@temboplus/afloat 0.1.57 → 0.1.59

package/{dist/lib/api/base-repository.d.ts → esm/src/shared/base_repository.d.ts}

@@ -1,175 +1,80 @@
-import { AppRouter } from "@ts-rest/core";
-import { InitClientArgs } from "@ts-rest/core";
+import { type AppRouter } from "@ts-rest/core";
+import type { InitClientArgs } from "@ts-rest/core";
+import { AfloatAuth } from "../features/auth/manager.js";
 /**
- * BaseRepository - Generic base class for API repositories
+ * BaseRepository
  *
- * Provides a consistent way to interact with the Afloat API using ts-rest contracts.
- * Handles authentication token management through multiple fallback mechanisms.
+ * A generic base class to build repositories for interacting with the Afloat API.
+ * This class initializes a "ts-rest" client using a specified "ts-rest" contract and provides
+ * helper methods to handle API responses consistently.
  *
- * **Token Resolution Order:**
- * 1. Direct token provided in constructor
- * 2. Global authentication state via getCurrentToken()
- *
- * @template TContract - The API contract extending `AppRouter` from `@ts-rest/core`
- *
- * @example
- * ```typescript
- * // Usage 1: Direct token usage (Recommended for server-side usage)
- * const repo = new WalletRepository("wallet", walletContract, {
- *   token: "user-auth-token"
- * });
- *
- * // Usage 2: Global auth state (Recommended for client-side usage)
- * // Token automatically retrieved from AfloatAuth.instance
- * const repo = new WalletRepository("wallet", walletContract);
- * ```
+ * @template TContract - The API contract extending `AppRouter` from `@npm/ts_rest.ts`.
  */
 export declare class BaseRepository<TContract extends AppRouter> {
     /**
-     * The ts-rest contract defining the API endpoints
+     * A "ts-rest" contract
+     *
      * @protected
      */
     protected contract: TContract;
     /**
-     * The API endpoint path for this repository
+     * An API endpoint
+     *
      * @protected
      */
     protected endpoint: string;
     /**
-     * Optional custom API root URL
+     * An API Root URL
+     *
      * @protected
      */
     protected root: string | undefined;
     /**
-     * Optional authentication token for API calls
+     * The auth instance to use for authentication
+     *
      * @protected
      */
-    protected token: string | undefined;
+    protected auth: AfloatAuth | undefined;
     /**
-     * Creates a new BaseRepository instance.
-     *
-     * @param endpoint - The API endpoint path (e.g., "users", "wallets")
-     * @param contract - The ts-rest contract defining the API
-     * @param options - Optional configuration
-     * @param options.root - Custom API root URL (defaults to https://api.afloat.money/v1)
-     * @param options.token - Authentication token for API calls
+     * Constructs a new instance of `BaseRepository`.
      *
-     * @example
-     * ```typescript
-     * // Server-side with explicit token
-     * const repo = new WalletRepository("wallet", walletContract, {
-     *   token: "user-auth-token",
-     *   root: "https://api-staging.afloat.money/v1"
-     * });
-     *
-     * // Client-side using global auth state
-     * const repo = new WalletRepository("wallet", walletContract);
-     * ```
+     * @param endpoint - API endpoint
+     * @param contract - The "ts-rest" contract
+     * @param args - Optional constructor arguments
+     * @param args.root - Optional API root URL
+     * @param args.auth - Optional auth instance to use
      */
-    constructor(endpoint: string, contract: TContract, options?: {
+    constructor(endpoint: string, contract: TContract, args?: {
         root?: string;
-        token?: string;
+        auth?: AfloatAuth;
     });
     /**
-     * Resolves an authentication token for API calls.
-     *
-     * Uses a fallback chain to find a valid token:
-     * 1. Instance token (set in constructor)
-     * 2. Global authentication state via getCurrentToken()
-     * 3. Return an empty string if no token is found (e.g., for public/unauthenticated endpoints)
+     * Gets an auth instance that can be used for permission checks.
+     * Follows a fallback strategy to find a valid auth instance.
      *
      * @protected
-     * @returns The authentication token
-     * @throws {Error} If no valid token can be found
-     *
-     * @example
-     * ```typescript
-     * // This method is called automatically by the client getter
-     * // You typically don't need to call this directly
-     * ```
+     * @returns {AfloatAuth} A valid auth instance
+     * @throws {Error} If no valid auth instance is available
      */
-    protected getToken(): string;
+    protected getAuthForPermissionCheck(): AfloatAuth;
     /**
-     * Gets the configured ts-rest client for making API requests.
-     *
-     * Automatically includes authentication headers and request tracking.
-     * The client resolves the authentication token using the fallback chain.
-     *
-     * @returns Configured ts-rest client instance
-     * @throws {Error} If no authentication token is available
-     *
-     * @example
-     * ```typescript
-     * // Client automatically includes token and request ID
-     * const result = await this.client.getUsers({ query: { limit: 10 } });
-     *
-     * // Headers automatically included:
-     * // - token: "user-auth-token"
-     * // - x-request-id: "uuid-v4-string"
-     * ```
+     * Gets the initialized client for making API requests.
+     * Uses authentication token if available.
      */
-    get client(): { [TKey in keyof TContract]: TContract[TKey] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey], InitClientArgs>> : TContract[TKey] extends AppRouter ? TContract[TKey] extends infer T extends AppRouter ? { [TKey_1 in keyof T]: TContract[TKey][TKey_1] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1], InitClientArgs>> : TContract[TKey][TKey_1] extends AppRouter ? TContract[TKey][TKey_1] extends infer T_1 extends AppRouter ? { [TKey_2 in keyof T_1]: TContract[TKey][TKey_1][TKey_2] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2] extends AppRouter ? TContract[TKey][TKey_1][TKey_2] extends infer T_2 extends AppRouter ? { [TKey_3 in keyof T_2]: TContract[TKey][TKey_1][TKey_2][TKey_3] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3] extends infer T_3 extends AppRouter ? { [TKey_4 in keyof T_3]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4] extends infer T_4 extends AppRouter ? { [TKey_5 in keyof T_4]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5] extends infer T_5 extends AppRouter ? { [TKey_6 in keyof T_5]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6] extends infer T_6 extends AppRouter ? { [TKey_7 in keyof T_6]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7] extends infer T_7 extends AppRouter ? { [TKey_8 in keyof T_7]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8] extends infer T_8 extends AppRouter ? { [TKey_9 in keyof T_8]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9] extends infer T_9 extends AppRouter ? { [TKey_10 in keyof T_9]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9][TKey_10] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9][TKey_10], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9][TKey_10], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9][TKey_10] extends AppRouter ? /*elided*/ any : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; };
+    get client(): { [TKey in keyof TContract]: TContract[TKey] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey], InitClientArgs>> : TContract[TKey] extends AppRouter ? TContract[TKey] extends infer T extends AppRouter ? { [TKey_1 in keyof T]: TContract[TKey][TKey_1] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1], InitClientArgs>> : TContract[TKey][TKey_1] extends AppRouter ? TContract[TKey][TKey_1] extends infer T_1 extends AppRouter ? { [TKey_2 in keyof T_1]: TContract[TKey][TKey_1][TKey_2] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2] extends AppRouter ? TContract[TKey][TKey_1][TKey_2] extends infer T_2 extends AppRouter ? { [TKey_3 in keyof T_2]: TContract[TKey][TKey_1][TKey_2][TKey_3] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3] extends infer T_3 extends AppRouter ? { [TKey_4 in keyof T_3]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4] extends infer T_4 extends AppRouter ? { [TKey_5 in keyof T_4]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5] extends infer T_5 extends AppRouter ? { [TKey_6 in keyof T_5]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6] extends infer T_6 extends AppRouter ? { [TKey_7 in keyof T_6]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7] extends infer T_7 extends AppRouter ? { [TKey_8 in keyof T_7]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8] extends infer T_8 extends AppRouter ? { [TKey_9 in keyof T_8]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9] extends infer T_9 extends AppRouter ? { [TKey_10 in keyof T_9]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9][TKey_10] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9][TKey_10], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9][TKey_10], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9][TKey_10] extends AppRouter ? any : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; };
     /**
-     * Updates the authentication token used by this repository.
-     *
-     * @param token - The new authentication token
-     *
-     * @example
-     * ```typescript
-     * // Useful for switching between different user contexts
-     * repository.setToken("new-auth-token");
-     *
-     * // Or clearing the token to fall back to global auth state
-     * repository.setToken(undefined);
-     * ```
-     */
-    setToken(token: string): void;
-    /**
-     * Gets the currently configured token (if set directly on the instance).
-     *
-     * @returns The current authentication token or undefined
-     *
-     * @note This only returns tokens set directly on the instance, not tokens
-     * resolved from the global authentication state.
-     *
-     * @example
-     * ```typescript
-     * const directToken = repository.getCurrentToken();
-     * if (directToken) {
-     *   console.log("Repository has a direct token");
-     * } else {
-     *   console.log("Repository will use global auth state");
-     * }
-     * ```
-     */
-    getCurrentToken(): string | undefined;
-    /**
-     * Handles API responses consistently across all repositories.
-     *
-     * Checks the HTTP status code and either returns the response body for
-     * successful requests or throws appropriate errors for failures.
-     *
-     * @template T - The expected type of the successful response body
-     * @param result - The API response object with status and body
-     * @param successStatusCode - The expected HTTP status code for success
-     * @returns The response body typed as T
-     * @throws {APIError} For API errors (400, 401, 403, 404, 500, etc.)
-     *
-     * @example
-     * ```typescript
-     * const result = await this.client.getUser({ params: { id: "123" } });
-     * return this.handleResponse<User>(result, 200);
-     *
-     * // Automatically handles error cases:
-     * // - 400: Bad Request with detailed error info
-     * // - 401: Unauthorized (authentication required)
-     * // - 403: Forbidden (insufficient permissions)
-     * // - 404: Not Found
-     * // - Other: Generic server error
-     * ```
+     * Handles the API response by checking the HTTP status code and returning the response body
+     * for successful requests or throwing an `APIError` for errors.
+     *
+     * @template T - The expected type of the successful response body.
+     * @param result - The API response object containing the status code and response body.
+     * @param successStatusCode - The expected HTTP status code indicating success (e.g., 200, 201).
+     * @returns The response body typed as `T` if the status code matches the success criteria.
+     * @throws `APIError` - If the status code indicates a failure.
      */
     handleResponse<T>(result: {
         status: number;
         body: unknown;
     }, successStatusCode: number): T;
 }
