@routedock/routedock 0.2.0 → 0.3.0

package/dist/{types-DmhmfLzP.d.cts → logger-D8_Q2ytp.d.cts}

@@ -8,6 +8,17 @@ import { Store } from 'mppx';
  */
 
 type PaymentMode = 'x402' | 'mpp-charge' | 'mpp-session' | 'mpp-session-ws';
+/** Payment asset configuration with optional mode/endpoint scoping */
+interface AssetConfig {
+    /** Asset ticker symbol, e.g. "USDC" or "XLM" */
+    asset: string;
+    /** Stellar Asset Contract (SAC) address for this payment asset */
+    asset_contract: string;
+    /** Optional: restrict this asset to specific payment modes. If omitted, available for all modes. */
+    modes?: PaymentMode[];
+    /** Optional: restrict this asset to specific endpoints (by name). If omitted, available for all endpoints. */
+    endpoints?: string[];
+}
 /**
  * Agent custody mode — declared in routedock.json when provider accepts ZK vault payers.
  * `nulth` = Nulth proof-authorized account (the ZK-account primitive; formerly "covenant-zk").
@@ -105,6 +116,12 @@ interface RouteDockManifest {
     asset: string;
     /** Stellar Asset Contract (SAC) address for the payment asset */
     asset_contract: string;
+    /**
+     * Payment assets accepted by this provider. Each asset can be scoped to specific
+     * modes and endpoints. When present, assets[0] must match the root-level
+     * asset and asset_contract.
+     */
+    assets?: AssetConfig[];
     /**
      * Stellar address (G...) that receives payments. Used as the default
      * recipient for all modes. Individual per-request modes (x402, mpp-charge)
@@ -407,4 +424,44 @@ interface SessionState {
 /** Dispute status of a channel */
 type DisputeStatus = 'open' | 'in-refund-window' | 'refundable' | 'settled';
 
-export { DEFAULT_MAX_SESSION_DURATION_MS as D, type EndpointDescriptor as E, type PaymentMode as P, type RouteDockManifest as R, type SLAConfig as S, type VaultMode as V, type DisputeStatus as a, type EstimateCostResult as b, type PaymentResult as c, type PreflightResult as d, type PricingConfig as e, type SessionCloseFailedPayload as f, type SessionCloseResult as g, type SessionEvent as h, type SessionEventPayloadMap as i, type SessionHandle as j, type SessionOptions as k, type SessionPricingConfig as l, type SessionState as m, type SessionStats as n, type SessionTimeoutPayload as o, type StreamOptions as p };
+/**
+ * Structured logging hook shared by the client and provider adapters.
+ *
+ * The SDK used to write straight to `console` in a couple of dozen error
+ * paths, which is unusable on structured-logging runtimes (Cloudflare Workers,
+ * Datadog, …) and untestable without spying on `console`. Every internal
+ * diagnostic now goes through a {@link RouteDockLogger}, so a consumer can
+ * silence it, redirect it, or attach correlation fields.
+ *
+ * The default implementation is console-backed, so behaviour is unchanged when
+ * no logger is supplied.
+ */
+/** Severity of a log line. */
+type RouteDockLogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Structured context attached to a log line, typically `{ error: err }`. Sinks
+ * receive the values unresolved, so a serialising sink must project non-JSON
+ * values such as `Error` itself.
+ */
+type RouteDockLogFields = Record<string, unknown>;
+/**
+ * Consumer-supplied log sink.
+ *
+ * `fields` carries the structured payload (the error, the channel id, …) that
+ * a bare string would drop at the boundary.
+ */
+type RouteDockLogger = (level: RouteDockLogLevel, message: string, fields?: RouteDockLogFields) => void;
+/**
+ * Default logger that forwards to the console at the matching level. Field
+ * values are spread as additional console arguments so `console.error(msg, err)`
+ * spies (and existing log shippers) keep seeing the raw error object.
+ */
+declare function createConsoleLogger(): RouteDockLogger;
+/** Shared console-backed logger — the default when none is configured. */
+declare const consoleLogger: RouteDockLogger;
+/** Logger that discards every line. */
+declare const noopLogger: RouteDockLogger;
+/** Resolve an optional logger to a concrete sink, defaulting to `fallback`. */
+declare function resolveLogger(logger: RouteDockLogger | undefined, fallback?: RouteDockLogger): RouteDockLogger;
+
+export { type AssetConfig as A, DEFAULT_MAX_SESSION_DURATION_MS as D, type EndpointDescriptor as E, type PaymentMode as P, type RouteDockLogFields as R, type SLAConfig as S, type VaultMode as V, type DisputeStatus as a, type EstimateCostResult as b, type PaymentResult as c, type PreflightResult as d, type PricingConfig as e, type RouteDockLogLevel as f, type RouteDockLogger as g, type RouteDockManifest as h, type SessionCloseFailedPayload as i, type SessionCloseResult as j, type SessionEvent as k, type SessionEventPayloadMap as l, type SessionHandle as m, type SessionOptions as n, type SessionPricingConfig as o, type SessionState as p, type SessionStats as q, type SessionTimeoutPayload as r, type StreamOptions as s, consoleLogger as t, createConsoleLogger as u, noopLogger as v, resolveLogger as w };

