Migrating from services to dedicated API files

This commit is contained in:
2025-05-03 21:28:41 +02:00
parent e789025cd1
commit 043eab423f
22 changed files with 265 additions and 228 deletions

View File

@@ -1,4 +1,4 @@
import { apiCall } from './authApi'; import { apiCall } from './auth';
import { API_BASE_URL } from '../utils/constants'; import { API_BASE_URL } from '../utils/constants';
const ADMIN_BASE_URL = `${API_BASE_URL}/admin`; const ADMIN_BASE_URL = `${API_BASE_URL}/admin`;

47
app/src/api/api.ts Normal file
View File

@@ -0,0 +1,47 @@
import { refreshToken } from './auth';
/**
* Makes an API call with proper cookie handling and error handling
*/
export const apiCall = async (
url: string,
options: RequestInit = {}
): Promise<Response> => {
try {
const response = await fetch(url, {
...options,
// Include credentials to send/receive cookies
credentials: 'include',
headers: {
'Content-Type': 'application/json',
...options.headers,
},
});
// Handle 401 responses
if (response.status === 401) {
const isRefreshEndpoint = url.endsWith('/auth/refresh');
if (!isRefreshEndpoint) {
// Attempt token refresh and retry the request
const refreshSuccess = await refreshToken();
if (refreshSuccess) {
// Retry the original request
return apiCall(url, options);
}
}
throw new Error('Authentication failed');
}
if (!response.ok && response.status !== 204) {
const errorData = (await response.json()) as { message: string };
throw new Error(
errorData?.message || `HTTP error! status: ${response.status}`
);
}
return response;
} catch (error) {
console.error(`API call failed: ${(error as Error).message}`);
throw error;
}
};

93
app/src/api/auth.ts Normal file
View File

@@ -0,0 +1,93 @@
import {
API_BASE_URL,
User,
LoginRequest,
LoginResponse,
isLoginResponse,
ErrorResponse,
isUser,
} from '../types/authApi';
import { apiCall } from './api';
/**
* Logs in a user with email and password
*/
export const login = async (
email: string,
password: string
): Promise<LoginResponse> => {
const loginData: LoginRequest = { email, password };
const response = await apiCall(`${API_BASE_URL}/auth/login`, {
method: 'POST',
body: JSON.stringify(loginData),
});
if (!response.ok) {
const data = await response.json();
const errorData = data as ErrorResponse;
throw new Error(errorData.message || 'Login failed');
}
const data = await response.json();
if (!isLoginResponse(data)) {
throw new Error('Invalid login response received from API');
}
return data;
};
/**
* Logs out the current user
*/
export const logout = async (): Promise<void> => {
const response = await apiCall(`${API_BASE_URL}/auth/logout`, {
method: 'POST',
});
if (!response.ok) {
const data = await response.json();
const errorData = data as ErrorResponse;
throw new Error(errorData.message || 'Logout failed');
}
};
/**
* Refreshes the auth token
* @returns true if refresh was successful, false otherwise
*/
export const refreshToken = async (): Promise<boolean> => {
try {
const response = await apiCall(`${API_BASE_URL}/auth/refresh`, {
method: 'POST',
});
if (!response.ok) {
const data = await response.json();
const errorData = data as ErrorResponse;
throw new Error(errorData.message || 'Token refresh failed');
}
return true;
} catch (error) {
return false;
}
};
/**
* Gets the currently authenticated user
*/
export const getCurrentUser = async (): Promise<User> => {
const response = await apiCall(`${API_BASE_URL}/auth/me`);
const data = await response.json();
if (!response.ok) {
const errorData = data as ErrorResponse;
throw new Error(errorData.message || 'Failed to get current user');
}
if (!isUser(data)) {
throw new Error('Invalid user data received from API');
}
return data;
};

View File

