better-effect 0.12.0 → 0.13.0

package/dist/{outcome-CB43bnFW.d.mts → outcome-DI8LPIQ4.d.mts}

@@ -1,13 +1,11 @@
-import { F as ServiceContract, H as ServiceToken, L as ServiceIdentityTypeId, M as AnyService, N as AnyServiceToken, O as InferYieldRequirements, P as ServiceClass, T as EffectRequirements, U as ServiceTokenOf, V as ServiceTagOf, a as ServiceResolver, c as RuntimeContextStorage, d as CleanupFailureDiagnostic, f as DisposableResource, h as ScopeOutcome, j as ServiceRequirement, m as ScopeFinalizer, p as MaybePromise$1, u as Scope, z as ServiceRequirements } from "./index-heuaRmXR.mjs";
+import { F as ServiceContract, H as ServiceToken, L as ServiceIdentityTypeId, M as AnyService, N as AnyServiceToken, O as InferYieldRequirements, P as ServiceClass, T as EffectRequirements, U as ServiceTokenOf, V as ServiceTagOf, a as ServiceResolver, c as RuntimeContextStorage, d as CleanupFailureDiagnostic, f as DisposableResource, h as ScopeOutcome, j as ServiceRequirement, m as ScopeFinalizer, p as MaybePromise, z as ServiceRequirements } from "./index-AiKM71-u.mjs";
+import { a as RuntimeObserver, l as MaybePromise$1, t as RuntimeExecutionAttributes } from "./observer-9nhbL7Pr.mjs";
 //#region src/internal/variance.d.ts
 /** Type-level marker for a value produced by `A`. */
 type Covariant<A> = () => A;
 /** Type-level marker that both consumes and produces `A`. */
 type Invariant<A> = (value: A) => A;
 //#endregion
