@zudojs/core 0.0.1

package/dist/context/provider/contextProvider.provider.d.ts

@@ -0,0 +1,61 @@
+import type { ExecutionContext } from "../core/executionContext.context.js";
+import { ContextStorage } from "../provider/contextStorage.storage.js";
+/**
+ * Provides access to the current execution context.
+ *
+ * ContextProvider intentionally hides the underlying storage
+ * mechanism from the rest of the framework.
+ */
+export interface ContextProvider {
+    /**
+     * Returns the current execution context.
+     *
+     * Returns undefined when no context is active.
+     */
+    get(): ExecutionContext | undefined;
+    /**
+     * Returns the current execution context.
+     *
+     * Throws when no context is active.
+     */
+    require(): ExecutionContext;
+    /**
+     * Determines whether an execution context is active.
+     */
+    has(): boolean;
+    /**
+     * Executes a callback within the supplied context.
+     */
+    run<T>(context: ExecutionContext, callback: () => T): T;
+}
+/**
+ * Default ContextProvider implementation.
+ *
+ * Uses ContextStorage internally while keeping that
+ * implementation detail hidden behind the provider contract.
+ */
+export declare class DefaultContextProvider implements ContextProvider {
+    private readonly storage;
+    constructor(storage?: ContextStorage);
+    /**
+     * Returns the current execution context.
+     */
+    get(): ExecutionContext | undefined;
+    /**
+     * Returns the current execution context or throws.
+     */
+    require(): ExecutionContext;
+    /**
+     * Checks whether a context is active.
+     */
+    has(): boolean;
+    /**
+     * Runs a callback within an execution context.
+     */
+    run<T>(context: ExecutionContext, callback: () => T): T;
+}
+/**
+ * Creates the default framework context provider.
+ */
+export declare function createContextProvider(): ContextProvider;
+//# sourceMappingURL=contextProvider.provider.d.ts.map

package/dist/context/provider/contextProvider.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextProvider.provider.d.ts","sourceRoot":"","sources":["../../../src/context/provider/contextProvider.provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,GAAG,IAAI,gBAAgB,GAAG,SAAS,CAAC;IAEpC;;;;OAIG;IACH,OAAO,IAAI,gBAAgB,CAAC;IAE5B;;OAEG;IACH,GAAG,IAAI,OAAO,CAAC;IAEf;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;CACzD;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IAEzC,YAAmB,OAAO,GAAE,cAAqC,EAEhE;IAED;;OAEG;IACI,GAAG,IAAI,gBAAgB,GAAG,SAAS,CAEzC;IAED;;OAEG;IACI,OAAO,IAAI,gBAAgB,CAEjC;IAED;;OAEG;IACI,GAAG,IAAI,OAAO,CAEpB;IAED;;OAEG;IACI,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAE7D;CACF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD"}

package/dist/context/provider/contextProvider.provider.js

@@ -0,0 +1,44 @@
+import { ContextStorage } from "../provider/contextStorage.storage.js";
+/**
+ * Default ContextProvider implementation.
+ *
+ * Uses ContextStorage internally while keeping that
+ * implementation detail hidden behind the provider contract.
+ */
+export class DefaultContextProvider {
+    storage;
+    constructor(storage = new ContextStorage()) {
+        this.storage = storage;
+    }
+    /**
+     * Returns the current execution context.
+     */
+    get() {
+        return this.storage.get();
+    }
+    /**
+     * Returns the current execution context or throws.
+     */
+    require() {
+        return this.storage.require();
+    }
+    /**
+     * Checks whether a context is active.
+     */
+    has() {
+        return this.storage.has();
+    }
+    /**
+     * Runs a callback within an execution context.
+     */
+    run(context, callback) {
+        return this.storage.run(context, callback);
+    }
+}
+/**
+ * Creates the default framework context provider.
+ */
+export function createContextProvider() {
+    return new DefaultContextProvider();
+}
+//# sourceMappingURL=contextProvider.provider.js.map

