@intellegens/cornerstone-client 0.0.0-experimental-upgrade-20260302-1

package/dist/services/api/ApiReadControllerClient/index.js

@@ -0,0 +1,111 @@
+import { apiInitializationService } from '../ApiInitializationService';
+import { fail, ok } from '../../../utils/result';
+import { ErrorCode } from '../../../data';
+/**
+ * Base client for read-only API controllers
+ */
+export class ApiReadControllerClient {
+    baseControllerPath;
+    /**
+     * Constructor
+     * @param baseControllerPath Base path to API controller
+     * @param httpService HTTP service implementation to use for requests
+     */
+    constructor(baseControllerPath, httpService) {
+        this.baseControllerPath = baseControllerPath;
+        this._httpService = httpService;
+    }
+    // #region HTTP service
+    _httpService = undefined;
+    /**
+     * Gets globally selected HTTP service
+     */
+    get httpService() {
+        return this._httpService || apiInitializationService._getHttpService();
+    }
+    // #endregion
+    // #region API
+    /**
+     * Fetches all entities from the read controller.
+     * @param {AbortSignal} [signal] - Optional cancellation signal
+     * @returns {Promise<ApiSuccessResponseDto<TDto>[], ReadMetadataDto>>} List of all entities with metadata
+     */
+    async readAll(signal) {
+        try {
+            const url = await apiInitializationService.getApiUrl(this.baseControllerPath, `/ReadAll`);
+            const res = await this.httpService.request(url, { method: 'GET', credentials: 'include', signal });
+            if (!res.ok) {
+                return fail(await res.json());
+            }
+            return ok(await res.json());
+        }
+        catch (err) {
+            console.error(err);
+            return fail({
+                error: {
+                    code: ErrorCode.UnknownError,
+                    message: 'Unknown error fetching all records',
+                    metadata: {},
+                },
+            });
+        }
+    }
+    /**
+     * Fetches selected entities based on a filter definition.
+     * @param {any} definition - The filter definition object
+     * @param {AbortSignal} [signal] - Optional cancellation signal
+     * @returns {Promise<ApiSuccessResponseDto<TDto>[], ReadMetadataDto>>} The result of the read operation with metadata
+     */
+    async readSelected(definition, signal) {
+        try {
+            const url = await apiInitializationService.getApiUrl(this.baseControllerPath, `/ReadSelected`);
+            const res = await this.httpService.request(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(definition),
+                credentials: 'include',
+                signal,
+            });
+            if (!res.ok) {
+                return fail(await res.json());
+            }
+            return ok(await res.json());
+        }
+        catch (err) {
+            console.error(err);
+            return fail({
+                error: {
+                    code: ErrorCode.UnknownError,
+                    message: 'Unknown error fetching selected records',
+                    metadata: {},
+                },
+            });
+        }
+    }
+    /**
+     * Fetches a single entity by its ID.
+     * @param {TKey} id - The ID of the entity
+     * @param {AbortSignal} [signal] - Optional cancellation signal
+     * @returns {Promise<ApiSuccessResponseDto<TDto, EmptyMetadataDto>>} The requested entity
+     */
+    async readSingle(id, signal) {
+        try {
+            const url = await apiInitializationService.getApiUrl(this.baseControllerPath, `/ReadSingle?id=${encodeURIComponent(String(id))}`);
+            const res = await this.httpService.request(url, { method: 'GET', credentials: 'include', signal });
+            if (!res.ok) {
+                return fail(await res.json());
+            }
+            return ok(await res.json());
+        }
+        catch (err) {
+            console.error(err);
+            return fail({
+                error: {
+                    code: ErrorCode.UnknownError,
+                    message: `Unknown error fetching record with id ${id}`,
+                    metadata: {},
+                },
+            });
+        }
+    }
+}

package/dist/services/api/HttpService/FetchHttpService.d.ts

@@ -0,0 +1,7 @@
+import { HttpRequestConfig, HttpResponse, IHttpService } from '../../../services';
+/**
+ * Default HTTP service implementation using the Fetch API
+ */
+export declare class FetchHttpService implements IHttpService {
+    request<T = any>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+}

package/dist/services/api/HttpService/FetchHttpService.integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/api/HttpService/FetchHttpService.integration.test.js

