@temboplus/afloat 0.1.53 → 0.1.55

package/{esm/src/features/admin/contract.d.ts → dist/features/admin/admin.contract.d.ts}

@@ -17,9 +17,9 @@ export declare const userManagementContract: {
             eager: z.ZodOptional<z.ZodString>;
         }, z.UnknownKeysParam, z.ZodTypeAny, {
             type?: string | undefined;
+            name?: string | undefined;
             id?: string | undefined;
             resetPassword?: number | undefined;
-            name?: string | undefined;
             identity?: string | undefined;
             profileId?: string | undefined;
             createdAt?: string | undefined;
@@ -30,9 +30,9 @@ export declare const userManagementContract: {
             isArchived?: number | undefined;
         }, {
             type?: string | undefined;
+            name?: string | undefined;
             id?: string | undefined;
             resetPassword?: number | undefined;
-            name?: string | undefined;
             identity?: string | undefined;
             profileId?: string | undefined;
             createdAt?: string | undefined;
@@ -56,21 +56,14 @@ export declare const userManagementContract: {
                 resetPassword: z.ZodBoolean;
                 isActive: z.ZodBoolean;
                 isArchived: z.ZodBoolean;
-                role: z.ZodOptional<z.ZodType<{
-                    id: string;
-                    access: string[];
-                    name: string;
-                    createdAt: string;
-                    updatedAt: string;
-                    description?: string | undefined;
-                }>>;
+                role: z.ZodOptional<z.ZodType<import("./admin.dtos").RoleDTO>>;
                 createdAt: z.ZodString;
                 updatedAt: z.ZodString;
             }, z.UnknownKeysParam, z.ZodTypeAny, {
                 type: string;
+                name: string;
                 id: string;
                 resetPassword: boolean;
-                name: string;
                 identity: string;
                 profileId: string;
                 createdAt: string;
@@ -79,18 +72,18 @@ export declare const userManagementContract: {
                 isActive: boolean;
                 isArchived: boolean;
                 role?: {
+                    name: string;
                     id: string;
                     access: string[];
-                    name: string;
                     createdAt: string;
                     updatedAt: string;
                     description?: string | undefined;
                 } | undefined;
             }, {
                 type: string;
+                name: string;
                 id: string;
                 resetPassword: boolean;
-                name: string;
                 identity: string;
                 profileId: string;
                 createdAt: string;
@@ -99,9 +92,9 @@ export declare const userManagementContract: {
                 isActive: boolean;
                 isArchived: boolean;
                 role?: {
+                    name: string;
                     id: string;
                     access: string[];
-                    name: string;
                     createdAt: string;
                     updatedAt: string;
                     description?: string | undefined;
@@ -147,9 +140,9 @@ export declare const userManagementContract: {
             eager: z.ZodOptional<z.ZodString>;
         }, z.UnknownKeysParam, z.ZodTypeAny, {
             type?: string | undefined;
+            name?: string | undefined;
             id?: string | undefined;
             resetPassword?: number | undefined;
-            name?: string | undefined;
             identity?: string | undefined;
             profileId?: string | undefined;
             createdAt?: string | undefined;
@@ -160,9 +153,9 @@ export declare const userManagementContract: {
             isArchived?: number | undefined;
         }, {
             type?: string | undefined;
+            name?: string | undefined;
             id?: string | undefined;
             resetPassword?: number | undefined;
-            name?: string | undefined;
             identity?: string | undefined;
             profileId?: string | undefined;
             createdAt?: string | undefined;
@@ -186,21 +179,14 @@ export declare const userManagementContract: {
                 resetPassword: z.ZodBoolean;
                 isActive: z.ZodBoolean;
                 isArchived: z.ZodBoolean;
-                role: z.ZodOptional<z.ZodType<{
-                    id: string;
-                    access: string[];
-                    name: string;
-                    createdAt: string;
-                    updatedAt: string;
-                    description?: string | undefined;
-                }>>;
+                role: z.ZodOptional<z.ZodType<import("./admin.dtos").RoleDTO>>;
                 createdAt: z.ZodString;
                 updatedAt: z.ZodString;
             }, z.UnknownKeysParam, z.ZodTypeAny, {
                 type: string;
+                name: string;
                 id: string;
                 resetPassword: boolean;
-                name: string;
                 identity: string;
                 profileId: string;
                 createdAt: string;
@@ -209,18 +195,18 @@ export declare const userManagementContract: {
                 isActive: boolean;
                 isArchived: boolean;
                 role?: {
+                    name: string;
                     id: string;
                     access: string[];
-                    name: string;
                     createdAt: string;
                     updatedAt: string;
                     description?: string | undefined;
                 } | undefined;
             }, {
                 type: string;
+                name: string;
                 id: string;
                 resetPassword: boolean;
-                name: string;
                 identity: string;
                 profileId: string;
                 createdAt: string;
@@ -229,9 +215,9 @@ export declare const userManagementContract: {
                 isActive: boolean;
                 isArchived: boolean;
                 role?: {
+                    name: string;
                     id: string;
                     access: string[];
-                    name: string;
                     createdAt: string;
                     updatedAt: string;
                     description?: string | undefined;
@@ -274,14 +260,14 @@ export declare const userManagementContract: {
             name: string;
             identity: string;
             resetPassword?: boolean | undefined;
-            password?: string | undefined;
             roleId?: string | undefined;
+            password?: string | undefined;
         }, {
             name: string;
             identity: string;
             resetPassword?: boolean | undefined;
-            password?: string | undefined;
             roleId?: string | undefined;
+            password?: string | undefined;
         }>;
         path: "/login";
         responses: {
@@ -297,8 +283,8 @@ export declare const userManagementContract: {
                 createdAt: z.ZodString;
             }, z.UnknownKeysParam, z.ZodTypeAny, {
                 type: string;
-                id: string;
                 name: string;
+                id: string;
                 identity: string;
                 profileId: string;
                 createdAt: string;
@@ -307,8 +293,8 @@ export declare const userManagementContract: {
                 isArchived: boolean;
             }, {
                 type: string;
-                id: string;
                 name: string;
+                id: string;
                 identity: string;
                 profileId: string;
                 createdAt: string;
@@ -367,17 +353,17 @@ export declare const userManagementContract: {
             resetPassword: z.ZodOptional<z.ZodBoolean>;
             isActive: z.ZodOptional<z.ZodBoolean>;
         }, z.UnknownKeysParam, z.ZodTypeAny, {
-            resetPassword?: boolean | undefined;
             name?: string | undefined;
-            password?: string | undefined;
+            resetPassword?: boolean | undefined;
             roleId?: string | undefined;
             isActive?: boolean | undefined;
+            password?: string | undefined;
         }, {
-            resetPassword?: boolean | undefined;
             name?: string | undefined;
-            password?: string | undefined;
+            resetPassword?: boolean | undefined;
             roleId?: string | undefined;
             isActive?: boolean | undefined;
+            password?: string | undefined;
         }>;
         path: "/login/:id";
         responses: {
@@ -391,21 +377,14 @@ export declare const userManagementContract: {
                 resetPassword: z.ZodBoolean;
                 isActive: z.ZodBoolean;
                 isArchived: z.ZodBoolean;
-                role: z.ZodOptional<z.ZodType<{
-                    id: string;
-                    access: string[];
-                    name: string;
-                    createdAt: string;
-                    updatedAt: string;
-                    description?: string | undefined;
-                }>>;
+                role: z.ZodOptional<z.ZodType<import("./admin.dtos").RoleDTO>>;
                 createdAt: z.ZodString;
                 updatedAt: z.ZodString;
             }, z.UnknownKeysParam, z.ZodTypeAny, {
                 type: string;
+                name: string;
                 id: string;
                 resetPassword: boolean;
-                name: string;
                 identity: string;
                 profileId: string;
                 createdAt: string;
@@ -414,18 +393,18 @@ export declare const userManagementContract: {
                 isActive: boolean;
                 isArchived: boolean;
                 role?: {
+                    name: string;
                     id: string;
                     access: string[];
-                    name: string;
                     createdAt: string;
                     updatedAt: string;
                     description?: string | undefined;
                 } | undefined;
             }, {
                 type: string;
+                name: string;
                 id: string;
                 resetPassword: boolean;
-                name: string;
                 identity: string;
                 profileId: string;
                 createdAt: string;
@@ -434,9 +413,9 @@ export declare const userManagementContract: {
                 isActive: boolean;
                 isArchived: boolean;
                 role?: {
+                    name: string;
                     id: string;
                     access: string[];
-                    name: string;
                     createdAt: string;
                     updatedAt: string;
                     description?: string | undefined;
@@ -499,21 +478,14 @@ export declare const userManagementContract: {
                 resetPassword: z.ZodBoolean;
                 isActive: z.ZodBoolean;
                 isArchived: z.ZodBoolean;
-                role: z.ZodOptional<z.ZodType<{
-                    id: string;
-                    access: string[];
-                    name: string;
-                    createdAt: string;
-                    updatedAt: string;
-                    description?: string | undefined;
-                }>>;
+                role: z.ZodOptional<z.ZodType<import("./admin.dtos").RoleDTO>>;
                 createdAt: z.ZodString;
                 updatedAt: z.ZodString;
             }, z.UnknownKeysParam, z.ZodTypeAny, {
                 type: string;
+                name: string;
                 id: string;
                 resetPassword: boolean;
-                name: string;
                 identity: string;
                 profileId: string;
                 createdAt: string;
@@ -522,18 +494,18 @@ export declare const userManagementContract: {
                 isActive: boolean;
                 isArchived: boolean;
                 role?: {
+                    name: string;
                     id: string;
                     access: string[];
-                    name: string;
                     createdAt: string;
                     updatedAt: string;
                     description?: string | undefined;
                 } | undefined;
             }, {
                 type: string;
+                name: string;
                 id: string;
                 resetPassword: boolean;
-                name: string;
                 identity: string;
                 profileId: string;
                 createdAt: string;
@@ -542,9 +514,9 @@ export declare const userManagementContract: {
                 isActive: boolean;
                 isArchived: boolean;
                 role?: {
+                    name: string;
                     id: string;
                     access: string[];
-                    name: string;
                     createdAt: string;
                     updatedAt: string;
                     description?: string | undefined;
@@ -597,21 +569,14 @@ export declare const userManagementContract: {
                 resetPassword: z.ZodBoolean;
                 isActive: z.ZodBoolean;
                 isArchived: z.ZodBoolean;
-                role: z.ZodOptional<z.ZodType<{
-                    id: string;
-                    access: string[];
-                    name: string;
-                    createdAt: string;
-                    updatedAt: string;
-                    description?: string | undefined;
-                }>>;
+                role: z.ZodOptional<z.ZodType<import("./admin.dtos").RoleDTO>>;
                 createdAt: z.ZodString;
                 updatedAt: z.ZodString;
             }, z.UnknownKeysParam, z.ZodTypeAny, {
                 type: string;
+                name: string;
                 id: string;
                 resetPassword: boolean;
-                name: string;
                 identity: string;
                 profileId: string;
                 createdAt: string;
@@ -620,18 +585,18 @@ export declare const userManagementContract: {
                 isActive: boolean;
                 isArchived: boolean;
                 role?: {
+                    name: string;
                     id: string;
                     access: string[];
-                    name: string;
                     createdAt: string;
                     updatedAt: string;
                     description?: string | undefined;
                 } | undefined;
             }, {
                 type: string;
+                name: string;
                 id: string;
                 resetPassword: boolean;
-                name: string;
                 identity: string;
                 profileId: string;
                 createdAt: string;
@@ -640,9 +605,9 @@ export declare const userManagementContract: {
                 isActive: boolean;
                 isArchived: boolean;
                 role?: {
+                    name: string;
                     id: string;
                     access: string[];
-                    name: string;
                     createdAt: string;
                     updatedAt: string;
                     description?: string | undefined;
@@ -745,16 +710,16 @@ export declare const userManagementContract: {
                 createdAt: z.ZodString;
                 updatedAt: z.ZodString;
             }, z.UnknownKeysParam, z.ZodTypeAny, {
+                name: string;
                 id: string;
                 access: string[];
-                name: string;
                 createdAt: string;
                 updatedAt: string;
                 description?: string | undefined;
             }, {
+                name: string;
                 id: string;
                 access: string[];
-                name: string;
                 createdAt: string;
                 updatedAt: string;
                 description?: string | undefined;
@@ -796,16 +761,16 @@ export declare const userManagementContract: {
                 createdAt: z.ZodString;
                 updatedAt: z.ZodString;
             }, z.UnknownKeysParam, z.ZodTypeAny, {
+                name: string;
                 id: string;
                 access: string[];
-                name: string;
                 createdAt: string;
                 updatedAt: string;
                 description?: string | undefined;
             }, {
+                name: string;
                 id: string;
                 access: string[];
-                name: string;
                 createdAt: string;
                 updatedAt: string;
                 description?: string | undefined;
@@ -839,4 +804,3 @@ export declare const userManagementContract: {
  * Use this type for strongly typed API client implementations.
  */
 export type UserManagementContract = typeof userManagementContract;
-//# sourceMappingURL=contract.d.ts.map

package/{script/src/features/admin/schemas.d.ts → dist/features/admin/admin.dtos.d.ts}

@@ -30,7 +30,7 @@ type _ManagedUserType = z.ZodObject<{
     resetPassword: z.ZodBoolean;
     isActive: z.ZodBoolean;
     isArchived: z.ZodBoolean;
-    role: z.ZodOptional<z.ZodType<Role>>;
+    role: z.ZodOptional<z.ZodType<RoleDTO>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }>;
@@ -101,7 +101,7 @@ type _ManagedUserQueryParamsType = z.ZodObject<{
  * Collection of user management schemas for export.
  * Provides access to all user and role validation schemas.
  */
-export declare const UserManagementSchemas: {
+export declare const UserManagementDTOSchemas: {
     role: _RoleType;
     managedUser: _ManagedUserType;
     managedUserQueryParams: _ManagedUserQueryParamsType;
@@ -115,32 +115,31 @@ export declare const UserManagementSchemas: {
  * TypeScript type for a validated role object.
  * Use this type for role instances that have been validated against the schema.
  */
-type Role = z.infer<typeof UserManagementSchemas.role>;
+export type RoleDTO = z.infer<typeof UserManagementDTOSchemas.role>;
 /**
  * TypeScript type for a create user request object.
  * Use this type for user creation requests that have been validated against the schema.
  */
-export type CreateUserRequest = z.infer<typeof UserManagementSchemas.createUserRequest>;
+export type CreateUserRequestDTO = z.infer<typeof UserManagementDTOSchemas.createUserRequest>;
 /**
  * TypeScript type for an update user request object.
  * Use this type for user update requests that have been validated against the schema.
  */
-export type UpdateUserRequest = z.infer<typeof UserManagementSchemas.updateUserRequest>;
+export type UpdateUserRequestDTO = z.infer<typeof UserManagementDTOSchemas.updateUserRequest>;
 /**
  * TypeScript type for a reset password request object.
  * Use this type for password reset requests that have been validated against the schema.
  */
-export type ResetPasswordRequest = z.infer<typeof UserManagementSchemas.resetPasswordRequest>;
+export type ResetPasswordRequestDTO = z.infer<typeof UserManagementDTOSchemas.resetPasswordRequest>;
 /**
  * TypeScript type for a create user response object.
  * Use this type for user creation responses that have been validated against the schema.
  */
-export type CreateUserResponse = z.infer<typeof UserManagementSchemas.createUserResponse>;
+export type CreateUserResponseDTO = z.infer<typeof UserManagementDTOSchemas.createUserResponse>;
 /**
  * TypeScript type for managed user query parameters.
  * Use this type for query parameter objects that have been validated against the schema.
  * All fields are optional to allow flexible filtering and searching.
  */
-export type ManagedUserQueryParams = z.infer<typeof UserManagementSchemas.managedUserQueryParams>;
+export type ManagedUserQueryParamsDTO = z.infer<typeof UserManagementDTOSchemas.managedUserQueryParams>;
 export {};
-//# sourceMappingURL=schemas.d.ts.map

package/dist/features/admin/admin.repository.d.ts

@@ -0,0 +1,179 @@
+import { BaseRepository } from "@/lib/api";
+import { userManagementContract } from "./admin.contract";
+import type { CreateUserRequestDTO, CreateUserResponseDTO, ManagedUserQueryParamsDTO, ResetPasswordRequestDTO, UpdateUserRequestDTO } from "./admin.dtos";
+import { Role } from "@/models/role.model";
+import { ManagedUser } from "@/models/managed-user.model";
+/**
+ * Repository class for managing user accounts through API interactions.
+ * Handles user creation, updates, archiving, and role management.
+ *
+ * This repository handles pure API communication without permission checking.
+ * Permission validation should be handled at the service layer or route handlers.
+ *
+ * @extends {BaseRepository<typeof userManagementContract>}
+ *
+ * @example
+ * ```typescript
+ * const repo = new UserManagementRepository({ token: adminToken });
+ * const users = await repo.getAllUsers();
+ * ```
+ */
+export declare class UserManagementRepository extends BaseRepository<typeof userManagementContract> {
+    /**
+     * Creates an instance of UserManagementRepository using the user management contract.
+     *
+     * @param options - Optional configuration
+     * @param options.token - Authentication token for API calls
+     * @param options.root - Custom API root URL
+     *
+     * @example
+     * ```typescript
+     * const repo = new UserManagementRepository({
+     *   token: "admin-auth-token",
+     *   root: "https://api-staging.afloat.money/v1"
+     * });
+     * ```
+     */
+    constructor(options?: {
+        token?: string;
+        root?: string;
+    });
+    /**
+     * Creates a new user account.
+     *
+     * @param input - The data required to create a new user account
+     * @returns Promise that resolves to the newly created user response
+     * @throws {APIError} If the creation operation fails
+     *
+     * @example
+     * ```typescript
+     * const newUser = await repo.createUser({
+     *   email: "newuser@example.com",
+     *   name: "New User",
+     *   roleId: "role-id"
+     * });
+     * ```
+     */
+    createUser(input: CreateUserRequestDTO): Promise<CreateUserResponseDTO>;
+    /**
+     * Updates an existing user account by ID.
+     *
+     * @param id - The unique identifier of the user account to update
+     * @param input - The data to update the user account with
+     * @returns Promise that resolves to the updated user account
+     * @throws {APIError} If the update operation fails
+     *
+     * @example
+     * ```typescript
+     * const updatedUser = await repo.updateUser("user-id", {
+     *   name: "Updated Name",
+     *   email: "updated@example.com"
+     * });
+     * ```
+     */
+    updateUser(id: string, input: UpdateUserRequestDTO): Promise<ManagedUser>;
+    /**
+     * Archives (soft deletes) a user account by ID.
+     *
+     * @param id - The unique identifier of the user account to archive
+     * @returns Promise that resolves to the updated user object
+     * @throws {APIError} If the archive operation fails
+     *
+     * @example
+     * ```typescript
+     * const archivedUser = await repo.archiveUser("user-id");
+     * ```
+     */
+    archiveUser(id: string): Promise<ManagedUser>;
+    /**
+     * Unarchives a previously archived user account by ID.
+     *
+     * @param id - The unique identifier of the user account to unarchive
+     * @returns Promise that resolves to the updated user object
+     * @throws {APIError} If the unarchive operation fails
+     *
+     * @example
+     * ```typescript
+     * const restoredUser = await repo.unArchiveUser("user-id");
+     * ```
+     */
+    unArchiveUser(id: string): Promise<ManagedUser>;
+    /**
+     * Resets a user's password.
+     *
+     * @param id - The unique identifier of the user account
+     * @param input - Optional password reset configuration
+     * @returns Promise that resolves to success status
+     * @throws {APIError} If the password reset operation fails
+     *
+     * @example
+     * ```typescript
+     * const result = await repo.resetUserPassword("user-id", {
+     *   sendEmail: true
+     * });
+     * ```
+     */
+    resetUserPassword(id: string, input?: ResetPasswordRequestDTO): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Retrieves all user accounts.
+     * Results are ordered in descending order by creation date by default.
+     *
+     * @param query - Optional query parameters for filtering and eager loading
+     * @returns Promise that resolves to an array of managed users
+     * @throws {APIError} If the fetch operation fails
+     *
+     * @example
+     * ```typescript
+     * // Get all users with role information
+     * const users = await repo.getAllUsers({ eager: "role" });
+     *
+     * // Get users with custom query
+     * const activeUsers = await repo.getAllUsers({ status: "active" });
+     * ```
+     */
+    getAllUsers(query?: ManagedUserQueryParamsDTO): Promise<ManagedUser[]>;
+    /**
+     * Retrieves a specific user account by ID.
+     *
+     * @param id - The unique identifier of the user account to retrieve
+     * @param query - Optional query parameters for eager loading
+     * @returns Promise that resolves to the managed user
+     * @throws {APIError} If the user is not found or fetch operation fails
+     *
+     * @example
+     * ```typescript
+     * const user = await repo.getUser("user-id", { eager: "role" });
+     * console.log(`User: ${user.name}, Role: ${user.role?.name}`);
+     * ```
+     */
+    getUser(id: string, query?: ManagedUserQueryParamsDTO): Promise<ManagedUser>;
+    /**
+     * Retrieves all available roles in the system.
+     *
+     * @returns Promise that resolves to an array of roles
+     * @throws {APIError} If the fetch operation fails
+     *
+     * @example
+     * ```typescript
+     * const roles = await repo.getAllRoles();
+     * roles.forEach(role => console.log(`Role: ${role.name}`));
+     * ```
+     */
+    getAllRoles(): Promise<Role[]>;
+    /**
+     * Retrieves a specific role by ID.
+     *
+     * @param id - The unique identifier of the role to retrieve
+     * @returns Promise that resolves to the role
+     * @throws {APIError} If the role is not found or fetch operation fails
+     *
+     * @example
+     * ```typescript
+     * const role = await repo.getRole("role-id");
+     * console.log(`Role: ${role.name}, Permissions: ${role.permissions.length}`);
+     * ```
+     */
+    getRole(id: string): Promise<Role>;
+}

package/dist/features/admin/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./admin.repository";
+export * from "./admin.dtos";

package/{esm/src/features/auth/access/contract.d.ts → dist/features/auth/access/access.api-contract.d.ts}

@@ -11,4 +11,3 @@ export declare const accessContract: {
         };
     };
 };
-//# sourceMappingURL=contract.d.ts.map