package/dist/context/provider/contextProvider.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextProvider.provider.js","sourceRoot":"","sources":["../../../src/context/provider/contextProvider.provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAkCvE;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IAChB,OAAO,CAAiB;IAEzC,YAAmB,OAAO,GAAmB,IAAI,cAAc,EAAE;QAC/D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,GAAG;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,OAAO;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACI,GAAG;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,GAAG,CAAI,OAAyB,EAAE,QAAiB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,sBAAsB,EAAE,CAAC;AACtC,CAAC"}

package/dist/context/provider/contextStorage.storage.d.ts

@@ -0,0 +1,54 @@
+import type { ExecutionContext } from "../core/executionContext.context.js";
+/**
+ * Stores the current ExecutionContext across asynchronous
+ * boundaries.
+ *
+ * This allows framework components to access the current
+ * execution without explicitly passing the context through
+ * every function call.
+ */
+export declare class ContextStorage {
+    private readonly storage;
+    /**
+     * Runs a function inside an execution context.
+     *
+     * The context is automatically available to all asynchronous
+     * operations created within the callback.
+     */
+    run<T>(context: ExecutionContext, callback: () => T): T;
+    /**
+     * Returns the current execution context.
+     *
+     * Returns undefined when called outside a managed execution.
+     */
+    get(): ExecutionContext | undefined;
+    /**
+     * Returns the current execution context.
+     *
+     * Throws when no execution context is available.
+     */
+    require(): ExecutionContext;
+    /**
+     * Checks whether an execution context is currently available.
+     */
+    has(): boolean;
+    /**
+     * Executes a callback with a derived execution context.
+     */
+    runWith<T>(context: ExecutionContext, callback: () => T): T;
+    /**
+     * Executes a callback using the current context with
+     * a temporary derived context.
+     */
+    runDerived<T>(context: ExecutionContext, callback: () => T): T;
+    /**
+     * Clears the current execution context by executing the
+     * callback outside the current storage context.
+     */
+    runWithoutContext<T>(callback: () => T): T;
+}
+/**
+ * Creates a ContextStorage instance.
+ */
+export declare function createContextStorage(): ContextStorage;
+//# sourceMappingURL=contextStorage.storage.d.ts.map

package/dist/context/provider/contextStorage.storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextStorage.storage.d.ts","sourceRoot":"","sources":["../../../src/context/provider/contextStorage.storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAE5E;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IAErE;;;;;OAKG;IACI,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAE7D;IAED;;;;OAIG;IACI,GAAG,IAAI,gBAAgB,GAAG,SAAS,CAEzC;IAED;;;;OAIG;IACI,OAAO,IAAI,gBAAgB,CAQjC;IAED;;OAEG;IACI,GAAG,IAAI,OAAO,CAEpB;IAED;;OAEG;IACI,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAEjE;IAED;;;OAGG;IACI,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAEpE;IAED;;;OAGG;IACI,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAEhD;CACF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

package/dist/context/provider/contextStorage.storage.js

@@ -0,0 +1,74 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+/**
+ * Stores the current ExecutionContext across asynchronous
+ * boundaries.
+ *
+ * This allows framework components to access the current
+ * execution without explicitly passing the context through
+ * every function call.
+ */
+export class ContextStorage {
+    storage = new AsyncLocalStorage();
+    /**
+     * Runs a function inside an execution context.
+     *
+     * The context is automatically available to all asynchronous
+     * operations created within the callback.
+     */
+    run(context, callback) {
+        return this.storage.run(context, callback);
+    }
+    /**
+     * Returns the current execution context.
+     *
+     * Returns undefined when called outside a managed execution.
+     */
+    get() {
+        return this.storage.getStore();
+    }
+    /**
+     * Returns the current execution context.
+     *
+     * Throws when no execution context is available.
+     */
+    require() {
+        const context = this.get();
+        if (!context) {
+            throw new Error("No execution context is available.");
+        }
+        return context;
+    }
+    /**
+     * Checks whether an execution context is currently available.
+     */
+    has() {
+        return this.get() !== undefined;
+    }
+    /**
+     * Executes a callback with a derived execution context.
+     */
+    runWith(context, callback) {
+        return this.run(context, callback);
+    }
+    /**
+     * Executes a callback using the current context with
+     * a temporary derived context.
+     */
+    runDerived(context, callback) {
+        return this.storage.run(context, callback);
+    }
+    /**
+     * Clears the current execution context by executing the
+     * callback outside the current storage context.
+     */
+    runWithoutContext(callback) {
+        return this.storage.exit(callback);
+    }
+}
+/**
+ * Creates a ContextStorage instance.
+ */
+export function createContextStorage() {
+    return new ContextStorage();
+}
+//# sourceMappingURL=contextStorage.storage.js.map

