@xyo-network/xl1-rpc 3.0.0 → 3.0.2

package/dist/node/engine/rpcMethodHandlersFromTimeSyncViewer.d.ts

@@ -1,5 +0,0 @@
-import type { TimeSyncViewerMethods } from '@xyo-network/xl1-protocol-lib';
-import type { TimeSyncViewerRpcMethodHandlers } from '../types/index.ts';
-/** Creates RPC method handlers that delegate to a TimeSyncViewer instance. */
-export declare const rpcMethodHandlersFromTimeSyncViewer: (viewer: TimeSyncViewerMethods) => TimeSyncViewerRpcMethodHandlers;
-//# sourceMappingURL=rpcMethodHandlersFromTimeSyncViewer.d.ts.map

package/dist/node/engine/rpcMethodHandlersFromTimeSyncViewer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rpcMethodHandlersFromTimeSyncViewer.d.ts","sourceRoot":"","sources":["../../../src/engine/rpcMethodHandlersFromTimeSyncViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAE1E,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAA;AAExE,8EAA8E;AAC9E,eAAO,MAAM,mCAAmC,GAAI,QAAQ,qBAAqB,KAAG,+BAOnF,CAAA"}

package/dist/node/engine/rpcMethodHandlersFromTransactionViewer.d.ts

@@ -1,5 +0,0 @@
-import type { TransactionViewerMethods } from '@xyo-network/xl1-protocol-lib';
-import type { TransactionViewerRpcMethodHandlers } from '../index-node.ts';
-/** Creates RPC method handlers that delegate to a TransactionViewer instance. */
-export declare const rpcMethodHandlersFromTransactionViewer: (viewer: TransactionViewerMethods) => TransactionViewerRpcMethodHandlers;
-//# sourceMappingURL=rpcMethodHandlersFromTransactionViewer.d.ts.map

package/dist/node/engine/rpcMethodHandlersFromTransactionViewer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rpcMethodHandlersFromTransactionViewer.d.ts","sourceRoot":"","sources":["../../../src/engine/rpcMethodHandlersFromTransactionViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAE7E,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,kBAAkB,CAAA;AAE1E,iFAAiF;AACjF,eAAO,MAAM,sCAAsC,GAAI,QAAQ,wBAAwB,KAAG,kCAEzF,CAAA"}

package/dist/node/engine/rpcMethodHandlersFromViewer.d.ts

@@ -1,5 +0,0 @@
-import type { XyoViewer } from '@xyo-network/xl1-protocol-lib';
-import type { XyoViewerRpcMethodHandlers } from '../types/index.ts';
-/** Creates RPC method handlers that delegate to an XyoViewer instance. */
-export declare const rpcMethodHandlersFromViewer: (viewer: XyoViewer) => XyoViewerRpcMethodHandlers;
-//# sourceMappingURL=rpcMethodHandlersFromViewer.d.ts.map

package/dist/node/engine/rpcMethodHandlersFromViewer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rpcMethodHandlersFromViewer.d.ts","sourceRoot":"","sources":["../../../src/engine/rpcMethodHandlersFromViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAE9D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAA;AAEnE,0EAA0E;AAC1E,eAAO,MAAM,2BAA2B,GAAI,QAAQ,SAAS,KAAG,0BAoC/D,CAAA"}

package/dist/node/engine-node/composedRpcEngineFromConnection.d.ts

@@ -1,20 +0,0 @@
-import type { JsonRpcRequest } from '@metamask/json-rpc-engine/v2';
-import { JsonRpcEngineV2, JsonRpcServer } from '@metamask/json-rpc-engine/v2';
-import type { Logger } from '@xylabs/sdk-js';
-import type { XyoConnection } from '@xyo-network/xl1-protocol-lib';
-import type { RpcContext, RpcMiddleware } from './middleware/index.ts';
-/**
- * Composed alternative to {@link rpcEngineFromConnection}. Builds the same
- * engine surface, but as a stack of small middleware:
- *
- *   logging → [sub-engine per viewer/runner namespace] → method-not-found
- *
- * Each sub-engine pairs a {@link createValidationMiddleware} with a
- * {@link createTypedHandlerMiddleware}, isolating one viewer's schemas + handlers.
- * Cross-cutting concerns (logging, error mapping, future auth/rate-limit) live
- * once at the root rather than inside the dispatch loop.
- */
-export declare const composedRpcEngineFromConnection: (connection: XyoConnection, logger?: Logger) => JsonRpcEngineV2<JsonRpcRequest, RpcContext>;
-/** Convenience wrapper that returns a spec-compliant {@link JsonRpcServer}. */
-export declare const composedRpcServerFromConnection: (connection: XyoConnection, logger?: Logger) => JsonRpcServer<RpcMiddleware>;
-//# sourceMappingURL=composedRpcEngineFromConnection.d.ts.map

