@intellegens/cornerstone-client 0.0.17 → 0.0.19

package/data/auth/Role/index.d.ts

@@ -0,0 +1,8 @@
+export interface Role {
+    name: string;
+    claims: Claim[];
+}
+export interface Claim {
+    name: string;
+    value: string;
+}

package/data/auth/Role/index.js

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

package/data/auth/User/index.d.ts

@@ -1,3 +1,4 @@
+import { Claim } from "../../../data";
 /**
  * Represents a user with an identifier and email address.
  *
@@ -5,8 +6,10 @@
  *
  * @param {TId} id The unique identifier for the user.
  * @param {string} email The email address associated with the user.
+ * @param {Claim[]} claims The claims associated with the user.
  */
 export type User<TId> = {
-    id: TId;
+    id: TId | undefined;
     email: string;
+    claims: Claim[];
 };

package/data/auth/index.d.ts

@@ -1,2 +1,3 @@
 export * from './User';
 export * from './UserInfo';
+export * from './Role';

package/data/auth/index.js

@@ -1,2 +1,3 @@
 export * from './User';
 export * from './UserInfo';
+export * from './Role';

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@intellegens/cornerstone-client",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "main": "index.js",
   "type": "module",
   "scripts": {
+    "clean": "node -e \"require('fs-extra').emptyDir('./dist');\"",
     "test": "echo \"Error: no test specified\" && exit 1",
-    "build": "npm run transpile-types && tsc && tsc-alias",
+    "build": "npm run clean && npm run transpile-types && tsc && tsc-alias",
     "demo": "npm run build && npx vite build && npx tsx ./demo",
     "transpile-types": "cd ../utils/cli && npm run cli zod-gen -- --input '../../client/src/data/_jsonschema' --output '../../client/src/data/_generated'"
   },
@@ -19,6 +20,7 @@
     "eslint": "^9.21.0",
     "eslint-config-prettier": "^10.0.1",
     "express": "^4.21.2",
+    "fs-extra": "^11.3.0",
     "globals": "^16.0.0",
     "prettier": "^3.5.2",
     "tsc-alias": "^1.8.11",

package/services/api/{client/ApiCrudControllerClient → ApiCrudControllerClient}/index.d.ts

@@ -1,4 +1,4 @@
-import { ApiReadControllerClient } from '../../..';
+import { ApiReadControllerClient } from '../..';
 /**
  * Generic API client for consuming any Cornerstone CrudController
  *

package/services/api/{client/ApiCrudControllerClient → ApiCrudControllerClient}/index.js

@@ -1,4 +1,4 @@
-import { apiInitializationService, ApiReadControllerClient } from '../../..';
+import { apiInitializationService, ApiReadControllerClient } from '../..';
 /**
  * Generic API client for consuming any Cornerstone CrudController
  *

package/services/api/{client/ApiReadControllerClient → ApiReadControllerClient}/index.d.ts

@@ -1,4 +1,4 @@
-import { IIdentifiable, ReadSelectedDefinition } from '../../../../data';
+import { IIdentifiable, ReadSelectedDefinition } from '../../../data';
 /**
  * Generic API client for consuming any Cornerstone ReadController
  *

package/services/api/{client/ApiReadControllerClient → ApiReadControllerClient}/index.js

@@ -1,4 +1,4 @@
-import { apiInitializationService } from '../../..';
+import { apiInitializationService } from '../..';
 /**
  * Generic API client for consuming any Cornerstone ReadController
  *

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

@@ -0,0 +1,35 @@
+import { ApiCrudControllerClient } from '../..';
+/**
+ * Client for user management operations
+ *
+ * @export
+ * @class UserManagementControllerClient
+ * @template TKey - Type of the entity key (e.g., number, string, GUID, etc.)
+ * @template TDto - Data Transfer Object representing the user entity
+ */
+export declare class UserManagementControllerClient<TKey, TDto> extends ApiCrudControllerClient<TKey, TDto> {
+    /**
+     * Gets the roles assigned to a user
+     * @param id - The ID of the user
+     * @returns List of role names assigned to the user
+     */
+    getUserRoles(id: TKey): Promise<string[]>;
+    /**
+     * Gets the claims assigned to a user
+     * @param id - The ID of the user
+     * @returns List of claims assigned to the user
+     */
+    getUserClaims(id: TKey): Promise<Record<string, string>>;
+    /**
+     * Gets all available roles in the system
+     * @returns List of all role names
+     */
+    getAllRoles(): Promise<string[]>;
+    /**
+     * Changes the password for a user
+     * @param id - The ID of the user
+     * @param newPassword - The new password to set
+     * @returns Promise that resolves when the password is changed successfully
+     */
+    changePassword(id: TKey, newPassword: string): Promise<void>;
+}

