squarefi-bff-api-module 1.36.54 → 1.36.55

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;
@@ -13533,6 +13534,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 +13605,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 +13712,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 +13903,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/apiV1Legacy.types.d.ts

@@ -7528,6 +7528,60 @@ export interface components {
                 mon_min_usd?: number;
             } | null;
         };
+        AuthResponse: {
+            /** @description JWT access token */
+            access_token?: string;
+            /**
+             * @description Token type (bearer)
+             * @enum {string}
+             */
+            token_type?: "bearer";
+            /** @description Seconds until token expiration */
+            expires_in?: number;
+            /** @description Token expiration timestamp */
+            expires_at?: number;
+            /** @description Refresh token for obtaining new access token */
+            refresh_token?: string;
+            user?: components["schemas"]["User"];
+        };
+        User: {
+            /** @description User's unique identifier */
+            id?: string;
+            /** @description Audience for the token */
+            aud?: string;
+            /** @description User's role */
+            role?: string;
+            /** @description User's email address */
+            email?: string;
+            /**
+             * Format: date-time
+             * @description When email was confirmed
+             */
+            email_confirmed_at?: string;
+            /** @description User's phone number */
+            phone?: string;
+            /**
+             * Format: date-time
+             * @description When user was confirmed
+             */
+            confirmed_at?: string;
+            /**
+             * Format: date-time
+             * @description When recovery email was sent
+             */
+            recovery_sent_at?: string;
+            /**
+             * Format: date-time
+             * @description Last sign in timestamp
+             */
+            last_sign_in_at?: string;
+            identities?: Record<string, never>[];
+            /** Format: date-time */
+            created_at?: string;
+            /** Format: date-time */
+            updated_at?: string;
+            is_anonymous?: boolean;
+        };
         SubAccount: {
             /**
              * @description Unique identifier for the sub-account
@@ -8311,7 +8365,6 @@ export interface components {
                 [key: string]: unknown;
             };
         };
-        User: unknown;
         Wallet: unknown;
         WalletDetailed: unknown;
         CryptoAddress: unknown;

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.55",
   "description": "Squarefi BFF API client module",
   "type": "module",
   "main": "./dist/index.js",