package/dist/node/engine-node/composedRpcEngineFromConnection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"composedRpcEngineFromConnection.d.ts","sourceRoot":"","sources":["../../../src/engine-node/composedRpcEngineFromConnection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,EACL,eAAe,EACf,aAAa,EACd,MAAM,8BAA8B,CAAA;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AA2BlE,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EAEd,MAAM,uBAAuB,CAAA;AA6B9B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,+BAA+B,GAC1C,YAAY,aAAa,EACzB,SAAS,MAAM,KAEd,eAAe,CAAC,cAAc,EAAE,UAAU,CAkF5C,CAAA;AAED,+EAA+E;AAC/E,eAAO,MAAM,+BAA+B,GAC1C,YAAY,aAAa,EACzB,SAAS,MAAM,KACd,aAAa,CAAC,aAAa,CAG7B,CAAA"}

package/dist/node/engine-node/index.d.ts

@@ -1,4 +0,0 @@
-export * from './composedRpcEngineFromConnection.ts';
-export * from './middleware/index.ts';
-export * from './rpcEngineFromConnection.ts';
-//# sourceMappingURL=index.d.ts.map

package/dist/node/engine-node/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine-node/index.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAA;AACpD,cAAc,uBAAuB,CAAA;AACrC,cAAc,8BAA8B,CAAA"}

package/dist/node/engine-node/middleware/RpcContext.d.ts

@@ -1,25 +0,0 @@
-import type { Json, JsonRpcMiddleware, JsonRpcRequest, MiddlewareContext } from '@metamask/json-rpc-engine/v2';
-import type { RequestResponseSchemas } from '../../types/index.ts';
-/**
- * Keys that validation middleware stamps into the per-request context.
- *
- * Must be a type alias (not an interface): `MiddlewareContext<K>` constrains
- * `K extends Record<PropertyKey, unknown>`, which interfaces can't satisfy
- * because they're open to declaration merging.
- */
-export type RpcContextKeyValues = {
-    /** Pre-validated, deserialized params; safe for handlers to consume. */
-    params: unknown;
-    /** The schema entry for the dispatched method; used to encode the result. */
-    schema: RequestResponseSchemas;
-};
-/** Typed MiddlewareContext used throughout the RPC engine. */
-export type RpcContext = MiddlewareContext<RpcContextKeyValues>;
-/**
- * Middleware shape used throughout the RPC engine. We only handle
- * {@link JsonRpcRequest}s (no notifications), so Result is constrained to
- * {@link JSON}. This matches what `createScaffoldMiddleware` and a sub-engine
- * built purely from request-handling middleware will produce.
- */
-export type RpcMiddleware = JsonRpcMiddleware<JsonRpcRequest, Json, RpcContext>;
-//# sourceMappingURL=RpcContext.d.ts.map

package/dist/node/engine-node/middleware/RpcContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RpcContext.d.ts","sourceRoot":"","sources":["../../../../src/engine-node/middleware/RpcContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EAClB,MAAM,8BAA8B,CAAA;AAErC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAElE;;;;;;GAMG;AAEH,MAAM,MAAM,mBAAmB,GAAG;IAChC,wEAAwE;IACxE,MAAM,EAAE,OAAO,CAAA;IACf,6EAA6E;IAC7E,MAAM,EAAE,sBAAsB,CAAA;CAC/B,CAAA;AAED,8DAA8D;AAC9D,MAAM,MAAM,UAAU,GAAG,iBAAiB,CAAC,mBAAmB,CAAC,CAAA;AAE/D;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC,cAAc,EAAE,IAAI,EAAE,UAAU,CAAC,CAAA"}