package/services/api/UserManagementControllerClient/index.js

@@ -0,0 +1,93 @@
+import { ApiCrudControllerClient, apiInitializationService } from '../..';
+/**
+ * Client for user management operations
+ *
+ * @export
+ * @class UserManagementControllerClient
+ * @template TKey - Type of the entity key (e.g., number, string, GUID, etc.)
+ * @template TDto - Data Transfer Object representing the user entity
+ */
+export class UserManagementControllerClient extends ApiCrudControllerClient {
+    /**
+     * Gets the roles assigned to a user
+     * @param id - The ID of the user
+     * @returns List of role names assigned to the user
+     */
+    async getUserRoles(id) {
+        try {
+            const url = await apiInitializationService.getApiUrl(this.baseControllerPath, `/GetUserRoles${encodeURIComponent(String(id))}`);
+            const response = await fetch(url, {
+                credentials: 'include',
+            });
+            if (!response.ok)
+                throw new Error('Failed to fetch user roles');
+            return response.json();
+        }
+        catch (err) {
+            throw err instanceof Error ? err : new Error('Unknown error fetching user roles');
+        }
+    }
+    /**
+     * Gets the claims assigned to a user
+     * @param id - The ID of the user
+     * @returns List of claims assigned to the user
+     */
+    async getUserClaims(id) {
+        try {
+            const url = await apiInitializationService.getApiUrl(this.baseControllerPath, `/GetUserClaims/${encodeURIComponent(String(id))}`);
+            const response = await fetch(url, {
+                credentials: 'include',
+            });
+            if (!response.ok)
+                throw new Error('Failed to fetch user claims');
+            return response.json();
+        }
+        catch (err) {
+            throw err instanceof Error ? err : new Error('Unknown error fetching user claims');
+        }
+    }
+    /**
+     * Gets all available roles in the system
+     * @returns List of all role names
+     */
+    async getAllRoles() {
+        try {
+            const url = await apiInitializationService.getApiUrl(this.baseControllerPath, `/GetAllRoles`);
+            const response = await fetch(url, {
+                credentials: 'include',
+            });
+            if (!response.ok)
+                throw new Error('Failed to fetch all roles');
+            return response.json();
+        }
+        catch (err) {
+            throw err instanceof Error ? err : new Error('Unknown error fetching all roles');
+        }
+    }
+    /**
+     * Changes the password for a user
+     * @param id - The ID of the user
+     * @param newPassword - The new password to set
+     * @returns Promise that resolves when the password is changed successfully
+     */
+    async changePassword(id, newPassword) {
+        try {
+            const url = await apiInitializationService.getApiUrl(this.baseControllerPath, `/ChangePassword/${encodeURIComponent(String(id))}`);
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify(newPassword),
+                credentials: 'include',
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(errorText || 'Failed to change password');
+            }
+        }
+        catch (err) {
+            throw err instanceof Error ? err : new Error('Unknown error changing password');
+        }
+    }
+}

package/services/api/index.d.ts

@@ -1,2 +1,4 @@
-export * from './initialization';
-export * from './client';
+export * from './ApiInitializationService';
+export * from './ApiReadControllerClient';
+export * from './ApiCrudControllerClient';
+export * from './UserManagementControllerClient';

package/services/api/index.js

