@naturalpay/sdk 0.2.0 → 0.2.1

package/resources/payments.d.mts

@@ -0,0 +1,174 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+/**
+ * Payment and transaction operations
+ */
+export declare class Payments extends APIResource {
+    /**
+     * Create a payment with delegation validation and limit enforcement.
+     *
+     * @example
+     * ```ts
+     * const payment = await client.payments.create({
+     *   amount: 1,
+     *   counterparty: 'counterparty',
+     *   'Idempotency-Key': 'Idempotency-Key',
+     * });
+     * ```
+     */
+    create(params: PaymentCreateParams, options?: RequestOptions): APIPromise<PaymentCreateResponse>;
+}
+export interface PaymentCreateResponse {
+    data: PaymentCreateResponse.Data;
+}
+export declare namespace PaymentCreateResponse {
+    interface Data {
+        /**
+         * Resource ID
+         */
+        id: string;
+        /**
+         * Resource attributes
+         */
+        attributes: Data.Attributes;
+        /**
+         * Resource relationships
+         */
+        relationships: Data.Relationships;
+        type: string;
+    }
+    namespace Data {
+        /**
+         * Resource attributes
+         */
+        interface Attributes {
+            /**
+             * Amount in cents
+             */
+            amount: number;
+            /**
+             * Claim link for unclaimed payments
+             */
+            claimLink: string | null;
+            /**
+             * When this payment was created
+             */
+            createdAt: string;
+            /**
+             * Currency code
+             */
+            currency: string;
+            /**
+             * Payment description
+             */
+            description: string | null;
+            /**
+             * Payment status
+             */
+            status: 'PROCESSING' | 'PENDING_CLAIM' | 'IN_REVIEW' | 'COMPLETED' | 'FAILED' | 'CANCELLED';
+            /**
+             * When this payment was last updated
+             */
+            updatedAt: string;
+        }
+        /**
+         * Resource relationships
+         */
+        interface Relationships {
+            /**
+             * Party receiving the payment
+             */
+            counterparty: Relationships.Counterparty;
+            /**
+             * Party that made the payment
+             */
+            customerParty: Relationships.CustomerParty;
+        }
+        namespace Relationships {
+            /**
+             * Party receiving the payment
+             */
+            interface Counterparty {
+                /**
+                 * Related resource identifier
+                 */
+                data: Counterparty.Data | null;
+            }
+            namespace Counterparty {
+                /**
+                 * Related resource identifier
+                 */
+                interface Data {
+                    id: string;
+                    /**
+                     * Resource type
+                     */
+                    type: string;
+                }
+            }
+            /**
+             * Party that made the payment
+             */
+            interface CustomerParty {
+                /**
+                 * Related resource identifier
+                 */
+                data: CustomerParty.Data;
+            }
+            namespace CustomerParty {
+                /**
+                 * Related resource identifier
+                 */
+                interface Data {
+                    id: string;
+                    /**
+                     * Resource type
+                     */
+                    type: string;
+                }
+            }
+        }
+    }
+}
+export interface PaymentCreateParams {
+    /**
+     * Body param: Amount in cents
+     */
+    amount: number;
+    /**
+     * Body param: Recipient: party ID (pty\_\*), email, or phone
+     */
+    counterparty: string;
+    /**
+     * Header param: Unique key for idempotent request handling. If a request with the
+     * same key was already processed, the original response is returned.
+     */
+    'Idempotency-Key': string;
+    /**
+     * Body param: Currency code
+     */
+    currency?: 'USD';
+    /**
+     * Body param: Sender party ID (pty\_\*). Omit to send from your own wallet;
+     * provide for delegated payments on behalf of a customer.
+     */
+    customerPartyId?: string;
+    /**
+     * Body param: Payment description
+     */
+    description?: string;
+    /**
+     * 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 Payments {
+    export { type PaymentCreateResponse as PaymentCreateResponse, type PaymentCreateParams as PaymentCreateParams, };
+}
+//# sourceMappingURL=payments.d.mts.map

package/resources/payments.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.mts","sourceRoot":"","sources":["../src/resources/payments.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAEzB;;GAEG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;CAoBjG;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC;CAClC;AAED,yBAAiB,qBAAqB,CAAC;IACrC,UAAiB,IAAI;QACnB;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;WAEG;QACH,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC;QAE5B;;WAEG;QACH,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC;QAElC,IAAI,EAAE,MAAM,CAAC;KACd;IAED,UAAiB,IAAI,CAAC;QACpB;;WAEG;QACH,UAAiB,UAAU;YACzB;;eAEG;YACH,MAAM,EAAE,MAAM,CAAC;YAEf;;eAEG;YACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;YAEzB;;eAEG;YACH,SAAS,EAAE,MAAM,CAAC;YAElB;;eAEG;YACH,QAAQ,EAAE,MAAM,CAAC;YAEjB;;eAEG;YACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;YAE3B;;eAEG;YACH,MAAM,EAAE,YAAY,GAAG,eAAe,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;YAE5F;;eAEG;YACH,SAAS,EAAE,MAAM,CAAC;SACnB;QAED;;WAEG;QACH,UAAiB,aAAa;YAC5B;;eAEG;YACH,YAAY,EAAE,aAAa,CAAC,YAAY,CAAC;YAEzC;;eAEG;YACH,aAAa,EAAE,aAAa,CAAC,aAAa,CAAC;SAC5C;QAED,UAAiB,aAAa,CAAC;YAC7B;;eAEG;YACH,UAAiB,YAAY;gBAC3B;;mBAEG;gBACH,IAAI,EAAE,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC;aAChC;YAED,UAAiB,YAAY,CAAC;gBAC5B;;mBAEG;gBACH,UAAiB,IAAI;oBACnB,EAAE,EAAE,MAAM,CAAC;oBAEX;;uBAEG;oBACH,IAAI,EAAE,MAAM,CAAC;iBACd;aACF;YAED;;eAEG;YACH,UAAiB,aAAa;gBAC5B;;mBAEG;gBACH,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;aAC1B;YAED,UAAiB,aAAa,CAAC;gBAC7B;;mBAEG;gBACH,UAAiB,IAAI;oBACnB,EAAE,EAAE,MAAM,CAAC;oBAEX;;uBAEG;oBACH,IAAI,EAAE,MAAM,CAAC;iBACd;aACF;SACF;KACF;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC;IAEjB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/payments.d.ts

@@ -0,0 +1,174 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+/**
+ * Payment and transaction operations
+ */
+export declare class Payments extends APIResource {
+    /**
+     * Create a payment with delegation validation and limit enforcement.
+     *
+     * @example
+     * ```ts
+     * const payment = await client.payments.create({
+     *   amount: 1,
+     *   counterparty: 'counterparty',
+     *   'Idempotency-Key': 'Idempotency-Key',
+     * });
+     * ```
+     */
+    create(params: PaymentCreateParams, options?: RequestOptions): APIPromise<PaymentCreateResponse>;
+}
+export interface PaymentCreateResponse {
+    data: PaymentCreateResponse.Data;
+}
+export declare namespace PaymentCreateResponse {
+    interface Data {
+        /**
+         * Resource ID
+         */
+        id: string;
+        /**
+         * Resource attributes
+         */
+        attributes: Data.Attributes;
+        /**
+         * Resource relationships
+         */
+        relationships: Data.Relationships;
+        type: string;
+    }
+    namespace Data {
+        /**
+         * Resource attributes
+         */
+        interface Attributes {
+            /**
+             * Amount in cents
+             */
+            amount: number;
+            /**
+             * Claim link for unclaimed payments
+             */
+            claimLink: string | null;
+            /**
+             * When this payment was created
+             */
+            createdAt: string;
+            /**
+             * Currency code
+             */
+            currency: string;
+            /**
+             * Payment description
+             */
+            description: string | null;
+            /**
+             * Payment status
+             */
+            status: 'PROCESSING' | 'PENDING_CLAIM' | 'IN_REVIEW' | 'COMPLETED' | 'FAILED' | 'CANCELLED';
+            /**
+             * When this payment was last updated
+             */
+            updatedAt: string;
+        }
+        /**
+         * Resource relationships
+         */
+        interface Relationships {
+            /**
+             * Party receiving the payment
+             */
+            counterparty: Relationships.Counterparty;
+            /**
+             * Party that made the payment
+             */
+            customerParty: Relationships.CustomerParty;
+        }
+        namespace Relationships {
+            /**
+             * Party receiving the payment
+             */
+            interface Counterparty {
+                /**
+                 * Related resource identifier
+                 */
+                data: Counterparty.Data | null;
+            }
+            namespace Counterparty {
+                /**
+                 * Related resource identifier
+                 */
+                interface Data {
+                    id: string;
+                    /**
+                     * Resource type
+                     */
+                    type: string;
+                }
+            }
+            /**
+             * Party that made the payment
+             */
+            interface CustomerParty {
+                /**
+                 * Related resource identifier
+                 */
+                data: CustomerParty.Data;
+            }
+            namespace CustomerParty {
+                /**
+                 * Related resource identifier
+                 */
+                interface Data {
+                    id: string;
+                    /**
+                     * Resource type
+                     */
+                    type: string;
+                }
+            }
+        }
+    }
+}
+export interface PaymentCreateParams {
+    /**
+     * Body param: Amount in cents
+     */
+    amount: number;
+    /**
+     * Body param: Recipient: party ID (pty\_\*), email, or phone
+     */
+    counterparty: string;
+    /**
+     * Header param: Unique key for idempotent request handling. If a request with the
+     * same key was already processed, the original response is returned.
+     */
+    'Idempotency-Key': string;
+    /**
+     * Body param: Currency code
+     */
+    currency?: 'USD';
+    /**
+     * Body param: Sender party ID (pty\_\*). Omit to send from your own wallet;
+     * provide for delegated payments on behalf of a customer.
+     */
+    customerPartyId?: string;
+    /**
+     * Body param: Payment description
+     */
+    description?: string;
+    /**
+     * 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 Payments {
+    export { type PaymentCreateResponse as PaymentCreateResponse, type PaymentCreateParams as PaymentCreateParams, };
+}
+//# sourceMappingURL=payments.d.ts.map

package/resources/payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../src/resources/payments.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OAEd,EAAE,cAAc,EAAE;AAEzB;;GAEG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;CAoBjG;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC;CAClC;AAED,yBAAiB,qBAAqB,CAAC;IACrC,UAAiB,IAAI;QACnB;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;WAEG;QACH,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC;QAE5B;;WAEG;QACH,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC;QAElC,IAAI,EAAE,MAAM,CAAC;KACd;IAED,UAAiB,IAAI,CAAC;QACpB;;WAEG;QACH,UAAiB,UAAU;YACzB;;eAEG;YACH,MAAM,EAAE,MAAM,CAAC;YAEf;;eAEG;YACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;YAEzB;;eAEG;YACH,SAAS,EAAE,MAAM,CAAC;YAElB;;eAEG;YACH,QAAQ,EAAE,MAAM,CAAC;YAEjB;;eAEG;YACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;YAE3B;;eAEG;YACH,MAAM,EAAE,YAAY,GAAG,eAAe,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;YAE5F;;eAEG;YACH,SAAS,EAAE,MAAM,CAAC;SACnB;QAED;;WAEG;QACH,UAAiB,aAAa;YAC5B;;eAEG;YACH,YAAY,EAAE,aAAa,CAAC,YAAY,CAAC;YAEzC;;eAEG;YACH,aAAa,EAAE,aAAa,CAAC,aAAa,CAAC;SAC5C;QAED,UAAiB,aAAa,CAAC;YAC7B;;eAEG;YACH,UAAiB,YAAY;gBAC3B;;mBAEG;gBACH,IAAI,EAAE,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC;aAChC;YAED,UAAiB,YAAY,CAAC;gBAC5B;;mBAEG;gBACH,UAAiB,IAAI;oBACnB,EAAE,EAAE,MAAM,CAAC;oBAEX;;uBAEG;oBACH,IAAI,EAAE,MAAM,CAAC;iBACd;aACF;YAED;;eAEG;YACH,UAAiB,aAAa;gBAC5B;;mBAEG;gBACH,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;aAC1B;YAED,UAAiB,aAAa,CAAC;gBAC7B;;mBAEG;gBACH,UAAiB,IAAI;oBACnB,EAAE,EAAE,MAAM,CAAC;oBAEX;;uBAEG;oBACH,IAAI,EAAE,MAAM,CAAC;iBACd;aACF;SACF;KACF;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC;IAEjB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/payments.js

@@ -0,0 +1,40 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Payments = void 0;
+const resource_1 = require("../core/resource.js");
+const headers_1 = require("../internal/headers.js");
+/**
+ * Payment and transaction operations
+ */
+class Payments extends resource_1.APIResource {
+    /**
+     * Create a payment with delegation validation and limit enforcement.
+     *
+     * @example
+     * ```ts
+     * const payment = await client.payments.create({
+     *   amount: 1,
+     *   counterparty: 'counterparty',
+     *   'Idempotency-Key': 'Idempotency-Key',
+     * });
+     * ```
+     */
+    create(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...body } = params;
+        return this._client.post('/payments', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                {
+                    'Idempotency-Key': idempotencyKey,
+                    ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+                    ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+}
+exports.Payments = Payments;
+//# sourceMappingURL=payments.js.map

package/resources/payments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.js","sourceRoot":"","sources":["../src/resources/payments.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,oDAAmD;AAGnD;;GAEG;AACH,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAA2B,EAAE,OAAwB;QAC1D,MAAM,EACJ,iBAAiB,EAAE,cAAc,EACjC,YAAY,EAAE,QAAQ,EACtB,eAAe,EAAE,WAAW,EAC5B,GAAG,IAAI,EACR,GAAG,MAAM,CAAC;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE;YACpC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC;gBACpB;oBACE,iBAAiB,EAAE,cAAc;oBACjC,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;AAjCD,4BAiCC"}

package/resources/payments.mjs

@@ -0,0 +1,36 @@
+// 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";
+/**
+ * Payment and transaction operations
+ */
+export class Payments extends APIResource {
+    /**
+     * Create a payment with delegation validation and limit enforcement.
+     *
+     * @example
+     * ```ts
+     * const payment = await client.payments.create({
+     *   amount: 1,
+     *   counterparty: 'counterparty',
+     *   'Idempotency-Key': 'Idempotency-Key',
+     * });
+     * ```
+     */
+    create(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...body } = params;
+        return this._client.post('/payments', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                {
+                    'Idempotency-Key': idempotencyKey,
+                    ...(xAgentID != null ? { 'X-Agent-ID': xAgentID } : undefined),
+                    ...(xInstanceID != null ? { 'X-Instance-ID': xInstanceID } : undefined),
+                },
+                options?.headers,
+            ]),
+        });
+    }
+}
+//# sourceMappingURL=payments.mjs.map

package/resources/payments.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.mjs","sourceRoot":"","sources":["../src/resources/payments.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,YAAY,EAAE;AAGvB;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAA2B,EAAE,OAAwB;QAC1D,MAAM,EACJ,iBAAiB,EAAE,cAAc,EACjC,YAAY,EAAE,QAAQ,EACtB,eAAe,EAAE,WAAW,EAC5B,GAAG,IAAI,EACR,GAAG,MAAM,CAAC;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE;YACpC,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC;gBACpB;oBACE,iBAAiB,EAAE,cAAc;oBACjC,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"}