@temboplus/afloat 0.1.77-beta.9 → 0.1.79

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

@@ -0,0 +1,80 @@
+import { type AppRouter } from "@ts-rest/core";
+import type { InitClientArgs } from "@ts-rest/core";
+import { AfloatAuth } 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 declare class BaseRepository<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;
+    /**
+     * The auth instance to use for authentication
+     *
+     * @protected
+     */
+    protected auth: AfloatAuth | undefined;
+    /**
+     * 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: string, contract: TContract, args?: {
+        root?: string;
+        auth?: AfloatAuth;
+    });
+    /**
+     * 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
+     */
+    protected getAuthForPermissionCheck(): AfloatAuth;
+    /**
+     * 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 ? any : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; } : never : never; };
+    /**
+     * 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/esm/src/shared/common_responses.d.ts

@@ -0,0 +1,13 @@
+import type { AppRouteResponse } from "@ts-rest/core";
+import { z } from "zod";
+type ApiErrorResponseSchemaType = z.ZodObject<{
+    statusCode: z.ZodNumber;
+    message: z.ZodString;
+    error: z.ZodString;
+    details: z.ZodOptional<z.ZodRecord>;
+}>;
+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",
+        });
+    }
+}

package/package.json

@@ -1,63 +1,37 @@
 {
   "name": "@temboplus/afloat",
-  "version": "0.1.77-beta.9",
-  "description": "A foundational library for Temboplus-Afloat projects.",
-  "main": "./dist/index.cjs.js",
-  "module": "./dist/index.esm.js",
-  "types": "./dist/index.d.ts",
-  "type": "module",
-  "exports": {
-    ".": {
-      "import": "./dist/index.esm.js",
-      "require": "./dist/index.cjs.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "rollup -c rollup.config.js",
-    "prepare": "npm run build",
-    "dev": "npm run build -- --watch",
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
+  "version": "0.1.79",
+  "description": "A JavaScript/TypeScript package providing common utilities and logic shared across all Temboplus-Afloat Projects",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/TemboPlus-Frontend/afloat-js.git"
+    "url": "git+https://github.com/TemboPlus-Frontend/afloat-js"
   },
-  "keywords": [
-    "temboplus",
-    "afloat"
-  ],
-  "author": "Okello Gerald",
   "license": "MIT",
   "bugs": {
     "url": "https://github.com/TemboPlus-Frontend/afloat-js/issues"
   },
-  "homepage": "https://github.com/TemboPlus-Frontend/afloat-js#readme",
-  "peerDependencies": {
+  "main": "./script/mod.js",
+  "module": "./esm/mod.js",
+  "exports": {
+    ".": {
+      "import": "./esm/mod.js",
+      "require": "./script/mod.js"
+    }
+  },
+  "scripts": {
+    "test": "node test_runner.js"
+  },
+  "private": false,
+  "dependencies": {
+    "@temboplus/frontend-core": "^0.2.21",
     "@ts-rest/core": "^3.52.1",
-    "tslib": "^2.8.1",
+    "antd": "^5.24.2",
     "uuid": "^11.1.0",
-    "zod": "^3.24.2",
-    "zustand": "^4.5.7"
+    "zod": "^3.24.2"
   },
   "devDependencies": {
-    "@rollup/plugin-alias": "^5.1.1",
-    "@rollup/plugin-commonjs": "^28.0.3",
-    "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-node-resolve": "^16.0.1",
-    "@rollup/plugin-terser": "^0.4.4",
-    "@rollup/plugin-typescript": "^12.1.3",
-    "@types/jest": "^29.5.14",
-    "jest": "^29.7.0",
-    "rollup": "^4.39.0",
-    "ts-jest": "^29.3.1",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.8.3"
+    "@types/node": "^20.9.0",
+    "picocolors": "^1.0.0"
   },
-  "dependencies": {
-    "@temboplus/frontend-core": "^0.2.20-beta.2"
-  }
-}
+  "_generatedBy": "dnt@dev"
+}

package/script/mod.d.ts

@@ -0,0 +1,8 @@
+export * from "@features/auth/index.ts";
+export * from "@features/contact/index.ts";
+export * from "@features/wallet/index.ts";
+export * from "@features/payout/index.ts";
+export * from "@features/admin/index.ts";
+export * from "@errors/index.ts";
+export * from "@models/index.ts";
+//# sourceMappingURL=mod.d.ts.map

package/script/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../mod.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AAEzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/script/mod.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("@features/auth/index.ts"), exports);
+__exportStar(require("@features/contact/index.ts"), exports);
+__exportStar(require("@features/wallet/index.ts"), exports);
+__exportStar(require("@features/payout/index.ts"), exports);
+__exportStar(require("@features/admin/index.ts"), exports);
+__exportStar(require("@errors/index.ts"), exports);
+__exportStar(require("@models/index.ts"), exports);

package/script/npm/src/mod.d.ts

@@ -0,0 +1,8 @@
+export * from "./src/features/auth/index.js";
+export * from "./src/features/contact/index.js";
+export * from "./src/features/wallet/index.js";
+export * from "./src/features/payout/index.js";
+export * from "./src/features/admin/index.js";
+export * from "./src/errors/index.js";
+export * from "./src/models/index.js";
+//# sourceMappingURL=mod.d.ts.map

package/script/npm/src/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/mod.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}