elysia 2.0.0-beta.21 → 2.0.0-beta.23

package/dist/utils.d.ts

@@ -1,13 +1,23 @@
-import { AnySchema, StandardSchemaV1Like } from "./type/types.js";
 import { Context } from "./context.js";
-import { AnyLocalHook, AppHook, BunHTMLBundlelike, ElysiaFormData, EventFn, EventScope, GuardSchemaType, InputSchema, Macro, MaybeArray, Prettify, SSEPayload } from "./types.js";
+import { AnySchema, StandardSchemaV1Like } from "./type/types.js";
+import { AnyLocalHook, AppHook, BunHTMLBundlelike, ElysiaFormData, EventFn, EventScope, GuardSchemaType, InputSchema, Macro, MacroTypeLambda, MaybeArray, Prettify, SSEPayload } from "./types.js";
 
 //#region src/utils.d.ts
-type DeriveEntry = Function | readonly [Function, 'mapDerive'];
+type DeriveEntry = Function | readonly [Function, 'mapDerive' | 'beforeHandle'];
 declare const nullObject: () => any;
 declare const mapDeriveEntry: (fn: Function) => DeriveEntry;
 declare const deriveEntryFn: (entry: DeriveEntry) => any;
 declare const isMapDeriveEntry: (entry: DeriveEntry) => boolean;
+declare const isPlainDeriveEntry: (entry: DeriveEntry) => boolean;
+/**
+ * `~deriveEntries` for `hooks` whose role per occurrence is `at` (an entry
+ * for a derive, undefined for a plain hook). `deriveModes` gives each
+ * function's entries to its occurrences in order, so a plain occurrence
+ * before a derive of the same function gets a placeholder
+ */
+declare function occurrenceDeriveEntries(hooks: readonly Function[], at: readonly (DeriveEntry | undefined)[]): DeriveEntry[];
+/** Each function's derive entries, in occurrence order */
+declare const deriveQueues: (entries: readonly DeriveEntry[] | undefined) => Map<any, DeriveEntry[]> | undefined;
 declare function isEmpty<T extends Object>(obj: T): boolean;
 declare const isNotEmpty: <T extends Object>(obj?: T) => boolean | undefined;
 /**
@@ -20,20 +30,20 @@ declare const isNotEmpty: <T extends Object>(obj?: T) => boolean | undefined;
  */
 declare function evictOldestHalf(cache: Map<any, any>): void;
 declare function fnv1a(str: string): number;
+/**
+ * 48-bit hash of a named plugin's key (fnv1a + 16 bits of a second hash): at
+ * 32 bits two plugins collide by ~77k and the second is dropped. 48 keeps
+ * `origin * 16 + slot` exact
+ */
+declare function pluginHash(str: string): number;
 declare const compositionKeys: readonly string[];
 declare function refTargets(roots: unknown[], models?: Record<string, unknown>): (name: string) => Iterable<unknown>;
+declare const macroOrigin: WeakMap<object | Function, number>;
 /**
- * Maps each lifecycle/derive function to the hash of the named plugin it was
- * first registered on. Used by `.use()` to dedup absorbed hooks: if a fn's
- * origin is already in `parent.#apps`, the parent has already absorbed that
- * named plugin via another path and should skip re-adding the fn.
- *
- * Anonymous plugins (no name) don't tag their fns - there's no hash to dedup
- * by, so their fns always propagate.
+ * Id of an unnamed plugin in `childrenHash`, negative so it never collides
+ * with a named plugin's unsigned hash
  */