@@ -0,0 +1,52 @@
+import { beforeEach, describe, expect, it } from 'vitest';
+import { FetchHttpService } from './FetchHttpService';
+const baseUrl = 'http://localhost:5000/api';
+const credentials = {
+    username: 'admin@test.com',
+    password: 'Password1234!',
+};
+describe('FetchHttpService', () => {
+    let fetchService;
+    beforeEach(() => {
+        fetchService = new FetchHttpService();
+    });
+    it('should make a GET request successfully', async () => {
+        const result = await fetchService.request(`${baseUrl}/AnythingManuallyMappedRead/ReadAll`);
+        expect(result.ok).toBe(true);
+        expect(result.status).toBe(200);
+        expect(result.statusText).toBe('OK');
+        const jsonData = await result.json();
+        expect(jsonData.result).toBeDefined();
+        expect(jsonData.error).toBeNull();
+    });
+    it('should make a POST request with body', async () => {
+        const result = await fetchService.request(`${baseUrl}/auth/signin`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(credentials),
+        });
+        expect(result.ok).toBe(true);
+        expect(result.status).toBe(204);
+    });
+    it('should handle non-ok responses', async () => {
+        const result = await fetchService.request(`${baseUrl}/auth/signin`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ username: credentials.username, password: `${credentials.password}wrong` }),
+        });
+        expect(result.ok).toBe(false);
+        expect(result.status).toBe(400);
+        expect(result.statusText).toBe('Bad Request');
+        const jsonData = await result.json();
+        expect(jsonData.result).toBeNull();
+        expect(jsonData.error).toBeDefined();
+        expect(jsonData.error.code).toBe(400);
+        expect(jsonData.error.message).toBe('Invalid email or password');
+    });
+    it('should handle fetch errors from backend', async () => {
+        const result = await fetchService.request('http://localhost:5000/api/error');
+        expect(result.ok).toBe(false);
+        expect(result.status).toBe(404);
+        expect(result.statusText).toBe('Not Found');
+    });
+});

package/dist/services/api/HttpService/FetchHttpService.js

@@ -0,0 +1,29 @@
+// Ignore eslint any error in this file
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Default HTTP service implementation using the Fetch API
+ */
+export class FetchHttpService {
+    async request(url, config) {
+        const response = await fetch(url, {
+            method: config?.method || 'GET',
+            headers: config?.headers,
+            body: config?.body,
+            credentials: config?.credentials || 'include',
+            signal: config?.signal,
+        });
+        // Convert Headers to a plain object
+        const headers = {};
+        response.headers.forEach((value, key) => {
+            headers[key] = value;
+        });
+        return {
+            ok: response.ok,
+            status: response.status,
+            statusText: response.statusText,
+            headers,
+            json: () => response.json(),
+            text: () => response.text(),
+        };
+    }
+}

package/dist/services/api/HttpService/HttpRequestConfig.d.ts

@@ -0,0 +1,10 @@
+/**
+ * HTTP request configuration interface
+ */
+export interface HttpRequestConfig {
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    headers?: Record<string, string>;
+    body?: string;
+    credentials?: RequestCredentials;
+    signal?: AbortSignal;
+}

package/dist/services/api/HttpService/HttpRequestConfig.js

@@ -0,0 +1 @@
+export {};

package/dist/services/api/HttpService/HttpResponse.d.ts

@@ -0,0 +1,11 @@
+/**
+ * HTTP response interface
+ */
+export interface HttpResponse<T = any> {
+    ok: boolean;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    json(): Promise<T>;
+    text(): Promise<string>;
+}

package/dist/services/api/HttpService/HttpResponse.js

@@ -0,0 +1,3 @@
+// Ignore eslint any error in this file
+/* eslint-disable @typescript-eslint/no-explicit-any */
+export {};

package/dist/services/api/HttpService/IHttpService.d.ts

@@ -0,0 +1,13 @@
+import { HttpRequestConfig, HttpResponse } from '../../../services';
+/**
+ * Abstract HTTP service interface that can be implemented by different HTTP clients
+ */
+export interface IHttpService {
+    /**
+     * Performs an HTTP request
+     * @param url - The URL to make the request to
+     * @param config - Request configuration
+     * @returns Promise that resolves to the HTTP response
+     */
+    request<T = any>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+}