package/dist/context/provider/contextStorage.storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextStorage.storage.js","sourceRoot":"","sources":["../../../src/context/provider/contextStorage.storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAIrD;;;;;;;GAOG;AACH,MAAM,OAAO,cAAc;IACR,OAAO,GAAG,IAAI,iBAAiB,EAAoB,CAAC;IAErE;;;;;OAKG;IACI,GAAG,CAAI,OAAyB,EAAE,QAAiB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACI,GAAG;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACI,OAAO;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE3B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACI,GAAG;QACR,OAAO,IAAI,CAAC,GAAG,EAAE,KAAK,SAAS,CAAC;IAClC,CAAC;IAED;;OAEG;IACI,OAAO,CAAI,OAAyB,EAAE,QAAiB;QAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACI,UAAU,CAAI,OAAyB,EAAE,QAAiB;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACI,iBAAiB,CAAI,QAAiB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,cAAc,EAAE,CAAC;AAC9B,CAAC"}

package/dist/context/provider/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/core/context/provider
+ *
+ * Async context storage and provider.
+ */
+export { ContextStorage, createContextStorage, } from "./contextStorage.storage.js";
+export { DefaultContextProvider, createContextProvider, type ContextProvider, } from "./contextProvider.provider.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/context/provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/provider/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,+BAA+B,CAAC"}

package/dist/context/provider/index.js

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/core/context/provider
+ *
+ * Async context storage and provider.
+ */
+export { ContextStorage, createContextStorage, } from "./contextStorage.storage.js";
+export { DefaultContextProvider, createContextProvider, } from "./contextProvider.provider.js";
+//# sourceMappingURL=index.js.map

package/dist/context/provider/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/context/provider/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GAEtB,MAAM,+BAA+B,CAAC"}

package/dist/context/snapshot/contextSnapshot.snapshot.d.ts

@@ -0,0 +1,48 @@
+import type { ExecutionContext } from "../core/executionContext.context.js";
+import { ContextValues } from "../values/contextValues.values.js";
+/**
+ * Immutable snapshot of an execution context.
+ *
+ * A snapshot captures both:
+ *
+ * 1. The execution metadata
+ * 2. The typed context values
+ *
+ * This allows the context to be restored later, for example
+ * when processing a background job or an asynchronous task.
+ */
+export interface ContextSnapshot {
+    /**
+     * Execution context captured at snapshot time.
+     */
+    readonly context: ExecutionContext;
+    /**
+     * Typed context values captured at snapshot time.
+     */
+    readonly values: ContextValues;
+    /**
+     * Time at which the snapshot was created.
+     */
+    readonly capturedAt: Date;
+}
+/**
+ * Creates a snapshot from an execution context.
+ */
+export declare function createContextSnapshot(context: ExecutionContext, values?: ContextValues): ContextSnapshot;
+/**
+ * Restores an execution context from a snapshot.
+ *
+ * The returned objects are references to the immutable
+ * snapshot state, so no mutable state is shared accidentally.
+ */
+export declare function restoreContextSnapshot(snapshot: ContextSnapshot): {
+    readonly context: ExecutionContext;
+    readonly values: ContextValues;
+};
+/**
+ * Creates a new snapshot derived from an existing snapshot.
+ *
+ * The original snapshot remains unchanged.
+ */
+export declare function deriveContextSnapshot(snapshot: ContextSnapshot, context: ExecutionContext, values?: ContextValues): ContextSnapshot;
+//# sourceMappingURL=contextSnapshot.snapshot.d.ts.map

