@openrai/nano-core 1.0.0 → 2.1.0

package/README.md

@@ -11,7 +11,7 @@
 
 Historically, Nano developers have faced a fragmented integration landscape: ranging from "heavy, enterprise:y" backends to lightweight "frontend-only" implementation, suffering either from rigid vendor lock-in or fragile PoW architecture.
 
-**`@openrai/nano-core`** extracts the most robust cryptographic, domain-driven design, and network-fallback primitives into a single, highly extensible foundation. It solves the hardest protocol challenges - such as block synchronization and different constraint between browser & backend environments - allowing developers to focus on application logic.
+**`@openrai/nano-core`** aims to be the canonical TypeScript Nano package: typed primitives, sane defaults, transport failover, endpoint normalization, auth handling, and a stable first-party API surface even when the internals wrap other best-of-breed libraries.
 
 ---
 
@@ -20,7 +20,8 @@ Historically, Nano developers have faced a fragmented integration landscape: ran
 * **Bypassing the "Frontier Dilemma":** Nano is a state-based block-lattice where each block depends strictly on the exact final state of the previous frontier. This strong design choise is one of the main reasons why Nano can be feeless and energy efficient, but it often becomes a stumbling block for integrations. `@openrai/nano-core` provides internal concurrent Mutex queuing to perfectly sequentialize blocks even under heavy asynchronous loads, eliminating "Fork" or "Gap" errors.
 * **Isomorphic Proof-of-Work (JIT Profiling):** Wraps `nano-pow-with-fallback` in a Just-In-Time (JIT) environment profiler via `WorkProvider.auto()`. What it means is that whether running on an Apple Silicon Node.js server (jumping straight to local WebGPU) or on an aging mobile browser (delegating safely to remote servers by default), which generation method to use can be decided dynamically, without UI blocking or interfering with the current user flow. 
 * **No Primitive-Obsession:** Heavily-typed, precision-safe wrappers for `NanoAmount` and `NanoAddress` entirely eliminate the "Stringly-Typed Money" programming anti-pattern.
-* **Resilient RPC Fallbacks:** Configure a progressive `TransportFallback` pool to gracefully route RPC requests across independent block validators without manual catch-blocks.
+* **Resilient RPC / WS / Work Fallbacks:** Endpoint pools validate eagerly, deduplicate, apply endpoint-local exponential backoff, and only fail once all viable options are exhausted.
+* **Secret-Safe Endpoint Normalization:** API keys from query params or URL userinfo are converted into structured auth metadata and redacted from canonical URLs and audit output.
 * **Cross-Language FFI Preparation**: The TypeScript architecture strictly follows Domain-Driven Design (DDD) to promote close API compatibility across different eventual programming language ports of the library.
 
 ## 📦 Installation
@@ -32,85 +33,155 @@ npm install @openrai/nano-core
 
 ## 🛠 Quick Start
 
-### 1. Progressive Client Initialization
-The `NanoClient` uses a "Convention over Configuration" approach. 
+### 1. Minimal Client
+The default surface should feel obvious on first read:
 
-#### Easy Mode (All Defaults)
-Out of the box, `NanoClient.initialize()` falls back to a public node pool and auto-configures the JIT Proof-of-Work environment profiler:
+```typescript
+import { NanoClient } from '@openrai/nano-core';
+
+const client = NanoClient.initialize({
+  rpc: [
+    'https://rpc.primary.example.com?apiKey=secret-rpc',
+    'https://rpc.nano.to',
+  ], // [Optional] Defaults to the April 2026 public RPC set
+  ws: [
+    'wss://ws.primary.example.com?api_key=secret-ws',
+    'wss://rpc.nano.to',
+  ], // [Optional] Defaults to public WebSocket endpoints
+  work: [
+    'https://work.primary.example.com?key=secret-work',
+    'https://rpc.nano.to',
+  ], // [Optional] Defaults to `https://rpc.nano.to` as the current public work endpoint
+  warn: (message) => console.warn(message), // [Optional] Defaults to console.warn with nano-core prefix
+});
+
+console.log(client.getAuditReport());
+```
+
+### 1.1 Observe Endpoint Selection
+
+Long-running services can observe which upstream endpoint became active without
+mutating transport configuration at runtime:
 
 ```typescript
 import { NanoClient } from '@openrai/nano-core';
 