@@ -1,2 +1,4 @@
-export * from './initialization';
-export * from './client';
+export * from './ApiInitializationService';
+export * from './ApiReadControllerClient';
+export * from './ApiCrudControllerClient';
+export * from './UserManagementControllerClient';

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

@@ -0,0 +1,50 @@
+import { User, UserInfo } from '../../../../data';
+export { User, UserInfo };
+/**
+ * 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<TId, TUser extends User<TId> = User<TId>> {
+    /**
+     * 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<TUser>} Currently logged in user's details
+     * @throws {Error} Error if fetch fails
+     */
+    whoAmI(): Promise<TUser | undefined>;
+    /**
+     * 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<TUser>;
+    /**
+     * Deauthenticates current user
+     *
+     * @return {Promise<void>}
+     * @throws {Error} Error if fetch fails
+     */
+    signout(): Promise<void>;
+    /**
+     * If any API response returns an "Unauthenticated" response, call this method
+     * to update local authentication state to unauthenticated
+     */
+    _handleResponse401(): void;
+}

package/services/auth/client/AuthService/index.js

@@ -0,0 +1,113 @@
+import { apiInitializationService } from '../../..';
+/**
+ * AuthService class is responsible for managing user authentication operations.
+ * It supports login, logout, and checking the current user's details.
+ *
+ * @export
+ * @class AuthService
+ */
+export class AuthService {
+    /**
+     * Holds currently authenticated user's details
+     */
+    user = 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.
+     */
+    async initialize() {
+        // Check user's authentication status
+        await this.whoAmI();
+    }
+    /**
+     * Checks if user is authenticated and retrieves the current user's details if they are
+     *
+     * @return {Promise<TUser>} Currently logged in user's details
+     * @throws {Error} Error if fetch fails
+     */
+    async whoAmI() {
+        try {
+            const url = await apiInitializationService.getApiUrl('/auth/whoami');
+            const response = await fetch(url, { credentials: 'include' });
+            if (response.ok) {
+                const info = await response.json();
+                return (this.user = info.user);
+            }
+            else if (response.status === 401) {
+                return (this.user = undefined);
+            }
+            else {
+                this.user = undefined;
+                throw new Error('Failed checking authentication status');
+            }
+        }
+        catch (error) {
+            throw error instanceof Error ? error : new Error('Failed checking authentication status');
+        }
+    }
+    /**
+     * 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
+     */
+    async signin(username, password) {
+        try {
+            const url = await apiInitializationService.getApiUrl('/auth/signin');
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ username, password }),
+                credentials: 'include',
+            });
+            if (response.ok) {
+                const user = await this.whoAmI();
+                if (user !== undefined) {
+                    return (this.user = user);
+                }
+                else {
+                    throw new Error('Failed signing in');
+                }
+            }
+            else {
+                throw new Error('Failed signing in');
+            }
+        }
+        catch (error) {
+            throw error instanceof Error ? error : new Error('Failed signing in');
+        }
+    }
+    /**
+     * Deauthenticates current user
+     *
+     * @return {Promise<void>}
+     * @throws {Error} Error if fetch fails
+     */
+    async signout() {
+        try {
+            const url = await apiInitializationService.getApiUrl('/auth/signout');
+            const response = await fetch(url, { credentials: 'include' });
+            if (response.ok) {
+                this.user = undefined;
+                return;
+            }
+            else {
+                throw new Error('Failed signing out');
+            }
+        }
+        catch (error) {
+            throw error instanceof Error ? error : new Error('Failed signing out');
+        }
+    }
+    /**
+     * If any API response returns an "Unauthenticated" response, call this method
+     * to update local authentication state to unauthenticated
+     */
+    _handleResponse401() {
+        this.user = undefined;
+    }
+}

package/services/auth/client/AuthorizationManagementControllerClient/index.d.ts

