@ritkey/sdk 0.1.0

package/dist/client/webhooks.js

@@ -0,0 +1,49 @@
+/**
+ * Webhook subscription management.
+ *
+ *   POST   /webhooks                       create()
+ *   GET    /webhooks                       list()
+ *   GET    /webhooks/events                listEventTypes()
+ *   GET    /webhooks/:id                   get(id)
+ *   PATCH  /webhooks/:id                   update(id, ...)
+ *   DELETE /webhooks/:id                   delete(id)
+ *   POST   /webhooks/:id/test              test(id)
+ *   GET    /webhooks/:id/deliveries        listDeliveries(id)
+ */
+export class WebhooksClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Create a new webhook subscription. Response includes `secret` — save it. */
+    async create(input) {
+        return this.http.request('POST', '/webhooks', input);
+    }
+    async list() {
+        return this.http.request('GET', '/webhooks');
+    }
+    async listEventTypes() {
+        return this.http.request('GET', '/webhooks/events');
+    }
+    async get(subscriptionId) {
+        return this.http.request('GET', `/webhooks/${encodeURIComponent(subscriptionId)}`);
+    }
+    async update(subscriptionId, patch) {
+        return this.http.request('PATCH', `/webhooks/${encodeURIComponent(subscriptionId)}`, patch);
+    }
+    async delete(subscriptionId) {
+        await this.http.request('DELETE', `/webhooks/${encodeURIComponent(subscriptionId)}`);
+    }
+    /**
+     * Fire a `webhook.test` event to this subscription only.
+     * Useful for verifying connectivity and HMAC verification on your receiver.
+     */
+    async test(subscriptionId) {
+        return this.http.request('POST', `/webhooks/${encodeURIComponent(subscriptionId)}/test`);
+    }
+    async listDeliveries(subscriptionId, opts) {
+        const qs = opts?.limit ? `?limit=${opts.limit}` : '';
+        return this.http.request('GET', `/webhooks/${encodeURIComponent(subscriptionId)}/deliveries${qs}`);
+    }
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/client/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/client/webhooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD,+EAA+E;IAC/E,KAAK,CAAC,MAAM,CAAC,KAAyB;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAiB,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CACtB,KAAK,EACL,WAAW,CACZ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc;QAKlB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,cAAsB;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CACtB,KAAK,EACL,aAAa,kBAAkB,CAAC,cAAc,CAAC,EAAE,CAClD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CACV,cAAsB,EACtB,KAAyB;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CACtB,OAAO,EACP,aAAa,kBAAkB,CAAC,cAAc,CAAC,EAAE,EACjD,KAAK,CACN,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,cAAsB;QACjC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CACrB,QAAQ,EACR,aAAa,kBAAkB,CAAC,cAAc,CAAC,EAAE,CAClD,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,cAAsB;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CACtB,MAAM,EACN,aAAa,kBAAkB,CAAC,cAAc,CAAC,OAAO,CACvD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,cAAsB,EACtB,IAAyB;QAEzB,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CACtB,KAAK,EACL,aAAa,kBAAkB,CAAC,cAAc,CAAC,cAAc,EAAE,EAAE,CAClE,CAAC;IACJ,CAAC;CACF"}

