@naturalpay/sdk 0.0.2 → 0.0.4

package/dist/index.cjs

@@ -585,6 +585,32 @@ var BaseResource = class {
 
 // src/resources/payments.ts
 var IDEMPOTENCY_WINDOW_SECONDS = 300;
+function unwrapPayment(response) {
+  if (!response?.data) {
+    throw new NaturalError('Unexpected response format: missing "data" field in payment response');
+  }
+  const { data } = response;
+  if (data.type !== "payment" || !data.attributes) {
+    throw new NaturalError(
+      `Unexpected resource format: expected type "payment", got "${data.type}"`
+    );
+  }
+  const { id, attributes, relationships } = data;
+  const description = attributes.description != null ? String(attributes.description) : void 0;
+  return {
+    transferId: id,
+    status: String(attributes.status),
+    amount: String(attributes.amount),
+    currency: String(attributes.currency),
+    description,
+    memo: description,
+    createdAt: attributes.createdAt != null ? String(attributes.createdAt) : void 0,
+    updatedAt: attributes.updatedAt != null ? String(attributes.updatedAt) : void 0,
+    claimLink: attributes.claimLink != null ? String(attributes.claimLink) : void 0,
+    counterpartyPartyId: relationships?.counterparty?.data?.id,
+    customerPartyId: relationships?.customerParty?.data?.id
+  };
+}
 var PaymentsResource = class extends BaseResource {
   /**
    * Generate idempotency key based on payment details + time window.
@@ -615,20 +641,19 @@ var PaymentsResource = class extends BaseResource {
     }
     const recipient = params.recipientEmail ?? params.recipientPhone ?? params.recipientPartyId;
     const idempotencyKey = params.idempotencyKey ?? this.generateIdempotencyKey(recipient, params.amount, params.memo);
-    const body = {
-      amount: params.amount
+    const attributes = {
+      amount: String(params.amount),
+      currency: "USD",
+      counterparty: recipient,
+      customerPartyId: params.customerPartyId
     };
-    if (params.recipientEmail) body["recipientEmail"] = params.recipientEmail;
-    if (params.recipientPhone) body["recipientPhone"] = params.recipientPhone;
-    if (params.recipientPartyId) body["recipientPartyId"] = params.recipientPartyId;
-    if (params.memo) body["memo"] = params.memo;
-    if (params.agentId) body["agentId"] = params.agentId;
-    if (params.customerPartyId) body["customerPartyId"] = params.customerPartyId;
-    if (params.instanceId) body["instanceId"] = params.instanceId;
-    return this.http.post("/payments/initiate", {
+    if (params.memo) attributes["description"] = params.memo;
+    const body = { data: { attributes } };
+    const response = await this.http.post("/payments", {
       body,
       headers: { "Idempotency-Key": idempotencyKey }
     });
+    return unwrapPayment(response);
   }
   /**
    * Get payment status by transfer ID.
@@ -637,20 +662,83 @@ var PaymentsResource = class extends BaseResource {
    * @returns Payment object with current status
    */
   async retrieve(transferId) {
-    return this.http.get(`/payments/${transferId}`);
-  }
-  /**
-   * Cancel a pending payment.
-   *
-   * @param transferId - The transfer ID to cancel
-   * @returns Cancellation result with status and message
-   */
-  async cancel(transferId) {
-    return this.http.post(`/payments/${transferId}/cancel`);
+    const response = await this.http.get(`/payments/${transferId}`);
+    return unwrapPayment(response);
   }
 };
 
 // src/resources/wallet.ts
+function unwrapBalance(response) {
+  if (!response?.data) {
+    throw new NaturalError(
+      'Unexpected response format: missing "data" field in wallet balance response'
+    );
+  }
+  const { data } = response;
+  if (data.type !== "wallet_balance" || !data.attributes) {
+    throw new NaturalError(
+      `Unexpected resource format: expected type "wallet_balance", got "${data.type}"`
+    );
+  }
+  const { id, attributes } = data;
+  return {
+    walletId: id,
+    balances: attributes.balances,
+    pendingClaimAmountMinor: attributes.pendingClaimAmountMinor != null ? Number(attributes.pendingClaimAmountMinor) : void 0,
+    pendingClaimCount: attributes.pendingClaimCount != null ? Number(attributes.pendingClaimCount) : void 0
+  };
+}
+function unwrapDeposit(response) {
+  if (!response?.data) {
+    throw new NaturalError('Unexpected response format: missing "data" field in deposit response');
+  }
+  const { data } = response;
+  if (data.type !== "deposit" || !data.attributes) {
+    throw new NaturalError(
+      `Unexpected resource format: expected type "deposit", got "${data.type}"`
+    );
+  }
+  const { id, attributes } = data;
+  return {
+    transferId: id ?? void 0,
+    status: String(attributes.status),
+    amount: attributes.amount != null ? String(attributes.amount) : "",
+    currency: String(attributes.currency),
+    estimatedSettlement: attributes.estimatedSettlement != null ? String(attributes.estimatedSettlement) : void 0,
+    error: attributes.error != null ? String(attributes.error) : void 0,
+    errorDetails: attributes.errorDetails != null ? String(attributes.errorDetails) : void 0
+  };
+}
+function unwrapWithdrawal(response) {
+  if (!response?.data) {
+    throw new NaturalError(
+      'Unexpected response format: missing "data" field in withdrawal response'
+    );
+  }
+  const { data } = response;
+  if (data.type !== "withdrawal" || !data.attributes) {
+    throw new NaturalError(
+      `Unexpected resource format: expected type "withdrawal", got "${data.type}"`
+    );
+  }
+  const { id, attributes } = data;
+  return {
+    transferId: id ?? void 0,
+    instructionId: attributes.instructionId != null ? String(attributes.instructionId) : void 0,
+    status: String(attributes.status),
+    amount: attributes.amount != null ? String(attributes.amount) : "",
+    currency: String(attributes.currency),
+    estimatedSettlement: attributes.estimatedSettlement != null ? String(attributes.estimatedSettlement) : void 0,
+    kycRequired: Boolean(attributes.kycRequired),
+    kycStatus: attributes.kycStatus != null ? String(attributes.kycStatus) : void 0,
+    kycSessionUrl: attributes.kycSessionUrl != null ? String(attributes.kycSessionUrl) : void 0,
+    mfaRequired: Boolean(attributes.mfaRequired),
+    mfaChallengeId: attributes.mfaChallengeId != null ? String(attributes.mfaChallengeId) : void 0,
+    mfaExpiresAt: attributes.mfaExpiresAt != null ? String(attributes.mfaExpiresAt) : void 0,
+    error: attributes.error != null ? String(attributes.error) : void 0,
+    errorDetails: attributes.errorDetails != null ? String(attributes.errorDetails) : void 0
+  };
+}
 var WalletResource = class extends BaseResource {
   /**
    * Get current wallet balance.
@@ -658,7 +746,8 @@ var WalletResource = class extends BaseResource {
    * @returns AccountBalance with available, current, pending amounts
    */
   async balance() {
-    return this.http.get("/wallet/balance");
+    const response = await this.http.get("/wallet/balance");
+    return unwrapBalance(response);
   }
   /**
    * Initiate a deposit from a linked bank account.
@@ -667,18 +756,20 @@ var WalletResource = class extends BaseResource {
    * @returns DepositResponse with transfer status
    */
   async deposit(params) {
-    const body = {
+    const attributes = {
       amount: params.amount,
       currency: params.currency ?? "USD",
       paymentInstrumentId: params.paymentInstrumentId
     };
     if (params.description) {
-      body["description"] = params.description;
+      attributes["description"] = params.description;
     }
-    return this.http.post("/wallet/deposit", {
+    const body = { data: { attributes } };
+    const response = await this.http.post("/wallet/deposit", {
       body,
       headers: { "Idempotency-Key": params.idempotencyKey }
     });
+    return unwrapDeposit(response);
   }
   /**
    * Initiate a withdrawal to a linked bank account.
@@ -687,28 +778,59 @@ var WalletResource = class extends BaseResource {
    * @returns WithdrawResponse with transfer status (may require KYC/MFA)
    */
   async withdraw(params) {
-    const body = {
+    const attributes = {
       amount: params.amount,
       currency: params.currency ?? "USD",
       paymentInstrumentId: params.paymentInstrumentId
     };
-    if (params.description) {
-      body["description"] = params.description;
-    }
-    return this.http.post("/wallet/withdraw", {
+    if (params.description) attributes["description"] = params.description;
+    if (params.walletId) attributes["walletId"] = params.walletId;
+    const body = { data: { attributes } };
+    const response = await this.http.post("/wallet/withdraw", {
       body,
       headers: { "Idempotency-Key": params.idempotencyKey }
     });
+    return unwrapWithdrawal(response);
   }
 };
 
 // src/resources/transactions.ts
+function unwrapTransactionResource(resource) {
+  if (resource.type !== "transaction" || !resource.attributes) {
+    throw new NaturalError(
+      `Unexpected resource format: expected type "transaction", got "${resource.type}"`
+    );
+  }
+  const { id, attributes, relationships } = resource;
+  return {
+    transactionId: id,
+    amount: String(attributes.amount),
+    currency: String(attributes.currency),
+    status: String(attributes.status),
+    description: attributes.description != null ? String(attributes.description) : void 0,
+    memo: attributes.memo != null ? String(attributes.memo) : void 0,
+    createdAt: String(attributes.createdAt),
+    updatedAt: attributes.updatedAt != null ? String(attributes.updatedAt) : void 0,
+    isDelegated: Boolean(attributes.isDelegated),
+    customerName: attributes.customerName != null ? String(attributes.customerName) : void 0,
+    customerAgentId: attributes.customerAgentId != null ? String(attributes.customerAgentId) : void 0,
+    senderName: attributes.senderName != null ? String(attributes.senderName) : void 0,
+    recipientName: attributes.recipientName != null ? String(attributes.recipientName) : void 0,
+    transactionType: String(attributes.transactionType),
+    category: String(attributes.category),
+    direction: String(attributes.direction),
+    sourcePartyId: relationships?.sourceParty?.data?.id,
+    destinationPartyId: relationships?.destinationParty?.data?.id,
+    sourceWalletId: relationships?.sourceWallet?.data?.id,
+    destinationWalletId: relationships?.destinationWallet?.data?.id
+  };
+}
 var TransactionsResource = class extends BaseResource {
   /**
    * List recent transactions.
    *
    * @param params - List parameters including agent context
-   * @returns List of Transaction objects
+   * @returns TransactionListResponse with transactions and pagination info
    */
   async list(params) {
     const headers = {};
@@ -718,20 +840,69 @@ var TransactionsResource = class extends BaseResource {
     if (params?.customerPartyId) {
       headers["X-On-Behalf-Of"] = params.customerPartyId;
     }
-    const data = await this.http.get("/transactions", {
+    const response = await this.http.get("/transactions", {
       params: {
-        limit: params?.limit ?? 10,
-        offset: params?.offset ?? 0,
-        customerFilter: params?.customerFilter,
+        limit: params?.limit ?? 50,
+        cursor: params?.cursor,
         type: params?.type
       },
       headers: Object.keys(headers).length > 0 ? headers : void 0
     });
-    return data.transfers ?? data.transactions ?? [];
+    if (!response?.data || !Array.isArray(response.data)) {
+      throw new NaturalError(
+        'Unexpected response format: missing "data" array in transaction list response'
+      );
+    }
+    const transactions = response.data.map(unwrapTransactionResource);
+    const pagination = response.meta?.pagination ?? {};
+    return {
+      transactions,
+      hasMore: pagination.hasMore ?? false,
+      nextCursor: pagination.nextCursor ?? null
+    };
   }
 };
 
 // src/resources/agents.ts
+function unwrapAgentResource(resource) {
+  if (resource.type !== "agent" || !resource.attributes) {
+    throw new NaturalError(
+      `Unexpected resource format: expected type "agent", got "${resource.type}"`
+    );
+  }
+  const { id, attributes, relationships } = resource;
+  return {
+    id,
+    name: String(attributes.name),
+    description: attributes.description != null ? String(attributes.description) : void 0,
+    status: String(attributes.status),
+    partyId: relationships?.party?.data?.id ?? "",
+    createdAt: attributes.createdAt != null ? String(attributes.createdAt) : void 0,
+    createdBy: attributes.createdBy != null ? String(attributes.createdBy) : void 0,
+    updatedAt: attributes.updatedAt != null ? String(attributes.updatedAt) : void 0,
+    updatedBy: attributes.updatedBy != null ? String(attributes.updatedBy) : void 0
+  };
+}
+function unwrapAgent(response) {
+  if (!response?.data) {
+    throw new NaturalError('Unexpected response format: missing "data" field in agent response');
+  }
+  return unwrapAgentResource(response.data);
+}
+function unwrapAgentList(response) {
+  if (!response?.data || !Array.isArray(response.data)) {
+    throw new NaturalError(
+      'Unexpected response format: missing "data" array in agent list response'
+    );
+  }
+  const agents = response.data.map(unwrapAgentResource);
+  const pagination = response.meta?.pagination ?? {};
+  return {
+    agents,
+    hasMore: pagination.hasMore ?? false,
+    nextCursor: pagination.nextCursor ?? null
+  };
+}
 var AgentsResource = class extends BaseResource {
   /**
    * List agents for the partner.
@@ -740,14 +911,15 @@ var AgentsResource = class extends BaseResource {
    * @returns AgentListResponse with list of agents
    */
   async list(params) {
-    return this.http.get("/agents", {
+    const response = await this.http.get("/agents", {
       params: {
         status: params?.status,
         partyId: params?.partyId,
         limit: params?.limit ?? 50,
-        offset: params?.offset ?? 0
+        cursor: params?.cursor
       }
     });
+    return unwrapAgentList(response);
   }
   /**
    * Get agent by ID.
@@ -756,7 +928,8 @@ var AgentsResource = class extends BaseResource {
    * @returns Agent details
    */
   async get(agentId) {
-    return this.http.get(`/agents/${agentId}`);
+    const response = await this.http.get(`/agents/${agentId}`);
+    return unwrapAgent(response);
   }
   /**
    * Create a new agent.
@@ -765,21 +938,25 @@ var AgentsResource = class extends BaseResource {
    * @returns AgentCreateResponse with created agent details
    */
   async create(params) {
-    const body = {
-      name: params.name,
-      partyId: params.partyId
+    const attributes = {
+      name: params.name
     };
     if (params.description) {
-      body["description"] = params.description;
+      attributes["description"] = params.description;
+    }
+    if (params.limits) {
+      attributes["limits"] = params.limits;
     }
+    const body = { data: { attributes } };
     const headers = {};
     if (params.idempotencyKey) {
       headers["Idempotency-Key"] = params.idempotencyKey;
     }
-    return this.http.post("/agents", {
+    const response = await this.http.post("/agents", {
       body,
       headers: Object.keys(headers).length > 0 ? headers : void 0
     });
+    return unwrapAgent(response);
   }
   /**
    * Update an existing agent.
@@ -789,18 +966,20 @@ var AgentsResource = class extends BaseResource {
    * @returns AgentUpdateResponse with updated agent details
    */
   async update(agentId, params) {
-    const body = {};
-    if (params.name !== void 0) body["name"] = params.name;
-    if (params.description !== void 0) body["description"] = params.description;
-    if (params.status !== void 0) body["status"] = params.status;
+    const attributes = {};
+    if (params.name !== void 0) attributes["name"] = params.name;
+    if (params.description !== void 0) attributes["description"] = params.description;
+    if (params.status !== void 0) attributes["status"] = params.status;
+    const body = { data: { attributes } };
     const headers = {};
     if (params.idempotencyKey) {
       headers["Idempotency-Key"] = params.idempotencyKey;
     }
-    return this.http.put(`/agents/${agentId}`, {
+    const response = await this.http.put(`/agents/${agentId}`, {
       body,
       headers: Object.keys(headers).length > 0 ? headers : void 0
     });
+    return unwrapAgent(response);
   }
   /**
    * Delete an agent.
@@ -813,6 +992,52 @@ var AgentsResource = class extends BaseResource {
 };
 
 // src/resources/delegations.ts
+function unwrapDelegationResource(resource) {
+  if (resource.type !== "delegation" || !resource.attributes) {
+    throw new NaturalError(
+      `Unexpected resource format: expected type "delegation", got "${resource.type}"`
+    );
+  }
+  const { id, attributes, relationships } = resource;
+  return {
+    id,
+    delegatingPartyId: relationships?.delegatingParty?.data?.id ?? "",
+    delegatedPartyId: relationships?.delegatedParty?.data?.id ?? "",
+    delegatingPartyName: attributes.delegatingPartyName != null ? String(attributes.delegatingPartyName) : void 0,
+    delegatedPartyName: attributes.delegatedPartyName != null ? String(attributes.delegatedPartyName) : void 0,
+    delegatingPartyEmail: attributes.delegatingPartyEmail != null ? String(attributes.delegatingPartyEmail) : void 0,
+    delegatedPartyEmail: attributes.delegatedPartyEmail != null ? String(attributes.delegatedPartyEmail) : void 0,
+    permissions: Array.isArray(attributes.permissions) ? attributes.permissions : [],
+    sourceType: attributes.sourceType != null ? String(attributes.sourceType) : void 0,
+    sourceId: attributes.sourceId != null ? String(attributes.sourceId) : void 0,
+    expiresAt: attributes.expiresAt != null ? String(attributes.expiresAt) : void 0,
+    status: String(attributes.status),
+    createdAt: String(attributes.createdAt),
+    createdBy: attributes.createdBy != null ? String(attributes.createdBy) : void 0
+  };
+}
+function unwrapDelegation(response) {
+  if (!response?.data) {
+    throw new NaturalError(
+      'Unexpected response format: missing "data" field in delegation response'
+    );
+  }
+  return unwrapDelegationResource(response.data);
+}
+function unwrapDelegationList(response) {
+  if (!response?.data || !Array.isArray(response.data)) {
+    throw new NaturalError(
+      'Unexpected response format: missing "data" array in delegation list response'
+    );
+  }
+  const delegations = response.data.map(unwrapDelegationResource);
+  const pagination = response.meta?.pagination ?? {};
+  return {
+    delegations,
+    hasMore: pagination.hasMore ?? false,
+    nextCursor: pagination.nextCursor ?? null
+  };
+}
 var DelegationsResource = class extends BaseResource {
   /**
    * List delegations with optional filters.
@@ -821,13 +1046,16 @@ var DelegationsResource = class extends BaseResource {
    * @returns DelegationListResponse with list of delegations
    */
   async list(params) {
-    return this.http.get("/delegations", {
+    const response = await this.http.get("/delegations", {
       params: {
         status: params?.status,
         delegatingPartyId: params?.delegatingPartyId,
-        delegatedPartyId: params?.delegatedPartyId
+        delegatedPartyId: params?.delegatedPartyId,
+        limit: params?.limit ?? 50,
+        cursor: params?.cursor
       }
     });
+    return unwrapDelegationList(response);
   }
   /**
    * Get delegation by ID.
@@ -836,31 +1064,8 @@ var DelegationsResource = class extends BaseResource {
    * @returns Delegation details
    */
   async get(delegationId) {
-    return this.http.get(`/delegations/${delegationId}`);
-  }
-  /**
-   * Create a new delegation (party-to-party trust relationship).
-   *
-   * @param params - Delegation creation parameters
-   * @returns Created Delegation
-   */
-  async create(params) {
-    const body = {
-      delegatingPartyId: params.delegatingPartyId,
-      delegatedPartyId: params.delegatedPartyId,
-      permissions: params.permissions
-    };
-    if (params.expiresAt) {
-      body["expiresAt"] = params.expiresAt;
-    }
-    const headers = {};
-    if (params.idempotencyKey) {
-      headers["Idempotency-Key"] = params.idempotencyKey;
-    }
-    return this.http.post("/delegations", {
-      body,
-      headers: Object.keys(headers).length > 0 ? headers : void 0
-    });
+    const response = await this.http.get(`/delegations/${delegationId}`);
+    return unwrapDelegation(response);
   }
   /**
    * Update an existing delegation.
@@ -870,11 +1075,15 @@ var DelegationsResource = class extends BaseResource {
    * @returns Updated Delegation
    */
   async update(delegationId, params) {
-    const body = {};
-    if (params.status !== void 0) body["status"] = params.status;
-    if (params.permissions !== void 0) body["permissions"] = params.permissions;
-    if (params.expiresAt !== void 0) body["expiresAt"] = params.expiresAt;
-    return this.http.put(`/delegations/${delegationId}`, { body });
+    const attributes = {};
+    if (params.status !== void 0) attributes["status"] = params.status;
+    if (params.permissions !== void 0) attributes["permissions"] = params.permissions;
+    if (params.expiresAt !== void 0) attributes["expiresAt"] = params.expiresAt;
+    const body = { data: { attributes } };
+    const response = await this.http.put(`/delegations/${delegationId}`, {
+      body
+    });
+    return unwrapDelegation(response);
   }
   /**
    * Revoke a delegation (soft delete by setting status to REVOKED).
@@ -883,19 +1092,61 @@ var DelegationsResource = class extends BaseResource {
    * @returns Revoked Delegation
    */
   async revoke(delegationId) {
-    return this.http.put(`/delegations/${delegationId}/revoke`);
+    return this.update(delegationId, { status: "REVOKED" });
   }
 };
 
 // src/resources/customers.ts
+function unwrapCustomerResource(resource) {
+  if (resource.type !== "customer" || !resource.attributes) {
+    throw new NaturalError(
+      `Unexpected resource format: expected type "customer", got "${resource.type}"`
+    );
+  }
+  const { id, attributes, relationships } = resource;
+  return {
+    party: {
+      id,
+      type: String(attributes.partyType),
+      legalName: attributes.legalName != null ? String(attributes.legalName) : void 0,
+      displayName: attributes.displayName != null ? String(attributes.displayName) : void 0,
+      status: attributes.partyStatus != null ? String(attributes.partyStatus) : void 0
+    },
+    delegationId: relationships?.delegation?.data?.id ?? "",
+    permissions: Array.isArray(attributes.permissions) ? attributes.permissions : [],
+    delegationStatus: String(attributes.delegationStatus),
+    createdAt: String(attributes.createdAt)
+  };
+}
+function unwrapCustomerList(response) {
+  if (!response?.data || !Array.isArray(response.data)) {
+    throw new NaturalError(
+      'Unexpected response format: missing "data" array in customer list response'
+    );
+  }
+  const items = response.data.map(unwrapCustomerResource);
+  const pagination = response.meta?.pagination ?? {};
+  return {
+    items,
+    hasMore: pagination.hasMore ?? false,
+    nextCursor: pagination.nextCursor ?? null
+  };
+}
 var CustomersResource = class extends BaseResource {
   /**
    * List customers onboarded by the partner via delegation.
    *
-   * @returns List of Customer objects with party info and delegation details
+   * @param params - Pagination parameters
+   * @returns CustomerListResponse with items, hasMore, nextCursor
    */
-  async list() {
-    return this.http.get("/customers");
+  async list(params) {
+    const response = await this.http.get("/customers", {
+      params: {
+        limit: params?.limit,
+        cursor: params?.cursor
+      }
+    });
+    return unwrapCustomerList(response);
   }
 };