fiberx-backend-toolkit 1.0.12 → 1.0.14

package/dist/fibase/clients/base_fibase_app_client.d.ts

@@ -0,0 +1,26 @@
+import { LoggerUtil } from "../../utils/main";
+import { FibaseAppClientConfigInterface, FibaseHeaderNamesInterface, FibaseHttpResponseInterface, FibaseRequestOptionsInterface, FibaseSignedRequestDataInterface, FibaseSignedRequestInputInterface } from "../../types/fibase_type";
+/** Shared signing, route-building, and HTTP behavior for every Fibase API version. */
+declare abstract class BaseFibaseAppClient {
+    readonly name: string;
+    protected readonly logger: LoggerUtil;
+    protected readonly config: FibaseAppClientConfigInterface;
+    protected readonly headers: FibaseHeaderNamesInterface;
+    private static readonly DEFAULT_HEADERS;
+    constructor(config: FibaseAppClientConfigInterface, client_name?: string);
+    /** Validate the values required to sign every Fibase request. */
+    private validateConfig;
+    /** Normalize paths to the same value Fibase uses when checking signatures. */
+    private normalizePath;
+    /** Fill named route parameters with safely encoded values. */
+    protected buildRoute(template: string, params: Record<string, string | number>): string;
+    /** Build the body digest used in Fibase's canonical request string. */
+    hashBody(body: unknown): string;
+    /** Build the canonical string signed by registered apps. */
+    buildCanonicalString(method: string, path: string, timestamp: string, nonce: string, body: unknown): string;
+    /** Build a signed request without sending it. */
+    buildSignedRequest<TBody = unknown>(input: FibaseSignedRequestInputInterface<TBody>): FibaseSignedRequestDataInterface<TBody>;
+    /** Send one signed request through the shared Axios transport. */
+    request<TResponse = unknown, TBody = unknown>(method: string, path: string, body?: TBody, options?: FibaseRequestOptionsInterface): Promise<FibaseHttpResponseInterface<TResponse>>;
+}
+export default BaseFibaseAppClient;

package/dist/fibase/clients/base_fibase_app_client.js

@@ -0,0 +1,133 @@
+"use strict";
+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");
+/** Shared signing, route-building, and HTTP behavior for every Fibase API version. */
+class BaseFibaseAppClient {
+    name;
+    logger;
+    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",
+    };
+    constructor(config, client_name = "base_fibase_app_client") {
+        this.name = client_name;
+        this.logger = new main_1.LoggerUtil(this.name);
+        this.config = {
+            ...config,
+            base_url: config.base_url.replace(/\/+$/, ""),
+            key_algorithm: config.key_algorithm ?? "sha256",
+            timeout_ms: config.timeout_ms ?? 30000,
+        };
+        this.headers = { ...BaseFibaseAppClient.DEFAULT_HEADERS, ...(config.headers ?? {}) };
+        this.validateConfig();
+    }
+    /** Validate the values required to sign every Fibase request. */
+    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 paths to the same value Fibase uses when checking signatures. */
+    normalizePath(path) {
+        const [pathname] = path.split("?");
+        return pathname.startsWith("/") ? pathname : `/${pathname}`;
+    }
+    /** Fill named route parameters with safely encoded values. */
+    buildRoute(template, params) {
+        return template.replace(/:([A-Za-z0-9_]+)/g, (_match, name) => {
+            const value = params[name];
+            if (value === undefined) {
+                throw new Error(`Missing Fibase route parameter: ${name}`);
+            }
+            return encodeURIComponent(String(value));
+        });
+    }
+    /** Build the body digest used in Fibase's canonical request string. */
+    hashBody(body) {
+        return main_1.CryptoKeyUtil.hash(JSON.stringify(body ?? {}), "sha256", "hex");
+    }
+    /** Build the canonical string signed by registered apps. */
+    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. */
+    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 one signed request through the shared Axios transport. */
+    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 ?? {}) },
+            params: options.params,
+            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,
+        };
+    }
+}
+exports.default = BaseFibaseAppClient;