package/dist/services/api/HttpService/IHttpService.js

@@ -0,0 +1,3 @@
+// Ignore eslint any error in this file
+/* eslint-disable @typescript-eslint/no-explicit-any */
+export {};

package/dist/services/api/HttpService/index.d.ts

@@ -0,0 +1,9 @@
+import { FetchHttpService } from './FetchHttpService';
+/**
+ * Default HTTP service instance
+ */
+export declare const defaultHttpService: FetchHttpService;
+export * from './FetchHttpService';
+export * from './HttpRequestConfig';
+export * from './HttpResponse';
+export * from './IHttpService';

package/dist/services/api/HttpService/index.js

@@ -0,0 +1,10 @@
+import { FetchHttpService } from './FetchHttpService';
+/**
+ * Default HTTP service instance
+ */
+export const defaultHttpService = new FetchHttpService();
+// Export additional HTTP service implementations
+export * from './FetchHttpService';
+export * from './HttpRequestConfig';
+export * from './HttpResponse';
+export * from './IHttpService';

package/dist/services/api/UserManagementControllerClient/index.d.ts

@@ -0,0 +1,41 @@
+import { ApiCrudControllerClient } from '../ApiCrudControllerClient';
+import { IHttpService } from '../HttpService';
+import { ApiResponseDto, ClaimDto, EmptyMetadataDto, ReadMetadataDto, UserDto } from '../../../data';
+/**
+ * Client for user management operations
+ *
+ * @export
+ * @class UserManagementControllerClient
+ * @template TKey - Type of the entity key (e.g., number, string, GUID, etc.)
+ * @template TUser - Data Transfer Object representing the user entity
+ */
+export declare class UserManagementControllerClient<TKey, TResultDto extends UserDto<TKey>, TSingleResultDto extends UserDto<TKey>, TInsertRequestDto extends UserDto<TKey>, TUpdateRequestDto extends UserDto<TKey>> extends ApiCrudControllerClient<TKey, TResultDto, TSingleResultDto, TInsertRequestDto, TUpdateRequestDto> {
+    /**
+     * Constructor
+     * @param baseControllerPath Base path to API controller
+     * @param httpService HTTP service implementation to use for requests
+     */
+    constructor(baseControllerPath: string, httpService?: IHttpService);
+    /**
+     * Gets the roles assigned to a user
+     * @param id - The ID of the user
+     * @param {AbortSignal} [signal] - Optional cancellation signal
+     * @returns List of role names assigned to the user
+     */
+    getUserRoles(id: TKey, signal?: AbortSignal): Promise<ApiResponseDto<string[], ReadMetadataDto>>;
+    /**
+     * Gets the claims assigned to a user
+     * @param id - The ID of the user
+     * @param {AbortSignal} [signal] - Optional cancellation signal
+     * @returns List of claims assigned to the user
+     */
+    getUserClaims(id: TKey, signal?: AbortSignal): Promise<ApiResponseDto<ClaimDto[], ReadMetadataDto>>;
+    /**
+     * Changes the password for a user
+     * @param id - The ID of the user
+     * @param newPassword - The new password to set
+     * @param {AbortSignal} [signal] - Optional cancellation signal
+     * @returns Promise that resolves when the password is changed successfully
+     */
+    changePassword(id: TKey, newPassword: string, signal?: AbortSignal): Promise<ApiResponseDto<undefined, EmptyMetadataDto>>;
+}

package/dist/services/api/UserManagementControllerClient/index.integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/api/UserManagementControllerClient/index.integration.test.js

