@naturalpay/sdk 0.2.0 → 0.3.0

package/resources/customers.d.ts

@@ -0,0 +1,272 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+/**
+ * Customer management
+ */
+export declare class Customers extends APIResource {
+    /**
+     * List active customers you can operate on behalf of.
+     */
+    list(params?: CustomerListParams | null | undefined, options?: RequestOptions): APIPromise<CustomerListResponse>;
+    /**
+     * List the pending customer invitations you've sent — agent invitations grouped by
+     * recipient.
+     */
+    listInvitations(params?: CustomerListInvitationsParams | null | undefined, options?: RequestOptions): APIPromise<CustomerListInvitationsResponse>;
+}
+export interface CustomerListResponse {
+    data: Array<CustomerListResponse.Data>;
+    meta: CustomerListResponse.Meta;
+}
+export declare namespace CustomerListResponse {
+    /**
+     * Customer resource for an active customer (type='customer', id=pty_xxx).
+     */
+    interface Data {
+        /**
+         * Customer party handle (pty_xxx)
+         */
+        id: string;
+        /**
+         * Resource attributes
+         */
+        attributes: Data.Attributes;
+        /**
+         * Resource type
+         */
+        type: string;
+    }
+    namespace Data {
+        /**
+         * Resource attributes
+         */
+        interface Attributes {
+            /**
+             * When the delegation was created
+             */
+            createdAt: string;
+            /**
+             * Customer email, if known
+             */
+            email: string | null;
+            /**
+             * Party info
+             */
+            party: Attributes.Party;
+            /**
+             * Granted permissions
+             */
+            permissions: Array<string>;
+            /**
+             * Status (ACTIVE, etc.)
+             */
+            status: string;
+            /**
+             * Why walletAvailableMinor may be null: "granted" balance is fresh; "denied"
+             * caller lacks wallets.read; "noWallet" party has not provisioned a wallet.
+             */
+            walletAccess: 'granted' | 'denied' | 'noWallet';
+            /**
+             * Available wallet balance in cents. Null when access is denied or no wallet
+             * exists — see walletAccess.
+             */
+            walletAvailableMinor: number | null;
+        }
+        namespace Attributes {
+            /**
+             * Party info
+             */
+            interface Party {
+                /**
+                 * Party handle (pty_xxx)
+                 */
+                id: string;
+                /**
+                 * Primary email
+                 */
+                email: string | null;
+                /**
+                 * Display name, falling back to legal name when display name is unset
+                 */
+                name: string;
+            }
+        }
+    }
+    interface Meta {
+        pagination: Meta.Pagination;
+    }
+    namespace Meta {
+        interface Pagination {
+            hasMore: boolean;
+            nextCursor: string | null;
+        }
+    }
+}
+export interface CustomerListInvitationsResponse {
+    data: Array<CustomerListInvitationsResponse.Data>;
+    meta: CustomerListInvitationsResponse.Meta;
+}
+export declare namespace CustomerListInvitationsResponse {
+    /**
+     * A pending customer invitation (type='customerInvitation', id=recipient email) —
+     * a grouping of agent invitations sent to one recipient.
+     */
+    interface Data {
+        /**
+         * Recipient email — the grouping key for the pending invitation. Stays the id even
+         * after the recipient creates an account.
+         */
+        id: string;
+        /**
+         * Resource attributes
+         */
+        attributes: Data.Attributes;
+        /**
+         * Resource type
+         */
+        type: string;
+    }
+    namespace Data {
+        /**
+         * Resource attributes
+         */
+        interface Attributes {
+            /**
+             * Pending agent delegation invitations sent to this recipient
+             */
+            agentInvitations: Array<Attributes.AgentInvitation>;
+            /**
+             * When the earliest agent invitation was created
+             */
+            createdAt: string;
+            /**
+             * Recipient email — the grouping key
+             */
+            email: string;
+            /**
+             * Party info (null until the recipient creates an account)
+             */
+            party: Attributes.Party | null;
+            /**
+             * Status (always PENDING)
+             */
+            status: string;
+            /**
+             * Always 'denied' for pending customers
+             */
+            walletAccess: 'granted' | 'denied' | 'noWallet';
+            /**
+             * Always null for pending customers
+             */
+            walletAvailableMinor: number | null;
+        }
+        namespace Attributes {
+            interface AgentInvitation {
+                /**
+                 * Agent the invitation targets
+                 */
+                agent: AgentInvitation.Agent;
+                /**
+                 * When the agent invitation was created
+                 */
+                createdAt: string;
+                /**
+                 * When the agent invitation expires (null if it does not expire)
+                 */
+                expiresAt: string | null;
+                /**
+                 * Agent delegation invitation handle (adi_xxx)
+                 */
+                invitationId: string;
+                /**
+                 * Permissions the invitation requests
+                 */
+                permissions: Array<string>;
+            }
+            namespace AgentInvitation {
+                /**
+                 * Agent the invitation targets
+                 */
+                interface Agent {
+                    /**
+                     * Agent handle (agt_xxx)
+                     */
+                    id: string;
+                    /**
+                     * Agent display name
+                     */
+                    name: string | null;
+                }
+            }
+            /**
+             * Party info (null until the recipient creates an account)
+             */
+            interface Party {
+                /**
+                 * Party handle (pty_xxx)
+                 */
+                id: string;
+                /**
+                 * Primary email
+                 */
+                email: string | null;
+                /**
+                 * Display name, falling back to legal name when display name is unset
+                 */
+                name: string;
+            }
+        }
+    }
+    interface Meta {
+        pagination: Meta.Pagination;
+    }
+    namespace Meta {
+        interface Pagination {
+            hasMore: boolean;
+            nextCursor: string | null;
+        }
+    }
+}
+export interface CustomerListParams {
+    /**
+     * Query param: Cursor for pagination
+     */
+    cursor?: string;
+    /**
+     * Query param: Maximum number of results
+     */
+    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 CustomerListInvitationsParams {
+    /**
+     * Query param: Cursor for pagination
+     */
+    cursor?: string;
+    /**
+     * Query param: Maximum number of results
+     */
+    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 Customers {
+    export { type CustomerListResponse as CustomerListResponse, type CustomerListInvitationsResponse as CustomerListInvitationsResponse, type CustomerListParams as CustomerListParams, type CustomerListInvitationsParams as CustomerListInvitationsParams, };
+}
+//# sourceMappingURL=customers.d.ts.map

package/resources/customers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.d.ts","sourceRoot":"","sources":["../src/resources/customers.ts"],"names":[],"mappings":"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"}

package/resources/customers.js

@@ -0,0 +1,48 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Customers = void 0;
+const resource_1 = require("../core/resource.js");
+const headers_1 = require("../internal/headers.js");
+/**
+ * Customer management
+ */
+class Customers extends resource_1.APIResource {
+    /**
+     * List active customers you can operate on behalf of.
+     */
+    list(params = {}, options) {
+        const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
+        return this._client.get('/customers', {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                {
+                    ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+                    ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * List the pending customer invitations you've sent — agent invitations grouped by
+     * recipient.
+     */
+    listInvitations(params = {}, options) {
+        const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
+        return this._client.get('/customers/invitations', {
+            query,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                {
+                    ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+                    ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.Customers = Customers;
+//# sourceMappingURL=customers.js.map

package/resources/customers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.js","sourceRoot":"","sources":["../src/resources/customers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,oDAAmD;AAGnD;;GAEG;AACH,MAAa,SAAU,SAAQ,sBAAW;IACxC;;OAEG;IACH,IAAI,CACF,SAAgD,EAAE,EAClD,OAAwB;QAExB,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACxF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE;YACpC,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB;oBACE,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC9D,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;iBACxE;gBACD,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,eAAe,CACb,SAA2D,EAAE,EAC7D,OAAwB;QAExB,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACxF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE;YAChD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB;oBACE,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC9D,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;iBACxE;gBACD,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF;AA3CD,8BA2CC"}

package/resources/customers.mjs

@@ -0,0 +1,44 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { buildHeaders } from "../internal/headers.mjs";
+/**
+ * Customer management
+ */
+export class Customers extends APIResource {
+    /**
+     * List active customers you can operate on behalf of.
+     */
+    list(params = {}, options) {
+        const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
+        return this._client.get('/customers', {
+            query,
+            ...options,
+            headers: buildHeaders([
+                {
+                    ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+                    ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * List the pending customer invitations you've sent — agent invitations grouped by
+     * recipient.
+     */
+    listInvitations(params = {}, options) {
+        const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
+        return this._client.get('/customers/invitations', {
+            query,
+            ...options,
+            headers: buildHeaders([
+                {
+                    ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+                    ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+}
+//# sourceMappingURL=customers.mjs.map

package/resources/customers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.mjs","sourceRoot":"","sources":["../src/resources/customers.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAE/C,OAAO,EAAE,YAAY,EAAE,gCAA4B;AAGnD;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,WAAW;IACxC;;OAEG;IACH,IAAI,CACF,SAAgD,EAAE,EAClD,OAAwB;QAExB,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACxF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE;YACpC,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB;oBACE,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC9D,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;iBACxE;gBACD,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,eAAe,CACb,SAA2D,EAAE,EAC7D,OAAwB;QAExB,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QACxF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE;YAChD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB;oBACE,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC9D,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;iBACxE;gBACD,OAAO,EAAE,OAAO;aACjB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF"}