squarefi-bff-api-module 1.36.54 → 1.36.56

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

@@ -7379,6 +7379,8 @@ export interface components {
              * @description Associated issuing program ID
              */
             issuing_program_id?: string;
+            /** @description Cards issued to this person (every status, canceled included), including cards on sibling per-vendor rows of the same person. Always present on list/get/PATCH; 0 when none. */
+            cards_count?: number;
             address?: components["schemas"]["CardholderAddress"];
         };
         /** @description An uploaded KYC file, addressable before it is attached to a cardholder */

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

@@ -4602,8 +4602,8 @@ export interface paths {
                                 code?: string | null;
                                 /** @description Initial topup amount */
                                 initial_topup?: number | null;
-                                /** @description Card design configuration */
-                                card_design?: Record<string, never> | null;
+                                /** @description Card artwork for this program; null = use the app's built-in design */
+                                card_design?: components["schemas"]["CardDesign"] | null;
                                 /** @description Legal consent text for card creation */
                                 consent_text?: string | null;
                                 /** @description One-time card issuing fee */
@@ -4702,7 +4702,8 @@ export interface paths {
                                 icon?: string | null;
                                 code?: string | null;
                                 initial_topup?: number | null;
-                                card_design?: Record<string, never> | null;
+                                /** @description Card artwork for this program; null = use the app's built-in design */
+                                card_design?: components["schemas"]["CardDesign"] | null;
                                 consent_text?: string | null;
                                 card_issuing_fee?: number | null;
                                 card_monthly_fee?: number | null;
@@ -10759,6 +10760,126 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/frontend/wallets/active": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Active wallet of the caller
+         * @description The wallet the app should open for the authenticated user.
+         *
+         *     Resolution order:
+         *     1. the wallet the user picked in Settings — the membership flagged
+         *        `wallets_users.is_selected`, while it is still active and the
+         *        wallet is not deleted;
+         *     2. otherwise the default kept for users who never picked one — the
+         *        `is_main` wallet, else the oldest one.
+         *
+         *     The selection cannot outlive the access it rides on: the flag sits on
+         *     the membership row, so revoking membership drops it. A deleted wallet
+         *     or a deactivated membership falls back to the default.
+         *
+         *     **Authentication**: Bearer token with x-tenant-id header required
+         *
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Resolved active wallet id (`null` when the user reaches no wallet). */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: {
+                                /** Format: uuid */
+                                wallet_id?: string | null;
+                            };
+                        };
+                    };
+                };
+                401: components["responses"]["UnauthorizedError"];
+            };
+        };
+        /**
+         * Select the active wallet
+         * @description Stores the caller's active-wallet choice on their own `wallets_users`
+         *     row (`is_selected`), so it follows the account instead of the device.
+         *     At most one such row exists per user — the DB enforces it.
+         *
+         *     The choice is per user, not per wallet: selecting a wallet shared with
+         *     the caller changes nothing for its owner or for the other members.
+         *     Any wallet the caller is an **active member** of may be selected —
+         *     ownership is not required.
+         *
+         *     **Authentication**: Bearer token with x-tenant-id header required
+         *
+         */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        wallet_id: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Selection stored. */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            /** @example Active wallet updated successfully */
+                            message?: string;
+                            data?: {
+                                /** Format: uuid */
+                                wallet_id?: string;
+                            };
+                        };
+                    };
+                };
+                /** @description wallet_id missing or blank */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                401: components["responses"]["UnauthorizedError"];
+                403: components["responses"]["ForbiddenError"];
+                404: components["responses"]["NotFoundError"];
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/frontend/wallets/accept-invite": {
         parameters: {
             query?: never;
@@ -13533,6 +13654,27 @@ export interface components {
             /** Format: date-time */
             created_at: string;
         };
+        /** @description How a card issued on this program is painted. Normalized on read, so every field here is either absent or usable — the abandoned shapes still in the column (`style.color`, `front_img`/`back_img`, a double-encoded JSON string) never reach a client. `null` means the program has no design: fall back to the app's built-in artwork. */
+        CardDesign: {
+            /**
+             * @description Contract version.
+             * @enum {integer}
+             */
+            version: 1;
+            /** @description The card face. One artwork for both themes — a card is a printed object, it does not restyle when the app does. */
+            cover?: {
+                /**
+                 * Format: uri
+                 * @description Absolute https URL of the artwork, authored at 2x of 318×200 (636×400).
+                 */
+                image_url?: string;
+            };
+            /**
+             * @description Hex colour for every text on the card (balance, nickname, masked PAN). Set it when the artwork needs contrast the app-wide card text colour does not give.
+             * @example #ffffff
+             */
+            text_color?: string;
+        };
         /** @description Issuing program configuration (`issuing_programs` row). When joined it also carries nested `order_types`, `kyc_rails` and `integration_vendors` (hence additionalProperties). */
         IssuingProgram: {
             /** Format: uuid */
@@ -13583,9 +13725,7 @@ export interface components {
             initial_topup?: number | null;
             /** @description Minimum top-up amount in program currency, compared against the credited amount (0 = no minimum) */
             min_topup?: number;
-            card_design?: {
-                [key: string]: unknown;
-            } | null;
+            card_design?: components["schemas"]["CardDesign"] | null;
             /** Format: uuid */
             kyc_rails_id?: string | null;
             /** Format: uuid */
@@ -13692,6 +13832,8 @@ export interface components {
             /** @description Embedded sub-account summary, or null when no sub-account is linked. Present on the normal (vendor-enriched) response; omitted only in the degraded local-only error mode. */
             sub_account: components["schemas"]["IssuingCardSubAccount"] | null;
             limits?: components["schemas"]["IssuingCardLimits"] | null;
+            /** @description This card's artwork, copied from its issuing program so a client needs no second request to paint the card. `null` = the program has no design, use the app's built-in artwork. */
+            card_design?: components["schemas"]["CardDesign"] | null;
             /** Format: date-time */
             created_at?: string;
             /** Format: date-time */
@@ -13881,6 +14023,8 @@ export interface components {
              * @description CORE user this cardholder is linked to (user_data provisioning mode); null for manually-created cardholders.
              */
             user_data_uuid?: string | null;
+            /** @description Cards issued to this person (every status, canceled included), including cards on sibling per-vendor rows of the same person. Always present on list/get/PATCH; 0 when none. */
+            cards_count?: number;
             vendor_id?: string | null;
             vendor_name?: string | null;
             vendor_type?: string | null;

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

@@ -8043,6 +8043,8 @@ export interface components {
              * @description Associated issuing program ID
              */
             issuing_program_id?: string;
+            /** @description Cards issued to this person (every status, canceled included), including cards on sibling per-vendor rows of the same person. Always present on list/get/PATCH; 0 when none. */
+            cards_count?: number;
             address?: components["schemas"]["CardholderAddress"];
         };
         /** @description An uploaded KYC file, addressable before it is attached to a cardholder */

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

@@ -88,6 +88,27 @@ export declare namespace API {
         }
     }
     namespace Cards {
+        /**
+         * How a card is painted: the artwork of the issuing program it belongs to.
+         *
+         * Normalized by the BFF on every read, so each field is either absent or
+         * usable — the abandoned shapes the `card_design` column still holds
+         * (`style.color`, `front_img`/`back_img`, a double-encoded JSON string)
+         * never reach a client. `null` means the program has no design and the app
+         * paints its own built-in artwork instead.
+         *
+         * One artwork covers both themes: a card face is a printed object, not a UI
+         * surface, so it does not restyle when the app does.
+         */
+        interface CardDesign {
+            version: 1;
+            cover?: {
+                /** Absolute https URL of the artwork, authored at 636×400 (2× the card). */
+                image_url?: string;
+            };
+            /** Hex colour for every text on the card face (balance, nickname, PAN). */
+            text_color?: string;
+        }
         namespace Config {
             type IssuingProgramOrderType = {
                 id: string;
@@ -127,6 +148,12 @@ export declare namespace API {
                  */
                 min_topup?: number;
                 status?: IssuingProgramStatus | string;
+                /**
+                 * The program's artwork. Present on DETAILED program responses only;
+                 * `null` when the program has none. Cards carry their own copy
+                 * (`IssuingCardListItem.card_design`) — read that when painting a card.
+                 */
+                card_design?: API.Cards.CardDesign | null;
             }
         }
         interface User {
@@ -204,6 +231,13 @@ export declare namespace API {
             type: CardType | string;
             form_factor: CardFormFactor | string;
             tokenizable: boolean;
+            /**
+             * This card's artwork, copied from its issuing program. Served WITH the
+             * card on purpose: joining against the program catalogue client-side
+             * costs a second request AND makes the card visibly swap artwork once
+             * that lands. `null` = no design, paint the app's built-in one.
+             */
+            card_design?: API.Cards.CardDesign | null;
         }
         interface IssuingCardDetailItem {
             id: string;
@@ -220,6 +254,8 @@ export declare namespace API {
             tokenizable: boolean;
             issuing_programs: API.Cards.Config.Program;
             limits?: API.Cards.Limits.Limits;
+            /** This card's artwork; see `IssuingCardListItem.card_design`. */
+            card_design?: API.Cards.CardDesign | null;
         }
         interface SubAccountCardListItem {
             type: string;

package/package.json

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