package/dist/node/engine-node/middleware/createHandlerMiddleware.d.ts

@@ -1,38 +0,0 @@
-import type { Promisable } from '@xylabs/sdk-js';
-import type { z } from 'zod/mini';
-import type { RpcSchemaMap } from '../../types/index.ts';
-import type { RpcMiddleware } from './RpcContext.ts';
-/**
- * Handler record whose signatures are derived directly from a schema map.
- *
- *   params:  `z.output<params.from>` — the in-memory shape that
- *            `params.from` produces by parsing the wire request on the
- *            server. This is what the handler actually receives.
- *
- *   result:  `z.input<result.to>` — the in-memory shape the handler
- *            returns, which `result.to` then encodes for the wire. For
- *            schemas without a `.transform()`, `z.input` and `z.output`
- *            are identical; for transform pipes (e.g. `BigIntToJsonZod`
- *            mapping `bigint` → `BrandedHex`) they diverge, and the
- *            handler must produce the pre-transform `bigint`/AttoXL1.
- *
- * A schema change forces a corresponding handler update (and vice versa).
- *
- * @example
- *   const handlers: TypedRpcHandlerRecord<typeof FinalizationViewerRpcSchemas> = {
- *     finalizationViewer_head: () => viewer.head(),
- *   }
- */
-export type TypedRpcHandlerRecord<TSchemas extends RpcSchemaMap> = {
-    [K in keyof TSchemas]: (params: z.output<TSchemas[K]['params']['from']>) => Promisable<z.input<TSchemas[K]['result']['to']>>;
-};
-/**
- * Builds a scaffold middleware that dispatches by method name to the matching
- * handler. `handlers` is constrained at the type level against `TSchemas` so
- * adding/removing/retyping a method in the schema map forces a corresponding
- * handler update (and vice versa). The `schemas` runtime argument exists only
- * to drive type inference — it's not consumed at runtime; each request's
- * schema entry is read from `MiddlewareContext` after upstream validation.
- */
-export declare const createTypedHandlerMiddleware: <TSchemas extends RpcSchemaMap>(_schemas: TSchemas, handlers: TypedRpcHandlerRecord<TSchemas>) => RpcMiddleware;
-//# sourceMappingURL=createHandlerMiddleware.d.ts.map

package/dist/node/engine-node/middleware/createHandlerMiddleware.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createHandlerMiddleware.d.ts","sourceRoot":"","sources":["../../../../src/engine-node/middleware/createHandlerMiddleware.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,UAAU,CAAA;AAEjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,iBAAiB,CAAA;AA8BhE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,qBAAqB,CAAC,QAAQ,SAAS,YAAY,IAAI;KAChE,CAAC,IAAI,MAAM,QAAQ,GAAG,CACrB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,KAC5C,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;CACtD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,GAAI,QAAQ,SAAS,YAAY,EACxE,UAAU,QAAQ,EAClB,UAAU,qBAAqB,CAAC,QAAQ,CAAC,KACxC,aAA+C,CAAA"}

package/dist/node/engine-node/middleware/createLoggingMiddleware.d.ts

@@ -1,9 +0,0 @@
-import type { Logger } from '@xylabs/sdk-js';
-import type { RpcMiddleware } from './RpcContext.ts';
-/**
- * Wraps downstream middleware in a try/catch and logs any thrown error
- * with the offending RPC method name. Re-throws so JsonRpcServer can
- * still format a spec-compliant error response.
- */
-export declare const createLoggingMiddleware: (logger?: Logger) => RpcMiddleware;
-//# sourceMappingURL=createLoggingMiddleware.d.ts.map

package/dist/node/engine-node/middleware/createLoggingMiddleware.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createLoggingMiddleware.d.ts","sourceRoot":"","sources":["../../../../src/engine-node/middleware/createLoggingMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,SAAS,MAAM,KAAG,aAOzD,CAAA"}

package/dist/node/engine-node/middleware/createMethodNotFoundMiddleware.d.ts

