devframe 1.3.1 → 1.3.3

package/dist/{nostics-D0PvLZsn.mjs → nostics-InlX4tmd.mjs}

@@ -1,6 +1,6 @@
 import { Diagnostic, createConsoleReporter, defineDiagnostics, defineProdDiagnostics, formatDiagnostic } from "nostics";
 import { ansiFormatter, ansiFormatter as ansiFormatter$1 } from "nostics/formatters/ansi";
-//#region src/utils/colors.ts
+// src/utils/colors.ts
 function makeColor(open, close) {
 	const o = `\x1B[${open}m`;
 	const c = `\x1B[${close}m`;
@@ -29,8 +29,7 @@ const colors = {
 	reset: makeColor(0, 0),
 	underline: makeColor(4, 24)
 };
-//#endregion
-//#region src/utils/nostics.ts
+// src/utils/nostics.ts
 const formatAnsi = ansiFormatter(colors);
 /**
 * The reporter every {@link defineDiagnostics} call below wires in ahead of
@@ -55,5 +54,4 @@ function defineDiagnostics$1(options) {
 		reporters: [devframeReporter, ...options.reporters ?? []]
 	});
 }
-//#endregion
 export { defineProdDiagnostics as a, defineDiagnostics$1 as i, ansiFormatter$1 as n, formatDiagnostic as o, createConsoleReporter as r, colors as s, Diagnostic as t };

package/dist/{origin-DZit9g29.mjs → origin-Ck7mLbKU.mjs}

@@ -1,4 +1,4 @@
-//#region src/utils/origin.ts
+// src/utils/origin.ts
 /**
 * Origin and hostname predicates shared by the RPC transports (the WS upgrade,
 * SSE, and MCP origin gates) and the instance shell's authentication-link
@@ -76,5 +76,4 @@ function validateOriginCandidate(candidate, allowedOrigins) {
 	if (canonical === "null") return void 0;
 	if (isLoopbackHostname(url.hostname) || allowedOrigins?.includes(canonical)) return canonical;
 }
-//#endregion
 export { isLoopbackHostname as n, validateOriginCandidate as r, isAllowedOrigin as t };

package/dist/recipes/interactive-auth.d.mts

@@ -1,7 +1,6 @@
-import { Bt as DevframeAuthHandler, o as DevframeNodeContext, s as DevframeNodeRpcSession } from "../context-BNxFOPbX.mjs";
-import "../index-CxJatyA1.mjs";
+import { B as DevframeNodeRpcSession, k as DevframeAuthHandler, z as DevframeNodeContext } from "../index-BhUqJUHG.mjs";
 import { ColorFn } from "../utils/colors.mjs";
-//#region src/recipes/interactive-auth.d.ts
+import "../node/auth.mjs";
 export interface CreateInteractiveAuthOptions {
   /**
    * Static, pre-shared bearer tokens that are always trusted, for CI runs
@@ -95,5 +94,4 @@ export declare function createAuthBanner(options?: CreateAuthBannerOptions): Aut
  * // the whole handler to `initDevframe` / `initHub` via their `auth` option.
  * ```
  */
-export declare function createInteractiveAuth(context: DevframeNodeContext, options?: CreateInteractiveAuthOptions): DevframeAuthHandler;
-//#endregion
+export declare function createInteractiveAuth(context: DevframeNodeContext, options?: CreateInteractiveAuthOptions): DevframeAuthHandler;

package/dist/recipes/interactive-auth.mjs

@@ -1,2 +1 @@
-import { n as createInteractiveAuth, t as createAuthBanner } from "../interactive-auth-DdDxs3WF.mjs";
-export { createAuthBanner, createInteractiveAuth };
+export { t as createAuthBanner, n as createInteractiveAuth } from "../interactive-auth-BURwIAvE.mjs";

package/dist/{remote-assets-eBvSKZMS.d.mts → remote-assets-5AQMHZnV.d.mts}

@@ -1,4 +1,3 @@
-//#region src/types/remote-assets.d.ts
 /**
  * A version-locked pointer at browser assets published as their own npm
  * package (e.g. `@devframes/plugin-git-client`), served through devframe's
@@ -119,5 +118,4 @@ interface RemoteAssetsStore {
    */
   materialize: (targetDir: string) => Promise<void>;
 }
-//#endregion
 export { RemoteAssetsStore as a, RemoteAssetsProviderCustom as i, RemoteAssetsErrorMessage as n, StaticAssetsSource as o, RemoteAssetsProvider as r, RemoteAssets as t };

package/dist/{remote-assets-B-n83kUY.mjs → remote-assets-DhonNeo_.mjs}

