@naturalpay/sdk 0.2.0 → 0.3.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

@@ -0,0 +1,113 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  APIKeys,
+  type APIKeyCreateResponse,
+  type APIKeyListResponse,
+  type APIKeyGetResponse,
+  type APIKeyRevokeResponse,
+  type APIKeyCreateParams,
+  type APIKeyListParams,
+  type APIKeyGetParams,
+  type APIKeyRevokeParams,
+} from './api-keys';
+export {
+  Agents,
+  type AgentCreateResponse,
+  type AgentUpdateResponse,
+  type AgentListResponse,
+  type AgentCreateInvitationsResponse,
+  type AgentGetResponse,
+  type AgentListInvitationsForDeveloperResponse,
+  type AgentRemoveResponse,
+  type AgentCreateParams,
+  type AgentUpdateParams,
+  type AgentListParams,
+  type AgentCreateInvitationsParams,
+  type AgentGetParams,
+  type AgentListInvitationsForDeveloperParams,
+  type AgentRemoveParams,
+} from './agents';
+export { Counterparties, type CounterpartyListResponse, type CounterpartyListParams } from './counterparties';
+export {
+  Customers,
+  type CustomerListResponse,
+  type CustomerListInvitationsResponse,
+  type CustomerListParams,
+  type CustomerListInvitationsParams,
+} from './customers';
+export {
+  Delegations,
+  type DelegationGetAgentDelegationResponse,
+  type DelegationListAgentDelegationsResponse,
+  type DelegationGetAgentDelegationParams,
+  type DelegationListAgentDelegationsParams,
+} from './delegations';
+export {
+  ExternalAccounts,
+  type ExternalAccountListResponse,
+  type ExternalAccountRemoveResponse,
+  type ExternalAccountListParams,
+  type ExternalAccountRemoveParams,
+} from './external-accounts';
+export {
+  Invitations,
+  type InvitationCreateResponse,
+  type InvitationListResponse,
+  type InvitationRevokeResponse,
+  type InvitationCreateParams,
+  type InvitationListParams,
+  type InvitationRevokeParams,
+} from './invitations';
+export {
+  Parties,
+  type PartyUpdateResponse,
+  type PartyGetResponse,
+  type PartyListMembersResponse,
+  type PartyUpdateParams,
+  type PartyGetParams,
+  type PartyListMembersParams,
+} from './parties';
+export {
+  PaymentRequests,
+  type PaymentRequestCreateResponse,
+  type PaymentRequestListResponse,
+  type PaymentRequestGetResponse,
+  type PaymentRequestCreateParams,
+  type PaymentRequestListParams,
+  type PaymentRequestGetParams,
+} from './payment-requests';
+export { Payments, type PaymentCreateResponse, type PaymentCreateParams } from './payments';
+export {
+  Transactions,
+  type TransactionListResponse,
+  type TransactionGetResponse,
+  type TransactionListParams,
+  type TransactionGetParams,
+} from './transactions';
+export {
+  Wallet,
+  type WalletListResponse,
+  type WalletGetResponse,
+  type WalletInitiateDepositResponse,
+  type WalletInitiateWithdrawalResponse,
+  type WalletListParams,
+  type WalletGetParams,
+  type WalletInitiateDepositParams,
+  type WalletInitiateWithdrawalParams,
+} 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';