@sardis/sdk 0.2.0

package/dist/resources/a2a.js

@@ -0,0 +1,154 @@
+/**
+ * A2A (Agent-to-Agent) resource
+ *
+ * Provides inter-agent communication capabilities:
+ * - Discover other agents via agent cards
+ * - Send payment requests
+ * - Verify credentials
+ */
+import { BaseResource } from './base.js';
+// ============ Resource ============
+export class A2AResource extends BaseResource {
+    /**
+     * Discover an agent by URL
+     *
+     * Fetches the agent card from /.well-known/agent-card.json
+     *
+     * @example
+     * ```typescript
+     * const agent = await client.a2a.discoverAgent('https://agent.example.com');
+     * console.log(agent.card?.capabilities);
+     * ```
+     */
+    async discoverAgent(agentUrl, forceRefresh) {
+        return this._post('/api/v2/a2a/discover', {
+            agent_url: agentUrl,
+            force_refresh: forceRefresh,
+        });
+    }
+    /**
+     * Get our own agent card
+     *
+     * @example
+     * ```typescript
+     * const myCard = await client.a2a.getAgentCard();
+     * console.log(myCard.capabilities);
+     * ```
+     */
+    async getAgentCard() {
+        return this._get('/api/v2/a2a/agent-card');
+    }
+    /**
+     * List all discovered agents
+     *
+     * @example
+     * ```typescript
+     * const agents = await client.a2a.listAgents({
+     *   capability: 'payment.execute',
+     *   available_only: true,
+     * });
+     * ```
+     */
+    async listAgents(options) {
+        const response = await this._get('/api/v2/a2a/agents', options);
+        if (Array.isArray(response)) {
+            return response;
+        }
+        return response.agents || [];
+    }
+    /**
+     * Send a payment request to another agent
+     *
+     * @example
+     * ```typescript
+     * const response = await client.a2a.sendPaymentRequest({
+     *   recipient_agent_url: 'https://merchant.example.com',
+     *   amount_minor: 5000,
+     *   token: 'USDC',
+     *   chain: 'base',
+     *   destination: '0x...',
+     *   purpose: 'Order #12345',
+     * });
+     *
+     * if (response.success) {
+     *   console.log('Payment tx:', response.tx_hash);
+     * }
+     * ```
+     */
+    async sendPaymentRequest(input) {
+        return this._post('/api/v2/a2a/payment-request', input);
+    }
+    /**
+     * Request credential verification from another agent
+     *
+     * @example
+     * ```typescript
+     * const response = await client.a2a.verifyCredential({
+     *   recipient_agent_url: 'https://verifier.example.com',
+     *   credential_type: 'mandate',
+     *   credential_data: mandate,
+     * });
+     *
+     * if (response.valid) {
+     *   console.log('Credential verified!');
+     * }
+     * ```
+     */
+    async verifyCredential(input) {
+        return this._post('/api/v2/a2a/verify-credential', input);
+    }
+    /**
+     * Send a raw A2A message to another agent
+     *
+     * @example
+     * ```typescript
+     * const response = await client.a2a.sendMessage(
+     *   'https://agent.example.com',
+     *   {
+     *     message_type: 'custom',
+     *     payload: { action: 'notify', data: {...} },
+     *   }
+     * );
+     * ```
+     */
+    async sendMessage(recipientUrl, message) {
+        return this._post('/api/v2/a2a/messages', {
+            recipient_url: recipientUrl,
+            ...message,
+        });
+    }
+    /**
+     * List recent A2A messages
+     *
+     * @example
+     * ```typescript
+     * const messages = await client.a2a.listMessages({
+     *   direction: 'inbound',
+     *   message_type: 'payment_request',
+     * });
+     * ```
+     */
+    async listMessages(options) {
+        const response = await this._get('/api/v2/a2a/messages', options);
+        if (Array.isArray(response)) {
+            return response;
+        }
+        return response.messages || [];
+    }
+    /**
+     * Register an agent for discovery
+     *
+     * @example
+     * ```typescript
+     * await client.a2a.registerAgent({
+     *   agent_id: 'my_agent',
+     *   agent_name: 'My Agent',
+     *   agent_url: 'https://my-agent.example.com',
+     * });
+     * ```
+     */
+    async registerAgent(input) {
+        return this._post('/api/v2/a2a/agents/register', input);
+    }
+}
+//# sourceMappingURL=a2a.js.map