@@ -1,5 +1,5 @@
-import { t as diagnostics } from "./diagnostics-E_PvUPsA.mjs";
-import { t as lookup } from "./mrmime-40h5OOIp.mjs";
+import { t as lookup } from "./mrmime-y_XyiVcd.mjs";
+import { t as diagnostics } from "./diagnostics-DC1-WcvN.mjs";
 import { createRequire } from "node:module";
 import { mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
 import { dirname, extname, isAbsolute, join, normalize, resolve, sep } from "pathe";
@@ -8,7 +8,7 @@ import { formatWithOptions, inspect } from "node:util";
 import { createReadStream, existsSync } from "node:fs";
 import { Buffer } from "node:buffer";
 import { Readable } from "node:stream";
-//#region ../../node_modules/.pnpm/obug@3.0.0/node_modules/obug/dist/core.js
+// ../../node_modules/.pnpm/obug@3.0.0/node_modules/obug/dist/core.js
 /**
 * Coerce `value`.
 */
@@ -135,8 +135,7 @@ function enabled(name) {
 	for (const ns of names) if (matchesTemplate(name, ns)) return true;
 	return false;
 }
-//#endregion
-//#region ../../node_modules/.pnpm/obug@3.0.0/node_modules/obug/dist/ansi.js
+// ../../node_modules/.pnpm/obug@3.0.0/node_modules/obug/dist/ansi.js
 let env = {};
 try {
 	process.env.DEBUG;
@@ -293,8 +292,7 @@ function createDebug(namespace, options) {
 	return createDebug$1(namespace, Object.assign(defaultOptions, { color }, options));
 }
 enable(env.DEBUG || "");
-//#endregion
-//#region src/utils/remote-assets.ts
+// src/utils/remote-assets.ts
 const debugFetch = createDebug("devframe:remote-assets:fetch");
 const debugCache = createDebug("devframe:remote-assets:cache");
 const MANIFEST_FILENAME = ".manifest.json";
@@ -664,5 +662,4 @@ function resolveStaticAssetsSource(source, projectStorageDir, defaultResolveFrom
 	} : source;
 	return resolveInstalled(resolved) ?? createStore(resolved, join(projectStorageDir, ".remote-assets", `${resolved.package.replace(/\//g, "+")}@${resolved.version}`));
 }
-//#endregion
 export { createDebug as n, resolveStaticAssetsSource as t };

package/dist/{revoke-CeQUo6KI.mjs → revoke-D6KA3vwr.mjs}

@@ -1,5 +1,5 @@
-import { t as DEVFRAME_EVENTS } from "./events-0wDwalmL.mjs";
-//#region src/node/auth/revoke.ts
+import { t as DEVFRAME_EVENTS } from "./events-qWCKwD8-.mjs";
+// src/node/auth/revoke.ts
 /**
 * Flip `isTrusted` to false on any live WS clients connected with `token`
 * and broadcast the `auth:revoked` event so they can react.
@@ -32,5 +32,4 @@ async function revokeAuthToken(context, storage, token) {
 	});
 	await revokeActiveConnectionsForToken(context, token);
 }
-//#endregion
 export { revokeAuthToken as n, revokeActiveConnectionsForToken as t };

package/dist/{rolldown-runtime-B4iAMlE-.mjs → rolldown-runtime-BVN1G_yT.mjs}

@@ -1,20 +1,20 @@
 import { createRequire } from "node:module";
-//#region \0rolldown/runtime.js
+// \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
-var __exportAll = (all, no_symbols) => {
-	let target = {};
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod, mod.exports), cb = null), mod.exports);
+var __exportAll = (all, flags) => {
+	let target = Object.setPrototypeOf({}, null);
 	for (var name in all) __defProp(target, name, {
 		get: all[name],
 		enumerable: true
 	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
+	if (!(flags & 1)) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return flags & 2 ? target : Object.preventExtensions(target);
 };
 var __copyProps = (to, from, except, desc) => {
 	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
@@ -31,5 +31,4 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 var __require = /* #__PURE__ */ (() => createRequire(import.meta.url))();
-//#endregion
 export { __toESM as i, __exportAll as n, __require as r, __commonJSMin as t };

package/dist/rpc/client.d.mts

@@ -1,7 +1,5 @@
-import { a as ChannelOptions, i as BirpcReturn, r as BirpcOptions } from "../index-Bia1vKjL.mjs";
-//#region src/rpc/client.d.ts
+import { a as ChannelOptions, i as BirpcReturn, r as BirpcOptions } from "../index-BKu9BxcT.mjs";
 export declare function createRpcClient<ServerFunctions extends object = Record<string, never>, ClientFunctions extends object = Record<string, never>>(functions: ClientFunctions, options: {
   channel: ChannelOptions;
   rpcOptions?: Partial<BirpcOptions<ServerFunctions, ClientFunctions, boolean>>;
-}): BirpcReturn<ServerFunctions, ClientFunctions, false>;
-//#endregion
+}): BirpcReturn<ServerFunctions, ClientFunctions, false>;

package/dist/rpc/client.mjs