@@ -1,7 +0,0 @@
-import type { RpcMiddleware } from './RpcContext.ts';
-/**
- * Terminal middleware. Reached only when no sibling middleware/sub-engine
- * matched the request method; throws a JSON-RPC "method not found" error.
- */
-export declare const createMethodNotFoundMiddleware: () => RpcMiddleware;
-//# sourceMappingURL=createMethodNotFoundMiddleware.d.ts.map

package/dist/node/engine-node/middleware/createMethodNotFoundMiddleware.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createMethodNotFoundMiddleware.d.ts","sourceRoot":"","sources":["../../../../src/engine-node/middleware/createMethodNotFoundMiddleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;GAGG;AACH,eAAO,MAAM,8BAA8B,QAAO,aAEjD,CAAA"}

package/dist/node/engine-node/middleware/createValidationMiddleware.d.ts

@@ -1,10 +0,0 @@
-import type { RpcSchemaMap } from '../../types/index.ts';
-import type { RpcMiddleware } from './RpcContext.ts';
-/**
- * Validates the request against the matching Zod schema in `schemas`, then
- * stamps `params` and `schema` into the MiddlewareContext for downstream
- * handlers. If the method is not in `schemas`, the request is passed through
- * via `next()` — letting a sibling sub-engine or terminal middleware handle it.
- */
-export declare const createValidationMiddleware: (schemas: RpcSchemaMap) => RpcMiddleware;
-//# sourceMappingURL=createValidationMiddleware.d.ts.map

package/dist/node/engine-node/middleware/createValidationMiddleware.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createValidationMiddleware.d.ts","sourceRoot":"","sources":["../../../../src/engine-node/middleware/createValidationMiddleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GAAI,SAAS,YAAY,KAAG,aAoBlE,CAAA"}

package/dist/node/engine-node/middleware/index.d.ts

@@ -1,6 +0,0 @@
-export * from './createHandlerMiddleware.ts';
-export * from './createLoggingMiddleware.ts';
-export * from './createMethodNotFoundMiddleware.ts';
-export * from './createValidationMiddleware.ts';
-export * from './RpcContext.ts';
-//# sourceMappingURL=index.d.ts.map

package/dist/node/engine-node/middleware/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/engine-node/middleware/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,qCAAqC,CAAA;AACnD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,iBAAiB,CAAA"}

package/dist/node/engine-node/rpcEngineFromConnection.d.ts

@@ -1,11 +0,0 @@
-import type { JsonRpcMiddleware } from '@metamask/json-rpc-engine/v2';
-import { JsonRpcEngineV2, JsonRpcServer } from '@metamask/json-rpc-engine/v2';
-import type { Logger } from '@xylabs/sdk-js';
-import type { XyoConnection } from '@xyo-network/xl1-protocol-lib';
-export declare const rpcEngineFromConnection: (connection: XyoConnection, logger?: Logger) => JsonRpcEngineV2<import("@metamask/json-rpc-engine/v2").JsonRpcCall, import("@metamask/json-rpc-engine/v2").MiddlewareContext<{
-    [x: string]: unknown;
-    [x: number]: unknown;
-    [x: symbol]: unknown;
-}>>;
-export declare function rpcServerFromConnection(connection: XyoConnection, logger?: Logger): JsonRpcServer<JsonRpcMiddleware>;
-//# sourceMappingURL=rpcEngineFromConnection.d.ts.map

package/dist/node/engine-node/rpcEngineFromConnection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rpcEngineFromConnection.d.ts","sourceRoot":"","sources":["../../../src/engine-node/rpcEngineFromConnection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAC3E,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC7E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAQlE,eAAO,MAAM,uBAAuB,GAClC,YAAY,aAAa,EACzB,SAAS,MAAM;;;;GA6ChB,CAAA;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,oCAGjF"}

package/dist/node/index-node.d.ts

@@ -1,7 +0,0 @@
-export * from './engine/index.ts';
-export * from './engine-node/index.ts';
-export * from './networkTier3Descriptors.ts';
-export * from './provider/index.ts';
-export * from './transport/index.ts';
-export * from './types/index.ts';
-//# sourceMappingURL=index-node.d.ts.map

package/dist/node/index-node.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-node.d.ts","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA"}