package/dist/resources/a2a.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.js","sourceRoot":"","sources":["../../src/resources/a2a.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAiIzC,qCAAqC;AAErC,MAAM,OAAO,WAAY,SAAQ,YAAY;IAC3C;;;;;;;;;;OAUG;IACH,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,YAAsB;QAC1D,OAAO,IAAI,CAAC,KAAK,CAAkB,sBAAsB,EAAE;YACzD,SAAS,EAAE,QAAQ;YACnB,aAAa,EAAE,YAAY;SAC5B,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,IAAI,CAAY,wBAAwB,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,UAAU,CAAC,OAKhB;QACC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAC9B,oBAAoB,EACpB,OAAO,CACR,CAAC;QAEF,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,kBAAkB,CAAC,KAA0B;QACjD,OAAO,IAAI,CAAC,KAAK,CAAkB,6BAA6B,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,gBAAgB,CAAC,KAA4B;QACjD,OAAO,IAAI,CAAC,KAAK,CAAqB,+BAA+B,EAAE,KAAK,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,WAAW,CACf,YAAoB,EACpB,OAA4B;QAE5B,OAAO,IAAI,CAAC,KAAK,CAAa,sBAAsB,EAAE;YACpD,aAAa,EAAE,YAAY;YAC3B,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,YAAY,CAAC,OAMlB;QACC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAC9B,sBAAsB,EACtB,OAAO,CACR,CAAC;QAEF,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,aAAa,CAAC,KAKnB;QACC,OAAO,IAAI,CAAC,KAAK,CAAkB,6BAA6B,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/dist/resources/agents.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Agents resource
+ *
+ * Agents are the core identity entities in Sardis. They can:
+ * - Own wallets
+ * - Issue mandates
+ * - Be subject to spending policies
+ */
+import { BaseResource } from './base.js';
+import type { Agent, CreateAgentInput, UpdateAgentInput, ListAgentsOptions, RequestOptions } from '../types.js';
+export declare class AgentsResource extends BaseResource {
+    private _normalize;
+    /**
+     * Create a new agent
+     *
+     * @example
+     * ```typescript
+     * const agent = await client.agents.create({
+     *   name: 'Shopping Agent',
+     *   description: 'Agent for e-commerce purchases',
+     *   spending_limits: {
+     *     per_transaction: '100.00',
+     *     daily: '500.00',
+     *   },
+     * });
+     * ```
+     */
+    create(input: CreateAgentInput, options?: RequestOptions): Promise<Agent>;
+    /**
+     * Get an agent by ID
+     *
+     * @example
+     * ```typescript
+     * const agent = await client.agents.get('agent_abc123');
+     * console.log(agent.name, agent.is_active);
+     * ```
+     */
+    get(agentId: string, options?: RequestOptions): Promise<Agent>;
+    /**
+     * List all agents
+     *
+     * @example
+     * ```typescript
+     * // List all agents
+     * const agents = await client.agents.list();
+     *
+     * // List with pagination
+     * const page = await client.agents.list({ limit: 10, offset: 20 });
+     *
+     * // List only active agents
+     * const active = await client.agents.list({ is_active: true });
+     * ```
+     */
+    list(options?: ListAgentsOptions): Promise<Agent[]>;
+    /**
+     * Update an agent
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.agents.update('agent_abc123', {
+     *   name: 'Updated Name',
+     *   is_active: false,
+     * });
+     * ```
+     */
+    update(agentId: string, input: UpdateAgentInput): Promise<Agent>;
+    /**
+     * Delete an agent
+     *
+     * Note: This is a soft delete - the agent is deactivated, not removed.
+     *
+     * @example
+     * ```typescript
+     * await client.agents.delete('agent_abc123');
+     * ```
+     */
+    delete(agentId: string): Promise<void>;
+    /**
+     * Get an agent's associated wallet
+     *
+     * @example
+     * ```typescript
+     * const wallet = await client.agents.getWallet('agent_abc123');
+     * console.log(wallet.addresses);
+     * ```
+     */
+    getWallet(agentId: string): Promise<{
+        wallet_id: string;
+        addresses: Record<string, string>;
+    }>;
+    /**
+     * Create a wallet for an agent
+     *
+     * @example
+     * ```typescript
+     * const wallet = await client.agents.createWallet('agent_abc123', {
+     *   currency: 'USDC',
+     *   limit_per_tx: '100.00',
+     * });
+     * ```
+     */
+    createWallet(agentId: string, options?: {
+        currency?: string;
+        limit_per_tx?: string;
+        limit_total?: string;
+    }): Promise<{
+        wallet_id: string;
+        addresses: Record<string, string>;
+    }>;
+}
+//# sourceMappingURL=agents.d.ts.map

