squarefi-bff-api-module 1.36.39 → 1.36.40

package/dist/api/frontend.d.ts

@@ -14,6 +14,18 @@ export declare const frontend: {
             deposit: ({ card_id, ...data }: API.Frontend.Issuing.Cards.Deposit.Request) => Promise<API.Frontend.Issuing.Cards.Deposit.Response>;
             withdraw: ({ card_id, ...data }: API.Frontend.Issuing.Cards.Withdraw.Request) => Promise<API.Frontend.Issuing.Cards.Withdraw.Response>;
         };
+        cardholders: {
+            list: (params?: API.Frontend.Issuing.Cardholders.List.Request) => Promise<API.Frontend.Issuing.Cardholders.List.Response>;
+            create: (data: API.Frontend.Issuing.Cardholders.Create.Request) => Promise<API.Frontend.Issuing.Cardholders.Create.Response>;
+            getById: ({ cardholder_id, ...params }: API.Frontend.Issuing.Cardholders.Get.Request) => Promise<API.Frontend.Issuing.Cardholders.Get.Response>;
+            delete: ({ cardholder_id, ...params }: API.Frontend.Issuing.Cardholders.Delete.Request) => Promise<API.Frontend.Issuing.Cardholders.Delete.Response>;
+            submit: ({ cardholder_id, ...params }: API.Frontend.Issuing.Cardholders.Submit.Request) => Promise<API.Frontend.Issuing.Cardholders.Submit.Response>;
+            documents: {
+                upload: ({ wallet_id, ...files }: API.Frontend.Issuing.Cardholders.Documents.Upload.Request) => Promise<API.Frontend.Issuing.Cardholders.Documents.Upload.Response>;
+                discard: ({ document_id, ...params }: API.Frontend.Issuing.Cardholders.Documents.Discard.Request) => Promise<void>;
+                attach: ({ cardholder_id, wallet_id, ...data }: API.Frontend.Issuing.Cardholders.Documents.Attach.Request) => Promise<API.Frontend.Issuing.Cardholders.Documents.Attach.Response>;
+            };
+        };
         subAccounts: {
             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

@@ -23,6 +23,43 @@ export const frontend = {
             deposit: ({ card_id, ...data }) => apiClientV1Frontend.postRequest(`/frontend/issuing/cards/${card_id}/deposit`, { data }),
             withdraw: ({ card_id, ...data }) => apiClientV1Frontend.postRequest(`/frontend/issuing/cards/${card_id}/withdraw`, { data }),
         },
+        // Cardholder create flow (see the OpenAPI spec for details):
+        //   1. `cardholders.create` — creates a DRAFT; no vendor is contacted. In `user_data_id` mode
+        //      the KYC documents are seeded from the verified user, so step 2 is usually unnecessary.
+        //   2. `cardholders.documents.upload` (one file per request, before or after the draft exists)
+        //      + `cardholders.documents.attach` — attach the returned upload ids to the draft.
+        //   3. `cardholders.submit` — registers at the vendor and flips the cardholder to ACTIVE.
+        // All write endpoints require the ADMIN role on the wallet; `wallet_id` travels as a query
+        // parameter for access validation.
+        cardholders: {
+            list: (params = {}) => apiClientV1Frontend.getRequest('/frontend/issuing/cardholders', { params }),
+            create: (data) => apiClientV1Frontend.postRequest('/frontend/issuing/cardholders', { data }),
+            getById: ({ cardholder_id, ...params }) => apiClientV1Frontend.getRequest(`/frontend/issuing/cardholders/${cardholder_id}`, { params }),
+            delete: ({ cardholder_id, ...params }) => apiClientV1Frontend.deleteRequest(`/frontend/issuing/cardholders/${cardholder_id}`, { params }),
+            // Retryable: a failed submit leaves the draft untouched, so it can be called again once the
+            // dossier is complete (a `400 CARDHOLDER_SUBMISSION_INCOMPLETE` lists what is missing in
+            // `error.details.missing`). While a review is running — or once the cardholder is live —
+            // another submit returns `409 CARDHOLDER_NOT_DRAFT`.
+            submit: ({ cardholder_id, ...params }) => apiClientV1Frontend.postRequest(`/frontend/issuing/cardholders/${cardholder_id}/submit`, { params }),
+            documents: {
+                // Send the file the camera produced, unchanged (no crop/resize/re-encode — the vendor's
+                // tampering check can flag a re-encoded photo as forgery), one file per request so the UI
+                // can show per-file progress and retry. Content-Type is set by the browser via FormData.
+                upload: ({ wallet_id, ...files }) => {
+                    const formData = new FormData();
+                    Object.entries(files).forEach(([type, file]) => {
+                        if (file)
+                            formData.append(type, file);
+                    });
+                    return apiClientV1Frontend.postRequest('/frontend/issuing/cardholder-documents', { data: formData, params: { wallet_id } });
+                },
+                // Only uploads not yet attached to a cardholder can be discarded (attached ones answer 409);
+                // an upload that is never attached is deleted by a cleanup sweep anyway.
+                discard: ({ document_id, ...params }) => apiClientV1Frontend.deleteRequest(`/frontend/issuing/cardholder-documents/${document_id}`, { params }),
+                // Attaching a document of a type the cardholder already has replaces the previous one.
+                attach: ({ cardholder_id, wallet_id, ...data }) => apiClientV1Frontend.postRequest(`/frontend/issuing/cardholders/${cardholder_id}/documents`, { data, params: { wallet_id } }),
+            },
+        },
         subAccounts: {
             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

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

@@ -676,6 +676,11 @@ export declare namespace API {
             type CardWithdrawRoot = pathsV1Frontend['/frontend/issuing/cards/{card_id}/withdraw'];
             type SubAccountDepositRoot = pathsV1Frontend['/frontend/issuing/sub-accounts/{sub_account_id}/deposit'];
             type SubAccountWithdrawRoot = pathsV1Frontend['/frontend/issuing/sub-accounts/{sub_account_id}/withdraw'];
+            type CardholdersRoot = pathsV1Frontend['/frontend/issuing/cardholders'];
+            type CardholderRoot = pathsV1Frontend['/frontend/issuing/cardholders/{cardholder_id}'];
+            type CardholderSubmitRoot = pathsV1Frontend['/frontend/issuing/cardholders/{cardholder_id}/submit'];
+            type CardholderDocumentsUploadRoot = pathsV1Frontend['/frontend/issuing/cardholder-documents'];
+            type CardholderAttachDocumentsRoot = pathsV1Frontend['/frontend/issuing/cardholders/{cardholder_id}/documents'];
             type WithOrderStatus<T extends {
                 data?: {
                     status?: string;
@@ -718,6 +723,64 @@ export declare namespace API {
                     type Response = SubAccounts.Withdraw.Response;
                 }
             }
+            export namespace Cardholders {
+                type Cardholder = componentsV1Frontend['schemas']['IssuingCardholder'];
+                namespace List {
+                    type Request = NonNullable<CardholdersRoot['get']['parameters']['query']>;
+                    type Response = CardholdersRoot['get']['responses']['200']['content']['application/json'];
+                }
+                namespace Create {
+                    type Request = CardholdersRoot['post']['requestBody']['content']['application/json'];
+                    type Response = CardholdersRoot['post']['responses']['201']['content']['application/json'];
+                }
+                namespace Get {
+                    type Request = {
+                        cardholder_id: string;
+                    } & NonNullable<CardholderRoot['get']['parameters']['query']>;
+                    type Response = CardholderRoot['get']['responses']['200']['content']['application/json'];
+                }
+                namespace Delete {
+                    type Request = {
+                        cardholder_id: string;
+                    } & NonNullable<CardholderRoot['delete']['parameters']['query']>;
+                    type Response = CardholderRoot['delete']['responses']['200']['content']['application/json'];
+                }
+                namespace Submit {
+                    type Request = {
+                        cardholder_id: string;
+                    } & CardholderSubmitRoot['post']['parameters']['query'];
+                    type Response = CardholderSubmitRoot['post']['responses']['200']['content']['application/json'];
+                }
+                namespace Documents {
+                    type DocumentType = keyof CardholderDocumentsUploadRoot['post']['requestBody']['content']['multipart/form-data'];
+                    namespace Upload {
+                        type Request = {
+                            wallet_id: string;
+                        } & {
+                            [K in DocumentType]?: File | Blob;
+                        };
+                        type Response = CardholderDocumentsUploadRoot['post']['responses']['201']['content']['application/json'];
+                        type Document = NonNullable<NonNullable<Response['data']>['documents']>[number];
+                    }
+                    namespace Discard {
+                        type Request = {
+                            document_id: string;
+                            wallet_id: string;
+                        };
+                    }
+                    namespace Attach {
+                        export type Request = {
+                            cardholder_id: string;
+                            wallet_id: string;
+                        } & CardholderAttachDocumentsRoot['post']['requestBody']['content']['application/json'];
+                        type RawResponse = CardholderAttachDocumentsRoot['post']['responses']['200']['content']['application/json'];
+                        export type Response = Omit<RawResponse, 'data'> & {
+                            data?: Cardholder;
+                        };
+                        export {};
+                    }
+                }
+            }
             export {};
         }
     }

package/package.json

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