@naturalpay/sdk 0.0.2 → 0.0.3

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,32 @@ 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
+  };
+}
 var WalletResource = class extends BaseResource {
   /**
    * Get current wallet balance.
@@ -658,7 +695,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.
@@ -695,6 +733,9 @@ var WalletResource = class extends BaseResource {
     if (params.description) {
       body["description"] = params.description;
     }
+    if (params.walletId) {
+      body["walletId"] = params.walletId;
+    }
     return this.http.post("/wallet/withdraw", {
       body,
       headers: { "Idempotency-Key": params.idempotencyKey }
@@ -703,12 +744,42 @@ var WalletResource = class extends BaseResource {
 };
 
 // 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 +789,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 +860,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 +877,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 +887,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 +915,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.
@@ -825,7 +953,9 @@ var DelegationsResource = class extends BaseResource {
       params: {
         status: params?.status,
         delegatingPartyId: params?.delegatingPartyId,
-        delegatedPartyId: params?.delegatedPartyId
+        delegatedPartyId: params?.delegatedPartyId,
+        limit: params?.limit ?? 50,
+        cursor: params?.cursor
       }
     });
   }
@@ -838,30 +968,6 @@ var DelegationsResource = class extends BaseResource {
   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
-    });
-  }
   /**
    * Update an existing delegation.
    *
@@ -883,7 +989,7 @@ var DelegationsResource = class extends BaseResource {
    * @returns Revoked Delegation
    */
   async revoke(delegationId) {
-    return this.http.put(`/delegations/${delegationId}/revoke`);
+    return this.update(delegationId, { status: "REVOKED" });
   }
 };
 
@@ -892,10 +998,16 @@ 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) {
+    return this.http.get("/customers", {
+      params: {
+        limit: params?.limit,
+        cursor: params?.cursor
+      }
+    });
   }
 };