package/dist/events/poller.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Typed event poller.
+ *
+ * For apps that don't want to operate a public HTTPS endpoint, the SDK can
+ * poll `GET /events` and emit events to callbacks. This is the fallback for
+ * environments where webhooks aren't practical (CLIs, scripts, dev loops).
+ *
+ * Production traffic should still use webhooks — polling is rate-limited
+ * by the underlying service and burns more API budget.
+ *
+ * Usage:
+ *   const stop = client.events.subscribe({
+ *     types: ['tx.sent', 'wallet.funded'],
+ *     onEvent: (event) => console.log(event),
+ *   });
+ *   // ... later
+ *   stop();
+ */
+import type { HttpTransport } from '../transport.js';
+import type { RitkeyEvent, EventType } from '../types.js';
+export interface SubscribeOptions {
+    /** Subset of event types to filter on. Default: all. */
+    types?: EventType[];
+    /** Restrict to a specific wallet. */
+    walletId?: string;
+    /** Maximum events to fetch per poll. Default: 50. */
+    batchSize?: number;
+    /** Poll interval in milliseconds. Default: 3000. */
+    intervalMs?: number;
+    /** Per-event callback. */
+    onEvent: (event: RitkeyEvent) => void | Promise<void>;
+    /** Optional error handler. If not set, errors are logged with console.error. */
+    onError?: (err: unknown) => void;
+}
+/** Returned by subscribe() — call it to stop polling. */
+export type StopFn = () => void;
+export declare class EventsClient {
+    private readonly http;
+    constructor(http: HttpTransport);
+    /**
+     * Subscribe to events via polling. Returns a stop function.
+     *
+     * The poller tracks the most-recent event id it has seen to avoid emitting
+     * duplicates across polls (server returns events newest-first by created_at;
+     * we de-dupe client-side using id).
+     */
+    subscribe(opts: SubscribeOptions): StopFn;
+    /**
+     * One-shot fetch of recent events (no polling).
+     */
+    list(opts?: {
+        walletId?: string;
+        type?: EventType;
+        limit?: number;
+    }): Promise<RitkeyEvent[]>;
+}
+//# sourceMappingURL=poller.d.ts.map

package/dist/events/poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poller.d.ts","sourceRoot":"","sources":["../../src/events/poller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,gFAAgF;IAChF,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAClC;AAED,yDAAyD;AACzD,MAAM,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC;AAOhC,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAEhD;;;;;;OAMG;IACH,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM;IA0EzC;;OAEG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAS3B"}

package/dist/events/poller.js

@@ -0,0 +1,121 @@
+/**
+ * Typed event poller.
+ *
+ * For apps that don't want to operate a public HTTPS endpoint, the SDK can
+ * poll `GET /events` and emit events to callbacks. This is the fallback for
+ * environments where webhooks aren't practical (CLIs, scripts, dev loops).
+ *
+ * Production traffic should still use webhooks — polling is rate-limited
+ * by the underlying service and burns more API budget.
+ *
+ * Usage:
+ *   const stop = client.events.subscribe({
+ *     types: ['tx.sent', 'wallet.funded'],
+ *     onEvent: (event) => console.log(event),
+ *   });
+ *   // ... later
+ *   stop();
+ */
+export class EventsClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Subscribe to events via polling. Returns a stop function.
+     *
+     * The poller tracks the most-recent event id it has seen to avoid emitting
+     * duplicates across polls (server returns events newest-first by created_at;
+     * we de-dupe client-side using id).
+     */
+    subscribe(opts) {
+        const intervalMs = opts.intervalMs ?? 3000;
+        const batchSize = opts.batchSize ?? 50;
+        const filterTypes = opts.types ? new Set(opts.types) : null;
+        const seenIds = new Set();
+        // Don't replay the existing event backlog on first poll — only emit
+        // events we observe AFTER subscribe() is called. We seed `seenIds` with
+        // the current tail of the log on first fetch.
+        let primed = false;
+        let stopped = false;
+        const poll = async () => {
+            if (stopped)
+                return;
+            try {
+                const qs = [`limit=${batchSize}`];
+                if (opts.walletId)
+                    qs.push(`walletId=${encodeURIComponent(opts.walletId)}`);
+                // We don't pass `type=` because we may want to subscribe to N types;
+                // we filter client-side instead.
+                const res = await this.http.request('GET', `/events?${qs.join('&')}`);
+                const events = res.events ?? [];
+                if (!primed) {
+                    // Seed the seen-set with everything currently in the log;
+                    // we don't replay history.
+                    for (const ev of events)
+                        seenIds.add(ev.id);
+                    primed = true;
+                    return;
+                }
+                // Emit newest events we haven't seen yet, in chronological order.
+                const fresh = events.filter((ev) => !seenIds.has(ev.id)).reverse();
+                for (const ev of fresh) {
+                    seenIds.add(ev.id);
+                    if (filterTypes && !filterTypes.has(ev.type))
+                        continue;
+                    try {
+                        await opts.onEvent(ev);
+                    }
+                    catch (handlerErr) {
+                        if (opts.onError)
+                            opts.onError(handlerErr);
+                        else
+                            console.error('[ritkey/sdk] event handler threw:', handlerErr);
+                    }
+                }
+                // Prevent seenIds from growing unbounded. Keep last ~10k.
+                if (seenIds.size > 10_000) {
+                    const overflow = seenIds.size - 5_000;
+                    const it = seenIds.values();
+                    for (let i = 0; i < overflow; i++) {
+                        const next = it.next();
+                        if (next.done)
+                            break;
+                        seenIds.delete(next.value);
+                    }
+                }
+            }
+            catch (err) {
+                if (opts.onError)
+                    opts.onError(err);
+                else
+                    console.error('[ritkey/sdk] poll failed:', err);
+            }
+        };
+        // Kick off first poll immediately, then on the interval.
+        void poll();
+        const handle = setInterval(() => void poll(), intervalMs);
+        // Don't block process exit on the timer.
+        handle.unref?.();
+        return () => {
+            stopped = true;
+            clearInterval(handle);
+        };
+    }
+    /**
+     * One-shot fetch of recent events (no polling).
+     */
+    async list(opts) {
+        const qs = [];
+        if (opts?.walletId)
+            qs.push(`walletId=${encodeURIComponent(opts.walletId)}`);
+        if (opts?.type)
+            qs.push(`type=${encodeURIComponent(opts.type)}`);
+        if (opts?.limit)
+            qs.push(`limit=${opts.limit}`);
+        const path = `/events${qs.length ? '?' + qs.join('&') : ''}`;
+        const res = await this.http.request('GET', path);
+        return res.events ?? [];
+    }
+}
+//# sourceMappingURL=poller.js.map