package/dist/fibase/clients/generated_fibase_registered_app_client.d.ts

@@ -0,0 +1,10 @@
+/** Generated by scripts/generate-fibase-registered-app-routes.js. */
+import { FibaseAppClientConfigInterface } from "../../types/fibase_type";
+import BaseFibaseAppClient from "./base_fibase_app_client";
+import FibaseV1Client from "./v1/fibase_v1_client";
+/** Generated API-version properties shared by the main Fibase client. */
+declare class GeneratedFibaseRegisteredAppClient extends BaseFibaseAppClient {
+    readonly v1: FibaseV1Client;
+    constructor(config: FibaseAppClientConfigInterface, client_name?: string);
+}
+export default GeneratedFibaseRegisteredAppClient;

package/dist/fibase/clients/generated_fibase_registered_app_client.js

@@ -0,0 +1,16 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const base_fibase_app_client_1 = __importDefault(require("./base_fibase_app_client"));
+const fibase_v1_client_1 = __importDefault(require("./v1/fibase_v1_client"));
+/** Generated API-version properties shared by the main Fibase client. */
+class GeneratedFibaseRegisteredAppClient extends base_fibase_app_client_1.default {
+    v1;
+    constructor(config, client_name = "fibase_app_client") {
+        super(config, client_name);
+        this.v1 = new fibase_v1_client_1.default(config);
+    }
+}
+exports.default = GeneratedFibaseRegisteredAppClient;

package/dist/fibase/clients/v1/fibase_v1_client.d.ts

@@ -0,0 +1,15 @@
+/** Generated by scripts/generate-fibase-registered-app-routes.js. */
+import { FibaseAppClientConfigInterface } from "../../../types/fibase_type";
+import FibaseV1IdentityClient from "./fibase_v1_identity_client";
+import FibaseV1IdentityWalletClient from "./fibase_v1_identity_wallet_client";
+import FibaseV1PaymentConfigClient from "./fibase_v1_payment_config_client";
+import FibaseV1TransactionClient from "./fibase_v1_transaction_client";
+/** Resource clients for Fibase's registered-app v1 API. */
+declare class FibaseV1Client {
+    readonly identity: FibaseV1IdentityClient;
+    readonly identity_wallet: FibaseV1IdentityWalletClient;
+    readonly payment_config: FibaseV1PaymentConfigClient;
+    readonly transaction: FibaseV1TransactionClient;
+    constructor(config: FibaseAppClientConfigInterface);
+}
+export default FibaseV1Client;

package/dist/fibase/clients/v1/fibase_v1_client.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fibase_v1_identity_client_1 = __importDefault(require("./fibase_v1_identity_client"));
+const fibase_v1_identity_wallet_client_1 = __importDefault(require("./fibase_v1_identity_wallet_client"));
+const fibase_v1_payment_config_client_1 = __importDefault(require("./fibase_v1_payment_config_client"));
+const fibase_v1_transaction_client_1 = __importDefault(require("./fibase_v1_transaction_client"));
+/** Resource clients for Fibase's registered-app v1 API. */
+class FibaseV1Client {
+    identity;
+    identity_wallet;
+    payment_config;
+    transaction;
+    constructor(config) {
+        this.identity = new fibase_v1_identity_client_1.default(config);
+        this.identity_wallet = new fibase_v1_identity_wallet_client_1.default(config);
+        this.payment_config = new fibase_v1_payment_config_client_1.default(config);
+        this.transaction = new fibase_v1_transaction_client_1.default(config);
+    }
+}
+exports.default = FibaseV1Client;

