@naturalpay/sdk 0.9.0 → 0.11.0

package/src/resources/transactions.ts

@@ -13,21 +13,12 @@ export class Transactions extends APIResource {
   /**
    * List transactions visible to your party.
    */
-  list(
-    params: TransactionListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<TransactionListResponse> {
-    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
+  list(params: TransactionListParams, options?: RequestOptions): APIPromise<TransactionListResponse> {
+    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params;
     return this._client.get('/transactions', {
       query,
       ...options,
-      headers: buildHeaders([
-        {
-          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
-          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
-        },
-        options?.headers,
-      ]),
+      headers: buildHeaders([{ 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID }, options?.headers]),
     });
   }
 
@@ -36,20 +27,14 @@ export class Transactions extends APIResource {
    */
   get(
     transactionID: string,
-    params: TransactionGetParams | null | undefined = {},
+    params: TransactionGetParams,
     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([
-        {
-          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
-          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
-        },
-        options?.headers,
-      ]),
+      headers: buildHeaders([{ 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID }, options?.headers]),
     });
   }
 }
@@ -77,7 +62,7 @@ export namespace TransactionListResponse {
      */
     relationships: Data.Relationships;
 
-    type: string;
+    type: 'transaction';
   }
 
   export namespace Data {
@@ -180,7 +165,7 @@ export namespace TransactionListResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'party';
         }
       }
 
@@ -204,7 +189,7 @@ export namespace TransactionListResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'party';
         }
       }
 
@@ -229,7 +214,7 @@ export namespace TransactionListResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'payment';
         }
       }
 
@@ -254,7 +239,7 @@ export namespace TransactionListResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'transfer';
         }
       }
     }
@@ -294,7 +279,7 @@ export namespace TransactionGetResponse {
      */
     relationships: Data.Relationships;
 
-    type: string;
+    type: 'transaction';
   }
 
   export namespace Data {
@@ -397,7 +382,7 @@ export namespace TransactionGetResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'party';
         }
       }
 
@@ -421,7 +406,7 @@ export namespace TransactionGetResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'party';
         }
       }
 
@@ -446,7 +431,7 @@ export namespace TransactionGetResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'payment';
         }
       }
 
@@ -471,7 +456,7 @@ export namespace TransactionGetResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'transfer';
         }
       }
     }
@@ -480,48 +465,46 @@ export namespace TransactionGetResponse {
 
 export interface TransactionListParams {
   /**
-   * Query param: Pagination cursor from previous response
+   * Header param: Agent ID (agt_xxx) used for attribution and audit.
    */
-  cursor?: string;
+  'X-Agent-ID': string;
 
   /**
-   * Query param: Results per page
+   * Header param: Stable run, session, or conversation ID for agent observability.
    */
-  limit?: number;
+  'X-Instance-ID': string;
 
   /**
-   * Query param
+   * Query param: Pagination cursor from previous response
    */
-  type?: 'payment' | 'transfer' | 'all';
+  cursor?: string;
 
   /**
-   * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+   * Query param: Results per page
    */
-  'X-Agent-ID'?: string;
+  limit?: number;
 
   /**
-   * Header param: Required when X-Agent-ID is present. Session or conversation ID
-   * for agent observability.
+   * Query param
    */
-  'X-Instance-ID'?: string;
+  type?: 'payment' | 'transfer' | 'all';
 }
 
 export interface TransactionGetParams {
   /**
-   * Query param: Party ID for delegated transaction lookup
+   * Header param: Agent ID (agt_xxx) used for attribution and audit.
    */
-  partyId?: string;
+  'X-Agent-ID': string;
 
   /**
-   * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+   * Header param: Stable run, session, or conversation ID for agent observability.
    */
-  'X-Agent-ID'?: string;
+  'X-Instance-ID': string;
 
   /**
-   * Header param: Required when X-Agent-ID is present. Session or conversation ID
-   * for agent observability.
+   * Query param: Party ID for delegated transaction lookup
    */
-  'X-Instance-ID'?: string;
+  partyId?: string;
 }
 
 export declare namespace Transactions {

package/src/resources/transfers.ts

@@ -15,24 +15,18 @@ export class Transfers extends APIResource {
    *
    * @example
    * ```ts
-   * const transfers = await client.transfers.list();
+   * const transfers = await client.transfers.list({
+   *   'X-Agent-ID': 'X-Agent-ID',
+   *   'X-Instance-ID': 'X-Instance-ID',
+   * });
    * ```
    */
-  list(
-    params: TransferListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<TransferListResponse> {
-    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
+  list(params: TransferListParams, options?: RequestOptions): APIPromise<TransferListResponse> {
+    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params;
     return this._client.get('/transfers', {
       query,
       ...options,
-      headers: buildHeaders([
-        {
-          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
-          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
-        },
-        options?.headers,
-      ]),
+      headers: buildHeaders([{ 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID }, options?.headers]),
     });
   }
 
@@ -43,25 +37,23 @@ 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 | null | undefined = {},
+    params: TransferGetParams,
     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([
-        {
-          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
-          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
-        },
-        options?.headers,
-      ]),
+      headers: buildHeaders([{ 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID }, options?.headers]),
     });
   }
 
@@ -74,6 +66,8 @@ 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',
    * });
    * ```
    */
@@ -91,11 +85,7 @@ export class Transfers extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        {
-          'Idempotency-Key': idempotencyKey,
-          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
-          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
-        },
+        { 'Idempotency-Key': idempotencyKey, 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID },
         options?.headers,
       ]),
     });
@@ -110,6 +100,8 @@ 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',
    * });
    * ```
    */
