@routedock/routedock 0.1.2 → 0.3.0

package/dist/provider/hono.d.cts

@@ -0,0 +1,101 @@
+import { MiddlewareHandler } from 'hono';
+import { Store } from '@stellar/mpp/channel/server';
+import { P as PaymentMode, h as RouteDockManifest, g as RouteDockLogger } from '../logger-D8_Q2ytp.cjs';
+import { O as OrphanedSessionInfo, S as SeenTxStore } from '../MppSessionHandler-1EL8QBAn.cjs';
+export { I as InMemorySeenTxStore, a as SettlementRecord } from '../MppSessionHandler-1EL8QBAn.cjs';
+export { R as ReconciliationStats, a as RegisterProviderOptions, S as SessionReconcilerOptions, b as SupabaseSeenTxStore, r as reconcileAbandonedSessions, c as registerProvider, e as runStartupReconciliation } from '../SessionReconciler-Cz2nuOlJ.cjs';
+export { s as signManifest } from '../sign-AKH67sft.cjs';
+import 'mppx';
+import 'express';
+import '@supabase/supabase-js';
+import '@stellar/stellar-sdk';
+
+type Network = 'testnet' | 'mainnet';
+interface RouteDockHonoOptions {
+    modes: PaymentMode[];
+    pricing: {
+        x402?: string;
+        'mpp-charge'?: string;
+        'mpp-session'?: {
+            rate: string;
+            channelFactory: string;
+        };
+        /** WebSocket transport variant of mpp-session — same channel, WS streaming */
+        'mpp-session-ws'?: {
+            rate: string;
+            channelFactory: string;
+        };
+    };
+    asset?: string;
+    assetContract?: string;
+    payee: string;
+    network: Network;
+    payeeSecretKey: string;
+    facilitatorApiKey?: string;
+    commitmentPublicKey?: string;
+    manifest: RouteDockManifest;
+    onSettled?: (txHash: string, amount: string, mode: string, payer: string | null) => Promise<void>;
+    onSessionOpen?: (channelId: string, payer: string | null) => Promise<void>;
+    onVoucher?: (channelId: string, voucherIndex: number, cumulativeAmount: string, signature: string) => Promise<void>;
+    onCallbackError?: (err: unknown, cbName: string) => void;
+    /**
+     * Called when an mpp-session connection aborts or goes idle before a clean
+     * close. Persist the session as `closing` for the SessionReconciler.
+     */
+    onOrphaned?: (channelId: string, info: OrphanedSessionInfo) => Promise<void>;
+    /** Idle timeout (ms) after which an mpp-session is flagged orphaned. */
+    idleTimeoutMs?: number;
+    /**
+     * Idempotency store guarding against duplicate settlement when an agent
+     * retries the same payment. Defaults to a per-handler in-memory store.
+     */
+    seenTxStore?: SeenTxStore;
+    /**
+     * Persistent store backing mpp-session channel state and handler state.
+     * Defaults to an in-memory store per handler; supply a durable store (e.g.
+     * Durable Object storage) so voucher tracking survives isolate eviction.
+     */
+    sessionStore?: Store.Store;
+    /** Log sink for internal error paths. Defaults to a console-backed logger. */
+    logger?: RouteDockLogger;
+}
+/**
+ * Context key set by the mpp-session-ws middleware after a request's payment
+ * credential has been verified, so the app's WebSocket upgrade route can
+ * refuse to upgrade unauthenticated handshakes.
+ */
+declare const MPP_SESSION_WS_VERIFIED = "routedock.mppSessionWs.verified";
+/**
+ * True when the routedockHono mpp-session-ws middleware verified the
+ * handshake request's Payment credential (see {@link MPP_SESSION_WS_VERIFIED}).
+ * WebSocket upgrade routes should refuse to upgrade when this is false.
+ */
+declare function mppSessionWsVerified(c: {
+    get: (key: string) => unknown;
+}): boolean;
+/**
+ * Hono middleware factory for RouteDock provider endpoints.
+ *
+ * **Workers-safe entry point.** This module uses only Web-standard APIs
+ * (`atob`/`TextDecoder` via {@link base64ToUtf8}, {@link hexToBytes}, and the
+ * request `AbortSignal`) and runs on Cloudflare Workers, Bun, Deno Deploy, and
+ * any Hono deployment target. The Express `routedock()` middleware
+ * (`@routedock/routedock/provider`) is Node.js-only — it relies on Node's
+ * `Buffer` and `req.on('close')`.
+ *
+ * Exposes the same configuration surface as the Express `routedock()` middleware.
+ *
+ * @example
+ * ```ts
+ * import { routedockHono } from '@routedock/sdk/provider/hono'
+ *
+ * app.use('/price', routedockHono({
+ *   modes: ['x402', 'mpp-charge'],
+ *   pricing: { x402: '0.001', 'mpp-charge': '0.0008' },
+ *   ...
+ * }))
+ * ```
+ */
+declare function routedockHono(opts: RouteDockHonoOptions): MiddlewareHandler;
+
+export { MPP_SESSION_WS_VERIFIED, type RouteDockHonoOptions, SeenTxStore, mppSessionWsVerified, routedockHono };