package/dist/fibase/clients/v1/fibase_v1_identity_client.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated by scripts/generate-fibase-registered-app-routes.js.
+ * Update the route or contract registry, then rerun the generator.
+ */
+import BaseFibaseAppClient from "../base_fibase_app_client";
+import { FibaseAppClientConfigInterface } from "../../../types/fibase_type";
+import { FibaseRegisteredAppRequestOptionsInterface, FibaseResolveAppIdentityInputInterface, FibaseResolveAppIdentityResponse, FibaseGetAppIdentityResponse } from "../../../types/fibase_registered_app_api_type";
+/** Fibase v1 registered-app identity endpoints. */
+declare class FibaseV1IdentityClient extends BaseFibaseAppClient {
+    constructor(config: FibaseAppClientConfigInterface);
+    /** POST /api/app/v1/identity/resolve */
+    getOrCreateAppIdentityRecord(input: FibaseResolveAppIdentityInputInterface, options?: FibaseRegisteredAppRequestOptionsInterface): Promise<FibaseResolveAppIdentityResponse>;
+    /** GET /api/app/v1/identity/:member_public_id */
+    getAppIdentityRecord(member_public_id: string, options?: FibaseRegisteredAppRequestOptionsInterface): Promise<FibaseGetAppIdentityResponse>;
+}
+export default FibaseV1IdentityClient;

package/dist/fibase/clients/v1/fibase_v1_identity_client.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Generated by scripts/generate-fibase-registered-app-routes.js.
+ * Update the route or contract registry, then rerun the generator.
+ */
+const base_fibase_app_client_1 = __importDefault(require("../base_fibase_app_client"));
+const registered_app_api_routes_1 = __importDefault(require("../../registered_app_api_routes"));
+/** Fibase v1 registered-app identity endpoints. */
+class FibaseV1IdentityClient extends base_fibase_app_client_1.default {
+    constructor(config) {
+        super(config, "fibase_v1_identity_client");
+    }
+    /** POST /api/app/v1/identity/resolve */
+    async getOrCreateAppIdentityRecord(input, options = {}) {
+        return this.request("POST", registered_app_api_routes_1.default.v1.getOrCreateAppIdentityRecord, input, options);
+    }
+    /** GET /api/app/v1/identity/:member_public_id */
+    async getAppIdentityRecord(member_public_id, options = {}) {
+        return this.request("GET", this.buildRoute(registered_app_api_routes_1.default.v1.getAppIdentityRecord, {
+            member_public_id: member_public_id,
+        }), undefined, options);
+    }
+}
+exports.default = FibaseV1IdentityClient;

package/dist/fibase/clients/v1/fibase_v1_identity_wallet_client.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Generated by scripts/generate-fibase-registered-app-routes.js.
+ * Update the route or contract registry, then rerun the generator.
+ */
+import BaseFibaseAppClient from "../base_fibase_app_client";
+import { FibaseAppClientConfigInterface } from "../../../types/fibase_type";
+import { FibaseRegisteredAppRequestOptionsInterface, FibaseGetAppIdentityWalletListInputInterface, FibaseGetAppIdentityWalletListResponse, FibaseResolveAppIdentityCurrencyWalletInputInterface, FibaseResolveAppIdentityCurrencyWalletResponse, FibaseGetAppIdentityCurrencyWalletInputInterface, FibaseGetAppIdentityCurrencyWalletResponse } from "../../../types/fibase_registered_app_api_type";
+/** Fibase v1 registered-app identity_wallet endpoints. */
+declare class FibaseV1IdentityWalletClient extends BaseFibaseAppClient {
+    constructor(config: FibaseAppClientConfigInterface);
+    /** GET /api/app/v1/identity/:identity_public_id/wallets */
+    getAppIdentityWalletList(input: FibaseGetAppIdentityWalletListInputInterface, options?: FibaseRegisteredAppRequestOptionsInterface): Promise<FibaseGetAppIdentityWalletListResponse>;
+    /** POST /api/app/v1/identity/:identity_public_id/wallets/resolve */
+    getOrCreateAppIdentityCurrencyWallet(input: FibaseResolveAppIdentityCurrencyWalletInputInterface, options?: FibaseRegisteredAppRequestOptionsInterface): Promise<FibaseResolveAppIdentityCurrencyWalletResponse>;
+    /** GET /api/app/v1/identity/:identity_public_id/wallets/:currency_id */
+    getAppIdentityCurrencyWallet(input: FibaseGetAppIdentityCurrencyWalletInputInterface, options?: FibaseRegisteredAppRequestOptionsInterface): Promise<FibaseGetAppIdentityCurrencyWalletResponse>;
+}
+export default FibaseV1IdentityWalletClient;