@@ -127,11 +119,7 @@ export class Transfers extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        {
-          'Idempotency-Key': idempotencyKey,
-          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
-          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
-        },
+        { 'Idempotency-Key': idempotencyKey, 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID },
         options?.headers,
       ]),
     });
@@ -158,7 +146,7 @@ export namespace TransferListResponse {
      */
     relationships: Data.Relationships;
 
-    type: string;
+    type: 'transfer';
   }
 
   export namespace Data {
@@ -323,7 +311,7 @@ export namespace TransferListResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'externalAccount';
         }
       }
 
@@ -347,7 +335,7 @@ export namespace TransferListResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'party';
         }
       }
 
@@ -371,7 +359,7 @@ export namespace TransferListResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'transaction';
         }
       }
 
@@ -395,7 +383,7 @@ export namespace TransferListResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'wallet';
         }
       }
     }
@@ -432,7 +420,7 @@ export namespace TransferGetResponse {
      */
     relationships: Data.Relationships;
 
-    type: string;
+    type: 'transfer';
   }
 
   export namespace Data {
@@ -597,7 +585,7 @@ export namespace TransferGetResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'externalAccount';
         }
       }
 
@@ -621,7 +609,7 @@ export namespace TransferGetResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'party';
         }
       }
 
@@ -645,7 +633,7 @@ export namespace TransferGetResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'transaction';
         }
       }
 
@@ -669,7 +657,7 @@ export namespace TransferGetResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'wallet';
         }
       }
     }
@@ -694,7 +682,7 @@ export namespace TransferInitiateDepositResponse {
      */
     relationships: Data.Relationships;
 
-    type: string;
+    type: 'transfer';
   }
 
   export namespace Data {
@@ -859,7 +847,7 @@ export namespace TransferInitiateDepositResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'externalAccount';
         }
       }
 
@@ -883,7 +871,7 @@ export namespace TransferInitiateDepositResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'party';
         }
       }
 
@@ -907,7 +895,7 @@ export namespace TransferInitiateDepositResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'transaction';
         }
       }
 
@@ -931,7 +919,7 @@ export namespace TransferInitiateDepositResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'wallet';
         }
       }
     }
@@ -956,7 +944,7 @@ export namespace TransferInitiateWithdrawalResponse {
      */
     relationships: Data.Relationships;
 
-    type: string;
+    type: 'transfer';
   }
 
   export namespace Data {
@@ -1121,7 +1109,7 @@ export namespace TransferInitiateWithdrawalResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'externalAccount';
         }
       }
 
@@ -1145,7 +1133,7 @@ export namespace TransferInitiateWithdrawalResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'party';
         }
       }
 
@@ -1169,7 +1157,7 @@ export namespace TransferInitiateWithdrawalResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'transaction';
         }
       }
 
@@ -1193,7 +1181,7 @@ export namespace TransferInitiateWithdrawalResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'wallet';
         }
       }
     }
