@naturalpay/sdk 0.4.0 → 0.5.0

package/src/resources/customers.ts

@@ -4,13 +4,14 @@ 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';
 
 /**
  * Customer management
  */
 export class Customers extends APIResource {
   /**
-   * List active customers you can operate on behalf of.
+   * List all customer relationships across the current developer party's agents.
    */
   list(
     params: CustomerListParams | null | undefined = {},
@@ -31,16 +32,15 @@ export class Customers extends APIResource {
   }
 
   /**
-   * List the pending customer invitations you've sent — agent invitations grouped by
-   * recipient.
+   * Get a specific customer relationship visible to the current developer party.
    */
-  listInvitations(
-    params: CustomerListInvitationsParams | null | undefined = {},
+  get(
+    customerID: string,
+    params: CustomerGetParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<CustomerListInvitationsResponse> {
-    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID, ...query } = params ?? {};
-    return this._client.get('/customers/invitations', {
-      query,
+  ): APIPromise<CustomerGetResponse> {
+    const { 'X-Agent-ID': xAgentID, 'X-Instance-ID': xInstanceID } = params ?? {};
+    return this._client.get(path`/customers/${customerID}`, {
       ...options,
       headers: buildHeaders([
         {
@@ -74,6 +74,11 @@ export namespace CustomerListResponse {
      */
     attributes: Data.Attributes;
 
+    /**
+     * Resource relationships
+     */
+    relationships: Data.Relationships;
+
     /**
      * Resource type
      */
@@ -86,62 +91,160 @@ export namespace CustomerListResponse {
      */
     export interface Attributes {
       /**
-       * When the delegation was created
+       * When the customer party was created
        */
-      createdAt: string;
+      createdAt: string | null;
 
       /**
-       * Customer email, if known
+       * Primary email
        */
       email: string | null;
 
       /**
-       * Party info
+       * Display name, falling back to legal name when display name is unset
        */
-      party: Attributes.Party;
+      name: string;
+    }
 
+    /**
+     * Resource relationships
+     */
+    export interface Relationships {
       /**
-       * Granted permissions
+       * Per-agent access for this customer relationship
        */
-      permissions: Array<string>;
+      agents: Relationships.Agents;
 
       /**
-       * Status (ACTIVE, etc.)
+       * Delegation state for this customer relationship
        */
-      status: string;
+      delegation: Relationships.Delegation;
+    }
 
+    export namespace Relationships {
       /**
-       * Why walletAvailableMinor may be null: "granted" balance is fresh; "denied"
-       * caller lacks wallets.read; "noWallet" party has not provisioned a wallet.
+       * Per-agent access for this customer relationship
        */
-      walletAccess: 'granted' | 'denied' | 'noWallet';
+      export interface Agents {
+        /**
+         * Agents attached to this customer relationship
+         */
+        data: Array<Agents.Data>;
+      }
 
-      /**
-       * Available wallet balance in cents. Null when access is denied or no wallet
-       * exists — see walletAccess.
-       */
-      walletAvailableMinor: number | null;
-    }
+      export namespace Agents {
+        /**
+         * Embedded agent access details
+         */
+        export interface Data {
+          /**
+           * Agent handle (agt_xxx)
+           */
+          id: string;
+
+          /**
+           * Agent access attributes
+           */
+          attributes: Data.Attributes;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+
+        export namespace Data {
+          /**
+           * Agent access attributes
+           */
+          export interface Attributes {
+            /**
+             * Per-agent limits for this customer relationship
+             */
+            limits: Attributes.Limits | null;
+
+            /**
+             * Agent display name
+             */
+            name: string | null;
+
+            /**
+             * Permissions this agent has for the customer
+             */
+            permissions: Array<string>;
+
+            /**
+             * Agent-customer relationship status
+             */
+            status: string;
+          }
+
+          export namespace Attributes {
+            /**
+             * Per-agent limits for this customer relationship
+             */
+            export interface Limits {
+              /**
+               * Positive per-transaction limit in cents. null means no per-payment limit.
+               */
+              perTransaction?: number | null;
+            }
+          }
+        }
+      }
 
-    export namespace Attributes {
       /**
-       * Party info
+       * Delegation state for this customer relationship
        */
-      export interface Party {
+      export interface Delegation {
         /**
-         * Party handle (pty_xxx)
+         * Embedded customer delegation details
          */
-        id: string;
+        data: Delegation.Data;
+      }
 
+      export namespace Delegation {
         /**
-         * Primary email
+         * Embedded customer delegation details
          */
-        email: string | null;
+        export interface Data {
+          /**
+           * Delegation handle (dlg_xxx)
+           */
+          id: string;
 
-        /**
-         * Display name, falling back to legal name when display name is unset
-         */
-        name: string;
+          /**
+           * Delegation attributes
+           */
+          attributes: Data.Attributes;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+
+        export namespace Data {
+          /**
+           * Delegation attributes
+           */
+          export interface Attributes {
+            /**
+             * When the customer relationship was created
+             */
+            createdAt: string;
+
+            /**
+             * Permissions available across this customer
+             */
+            permissions: Array<string>;
+
+            /**
+             * Customer relationship status
+             */
+            status: string;
+          }
+        }
       }
     }
   }
@@ -159,21 +262,20 @@ export namespace CustomerListResponse {
   }
 }
 
-export interface CustomerListInvitationsResponse {
-  data: Array<CustomerListInvitationsResponse.Data>;
-
-  meta: CustomerListInvitationsResponse.Meta;
+export interface CustomerGetResponse {
+  /**
+   * Customer resource for an active customer (type='customer', id=pty_xxx).
+   */
+  data: CustomerGetResponse.Data;
 }
 
-export namespace CustomerListInvitationsResponse {
+export namespace CustomerGetResponse {
   /**
-   * A pending customer invitation (type='customerInvitation', id=recipient email) —
-   * a grouping of agent invitations sent to one recipient.
+   * Customer resource for an active customer (type='customer', id=pty_xxx).
    */
   export interface Data {
     /**
-     * Recipient email — the grouping key for the pending invitation. Stays the id even
-     * after the recipient creates an account.
+     * Customer party handle (pty_xxx)
      */
     id: string;
 
@@ -182,6 +284,11 @@ export namespace CustomerListInvitationsResponse {
      */
     attributes: Data.Attributes;
 
+    /**
+     * Resource relationships
+     */
+    relationships: Data.Relationships;
+
     /**
      * Resource type
      */
@@ -194,117 +301,161 @@ export namespace CustomerListInvitationsResponse {
      */
     export interface Attributes {
       /**
-       * Pending agent delegation invitations sent to this recipient
+       * When the customer party was created
        */
-      agentInvitations: Array<Attributes.AgentInvitation>;
+      createdAt: string | null;
 
       /**
-       * When the earliest agent invitation was created
+       * Primary email
        */
-      createdAt: string;
-
-      /**
-       * Recipient email — the grouping key
-       */
-      email: string;
+      email: string | null;
 
       /**
-       * Party info (null until the recipient creates an account)
+       * Display name, falling back to legal name when display name is unset
        */
-      party: Attributes.Party | null;
+      name: string;
+    }
 
+    /**
+     * Resource relationships
+     */
+    export interface Relationships {
       /**
-       * Status (always PENDING)
+       * Per-agent access for this customer relationship
        */
-      status: string;
+      agents: Relationships.Agents;
 
       /**
-       * Always 'denied' for pending customers
+       * Delegation state for this customer relationship
        */
-      walletAccess: 'granted' | 'denied' | 'noWallet';
+      delegation: Relationships.Delegation;
+    }
 
+    export namespace Relationships {
       /**
-       * Always null for pending customers
+       * Per-agent access for this customer relationship
        */
-      walletAvailableMinor: number | null;
-    }
-
-    export namespace Attributes {
-      export 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;
-
+      export interface Agents {
         /**
-         * Permissions the invitation requests
+         * Agents attached to this customer relationship
          */
-        permissions: Array<string>;
+        data: Array<Agents.Data>;
       }
 
-      export namespace AgentInvitation {
+      export namespace Agents {
         /**
-         * Agent the invitation targets
+         * Embedded agent access details
          */
-        export interface Agent {
+        export interface Data {
           /**
            * Agent handle (agt_xxx)
            */
           id: string;
 
           /**
-           * Agent display name
+           * Agent access attributes
+           */
+          attributes: Data.Attributes;
+
+          /**
+           * Resource type
+           */
+          type: string;
+        }
+
+        export namespace Data {
+          /**
+           * Agent access attributes
            */
-          name: string | null;
+          export interface Attributes {
+            /**
+             * Per-agent limits for this customer relationship
+             */
+            limits: Attributes.Limits | null;
+
+            /**
+             * Agent display name
+             */
+            name: string | null;
+
+            /**
+             * Permissions this agent has for the customer
+             */
+            permissions: Array<string>;
+
+            /**
+             * Agent-customer relationship status
+             */
+            status: string;
+          }
+
+          export namespace Attributes {
+            /**
+             * Per-agent limits for this customer relationship
+             */
+            export interface Limits {
+              /**
+               * Positive per-transaction limit in cents. null means no per-payment limit.
+               */
+              perTransaction?: number | null;
+            }
+          }
         }
       }
 
       /**
-       * Party info (null until the recipient creates an account)
+       * Delegation state for this customer relationship
        */
-      export interface Party {
+      export interface Delegation {
         /**
-         * Party handle (pty_xxx)
+         * Embedded customer delegation details
          */
-        id: string;
-
-        /**
-         * Primary email
-         */
-        email: string | null;
+        data: Delegation.Data;
+      }
 
+      export namespace Delegation {
         /**
-         * Display name, falling back to legal name when display name is unset
+         * Embedded customer delegation details
          */
-        name: string;
-      }
-    }
-  }
+        export interface Data {
+          /**
+           * Delegation handle (dlg_xxx)
+           */
+          id: string;
 
-  export interface Meta {
-    pagination: Meta.Pagination;
-  }
+          /**
+           * Delegation attributes
+           */
+          attributes: Data.Attributes;
 
-  export namespace Meta {
-    export interface Pagination {
-      hasMore: boolean;
+          /**
+           * Resource type
+           */
+          type: string;
+        }
 
-      nextCursor: string | null;
+        export namespace Data {
+          /**
+           * Delegation attributes
+           */
+          export interface Attributes {
+            /**
+             * When the customer relationship was created
+             */
+            createdAt: string;
+
+            /**
+             * Permissions available across this customer
+             */
+            permissions: Array<string>;
+
+            /**
+             * Customer relationship status
+             */
+            status: string;
+          }
+        }
+      }
     }
   }
 }
@@ -332,25 +483,15 @@ export interface CustomerListParams {
   'X-Instance-ID'?: string;
 }
 
-export interface CustomerListInvitationsParams {
-  /**
-   * Query param: Cursor for pagination
-   */
-  cursor?: string;
-
+export interface CustomerGetParams {
   /**
-   * Query param: Maximum number of results
-   */
-  limit?: number;
-
-  /**
-   * Header param: Agent ID (agt_xxx) identifying which agent is making the request.
+   * 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.
+   * Required when X-Agent-ID is present. Session or conversation ID for agent
+   * observability.
    */
   'X-Instance-ID'?: string;
 }
@@ -358,8 +499,8 @@ export interface CustomerListInvitationsParams {
 export declare namespace Customers {
   export {
     type CustomerListResponse as CustomerListResponse,
-    type CustomerListInvitationsResponse as CustomerListInvitationsResponse,
+    type CustomerGetResponse as CustomerGetResponse,
     type CustomerListParams as CustomerListParams,
-    type CustomerListInvitationsParams as CustomerListInvitationsParams,
+    type CustomerGetParams as CustomerGetParams,
   };
 }

package/src/resources/index.ts

@@ -16,44 +16,30 @@ export {
   type AgentCreateResponse,
   type AgentUpdateResponse,
   type AgentListResponse,
-  type AgentCreateInvitationsResponse,
+  type AgentCreateCustomerResponse,
   type AgentGetResponse,
-  type AgentListInvitationsForDeveloperResponse,
+  type AgentGetCustomerResponse,
+  type AgentListCustomersResponse,
   type AgentRemoveResponse,
+  type AgentRemoveCustomerResponse,
   type AgentCreateParams,
   type AgentUpdateParams,
   type AgentListParams,
-  type AgentCreateInvitationsParams,
+  type AgentCreateCustomerParams,
   type AgentGetParams,
-  type AgentListInvitationsForDeveloperParams,
+  type AgentGetCustomerParams,
+  type AgentListCustomersParams,
   type AgentRemoveParams,
+  type AgentRemoveCustomerParams,
 } from './agents';
 export { Counterparties, type CounterpartyListResponse, type CounterpartyListParams } from './counterparties';
 export {
   Customers,
   type CustomerListResponse,
-  type CustomerListInvitationsResponse,
+  type CustomerGetResponse,
   type CustomerListParams,
-  type CustomerListInvitationsParams,
+  type CustomerGetParams,
 } from './customers';
-export {
-  Delegations,
-  type DelegationGetAgentDelegationResponse,
-  type DelegationListAgentDelegationsResponse,
-  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,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.4.0'; // x-release-please-version
+export const VERSION = '0.5.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.4.0";
+export declare const VERSION = "0.5.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.4.0";
+export declare const VERSION = "0.5.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.4.0'; // x-release-please-version
+exports.VERSION = '0.5.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.4.0'; // x-release-please-version
+export const VERSION = '0.5.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map

package/internal/qs/formats.d.mts

@@ -1,7 +0,0 @@
-import type { Format } from "./types.mjs";
-export declare const default_format: Format;
-export declare const default_formatter: (v: PropertyKey) => string;
-export declare const formatters: Record<Format, (str: PropertyKey) => string>;
-export declare const RFC1738 = "RFC1738";
-export declare const RFC3986 = "RFC3986";
-//# sourceMappingURL=formats.d.mts.map

package/internal/qs/formats.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"formats.d.mts","sourceRoot":"","sources":["../../src/internal/qs/formats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,oBAAgB;AAEtC,eAAO,MAAM,cAAc,EAAE,MAAkB,CAAC;AAChD,eAAO,MAAM,iBAAiB,GAAI,GAAG,WAAW,WAAc,CAAC;AAC/D,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,MAAM,CAGnE,CAAC;AACF,eAAO,MAAM,OAAO,YAAY,CAAC;AACjC,eAAO,MAAM,OAAO,YAAY,CAAC"}

package/internal/qs/formats.d.ts

@@ -1,7 +0,0 @@
-import type { Format } from "./types.js";
-export declare const default_format: Format;
-export declare const default_formatter: (v: PropertyKey) => string;
-export declare const formatters: Record<Format, (str: PropertyKey) => string>;
-export declare const RFC1738 = "RFC1738";
-export declare const RFC3986 = "RFC3986";
-//# sourceMappingURL=formats.d.ts.map

package/internal/qs/formats.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../src/internal/qs/formats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,mBAAgB;AAEtC,eAAO,MAAM,cAAc,EAAE,MAAkB,CAAC;AAChD,eAAO,MAAM,iBAAiB,GAAI,GAAG,WAAW,WAAc,CAAC;AAC/D,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,MAAM,CAGnE,CAAC;AACF,eAAO,MAAM,OAAO,YAAY,CAAC;AACjC,eAAO,MAAM,OAAO,YAAY,CAAC"}

package/internal/qs/formats.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RFC3986 = exports.RFC1738 = exports.formatters = exports.default_formatter = exports.default_format = void 0;
-exports.default_format = 'RFC3986';
-const default_formatter = (v) => String(v);
-exports.default_formatter = default_formatter;
-exports.formatters = {
-    RFC1738: (v) => String(v).replace(/%20/g, '+'),
-    RFC3986: exports.default_formatter,
-};
-exports.RFC1738 = 'RFC1738';
-exports.RFC3986 = 'RFC3986';
-//# sourceMappingURL=formats.js.map

package/internal/qs/formats.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"formats.js","sourceRoot":"","sources":["../../src/internal/qs/formats.ts"],"names":[],"mappings":";;;AAEa,QAAA,cAAc,GAAW,SAAS,CAAC;AACzC,MAAM,iBAAiB,GAAG,CAAC,CAAc,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAAlD,QAAA,iBAAiB,qBAAiC;AAClD,QAAA,UAAU,GAAiD;IACtE,OAAO,EAAE,CAAC,CAAc,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;IAC3D,OAAO,EAAE,yBAAiB;CAC3B,CAAC;AACW,QAAA,OAAO,GAAG,SAAS,CAAC;AACpB,QAAA,OAAO,GAAG,SAAS,CAAC"}