@zudojs/core 0.0.1

package/dist/container/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/container/token.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,GAAG,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAEtE"}

package/dist/container/token.js

@@ -0,0 +1,10 @@
+/**
+ * Creates a unique symbol token.
+ *
+ * Useful for interfaces and infrastructure contracts that do not
+ * exist at runtime.
+ */
+export function createToken(description) {
+    return Symbol(description);
+}
+//# sourceMappingURL=token.js.map

package/dist/container/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/container/token.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAc,WAAmB;IAC1D,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;AAC7B,CAAC"}

package/dist/context/core/context.d.ts

@@ -0,0 +1,95 @@
+import type { ApplicationContext } from "../../application/applicationContext.context.js";
+/**
+ * Represents the source through which an execution was initiated.
+ */
+export type ContextType = "http" | "rpc" | "message" | "job" | "cli" | "worker" | "unknown";
+/**
+ * Metadata describing a single execution.
+ */
+export interface ExecutionMetadata {
+    readonly id: string;
+    readonly type: ContextType;
+    readonly createdAt: Date;
+}
+/**
+ * Represents one unit of execution inside a Zudojs application.
+ *
+ * An execution context can represent an HTTP request, background job,
+ * queue message, RPC call, CLI command, or another execution source.
+ *
+ * Context combines:
+ * - A reference to the application (via ApplicationContext)
+ * - Execution-specific metadata (id, type, timestamp)
+ * - Mutable values for the execution lifetime
+ *
+ * This is useful when you need to track execution-specific state
+ * alongside application-wide capabilities.
+ */
+export declare class Context {
+    private readonly application;
+    private readonly metadata;
+    private readonly values;
+    constructor(application: ApplicationContext, metadata: ExecutionMetadata);
+    /**
+     * Returns the application context associated with this execution.
+     */
+    getApplication(): ApplicationContext;
+    /**
+     * Returns execution metadata.
+     */
+    getMetadata(): ExecutionMetadata;
+    /**
+     * Returns the unique execution ID.
+     */
+    getId(): string;
+    /**
+     * Returns the execution type.
+     */
+    getType(): ContextType;
+    /**
+     * Stores a value for the lifetime of this execution context.
+     */
+    set<T>(key: string | symbol, value: T): void;
+    /**
+     * Retrieves a value from the execution context.
+     */
+    get<T>(key: string | symbol): T | undefined;
+    /**
+     * Checks whether a value exists in the execution context.
+     */
+    has(key: string | symbol): boolean;
+    /**
+     * Removes a value from the execution context.
+     */
+    delete(key: string | symbol): boolean;
+    /**
+     * Clears all values associated with this execution.
+     */
+    clear(): void;
+}
+/**
+ * Options for creating a Context.
+ */
+export interface CreateContextOptions {
+    /**
+     * Application context.
+     */
+    readonly application: ApplicationContext;
+    /**
+     * Execution type.
+     */
+    readonly type: ContextType;
+    /**
+     * Optional execution ID. Generated if not provided.
+     */
+    readonly id?: string;
+    /**
+     * Optional creation timestamp. Current time used if not provided.
+     */
+    readonly createdAt?: Date;
+}
+/**
+ * Creates a new execution Context.
+ */
+export declare function createContext(options: CreateContextOptions): Context;
+//# sourceMappingURL=context.d.ts.map

package/dist/context/core/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/context/core/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAE1F;;GAEG;AACH,MAAM,MAAM,WAAW,GACrB,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAE7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAE9D,YACE,WAAW,EAAE,kBAAkB,EAC/B,QAAQ,EAAE,iBAAiB,EAI5B;IAED;;OAEG;IACI,cAAc,IAAI,kBAAkB,CAE1C;IAED;;OAEG;IACI,WAAW,IAAI,iBAAiB,CAEtC;IAED;;OAEG;IACI,KAAK,IAAI,MAAM,CAErB;IAED;;OAEG;IACI,OAAO,IAAI,WAAW,CAE5B;IAED;;OAEG;IACI,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAElD;IAED;;OAEG;IACI,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,SAAS,CAEjD;IAED;;OAEG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAExC;IAED;;OAEG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAE3C;IAED;;OAEG;IACI,KAAK,IAAI,IAAI,CAEnB;CACF;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAQpE"}

package/dist/context/core/context.js

