@sardis/sdk 0.2.0

package/dist/resources/ucp.d.ts

@@ -0,0 +1,218 @@
+/**
+ * UCP (Universal Commerce Protocol) resource
+ *
+ * Provides checkout session management for structured commerce:
+ * - Create checkout sessions with cart items
+ * - Update sessions (add/remove items, discounts)
+ * - Complete checkout and generate payment mandates
+ */
+import { BaseResource } from './base.js';
+export interface UCPLineItem {
+    item_id: string;
+    name: string;
+    description: string;
+    quantity: number;
+    unit_price_minor: number;
+    currency?: string;
+    sku?: string;
+    category?: string;
+    image_url?: string;
+    taxable?: boolean;
+    tax_rate?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UCPDiscount {
+    discount_id: string;
+    name: string;
+    discount_type: 'percentage' | 'fixed' | 'coupon';
+    value: string;
+    code?: string;
+    applied_to?: string[];
+    min_purchase_minor?: number;
+}
+export interface CreateCheckoutInput {
+    merchant_id: string;
+    merchant_name: string;
+    merchant_domain: string;
+    customer_id: string;
+    line_items: UCPLineItem[];
+    currency?: string;
+    tax_rate?: string;
+    shipping_minor?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateCheckoutInput {
+    add_items?: UCPLineItem[];
+    remove_item_ids?: string[];
+    add_discounts?: UCPDiscount[];
+    remove_discount_ids?: string[];
+    shipping_minor?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface CompleteCheckoutInput {
+    chain: string;
+    token: string;
+    destination: string;
+    subject: string;
+    issuer: string;
+    execute_payment?: boolean;
+}
+export interface CheckoutSession {
+    session_id: string;
+    merchant_id: string;
+    merchant_name: string;
+    merchant_domain: string;
+    customer_id: string;
+    status: 'open' | 'pending_payment' | 'completed' | 'expired' | 'cancelled';
+    currency: string;
+    line_items: UCPLineItem[];
+    discounts: UCPDiscount[];
+    subtotal_minor: number;
+    taxes_minor: number;
+    shipping_minor: number;
+    total_minor: number;
+    cart_mandate?: Record<string, unknown>;
+    checkout_mandate?: Record<string, unknown>;
+    payment_mandate?: Record<string, unknown>;
+    order_id?: string;
+    chain_tx_hash?: string;
+    created_at: string;
+    updated_at: string;
+    expires_at: number;
+    metadata?: Record<string, unknown>;
+}
+export interface CheckoutResult {
+    success: boolean;
+    session_id: string;
+    order_id?: string;
+    payment_mandate?: Record<string, unknown>;
+    chain_tx_hash?: string;
+    error?: string;
+    error_code?: string;
+}
+export interface UCPOrder {
+    order_id: string;
+    checkout_session_id: string;
+    merchant_id: string;
+    customer_id: string;
+    status: string;
+    line_items: UCPLineItem[];
+    currency: string;
+    subtotal_minor: number;
+    taxes_minor: number;
+    shipping_minor: number;
+    discount_minor: number;
+    total_minor: number;
+    payment_mandate_id?: string;
+    chain_tx_hash?: string;
+    created_at: string;
+    updated_at: string;
+    metadata?: Record<string, unknown>;
+}
+export declare class UCPResource extends BaseResource {
+    /**
+     * Create a new checkout session
+     *
+     * @example
+     * ```typescript
+     * const session = await client.ucp.createCheckout({
+     *   merchant_id: 'merchant_123',
+     *   merchant_name: 'Example Store',
+     *   merchant_domain: 'store.example.com',
+     *   customer_id: 'agent_abc',
+     *   line_items: [{
+     *     item_id: 'item_1',
+     *     name: 'Widget',
+     *     description: 'A useful widget',
+     *     quantity: 2,
+     *     unit_price_minor: 1000,
+     *   }],
+     * });
+     * ```
+     */
+    createCheckout(input: CreateCheckoutInput): Promise<CheckoutSession>;
+    /**
+     * Get a checkout session
+     *
+     * @example
+     * ```typescript
+     * const session = await client.ucp.getCheckout('cs_abc123');
+     * console.log(session.status, session.total_minor);
+     * ```
+     */
+    getCheckout(sessionId: string): Promise<CheckoutSession>;
+    /**
+     * Update a checkout session
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.ucp.updateCheckout('cs_abc123', {
+     *   add_items: [{ item_id: 'item_2', name: 'Extra', quantity: 1, unit_price_minor: 500 }],
+     *   add_discounts: [{
+     *     discount_id: 'disc_1',
+     *     name: '10% Off',
+     *     discount_type: 'percentage',
+     *     value: '10',
+     *   }],
+     * });
+     * ```
+     */
+    updateCheckout(sessionId: string, input: UpdateCheckoutInput): Promise<CheckoutSession>;
+    /**
+     * Complete a checkout session and generate payment mandate
+     *
+     * @example
+     * ```typescript
+     * const result = await client.ucp.completeCheckout('cs_abc123', {
+     *   chain: 'base',
+     *   token: 'USDC',
+     *   destination: '0x...',
+     *   subject: 'agent_abc',
+     *   issuer: 'sardis.sh',
+     * });
+     *
+     * if (result.success) {
+     *   console.log('Payment tx:', result.chain_tx_hash);
+     * }
+     * ```
+     */
+    completeCheckout(sessionId: string, input: CompleteCheckoutInput): Promise<CheckoutResult>;
+    /**
+     * Cancel a checkout session
+     *
+     * @example
+     * ```typescript
+     * await client.ucp.cancelCheckout('cs_abc123');
+     * ```
+     */
+    cancelCheckout(sessionId: string): Promise<CheckoutSession>;
+    /**
+     * Get an order by ID
+     *
+     * @example
+     * ```typescript
+     * const order = await client.ucp.getOrder('ord_abc123');
+     * console.log(order.status, order.chain_tx_hash);
+     * ```
+     */
+    getOrder(orderId: string): Promise<UCPOrder>;
+    /**
+     * List orders
+     *
+     * @example
+     * ```typescript
+     * const orders = await client.ucp.listOrders({
+     *   customer_id: 'agent_abc',
+     *   status: 'completed',
+     * });
+     * ```
+     */
+    listOrders(options?: {
+        customer_id?: string;
+        merchant_id?: string;
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<UCPOrder[]>;
+}
+//# sourceMappingURL=ucp.d.ts.map

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

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

package/dist/resources/ucp.js

@@ -0,0 +1,129 @@
+/**
+ * UCP (Universal Commerce Protocol) resource
+ *
+ * Provides checkout session management for structured commerce:
+ * - Create checkout sessions with cart items
+ * - Update sessions (add/remove items, discounts)
+ * - Complete checkout and generate payment mandates
+ */
+import { BaseResource } from './base.js';
+// ============ Resource ============
+export class UCPResource extends BaseResource {
+    /**
+     * Create a new checkout session
+     *
+     * @example
+     * ```typescript
+     * const session = await client.ucp.createCheckout({
+     *   merchant_id: 'merchant_123',
+     *   merchant_name: 'Example Store',
+     *   merchant_domain: 'store.example.com',
+     *   customer_id: 'agent_abc',
+     *   line_items: [{
+     *     item_id: 'item_1',
+     *     name: 'Widget',
+     *     description: 'A useful widget',
+     *     quantity: 2,
+     *     unit_price_minor: 1000,
+     *   }],
+     * });
+     * ```
+     */
+    async createCheckout(input) {
+        return this._post('/api/v2/ucp/checkout', input);
+    }
+    /**
+     * Get a checkout session
+     *
+     * @example
+     * ```typescript
+     * const session = await client.ucp.getCheckout('cs_abc123');
+     * console.log(session.status, session.total_minor);
+     * ```
+     */
+    async getCheckout(sessionId) {
+        return this._get(`/api/v2/ucp/checkout/${sessionId}`);
+    }
+    /**
+     * Update a checkout session
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.ucp.updateCheckout('cs_abc123', {
+     *   add_items: [{ item_id: 'item_2', name: 'Extra', quantity: 1, unit_price_minor: 500 }],
+     *   add_discounts: [{
+     *     discount_id: 'disc_1',
+     *     name: '10% Off',
+     *     discount_type: 'percentage',
+     *     value: '10',
+     *   }],
+     * });
+     * ```
+     */
+    async updateCheckout(sessionId, input) {
+        return this._patch(`/api/v2/ucp/checkout/${sessionId}`, input);
+    }
+    /**
+     * Complete a checkout session and generate payment mandate
+     *
+     * @example
+     * ```typescript
+     * const result = await client.ucp.completeCheckout('cs_abc123', {
+     *   chain: 'base',
+     *   token: 'USDC',
+     *   destination: '0x...',
+     *   subject: 'agent_abc',
+     *   issuer: 'sardis.sh',
+     * });
+     *
+     * if (result.success) {
+     *   console.log('Payment tx:', result.chain_tx_hash);
+     * }
+     * ```
+     */
+    async completeCheckout(sessionId, input) {
+        return this._post(`/api/v2/ucp/checkout/${sessionId}/complete`, input);
+    }
+    /**
+     * Cancel a checkout session
+     *
+     * @example
+     * ```typescript
+     * await client.ucp.cancelCheckout('cs_abc123');
+     * ```
+     */
+    async cancelCheckout(sessionId) {
+        return this._post(`/api/v2/ucp/checkout/${sessionId}/cancel`, {});
+    }
+    /**
+     * Get an order by ID
+     *
+     * @example
+     * ```typescript
+     * const order = await client.ucp.getOrder('ord_abc123');
+     * console.log(order.status, order.chain_tx_hash);
+     * ```
+     */
+    async getOrder(orderId) {
+        return this._get(`/api/v2/ucp/orders/${orderId}`);
+    }
+    /**
+     * List orders
+     *
+     * @example
+     * ```typescript
+     * const orders = await client.ucp.listOrders({
+     *   customer_id: 'agent_abc',
+     *   status: 'completed',
+     * });
+     * ```
+     */
+    async listOrders(options) {
+        const response = await this._get('/api/v2/ucp/orders', options);
+        if (Array.isArray(response)) {
+            return response;
+        }
+        return response.orders || [];
+    }
+}
+//# sourceMappingURL=ucp.js.map

package/dist/resources/ucp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ucp.js","sourceRoot":"","sources":["../../src/resources/ucp.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAkHzC,qCAAqC;AAErC,MAAM,OAAO,WAAY,SAAQ,YAAY;IAC3C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,cAAc,CAAC,KAA0B;QAC7C,OAAO,IAAI,CAAC,KAAK,CAAkB,sBAAsB,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,WAAW,CAAC,SAAiB;QACjC,OAAO,IAAI,CAAC,IAAI,CAAkB,wBAAwB,SAAS,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,cAAc,CAAC,SAAiB,EAAE,KAA0B;QAChE,OAAO,IAAI,CAAC,MAAM,CAAkB,wBAAwB,SAAS,EAAE,EAAE,KAAK,CAAC,CAAC;IAClF,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,gBAAgB,CAAC,SAAiB,EAAE,KAA4B;QACpE,OAAO,IAAI,CAAC,KAAK,CAAiB,wBAAwB,SAAS,WAAW,EAAE,KAAK,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,cAAc,CAAC,SAAiB;QACpC,OAAO,IAAI,CAAC,KAAK,CAAkB,wBAAwB,SAAS,SAAS,EAAE,EAAE,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAW,sBAAsB,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,UAAU,CAAC,OAMhB;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;CACF"}

package/dist/resources/wallets.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Wallets Resource
+ *
+ * Manages non-custodial wallets for agents.
+ * Wallets never hold funds - they only sign transactions via MPC.
+ */
+import { BaseResource } from './base.js';
+import type { Wallet, WalletBalance, CreateWalletInput, SetAddressInput, WalletTransferInput, WalletTransferResponse, RequestOptions } from '../types.js';
+export declare class WalletsResource extends BaseResource {
+    private _normalize;
+    /**
+     * Create a new non-custodial wallet for an agent.
+     *
+     * @param input Wallet creation parameters
+     * @param options Request options (signal, timeout)
+     * @returns Created wallet
+     */
+    create(input: CreateWalletInput, options?: RequestOptions): Promise<Wallet>;
+    /**
+     * Get a wallet by ID.
+     *
+     * @param walletId Wallet ID
+     * @param options Request options (signal, timeout)
+     * @returns Wallet details
+     */
+    get(walletId: string, options?: RequestOptions): Promise<Wallet>;
+    /**
+     * List wallets.
+     *
+     * @param agentId Optional agent ID filter
+     * @param limit Maximum number of wallets to return
+     * @param options Request options (signal, timeout)
+     * @returns List of wallets
+     */
+    list(agentId?: string, limit?: number, options?: RequestOptions): Promise<Wallet[]>;
+    /**
+     * Get wallet balance from chain (non-custodial, read-only).
+     *
+     * @param walletId Wallet ID
+     * @param chain Chain identifier (e.g., "base", "polygon")
+     * @param token Token symbol (e.g., "USDC", "USDT")
+     * @param options Request options (signal, timeout)
+     * @returns Wallet balance from chain
+     */
+    getBalance(walletId: string, chain?: string, token?: string, options?: RequestOptions): Promise<WalletBalance>;
+    /**
+     * Get all wallet addresses (chain -> address mapping).
+     *
+     * @param walletId Wallet ID
+     * @param options Request options (signal, timeout)
+     * @returns Dictionary mapping chain names to addresses
+     */
+    getAddresses(walletId: string, options?: RequestOptions): Promise<Record<string, string>>;
+    /**
+     * Set wallet address for a chain.
+     *
+     * @param walletId Wallet ID
+     * @param input Address information
+     * @param options Request options (signal, timeout)
+     * @returns Updated wallet
+     */
+    setAddress(walletId: string, input: SetAddressInput, options?: RequestOptions): Promise<Wallet>;
+    /**
+     * Transfer stablecoins from a wallet (agent is sender).
+     *
+     * This endpoint is intended to be called by an agent process using an API key.
+     * Sardis enforces policy + compliance and signs via the agent MPC wallet.
+     */
+    transfer(walletId: string, input: WalletTransferInput, options?: RequestOptions): Promise<WalletTransferResponse>;
+}
+//# sourceMappingURL=wallets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wallets.d.ts","sourceRoot":"","sources":["../../src/resources/wallets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EACV,MAAM,EACN,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,UAAU;IAQlB;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAKjF;;;;;;OAMG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAKtE;;;;;;;OAOG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkB9F;;;;;;;;OAQG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAe,EACtB,KAAK,GAAE,MAAe,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC;IAOzB;;;;;;OAMG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAQ/F;;;;;;;OAOG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC;IASlB;;;;;OAKG;IACG,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,mBAAmB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,sBAAsB,CAAC;CAOnC"}

package/dist/resources/wallets.js

@@ -0,0 +1,105 @@
+/**
+ * Wallets Resource
+ *
+ * Manages non-custodial wallets for agents.
+ * Wallets never hold funds - they only sign transactions via MPC.
+ */
+import { BaseResource } from './base.js';
+export class WalletsResource extends BaseResource {
+    _normalize(wallet) {
+        // Provide backwards-compatible alias: id := wallet_id
+        if (!wallet.id) {
+            wallet.id = wallet.wallet_id;
+        }
+        return wallet;
+    }
+    /**
+     * Create a new non-custodial wallet for an agent.
+     *
+     * @param input Wallet creation parameters
+     * @param options Request options (signal, timeout)
+     * @returns Created wallet
+     */
+    async create(input, options) {
+        const wallet = await this._post('/api/v2/wallets', input, options);
+        return this._normalize(wallet);
+    }
+    /**
+     * Get a wallet by ID.
+     *
+     * @param walletId Wallet ID
+     * @param options Request options (signal, timeout)
+     * @returns Wallet details
+     */
+    async get(walletId, options) {
+        const wallet = await this._get(`/api/v2/wallets/${walletId}`, undefined, options);
+        return this._normalize(wallet);
+    }
+    /**
+     * List wallets.
+     *
+     * @param agentId Optional agent ID filter
+     * @param limit Maximum number of wallets to return
+     * @param options Request options (signal, timeout)
+     * @returns List of wallets
+     */
+    async list(agentId, limit = 100, options) {
+        const params = { limit };
+        if (agentId) {
+            params.agent_id = agentId;
+        }
+        const response = await this._get('/api/v2/wallets', params, options);
+        // Handle both array and object response formats
+        if (Array.isArray(response)) {
+            return response.map((w) => this._normalize(w));
+        }
+        return (response.wallets || []).map((w) => this._normalize(w));
+    }
+    /**
+     * Get wallet balance from chain (non-custodial, read-only).
+     *
+     * @param walletId Wallet ID
+     * @param chain Chain identifier (e.g., "base", "polygon")
+     * @param token Token symbol (e.g., "USDC", "USDT")
+     * @param options Request options (signal, timeout)
+     * @returns Wallet balance from chain
+     */
+    async getBalance(walletId, chain = 'base', token = 'USDC', options) {
+        return this._get(`/api/v2/wallets/${walletId}/balance`, {
+            chain,
+            token,
+        }, options);
+    }
+    /**
+     * Get all wallet addresses (chain -> address mapping).
+     *
+     * @param walletId Wallet ID
+     * @param options Request options (signal, timeout)
+     * @returns Dictionary mapping chain names to addresses
+     */
+    async getAddresses(walletId, options) {
+        return this._get(`/api/v2/wallets/${walletId}/addresses`, undefined, options);
+    }
+    /**
+     * Set wallet address for a chain.
+     *
+     * @param walletId Wallet ID
+     * @param input Address information
+     * @param options Request options (signal, timeout)
+     * @returns Updated wallet
+     */
+    async setAddress(walletId, input, options) {
+        const wallet = await this._post(`/api/v2/wallets/${walletId}/addresses`, input, options);
+        return this._normalize(wallet);
+    }
+    /**
+     * Transfer stablecoins from a wallet (agent is sender).
+     *
+     * This endpoint is intended to be called by an agent process using an API key.
+     * Sardis enforces policy + compliance and signs via the agent MPC wallet.
+     */
+    async transfer(walletId, input, options) {
+        return this._post(`/api/v2/wallets/${walletId}/transfer`, input, options);
+    }
+}
+//# sourceMappingURL=wallets.js.map

package/dist/resources/wallets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallets.js","sourceRoot":"","sources":["../../src/resources/wallets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAWzC,MAAM,OAAO,eAAgB,SAAQ,YAAY;IACvC,UAAU,CAAC,MAAc;QAC/B,sDAAsD;QACtD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,MAAoC,CAAC,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC;QAC9D,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,KAAwB,EAAE,OAAwB;QAC7D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAS,iBAAiB,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,OAAwB;QAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAS,mBAAmB,QAAQ,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC1F,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CAAC,OAAgB,EAAE,QAAgB,GAAG,EAAE,OAAwB;QACxE,MAAM,MAAM,GAA4B,EAAE,KAAK,EAAE,CAAC;QAClD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC;QAC5B,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAC9B,iBAAiB,EACjB,MAAM,EACN,OAAO,CACR,CAAC;QAEF,gDAAgD;QAChD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,UAAU,CACd,QAAgB,EAChB,QAAgB,MAAM,EACtB,QAAgB,MAAM,EACtB,OAAwB;QAExB,OAAO,IAAI,CAAC,IAAI,CAAgB,mBAAmB,QAAQ,UAAU,EAAE;YACrE,KAAK;YACL,KAAK;SACN,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,IAAI,CACd,mBAAmB,QAAQ,YAAY,EACvC,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,CACd,QAAgB,EAChB,KAAsB,EACtB,OAAwB;QAExB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAC7B,mBAAmB,QAAQ,YAAY,EACvC,KAAK,EACL,OAAO,CACR,CAAC;QACF,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CACZ,QAAgB,EAChB,KAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAI,CAAC,KAAK,CACf,mBAAmB,QAAQ,WAAW,EACtC,KAAK,EACL,OAAO,CACR,CAAC;IACJ,CAAC;CACF"}

package/dist/resources/webhooks.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Webhooks resource
+ */
+import { BaseResource } from './base.js';
+import type { Webhook, WebhookDelivery, CreateWebhookInput, UpdateWebhookInput } from '../types.js';
+export declare class WebhooksResource extends BaseResource {
+    /**
+     * List all available webhook event types
+     */
+    listEventTypes(): Promise<string[]>;
+    /**
+     * Create a webhook subscription
+     */
+    create(input: CreateWebhookInput): Promise<Webhook>;
+    /**
+     * List all webhook subscriptions
+     */
+    list(): Promise<Webhook[]>;
+    /**
+     * Get a webhook subscription by ID
+     *
+     * @param webhookId - The webhook ID
+     * @returns The webhook object
+     */
+    get(webhookId: string): Promise<Webhook>;
+    /**
+     * Get a webhook subscription by ID
+     *
+     * @deprecated Use `get(webhookId)` instead. This method will be removed in v1.0.0.
+     * @param webhookId - The webhook ID
+     * @returns The webhook object
+     */
+    getById(webhookId: string): Promise<Webhook>;
+    /**
+     * Update a webhook subscription
+     */
+    update(webhookId: string, input: UpdateWebhookInput): Promise<Webhook>;
+    /**
+     * Delete a webhook subscription
+     */
+    delete(webhookId: string): Promise<void>;
+    /**
+     * Send a test event to a webhook
+     */
+    test(webhookId: string): Promise<WebhookDelivery>;
+    /**
+     * List delivery attempts for a webhook
+     */
+    listDeliveries(webhookId: string, limit?: number): Promise<WebhookDelivery[]>;
+    /**
+     * Rotate the webhook signing secret
+     */
+    rotateSecret(webhookId: string): Promise<{
+        secret: string;
+    }>;
+}
+//# sourceMappingURL=webhooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/resources/webhooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEpG,qBAAa,gBAAiB,SAAQ,YAAY;IAChD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKzC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAKhC;;;;;OAKG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C;;;;;;OAMG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlD;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5E;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAIvD;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAQvF;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAGnE"}

package/dist/resources/webhooks.js

@@ -0,0 +1,77 @@
+/**
+ * Webhooks resource
+ */
+import { BaseResource } from './base.js';
+export class WebhooksResource extends BaseResource {
+    /**
+     * List all available webhook event types
+     */
+    async listEventTypes() {
+        const response = await this._get('/api/v2/webhooks/event-types');
+        return response.event_types || [];
+    }
+    /**
+     * Create a webhook subscription
+     */
+    async create(input) {
+        return this._post('/api/v2/webhooks', input);
+    }
+    /**
+     * List all webhook subscriptions
+     */
+    async list() {
+        const response = await this._get('/api/v2/webhooks');
+        return response.webhooks || [];
+    }
+    /**
+     * Get a webhook subscription by ID
+     *
+     * @param webhookId - The webhook ID
+     * @returns The webhook object
+     */
+    async get(webhookId) {
+        return this._get(`/api/v2/webhooks/${webhookId}`);
+    }
+    /**
+     * Get a webhook subscription by ID
+     *
+     * @deprecated Use `get(webhookId)` instead. This method will be removed in v1.0.0.
+     * @param webhookId - The webhook ID
+     * @returns The webhook object
+     */
+    async getById(webhookId) {
+        return this.get(webhookId);
+    }
+    /**
+     * Update a webhook subscription
+     */
+    async update(webhookId, input) {
+        return this._patch(`/api/v2/webhooks/${webhookId}`, input);
+    }
+    /**
+     * Delete a webhook subscription
+     */
+    async delete(webhookId) {
+        await this._delete(`/api/v2/webhooks/${webhookId}`);
+    }
+    /**
+     * Send a test event to a webhook
+     */
+    async test(webhookId) {
+        return this._post(`/api/v2/webhooks/${webhookId}/test`, {});
+    }
+    /**
+     * List delivery attempts for a webhook
+     */
+    async listDeliveries(webhookId, limit = 50) {
+        const response = await this._get(`/api/v2/webhooks/${webhookId}/deliveries`, { limit });
+        return response.deliveries || [];
+    }
+    /**
+     * Rotate the webhook signing secret
+     */
+    async rotateSecret(webhookId) {
+        return this._post(`/api/v2/webhooks/${webhookId}/rotate-secret`, {});
+    }
+}
+//# sourceMappingURL=webhooks.js.map