@sly_ai/sdk 0.1.0

package/dist/cards.mjs

@@ -0,0 +1,369 @@
+// src/cards/index.ts
+var VisaClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Create a Visa VIC payment instruction
+   */
+  async createInstruction(params) {
+    return this.client.request("/v1/cards/visa/instructions", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /**
+   * Get a specific Visa payment instruction
+   */
+  async getInstruction(instructionId) {
+    return this.client.request(
+      `/v1/cards/visa/instructions/${instructionId}`
+    );
+  }
+  /**
+   * List Visa payment instructions
+   */
+  async listInstructions(options) {
+    const params = new URLSearchParams();
+    if (options?.status) params.set("status", options.status);
+    if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.offset) params.set("offset", String(options.offset));
+    const query = params.toString();
+    return this.client.request(
+      `/v1/cards/visa/instructions${query ? `?${query}` : ""}`
+    );
+  }
+  /**
+   * Provision a VTS token for an instruction
+   */
+  async createToken(params) {
+    return this.client.request("/v1/cards/visa/tokens", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /**
+   * Get a specific Visa token
+   */
+  async getToken(tokenId) {
+    return this.client.request(`/v1/cards/visa/tokens/${tokenId}`);
+  }
+  /**
+   * List Visa tokens
+   */
+  async listTokens(options) {
+    const params = new URLSearchParams();
+    if (options?.status) params.set("status", options.status);
+    if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.offset) params.set("offset", String(options.offset));
+    const query = params.toString();
+    return this.client.request(
+      `/v1/cards/visa/tokens${query ? `?${query}` : ""}`
+    );
+  }
+  /**
+   * Suspend a Visa token
+   */
+  async suspendToken(tokenId) {
+    return this.client.request(
+      `/v1/cards/visa/tokens/${tokenId}`,
+      { method: "DELETE" }
+    );
+  }
+};
+var MastercardClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Register an agent with Mastercard Agent Pay
+   */
+  async registerAgent(params) {
+    return this.client.request("/v1/cards/mastercard/agents", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /**
+   * Get a specific Mastercard agent registration
+   */
+  async getAgent(agentId) {
+    return this.client.request(
+      `/v1/cards/mastercard/agents/${agentId}`
+    );
+  }
+  /**
+   * List registered Mastercard agents
+   */
+  async listAgents() {
+    return this.client.request(
+      "/v1/cards/mastercard/agents"
+    );
+  }
+  /**
+   * Create a Mastercard agentic token with DTVC
+   */
+  async createToken(params) {
+    return this.client.request("/v1/cards/mastercard/tokens", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /**
+   * Get a Mastercard token, optionally refreshing the DTVC
+   */
+  async getToken(tokenReference, options) {
+    const query = options?.refresh ? "?refresh=true" : "";
+    return this.client.request(
+      `/v1/cards/mastercard/tokens/${tokenReference}${query}`
+    );
+  }
+  /**
+   * List Mastercard tokens
+   */
+  async listTokens(options) {
+    const params = new URLSearchParams();
+    if (options?.status) params.set("status", options.status);
+    if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.offset) params.set("offset", String(options.offset));
+    const query = params.toString();
+    return this.client.request(
+      `/v1/cards/mastercard/tokens${query ? `?${query}` : ""}`
+    );
+  }
+  /**
+   * Revoke a Mastercard token
+   */
+  async revokeToken(tokenReference) {
+    return this.client.request(
+      `/v1/cards/mastercard/tokens/${tokenReference}`,
+      { method: "DELETE" }
+    );
+  }
+};
+var CardsClient = class {
+  constructor(client) {
+    this.client = client;
+    this.visa = new VisaClient(client);
+    this.mastercard = new MastercardClient(client);
+  }
+  /**
+   * Verify an AI agent's Web Bot Auth signature
+   *
+   * @example
+   * ```typescript
+   * const result = await payos.cards.verifyAgentSignature({
+   *   method: 'POST',
+   *   path: '/checkout',
+   *   headers: req.headers,
+   *   signatureInput: req.headers['signature-input'],
+   *   signature: req.headers['signature'],
+   * });
+   *
+   * if (result.valid) {
+   *   console.log(`Verified ${result.network} agent from ${result.agentProvider}`);
+   * }
+   * ```
+   */
+  async verifyAgentSignature(params) {
+    return this.client.request("/v1/cards/verify", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /**
+   * Get configured card networks and their status
+   *
+   * @example
+   * ```typescript
+   * const { networks, capabilities } = await payos.cards.getNetworks();
+   *
+   * if (networks.visa.configured) {
+   *   console.log(`Visa: ${networks.visa.status}`);
+   * }
+   * ```
+   */
+  async getNetworks() {
+    return this.client.request("/v1/cards/networks");
+  }
+  /**
+   * Test connection to a card network
+   */
+  async testNetwork(network) {
+    return this.client.request(`/v1/cards/networks/${network}/test`, {
+      method: "POST"
+    });
+  }
+  /**
+   * Configure Visa VIC credentials
+   */
+  async configureVisa(params) {
+    return this.client.request("/v1/cards/networks/visa/configure", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /**
+   * Configure Mastercard Agent Pay credentials
+   */
+  async configureMastercard(params) {
+    return this.client.request("/v1/cards/networks/mastercard/configure", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  /**
+   * Disconnect a card network
+   */
+  async disconnectNetwork(network) {
+    return this.client.request(
+      `/v1/cards/networks/${network}/disconnect`,
+      { method: "DELETE" }
+    );
+  }
+  /**
+   * Get comprehensive card network analytics
+   *
+   * @param days - Number of days to analyze (default: 30)
+   *
+   * @example
+   * ```typescript
+   * const analytics = await payos.cards.getAnalytics(30);
+   *
+   * console.log(`Success rate: ${analytics.verifications.successRate}%`);
+   * console.log(`Total volume: $${analytics.transactions.volume}`);
+   * ```
+   */
+  async getAnalytics(days = 30) {
+    return this.client.request(`/v1/cards/analytics?days=${days}`);
+  }
+  /**
+   * Get verification statistics
+   *
+   * @param days - Number of days to analyze (default: 30)
+   */
+  async getVerificationStats(days = 30) {
+    return this.client.request(`/v1/cards/verifications/stats?days=${days}`);
+  }
+  /**
+   * List card network transactions
+   */
+  async listTransactions(options) {
+    const params = new URLSearchParams();
+    if (options?.network) params.set("network", options.network);
+    if (options?.status) params.set("status", options.status);
+    if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.offset) params.set("offset", String(options.offset));
+    const query = params.toString();
+    return this.client.request(
+      `/v1/cards/transactions${query ? `?${query}` : ""}`
+    );
+  }
+  /**
+   * Get a specific transaction
+   */
+  async getTransaction(transactionId) {
+    return this.client.request(`/v1/cards/transactions/${transactionId}`);
+  }
+  // ============================================
+  // Agent Signing Methods
+  // ============================================
+  /**
+   * Generate a signing key for an agent
+   *
+   * Creates an Ed25519 or RSA-SHA256 key pair for the agent to sign
+   * payment requests according to RFC 9421 (HTTP Message Signatures).
+   *
+   * @example
+   * ```typescript
+   * const key = await payos.cards.generateSigningKey('agent_123');
+   * console.log(`Public key: ${key.publicKey}`);
+   * // Register this public key with card networks (Visa TAP, MC Agent Pay)
+   * ```
+   */
+  async generateSigningKey(agentId, options) {
+    return this.client.request(
+      `/v1/agents/${agentId}/signing-keys`,
+      {
+        method: "POST",
+        body: JSON.stringify(options || {})
+      }
+    );
+  }
+  /**
+   * Get the signing key status for an agent
+   *
+   * @example
+   * ```typescript
+   * const status = await payos.cards.getSigningKey('agent_123');
+   * if (status.hasKey) {
+   *   console.log(`Key: ${status.keyId}, Uses: ${status.stats.useCount}`);
+   * }
+   * ```
+   */
+  async getSigningKey(agentId) {
+    return this.client.request(`/v1/agents/${agentId}/signing-keys`);
+  }
+  /**
+   * Revoke an agent's signing key
+   *
+   * After revocation, the agent will need a new key to sign requests.
+   */
+  async revokeSigningKey(agentId) {
+    return this.client.request(
+      `/v1/agents/${agentId}/signing-keys`,
+      { method: "DELETE" }
+    );
+  }
+  /**
+   * Sign a payment request for an agent
+   *
+   * Signs an HTTP request according to RFC 9421 so the agent can
+   * authenticate with merchants and card networks.
+   *
+   * Requirements:
+   * - Agent must have KYA tier >= 1
+   * - Agent must be active
+   * - Agent must have a signing key
+   * - Payment must be within spending limits
+   *
+   * @example
+   * ```typescript
+   * // Sign a payment request
+   * const signed = await payos.cards.signRequest('agent_123', {
+   *   method: 'POST',
+   *   path: '/api/checkout',
+   *   host: 'merchant.com',
+   *   body: JSON.stringify({ items: [...], total: 99.99 }),
+   *   payment: {
+   *     amount: 99.99,
+   *     currency: 'USD',
+   *     merchantName: 'Acme Store',
+   *   },
+   * });
+   *
+   * // Agent uses signed headers to call merchant
+   * const response = await fetch('https://merchant.com/api/checkout', {
+   *   method: 'POST',
+   *   headers: {
+   *     ...signed.headers,
+   *     'Content-Type': 'application/json',
+   *   },
+   *   body: JSON.stringify({ items: [...], total: 99.99 }),
+   * });
+   * ```
+   */
+  async signRequest(agentId, request) {
+    return this.client.request(
+      `/v1/agents/${agentId}/sign-request`,
+      {
+        method: "POST",
+        body: JSON.stringify(request)
+      }
+    );
+  }
+};
+
+export { CardsClient, MastercardClient, VisaClient };
+//# sourceMappingURL=cards.mjs.map
+//# sourceMappingURL=cards.mjs.map

package/dist/cards.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cards/index.ts"],"names":[],"mappings":"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","file":"cards.mjs","sourcesContent":["/**\n * Card Networks Module\n *\n * Provides SDK integration for Visa VIC and Mastercard Agent Pay\n * for accepting payments from AI agents.\n */\n\nimport { PayOSClient } from '../client';\nimport type {\n  VerifyAgentSignatureRequest,\n  VerifyAgentSignatureResult,\n  CardNetworksResponse,\n  CardAnalyticsResponse,\n  VerificationStats,\n  CreateVisaInstructionRequest,\n  VisaPaymentInstruction,\n  PaginatedResponse,\n  CreateVisaTokenRequest,\n  VisaToken,\n  RegisterMastercardAgentRequest,\n  MastercardAgentRegistration,\n  CreateMastercardTokenRequest,\n  MastercardToken,\n  CardTransaction,\n  NetworkTestResult,\n  ConfigureVisaRequest,\n  ConfigureMastercardRequest,\n  ConfigureResult,\n  GenerateSigningKeyRequest,\n  GenerateSigningKeyResult,\n  SigningKeyStatus,\n  SignRequestInput,\n  SignRequestResult,\n  DeleteSigningKeyResult,\n} from './types';\n\nexport * from './types';\n\n/**\n * Visa-specific operations\n */\nexport class VisaClient {\n  constructor(private client: PayOSClient) {}\n\n  /**\n   * Create a Visa VIC payment instruction\n   */\n  async createInstruction(\n    params: CreateVisaInstructionRequest\n  ): Promise<VisaPaymentInstruction> {\n    return this.client.request<VisaPaymentInstruction>('/v1/cards/visa/instructions', {\n      method: 'POST',\n      body: JSON.stringify(params),\n    });\n  }\n\n  /**\n   * Get a specific Visa payment instruction\n   */\n  async getInstruction(instructionId: string): Promise<VisaPaymentInstruction> {\n    return this.client.request<VisaPaymentInstruction>(\n      `/v1/cards/visa/instructions/${instructionId}`\n    );\n  }\n\n  /**\n   * List Visa payment instructions\n   */\n  async listInstructions(options?: {\n    status?: string;\n    limit?: number;\n    offset?: number;\n  }): Promise<PaginatedResponse<VisaPaymentInstruction>> {\n    const params = new URLSearchParams();\n    if (options?.status) params.set('status', options.status);\n    if (options?.limit) params.set('limit', String(options.limit));\n    if (options?.offset) params.set('offset', String(options.offset));\n    const query = params.toString();\n    return this.client.request<PaginatedResponse<VisaPaymentInstruction>>(\n      `/v1/cards/visa/instructions${query ? `?${query}` : ''}`\n    );\n  }\n\n  /**\n   * Provision a VTS token for an instruction\n   */\n  async createToken(params: CreateVisaTokenRequest): Promise<VisaToken> {\n    return this.client.request<VisaToken>('/v1/cards/visa/tokens', {\n      method: 'POST',\n      body: JSON.stringify(params),\n    });\n  }\n\n  /**\n   * Get a specific Visa token\n   */\n  async getToken(tokenId: string): Promise<VisaToken> {\n    return this.client.request<VisaToken>(`/v1/cards/visa/tokens/${tokenId}`);\n  }\n\n  /**\n   * List Visa tokens\n   */\n  async listTokens(options?: {\n    status?: string;\n    limit?: number;\n    offset?: number;\n  }): Promise<PaginatedResponse<VisaToken>> {\n    const params = new URLSearchParams();\n    if (options?.status) params.set('status', options.status);\n    if (options?.limit) params.set('limit', String(options.limit));\n    if (options?.offset) params.set('offset', String(options.offset));\n    const query = params.toString();\n    return this.client.request<PaginatedResponse<VisaToken>>(\n      `/v1/cards/visa/tokens${query ? `?${query}` : ''}`\n    );\n  }\n\n  /**\n   * Suspend a Visa token\n   */\n  async suspendToken(tokenId: string): Promise<{ success: boolean; message: string }> {\n    return this.client.request<{ success: boolean; message: string }>(\n      `/v1/cards/visa/tokens/${tokenId}`,\n      { method: 'DELETE' }\n    );\n  }\n}\n\n/**\n * Mastercard-specific operations\n */\nexport class MastercardClient {\n  constructor(private client: PayOSClient) {}\n\n  /**\n   * Register an agent with Mastercard Agent Pay\n   */\n  async registerAgent(\n    params: RegisterMastercardAgentRequest\n  ): Promise<MastercardAgentRegistration> {\n    return this.client.request<MastercardAgentRegistration>('/v1/cards/mastercard/agents', {\n      method: 'POST',\n      body: JSON.stringify(params),\n    });\n  }\n\n  /**\n   * Get a specific Mastercard agent registration\n   */\n  async getAgent(agentId: string): Promise<MastercardAgentRegistration> {\n    return this.client.request<MastercardAgentRegistration>(\n      `/v1/cards/mastercard/agents/${agentId}`\n    );\n  }\n\n  /**\n   * List registered Mastercard agents\n   */\n  async listAgents(): Promise<{ data: MastercardAgentRegistration[] }> {\n    return this.client.request<{ data: MastercardAgentRegistration[] }>(\n      '/v1/cards/mastercard/agents'\n    );\n  }\n\n  /**\n   * Create a Mastercard agentic token with DTVC\n   */\n  async createToken(params: CreateMastercardTokenRequest): Promise<MastercardToken> {\n    return this.client.request<MastercardToken>('/v1/cards/mastercard/tokens', {\n      method: 'POST',\n      body: JSON.stringify(params),\n    });\n  }\n\n  /**\n   * Get a Mastercard token, optionally refreshing the DTVC\n   */\n  async getToken(tokenReference: string, options?: { refresh?: boolean }): Promise<MastercardToken> {\n    const query = options?.refresh ? '?refresh=true' : '';\n    return this.client.request<MastercardToken>(\n      `/v1/cards/mastercard/tokens/${tokenReference}${query}`\n    );\n  }\n\n  /**\n   * List Mastercard tokens\n   */\n  async listTokens(options?: {\n    status?: string;\n    limit?: number;\n    offset?: number;\n  }): Promise<PaginatedResponse<MastercardToken>> {\n    const params = new URLSearchParams();\n    if (options?.status) params.set('status', options.status);\n    if (options?.limit) params.set('limit', String(options.limit));\n    if (options?.offset) params.set('offset', String(options.offset));\n    const query = params.toString();\n    return this.client.request<PaginatedResponse<MastercardToken>>(\n      `/v1/cards/mastercard/tokens${query ? `?${query}` : ''}`\n    );\n  }\n\n  /**\n   * Revoke a Mastercard token\n   */\n  async revokeToken(tokenReference: string): Promise<{ success: boolean; message: string }> {\n    return this.client.request<{ success: boolean; message: string }>(\n      `/v1/cards/mastercard/tokens/${tokenReference}`,\n      { method: 'DELETE' }\n    );\n  }\n}\n\n/**\n * Cards Module - Main client for card network operations\n *\n * Provides unified access to:\n * - Web Bot Auth signature verification\n * - Network configuration and status\n * - Visa VIC payment instructions and tokens\n * - Mastercard Agent Pay registration and tokens\n * - Analytics and transactions\n */\nexport class CardsClient {\n  /** Visa-specific operations */\n  public readonly visa: VisaClient;\n  /** Mastercard-specific operations */\n  public readonly mastercard: MastercardClient;\n\n  constructor(private client: PayOSClient) {\n    this.visa = new VisaClient(client);\n    this.mastercard = new MastercardClient(client);\n  }\n\n  /**\n   * Verify an AI agent's Web Bot Auth signature\n   *\n   * @example\n   * ```typescript\n   * const result = await payos.cards.verifyAgentSignature({\n   *   method: 'POST',\n   *   path: '/checkout',\n   *   headers: req.headers,\n   *   signatureInput: req.headers['signature-input'],\n   *   signature: req.headers['signature'],\n   * });\n   *\n   * if (result.valid) {\n   *   console.log(`Verified ${result.network} agent from ${result.agentProvider}`);\n   * }\n   * ```\n   */\n  async verifyAgentSignature(\n    params: VerifyAgentSignatureRequest\n  ): Promise<VerifyAgentSignatureResult> {\n    return this.client.request<VerifyAgentSignatureResult>('/v1/cards/verify', {\n      method: 'POST',\n      body: JSON.stringify(params),\n    });\n  }\n\n  /**\n   * Get configured card networks and their status\n   *\n   * @example\n   * ```typescript\n   * const { networks, capabilities } = await payos.cards.getNetworks();\n   *\n   * if (networks.visa.configured) {\n   *   console.log(`Visa: ${networks.visa.status}`);\n   * }\n   * ```\n   */\n  async getNetworks(): Promise<CardNetworksResponse> {\n    return this.client.request<CardNetworksResponse>('/v1/cards/networks');\n  }\n\n  /**\n   * Test connection to a card network\n   */\n  async testNetwork(network: 'visa' | 'mastercard'): Promise<NetworkTestResult> {\n    return this.client.request<NetworkTestResult>(`/v1/cards/networks/${network}/test`, {\n      method: 'POST',\n    });\n  }\n\n  /**\n   * Configure Visa VIC credentials\n   */\n  async configureVisa(params: ConfigureVisaRequest): Promise<ConfigureResult> {\n    return this.client.request<ConfigureResult>('/v1/cards/networks/visa/configure', {\n      method: 'POST',\n      body: JSON.stringify(params),\n    });\n  }\n\n  /**\n   * Configure Mastercard Agent Pay credentials\n   */\n  async configureMastercard(params: ConfigureMastercardRequest): Promise<ConfigureResult> {\n    return this.client.request<ConfigureResult>('/v1/cards/networks/mastercard/configure', {\n      method: 'POST',\n      body: JSON.stringify(params),\n    });\n  }\n\n  /**\n   * Disconnect a card network\n   */\n  async disconnectNetwork(network: 'visa' | 'mastercard'): Promise<{ success: boolean; message: string }> {\n    return this.client.request<{ success: boolean; message: string }>(\n      `/v1/cards/networks/${network}/disconnect`,\n      { method: 'DELETE' }\n    );\n  }\n\n  /**\n   * Get comprehensive card network analytics\n   *\n   * @param days - Number of days to analyze (default: 30)\n   *\n   * @example\n   * ```typescript\n   * const analytics = await payos.cards.getAnalytics(30);\n   *\n   * console.log(`Success rate: ${analytics.verifications.successRate}%`);\n   * console.log(`Total volume: $${analytics.transactions.volume}`);\n   * ```\n   */\n  async getAnalytics(days = 30): Promise<CardAnalyticsResponse> {\n    return this.client.request<CardAnalyticsResponse>(`/v1/cards/analytics?days=${days}`);\n  }\n\n  /**\n   * Get verification statistics\n   *\n   * @param days - Number of days to analyze (default: 30)\n   */\n  async getVerificationStats(days = 30): Promise<VerificationStats> {\n    return this.client.request<VerificationStats>(`/v1/cards/verifications/stats?days=${days}`);\n  }\n\n  /**\n   * List card network transactions\n   */\n  async listTransactions(options?: {\n    network?: 'visa' | 'mastercard';\n    status?: string;\n    limit?: number;\n    offset?: number;\n  }): Promise<PaginatedResponse<CardTransaction>> {\n    const params = new URLSearchParams();\n    if (options?.network) params.set('network', options.network);\n    if (options?.status) params.set('status', options.status);\n    if (options?.limit) params.set('limit', String(options.limit));\n    if (options?.offset) params.set('offset', String(options.offset));\n    const query = params.toString();\n    return this.client.request<PaginatedResponse<CardTransaction>>(\n      `/v1/cards/transactions${query ? `?${query}` : ''}`\n    );\n  }\n\n  /**\n   * Get a specific transaction\n   */\n  async getTransaction(transactionId: string): Promise<CardTransaction> {\n    return this.client.request<CardTransaction>(`/v1/cards/transactions/${transactionId}`);\n  }\n\n  // ============================================\n  // Agent Signing Methods\n  // ============================================\n\n  /**\n   * Generate a signing key for an agent\n   *\n   * Creates an Ed25519 or RSA-SHA256 key pair for the agent to sign\n   * payment requests according to RFC 9421 (HTTP Message Signatures).\n   *\n   * @example\n   * ```typescript\n   * const key = await payos.cards.generateSigningKey('agent_123');\n   * console.log(`Public key: ${key.publicKey}`);\n   * // Register this public key with card networks (Visa TAP, MC Agent Pay)\n   * ```\n   */\n  async generateSigningKey(\n    agentId: string,\n    options?: GenerateSigningKeyRequest\n  ): Promise<GenerateSigningKeyResult> {\n    return this.client.request<GenerateSigningKeyResult>(\n      `/v1/agents/${agentId}/signing-keys`,\n      {\n        method: 'POST',\n        body: JSON.stringify(options || {}),\n      }\n    );\n  }\n\n  /**\n   * Get the signing key status for an agent\n   *\n   * @example\n   * ```typescript\n   * const status = await payos.cards.getSigningKey('agent_123');\n   * if (status.hasKey) {\n   *   console.log(`Key: ${status.keyId}, Uses: ${status.stats.useCount}`);\n   * }\n   * ```\n   */\n  async getSigningKey(agentId: string): Promise<SigningKeyStatus> {\n    return this.client.request<SigningKeyStatus>(`/v1/agents/${agentId}/signing-keys`);\n  }\n\n  /**\n   * Revoke an agent's signing key\n   *\n   * After revocation, the agent will need a new key to sign requests.\n   */\n  async revokeSigningKey(agentId: string): Promise<DeleteSigningKeyResult> {\n    return this.client.request<DeleteSigningKeyResult>(\n      `/v1/agents/${agentId}/signing-keys`,\n      { method: 'DELETE' }\n    );\n  }\n\n  /**\n   * Sign a payment request for an agent\n   *\n   * Signs an HTTP request according to RFC 9421 so the agent can\n   * authenticate with merchants and card networks.\n   *\n   * Requirements:\n   * - Agent must have KYA tier >= 1\n   * - Agent must be active\n   * - Agent must have a signing key\n   * - Payment must be within spending limits\n   *\n   * @example\n   * ```typescript\n   * // Sign a payment request\n   * const signed = await payos.cards.signRequest('agent_123', {\n   *   method: 'POST',\n   *   path: '/api/checkout',\n   *   host: 'merchant.com',\n   *   body: JSON.stringify({ items: [...], total: 99.99 }),\n   *   payment: {\n   *     amount: 99.99,\n   *     currency: 'USD',\n   *     merchantName: 'Acme Store',\n   *   },\n   * });\n   *\n   * // Agent uses signed headers to call merchant\n   * const response = await fetch('https://merchant.com/api/checkout', {\n   *   method: 'POST',\n   *   headers: {\n   *     ...signed.headers,\n   *     'Content-Type': 'application/json',\n   *   },\n   *   body: JSON.stringify({ items: [...], total: 99.99 }),\n   * });\n   * ```\n   */\n  async signRequest(\n    agentId: string,\n    request: SignRequestInput\n  ): Promise<SignRequestResult> {\n    return this.client.request<SignRequestResult>(\n      `/v1/agents/${agentId}/sign-request`,\n      {\n        method: 'POST',\n        body: JSON.stringify(request),\n      }\n    );\n  }\n}\n"]}

package/dist/client-Cwe2CLU7.d.mts

@@ -0,0 +1,41 @@
+import { b as SlyConfig, c as SettlementQuoteRequest, S as SettlementQuote, d as CreateSettlementRequest, a as Settlement, e as ComplianceCheckRequest, C as ComplianceCheckResponse, f as CapabilitiesResponse } from './types-df1EICn_.mjs';
+
+/**
+ * Base API client for Sly
+ *
+ * Note: EVM key validation is intentionally NOT done here.
+ * The base client only makes REST API calls (Bearer token auth).
+ * Protocol-specific clients (x402, etc.) that need EVM signing
+ * validate the key themselves.
+ */
+declare class SlyClient {
+    private apiKey;
+    private apiUrl;
+    constructor(config: SlyConfig);
+    /**
+     * Make an authenticated API request
+     */
+    request<T>(path: string, options?: RequestInit): Promise<T>;
+    /**
+     * Get a settlement quote
+     */
+    getSettlementQuote(request: SettlementQuoteRequest): Promise<SettlementQuote>;
+    /**
+     * Create a settlement
+     */
+    createSettlement(request: CreateSettlementRequest): Promise<Settlement>;
+    /**
+     * Get settlement status
+     */
+    getSettlement(settlementId: string): Promise<Settlement>;
+    /**
+     * Check compliance for a recipient
+     */
+    checkCompliance(request: ComplianceCheckRequest): Promise<ComplianceCheckResponse>;
+    /**
+     * Get API capabilities
+     */
+    getCapabilities(): Promise<CapabilitiesResponse>;
+}
+
+export { SlyClient as S };

package/dist/client-CyJe3uWO.d.ts

@@ -0,0 +1,41 @@
+import { b as SlyConfig, c as SettlementQuoteRequest, S as SettlementQuote, d as CreateSettlementRequest, a as Settlement, e as ComplianceCheckRequest, C as ComplianceCheckResponse, f as CapabilitiesResponse } from './types-df1EICn_.js';
+
+/**
+ * Base API client for Sly
+ *
+ * Note: EVM key validation is intentionally NOT done here.
+ * The base client only makes REST API calls (Bearer token auth).
+ * Protocol-specific clients (x402, etc.) that need EVM signing
+ * validate the key themselves.
+ */
+declare class SlyClient {
+    private apiKey;
+    private apiUrl;
+    constructor(config: SlyConfig);
+    /**
+     * Make an authenticated API request
+     */
+    request<T>(path: string, options?: RequestInit): Promise<T>;
+    /**
+     * Get a settlement quote
+     */
+    getSettlementQuote(request: SettlementQuoteRequest): Promise<SettlementQuote>;
+    /**
+     * Create a settlement
+     */
+    createSettlement(request: CreateSettlementRequest): Promise<Settlement>;
+    /**
+     * Get settlement status
+     */
+    getSettlement(settlementId: string): Promise<Settlement>;
+    /**
+     * Check compliance for a recipient
+     */
+    checkCompliance(request: ComplianceCheckRequest): Promise<ComplianceCheckResponse>;
+    /**
+     * Get API capabilities
+     */
+    getCapabilities(): Promise<CapabilitiesResponse>;
+}
+
+export { SlyClient as S };