@@ -0,0 +1,103 @@
+/**
+ * Represents one unit of execution inside a Zudojs application.
+ *
+ * An execution context can represent an HTTP request, background job,
+ * queue message, RPC call, CLI command, or another execution source.
+ *
+ * Context combines:
+ * - A reference to the application (via ApplicationContext)
+ * - Execution-specific metadata (id, type, timestamp)
+ * - Mutable values for the execution lifetime
+ *
+ * This is useful when you need to track execution-specific state
+ * alongside application-wide capabilities.
+ */
+export class Context {
+    application;
+    metadata;
+    values = new Map();
+    constructor(application, metadata) {
+        this.application = application;
+        this.metadata = metadata;
+    }
+    /**
+     * Returns the application context associated with this execution.
+     */
+    getApplication() {
+        return this.application;
+    }
+    /**
+     * Returns execution metadata.
+     */
+    getMetadata() {
+        return this.metadata;
+    }
+    /**
+     * Returns the unique execution ID.
+     */
+    getId() {
+        return this.metadata.id;
+    }
+    /**
+     * Returns the execution type.
+     */
+    getType() {
+        return this.metadata.type;
+    }
+    /**
+     * Stores a value for the lifetime of this execution context.
+     */
+    set(key, value) {
+        this.values.set(key, value);
+    }
+    /**
+     * Retrieves a value from the execution context.
+     */
+    get(key) {
+        return this.values.get(key);
+    }
+    /**
+     * Checks whether a value exists in the execution context.
+     */
+    has(key) {
+        return this.values.has(key);
+    }
+    /**
+     * Removes a value from the execution context.
+     */
+    delete(key) {
+        return this.values.delete(key);
+    }
+    /**
+     * Clears all values associated with this execution.
+     */
+    clear() {
+        this.values.clear();
+    }
+}
+/**
+ * Creates a new execution Context.
+ */
+export function createContext(options) {
+    const metadata = {
+        id: options.id ?? createExecutionId(),
+        type: options.type,
+        createdAt: options.createdAt ?? new Date(),
+    };
+    return new Context(options.application, metadata);
+}
+/**
+ * Creates a unique execution identifier.
+ */
+function createExecutionId() {
+    if (typeof globalThis.crypto !== "undefined" &&
+        typeof globalThis.crypto.randomUUID === "function") {
+        return globalThis.crypto.randomUUID();
+    }
+    return [
+        Date.now().toString(36),
+        Math.random().toString(36).slice(2),
+        Math.random().toString(36).slice(2),
+    ].join("-");
+}
+//# sourceMappingURL=context.js.map

package/dist/context/core/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/context/core/context.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,OAAO;IACD,WAAW,CAAqB;IAChC,QAAQ,CAAoB;IAE5B,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;IAE9D,YACE,WAA+B,EAC/B,QAA2B;QAE3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,cAAc;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACI,WAAW;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACI,KAAK;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACI,OAAO;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,GAAG,CAAI,GAAoB,EAAE,KAAQ;QAC1C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACI,GAAG,CAAI,GAAoB;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAkB,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,GAAG,CAAC,GAAoB;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,GAAoB;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF;AA2BD;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAA6B;IACzD,MAAM,QAAQ,GAAsB;QAClC,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,iBAAiB,EAAE;QACrC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE;KAC3C,CAAC;IAEF,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB;IACxB,IACE,OAAO,UAAU,CAAC,MAAM,KAAK,WAAW;QACxC,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,KAAK,UAAU,EAClD,CAAC;QACD,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IACxC,CAAC;IAED,OAAO;QACL,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;KACpC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC"}

package/dist/context/core/contextKey.key.d.ts

