@zudojs/core 1.2.4 → 1.3.0

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

@@ -1,3 +1,5 @@
+import { ContextValueNotFoundError } from "../../errors/contextValueNotFound.error.js";
+import { InvalidArgumentError } from "../../errors/exceptions.js";
 /**
  * Creates a strongly typed ContextKey.
  *
@@ -9,7 +11,7 @@
  */
 export function createContextKey(name) {
     if (!name.trim()) {
-        throw new Error("Context key name cannot be empty.");
+        throw new InvalidArgumentError("Context key name cannot be empty.");
     }
     return Object.freeze({
         id: Symbol(name),
@@ -39,7 +41,7 @@ export function getContextValue(store, key) {
 export function requireContextValue(store, key) {
     const value = getContextValue(store, key);
     if (value === undefined) {
-        throw new Error(`Required context value "${key.name}" is not available.`);
+        throw new ContextValueNotFoundError(key.name);
     }
     return value;
 }
@@ -55,4 +57,3 @@ export function hasContextValue(store, key) {
 export function deleteContextValue(store, key) {
     return store.delete(key.id);
 }
-//# sourceMappingURL=contextKey.key.js.map

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

@@ -136,4 +136,3 @@ export declare function getExecutionDuration(context: ExecutionContext, endTime?
  * so no weaker fallback exists.
  */
 export declare function createExecutionId(): string;
-//# sourceMappingURL=executionContext.context.d.ts.map

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

@@ -101,4 +101,3 @@ export function getExecutionDuration(context, endTime = new Date()) {
 export function createExecutionId() {
     return globalThis.crypto.randomUUID();
 }
-//# sourceMappingURL=executionContext.context.js.map

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

@@ -6,4 +6,3 @@
 export { createExecutionContext, deriveExecutionContext, withExecutionMetadata, getExecutionDuration, createExecutionId, type ExecutionContext, type CreateExecutionContextInput, } from "./executionContext.context.js";
 export { createContextKey, setContextValue, getContextValue, requireContextValue, hasContextValue, deleteContextValue, type ContextKey, type ContextValueStore, } from "./contextKey.key.js";
 export { createContext, type Context, type ContextType, type CreateContextOptions, } from "./contextAliases.deprecated.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/context/core/index.js

@@ -6,4 +6,3 @@
 export { createExecutionContext, deriveExecutionContext, withExecutionMetadata, getExecutionDuration, createExecutionId, } from "./executionContext.context.js";
 export { createContextKey, setContextValue, getContextValue, requireContextValue, hasContextValue, deleteContextValue, } from "./contextKey.key.js";
 export { createContext, } from "./contextAliases.deprecated.js";
-//# sourceMappingURL=index.js.map

package/dist/context/index.d.ts

@@ -25,4 +25,3 @@ 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.js

@@ -25,4 +25,3 @@ 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/provider/contextProvider.provider.d.ts

@@ -61,4 +61,3 @@ export declare class DefaultContextProvider implements ContextProvider {
  * to a specific ContextStorage.
  */
 export declare function createContextProvider(storage?: ContextStorage): ContextProvider;
-//# sourceMappingURL=contextProvider.provider.d.ts.map

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

@@ -44,4 +44,3 @@ export class DefaultContextProvider {
 export function createContextProvider(storage) {
     return new DefaultContextProvider(storage);
 }
-//# sourceMappingURL=contextProvider.provider.js.map

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

@@ -99,4 +99,3 @@ export declare class ContextStorage {
  * Creates a ContextStorage instance.
  */
 export declare function createContextStorage(): ContextStorage;
-//# sourceMappingURL=contextStorage.storage.d.ts.map

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

@@ -124,4 +124,3 @@ export class ContextStorage {
 export function createContextStorage() {
     return new ContextStorage();
 }
-//# sourceMappingURL=contextStorage.storage.js.map

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

@@ -15,4 +15,3 @@ export declare const defaultContextStorage: ContextStorage;
  * Returns the process-wide default ContextStorage.
  */
 export declare function getDefaultContextStorage(): ContextStorage;
-//# sourceMappingURL=defaultContextStorage.storage.d.ts.map

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

@@ -17,4 +17,3 @@ export const defaultContextStorage = new ContextStorage();
 export function getDefaultContextStorage() {
     return defaultContextStorage;
 }
-//# sourceMappingURL=defaultContextStorage.storage.js.map

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

@@ -6,4 +6,3 @@
 export { ContextStorage, createContextStorage, type ExecutionContextOverrides, } from "./contextStorage.storage.js";
 export { defaultContextStorage, getDefaultContextStorage, } from "./defaultContextStorage.storage.js";
 export { DefaultContextProvider, createContextProvider, type ContextProvider, } from "./contextProvider.provider.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/context/provider/index.js

@@ -6,4 +6,3 @@
 export { ContextStorage, createContextStorage, } from "./contextStorage.storage.js";
 export { defaultContextStorage, getDefaultContextStorage, } from "./defaultContextStorage.storage.js";
 export { DefaultContextProvider, createContextProvider, } from "./contextProvider.provider.js";
-//# sourceMappingURL=index.js.map

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

@@ -45,4 +45,3 @@ export declare function restoreContextSnapshot(snapshot: ContextSnapshot): {
  * 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.js

@@ -30,4 +30,3 @@ export function restoreContextSnapshot(snapshot) {
 export function deriveContextSnapshot(snapshot, context, values) {
     return createContextSnapshot(context, values ?? new ContextValues(snapshot.values.toStore()));
 }
-//# sourceMappingURL=contextSnapshot.snapshot.js.map

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

@@ -5,4 +5,3 @@
  * asynchronous and distributed boundaries.
  */
 export { createContextSnapshot, restoreContextSnapshot, deriveContextSnapshot, type ContextSnapshot, } from "./contextSnapshot.snapshot.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/context/snapshot/index.js

@@ -5,4 +5,3 @@
  * asynchronous and distributed boundaries.
  */
 export { createContextSnapshot, restoreContextSnapshot, deriveContextSnapshot, } from "./contextSnapshot.snapshot.js";
-//# sourceMappingURL=index.js.map

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

@@ -81,4 +81,3 @@ export declare class ContextValues {
  * Creates an empty ContextValues collection.
  */
 export declare function createContextValues(): ContextValues;
-//# sourceMappingURL=contextValues.values.d.ts.map

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

@@ -117,4 +117,3 @@ export class ContextValues {
 export function createContextValues() {
     return new ContextValues();
 }
-//# sourceMappingURL=contextValues.values.js.map

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

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

package/dist/context/values/index.js

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

package/dist/contracts/adapter.d.ts

@@ -41,4 +41,3 @@ export interface Adapter<TOptions = unknown> extends Disposable {
      */
     stop(): Promise<void> | void;
 }
-//# sourceMappingURL=adapter.d.ts.map

package/dist/contracts/adapter.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=adapter.js.map

package/dist/contracts/disposable.d.ts

@@ -20,4 +20,3 @@ export interface Disposable {
      */
     dispose(): Promise<void> | void;
 }
-//# sourceMappingURL=disposable.d.ts.map

package/dist/contracts/disposable.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=disposable.js.map

package/dist/contracts/handler.d.ts

@@ -29,4 +29,3 @@ export type HandlerFunction<TInput = unknown, TOutput = unknown> = (input: TInpu
  * Converts a handler function into a Handler object.
  */
 export declare function createHandler<TInput, TOutput>(handler: HandlerFunction<TInput, TOutput>): Handler<TInput, TOutput>;
-//# sourceMappingURL=handler.d.ts.map

package/dist/contracts/handler.js

@@ -6,4 +6,3 @@ export function createHandler(handler) {
         handle: handler,
     };
 }
-//# sourceMappingURL=handler.js.map

package/dist/contracts/index.d.ts

@@ -4,4 +4,3 @@
 export { type Adapter } from "./adapter.js";
 export { type Handler, type HandlerFunction, createHandler, } from "./handler.js";
 export { type Disposable } from "./disposable.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/contracts/index.js

@@ -4,4 +4,3 @@
 export {} from "./adapter.js";
 export { createHandler, } from "./handler.js";
 export {} from "./disposable.js";
-//# sourceMappingURL=index.js.map

package/dist/errors/contextValueNotFound.error.d.ts

@@ -0,0 +1,15 @@
+import { FrameworkError } from "./frameworkError.error.js";
+/**
+ * Thrown by `ContextValues.require()` when no value is stored under
+ * the requested context key.
+ *
+ * A plain `Error` used to be thrown here, so callers could neither
+ * catch it by type nor read a code from it.
+ */
+export declare class ContextValueNotFoundError extends FrameworkError {
+    /**
+     * Human-readable name of the missing key.
+     */
+    readonly key: string;
+    constructor(keyName: string);
+}

package/dist/errors/contextValueNotFound.error.js

@@ -0,0 +1,23 @@
+import { FrameworkError } from "./frameworkError.error.js";
+import { ErrorCode } from "./errorCode.code.js";
+/**
+ * Thrown by `ContextValues.require()` when no value is stored under
+ * the requested context key.
+ *
+ * A plain `Error` used to be thrown here, so callers could neither
+ * catch it by type nor read a code from it.
+ */
+export class ContextValueNotFoundError extends FrameworkError {
+    /**
+     * Human-readable name of the missing key.
+     */
+    key;
+    constructor(keyName) {
+        super(`Required context value "${keyName}" is not available.`, {
+            code: ErrorCode.CONTEXT_VALUE_NOT_FOUND,
+            details: { key: keyName },
+        });
+        this.name = "ContextValueNotFoundError";
+        this.key = keyName;
+    }
+}

package/dist/errors/errorCode.code.d.ts

@@ -30,6 +30,7 @@ export declare const ErrorCode: {
     readonly CONFIGURATION_CONFLICT: "CORE_CONFIGURATION_CONFLICT";
     readonly EXECUTION_CONTEXT_NOT_FOUND: "CORE_EXECUTION_CONTEXT_NOT_FOUND";
     readonly INVALID_EXECUTION_CONTEXT: "CORE_INVALID_EXECUTION_CONTEXT";
+    readonly CONTEXT_VALUE_NOT_FOUND: "CORE_CONTEXT_VALUE_NOT_FOUND";
     readonly MODULE_NOT_FOUND: "CORE_MODULE_NOT_FOUND";
     readonly MODULE_ALREADY_REGISTERED: "CORE_MODULE_ALREADY_REGISTERED";
     readonly MODULE_INITIALIZATION_FAILED: "CORE_MODULE_INITIALIZATION_FAILED";
@@ -75,4 +76,3 @@ export declare const ErrorCode: {
  * Union of all core Zudojs error codes.
  */
 export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
-//# sourceMappingURL=errorCode.code.d.ts.map

package/dist/errors/errorCode.code.js

@@ -35,6 +35,7 @@ export const ErrorCode = {
     // Context
     EXECUTION_CONTEXT_NOT_FOUND: "CORE_EXECUTION_CONTEXT_NOT_FOUND",
     INVALID_EXECUTION_CONTEXT: "CORE_INVALID_EXECUTION_CONTEXT",
+    CONTEXT_VALUE_NOT_FOUND: "CORE_CONTEXT_VALUE_NOT_FOUND",
     // Modules
     MODULE_NOT_FOUND: "CORE_MODULE_NOT_FOUND",
     MODULE_ALREADY_REGISTERED: "CORE_MODULE_ALREADY_REGISTERED",
@@ -81,4 +82,3 @@ export const ErrorCode = {
     // Configuration validation
     CONFIGURATION_VALIDATION_FAILED: "CORE_CONFIGURATION_VALIDATION_FAILED",
 };
-//# sourceMappingURL=errorCode.code.js.map

package/dist/errors/exceptions.d.ts

@@ -71,4 +71,3 @@ export declare class AdapterNotFoundError extends FrameworkError {
  * Creates a readable representation of a dependency token.
  */
 export declare function describeToken(token: unknown): string;
-//# sourceMappingURL=exceptions.d.ts.map

package/dist/errors/exceptions.js

@@ -159,4 +159,3 @@ export function describeToken(token) {
     }
     return String(token);
 }
-//# sourceMappingURL=exceptions.js.map

package/dist/errors/frameworkError.error.d.ts

@@ -45,4 +45,3 @@ export declare class FrameworkError extends ApplicationError {
      */
     toJSON(): FrameworkErrorJSON;
 }
-//# sourceMappingURL=frameworkError.error.d.ts.map

package/dist/errors/frameworkError.error.js

@@ -51,4 +51,3 @@ export class FrameworkError extends ApplicationError {
         };
     }
 }
-//# sourceMappingURL=frameworkError.error.js.map

package/dist/errors/index.d.ts

@@ -6,5 +6,5 @@
 export { ErrorCode } from "./errorCode.code.js";
 export type { ErrorCode as ErrorCodeType } from "./errorCode.code.js";
 export { FrameworkError, type FrameworkErrorJSON, } from "./frameworkError.error.js";
+export { ContextValueNotFoundError } from "./contextValueNotFound.error.js";
 export { InvalidArgumentError, InvalidStateError, ProviderNotFoundError, ProviderAlreadyRegisteredError, InvalidProviderError, DependencyResolutionError, ConfigurationNotFoundError, ExecutionContextNotFoundError, ModuleNotFoundError, AdapterNotFoundError, describeToken, } from "./exceptions.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.js

@@ -5,5 +5,5 @@
  */
 export { ErrorCode } from "./errorCode.code.js";
 export { FrameworkError, } from "./frameworkError.error.js";
+export { ContextValueNotFoundError } from "./contextValueNotFound.error.js";
 export { InvalidArgumentError, InvalidStateError, ProviderNotFoundError, ProviderAlreadyRegisteredError, InvalidProviderError, DependencyResolutionError, ConfigurationNotFoundError, ExecutionContextNotFoundError, ModuleNotFoundError, AdapterNotFoundError, describeToken, } from "./exceptions.js";
-//# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -31,4 +31,7 @@ export * from "./modules/index.js";
 export { ModuleNotFoundError } from "./modules/index.js";
 export * from "./runtime/index.js";
 export * from "./application/index.js";
-//# sourceMappingURL=index.d.ts.map
+export { Lifecycle as CoreLifecycle, LifecycleManager as CoreLifecycleManager, LifecycleState as CoreLifecycleState, } from "./lifecycle/index.js";
+export { Container as CoreContainer } from "./container/index.js";
+export { ConfigurationManager as CoreConfigurationManager } from "./configuration/index.js";
+export { createRuntime as createCoreRuntime } from "./runtime/index.js";

package/dist/index.js

@@ -86,4 +86,19 @@ export * from "./runtime/index.js";
  * ============================================================
  */
 export * from "./application/index.js";
-//# sourceMappingURL=index.js.map
+/*
+ * ============================================================
+ * Aliases for colliding names
+ * ============================================================
+ *
+ * These names are also exported, with different meanings, by sibling
+ * packages: `LifecycleState`/`LifecycleManager` by @zudojs/lifecycle
+ * and @zudojs/constants, `createRuntime` by @zudojs/runtime,
+ * `Container` by @zudojs/container, `ConfigurationManager` by
+ * @zudojs/config. The originals stay; import the Core-prefixed alias
+ * when two of those packages meet in one file.
+ */
+export { Lifecycle as CoreLifecycle, LifecycleManager as CoreLifecycleManager, LifecycleState as CoreLifecycleState, } from "./lifecycle/index.js";
+export { Container as CoreContainer } from "./container/index.js";
+export { ConfigurationManager as CoreConfigurationManager } from "./configuration/index.js";
+export { createRuntime as createCoreRuntime } from "./runtime/index.js";

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

@@ -6,4 +6,3 @@
 export { Lifecycle, LifecycleState, type LifecycleOptions, type LifecycleParticipant, } from "./lifecycle.js";
 export { hasInitializeHook, hasStartHook, hasStopHook, hasDestroyHook, type OnInitialize, type OnStart, type OnStop, type OnDestroy, type LifecycleHook, } from "./lifecycleHook.hook.js";
 export { LifecycleRegistry, type LifecycleComponent, type LifecycleRegistration, } from "./lifecycleRegistry.registry.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/lifecycle/core/index.js

@@ -6,4 +6,3 @@
 export { Lifecycle, LifecycleState, } from "./lifecycle.js";
 export { hasInitializeHook, hasStartHook, hasStopHook, hasDestroyHook, } from "./lifecycleHook.hook.js";
 export { LifecycleRegistry, } from "./lifecycleRegistry.registry.js";
-//# sourceMappingURL=index.js.map

package/dist/lifecycle/core/lifecycle.d.ts

@@ -1,5 +1,16 @@
 import type { Logger } from "../../logging/core/logger.js";
-/** Lifecycle states supported by the Zudojs application runtime. */
+/**
+ * States of the core `Lifecycle` participant machine (created →
+ * initializing → initialized → starting → running → stopping → stopped,
+ * plus failed).
+ *
+ * This is one of three state vocabularies in the framework and they do
+ * not share values: `LifecycleState` from @zudojs/constants describes
+ * a component managed by @zudojs/lifecycle (idle … started → ready …
+ * disposed) and `RuntimeState` from @zudojs/runtime describes that
+ * package's runtime. Import this one as `CoreLifecycleState` when the
+ * names would clash.
+ */
 export declare const LifecycleState: {
     readonly CREATED: "created";
     readonly INITIALIZING: "initializing";
@@ -91,4 +102,3 @@ export declare class Lifecycle {
     private runStop;
     private invalidState;
 }
-//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle/core/lifecycle.js

@@ -1,6 +1,17 @@
 import { InvalidStateError } from "../../errors/exceptions.js";
 import { rollbackStartedParticipants } from "./lifecycle.rollback.js";
-/** Lifecycle states supported by the Zudojs application runtime. */
+/**
+ * States of the core `Lifecycle` participant machine (created →
+ * initializing → initialized → starting → running → stopping → stopped,
+ * plus failed).
+ *
+ * This is one of three state vocabularies in the framework and they do
+ * not share values: `LifecycleState` from @zudojs/constants describes
+ * a component managed by @zudojs/lifecycle (idle … started → ready …
+ * disposed) and `RuntimeState` from @zudojs/runtime describes that
+ * package's runtime. Import this one as `CoreLifecycleState` when the
+ * names would clash.
+ */
 export const LifecycleState = {
     CREATED: "created",
     INITIALIZING: "initializing",
@@ -355,4 +366,3 @@ export class Lifecycle {
         return new InvalidStateError(`Cannot ${label} application while state is "${this.state}".`, { operation, state: this.state });
     }
 }
-//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle/core/lifecycle.rollback.d.ts

@@ -15,4 +15,3 @@ import type { LifecycleParticipant } from "./lifecycle.js";
  * @returns The errors raised by `stop()` hooks during the rollback.
  */
 export declare function rollbackStartedParticipants(participants: readonly LifecycleParticipant[], count: number, logger: Logger | undefined): Promise<readonly unknown[]>;
-//# sourceMappingURL=lifecycle.rollback.d.ts.map

package/dist/lifecycle/core/lifecycle.rollback.js

@@ -31,4 +31,3 @@ export async function rollbackStartedParticipants(participants, count, logger) {
     }
     return errors;
 }
-//# sourceMappingURL=lifecycle.rollback.js.map

package/dist/lifecycle/core/lifecycleHook.hook.d.ts

@@ -56,4 +56,3 @@ export declare function hasStopHook(value: unknown): value is OnStop;
  * Type guard for destroy hooks.
  */
 export declare function hasDestroyHook(value: unknown): value is OnDestroy;
-//# sourceMappingURL=lifecycleHook.hook.d.ts.map

package/dist/lifecycle/core/lifecycleHook.hook.js

@@ -34,4 +34,3 @@ export function hasDestroyHook(value) {
         "onDestroy" in value &&
         typeof value.onDestroy === "function");
 }
-//# sourceMappingURL=lifecycleHook.hook.js.map

package/dist/lifecycle/core/lifecycleRegistry.registry.d.ts

@@ -106,4 +106,3 @@ export declare class LifecycleRegistry {
      */
     private resolveComponentName;
 }
-//# sourceMappingURL=lifecycleRegistry.registry.d.ts.map

package/dist/lifecycle/core/lifecycleRegistry.registry.js

@@ -131,4 +131,3 @@ export class LifecycleRegistry {
         return "anonymous";
     }
 }
-//# sourceMappingURL=lifecycleRegistry.registry.js.map

package/dist/lifecycle/index.d.ts

@@ -7,4 +7,3 @@
 export * from "./core/index.js";
 export * from "./manager/index.js";
 export * from "./scope/index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/lifecycle/index.js

@@ -7,4 +7,3 @@
 export * from "./core/index.js";
 export * from "./manager/index.js";
 export * from "./scope/index.js";
-//# sourceMappingURL=index.js.map

package/dist/lifecycle/manager/index.d.ts

@@ -4,4 +4,3 @@
  * Lifecycle orchestration.
  */
 export { LifecycleManager, type LifecycleManagerOptions, type ManagedLifecycleComponent, } from "./lifecycleManager.manager.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/lifecycle/manager/index.js

@@ -4,4 +4,3 @@
  * Lifecycle orchestration.
  */
 export { LifecycleManager, } from "./lifecycleManager.manager.js";
-//# sourceMappingURL=index.js.map

package/dist/lifecycle/manager/lifecycleManager.manager.d.ts

@@ -49,4 +49,3 @@ export declare class LifecycleManager {
     private isLifecycleParticipant;
     private getComponentName;
 }
-//# sourceMappingURL=lifecycleManager.manager.d.ts.map

package/dist/lifecycle/manager/lifecycleManager.manager.js

@@ -117,4 +117,3 @@ export class LifecycleManager {
         return "anonymous";
     }
 }
-//# sourceMappingURL=lifecycleManager.manager.js.map

package/dist/lifecycle/scope/index.d.ts

@@ -5,4 +5,3 @@
  * modules, plugins, workers, and services.
  */
 export { LifecycleScope, LifecycleScopeState, type LifecycleScopeOptions, } from "./lifecycleScope.scope.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/lifecycle/scope/index.js

@@ -5,4 +5,3 @@
  * modules, plugins, workers, and services.
  */
 export { LifecycleScope, LifecycleScopeState, } from "./lifecycleScope.scope.js";
-//# sourceMappingURL=index.js.map

package/dist/lifecycle/scope/lifecycleScope.scope.d.ts

@@ -67,4 +67,3 @@ export declare class LifecycleScope {
     private detach;
     private invalidState;
 }
-//# sourceMappingURL=lifecycleScope.scope.d.ts.map

package/dist/lifecycle/scope/lifecycleScope.scope.js

@@ -299,4 +299,3 @@ export class LifecycleScope {
         return new InvalidStateError(`Cannot ${operation} lifecycle scope "${this.name}" while state is "${this.state}".`, { scope: this.name, operation, state: this.state });
     }
 }
-//# sourceMappingURL=lifecycleScope.scope.js.map

package/dist/logging/console/consoleLogger.logger.d.ts

@@ -75,4 +75,3 @@ export declare class ConsoleLogger extends BaseLogger {
      */
     private stringifyValue;
 }
-//# sourceMappingURL=consoleLogger.logger.d.ts.map

package/dist/logging/console/consoleLogger.logger.js

@@ -3,6 +3,7 @@ import { InvalidArgumentError } from "../../errors/exceptions.js";
 import { safeLogStringify, sanitizeLogValue, serializeLogError, } from "../core/logEntry.entry.js";
 import { loggerContextFromExecution } from "../core/loggerContext.context.js";
 import { DEFAULT_LOGGER_OPTIONS, } from "../core/loggerOptions.options.js";
+import { createLogRedactor } from "../core/logRedaction.redaction.js";
 import { BaseLogger } from "../core/logger.js";
 /**
  * Logger implementation that writes structured log entries
@@ -33,10 +34,14 @@ export class ConsoleLogger extends BaseLogger {
         if (!isLogLevel(level)) {
             throw new InvalidArgumentError(`Unknown log level "${String(level)}". Expected one of: ${Object.keys(LogLevelPriority).join(", ")}.`, { level });
         }
+        // Secure by default: sensitive keys are redacted unless the caller
+        // opts out with `redact: false` or supplies its own hook. Children
+        // receive the resolved value, so they inherit whichever it is.
         this.options = {
             ...DEFAULT_LOGGER_OPTIONS,
             ...options,
             level,
+            redact: options.redact === undefined ? createLogRedactor() : options.redact,
         };
     }
     /**
@@ -51,7 +56,7 @@ export class ConsoleLogger extends BaseLogger {
         if (!shouldLog(level, this.options.level)) {
             return;
         }
-        const redact = this.options.redact;
+        const redact = this.options.redact === false ? undefined : this.options.redact;
         context = this.withExecutionContext(context);
         const entry = {
             level,
@@ -243,4 +248,3 @@ export class ConsoleLogger extends BaseLogger {
         }
     }
 }
-//# sourceMappingURL=consoleLogger.logger.js.map

package/dist/logging/console/index.d.ts

@@ -5,4 +5,3 @@
  */
 export { ConsoleLogger } from "./consoleLogger.logger.js";
 export { LoggerFactory, type LoggerFactoryOptions, type LoggerImplementation, } from "./loggerFactory.factory.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/logging/console/index.js

@@ -5,4 +5,3 @@
  */
 export { ConsoleLogger } from "./consoleLogger.logger.js";
 export { LoggerFactory, } from "./loggerFactory.factory.js";
-//# sourceMappingURL=index.js.map

package/dist/logging/console/loggerFactory.factory.d.ts

@@ -43,4 +43,3 @@ export declare class LoggerFactory {
      */
     child(logger: Logger, context: LoggerContext): Logger;
 }
-//# sourceMappingURL=loggerFactory.factory.d.ts.map

package/dist/logging/console/loggerFactory.factory.js

@@ -28,4 +28,3 @@ export class LoggerFactory {
         return logger.child(context);
     }
 }
-//# sourceMappingURL=loggerFactory.factory.js.map

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

@@ -9,4 +9,3 @@ export { createLoggerContext, loggerContextFromExecution, type LoggerContext, }
 export { serializeLogError, sanitizeLogValue, safeLogStringify, type LogEntry, type LogError, type LogErrorSerializationOptions, } from "./logEntry.entry.js";
 export { createLogRedactor, type LogRedactionHook, type LogRedactorOptions, } from "./logRedaction.redaction.js";
 export { DEFAULT_LOGGER_OPTIONS, type LoggerOptions, type LogLevelOption, } from "./loggerOptions.options.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/logging/core/index.js

@@ -9,4 +9,3 @@ export { createLoggerContext, loggerContextFromExecution, } from "./loggerContex
 export { serializeLogError, sanitizeLogValue, safeLogStringify, } from "./logEntry.entry.js";
 export { createLogRedactor, } from "./logRedaction.redaction.js";
 export { DEFAULT_LOGGER_OPTIONS, } from "./loggerOptions.options.js";
-//# sourceMappingURL=index.js.map

package/dist/logging/core/logEntry.entry.d.ts

@@ -108,4 +108,3 @@ export declare function sanitizeLogValue(value: unknown, seen?: WeakSet<object>,
  * placeholder strings.
  */
 export declare function safeLogStringify(value: unknown): string;
-//# sourceMappingURL=logEntry.entry.d.ts.map

package/dist/logging/core/logEntry.entry.js

@@ -156,4 +156,3 @@ export function safeLogStringify(value) {
         return '"[Unserializable]"';
     }
 }
-//# sourceMappingURL=logEntry.entry.js.map

package/dist/logging/core/logLevel.level.d.ts

@@ -44,4 +44,3 @@ export declare function resolveLogLevel(value: unknown): LogLevel;
  * silently disabling all logging.
  */
 export declare function shouldLog(level: LogLevel, minimumLevel: LogLevel): boolean;
-//# sourceMappingURL=logLevel.level.d.ts.map