@@ -0,0 +1,60 @@
+import { beforeAll, beforeEach, describe, expect, it } from 'vitest';
+import { UserManagementControllerClient } from '.';
+import fetchOrig from 'node-fetch';
+import fetchCookie from 'fetch-cookie';
+import { CookieJar } from 'tough-cookie';
+// Create a fetch instance that handles auth cookies
+const jar = new CookieJar();
+const cookieFetch = fetchCookie(fetchOrig, jar);
+// Custom IHttpService implementation for tests
+class CookieFetchHttpService {
+    async request(url, config) {
+        const response = await cookieFetch(url, {
+            method: config?.method || 'GET',
+            headers: config?.headers,
+            body: config?.body,
+            signal: config?.signal,
+        });
+        const headers = {};
+        response.headers.forEach((value, key) => {
+            headers[key] = value;
+        });
+        return {
+            ok: response.ok,
+            status: response.status,
+            statusText: response.statusText,
+            headers,
+            json: () => response.json(),
+            text: () => response.text(),
+        };
+    }
+}
+const credentials = {
+    username: 'admin@test.com',
+    password: 'Password1234!',
+};
+const baseUrl = 'http://localhost:5000/api';
+describe('UserManagementControllerClient', () => {
+    let client;
+    let fetchService = new CookieFetchHttpService();
+    beforeAll(async () => {
+        await fetchService.request(`${baseUrl}/auth/signin`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(credentials),
+        });
+    });
+    beforeEach(() => {
+        client = new UserManagementControllerClient('/users', fetchService);
+    });
+    it('should use injected HTTP service for getUserRoles', async () => {
+        const result = (await client.getUserRoles(1));
+        expect(result.ok).toBe(true);
+        expect(result.result).toBeDefined();
+    });
+    it('should use injected HTTP service for getUserClaims', async () => {
+        const result = (await client.getUserClaims(1));
+        expect(result.ok).toBe(true);
+        expect(result.result).toBeDefined();
+    });
+});

package/dist/services/api/UserManagementControllerClient/index.js

@@ -0,0 +1,117 @@
+import { ApiCrudControllerClient } from '../ApiCrudControllerClient';
+import { apiInitializationService } from '../ApiInitializationService';
+import { ErrorCode } from '../../../data';
+import { fail, ok } from '../../../utils/result';
+/**
+ * Client for user management operations
+ *
+ * @export
+ * @class UserManagementControllerClient
+ * @template TKey - Type of the entity key (e.g., number, string, GUID, etc.)
+ * @template TUser - Data Transfer Object representing the user entity
+ */
+export class UserManagementControllerClient extends ApiCrudControllerClient {
+    /**
+     * Constructor
+     * @param baseControllerPath Base path to API controller
+     * @param httpService HTTP service implementation to use for requests
+     */
+    constructor(baseControllerPath, httpService) {
+        super(baseControllerPath, httpService);
+    }
+    /**
+     * Gets the roles assigned to a user
+     * @param id - The ID of the user
+     * @param {AbortSignal} [signal] - Optional cancellation signal
+     * @returns List of role names assigned to the user
+     */
+    async getUserRoles(id, signal) {
+        try {
+            const url = await apiInitializationService.getApiUrl(this.baseControllerPath, 'GetUserRoles', encodeURIComponent(String(id)));
+            const res = await this.httpService.request(url, {
+                method: 'GET',
+                credentials: 'include',
+                signal,
+            });
+            if (!res.ok) {
+                return fail(await res.json());
+            }
+            return ok(await res.json());
+        }
+        catch (err) {
+            console.error(err);
+            return fail({
+                error: {
+                    code: ErrorCode.UnknownError,
+                    message: 'Unknown error while fetching user roles',
+                    metadata: {},
+                },
+            });
+        }
+    }
+    /**
+     * Gets the claims assigned to a user
+     * @param id - The ID of the user
+     * @param {AbortSignal} [signal] - Optional cancellation signal
+     * @returns List of claims assigned to the user
+     */
+    async getUserClaims(id, signal) {
+        try {
+            const url = await apiInitializationService.getApiUrl(this.baseControllerPath, 'GetUserClaims', encodeURIComponent(String(id)));
+            const res = await this.httpService.request(url, {
+                method: 'GET',
+                credentials: 'include',
+                signal,
+            });
+            if (!res.ok) {
+                return fail(await res.json());
+            }
+            return ok(await res.json());
+        }
+        catch (err) {
+            console.error(err);
+            return fail({
+                error: {
+                    code: ErrorCode.UnknownError,
+                    message: 'Unknown error while fetching user claims',
+                    metadata: {},
+                },
+            });
+        }
+    }
+    /**
+     * Changes the password for a user
+     * @param id - The ID of the user
+     * @param newPassword - The new password to set
+     * @param {AbortSignal} [signal] - Optional cancellation signal
+     * @returns Promise that resolves when the password is changed successfully
+     */
+    async changePassword(id, newPassword, signal) {
+        try {
+            const url = await apiInitializationService.getApiUrl(this.baseControllerPath, 'ChangePassword', encodeURIComponent(String(id)));
+            const res = await this.httpService.request(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(newPassword),
+                credentials: 'include',
+                signal,
+            });
+            if (!res.ok) {
+                return fail(await res.json());
+            }
+            return ok(undefined);
+        }
+        catch (err) {
+            console.error(err);
+            return fail({
+                error: {
+                    code: ErrorCode.UnknownError,
+                    message: 'Unknown error while changing password',
+                    metadata: {},
+                },
+            });
+        }
+    }
+}