package/dist/{types-DmhmfLzP.d.ts → logger-D8_Q2ytp.d.ts}

@@ -8,6 +8,17 @@ import { Store } from 'mppx';
  */
 
 type PaymentMode = 'x402' | 'mpp-charge' | 'mpp-session' | 'mpp-session-ws';
+/** Payment asset configuration with optional mode/endpoint scoping */
+interface AssetConfig {
+    /** Asset ticker symbol, e.g. "USDC" or "XLM" */
+    asset: string;
+    /** Stellar Asset Contract (SAC) address for this payment asset */
+    asset_contract: string;
+    /** Optional: restrict this asset to specific payment modes. If omitted, available for all modes. */
+    modes?: PaymentMode[];
+    /** Optional: restrict this asset to specific endpoints (by name). If omitted, available for all endpoints. */
+    endpoints?: string[];
+}
 /**
  * Agent custody mode — declared in routedock.json when provider accepts ZK vault payers.
  * `nulth` = Nulth proof-authorized account (the ZK-account primitive; formerly "covenant-zk").
@@ -105,6 +116,12 @@ interface RouteDockManifest {
     asset: string;
     /** Stellar Asset Contract (SAC) address for the payment asset */
     asset_contract: string;
+    /**
+     * Payment assets accepted by this provider. Each asset can be scoped to specific
+     * modes and endpoints. When present, assets[0] must match the root-level
+     * asset and asset_contract.
+     */
+    assets?: AssetConfig[];
     /**
      * Stellar address (G...) that receives payments. Used as the default
      * recipient for all modes. Individual per-request modes (x402, mpp-charge)
@@ -407,4 +424,44 @@ interface SessionState {
 /** Dispute status of a channel */
 type DisputeStatus = 'open' | 'in-refund-window' | 'refundable' | 'settled';
 
-export { DEFAULT_MAX_SESSION_DURATION_MS as D, type EndpointDescriptor as E, type PaymentMode as P, type RouteDockManifest as R, type SLAConfig as S, type VaultMode as V, type DisputeStatus as a, type EstimateCostResult as b, type PaymentResult as c, type PreflightResult as d, type PricingConfig as e, type SessionCloseFailedPayload as f, type SessionCloseResult as g, type SessionEvent as h, type SessionEventPayloadMap as i, type SessionHandle as j, type SessionOptions as k, type SessionPricingConfig as l, type SessionState as m, type SessionStats as n, type SessionTimeoutPayload as o, type StreamOptions as p };
+/**
+ * Structured logging hook shared by the client and provider adapters.
+ *
+ * The SDK used to write straight to `console` in a couple of dozen error
+ * paths, which is unusable on structured-logging runtimes (Cloudflare Workers,
+ * Datadog, …) and untestable without spying on `console`. Every internal
+ * diagnostic now goes through a {@link RouteDockLogger}, so a consumer can
+ * silence it, redirect it, or attach correlation fields.
+ *
+ * The default implementation is console-backed, so behaviour is unchanged when
+ * no logger is supplied.
+ */
+/** Severity of a log line. */
+type RouteDockLogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Structured context attached to a log line, typically `{ error: err }`. Sinks
+ * receive the values unresolved, so a serialising sink must project non-JSON
+ * values such as `Error` itself.
+ */
+type RouteDockLogFields = Record<string, unknown>;
+/**
+ * Consumer-supplied log sink.
+ *
+ * `fields` carries the structured payload (the error, the channel id, …) that
+ * a bare string would drop at the boundary.
+ */
+type RouteDockLogger = (level: RouteDockLogLevel, message: string, fields?: RouteDockLogFields) => void;
+/**
+ * Default logger that forwards to the console at the matching level. Field
+ * values are spread as additional console arguments so `console.error(msg, err)`
+ * spies (and existing log shippers) keep seeing the raw error object.
+ */
+declare function createConsoleLogger(): RouteDockLogger;
+/** Shared console-backed logger — the default when none is configured. */
+declare const consoleLogger: RouteDockLogger;
+/** Logger that discards every line. */
+declare const noopLogger: RouteDockLogger;
+/** Resolve an optional logger to a concrete sink, defaulting to `fallback`. */
+declare function resolveLogger(logger: RouteDockLogger | undefined, fallback?: RouteDockLogger): RouteDockLogger;
+
+export { type AssetConfig as A, DEFAULT_MAX_SESSION_DURATION_MS as D, type EndpointDescriptor as E, type PaymentMode as P, type RouteDockLogFields as R, type SLAConfig as S, type VaultMode as V, type DisputeStatus as a, type EstimateCostResult as b, type PaymentResult as c, type PreflightResult as d, type PricingConfig as e, type RouteDockLogLevel as f, type RouteDockLogger as g, type RouteDockManifest as h, type SessionCloseFailedPayload as i, type SessionCloseResult as j, type SessionEvent as k, type SessionEventPayloadMap as l, type SessionHandle as m, type SessionOptions as n, type SessionPricingConfig as o, type SessionState as p, type SessionStats as q, type SessionTimeoutPayload as r, type StreamOptions as s, consoleLogger as t, createConsoleLogger as u, noopLogger as v, resolveLogger as w };