-//#region src/utils/types.d.ts
-type MaybePromise<T> = T | PromiseLike<T>;
-//#endregion
 //#region src/internal/missing-dependencies.d.ts
 type MissingDependencies<Missing extends AnyService> = {
   /** Names the Services that must be supplied before execution. */
@@ -196,7 +194,7 @@ interface LayerRegistration {
    */
   readonly serviceTag?: string;
   /** Lazily acquire the Service instance; concrete types are erased at this backend boundary. */
-  readonly acquire: () => MaybePromise<unknown>;
+  readonly acquire: () => MaybePromise$1<unknown>;
 }
 /** Generator shape used by `Layer.gen` and `Layer.scopedGen`. */
 type LayerGenerator<S extends ServiceClass<any, any>, Yield extends ServiceRequirement<unknown> = ServiceRequirement<unknown>> = () => AsyncGenerator<Yield, ServiceContract<InstanceType<S>>, unknown>;
@@ -217,9 +215,9 @@ interface LayerProvider extends LayerRegistration {
   /** The tag captured before this provider can cross an asynchronous boundary. */
   readonly serviceTag: string;
   /** Provider storage deliberately erases the concrete instance type. */
-  readonly release?: (instance: unknown, outcome: ScopeOutcome) => MaybePromise<void>;
+  readonly release?: (instance: unknown, outcome: ScopeOutcome) => MaybePromise$1<void>;
   /** Capture acquisition-local cleanup without retaining the acquired instance. */
-  readonly acquireWithRelease?: () => MaybePromise<CapturedLayerAcquisition>;
+  readonly acquireWithRelease?: () => MaybePromise$1<CapturedLayerAcquisition>;
 }
 /** A Service class whose constructor can be called without arguments. */
 type DefaultConstructibleServiceClass<Tag extends string = string, Instance extends AnyService = AnyService> = ServiceClass<Tag, Instance> & (new () => Instance);
@@ -260,17 +258,17 @@ declare class Layer<in out Provided extends AnyService = AnyService, out Require
   static readonly empty: Layer<never, never>;
   /** Create a Layer that lazily acquires a Service instance. */
   static make<S extends DefaultConstructibleServiceClass<any, any>>(service: S): LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>>;
-  static make<S extends ServiceClass<any, any>>(service: S, acquire: () => MaybePromise<ServiceContract<InstanceType<S>>>): LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>>;
+  static make<S extends ServiceClass<any, any>>(service: S, acquire: () => MaybePromise$1<ServiceContract<InstanceType<S>>>): LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>>;
   /** Create a Layer from an already-constructed Service instance. */
   static succeed<S extends ServiceClass<any, any>>(service: S, instance: ServiceContract<InstanceType<S>>): LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>>;
   /** Alias a source Service under a compatible target contract. */
   static alias<From extends ServiceClass<any, any>, To extends ServiceClass<any, any>>(options: LayerAliasOptions<From, To>): LayerResult<ProviderEntry<InstanceType<To>, InstanceType<From> | ServiceRequirements<InstanceType<To>>>>;
   /** Define a provider with Runtime-root cleanup. */
-  static scoped<S extends ServiceClass<any, any>>(service: S, acquire: () => MaybePromise<ServiceContract<InstanceType<S>>>, release: (instance: InstanceType<S>, outcome: ScopeOutcome) => MaybePromise<void>): LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>>;
+  static scoped<S extends ServiceClass<any, any>>(service: S, acquire: () => MaybePromise$1<ServiceContract<InstanceType<S>>>, release: (instance: InstanceType<S>, outcome: ScopeOutcome) => MaybePromise$1<void>): LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>>;
   /** Define a provider with Runtime-root cleanup through its disposal protocol. */
-  static scopedDisposable<S extends ServiceClass<any, any>>(service: S, acquire: () => MaybePromise<ServiceContract<InstanceType<S>> & DisposableResource>): LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>>;
+  static scopedDisposable<S extends ServiceClass<any, any>>(service: S, acquire: () => MaybePromise$1<ServiceContract<InstanceType<S>> & DisposableResource>): LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>>;
   /** Define a provider whose acquisition can yield contextual Services. */
-  static scopedGen<S extends ServiceClass<any, any>, Yield extends ServiceRequirement<unknown>>(service: S, factory: LayerGenerator<S, Yield>, release: (instance: InstanceType<S>, outcome: ScopeOutcome) => MaybePromise<void>): LayerResult<ProviderEntry<InstanceType<S>, LayerGeneratorRequirements<S, Yield>>>;
+  static scopedGen<S extends ServiceClass<any, any>, Yield extends ServiceRequirement<unknown>>(service: S, factory: LayerGenerator<S, Yield>, release: (instance: InstanceType<S>, outcome: ScopeOutcome) => MaybePromise$1<void>): LayerResult<ProviderEntry<InstanceType<S>, LayerGeneratorRequirements<S, Yield>>>;
   /** Define a provider whose acquisition can yield contextual Services. */
   static gen<S extends ServiceClass<any, any>, Yield extends ServiceRequirement<unknown>>(service: S, factory: LayerGenerator<S, Yield>): LayerResult<ProviderEntry<InstanceType<S>, LayerGeneratorRequirements<S, Yield>>>;
   /** Compose Layers without replacing providers. */
@@ -308,9 +306,9 @@ type LayerBackendDisposeOptions = {
 /** Runtime adapter responsible for registering, resolving, and disposing Layer providers. */
 interface LayerBackend extends ServiceResolver {
   /** Register one Service provider with the backend. */
-  register(registration: LayerRegistration): MaybePromise<void>;
+  register(registration: LayerRegistration): MaybePromise$1<void>;
   /** Dispose all backend-owned instances and provider registrations. */
-  disposeAll(options?: LayerBackendDisposeOptions): MaybePromise<void>;
+  disposeAll(options?: LayerBackendDisposeOptions): MaybePromise$1<void>;
 }
 //#endregion
 //#region src/layer/errors.d.ts
@@ -346,59 +344,6 @@ declare class LayerGeneratorYieldError extends Error {
   constructor(service: ServiceClass<any>);
 }
 //#endregion
-//#region src/runtime/observer.d.ts
-/** Event emitted after a Service resolution attempt settles. */
-type RuntimeServiceResolveEvent = {
-  readonly service: AnyServiceToken;
-  readonly resolutionPath: readonly AnyServiceToken[];
-  readonly outcome: ScopeOutcome;
-};
-/** Event emitted after a provider acquisition attempt settles. */
-type RuntimeServiceAcquireEvent = {
-  readonly service: AnyServiceToken;
-  readonly resolutionPath: readonly AnyServiceToken[];
-  readonly outcome: ScopeOutcome;
-};
-/** Values supplied to one Runtime execution for diagnostic correlation. */
-type RuntimeExecutionAttributes = Readonly<Record<string, unknown>>;
-/** Metadata shared by the start and end events for one execution. */
-type RuntimeExecutionMetadata = {
-  readonly executionId: string;
-  readonly name?: string;
-  readonly attributes?: RuntimeExecutionAttributes;
-  /** Monotonic host timestamp captured immediately before the Program starts. */
-  readonly startedAt: number;
-};
-/** Event emitted immediately before a program starts in an execution Scope. */
-type RuntimeExecutionStartEvent = RuntimeExecutionMetadata & {
-  readonly scope: Scope;
-};
-/** Event emitted after a program and its execution Scope settle. */
-type RuntimeExecutionEndEvent = RuntimeExecutionMetadata & {
-  readonly scope: Scope;
-  readonly outcome: ScopeOutcome;
-  /** Monotonic elapsed time for the Program and its execution cleanup. */
-  readonly durationMs: number;
-};
-/** Event emitted after a Layer provider release callback settles. */
-type RuntimeResourceReleaseEvent = {
-  readonly service: AnyServiceToken;
-  readonly outcome: ScopeOutcome;
-  readonly error?: unknown;
-};
-/** Optional best-effort hooks for Runtime lifecycle and resolution events. */
-type RuntimeObserver = {
-  readonly onServiceResolve?: (event: RuntimeServiceResolveEvent) => MaybePromise<void>;
-  readonly onServiceAcquire?: (event: RuntimeServiceAcquireEvent) => MaybePromise<void>;
-  readonly onExecutionStart?: (event: RuntimeExecutionStartEvent) => MaybePromise<void>;
-  readonly onExecutionEnd?: (event: RuntimeExecutionEndEvent) => MaybePromise<void>;
-  readonly onResourceRelease?: (event: RuntimeResourceReleaseEvent) => MaybePromise<void>;
-};
-/** Compose best-effort Runtime observers into one observer. */
-declare const RuntimeObserver: {
-  compose: (...observers: readonly RuntimeObserver[]) => RuntimeObserver;
-};
-//#endregion
 //#region src/runtime/outcome.d.ts
 /** Aggregated cleanup information reported during Runtime shutdown. */
 type RuntimeShutdownDiagnostic = {
@@ -408,7 +353,7 @@ type RuntimeShutdownDiagnostic = {
   readonly error: LayerDisposeError;
 };
 /** Observer notified about cleanup failures without changing primary results. */
-type CleanupFailureObserver = (diagnostic: CleanupFailureDiagnostic | RuntimeShutdownDiagnostic) => MaybePromise$1<void>;
+type CleanupFailureObserver = (diagnostic: CleanupFailureDiagnostic | RuntimeShutdownDiagnostic) => MaybePromise<void>;
 /** Optional Runtime configuration for cleanup diagnostics. */
 type RuntimeOptions = {
   /** Backend used to register and resolve the Layer. Defaults to MapLayerBackend. */
@@ -438,5 +383,5 @@ type RuntimeDisposeOptions = {
   readonly abortAfterGracePeriod?: boolean;
 };
 //#endregion
-export { MissingServices as A, CompleteExecution as C, LayerInput as D, ExecutionMissing as E, ValidateOneOverride as F, ValidateOverrides as I, ValidateOverridesWitness as L, ProvidedEnvironment as M, RequiredEnvironment as N, LayerInputState as O, ValidateLayerInput as P, ProviderEntry as R, LayerRegistration as S, CompleteInput as T, LayerRegistrationError as _, RuntimeShutdownDiagnostic as a, LayerBackendDisposeOptions as b, RuntimeExecutionMetadata as c, RuntimeResourceReleaseEvent as d, RuntimeServiceAcquireEvent as f, LayerGeneratorYieldError as g, LayerDisposeError as h, RuntimeRunOptions as i, OverrideLayerResult as j, LayerResult as k, RuntimeExecutionStartEvent as l, DuplicateServiceError as m, RuntimeDisposeOptions as n, RuntimeExecutionAttributes as o, RuntimeServiceResolveEvent as p, RuntimeOptions as r, RuntimeExecutionEndEvent as s, CleanupFailureObserver as t, RuntimeObserver as u, ServiceTagCollisionError as v, CompleteExecutionLayer as w, Layer as x, LayerBackend as y, MissingDependencies as z };
-//# sourceMappingURL=outcome-CB43bnFW.d.mts.map
+export { ProviderEntry as A, OverrideLayerResult as C, ValidateOneOverride as D, ValidateLayerInput as E, ValidateOverrides as O, MissingServices as S, RequiredEnvironment as T, CompleteInput as _, RuntimeShutdownDiagnostic as a, LayerInputState as b, LayerGeneratorYieldError as c, LayerBackend as d, LayerBackendDisposeOptions as f, CompleteExecutionLayer as g, CompleteExecution as h, RuntimeRunOptions as i, MissingDependencies as j, ValidateOverridesWitness as k, LayerRegistrationError as l, LayerRegistration as m, RuntimeDisposeOptions as n, DuplicateServiceError as o, Layer as p, RuntimeOptions as r, LayerDisposeError as s, CleanupFailureObserver as t, ServiceTagCollisionError as u, ExecutionMissing as v, ProvidedEnvironment as w, LayerResult as x, LayerInput as y };
+//# sourceMappingURL=outcome-DI8LPIQ4.d.mts.map

package/dist/outcome-DI8LPIQ4.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome-DI8LPIQ4.d.mts","names":[],"sources":["../src/internal/variance.ts","../src/internal/missing-dependencies.ts","../src/layer/metadata.ts","../src/layer/inference.ts","../src/layer/types.ts","../src/layer/layer.ts","../src/layer/backend.ts","../src/layer/errors.ts","../src/runtime/outcome.ts"],"mappings":"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"}

package/dist/{program-metadata-DhQCCirO.mjs → program-metadata-BxjGkT17.mjs}

@@ -1,5 +1,5 @@
-import { h as RuntimeContextNotConfiguredError, i as getRuntimeContext, l as makeRuntimeContext, n as currentRuntimeContext, t as activeRuntimeContextStorage, u as runRuntimeContext } from "./context-BUEf1qjL.mjs";
-import { a as ResourceNotDisposableError, c as ScopeRuntimeNotConfiguredError, i as getDisposeFinalizer, o as ScopeCloseError, s as ScopeClosedError } from "./signal-D2UTcaaG.mjs";
+import { h as RuntimeContextNotConfiguredError, i as getRuntimeContext, l as makeRuntimeContext, n as currentRuntimeContext, t as activeRuntimeContextStorage, u as runRuntimeContext } from "./context-BphfFUMO.mjs";
+import { a as ScopeClosedError, i as ScopeCloseError, n as getDisposeFinalizer, o as ScopeRuntimeNotConfiguredError, r as ResourceNotDisposableError } from "./disposable-CP-Q2H3l.mjs";
 //#region src/scope/runtime.ts
 const scopeStorages = /* @__PURE__ */ new WeakMap();
 /** Bridges the current Scope through async execution context. */
@@ -257,4 +257,4 @@ const inheritProgramName = (source, derived) => {
 //#endregion
 export { runScoped as a, Scope as i, inheritProgramName as n, ScopeRuntime as o, setProgramName as r, getProgramName as t };
 
-//# sourceMappingURL=program-metadata-DhQCCirO.mjs.map
+//# sourceMappingURL=program-metadata-BxjGkT17.mjs.map

package/dist/{program-metadata-DhQCCirO.mjs.map → program-metadata-BxjGkT17.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"program-metadata-DhQCCirO.mjs","names":[],"sources":["../src/scope/runtime.ts","../src/scope/internal.ts","../src/scope/scope.ts","../src/effect/program-metadata.ts"],"sourcesContent":["import { ScopeRuntimeNotConfiguredError } from './errors'\n\nimport { RuntimeContextNotConfiguredError } from '../runtime/errors'\n\nimport type { Scope } from './scope'\n\nimport {\n  activeRuntimeContextStorage,\n  currentRuntimeContext,\n  getRuntimeContext,\n  makeRuntimeContext,\n  runRuntimeContext\n} from '../runtime/context'\n\nimport type { RuntimeContextStorage } from '../runtime/context'\n\nconst scopeStorages = new WeakMap<object, RuntimeContextStorage>()\n\n/** Bridges the current Scope through async execution context. */\nexport class ScopeRuntime {\n  /** Supply a Scope while invoking a callback. */\n  static run<A>(\n    scope: Scope,\n    program: () => A,\n    storage: RuntimeContextStorage = scopeStorages.get(scope) ?? activeRuntimeContextStorage()\n  ): A {\n    scopeStorages.set(scope, storage)\n\n    const current = getRuntimeContext(storage)\n    const context = makeRuntimeContext(\n      current?.resolver,\n      scope,\n      current?.resolutionPath ?? [],\n      current?.signal,\n      current\n    )\n\n    return runRuntimeContext(storage, context, program)\n  }\n\n  /** Return the Scope active in the current execution context. */\n  static current(): Scope {\n    let context\n\n    try {\n      context = currentRuntimeContext()\n    } catch (cause) {\n      if (cause instanceof RuntimeContextNotConfiguredError) {\n        throw new ScopeRuntimeNotConfiguredError()\n      }\n\n      throw cause\n    }\n\n    if (!context.scope) {\n      throw new ScopeRuntimeNotConfiguredError()\n    }\n\n    return context.scope\n  }\n\n  /** Associate a Runtime-owned Scope with its context storage. */\n  static bind(scope: Scope, storage: RuntimeContextStorage): void {\n    scopeStorages.set(scope, storage)\n  }\n}\n","import { ScopeCloseError } from './errors'\n\nimport { ScopeRuntime } from './runtime'\n\nimport type { CloseableScope } from './scope'\n\nimport {\n  runRuntimeContext,\n  type CompleteRuntimeContext,\n  type RuntimeContextStorage\n} from '../runtime/context'\n\nimport type { CleanupFailureDiagnostic, MaybePromise, ScopeOutcome } from './types'\n\nexport type OutcomeClassifier<A> = (value: A) => ScopeOutcome\n\nexport type RunScopedOptions<A> = {\n  readonly classify: OutcomeClassifier<A>\n  readonly onOutcome?: (outcome: ScopeOutcome) => void\n  readonly onCleanupFailure?: (diagnostic: CleanupFailureDiagnostic) => MaybePromise<void>\n  readonly contextStorage?: RuntimeContextStorage\n  readonly context?: CompleteRuntimeContext\n}\n\nconst notifyCleanupFailure = async (\n  observer: ((diagnostic: CleanupFailureDiagnostic) => MaybePromise<void>) | undefined,\n  diagnostic: CleanupFailureDiagnostic\n): Promise<void> => {\n  if (!observer) {\n    return\n  }\n\n  try {\n    await observer(diagnostic)\n  } catch {\n    // Cleanup diagnostics are best effort and never affect the primary result.\n  }\n}\n\nexport const runScoped = async <A>(\n  scope: CloseableScope,\n  program: () => A | PromiseLike<A>,\n  options: RunScopedOptions<Awaited<A>>\n): Promise<Awaited<A>> => {\n  let value!: Awaited<A>\n\n  let programFailed = false\n  let programFailure: unknown\n\n  try {\n    const run = () => ScopeRuntime.run(scope, program, options.contextStorage)\n\n    value = await (options.context && options.contextStorage\n      ? runRuntimeContext(options.contextStorage, options.context, run)\n      : run())\n  } catch (cause) {\n    programFailed = true\n    programFailure = cause\n  }\n\n  let outcome: ScopeOutcome\n  let outcomeStatus: ScopeOutcome['status']\n\n  if (programFailed) {\n    outcome = {\n      status: 'failure',\n      cause: programFailure\n    }\n    outcomeStatus = 'failure'\n  } else {\n    try {\n      outcome = options.classify(value)\n      // Read the discriminant before cleanup so a throwing classifier or proxy is a program failure.\n      outcomeStatus = outcome.status\n    } catch (cause) {\n      programFailed = true\n      programFailure = cause\n      outcome = {\n        status: 'failure',\n        cause\n      }\n      outcomeStatus = 'failure'\n    }\n  }\n\n  options.onOutcome?.(outcome)\n\n  let cleanupFailed = false\n  let cleanupFailure: unknown\n\n  try {\n    await scope.close(outcome)\n  } catch (cause) {\n    cleanupFailed = true\n    cleanupFailure = cause\n  }\n\n  if (cleanupFailed) {\n    const error =\n      cleanupFailure instanceof ScopeCloseError\n        ? cleanupFailure\n        : new ScopeCloseError([cleanupFailure])\n\n    await notifyCleanupFailure(options.onCleanupFailure, {\n      outcome,\n      error\n    })\n\n    cleanupFailure = error\n  }\n\n  if (programFailed) {\n    throw programFailure\n  }\n\n  if (outcomeStatus === 'failure') {\n    return value\n  }\n\n  if (cleanupFailed) {\n    throw cleanupFailure\n  }\n\n  return value\n}\n","import { ResourceNotDisposableError, ScopeCloseError, ScopeClosedError } from './errors'\n\nimport { getDisposeFinalizer } from './disposable'\n\nimport { runScoped } from './internal'\n\nimport { ScopeRuntime } from './runtime'\n\nimport type { DisposableResource, MaybePromise, ScopeFinalizer, ScopeOutcome } from './types'\n\n/**\n * Non-owning lifecycle context for finalizers and child Scopes.\n *\n * A Scope can register cleanup and create children, but it cannot close\n * itself. Use `Scope.make()` or `Scope.run()` when your code owns the Scope.\n */\nexport interface Scope {\n  /** Register a finalizer that runs when the owning Scope closes. */\n  addFinalizer(finalizer: ScopeFinalizer): void\n\n  /** Acquire a resource and register its outcome-aware release callback. */\n  acquire<R>(\n    acquire: () => MaybePromise<R>,\n    release: (resource: R, outcome: ScopeOutcome) => MaybePromise<void>\n  ): Promise<R>\n\n  /** Register an already-acquired disposable resource. */\n  add<R extends DisposableResource>(resource: R): Promise<R>\n\n  /** Create a child Scope owned by this Scope. */\n  fork(): CloseableScope\n}\n\n/** A Scope whose owner is responsible for calling `close()`. */\nexport interface CloseableScope extends Scope {\n  /** Close the Scope and run children and finalizers in child-first LIFO order. */\n  close(outcome?: ScopeOutcome): Promise<void>\n}\n\nconst SCOPE_SUCCESS: ScopeOutcome = Object.freeze({ status: 'success' })\n\nclass ScopeImpl implements CloseableScope {\n  private readonly children = new Set<ScopeImpl>()\n\n  private readonly finalizers: ScopeFinalizer[] = []\n\n  private closePromise: Promise<void> | undefined\n\n  private closeOutcome: ScopeOutcome | undefined\n\n  constructor(private parent?: ScopeImpl) {}\n\n  fork(): CloseableScope {\n    this.assertOpen()\n\n    const child = new ScopeImpl(this)\n\n    this.children.add(child)\n\n    return child\n  }\n\n  addFinalizer(finalizer: ScopeFinalizer): void {\n    this.assertOpen()\n\n    this.finalizers.push(finalizer)\n  }\n\n  async acquire<R>(\n    acquire: () => MaybePromise<R>,\n    release: (resource: R, outcome: ScopeOutcome) => MaybePromise<void>\n  ): Promise<R> {\n    this.assertOpen()\n\n    const resource = await acquire()\n\n    try {\n      this.addFinalizer((outcome) => release(resource, outcome))\n\n      return resource\n    } catch (scopeFailure) {\n      try {\n        await release(resource, this.closeOutcome ?? SCOPE_SUCCESS)\n      } catch (releaseFailure) {\n        throw new AggregateError(\n          [scopeFailure, releaseFailure],\n          'Scope closed while acquiring a resource and immediate cleanup also failed'\n        )\n      }\n\n      throw scopeFailure\n    }\n  }\n\n  async add<R extends DisposableResource>(resource: R): Promise<R> {\n    const finalizer = getDisposeFinalizer(resource)\n\n    if (!finalizer) {\n      throw new ResourceNotDisposableError()\n    }\n\n    try {\n      this.addFinalizer(finalizer)\n\n      return resource\n    } catch (scopeFailure) {\n      try {\n        await finalizer(this.closeOutcome ?? SCOPE_SUCCESS)\n      } catch (releaseFailure) {\n        throw new AggregateError(\n          [scopeFailure, releaseFailure],\n          'Scope closed while adding a disposable resource and cleanup also failed'\n        )\n      }\n\n      throw scopeFailure\n    }\n  }\n\n  close(outcome: ScopeOutcome = SCOPE_SUCCESS): Promise<void> {\n    if (this.closePromise) {\n      return this.closePromise\n    }\n\n    this.closeOutcome = outcome\n    this.closePromise = Promise.resolve().then(() => this.closeWithRuntime(outcome))\n\n    return this.closePromise\n  }\n\n  private async closeWithRuntime(outcome: ScopeOutcome): Promise<void> {\n    let started = false\n\n    try {\n      await ScopeRuntime.run(this, () => {\n        started = true\n        return this.closeInternal(outcome)\n      })\n    } catch (storageFailure) {\n      if (started) {\n        throw storageFailure\n      }\n\n      // Context propagation cannot prevent direct Scope cleanup.\n      try {\n        await this.closeInternal(outcome)\n      } catch (cleanupFailure) {\n        const cleanupCauses =\n          cleanupFailure instanceof ScopeCloseError ? cleanupFailure.causes : [cleanupFailure]\n\n        throw new ScopeCloseError([storageFailure, ...cleanupCauses])\n      }\n\n      throw storageFailure\n    }\n  }\n\n  private async closeInternal(outcome: ScopeOutcome): Promise<void> {\n    const failures: unknown[] = []\n\n    const children = [...this.children]\n\n    this.children.clear()\n\n    for (let index = children.length - 1; index >= 0; index--) {\n      const child = children[index]\n\n      if (!child) {\n        continue\n      }\n\n      try {\n        await child.close(outcome)\n      } catch (cause) {\n        if (cause instanceof ScopeCloseError) {\n          failures.push(...cause.causes)\n        } else {\n          failures.push(cause)\n        }\n      }\n    }\n\n    for (let index = this.finalizers.length - 1; index >= 0; index--) {\n      const finalizer = this.finalizers[index]\n\n      if (!finalizer) {\n        continue\n      }\n\n      try {\n        await finalizer(outcome)\n      } catch (cause) {\n        failures.push(cause)\n      }\n    }\n\n    this.finalizers.length = 0\n\n    this.detach()\n\n    if (failures.length > 0) {\n      throw new ScopeCloseError(failures)\n    }\n  }\n\n  private detach(): void {\n    const parent = this.parent\n\n    if (!parent) {\n      return\n    }\n\n    parent.children.delete(this)\n    this.parent = undefined\n  }\n\n  private assertOpen(): void {\n    if (this.closePromise) {\n      throw new ScopeClosedError()\n    }\n  }\n}\n\nexport const Scope = {\n  /** Create an owned, initially open Scope. */\n  make(): CloseableScope {\n    return new ScopeImpl()\n  },\n\n  /** Return the non-owning Scope available in the current execution context. */\n  current(): Scope {\n    return ScopeRuntime.current()\n  },\n\n  /** Run a callback with an existing Scope supplied as the current context. */\n  provide<A>(scope: Scope, program: () => A): A {\n    return ScopeRuntime.run(scope, program)\n  },\n\n  /** Resolve the current Scope through `yield* Scope` inside an Effect. */\n  // oxlint-disable-next-line require-yield\n  *[Symbol.iterator](): Generator<never, Scope, unknown> {\n    return ScopeRuntime.current()\n  },\n\n  /**\n   * Run a program in a newly owned Scope.\n   *\n   * Scope is independent from `better-result`, so returned values—including\n   * `Result.err`—close this Scope with a successful outcome. Result-aware\n   * outcome classification belongs to `Runtime.run`.\n   *\n   * @example\n   * ```ts\n   * await Scope.run(async (scope) => {\n   *   const connection = await scope.acquire(connect, (connection) => connection.close())\n   *   return connection.query()\n   * })\n   * ```\n   */\n  run<A>(program: (scope: Scope) => A | PromiseLike<A>): Promise<Awaited<A>> {\n    const scope = new ScopeImpl()\n\n    return runScoped(scope, () => program(scope), {\n      classify: () => SCOPE_SUCCESS\n    })\n  }\n} as const\n\n/** Type-level aliases for Scope ownership, outcomes, and cleanup contracts. */\nexport declare namespace Scope {\n  /** A Scope whose owner is responsible for calling `close()`. */\n  export type Closeable = CloseableScope\n\n  /** The outcome supplied to Scope finalizers and resource releases. */\n  export type Outcome = ScopeOutcome\n\n  /** A cleanup callback registered with a Scope. */\n  export type Finalizer = ScopeFinalizer\n\n  /** A value implementing a JavaScript disposal protocol. */\n  export type Disposable = DisposableResource\n}\n","export type ProgramIdentity = (...arguments_: never[]) => void\n\nconst programNames = new WeakMap<ProgramIdentity, string>()\n\n/** Return the private diagnostic name attached to a callable Program. */\nexport const getProgramName = (program: ProgramIdentity): string | undefined =>\n  programNames.get(program)\n\n/** Attach a name without changing the callable Program facade. */\nexport const setProgramName = <Program extends ProgramIdentity>(\n  program: Program,\n  name: string\n): Program => {\n  programNames.set(program, name)\n  return program\n}\n\n/** Copy a source Program's name to a lazily-created derived Program. */\nexport const inheritProgramName = <Source extends ProgramIdentity, Derived extends ProgramIdentity>(\n  source: Source,\n  derived: Derived\n): Derived => {\n  const name = getProgramName(source)\n\n  return name === undefined ? derived : setProgramName(derived, name)\n}\n"],"mappings":"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"}
+{"version":3,"file":"program-metadata-BxjGkT17.mjs","names":[],"sources":["../src/scope/runtime.ts","../src/scope/internal.ts","../src/scope/scope.ts","../src/effect/program-metadata.ts"],"sourcesContent":["import { ScopeRuntimeNotConfiguredError } from './errors'\n\nimport { RuntimeContextNotConfiguredError } from '../runtime/errors'\n\nimport type { Scope } from './scope'\n\nimport {\n  activeRuntimeContextStorage,\n  currentRuntimeContext,\n  getRuntimeContext,\n  makeRuntimeContext,\n  runRuntimeContext\n} from '../runtime/context'\n\nimport type { RuntimeContextStorage } from '../runtime/context'\n\nconst scopeStorages = new WeakMap<object, RuntimeContextStorage>()\n\n/** Bridges the current Scope through async execution context. */\nexport class ScopeRuntime {\n  /** Supply a Scope while invoking a callback. */\n  static run<A>(\n    scope: Scope,\n    program: () => A,\n    storage: RuntimeContextStorage = scopeStorages.get(scope) ?? activeRuntimeContextStorage()\n  ): A {\n    scopeStorages.set(scope, storage)\n\n    const current = getRuntimeContext(storage)\n    const context = makeRuntimeContext(\n      current?.resolver,\n      scope,\n      current?.resolutionPath ?? [],\n      current?.signal,\n      current\n    )\n\n    return runRuntimeContext(storage, context, program)\n  }\n\n  /** Return the Scope active in the current execution context. */\n  static current(): Scope {\n    let context\n\n    try {\n      context = currentRuntimeContext()\n    } catch (cause) {\n      if (cause instanceof RuntimeContextNotConfiguredError) {\n        throw new ScopeRuntimeNotConfiguredError()\n      }\n\n      throw cause\n    }\n\n    if (!context.scope) {\n      throw new ScopeRuntimeNotConfiguredError()\n    }\n\n    return context.scope\n  }\n\n  /** Associate a Runtime-owned Scope with its context storage. */\n  static bind(scope: Scope, storage: RuntimeContextStorage): void {\n    scopeStorages.set(scope, storage)\n  }\n}\n","import { ScopeCloseError } from './errors'\n\nimport { ScopeRuntime } from './runtime'\n\nimport type { CloseableScope } from './scope'\n\nimport {\n  runRuntimeContext,\n  type CompleteRuntimeContext,\n  type RuntimeContextStorage\n} from '../runtime/context'\n\nimport type { CleanupFailureDiagnostic, MaybePromise, ScopeOutcome } from './types'\n\nexport type OutcomeClassifier<A> = (value: A) => ScopeOutcome\n\nexport type RunScopedOptions<A> = {\n  readonly classify: OutcomeClassifier<A>\n  readonly onOutcome?: (outcome: ScopeOutcome) => void\n  readonly onCleanupFailure?: (diagnostic: CleanupFailureDiagnostic) => MaybePromise<void>\n  readonly contextStorage?: RuntimeContextStorage\n  readonly context?: CompleteRuntimeContext\n}\n\nconst notifyCleanupFailure = async (\n  observer: ((diagnostic: CleanupFailureDiagnostic) => MaybePromise<void>) | undefined,\n  diagnostic: CleanupFailureDiagnostic\n): Promise<void> => {\n  if (!observer) {\n    return\n  }\n\n  try {\n    await observer(diagnostic)\n  } catch {\n    // Cleanup diagnostics are best effort and never affect the primary result.\n  }\n}\n\nexport const runScoped = async <A>(\n  scope: CloseableScope,\n  program: () => A | PromiseLike<A>,\n  options: RunScopedOptions<Awaited<A>>\n): Promise<Awaited<A>> => {\n  let value!: Awaited<A>\n\n  let programFailed = false\n  let programFailure: unknown\n\n  try {\n    const run = () => ScopeRuntime.run(scope, program, options.contextStorage)\n\n    value = await (options.context && options.contextStorage\n      ? runRuntimeContext(options.contextStorage, options.context, run)\n      : run())\n  } catch (cause) {\n    programFailed = true\n    programFailure = cause\n  }\n\n  let outcome: ScopeOutcome\n  let outcomeStatus: ScopeOutcome['status']\n\n  if (programFailed) {\n    outcome = {\n      status: 'failure',\n      cause: programFailure\n    }\n    outcomeStatus = 'failure'\n  } else {\n    try {\n      outcome = options.classify(value)\n      // Read the discriminant before cleanup so a throwing classifier or proxy is a program failure.\n      outcomeStatus = outcome.status\n    } catch (cause) {\n      programFailed = true\n      programFailure = cause\n      outcome = {\n        status: 'failure',\n        cause\n      }\n      outcomeStatus = 'failure'\n    }\n  }\n\n  options.onOutcome?.(outcome)\n\n  let cleanupFailed = false\n  let cleanupFailure: unknown\n\n  try {\n    await scope.close(outcome)\n  } catch (cause) {\n    cleanupFailed = true\n    cleanupFailure = cause\n  }\n\n  if (cleanupFailed) {\n    const error =\n      cleanupFailure instanceof ScopeCloseError\n        ? cleanupFailure\n        : new ScopeCloseError([cleanupFailure])\n\n    await notifyCleanupFailure(options.onCleanupFailure, {\n      outcome,\n      error\n    })\n\n    cleanupFailure = error\n  }\n\n  if (programFailed) {\n    throw programFailure\n  }\n\n  if (outcomeStatus === 'failure') {\n    return value\n  }\n\n  if (cleanupFailed) {\n    throw cleanupFailure\n  }\n\n  return value\n}\n","import { ResourceNotDisposableError, ScopeCloseError, ScopeClosedError } from './errors'\n\nimport { getDisposeFinalizer } from './disposable'\n\nimport { runScoped } from './internal'\n\nimport { ScopeRuntime } from './runtime'\n\nimport type { DisposableResource, MaybePromise, ScopeFinalizer, ScopeOutcome } from './types'\n\n/**\n * Non-owning lifecycle context for finalizers and child Scopes.\n *\n * A Scope can register cleanup and create children, but it cannot close\n * itself. Use `Scope.make()` or `Scope.run()` when your code owns the Scope.\n */\nexport interface Scope {\n  /** Register a finalizer that runs when the owning Scope closes. */\n  addFinalizer(finalizer: ScopeFinalizer): void\n\n  /** Acquire a resource and register its outcome-aware release callback. */\n  acquire<R>(\n    acquire: () => MaybePromise<R>,\n    release: (resource: R, outcome: ScopeOutcome) => MaybePromise<void>\n  ): Promise<R>\n\n  /** Register an already-acquired disposable resource. */\n  add<R extends DisposableResource>(resource: R): Promise<R>\n\n  /** Create a child Scope owned by this Scope. */\n  fork(): CloseableScope\n}\n\n/** A Scope whose owner is responsible for calling `close()`. */\nexport interface CloseableScope extends Scope {\n  /** Close the Scope and run children and finalizers in child-first LIFO order. */\n  close(outcome?: ScopeOutcome): Promise<void>\n}\n\nconst SCOPE_SUCCESS: ScopeOutcome = Object.freeze({ status: 'success' })\n\nclass ScopeImpl implements CloseableScope {\n  private readonly children = new Set<ScopeImpl>()\n\n  private readonly finalizers: ScopeFinalizer[] = []\n\n  private closePromise: Promise<void> | undefined\n\n  private closeOutcome: ScopeOutcome | undefined\n\n  constructor(private parent?: ScopeImpl) {}\n\n  fork(): CloseableScope {\n    this.assertOpen()\n\n    const child = new ScopeImpl(this)\n\n    this.children.add(child)\n\n    return child\n  }\n\n  addFinalizer(finalizer: ScopeFinalizer): void {\n    this.assertOpen()\n\n    this.finalizers.push(finalizer)\n  }\n\n  async acquire<R>(\n    acquire: () => MaybePromise<R>,\n    release: (resource: R, outcome: ScopeOutcome) => MaybePromise<void>\n  ): Promise<R> {\n    this.assertOpen()\n\n    const resource = await acquire()\n\n    try {\n      this.addFinalizer((outcome) => release(resource, outcome))\n\n      return resource\n    } catch (scopeFailure) {\n      try {\n        await release(resource, this.closeOutcome ?? SCOPE_SUCCESS)\n      } catch (releaseFailure) {\n        throw new AggregateError(\n          [scopeFailure, releaseFailure],\n          'Scope closed while acquiring a resource and immediate cleanup also failed'\n        )\n      }\n\n      throw scopeFailure\n    }\n  }\n\n  async add<R extends DisposableResource>(resource: R): Promise<R> {\n    const finalizer = getDisposeFinalizer(resource)\n\n    if (!finalizer) {\n      throw new ResourceNotDisposableError()\n    }\n\n    try {\n      this.addFinalizer(finalizer)\n\n      return resource\n    } catch (scopeFailure) {\n      try {\n        await finalizer(this.closeOutcome ?? SCOPE_SUCCESS)\n      } catch (releaseFailure) {\n        throw new AggregateError(\n          [scopeFailure, releaseFailure],\n          'Scope closed while adding a disposable resource and cleanup also failed'\n        )\n      }\n\n      throw scopeFailure\n    }\n  }\n\n  close(outcome: ScopeOutcome = SCOPE_SUCCESS): Promise<void> {\n    if (this.closePromise) {\n      return this.closePromise\n    }\n\n    this.closeOutcome = outcome\n    this.closePromise = Promise.resolve().then(() => this.closeWithRuntime(outcome))\n\n    return this.closePromise\n  }\n\n  private async closeWithRuntime(outcome: ScopeOutcome): Promise<void> {\n    let started = false\n\n    try {\n      await ScopeRuntime.run(this, () => {\n        started = true\n        return this.closeInternal(outcome)\n      })\n    } catch (storageFailure) {\n      if (started) {\n        throw storageFailure\n      }\n\n      // Context propagation cannot prevent direct Scope cleanup.\n      try {\n        await this.closeInternal(outcome)\n      } catch (cleanupFailure) {\n        const cleanupCauses =\n          cleanupFailure instanceof ScopeCloseError ? cleanupFailure.causes : [cleanupFailure]\n\n        throw new ScopeCloseError([storageFailure, ...cleanupCauses])\n      }\n\n      throw storageFailure\n    }\n  }\n\n  private async closeInternal(outcome: ScopeOutcome): Promise<void> {\n    const failures: unknown[] = []\n\n    const children = [...this.children]\n\n    this.children.clear()\n\n    for (let index = children.length - 1; index >= 0; index--) {\n      const child = children[index]\n\n      if (!child) {\n        continue\n      }\n\n      try {\n        await child.close(outcome)\n      } catch (cause) {\n        if (cause instanceof ScopeCloseError) {\n          failures.push(...cause.causes)\n        } else {\n          failures.push(cause)\n        }\n      }\n    }\n\n    for (let index = this.finalizers.length - 1; index >= 0; index--) {\n      const finalizer = this.finalizers[index]\n\n      if (!finalizer) {\n        continue\n      }\n\n      try {\n        await finalizer(outcome)\n      } catch (cause) {\n        failures.push(cause)\n      }\n    }\n\n    this.finalizers.length = 0\n\n    this.detach()\n\n    if (failures.length > 0) {\n      throw new ScopeCloseError(failures)\n    }\n  }\n\n  private detach(): void {\n    const parent = this.parent\n\n    if (!parent) {\n      return\n    }\n\n    parent.children.delete(this)\n    this.parent = undefined\n  }\n\n  private assertOpen(): void {\n    if (this.closePromise) {\n      throw new ScopeClosedError()\n    }\n  }\n}\n\nexport const Scope = {\n  /** Create an owned, initially open Scope. */\n  make(): CloseableScope {\n    return new ScopeImpl()\n  },\n\n  /** Return the non-owning Scope available in the current execution context. */\n  current(): Scope {\n    return ScopeRuntime.current()\n  },\n\n  /** Run a callback with an existing Scope supplied as the current context. */\n  provide<A>(scope: Scope, program: () => A): A {\n    return ScopeRuntime.run(scope, program)\n  },\n\n  /** Resolve the current Scope through `yield* Scope` inside an Effect. */\n  // oxlint-disable-next-line require-yield\n  *[Symbol.iterator](): Generator<never, Scope, unknown> {\n    return ScopeRuntime.current()\n  },\n\n  /**\n   * Run a program in a newly owned Scope.\n   *\n   * Scope is independent from `better-result`, so returned values—including\n   * `Result.err`—close this Scope with a successful outcome. Result-aware\n   * outcome classification belongs to `Runtime.run`.\n   *\n   * @example\n   * ```ts\n   * await Scope.run(async (scope) => {\n   *   const connection = await scope.acquire(connect, (connection) => connection.close())\n   *   return connection.query()\n   * })\n   * ```\n   */\n  run<A>(program: (scope: Scope) => A | PromiseLike<A>): Promise<Awaited<A>> {\n    const scope = new ScopeImpl()\n\n    return runScoped(scope, () => program(scope), {\n      classify: () => SCOPE_SUCCESS\n    })\n  }\n} as const\n\n/** Type-level aliases for Scope ownership, outcomes, and cleanup contracts. */\nexport declare namespace Scope {\n  /** A Scope whose owner is responsible for calling `close()`. */\n  export type Closeable = CloseableScope\n\n  /** The outcome supplied to Scope finalizers and resource releases. */\n  export type Outcome = ScopeOutcome\n\n  /** A cleanup callback registered with a Scope. */\n  export type Finalizer = ScopeFinalizer\n\n  /** A value implementing a JavaScript disposal protocol. */\n  export type Disposable = DisposableResource\n}\n","export type ProgramIdentity = (...arguments_: never[]) => void\n\nconst programNames = new WeakMap<ProgramIdentity, string>()\n\n/** Return the private diagnostic name attached to a callable Program. */\nexport const getProgramName = (program: ProgramIdentity): string | undefined =>\n  programNames.get(program)\n\n/** Attach a name without changing the callable Program facade. */\nexport const setProgramName = <Program extends ProgramIdentity>(\n  program: Program,\n  name: string\n): Program => {\n  programNames.set(program, name)\n  return program\n}\n\n/** Copy a source Program's name to a lazily-created derived Program. */\nexport const inheritProgramName = <Source extends ProgramIdentity, Derived extends ProgramIdentity>(\n  source: Source,\n  derived: Derived\n): Derived => {\n  const name = getProgramName(source)\n\n  return name === undefined ? derived : setProgramName(derived, name)\n}\n"],"mappings":"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"}

package/dist/runtime/explicit.d.mts

@@ -1,4 +1,4 @@
-import { c as RuntimeContextStorage, s as RuntimeContext } from "../index-heuaRmXR.mjs";
+import { c as RuntimeContextStorage, s as RuntimeContext } from "../index-AiKM71-u.mjs";
 import { n as RuntimeContextOverlapError, t as RuntimeContextNotConfiguredError } from "../errors-BKcsQ0ip.mjs";
 //#region src/runtime/explicit.d.ts
 /**

package/dist/runtime/explicit.mjs

@@ -1,4 +1,4 @@
-import { a as getRuntimeContextLineage, c as isRuntimeContextFrameCarrierInstalled, g as RuntimeContextOverlapError, h as RuntimeContextNotConfiguredError, m as withActiveRuntimeContextStorage, o as inheritRuntimeContextLineage, p as setRuntimeContextLineage, r as currentRuntimeContextFrame, s as isDerivedRuntimeContext } from "../context-BUEf1qjL.mjs";
+import { a as getRuntimeContextLineage, c as isRuntimeContextFrameCarrierInstalled, g as RuntimeContextOverlapError, h as RuntimeContextNotConfiguredError, m as withActiveRuntimeContextStorage, o as inheritRuntimeContextLineage, p as setRuntimeContextLineage, r as currentRuntimeContextFrame, s as isDerivedRuntimeContext } from "../context-BphfFUMO.mjs";
 import { t as isPromiseLike } from "../runtime-CDcCF5cb.mjs";
 //#region src/runtime/explicit.ts
 let fallbackRootLease = false;

package/dist/runtime/node.d.mts

@@ -1,4 +1,4 @@
-import { c as RuntimeContextStorage, s as RuntimeContext } from "../index-heuaRmXR.mjs";
+import { c as RuntimeContextStorage, s as RuntimeContext } from "../index-AiKM71-u.mjs";
 import { t as RuntimeContextNotConfiguredError } from "../errors-BKcsQ0ip.mjs";
-import { n as nodeRuntimeContextStorage, t as NodeRuntimeContextStorage } from "../node-context-DWsCUBRa.mjs";
+import { n as nodeRuntimeContextStorage, t as NodeRuntimeContextStorage } from "../node-context-DczjAcrX.mjs";
 export { NodeRuntimeContextStorage, type RuntimeContext, RuntimeContextNotConfiguredError, type RuntimeContextStorage, nodeRuntimeContextStorage };

package/dist/runtime/node.mjs

@@ -1,3 +1,3 @@
-import { h as RuntimeContextNotConfiguredError } from "../context-BUEf1qjL.mjs";
-import { n as nodeRuntimeContextStorage, t as NodeRuntimeContextStorage } from "../node-context-lggRF4bR.mjs";
+import { h as RuntimeContextNotConfiguredError } from "../context-BphfFUMO.mjs";
+import { n as nodeRuntimeContextStorage, t as NodeRuntimeContextStorage } from "../node-context-Ca18oNSg.mjs";
 export { NodeRuntimeContextStorage, RuntimeContextNotConfiguredError, nodeRuntimeContextStorage };

package/dist/{runtime-CBMrX8Wl.mjs → runtime-C_55ofnL.mjs}

@@ -1,8 +1,9 @@
 import { c as CircularDependencyError, f as captureServiceTag, i as LayerDisposeError, l as ServiceAcquisitionError, n as normalizeLayerRegistration, o as LayerRegistrationError, r as DuplicateServiceError, s as ServiceTagCollisionError, t as captureLayerRegistrationTag, u as ServiceNotFoundError } from "./registration-drnZk0SY.mjs";
-import { i as getRuntimeContext, l as makeRuntimeContext, u as runRuntimeContext } from "./context-BUEf1qjL.mjs";
-import { l as defaultRuntimeContextStorage, n as linkAbortSignals } from "./signal-D2UTcaaG.mjs";
-import { a as runScoped, i as Scope, o as ScopeRuntime, t as getProgramName } from "./program-metadata-DhQCCirO.mjs";
+import { i as getRuntimeContext, l as makeRuntimeContext, u as runRuntimeContext } from "./context-BphfFUMO.mjs";
+import { s as defaultRuntimeContextStorage } from "./disposable-CP-Q2H3l.mjs";
+import { a as runScoped, i as Scope, o as ScopeRuntime, t as getProgramName } from "./program-metadata-BxjGkT17.mjs";
 import { t as assertServiceCompatibility } from "./internal-identity-CbXoZIfw.mjs";
+import { n as linkAbortSignals } from "./signal-nfgFyNCk.mjs";
 import { Err } from "better-result";
 //#region src/layer/map-layer-backend.ts
 /** Native map-backed Layer backend used by Runtime when no adapter is supplied. */
@@ -109,11 +110,13 @@ const createResolutionResolver = (resolver, storage = defaultRuntimeContextStora
 		const cycleStart = findCycleStart(path, tag);
 		const resolutionPath = [...path, token];
 		const notifyResolve = (outcome) => {
-			notifyRuntimeObservers(observers, (observer) => observer.onServiceResolve, {
+			const event = {
 				service: token,
 				resolutionPath,
 				outcome
-			});
+			};
+			if (context?.executionId !== void 0) Object.assign(event, { executionId: context.executionId });
+			notifyRuntimeObservers(observers, (observer) => observer.onServiceResolve, event);
 		};
 		if (cycleStart >= 0) {
 			const error = new CircularDependencyError([...path.slice(cycleStart), token]);
@@ -228,47 +231,56 @@ const notifyShutdownFailure = async (observer, diagnostic) => {
 		await observer(diagnostic);
 	} catch {}
 };
-const releaseLayerResource = async (service, release, outcome, observers) => {
+const releaseLayerResource = async (service, release, outcome, observers, executionId) => {
 	try {
 		await release(outcome);
-		notifyRuntimeObservers(observers, (observer) => observer.onResourceRelease, {
+		const event = {
 			service,
 			outcome
-		});
+		};
+		if (executionId !== void 0) Object.assign(event, { executionId });
+		notifyRuntimeObservers(observers, (observer) => observer.onResourceRelease, event);
 	} catch (cause) {
-		notifyRuntimeObservers(observers, (observer) => observer.onResourceRelease, {
+		const event = {
 			service,
 			outcome,
 			error: cause
-		});
+		};
+		if (executionId !== void 0) Object.assign(event, { executionId });
+		notifyRuntimeObservers(observers, (observer) => observer.onResourceRelease, event);
 		throw cause;
 	}
 };
-const bindProviderToScope = (provider, scope, contextStorage, resolver, observers) => ({
+const bindProviderToScope = (provider, scope, contextStorage, resolver, observers, ownerExecutionId) => ({
 	service: provider.service,
 	serviceTag: provider.serviceTag,
 	acquire: () => {
 		const current = getRuntimeContext(contextStorage);
+		const executionId = current?.executionId ?? ownerExecutionId;
 		const context = makeRuntimeContext(resolver, scope, current?.resolutionPath ?? [], current?.signal, current);
 		return runRuntimeContext(contextStorage, context, () => ScopeRuntime.run(scope, async () => {
 			const resolutionPath = current?.resolutionPath ?? [provider.service];
 			try {
-				const instance = provider.acquireWithRelease ? (await scope.acquire(provider.acquireWithRelease, (acquired, outcome) => releaseLayerResource(provider.service, acquired.release, outcome, observers))).instance : provider.release ? await scope.acquire(() => provider.acquire(), (resource, outcome) => releaseLayerResource(provider.service, (releaseOutcome) => provider.release(resource, releaseOutcome), outcome, observers)) : await provider.acquire();
-				notifyRuntimeObservers(observers, (observer) => observer.onServiceAcquire, {
+				const instance = provider.acquireWithRelease ? (await scope.acquire(provider.acquireWithRelease, (acquired, outcome) => releaseLayerResource(provider.service, acquired.release, outcome, observers, ownerExecutionId))).instance : provider.release ? await scope.acquire(() => provider.acquire(), (resource, outcome) => releaseLayerResource(provider.service, (releaseOutcome) => provider.release(resource, releaseOutcome), outcome, observers, ownerExecutionId)) : await provider.acquire();
+				const event = {
 					service: provider.service,
 					resolutionPath,
 					outcome: SCOPE_SUCCESS
-				});
+				};
+				if (executionId !== void 0) Object.assign(event, { executionId });
+				notifyRuntimeObservers(observers, (observer) => observer.onServiceAcquire, event);
 				return instance;
 			} catch (cause) {
-				notifyRuntimeObservers(observers, (observer) => observer.onServiceAcquire, {
+				const event = {
 					service: provider.service,
 					resolutionPath,
 					outcome: {
 						status: "failure",
 						cause
 					}
-				});
+				};
+				if (executionId !== void 0) Object.assign(event, { executionId });
+				notifyRuntimeObservers(observers, (observer) => observer.onServiceAcquire, event);
 				throw cause;
 			}
 		}, contextStorage));
@@ -394,7 +406,7 @@ var RuntimeHandleImpl = class {
 		return this.startExecution(prepared.signalLink, prepared.metadata, async () => {
 			try {
 				return await this.runExecution(executionScope, async () => {
-					for (const provider of layer.providers) backend.register(bindProviderToScope(provider, executionScope, this.contextStorage, resolver, this.observers));
+					for (const provider of layer.providers) backend.register(bindProviderToScope(provider, executionScope, this.contextStorage, resolver, this.observers, prepared.metadata.executionId));
 					return await program();
 				}, resolver, prepared.signalLink.signal, prepared.metadata);
 			} finally {
@@ -461,16 +473,18 @@ var RuntimeHandleImpl = class {
 	}
 	runExecution(executionScope, program, resolver = this.resolver, signal = this.shutdownController.signal, metadata) {
 		let outcome;
+		let cleanupFailure;
 		const onOutcome = (determinedOutcome) => {
 			outcome = determinedOutcome;
 		};
-		const runOptions = this.onCleanupFailure ? {
+		const onExecutionCleanupFailure = async (diagnostic) => {
+			cleanupFailure = diagnostic.error;
+			if (this.onCleanupFailure !== void 0) await this.onCleanupFailure(diagnostic);
+		};
+		const runOptions = {
 			classify: classifyRuntimeOutcome,
 			onOutcome,
-			onCleanupFailure: this.onCleanupFailure
-		} : {
-			classify: classifyRuntimeOutcome,
-			onOutcome
+			onCleanupFailure: onExecutionCleanupFailure
 		};
 		const startEvent = Object.freeze({
 			...metadata,
@@ -481,20 +495,21 @@ var RuntimeHandleImpl = class {
 		const notifyEnd = (finalOutcome) => {
 			if (ended) return;
 			ended = true;
-			const endEvent = Object.freeze({
+			const endEvent = {
 				...metadata,
 				scope: executionScope,
 				outcome: finalOutcome,
 				durationMs: executionDuration(metadata, this.executionDependencies)
-			});
-			notifyRuntimeObservers(this.observers, (observer) => observer.onExecutionEnd, endEvent);
+			};
+			if (cleanupFailure !== void 0) Object.assign(endEvent, { cleanupFailure });
+			notifyRuntimeObservers(this.observers, (observer) => observer.onExecutionEnd, Object.freeze(endEvent));
 		};
 		let execution;
 		try {
 			execution = runScoped(executionScope, program, {
 				...runOptions,
 				contextStorage: this.contextStorage,
-				context: makeRuntimeContext(resolver, executionScope, [], signal)
+				context: makeRuntimeContext(resolver, executionScope, [], signal, void 0, metadata.executionId)
 			});
 		} catch (cause) {
 			notifyEnd({
@@ -773,4 +788,4 @@ var Runtime = class Runtime {
 //#endregion
 export { MapLayerBackend as i, RuntimeObserver as n, classifyRuntimeOutcome as r, Runtime as t };
 
-//# sourceMappingURL=runtime-CBMrX8Wl.mjs.map
+//# sourceMappingURL=runtime-C_55ofnL.mjs.map