@@ -1,5 +1,5 @@
import { API_BASE_URL } from '../utils/constants'; import { API_BASE_URL } from '../utils/constants';
import { apiCall } from './authApi'; import { apiCall } from './auth';
export const updateProfile = async (updates) => { export const updateProfile = async (updates) => {
const response = await apiCall(`${API_BASE_URL}/profile`, { const response = await apiCall(`${API_BASE_URL}/profile`, {

View File

@@ -2,7 +2,7 @@ import React from 'react';
import { Text, Center } from '@mantine/core'; import { Text, Center } from '@mantine/core';
import Editor from './Editor'; import Editor from './Editor';
import MarkdownPreview from './MarkdownPreview'; import MarkdownPreview from './MarkdownPreview';
import { getFileUrl } from '../../services/api'; import { getFileUrl } from '../../api/notes';
import { isImageFile } from '../../utils/fileHelpers'; import { isImageFile } from '../../utils/fileHelpers';
const ContentView = ({ const ContentView = ({

View File

@@ -1,7 +1,7 @@
import React, { useState } from 'react'; import React, { useState } from 'react';
import { Modal, TextInput, Button, Group, Box } from '@mantine/core'; import { Modal, TextInput, Button, Group, Box } from '@mantine/core';
import { useModalContext } from '../../../contexts/ModalContext'; import { useModalContext } from '../../../contexts/ModalContext';
import { createWorkspace } from '../../../services/api'; import { createWorkspace } from '../../../api/notes';
import { notifications } from '@mantine/notifications'; import { notifications } from '@mantine/notifications';
const CreateWorkspaceModal = ({ onWorkspaceCreated }) => { const CreateWorkspaceModal = ({ onWorkspaceCreated }) => {

View File

@@ -17,7 +17,7 @@ import {
import { IconFolders, IconSettings, IconFolderPlus } from '@tabler/icons-react'; import { IconFolders, IconSettings, IconFolderPlus } from '@tabler/icons-react';
import { useWorkspace } from '../../contexts/WorkspaceContext'; import { useWorkspace } from '../../contexts/WorkspaceContext';
import { useModalContext } from '../../contexts/ModalContext'; import { useModalContext } from '../../contexts/ModalContext';
import { listWorkspaces } from '../../services/api'; import { listWorkspaces } from '../../api/notes';
import CreateWorkspaceModal from '../modals/workspace/CreateWorkspaceModal'; import CreateWorkspaceModal from '../modals/workspace/CreateWorkspaceModal';
const WorkspaceSwitcher = () => { const WorkspaceSwitcher = () => {

View File

@@ -6,7 +6,7 @@ import React, {
useEffect, useEffect,
} from 'react'; } from 'react';
import { notifications } from '@mantine/notifications'; import { notifications } from '@mantine/notifications';
import * as authApi from '../services/authApi'; import * as authApi from '../api/auth';
const AuthContext = createContext(null); const AuthContext = createContext(null);

View File

@@ -14,7 +14,7 @@ import {
updateLastWorkspaceName, updateLastWorkspaceName,
deleteWorkspace, deleteWorkspace,
listWorkspaces, listWorkspaces,
} from '../services/api'; } from '../api/notes';
import { DEFAULT_WORKSPACE_SETTINGS } from '../utils/constants'; import { DEFAULT_WORKSPACE_SETTINGS } from '../utils/constants';
const WorkspaceContext = createContext(); const WorkspaceContext = createContext();

View File

@@ -1,6 +1,6 @@
import { useState, useEffect } from 'react'; import { useState, useEffect } from 'react';
import { notifications } from '@mantine/notifications'; import { notifications } from '@mantine/notifications';
import { getUsers, getWorkspaces, getSystemStats } from '../services/adminApi'; import { getUsers, getWorkspaces, getSystemStats } from '../api/admin';
// Hook for admin data fetching (stats and workspaces) // Hook for admin data fetching (stats and workspaces)
export const useAdminData = (type) => { export const useAdminData = (type) => {

View File

@@ -1,5 +1,5 @@
import { useState, useCallback, useEffect } from 'react'; import { useState, useCallback, useEffect } from 'react';
import { fetchFileContent } from '../services/api'; import { fetchFileContent } from '../api/notes';
import { isImageFile } from '../utils/fileHelpers'; import { isImageFile } from '../utils/fileHelpers';
import { DEFAULT_FILE } from '../utils/constants'; import { DEFAULT_FILE } from '../utils/constants';
import { useWorkspace } from '../contexts/WorkspaceContext'; import { useWorkspace } from '../contexts/WorkspaceContext';

View File

@@ -1,5 +1,5 @@
import { useState, useCallback } from 'react'; import { useState, useCallback } from 'react';
import { fetchFileList } from '../services/api'; import { fetchFileList } from '../api/notes';
import { useWorkspace } from '../contexts/WorkspaceContext'; import { useWorkspace } from '../contexts/WorkspaceContext';
export const useFileList = () => { export const useFileList = () => {

View File

@@ -1,6 +1,6 @@
import { useCallback } from 'react'; import { useCallback } from 'react';
import { notifications } from '@mantine/notifications'; import { notifications } from '@mantine/notifications';
import { saveFileContent, deleteFile } from '../services/api'; import { saveFileContent, deleteFile } from '../api/notes';
import { useWorkspace } from '../contexts/WorkspaceContext'; import { useWorkspace } from '../contexts/WorkspaceContext';
import { useGitOperations } from './useGitOperations'; import { useGitOperations } from './useGitOperations';

View File

@@ -1,6 +1,6 @@
import { useCallback } from 'react'; import { useCallback } from 'react';
import { notifications } from '@mantine/notifications'; import { notifications } from '@mantine/notifications';
import { pullChanges, commitAndPush } from '../services/api'; import { pullChanges, commitAndPush } from '../api/notes';
import { useWorkspace } from '../contexts/WorkspaceContext'; import { useWorkspace } from '../contexts/WorkspaceContext';
export const useGitOperations = () => { export const useGitOperations = () => {

View File

@@ -1,5 +1,5 @@
import { useCallback } from 'react'; import { useCallback } from 'react';
import { getLastOpenedFile, updateLastOpenedFile } from '../services/api'; import { getLastOpenedFile, updateLastOpenedFile } from '../api/notes';
import { useWorkspace } from '../contexts/WorkspaceContext'; import { useWorkspace } from '../contexts/WorkspaceContext';
export const useLastOpenedFile = () => { export const useLastOpenedFile = () => {

View File

@@ -1,6 +1,6 @@
import { useState, useCallback } from 'react'; import { useState, useCallback } from 'react';
import { notifications } from '@mantine/notifications'; import { notifications } from '@mantine/notifications';
import { updateProfile, deleteProfile } from '../services/api'; import { updateProfile, deleteProfile } from '../api/notes';
export function useProfileSettings() { export function useProfileSettings() {
const [loading, setLoading] = useState(false); const [loading, setLoading] = useState(false);

View File

@@ -1,5 +1,5 @@
import { useAdminData } from './useAdminData'; import { useAdminData } from './useAdminData';
import { createUser, updateUser, deleteUser } from '../services/adminApi'; import { createUser, updateUser, deleteUser } from '../api/admin';
import { notifications } from '@mantine/notifications'; import { notifications } from '@mantine/notifications';
export const useUserAdmin = () => { export const useUserAdmin = () => {

View File

@@ -1,138 +0,0 @@
import {
API_BASE_URL,
User,
LoginRequest,
LoginResponse,
ApiCallOptions,
ErrorResponse
} from '../types/api';
let authToken: string | null = null;
/**
* Sets the authentication token for API requests
*/
export const setAuthToken = (token: string): void => {
authToken = token;
};
/**
* Clears the authentication token
*/
export const clearAuthToken = (): void => {
authToken = null;
};
/**
* Gets headers for API requests including auth token if present
*/
export const getAuthHeaders = (): HeadersInit => {
const headers: Record<string, string> = {
'Content-Type': 'application/json',
};
if (authToken) {
headers['Authorization'] = `Bearer ${authToken}`;
}
return headers;
};
/**
* Makes an API call with authentication and error handling
*/
export const apiCall = async (
url: string,
options: ApiCallOptions = {}
): Promise<Response> => {
try {
const headers = {
...getAuthHeaders(),
...options.headers,
};
const response = await fetch(url, {
...options,
headers: headers as HeadersInit,
});
// Handle 401 responses
if (response.status === 401) {
const isRefreshEndpoint = url.endsWith('/auth/refresh');
if (!isRefreshEndpoint) {
// Attempt token refresh and retry the request
const refreshSuccess = await refreshToken();
if (refreshSuccess) {
// Retry the original request with the new token
return apiCall(url, options);
}
}
throw new Error('Authentication failed');
}
if (!response.ok && response.status !== 204) {
const errorData = await response.json() as ErrorResponse;
throw new Error(
errorData?.message || `HTTP error! status: ${response.status}`
);
}
return response;
} catch (error) {
console.error(`API call failed: ${(error as Error).message}`);
throw error;
}
};
/**
* Logs in a user with email and password
*/
export const login = async (
email: string,
password: string
): Promise<LoginResponse> => {
const loginData: LoginRequest = { email, password };
const response = await apiCall(`${API_BASE_URL}/auth/login`, {
method: 'POST',
body: JSON.stringify(loginData),
});
return response.json();
};
/**
* Logs out the current user
*/
export const logout = async (): Promise<void> => {
const sessionId = localStorage.getItem('sessionId');
await apiCall(`${API_BASE_URL}/auth/logout`, {
method: 'POST',
headers: {
'X-Session-ID': sessionId || '',
},
});
};
/**
* Refreshes the auth token using a refresh token
*/
export const refreshToken = async (): Promise<boolean> => {
const refreshToken = localStorage.getItem('refreshToken');
try {
const response = await apiCall(`${API_BASE_URL}/auth/refresh`, {
method: 'POST',
body: JSON.stringify({ refreshToken }),
});
const data = await response.json();
return !!data.accessToken;
} catch (error) {
return false;
}
};
/**
* Gets the currently authenticated user
*/
export const getCurrentUser = async (): Promise<User> => {
const response = await apiCall(`${API_BASE_URL}/auth/me`);
return response.json();
};

View File

@@ -1,59 +0,0 @@
declare global {
interface Window {
API_BASE_URL: string;
}
}
export const API_BASE_URL = window.API_BASE_URL;
/**
* User role in the system
*/
export enum UserRole {
Admin = 'admin',
Editor = 'editor',
Viewer = 'viewer'
}
/**
* User model from the API
*/
export interface User {
id: number;
email: string;
displayName?: string;
role: UserRole;
createdAt: string;
lastWorkspaceId: number;
}
/**
* Error response from the API
*/
export interface ErrorResponse {
message: string;
}
/**
* Login request parameters
*/
export interface LoginRequest {
email: string;
password: string;
}
/**
* Login response from the API
*/
export interface LoginResponse {
user: User;
sessionId: string;
expiresAt: string;
}
/**
* API call options extending the standard RequestInit
*/
export interface ApiCallOptions extends RequestInit {
headers?: HeadersInit;
}

105
app/src/types/authApi.ts Normal file
View File

@@ -0,0 +1,105 @@
declare global {
interface Window {
API_BASE_URL: string;
}
}
export const API_BASE_URL = window.API_BASE_URL;
/**
* User role in the system
*/
export enum UserRole {
Admin = 'admin',
Editor = 'editor',
Viewer = 'viewer',
}
/**
* Type guard to check if a value is a valid UserRole
*/
export function isUserRole(value: unknown): value is UserRole {
return typeof value === 'string' && value in UserRole;
}
/**
* User model from the API
*/
export interface User {
id: number;
email: string;
displayName?: string;
role: UserRole;
createdAt: string;
lastWorkspaceId: number;
}
/**
* Type guard to check if a value is a valid User
*/
export function isUser(value: unknown): value is User {
return (
typeof value === 'object' &&
value !== null &&
'id' in value &&
typeof (value as User).id === 'number' &&
'email' in value &&
typeof (value as User).email === 'string' &&
('displayName' in value
? typeof (value as User).displayName === 'string'
: true) &&
'role' in value &&
isUserRole((value as User).role) &&
'createdAt' in value &&
typeof (value as User).createdAt === 'string' &&
'lastWorkspaceId' in value &&
typeof (value as User).lastWorkspaceId === 'number'
);
}
/**
* Error response from the API
*/
export interface ErrorResponse {
message: string;
}
/**
* Login request parameters
*/
export interface LoginRequest {
email: string;
password: string;
}
/**
* Login response from the API
*/
export interface LoginResponse {
user: User;
sessionId: string;
expiresAt: string;
}
/**
* Type guard to check if a value is a valid LoginResponse
*/
export function isLoginResponse(value: unknown): value is LoginResponse {
return (
typeof value === 'object' &&
value !== null &&
'user' in value &&
isUser((value as LoginResponse).user) &&
'sessionId' in value &&
typeof (value as LoginResponse).sessionId === 'string' &&
'expiresAt' in value &&
typeof (value as LoginResponse).expiresAt === 'string'
);
}
/**
* API call options extending the standard RequestInit
*/
export interface ApiCallOptions extends RequestInit {
headers?: HeadersInit;
}

View File

@@ -9,10 +9,6 @@ export enum InlineContainerType {
Delete = 'delete', Delete = 'delete',
} }
export const INLINE_CONTAINER_TYPES = new Set<InlineContainerType>(
Object.values(InlineContainerType)
);
export const MARKDOWN_REGEX = { export const MARKDOWN_REGEX = {
WIKILINK: /(!?)\[\[(.*?)\]\]/g, WIKILINK: /(!?)\[\[(.*?)\]\]/g,
} as const; } as const;

View File

@@ -1,6 +1,6 @@
import { visit } from 'unist-util-visit'; import { visit } from 'unist-util-visit';
import { lookupFileByName, getFileUrl } from '../services/api'; import { lookupFileByName, getFileUrl } from '../api/notes';
import { MARKDOWN_REGEX } from '../types/markdown'; import { InlineContainerType, MARKDOWN_REGEX } from '../types/markdown';
import { Node } from 'unist'; import { Node } from 'unist';
import { Parent } from 'unist'; import { Parent } from 'unist';
import { Text } from 'mdast'; import { Text } from 'mdast';
@@ -146,16 +146,9 @@ function addMarkdownExtension(fileName: string): string {
* Determines if a node type can contain inline content * Determines if a node type can contain inline content
*/ */
function canContainInline(type: string): boolean { function canContainInline(type: string): boolean {
return [ return Object.values(InlineContainerType).includes(
'paragraph', type as InlineContainerType
'listItem', );
'tableCell',
'blockquote',
'heading',
'emphasis',
'strong',
'delete',
].includes(type);
} }
/** /**