@@ -0,0 +1,60 @@
+/**
+ * A typed key used to store and retrieve values from
+ * an execution context.
+ *
+ * The generic type represents the value associated with
+ * the key.
+ */
+export interface ContextKey<T> {
+    /**
+     * Unique key identifier.
+     */
+    readonly id: symbol;
+    /**
+     * Human-readable key name.
+     *
+     * Useful for debugging and diagnostics.
+     */
+    readonly name: string;
+}
+/**
+ * Creates a strongly typed ContextKey.
+ *
+ * Example:
+ *
+ * const userKey = createContextKey<User>(
+ *   "authenticated-user",
+ * );
+ */
+export declare function createContextKey<T>(name: string): ContextKey<T>;
+/**
+ * Internal storage used by the execution context
+ * for strongly typed values.
+ */
+export type ContextValueStore = Map<symbol, unknown>;
+/**
+ * Stores a value against a context key.
+ */
+export declare function setContextValue<T>(store: ContextValueStore, key: ContextKey<T>, value: T): void;
+/**
+ * Retrieves a value associated with a context key.
+ *
+ * Returns undefined when the key has not been registered
+ * in the current context.
+ */
+export declare function getContextValue<T>(store: ContextValueStore, key: ContextKey<T>): T | undefined;
+/**
+ * Retrieves a required context value.
+ *
+ * Throws when the value does not exist.
+ */
+export declare function requireContextValue<T>(store: ContextValueStore, key: ContextKey<T>): T;
+/**
+ * Checks whether a context value exists.
+ */
+export declare function hasContextValue<T>(store: ContextValueStore, key: ContextKey<T>): boolean;
+/**
+ * Removes a context value.
+ */
+export declare function deleteContextValue<T>(store: ContextValueStore, key: ContextKey<T>): boolean;
+//# sourceMappingURL=contextKey.key.d.ts.map

package/dist/context/core/contextKey.key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextKey.key.d.ts","sourceRoot":"","sources":["../../../src/context/core/contextKey.key.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAS/D;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAClB,KAAK,EAAE,CAAC,GACP,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GACjB,CAAC,GAAG,SAAS,CAEf;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GACjB,CAAC,CAQH;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GACjB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GACjB,OAAO,CAET"}

package/dist/context/core/contextKey.key.js

@@ -0,0 +1,58 @@
+/**
+ * Creates a strongly typed ContextKey.
+ *
+ * Example:
+ *
+ * const userKey = createContextKey<User>(
+ *   "authenticated-user",
+ * );
+ */
+export function createContextKey(name) {
+    if (!name.trim()) {
+        throw new Error("Context key name cannot be empty.");
+    }
+    return Object.freeze({
+        id: Symbol(name),
+        name,
+    });
+}
+/**
+ * Stores a value against a context key.
+ */
+export function setContextValue(store, key, value) {
+    store.set(key.id, value);
+}
+/**
+ * Retrieves a value associated with a context key.
+ *
+ * Returns undefined when the key has not been registered
+ * in the current context.
+ */
+export function getContextValue(store, key) {
+    return store.get(key.id);
+}
+/**
+ * Retrieves a required context value.
+ *
+ * Throws when the value does not exist.
+ */
+export function requireContextValue(store, key) {
+    const value = getContextValue(store, key);
+    if (value === undefined) {
+        throw new Error(`Required context value "${key.name}" is not available.`);
+    }
+    return value;
+}
+/**
+ * Checks whether a context value exists.
+ */
+export function hasContextValue(store, key) {
+    return store.has(key.id);
+}
+/**
+ * Removes a context value.
+ */
+export function deleteContextValue(store, key) {
+    return store.delete(key.id);
+}
+//# sourceMappingURL=contextKey.key.js.map

package/dist/context/core/contextKey.key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextKey.key.js","sourceRoot":"","sources":["../../../src/context/core/contextKey.key.ts"],"names":[],"mappings":"AAqBA;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAI,IAAY;IAC9C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC;QAChB,IAAI;KACL,CAAC,CAAC;AACL,CAAC;AAQD;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAwB,EACxB,GAAkB,EAClB,KAAQ;IAER,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAwB,EACxB,GAAkB;IAElB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAkB,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAwB,EACxB,GAAkB;IAElB,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAE1C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,IAAI,qBAAqB,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAwB,EACxB,GAAkB;IAElB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAwB,EACxB,GAAkB;IAElB,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC9B,CAAC"}