@@ -1,5 +1,5 @@
-import { t as createBirpc } from "../dist-CO98PBnQ.mjs";
-//#region src/rpc/client.ts
+import { t as createBirpc } from "../dist-BWGpvt-z.mjs";
+// src/rpc/client.ts
 function createRpcClient(functions, options) {
 	const { channel, rpcOptions = {} } = options;
 	return createBirpc(functions, {
@@ -9,5 +9,4 @@ function createRpcClient(functions, options) {
 		proxify: false
 	});
 }
-//#endregion
 export { createRpcClient };

package/dist/rpc/dump.d.mts

@@ -1,6 +1,5 @@
-import { i as BirpcReturn } from "../index-Bia1vKjL.mjs";
-import { c as RpcDumpCollectionOptions, f as RpcDumpRecordError, g as RpcFunctionDefinitionAny, i as RpcDefinitionsToFunctions, p as RpcDumpStore, s as RpcDumpClientOptions } from "../types-BmDbfHCx.mjs";
-//#region src/rpc/dump/collect.d.ts
+import { i as BirpcReturn } from "../index-BKu9BxcT.mjs";
+import { c as RpcDumpCollectionOptions, f as RpcDumpRecordError, g as RpcFunctionDefinitionAny, i as RpcDefinitionsToFunctions, p as RpcDumpStore, s as RpcDumpClientOptions } from "../types-KZOyhez5.mjs";
 export declare function dumpFunctions<T extends readonly RpcFunctionDefinitionAny[]>(definitions: T, context?: any, options?: RpcDumpCollectionOptions): Promise<RpcDumpStore<RpcDefinitionsToFunctions<T>>>;
 /**
  * Creates a client that serves pre-computed results from a dump store.
@@ -18,8 +17,6 @@ export declare function createClientFromDump<T extends Record<string, any>>(stor
  * Note: Only checks the definition itself, not setup results.
  */
 export declare function getDefinitionsWithDumps<T extends readonly RpcFunctionDefinitionAny[]>(definitions: T): RpcFunctionDefinitionAny[];
-//#endregion
-//#region src/rpc/dump/error.d.ts
 /**
  * Normalize a thrown value into a plain object suitable for storage in
  * a dump record. Preserves `message`, `name`, `cause`, and any own
@@ -35,8 +32,6 @@ export declare function serializeDumpError(error: unknown): RpcDumpRecordError;
  * the original `name`, and re-attaches any custom own properties.
  */
 export declare function reviveDumpError(stored: RpcDumpRecordError): Error;
-//#endregion
-//#region src/rpc/dump/static.d.ts
 export type StaticRpcDumpSerialization = 'json' | 'structured-clone';
 export interface StaticRpcDumpManifestStaticEntry {
   type: 'static';
@@ -66,8 +61,6 @@ export interface StaticRpcDumpCollection {
   files: Record<string, StaticRpcDumpFile>;
 }
 export declare function collectStaticRpcDump(definitions: Iterable<RpcFunctionDefinitionAny>, context: any): Promise<StaticRpcDumpCollection>;
-//#endregion
-//#region src/rpc/dump/write.d.ts
 export interface WriteStaticRpcDumpOptions {
   /**
    * Pretty-print RPC dump JSON files. Defaults to `false` so payload
@@ -81,5 +74,4 @@ export interface WriteStaticRpcDumpOptions {
  * the `__rpc-dump/index.json` manifest, under `outDir`. Shared by the build
  * adapter (`createBuild`) and `@devframes/hub`'s `buildHub`.
  */
-export declare function writeStaticRpcDump(dump: StaticRpcDumpCollection, outDir: string, options?: WriteStaticRpcDumpOptions): Promise<void>;
-//#endregion
+export declare function writeStaticRpcDump(dump: StaticRpcDumpCollection, outDir: string, options?: WriteStaticRpcDumpOptions): Promise<void>;

package/dist/rpc/dump.mjs

@@ -1,2 +1 @@
-import { a as getDefinitionsWithDumps, i as dumpFunctions, n as collectStaticRpcDump, o as reviveDumpError, r as createClientFromDump, s as serializeDumpError, t as writeStaticRpcDump } from "../write-DK7rBUN3.mjs";
-export { collectStaticRpcDump, createClientFromDump, dumpFunctions, getDefinitionsWithDumps, reviveDumpError, serializeDumpError, writeStaticRpcDump };
+export { n as collectStaticRpcDump, r as createClientFromDump, i as dumpFunctions, a as getDefinitionsWithDumps, o as reviveDumpError, s as serializeDumpError, t as writeStaticRpcDump } from "../write-3miSvPaD.mjs";

package/dist/rpc/index.d.mts

@@ -1,4 +1,122 @@
-import { i as BirpcReturn, t as BirpcFn } from "../index-Bia1vKjL.mjs";
-import { a as STRUCTURED_CLONE_PREFIX, c as getRpcResolvedSetupResult, d as RpcFunctionsCollectorBase, f as RpcCacheManager, i as validateRpcReturn, l as createDefineWrapperWithContext, n as validateDefinitions, o as strictJsonStringify, p as RpcCacheOptions, r as validateRpcArgs, s as getRpcHandler, t as validateDefinition, u as defineRpcFunction } from "../index-DuEm0sDH.mjs";
-import { C as RpcFunctionType, E as Thenable, S as RpcFunctionSetupResult, T as RpcReturnSchema, _ as RpcFunctionDefinitionAnyWithContext, a as RpcDefinitionsToFunctionsWithNamespace, b as RpcFunctionDefinitionWithSchemas, c as RpcDumpCollectionOptions, d as RpcDumpRecord, f as RpcDumpRecordError, g as RpcFunctionDefinitionAny, h as RpcFunctionDefinition, i as RpcDefinitionsToFunctions, l as RpcDumpDefinition, m as RpcFunctionAgentOptions, n as RpcArgsSchema, o as RpcDump, p as RpcDumpStore, r as RpcDefinitionsFilter, s as RpcDumpClientOptions, t as EntriesToObject, u as RpcDumpGetter, v as RpcFunctionDefinitionBase, w as RpcFunctionsCollector, x as RpcFunctionDefinitionWithoutSchemas, y as RpcFunctionDefinitionToFunction } from "../types-BmDbfHCx.mjs";
-export { type BirpcFn, type BirpcReturn, EntriesToObject, RpcArgsSchema, RpcCacheManager, RpcCacheOptions, RpcDefinitionsFilter, RpcDefinitionsToFunctions, RpcDefinitionsToFunctionsWithNamespace, RpcDump, RpcDumpClientOptions, RpcDumpCollectionOptions, RpcDumpDefinition, RpcDumpGetter, RpcDumpRecord, RpcDumpRecordError, RpcDumpStore, RpcFunctionAgentOptions, RpcFunctionDefinition, RpcFunctionDefinitionAny, RpcFunctionDefinitionAnyWithContext, RpcFunctionDefinitionBase, RpcFunctionDefinitionToFunction, RpcFunctionDefinitionWithSchemas, RpcFunctionDefinitionWithoutSchemas, RpcFunctionSetupResult, RpcFunctionType, RpcFunctionsCollector, RpcFunctionsCollectorBase, RpcReturnSchema, STRUCTURED_CLONE_PREFIX, Thenable, createDefineWrapperWithContext, defineRpcFunction, getRpcHandler, getRpcResolvedSetupResult, strictJsonStringify, validateDefinition, validateDefinitions, validateRpcArgs, validateRpcReturn };
+import { i as BirpcReturn, t as BirpcFn } from "../index-BKu9BxcT.mjs";
+import { C as RpcFunctionType, E as Thenable, S as RpcFunctionSetupResult, T as RpcReturnSchema, _ as RpcFunctionDefinitionAnyWithContext, a as RpcDefinitionsToFunctionsWithNamespace, b as RpcFunctionDefinitionWithSchemas, c as RpcDumpCollectionOptions, d as RpcDumpRecord, f as RpcDumpRecordError, g as RpcFunctionDefinitionAny, h as RpcFunctionDefinition, i as RpcDefinitionsToFunctions, l as RpcDumpDefinition, m as RpcFunctionAgentOptions, n as RpcArgsSchema, o as RpcDump, p as RpcDumpStore, r as RpcDefinitionsFilter, s as RpcDumpClientOptions, t as EntriesToObject, u as RpcDumpGetter, v as RpcFunctionDefinitionBase, w as RpcFunctionsCollector, x as RpcFunctionDefinitionWithoutSchemas, y as RpcFunctionDefinitionToFunction } from "../types-KZOyhez5.mjs";
+export interface RpcCacheOptions {
+  functions: string[];
+  keySerializer?: (args: unknown[]) => string;
+}
+/**
+ * @experimental API is expected to change.
+ */
+export declare class RpcCacheManager {
+  private cacheMap;
+  private options;
+  private keySerializer;
+  constructor(options: RpcCacheOptions);
+  updateOptions(options: Partial<RpcCacheOptions>): void;
+  cached<T>(m: string, a: unknown[]): T | undefined;
+  has(m: string, a: unknown[]): boolean;
+  apply(req: {
+    m: string;
+    a: unknown[];
+  }, res: unknown): void;
+  validate(m: string): boolean;
+  clear(fn?: string): void;
+}
+export declare class RpcFunctionsCollectorBase<LocalFunctions extends Record<string, any>, SetupContext> implements RpcFunctionsCollector<LocalFunctions, SetupContext> {
+  readonly context: SetupContext;
+  readonly definitions: Map<string, RpcFunctionDefinition<string, any, any, any, any, any, SetupContext>>;
+  readonly functions: LocalFunctions;
+  private readonly _onChanged;
+  constructor(context: SetupContext);
+  register(fnDef: RpcFunctionDefinition<string, any, any, any, any, any, SetupContext>, force?: boolean): void;
+  update(fn: RpcFunctionDefinition<string, any, any, any, any, any, SetupContext>, force?: boolean): void;
+  onChanged(fn: (id?: string) => void): () => void;
+  getHandler<T extends keyof LocalFunctions>(name: T): Promise<LocalFunctions[T]>;
+  getSchema<T extends keyof LocalFunctions>(name: T): {
+    args: RpcArgsSchema | undefined;
+    returns: RpcReturnSchema | undefined;
+  };
+  has(name: string): boolean;
+  get(name: string): RpcFunctionDefinition<string, any, any, any, any, any, SetupContext> | undefined;
+  list(): string[];
+}
+export declare function defineRpcFunction<NAME extends string, TYPE extends RpcFunctionType, ARGS extends any[], RETURN = void, const AS extends RpcArgsSchema | undefined = undefined, const RS extends RpcReturnSchema | undefined = undefined>(definition: RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS>): RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS>;
+export declare function createDefineWrapperWithContext<CONTEXT>(): <NAME extends string, TYPE extends RpcFunctionType, ARGS extends any[], RETURN = void, const AS extends RpcArgsSchema | undefined = undefined, const RS extends RpcReturnSchema | undefined = undefined>(definition: RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, CONTEXT>) => RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, CONTEXT>;
+export declare function getRpcResolvedSetupResult<NAME extends string, TYPE extends RpcFunctionType, ARGS extends any[], RETURN = void, CONTEXT = undefined>(definition: RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, any, any, CONTEXT>, context: CONTEXT): Promise<RpcFunctionSetupResult<ARGS, RETURN>>;
+export declare function getRpcHandler<NAME extends string, TYPE extends RpcFunctionType, ARGS extends any[], RETURN = void, CONTEXT = undefined>(definition: RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, any, any, CONTEXT>, context: CONTEXT): Promise<(...args: ARGS) => RETURN>;
+/**
+ * Wire format used by the live RPC transports (WebSocket and SSE).
+ *
+ * - **JSON (default, unprefixed):** payload is plain JSON text. Used when
+ *   the dispatched method is declared `jsonSerializable: true`. Encoded
+ *   via {@link strictJsonStringify} (rejects non-JSON values), decoded
+ *   via `JSON.parse`.
+ * - **Structured-clone (`s:` prefix):** payload is `s:` followed by
+ *   `structured-clone-es` text. Used when the method is declared
+ *   `jsonSerializable: false` (or omitted, the default). Round-trips
+ *   `Map`, `Set`, `Date`, `BigInt`, cycles, and class instances.
+ *
+ * birpc envelopes always start with `{`, so a leading byte that is not
+ * `s` is unambiguously JSON. Each direction independently chooses its
+ * encoding from local definitions; request and response are not
+ * coupled by a mirror rule.
+ */
+export declare const STRUCTURED_CLONE_PREFIX = "s:";
+/**
+ * `JSON.stringify` with a single-pass strict replacer.
+ *
+ * Throws `DF0020` synchronously when the value contains a type JSON
+ * cannot round-trip losslessly: `Map`, `Set`, `Date`, `BigInt`, class
+ * instances, or `undefined` inside an array (silently becomes `null`).
+ *
+ * Native pass-throughs (no extra work needed):
+ *   - circular references: `JSON.stringify` raises `TypeError`.
+ *   - `BigInt` at top level: caught here for a friendlier error path.
+ *
+ * Lenient cases (allowed without throwing):
+ *   - `undefined` as an object property: legitimate optional field;
+ *     JSON.stringify just omits it.
+ *   - `undefined` at the root: legitimate "action returned nothing".
+ *   - `Symbol` / `Function` values: semantically "drop me" in JSON.
+ *
+ * `fnName` is used only for the diagnostic message; pass the RPC
+ * function name when calling from a wire serializer / dump writer so
+ * the error points at the offending function.
+ */
+export declare function strictJsonStringify(value: unknown, fnName?: string): string;
+/**
+ * Validate positional arguments against their declared schemas. Only
+ * indices with a schema are checked; extra arguments pass through
+ * untouched. Throws `DF0038` on the first failing argument.
+ *
+ * Validation guards the payload without rewriting it: the original values
+ * are handed to the handler unchanged, so a schema that describes a subset
+ * of an object never silently strips the sender's extra fields (and any
+ * declared transforms stay a purely type-level concern).
+ *
+ * @internal
+ */
+export declare function validateRpcArgs(name: string, argsSchema: RpcArgsSchema | undefined, args: readonly unknown[]): Promise<unknown[]>;
+/**
+ * Validate a handler's resolved return value against its declared schema.
+ * Throws `DF0039` when the value fails the schema, otherwise returns the
+ * original value unchanged (guard-only, never rewriting the payload; see
+ * {@link validateRpcArgs}). Passes through when no return schema is set.
+ *
+ * @internal
+ */
+export declare function validateRpcReturn(name: string, returnSchema: RpcReturnSchema | undefined, value: unknown): Promise<unknown>;
+/**
+ * Validates RPC function definitions.
+ * Action and event functions cannot have dumps (side effects should not be cached).
+ *
+ * @throws {Error} If an action or event function has a dump configuration
+ */
+export declare function validateDefinitions(definitions: readonly RpcFunctionDefinitionAny[]): void;
+/**
+ * Validates a single RPC function definition.
+ *
+ * @throws {Error} If an action or event function has a dump configuration
+ */
+export declare function validateDefinition(definition: RpcFunctionDefinitionAny): void;
+export { type BirpcFn, type BirpcReturn, EntriesToObject, RpcArgsSchema, RpcDefinitionsFilter, RpcDefinitionsToFunctions, RpcDefinitionsToFunctionsWithNamespace, RpcDump, RpcDumpClientOptions, RpcDumpCollectionOptions, RpcDumpDefinition, RpcDumpGetter, RpcDumpRecord, RpcDumpRecordError, RpcDumpStore, RpcFunctionAgentOptions, RpcFunctionDefinition, RpcFunctionDefinitionAny, RpcFunctionDefinitionAnyWithContext, RpcFunctionDefinitionBase, RpcFunctionDefinitionToFunction, RpcFunctionDefinitionWithSchemas, RpcFunctionDefinitionWithoutSchemas, RpcFunctionSetupResult, RpcFunctionType, RpcFunctionsCollector, RpcReturnSchema, Thenable };

package/dist/rpc/index.mjs

@@ -1,8 +1,8 @@
-import { i as hash, n as validateDefinitions, r as ensureAgentJsonSerializable, t as validateDefinition } from "../validation-CMfDAti3.mjs";
-import { n as strictJsonStringify, r as diagnostics, t as STRUCTURED_CLONE_PREFIX } from "../serialization-BhuOoL80.mjs";
-import { i as validateRpcReturn, n as getRpcResolvedSetupResult, r as validateRpcArgs, t as getRpcHandler } from "../handler-DmaAfpGq.mjs";
-import { n as defineRpcFunction, t as createDefineWrapperWithContext } from "../define-BLWPsH6y.mjs";
-//#region src/rpc/cache.ts
+import { i as hash, n as validateDefinitions, r as ensureAgentJsonSerializable, t as validateDefinition } from "../validation-Cjy1P58H.mjs";
+import { n as strictJsonStringify, r as diagnostics, t as STRUCTURED_CLONE_PREFIX } from "../serialization-iiTQ7n21.mjs";
+import { i as validateRpcReturn, n as getRpcResolvedSetupResult, r as validateRpcArgs, t as getRpcHandler } from "../handler-DkLlj3-B.mjs";
+import { n as defineRpcFunction, t as createDefineWrapperWithContext } from "../define-C8h-fyD3.mjs";
+// src/rpc/cache.ts
 /**
 * @experimental API is expected to change.
 */
@@ -40,8 +40,7 @@ var RpcCacheManager = class {
 		else this.cacheMap.clear();
 	}
 };
-//#endregion
-//#region src/rpc/collector.ts
+// src/rpc/collector.ts
 var RpcFunctionsCollectorBase = class {
 	context;
 	definitions = /* @__PURE__ */ new Map();
@@ -112,5 +111,4 @@ var RpcFunctionsCollectorBase = class {
 		return Array.from(this.definitions.keys());
 	}
 };
-//#endregion
 export { RpcCacheManager, RpcFunctionsCollectorBase, STRUCTURED_CLONE_PREFIX, createDefineWrapperWithContext, defineRpcFunction, getRpcHandler, getRpcResolvedSetupResult, strictJsonStringify, validateDefinition, validateDefinitions, validateRpcArgs, validateRpcReturn };

package/dist/rpc/server.d.mts

@@ -1,6 +1,4 @@
-import { n as BirpcGroup, o as EventOptions } from "../index-Bia1vKjL.mjs";
-//#region src/rpc/server.d.ts
+import { n as BirpcGroup, o as EventOptions } from "../index-BKu9BxcT.mjs";
 export declare function createRpcServer<ClientFunctions extends object = Record<string, never>, ServerFunctions extends object = Record<string, never>>(functions: ServerFunctions, options?: {
   rpcOptions?: EventOptions<ClientFunctions, ServerFunctions, false>;
-}): BirpcGroup<ClientFunctions, ServerFunctions, false>;
-//#endregion
+}): BirpcGroup<ClientFunctions, ServerFunctions, false>;