package/dist/fibase/clients/v1/fibase_v1_identity_wallet_client.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Generated by scripts/generate-fibase-registered-app-routes.js.
+ * Update the route or contract registry, then rerun the generator.
+ */
+const base_fibase_app_client_1 = __importDefault(require("../base_fibase_app_client"));
+const registered_app_api_routes_1 = __importDefault(require("../../registered_app_api_routes"));
+/** Fibase v1 registered-app identity_wallet endpoints. */
+class FibaseV1IdentityWalletClient extends base_fibase_app_client_1.default {
+    constructor(config) {
+        super(config, "fibase_v1_identity_wallet_client");
+    }
+    /** GET /api/app/v1/identity/:identity_public_id/wallets */
+    async getAppIdentityWalletList(input, options = {}) {
+        return this.request("GET", this.buildRoute(registered_app_api_routes_1.default.v1.getAppIdentityWalletList, {
+            identity_public_id: input.identity_public_id,
+        }), undefined, { ...options, params: { ...(input.query ?? {}) } });
+    }
+    /** POST /api/app/v1/identity/:identity_public_id/wallets/resolve */
+    async getOrCreateAppIdentityCurrencyWallet(input, options = {}) {
+        return this.request("POST", this.buildRoute(registered_app_api_routes_1.default.v1.getOrCreateAppIdentityCurrencyWallet, {
+            identity_public_id: input.identity_public_id,
+        }), { currency_id: input.currency_id }, options);
+    }
+    /** GET /api/app/v1/identity/:identity_public_id/wallets/:currency_id */
+    async getAppIdentityCurrencyWallet(input, options = {}) {
+        return this.request("GET", this.buildRoute(registered_app_api_routes_1.default.v1.getAppIdentityCurrencyWallet, {
+            identity_public_id: input.identity_public_id,
+            currency_id: input.currency_id,
+        }), undefined, options);
+    }
+}
+exports.default = FibaseV1IdentityWalletClient;

package/dist/fibase/clients/v1/fibase_v1_payment_config_client.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated by scripts/generate-fibase-registered-app-routes.js.
+ * Update the route or contract registry, then rerun the generator.
+ */
+import BaseFibaseAppClient from "../base_fibase_app_client";
+import { FibaseAppClientConfigInterface } from "../../../types/fibase_type";
+import { FibaseRegisteredAppRequestOptionsInterface, FibaseGetAppCurrencyListInputInterface, FibaseGetAppCurrencyListResponse, FibaseGetAppCurrencyPaymentOptionsResponse } from "../../../types/fibase_registered_app_api_type";
+/** Fibase v1 registered-app payment_config endpoints. */
+declare class FibaseV1PaymentConfigClient extends BaseFibaseAppClient {
+    constructor(config: FibaseAppClientConfigInterface);
+    /** GET /api/app/v1/payment-config/currencies */
+    getAppCurrencyList(input: FibaseGetAppCurrencyListInputInterface, options?: FibaseRegisteredAppRequestOptionsInterface): Promise<FibaseGetAppCurrencyListResponse>;
+    /** GET /api/app/v1/payment-config/currencies/:currency_id/options */
+    getAppCurrencyPaymentOptions(currency_id: string | number, options?: FibaseRegisteredAppRequestOptionsInterface): Promise<FibaseGetAppCurrencyPaymentOptionsResponse>;
+}
+export default FibaseV1PaymentConfigClient;