+//# sourceMappingURL=base_repository.d.ts.map

package/esm/src/shared/base_repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base_repository.d.ts","sourceRoot":"","sources":["../../../src/src/shared/base_repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,eAAe,CAAC;AAG3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAe,MAAM,6BAA6B,CAAC;AAEtE;;;;;;;;GAQG;AACH,qBAAa,cAAc,CAAC,SAAS,SAAS,SAAS;IACrD;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC;IAE9B;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAEnC;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAEvC;;;;;;;;OAQG;gBACS,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE;QACxD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,UAAU,CAAC;KACnB;IASD;;;;;;;OAOG;IACH,SAAS,CAAC,yBAAyB,IAAI,UAAU;IAgBjD;;;OAGG;IACH,IAAI,MAAM,k0LA+BT;IAED;;;;;;;;;OASG;IACH,cAAc,CAAC,CAAC,EACd,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,EACzC,iBAAiB,EAAE,MAAM,GACxB,CAAC;CAgBL"}

package/esm/src/shared/base_repository.js

@@ -0,0 +1,153 @@
+import { initClient } from "@ts-rest/core";
+import { APIError } from "../errors/api_error.js";
+import { v4 as uuidv4 } from "uuid";
+import { AfloatAuth, AuthContext } from "../features/auth/manager.js";
+/**
+ * BaseRepository
+ *
+ * A generic base class to build repositories for interacting with the Afloat API.
+ * This class initializes a "ts-rest" client using a specified "ts-rest" contract and provides
+ * helper methods to handle API responses consistently.
+ *
+ * @template TContract - The API contract extending `AppRouter` from `@npm/ts_rest.ts`.
+ */
+export class BaseRepository {
+    /**
+     * Constructs a new instance of `BaseRepository`.
+     *
+     * @param endpoint - API endpoint
+     * @param contract - The "ts-rest" contract
+     * @param args - Optional constructor arguments
+     * @param args.root - Optional API root URL
+     * @param args.auth - Optional auth instance to use
+     */
+    constructor(endpoint, contract, args) {
+        /**
+         * A "ts-rest" contract
+         *
+         * @protected
+         */
+        Object.defineProperty(this, "contract", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * An API endpoint
+         *
+         * @protected
+         */
+        Object.defineProperty(this, "endpoint", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * An API Root URL
+         *
+         * @protected
+         */
+        Object.defineProperty(this, "root", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * The auth instance to use for authentication
+         *
+         * @protected
+         */
+        Object.defineProperty(this, "auth", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.contract = contract;
+        this.endpoint = endpoint;
+        this.root = args?.root;
+        // Use provided auth or try to get the current context
+        this.auth = args?.auth || AuthContext.current;
+    }
+    /**
+     * Gets an auth instance that can be used for permission checks.
+     * Follows a fallback strategy to find a valid auth instance.
+     *
+     * @protected
+     * @returns {AfloatAuth} A valid auth instance
+     * @throws {Error} If no valid auth instance is available
+     */
+    getAuthForPermissionCheck() {
+        // Use the instance provided in constructor, or fallback to context
+        const auth = this.auth || AuthContext.current;
+        if (!auth) {
+            try {
+                // Last resort: try to get the client singleton
+                return AfloatAuth.instance;
+            }
+            catch (_) {
+                throw new Error(`No valid auth instance available for ${this.endpoint} repository`);
+            }
+        }
+        return auth;
+    }
+    /**
+     * Gets the initialized client for making API requests.
+     * Uses authentication token if available.
+     */
+    get client() {
+        const baseUrl = this.root
+            ? `${this.root}/${this.endpoint}`
+            : `https://api.afloat.money/v1/${this.endpoint}`;
+        let token = "";
+        // Try to get token from the provided auth instance
+        if (this.auth) {
+            token = this.auth.getUserToken() ?? "";
+        }
+        // Fall back to singleton if no auth was provided, but handle exceptions
+        // that occur in server environments
+        else {
+            try {
+                token = AfloatAuth.instance.getUserToken() ?? "";
+            }
+            catch (_) {
+                // This will fail when called within the server without initialization
+                // We'll proceed with an empty token
+            }
+        }
+        const args = {
+            baseUrl,
+            baseHeaders: {
+                "token": token,
+                "x-request-id": uuidv4(),
+            },
+        };
+        return initClient(this.contract, args);
+    }
+    /**
+     * Handles the API response by checking the HTTP status code and returning the response body
+     * for successful requests or throwing an `APIError` for errors.
+     *
+     * @template T - The expected type of the successful response body.
+     * @param result - The API response object containing the status code and response body.
+     * @param successStatusCode - The expected HTTP status code indicating success (e.g., 200, 201).
+     * @returns The response body typed as `T` if the status code matches the success criteria.
+     * @throws `APIError` - If the status code indicates a failure.
+     */
+    handleResponse(result, successStatusCode) {
+        if (successStatusCode === result.status) {
+            return result.body;
+        }
+        if (result.status === 400) {
+            throw new APIError(result.body);
+        }
+        throw new APIError({
+            message: "We encountered an error trying to process your request. Please try again later",
+            statusCode: 520,
+            error: "UNKNOWN ERROR",
+        });
+    }
+}

package/{dist/lib/api/common-responses.d.ts → esm/src/shared/common_responses.d.ts}

@@ -10,3 +10,4 @@ export declare const common400ResponseSchema: ApiErrorResponseSchemaType;
 export type Common400APIResponse = z.infer<typeof common400ResponseSchema>;
 export declare const commonAPIResponses: Record<number, AppRouteResponse>;
 export {};
+//# sourceMappingURL=common_responses.d.ts.map

package/esm/src/shared/common_responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common_responses.d.ts","sourceRoot":"","sources":["../../../src/src/shared/common_responses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,KAAK,0BAA0B,GAAG,CAAC,CAAC,SAAS,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC;IACxB,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC;IACnB,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;CACrC,CAAC,CAAC;AACH,eAAO,MAAM,uBAAuB,EAAE,0BAKpC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE3E,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAE/D,CAAC"}

package/esm/src/shared/common_responses.js

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export const common400ResponseSchema = z.object({
+    statusCode: z.number(),
+    message: z.string(),
+    error: z.string(),
+    details: z.record(z.string()).optional(),
+});
+export const commonAPIResponses = {
+    400: common400ResponseSchema,
+};

package/esm/src/shared/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./common_responses.js";
+export * from "./base_repository.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/src/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/shared/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}

package/esm/src/shared/index.js

@@ -0,0 +1,2 @@
+export * from "./common_responses.js";
+export * from "./base_repository.js";

package/esm/src/shared/token_required_repository.d.ts

@@ -0,0 +1,78 @@
+import { type AppRouter } from "@ts-rest/core";
+import type { InitClientArgs } from "@ts-rest/core";
+/**
+ * TokenRequiredRepository
+ *
+ * A generic base class to build repositories for interacting with the API,
+ * without any dependency on AfloatAuth. Instead, it requires token to be
+ * explicitly provided when initializing the repository.
+ *
+ * @template TContract - The API contract extending `AppRouter` from `@ts-rest/core`.
+ */
+export declare class TokenRequiredRepository<TContract extends AppRouter> {
+    /**
+     * A "ts-rest" contract
+     *
+     * @protected
+     */
+    protected contract: TContract;
+    /**
+     * An API endpoint
+     *
+     * @protected
+     */
+    protected endpoint: string;
+    /**
+     * An API Root URL
+     *
+     * @protected
+     */
+    protected root: string | undefined;
+    /**
+     * Authentication token
+     *
+     * @protected
+     */
+    protected token: string;
+    /**
+     * Constructs a new instance of `TokenRequiredRepository`.
+     *
+     * @param endpoint - API endpoint
+     * @param contract - The "ts-rest" contract
+     * @param token - Authentication token (required)
+     * @param root - Optional API root URL
+     */
+    constructor(endpoint: string, contract: TContract, token: string, root?: string);
+    /**
+     * Gets the initialized client for making API requests.
+     * Uses the provided authentication token.
+     */
+    get client(): { [TKey in keyof TContract]: TContract[TKey] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey], InitClientArgs>> : TContract[TKey] extends AppRouter ? TContract[TKey] extends infer T extends AppRouter ? { [TKey_1 in keyof T]: TContract[TKey][TKey_1] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1], InitClientArgs>> : TContract[TKey][TKey_1] extends AppRouter ? TContract[TKey][TKey_1] extends infer T_1 extends AppRouter ? { [TKey_2 in keyof T_1]: TContract[TKey][TKey_1][TKey_2] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2] extends AppRouter ? TContract[TKey][TKey_1][TKey_2] extends infer T_2 extends AppRouter ? { [TKey_3 in keyof T_2]: TContract[TKey][TKey_1][TKey_2][TKey_3] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3] extends infer T_3 extends AppRouter ? { [TKey_4 in keyof T_3]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4] extends infer T_4 extends AppRouter ? { [TKey_5 in keyof T_4]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5] extends infer T_5 extends AppRouter ? { [TKey_6 in keyof T_5]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6] extends infer T_6 extends AppRouter ? { [TKey_7 in keyof T_6]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7] extends infer T_7 extends AppRouter ? { [TKey_8 in keyof T_7]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8] extends infer T_8 extends AppRouter ? { [TKey_9 in keyof T_8]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9] extends AppRouter ? TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9] extends infer T_9 extends AppRouter ? { [TKey_10 in keyof T_9]: TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9][TKey_10] extends import("@ts-rest/core").AppRoute ? import("@ts-rest/core").AppRouteFunction<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9][TKey_10], InitClientArgs, import("@ts-rest/core").PartialClientInferRequest<TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9][TKey_10], InitClientArgs>> : TContract[TKey][TKey_1][TKey_2][TKey_3][TKey_4][TKey_5][TKey_6][TKey_7][TKey_8][TKey_9][TKey_10] extends AppRouter ? any : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; };
+    /**
+     * Updates the token used by this repository
+     *
+     * @param token - New authentication token
+     */
+    setToken(token: string): void;
+    /**
+     * Gets the current token
+     *
+     * @returns The current authentication token
+     */
+    getToken(): string;
+    /**
+     * Handles the API response by checking the HTTP status code and returning the response body
+     * for successful requests or throwing an `APIError` for errors.
+     *
+     * @template T - The expected type of the successful response body.
+     * @param result - The API response object containing the status code and response body.
+     * @param successStatusCode - The expected HTTP status code indicating success (e.g., 200, 201).
+     * @returns The response body typed as `T` if the status code matches the success criteria.
+     * @throws `APIError` - If the status code indicates a failure.
+     */
+    handleResponse<T>(result: {
+        status: number;
+        body: unknown;
+    }, successStatusCode: number): T;
+}
+//# sourceMappingURL=token_required_repository.d.ts.map