package/dist/rpc/server.mjs

@@ -1,10 +1,9 @@
-import { n as createBirpcGroup } from "../dist-CO98PBnQ.mjs";
-//#region src/rpc/server.ts
+import { n as createBirpcGroup } from "../dist-BWGpvt-z.mjs";
+// src/rpc/server.ts
 function createRpcServer(functions, options = {}) {
 	return createBirpcGroup(functions, [], {
 		...options.rpcOptions,
 		proxify: false
 	});
 }
-//#endregion
 export { createRpcServer };

package/dist/rpc/transports/sse-client.d.mts

@@ -1,2 +1,34 @@
-import { n as createSseRpcChannel, t as SseRpcChannelOptions } from "../../sse-client-DNdscfu_.mjs";
-export { SseRpcChannelOptions, createSseRpcChannel };
+import { a as ChannelOptions } from "../../index-BKu9BxcT.mjs";
+import { g as RpcFunctionDefinitionAny } from "../../types-KZOyhez5.mjs";
+export interface SseRpcChannelOptions {
+  /** Resolved `http(s)://` URL of the SSE endpoint. */
+  url: string;
+  onConnected?: () => void;
+  onError?: (e: Error) => void;
+  onDisconnected?: () => void;
+  authToken?: string;
+  /**
+   * RPC function definitions (or just the `jsonSerializable` flag per
+   * method) used to dispatch the per-call wire serializer, the same contract
+   * as the WS channel.
+   */
+  definitions?: ReadonlyMap<string, Pick<RpcFunctionDefinitionAny, 'jsonSerializable'>>;
+  /** Fetch implementation. Default: `globalThis.fetch`. */
+  fetch?: typeof globalThis.fetch;
+}
+/**
+ * Build a birpc `ChannelOptions` object backed by an SSE stream (server →
+ * client) and HTTP `POST` (client → server): the WebSocket-free counterpart
+ * to `createWsRpcChannel`, wire-compatible with `attachSseRpcTransport`.
+ *
+ * The stream is consumed via `fetch` streaming (not `EventSource`), so it
+ * works in browsers and server runtimes alike. The server's first frame
+ * (`event: session`) carries the session id; every `POST` echoes it in the
+ * `x-birpc-session` header. A response to a client-initiated request comes
+ * back in the `POST`'s own body and is re-injected into the channel; a
+ * dropped stream terminates the channel; there is no reconnect, matching
+ * the WS channel's closed-is-done semantics.
+ */
+export declare function createSseRpcChannel(options: SseRpcChannelOptions): ChannelOptions & {
+  close: () => void;
+};