@@ -0,0 +1,39 @@
+import { Role } from '../../../../data';
+/**
+ * Client for authorization management operations
+ *
+ * @export
+ * @class AuthorizationManagementControllerClient
+ */
+export declare class AuthorizationManagementControllerClient {
+    protected readonly baseControllerPath: string;
+    /**
+     * Constructor
+     * @param baseControllerPath Base path to API controller
+     */
+    constructor(baseControllerPath?: string);
+    /**
+     * Gets all roles in the system
+     * @param includeClaims - Whether to include claims in the response
+     * @returns List of all roles
+     */
+    getAllRoles(includeClaims: boolean): Promise<Role[]>;
+    /**
+     * Creates or updates a role
+     * @param roleDto - The role to create or update
+     * @returns The created or updated role
+     */
+    upsertRole(roleDto: Role): Promise<Role>;
+    /**
+     * Gets a role with its claims
+     * @param roleName - The name of the role
+     * @returns The role with its claims
+     */
+    getRoleWithClaims(roleName: string): Promise<Role>;
+    /**
+     * Deletes a role
+     * @param roleName - The name of the role to delete
+     * @returns Promise that resolves when the role is deleted successfully
+     */
+    deleteRole(roleName: string): Promise<void>;
+}

package/services/auth/client/AuthorizationManagementControllerClient/index.js