package/dist/context/snapshot/contextSnapshot.snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextSnapshot.snapshot.d.ts","sourceRoot":"","sources":["../../../src/context/snapshot/contextSnapshot.snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAGlE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,EACzB,MAAM,GAAE,aAAqC,GAC5C,eAAe,CAMjB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,eAAe,GAAG;IACjE,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC,CAKA;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,aAAa,GACrB,eAAe,CAKjB"}

package/dist/context/snapshot/contextSnapshot.snapshot.js

@@ -0,0 +1,33 @@
+import { ContextValues } from "../values/contextValues.values.js";
+import { createContextValues } from "../values/contextValues.values.js";
+/**
+ * Creates a snapshot from an execution context.
+ */
+export function createContextSnapshot(context, values = createContextValues()) {
+    return Object.freeze({
+        context,
+        values,
+        capturedAt: new Date(),
+    });
+}
+/**
+ * Restores an execution context from a snapshot.
+ *
+ * The returned objects are references to the immutable
+ * snapshot state, so no mutable state is shared accidentally.
+ */
+export function restoreContextSnapshot(snapshot) {
+    return {
+        context: snapshot.context,
+        values: new ContextValues(snapshot.values.toStore()),
+    };
+}
+/**
+ * Creates a new snapshot derived from an existing snapshot.
+ *
+ * The original snapshot remains unchanged.
+ */
+export function deriveContextSnapshot(snapshot, context, values) {
+    return createContextSnapshot(context, values ?? new ContextValues(snapshot.values.toStore()));
+}
+//# sourceMappingURL=contextSnapshot.snapshot.js.map

package/dist/context/snapshot/contextSnapshot.snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextSnapshot.snapshot.js","sourceRoot":"","sources":["../../../src/context/snapshot/contextSnapshot.snapshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AA8BxE;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAyB,EACzB,MAAM,GAAkB,mBAAmB,EAAE;IAE7C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO;QACP,MAAM;QACN,UAAU,EAAE,IAAI,IAAI,EAAE;KACvB,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAyB;IAI9D,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,MAAM,EAAE,IAAI,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;KACrD,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAyB,EACzB,OAAyB,EACzB,MAAsB;IAEtB,OAAO,qBAAqB,CAC1B,OAAO,EACP,MAAM,IAAI,IAAI,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CACvD,CAAC;AACJ,CAAC"}

package/dist/context/snapshot/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/core/context/snapshot
+ *
+ * Context snapshots for propagation across
+ * asynchronous and distributed boundaries.
+ */
+export { createContextSnapshot, restoreContextSnapshot, deriveContextSnapshot, type ContextSnapshot, } from "./contextSnapshot.snapshot.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/context/snapshot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/snapshot/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,+BAA+B,CAAC"}

package/dist/context/snapshot/index.js

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/core/context/snapshot
+ *
+ * Context snapshots for propagation across
+ * asynchronous and distributed boundaries.
+ */
+export { createContextSnapshot, restoreContextSnapshot, deriveContextSnapshot, } from "./contextSnapshot.snapshot.js";
+//# sourceMappingURL=index.js.map

package/dist/context/snapshot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/context/snapshot/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,GAEtB,MAAM,+BAA+B,CAAC"}

package/dist/context/values/contextValues.values.d.ts