package/dist/rpc/transports/sse-client.mjs

@@ -1,6 +1,6 @@
 import { DEVFRAME_AUTH_TOKEN_QUERY_PARAM, DEVFRAME_SSE_SESSION_HEADER } from "../../constants.mjs";
-import { t as createRpcWireCodec } from "../../wire-codec-B1W3zH3L.mjs";
-//#region src/rpc/transports/sse-client.ts
+import { t as createRpcWireCodec } from "../../wire-codec-BdngvzfH.mjs";
+// src/rpc/transports/sse-client.ts
 function NOOP() {}
 /** Split the next complete SSE frame (up to a blank line) off the buffer. */
 function takeFrame(buffer) {
@@ -154,5 +154,4 @@ function createSseRpcChannel(options) {
 		deserialize: codec.deserialize
 	};
 }
-//#endregion
 export { createSseRpcChannel };

package/dist/rpc/transports/sse-server.d.mts

@@ -1,8 +1,7 @@
-import { n as BirpcGroup } from "../../index-Bia1vKjL.mjs";
-import { g as RpcFunctionDefinitionAny } from "../../types-BmDbfHCx.mjs";
-import { n as DevframeRpcConnection, t as DevframeNodeRpcSessionMeta } from "../../session-r6PDixP6.mjs";
-import { n as WsOriginRegistry } from "../../ws-server-y2R76aSW.mjs";
-//#region src/rpc/transports/sse-server.d.ts
+import { n as BirpcGroup } from "../../index-BKu9BxcT.mjs";
+import { g as RpcFunctionDefinitionAny } from "../../types-KZOyhez5.mjs";
+import { n as DevframeRpcConnection, t as DevframeNodeRpcSessionMeta } from "../../session-Y9R6tqg4.mjs";
+import { WsOriginRegistry } from "./ws-server.mjs";
 export interface SseRpcTransportOptions {
   /**
    * Same contract as `WsRpcTransportOptions.allowedOrigins`: extra origins
@@ -57,5 +56,4 @@ export interface SseRpcTransport {
  *  - server-initiated calls/events stream down as `event: message`
  *    frames, and the client's replies up via `POST` get a bare `202`.
  */
-export declare function attachSseRpcTransport<ClientFunctions extends object, ServerFunctions extends object>(rpcGroup: BirpcGroup<ClientFunctions, ServerFunctions, false>, options?: SseRpcTransportOptions): SseRpcTransport;
-//#endregion
+export declare function attachSseRpcTransport<ClientFunctions extends object, ServerFunctions extends object>(rpcGroup: BirpcGroup<ClientFunctions, ServerFunctions, false>, options?: SseRpcTransportOptions): SseRpcTransport;

package/dist/rpc/transports/sse-server.mjs

@@ -1,8 +1,8 @@
 import { DEVFRAME_SSE_SESSION_HEADER } from "../../constants.mjs";
-import { n as peekRpcWireFrame, t as createRpcWireCodec } from "../../wire-codec-B1W3zH3L.mjs";
-import { t as isAllowedOrigin } from "../../origin-DZit9g29.mjs";
-import { t as createRpcSessionMeta } from "../../session-DPfj6zQG.mjs";
-//#region src/rpc/transports/sse-server.ts
+import { t as isAllowedOrigin } from "../../origin-Ck7mLbKU.mjs";
+import { n as peekRpcWireFrame, t as createRpcWireCodec } from "../../wire-codec-BdngvzfH.mjs";
+import { t as createRpcSessionMeta } from "../../session-BjvoLH3r.mjs";
+// src/rpc/transports/sse-server.ts
 const SSE_STREAM_HEADERS = {
 	"content-type": "text/event-stream",
 	"cache-control": "no-cache, no-transform",
@@ -205,5 +205,4 @@ function attachSseRpcTransport(rpcGroup, options = {}) {
 		}
 	};
 }