package/dist/resources/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/resources/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EACV,KAAK,EACL,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,UAAU;IAQlB;;;;;;;;;;;;;;OAcG;IACG,MAAM,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAK/E;;;;;;;;OAQG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAKpE;;;;;;;;;;;;;;OAcG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAyBzD;;;;;;;;;;OAUG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IAKtE;;;;;;;;;OASG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;;;;;;;OAQG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAInG;;;;;;;;;;OAUG;IACG,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GACA,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CAGrE"}

package/dist/resources/agents.js

@@ -0,0 +1,138 @@
+/**
+ * Agents resource
+ *
+ * Agents are the core identity entities in Sardis. They can:
+ * - Own wallets
+ * - Issue mandates
+ * - Be subject to spending policies
+ */
+import { BaseResource } from './base.js';
+export class AgentsResource extends BaseResource {
+    _normalize(agent) {
+        // Provide backwards-compatible alias: id := agent_id
+        if (!agent.id) {
+            agent.id = agent.agent_id;
+        }
+        return agent;
+    }
+    /**
+     * Create a new agent
+     *
+     * @example
+     * ```typescript
+     * const agent = await client.agents.create({
+     *   name: 'Shopping Agent',
+     *   description: 'Agent for e-commerce purchases',
+     *   spending_limits: {
+     *     per_transaction: '100.00',
+     *     daily: '500.00',
+     *   },
+     * });
+     * ```
+     */
+    async create(input, options) {
+        const agent = await this._post('/api/v2/agents', input, options);
+        return this._normalize(agent);
+    }
+    /**
+     * Get an agent by ID
+     *
+     * @example
+     * ```typescript
+     * const agent = await client.agents.get('agent_abc123');
+     * console.log(agent.name, agent.is_active);
+     * ```
+     */
+    async get(agentId, options) {
+        const agent = await this._get(`/api/v2/agents/${agentId}`, undefined, options);
+        return this._normalize(agent);
+    }
+    /**
+     * List all agents
+     *
+     * @example
+     * ```typescript
+     * // List all agents
+     * const agents = await client.agents.list();
+     *
+     * // List with pagination
+     * const page = await client.agents.list({ limit: 10, offset: 20 });
+     *
+     * // List only active agents
+     * const active = await client.agents.list({ is_active: true });
+     * ```
+     */
+    async list(options) {
+        const params = {};
+        if (options?.limit !== undefined) {
+            params.limit = options.limit;
+        }
+        if (options?.offset !== undefined) {
+            params.offset = options.offset;
+        }
+        if (options?.is_active !== undefined) {
+            params.is_active = options.is_active;
+        }
+        const response = await this._get('/api/v2/agents', Object.keys(params).length > 0 ? params : undefined);
+        // Handle both array and object response formats
+        if (Array.isArray(response)) {
+            return response.map((a) => this._normalize(a));
+        }
+        return (response.agents || []).map((a) => this._normalize(a));
+    }
+    /**
+     * Update an agent
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.agents.update('agent_abc123', {
+     *   name: 'Updated Name',
+     *   is_active: false,
+     * });
+     * ```
+     */
+    async update(agentId, input) {
+        const agent = await this._patch(`/api/v2/agents/${agentId}`, input);
+        return this._normalize(agent);
+    }
+    /**
+     * Delete an agent
+     *
+     * Note: This is a soft delete - the agent is deactivated, not removed.
+     *
+     * @example
+     * ```typescript
+     * await client.agents.delete('agent_abc123');
+     * ```
+     */
+    async delete(agentId) {
+        await this._delete(`/api/v2/agents/${agentId}`);
+    }
+    /**
+     * Get an agent's associated wallet
+     *
+     * @example
+     * ```typescript
+     * const wallet = await client.agents.getWallet('agent_abc123');
+     * console.log(wallet.addresses);
+     * ```
+     */
+    async getWallet(agentId) {
+        return this._get(`/api/v2/agents/${agentId}/wallet`);
+    }
+    /**
+     * Create a wallet for an agent
+     *
+     * @example
+     * ```typescript
+     * const wallet = await client.agents.createWallet('agent_abc123', {
+     *   currency: 'USDC',
+     *   limit_per_tx: '100.00',
+     * });
+     * ```
+     */
+    async createWallet(agentId, options) {
+        return this._post(`/api/v2/agents/${agentId}/wallet`, options || {});
+    }
+}
+//# sourceMappingURL=agents.js.map