-// Zero configuration required for prototyping
-const protocolClient = NanoClient.initialize();
+const client = NanoClient.initialize();
+
+const unsubscribe = client.onEndpointChange((event) => {
+  console.log(event.kind, event.status, event.activeUrl, event.previousUrl);
+});
+
+console.log(client.getActiveEndpoints());
+// { rpc?: string, ws?: string, work?: string }
+
+// Later:
+unsubscribe();
 ```
 
-#### Enterprise Mode (Explicit Overrides)
-For production environments, every single layer of the stack is fully overridable:
+This is an observe-only API. It does not reconfigure pools or alter failover
+policy; it simply exposes which endpoint was selected after a successful RPC,
+WS, or work operation.
+
+What this buys you immediately:
+
+- comma-separated env vars also work: `NANO_RPC_URL`, `NANO_WS_URL`, `NANO_WORK_URL`
+- malformed or duplicate endpoints are dropped during construction
+- API keys in query params or URL userinfo are extracted and redacted from audit output
+- failover and endpoint-local backoff happen inside the pool, not in your app code
+
+Current built-in defaults as of April 2026:
+
+- RPC: `https://rpc.nano.to`, `https://node.somenano.com/proxy`, `https://rainstorm.city/api`, `https://nanoslo.0x.no/proxy`
+- WS: `wss://rpc.nano.to`
+- Work: `https://rpc.nano.to`
+
+### 2. Zero-Config Prototype Mode
+Out of the box, `NanoClient.initialize()` falls back to default public RPC / WS / work pools and auto-configures the work provider:
+
+```typescript
+import { NanoClient } from '@openrai/nano-core';
+
+const client = NanoClient.initialize();
+```
+
+### 3. Explicit Override Mode
+For production environments, you can override only the pieces you care about while keeping the same normalized pool behavior:
 
 ```typescript
-import { 
-  NanoClient, 
-  TransportFallback,
+import {
+  NanoClient,
   WorkProvider,
   RemoteWorkServer,
-  LocalCompute
+  LocalCompute,
 } from '@openrai/nano-core';
 
-const protocolClient = NanoClient.initialize({
-  network: 'mainnet', // [Optional] Default is 'mainnet'
-  
-  // [Optional] Resilient public/private node pooling
-  transports: TransportFallback.of([
-    'https://rpc.my-private-node.com',
-    'https://rpc.nano.org'
-  ]),
-  
-  // [Optional] JIT Environment Profiling overrides
+const client = NanoClient.initialize({
+  network: 'mainnet', // [Optional] Defaults to 'mainnet'
+  rpc: [
+    'https://rpc.private.example.com?apiKey=secret-rpc',
+    'https://rpc.nano.to',
+  ], // [Optional] Defaults to the April 2026 public RPC set
+  ws: [
+    'wss://ws.private.example.com?api_key=secret-ws',
+    'wss://rpc.nano.to',
+  ], // [Optional] Defaults to public WebSocket endpoints
   workProvider: WorkProvider.auto({
+    urls: [
+      'https://work.private.example.com?key=secret-work',
+    ], // [Optional] Defaults to `https://rpc.nano.to` when omitted
     remotes: [
-      RemoteWorkServer.of('https://api.openrai.com/work', { timeoutMs: 5000, circuitBreakerMs: 30000 })
-    ],
+      RemoteWorkServer.of(
+        'https://work-backup.example.com',
+        {
+          timeoutMs: 5000, // [Optional] Defaults to 5000
+          circuitBreakerMs: 30000, // [Optional] Reserved for future tuning
+        },
+      ),
+    ], // [Optional] Additional remote work backends
     localChain: [
-      LocalCompute.WEBGPU, 
-      LocalCompute.WASM_THREADS, 
-      LocalCompute.CPU
-    ],
+      LocalCompute.WEBGPU,
+      LocalCompute.WASM_THREADS,
+      LocalCompute.CPU,
+    ], // [Optional] Local fallback order
     profiler: {
-      mode: 'manual', // Explicit calibration to protect TTI
-      preferLocalAboveMhs: 30, // Override threshold for server hardware 
-      cacheStrategy: 'persistent'
-    }
-  })
+      mode: 'manual',
+      preferLocalAboveMhs: 30,
+      cacheStrategy: 'persistent',
+    }, // [Optional] Calibration strategy overrides
+    warn: (message) => console.warn(message), // [Optional] Defaults to console.warn with nano-core prefix
+  }), // [Optional] Defaults to WorkProvider.auto(...) using normalized work endpoints
+  warn: (message) => console.warn(message), // [Optional] Defaults to console.warn with nano-core prefix
 });
 ```
 
-### 2. Isomorphic Work Calibration
+### 4. Isomorphic Work Calibration
 It's critical not to freeze the browser threads. On boot, evaluate the environment. `nano-core` remembers the hardware constraints across sessions.
 
 ```typescript
 // Auto-detects whether local WebGPU/WASM is faster than network latency to remotes
-const profile = await protocolClient.workProvider.calibrate();
+const profile = await client.workProvider.calibrate();
 console.log(`Determined active PoW strategy: ${profile.activeStrategy} at ${profile.measuredMhs} MH/s.`);
 ```
 
-### 3. Precision-Safe Mutex Execution
-`NanoAmount` enforces standard 30-decimal limits at compile time, rejecting invalid floats. Sending is automatically queued per-account.
+### 5. Precision-Safe Execution
+`NanoAmount` and `NanoAddress` give you typed protocol primitives immediately, even while the higher-level wallet surface is still being filled out.
 
 ```typescript
 import { NanoAddress, NanoAmount } from '@openrai/nano-core';
 
-// 1. Hydrate the Frontier
-const wallet = await protocolClient.hydrateWallet(process.env.NANO_SEED, { index: 0 });
+const destination = NanoAddress.parse(
+  'nano_3arg3asgtigae3xckabaaewkx3bzsh7nwz7jkmjos79ihyaxwphhm6qgjps4',
+);
+
+const amount = NanoAmount.fromNano('1.25');
 
