release: 0.127.0

.github/workflows/release-doctor.yml

@@ -19,4 +19,3 @@ jobs:
           bash ./bin/check-release-environment
         env:
           NPM_TOKEN: ${{ secrets.LITHIC_NPM_TOKEN || secrets.NPM_TOKEN }}
-

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.126.0"
+  ".": "0.127.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 176
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-abe6a4f82f696099fa8ecb1cc44f08979e17d56578ae7ea68b0e9182e21df508.yml
-openapi_spec_hash: d2ce51592a9a234c6f34a1168a31f91f
-config_hash: 2b2786c821f62db49cc630ba45329336
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-4ecc06edca2cfad4eaf11573611e89823fda5f56370bac5cd02a498a6b277d09.yml
+openapi_spec_hash: 8f4a30bec4348cbde85b1e65bef9189a
+config_hash: 9dddee5f7af579864599849cb28a0770

CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## 0.127.0 (2026-01-08)
+
+Full Changelog: [v0.126.0...v0.127.0](https://github.com/lithic-com/lithic-node/compare/v0.126.0...v0.127.0)
+
+### Features
+
+* **api:** Add card state attribute to tokenization rules ([0a56f6a](https://github.com/lithic-com/lithic-node/commit/0a56f6a01d6965c24dde06bdc1e56f252235a575))
+* **api:** Add event_type to ASA request and 3DS decisioning request ([0a56f6a](https://github.com/lithic-com/lithic-node/commit/0a56f6a01d6965c24dde06bdc1e56f252235a575))
+* **api:** add external_id to payment_event ([538d96e](https://github.com/lithic-com/lithic-node/commit/538d96e5eba1b99e56839f5b0aac87496b681279))
+* **api:** add get /v1/transfer_limits endpoint ([538d96e](https://github.com/lithic-com/lithic-node/commit/538d96e5eba1b99e56839f5b0aac87496b681279))
+* **api:** add post /v1/book_transfers/{book_transfer_token}/retry endpoint ([538d96e](https://github.com/lithic-com/lithic-node/commit/538d96e5eba1b99e56839f5b0aac87496b681279))
+* **api:** Add user defined status to ledger accounts ([0a56f6a](https://github.com/lithic-com/lithic-node/commit/0a56f6a01d6965c24dde06bdc1e56f252235a575))
+* **api:** add WIRE_DRAWDOWN_REQUEST transfer type ([e7c375b](https://github.com/lithic-com/lithic-node/commit/e7c375bf328756a708d54e8a33e2ed154ebfeb93))
+* **api:** Expose Payment Allocation Details ([0a56f6a](https://github.com/lithic-com/lithic-node/commit/0a56f6a01d6965c24dde06bdc1e56f252235a575))
+* **api:** remove unnecessary X-Lithic-Pagination header ([e7c375b](https://github.com/lithic-com/lithic-node/commit/e7c375bf328756a708d54e8a33e2ed154ebfeb93))
+* **api:** remove v1/aggregate_balances and related models ([0078e74](https://github.com/lithic-com/lithic-node/commit/0078e74adc26ff15a7340684c1b07b662e500e01))
+
+
+### Bug Fixes
+
+* **docs:** remove extraneous example object fields ([3ba95e6](https://github.com/lithic-com/lithic-node/commit/3ba95e64b6eea6893359d17a21d66eab3a93219b))
+
+
+### Chores
+
+* break long lines in snippets into multiline ([5e9608e](https://github.com/lithic-com/lithic-node/commit/5e9608eda7596bc4d7d621013feb6900f4caae98))
+* formatting ([0b4c11e](https://github.com/lithic-com/lithic-node/commit/0b4c11edeffb476c403be5b84c1e310fd5dfc063))
+* **internal:** codegen related update ([a06ac86](https://github.com/lithic-com/lithic-node/commit/a06ac867f0c60f77fd92dfe6a7eac8e9c4967cd5))
+* update code formatting ([0a56f6a](https://github.com/lithic-com/lithic-node/commit/0a56f6a01d6965c24dde06bdc1e56f252235a575))
+
+
+### Documentation
+
+* **api:** clarify description of token /  retry_token when it serves as idempotency key ([e7c375b](https://github.com/lithic-com/lithic-node/commit/e7c375bf328756a708d54e8a33e2ed154ebfeb93))
+* Update language for Google Web Push Provisioning docs ([0a56f6a](https://github.com/lithic-com/lithic-node/commit/0a56f6a01d6965c24dde06bdc1e56f252235a575))
+
 ## 0.126.0 (2025-12-11)
 
 Full Changelog: [v0.125.0...v0.126.0](https://github.com/lithic-com/lithic-node/compare/v0.125.0...v0.126.0)

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025 Lithic
+   Copyright 2026 Lithic
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

MIGRATION.md

@@ -104,12 +104,10 @@ client.example.list(undefined, { headers: { ... } });
 - `client.tokenizations.resendActivationCode()`
 - `client.tokenizations.updateDigitalCardArt()`
 - `client.cards.list()`
-- `client.cards.aggregateBalances.list()`
 - `client.cards.balances.list()`
 - `client.cards.financialTransactions.list()`
 - `client.cardBulkOrders.list()`
 - `client.balances.list()`
-- `client.aggregateBalances.list()`
 - `client.disputes.list()`
 - `client.disputes.initiateEvidenceUpload()`
 - `client.disputes.listEvidences()`
@@ -144,27 +142,10 @@ client.example.list(undefined, { headers: { ... } });
 - `client.fundingEvents.list()`
 - `client.networkPrograms.list()`
 - `client.accountActivity.list()`
+- `client.transferLimits.list()`
 
 </details>
 
-### HTTP method naming
-
-Previously some methods could not be named intuitively due to an internal naming conflict. This has been fixed and the affected methods are now correctly named.
-
-```ts
-// Before
-client.authRules.v2.del();
-client.disputes.del();
-client.events.subscriptions.del();
-client.responderEndpoints.del();
-
-// After
-client.authRules.v2.delete();
-client.disputes.delete();
-client.events.subscriptions.delete();
-client.responderEndpoints.delete();
-```
-
 ### Removed `httpAgent` in favor of `fetchOptions`
 
 The `httpAgent` client option has been removed in favor of a [platform-specific `fetchOptions` property](https://github.com/lithic-com/lithic-node#fetch-options).

README.md

@@ -156,23 +156,6 @@ while (page.hasNextPage()) {
 }
 ```
 
-## Default Headers
-
-We automatically send the `X-Lithic-Pagination` header set to `cursor`.
-
-If you need to, you can override it by setting default headers on a per-request basis.
-
-```ts
-import Lithic from 'lithic';
-
-const client = new Lithic();
-
-const card = await client.cards.create(
-  { type: 'SINGLE_USE' },
-  { headers: { 'X-Lithic-Pagination': 'My-Custom-Value' } },
-);
-```
-
 ## Webhooks
 
 Lithic uses webhooks to notify your application when events happen. The library provides signature verification via the `standardwebhooks` package.
@@ -201,7 +184,7 @@ switch (event.event_type) {
 
 ```ts
 // Verify signature without parsing the event
-lithic.webhooks.verifySignature(body, headers)
+lithic.webhooks.verifySignature(body, headers);
 
 // Parse only - skips signature verification
 const event = lithic.webhooks.parseUnsafe(body);
@@ -231,7 +214,6 @@ export default async function POST(req: Request) {
 > [!NOTE]
 > If you're using the pages router, you will need [this trick](https://vancelucas.com/blog/how-to-access-raw-body-data-with-next-js/) to get the raw body.
 
-
 ## Advanced Usage
 
 ### Accessing raw Response data (e.g., headers)
@@ -250,7 +232,9 @@ const response = await client.cards.create({ type: 'SINGLE_USE' }).asResponse();
 console.log(response.headers.get('X-My-Header'));
 console.log(response.statusText); // access the underlying Response object
 
-const { data: card, response: raw } = await client.cards.create({ type: 'SINGLE_USE' }).withResponse();
+const { data: card, response: raw } = await client.cards
+  .create({ type: 'SINGLE_USE' })
+  .withResponse();
 console.log(raw.headers.get('X-My-Header'));
 console.log(card.token);
 ```

api.md

@@ -189,16 +189,6 @@ Methods:
 - <code>client.cards.<a href="./src/resources/cards/cards.ts">getEmbedHTML</a>(...args) -> Promise&lt;string&gt;</code>
 - <code>client.cards.<a href="./src/resources/cards/cards.ts">getEmbedURL</a>(...args) -> string</code>
 
-## AggregateBalances
-
-Types:
-
-- <code><a href="./src/resources/cards/aggregate-balances.ts">AggregateBalanceListResponse</a></code>
-
-Methods:
-
-- <code title="get /v1/cards/aggregate_balances">client.cards.aggregateBalances.<a href="./src/resources/cards/aggregate-balances.ts">list</a>({ ...params }) -> AggregateBalanceListResponsesSinglePage</code>
-
 ## Balances
 
 Methods:
@@ -235,16 +225,6 @@ Methods:
 
 - <code title="get /v1/balances">client.balances.<a href="./src/resources/balances.ts">list</a>({ ...params }) -> BalancesSinglePage</code>
 
-# AggregateBalances
-
-Types:
-
-- <code><a href="./src/resources/aggregate-balances.ts">AggregateBalance</a></code>
-
-Methods:
-
-- <code title="get /v1/aggregate_balances">client.aggregateBalances.<a href="./src/resources/aggregate-balances.ts">list</a>({ ...params }) -> AggregateBalancesSinglePage</code>
-
 # Disputes
 
 Types:
@@ -624,6 +604,7 @@ Methods:
 - <code title="post /v1/book_transfers">client.bookTransfers.<a href="./src/resources/book-transfers.ts">create</a>({ ...params }) -> BookTransferResponse</code>
 - <code title="get /v1/book_transfers/{book_transfer_token}">client.bookTransfers.<a href="./src/resources/book-transfers.ts">retrieve</a>(bookTransferToken) -> BookTransferResponse</code>
 - <code title="get /v1/book_transfers">client.bookTransfers.<a href="./src/resources/book-transfers.ts">list</a>({ ...params }) -> BookTransferResponsesCursorPage</code>
+- <code title="post /v1/book_transfers/{book_transfer_token}/retry">client.bookTransfers.<a href="./src/resources/book-transfers.ts">retry</a>(bookTransferToken, { ...params }) -> BookTransferResponse</code>
 - <code title="post /v1/book_transfers/{book_transfer_token}/reverse">client.bookTransfers.<a href="./src/resources/book-transfers.ts">reverse</a>(bookTransferToken, { ...params }) -> BookTransferResponse</code>
 
 # CreditProducts
@@ -737,6 +718,16 @@ Methods:
 - <code title="get /v1/account_activity">client.accountActivity.<a href="./src/resources/account-activity.ts">list</a>({ ...params }) -> AccountActivityListResponsesCursorPage</code>
 - <code title="get /v1/account_activity/{transaction_token}">client.accountActivity.<a href="./src/resources/account-activity.ts">retrieveTransaction</a>(transactionToken) -> AccountActivityRetrieveTransactionResponse</code>
 
+# TransferLimits
+
+Types:
+
+- <code><a href="./src/resources/transfer-limits.ts">TransferLimitsResponse</a></code>
+
+Methods:
+
+- <code title="get /v1/transfer_limits">client.transferLimits.<a href="./src/resources/transfer-limits.ts">list</a>({ ...params }) -> TransferLimitsResponseDataSinglePage</code>
+
 # Webhooks
 
 Types:
@@ -745,7 +736,7 @@ Types:
 - <code><a href="./src/resources/webhooks.ts">AccountHolderUpdatedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">AccountHolderVerificationWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">AccountHolderDocumentUpdatedWebhookEvent</a></code>
-- <code><a href="./src/resources/webhooks.ts">AsaRequestWebhookEvent</a></code>
+- <code><a href="./src/resources/webhooks.ts">CardAuthorizationApprovalRequestWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">TokenizationDecisioningRequestWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">AuthRulesBacktestReportCreatedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">BalanceUpdatedWebhookEvent</a></code>
@@ -793,6 +784,7 @@ Types:
 - <code><a href="./src/resources/webhooks.ts">TokenizationTwoFactorAuthenticationCodeWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">TokenizationTwoFactorAuthenticationCodeSentWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">TokenizationUpdatedWebhookEvent</a></code>
+- <code><a href="./src/resources/webhooks.ts">ThreeDSAuthenticationApprovalRequestWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">DisputeTransactionCreatedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">DisputeTransactionUpdatedWebhookEvent</a></code>
 - <code><a href="./src/resources/webhooks.ts">ParsedWebhookEvent</a></code>

bin/cli

@@ -8,15 +8,21 @@ const commands = {
     fn: () => {
       const result = spawnSync(
         'npx',
-        ['-y', 'https://github.com/stainless-api/migrate-ts/releases/download/0.0.2/stainless-api-migrate-0.0.2-6.tgz', '--migrationConfig', require.resolve('./migration-config.json'), ...process.argv.slice(3)],
+        [
+          '-y',
+          'https://github.com/stainless-api/migrate-ts/releases/download/0.0.2/stainless-api-migrate-0.0.2-6.tgz',
+          '--migrationConfig',
+          require.resolve('./migration-config.json'),
+          ...process.argv.slice(3),
+        ],
         { stdio: 'inherit' },
       );
       if (result.status !== 0) {
         process.exit(result.status);
       }
-    }
-  }
-}
+    },
+  },
+};
 
 function exitWithHelp() {
   console.log(`Usage: lithic <subcommand>`);

bin/migration-config.json

@@ -36,11 +36,6 @@
         }
       ]
     },
-    {
-      "base": "authRules.v2",
-      "name": "delete",
-      "oldName": "del"
-    },
     {
       "base": "authRules.v2.backtests",
       "name": "retrieve",
@@ -107,11 +102,6 @@
         }
       ]
     },
-    {
-      "base": "disputes",
-      "name": "delete",
-      "oldName": "del"
-    },
     {
       "base": "disputes",
       "name": "deleteEvidence",
@@ -178,11 +168,6 @@
         }
       ]
     },
-    {
-      "base": "events.subscriptions",
-      "name": "delete",
-      "oldName": "del"
-    },
     {
       "base": "events.eventSubscriptions",
       "name": "resend",
@@ -351,11 +336,6 @@
           "type": "options"
         }
       ]
-    },
-    {
-      "base": "responderEndpoints",
-      "name": "delete",
-      "oldName": "del"
     }
   ]
 }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "lithic",
-  "version": "0.126.0",
+  "version": "0.127.0",
   "description": "The official TypeScript library for the Lithic API",
   "author": "Lithic <sdk-feedback@lithic.com>",
   "types": "dist/index.d.ts",