package/dist/context/core/executionContext.context.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Represents the execution context of a single operation
+ * within a Zudojs application.
+ *
+ * An execution can represent:
+ *
+ * HTTP request
+ * RPC request
+ * Message consumption
+ * Background job
+ * Scheduled task
+ * CLI command
+ * Internal application operation
+ */
+export interface ExecutionContext {
+    /**
+     * Unique identifier for this execution.
+     */
+    readonly executionId: string;
+    /**
+     * Identifier used to correlate related operations.
+     */
+    readonly correlationId?: string;
+    /**
+     * Distributed tracing identifier.
+     */
+    readonly traceId?: string;
+    /**
+     * Current tracing span identifier.
+     */
+    readonly spanId?: string;
+    /**
+     * Identifier of the authenticated principal.
+     *
+     * The principal can represent a user, service account,
+     * API client, or another authenticated identity.
+     */
+    readonly principalId?: string;
+    /**
+     * Authentication scheme used for the execution.
+     *
+     * Examples:
+     *
+     * bearer
+     * api-key
+     * session
+     * service
+     */
+    readonly authenticationScheme?: string;
+    /**
+     * Name of the application or service handling the execution.
+     */
+    readonly service?: string;
+    /**
+     * Name of the module or bounded context handling the execution.
+     */
+    readonly module?: string;
+    /**
+     * Name of the operation being executed.
+     */
+    readonly operation?: string;
+    /**
+     * Origin transport of the execution.
+     *
+     * Examples:
+     *
+     * http
+     * rpc
+     * messaging
+     * websocket
+     * worker
+     * cli
+     */
+    readonly transport?: string;
+    /**
+     * Start time of the execution.
+     */
+    readonly startedAt: Date;
+    /**
+     * Arbitrary execution scoped metadata.
+     */
+    readonly metadata: Readonly<Record<string, unknown>>;
+}
+/**
+ * Input used to create an ExecutionContext.
+ *
+ * The execution ID and start time can be generated automatically.
+ */
+export interface CreateExecutionContextInput extends Partial<Omit<ExecutionContext, "executionId" | "startedAt" | "metadata">> {
+    /**
+     * Optional execution identifier.
+     *
+     * When omitted, the framework generates one.
+     */
+    readonly executionId?: string;
+    /**
+     * Optional execution start time.
+     *
+     * When omitted, the current time is used.
+     */
+    readonly startedAt?: Date;
+    /**
+     * Optional execution metadata.
+     */
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Creates a new execution context.
+ */
+export declare function createExecutionContext(input?: CreateExecutionContextInput): ExecutionContext;
+/**
+ * Creates a new execution context from an existing context.
+ *
+ * Existing values are preserved unless explicitly overridden.
+ * Metadata is merged rather than replaced.
+ */
+export declare function deriveExecutionContext(context: ExecutionContext, overrides?: Partial<Omit<ExecutionContext, "executionId" | "startedAt" | "metadata">> & {
+    readonly executionId?: string;
+    readonly startedAt?: Date;
+    readonly metadata?: Record<string, unknown>;
+}): ExecutionContext;
+/**
+ * Adds metadata to an execution context without mutating
+ * the existing context.
+ */
+export declare function withExecutionMetadata(context: ExecutionContext, metadata: Record<string, unknown>): ExecutionContext;
+/**
+ * Returns the duration of an execution in milliseconds.
+ */
+export declare function getExecutionDuration(context: ExecutionContext, endTime?: Date): number;
+//# sourceMappingURL=executionContext.context.d.ts.map

package/dist/context/core/executionContext.context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executionContext.context.d.ts","sourceRoot":"","sources":["../../../src/context/core/executionContext.context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;;;;;OASG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA4B,SAAQ,OAAO,CAC1D,IAAI,CAAC,gBAAgB,EAAE,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC,CACjE;IACC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,GAAE,2BAAgC,GACtC,gBAAgB,CA4BlB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,EACzB,SAAS,GAAE,OAAO,CAChB,IAAI,CAAC,gBAAgB,EAAE,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC,CACjE,GAAG;IACF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,GACL,gBAAgB,CA8BlB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,gBAAgB,CAIlB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,IAAiB,GACzB,MAAM,CAER"}

package/dist/context/core/executionContext.context.js

@@ -0,0 +1,81 @@
+/**
+ * Creates a new execution context.
+ */
+export function createExecutionContext(input = {}) {
+    return Object.freeze({
+        executionId: input.executionId ?? createExecutionId(),
+        correlationId: input.correlationId,
+        traceId: input.traceId,
+        spanId: input.spanId,
+        principalId: input.principalId,
+        authenticationScheme: input.authenticationScheme,
+        service: input.service,
+        module: input.module,
+        operation: input.operation,
+        transport: input.transport,
+        startedAt: input.startedAt ?? new Date(),
+        metadata: Object.freeze({
+            ...(input.metadata ?? {}),
+        }),
+    });
+}
+/**
+ * Creates a new execution context from an existing context.
+ *
+ * Existing values are preserved unless explicitly overridden.
+ * Metadata is merged rather than replaced.
+ */
+export function deriveExecutionContext(context, overrides = {}) {
+    return createExecutionContext({
+        executionId: overrides.executionId ?? context.executionId,
+        correlationId: overrides.correlationId ?? context.correlationId,
+        traceId: overrides.traceId ?? context.traceId,
+        spanId: overrides.spanId ?? context.spanId,
+        principalId: overrides.principalId ?? context.principalId,
+        authenticationScheme: overrides.authenticationScheme ?? context.authenticationScheme,
+        service: overrides.service ?? context.service,
+        module: overrides.module ?? context.module,
+        operation: overrides.operation ?? context.operation,
+        transport: overrides.transport ?? context.transport,
+        startedAt: overrides.startedAt ?? context.startedAt,
+        metadata: {
+            ...context.metadata,
+            ...(overrides.metadata ?? {}),
+        },
+    });
+}
+/**
+ * Adds metadata to an execution context without mutating
+ * the existing context.
+ */
+export function withExecutionMetadata(context, metadata) {
+    return deriveExecutionContext(context, {
+        metadata,
+    });
+}
+/**
+ * Returns the duration of an execution in milliseconds.
+ */
+export function getExecutionDuration(context, endTime = new Date()) {
+    return endTime.getTime() - context.startedAt.getTime();
+}
+/**
+ * Creates a framework execution identifier.
+ *
+ * Uses crypto.randomUUID when available.
+ */
+function createExecutionId() {
+    if (typeof globalThis.crypto !== "undefined" &&
+        typeof globalThis.crypto.randomUUID === "function") {
+        return globalThis.crypto.randomUUID();
+    }
+    /**
+     * Fallback for environments where Web Crypto is unavailable.
+     */
+    return [
+        Date.now().toString(36),
+        Math.random().toString(36).slice(2),
+        Math.random().toString(36).slice(2),
+    ].join("-");
+}
+//# sourceMappingURL=executionContext.context.js.map

package/dist/context/core/executionContext.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executionContext.context.js","sourceRoot":"","sources":["../../../src/context/core/executionContext.context.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,9 @@
+/**
+ * @zudojs/core/context/core
+ *
+ * Core context types and key management.
+ */
+export { Context, createContext, type ContextType, type ExecutionMetadata, type CreateContextOptions, } from "./context.js";
+export { createExecutionContext, deriveExecutionContext, withExecutionMetadata, getExecutionDuration, type ExecutionContext, type CreateExecutionContextInput, } from "./executionContext.context.js";
+export { createContextKey, setContextValue, getContextValue, requireContextValue, hasContextValue, deleteContextValue, type ContextKey, type ContextValueStore, } from "./contextKey.key.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,OAAO,EACP,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,2BAA2B,GACjC,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC"}

