squarefi-bff-api-module 1.35.3 → 1.36.0

package/dist/api/issuing.d.ts

@@ -9,9 +9,9 @@ export declare const issuing: {
             subAccountCard: (data: API.Cards.Create.SubAccountRequest) => Promise<API.Cards.Create.ExtendedSubAccountResponse>;
         };
         byWalletUuid: {
-            getAll: (params: API.Cards.CardsList.Request.ByWalletUuid) => Promise<API.Cards.CardsList.Response>;
-            getBySubaccountType: (params: API.Cards.CardsList.Request.BySubaccountAndWalletUuid) => Promise<API.Cards.CardsList.Response>;
-            getBySubAccount: (params: API.Cards.CardsList.Request.BySubAccountAndWalletId) => Promise<API.Cards.CardsList.Response>;
+            getAll: ({ limit, offset, ...rest }: API.Cards.CardsList.Request.ByWalletUuid) => Promise<API.Cards.CardsList.Response>;
+            getBySubaccountType: ({ limit, offset, ...rest }: API.Cards.CardsList.Request.BySubaccountAndWalletUuid) => Promise<API.Cards.CardsList.Response>;
+            getBySubAccount: ({ limit, offset, ...rest }: API.Cards.CardsList.Request.BySubAccountAndWalletId) => Promise<API.Cards.CardsList.Response>;
         };
         getById: (card_id: string) => Promise<API.Cards.IssuingCardDetailItem>;
         sensitiveData: {
@@ -33,8 +33,8 @@ export declare const issuing: {
         rename: (card_id: string, nick_name: string) => Promise<API.Cards.IssuingCardDetailItem>;
     };
     transactions: {
-        getByCardId: (card_id: string, limit?: number, offset?: number) => Promise<API.Cards.TransactionsList>;
-        getBySubAccountId: (fiat_account_id: string, limit?: number, offset?: number) => Promise<API.Cards.TransactionsList>;
+        getByCardId: ({ card_id, limit, offset, transaction_type, status, from, to, }: API.Cards.Transactions.List.ByCardIdRequest) => Promise<API.Cards.TransactionsList>;
+        getBySubAccountId: ({ fiat_account_id, limit, offset, transaction_type, status, from, to, }: API.Cards.Transactions.List.BySubAccountIdRequest) => Promise<API.Cards.TransactionsList>;
         csv: {
             getByCardId: (card_id: string) => Promise<string>;
             getBySubAccountId: (sub_account_id: string) => Promise<string>;

package/dist/api/issuing.js

@@ -31,14 +31,14 @@ export const issuing = {
             },
         },
         byWalletUuid: {
-            getAll: (params) => apiClientV1.getRequest('/issuing/cards', {
-                params,
+            getAll: ({ limit = defaultPaginationParams.limit, offset = defaultPaginationParams.offset, ...rest }) => apiClientV1.getRequest('/issuing/cards', {
+                params: { ...rest, limit, offset },
             }),
-            getBySubaccountType: (params) => apiClientV1.getRequest('/issuing/cards', {
-                params,
+            getBySubaccountType: ({ limit = defaultPaginationParams.limit, offset = defaultPaginationParams.offset, ...rest }) => apiClientV1.getRequest('/issuing/cards', {
+                params: { ...rest, limit, offset },
             }),
-            getBySubAccount: (params) => apiClientV1.getRequest('/issuing/cards', {
-                params,
+            getBySubAccount: ({ limit = defaultPaginationParams.limit, offset = defaultPaginationParams.offset, ...rest }) => apiClientV1.getRequest('/issuing/cards', {
+                params: { ...rest, limit, offset },
             }),
         },
         // getById: (card_id: string) => apiClientV1.getRequest<API.Cards.IssuingCardDetailItem>(`/issuing/cards/${card_id}`),
@@ -86,11 +86,11 @@ export const issuing = {
         }),
     },
     transactions: {
-        getByCardId: (card_id, limit = defaultPaginationParams.limit, offset = defaultPaginationParams.offset) => apiClientV1.getRequest(`/issuing/transactions/`, {
-            params: { limit, offset, card_id, new_scheme: true },
+        getByCardId: ({ card_id, limit = defaultPaginationParams.limit, offset = defaultPaginationParams.offset, transaction_type, status, from, to, }) => apiClientV1.getRequest(`/issuing/transactions/`, {
+            params: { limit, offset, card_id, new_scheme: true, transaction_type, status, from, to },
         }),
-        getBySubAccountId: (fiat_account_id, limit = defaultPaginationParams.limit, offset = defaultPaginationParams.offset) => apiClientV1.getRequest(`/issuing/transactions/`, {
-            params: { limit, offset, fiat_account_id, new_scheme: true },
+        getBySubAccountId: ({ fiat_account_id, limit = defaultPaginationParams.limit, offset = defaultPaginationParams.offset, transaction_type, status, from, to, }) => apiClientV1.getRequest(`/issuing/transactions/`, {
+            params: { limit, offset, fiat_account_id, new_scheme: true, transaction_type, status, from, to },
         }),
         csv: {
             getByCardId: (card_id) => apiClientV1.getRequest(`/issuing/transactions/csv`, {

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

@@ -2011,6 +2011,8 @@ export interface paths {
                     sub_account_type?: "prepaid" | "balance";
                     /** @description Filter cards by status */
                     status?: "ACTIVE" | "INACTIVE" | "SUSPENDED" | "CANCELED";
+                    /** @description Filter cards by exact last 4 digits of the card number */
+                    last4?: string;
                     /** @description Number of items to skip */
                     offset?: number;
                     /** @description Number of items to return */
@@ -3229,7 +3231,81 @@ export interface paths {
         delete?: never;
         options?: never;
         head?: never;
-        patch?: never;
+        /**
+         * Update sub-account
+         * @description Updates editable fields of a sub-account. Currently only the `nick_name` can be changed.
+         *
+         *     **Authentication**: x-api-key header required
+         *
+         *     **Access Control**: User must have access to the sub-account
+         *
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description The ID of the sub-account to update */
+                    sub_account_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /**
+                         * @description New nickname for the sub-account
+                         * @example Travel budget
+                         */
+                        nick_name: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Sub-account updated successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: components["schemas"]["IssuingSubAccount"];
+                            /** @example Sub-account updated successfully */
+                            message?: string;
+                        };
+                    };
+                };
+                /** @description Bad Request - nick_name is required */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorResponse"];
+                    };
+                };
+                /** @description Access denied to this sub-account */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorResponse"];
+                    };
+                };
+                /** @description Sub-account not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiErrorResponse"];
+                    };
+                };
+            };
+        };
         trace?: never;
     };
     "/api/issuing/sub-accounts/{sub_account_id}/transactions": {

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

@@ -1736,6 +1736,8 @@ export interface paths {
                     sub_account_type?: "prepaid" | "balance";
                     /** @description Filter cards by status */
                     status?: "ACTIVE" | "INACTIVE" | "SUSPENDED" | "CANCELED";
+                    /** @description Filter cards by exact last 4 digits of the card number */
+                    last4?: string;
                     /** @description Number of items to skip */
                     offset?: number;
                     /** @description Number of items to return */
@@ -3008,7 +3010,76 @@ export interface paths {
         delete?: never;
         options?: never;
         head?: never;
-        patch?: never;
+        /**
+         * Update sub-account
+         * @description Updates editable fields of a sub-account. Currently only the `nick_name` can be changed.
+         *
+         *     **Authentication**: Bearer token with x-tenant-id header required
+         *
+         *     **Access Control**: User must have ADMIN role on the sub-account's wallet
+         *
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description The ID of the sub-account to update */
+                    sub_account_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /**
+                         * @description New nickname for the sub-account
+                         * @example Travel budget
+                         */
+                        nick_name: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Sub-account updated successfully */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            /** @description Updated sub-account details */
+                            data?: Record<string, never>;
+                            /** @example Sub-account updated successfully */
+                            message?: string;
+                        };
+                    };
+                };
+                /** @description Bad Request - nick_name is required */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Access denied to this sub-account */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Sub-account not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
         trace?: never;
     };
     "/frontend/issuing/sub-accounts/{sub_account_id}/transactions": {

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

@@ -1260,13 +1260,18 @@ export interface paths {
                     sort_by?: "card_id" | "nick_name" | "name_on_card" | "last4" | "card_status" | "created_at";
                     /** @description Sort direction */
                     sort_order?: "ASC" | "DESC";
+                    /**
+                     * @description Filter cards by exact last 4 digits of the card number (equality match against `issuing_cards.last4`).
+                     * @example 1234
+                     */
+                    "filter[last4]"?: string;
                     /** @description Filter by specific card properties. Can be provided in three ways:
                      *     1. As JSON object: `filter={"last4":"1234"}`
                      *     2. As query params: `filter[last4]=1234`
                      *     3. For nested filtering: `filter[fiat_account][type]=prepaid`
                      *
                      *     Common filter fields:
-                     *     - `last4`: Filter by last 4 digits of card
+                     *     - `last4`: Filter by last 4 digits of card (exact match)
                      *     - `card_status`: Filter by status (ACTIVE, INACTIVE, CANCELED)
                      *     - `fiat_account.type`: Filter by account type (prepaid, balance)
                      *     - `from_created_at`: Filter cards created on or after this date (ISO 8601 format)
@@ -2284,10 +2289,12 @@ export interface paths {
                     new_scheme?: boolean;
                     /** @description Filter by transaction type */
                     transaction_type?: string;
-                    /** @description Filter by start date */
+                    /** @description Filter by start date (ISO 8601). Sent to external provider as `from_timestamp` and post-filtered against `cleared_at`/`created_at`. */
                     from?: string;
-                    /** @description Filter by end date */
+                    /** @description Filter by end date (ISO 8601). Sent to external provider as `to_timestamp` and post-filtered against `cleared_at`/`created_at`. */
                     to?: string;
+                    /** @description Filter by transaction status. Forwarded to external provider and applied as a post-filter on the combined result. */
+                    status?: "PENDING" | "APPROVED" | "DECLINED" | "CANCELED";
                 };
                 header?: never;
                 path?: never;

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

@@ -6490,7 +6490,60 @@ export interface paths {
         delete?: never;
         options?: never;
         head?: never;
-        patch?: never;
+        /**
+         * Update sub-account
+         * @description Updates editable fields of a sub-account. Currently only the `nick_name` can be changed.
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    sub_account_id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        nick_name: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Sub-account updated */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example true */
+                            success?: boolean;
+                            data?: components["schemas"]["IssuingSubAccount"];
+                        };
+                    };
+                };
+                /** @description Bad Request — nick_name is required */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Sub-account not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
         trace?: never;
     };
     "/admin/issuing/sub-accounts/{sub_account_id}/transactions": {

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

@@ -1,6 +1,7 @@
 import { APIKeyRole, CardFormFactor, CardTransactionType, CardType, CurrencyType, IssuingProgramStatus, OrderType, SortingDirection, SubAccountType } from '../../constants';
 import { components, operations, paths } from './autogen/apiV2.types';
 import { components as componentsV1Frontend, paths as pathsV1Frontend } from './autogen/apiV1Frontend.types';
+import { paths as pathsV1Legacy } from './autogen/apiV1Legacy.types';
 export declare namespace API {
     namespace Auth {
         namespace RefreshToken {
@@ -221,16 +222,11 @@ export declare namespace API {
         }
         namespace CardsList {
             namespace Request {
-                type CardsListSortingFields = Partial<Pick<IssuingCardListItem, 'created_at' | 'card_status' | 'last4' | 'nick_name' | 'name_on_card' | 'card_id'>>;
-                type CardsListFilteringFields = Partial<IssuingCardListItem>;
-                type CardsListRequestCommonParams = API.Common.Pagination.Request & API.Common.Sorting.Request<CardsListSortingFields> & API.Common.Filtering.Request<CardsListFilteringFields>;
-                interface ByWalletUuid extends CardsListRequestCommonParams {
-                    wallet_uuid: string;
-                }
-                interface BySubaccountAndWalletUuid extends ByWalletUuid {
+                type ByWalletUuid = NonNullable<pathsV1Legacy['/issuing/cards']['get']['parameters']['query']>;
+                type BySubaccountAndWalletUuid = ByWalletUuid & {
                     filter?: Record<'fiat_account', Record<'type', SubAccountType>>;
-                }
-                type BySubAccountAndWalletId = ByWalletUuid & {
+                };
+                type BySubAccountAndWalletId = Omit<ByWalletUuid, 'fiat_account_id'> & {
                     fiat_account_id: string;
                 };
             }
@@ -271,6 +267,19 @@ export declare namespace API {
             has_more: boolean;
             count: number;
         }
+        namespace Transactions {
+            namespace List {
+                type Query = NonNullable<pathsV1Legacy['/issuing/transactions']['get']['parameters']['query']>;
+                export type StatusFilter = NonNullable<Query['status']>;
+                export type ByCardIdRequest = Omit<Query, 'card_id'> & {
+                    card_id: string;
+                };
+                export type BySubAccountIdRequest = Omit<Query, 'fiat_account_id'> & {
+                    fiat_account_id: string;
+                };
+                export {};
+            }
+        }
         interface SensitiveData {
             card_number: string;
             cvv: string;

package/package.json

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