package/dist/fibase/clients/v1/fibase_v1_payment_config_client.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Generated by scripts/generate-fibase-registered-app-routes.js.
+ * Update the route or contract registry, then rerun the generator.
+ */
+const base_fibase_app_client_1 = __importDefault(require("../base_fibase_app_client"));
+const registered_app_api_routes_1 = __importDefault(require("../../registered_app_api_routes"));
+/** Fibase v1 registered-app payment_config endpoints. */
+class FibaseV1PaymentConfigClient extends base_fibase_app_client_1.default {
+    constructor(config) {
+        super(config, "fibase_v1_payment_config_client");
+    }
+    /** GET /api/app/v1/payment-config/currencies */
+    async getAppCurrencyList(input, options = {}) {
+        return this.request("GET", registered_app_api_routes_1.default.v1.getAppCurrencyList, undefined, {
+            ...options,
+            params: { ...(input.query ?? {}) },
+        });
+    }
+    /** GET /api/app/v1/payment-config/currencies/:currency_id/options */
+    async getAppCurrencyPaymentOptions(currency_id, options = {}) {
+        return this.request("GET", this.buildRoute(registered_app_api_routes_1.default.v1.getAppCurrencyPaymentOptions, {
+            currency_id: currency_id,
+        }), undefined, options);
+    }
+}
+exports.default = FibaseV1PaymentConfigClient;

package/dist/fibase/clients/v1/fibase_v1_transaction_client.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Generated by scripts/generate-fibase-registered-app-routes.js.
+ * Update the route or contract registry, then rerun the generator.
+ */
+import BaseFibaseAppClient from "../base_fibase_app_client";
+import { FibaseAppClientConfigInterface } from "../../../types/fibase_type";
+import { FibaseRegisteredAppRequestOptionsInterface, FibaseInitiateAppDepositTransactionInputInterface, FibaseInitiateAppDepositTransactionResponse, FibaseGetAppTransactionResponse, FibaseVerifyAppTransactionResponse } from "../../../types/fibase_registered_app_api_type";
+/** Fibase v1 registered-app transaction endpoints. */
+declare class FibaseV1TransactionClient extends BaseFibaseAppClient {
+    constructor(config: FibaseAppClientConfigInterface);
+    /** POST /api/app/v1/transactions/deposits */
+    initiateAppDepositTransaction(input: FibaseInitiateAppDepositTransactionInputInterface, options?: FibaseRegisteredAppRequestOptionsInterface): Promise<FibaseInitiateAppDepositTransactionResponse>;
+    /**
+     * GET /api/app/v1/transactions/reference/:app_reference
+     * Fibase currently returns `501 service_not_implemented` for this route.
+     */
+    getAppTransactionByReference(app_reference: string, options?: FibaseRegisteredAppRequestOptionsInterface): Promise<FibaseGetAppTransactionResponse>;
+    /**
+     * POST /api/app/v1/transactions/:transaction_public_id/verify
+     * Fibase currently returns `501 service_not_implemented` for this route.
+     */
+    verifyAppTransaction(transaction_public_id: string, options?: FibaseRegisteredAppRequestOptionsInterface): Promise<FibaseVerifyAppTransactionResponse>;
+    /**
+     * GET /api/app/v1/transactions/:transaction_public_id
+     * Fibase currently returns `501 service_not_implemented` for this route.
+     */
+    getAppTransactionRecord(transaction_public_id: string, options?: FibaseRegisteredAppRequestOptionsInterface): Promise<FibaseGetAppTransactionResponse>;
+}
+export default FibaseV1TransactionClient;

