fiberx-backend-toolkit 1.0.12 → 1.0.14

package/dist/fibase/fibase_app_client.js

@@ -3,42 +3,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const axios_1 = __importDefault(require("axios"));
 const main_1 = require("../utils/main");
+const generated_fibase_registered_app_client_1 = __importDefault(require("./clients/generated_fibase_registered_app_client"));
 const app_event_payload_builder_1 = __importDefault(require("./app_event_payload_builder"));
-class FibaseAppClient {
+/** Main Fibase client and entry point for versioned API clients. */
+class FibaseAppClient extends generated_fibase_registered_app_client_1.default {
     static instance = null;
-    name = "fibase_app_client";
-    logger = new main_1.LoggerUtil(this.name);
-    config;
-    headers;
-    static DEFAULT_HEADERS = {
-        app_id: "X-App-Id",
-        app_key_version: "X-Key-Version",
-        timestamp: "X-Timestamp",
-        nonce: "X-Nonce",
-        signature: "x-Signature",
-        request_id: "X-Request-Id",
-        content_type: "Content-Type",
-    };
     static DEFAULT_BASE_URLS = {
         development: "http://localhost:4000",
         staging: "https://staging-api.fibase.app",
         production: "https://api.fibase.app",
     };
     constructor(config) {
-        this.config = {
-            ...config,
-            base_url: config.base_url.replace(/\/+$/, ""),
-            key_algorithm: config.key_algorithm ?? "sha256",
-            timeout_ms: config.timeout_ms ?? 30000,
-        };
-        this.headers = { ...FibaseAppClient.DEFAULT_HEADERS, ...(config.headers ?? {}) };
-        this.validateConfig();
+        super(config, "fibase_app_client");
     }
-    /**
-     * Create a singleton client for applications that prefer process-wide reuse.
-     */
+    /** Create a process-wide Fibase client. */
     static initialize(config) {
         if (this.instance) {
             throw new Error("FibaseAppClient already initialized.");
@@ -46,18 +25,14 @@ class FibaseAppClient {
         this.instance = new FibaseAppClient(config);
         return this.instance;
     }
-    /**
-     * Return the initialized singleton client.
-     */
+    /** Return the initialized process-wide client. */
     static getInstance() {
         if (!this.instance) {
             throw new Error("FibaseAppClient not initialized.");
         }
         return this.instance;
     }
-    /**
-     * Build a client from environment variables loaded by EnvManagerUtil.
-     */
+    /** Build a client from Fibase environment variables. */
     static fromEnv(options = {}) {
         const env_manager = main_1.EnvManagerUtil.getInstance();
         const mode = env_manager.getEnvVar("MODE", "development") ?? "development";
@@ -83,108 +58,7 @@ class FibaseAppClient {
             timeout_ms: Number(env_manager.getEnvVar(options.timeout_ms_key ?? "FIBASE_TIMEOUT_MS", 30000)),
         });
     }
-    /**
-     * Validate the minimum data required to sign Fibase app requests.
-     */
-    validateConfig() {
-        if (!this.config.base_url) {
-            throw new Error("Fibase base_url is required");
-        }
-        if (!this.config.app_id) {
-            throw new Error("Fibase app_id is required");
-        }
-        if (!this.config.app_private_key) {
-            throw new Error("Fibase app_private_key is required");
-        }
-    }
-    /**
-     * Normalize request paths so signature generation matches the server authenticator.
-     */
-    normalizePath(path) {
-        const [pathname] = path.split("?");
-        return pathname.startsWith("/") ? pathname : `/${pathname}`;
-    }
-    /**
-     * Build the same body hash format used by Fibase's RequestAuthenticatorUtil.
-     */
-    hashBody(body) {
-        const json = JSON.stringify(body ?? {});
-        return main_1.CryptoKeyUtil.hash(json, "sha256", "hex");
-    }
-    /**
-     * Build the canonical string signed by external apps and verified by Fibase.
-     */
-    buildCanonicalString(method, path, timestamp, nonce, body) {
-        return [
-            method.toUpperCase(),
-            this.normalizePath(path),
-            timestamp,
-            nonce,
-            this.hashBody(body),
-        ].join("\n");
-    }
-    /**
-     * Build a signed request without sending it. Useful for tests and custom transports.
-     */
-    buildSignedRequest(input) {
-        const method = input.method.toUpperCase();
-        const path = this.normalizePath(input.path);
-        const body = (input.body ?? {});
-        const timestamp = input.timestamp ?? Date.now().toString();
-        const nonce = input.nonce ?? main_1.UUIDGeneratorUtil.generateUUIDV2("NONCE");
-        const canonical = this.buildCanonicalString(method, path, timestamp, nonce, body);
-        const signature = main_1.CryptoKeyUtil.sign(canonical, this.config.app_private_key, this.config.key_algorithm, "base64");
-        return {
-            url: `${this.config.base_url}${path}`,
-            method,
-            path,
-            body,
-            canonical,
-            signature,
-            headers: {
-                [this.headers.content_type]: "application/json",
-                [this.headers.app_id]: this.config.app_id,
-                [this.headers.app_key_version]: String(this.config.app_key_version ?? 1),
-                [this.headers.timestamp]: timestamp,
-                [this.headers.nonce]: nonce,
-                [this.headers.signature]: signature,
-                [this.headers.request_id]: input.request_id ?? main_1.UUIDGeneratorUtil.generateUUIDV2("REQ"),
-            },
-        };
-    }
-    /**
-     * Send a signed request to Fibase using the standard app-auth headers.
-     */
-    async request(method, path, body, options = {}) {
-        const signed_request = this.buildSignedRequest({
-            method,
-            path,
-            body,
-            request_id: options.request_id,
-        });
-        const request_config = {
-            url: signed_request.url,
-            method: signed_request.method,
-            data: signed_request.body,
-            headers: { ...signed_request.headers, ...(options.headers ?? {}) },
-            timeout: this.config.timeout_ms,
-        };
-        this.logger.info("Sending signed Fibase app request", {
-            method: signed_request.method,
-            path: signed_request.path,
-            request_id: signed_request.headers[this.headers.request_id],
-        });
-        const response = await axios_1.default.request(request_config);
-        return {
-            status: response.status,
-            status_text: response.statusText,
-            data: response.data,
-            headers: response.headers,
-        };
-    }
-    /**
-     * Build and send a standard app event to the Fibase central app.
-     */
+    /** Build and send a standard app event to Fibase. */
     async sendAppEvent(input, options = {}) {
         const event_payload = app_event_payload_builder_1.default.build(input);
         return this.request("POST", options.path ?? "/api/app-events", event_payload, options);

package/dist/fibase/main.d.ts

@@ -1,3 +1,8 @@
-import FibaseAppEventPayloadBuilder from "./app_event_payload_builder";
 import FibaseAppClient from "./fibase_app_client";
-export { FibaseAppEventPayloadBuilder, FibaseAppClient };
+import BaseFibaseAppClient from "./clients/base_fibase_app_client";
+import FibaseAppEventPayloadBuilder from "./app_event_payload_builder";
+export { BaseFibaseAppClient, FibaseAppEventPayloadBuilder, FibaseAppClient };
+export * from "./clients/v1/main";
+export { default as FibaseRegisteredAppAPIRoutes, FibaseRegisteredAppAPIManifest, } from "./registered_app_api_routes";
+export * from "../types/fibase_type";
+export * from "../types/fibase_registered_app_api_type";

package/dist/fibase/main.js

@@ -1,10 +1,32 @@
 "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);
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FibaseAppClient = exports.FibaseAppEventPayloadBuilder = void 0;
-const app_event_payload_builder_1 = __importDefault(require("./app_event_payload_builder"));
-exports.FibaseAppEventPayloadBuilder = app_event_payload_builder_1.default;
+exports.FibaseRegisteredAppAPIManifest = exports.FibaseRegisteredAppAPIRoutes = exports.FibaseAppClient = exports.FibaseAppEventPayloadBuilder = exports.BaseFibaseAppClient = void 0;
 const fibase_app_client_1 = __importDefault(require("./fibase_app_client"));
 exports.FibaseAppClient = fibase_app_client_1.default;
+const base_fibase_app_client_1 = __importDefault(require("./clients/base_fibase_app_client"));
+exports.BaseFibaseAppClient = base_fibase_app_client_1.default;
+const app_event_payload_builder_1 = __importDefault(require("./app_event_payload_builder"));
+exports.FibaseAppEventPayloadBuilder = app_event_payload_builder_1.default;
+__exportStar(require("./clients/v1/main"), exports);
+var registered_app_api_routes_1 = require("./registered_app_api_routes");
+Object.defineProperty(exports, "FibaseRegisteredAppAPIRoutes", { enumerable: true, get: function () { return __importDefault(registered_app_api_routes_1).default; } });
+Object.defineProperty(exports, "FibaseRegisteredAppAPIManifest", { enumerable: true, get: function () { return registered_app_api_routes_1.FibaseRegisteredAppAPIManifest; } });
+__exportStar(require("../types/fibase_type"), exports);
+__exportStar(require("../types/fibase_registered_app_api_type"), exports);

package/dist/fibase/registered_app_api_routes.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Generated by scripts/generate-fibase-registered-app-routes.js.
+ * Do not edit by hand; edit the Fibase routes and rerun the generator.
+ */
+export declare const FibaseRegisteredAppAPIManifest: readonly [{
+    readonly name: "getOrCreateAppIdentityRecord";
+    readonly method: "POST";
+    readonly path: "/api/app/v1/identity/resolve";
+    readonly permission: "app_identity_module.get_or_create_identity_record";
+    readonly controller: "getOrCreateAppIdentityRecordController";
+}, {
+    readonly name: "getAppIdentityRecord";
+    readonly method: "GET";
+    readonly path: "/api/app/v1/identity/:member_public_id";
+    readonly permission: "app_identity_module.get_identity_record";
+    readonly controller: "getAppIdentityRecordController";
+}, {
+    readonly name: "getAppIdentityWalletList";
+    readonly method: "GET";
+    readonly path: "/api/app/v1/identity/:identity_public_id/wallets";
+    readonly permission: "app_identity_wallet_module.get_identity_wallet_list";
+    readonly controller: "getAppIdentityWalletListController";
+}, {
+    readonly name: "getOrCreateAppIdentityCurrencyWallet";
+    readonly method: "POST";
+    readonly path: "/api/app/v1/identity/:identity_public_id/wallets/resolve";
+    readonly permission: "app_identity_wallet_module.get_or_create_identity_currency_wallet";
+    readonly controller: "getOrCreateAppIdentityCurrencyWalletController";
+}, {
+    readonly name: "getAppIdentityCurrencyWallet";
+    readonly method: "GET";
+    readonly path: "/api/app/v1/identity/:identity_public_id/wallets/:currency_id";
+    readonly permission: "app_identity_wallet_module.get_identity_currency_wallet";
+    readonly controller: "getAppIdentityCurrencyWalletController";
+}, {
+    readonly name: "getAppCurrencyList";
+    readonly method: "GET";
+    readonly path: "/api/app/v1/payment-config/currencies";
+    readonly permission: "app_payment_config_module.get_app_currency_list";
+    readonly controller: "getAppCurrencyListController";
+}, {
+    readonly name: "getAppCurrencyPaymentOptions";
+    readonly method: "GET";
+    readonly path: "/api/app/v1/payment-config/currencies/:currency_id/options";
+    readonly permission: "app_payment_config_module.get_app_currency_payment_options";
+    readonly controller: "getAppCurrencyPaymentOptionsController";
+}, {
+    readonly name: "initiateAppDepositTransaction";
+    readonly method: "POST";
+    readonly path: "/api/app/v1/transactions/deposits";
+    readonly permission: "app_transaction_module.initiate_deposit_transaction";
+    readonly controller: "initiateAppDepositTransactionController";
+}, {
+    readonly name: "getAppTransactionByReference";
+    readonly method: "GET";
+    readonly path: "/api/app/v1/transactions/reference/:app_reference";
+    readonly permission: "app_transaction_module.get_transaction_by_reference";
+    readonly controller: "getAppTransactionByReferenceController";
+}, {
+    readonly name: "verifyAppTransaction";
+    readonly method: "POST";
+    readonly path: "/api/app/v1/transactions/:transaction_public_id/verify";
+    readonly permission: "app_transaction_module.verify_transaction";
+    readonly controller: "verifyAppTransactionController";
+}, {
+    readonly name: "getAppTransactionRecord";
+    readonly method: "GET";
+    readonly path: "/api/app/v1/transactions/:transaction_public_id";
+    readonly permission: "app_transaction_module.get_transaction_record";
+    readonly controller: "getAppTransactionRecordController";
+}];
+declare const FibaseRegisteredAppAPIRoutes: {
+    readonly v1: {
+        readonly getOrCreateAppIdentityRecord: "/api/app/v1/identity/resolve";
+        readonly getAppIdentityRecord: "/api/app/v1/identity/:member_public_id";
+        readonly getAppIdentityWalletList: "/api/app/v1/identity/:identity_public_id/wallets";
+        readonly getOrCreateAppIdentityCurrencyWallet: "/api/app/v1/identity/:identity_public_id/wallets/resolve";
+        readonly getAppIdentityCurrencyWallet: "/api/app/v1/identity/:identity_public_id/wallets/:currency_id";
+        readonly getAppCurrencyList: "/api/app/v1/payment-config/currencies";
+        readonly getAppCurrencyPaymentOptions: "/api/app/v1/payment-config/currencies/:currency_id/options";
+        readonly initiateAppDepositTransaction: "/api/app/v1/transactions/deposits";
+        readonly getAppTransactionByReference: "/api/app/v1/transactions/reference/:app_reference";
+        readonly verifyAppTransaction: "/api/app/v1/transactions/:transaction_public_id/verify";
+        readonly getAppTransactionRecord: "/api/app/v1/transactions/:transaction_public_id";
+    };
+};
+export default FibaseRegisteredAppAPIRoutes;

package/dist/fibase/registered_app_api_routes.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FibaseRegisteredAppAPIManifest = void 0;
+/**
+ * Generated by scripts/generate-fibase-registered-app-routes.js.
+ * Do not edit by hand; edit the Fibase routes and rerun the generator.
+ */
+exports.FibaseRegisteredAppAPIManifest = [
+    {
+        name: "getOrCreateAppIdentityRecord",
+        method: "POST",
+        path: "/api/app/v1/identity/resolve",
+        permission: "app_identity_module.get_or_create_identity_record",
+        controller: "getOrCreateAppIdentityRecordController",
+    },
+    {
+        name: "getAppIdentityRecord",
+        method: "GET",
+        path: "/api/app/v1/identity/:member_public_id",
+        permission: "app_identity_module.get_identity_record",
+        controller: "getAppIdentityRecordController",
+    },
+    {
+        name: "getAppIdentityWalletList",
+        method: "GET",
+        path: "/api/app/v1/identity/:identity_public_id/wallets",
+        permission: "app_identity_wallet_module.get_identity_wallet_list",
+        controller: "getAppIdentityWalletListController",
+    },
+    {
+        name: "getOrCreateAppIdentityCurrencyWallet",
+        method: "POST",
+        path: "/api/app/v1/identity/:identity_public_id/wallets/resolve",
+        permission: "app_identity_wallet_module.get_or_create_identity_currency_wallet",
+        controller: "getOrCreateAppIdentityCurrencyWalletController",
+    },
+    {
+        name: "getAppIdentityCurrencyWallet",
+        method: "GET",
+        path: "/api/app/v1/identity/:identity_public_id/wallets/:currency_id",
+        permission: "app_identity_wallet_module.get_identity_currency_wallet",
+        controller: "getAppIdentityCurrencyWalletController",
+    },
+    {
+        name: "getAppCurrencyList",
+        method: "GET",
+        path: "/api/app/v1/payment-config/currencies",
+        permission: "app_payment_config_module.get_app_currency_list",
+        controller: "getAppCurrencyListController",
+    },
+    {
+        name: "getAppCurrencyPaymentOptions",
+        method: "GET",
+        path: "/api/app/v1/payment-config/currencies/:currency_id/options",
+        permission: "app_payment_config_module.get_app_currency_payment_options",
+        controller: "getAppCurrencyPaymentOptionsController",
+    },
+    {
+        name: "initiateAppDepositTransaction",
+        method: "POST",
+        path: "/api/app/v1/transactions/deposits",
+        permission: "app_transaction_module.initiate_deposit_transaction",
+        controller: "initiateAppDepositTransactionController",
+    },
+    {
+        name: "getAppTransactionByReference",
+        method: "GET",
+        path: "/api/app/v1/transactions/reference/:app_reference",
+        permission: "app_transaction_module.get_transaction_by_reference",
+        controller: "getAppTransactionByReferenceController",
+    },
+    {
+        name: "verifyAppTransaction",
+        method: "POST",
+        path: "/api/app/v1/transactions/:transaction_public_id/verify",
+        permission: "app_transaction_module.verify_transaction",
+        controller: "verifyAppTransactionController",
+    },
+    {
+        name: "getAppTransactionRecord",
+        method: "GET",
+        path: "/api/app/v1/transactions/:transaction_public_id",
+        permission: "app_transaction_module.get_transaction_record",
+        controller: "getAppTransactionRecordController",
+    },
+];
+const FibaseRegisteredAppAPIRoutes = {
+    v1: {
+        getOrCreateAppIdentityRecord: "/api/app/v1/identity/resolve",
+        getAppIdentityRecord: "/api/app/v1/identity/:member_public_id",
+        getAppIdentityWalletList: "/api/app/v1/identity/:identity_public_id/wallets",
+        getOrCreateAppIdentityCurrencyWallet: "/api/app/v1/identity/:identity_public_id/wallets/resolve",
+        getAppIdentityCurrencyWallet: "/api/app/v1/identity/:identity_public_id/wallets/:currency_id",
+        getAppCurrencyList: "/api/app/v1/payment-config/currencies",
+        getAppCurrencyPaymentOptions: "/api/app/v1/payment-config/currencies/:currency_id/options",
+        initiateAppDepositTransaction: "/api/app/v1/transactions/deposits",
+        getAppTransactionByReference: "/api/app/v1/transactions/reference/:app_reference",
+        verifyAppTransaction: "/api/app/v1/transactions/:transaction_public_id/verify",
+        getAppTransactionRecord: "/api/app/v1/transactions/:transaction_public_id",
+    },
+};
+exports.default = FibaseRegisteredAppAPIRoutes;

package/dist/mailer/processors/email_enqueue_processor.js

@@ -43,7 +43,7 @@ class EmailEnqueueProcessor {
             }
         }
         if (missing.length) {
-            throw new Error(`Missing required email placeholders: ${missing.join(", ")}`);
+            throw new Error(`Missing required email placeholders: ${missing.join(", ")}, payload passed: ${payload}`);
         }
     }
     // ==============================