package/dist/context/core/index.js

@@ -0,0 +1,9 @@
+/**
+ * @zudojs/core/context/core
+ *
+ * Core context types and key management.
+ */
+export { Context, createContext, } from "./context.js";
+export { createExecutionContext, deriveExecutionContext, withExecutionMetadata, getExecutionDuration, } from "./executionContext.context.js";
+export { createContextKey, setContextValue, getContextValue, requireContextValue, hasContextValue, deleteContextValue, } from "./contextKey.key.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/context/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,OAAO,EACP,aAAa,GAId,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GAGrB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GAGnB,MAAM,qBAAqB,CAAC"}

package/dist/context/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Execution context.
+ */
+export * from "./core/index.js";
+export * from "./provider/index.js";
+export * from "./values/index.js";
+export * from "./snapshot/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,iBAAiB,CAAC;AAEhC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,mBAAmB,CAAC;AAElC,cAAc,qBAAqB,CAAC"}

package/dist/context/index.js

@@ -0,0 +1,8 @@
+/**
+ * Execution context.
+ */
+export * from "./core/index.js";
+export * from "./provider/index.js";
+export * from "./values/index.js";
+export * from "./snapshot/index.js";
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,iBAAiB,CAAC;AAEhC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,mBAAmB,CAAC;AAElC,cAAc,qBAAqB,CAAC"}