package/dist/fibase/clients/v1/fibase_v1_transaction_client.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Generated by scripts/generate-fibase-registered-app-routes.js.
+ * Update the route or contract registry, then rerun the generator.
+ */
+const base_fibase_app_client_1 = __importDefault(require("../base_fibase_app_client"));
+const registered_app_api_routes_1 = __importDefault(require("../../registered_app_api_routes"));
+/** Fibase v1 registered-app transaction endpoints. */
+class FibaseV1TransactionClient extends base_fibase_app_client_1.default {
+    constructor(config) {
+        super(config, "fibase_v1_transaction_client");
+    }
+    /** POST /api/app/v1/transactions/deposits */
+    async initiateAppDepositTransaction(input, options = {}) {
+        return this.request("POST", registered_app_api_routes_1.default.v1.initiateAppDepositTransaction, input, options);
+    }
+    /**
+     * GET /api/app/v1/transactions/reference/:app_reference
+     * Fibase currently returns `501 service_not_implemented` for this route.
+     */
+    async getAppTransactionByReference(app_reference, options = {}) {
+        return this.request("GET", this.buildRoute(registered_app_api_routes_1.default.v1.getAppTransactionByReference, {
+            app_reference: app_reference,
+        }), undefined, options);
+    }
+    /**
+     * POST /api/app/v1/transactions/:transaction_public_id/verify
+     * Fibase currently returns `501 service_not_implemented` for this route.
+     */
+    async verifyAppTransaction(transaction_public_id, options = {}) {
+        return this.request("POST", this.buildRoute(registered_app_api_routes_1.default.v1.verifyAppTransaction, {
+            transaction_public_id: transaction_public_id,
+        }), {}, options);
+    }
+    /**
+     * GET /api/app/v1/transactions/:transaction_public_id
+     * Fibase currently returns `501 service_not_implemented` for this route.
+     */
+    async getAppTransactionRecord(transaction_public_id, options = {}) {
+        return this.request("GET", this.buildRoute(registered_app_api_routes_1.default.v1.getAppTransactionRecord, {
+            transaction_public_id: transaction_public_id,
+        }), undefined, options);
+    }
+}
+exports.default = FibaseV1TransactionClient;

package/dist/fibase/clients/v1/main.d.ts

@@ -0,0 +1,6 @@
+/** Generated by scripts/generate-fibase-registered-app-routes.js. */
+export { default as FibaseV1Client } from "./fibase_v1_client";
+export { default as FibaseV1IdentityClient } from "./fibase_v1_identity_client";
+export { default as FibaseV1IdentityWalletClient } from "./fibase_v1_identity_wallet_client";
+export { default as FibaseV1PaymentConfigClient } from "./fibase_v1_payment_config_client";
+export { default as FibaseV1TransactionClient } from "./fibase_v1_transaction_client";

package/dist/fibase/clients/v1/main.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FibaseV1TransactionClient = exports.FibaseV1PaymentConfigClient = exports.FibaseV1IdentityWalletClient = exports.FibaseV1IdentityClient = exports.FibaseV1Client = void 0;
+/** Generated by scripts/generate-fibase-registered-app-routes.js. */
+var fibase_v1_client_1 = require("./fibase_v1_client");
+Object.defineProperty(exports, "FibaseV1Client", { enumerable: true, get: function () { return __importDefault(fibase_v1_client_1).default; } });
+var fibase_v1_identity_client_1 = require("./fibase_v1_identity_client");
+Object.defineProperty(exports, "FibaseV1IdentityClient", { enumerable: true, get: function () { return __importDefault(fibase_v1_identity_client_1).default; } });
+var fibase_v1_identity_wallet_client_1 = require("./fibase_v1_identity_wallet_client");
+Object.defineProperty(exports, "FibaseV1IdentityWalletClient", { enumerable: true, get: function () { return __importDefault(fibase_v1_identity_wallet_client_1).default; } });
+var fibase_v1_payment_config_client_1 = require("./fibase_v1_payment_config_client");
+Object.defineProperty(exports, "FibaseV1PaymentConfigClient", { enumerable: true, get: function () { return __importDefault(fibase_v1_payment_config_client_1).default; } });
+var fibase_v1_transaction_client_1 = require("./fibase_v1_transaction_client");
+Object.defineProperty(exports, "FibaseV1TransactionClient", { enumerable: true, get: function () { return __importDefault(fibase_v1_transaction_client_1).default; } });

