@temboplus/afloat 0.1.11 → 0.1.13

package/README.md

@@ -8,7 +8,7 @@ This JavaScript/TypeScript package provides a central hub for shared utilities,
 
 * **Abstracted Server Communication**
     * Simplifies front-end development by abstracting all interactions with the server behind model-specific repositories
-    * Front-end projects only need to interact with these repositories, decoupling them from the underlying API implementation
+    * Consuming projects only need to interact with these repositories, decoupling them from the underlying API implementation
 
 * **Shared Utilities**
     * Provides a collection of reusable helper functions for common tasks across Afloat projects, such as error handling
@@ -18,4 +18,122 @@ This JavaScript/TypeScript package provides a central hub for shared utilities,
 
 * **Enhanced Maintainability**
     * Centralizes common logic, making it easier to maintain and update across all consuming projects
-    * Reduces code duplication and improves consistency
+    * Reduces code duplication and improves consistency
+
+* **Cross-Environment Compatibility**
+    * Works seamlessly in both client-side and server-side environments
+    * Supports both synchronous and asynchronous initialization patterns
+
+## Usage
+
+### Authentication Setup
+
+#### Client-Side Usage
+
+In client-side applications, authentication is initialized synchronously:
+
+```typescript
+import { AfloatAuth } from "@temboplus/afloat";
+
+// Initialize client auth (typically in your app entry point)
+const auth = AfloatAuth.instance;
+
+// Check if user is authenticated
+console.log("User authenticated:", !!auth.currentUser);
+
+// Access current user
+const user = auth.currentUser;
+if (user) {
+  console.log(`Logged in as: ${user.email}`);
+}
+```
+
+#### Server-Side Usage
+
+In server-side environments, authentication requires asynchronous initialization:
+
+```typescript
+import { AfloatAuth } from "@temboplus/afloat";
+
+// In a server route handler or similar context
+async function handleRequest(req, res) {
+  try {
+    // Extract token from request
+    const token = req.headers.authorization?.replace('Bearer ', '');
+    
+    if (!token) {
+      return res.status(401).json({ error: 'Unauthorized' });
+    }
+    
+    // Initialize server-side auth
+    const auth = await AfloatAuth.initializeServer(token);
+    
+    // Now you can use auth for permission checks
+    const isAdmin = auth.checkPermission(Permissions.Payout.View);
+    
+    // Continue with your handler logic...
+  } catch (error) {
+    console.error('Authentication error:', error);
+    return res.status(500).json({ error: 'Authentication failed' });
+  }
+}
+```
+
+### Using Repositories
+
+Repositories provide a consistent interface for data operations across environments.
+
+#### Client-Side Repository Usage
+
+```typescript
+import { WalletRepo } from "@temboplus/afloat";
+
+// Create repository - auth is automatically handled
+const walletRepo = new WalletRepo();
+
+// Use repository methods
+async function displayBalance() {
+  try {
+    const balance = await walletRepo.getBalance();
+    console.log(`Current balance: ${balance}`);
+  } catch (error) {
+    console.error('Error fetching balance:', error);
+  }
+}
+```
+
+#### Server-Side Repository Usage
+
+```typescript
+import { AfloatAuth, WalletRepo } from "@temboplus/afloat";
+
+async function processServerRequest(token) {
+  // Initialize auth for this request
+  const auth = await AfloatAuth.initializeServer(token);
+  
+  // Create repository with explicit auth instance
+  const walletRepo = new WalletRepo({ auth });
+  
+  // Use repository methods
+  const balance = await walletRepo.getBalance();
+  const wallets = await walletRepo.getWallets();
+  
+  return { balance, wallets };
+}
+```
+
+## Best Practices
+
+1. **Client-Side Applications**
+   - Initialize `AfloatAuth.instance` early in your application lifecycle
+   - Create repositories without explicit auth parameters
+   - Handle permission errors appropriately in your UI
+
+2. **Server-Side Applications**
+   - Always use `await AfloatAuth.initializeServer(token)` for each request
+   - Pass the auth instance explicitly to repositories
+   - Implement proper error handling for authentication failures
+
+3. **Testing**
+   - Use the `AuthContext` to inject mock auth instances during testing
+   - Reset `AuthContext.current` after each test to prevent test pollution

