@naturalpay/sdk 0.1.4 → 0.2.1

package/src/resources/delegations.ts

@@ -0,0 +1,580 @@
+// 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';
+
+/**
+ * Agent delegation management
+ */
+export class Delegations extends APIResource {
+  /**
+   * Get agent delegation
+   */
+  getAgentDelegation(
+    agentDelegationID: string,
+    params: DelegationGetAgentDelegationParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<DelegationGetAgentDelegationResponse> {
+    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID } = params ?? {};
+    return this._client.get(path`/agent-delegations/${agentDelegationID}`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * List agent delegations
+   */
+  listAgentDelegations(
+    params: DelegationListAgentDelegationsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<DelegationListAgentDelegationsResponse> {
+    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
+    return this._client.get('/agent-delegations', {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+          ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface DelegationGetAgentDelegationResponse {
+  data: DelegationGetAgentDelegationResponse.Data;
+}
+
+export namespace DelegationGetAgentDelegationResponse {
+  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 {
+      /**
+       * Agent display name
+       */
+      agentName: string | null;
+
+      /**
+       * When this delegation was created
+       */
+      createdAt: string;
+
+      /**
+       * User who created this delegation (usr\_\*)
+       */
+      createdBy: string | null;
+
+      /**
+       * Developer party name
+       */
+      delegateePartyName: string | null;
+
+      /**
+       * Customer party name
+       */
+      delegatorPartyName: string | null;
+
+      /**
+       * Expiration timestamp
+       */
+      expiresAt: string | null;
+
+      /**
+       * Transaction limits in cents
+       */
+      limits: Attributes.Limits | null;
+
+      /**
+       * Granted permissions. Use `status` to derive Active vs Revoked.
+       */
+      permissions: Array<string>;
+
+      /**
+       * Authoritative active/revoked flag (revoke keeps permissions for audit)
+       */
+      status: 'ACTIVE' | 'REVOKED';
+
+      /**
+       * When this delegation was last updated
+       */
+      updatedAt: string;
+    }
+
+    export namespace Attributes {
+      /**
+       * Transaction limits in cents
+       */
+      export interface Limits {
+        /**
+         * Positive per-transaction limit in cents. null means no per-payment limit.
+         */
+        perTransaction?: number | null;
+      }
+    }
+
+    /**
+     * Resource relationships
+     */
+    export interface Relationships {
+      /**
+       * Agent granted access
+       */
+      agent: Relationships.Agent;
+
+      /**
+       * Parent party delegation
+       */
+      delegation: Relationships.Delegation;
+
+      /**
+       * Developer party receiving access
+       */
+      delegateeParty?: Relationships.DelegateeParty;
+
+      /**
+       * Customer party granting access
+       */
+      delegatorParty?: Relationships.DelegatorParty;
+    }
+
+    export namespace Relationships {
+      /**
+       * Agent granted access
+       */
+      export interface Agent {
+        /**
+         * Related resource identifier
+         */
+        data: Agent.Data;
+      }
+
+      export namespace Agent {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Parent party delegation
+       */
+      export interface Delegation {
+        /**
+         * Related resource identifier
+         */
+        data: Delegation.Data;
+      }
+
+      export namespace Delegation {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Developer party receiving access
+       */
+      export interface DelegateeParty {
+        /**
+         * Related resource identifier
+         */
+        data: DelegateeParty.Data | null;
+      }
+
+      export namespace DelegateeParty {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Customer party granting access
+       */
+      export interface DelegatorParty {
+        /**
+         * Related resource identifier
+         */
+        data: DelegatorParty.Data | null;
+      }
+
+      export namespace DelegatorParty {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+    }
+  }
+}
+
+export interface DelegationListAgentDelegationsResponse {
+  data: Array<DelegationListAgentDelegationsResponse.Data>;
+
+  meta: DelegationListAgentDelegationsResponse.Meta;
+}
+
+export namespace DelegationListAgentDelegationsResponse {
+  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 {
+      /**
+       * Agent display name
+       */
+      agentName: string | null;
+
+      /**
+       * When this delegation was created
+       */
+      createdAt: string;
+
+      /**
+       * User who created this delegation (usr\_\*)
+       */
+      createdBy: string | null;
+
+      /**
+       * Developer party name
+       */
+      delegateePartyName: string | null;
+
+      /**
+       * Customer party name
+       */
+      delegatorPartyName: string | null;
+
+      /**
+       * Expiration timestamp
+       */
+      expiresAt: string | null;
+
+      /**
+       * Transaction limits in cents
+       */
+      limits: Attributes.Limits | null;
+
+      /**
+       * Granted permissions. Use `status` to derive Active vs Revoked.
+       */
+      permissions: Array<string>;
+
+      /**
+       * Authoritative active/revoked flag (revoke keeps permissions for audit)
+       */
+      status: 'ACTIVE' | 'REVOKED';
+
+      /**
+       * When this delegation was last updated
+       */
+      updatedAt: string;
+    }
+
+    export namespace Attributes {
+      /**
+       * Transaction limits in cents
+       */
+      export interface Limits {
+        /**
+         * Positive per-transaction limit in cents. null means no per-payment limit.
+         */
+        perTransaction?: number | null;
+      }
+    }
+
+    /**
+     * Resource relationships
+     */
+    export interface Relationships {
+      /**
+       * Agent granted access
+       */
+      agent: Relationships.Agent;
+
+      /**
+       * Parent party delegation
+       */
+      delegation: Relationships.Delegation;
+
+      /**
+       * Developer party receiving access
+       */
+      delegateeParty?: Relationships.DelegateeParty;
+
+      /**
+       * Customer party granting access
+       */
+      delegatorParty?: Relationships.DelegatorParty;
+    }
+
+    export namespace Relationships {
+      /**
+       * Agent granted access
+       */
+      export interface Agent {
+        /**
+         * Related resource identifier
+         */
+        data: Agent.Data;
+      }
+
+      export namespace Agent {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Parent party delegation
+       */
+      export interface Delegation {
+        /**
+         * Related resource identifier
+         */
+        data: Delegation.Data;
+      }
+
+      export namespace Delegation {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Developer party receiving access
+       */
+      export interface DelegateeParty {
+        /**
+         * Related resource identifier
+         */
+        data: DelegateeParty.Data | null;
+      }
+
+      export namespace DelegateeParty {
+        /**
+         * Related resource identifier
+         */
+        export interface Data {
+          id: string;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+      }
+
+      /**
+       * Customer party granting access
+       */
+      export interface DelegatorParty {
+        /**
+         * Related resource identifier
+         */
+        data: DelegatorParty.Data | null;
+      }
+
+      export namespace DelegatorParty {
+        /**
+         * 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 DelegationGetAgentDelegationParams {
+  /**
+   * 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 interface DelegationListAgentDelegationsParams {
+  /**
+   * Query param: Filter by agent (agt_xxx)
+   */
+  agentId?: string;
+
+  /**
+   * Query param: Cursor for pagination
+   */
+  cursor?: string;
+
+  /**
+   * Query param: Filter to delegations where caller is the delegated party
+   * (developer)
+   */
+  delegateePartyId?: string;
+
+  /**
+   * Query param: Filter by parent delegation (dlg_xxx)
+   */
+  delegationId?: string;
+
+  /**
+   * Query param: Filter to delegations where caller is the delegating party
+   * (customer)
+   */
+  delegatorPartyId?: string;
+
+  /**
+   * Query param: Include revoked delegations
+   */
+  includeRevoked?: boolean | string;
+
+  /**
+   * Query param: Max items per page
+   */
+  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 declare namespace Delegations {
+  export {
+    type DelegationGetAgentDelegationResponse as DelegationGetAgentDelegationResponse,
+    type DelegationListAgentDelegationsResponse as DelegationListAgentDelegationsResponse,
+    type DelegationGetAgentDelegationParams as DelegationGetAgentDelegationParams,
+    type DelegationListAgentDelegationsParams as DelegationListAgentDelegationsParams,
+  };
+}

package/src/resources/index.ts

@@ -0,0 +1,95 @@
+// 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 {
+  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 WalletGetBalanceResponse,
+  type WalletGetDepositInstructionsResponse,
+  type WalletInitiateDepositResponse,
+  type WalletInitiateWithdrawalResponse,
+  type WalletListPaymentInstrumentsResponse,
+  type WalletRemovePaymentInstrumentResponse,
+  type WalletGetBalanceParams,
+  type WalletGetDepositInstructionsParams,
+  type WalletInitiateDepositParams,
+  type WalletInitiateWithdrawalParams,
+  type WalletListPaymentInstrumentsParams,
+  type WalletRemovePaymentInstrumentParams,
+} from './wallet';