package/dist/fibase/fibase_app_client.d.ts

@@ -1,52 +1,17 @@
-import { FibaseAppClientConfigInterface, FibaseAppClientEnvOptionsInterface, FibaseAppEventBuildInputInterface, FibaseHttpResponseInterface, FibaseRequestOptionsInterface, FibaseSendAppEventOptionsInterface, FibaseSignedRequestDataInterface, FibaseSignedRequestInputInterface } from "../types/fibase_type";
-declare class FibaseAppClient {
+import GeneratedFibaseRegisteredAppClient from "./clients/generated_fibase_registered_app_client";
+import { FibaseAppClientConfigInterface, FibaseAppClientEnvOptionsInterface, FibaseAppEventBuildInputInterface, FibaseHttpResponseInterface, FibaseSendAppEventOptionsInterface } from "../types/fibase_type";
+/** Main Fibase client and entry point for versioned API clients. */
+declare class FibaseAppClient extends GeneratedFibaseRegisteredAppClient {
     private static instance;
-    readonly name = "fibase_app_client";
-    private readonly logger;
-    private readonly config;
-    private readonly headers;
-    private static readonly DEFAULT_HEADERS;
     private static readonly DEFAULT_BASE_URLS;
     constructor(config: FibaseAppClientConfigInterface);
-    /**
-     * Create a singleton client for applications that prefer process-wide reuse.
-     */
+    /** Create a process-wide Fibase client. */
     static initialize(config: FibaseAppClientConfigInterface): FibaseAppClient;
-    /**
-     * Return the initialized singleton client.
-     */
+    /** Return the initialized process-wide client. */
     static getInstance(): FibaseAppClient;
-    /**
-     * Build a client from environment variables loaded by EnvManagerUtil.
-     */
+    /** Build a client from Fibase environment variables. */
     static fromEnv(options?: FibaseAppClientEnvOptionsInterface): FibaseAppClient;
-    /**
-     * Validate the minimum data required to sign Fibase app requests.
-     */
-    private validateConfig;
-    /**
-     * Normalize request paths so signature generation matches the server authenticator.
-     */
-    private normalizePath;
-    /**
-     * Build the same body hash format used by Fibase's RequestAuthenticatorUtil.
-     */
-    hashBody(body: unknown): string;
-    /**
-     * Build the canonical string signed by external apps and verified by Fibase.
-     */
-    buildCanonicalString(method: string, path: string, timestamp: string, nonce: string, body: unknown): string;
-    /**
-     * Build a signed request without sending it. Useful for tests and custom transports.
-     */
-    buildSignedRequest<TBody = unknown>(input: FibaseSignedRequestInputInterface<TBody>): FibaseSignedRequestDataInterface<TBody>;
-    /**
-     * Send a signed request to Fibase using the standard app-auth headers.
-     */
-    request<TResponse = unknown, TBody = unknown>(method: string, path: string, body?: TBody, options?: FibaseRequestOptionsInterface): Promise<FibaseHttpResponseInterface<TResponse>>;
-    /**
-     * Build and send a standard app event to the Fibase central app.
-     */
+    /** Build and send a standard app event to Fibase. */
     sendAppEvent<TPayload, TResponse = unknown>(input: FibaseAppEventBuildInputInterface<TPayload>, options?: FibaseSendAppEventOptionsInterface): Promise<FibaseHttpResponseInterface<TResponse>>;
 }
 export default FibaseAppClient;