package/esm/src/features/auth/manager.d.ts

@@ -1,5 +1,13 @@
 import type { User } from "../../models/index.js";
 import type { Permission } from "../../models/permission.js";
+/**
+ * Global context to hold the current auth instance reference.
+ * This provides a way to access the auth instance across the application
+ * without directly coupling to the singleton pattern.
+ */
+export declare const AuthContext: {
+    current: AfloatAuth | undefined;
+};
 /**
  * Main authentication class that works in both client and server environments.
  * Provides authentication functionality and user management.
@@ -12,7 +20,7 @@ export declare class AfloatAuth {
     /** client AfloatAuth instance */
     private static _instance;
     /**
-     * Private constructor to prevent direct instantiation.
+     * Private constructor to maintain control over instantiation.
      * @param {AuthStore} store - The auth store implementation to use
      * @param {TokenHandler} tokenHandler - The token handler implementation to use
      */

package/esm/src/features/auth/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/src/features/auth/manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAU7D;;;GAGG;AACH,qBAAa,UAAU;IACrB,oCAAoC;IACpC,OAAO,CAAC,KAAK,CAAY;IAEzB,uCAAuC;IACvC,OAAO,CAAC,YAAY,CAAe;IAEnC,iCAAiC;IACjC,OAAO,CAAC,MAAM,CAAC,SAAS,CAA2B;IACnD;;;;OAIG;IACH,OAAO;IAKP;;;;;;;;;;;;OAYG;IACH,WAAkB,QAAQ,IAAI,UAAU,CAKvC;IAED;;;;;;;OAOG;WACiB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAyBxE;;;;OAIG;IACH,OAAO,KAAK,IAAI,GAEf;IAED;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC;;;OAGG;IACH,IAAI,WAAW,IAAI,IAAI,GAAG,SAAS,CAElC;IAED;;;;OAIG;IACH,cAAc,IAAI,IAAI,GAAG,SAAS;IAIlC;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAI1C;;;;;;OAMG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D;;;;;;OAMG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMvE;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;;OAGG;IACH,OAAO,CAAC,cAAc;CAIvB"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/src/features/auth/manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAU7D;;;;GAIG;AACH,eAAO,MAAM,WAAW;aAEA,UAAU,GAAG,SAAS;CAC7C,CAAC;AAEF;;;GAGG;AACH,qBAAa,UAAU;IACrB,oCAAoC;IACpC,OAAO,CAAC,KAAK,CAAY;IAEzB,uCAAuC;IACvC,OAAO,CAAC,YAAY,CAAe;IAEnC,iCAAiC;IACjC,OAAO,CAAC,MAAM,CAAC,SAAS,CAA2B;IAEnD;;;;OAIG;IACH,OAAO;IAKP;;;;;;;;;;;;OAYG;IACH,WAAkB,QAAQ,IAAI,UAAU,CAYvC;IAED;;;;;;;OAOG;WACiB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA8BxE;;;;OAIG;IACH,OAAO,KAAK,IAAI,GAEf;IAED;;;OAGG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC;;;OAGG;IACH,IAAI,WAAW,IAAI,IAAI,GAAG,SAAS,CAElC;IAED;;;;OAIG;IACH,cAAc,IAAI,IAAI,GAAG,SAAS;IAIlC;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAI1C;;;;;;OAMG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D;;;;;;OAMG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMvE;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;;OAGG;IACH,OAAO,CAAC,cAAc;CAIvB"}

package/esm/src/features/auth/manager.js

@@ -3,13 +3,22 @@ import { createClientStore, useClientUser, } from "./storage/client_store.js";
 import { ClientTokenHandler } from "./storage/client_token_handler.js";
 import { ServerStore } from "./storage/server_store.js";
 import { ServerTokenHandler } from "./storage/server_token_handler.js";
