@naturalpay/sdk 0.0.3 → 0.0.5

package/README.md

@@ -210,7 +210,7 @@ npx naturalpay mcp serve --transport http --port 8080
 ```typescript
 import { createServer } from 'naturalpay/mcp';
 
-const server = createServer('pk_sandbox_xxx');
+const server = createServer({ apiKey: 'pk_sandbox_xxx' });
 
 // Start with stdio
 server.start({ transportType: 'stdio' });

package/dist/index.cjs

@@ -298,6 +298,12 @@ function logToolCall(logger2, toolName, options) {
     logger2.info(`Tool call: ${toolName}`, extra);
   }
 }
+var toolCallStorage = new async_hooks.AsyncLocalStorage();
+function getToolCallHeader() {
+  const data = toolCallStorage.getStore();
+  if (!data) return void 0;
+  return btoa(JSON.stringify(data));
+}
 
 // src/http.ts
 var logger = getLogger("http");
@@ -531,9 +537,15 @@ var HTTPClient = class {
       const headers = {
         Authorization: `Bearer ${jwt}`,
         "Content-Type": "application/json",
-        "User-Agent": `naturalpay-ts/${SDK_VERSION2}`,
-        ...options?.headers
+        "User-Agent": `naturalpay-ts/${SDK_VERSION2}`
       };
+      const toolCallHeader = getToolCallHeader();
+      if (toolCallHeader) {
+        headers["X-Tool-Call"] = toolCallHeader;
+      }
+      if (options?.headers) {
+        Object.assign(headers, options.headers);
+      }
       const response = await fetch(url, {
         method,
         headers,
@@ -649,9 +661,16 @@ var PaymentsResource = class extends BaseResource {
     };
     if (params.memo) attributes["description"] = params.memo;
     const body = { data: { attributes } };
+    const headers = { "Idempotency-Key": idempotencyKey };
+    if (params.agentId) {
+      headers["X-Agent-ID"] = params.agentId;
+    }
+    if (params.instanceId) {
+      headers["X-Instance-ID"] = params.instanceId;
+    }
     const response = await this.http.post("/payments", {
       body,
-      headers: { "Idempotency-Key": idempotencyKey }
+      headers
     });
     return unwrapPayment(response);
   }
@@ -661,8 +680,14 @@ var PaymentsResource = class extends BaseResource {
    * @param transferId - The transfer ID to look up
    * @returns Payment object with current status
    */
-  async retrieve(transferId) {
-    const response = await this.http.get(`/payments/${transferId}`);
+  async retrieve(transferId, options) {
+    const headers = {};
+    if (options?.instanceId) {
+      headers["X-Instance-ID"] = options.instanceId;
+    }
+    const response = await this.http.get(`/payments/${transferId}`, {
+      headers: Object.keys(headers).length > 0 ? headers : void 0
+    });
     return unwrapPayment(response);
   }
 };
@@ -688,14 +713,71 @@ function unwrapBalance(response) {
     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.
    *
    * @returns AccountBalance with available, current, pending amounts
    */
-  async balance() {
-    const response = await this.http.get("/wallet/balance");
+  async balance(options) {
+    const headers = {};
+    if (options?.instanceId) {
+      headers["X-Instance-ID"] = options.instanceId;
+    }
+    const response = await this.http.get("/wallet/balance", {
+      headers: Object.keys(headers).length > 0 ? headers : void 0
+    });
     return unwrapBalance(response);
   }
   /**
@@ -705,18 +787,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.
@@ -725,21 +809,19 @@ 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;
-    }
-    if (params.walletId) {
-      body["walletId"] = params.walletId;
-    }
-    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);
   }
 };
 
@@ -789,6 +871,9 @@ var TransactionsResource = class extends BaseResource {
     if (params?.customerPartyId) {
       headers["X-On-Behalf-Of"] = params.customerPartyId;
     }
+    if (params?.instanceId) {
+      headers["X-Instance-ID"] = params.instanceId;
+    }
     const response = await this.http.get("/transactions", {
       params: {
         limit: params?.limit ?? 50,
@@ -860,13 +945,18 @@ var AgentsResource = class extends BaseResource {
    * @returns AgentListResponse with list of agents
    */
   async list(params) {
+    const headers = {};
+    if (params?.instanceId) {
+      headers["X-Instance-ID"] = params.instanceId;
+    }
     const response = await this.http.get("/agents", {
       params: {
         status: params?.status,
         partyId: params?.partyId,
         limit: params?.limit ?? 50,
         cursor: params?.cursor
-      }
+      },
+      headers: Object.keys(headers).length > 0 ? headers : void 0
     });
     return unwrapAgentList(response);
   }
@@ -941,6 +1031,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.
@@ -949,7 +1085,7 @@ 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,
@@ -958,6 +1094,7 @@ var DelegationsResource = class extends BaseResource {
         cursor: params?.cursor
       }
     });
+    return unwrapDelegationList(response);
   }
   /**
    * Get delegation by ID.
@@ -966,7 +1103,8 @@ var DelegationsResource = class extends BaseResource {
    * @returns Delegation details
    */
   async get(delegationId) {
-    return this.http.get(`/delegations/${delegationId}`);
+    const response = await this.http.get(`/delegations/${delegationId}`);
+    return unwrapDelegation(response);
   }
   /**
    * Update an existing delegation.
@@ -976,11 +1114,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).
@@ -994,6 +1136,41 @@ var DelegationsResource = class extends BaseResource {
 };
 
 // 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.
@@ -1002,12 +1179,13 @@ var CustomersResource = class extends BaseResource {
    * @returns CustomerListResponse with items, hasMore, nextCursor
    */
   async list(params) {
-    return this.http.get("/customers", {
+    const response = await this.http.get("/customers", {
       params: {
         limit: params?.limit,
         cursor: params?.cursor
       }
     });
+    return unwrapCustomerList(response);
   }
 };