@stable_sea/sdk 0.1.6 → 0.2.1

package/README.md

@@ -21,7 +21,7 @@ import { createStableSeaClient } from "@stable_sea/sdk";
 const client = createStableSeaClient({
   apiKey: process.env.STABLE_SEA_API_KEY!,
   baseUrl: process.env.STABLE_SEA_BASE_URL!,
-  version: "2026-07-23",
+  version: "2026-10-11",
 });
 ```
 
@@ -113,7 +113,9 @@ in Terminal. Submit registration with `POST /v1/bank_accounts`, poll the returne
 `baop_` ID at `GET /v1/bank_account_operations/{id}`, then read the resulting
 `bacc_` account. Registration preserves Terminal's screening rules and does not
 enable funding or payouts. Remove an account with
-`POST /v1/bank_accounts/{id}/remove`; pending transactions prevent removal.
+`DELETE /v1/bank_accounts/{id}` without a body or idempotency key. HTTP 202
+returns an operation to poll; repeat DELETE after success for a 200 deletion
+receipt. Pending transactions prevent removal.
 
 See [the bank account guide](../../docs/api/bank-accounts.md) for examples and retry behavior.
 
@@ -165,3 +167,14 @@ permissions and retry behavior.
   before this it reported `chain: "unknown"`. Code that switches on `chain`
   should accept the new value, and code that keyed a Solana balance by its
   `unknown` row should expect the `solana` row instead.
+
+## October 11 API contract
+
+Update to the latest SDK before using the revised contract. Send bank removal
+with `client.DELETE("/v1/bank_accounts/{id}")`, without a body or idempotency key.
+Read bank and wallet operation `status` instead of `state`. Retrieve issued
+statement content with `GET /v1/statements/{id}`; the `/content` route is retired.
+
+The HTTP request pin is `2026-10-11`. The retired pin returns
+`400 unsupported_api_version`. Existing API keys remain valid; stored key and
+thin-event/webhook versions are preserved.

package/dist/client.d.ts

@@ -1,10 +1,10 @@
 import createClient from "openapi-fetch";
 import type { FetchResponse } from "openapi-fetch";
-import type { paths } from "./gen/schema.js";
+import type { components, paths } from "./gen/schema.js";
 export interface StableSeaClientOptions {
     apiKey: string;
     baseUrl: string;
-    version?: "2026-07-23";
+    version?: components["schemas"]["HTTPAPIVersion"];
 }
 type GeneratedClient = ReturnType<typeof createClient<paths>>;
 type MutationPath = {

package/dist/gen/schema.d.ts

@@ -182,27 +182,13 @@ export interface paths {
         get: operations["bank_accounts.get"];
         put?: never;
         post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/bank_accounts/{id}/remove": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
         /**
          * Remove a bank account
-         * @description Archives a saved bank account using Terminal's removal restrictions. Pending transactions prevent removal. Poll the returned operation for the outcome. Removal preserves transaction history and does not cancel or reverse a deposit. Requires money:bank_accounts_write and an Idempotency-Key.
+         * @description Archives a saved bank account and preserves its transaction history. Pending transactions prevent removal. Requires `money:bank_accounts_write`; send no body or idempotency key.
+         *
+         *     HTTP 202 returns a processing operation: poll it until `status` is `succeeded` or `failed`. Repeat DELETE while pending to retrieve the same operation. After success, repeat DELETE to receive HTTP 200 with `id` and `deleted: true`. After a failed operation, resolve its cause and repeat DELETE to submit a new attempt. Removal does not cancel or reverse a deposit.
          */
-        post: operations["bank_accounts.remove"];
-        delete?: never;
+        delete: operations["bank_accounts.delete"];
         options?: never;
         head?: never;
         patch?: never;
@@ -434,10 +420,10 @@ export interface paths {
         get: operations["external_wallets.get"];
         put?: never;
         /**
-         * Rename an external wallet
-         * @description Submits a rename for a wallet your business connected. The new name is screened using Terminal's existing rules. Poll the returned operation for the outcome. The address, network and other wallet properties remain unchanged.
+         * Update an external wallet
+         * @description Updates supported fields on a connected wallet. Currently only `name` is mutable; omitted or null fields remain unchanged. A new name is screened using the existing rules. Poll the returned operation until `status` is `succeeded` or `failed`. Address, network and screening status are server-controlled.
          */
-        post: operations["external_wallets.rename"];
+        post: operations["external_wallets.update"];
         delete?: never;
         options?: never;
         head?: never;
@@ -695,29 +681,9 @@ export interface paths {
         };
         /**
          * Retrieve a statement
-         * @description Returns one statement by id. A statement that has been corrected still resolves, and carries superseded_by naming the document that replaced it.
-         */
-        get: operations["statements.retrieve"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/statements/{id}/content": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Retrieve statement content
          * @description Returns the immutable issued statement values as display-ready JSON. Corrected statements remain retrievable and name their replacement. Pay-ins and payouts are not served on this API, so they are not listed in transactions; the balances and totals are the printed ones and still include their effect, which means a statement for a period in which the business made a payment does not reconcile from its transactions alone.
          */
-        get: operations["statements.content.retrieve"];
+        get: operations["statements.retrieve"];
         put?: never;
         post?: never;
         delete?: never;
@@ -1009,7 +975,7 @@ export interface components {
             pending_incoming_native: string;
             /** @description pending_incoming_native valued in USD. Omitted when no rate is available at created_ts. */
             pending_incoming_usd?: string;
-            /** @description Value outgoing from this balance and not yet settled, in the asset's own units. Never netted against pending_incoming_native. A single movement's pass-through legs are netted inside this figure: an account credited and debited within one movement counts once, not twice in both directions. */
+            /** @description Value reserved for outgoing movements or confirmed bank-return recovery, in the asset's own units. Never netted against pending_incoming_native. A single movement's pass-through legs are netted inside this figure: an account credited and debited within one movement counts once, not twice in both directions. */
             pending_outgoing_native: string;
             /** @description pending_outgoing_native valued in USD. Omitted when no rate is available at created_ts. */
             pending_outgoing_usd?: string;
@@ -1076,6 +1042,11 @@ export interface components {
             mx_bank_account?: components["schemas"]["MXBankAccountCreateDetails"];
             us_bank_account?: components["schemas"]["USBankAccountCreateDetails"];
         };
+        BankAccountDeleted: {
+            /** @enum {boolean} */
+            deleted: true;
+            id: string;
+        };
         BankAccountList: {
             data: components["schemas"]["BankAccount"][];
             has_more: boolean;
@@ -1095,7 +1066,7 @@ export interface components {
             /** @enum {string} */
             operation: "create" | "remove";
             /** @enum {string} */
-            state: "pending" | "succeeded" | "failed";
+            status: "pending" | "succeeded" | "failed";
         };
         Decimal: string;
         Deposit: {
@@ -1337,12 +1308,12 @@ export interface components {
             /** @enum {string} */
             object: "external_wallet_operation";
             /** @enum {string} */
-            operation: "create" | "rename";
+            operation: "create" | "update";
             /** @enum {string} */
-            state: "pending" | "succeeded" | "failed";
+            status: "pending" | "succeeded" | "failed";
         };
-        ExternalWalletRenameInput: {
-            name: string;
+        ExternalWalletUpdateInput: {
+            name?: string | null;
         };
         FundingMethod: {
             ach?: {
@@ -1419,6 +1390,8 @@ export interface components {
             /** Format: date-time */
             observed_ts: string;
         };
+        /** @enum {string} */
+        HTTPAPIVersion: "2026-10-11";
         List: {
             data: components["schemas"]["Resource"][];
             has_more: boolean;
@@ -1718,15 +1691,21 @@ export interface components {
             label: string;
             symbol: string;
         };
-        StatementContent: {
+        StatementDetail: {
             balances: components["schemas"]["StatementLine"][];
             /** Format: date-time */
             created_ts: string;
             id: string;
             livemode: boolean;
+            /** Format: int32 */
+            number: number;
             /** @enum {string} */
-            object: "statement_content";
+            object: "statement";
             period: components["schemas"]["StatementPeriod"];
+            /** Format: date-time */
+            period_end_ts: string;
+            /** Format: date-time */
+            period_start_ts: string;
             ramp_fees?: components["schemas"]["StatementRampFee"][];
             superseded_by?: string;
             totals: components["schemas"]["StatementTotals"];
@@ -2035,7 +2014,7 @@ export interface components {
     };
     parameters: {
         "Idempotency-Key": string;
-        "Stable-Sea-Version": components["schemas"]["APIVersion"];
+        "Stable-Sea-Version": components["schemas"]["HTTPAPIVersion"];
     };
     requestBodies: never;
     headers: {
@@ -2411,12 +2390,10 @@ export interface operations {
             };
         };
     };
-    "bank_accounts.remove": {
+    "bank_accounts.delete": {
         parameters: {
             query?: never;
-            header: {
-                "Idempotency-Key": components["parameters"]["Idempotency-Key"];
-            };
+            header?: never;
             path: {
                 id: string;
             };
@@ -2432,6 +2409,15 @@ export interface operations {
                     "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
                     [name: string]: unknown;
                 };
+                content: {
+                    "application/json": components["schemas"]["BankAccountDeleted"];
+                };
+            };
+            /** @description Accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
                 content: {
                     "application/json": components["schemas"]["BankAccountOperation"];
                 };
@@ -2439,7 +2425,6 @@ export interface operations {
             400: components["responses"]["Error400"];
             401: components["responses"]["Error401"];
             403: components["responses"]["Error403"];
-            409: components["responses"]["Error409"];
             429: components["responses"]["Error429"];
             /** @description Error response. */
             default: {
@@ -2895,7 +2880,7 @@ export interface operations {
             };
         };
     };
-    "external_wallets.rename": {
+    "external_wallets.update": {
         parameters: {
             query?: never;
             header: {
@@ -2908,7 +2893,7 @@ export interface operations {
         };
         requestBody?: {
             content: {
-                "application/json": components["schemas"]["ExternalWalletRenameInput"];
+                "application/json": components["schemas"]["ExternalWalletUpdateInput"];
             };
         };
         responses: {
@@ -3443,46 +3428,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["Statement"];
-                };
-            };
-            400: components["responses"]["Error400"];
-            401: components["responses"]["Error401"];
-            403: components["responses"]["Error403"];
-            429: components["responses"]["Error429"];
-            /** @description Error response. */
-            default: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["Error"];
-                };
-            };
-        };
-    };
-    "statements.content.retrieve": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                /** @description The statement id. */
-                id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    "X-RateLimit-Limit": components["headers"]["X-RateLimit-Limit"];
-                    "X-RateLimit-Remaining": components["headers"]["X-RateLimit-Remaining"];
-                    "X-RateLimit-Reset": components["headers"]["X-RateLimit-Reset"];
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["StatementContent"];
+                    "application/json": components["schemas"]["StatementDetail"];
                 };
             };
             400: components["responses"]["Error400"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stable_sea/sdk",
-  "version": "0.1.6",
+  "version": "0.2.1",
   "type": "module",
   "sideEffects": false,
   "files": [