@@ -0,0 +1,84 @@
+import type { ContextKey, ContextValueStore } from "../core/contextKey.key.js";
+/**
+ * Immutable, strongly typed storage for values associated
+ * with an ExecutionContext.
+ *
+ * ContextValues keeps application scoped values separate from
+ * the fixed properties of ExecutionContext.
+ */
+export declare class ContextValues {
+    private readonly values;
+    /**
+     * Creates a ContextValues instance.
+     *
+     * An optional initial store can be supplied when deriving
+     * a new context value collection.
+     */
+    constructor(values?: ContextValueStore);
+    /**
+     * Returns a value associated with a context key.
+     *
+     * Returns undefined when the value does not exist.
+     */
+    get<T>(key: ContextKey<T>): T | undefined;
+    /**
+     * Returns a required context value.
+     *
+     * Throws when the value does not exist.
+     */
+    require<T>(key: ContextKey<T>): T;
+    /**
+     * Checks whether a value exists for the supplied key.
+     */
+    has<T>(key: ContextKey<T>): boolean;
+    /**
+     * Returns a new ContextValues instance with
+     * the supplied value added or replaced.
+     */
+    set<T>(key: ContextKey<T>, value: T): ContextValues;
+    /**
+     * Returns a new ContextValues instance with
+     * the supplied key removed.
+     */
+    delete<T>(key: ContextKey<T>): ContextValues;
+    /**
+     * Returns a new ContextValues instance without
+     * any stored values.
+     */
+    clear(): ContextValues;
+    /**
+     * Returns the number of stored context values.
+     */
+    size(): number;
+    /**
+     * Returns whether no values are stored.
+     */
+    isEmpty(): boolean;
+    /**
+     * Creates a new ContextValues instance containing
+     * all existing values plus the supplied values.
+     */
+    merge(other: ContextValues): ContextValues;
+    /**
+     * Creates a mutable internal snapshot.
+     *
+     * This is intentionally not exposed publicly as a Map.
+     *
+     * It is useful for framework infrastructure that needs to
+     * derive another ContextValues instance.
+     */
+    toStore(): ContextValueStore;
+    /**
+     * Iterates over stored context values.
+     *
+     * Keys are exposed as symbols because the ContextKey
+     * objects themselves are intentionally not recoverable
+     * from the internal store.
+     */
+    entries(): IterableIterator<readonly [symbol, unknown]>;
+}
+/**
+ * Creates an empty ContextValues collection.
+ */
+export declare function createContextValues(): ContextValues;
+//# sourceMappingURL=contextValues.values.d.ts.map

package/dist/context/values/contextValues.values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextValues.values.d.ts","sourceRoot":"","sources":["../../../src/context/values/contextValues.values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAO/E;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAE3C;;;;;OAKG;IACH,YAAmB,MAAM,CAAC,EAAE,iBAAiB,EAE5C;IAED;;;;OAIG;IACI,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAE/C;IAED;;;;OAIG;IACI,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAEvC;IAED;;OAEG;IACI,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAEzC;IAED;;;OAGG;IACI,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,aAAa,CAMzD;IAED;;;OAGG;IACI,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,aAAa,CAMlD;IAED;;;OAGG;IACI,KAAK,IAAI,aAAa,CAE5B;IAED;;OAEG;IACI,IAAI,IAAI,MAAM,CAEpB;IAED;;OAEG;IACI,OAAO,IAAI,OAAO,CAExB;IAED;;;OAGG;IACI,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAQhD;IAED;;;;;;;OAOG;IACI,OAAO,IAAI,iBAAiB,CAElC;IAED;;;;;;OAMG;IACK,OAAO,IAAI,gBAAgB,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAI9D;CACF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}

package/dist/context/values/contextValues.values.js

