devframe 0.2.2 → 0.3.0

package/dist/index-C5PmWqBf.d.mts

@@ -0,0 +1,79 @@
+import { _ as RpcFunctionDefinitionAny, c as RpcDumpClientOptions, l as RpcDumpCollectionOptions, m as RpcDumpStore, n as BirpcReturn, o as RpcDefinitionsToFunctions, p as RpcDumpRecordError } from "./types-BXL7EIDM.mjs";
+
+//#region src/rpc/dump/static.d.ts
+type StaticRpcDumpSerialization = 'json' | 'structured-clone';
+interface StaticRpcDumpManifestStaticEntry {
+  type: 'static';
+  path: string;
+  /** Encoder used when this entry's file was written. Default: `'json'`. */
+  serialization?: StaticRpcDumpSerialization;
+}
+interface StaticRpcDumpManifestQueryEntry {
+  type: 'query';
+  records: Record<string, string>;
+  fallback?: string;
+  /** Encoder used when each record/fallback file was written. Default: `'json'`. */
+  serialization?: StaticRpcDumpSerialization;
+}
+type StaticRpcDumpManifestValue = StaticRpcDumpManifestStaticEntry | StaticRpcDumpManifestQueryEntry | any;
+type StaticRpcDumpManifest = Record<string, StaticRpcDumpManifestValue>;
+interface StaticRpcDumpFile {
+  /** Whether this file was written via `JSON.stringify` or `structured-clone-es.stringify`. */
+  serialization: StaticRpcDumpSerialization;
+  /** Function name the file belongs to — used to scope `DF0019` errors during write. */
+  fnName: string;
+  /** Payload to encode. */
+  data: unknown;
+}
+interface StaticRpcDumpCollection {
+  manifest: StaticRpcDumpManifest;
+  files: Record<string, StaticRpcDumpFile>;
+}
+declare function collectStaticRpcDump(definitions: Iterable<RpcFunctionDefinitionAny>, context: any): Promise<StaticRpcDumpCollection>;
+//#endregion
+//#region src/rpc/dump/collect.d.ts
+/**
+ * Collects pre-computed dumps by executing functions with their defined input combinations.
+ * Static functions without dump config automatically get `{ inputs: [[]] }`.
+ *
+ * @example
+ * ```ts
+ * const store = await dumpFunctions([greet], context, { concurrency: 10 })
+ * ```
+ */
+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.
+ * Uses argument hashing to match calls to stored records.
+ *
+ * @example
+ * ```ts
+ * const client = createClientFromDump(store)
+ * await client.greet('Alice')
+ * ```
+ */
+declare function createClientFromDump<T extends Record<string, any>>(store: RpcDumpStore<T>, options?: RpcDumpClientOptions): BirpcReturn<T>;
+/**
+ * Filters function definitions to only those with dump definitions.
+ * Note: Only checks the definition itself, not setup results.
+ */
+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
+ * enumerable properties of an `Error` so consumers reading the dump can
+ * reconstruct a richer Error than just `{ message, name }`.
+ *
+ * Non-`Error` throws are wrapped as `{ name: 'Error', message: String(thrown) }`.
+ */
+declare function serializeDumpError(error: unknown): RpcDumpRecordError;
+/**
+ * Inverse of {@link serializeDumpError}: rebuild a thrown `Error` from
+ * the plain object stored in a dump record. Preserves `cause`, restores
+ * the original `name`, and re-attaches any custom own properties.
+ */
+declare function reviveDumpError(stored: RpcDumpRecordError): Error;
+//#endregion
+export { getDefinitionsWithDumps as a, StaticRpcDumpManifest as c, StaticRpcDumpManifestValue as d, StaticRpcDumpSerialization as f, dumpFunctions as i, StaticRpcDumpManifestQueryEntry as l, serializeDumpError as n, StaticRpcDumpCollection as o, collectStaticRpcDump as p, createClientFromDump as r, StaticRpcDumpFile as s, reviveDumpError as t, StaticRpcDumpManifestStaticEntry as u };

package/dist/{index-BNAsgVNz.d.mts → index-CTK6fuXs.d.mts}