@@ -1202,48 +1190,46 @@ export namespace TransferInitiateWithdrawalResponse {
 
 export interface TransferListParams {
   /**
-   * Query param: Pagination cursor from previous response
+   * Header param: Agent ID (agt_xxx) used for attribution and audit.
    */
-  cursor?: string;
+  'X-Agent-ID': string;
 
   /**
-   * Query param: Results per page
+   * Header param: Stable run, session, or conversation ID for agent observability.
    */
-  limit?: number;
+  'X-Instance-ID': string;
 
   /**
-   * Query param: Party ID for delegated transfer lookup
+   * Query param: Pagination cursor from previous response
    */
-  partyId?: string;
+  cursor?: string;
 
   /**
-   * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+   * Query param: Results per page
    */
-  'X-Agent-ID'?: string;
+  limit?: number;
 
   /**
-   * Header param: Required when X-Agent-ID is present. Session or conversation ID
-   * for agent observability.
+   * Query param: Party ID for delegated transfer lookup
    */
-  'X-Instance-ID'?: string;
+  partyId?: string;
 }
 
 export interface TransferGetParams {
   /**
-   * Query param: Party ID for delegated transfer lookup
+   * Header param: Agent ID (agt_xxx) used for attribution and audit.
    */
-  partyId?: string;
+  'X-Agent-ID': string;
 
   /**
-   * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+   * Header param: Stable run, session, or conversation ID for agent observability.
    */
-  'X-Agent-ID'?: string;
+  'X-Instance-ID': string;
 
   /**
-   * Header param: Required when X-Agent-ID is present. Session or conversation ID
-   * for agent observability.
+   * Query param: Party ID for delegated transfer lookup
    */
-  'X-Instance-ID'?: string;
+  partyId?: string;
 }
 
 export interface TransferInitiateDepositParams {
@@ -1264,25 +1250,24 @@ export interface TransferInitiateDepositParams {
   'Idempotency-Key': string;
 
   /**
-   * Body param: Currency code
+   * Header param: Agent ID (agt_xxx) used for attribution and audit.
    */
-  currency?: string;
+  'X-Agent-ID': string;
 
   /**
-   * Body param: Deposit description
+   * Header param: Stable run, session, or conversation ID for agent observability.
    */
-  description?: string;
+  'X-Instance-ID': string;
 
   /**
-   * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+   * Body param: Currency code
    */
-  'X-Agent-ID'?: string;
+  currency?: string;
 
   /**
-   * Header param: Required when X-Agent-ID is present. Session or conversation ID
-   * for agent observability.
+   * Body param: Deposit description
    */
-  'X-Instance-ID'?: string;
+  description?: string;
 }
 
 export interface TransferInitiateWithdrawalParams {
@@ -1303,25 +1288,24 @@ export interface TransferInitiateWithdrawalParams {
   'Idempotency-Key': string;
 
   /**
-   * Body param: Currency code
+   * Header param: Agent ID (agt_xxx) used for attribution and audit.
    */
-  currency?: string;
+  'X-Agent-ID': string;
 
   /**
-   * Body param: Withdrawal description
+   * Header param: Stable run, session, or conversation ID for agent observability.
    */
-  description?: string;
+  'X-Instance-ID': string;
 
   /**
-   * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+   * Body param: Currency code
    */
-  'X-Agent-ID'?: string;
+  currency?: string;
 
   /**
-   * Header param: Required when X-Agent-ID is present. Session or conversation ID
-   * for agent observability.
+   * Body param: Withdrawal description
    */
-  'X-Instance-ID'?: string;
+  description?: string;
 }
 
 export declare namespace Transfers {

package/src/resources/wallet.ts

@@ -80,7 +80,7 @@ export namespace WalletListResponse {
     /**
      * Resource type
      */
-    type: string;
+    type: 'wallet';
   }
 
   export namespace Data {
@@ -197,7 +197,7 @@ export namespace WalletListResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'party';
         }
       }
     }
@@ -240,7 +240,7 @@ export namespace WalletGetResponse {
     /**
      * Resource type
      */
-    type: string;
+    type: 'wallet';
   }
 
   export namespace Data {
@@ -357,7 +357,7 @@ export namespace WalletGetResponse {
           /**
            * Resource type
            */
-          type: string;
+          type: 'party';
         }
       }
     }