package/dist/events/poller.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @ritkey/sdk — TypeScript SDK for Ritkey
+ *
+ * Public surface:
+ *   - RitkeyClient: wallet, webhook, events operations
+ *   - verifyWebhook: receiver-side HMAC verification helper
+ *   - isEvent: type narrower for verified events
+ *   - All public types
+ */
+export { RitkeyClient } from './client/index.js';
+export { WalletsClient } from './client/wallets.js';
+export { WebhooksClient } from './client/webhooks.js';
+export { AlertsClient } from './client/alerts.js';
+export { EventsClient } from './events/poller.js';
+export { verifyWebhook, isEvent } from './verify/index.js';
+export type { VerifyOptions, VerifyResult } from './verify/index.js';
+export type { SubscribeOptions, StopFn } from './events/poller.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACrE,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACnE,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @ritkey/sdk — TypeScript SDK for Ritkey
+ *
+ * Public surface:
+ *   - RitkeyClient: wallet, webhook, events operations
+ *   - verifyWebhook: receiver-side HMAC verification helper
+ *   - isEvent: type narrower for verified events
+ *   - All public types
+ */
+export { RitkeyClient } from './client/index.js';
+export { WalletsClient } from './client/wallets.js';
+export { WebhooksClient } from './client/webhooks.js';
+export { AlertsClient } from './client/alerts.js';
+export { EventsClient } from './events/poller.js';
+export { verifyWebhook, isEvent } from './verify/index.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG3D,cAAc,YAAY,CAAC"}

package/dist/transport.d.ts