package/dist/services/api/index.d.ts

@@ -0,0 +1,5 @@
+export * from './HttpService';
+export * from './ApiInitializationService';
+export * from './ApiReadControllerClient';
+export * from './ApiCrudControllerClient';
+export * from './UserManagementControllerClient';

package/dist/services/api/index.js

@@ -0,0 +1,5 @@
+export * from './HttpService';
+export * from './ApiInitializationService';
+export * from './ApiReadControllerClient';
+export * from './ApiCrudControllerClient';
+export * from './UserManagementControllerClient';

package/dist/services/auth/client/AuthService/index.d.ts

@@ -0,0 +1,75 @@
+import { IHttpService } from '../../..';
+import { ApiResponseDto, EmptyMetadataDto, UserDto, UserInfoDto, RegisterRequestDto } from '../../../../data';
+export { UserDto, UserInfoDto };
+/**
+ * AuthService class is responsible for managing user authentication operations.
+ * It supports login, logout, and checking the current user's details.
+ *
+ * @export
+ * @class AuthService
+ */
+export declare class AuthService<TKey, TRegisterUser extends RegisterRequestDto = RegisterRequestDto, TUser extends UserDto<TKey> = UserDto<TKey>> {
+    protected readonly baseControllerPath: string;
+    /**
+     * Constructor
+     * @param baseControllerPath Base path to Auth API controller
+     * @param httpService HTTP service implementation to use for requests
+     */
+    constructor(baseControllerPath?: string, httpService?: IHttpService);
+    private readonly _httpService?;
+    /**
+     * Gets globally selected HTTP service
+     */
+    protected get httpService(): IHttpService;
+    /**
+     * Holds currently authenticated user's details
+     */
+    user: TUser | undefined;
+    /**
+     * Initializes the Authentication status by checking with the API if the current user is authenticated or not
+     *
+     * @async
+     * @return {Promise<void>} Resolves when initialization is complete.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Checks if user is authenticated and retrieves the current user's details if they are
+     *
+     * @return {Promise<UserInfoDto<TKey, TUser>>} Currently logged in user's details
+     * @throws {Error} Error if fetch fails
+     */
+    whoAmI(): Promise<ApiResponseDto<UserInfoDto<TKey, TUser>, EmptyMetadataDto>>;
+    /**
+     * Authenticates a user using their username and password, and retrieves user's details
+     *
+     * @param {string} username Login credentials: username
+     * @param {string} password Login credentials: password
+     * @return {Promise<TUser>} Currently logged in user's details
+     * @throws {Error} Error if fetch fails
+     */
+    signIn(username: string, password: string): Promise<ApiResponseDto<TUser, EmptyMetadataDto>>;
+    /**
+     * Deauthenticates current user
+     *
+     * @return {Promise<void>}
+     * @throws {Error} Error if fetch fails
+     */
+    signOut(): Promise<ApiResponseDto<undefined, EmptyMetadataDto>>;
+    /**
+     * Registers a new user by sending user details to the API.
+     *
+     * @param {TRegisterUser} user User object containing registration data (e.g. username, password, and optionally firstName, lastName, etc.)
+     * @return {Promise<ApiResponseDto<TUser, EmptyMetadataDto>>} API response with registered user details or error info
+     * @throws {Error} Error if the request fails
+     */
+    register(user: TRegisterUser): Promise<ApiResponseDto<TUser, EmptyMetadataDto>>;
+    /**
+     * If any API response returns an "Unauthenticated" response, call this method
+     * to update local authentication state to unauthenticated
+     */
+    handleNoAuthApiResponse(): void;
+    /**
+     * True if a user is currently loaded (post whoAmI/signIn)
+     */
+    isAuthenticated(): boolean;
+}