+/**
+ * Global context to hold the current auth instance reference.
+ * This provides a way to access the auth instance across the application
+ * without directly coupling to the singleton pattern.
+ */
+export const AuthContext = {
+    // Default undefined state - will be set during initialization
+    current: undefined,
+};
 /**
  * Main authentication class that works in both client and server environments.
  * Provides authentication functionality and user management.
  */
 export class AfloatAuth {
     /**
-     * Private constructor to prevent direct instantiation.
+     * Private constructor to maintain control over instantiation.
      * @param {AuthStore} store - The auth store implementation to use
      * @param {TokenHandler} tokenHandler - The token handler implementation to use
      */
@@ -45,7 +54,12 @@ export class AfloatAuth {
      * const serverAuth = await AfloatAuth.initializeServer(token);
      */
     static get instance() {
-        return AfloatAuth._instance || (AfloatAuth._instance = new AfloatAuth(createClientStore(), ClientTokenHandler.instance));
+        if (!AfloatAuth._instance) {
+            AfloatAuth._instance = new AfloatAuth(createClientStore(), ClientTokenHandler.instance);
+            // Set as current instance for global access
+            AuthContext.current = AfloatAuth._instance;
+        }
+        return AfloatAuth._instance;
     }
     /**
      * Creates a new server-side instance of AfloatAuth.
@@ -66,7 +80,10 @@ export class AfloatAuth {
             const user = await tokenHandler.constructUser();
             store.setUser(user);
             // Create and initialize auth instance
-            return new AfloatAuth(store, tokenHandler);
+            const auth = new AfloatAuth(store, tokenHandler);
+            // Set as current instance for global access
+            AuthContext.current = auth;
+            return auth;
         }
         catch (error) {
             if (error instanceof Error) {

package/esm/src/features/contact/repository.d.ts

@@ -1,6 +1,7 @@
 import { BaseRepository } from "../../shared/base_repository.js";
 import { contract } from "./contract.js";
 import { Contact, type ContactInput } from "../../models/contact/index.js";
+import type { AfloatAuth } from "../auth/manager.js";
 /**
  * Repository class for managing `Contact` data through API interactions.
  * Extends the `BaseRepository` to leverage shared functionality.
@@ -8,12 +9,19 @@ import { Contact, type ContactInput } from "../../models/contact/index.js";
 export declare class ContactRepository extends BaseRepository<typeof contract> {
     /**
      * Creates an instance of `ContactRepository` using the contact contract.
+     * @param {Object} [props] - Optional constructor properties
+     * @param {AfloatAuth} [props.auth] - Optional auth instance to use
+     * @param {string} [props.root] - Optional API root URL
      */
-    constructor();
+    constructor(props?: {
+        auth?: AfloatAuth;
+        root?: string;
+    });
     /**
      * Creates a new contact record.
      * @param {ContactInput} input - The data required to create a new contact.
      * @returns {Promise<Contact>} A promise that resolves to the newly created contact.
+     * @throws {PermissionError} If the user lacks required permissions
      * @throws {APIError} If the response status code is not 201.
      */
     create(input: ContactInput): Promise<Contact>;
@@ -22,6 +30,7 @@ export declare class ContactRepository extends BaseRepository<typeof contract> {
      * @param {string} id - The unique identifier of the contact to edit.
      * @param {ContactInput} input - The data to update the contact with.
      * @returns {Promise<Contact>} A promise that resolves to the updated contact.
+     * @throws {PermissionError} If the user lacks required permissions
      * @throws {APIError} If the response status code is not 200.
      */
     edit(id: string, input: ContactInput): Promise<Contact>;
@@ -29,6 +38,7 @@ export declare class ContactRepository extends BaseRepository<typeof contract> {
      * Deletes a contact record by ID.
      * @param {string} id - The unique identifier of the contact to remove.
      * @returns {Promise<void>} A promise that resolves when the deletion is complete.
+     * @throws {PermissionError} If the user lacks required permissions
      * @throws {APIError} If the response status code is not 200.
      */
     remove(id: string): Promise<void>;
@@ -37,6 +47,7 @@ export declare class ContactRepository extends BaseRepository<typeof contract> {
      * Results are ordered in descending order by default.
      *
      * @returns {Promise<Contact[]>} A promise that resolves to an array of contacts.
+     * @throws {PermissionError} If the user lacks required permissions
      * @throws {APIError} If the response status code is not 200 or the range is invalid.
      * @example
      * const repository = new ContactRepository();

package/esm/src/features/contact/repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../src/src/features/contact/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,OAAO,EAEP,KAAK,YAAY,EAClB,MAAM,+BAA+B,CAAC;AAKvC;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,OAAO,QAAQ,CAAC;IACpE;;OAEG;;IAKH;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAanD;;;;;;OAMG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAgB7D;;;;;OAKG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvC;;;;;;;;;OASG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;CAanC"}
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../src/src/features/contact/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,OAAO,EAEP,KAAK,YAAY,EAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,OAAO,QAAQ,CAAC;IACpE;;;;;OAKG;gBACS,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,UAAU,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAIxD;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBnD;;;;;;;OAOG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB7D;;;;;;OAMG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAevC;;;;;;;;;;OAUG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;CAgBnC"}

package/esm/src/features/contact/repository.js

@@ -1,7 +1,6 @@
 import { BaseRepository } from "../../shared/base_repository.js";
 import { contract } from "./contract.js";
 import { Contact, } from "../../models/contact/index.js";
-import { AfloatAuth } from "../auth/index.js";
 import { Permissions } from "../../models/index.js";
 import { PermissionError } from "../../errors/index.js";
 /**
@@ -11,21 +10,27 @@ import { PermissionError } from "../../errors/index.js";
 export class ContactRepository extends BaseRepository {
     /**
      * Creates an instance of `ContactRepository` using the contact contract.
+     * @param {Object} [props] - Optional constructor properties
+     * @param {AfloatAuth} [props.auth] - Optional auth instance to use
+     * @param {string} [props.root] - Optional API root URL
      */
-    constructor() {
-        super("contact", contract);
+    constructor(props) {
+        super("contact", contract, props);
     }
     /**
      * Creates a new contact record.
      * @param {ContactInput} input - The data required to create a new contact.
      * @returns {Promise<Contact>} A promise that resolves to the newly created contact.
+     * @throws {PermissionError} If the user lacks required permissions
      * @throws {APIError} If the response status code is not 201.
      */
     async create(input) {
-        if (!AfloatAuth.instance.checkPermission(Permissions.Contact.Create)) {
+        const auth = this.getAuthForPermissionCheck();
+        const requiredPerm = Permissions.Contact.Create;
+        if (!auth.checkPermission(requiredPerm)) {
             throw new PermissionError({
                 message: "You are not authorized to add contacts.",
-                requiredPermissions: [Permissions.Contact.Create],
+                requiredPermissions: [requiredPerm],
             });
         }
         const result = await this.client.postContact({ body: input });
@@ -37,13 +42,16 @@ export class ContactRepository extends BaseRepository {
      * @param {string} id - The unique identifier of the contact to edit.
      * @param {ContactInput} input - The data to update the contact with.
      * @returns {Promise<Contact>} A promise that resolves to the updated contact.
+     * @throws {PermissionError} If the user lacks required permissions
      * @throws {APIError} If the response status code is not 200.
      */
     async edit(id, input) {
-        if (!AfloatAuth.instance.checkPermission(Permissions.Contact.Update)) {
+        const auth = this.getAuthForPermissionCheck();
+        const requiredPerm = Permissions.Contact.Update;
+        if (!auth.checkPermission(requiredPerm)) {
             throw new PermissionError({
                 message: "You are not authorized to update contacts.",
-                requiredPermissions: [Permissions.Contact.Update],
+                requiredPermissions: [requiredPerm],
             });
         }
         const result = await this.client.editContact({
@@ -57,13 +65,16 @@ export class ContactRepository extends BaseRepository {
      * Deletes a contact record by ID.
      * @param {string} id - The unique identifier of the contact to remove.
      * @returns {Promise<void>} A promise that resolves when the deletion is complete.
+     * @throws {PermissionError} If the user lacks required permissions
      * @throws {APIError} If the response status code is not 200.
      */
     async remove(id) {
-        if (!AfloatAuth.instance.checkPermission(Permissions.Contact.Delete)) {
+        const auth = this.getAuthForPermissionCheck();
+        const requiredPerm = Permissions.Contact.Delete;
+        if (!auth.checkPermission(requiredPerm)) {
             throw new PermissionError({
                 message: "You are not authorized to delete contacts.",
-                requiredPermissions: [Permissions.Contact.Delete],
+                requiredPermissions: [requiredPerm],
             });
         }
         const result = await this.client.deleteContact({ params: { id } });
@@ -74,16 +85,19 @@ export class ContactRepository extends BaseRepository {
      * Results are ordered in descending order by default.
      *
      * @returns {Promise<Contact[]>} A promise that resolves to an array of contacts.
+     * @throws {PermissionError} If the user lacks required permissions
      * @throws {APIError} If the response status code is not 200 or the range is invalid.
      * @example
      * const repository = new ContactRepository();
      * repository.getAll().then(contacts => console.log(contacts));
      */
     async getAll() {
-        if (!AfloatAuth.instance.checkPermission(Permissions.Contact.List)) {
+        const auth = this.getAuthForPermissionCheck();
+        const requiredPerm = Permissions.Contact.List;
+        if (!auth.checkPermission(requiredPerm)) {
             throw new PermissionError({
                 message: "You are not authorized to view contacts.",
-                requiredPermissions: [Permissions.Contact.List],
+                requiredPermissions: [requiredPerm],
             });
         }
         const query = { orderByDesc: "createdAt" };

package/esm/src/features/files-gen/repository.d.ts

@@ -2,6 +2,7 @@ import { contract } from "./contract.js";
 import { BaseRepository } from "../../shared/index.js";
 import type { ClientInferRequest, ClientInferResponseBody } from "@ts-rest/core";
 import type { StatementFile } from "../../models/wallet/index.js";
+import type { AfloatAuth } from "../auth/index.js";
 /**
  * Type definition for statement generation input parameters.
  * Inferred from the contract's genStatementPDF endpoint request body.
@@ -24,7 +25,9 @@ export declare class AfloatFilesRepo extends BaseRepository<typeof contract> {
      * Creates an instance of AfloatFilesRepo initialized with the files generation contract.
      * Configures the repository with the PDF maker service endpoint.
      */
-    constructor();
+    constructor(props?: {
+        auth?: AfloatAuth;
+    });
     /**
      * Generates and downloads a statement PDF based on the provided parameters.
      * @param {GenStatementInput} body - The statement generation parameters

package/esm/src/features/files-gen/repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../src/src/features/files-gen/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;;GAIG;AACH,KAAK,iBAAiB,GAAG,kBAAkB,CACzC,OAAO,QAAQ,CAAC,eAAe,CAChC,CAAC,MAAM,CAAC,CAAC;AAEV;;;;GAIG;AACH,KAAK,yBAAyB,GAAG,uBAAuB,CACtD,OAAO,QAAQ,CAAC,oBAAoB,CACrC,CAAC;AAEF;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,cAAc,CAAC,OAAO,QAAQ,CAAC;IAClE;;;OAGG;;IAQH;;;;;;;;;OASG;IACG,iBAAiB,CACrB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,aAAa,CAAC;IAUzB;;;;OAIG;IACG,oBAAoB,IAAI,OAAO,CAAC,yBAAyB,CAAC;CAWjE"}
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../src/src/features/files-gen/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;GAIG;AACH,KAAK,iBAAiB,GAAG,kBAAkB,CACzC,OAAO,QAAQ,CAAC,eAAe,CAChC,CAAC,MAAM,CAAC,CAAC;AAEV;;;;GAIG;AACH,KAAK,yBAAyB,GAAG,uBAAuB,CACtD,OAAO,QAAQ,CAAC,oBAAoB,CACrC,CAAC;AAEF;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,cAAc,CAAC,OAAO,QAAQ,CAAC;IAClE;;;OAGG;gBACS,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,UAAU,CAAA;KAAE;IAQzC;;;;;;;;;OASG;IACG,iBAAiB,CACrB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,aAAa,CAAC;IAiBzB;;;;OAIG;IACG,oBAAoB,IAAI,OAAO,CAAC,yBAAyB,CAAC;CAWjE"}

package/esm/src/features/files-gen/repository.js

@@ -11,10 +11,11 @@ export class AfloatFilesRepo extends BaseRepository {
      * Creates an instance of AfloatFilesRepo initialized with the files generation contract.
      * Configures the repository with the PDF maker service endpoint.
      */
-    constructor() {
+    constructor(props) {
         super("wallet", contract, {
-            //root: "https://api.afloat.money/pdf-maker/afloat",
-            root: "http://localhost:3000/afloat"
+            root: "https://api.afloat.money/pdf-maker/afloat",
+            // root: "http://localhost:3000/afloat",
+            auth: props?.auth,
         });
     }
     /**
@@ -32,6 +33,12 @@ export class AfloatFilesRepo extends BaseRepository {
         if (result.status === 201) {
             return result.body;
         }
+        if (result.status === 202) {
+            throw new APIError({
+                message: result.body.message,
+                statusCode: 202,
+            });
+        }
         throw APIError.unknown("An error occurred while generating statement PDF");
     }
     /**

package/esm/src/features/payout/repository.d.ts

@@ -1,6 +1,7 @@
 import { BaseRepository } from "../../shared/index.js";
 import { type PayoutAPI } from "./contract.js";
 import { type GetPayoutsAPIArgs, type PayoutInput } from "../../models/payout/index.js";
+import type { AfloatAuth } from "../auth/manager.js";
 import { Payout } from "../../models/payout/derivatives/payout.js";
 /**
  * Repository class for managing payout operations including creation, approval,
@@ -10,8 +11,12 @@ import { Payout } from "../../models/payout/derivatives/payout.js";
 export declare class PayoutRepository extends BaseRepository<PayoutAPI> {
     /**
      * Creates an instance of PayoutRepository initialized with the payout contract.
+     * @param {Object} [props] - Optional constructor properties
+     * @param {AfloatAuth} [props.auth] - Optional auth instance to use
      */
-    constructor();
+    constructor(props?: {
+        auth?: AfloatAuth;
+    });
     /**
      * Retrieves a paginated list of payouts with optional filtering for pending status.
      * @param {GetPayoutsAPIArgs} [args] - Optional arguments for filtering and pagination

package/esm/src/features/payout/repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../src/src/features/payout/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACL,KAAK,iBAAiB,EAEtB,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;AAItC,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,cAAc,CAAC,SAAS,CAAC;IAC7D;;OAEG;;IAKH;;;;;;;;;OASG;IACG,MAAM,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IA2CF;;;;;;OAMG;IACG,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAkB9C;;;;;;;;OAQG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BrE;;;;;;;;OAQG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CA6BrE"}
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../src/src/features/payout/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACL,KAAK,iBAAiB,EAEtB,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,cAAc,CAAC,SAAS,CAAC;IAC7D;;;;OAIG;gBACS,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,UAAU,CAAA;KAAE;IAIzC;;;;;;;;;OASG;IACG,MAAM,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IA6CF;;;;;;OAMG;IACG,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB9C;;;;;;;;OAQG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAgCrE;;;;;;;;OAQG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CA+BrE"}

package/esm/src/features/payout/repository.js

@@ -1,7 +1,6 @@
 import { BaseRepository } from "../../shared/index.js";
 import { contract } from "./contract.js";
 import { PAYOUT_APPROVAL_STATUS, } from "../../models/payout/index.js";
-import { AfloatAuth } from "../auth/manager.js";
 import { Permissions } from "../../models/permission.js";
 import { APIError, PermissionError } from "../../errors/index.js";
 import { Payout } from "../../models/payout/derivatives/payout.js";
@@ -13,9 +12,11 @@ import { Payout } from "../../models/payout/derivatives/payout.js";
 export class PayoutRepository extends BaseRepository {
     /**
      * Creates an instance of PayoutRepository initialized with the payout contract.
+     * @param {Object} [props] - Optional constructor properties
+     * @param {AfloatAuth} [props.auth] - Optional auth instance to use
      */
-    constructor() {
-        super("payout", contract);
+    constructor(props) {
+        super("payout", contract, { auth: props?.auth });
     }
     /**
      * Retrieves a paginated list of payouts with optional filtering for pending status.
@@ -28,8 +29,9 @@ export class PayoutRepository extends BaseRepository {
      * @returns {Promise<{results: Payout[]; total: number}>} Paginated payout results and total count
      */
     async getAll(args) {
+        const auth = this.getAuthForPermissionCheck();
         const requiredPerm = Permissions.Payout.List;
-        if (!AfloatAuth.instance.checkPermission(requiredPerm)) {
+        if (!auth.checkPermission(requiredPerm)) {
             throw new PermissionError({
                 message: "You are not authorized to view payouts.",
                 requiredPermissions: [requiredPerm],
@@ -70,8 +72,9 @@ export class PayoutRepository extends BaseRepository {
      * @returns {Promise<Payout>} The created payout
      */
     async pay(input) {
+        const auth = this.getAuthForPermissionCheck();
         const requiredPerm = Permissions.Payout.Create;
-        if (!AfloatAuth.instance.checkPermission(Permissions.Payout.Create)) {
+        if (!auth.checkPermission(requiredPerm)) {
             throw new PermissionError({
                 message: "You are not authorized to create payouts.",
                 requiredPermissions: [requiredPerm],
@@ -95,8 +98,9 @@ export class PayoutRepository extends BaseRepository {
      * @returns {Promise<Payout>} The approved payout
      */
     async approve(id, args) {
+        const auth = this.getAuthForPermissionCheck();
         const requiredPerm = Permissions.Payout.Approve;
-        if (!AfloatAuth.instance.checkPermission(requiredPerm)) {
+        if (!auth.checkPermission(requiredPerm)) {
             throw new PermissionError({
                 message: "You are not authorized to approve or reject payouts.",
                 requiredPermissions: [requiredPerm],
@@ -130,8 +134,9 @@ export class PayoutRepository extends BaseRepository {
      * @returns {Promise<Payout>} The rejected payout
      */
     async reject(id, args) {
+        const auth = this.getAuthForPermissionCheck();
         const requiredPerm = Permissions.Payout.Approve;
-        if (!AfloatAuth.instance.checkPermission(requiredPerm)) {
+        if (!auth.checkPermission(requiredPerm)) {
             throw new PermissionError({
                 message: "You are not authorized to approve or reject payouts.",
                 requiredPermissions: [requiredPerm],

package/esm/src/features/wallet/repository.d.ts

@@ -1,6 +1,7 @@
 import { BaseRepository } from "../../shared/base_repository.js";
 import { contract } from "./contract.js";
 import type { STATEMENT_OUTPUT_TYPE, StatementFile, Wallet, WalletStatementItem } from "../../models/wallet/index.js";
+import type { AfloatAuth } from "../auth/manager.js";
 /**
  * Repository class for managing wallet operations including balance checking,
  * statement generation, and wallet information retrieval.
@@ -9,8 +10,14 @@ import type { STATEMENT_OUTPUT_TYPE, StatementFile, Wallet, WalletStatementItem
 export declare class WalletRepo extends BaseRepository<typeof contract> {
     /**
      * Creates an instance of WalletRepo initialized with the wallet contract.
+     * @param {Object} [options] - Optional configuration
+     * @param {string} [options.root] - Custom API root URL
+     * @param {AfloatAuth} [options.auth] - Auth instance to use
      */
-    constructor();
+    constructor(props?: {
+        root?: string;
+        auth?: AfloatAuth;
+    });
     /**
      * Gets an instance of the file generation repository.
      * @private

package/esm/src/features/wallet/repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../src/src/features/wallet/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EACV,qBAAqB,EACrB,aAAa,EACb,MAAM,EACN,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AAMtC;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,cAAc,CAAC,OAAO,QAAQ,CAAC;IAC7D;;OAEG;;IAKH;;;;OAIG;IACH,OAAO,KAAK,WAAW,GAEtB;IAED;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAkBnC;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAUrC;;;;;;;;;;;OAWG;IACG,YAAY,CAChB,KAAK,EAAE;QACL,KAAK,CAAC,EAAE;YAAE,SAAS,EAAE,IAAI,CAAC;YAAC,OAAO,EAAE,IAAI,CAAA;SAAE,CAAC;QAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA0BjC;;;;;;;;;OASG;IACG,YAAY,CAChB,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE;QACL,SAAS,EAAE,IAAI,CAAC;QAChB,OAAO,EAAE,IAAI,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,aAAa,CAAC;IAiBzB;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,aAAa,CAAC;CAWpD"}
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../src/src/features/wallet/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EACV,qBAAqB,EACrB,aAAa,EACb,MAAM,EACN,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,cAAc,CAAC,OAAO,QAAQ,CAAC;IAC7D;;;;;OAKG;gBACS,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,UAAU,CAAA;KAAE;IAOxD;;;;OAIG;IACH,OAAO,KAAK,WAAW,GAEtB;IAED;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAoBnC;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAUrC;;;;;;;;;;;OAWG;IACG,YAAY,CAChB,KAAK,EAAE;QACL,KAAK,CAAC,EAAE;YAAE,SAAS,EAAE,IAAI,CAAC;YAAC,OAAO,EAAE,IAAI,CAAA;SAAE,CAAC;QAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA4BjC;;;;;;;;;OASG;IACG,YAAY,CAChB,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE;QACL,SAAS,EAAE,IAAI,CAAC;QAChB,OAAO,EAAE,IAAI,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO,CAAC,aAAa,CAAC;IAmBzB;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,aAAa,CAAC;CAapD"}

package/esm/src/features/wallet/repository.js

@@ -1,7 +1,6 @@
 import { BaseRepository } from "../../shared/base_repository.js";
 import { contract } from "./contract.js";
 import { AfloatFilesRepo } from "../files-gen/repository.js";
-import { AfloatAuth } from "../auth/manager.js";
 import { Permissions } from "../../models/permission.js";
 import { PermissionError } from "../../errors/index.js";
 /**
@@ -12,9 +11,15 @@ import { PermissionError } from "../../errors/index.js";
 export class WalletRepo extends BaseRepository {
     /**
      * Creates an instance of WalletRepo initialized with the wallet contract.
+     * @param {Object} [options] - Optional configuration
+     * @param {string} [options.root] - Custom API root URL
+     * @param {AfloatAuth} [options.auth] - Auth instance to use
      */
-    constructor() {
-        super("wallet", contract);
+    constructor(props) {
+        super("wallet", contract, {
+            root: props?.root,
+            auth: props?.auth,
+        });
     }
     /**
      * Gets an instance of the file generation repository.
@@ -22,7 +27,7 @@ export class WalletRepo extends BaseRepository {
      * @returns {AfloatFilesRepo} A new instance of AfloatFilesRepo
      */
     get fileGenRepo() {
-        return new AfloatFilesRepo();
+        return new AfloatFilesRepo({ auth: this.auth });
     }
     /**
      * Retrieves the current available balance for the wallet.
@@ -31,8 +36,9 @@ export class WalletRepo extends BaseRepository {
      * @returns {Promise<number>} The available balance amount
      */
     async getBalance() {
+        const auth = this.getAuthForPermissionCheck();
         const requirePerm = Permissions.Wallet.ViewBalance;
-        if (!AfloatAuth.instance.checkPermission(requirePerm)) {
+        if (!auth.checkPermission(requirePerm)) {
             throw new PermissionError({
                 message: "You are not authorized to view the account balance.",
                 requiredPermissions: [requirePerm],
@@ -69,8 +75,9 @@ export class WalletRepo extends BaseRepository {
      * @returns {Promise<WalletStatementItem[]>} Array of statement items for the specified period
      */
     async getStatement(props) {
+        const auth = this.getAuthForPermissionCheck();
         const requirePerm = Permissions.Wallet.ViewStatement;
-        if (!AfloatAuth.instance.checkPermission(requirePerm)) {
+        if (!auth.checkPermission(requirePerm)) {
             throw new PermissionError({
                 message: "You are not authorized to view the statement.",
                 requiredPermissions: [requirePerm],
@@ -100,8 +107,9 @@ export class WalletRepo extends BaseRepository {
      * @returns {Promise<StatementFile>} The generated statement file
      */
     async genStatement(fileType, props) {
+        const auth = this.getAuthForPermissionCheck();
         const requirePerm = Permissions.Wallet.ViewStatement;
-        if (!AfloatAuth.instance.checkPermission(requirePerm)) {
+        if (!auth.checkPermission(requirePerm)) {
             throw new PermissionError({
                 message: "You are not authorized to view the statement.",
                 requiredPermissions: [requirePerm],
@@ -120,8 +128,9 @@ export class WalletRepo extends BaseRepository {
      * @returns {Promise<StatementFile>} The generated PDF file containing wallet details
      */
     async genWalletDetailsPDF() {
+        const auth = this.getAuthForPermissionCheck();
         const requirePerm = Permissions.Wallet.ViewBalance;
-        if (!AfloatAuth.instance.checkPermission(requirePerm)) {
+        if (!auth.checkPermission(requirePerm)) {
             throw new PermissionError({
                 message: "You are not authorized to view the account details.",
                 requiredPermissions: [requirePerm],