-//#endregion
 export { attachSseRpcTransport };

package/dist/rpc/transports/ws-bun.d.mts

@@ -1,6 +1,5 @@
-import { n as WsOriginRegistry } from "../../ws-server-y2R76aSW.mjs";
-import { t as ContextRpcServer } from "../../rpc-core-CGTCla-R.mjs";
-//#region src/rpc/transports/ws-bun.d.ts
+import { t as ContextRpcServer } from "../../rpc-core-CblgPYJ_.mjs";
+import { WsOriginRegistry } from "./ws-server.mjs";
 export interface AttachBunWsTransportOptions {
   /** Same contract as `WsRpcTransportOptions.allowedOrigins`. */
   allowedOrigins?: readonly string[] | WsOriginRegistry | false;
@@ -30,5 +29,4 @@ export interface BunWsTier {
  * app's own origin, with no side-car server. Load it dynamically so the Bun
  * adapter never enters a Node-only bundle path.
  */
-export declare function attachBunWsTransport(core: ContextRpcServer, options?: AttachBunWsTransportOptions): Promise<BunWsTier>;
-//#endregion
+export declare function attachBunWsTransport(core: ContextRpcServer, options?: AttachBunWsTransportOptions): Promise<BunWsTier>;

package/dist/rpc/transports/ws-bun.mjs

@@ -1,6 +1,6 @@
-import { t as isAllowedOrigin } from "../../origin-DZit9g29.mjs";
+import { t as isAllowedOrigin } from "../../origin-Ck7mLbKU.mjs";
 import { createWsRpcPeerHooks } from "./ws-server.mjs";
-//#region src/rpc/transports/ws-bun.ts
+// src/rpc/transports/ws-bun.ts
 /**
 * The Bun fetch-upgrade WebSocket tier for `initDevframe` / `initHub`: the
 * same RPC peer wiring as `attachWsRpcTransport`, driven by crossws's Bun
@@ -33,5 +33,4 @@ async function attachBunWsTransport(core, options = {}) {
 		close: () => ws.close()
 	};
 }
-//#endregion
 export { attachBunWsTransport };

package/dist/rpc/transports/ws-client.d.mts

@@ -1,2 +1,27 @@
-import { n as createWsRpcChannel, t as WsRpcChannelOptions } from "../../ws-client-6Mrz6eC4.mjs";
-export { WsRpcChannelOptions, createWsRpcChannel };
+import { a as ChannelOptions } from "../../index-BKu9BxcT.mjs";
+import { g as RpcFunctionDefinitionAny } from "../../types-KZOyhez5.mjs";
+export interface WsRpcChannelOptions {
+  url: string;
+  onConnected?: (e: Event) => void;
+  onError?: (e: Error) => void;
+  onDisconnected?: (e: CloseEvent) => void;
+  authToken?: string;
+  /**
+   * RPC function definitions (or just the `jsonSerializable` flag per
+   * method) used to dispatch the per-call wire serializer. Pass an
+   * empty / partial map on clients that don't have the full registry;
+   * encoding falls back to structured-clone (the safer superset) and
+   * decoding still routes correctly via the wire prefix.
+   */
+  definitions?: ReadonlyMap<string, Pick<RpcFunctionDefinitionAny, 'jsonSerializable'>>;
+}
+/**
+ * Build a birpc `ChannelOptions` object backed by a browser `WebSocket`.
+ * Pass the result straight to `createRpcClient`'s `channel` option.
+ *
+ * Also returns `close()`, closing the underlying socket, mirroring the server transport's
+ * existing `WsRpcTransport.close()`. `birpc`'s own `ChannelOptions` has no teardown of its own.
+ */
+export declare function createWsRpcChannel(options: WsRpcChannelOptions): ChannelOptions & {
+  close: () => void;
+};

package/dist/rpc/transports/ws-client.mjs

@@ -1,6 +1,6 @@
 import { DEVFRAME_AUTH_TOKEN_QUERY_PARAM } from "../../constants.mjs";
-import { t as createRpcWireCodec } from "../../wire-codec-B1W3zH3L.mjs";
-//#region src/rpc/transports/ws-client.ts
+import { t as createRpcWireCodec } from "../../wire-codec-BdngvzfH.mjs";
+// src/rpc/transports/ws-client.ts
 function NOOP() {}
 const EMPTY_DEFS = /* @__PURE__ */ new Map();
 /**
@@ -60,5 +60,4 @@ function createWsRpcChannel(options) {
 		deserialize: codec.deserialize
 	};
 }
-//#endregion
 export { createWsRpcChannel };

package/dist/rpc/transports/ws-deno.d.mts

@@ -1,6 +1,5 @@
-import { n as WsOriginRegistry } from "../../ws-server-y2R76aSW.mjs";
-import { t as ContextRpcServer } from "../../rpc-core-CGTCla-R.mjs";
-//#region src/rpc/transports/ws-deno.d.ts
+import { t as ContextRpcServer } from "../../rpc-core-CblgPYJ_.mjs";
+import { WsOriginRegistry } from "./ws-server.mjs";
 export interface AttachDenoWsTransportOptions {
   /** Same contract as `WsRpcTransportOptions.allowedOrigins`. */
   allowedOrigins?: readonly string[] | WsOriginRegistry | false;
@@ -21,5 +20,4 @@ export interface DenoWsTier {
  * app's own origin, with no side-car server. Load it dynamically so the Deno
  * adapter never enters a Node-only bundle path.
  */
-export declare function attachDenoWsTransport(core: ContextRpcServer, options?: AttachDenoWsTransportOptions): Promise<DenoWsTier>;
-//#endregion
+export declare function attachDenoWsTransport(core: ContextRpcServer, options?: AttachDenoWsTransportOptions): Promise<DenoWsTier>;

package/dist/rpc/transports/ws-deno.mjs

@@ -1,6 +1,6 @@
-import { t as isAllowedOrigin } from "../../origin-DZit9g29.mjs";
+import { t as isAllowedOrigin } from "../../origin-Ck7mLbKU.mjs";
 import { createWsRpcPeerHooks } from "./ws-server.mjs";
-//#region src/rpc/transports/ws-deno.ts
+// src/rpc/transports/ws-deno.ts
 /**
 * The Deno fetch-upgrade WebSocket tier for `initDevframe` / `initHub`: the
 * same RPC peer wiring as `attachWsRpcTransport`, driven by crossws's Deno
@@ -32,5 +32,4 @@ async function attachDenoWsTransport(core, options = {}) {
 		close: () => ws.close()
 	};
 }
-//#endregion
 export { attachDenoWsTransport };