@naturalpay/sdk 0.2.1 → 0.4.0

package/src/resources/external-accounts.ts

@@ -0,0 +1,324 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+/**
+ * Linked external bank accounts
+ */
+export class ExternalAccounts extends APIResource {
+  /**
+   * List linked external accounts with cursor pagination.
+   */
+  list(
+    params: ExternalAccountListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ExternalAccountListResponse> {
+    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
+    return this._client.get('/external-accounts', {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Remove (unlink) a bank account.
+   */
+  remove(
+    externalAccountID: string,
+    params: ExternalAccountRemoveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ExternalAccountRemoveResponse> {
+    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID } = params ?? {};
+    return this._client.delete(path`/external-accounts/${externalAccountID}`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface ExternalAccountListResponse {
+  data: Array<ExternalAccountListResponse.Data>;
+
+  meta: ExternalAccountListResponse.Meta;
+}
+
+export namespace ExternalAccountListResponse {
+  export interface Data {
+    /**
+     * Resource ID
+     */
+    id: string;
+
+    /**
+     * Resource attributes
+     */
+    attributes: Data.Attributes;
+
+    /**
+     * Resource relationships
+     */
+    relationships: Data.Relationships;
+
+    /**
+     * Resource type
+     */
+    type: string;
+  }
+
+  export namespace Data {
+    /**
+     * Resource attributes
+     */
+    export interface Attributes {
+      /**
+       * Account display name
+       */
+      accountName: string | null;
+
+      /**
+       * Account type (checking, savings)
+       */
+      accountType: 'checking' | 'savings' | 'unknown' | null;
+
+      /**
+       * Bank institution name
+       */
+      bankName: string | null;
+
+      /**
+       * When the external account was linked
+       */
+      createdAt: string;
+
+      /**
+       * Last 4 digits of account
+       */
+      lastFour: string;
+
+      /**
+       * Status (pending, active, disabled)
+       */
+      status: 'pending' | 'new' | 'active' | 'disabled' | 'deleted' | 'unknown';
+    }
+
+    /**
+     * Resource relationships
+     */
+    export interface Relationships {
+      /**
+       * Party that owns the external account
+       */
+      party: Relationships.Party;
+    }
+
+    export namespace Relationships {
+      /**
+       * Party that owns the external account
+       */
+      export interface Party {
+        /**
+         * Related resource identifier
+         */
+        data: Party.Data;
+      }
+
+      export namespace Party {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+    }
+  }
+
+  export interface Meta {
+    pagination: Meta.Pagination;
+  }
+
+  export namespace Meta {
+    export interface Pagination {
+      hasMore: boolean;
+
+      nextCursor: string | null;
+    }
+  }
+}
+
+export interface ExternalAccountRemoveResponse {
+  data: ExternalAccountRemoveResponse.Data;
+
+  meta: ExternalAccountRemoveResponse.Meta;
+}
+
+export namespace ExternalAccountRemoveResponse {
+  export interface Data {
+    /**
+     * Resource ID
+     */
+    id: string;
+
+    /**
+     * Resource attributes
+     */
+    attributes: Data.Attributes;
+
+    /**
+     * Resource relationships
+     */
+    relationships: Data.Relationships;
+
+    /**
+     * Resource type
+     */
+    type: string;
+  }
+
+  export namespace Data {
+    /**
+     * Resource attributes
+     */
+    export interface Attributes {
+      /**
+       * Account display name
+       */
+      accountName: string | null;
+
+      /**
+       * Account type (checking, savings)
+       */
+      accountType: 'checking' | 'savings' | 'unknown' | null;
+
+      /**
+       * Bank institution name
+       */
+      bankName: string | null;
+
+      /**
+       * When the external account was linked
+       */
+      createdAt: string;
+
+      /**
+       * Last 4 digits of account
+       */
+      lastFour: string;
+
+      /**
+       * Status (pending, active, disabled)
+       */
+      status: 'pending' | 'new' | 'active' | 'disabled' | 'deleted' | 'unknown';
+    }
+
+    /**
+     * Resource relationships
+     */
+    export interface Relationships {
+      /**
+       * Party that owns the external account
+       */
+      party: Relationships.Party;
+    }
+
+    export namespace Relationships {
+      /**
+       * Party that owns the external account
+       */
+      export interface Party {
+        /**
+         * Related resource identifier
+         */
+        data: Party.Data;
+      }
+
+      export namespace Party {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+    }
+  }
+
+  export interface Meta {
+    /**
+     * Indicates the resource was deleted
+     */
+    deleted: true;
+  }
+}
+
+export interface ExternalAccountListParams {
+  /**
+   * Query param
+   */
+  cursor?: string;
+
+  /**
+   * Query param
+   */
+  limit?: number;
+
+  /**
+   * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+   */
+  'X-Agent-ID'?: string;
+
+  /**
+   * Header param: Required when X-Agent-ID is present. Session or conversation ID
+   * for agent observability.
+   */
+  'X-Instance-ID'?: string;
+}
+
+export interface ExternalAccountRemoveParams {
+  /**
+   * Agent ID (agt_xxx) identifying which agent is making the request.
+   */
+  'X-Agent-ID'?: string;
+
+  /**
+   * Required when X-Agent-ID is present. Session or conversation ID for agent
+   * observability.
+   */
+  'X-Instance-ID'?: string;
+}
+
+export declare namespace ExternalAccounts {
+  export {
+    type ExternalAccountListResponse as ExternalAccountListResponse,
+    type ExternalAccountRemoveResponse as ExternalAccountRemoveResponse,
+    type ExternalAccountListParams as ExternalAccountListParams,
+    type ExternalAccountRemoveParams as ExternalAccountRemoveParams,
+  };
+}

package/src/resources/index.ts

@@ -43,6 +43,24 @@ export {
   type DelegationGetAgentDelegationParams,
   type DelegationListAgentDelegationsParams,
 } from './delegations';
+export {
+  Escalations,
+  type EscalationListResponse,
+  type EscalationApproveResponse,
+  type EscalationDenyResponse,
+  type EscalationGetResponse,
+  type EscalationListParams,
+  type EscalationApproveParams,
+  type EscalationDenyParams,
+  type EscalationGetParams,
+} from './escalations';
+export {
+  ExternalAccounts,
+  type ExternalAccountListResponse,
+  type ExternalAccountRemoveResponse,
+  type ExternalAccountListParams,
+  type ExternalAccountRemoveParams,
+} from './external-accounts';
 export {
   Invitations,
   type InvitationCreateResponse,
@@ -57,20 +75,36 @@ export {
   type PartyUpdateResponse,
   type PartyGetResponse,
   type PartyListMembersResponse,
+  type PartyRemoveMemberResponse,
   type PartyUpdateParams,
   type PartyGetParams,
   type PartyListMembersParams,
+  type PartyRemoveMemberParams,
 } from './parties';
 export {
   PaymentRequests,
   type PaymentRequestCreateResponse,
   type PaymentRequestListResponse,
+  type PaymentRequestDeclineResponse,
+  type PaymentRequestFulfillResponse,
   type PaymentRequestGetResponse,
+  type PaymentRequestListIncomingResponse,
   type PaymentRequestCreateParams,
   type PaymentRequestListParams,
+  type PaymentRequestDeclineParams,
+  type PaymentRequestFulfillParams,
   type PaymentRequestGetParams,
+  type PaymentRequestListIncomingParams,
 } from './payment-requests';
-export { Payments, type PaymentCreateResponse, type PaymentCreateParams } from './payments';
+export {
+  Payments,
+  type PaymentCreateResponse,
+  type PaymentListResponse,
+  type PaymentGetResponse,
+  type PaymentCreateParams,
+  type PaymentListParams,
+  type PaymentGetParams,
+} from './payments';
 export {
   Transactions,
   type TransactionListResponse,
@@ -78,18 +112,36 @@ export {
   type TransactionListParams,
   type TransactionGetParams,
 } from './transactions';
+export {
+  Transfers,
+  type TransferListResponse,
+  type TransferGetResponse,
+  type TransferInitiateDepositResponse,
+  type TransferInitiateWithdrawalResponse,
+  type TransferListParams,
+  type TransferGetParams,
+  type TransferInitiateDepositParams,
+  type TransferInitiateWithdrawalParams,
+} from './transfers';
 export {
   Wallet,
-  type WalletGetBalanceResponse,
-  type WalletGetDepositInstructionsResponse,
-  type WalletInitiateDepositResponse,
-  type WalletInitiateWithdrawalResponse,
-  type WalletListPaymentInstrumentsResponse,
-  type WalletRemovePaymentInstrumentResponse,
-  type WalletGetBalanceParams,
-  type WalletGetDepositInstructionsParams,
-  type WalletInitiateDepositParams,
-  type WalletInitiateWithdrawalParams,
-  type WalletListPaymentInstrumentsParams,
-  type WalletRemovePaymentInstrumentParams,
+  type WalletListResponse,
+  type WalletGetResponse,
+  type WalletListParams,
+  type WalletGetParams,
 } from './wallet';
+export {
+  Webhooks,
+  type WebhookCreateResponse,
+  type WebhookUpdateResponse,
+  type WebhookListResponse,
+  type WebhookGetResponse,
+  type WebhookRemoveResponse,
+  type WebhookRotateSecretResponse,
+  type WebhookCreateParams,
+  type WebhookUpdateParams,
+  type WebhookListParams,
+  type WebhookGetParams,
+  type WebhookRemoveParams,
+  type WebhookRotateSecretParams,
+} from './webhooks';

package/src/resources/invitations.ts

@@ -11,13 +11,13 @@ import { path } from '../internal/utils/path';
  */
 export class Invitations extends APIResource {
   /**
-   * Create one or more invitations to join the authenticated user's party.
+   * Send invitations to join your party.
    *
    * @example
    * ```ts
    * const invitation = await client.invitations.create({
    *   invitations: [
-   *     { email: 'dev@stainless.com', role: 'OWNER' },
+   *     { email: 'dev@stainless.com', role: 'ADMIN' },
    *   ],
    * });
    * ```
@@ -70,19 +70,25 @@ export class Invitations extends APIResource {
    * ```ts
    * const response = await client.invitations.revoke(
    *   'invitationId',
+   *   { 'Idempotency-Key': 'Idempotency-Key' },
    * );
    * ```
    */
   revoke(
     invitationID: string,
-    params: InvitationRevokeParams | null | undefined = {},
+    params: InvitationRevokeParams,
     options?: RequestOptions,
   ): APIPromise<InvitationRevokeResponse> {
-    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID } = params ?? {};
-    return this._client.post(path`/party-invitations/${invitationID}/revoke`, {
+    const {
+      'Idempotency-Key': idempotencyKey,
+      'X-Agent-ID': xAgentID,
+      'X-Instance-ID': xInstanceID,
+    } = params;
+    return this._client.delete(path`/party-invitations/${invitationID}`, {
       ...options,
       headers: buildHeaders([
         {
+          'Idempotency-Key': idempotencyKey,
           ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
           ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
         },
@@ -263,6 +269,8 @@ export namespace InvitationListResponse {
 
 export interface InvitationRevokeResponse {
   data: InvitationRevokeResponse.Data;
+
+  meta: InvitationRevokeResponse.Meta;
 }
 
 export namespace InvitationRevokeResponse {
@@ -319,6 +327,13 @@ export namespace InvitationRevokeResponse {
       status: 'PENDING' | 'ACCEPTED' | 'REVOKED';
     }
   }
+
+  export interface Meta {
+    /**
+     * Indicates the resource was deleted
+     */
+    deleted: true;
+  }
 }
 
 export interface InvitationCreateParams {
@@ -327,11 +342,6 @@ export interface InvitationCreateParams {
    */
   invitations: Array<InvitationCreateParams.Invitation>;
 
-  /**
-   * Body param: Days until invitation expires (1-30)
-   */
-  expiresInDays?: number;
-
   /**
    * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
    */
@@ -357,7 +367,7 @@ export namespace InvitationCreateParams {
     /**
      * Role to assign on acceptance
      */
-    role: 'OWNER' | 'ADMIN' | 'MEMBER' | 'VIEWER';
+    role: 'ADMIN' | 'MEMBER' | 'VIEWER';
   }
 }
 
@@ -390,6 +400,12 @@ export interface InvitationListParams {
 }
 
 export interface InvitationRevokeParams {
+  /**
+   * Unique key for idempotent request handling. If a request with the same key was
+   * already processed, the original response is returned.
+   */
+  'Idempotency-Key': string;
+
   /**
    * Agent ID (agt_xxx) identifying which agent is making the request.
    */