@@ -0,0 +1,21 @@
+/**
+ * HTTP transport for the Ritkey SDK.
+ *
+ * Wraps `fetch` with:
+ *   - default headers (Authorization + content-type)
+ *   - per-request timeout (AbortController)
+ *   - JSON serialization/parsing
+ *   - rich error type that captures status, code, and parsed body
+ */
+import { type RitkeyClientConfig } from './types.js';
+export declare class HttpTransport {
+    private readonly baseUrl;
+    private readonly apiKey?;
+    private readonly fetchImpl;
+    private readonly timeoutMs;
+    constructor(config: RitkeyClientConfig);
+    request<T = unknown>(method: 'GET' | 'POST' | 'PATCH' | 'DELETE', path: string, body?: unknown, opts?: {
+        timeoutMs?: number;
+    }): Promise<T>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIlE,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,kBAAkB;IAehC,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,EAC3C,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5B,OAAO,CAAC,CAAC,CAAC;CAwDd"}

package/dist/transport.js

@@ -0,0 +1,83 @@
+/**
+ * HTTP transport for the Ritkey SDK.
+ *
+ * Wraps `fetch` with:
+ *   - default headers (Authorization + content-type)
+ *   - per-request timeout (AbortController)
+ *   - JSON serialization/parsing
+ *   - rich error type that captures status, code, and parsed body
+ */
+import { RitkeyError } from './types.js';
+export class HttpTransport {
+    baseUrl;
+    apiKey;
+    fetchImpl;
+    timeoutMs;
+    constructor(config) {
+        if (!config.baseUrl)
+            throw new Error('RitkeyClient: baseUrl is required');
+        // Strip trailing slash so path joins are simple.
+        this.baseUrl = config.baseUrl.replace(/\/+$/, '');
+        this.apiKey = config.apiKey;
+        this.fetchImpl = (config.fetch ?? globalThis.fetch).bind(globalThis);
+        this.timeoutMs = config.timeoutMs ?? 30_000;
+        if (typeof this.fetchImpl !== 'function') {
+            throw new Error('RitkeyClient: no fetch implementation available. Use Node 18+ or pass `fetch` in the config.');
+        }
+    }
+    async request(method, path, body, opts) {
+        const url = `${this.baseUrl}${path.startsWith('/') ? '' : '/'}${path}`;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), opts?.timeoutMs ?? this.timeoutMs);
+        const headers = {
+            Accept: 'application/json',
+        };
+        if (this.apiKey)
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        if (body !== undefined)
+            headers['Content-Type'] = 'application/json';
+        let res;
+        try {
+            res = await this.fetchImpl(url, {
+                method,
+                headers,
+                body: body !== undefined ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            clearTimeout(timeout);
+            if (err?.name === 'AbortError') {
+                throw new RitkeyError(0, `Request timed out after ${opts?.timeoutMs ?? this.timeoutMs}ms`, null);
+            }
+            throw new RitkeyError(0, err?.message ?? 'Network error', null);
+        }
+        clearTimeout(timeout);
+        // 204 No Content
+        if (res.status === 204)
+            return undefined;
+        // Parse JSON (may be empty string).
+        const text = await res.text();
+        let parsed = null;
+        if (text.length > 0) {
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                // Server returned non-JSON. Surface as a string body on the error.
+                if (!res.ok) {
+                    throw new RitkeyError(res.status, `HTTP ${res.status}: ${text.slice(0, 200)}`, text);
+                }
+                return text;
+            }
+        }
+        if (!res.ok) {
+            const message = (parsed && typeof parsed === 'object' && (parsed.error ?? parsed.message)) ||
+                `HTTP ${res.status}`;
+            const code = parsed && typeof parsed === 'object' ? parsed.code : undefined;
+            throw new RitkeyError(res.status, String(message), parsed, code);
+        }
+        return parsed;
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAA2B,MAAM,YAAY,CAAC;AAIlE,MAAM,OAAO,aAAa;IACP,OAAO,CAAS;IAChB,MAAM,CAAU;IAChB,SAAS,CAAU;IACnB,SAAS,CAAS;IAEnC,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC1E,iDAAiD;QACjD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrE,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC;QAE5C,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,8FAA8F,CAC/F,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CACX,MAA2C,EAC3C,IAAY,EACZ,IAAc,EACd,IAA6B;QAE7B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC;QACvE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;QAExF,MAAM,OAAO,GAA2B;YACtC,MAAM,EAAE,kBAAkB;SAC3B,CAAC;QACF,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;QACpE,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAErE,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE;gBAC9B,MAAM;gBACN,OAAO;gBACP,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC3D,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,IAAI,GAAG,EAAE,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC/B,MAAM,IAAI,WAAW,CAAC,CAAC,EAAE,2BAA2B,IAAI,EAAE,SAAS,IAAI,IAAI,CAAC,SAAS,IAAI,EAAE,IAAI,CAAC,CAAC;YACnG,CAAC;YACD,MAAM,IAAI,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,IAAI,eAAe,EAAE,IAAI,CAAC,CAAC;QAClE,CAAC;QACD,YAAY,CAAC,OAAO,CAAC,CAAC;QAEtB,iBAAiB;QACjB,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,SAAyB,CAAC;QAEzD,oCAAoC;QACpC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,MAAM,GAAQ,IAAI,CAAC;QACvB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,mEAAmE;gBACnE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,MAAM,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;gBACvF,CAAC;gBACD,OAAO,IAAoB,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,OAAO,GACX,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC1E,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5E,MAAM,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,MAAW,CAAC;IACrB,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Shared types for the Ritkey SDK.
+ *
+ * These mirror the wire format of the @ritkey/service HTTP API. Where the
+ * server returns extra `_notice` / `_security` documentation fields, the SDK
+ * forwards them so apps can show them to users on first wallet creation.
+ */
+export type WalletType = 'xor' | 'threshold';
+export type WalletStatus = 'active' | 'frozen' | 'archived';
+/** Full wallet view from POST /wallets and POST /wallets/import (creation responses). */
+export interface CreatedWallet {
+    walletId: string;
+    address: string;
+    publicKey: string;
+    /** Returned ONCE — save it. Used as one of two shares for signing. */
+    agentShard: string;
+    /** Returned ONCE — store offline (cold storage). The third share. */
+    backupShard: string;
+    walletType: WalletType;
+    threshold: number;
+    totalShares: number;
+    label: string;
+    createdAt: string;
+}
+/** Wallet view from GET /wallets/:id (no shards). */
+export interface Wallet {
+    id: string;
+    address: string;
+    publicKey: string;
+    label: string;
+    status: WalletStatus;
+    createdAt: string;
+    fundedAt?: string | null;
+}
+export interface SendTransactionInput {
+    walletId: string;
+    agentShard: string;
+    to: string;
+    value: string;
+    data?: string;
+}
+export interface SignMessageInput {
+    walletId: string;
+    agentShard: string;
+    message: string;
+}
+export interface ExportKeyInput {
+    walletId: string;
+    agentShard: string;
+    /**
+     * Optional. If provided, the server uses agentShard+backupShard for
+     * reconstruction without combining its own shard (server-less mode).
+     */
+    backupShard?: string;
+}
+export interface SweepInput {
+    walletId: string;
+    agentShard: string;
+    sweepTo: string;
+}
+export interface SentTransaction {
+    hash: string;
+    from: string;
+    to: string;
+    value: string;
+    walletType: WalletType;
+    explorer: string;
+}
+export interface BalanceResponse {
+    address: string;
+    native: {
+        wei: string;
+        formatted: string;
+        symbol: 'RITUAL';
+    };
+    ritualWallet: {
+        balance: string;
+        formatted: string;
+        lockUntil: string;
+        isLocked: boolean;
+    };
+    currentBlock: string;
+}
+export interface ExportedKey {
+    walletId: string;
+    address: string;
+    privateKey: string;
+    status: 'archived';
+}
+export type SubscriptionStatus = 'active' | 'paused' | 'disabled';
+export type EventType = 'wallet.created' | 'wallet.imported' | 'wallet.frozen' | 'wallet.unfrozen' | 'wallet.archived' | 'wallet.funded' | 'wallet.swept' | 'tx.sent' | 'tx.received' | 'message.signed' | 'ritual.deposited' | 'key.exported' | 'webhook.test' | 'alert.spend_threshold' | 'alert.unusual_recipient' | 'alert.key_export_warning' | 'alert.balance_low';
+export interface WebhookSubscription {
+    id: string;
+    url: string;
+    eventsFilter: (EventType | '*')[];
+    label: string;
+    status: SubscriptionStatus;
+    createdAt: string;
+    lastDeliveryAt: string | null;
+    consecutiveFailures: number;
+}
+/** POST /webhooks response — includes the one-time signing secret. */
+export interface CreatedWebhook extends WebhookSubscription {
+    secret: string;
+}
+export interface CreateWebhookInput {
+    url: string;
+    events?: (EventType | '*')[];
+    label?: string;
+}
+export interface UpdateWebhookInput {
+    url?: string;
+    events?: (EventType | '*')[];
+    label?: string;
+    status?: 'active' | 'paused';
+}
+export interface DeliveryLogEntry {
+    id: string;
+    eventId: string;
+    status: 'pending' | 'delivered' | 'failed' | 'dead';
+    attempts: number;
+    url: string;
+    responseStatus: number | null;
+    lastError: string | null;
+    createdAt: string;
+    lastAttemptAt: string | null;
+}
+export interface BaseEvent {
+    id: string;
+    type: EventType;
+    timestamp: string;
+    walletId: string | null;
+}
+/** Each event's `data` shape is type-specific; we keep it loose at the SDK
+ * boundary so the wire format can evolve without breaking changes. Use
+ * the type tag to narrow. */
+export interface RitkeyEvent<T = unknown> extends BaseEvent {
+    data: T;
+}
+export type AlertKind = 'spend_threshold' | 'unusual_recipient' | 'key_export_warning' | 'balance_low';
+export type AlertSeverity = 'info' | 'warn' | 'critical';
+export interface SpendThresholdConfig {
+    thresholdRitual: string;
+}
+export interface UnusualRecipientConfig {
+    whitelist: string[];
+}
+export interface KeyExportWarningConfig {
+}
+export interface BalanceLowConfig {
+    floorRitual: string;
+}
+export type AlertConfig = SpendThresholdConfig | UnusualRecipientConfig | KeyExportWarningConfig | BalanceLowConfig;
+export interface AlertRule {
+    id: string;
+    walletId: string | null;
+    kind: AlertKind;
+    config: AlertConfig;
+    enabled: boolean;
+    severity: AlertSeverity;
+    label: string;
+    createdAt: string;
+}
+export interface CreateAlertRuleInput {
+    walletId: string;
+    kind: AlertKind;
+    config: AlertConfig;
+    severity?: AlertSeverity;
+    label?: string;
+}
+export interface UpdateAlertRuleInput {
+    enabled?: boolean;
+    severity?: AlertSeverity;
+    label?: string;
+    config?: AlertConfig;
+}
+export interface RitkeyClientConfig {
+    /** Base URL, e.g. https://ritkey.example.com */
+    baseUrl: string;
+    /** Bearer API key. Required unless your server is in OPEN_MODE. */
+    apiKey?: string;
+    /** Override fetch impl (for testing, custom retry, etc.) */
+    fetch?: typeof fetch;
+    /** Default per-request timeout in ms. Default: 30_000 */
+    timeoutMs?: number;
+}
+export declare class RitkeyError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly body: unknown;
+    constructor(status: number, message: string, body: unknown, code?: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,20 @@
+/**
+ * Shared types for the Ritkey SDK.
+ *
+ * These mirror the wire format of the @ritkey/service HTTP API. Where the
+ * server returns extra `_notice` / `_security` documentation fields, the SDK
+ * forwards them so apps can show them to users on first wallet creation.
+ */
+export class RitkeyError extends Error {
+    status;
+    code;
+    body;
+    constructor(status, message, body, code) {
+        super(message);
+        this.name = 'RitkeyError';
+        this.status = status;
+        this.code = code;
+        this.body = body;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwPH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,MAAM,CAAS;IACf,IAAI,CAAU;IACd,IAAI,CAAU;IACvB,YAAY,MAAc,EAAE,OAAe,EAAE,IAAa,EAAE,IAAa;QACvE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}