package/dist/resources/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/resources/agents.ts"],"names":[],"mappings":"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"}

package/dist/resources/base.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Base resource class for all API resources.
+ *
+ * Provides common HTTP methods with support for:
+ * - Request options (params, data, signal, timeout)
+ * - Request cancellation via AbortController
+ * - Consistent error handling
+ *
+ * @packageDocumentation
+ */
+import type { SardisClient } from '../client.js';
+import type { RequestOptions } from '../types.js';
+/**
+ * Abstract base class for API resources.
+ *
+ * All resource classes extend this class to gain access to
+ * HTTP methods that integrate with the SardisClient.
+ *
+ * @example
+ * ```typescript
+ * class MyResource extends BaseResource {
+ *   async getItem(id: string, options?: RequestOptions) {
+ *     return this._get<Item>(`/api/v2/items/${id}`, undefined, options);
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class BaseResource {
+    /**
+     * The SardisClient instance used for HTTP requests.
+     * @internal
+     */
+    protected client: SardisClient;
+    /**
+     * Creates a new BaseResource instance.
+     *
+     * @param client - The SardisClient instance
+     */
+    constructor(client: SardisClient);
+    /**
+     * Performs a GET request.
+     *
+     * @typeParam T - The expected response type
+     * @param path - API path
+     * @param params - Query parameters
+     * @param options - Request options (signal, timeout)
+     * @returns The response data
+     *
+     * @example
+     * ```typescript
+     * const result = await this._get<Item[]>('/api/v2/items', { limit: 10 });
+     * ```
+     */
+    protected _get<T>(path: string, params?: Record<string, unknown>, options?: RequestOptions): Promise<T>;
+    /**
+     * Performs a POST request.
+     *
+     * @typeParam T - The expected response type
+     * @param path - API path
+     * @param data - Request body
+     * @param options - Request options (signal, timeout)
+     * @returns The response data
+     *
+     * @example
+     * ```typescript
+     * const result = await this._post<Item>('/api/v2/items', { name: 'New Item' });
+     * ```
+     */
+    protected _post<T>(path: string, data?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Performs a PATCH request.
+     *
+     * @typeParam T - The expected response type
+     * @param path - API path
+     * @param data - Request body with partial updates
+     * @param options - Request options (signal, timeout)
+     * @returns The response data
+     *
+     * @example
+     * ```typescript
+     * const result = await this._patch<Item>('/api/v2/items/123', { name: 'Updated' });
+     * ```
+     */
+    protected _patch<T>(path: string, data?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Performs a PUT request.
+     *
+     * @typeParam T - The expected response type
+     * @param path - API path
+     * @param data - Request body
+     * @param options - Request options (signal, timeout)
+     * @returns The response data
+     *
+     * @example
+     * ```typescript
+     * const result = await this._put<Item>('/api/v2/items/123', { name: 'Replaced' });
+     * ```
+     */
+    protected _put<T>(path: string, data?: unknown, options?: RequestOptions): Promise<T>;
+    /**
+     * Performs a DELETE request.
+     *
+     * @typeParam T - The expected response type
+     * @param path - API path
+     * @param options - Request options (signal, timeout)
+     * @returns The response data (if any)
+     *
+     * @example
+     * ```typescript
+     * await this._delete('/api/v2/items/123');
+     * ```
+     */
+    protected _delete<T>(path: string, options?: RequestOptions): Promise<T>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/resources/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/resources/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,YAAY;IAChC;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC;IAE/B;;;;OAIG;gBACS,MAAM,EAAE,YAAY;IAIhC;;;;;;;;;;;;;OAaG;cACa,IAAI,CAAC,CAAC,EACpB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;IAIb;;;;;;;;;;;;;OAaG;cACa,KAAK,CAAC,CAAC,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;IAIb;;;;;;;;;;;;;OAaG;cACa,MAAM,CAAC,CAAC,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;IAIb;;;;;;;;;;;;;OAaG;cACa,IAAI,CAAC,CAAC,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;IAIb;;;;;;;;;;;;OAYG;cACa,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;CAG/E"}

package/dist/resources/base.js

@@ -0,0 +1,120 @@
+/**
+ * Base resource class for all API resources.
+ *
+ * Provides common HTTP methods with support for:
+ * - Request options (params, data, signal, timeout)
+ * - Request cancellation via AbortController
+ * - Consistent error handling
+ *
+ * @packageDocumentation
+ */
+/**
+ * Abstract base class for API resources.
+ *
+ * All resource classes extend this class to gain access to
+ * HTTP methods that integrate with the SardisClient.
+ *
+ * @example
+ * ```typescript
+ * class MyResource extends BaseResource {
+ *   async getItem(id: string, options?: RequestOptions) {
+ *     return this._get<Item>(`/api/v2/items/${id}`, undefined, options);
+ *   }
+ * }
+ * ```
+ */
+export class BaseResource {
+    /**
+     * Creates a new BaseResource instance.
+     *
+     * @param client - The SardisClient instance
+     */
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Performs a GET request.
+     *
+     * @typeParam T - The expected response type
+     * @param path - API path
+     * @param params - Query parameters
+     * @param options - Request options (signal, timeout)
+     * @returns The response data
+     *
+     * @example
+     * ```typescript
+     * const result = await this._get<Item[]>('/api/v2/items', { limit: 10 });
+     * ```
+     */
+    async _get(path, params, options) {
+        return this.client.request('GET', path, { ...options, params: params ?? options?.params });
+    }
+    /**
+     * Performs a POST request.
+     *
+     * @typeParam T - The expected response type
+     * @param path - API path
+     * @param data - Request body
+     * @param options - Request options (signal, timeout)
+     * @returns The response data
+     *
+     * @example
+     * ```typescript
+     * const result = await this._post<Item>('/api/v2/items', { name: 'New Item' });
+     * ```
+     */
+    async _post(path, data, options) {
+        return this.client.request('POST', path, { ...options, data: data ?? options?.data });
+    }
+    /**
+     * Performs a PATCH request.
+     *
+     * @typeParam T - The expected response type
+     * @param path - API path
+     * @param data - Request body with partial updates
+     * @param options - Request options (signal, timeout)
+     * @returns The response data
+     *
+     * @example
+     * ```typescript
+     * const result = await this._patch<Item>('/api/v2/items/123', { name: 'Updated' });
+     * ```
+     */
+    async _patch(path, data, options) {
+        return this.client.request('PATCH', path, { ...options, data: data ?? options?.data });
+    }
+    /**
+     * Performs a PUT request.
+     *
+     * @typeParam T - The expected response type
+     * @param path - API path
+     * @param data - Request body
+     * @param options - Request options (signal, timeout)
+     * @returns The response data
+     *
+     * @example
+     * ```typescript
+     * const result = await this._put<Item>('/api/v2/items/123', { name: 'Replaced' });
+     * ```
+     */
+    async _put(path, data, options) {
+        return this.client.request('PUT', path, { ...options, data: data ?? options?.data });
+    }
+    /**
+     * Performs a DELETE request.
+     *
+     * @typeParam T - The expected response type
+     * @param path - API path
+     * @param options - Request options (signal, timeout)
+     * @returns The response data (if any)
+     *
+     * @example
+     * ```typescript
+     * await this._delete('/api/v2/items/123');
+     * ```
+     */
+    async _delete(path, options) {
+        return this.client.request('DELETE', path, options);
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/resources/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/resources/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAgB,YAAY;IAOhC;;;;OAIG;IACH,YAAY,MAAoB;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACO,KAAK,CAAC,IAAI,CAClB,IAAY,EACZ,MAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAI,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAChG,CAAC;IAED;;;;;;;;;;;;;OAaG;IACO,KAAK,CAAC,KAAK,CACnB,IAAY,EACZ,IAAc,EACd,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAI,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;;;;;;;;;;OAaG;IACO,KAAK,CAAC,MAAM,CACpB,IAAY,EACZ,IAAc,EACd,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAI,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED;;;;;;;;;;;;;OAaG;IACO,KAAK,CAAC,IAAI,CAClB,IAAY,EACZ,IAAc,EACd,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAI,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED;;;;;;;;;;;;OAYG;IACO,KAAK,CAAC,OAAO,CAAI,IAAY,EAAE,OAAwB;QAC/D,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAI,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/resources/cards.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Cards Resource
+ *
+ * Virtual card issuance + simulated purchase demo flow.
+ */
+import { BaseResource } from './base.js';
+import type { Card, CardTransaction, IssueCardInput, UpdateCardLimitsInput, SimulateCardPurchaseInput, SimulateCardPurchaseResponse, RequestOptions } from '../types.js';
+export declare class CardsResource extends BaseResource {
+    issue(input: IssueCardInput, options?: RequestOptions): Promise<Card>;
+    list(wallet_id?: string, options?: RequestOptions): Promise<Card[]>;
+    get(card_id: string, options?: RequestOptions): Promise<Card>;
+    freeze(card_id: string, options?: RequestOptions): Promise<Card>;
+    unfreeze(card_id: string, options?: RequestOptions): Promise<Card>;
+    cancel(card_id: string, options?: RequestOptions): Promise<void>;
+    updateLimits(card_id: string, input: UpdateCardLimitsInput, options?: RequestOptions): Promise<Card>;
+    transactions(card_id: string, limit?: number, options?: RequestOptions): Promise<CardTransaction[]>;
+    simulatePurchase(card_id: string, input: SimulateCardPurchaseInput, options?: RequestOptions): Promise<SimulateCardPurchaseResponse>;
+}
+//# sourceMappingURL=cards.d.ts.map

package/dist/resources/cards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../../src/resources/cards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EACV,IAAI,EACJ,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EACzB,4BAA4B,EAC5B,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,qBAAa,aAAc,SAAQ,YAAY;IACvC,KAAK,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE,IAAI,CACR,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,EAAE,CAAC;IAMZ,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,qBAAqB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAIV,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAQvG,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,yBAAyB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,4BAA4B,CAAC;CAOzC"}