squarefi-bff-api-module 1.36.44 → 1.36.46

package/dist/api/frontend.d.ts

@@ -30,6 +30,8 @@ export declare const frontend: {
             };
         };
         subAccounts: {
+            getAll: (params?: API.Frontend.Issuing.SubAccounts.List.Request) => Promise<API.Frontend.Issuing.SubAccounts.List.Response>;
+            getById: ({ sub_account_id, }: API.Frontend.Issuing.SubAccounts.Get.Request) => Promise<API.Frontend.Issuing.SubAccounts.Get.Response>;
             deposit: ({ sub_account_id, ...data }: API.Frontend.Issuing.SubAccounts.Deposit.Request) => Promise<API.Frontend.Issuing.SubAccounts.Deposit.Response>;
             withdraw: ({ sub_account_id, ...data }: API.Frontend.Issuing.SubAccounts.Withdraw.Request) => Promise<API.Frontend.Issuing.SubAccounts.Withdraw.Response>;
         };

package/dist/api/frontend.js

@@ -80,6 +80,11 @@ export const frontend = {
             },
         },
         subAccounts: {
+            // Local-first list (`fiat_accounts` + computed balances + the program embed with its
+            // cardholder KYC bar). `ids` (comma-separated) makes it a targeted read of specific
+            // sub-accounts — prefer that over `getById`, whose shape varies with the vendor.
+            getAll: (params = {}) => apiClientV1Frontend.getRequest('/frontend/issuing/sub-accounts', { params }),
+            getById: ({ sub_account_id, }) => apiClientV1Frontend.getRequest(`/frontend/issuing/sub-accounts/${sub_account_id}`),
             deposit: ({ sub_account_id, ...data }) => apiClientV1Frontend.postRequest(`/frontend/issuing/sub-accounts/${sub_account_id}/deposit`, { data }),
             // Concurrent withdrawals on the same sub-account are rejected with `409`. The currency is
             // taken from the sub-account, so only the amount is needed.

package/dist/api/types/autogen/apiV1Frontend.types.d.ts

@@ -3129,6 +3129,10 @@ export interface paths {
                     wallet_id?: string;
                     /** @description Filter sub-accounts by program ID */
                     program_id?: string;
+                    /** @description Comma-separated sub-account ids to fetch (targeted read through the list shape) */
+                    ids?: string;
+                    /** @description Filter sub-accounts by type */
+                    type?: "balance" | "prepaid";
                     /** @description Filter sub-accounts by status */
                     status?: "ACTIVE" | "INACTIVE" | "SUSPENDED";
                     /** @description Number of items to skip */
@@ -3842,6 +3846,8 @@ export interface paths {
                     offset?: number;
                     /** @description Number of items to return */
                     limit?: number;
+                    /** @description Wallet context — tariffs follow the wallet owner's group. */
+                    wallet_id?: string;
                 };
                 header?: never;
                 path?: never;
@@ -3992,6 +3998,11 @@ export interface paths {
         get: {
             parameters: {
                 query?: {
+                    /** @description Wallet context: tariffs follow the wallet owner's group, and a wallet that already
+                     *     holds a sub-account on the program keeps it readable even when the rail visibility
+                     *     filter would hide it from the listing.
+                     *      */
+                    wallet_id?: string;
                     /** @description Include extra UI fields (icon, card_design, consent_text, etc.) */
                     detailed?: boolean;
                 };
@@ -4017,6 +4028,19 @@ export interface paths {
                                 /** Format: uuid */
                                 id: string;
                                 name: string;
+                                /** @enum {string} */
+                                status: "ACTIVE" | "INACTIVE";
+                                /** @description Default card spending limit */
+                                card_limit: number;
+                                /** @description Whether card supports Apple/Google Pay */
+                                tokenizable: boolean;
+                                icon?: string | null;
+                                code?: string | null;
+                                initial_topup?: number | null;
+                                card_design?: Record<string, never> | null;
+                                consent_text?: string | null;
+                                card_issuing_fee?: number | null;
+                                card_monthly_fee?: number | null;
                                 description?: string | null;
                                 /** @enum {string} */
                                 form_factor: "VIRTUAL" | "PHYSICAL";

package/dist/api/types/types.d.ts

@@ -691,18 +691,39 @@ export declare namespace API {
                 };
             };
             export namespace SubAccounts {
-                namespace Deposit {
+                type SubAccountsRoot = pathsV1Frontend['/frontend/issuing/sub-accounts'];
+                type SubAccountRoot = pathsV1Frontend['/frontend/issuing/sub-accounts/{sub_account_id}'];
+                export namespace List {
+                    /** `ids` is comma-separated — a targeted read of specific sub-accounts through the list shape. */
+                    type Request = NonNullable<SubAccountsRoot['get']['parameters']['query']>;
+                    type Response = SubAccountsRoot['get']['responses']['200']['content']['application/json'];
+                    /**
+                     * A `fiat_accounts` row enriched with computed balances, currency and the program embed.
+                     * `issuing_program.cardholder_requirements` carries the program's cardholder KYC bar even
+                     * when the program is hidden from the caller's config listing (rail visibility, group
+                     * whitelist) — the sub-account payload is the one place it can always be read from.
+                     */
+                    type SubAccount = NonNullable<Response['data']>[number];
+                }
+                export namespace Get {
+                    type Request = {
+                        sub_account_id: string;
+                    };
+                    type Response = SubAccountRoot['get']['responses']['200']['content']['application/json'];
+                }
+                export namespace Deposit {
                     type Request = {
                         sub_account_id: string;
                     } & SubAccountDepositRoot['post']['requestBody']['content']['application/json'];
                     type Response = WithOrderStatus<SubAccountDepositRoot['post']['responses']['200']['content']['application/json']>;
                 }
-                namespace Withdraw {
+                export namespace Withdraw {
                     type Request = {
                         sub_account_id: string;
                     } & SubAccountWithdrawRoot['post']['requestBody']['content']['application/json'];
                     type Response = WithOrderStatus<SubAccountWithdrawRoot['post']['responses']['200']['content']['application/json']>;
                 }
+                export {};
             }
             export namespace Cards {
                 namespace List {
@@ -955,10 +976,7 @@ export declare namespace API {
                     /** What each country changes about the cardholder dossier (a `country_rules` entry). */
                     export type CountryRule = NonNullable<NonNullable<CardholderRequirements['country_rules']>[string]>;
                     export namespace List {
-                        /** The spec omits `wallet_id`, but the handler reads it to resolve the tariff group. */
-                        type Request = NonNullable<ProgramsRoot['get']['parameters']['query']> & {
-                            wallet_id?: string;
-                        };
+                        type Request = NonNullable<ProgramsRoot['get']['parameters']['query']>;
                         type Response = ProgramsRoot['get']['responses']['200']['content']['application/json'];
                     }
                     export namespace Get {
@@ -966,6 +984,11 @@ export declare namespace API {
                             id: string;
                         } & NonNullable<ProgramByIdRoot['get']['parameters']['query']>;
                         type Response = ProgramByIdRoot['get']['responses']['200']['content']['application/json'];
+                        /**
+                         * The byId payload: the same program fields as the list item, but `order_types` is the
+                         * DETAILED form ({id, tokens}) — flatten to ids when a list-shaped Program is needed.
+                         */
+                        type Data = NonNullable<Response['data']>;
                     }
                     export {};
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "squarefi-bff-api-module",
-  "version": "1.36.44",
+  "version": "1.36.46",
   "description": "Squarefi BFF API client module",
   "type": "module",
   "main": "./dist/index.js",