@@ -0,0 +1,102 @@
+import { apiInitializationService } from '../../..';
+/**
+ * Client for authorization management operations
+ *
+ * @export
+ * @class AuthorizationManagementControllerClient
+ */
+export class AuthorizationManagementControllerClient {
+    baseControllerPath;
+    /**
+     * Constructor
+     * @param baseControllerPath Base path to API controller
+     */
+    constructor(baseControllerPath = 'AuthorizationManagement') {
+        this.baseControllerPath = baseControllerPath;
+    }
+    /**
+     * Gets all roles in the system
+     * @param includeClaims - Whether to include claims in the response
+     * @returns List of all roles
+     */
+    async getAllRoles(includeClaims) {
+        try {
+            const url = await apiInitializationService.getApiUrl(this.baseControllerPath, `/GetAllRoles?includeClaims=${includeClaims}`);
+            const response = await fetch(url, {
+                credentials: 'include',
+            });
+            if (!response.ok)
+                throw new Error('Failed to fetch all roles');
+            return response.json();
+        }
+        catch (err) {
+            throw err instanceof Error ? err : new Error('Unknown error fetching all roles');
+        }
+    }
+    /**
+     * Creates or updates a role
+     * @param roleDto - The role to create or update
+     * @returns The created or updated role
+     */
+    async upsertRole(roleDto) {
+        try {
+            const url = await apiInitializationService.getApiUrl(this.baseControllerPath, `/UpsertRole`);
+            const response = await fetch(url, {
+                method: 'PUT',
+                headers: {
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify(roleDto),
+                credentials: 'include',
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(errorText || 'Failed to upsert role');
+            }
+            return response.json();
+        }
+        catch (err) {
+            throw err instanceof Error ? err : new Error('Unknown error upserting role');
+        }
+    }
+    /**
+     * Gets a role with its claims
+     * @param roleName - The name of the role
+     * @returns The role with its claims
+     */
+    async getRoleWithClaims(roleName) {
+        try {
+            const url = await apiInitializationService.getApiUrl(this.baseControllerPath, `/GetRoleWithClaims/${encodeURIComponent(roleName)}`);
+            const response = await fetch(url, {
+                credentials: 'include',
+            });
+            if (!response.ok)
+                throw new Error('Failed to fetch role with claims');
+            return response.json();
+        }
+        catch (err) {
+            throw err instanceof Error ? err : new Error('Unknown error fetching role with claims');
+        }
+    }
+    /**
+     * Deletes a role
+     * @param roleName - The name of the role to delete
+     * @returns Promise that resolves when the role is deleted successfully
+     */
+    async deleteRole(roleName) {
+        try {
+            const url = await apiInitializationService.getApiUrl(this.baseControllerPath, `/DeleteRole/${encodeURIComponent(roleName)}`);
+            const response = await fetch(url, {
+                method: 'DELETE',
+                credentials: 'include',
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(errorText || 'Failed to delete role');
+            }
+        }
+        catch (err) {
+            throw err instanceof Error ? err : new Error('Unknown error deleting role');
+        }
+    }
+}

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

@@ -0,0 +1,2 @@
+export * from './AuthorizationManagementControllerClient';
+export * from './AuthService';

package/services/auth/client/index.js

@@ -0,0 +1,2 @@
+export * from './AuthorizationManagementControllerClient';
+export * from './AuthService';

package/services/auth/index.d.ts

@@ -1,50 +1 @@
-import { User, UserInfo } from '../../data';
-export { User, UserInfo };
-/**
- * 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<TId, TUser = User<TId>> {
-    /**
-     * 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<TUser>} Currently logged in user's details
-     * @throws {Error} Error if fetch fails
-     */
-    whoAmI(): Promise<TUser | undefined>;
-    /**
-     * 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<TUser>;
-    /**
-     * Deauthenticates current user
-     *
-     * @return {Promise<void>}
-     * @throws {Error} Error if fetch fails
-     */
-    signout(): Promise<void>;
-    /**
-     * If any API response returns an "Unauthenticated" response, call this method
-     * to update local authentication state to unauthenticated
-     */
-    _handleResponse401(): void;
-}
+export * from './client';

package/services/auth/index.js

@@ -1,113 +1 @@
-import { apiInitializationService } from '..';
-/**
- * AuthService class is responsible for managing user authentication operations.
- * It supports login, logout, and checking the current user's details.
- *
- * @export
- * @class AuthService
- */
-export class AuthService {
-    /**
-     * Holds currently authenticated user's details
-     */
-    user = 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.
-     */
-    async initialize() {
-        // Check user's authentication status
-        await this.whoAmI();
-    }
-    /**
-     * Checks if user is authenticated and retrieves the current user's details if they are
-     *
-     * @return {Promise<TUser>} Currently logged in user's details
-     * @throws {Error} Error if fetch fails
-     */
-    async whoAmI() {
-        try {
-            const url = await apiInitializationService.getApiUrl('/auth/whoami');
-            const response = await fetch(url, { credentials: 'include' });
-            if (response.ok) {
-                const info = await response.json();
-                return (this.user = info.user);
-            }
-            else if (response.status === 401) {
-                return (this.user = undefined);
-            }
-            else {
-                this.user = undefined;
-                throw new Error('Failed checking authentication status');
-            }
-        }
-        catch (error) {
-            throw error instanceof Error ? error : new Error('Failed checking authentication status');
-        }
-    }
-    /**
-     * 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
-     */
-    async signin(username, password) {
-        try {
-            const url = await apiInitializationService.getApiUrl('/auth/signin');
-            const response = await fetch(url, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ username, password }),
-                credentials: 'include',
-            });
-            if (response.ok) {
-                const user = await this.whoAmI();
-                if (user !== undefined) {
-                    return (this.user = user);
-                }
-                else {
-                    throw new Error('Failed signing in');
-                }
-            }
-            else {
-                throw new Error('Failed signing in');
-            }
-        }
-        catch (error) {
-            throw error instanceof Error ? error : new Error('Failed signing in');
-        }
-    }
-    /**
-     * Deauthenticates current user
-     *
-     * @return {Promise<void>}
-     * @throws {Error} Error if fetch fails
-     */
-    async signout() {
-        try {
-            const url = await apiInitializationService.getApiUrl('/auth/signout');
-            const response = await fetch(url, { credentials: 'include' });
-            if (response.ok) {
-                this.user = undefined;
-                return;
-            }
-            else {
-                throw new Error('Failed signing out');
-            }
-        }
-        catch (error) {
-            throw error instanceof Error ? error : new Error('Failed signing out');
-        }
-    }
-    /**
-     * If any API response returns an "Unauthenticated" response, call this method
-     * to update local authentication state to unauthenticated
-     */
-    _handleResponse401() {
-        this.user = undefined;
-    }
-}
+export * from './client';

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

@@ -1,2 +0,0 @@
-export * from './ApiReadControllerClient';
-export * from './ApiCrudControllerClient';

package/services/api/client/index.js

@@ -1,2 +0,0 @@
-export * from './ApiReadControllerClient';
-export * from './ApiCrudControllerClient';