-declare const fnOrigin: WeakMap<Function, number>;
-declare const macroOrigin: WeakMap<object | Function, number>;
-declare const isLocalScope: (s: EventScope | undefined) => s is "local" | undefined;
+declare const pluginId: (plugin: object) => number;
 /**
  * Linked-list representation of the scope/global hook chain of a route
  *
@@ -51,10 +61,9 @@ declare const isLocalScope: (s: EventScope | undefined) => s is "local" | undefi
  * without flattening - `over` is walked first (older / outer context),
  * then `combine` (newer / inner context)
  *
- * `tail` is the child's own chain head at that `.use()`. Its local hooks
- * registered after the child absorbed the route run after the route's own
- * hooks, as they would with the child as the root (`afterUseHooks` in
- * `compile/handler`)
+ * `callback` is the chain of a `.group()`/`.guard()` callback the route came
+ * out of: its error hooks cover every route the callback produced. Flattening
+ * never reads it
  *
  * Use with {@link flattenChain} to walk tail-first and reconstruct
  * flat `Partial<AppHook>` at compile time
@@ -66,18 +75,15 @@ type ChainNode = {
   scope?: EventScope;
   propagated?: boolean;
   owner?: object;
+  origin?: number;
+  registration?: ChainNode;
 } | {
   combine: ChainNode | undefined;
   over: ChainNode | undefined;
-  tail?: ChainNode;
+  callback?: ChainNode;
+  inner?: ChainNode;
   refs: boolean;
 };
-/**
- * The absorbing instance's chain as it stood at `.use()`: the `over` of a
- * combine node, or the node itself. A combine node is never on an instance's
- * own chain, so it can't serve as a `stopAt` directly
- */
-declare const rootSnapshot: (node: ChainNode | undefined) => ChainNode | undefined;
 interface CompactBeforeHandleChunk {
   parent?: CompactBeforeHandleChunk;
   values: readonly Function[];
@@ -91,19 +97,30 @@ interface CompactBeforeHandlePrefix {
 declare const isCompactBeforeHandleOnly: (hook: Partial<AppHook> | undefined) => boolean;
 declare function compactBeforeHandleConflicts(hook: Partial<AppHook> | undefined): boolean;
 declare function compactBeforeHandlePrefix(start: ChainNode | undefined): CompactBeforeHandlePrefix | undefined;
+interface ChainInfo {
+  installs?: ReadonlySet<number>;
+  named?: true;
+}
 /**
  * Walk the chain tail-first into a fresh `Partial<AppHook>`
  *
+ * Each instance chain a combine node links is one layer, outermost first.
+ * A named plugin's hook is skipped when an outer layer, or `skip`, already
+ * installed that plugin's same lifecycle event: it runs once, at its
+ * outermost position. Within a layer every registration stays
+ *
  * Explicit-stack walk (no recursion) so it works uniformly for linear
  * chains and combine nodes without risking stack overflow on deep chains
  */
-declare function flattenChain(start: ChainNode | undefined, keep?: (s: EventScope | undefined) => boolean, stopAt?: ChainNode, resolveAdded?: (node: ChainNode) => Partial<AppHook> | undefined): Partial<AppHook> | undefined;
+declare function flattenChain(start: ChainNode | undefined, resolveAdded?: (node: ChainNode) => Partial<AppHook> | undefined, skip?: ReadonlySet<number>, info?: ChainInfo): Partial<AppHook> | undefined;
 declare const macroEpoch: () => number;
 declare const invalidateMacroEpoch: () => void;
 /** Drop this root's flattened-chain memo. Recomputable on next compile. */
 declare function clearFlattenChainMemo(root: object): void;
-declare function flattenChainMemoReadonly(root: object, start: ChainNode | undefined, resolveAdded?: (node: ChainNode) => Partial<AppHook> | undefined): Partial<AppHook> | undefined;
-declare function flattenChainMemo(root: object, start: ChainNode | undefined, resolveAdded?: (node: ChainNode) => Partial<AppHook> | undefined): Partial<AppHook> | undefined;
+/** What the chain installs, see {@link flattenChain} */
+declare function flattenChainInfo(root: object, start: ChainNode | undefined, resolveAdded?: (node: ChainNode) => Partial<AppHook> | undefined): ChainInfo | undefined;
+declare function flattenChainMemoReadonly(root: object, start: ChainNode | undefined, resolveAdded?: (node: ChainNode) => Partial<AppHook> | undefined, skip?: ReadonlySet<number>): Partial<AppHook> | undefined;
+declare function flattenChainMemo(root: object, start: ChainNode | undefined, resolveAdded?: (node: ChainNode) => Partial<AppHook> | undefined, skip?: ReadonlySet<number>): Partial<AppHook> | undefined;
 /**
  *
  * @param url URL to redirect to
@@ -130,6 +147,7 @@ declare function formToFormData(value: Record<keyof any, unknown>): FormData;
  * ```
  */
 declare const form: <const T extends Record<keyof any, unknown>>(value: T) => ElysiaFormData<T>;
+declare const macroType: <L extends MacroTypeLambda>() => L | undefined;
 declare const assignOwn: <T extends object>(target: T, source: any) => T;
 declare const getLoosePath: (path: string) => string;
 /**
@@ -171,7 +189,7 @@ declare function hookToGuard(a: Partial<AppHook & Macro> & {
   schema?: GuardSchemaType;
 }): Partial<AppHook & Macro>;
 declare function coalesceSchemas(existing: any[], incoming: any[]): void;
-declare function mergeHook(a: Partial<AppHook>, b: Partial<AppHook> | undefined, reverse?: boolean, dedup?: boolean): Partial<AppHook>;
+declare function mergeHook(a: Partial<AppHook>, b: Partial<AppHook> | undefined): Partial<AppHook>;
 declare const createErrorEventHandler: (fn: EventFn<"error">, error: Error) => (context: Context) => unknown;
 declare function mergeDeep<A extends Record<string, any>, B extends Record<string, any>>(target: A, source: B, skipKeys?: string[], override?: boolean, mergeArray?: boolean, seen?: WeakSet<object>, cloneAdopt?: {
   map?: WeakMap<object, any>;
@@ -181,7 +199,6 @@ declare function cloneHook<T extends Partial<AnyLocalHook> | Partial<AppHook>>(s
 declare function clonePlainDeep<T>(value: T, seen?: WeakMap<object, any>): T;
 declare function guardNonPlainLeaves(target: Record<string, unknown>, source: Record<string, unknown>): void;
 declare function joinPath(base: string, path: string): string;
-declare function pushField<K extends keyof any>(target: Record<K, unknown>, key: K, item: unknown): void;
 declare const requestId: typeof Bun.randomUUIDv7 | (() => `${string}-${string}-${string}-${string}-${string}`);
 /**
  * Offset of the first byte after `://`, so the authority is never scanned as
@@ -200,7 +217,8 @@ declare function serializeMacroSeed(_key: string, value: unknown): unknown;
 declare const throwLifecycleErrors: (errors: unknown[]) => void;
 declare const isDisposable: (value: any) => boolean;
 declare const isSingleton: (value: object) => boolean;
-declare const markSingletons: (value: unknown, depth?: number, seen?: Set<object>) => void;
+declare const markSingletons: (value: unknown, depth?: number) => void;
+declare const markPropertySingletons: (object: object) => void;
 declare const isSocketQuiet: (socket: {
   readyState: number;
   data: {
@@ -211,4 +229,4 @@ declare const isSocketQuiet: (socket: {
 }) => boolean;
 declare const isHTMLBundle: (value: unknown) => value is BunHTMLBundlelike;
 //#endregion
-export { ChainNode, CompactBeforeHandleChunk, CompactBeforeHandlePrefix, DeriveEntry, ELYSIA_FORM_PROTOTYPE, assignOwn, authorityEnd, bytes, clearFlattenChainMemo, cloneHook, clonePlainDecorators, clonePlainDeep, coalesceSchemas, compactBeforeHandleConflicts, compactBeforeHandlePrefix, compositionKeys, constantTimeEqual, createErrorEventHandler, deriveEntryFn, eventProperties, evictOldestHalf, flattenChain, flattenChainMemo, flattenChainMemoReadonly, fnOrigin, fnv1a, form, formToFormData, getLoosePath, guardNonPlainLeaves, hookToGuard, invalidateMacroEpoch, isBlob, isByteStream, isCompactBeforeHandleOnly, isDisposable, isElysiaForm, isEmpty, isHTMLBundle, isLocalScope, isMapDeriveEntry, isNotEmpty, isPlainObject, isRecordNumber, isSingleton, isSocketQuiet, joinPath, macroEpoch, macroOrigin, mapDeriveEntry, markSingletons, mergeArray, mergeDeep, mergeHook, mergeResponse, nullObject, prefix, pushField, redirect, refTargets, replaceUrlPath, requestId, rootSnapshot, schemaProperties, serializeMacroSeed, sse, sseData, throwLifecycleErrors };
+export { ChainInfo, ChainNode, CompactBeforeHandleChunk, CompactBeforeHandlePrefix, DeriveEntry, ELYSIA_FORM_PROTOTYPE, assignOwn, authorityEnd, bytes, clearFlattenChainMemo, cloneHook, clonePlainDecorators, clonePlainDeep, coalesceSchemas, compactBeforeHandleConflicts, compactBeforeHandlePrefix, compositionKeys, constantTimeEqual, createErrorEventHandler, deriveEntryFn, deriveQueues, eventProperties, evictOldestHalf, flattenChain, flattenChainInfo, flattenChainMemo, flattenChainMemoReadonly, fnv1a, form, formToFormData, getLoosePath, guardNonPlainLeaves, hookToGuard, invalidateMacroEpoch, isBlob, isByteStream, isCompactBeforeHandleOnly, isDisposable, isElysiaForm, isEmpty, isHTMLBundle, isMapDeriveEntry, isNotEmpty, isPlainDeriveEntry, isPlainObject, isRecordNumber, isSingleton, isSocketQuiet, joinPath, macroEpoch, macroOrigin, macroType, mapDeriveEntry, markPropertySingletons, markSingletons, mergeArray, mergeDeep, mergeHook, mergeResponse, nullObject, occurrenceDeriveEntries, pluginHash, pluginId, prefix, redirect, refTargets, replaceUrlPath, requestId, schemaProperties, serializeMacroSeed, sse, sseData, throwLifecycleErrors };