@naturalpay/sdk 0.11.0 → 0.13.0

package/src/resources/transactions.ts

@@ -13,12 +13,21 @@ export class Transactions extends APIResource {
   /**
    * List transactions visible to your party.
    */
-  list(params: TransactionListParams, options?: RequestOptions): APIPromise<TransactionListResponse> {
-    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params;
+  list(
+    params: TransactionListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TransactionListResponse> {
+    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
     return this._client.get('/transactions', {
       query,
       ...options,
-      headers: buildHeaders([{ 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID }, options?.headers]),
+      headers: buildHeaders([
+        {
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
     });
   }
 
@@ -27,14 +36,20 @@ export class Transactions extends APIResource {
    */
   get(
     transactionID: string,
-    params: TransactionGetParams,
+    params: TransactionGetParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<TransactionGetResponse> {
-    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params;
+    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
     return this._client.get(path`/transactions/${transactionID}`, {
       query,
       ...options,
-      headers: buildHeaders([{ 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID }, options?.headers]),
+      headers: buildHeaders([
+        {
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
     });
   }
 }
@@ -464,16 +479,6 @@ export namespace TransactionGetResponse {
 }
 
 export interface TransactionListParams {
-  /**
-   * Header param: Agent ID (agt_xxx) used for attribution and audit.
-   */
-  'X-Agent-ID': string;
-
-  /**
-   * Header param: Stable run, session, or conversation ID for agent observability.
-   */
-  'X-Instance-ID': string;
-
   /**
    * Query param: Pagination cursor from previous response
    */
@@ -488,23 +493,41 @@ export interface TransactionListParams {
    * Query param
    */
   type?: 'payment' | 'transfer' | 'all';
-}
 
-export interface TransactionGetParams {
   /**
-   * Header param: Agent ID (agt_xxx) used for attribution and audit.
+   * Header param: Conditionally required for payment-related API requests. Pass an
+   * agent ID (agt_xxx) for attribution, or omit it only when your party has exactly
+   * one active agent, which Natural defaults automatically.
    */
-  'X-Agent-ID': string;
+  'X-Agent-ID'?: string;
 
   /**
    * Header param: Stable run, session, or conversation ID for agent observability.
+   * If omitted on a payment-related API request, Natural generates one after
+   * resolving the attribution agent.
    */
-  'X-Instance-ID': string;
+  'X-Instance-ID'?: string;
+}
 
+export interface TransactionGetParams {
   /**
    * Query param: Party ID for delegated transaction lookup
    */
   partyId?: string;
+
+  /**
+   * Header param: Conditionally required for payment-related API requests. Pass an
+   * agent ID (agt_xxx) for attribution, or omit it only when your party has exactly
+   * one active agent, which Natural defaults automatically.
+   */
+  'X-Agent-ID'?: string;
+
+  /**
+   * Header param: Stable run, session, or conversation ID for agent observability.
+   * If omitted on a payment-related API request, Natural generates one after
+   * resolving the attribution agent.
+   */
+  'X-Instance-ID'?: string;
 }
 
 export declare namespace Transactions {

package/src/resources/transfers.ts

@@ -15,18 +15,24 @@ export class Transfers extends APIResource {
    *
    * @example
    * ```ts
-   * const transfers = await client.transfers.list({
-   *   'X-Agent-ID': 'X-Agent-ID',
-   *   'X-Instance-ID': 'X-Instance-ID',
-   * });
+   * const transfers = await client.transfers.list();
    * ```
    */
-  list(params: TransferListParams, options?: RequestOptions): APIPromise<TransferListResponse> {
-    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params;
+  list(
+    params: TransferListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TransferListResponse> {
+    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
     return this._client.get('/transfers', {
       query,
       ...options,
-      headers: buildHeaders([{ 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID }, options?.headers]),
+      headers: buildHeaders([
+        {
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
     });
   }
 
@@ -37,23 +43,25 @@ export class Transfers extends APIResource {
    * ```ts
    * const transfer = await client.transfers.get(
    *   'trf_ecc2efdd09bd231a9ad9bd2aada37aa7',
-   *   {
-   *     'X-Agent-ID': 'X-Agent-ID',
-   *     'X-Instance-ID': 'X-Instance-ID',
-   *   },
    * );
    * ```
    */
   get(
     transferID: string,
-    params: TransferGetParams,
+    params: TransferGetParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<TransferGetResponse> {
-    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params;
+    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
     return this._client.get(path`/transfers/${transferID}`, {
       query,
       ...options,
-      headers: buildHeaders([{ 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID }, options?.headers]),
+      headers: buildHeaders([
+        {
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
     });
   }
 
@@ -66,8 +74,6 @@ export class Transfers extends APIResource {
    *   amount: 100,
    *   externalAccountId: 'eac_ecc2efdd09bd231a9ad9bd2aada37aa7',
    *   'Idempotency-Key': 'Idempotency-Key',
-   *   'X-Agent-ID': 'X-Agent-ID',
-   *   'X-Instance-ID': 'X-Instance-ID',
    * });
    * ```
    */
@@ -85,7 +91,11 @@ export class Transfers extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { 'Idempotency-Key': idempotencyKey, 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID },
+        {
+          'Idempotency-Key': idempotencyKey,
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -100,8 +110,6 @@ export class Transfers extends APIResource {
    *   amount: 1,
    *   externalAccountId: 'eac_ecc2efdd09bd231a9ad9bd2aada37aa7',
    *   'Idempotency-Key': 'Idempotency-Key',
-   *   'X-Agent-ID': 'X-Agent-ID',
-   *   'X-Instance-ID': 'X-Instance-ID',
    * });
    * ```
    */
@@ -119,7 +127,11 @@ export class Transfers extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { 'Idempotency-Key': idempotencyKey, 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID },
+        {
+          'Idempotency-Key': idempotencyKey,
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -1189,16 +1201,6 @@ export namespace TransferInitiateWithdrawalResponse {
 }
 
 export interface TransferListParams {
-  /**
-   * Header param: Agent ID (agt_xxx) used for attribution and audit.
-   */
-  'X-Agent-ID': string;
-
-  /**
-   * Header param: Stable run, session, or conversation ID for agent observability.
-   */
-  'X-Instance-ID': string;
-
   /**
    * Query param: Pagination cursor from previous response
    */
@@ -1213,23 +1215,41 @@ export interface TransferListParams {
    * Query param: Party ID for delegated transfer lookup
    */
   partyId?: string;
-}
 
-export interface TransferGetParams {
   /**
-   * Header param: Agent ID (agt_xxx) used for attribution and audit.
+   * Header param: Conditionally required for payment-related API requests. Pass an
+   * agent ID (agt_xxx) for attribution, or omit it only when your party has exactly
+   * one active agent, which Natural defaults automatically.
    */
-  'X-Agent-ID': string;
+  'X-Agent-ID'?: string;
 
   /**
    * Header param: Stable run, session, or conversation ID for agent observability.
+   * If omitted on a payment-related API request, Natural generates one after
+   * resolving the attribution agent.
    */
-  'X-Instance-ID': string;
+  'X-Instance-ID'?: string;
+}
 
+export interface TransferGetParams {
   /**
    * Query param: Party ID for delegated transfer lookup
    */
   partyId?: string;
+
+  /**
+   * Header param: Conditionally required for payment-related API requests. Pass an
+   * agent ID (agt_xxx) for attribution, or omit it only when your party has exactly
+   * one active agent, which Natural defaults automatically.
+   */
+  'X-Agent-ID'?: string;
+
+  /**
+   * Header param: Stable run, session, or conversation ID for agent observability.
+   * If omitted on a payment-related API request, Natural generates one after
+   * resolving the attribution agent.
+   */
+  'X-Instance-ID'?: string;
 }
 
 export interface TransferInitiateDepositParams {
@@ -1250,24 +1270,28 @@ export interface TransferInitiateDepositParams {
   'Idempotency-Key': string;
 
   /**
-   * Header param: Agent ID (agt_xxx) used for attribution and audit.
+   * Body param: Currency code
    */
-  'X-Agent-ID': string;
+  currency?: string;
 
   /**
-   * Header param: Stable run, session, or conversation ID for agent observability.
+   * Body param: Deposit description
    */
-  'X-Instance-ID': string;
+  description?: string;
 
   /**
-   * Body param: Currency code
+   * Header param: Conditionally required for payment-related API requests. Pass an
+   * agent ID (agt_xxx) for attribution, or omit it only when your party has exactly
+   * one active agent, which Natural defaults automatically.
    */
-  currency?: string;
+  'X-Agent-ID'?: string;
 
   /**
-   * Body param: Deposit description
+   * Header param: Stable run, session, or conversation ID for agent observability.
+   * If omitted on a payment-related API request, Natural generates one after
+   * resolving the attribution agent.
    */
-  description?: string;
+  'X-Instance-ID'?: string;
 }
 
 export interface TransferInitiateWithdrawalParams {
@@ -1288,24 +1312,28 @@ export interface TransferInitiateWithdrawalParams {
   'Idempotency-Key': string;
 
   /**
-   * Header param: Agent ID (agt_xxx) used for attribution and audit.
+   * Body param: Currency code
    */
-  'X-Agent-ID': string;
+  currency?: string;
 
   /**
-   * Header param: Stable run, session, or conversation ID for agent observability.
+   * Body param: Withdrawal description
    */
-  'X-Instance-ID': string;
+  description?: string;
 
   /**
-   * Body param: Currency code
+   * Header param: Conditionally required for payment-related API requests. Pass an
+   * agent ID (agt_xxx) for attribution, or omit it only when your party has exactly
+   * one active agent, which Natural defaults automatically.
    */
-  currency?: string;
+  'X-Agent-ID'?: string;
 
   /**
-   * Body param: Withdrawal description
+   * Header param: Stable run, session, or conversation ID for agent observability.
+   * If omitted on a payment-related API request, Natural generates one after
+   * resolving the attribution agent.
    */
-  description?: string;
+  'X-Instance-ID'?: string;
 }
 
 export declare namespace Transfers {

package/src/resources/wallet.ts

@@ -11,8 +11,8 @@ import { path } from '../internal/utils/path';
  */
 export class Wallet extends APIResource {
   /**
-   * List wallets for the authenticated party, including balance and ACH deposit
-   * instructions when available. Currently returns at most one wallet.
+   * List wallets for the authenticated party, including balance and receiving bank
+   * name when available. Currently returns at most one wallet.
    */
   list(
     params: WalletListParams | null | undefined = {},
@@ -32,8 +32,8 @@ export class Wallet extends APIResource {
   }
 
   /**
-   * Get a wallet visible to the authenticated party, including balance and ACH
-   * deposit instructions when available.
+   * Get a wallet visible to the authenticated party, including balance and receiving
+   * bank name when available.
    */
   get(
     walletID: string,
@@ -99,7 +99,7 @@ export namespace WalletListResponse {
       claims: Attributes.Claims;
 
       /**
-       * ACH deposit instructions for this wallet, when available
+       * ACH deposit-instruction metadata for this wallet, when available
        */
       depositInstructions: Attributes.DepositInstructions | null;
 
@@ -146,23 +146,13 @@ export namespace WalletListResponse {
       }
 
       /**
-       * ACH deposit instructions for this wallet, when available
+       * ACH deposit-instruction metadata for this wallet, when available
        */
       export interface DepositInstructions {
-        /**
-         * Account number for ACH deposits
-         */
-        accountNumber: string;
-
         /**
          * Name of the receiving bank
          */
         bankName: string;
-
-        /**
-         * Bank routing number for ACH deposits
-         */
-        routingNumber: string;
       }
     }
 
@@ -259,7 +249,7 @@ export namespace WalletGetResponse {
       claims: Attributes.Claims;
 
       /**
-       * ACH deposit instructions for this wallet, when available
+       * ACH deposit-instruction metadata for this wallet, when available
        */
       depositInstructions: Attributes.DepositInstructions | null;
 
@@ -306,23 +296,13 @@ export namespace WalletGetResponse {
       }
 
       /**
-       * ACH deposit instructions for this wallet, when available
+       * ACH deposit-instruction metadata for this wallet, when available
        */
       export interface DepositInstructions {
-        /**
-         * Account number for ACH deposits
-         */
-        accountNumber: string;
-
         /**
          * Name of the receiving bank
          */
         bankName: string;
-
-        /**
-         * Bank routing number for ACH deposits
-         */
-        routingNumber: string;
       }
     }
 
@@ -366,26 +346,32 @@ export namespace WalletGetResponse {
 
 export interface WalletListParams {
   /**
-   * Agent ID (agt_xxx) identifying which agent is making the request.
+   * Agent ID (agt_xxx) used for attribution. Required for payment-related API
+   * requests unless your party has exactly one active agent, which Natural defaults
+   * automatically.
    */
   'X-Agent-ID'?: string;
 
   /**
-   * Required when X-Agent-ID is present. Session or conversation ID for agent
-   * observability.
+   * Stable run, session, or conversation ID for agent observability. If omitted on a
+   * payment-related API request, Natural generates one after resolving the
+   * attribution agent.
    */
   'X-Instance-ID'?: string;
 }
 
 export interface WalletGetParams {
   /**
-   * Agent ID (agt_xxx) identifying which agent is making the request.
+   * Agent ID (agt_xxx) used for attribution. Required for payment-related API
+   * requests unless your party has exactly one active agent, which Natural defaults
+   * automatically.
    */
   'X-Agent-ID'?: string;
 
   /**
-   * Required when X-Agent-ID is present. Session or conversation ID for agent
-   * observability.
+   * Stable run, session, or conversation ID for agent observability. If omitted on a
+   * payment-related API request, Natural generates one after resolving the
+   * attribution agent.
    */
   'X-Instance-ID'?: string;
 }

package/src/resources/webhooks.ts

@@ -1045,13 +1045,16 @@ export interface WebhookCreateParams {
   tags?: { [key: string]: string };
 
   /**
-   * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+   * Header param: Agent ID (agt_xxx) used for attribution. Required for
+   * payment-related API requests unless your party has exactly one active agent,
+   * which Natural defaults automatically.
    */
   'X-Agent-ID'?: string;
 
   /**
-   * Header param: Required when X-Agent-ID is present. Session or conversation ID
-   * for agent observability.
+   * Header param: Stable run, session, or conversation ID for agent observability.
+   * If omitted on a payment-related API request, Natural generates one after
+   * resolving the attribution agent.
    */
   'X-Instance-ID'?: string;
 }
@@ -1118,13 +1121,16 @@ export interface WebhookUpdateParams {
   url?: string;
 
   /**
-   * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+   * Header param: Agent ID (agt_xxx) used for attribution. Required for
+   * payment-related API requests unless your party has exactly one active agent,
+   * which Natural defaults automatically.
    */
   'X-Agent-ID'?: string;
 
   /**
-   * Header param: Required when X-Agent-ID is present. Session or conversation ID
-   * for agent observability.
+   * Header param: Stable run, session, or conversation ID for agent observability.
+   * If omitted on a payment-related API request, Natural generates one after
+   * resolving the attribution agent.
    */
   'X-Instance-ID'?: string;
 }
@@ -1146,26 +1152,32 @@ export interface WebhookListParams {
   status?: 'ENABLED' | 'DISABLED';
 
   /**
-   * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+   * Header param: Agent ID (agt_xxx) used for attribution. Required for
+   * payment-related API requests unless your party has exactly one active agent,
+   * which Natural defaults automatically.
    */
   'X-Agent-ID'?: string;
 
   /**
-   * Header param: Required when X-Agent-ID is present. Session or conversation ID
-   * for agent observability.
+   * Header param: Stable run, session, or conversation ID for agent observability.
+   * If omitted on a payment-related API request, Natural generates one after
+   * resolving the attribution agent.
    */
   'X-Instance-ID'?: string;
 }
 
 export interface WebhookGetParams {
   /**
-   * Agent ID (agt_xxx) identifying which agent is making the request.
+   * Agent ID (agt_xxx) used for attribution. Required for payment-related API
+   * requests unless your party has exactly one active agent, which Natural defaults
+   * automatically.
    */
   'X-Agent-ID'?: string;
 
   /**
-   * Required when X-Agent-ID is present. Session or conversation ID for agent
-   * observability.
+   * Stable run, session, or conversation ID for agent observability. If omitted on a
+   * payment-related API request, Natural generates one after resolving the
+   * attribution agent.
    */
   'X-Instance-ID'?: string;
 }
@@ -1178,13 +1190,16 @@ export interface WebhookRemoveParams {
   'Idempotency-Key': string;
 
   /**
-   * Agent ID (agt_xxx) identifying which agent is making the request.
+   * Agent ID (agt_xxx) used for attribution. Required for payment-related API
+   * requests unless your party has exactly one active agent, which Natural defaults
+   * automatically.
    */
   'X-Agent-ID'?: string;
 
   /**
-   * Required when X-Agent-ID is present. Session or conversation ID for agent
-   * observability.
+   * Stable run, session, or conversation ID for agent observability. If omitted on a
+   * payment-related API request, Natural generates one after resolving the
+   * attribution agent.
    */
   'X-Instance-ID'?: string;
 }
@@ -1203,13 +1218,16 @@ export interface WebhookRotateSecretParams {
   'Idempotency-Key': string;
 
   /**
-   * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+   * Header param: Agent ID (agt_xxx) used for attribution. Required for
+   * payment-related API requests unless your party has exactly one active agent,
+   * which Natural defaults automatically.
    */
   'X-Agent-ID'?: string;
 
   /**
-   * Header param: Required when X-Agent-ID is present. Session or conversation ID
-   * for agent observability.
+   * Header param: Stable run, session, or conversation ID for agent observability.
+   * If omitted on a payment-related API request, Natural generates one after
+   * resolving the attribution agent.
    */
   'X-Instance-ID'?: string;
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.11.0'; // x-release-please-version
+export const VERSION = '0.13.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.11.0";
+export declare const VERSION = "0.13.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.11.0";
+export declare const VERSION = "0.13.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.11.0'; // x-release-please-version
+exports.VERSION = '0.13.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.11.0'; // x-release-please-version
+export const VERSION = '0.13.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map