-// 2. Transact
-// The engine auto-queues the lock, generates PoW in the background, and broadcasts to the RPC pool.
-const receipt = await wallet.send(
-  NanoAddress.parse('nano_3arg3asgtigae3xckabaaewkx3bzsh7nwz7jkmjos79ihyaxwphhm6qgjps4'), 
-  NanoAmount.fromNano('1.25') 
+const wallet = await client.hydrateWallet(
+  process.env.NANO_SEED,
+  { index: 0 }, // [Optional] Defaults to account index 0
 );
 
-console.log(`Transaction finalized. Hash: ${receipt}`);
+console.log({ destination, amount, wallet });
 ```
 
 ## 📐 Architecture Comparison
@@ -160,3 +231,4 @@ Across all tested engines, WebGL is the most consistently paced API. Because it
 These findings conclusively validate the `WorkProvider.auto()` architecture. The SDK cannot assume local hardware is safe just because `navigator.gpu` exists. 
 
 The JIT Environment Profiler must execute a sub-50ms micro-probe on load. If the probe detects a sandboxed environment where a `Send` block will trigger the "Throttle Cliff" (taking >5 seconds), the SDK must intelligently route the work to a remote BPoW server, ensuring the application remains responsive and the user's battery is preserved.
+See `docs/architecture/transport-auth.md` for the full transport/auth design.

package/dist/client.d.ts

@@ -1,4 +1,7 @@
+import { HttpEndpointPool } from './transport/http.js';
+import { WsEndpointPool } from './transport/ws.js';
 import { WorkProvider } from './work/WorkProvider.js';
+import type { EndpointActivityEvent } from './transport/types.js';
 export interface TransportFallback {
     urls: string[];
 }
@@ -8,13 +11,28 @@ export declare const TransportFallback: {
 export interface NanoClientOptions {
     network?: 'mainnet' | 'testnet' | 'beta';
     transports?: TransportFallback;
+    rpc?: string[];
+    ws?: string[];
+    work?: string[];
     workProvider?: WorkProvider;
+    warn?: (message: string) => void;
+}
+export interface NanoClientActiveEndpoints {
+    rpc?: string;
+    ws?: string;
+    work?: string;
 }
 export declare class NanoClient {
     workProvider: WorkProvider;
+    rpcPool: HttpEndpointPool;
+    wsPool: WsEndpointPool;
     private options;
+    private readonly endpointListeners;
+    private readonly activeEndpoints;
     private constructor();
     static initialize(options?: NanoClientOptions): NanoClient;
+    onEndpointChange(listener: (event: EndpointActivityEvent) => void): () => void;
+    getActiveEndpoints(): NanoClientActiveEndpoints;
     /**
      * Generates a minimal JSON-serializable report of the active configuration.
      * Useful for deploy-time auditing and startup logs to detect misconfigurations.

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,eAAO,MAAM,iBAAiB;eACjB,MAAM,EAAE,KAAG,iBAAiB;CACxC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACzC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,qBAAa,UAAU;IACd,YAAY,EAAE,YAAY,CAAC;IAClC,OAAO,CAAC,OAAO,CAAoB;IAEnC,OAAO;WAKO,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU;IAIrE;;;OAGG;IACI,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAS/B,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;wBAG/C,GAAG,UAAU,GAAG;;CAK3C"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAwB,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAsB,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,YAAY,EAA4B,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAgB,MAAM,sBAAsB,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,eAAO,MAAM,iBAAiB;eACjB,MAAM,EAAE,KAAG,iBAAiB;CACxC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACzC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,UAAU;IACd,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,cAAc,CAAC;IAC9B,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA8C;IAChF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwC;IAExE,OAAO;WAsDO,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU;IAI9D,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,GAAG,MAAM,IAAI;IAK9E,kBAAkB,IAAI,yBAAyB;IAQtD;;;OAGG;IACI,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAS/B,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;wBAG/C,GAAG,UAAU,GAAG;;CAK3C"}

package/dist/client.js

@@ -1,26 +1,94 @@
+import { HttpEndpointPool } from './transport/http.js';
+import { WsEndpointPool } from './transport/ws.js';
 import { WorkProvider } from './work/WorkProvider.js';
 export const TransportFallback = {
     of: (urls) => ({ urls })
 };
 export class NanoClient {
     workProvider;
+    rpcPool;
+    wsPool;
     options;
+    endpointListeners;
+    activeEndpoints;
     constructor(options) {
         this.options = options;
-        this.workProvider = options.workProvider ?? WorkProvider.auto({});
+        this.endpointListeners = new Set();
+        this.activeEndpoints = {};
+        const warn = options.warn ?? ((message) => console.warn(`[nano-core] ${message}`));
+        const forwardEndpointChange = (event) => {
+            this.activeEndpoints[event.kind] = event.activeUrl;
+            for (const listener of this.endpointListeners) {
+                listener(event);
+            }
+        };
+        const defaultRpc = [
+            'https://rpc.nano.to',
+            'https://node.somenano.com/proxy',
+            'https://rainstorm.city/api',
+            'https://nanoslo.0x.no/proxy',
+        ];
+        const defaultWs = ['wss://rpc.nano.to'];
+        const defaultWork = ['https://rpc.nano.to'];
+        const rpcUrls = options.rpc ?? options.transports?.urls;
+        const rpcEnv = process.env['NANO_RPC_URL'];
+        const wsEnv = process.env['NANO_WS_URL'];
+        const workEnv = process.env['NANO_WORK_URL'];
+        const rpcOptions = {
+            kind: 'rpc',
+            defaults: defaultRpc,
+            warn,
+            onActiveEndpointChange: forwardEndpointChange,
+        };
+        if (rpcUrls && rpcUrls.length > 0)
+            rpcOptions.urls = rpcUrls;
+        if (rpcEnv)
+            rpcOptions.env = rpcEnv;
+        this.rpcPool = new HttpEndpointPool(rpcOptions);
+        const wsOptions = {
+            defaults: defaultWs,
+            warn,
+            onActiveEndpointChange: forwardEndpointChange,
+        };
+        if (options.ws && options.ws.length > 0)
+            wsOptions.urls = options.ws;
+        if (wsEnv)
+            wsOptions.env = wsEnv;
+        this.wsPool = new WsEndpointPool(wsOptions);
+        const workOptions = {
+            defaults: defaultWork,
+            warn,
+            onActiveEndpointChange: forwardEndpointChange,
+        };
+        if (options.work && options.work.length > 0)
+            workOptions.urls = options.work;
+        if (workEnv)
+            workOptions.env = workEnv;
+        this.workProvider = options.workProvider ?? WorkProvider.auto(workOptions);
     }
     static initialize(options = {}) {
         return new NanoClient(options);
     }
+    onEndpointChange(listener) {
+        this.endpointListeners.add(listener);
+        return () => this.endpointListeners.delete(listener);
+    }
+    getActiveEndpoints() {
+        return {
+            ...(this.activeEndpoints.rpc ? { rpc: this.activeEndpoints.rpc } : {}),
+            ...(this.activeEndpoints.ws ? { ws: this.activeEndpoints.ws } : {}),
+            ...(this.activeEndpoints.work ? { work: this.activeEndpoints.work } : {}),
+        };
+    }
     /**
      * Generates a minimal JSON-serializable report of the active configuration.
      * Useful for deploy-time auditing and startup logs to detect misconfigurations.
      */
     getAuditReport() {
-        const defaultTransports = ['https://rpc.nano.org'];
         return {
             network: this.options.network ?? 'mainnet',
-            transports: this.options.transports?.urls ?? defaultTransports,
+            rpc: this.rpcPool.getAuditReport(),
+            ws: this.wsPool.getAuditReport(),
             workProvider: this.workProvider.getAuditReport()
         };
     }

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAMtD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,EAAE,EAAE,CAAC,IAAc,EAAqB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;CACtD,CAAC;AAQF,MAAM,OAAO,UAAU;IACd,YAAY,CAAe;IAC1B,OAAO,CAAoB;IAEnC,YAAoB,OAA0B;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;IAEM,MAAM,CAAC,UAAU,CAAC,UAA6B,EAAE;QACtD,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;;OAGG;IACI,cAAc;QACnB,MAAM,iBAAiB,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACnD,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,SAAS;YAC1C,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,IAAI,iBAAiB;YAC9D,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE;SACjD,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,UAA8B,EAAE;QACvE,wCAAwC;QACxC,OAAO;YACL,IAAI,EAAE,KAAK,EAAE,OAAY,EAAE,MAAW,EAAE,EAAE;gBACxC,OAAO,YAAY,CAAC;YACtB,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { NanoAddress } from './primitives/NanoAddress.js';
 export { NanoAmount } from './primitives/NanoAmount.js';
 export { WorkProvider, RemoteWorkServer, LocalCompute, type WorkProviderOptions } from './work/WorkProvider.js';
-export { NanoClient, TransportFallback, type NanoClientOptions } from './client.js';
+export { NanoClient, TransportFallback, type NanoClientOptions, type NanoClientActiveEndpoints } from './client.js';
+export { EndpointPool, HttpEndpointPool, NanoTransportConfigError, WsEndpointPool, normalizeEndpoints, } from './transport/index.js';
+export type { AuthSource, EndpointActivityEvent, EndpointAuditRecord, EndpointAuth, EndpointKind, EndpointPoolOptions, EndpointState, NormalizedEndpoint, TransportPolicy, } from './transport/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAChH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAChH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,KAAK,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACpH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,eAAe,GAChB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -2,4 +2,5 @@ export { NanoAddress } from './primitives/NanoAddress.js';
 export { NanoAmount } from './primitives/NanoAmount.js';
 export { WorkProvider, RemoteWorkServer, LocalCompute } from './work/WorkProvider.js';
 export { NanoClient, TransportFallback } from './client.js';
+export { EndpointPool, HttpEndpointPool, NanoTransportConfigError, WsEndpointPool, normalizeEndpoints, } from './transport/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAA4B,MAAM,wBAAwB,CAAC;AAChH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAA0B,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAA4B,MAAM,wBAAwB,CAAC;AAChH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAA0D,MAAM,aAAa,CAAC;AACpH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}

package/dist/transport/EndpointPool.d.ts

@@ -0,0 +1,16 @@
+import type { EndpointAuditRecord, EndpointPoolOptions, NormalizedEndpoint } from './types.js';
+export declare class EndpointPool {
+    private readonly states;
+    private readonly warn;
+    private readonly now;
+    private readonly baseDelayMs;
+    private readonly maxDelayMs;
+    private readonly onActiveEndpointChange;
+    private activeEndpointUrl;
+    constructor(options: EndpointPoolOptions);
+    private emitActiveEndpointChange;
+    getEndpoints(): NormalizedEndpoint[];
+    getAuditReport(): EndpointAuditRecord[];
+    execute<T>(attempt: (endpoint: NormalizedEndpoint) => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=EndpointPool.d.ts.map

package/dist/transport/EndpointPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointPool.d.ts","sourceRoot":"","sources":["../../src/transport/EndpointPool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mBAAmB,EACnB,mBAAmB,EAEnB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAQpB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAkD;IACzF,OAAO,CAAC,iBAAiB,CAAgB;gBAE7B,OAAO,EAAE,mBAAmB;IA2BxC,OAAO,CAAC,wBAAwB;IAczB,YAAY,IAAI,kBAAkB,EAAE;IAIpC,cAAc,IAAI,mBAAmB,EAAE;IAejC,OAAO,CAAC,CAAC,EACpB,OAAO,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,OAAO,CAAC,CAAC,CAAC,GACpD,OAAO,CAAC,CAAC,CAAC;CAoCd"}

package/dist/transport/EndpointPool.js

@@ -0,0 +1,105 @@
+import { normalizeEndpoints } from './normalize.js';
+function withJitter(delay) {
+    const factor = 0.85 + (Math.random() * 0.3);
+    return Math.round(delay * factor);
+}
+export class EndpointPool {
+    states;
+    warn;
+    now;
+    baseDelayMs;
+    maxDelayMs;
+    onActiveEndpointChange;
+    activeEndpointUrl;
+    constructor(options) {
+        this.warn = options.warn ?? (() => { });
+        this.now = options.now ?? (() => Date.now());
+        this.baseDelayMs = options.baseDelayMs ?? 500;
+        this.maxDelayMs = options.maxDelayMs ?? 30000;
+        this.onActiveEndpointChange = options.onActiveEndpointChange ?? null;
+        const endpoints = normalizeEndpoints({
+            kind: options.kind,
+            defaults: options.defaults,
+            warn: this.warn,
+            ...(options.urls ? { inputs: options.urls } : {}),
+            ...(options.env ? { env: options.env } : {}),
+            ...(options.transportPolicy ? { transportPolicy: options.transportPolicy } : {}),
+        });
+        this.states = endpoints.map((endpoint) => ({
+            endpoint,
+            consecutiveFailures: 0,
+            lastSuccessAt: null,
+            lastFailureAt: null,
+            cooldownUntil: 0,
+            lastLatencyMs: null,
+        }));
+        this.activeEndpointUrl = null;
+    }
+    emitActiveEndpointChange(nextUrl) {
+        if (!this.onActiveEndpointChange)
+            return;
+        if (this.activeEndpointUrl === nextUrl)
+            return;
+        const previousUrl = this.activeEndpointUrl ?? undefined;
+        this.activeEndpointUrl = nextUrl;
+        this.onActiveEndpointChange({
+            kind: this.states[0]?.endpoint.kind ?? 'rpc',
+            status: previousUrl ? 'failover' : 'connected',
+            activeUrl: nextUrl,
+            ...(previousUrl ? { previousUrl } : {}),
+        });
+    }
+    getEndpoints() {
+        return this.states.map((state) => state.endpoint);
+    }
+    getAuditReport() {
+        return this.states.map((state) => ({
+            kind: state.endpoint.kind,
+            url: state.endpoint.url.toString(),
+            authUsed: state.endpoint.auth.type === 'api-key',
+            authSource: state.endpoint.auth.type === 'api-key' ? state.endpoint.auth.source : null,
+            policy: state.endpoint.auth.type === 'api-key' ? state.endpoint.auth.policy : null,
+            consecutiveFailures: state.consecutiveFailures,
+            lastSuccessAt: state.lastSuccessAt,
+            lastFailureAt: state.lastFailureAt,
+            cooldownUntil: state.cooldownUntil > 0 ? new Date(state.cooldownUntil).toISOString() : null,
+            lastLatencyMs: state.lastLatencyMs,
+        }));
+    }
+    async execute(attempt) {
+        const start = this.now();
+        const orderedStates = [...this.states].sort((a, b) => {
+            const aReady = a.cooldownUntil <= start ? 0 : 1;
+            const bReady = b.cooldownUntil <= start ? 0 : 1;
+            if (aReady !== bReady)
+                return aReady - bReady;
+            const aLatency = a.lastLatencyMs ?? Number.MAX_SAFE_INTEGER;
+            const bLatency = b.lastLatencyMs ?? Number.MAX_SAFE_INTEGER;
+            return aLatency - bLatency;
+        });
+        let lastError;
+        for (const state of orderedStates) {
+            if (state.cooldownUntil > start)
+                continue;
+            const attemptStarted = this.now();
+            try {
+                const result = await attempt(state.endpoint);
+                state.consecutiveFailures = 0;
+                state.cooldownUntil = 0;
+                state.lastSuccessAt = new Date(this.now()).toISOString();
+                state.lastLatencyMs = this.now() - attemptStarted;
+                this.emitActiveEndpointChange(state.endpoint.url.toString());
+                return result;
+            }
+            catch (error) {
+                lastError = error;
+                state.consecutiveFailures += 1;
+                state.lastFailureAt = new Date(this.now()).toISOString();
+                const delay = Math.min(this.baseDelayMs * (2 ** (state.consecutiveFailures - 1)), this.maxDelayMs);
+                state.cooldownUntil = this.now() + withJitter(delay);
+            }
+        }
+        throw lastError instanceof Error ? lastError : new Error('All endpoints exhausted');
+    }
+}
+//# sourceMappingURL=EndpointPool.js.map

package/dist/transport/EndpointPool.js.map

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

package/dist/transport/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class NanoTransportConfigError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/transport/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/transport/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/transport/errors.js

@@ -0,0 +1,7 @@
+export class NanoTransportConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'NanoTransportConfigError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/transport/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/transport/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF"}

package/dist/transport/http.d.ts

@@ -0,0 +1,13 @@
+import type { EndpointAuditRecord, EndpointPoolOptions } from './types.js';
+export interface HttpPoolOptions extends Omit<EndpointPoolOptions, 'kind'> {
+    kind?: 'rpc' | 'work';
+    timeoutMs?: number;
+}
+export declare class HttpEndpointPool {
+    private readonly pool;
+    private readonly timeoutMs;
+    constructor(options: HttpPoolOptions);
+    getAuditReport(): EndpointAuditRecord[];
+    postJson<T>(body: Record<string, unknown>, extraHeaders?: Record<string, string>): Promise<T>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/transport/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAsB,MAAM,YAAY,CAAC;AAE/F,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACxE,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAeD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;gBAE9B,OAAO,EAAE,eAAe;IAQ7B,cAAc,IAAI,mBAAmB,EAAE;IAIjC,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAqC3G"}

package/dist/transport/http.js

@@ -0,0 +1,60 @@
+import { EndpointPool } from './EndpointPool.js';
+function buildHeaders(endpoint, extraHeaders) {
+    const headers = {
+        'Content-Type': 'application/json',
+        ...(extraHeaders ?? {}),
+    };
+    if (endpoint.auth.type === 'api-key') {
+        headers['Authorization'] = `Bearer ${endpoint.auth.value}`;
+    }
+    return headers;
+}
+export class HttpEndpointPool {
+    pool;
+    timeoutMs;
+    constructor(options) {
+        this.timeoutMs = options.timeoutMs ?? null;
+        this.pool = new EndpointPool({
+            ...options,
+            kind: options.kind ?? 'rpc',
+        });
+    }
+    getAuditReport() {
+        return this.pool.getAuditReport();
+    }
+    async postJson(body, extraHeaders) {
+        return this.pool.execute(async (endpoint) => {
+            const payload = endpoint.auth.type === 'api-key' && endpoint.auth.policy === 'json-body-key'
+                ? { ...body, key: endpoint.auth.value }
+                : endpoint.auth.type === 'api-key' && endpoint.auth.policy === 'bearer-and-json-body-key'
+                    ? { ...body, key: endpoint.auth.value }
+                    : body;
+            const controller = this.timeoutMs !== null ? new AbortController() : null;
+            const timer = controller && this.timeoutMs !== null
+                ? setTimeout(() => controller.abort(), this.timeoutMs)
+                : null;
+            let response;
+            try {
+                response = await fetch(endpoint.url, {
+                    method: 'POST',
+                    headers: buildHeaders(endpoint, extraHeaders),
+                    body: JSON.stringify(payload),
+                    ...(controller ? { signal: controller.signal } : {}),
+                });
+            }
+            finally {
+                if (timer !== null)
+                    clearTimeout(timer);
+            }
+            if (!response.ok) {
+                throw new Error(`HTTP error ${response.status} ${response.statusText}`);
+            }
+            const json = await response.json();
+            if (json.error) {
+                throw new Error(json.error);
+            }
+            return json;
+        });
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/transport/http.js.map

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

package/dist/transport/index.d.ts

@@ -0,0 +1,7 @@
+export { NanoTransportConfigError } from './errors.js';
+export { normalizeEndpoints } from './normalize.js';
+export { EndpointPool } from './EndpointPool.js';
+export { HttpEndpointPool, type HttpPoolOptions } from './http.js';
+export { WsEndpointPool, type WsPoolOptions } from './ws.js';
+export type { AuthSource, EndpointActivityEvent, EndpointAuth, EndpointAuditRecord, EndpointKind, EndpointPoolOptions, EndpointState, NormalizedEndpoint, TransportPolicy, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,YAAY,EACV,UAAU,EACV,qBAAqB,EACrB,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/transport/index.js

@@ -0,0 +1,6 @@
+export { NanoTransportConfigError } from './errors.js';
+export { normalizeEndpoints } from './normalize.js';
+export { EndpointPool } from './EndpointPool.js';
+export { HttpEndpointPool } from './http.js';
+export { WsEndpointPool } from './ws.js';
+//# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAwB,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,cAAc,EAAsB,MAAM,SAAS,CAAC"}

package/dist/transport/normalize.d.ts

@@ -0,0 +1,10 @@
+import type { EndpointKind, NormalizedEndpoint, TransportPolicy } from './types.js';
+export declare function normalizeEndpoints(options: {
+    kind: EndpointKind;
+    inputs?: string[];
+    env?: string;
+    defaults: string[];
+    warn?: (message: string) => void;
+    transportPolicy?: TransportPolicy;
+}): NormalizedEndpoint[];
+//# sourceMappingURL=normalize.d.ts.map

package/dist/transport/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/transport/normalize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,eAAe,EAChB,MAAM,YAAY,CAAC;AA6BpB,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC,GAAG,kBAAkB,EAAE,CAsFvB"}

package/dist/transport/normalize.js

@@ -0,0 +1,100 @@
+import { NanoTransportConfigError } from './errors.js';
+const API_KEY_QUERY_KEYS = ['key', 'apiKey', 'api_key'];
+function allowedProtocols(kind) {
+    switch (kind) {
+        case 'rpc':
+        case 'work':
+            return ['http:', 'https:'];
+        case 'ws':
+            return ['ws:', 'wss:'];
+    }
+}
+function defaultPolicy(kind) {
+    return kind === 'ws' ? 'bearer-header' : 'bearer-header';
+}
+function normalizePath(url) {
+    if (url.pathname === '')
+        url.pathname = '/';
+}
+function canonicalKey(endpoint) {
+    const authKey = endpoint.auth.type === 'api-key'
+        ? `${endpoint.auth.type}:${endpoint.auth.value}:${endpoint.auth.policy}`
+        : 'none';
+    return `${endpoint.kind}:${endpoint.url.toString()}:${authKey}`;
+}
+export function normalizeEndpoints(options) {
+    const warn = options.warn ?? (() => { });
+    const rawInputs = options.inputs && options.inputs.length > 0
+        ? options.inputs
+        : options.env && options.env.trim() !== ''
+            ? options.env.split(',')
+            : options.defaults;
+    const allowed = allowedProtocols(options.kind);
+    const normalized = [];
+    const seen = new Set();
+    for (const raw of rawInputs) {
+        const input = raw.trim();
+        if (input === '')
+            continue;
+        let url;
+        try {
+            url = new URL(input);
+        }
+        catch {
+            warn(`Ignoring malformed ${options.kind.toUpperCase()} endpoint "${input}": invalid URL`);
+            continue;
+        }
+        if (!allowed.includes(url.protocol)) {
+            warn(`Ignoring invalid ${options.kind.toUpperCase()} endpoint "${input}": expected ${allowed.join(' or ')}`);
+            continue;
+        }
+        if (url.hostname.trim() === '') {
+            warn(`Ignoring invalid ${options.kind.toUpperCase()} endpoint "${input}": hostname is required`);
+            continue;
+        }
+        let auth = { type: 'none' };
+        for (const key of API_KEY_QUERY_KEYS) {
+            const value = url.searchParams.get(key);
+            if (value && value.trim() !== '') {
+                auth = {
+                    type: 'api-key',
+                    value,
+                    source: 'query',
+                    policy: options.transportPolicy ?? defaultPolicy(options.kind),
+                };
+                url.searchParams.delete(key);
+                break;
+            }
+        }
+        if (auth.type === 'none' && url.username.trim() !== '') {
+            auth = {
+                type: 'api-key',
+                value: decodeURIComponent(url.username),
+                source: 'userinfo',
+                policy: options.transportPolicy ?? defaultPolicy(options.kind),
+            };
+            url.username = '';
+            url.password = '';
+        }
+        normalizePath(url);
+        const endpoint = {
+            kind: options.kind,
+            originalInput: input,
+            url,
+            auth,
+            auditLabel: `${url.toString()}${auth.type === 'api-key' ? ' (api-key used)' : ' (no auth)'}`,
+        };
+        const dedupeKey = canonicalKey(endpoint);
+        if (seen.has(dedupeKey)) {
+            warn(`Ignoring duplicate ${options.kind.toUpperCase()} endpoint "${endpoint.auditLabel}"`);
+            continue;
+        }
+        seen.add(dedupeKey);
+        normalized.push(endpoint);
+    }
+    if (normalized.length === 0) {
+        throw new NanoTransportConfigError(`No valid ${options.kind.toUpperCase()} endpoints remain after validation`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/transport/normalize.js.map

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

package/dist/transport/types.d.ts

@@ -0,0 +1,57 @@
+export type EndpointKind = 'rpc' | 'ws' | 'work';
+export type AuthSource = 'explicit' | 'query' | 'userinfo';
+export type TransportPolicy = 'bearer-header' | 'json-body-key' | 'bearer-and-json-body-key';
+export type EndpointAuth = {
+    type: 'none';
+} | {
+    type: 'api-key';
+    value: string;
+    source: AuthSource;
+    policy: TransportPolicy;
+};
+export interface NormalizedEndpoint {
+    kind: EndpointKind;
+    originalInput: string;
+    url: URL;
+    auth: EndpointAuth;
+    auditLabel: string;
+}
+export interface EndpointState {
+    endpoint: NormalizedEndpoint;
+    consecutiveFailures: number;
+    lastSuccessAt: string | null;
+    lastFailureAt: string | null;
+    cooldownUntil: number;
+    lastLatencyMs: number | null;
+}
+export interface EndpointAuditRecord {
+    kind: EndpointKind;
+    url: string;
+    authUsed: boolean;
+    authSource: AuthSource | null;
+    policy: TransportPolicy | null;
+    consecutiveFailures: number;
+    lastSuccessAt: string | null;
+    lastFailureAt: string | null;
+    cooldownUntil: string | null;
+    lastLatencyMs: number | null;
+}
+export interface EndpointActivityEvent {
+    kind: EndpointKind;
+    status: 'connected' | 'failover';
+    activeUrl: string;
+    previousUrl?: string;
+}
+export interface EndpointPoolOptions {
+    kind: EndpointKind;
+    env?: string;
+    urls?: string[];
+    defaults: string[];
+    warn?: (message: string) => void;
+    now?: () => number;
+    transportPolicy?: TransportPolicy;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    onActiveEndpointChange?: (event: EndpointActivityEvent) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/transport/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;AAEjD,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;AAE3D,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,eAAe,GAAG,0BAA0B,CAAC;AAE7F,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC;AAEpF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,WAAW,GAAG,UAAU,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACjE"}

package/dist/transport/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/transport/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":""}

package/dist/transport/ws.d.ts

@@ -0,0 +1,10 @@
+import type { EndpointAuditRecord, EndpointPoolOptions } from './types.js';
+export interface WsPoolOptions extends Omit<EndpointPoolOptions, 'kind'> {
+}
+export declare class WsEndpointPool {
+    private readonly pool;
+    constructor(options: WsPoolOptions);
+    getAuditReport(): EndpointAuditRecord[];
+    connect(): Promise<WebSocket>;
+}
+//# sourceMappingURL=ws.d.ts.map

package/dist/transport/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../src/transport/ws.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAsB,MAAM,YAAY,CAAC;AAE/F,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC;CAAG;AAE3E,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;gBAExB,OAAO,EAAE,aAAa;IAO3B,cAAc,IAAI,mBAAmB,EAAE;IAIjC,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC;CAiB3C"}

package/dist/transport/ws.js

@@ -0,0 +1,29 @@
+import { EndpointPool } from './EndpointPool.js';
+export class WsEndpointPool {
+    pool;
+    constructor(options) {
+        this.pool = new EndpointPool({
+            ...options,
+            kind: 'ws',
+        });
+    }
+    getAuditReport() {
+        return this.pool.getAuditReport();
+    }
+    async connect() {
+        return this.pool.execute(async (endpoint) => {
+            let connectUrl = endpoint.url.toString();
+            if (endpoint.auth.type === 'api-key') {
+                const url = new URL(connectUrl);
+                url.searchParams.set('api_key', endpoint.auth.value);
+                connectUrl = url.toString();
+            }
+            return await new Promise((resolve, reject) => {
+                const ws = new WebSocket(connectUrl);
+                ws.onopen = () => resolve(ws);
+                ws.onerror = () => reject(new Error(`WebSocket connect failed: ${endpoint.auditLabel}`));
+            });
+        });
+    }
+}
+//# sourceMappingURL=ws.js.map

package/dist/transport/ws.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.js","sourceRoot":"","sources":["../../src/transport/ws.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKjD,MAAM,OAAO,cAAc;IACR,IAAI,CAAe;IAEpC,YAAY,OAAsB;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,YAAY,CAAC;YAC3B,GAAG,OAAO;YACV,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC;IAEM,cAAc;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;IACpC,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,QAA4B,EAAE,EAAE;YAC9D,IAAI,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAEzC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACrC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;gBAChC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACrD,UAAU,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,CAAC;YAED,OAAO,MAAM,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACtD,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC;gBACrC,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC9B,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;YAC3F,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/work/WorkProvider.d.ts

@@ -1,3 +1,4 @@
+import type { EndpointActivityEvent } from '../transport/types.js';
 /**
  * Local compute engines available.
  */
@@ -19,6 +20,11 @@ export declare class RemoteWorkServer {
     }): RemoteWorkServer;
 }
 export interface WorkProviderOptions {
+    urls?: string[];
+    env?: string;
+    defaults?: string[];
+    warn?: (message: string) => void;
+    onActiveEndpointChange?: (event: EndpointActivityEvent) => void;
     remotes?: RemoteWorkServer[];
     localChain?: LocalCompute[];
     profiler?: {
@@ -29,6 +35,7 @@ export interface WorkProviderOptions {
 }
 export declare class WorkProvider {
     private options;
+    private remotePool;
     private constructor();
     static auto(options: WorkProviderOptions): WorkProvider;
     /**

package/dist/work/WorkProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkProvider.d.ts","sourceRoot":"","sources":["../../src/work/WorkProvider.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,YAAY;IACtB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,YAAY,SAAS;IACrB,GAAG,QAAQ;CACZ;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,UAAU,CAAS;gBAEf,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAK1C,IAAW,GAAG,IAAI,MAAM,CAAsB;IAC9C,IAAW,SAAS,IAAI,MAAM,CAA4B;IAE1D,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO;CAGvF;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,aAAa,EAAE,YAAY,GAAG,QAAQ,CAAC;KACxC,CAAC;CACH;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAsB;IAErC,OAAO;WAIO,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY;IAI9D;;OAEG;IACI,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAQ5C;;;OAGG;IACU,SAAS,IAAI,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAWlF;;OAEG;IACU,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAKzE"}
+{"version":3,"file":"WorkProvider.d.ts","sourceRoot":"","sources":["../../src/work/WorkProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGnE;;GAEG;AACH,oBAAY,YAAY;IACtB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,YAAY,SAAS;IACrB,GAAG,QAAQ;CACZ;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,UAAU,CAAS;gBAEf,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAK1C,IAAW,GAAG,IAAI,MAAM,CAAsB;IAC9C,IAAW,SAAS,IAAI,MAAM,CAA4B;IAE1D,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO;CAGvF;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAChE,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,aAAa,EAAE,YAAY,GAAG,QAAQ,CAAC;KACxC,CAAC;CACH;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,UAAU,CAA0B;IAE5C,OAAO;WAsBO,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY;IAI9D;;OAEG;IACI,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAS5C;;;OAGG;IACU,SAAS,IAAI,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAWlF;;OAEG;IACU,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAazE"}

package/dist/work/WorkProvider.js

@@ -1,3 +1,4 @@
+import { HttpEndpointPool } from '../transport/http.js';
 /**
  * Local compute engines available.
  */
@@ -23,8 +24,28 @@ export class RemoteWorkServer {
 }
 export class WorkProvider {
     options;
+    remotePool;
     constructor(options) {
         this.options = options;
+        const hasRemotePool = (options.urls && options.urls.length > 0) || options.env || (options.defaults && options.defaults.length > 0);
+        if (!hasRemotePool) {
+            this.remotePool = null;
+            return;
+        }
+        const remotePoolOptions = {
+            kind: 'work',
+            defaults: options.defaults ?? [],
+            transportPolicy: 'bearer-and-json-body-key',
+        };
+        if (options.urls && options.urls.length > 0)
+            remotePoolOptions.urls = options.urls;
+        if (options.env)
+            remotePoolOptions.env = options.env;
+        if (options.warn)
+            remotePoolOptions.warn = options.warn;
+        if (options.onActiveEndpointChange)
+            remotePoolOptions.onActiveEndpointChange = options.onActiveEndpointChange;
+        this.remotePool = new HttpEndpointPool(remotePoolOptions);
     }
     static auto(options) {
         return new WorkProvider(options);
@@ -34,6 +55,7 @@ export class WorkProvider {
      */
     getAuditReport() {
         return {
+            remotePool: this.remotePool?.getAuditReport() ?? [],
             remotes: this.options.remotes?.map(r => ({ url: r.url, timeoutMs: r.timeoutMs })) || [],
             localChain: this.options.localChain || [],
             profiler: this.options.profiler || 'default'
@@ -56,9 +78,17 @@ export class WorkProvider {
      * Generate Proof-of-Work for a given hash.
      */
     async generate(hash, difficulty) {
-        // In real implementation, this would route to Local vs Remote.
-        // Placeholder to satisfy signature matching the design.
-        return '0000000000000000'; // dummy work
+        if (this.remotePool) {
+            const response = await this.remotePool.postJson({
+                action: 'work_generate',
+                hash,
+                difficulty,
+            });
+            if (response.work)
+                return response.work;
+        }
+        // In real implementation, this would route to local fallback engines.
+        return '0000000000000000';
     }
 }
 //# sourceMappingURL=WorkProvider.js.map

package/dist/work/WorkProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"WorkProvider.js","sourceRoot":"","sources":["../../src/work/WorkProvider.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,+BAAe,CAAA;IACf,qCAAqB,CAAA;IACrB,2BAAW,CAAA;AACb,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB;AAED,MAAM,OAAO,gBAAgB;IACnB,IAAI,CAAS;IACb,UAAU,CAAS;IAE3B,YAAY,GAAW,EAAE,SAAiB;QACxC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,IAAW,GAAG,KAAa,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,IAAW,SAAS,KAAa,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAE1D,MAAM,CAAC,EAAE,CAAC,GAAW,EAAE,UAA6D,EAAE;QACpF,OAAO,IAAI,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;IAC9D,CAAC;CACF;AAYD,MAAM,OAAO,YAAY;IACf,OAAO,CAAsB;IAErC,YAAoB,OAA4B;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEM,MAAM,CAAC,IAAI,CAAC,OAA4B;QAC7C,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,cAAc;QACnB,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE;YACvF,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE;YACzC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,SAAS;SAC7C,CAAC;IACJ,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,SAAS;QACpB,wEAAwE;QACxE,kDAAkD;QAElD,yDAAyD;QACzD,OAAO;YACL,WAAW,EAAE,KAAK,EAAE,iCAAiC;YACrD,cAAc,EAAE,eAAe;SAChC,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,UAAkB;QACpD,+DAA+D;QAC/D,wDAAwD;QACxD,OAAO,kBAAkB,CAAC,CAAC,aAAa;IAC1C,CAAC;CACF"}
+{"version":3,"file":"WorkProvider.js","sourceRoot":"","sources":["../../src/work/WorkProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAwB,MAAM,sBAAsB,CAAC;AAI9E;;GAEG;AACH,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,+BAAe,CAAA;IACf,qCAAqB,CAAA;IACrB,2BAAW,CAAA;AACb,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB;AAED,MAAM,OAAO,gBAAgB;IACnB,IAAI,CAAS;IACb,UAAU,CAAS;IAE3B,YAAY,GAAW,EAAE,SAAiB;QACxC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,IAAW,GAAG,KAAa,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,IAAW,SAAS,KAAa,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAE1D,MAAM,CAAC,EAAE,CAAC,GAAW,EAAE,UAA6D,EAAE;QACpF,OAAO,IAAI,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;IAC9D,CAAC;CACF;AAiBD,MAAM,OAAO,YAAY;IACf,OAAO,CAAsB;IAC7B,UAAU,CAA0B;IAE5C,YAAoB,OAA4B;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,MAAM,aAAa,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEpI,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,OAAO;QACT,CAAC;QAED,MAAM,iBAAiB,GAAoB;YACzC,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;YAChC,eAAe,EAAE,0BAA0B;SAC5C,CAAC;QACF,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,iBAAiB,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACnF,IAAI,OAAO,CAAC,GAAG;YAAE,iBAAiB,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACrD,IAAI,OAAO,CAAC,IAAI;YAAE,iBAAiB,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACxD,IAAI,OAAO,CAAC,sBAAsB;YAAE,iBAAiB,CAAC,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;QAE9G,IAAI,CAAC,UAAU,GAAG,IAAI,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;IAC5D,CAAC;IAEM,MAAM,CAAC,IAAI,CAAC,OAA4B;QAC7C,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,cAAc;QACnB,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE;YACnD,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE;YACvF,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE;YACzC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,SAAS;SAC7C,CAAC;IACJ,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,SAAS;QACpB,wEAAwE;QACxE,kDAAkD;QAElD,yDAAyD;QACzD,OAAO;YACL,WAAW,EAAE,KAAK,EAAE,iCAAiC;YACrD,cAAc,EAAE,eAAe;SAChC,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,UAAkB;QACpD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAmB;gBAChE,MAAM,EAAE,eAAe;gBACvB,IAAI;gBACJ,UAAU;aACX,CAAC,CAAC;YACH,IAAI,QAAQ,CAAC,IAAI;gBAAE,OAAO,QAAQ,CAAC,IAAI,CAAC;QAC1C,CAAC;QAED,sEAAsE;QACtE,OAAO,kBAAkB,CAAC;IAC5B,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrai/nano-core",
-  "version": "1.0.0",
+  "version": "2.1.0",
   "description": "Protocol engine for Nano integration ecosystem",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,6 +9,18 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./transport": {
+      "import": "./dist/transport/index.js",
+      "types": "./dist/transport/index.d.ts"
+    },
+    "./transport/http": {
+      "import": "./dist/transport/http.js",
+      "types": "./dist/transport/http.d.ts"
+    },
+    "./transport/ws": {
+      "import": "./dist/transport/ws.js",
+      "types": "./dist/transport/ws.d.ts"
     }
   },
   "scripts": {
@@ -22,6 +34,9 @@
   ],
   "author": "OpenRai",
   "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
   "files": [
     "dist"
   ],
@@ -30,6 +45,7 @@
     "nanocurrency": "^2.5.0"
   },
   "devDependencies": {
+    "@types/node": "^24.6.0",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2"
   }