@@ -1,4 +1,5 @@
-import { C as RpcFunctionsCollector, S as RpcFunctionType, _ as RpcFunctionDefinitionAny, c as RpcDumpClientOptions, g as RpcFunctionDefinition, i as RpcArgsSchema, l as RpcDumpCollectionOptions, m as RpcDumpStore, n as BirpcReturn, o as RpcDefinitionsToFunctions, p as RpcDumpRecordError, w as RpcReturnSchema, x as RpcFunctionSetupResult } from "./types-DmcujDa5.mjs";
+import { C as RpcFunctionsCollector, S as RpcFunctionType, _ as RpcFunctionDefinitionAny, g as RpcFunctionDefinition, i as RpcArgsSchema, w as RpcReturnSchema, x as RpcFunctionSetupResult } from "./types-BXL7EIDM.mjs";
+import { a as getDefinitionsWithDumps$1, c as StaticRpcDumpManifest$1, d as StaticRpcDumpManifestValue$1, f as StaticRpcDumpSerialization$1, i as dumpFunctions$1, l as StaticRpcDumpManifestQueryEntry$1, n as serializeDumpError$1, o as StaticRpcDumpCollection$1, p as collectStaticRpcDump$1, r as createClientFromDump$1, s as StaticRpcDumpFile$1, t as reviveDumpError$1, u as StaticRpcDumpManifestStaticEntry$1 } from "./index-C5PmWqBf.mjs";
 
 //#region src/rpc/cache.d.ts
 interface RpcCacheOptions {
@@ -47,82 +48,6 @@ declare class RpcFunctionsCollectorBase<LocalFunctions extends Record<string, an
 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>;
 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>;
 //#endregion
-//#region src/rpc/dump/index.d.ts
-/**
- * Collects pre-computed dumps by executing functions with their defined input combinations.
- * Static functions without dump config automatically get `{ inputs: [[]] }`.
- *
- * @example
- * ```ts
- * const store = await dumpFunctions([greet], context, { concurrency: 10 })
- * ```
- */
-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.
- * Uses argument hashing to match calls to stored records.
- *
- * @example
- * ```ts
- * const client = createClientFromDump(store)
- * await client.greet('Alice')
- * ```
- */
-declare function createClientFromDump<T extends Record<string, any>>(store: RpcDumpStore<T>, options?: RpcDumpClientOptions): BirpcReturn<T>;
-/**
- * Filters function definitions to only those with dump definitions.
- * Note: Only checks the definition itself, not setup results.
- */
-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
- * enumerable properties of an `Error` so consumers reading the dump can
- * reconstruct a richer Error than just `{ message, name }`.
- *
- * Non-`Error` throws are wrapped as `{ name: 'Error', message: String(thrown) }`.
- */
-declare function serializeDumpError(error: unknown): RpcDumpRecordError;
-/**
- * Inverse of {@link serializeDumpError}: rebuild a thrown `Error` from
- * the plain object stored in a dump record. Preserves `cause`, restores
- * the original `name`, and re-attaches any custom own properties.
- */
-declare function reviveDumpError(stored: RpcDumpRecordError): Error;
-//#endregion
-//#region src/rpc/dump/static.d.ts
-type StaticRpcDumpSerialization = 'json' | 'structured-clone';
-interface StaticRpcDumpManifestStaticEntry {
-  type: 'static';
-  path: string;
-  /** Encoder used when this entry's file was written. Default: `'json'`. */
-  serialization?: StaticRpcDumpSerialization;
-}
-interface StaticRpcDumpManifestQueryEntry {
-  type: 'query';
-  records: Record<string, string>;
-  fallback?: string;
-  /** Encoder used when each record/fallback file was written. Default: `'json'`. */
-  serialization?: StaticRpcDumpSerialization;
-}
-type StaticRpcDumpManifestValue = StaticRpcDumpManifestStaticEntry | StaticRpcDumpManifestQueryEntry | any;
-type StaticRpcDumpManifest = Record<string, StaticRpcDumpManifestValue>;
-interface StaticRpcDumpFile {
-  /** Whether this file was written via `JSON.stringify` or `structured-clone-es.stringify`. */
-  serialization: StaticRpcDumpSerialization;
-  /** Function name the file belongs to — used to scope `DF0019` errors during write. */
-  fnName: string;
-  /** Payload to encode. */
-  data: unknown;
-}
-interface StaticRpcDumpCollection {
-  manifest: StaticRpcDumpManifest;
-  files: Record<string, StaticRpcDumpFile>;
-}
-declare function collectStaticRpcDump(definitions: Iterable<RpcFunctionDefinitionAny>, context: any): Promise<StaticRpcDumpCollection>;
-//#endregion
 //#region src/rpc/handler.d.ts
 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>>;
 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>;
@@ -184,4 +109,32 @@ declare function validateDefinitions(definitions: readonly RpcFunctionDefinition
  */
 declare function validateDefinition(definition: RpcFunctionDefinitionAny): void;
 //#endregion
-export { RpcCacheManager as C, RpcFunctionsCollectorBase as S, createClientFromDump as _, getRpcHandler as a, createDefineWrapperWithContext as b, StaticRpcDumpFile as c, StaticRpcDumpManifestStaticEntry as d, StaticRpcDumpManifestValue as f, serializeDumpError as g, reviveDumpError as h, strictJsonStringify as i, StaticRpcDumpManifest as l, collectStaticRpcDump as m, validateDefinitions as n, getRpcResolvedSetupResult as o, StaticRpcDumpSerialization as p, STRUCTURED_CLONE_PREFIX as r, StaticRpcDumpCollection as s, validateDefinition as t, StaticRpcDumpManifestQueryEntry as u, dumpFunctions as v, RpcCacheOptions as w, defineRpcFunction as x, getDefinitionsWithDumps as y };
+//#region src/rpc/index.d.ts
+/** @deprecated Import from `devframe/rpc/dump` instead. */
+declare const collectStaticRpcDump: typeof collectStaticRpcDump$1;
+/** @deprecated Import from `devframe/rpc/dump` instead. */
+declare const createClientFromDump: typeof createClientFromDump$1;
+/** @deprecated Import from `devframe/rpc/dump` instead. */
+declare const dumpFunctions: typeof dumpFunctions$1;
+/** @deprecated Import from `devframe/rpc/dump` instead. */
+declare const getDefinitionsWithDumps: typeof getDefinitionsWithDumps$1;
+/** @deprecated Import from `devframe/rpc/dump` instead. */
+declare const reviveDumpError: typeof reviveDumpError$1;
+/** @deprecated Import from `devframe/rpc/dump` instead. */
+declare const serializeDumpError: typeof serializeDumpError$1;
+/** @deprecated Import from `devframe/rpc/dump` instead. */
+type StaticRpcDumpCollection = StaticRpcDumpCollection$1;
+/** @deprecated Import from `devframe/rpc/dump` instead. */
+type StaticRpcDumpFile = StaticRpcDumpFile$1;
+/** @deprecated Import from `devframe/rpc/dump` instead. */
+type StaticRpcDumpManifest = StaticRpcDumpManifest$1;
+/** @deprecated Import from `devframe/rpc/dump` instead. */
+type StaticRpcDumpManifestQueryEntry = StaticRpcDumpManifestQueryEntry$1;
+/** @deprecated Import from `devframe/rpc/dump` instead. */
+type StaticRpcDumpManifestStaticEntry = StaticRpcDumpManifestStaticEntry$1;
+/** @deprecated Import from `devframe/rpc/dump` instead. */
+type StaticRpcDumpManifestValue = StaticRpcDumpManifestValue$1;
+/** @deprecated Import from `devframe/rpc/dump` instead. */
+type StaticRpcDumpSerialization = StaticRpcDumpSerialization$1;
+//#endregion
+export { RpcCacheManager as C, RpcFunctionsCollectorBase as S, strictJsonStringify as _, StaticRpcDumpManifestStaticEntry as a, createDefineWrapperWithContext as b, collectStaticRpcDump as c, getDefinitionsWithDumps as d, reviveDumpError as f, STRUCTURED_CLONE_PREFIX as g, validateDefinitions as h, StaticRpcDumpManifestQueryEntry as i, createClientFromDump as l, validateDefinition as m, StaticRpcDumpFile as n, StaticRpcDumpManifestValue as o, serializeDumpError as p, StaticRpcDumpManifest as r, StaticRpcDumpSerialization as s, StaticRpcDumpCollection as t, dumpFunctions as u, getRpcHandler as v, RpcCacheOptions as w, defineRpcFunction as x, getRpcResolvedSetupResult as y };