package/dist/provider/hono.d.ts

@@ -0,0 +1,101 @@
+import { MiddlewareHandler } from 'hono';
+import { Store } from '@stellar/mpp/channel/server';
+import { P as PaymentMode, h as RouteDockManifest, g as RouteDockLogger } from '../logger-D8_Q2ytp.js';
+import { O as OrphanedSessionInfo, S as SeenTxStore } from '../MppSessionHandler-Bq4S-JTE.js';
+export { I as InMemorySeenTxStore, a as SettlementRecord } from '../MppSessionHandler-Bq4S-JTE.js';
+export { R as ReconciliationStats, a as RegisterProviderOptions, S as SessionReconcilerOptions, b as SupabaseSeenTxStore, r as reconcileAbandonedSessions, c as registerProvider, e as runStartupReconciliation } from '../SessionReconciler-Bw-PoBVl.js';
+export { s as signManifest } from '../sign-BEq-OsSq.js';
+import 'mppx';
+import 'express';
+import '@supabase/supabase-js';
+import '@stellar/stellar-sdk';
+
+type Network = 'testnet' | 'mainnet';
+interface RouteDockHonoOptions {
+    modes: PaymentMode[];
+    pricing: {
+        x402?: string;
+        'mpp-charge'?: string;
+        'mpp-session'?: {
+            rate: string;
+            channelFactory: string;
+        };
+        /** WebSocket transport variant of mpp-session — same channel, WS streaming */
+        'mpp-session-ws'?: {
+            rate: string;
+            channelFactory: string;
+        };
+    };
+    asset?: string;
+    assetContract?: string;
+    payee: string;
+    network: Network;
+    payeeSecretKey: string;
+    facilitatorApiKey?: string;
+    commitmentPublicKey?: string;
+    manifest: RouteDockManifest;
+    onSettled?: (txHash: string, amount: string, mode: string, payer: string | null) => Promise<void>;
+    onSessionOpen?: (channelId: string, payer: string | null) => Promise<void>;
+    onVoucher?: (channelId: string, voucherIndex: number, cumulativeAmount: string, signature: string) => Promise<void>;
+    onCallbackError?: (err: unknown, cbName: string) => void;
+    /**
+     * Called when an mpp-session connection aborts or goes idle before a clean
+     * close. Persist the session as `closing` for the SessionReconciler.
+     */
+    onOrphaned?: (channelId: string, info: OrphanedSessionInfo) => Promise<void>;
+    /** Idle timeout (ms) after which an mpp-session is flagged orphaned. */
+    idleTimeoutMs?: number;
+    /**
+     * Idempotency store guarding against duplicate settlement when an agent
+     * retries the same payment. Defaults to a per-handler in-memory store.
+     */
+    seenTxStore?: SeenTxStore;
+    /**
+     * Persistent store backing mpp-session channel state and handler state.
+     * Defaults to an in-memory store per handler; supply a durable store (e.g.
+     * Durable Object storage) so voucher tracking survives isolate eviction.
+     */
+    sessionStore?: Store.Store;
+    /** Log sink for internal error paths. Defaults to a console-backed logger. */
+    logger?: RouteDockLogger;
+}
+/**
+ * Context key set by the mpp-session-ws middleware after a request's payment
+ * credential has been verified, so the app's WebSocket upgrade route can
+ * refuse to upgrade unauthenticated handshakes.
+ */
+declare const MPP_SESSION_WS_VERIFIED = "routedock.mppSessionWs.verified";
+/**
+ * True when the routedockHono mpp-session-ws middleware verified the
+ * handshake request's Payment credential (see {@link MPP_SESSION_WS_VERIFIED}).
+ * WebSocket upgrade routes should refuse to upgrade when this is false.
+ */
+declare function mppSessionWsVerified(c: {
+    get: (key: string) => unknown;
+}): boolean;
+/**
+ * Hono middleware factory for RouteDock provider endpoints.
+ *
+ * **Workers-safe entry point.** This module uses only Web-standard APIs
+ * (`atob`/`TextDecoder` via {@link base64ToUtf8}, {@link hexToBytes}, and the
+ * request `AbortSignal`) and runs on Cloudflare Workers, Bun, Deno Deploy, and
+ * any Hono deployment target. The Express `routedock()` middleware
+ * (`@routedock/routedock/provider`) is Node.js-only — it relies on Node's
+ * `Buffer` and `req.on('close')`.
+ *
+ * Exposes the same configuration surface as the Express `routedock()` middleware.
+ *
+ * @example
+ * ```ts
+ * import { routedockHono } from '@routedock/sdk/provider/hono'
+ *
+ * app.use('/price', routedockHono({
+ *   modes: ['x402', 'mpp-charge'],
+ *   pricing: { x402: '0.001', 'mpp-charge': '0.0008' },
+ *   ...
+ * }))
+ * ```
+ */
+declare function routedockHono(opts: RouteDockHonoOptions): MiddlewareHandler;
+
+export { MPP_SESSION_WS_VERIFIED, type RouteDockHonoOptions, SeenTxStore, mppSessionWsVerified, routedockHono };