package/esm/src/shared/token_required_repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token_required_repository.d.ts","sourceRoot":"","sources":["../../../src/src/shared/token_required_repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,eAAe,CAAC;AAG3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD;;;;;;;;GAQG;AACH,qBAAa,uBAAuB,CAAC,SAAS,SAAS,SAAS;IAC9D;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC;IAE9B;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAEnC;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC;IAExB;;;;;;;OAOG;gBAED,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,SAAS,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM;IAQf;;;OAGG;IACH,IAAI,MAAM,k0LAcT;IAED;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;;;;;;OASG;IACH,cAAc,CAAC,CAAC,EACd,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,EACzC,iBAAiB,EAAE,MAAM,GACxB,CAAC;CAgBL"}

package/esm/src/shared/token_required_repository.js

@@ -0,0 +1,128 @@
+import { initClient } from "@ts-rest/core";
+import { APIError } from "../errors/api_error.js";
+import { v4 as uuidv4 } from "uuid";
+/**
+ * TokenRequiredRepository
+ *
+ * A generic base class to build repositories for interacting with the API,
+ * without any dependency on AfloatAuth. Instead, it requires token to be
+ * explicitly provided when initializing the repository.
+ *
+ * @template TContract - The API contract extending `AppRouter` from `@ts-rest/core`.
+ */
+export class TokenRequiredRepository {
+    /**
+     * Constructs a new instance of `TokenRequiredRepository`.
+     *
+     * @param endpoint - API endpoint
+     * @param contract - The "ts-rest" contract
+     * @param token - Authentication token (required)
+     * @param root - Optional API root URL
+     */
+    constructor(endpoint, contract, token, root) {
+        /**
+         * A "ts-rest" contract
+         *
+         * @protected
+         */
+        Object.defineProperty(this, "contract", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * An API endpoint
+         *
+         * @protected
+         */
+        Object.defineProperty(this, "endpoint", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * An API Root URL
+         *
+         * @protected
+         */
+        Object.defineProperty(this, "root", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * Authentication token
+         *
+         * @protected
+         */
+        Object.defineProperty(this, "token", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.contract = contract;
+        this.endpoint = endpoint;
+        this.token = token;
+        this.root = root;
+    }
+    /**
+     * Gets the initialized client for making API requests.
+     * Uses the provided authentication token.
+     */
+    get client() {
+        const baseUrl = this.root
+            ? `${this.root}/${this.endpoint}`
+            : `https://api.afloat.money/v1/${this.endpoint}`;
+        const args = {
+            baseUrl,
+            baseHeaders: {
+                "token": this.token,
+                "x-request-id": uuidv4(),
+            },
+        };
+        return initClient(this.contract, args);
+    }
+    /**
+     * Updates the token used by this repository
+     *
+     * @param token - New authentication token
+     */
+    setToken(token) {
+        this.token = token;
+    }
+    /**
+     * Gets the current token
+     *
+     * @returns The current authentication token
+     */
+    getToken() {
+        return this.token;
+    }
+    /**
+     * Handles the API response by checking the HTTP status code and returning the response body
+     * for successful requests or throwing an `APIError` for errors.
+     *
+     * @template T - The expected type of the successful response body.
+     * @param result - The API response object containing the status code and response body.
+     * @param successStatusCode - The expected HTTP status code indicating success (e.g., 200, 201).
+     * @returns The response body typed as `T` if the status code matches the success criteria.
+     * @throws `APIError` - If the status code indicates a failure.
+     */
+    handleResponse(result, successStatusCode) {
+        if (successStatusCode === result.status) {
+            return result.body;
+        }
+        if (result.status === 400) {
+            throw new APIError(result.body);
+        }
+        throw new APIError({
+            message: "We encountered an error trying to process your request. Please try again later",
+            statusCode: 520,
+            error: "UNKNOWN ERROR",
+        });
+    }
+}