@@ -0,0 +1,120 @@
+import { getContextValue, hasContextValue, requireContextValue, } from "../core/contextKey.key.js";
+/**
+ * Immutable, strongly typed storage for values associated
+ * with an ExecutionContext.
+ *
+ * ContextValues keeps application scoped values separate from
+ * the fixed properties of ExecutionContext.
+ */
+export class ContextValues {
+    values;
+    /**
+     * Creates a ContextValues instance.
+     *
+     * An optional initial store can be supplied when deriving
+     * a new context value collection.
+     */
+    constructor(values) {
+        this.values = new Map(values ?? []);
+    }
+    /**
+     * Returns a value associated with a context key.
+     *
+     * Returns undefined when the value does not exist.
+     */
+    get(key) {
+        return getContextValue(this.values, key);
+    }
+    /**
+     * Returns a required context value.
+     *
+     * Throws when the value does not exist.
+     */
+    require(key) {
+        return requireContextValue(this.values, key);
+    }
+    /**
+     * Checks whether a value exists for the supplied key.
+     */
+    has(key) {
+        return hasContextValue(this.values, key);
+    }
+    /**
+     * Returns a new ContextValues instance with
+     * the supplied value added or replaced.
+     */
+    set(key, value) {
+        const values = new Map(this.values);
+        values.set(key.id, value);
+        return new ContextValues(values);
+    }
+    /**
+     * Returns a new ContextValues instance with
+     * the supplied key removed.
+     */
+    delete(key) {
+        const values = new Map(this.values);
+        values.delete(key.id);
+        return new ContextValues(values);
+    }
+    /**
+     * Returns a new ContextValues instance without
+     * any stored values.
+     */
+    clear() {
+        return new ContextValues();
+    }
+    /**
+     * Returns the number of stored context values.
+     */
+    size() {
+        return this.values.size;
+    }
+    /**
+     * Returns whether no values are stored.
+     */
+    isEmpty() {
+        return this.values.size === 0;
+    }
+    /**
+     * Creates a new ContextValues instance containing
+     * all existing values plus the supplied values.
+     */
+    merge(other) {
+        const values = new Map(this.values);
+        for (const [key, value] of other.values) {
+            values.set(key, value);
+        }
+        return new ContextValues(values);
+    }
+    /**
+     * Creates a mutable internal snapshot.
+     *
+     * This is intentionally not exposed publicly as a Map.
+     *
+     * It is useful for framework infrastructure that needs to
+     * derive another ContextValues instance.
+     */
+    toStore() {
+        return new Map(this.values);
+    }
+    /**
+     * Iterates over stored context values.
+     *
+     * Keys are exposed as symbols because the ContextKey
+     * objects themselves are intentionally not recoverable
+     * from the internal store.
+     */
+    *entries() {
+        for (const entry of this.values.entries()) {
+            yield entry;
+        }
+    }
+}
+/**
+ * Creates an empty ContextValues collection.
+ */
+export function createContextValues() {
+    return new ContextValues();
+}
+//# sourceMappingURL=contextValues.values.js.map

package/dist/context/values/contextValues.values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextValues.values.js","sourceRoot":"","sources":["../../../src/context/values/contextValues.values.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,eAAe,EACf,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IACP,MAAM,CAAoB;IAE3C;;;;;OAKG;IACH,YAAmB,MAA0B;QAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAI,GAAkB;QAC9B,OAAO,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACI,OAAO,CAAI,GAAkB;QAClC,OAAO,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,GAAG,CAAI,GAAkB;QAC9B,OAAO,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACI,GAAG,CAAI,GAAkB,EAAE,KAAQ;QACxC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEpC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAE1B,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACI,MAAM,CAAI,GAAkB;QACjC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEpC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEtB,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACI,KAAK;QACV,OAAO,IAAI,aAAa,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,IAAI;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED;;OAEG;IACI,OAAO;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC;IAChC,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,KAAoB;QAC/B,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACxC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC;QAED,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;OAOG;IACI,OAAO;QACZ,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACI,CAAC,OAAO;QACb,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1C,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,aAAa,EAAE,CAAC;AAC7B,CAAC"}

package/dist/context/values/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/core/context/values
+ *
+ * Immutable typed context value collection.
+ */
+export { ContextValues, createContextValues } from "./contextValues.values.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/context/values/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/values/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/context/values/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/core/context/values
+ *
+ * Immutable typed context value collection.
+ */
+export { ContextValues, createContextValues } from "./contextValues.values.js";
+//# sourceMappingURL=index.js.map

package/dist/context/values/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/context/values/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}