better-effect 0.10.0 → 0.12.0

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/function/pipe.ts","../src/resource/errors.ts","../src/resource/internal.ts","../src/resource/resource.ts","../src/runtime/outcome.ts","../src/runtime/observer.ts","../src/layer/resolution.ts","../src/layer/runtime.ts","../src/runtime/runtime.ts"],"sourcesContent":["type Unary<A, B> = (value: A) => B\n\n/**\n * Compose a value through a sequence of unary functions.\n *\n * `pipe` is deliberately independent of Effect, Result, Promise, Scope, and\n * Service metadata.\n *\n * @example\n * ```ts\n * const label = pipe(\n *   'alice',\n *   (name) => name.trim(),\n *   (name) => name.toUpperCase()\n * )\n * ```\n */\ntype PipeRuntimeValue = Parameters<Unary<any, any>>[0]\n\ntype PipeRuntimeOperation = Unary<PipeRuntimeValue, PipeRuntimeValue>\n\nexport function pipe<A>(value: A): A\nexport function pipe<A, B>(value: A, ab: Unary<A, B>): B\nexport function pipe<A, B, C>(value: A, ab: Unary<A, B>, bc: Unary<B, C>): C\nexport function pipe<A, B, C, D>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>): D\nexport function pipe<A, B, C, D, E>(\n  value: A,\n  ab: Unary<A, B>,\n  bc: Unary<B, C>,\n  cd: Unary<C, D>,\n  de: Unary<D, E>\n): E\nexport function pipe<A, B, C, D, E, F>(\n  value: A,\n  ab: Unary<A, B>,\n  bc: Unary<B, C>,\n  cd: Unary<C, D>,\n  de: Unary<D, E>,\n  ef: Unary<E, F>\n): F\nexport function pipe<A, B, C, D, E, F, G>(\n  value: A,\n  ab: Unary<A, B>,\n  bc: Unary<B, C>,\n  cd: Unary<C, D>,\n  de: Unary<D, E>,\n  ef: Unary<E, F>,\n  fg: Unary<F, G>\n): G\nexport function pipe<A, B, C, D, E, F, G, H>(\n  value: A,\n  ab: Unary<A, B>,\n  bc: Unary<B, C>,\n  cd: Unary<C, D>,\n  de: Unary<D, E>,\n  ef: Unary<E, F>,\n  fg: Unary<F, G>,\n  gh: Unary<G, H>\n): H\nexport function pipe<A, B, C, D, E, F, G, H, I>(\n  value: A,\n  ab: Unary<A, B>,\n  bc: Unary<B, C>,\n  cd: Unary<C, D>,\n  de: Unary<D, E>,\n  ef: Unary<E, F>,\n  fg: Unary<F, G>,\n  gh: Unary<G, H>,\n  hi: Unary<H, I>\n): I\nexport function pipe<A, B, C, D, E, F, G, H, I, J>(\n  value: A,\n  ab: Unary<A, B>,\n  bc: Unary<B, C>,\n  cd: Unary<C, D>,\n  de: Unary<D, E>,\n  ef: Unary<E, F>,\n  fg: Unary<F, G>,\n  gh: Unary<G, H>,\n  hi: Unary<H, I>,\n  ij: Unary<I, J>\n): J\nexport function pipe<A, B, C, D, E, F, G, H, I, J, K>(\n  value: A,\n  ab: Unary<A, B>,\n  bc: Unary<B, C>,\n  cd: Unary<C, D>,\n  de: Unary<D, E>,\n  ef: Unary<E, F>,\n  fg: Unary<F, G>,\n  gh: Unary<G, H>,\n  hi: Unary<H, I>,\n  ij: Unary<I, J>,\n  jk: Unary<J, K>\n): K\nexport function pipe(\n  value: PipeRuntimeValue,\n  ...operations: ReadonlyArray<PipeRuntimeOperation>\n): PipeRuntimeValue {\n  return operations.reduce((current, operation) => operation(current), value)\n}\n","import { TaggedError } from 'better-result'\n\n/** Describes a failure encountered while releasing a Resource. */\nexport class ResourceReleaseFailure extends TaggedError('ResourceReleaseFailure')<{\n  readonly resource: string\n  readonly cause: unknown\n  readonly message: string\n}> {}\n","import { Result, type Result as ResultType, type UnhandledException } from 'better-result'\n\nimport { ResourceReleaseFailure } from './errors'\n\nimport { disposeResource } from '../scope/disposable'\n\nexport { disposeResource }\n\nimport type { AsyncResult, MaybePromise, ReleaseFailureObserver, ReleaseOutcome } from './types'\n\nconst toReleaseFailure = (resource: string, cause: unknown): ResourceReleaseFailure =>\n  new ResourceReleaseFailure({\n    resource,\n    cause,\n    message: `Failed to release resource: ${resource}`\n  })\n\nexport const runResult = async <T, E>(\n  operation: () => AsyncResult<T, E>\n): Promise<ResultType<T, E | UnhandledException>> => {\n  const execution = await Result.tryPromise(() => Promise.resolve(operation()))\n\n  return execution.andThen((result) => result)\n}\n\nconst normalizeReleaseOutcome = (\n  name: string,\n  outcome: ReleaseOutcome\n): ResultType<void, ResourceReleaseFailure> => {\n  if (outcome === undefined) {\n    return Result.ok()\n  }\n\n  return outcome.mapError((cause) => toReleaseFailure(name, cause))\n}\n\nexport const runRelease = async <R>(\n  name: string,\n  resource: R,\n  release: (resource: R) => MaybePromise<ReleaseOutcome>\n): Promise<ResultType<void, ResourceReleaseFailure>> => {\n  const execution = await Result.tryPromise({\n    try: () => Promise.resolve(release(resource)),\n    catch: (cause) => toReleaseFailure(name, cause)\n  })\n\n  return execution.andThen((outcome) => normalizeReleaseOutcome(name, outcome))\n}\n\nconst notifyReleaseFailure = async (\n  observer: ReleaseFailureObserver | undefined,\n\n  failure: ResourceReleaseFailure\n): Promise<void> => {\n  if (!observer) {\n    return\n  }\n\n  try {\n    await observer(failure)\n  } catch {\n    /*\n     * Diagnostics must never replace\n     * the actual operation error.\n     */\n  }\n}\n\nexport const combineUseAndRelease = async <A, E>(\n  used: ResultType<A, E>,\n\n  released: ResultType<void, ResourceReleaseFailure>,\n\n  onReleaseFailure?: ReleaseFailureObserver\n): Promise<ResultType<A, E | ResourceReleaseFailure>> => {\n  if (Result.isError(used)) {\n    if (Result.isError(released)) {\n      await notifyReleaseFailure(onReleaseFailure, released.error)\n    }\n\n    return Result.err<A, E | ResourceReleaseFailure>(used.error)\n  }\n\n  if (Result.isError(released)) {\n    await notifyReleaseFailure(onReleaseFailure, released.error)\n\n    return Result.err<A, E | ResourceReleaseFailure>(released.error)\n  }\n\n  return Result.ok<A, E | ResourceReleaseFailure>(used.value)\n}\n","import { Result, type Result as ResultType, type UnhandledException } from 'better-result'\n\nimport { Scope } from '../scope'\n\nimport { ResourceReleaseFailure } from './errors'\n\nimport { combineUseAndRelease, disposeResource, runRelease, runResult } from './internal'\n\nimport type { AcquireUseReleaseOptions } from './types'\n\n/**\n * Acquire a resource, use it, and always attempt release afterward.\n *\n * Acquisition, use, and release may be synchronous or asynchronous Result\n * operations. If both use and release fail, the use error remains primary and\n * `onReleaseFailure` receives the cleanup failure as a diagnostic.\n *\n * When `release` is omitted, `Symbol.asyncDispose` is preferred over\n * `Symbol.dispose`.\n *\n * @example\n * ```ts\n * const result = await Resource.acquireUseRelease({\n *   name: 'database connection',\n *   acquire: () => connect(),\n *   use: (connection) => query(connection),\n *   release: (connection) => connection.close()\n * })\n * ```\n */\nconst acquireUseRelease = <R, A, AcquireError, UseError>({\n  name,\n  acquire,\n  use,\n  release = disposeResource,\n  onReleaseFailure\n}: AcquireUseReleaseOptions<R, A, AcquireError, UseError>): Promise<\n  ResultType<A, AcquireError | UseError | UnhandledException | ResourceReleaseFailure>\n> =>\n  Result.gen(async function* () {\n    const resource = yield* Result.await(runResult(acquire))\n\n    const scope = Scope.make()\n\n    let released: ResultType<void, ResourceReleaseFailure> = Result.ok()\n\n    scope.addFinalizer(async () => {\n      released = await runRelease(name, resource, release)\n    })\n\n    const used = await runResult(() => use(resource))\n\n    await scope.close()\n\n    return await combineUseAndRelease(used, released, onReleaseFailure)\n  })\n\nexport const Resource = {\n  /** Acquire, use, and release a resource with deterministic error precedence. */\n  acquireUseRelease\n} as const\n","import { Err } from 'better-result'\n\nimport type { CleanupFailureDiagnostic, MaybePromise, ScopeOutcome } from '../scope'\n\nimport type { LayerDisposeError } from '../layer/errors'\n\nimport type { LayerBackend } from '../layer/backend'\n\nimport type { RuntimeContextStorage } from './context'\n\nimport type { RuntimeObserver } from './observer'\n\n/** Aggregated cleanup information reported during Runtime shutdown. */\nexport type RuntimeShutdownDiagnostic = {\n  /** Final outcome supplied to the Runtime root Scope. */\n  readonly outcome: ScopeOutcome\n  /** Aggregated root-Scope and backend cleanup failure. */\n  readonly error: LayerDisposeError\n}\n\n/** Observer notified about cleanup failures without changing primary results. */\nexport type CleanupFailureObserver = (\n  diagnostic: CleanupFailureDiagnostic | RuntimeShutdownDiagnostic\n) => MaybePromise<void>\n\n/** Optional Runtime configuration for cleanup diagnostics. */\nexport type RuntimeOptions = {\n  /** Backend used to register and resolve the Layer. Defaults to MapLayerBackend. */\n  readonly backend?: LayerBackend\n  /** Resolve every Layer provider before Runtime.make resolves. */\n  readonly warmup?: boolean\n  /** Best-effort lifecycle and Service resolution observers. */\n  readonly observers?: readonly RuntimeObserver[]\n  /** Optional observer for best-effort cleanup diagnostics. */\n  readonly onCleanupFailure?: CleanupFailureObserver\n  /** Context storage used by Service, Scope and Layer resolution. */\n  readonly contextStorage?: RuntimeContextStorage\n  /** Optional signal exposed through the RuntimeContext. */\n  readonly signal?: AbortSignal\n}\n\n/** Optional signal supplied to one managed Runtime execution. */\nexport type RuntimeRunOptions = {\n  readonly signal?: AbortSignal\n}\n\n/** Cooperative shutdown policy for a managed Runtime. */\nexport type RuntimeDisposeOptions = {\n  /** Time to let active executions settle before requesting cancellation. */\n  readonly gracePeriod?: number\n  /** Abort active execution signals after the grace period expires. */\n  readonly abortAfterGracePeriod?: boolean\n}\n\n/** Classify only a nominal better-result Err as a failed Runtime outcome. */\nexport const classifyRuntimeOutcome = <A>(value: A): ScopeOutcome => {\n  if (value instanceof Err) {\n    return {\n      status: 'failure',\n      cause: value.error\n    }\n  }\n\n  return {\n    status: 'success'\n  }\n}\n","import type { AnyServiceToken } from '../service'\nimport type { Scope } from '../scope'\nimport type { ScopeOutcome } from '../scope'\nimport type { MaybePromise } from '../utils/types'\n\n/** Event emitted after a Service resolution attempt settles. */\nexport type RuntimeServiceResolveEvent = {\n  readonly service: AnyServiceToken\n  readonly resolutionPath: readonly AnyServiceToken[]\n  readonly outcome: ScopeOutcome\n}\n\n/** Event emitted after a provider acquisition attempt settles. */\nexport type RuntimeServiceAcquireEvent = {\n  readonly service: AnyServiceToken\n  readonly resolutionPath: readonly AnyServiceToken[]\n  readonly outcome: ScopeOutcome\n}\n\n/** Event emitted immediately before a program starts in an execution Scope. */\nexport type RuntimeExecutionStartEvent = {\n  readonly scope: Scope\n}\n\n/** Event emitted after a program and its execution Scope settle. */\nexport type RuntimeExecutionEndEvent = {\n  readonly scope: Scope\n  readonly outcome: ScopeOutcome\n}\n\n/** Event emitted after a Layer provider release callback settles. */\nexport type RuntimeResourceReleaseEvent = {\n  readonly service: AnyServiceToken\n  readonly outcome: ScopeOutcome\n  readonly error?: unknown\n}\n\n/** Optional best-effort hooks for Runtime lifecycle and resolution events. */\nexport type RuntimeObserver = {\n  readonly onServiceResolve?: (event: RuntimeServiceResolveEvent) => MaybePromise<void>\n  readonly onServiceAcquire?: (event: RuntimeServiceAcquireEvent) => MaybePromise<void>\n  readonly onExecutionStart?: (event: RuntimeExecutionStartEvent) => MaybePromise<void>\n  readonly onExecutionEnd?: (event: RuntimeExecutionEndEvent) => MaybePromise<void>\n  readonly onResourceRelease?: (event: RuntimeResourceReleaseEvent) => MaybePromise<void>\n}\n\nexport const notifyRuntimeObservers = <Event>(\n  observers: readonly RuntimeObserver[],\n  select: (observer: RuntimeObserver) => ((event: Event) => MaybePromise<void>) | undefined,\n  event: Event\n): void => {\n  for (const observer of observers) {\n    const callback = select(observer)\n\n    if (!callback) {\n      continue\n    }\n\n    try {\n      void Promise.resolve(callback(event)).catch(() => {})\n    } catch {\n      // Observability must never change the Runtime result.\n    }\n  }\n}\n","import {\n  CircularDependencyError,\n  ServiceAcquisitionError,\n  ServiceNotFoundError,\n  type AnyServiceToken,\n  type ServiceResolver\n} from '../service'\n\nimport { getRuntimeContext, makeRuntimeContext, runRuntimeContext } from '../runtime/context'\n\nimport { defaultRuntimeContextStorage } from '../runtime/default'\n\nimport type { RuntimeContextStorage } from '../runtime/context'\n\nimport { notifyRuntimeObservers, type RuntimeObserver } from '../runtime/observer'\n\nimport type { ScopeOutcome } from '../scope'\n\nimport { ServiceTagCollisionError } from './errors'\n\nconst findCycleStart = (path: readonly AnyServiceToken[], token: AnyServiceToken): number =>\n  path.findIndex((current) => current.serviceTag === token.serviceTag)\n\nconst shouldPreserve = (cause: unknown): boolean =>\n  cause instanceof CircularDependencyError ||\n  cause instanceof ServiceAcquisitionError ||\n  cause instanceof ServiceNotFoundError ||\n  cause instanceof ServiceTagCollisionError\n\n/** Wrap a backend with Runtime-local resolution paths and acquisition errors. */\nexport const createResolutionResolver = (\n  resolver: ServiceResolver,\n  storage: RuntimeContextStorage = defaultRuntimeContextStorage,\n  observers: readonly RuntimeObserver[] = []\n): ServiceResolver => {\n  const wrapped: ServiceResolver = {\n    async resolve<T extends AnyServiceToken>(token: T): Promise<InstanceType<T>> {\n      const context = getRuntimeContext(storage)\n      const path = context?.resolutionPath ?? []\n      const cycleStart = findCycleStart(path, token)\n      const resolutionPath = [...path, token]\n\n      const notifyResolve = (outcome: ScopeOutcome): void => {\n        notifyRuntimeObservers(observers, (observer) => observer.onServiceResolve, {\n          service: token,\n          resolutionPath,\n          outcome\n        })\n      }\n\n      if (cycleStart >= 0) {\n        const error = new CircularDependencyError([...path.slice(cycleStart), token])\n        notifyResolve({ status: 'failure', cause: error })\n        throw error\n      }\n\n      const nextContext = makeRuntimeContext(\n        wrapped,\n        context?.scope,\n        resolutionPath,\n        context?.signal,\n        context\n      )\n\n      return await runRuntimeContext(storage, nextContext, async () => {\n        try {\n          const instance = await resolver.resolve(token)\n          notifyResolve({ status: 'success' })\n          return instance\n        } catch (cause) {\n          if (shouldPreserve(cause)) {\n            notifyResolve({ status: 'failure', cause })\n            throw cause\n          }\n\n          const error = new ServiceAcquisitionError(token, resolutionPath, cause)\n          notifyResolve({ status: 'failure', cause: error })\n          throw error\n        }\n      })\n    }\n  }\n\n  return wrapped\n}\n","import type { AnyService, AnyServiceToken, ServiceResolver } from '../service'\n\nimport { Scope, type CloseableScope } from '../scope'\nimport { runScoped } from '../scope/internal'\nimport { ScopeRuntime } from '../scope/runtime'\n\nimport {\n  getRuntimeContext,\n  makeRuntimeContext,\n  runRuntimeContext,\n  type RuntimeContextStorage\n} from '../runtime/context'\n\nimport { defaultRuntimeContextStorage } from '../runtime/default'\n\nimport {\n  classifyRuntimeOutcome,\n  type CleanupFailureObserver,\n  type RuntimeDisposeOptions,\n  type RuntimeOptions,\n  type RuntimeRunOptions,\n  type RuntimeShutdownDiagnostic\n} from '../runtime/outcome'\n\nimport { linkAbortSignals, type AbortSignalLink } from '../runtime/signal'\n\nimport { LayerDisposeError, LayerRegistrationError } from './errors'\n\nimport { createResolutionResolver } from './resolution'\n\nimport { notifyRuntimeObservers, type RuntimeObserver } from '../runtime/observer'\n\nimport type { LayerBackend } from './backend'\n\nimport { MapLayerBackend } from './map-layer-backend'\n\nimport type {\n  CompleteExecution,\n  CompleteExecutionLayer,\n  CompleteInput,\n  LayerInput,\n  ProvidedEnvironment\n} from './inference'\n\nimport type { LayerRegistration } from './types'\n\nimport type { ScopeOutcome } from '../scope'\n\ntype LayerProvider = LayerInput['providers'][number]\n\ninterface RuntimeHandleCore<Provided extends AnyService> {\n  /** The backend used to resolve this Layer's providers. */\n  readonly backend: LayerBackend\n\n  /** Run a program in a child Scope of the Layer's root Scope. */\n  run<A>(program: CompleteExecution<Provided, A>, options?: RuntimeRunOptions): Promise<Awaited<A>>\n\n  /** Run a program with providers owned by that execution's child Scope. */\n  runWith<Request extends LayerInput, A>(\n    layer: Request & CompleteExecutionLayer<Provided, Request>,\n    program: CompleteExecution<Provided | ProvidedEnvironment<Request>, A>,\n    options?: RuntimeRunOptions\n  ): Promise<Awaited<A>>\n\n  /** Resolve every registered provider before accepting normal executions. */\n  warmup(): Promise<void>\n\n  /** Stop new executions and release Layer-owned resources. */\n  dispose(input?: RuntimeDisposeOptions | ScopeOutcome): Promise<void>\n}\n\n/** Runtime-facing handle that owns a Layer's resources and execution scopes. */\nexport type RuntimeHandle<Provided extends AnyService = any> = RuntimeHandleCore<Provided>\n\nconst SCOPE_SUCCESS: ScopeOutcome = Object.freeze({ status: 'success' })\n\nclass RuntimeHandleDisposedError extends Error {\n  constructor() {\n    super('Cannot run a program using a disposed Layer')\n\n    this.name = 'RuntimeHandleDisposedError'\n  }\n}\n\nconst normalizeDisposeCauses = (cause: unknown): readonly unknown[] => {\n  if (cause instanceof AggregateError) {\n    return [...cause.errors]\n  }\n\n  return [cause]\n}\n\nconst isScopeOutcome = (\n  input: RuntimeDisposeOptions | ScopeOutcome | undefined\n): input is ScopeOutcome => input !== undefined && 'status' in input\n\nconst validateDisposeOptions = (options: RuntimeDisposeOptions): void => {\n  const { gracePeriod } = options\n\n  if (gracePeriod !== undefined && (!Number.isFinite(gracePeriod) || gracePeriod < 0)) {\n    throw new RangeError('Runtime dispose gracePeriod must be a finite non-negative number')\n  }\n}\n\ntype ActiveExecution = {\n  readonly promise: Promise<unknown>\n}\n\nconst notifyShutdownFailure = async (\n  observer: CleanupFailureObserver | undefined,\n  diagnostic: RuntimeShutdownDiagnostic\n): Promise<void> => {\n  if (!observer) {\n    return\n  }\n\n  try {\n    await observer(diagnostic)\n  } catch {\n    // Shutdown diagnostics are best effort and never affect the primary result.\n  }\n}\n\nconst bindProviderToScope = (\n  provider: LayerProvider,\n  scope: CloseableScope,\n  contextStorage: RuntimeContextStorage,\n  resolver: ServiceResolver,\n  observers: readonly RuntimeObserver[]\n): LayerRegistration => ({\n  service: provider.service,\n\n  acquire: () => {\n    const current = getRuntimeContext(contextStorage)\n    const context = makeRuntimeContext(\n      resolver,\n      scope,\n      current?.resolutionPath ?? [],\n      current?.signal,\n      current\n    )\n\n    return runRuntimeContext(contextStorage, context, () =>\n      ScopeRuntime.run(\n        scope,\n        async () => {\n          const resolutionPath = current?.resolutionPath ?? [provider.service]\n\n          try {\n            const instance = provider.release\n              ? await scope.acquire(\n                  () => provider.acquire(),\n                  async (resource, outcome) => {\n                    try {\n                      await provider.release!(resource, outcome)\n                      notifyRuntimeObservers(observers, (observer) => observer.onResourceRelease, {\n                        service: provider.service,\n                        outcome\n                      })\n                    } catch (cause) {\n                      notifyRuntimeObservers(observers, (observer) => observer.onResourceRelease, {\n                        service: provider.service,\n                        outcome,\n                        error: cause\n                      })\n                      throw cause\n                    }\n                  }\n                )\n              : await provider.acquire()\n\n            notifyRuntimeObservers(observers, (observer) => observer.onServiceAcquire, {\n              service: provider.service,\n              resolutionPath,\n              outcome: SCOPE_SUCCESS\n            })\n\n            return instance\n          } catch (cause) {\n            notifyRuntimeObservers(observers, (observer) => observer.onServiceAcquire, {\n              service: provider.service,\n              resolutionPath,\n              outcome: {\n                status: 'failure',\n                cause\n              }\n            })\n            throw cause\n          }\n        },\n        contextStorage\n      )\n    )\n  }\n})\n\n/** Resolve request-local providers first, then fall back to the Runtime root. */\nclass ExecutionLayerBackend implements LayerBackend {\n  private readonly localTags = new Set<string>()\n\n  constructor(\n    private readonly local: MapLayerBackend,\n    private readonly root: LayerBackend\n  ) {}\n\n  register(registration: LayerRegistration): void {\n    this.localTags.add(registration.service.serviceTag)\n    this.local.register(registration)\n  }\n\n  async resolve<T extends AnyServiceToken>(token: T): Promise<InstanceType<T>> {\n    if (this.localTags.has(token.serviceTag)) {\n      return await this.local.resolve(token)\n    }\n\n    return await this.root.resolve(token)\n  }\n\n  async disposeAll(): Promise<void> {\n    await this.local.disposeAll()\n    this.localTags.clear()\n  }\n}\n\nclass RuntimeHandleImpl<Provided extends AnyService> implements RuntimeHandleCore<Provided> {\n  private disposePromise: Promise<void> | undefined\n\n  private warmupPromise: Promise<void> | undefined\n\n  private readonly executions = new Set<ActiveExecution>()\n\n  private readonly shutdownController = new AbortController()\n\n  private state: 'active' | 'disposing' | 'disposed' = 'active'\n\n  constructor(\n    readonly backend: LayerBackend,\n    private readonly resolver: ServiceResolver,\n    private readonly rootScope: CloseableScope,\n    private readonly onCleanupFailure: CleanupFailureObserver | undefined,\n    private readonly contextStorage: RuntimeContextStorage,\n    private readonly signal: AbortSignal | undefined,\n    private readonly observers: readonly RuntimeObserver[],\n    private readonly services: readonly AnyServiceToken[]\n  ) {}\n\n  run<A>(\n    program: CompleteExecution<Provided, A>,\n    options?: RuntimeRunOptions\n  ): Promise<Awaited<A>> {\n    this.assertActive()\n\n    const executionScope = this.rootScope.fork()\n    const signalLink = linkAbortSignals(\n      this.signal,\n      options?.signal,\n      this.shutdownController.signal\n    )\n\n    return this.startExecution<Awaited<A>>(signalLink, () =>\n      this.runExecution(executionScope, program, this.resolver, signalLink.signal)\n    )\n  }\n\n  runWith<Request extends LayerInput, A>(\n    layer: Request & CompleteExecutionLayer<Provided, Request>,\n    program: CompleteExecution<Provided | ProvidedEnvironment<Request>, A>,\n    options?: RuntimeRunOptions\n  ): Promise<Awaited<A>> {\n    this.assertActive()\n\n    const executionScope = this.rootScope.fork()\n    const localBackend = new MapLayerBackend()\n    const backend = new ExecutionLayerBackend(localBackend, this.backend)\n    const resolver = createResolutionResolver(backend, this.contextStorage, this.observers)\n    const signalLink = linkAbortSignals(\n      this.signal,\n      options?.signal,\n      this.shutdownController.signal\n    )\n\n    return this.startExecution<Awaited<A>>(signalLink, async (): Promise<Awaited<A>> => {\n      try {\n        return await this.runExecution<Awaited<A>>(\n          executionScope,\n          async (): Promise<Awaited<A>> => {\n            for (const provider of layer.providers) {\n              backend.register(\n                bindProviderToScope(\n                  provider,\n                  executionScope,\n                  this.contextStorage,\n                  resolver,\n                  this.observers\n                )\n              )\n            }\n\n            return await program()\n          },\n          resolver,\n          signalLink.signal\n        )\n      } finally {\n        await localBackend.disposeAll()\n      }\n    })\n  }\n\n  warmup(): Promise<void> {\n    this.assertActive()\n\n    if (this.warmupPromise) {\n      return this.warmupPromise\n    }\n\n    const warmup = runRuntimeContext(\n      this.contextStorage,\n      makeRuntimeContext(this.resolver, this.rootScope, [], this.signal),\n      async () => {\n        for (const service of this.services) {\n          await this.resolver.resolve(service)\n        }\n      }\n    )\n\n    this.warmupPromise = warmup\n\n    void warmup.then(\n      () => {\n        if (this.warmupPromise === warmup) {\n          this.warmupPromise = undefined\n        }\n      },\n      () => {\n        if (this.warmupPromise === warmup) {\n          this.warmupPromise = undefined\n        }\n      }\n    )\n\n    return warmup\n  }\n\n  private startExecution<A>(signalLink: AbortSignalLink, run: () => PromiseLike<A>): Promise<A> {\n    let resolveExecution!: (value: A | PromiseLike<A>) => void\n    let rejectExecution!: (cause?: unknown) => void\n\n    const execution = new Promise<A>((resolve, reject) => {\n      resolveExecution = resolve\n      rejectExecution = reject\n    })\n\n    const activeExecution: ActiveExecution = { promise: execution }\n\n    this.executions.add(activeExecution)\n\n    void execution.then(\n      () => {\n        this.executions.delete(activeExecution)\n        signalLink.dispose()\n      },\n      () => {\n        this.executions.delete(activeExecution)\n        signalLink.dispose()\n      }\n    )\n\n    try {\n      const running = run()\n\n      void running.then(\n        (value) => {\n          resolveExecution(value)\n        },\n        (cause) => {\n          rejectExecution(cause)\n        }\n      )\n    } catch (cause) {\n      rejectExecution(cause)\n    }\n\n    return execution\n  }\n\n  private runExecution<A>(\n    executionScope: CloseableScope,\n    program: () => A | PromiseLike<A>,\n    resolver: ServiceResolver = this.resolver,\n    signal: AbortSignal = this.shutdownController.signal\n  ): Promise<Awaited<A>> {\n    let outcome!: ScopeOutcome\n    const onOutcome = (determinedOutcome: ScopeOutcome): void => {\n      outcome = determinedOutcome\n    }\n    const runOptions = this.onCleanupFailure\n      ? {\n          classify: classifyRuntimeOutcome,\n          onOutcome,\n          onCleanupFailure: this.onCleanupFailure\n        }\n      : {\n          classify: classifyRuntimeOutcome,\n          onOutcome\n        }\n\n    notifyRuntimeObservers(this.observers, (observer) => observer.onExecutionStart, {\n      scope: executionScope\n    })\n\n    const execution = runScoped(executionScope, program, {\n      ...runOptions,\n      contextStorage: this.contextStorage,\n      context: makeRuntimeContext(resolver, executionScope, [], signal)\n    })\n\n    return execution.then(\n      (value) => {\n        notifyRuntimeObservers(this.observers, (observer) => observer.onExecutionEnd, {\n          scope: executionScope,\n          outcome\n        })\n        return value\n      },\n      (cause) => {\n        notifyRuntimeObservers(this.observers, (observer) => observer.onExecutionEnd, {\n          scope: executionScope,\n          outcome\n        })\n        throw cause\n      }\n    )\n  }\n\n  dispose(input?: RuntimeDisposeOptions | ScopeOutcome): Promise<void> {\n    if (this.disposePromise) {\n      return this.disposePromise\n    }\n\n    const outcome =\n      isScopeOutcome(input) || input === undefined ? (input ?? SCOPE_SUCCESS) : SCOPE_SUCCESS\n    const options = isScopeOutcome(input) || input === undefined ? {} : input\n\n    validateDisposeOptions(options)\n    this.state = 'disposing'\n\n    const executions = [...this.executions]\n\n    this.disposePromise = this.performDispose(executions, outcome, options)\n\n    return this.disposePromise\n  }\n\n  private async performDispose(\n    executions: readonly ActiveExecution[],\n    outcome: ScopeOutcome,\n    options: RuntimeDisposeOptions\n  ): Promise<void> {\n    const failures: unknown[] = []\n\n    await Promise.allSettled(this.warmupPromise ? [this.warmupPromise] : [])\n    await this.waitForExecutions(executions, options)\n\n    try {\n      const signalLink = linkAbortSignals(this.signal, this.shutdownController.signal)\n\n      try {\n        await runRuntimeContext(\n          this.contextStorage,\n          makeRuntimeContext(this.resolver, this.rootScope, [], signalLink.signal),\n          () => this.rootScope.close(outcome)\n        )\n      } finally {\n        signalLink.dispose()\n      }\n    } catch (cause) {\n      failures.push(cause)\n    }\n\n    try {\n      await this.backend.disposeAll()\n    } catch (cause) {\n      failures.push(cause)\n    }\n\n    this.state = 'disposed'\n\n    if (failures.length > 0) {\n      const error = new LayerDisposeError(failures.flatMap(normalizeDisposeCauses))\n\n      await notifyShutdownFailure(this.onCleanupFailure, {\n        outcome,\n        error\n      })\n\n      throw error\n    }\n  }\n\n  private async waitForExecutions(\n    executions: readonly ActiveExecution[],\n    options: RuntimeDisposeOptions\n  ): Promise<void> {\n    const settled = Promise.allSettled(executions.map((execution) => execution.promise))\n\n    if (options.abortAfterGracePeriod !== true || executions.length === 0) {\n      await settled\n      return\n    }\n\n    const gracePeriod = options.gracePeriod ?? 0\n    let timer: ReturnType<typeof setTimeout> | undefined\n\n    const timedOut = await Promise.race([\n      settled.then(() => false),\n      new Promise<boolean>((resolve) => {\n        timer = setTimeout(() => resolve(true), gracePeriod)\n      })\n    ])\n\n    if (timer !== undefined) {\n      clearTimeout(timer)\n    }\n\n    if (timedOut && !this.shutdownController.signal.aborted) {\n      this.shutdownController.abort(new Error('Runtime shutdown grace period exceeded'))\n    }\n\n    await settled\n  }\n\n  private assertActive(): void {\n    if (this.state !== 'active') {\n      throw new RuntimeHandleDisposedError()\n    }\n  }\n}\n\n/** Build a Runtime handle for a complete Layer and register its providers. */\nexport const createRuntimeHandle = async <L extends LayerInput>(\n  layer: L & CompleteInput<L>,\n  backend: LayerBackend,\n  options: RuntimeOptions = {}\n): Promise<RuntimeHandle<ProvidedEnvironment<L>>> => {\n  const rootScope = Scope.make()\n  const contextStorage = options.contextStorage ?? defaultRuntimeContextStorage\n  const observers = options.observers ?? []\n  const resolver = createResolutionResolver(backend, contextStorage, observers)\n  ScopeRuntime.bind(rootScope, contextStorage)\n  let current: LayerProvider | undefined\n\n  try {\n    for (const provider of layer.providers) {\n      current = provider\n\n      await backend.register(\n        bindProviderToScope(provider, rootScope, contextStorage, resolver, observers)\n      )\n    }\n  } catch (registrationCause) {\n    const outcome: ScopeOutcome = {\n      status: 'failure',\n      cause: registrationCause\n    }\n    const cleanupCauses: unknown[] = []\n\n    try {\n      await runRuntimeContext(\n        contextStorage,\n        makeRuntimeContext(resolver, rootScope, [], options.signal),\n        () => rootScope.close(outcome)\n      )\n    } catch (cause) {\n      cleanupCauses.push(cause)\n    }\n\n    try {\n      await backend.disposeAll()\n    } catch (cause) {\n      cleanupCauses.push(cause)\n    }\n\n    if (cleanupCauses.length > 0) {\n      const shutdownError = new LayerDisposeError(cleanupCauses.flatMap(normalizeDisposeCauses))\n\n      await notifyShutdownFailure(options.onCleanupFailure, {\n        outcome,\n        error: shutdownError\n      })\n    }\n\n    const cleanupCause =\n      cleanupCauses.length === 1\n        ? cleanupCauses[0]\n        : cleanupCauses.length > 1\n          ? new LayerDisposeError(cleanupCauses.flatMap(normalizeDisposeCauses))\n          : undefined\n\n    throw new LayerRegistrationError(current?.service, registrationCause, cleanupCause)\n  }\n\n  return new RuntimeHandleImpl<ProvidedEnvironment<L>>(\n    backend,\n    resolver,\n    rootScope,\n    options.onCleanupFailure,\n    contextStorage,\n    options.signal,\n    observers,\n    layer.providers.map((provider) => provider.service)\n  )\n}\n","import type { LayerBackend } from '../layer'\n\nimport { MapLayerBackend } from '../layer/map-layer-backend'\n\nimport { createRuntimeHandle, type RuntimeHandle } from '../layer/runtime'\n\nimport type {\n  CompleteExecutionLayer,\n  LayerInput,\n  CompleteInput,\n  ProvidedEnvironment\n} from '../layer/inference'\n\nimport type { CompleteExecution } from '../layer/inference'\n\nimport type { AnyService } from '../service'\n\nimport {\n  classifyRuntimeOutcome,\n  type RuntimeDisposeOptions,\n  type RuntimeOptions,\n  type RuntimeRunOptions,\n  type RuntimeShutdownDiagnostic\n} from './outcome'\n\nimport type { ScopeOutcome } from '../scope'\n\nimport type { RuntimeFor } from './types'\n\nimport type { RuntimeObserver } from './observer'\n\ntype RuntimeBackendInput = LayerBackend | RuntimeOptions | undefined\n\ntype RuntimeConfig = {\n  readonly backend: LayerBackend\n  readonly options: RuntimeOptions\n}\n\nconst isLayerBackend = (value: RuntimeBackendInput): value is LayerBackend =>\n  value !== undefined && 'register' in value && 'resolve' in value && 'disposeAll' in value\n\nconst resolveRuntimeConfig = (\n  backendOrOptions: RuntimeBackendInput,\n  legacyOptions?: RuntimeOptions\n): RuntimeConfig => {\n  if (isLayerBackend(backendOrOptions)) {\n    return {\n      backend: backendOrOptions,\n      options: legacyOptions ?? {}\n    }\n  }\n\n  const options = backendOrOptions ?? {}\n\n  return {\n    backend: options.backend ?? new MapLayerBackend(),\n    options\n  }\n}\n\n/**\n * Long-lived execution environment backed by a complete Layer.\n *\n * A Runtime owns Layer resources until `dispose()` is called. Each `run()` is\n * isolated in a child Scope, while Layer-scoped resources remain shared.\n *\n * @example\n * ```ts\n * const runtime = await Runtime.make(AppLive)\n * const result = await runtime.run(loadUser('u1'))\n * await runtime.dispose()\n * ```\n *\n * @typeParam Provided The branded Service instances supplied by the Layer.\n */\nexport class Runtime<Provided extends AnyService = any> {\n  private constructor(private readonly handle: RuntimeHandle<Provided>) {}\n\n  /**\n   * Create a long-lived Runtime that owns its Layer resources.\n   *\n   * @example\n   * ```ts\n   * const runtime = await Runtime.make(AppLive)\n   * const result = await runtime.run(program)\n   * await runtime.dispose()\n   * ```\n   */\n  static make<L extends LayerInput>(\n    layer: L & CompleteInput<L>,\n    backend: LayerBackend,\n    options?: RuntimeOptions\n  ): Promise<Runtime<ProvidedEnvironment<L>>>\n\n  static make<L extends LayerInput>(\n    layer: L & CompleteInput<L>,\n    options?: RuntimeOptions\n  ): Promise<Runtime<ProvidedEnvironment<L>>>\n\n  static async make<L extends LayerInput>(\n    layer: L & CompleteInput<L>,\n    backendOrOptions?: LayerBackend | RuntimeOptions,\n    legacyOptions?: RuntimeOptions\n  ): Promise<Runtime<ProvidedEnvironment<L>>> {\n    const { backend, options } = resolveRuntimeConfig(backendOrOptions, legacyOptions)\n    const handle = await createRuntimeHandle(layer, backend, options)\n    const runtime = new Runtime<ProvidedEnvironment<L>>(handle)\n\n    if (options.warmup) {\n      await runtime.warmup()\n    }\n\n    return runtime\n  }\n\n  /**\n   * Run one program and dispose its Layer resources before resolving.\n   *\n   * This is convenient for request-style or command-style execution where a\n   * Runtime should not outlive the operation.\n   */\n  static run<A, L extends LayerInput>(\n    layer: L & CompleteInput<L>,\n    backend: LayerBackend,\n    program: CompleteExecution<ProvidedEnvironment<L>, A>,\n    options?: RuntimeOptions\n  ): Promise<Awaited<A>>\n\n  static run<A, L extends LayerInput>(\n    layer: L & CompleteInput<L>,\n    program: CompleteExecution<ProvidedEnvironment<L>, A>,\n    options?: RuntimeOptions\n  ): Promise<Awaited<A>>\n\n  static run<A, L extends LayerInput>(\n    layer: L & CompleteInput<L>,\n    options: RuntimeOptions,\n    program: CompleteExecution<ProvidedEnvironment<L>, A>\n  ): Promise<Awaited<A>>\n\n  static async run<A, L extends LayerInput>(\n    layer: L & CompleteInput<L>,\n    backendOrProgramOrOptions:\n      | LayerBackend\n      | RuntimeOptions\n      | CompleteExecution<ProvidedEnvironment<L>, A>,\n    programOrOptions?: CompleteExecution<ProvidedEnvironment<L>, A> | RuntimeOptions,\n    legacyOptions?: RuntimeOptions\n  ): Promise<Awaited<A>> {\n    let program: CompleteExecution<ProvidedEnvironment<L>, A>\n    let backendOrOptions: RuntimeBackendInput\n    let options: RuntimeOptions | undefined\n\n    // oxlint-disable-next-line anti-slop/no-runtime-typeof -- overload dispatch needs to distinguish a Program callback from configuration.\n    if (typeof backendOrProgramOrOptions === 'function') {\n      program = backendOrProgramOrOptions\n      // SAFETY: The function overload branch establishes that this argument is the optional RuntimeOptions value.\n      backendOrOptions = programOrOptions as RuntimeOptions | undefined\n      options = undefined\n    } else {\n      backendOrOptions = backendOrProgramOrOptions\n      // SAFETY: The non-function overload branch establishes that this argument is the complete execution callback.\n      program = programOrOptions as CompleteExecution<ProvidedEnvironment<L>, A>\n      options = legacyOptions\n    }\n\n    const config = resolveRuntimeConfig(backendOrOptions, options)\n    let programOutcome: ScopeOutcome | undefined\n    const outcomeObserver: RuntimeObserver = {\n      onExecutionEnd: ({ outcome }) => {\n        programOutcome = outcome\n      }\n    }\n    const runtimeOptions: RuntimeOptions = {\n      ...config.options,\n      observers: [outcomeObserver, ...(config.options.observers ?? [])]\n    }\n    const runtime = await Runtime.make(layer, config.backend, runtimeOptions)\n\n    let value!: Awaited<A>\n    let executionFailed = false\n    let executionFailure: unknown\n\n    try {\n      value = await runtime.runUnchecked(program)\n    } catch (cause) {\n      executionFailed = true\n      executionFailure = cause\n    }\n\n    const outcome: ScopeOutcome =\n      programOutcome ??\n      ({\n        status: 'failure',\n        cause: executionFailure\n      } as const)\n\n    try {\n      await runtime.disposeWithOutcome(outcome)\n    } catch (shutdownFailure) {\n      if (!executionFailed && outcome.status === 'success') {\n        throw shutdownFailure\n      }\n    }\n\n    if (executionFailed) {\n      throw executionFailure\n    }\n\n    return value\n  }\n\n  /** Run a callback with a managed Runtime and always dispose it afterward. */\n  static use<A, L extends LayerInput>(\n    layer: L & CompleteInput<L>,\n    use: (runtime: Runtime<ProvidedEnvironment<L>>) => A | PromiseLike<A>,\n    options?: RuntimeOptions\n  ): Promise<Awaited<A>>\n\n  static async use<A, L extends LayerInput>(\n    layer: L & CompleteInput<L>,\n    use: (runtime: Runtime<ProvidedEnvironment<L>>) => A | PromiseLike<A>,\n    options?: RuntimeOptions\n  ): Promise<Awaited<A>> {\n    const runtime = await Runtime.make(layer, options)\n\n    let value!: Awaited<A>\n    let executionFailed = false\n    let executionFailure: unknown\n    let programOutcome: ScopeOutcome | undefined\n\n    try {\n      value = await use(runtime)\n      programOutcome = classifyRuntimeOutcome(value)\n    } catch (cause) {\n      executionFailed = true\n      executionFailure = cause\n      programOutcome = {\n        status: 'failure',\n        cause\n      }\n    }\n\n    const outcome: ScopeOutcome =\n      programOutcome ??\n      ({\n        status: 'failure',\n        cause: executionFailure\n      } as const)\n\n    try {\n      await runtime.disposeWithOutcome(outcome)\n    } catch (shutdownFailure) {\n      if (!executionFailed && outcome.status === 'success') {\n        throw shutdownFailure\n      }\n    }\n\n    if (executionFailed) {\n      throw executionFailure\n    }\n\n    return value\n  }\n\n  /** Resolve every Layer provider and dispose the Runtime if warmup fails. */\n  async warmup(): Promise<void> {\n    try {\n      await this.handle.warmup()\n    } catch (cause) {\n      try {\n        await this.handle.dispose({ status: 'failure', cause })\n      } catch {\n        // Warmup failure remains the primary error; cleanup is best effort.\n      }\n\n      throw cause\n    }\n  }\n\n  /** Run one execution in this Runtime's child Scope. */\n  run<A>(\n    program: CompleteExecution<Provided, A>,\n    options?: RuntimeRunOptions\n  ): Promise<Awaited<A>> {\n    return this.handle.run(program, options)\n  }\n\n  /** Run one execution with a Layer owned by that execution's child Scope. */\n  runWith<Request extends LayerInput, A>(\n    layer: Request & CompleteExecutionLayer<Provided, Request>,\n    program: CompleteExecution<Provided | ProvidedEnvironment<Request>, A>,\n    options?: RuntimeRunOptions\n  ): Promise<Awaited<A>> {\n    return this.handle.runWith(layer, program, options)\n  }\n\n  private runUnchecked<A>(program: () => A | PromiseLike<A>): Promise<Awaited<A>> {\n    // SAFETY: One-shot Runtime.run performs the same complete-program validation at its public boundary before using this internal escape hatch.\n    return this.handle.run(program as CompleteExecution<Provided, A>)\n  }\n\n  /** Stop new executions and release the Runtime's Layer resources. */\n  dispose(options?: RuntimeDisposeOptions): Promise<void>\n\n  /** @deprecated Scope outcomes are kept for internal compatibility. */\n  dispose(outcome: ScopeOutcome): Promise<void>\n\n  dispose(optionsOrOutcome?: RuntimeDisposeOptions | ScopeOutcome): Promise<void> {\n    return this.handle.dispose(optionsOrOutcome)\n  }\n\n  /** Release Runtime-owned resources through JavaScript's async disposal protocol. */\n  async [Symbol.asyncDispose](): Promise<void> {\n    await this.dispose()\n  }\n\n  private disposeWithOutcome(outcome: ScopeOutcome): Promise<void> {\n    return this.handle.dispose(outcome)\n  }\n}\n\n/** Type-level aliases for naming Runtime handles and shutdown options. */\nexport declare namespace Runtime {\n  /** Name a Runtime type from a concrete Layer. */\n  export type For<L extends LayerInput> = RuntimeFor<L>\n\n  /** Optional Runtime shutdown configuration. */\n  export type Options = RuntimeOptions\n\n  /** Optional signal supplied to one managed Runtime execution. */\n  export type RunOptions = RuntimeRunOptions\n\n  /** Cooperative shutdown policy for a managed Runtime. */\n  export type DisposeOptions = RuntimeDisposeOptions\n\n  /** Diagnostic reported for aggregated Runtime shutdown cleanup failures. */\n  export type ShutdownDiagnostic = RuntimeShutdownDiagnostic\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/function/pipe.ts","../src/resource/errors.ts","../src/resource/internal.ts","../src/resource/resource.ts"],"sourcesContent":["type Unary<A, B> = (value: A) => B\n\n/**\n * Compose a value through a sequence of unary functions.\n *\n * `pipe` is deliberately independent of Effect, Result, Promise, Scope, and\n * Service metadata.\n *\n * @example\n * ```ts\n * const label = pipe(\n *   'alice',\n *   (name) => name.trim(),\n *   (name) => name.toUpperCase()\n * )\n * ```\n */\ntype PipeRuntimeValue = Parameters<Unary<any, any>>[0]\n\ntype PipeRuntimeOperation = Unary<PipeRuntimeValue, PipeRuntimeValue>\n\nexport function pipe<A>(value: A): A\nexport function pipe<A, B>(value: A, ab: Unary<A, B>): B\nexport function pipe<A, B, C>(value: A, ab: Unary<A, B>, bc: Unary<B, C>): C\nexport function pipe<A, B, C, D>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>): D\nexport function pipe<A, B, C, D, E>(\n  value: A,\n  ab: Unary<A, B>,\n  bc: Unary<B, C>,\n  cd: Unary<C, D>,\n  de: Unary<D, E>\n): E\nexport function pipe<A, B, C, D, E, F>(\n  value: A,\n  ab: Unary<A, B>,\n  bc: Unary<B, C>,\n  cd: Unary<C, D>,\n  de: Unary<D, E>,\n  ef: Unary<E, F>\n): F\nexport function pipe<A, B, C, D, E, F, G>(\n  value: A,\n  ab: Unary<A, B>,\n  bc: Unary<B, C>,\n  cd: Unary<C, D>,\n  de: Unary<D, E>,\n  ef: Unary<E, F>,\n  fg: Unary<F, G>\n): G\nexport function pipe<A, B, C, D, E, F, G, H>(\n  value: A,\n  ab: Unary<A, B>,\n  bc: Unary<B, C>,\n  cd: Unary<C, D>,\n  de: Unary<D, E>,\n  ef: Unary<E, F>,\n  fg: Unary<F, G>,\n  gh: Unary<G, H>\n): H\nexport function pipe<A, B, C, D, E, F, G, H, I>(\n  value: A,\n  ab: Unary<A, B>,\n  bc: Unary<B, C>,\n  cd: Unary<C, D>,\n  de: Unary<D, E>,\n  ef: Unary<E, F>,\n  fg: Unary<F, G>,\n  gh: Unary<G, H>,\n  hi: Unary<H, I>\n): I\nexport function pipe<A, B, C, D, E, F, G, H, I, J>(\n  value: A,\n  ab: Unary<A, B>,\n  bc: Unary<B, C>,\n  cd: Unary<C, D>,\n  de: Unary<D, E>,\n  ef: Unary<E, F>,\n  fg: Unary<F, G>,\n  gh: Unary<G, H>,\n  hi: Unary<H, I>,\n  ij: Unary<I, J>\n): J\nexport function pipe<A, B, C, D, E, F, G, H, I, J, K>(\n  value: A,\n  ab: Unary<A, B>,\n  bc: Unary<B, C>,\n  cd: Unary<C, D>,\n  de: Unary<D, E>,\n  ef: Unary<E, F>,\n  fg: Unary<F, G>,\n  gh: Unary<G, H>,\n  hi: Unary<H, I>,\n  ij: Unary<I, J>,\n  jk: Unary<J, K>\n): K\nexport function pipe(\n  value: PipeRuntimeValue,\n  ...operations: ReadonlyArray<PipeRuntimeOperation>\n): PipeRuntimeValue {\n  return operations.reduce((current, operation) => operation(current), value)\n}\n","import { TaggedError } from 'better-result'\n\n/** Describes a failure encountered while releasing a Resource. */\nexport class ResourceReleaseFailure extends TaggedError('ResourceReleaseFailure')<{\n  readonly resource: string\n  readonly cause: unknown\n  readonly message: string\n}> {}\n","import { Result, type Result as ResultType, type UnhandledException } from 'better-result'\n\nimport { ResourceReleaseFailure } from './errors'\n\nimport { disposeResource } from '../scope/disposable'\n\nexport { disposeResource }\n\nimport type { AsyncResult, MaybePromise, ReleaseFailureObserver, ReleaseOutcome } from './types'\n\nconst toReleaseFailure = (resource: string, cause: unknown): ResourceReleaseFailure =>\n  new ResourceReleaseFailure({\n    resource,\n    cause,\n    message: `Failed to release resource: ${resource}`\n  })\n\nexport const runResult = async <T, E>(\n  operation: () => AsyncResult<T, E>\n): Promise<ResultType<T, E | UnhandledException>> => {\n  const execution = await Result.tryPromise(() => Promise.resolve(operation()))\n\n  return execution.andThen((result) => result)\n}\n\nconst normalizeReleaseOutcome = (\n  name: string,\n  outcome: ReleaseOutcome\n): ResultType<void, ResourceReleaseFailure> => {\n  if (outcome === undefined) {\n    return Result.ok()\n  }\n\n  return outcome.mapError((cause) => toReleaseFailure(name, cause))\n}\n\nexport const runRelease = async <R>(\n  name: string,\n  resource: R,\n  release: (resource: R) => MaybePromise<ReleaseOutcome>\n): Promise<ResultType<void, ResourceReleaseFailure>> => {\n  const execution = await Result.tryPromise({\n    try: () => Promise.resolve(release(resource)),\n    catch: (cause) => toReleaseFailure(name, cause)\n  })\n\n  return execution.andThen((outcome) => normalizeReleaseOutcome(name, outcome))\n}\n\nconst notifyReleaseFailure = async (\n  observer: ReleaseFailureObserver | undefined,\n\n  failure: ResourceReleaseFailure\n): Promise<void> => {\n  if (!observer) {\n    return\n  }\n\n  try {\n    await observer(failure)\n  } catch {\n    /*\n     * Diagnostics must never replace\n     * the actual operation error.\n     */\n  }\n}\n\nexport const combineUseAndRelease = async <A, E>(\n  used: ResultType<A, E>,\n\n  released: ResultType<void, ResourceReleaseFailure>,\n\n  onReleaseFailure?: ReleaseFailureObserver\n): Promise<ResultType<A, E | ResourceReleaseFailure>> => {\n  if (Result.isError(used)) {\n    if (Result.isError(released)) {\n      await notifyReleaseFailure(onReleaseFailure, released.error)\n    }\n\n    return Result.err<A, E | ResourceReleaseFailure>(used.error)\n  }\n\n  if (Result.isError(released)) {\n    await notifyReleaseFailure(onReleaseFailure, released.error)\n\n    return Result.err<A, E | ResourceReleaseFailure>(released.error)\n  }\n\n  return Result.ok<A, E | ResourceReleaseFailure>(used.value)\n}\n","import { Result, type Result as ResultType, type UnhandledException } from 'better-result'\n\nimport { Scope } from '../scope'\n\nimport { ResourceReleaseFailure } from './errors'\n\nimport { combineUseAndRelease, disposeResource, runRelease, runResult } from './internal'\n\nimport type { AcquireUseReleaseOptions } from './types'\n\n/**\n * Acquire a resource, use it, and always attempt release afterward.\n *\n * Acquisition, use, and release may be synchronous or asynchronous Result\n * operations. If both use and release fail, the use error remains primary and\n * `onReleaseFailure` receives the cleanup failure as a diagnostic.\n *\n * When `release` is omitted, `Symbol.asyncDispose` is preferred over\n * `Symbol.dispose`.\n *\n * @example\n * ```ts\n * const result = await Resource.acquireUseRelease({\n *   name: 'database connection',\n *   acquire: () => connect(),\n *   use: (connection) => query(connection),\n *   release: (connection) => connection.close()\n * })\n * ```\n */\nconst acquireUseRelease = <R, A, AcquireError, UseError>({\n  name,\n  acquire,\n  use,\n  release = disposeResource,\n  onReleaseFailure\n}: AcquireUseReleaseOptions<R, A, AcquireError, UseError>): Promise<\n  ResultType<A, AcquireError | UseError | UnhandledException | ResourceReleaseFailure>\n> =>\n  Result.gen(async function* () {\n    const resource = yield* Result.await(runResult(acquire))\n\n    const scope = Scope.make()\n\n    let released: ResultType<void, ResourceReleaseFailure> = Result.ok()\n\n    scope.addFinalizer(async () => {\n      released = await runRelease(name, resource, release)\n    })\n\n    const used = await runResult(() => use(resource))\n\n    await scope.close()\n\n    return await combineUseAndRelease(used, released, onReleaseFailure)\n  })\n\nexport const Resource = {\n  /** Acquire, use, and release a resource with deterministic error precedence. */\n  acquireUseRelease\n} as const\n"],"mappings":";;;;;;;;;AA+FA,SAAgB,KACd,OACA,GAAG,YACe;CAClB,OAAO,WAAW,QAAQ,SAAS,cAAc,UAAU,OAAO,GAAG,KAAK;AAC5E;;;;ACjGA,IAAa,yBAAb,cAA4C,YAAY,wBAAwB,CAAC,CAI9E,CAAC;;;ACGJ,MAAM,oBAAoB,UAAkB,UAC1C,IAAI,uBAAuB;CACzB;CACA;CACA,SAAS,+BAA+B;AAC1C,CAAC;AAEH,MAAa,YAAY,OACvB,cACmD;CAGnD,QAAO,MAFiB,OAAO,iBAAiB,QAAQ,QAAQ,UAAU,CAAC,CAAC,EAAA,CAE3D,SAAS,WAAW,MAAM;AAC7C;AAEA,MAAM,2BACJ,MACA,YAC6C;CAC7C,IAAI,YAAY,KAAA,GACd,OAAO,OAAO,GAAG;CAGnB,OAAO,QAAQ,UAAU,UAAU,iBAAiB,MAAM,KAAK,CAAC;AAClE;AAEA,MAAa,aAAa,OACxB,MACA,UACA,YACsD;CAMtD,QAAO,MALiB,OAAO,WAAW;EACxC,WAAW,QAAQ,QAAQ,QAAQ,QAAQ,CAAC;EAC5C,QAAQ,UAAU,iBAAiB,MAAM,KAAK;CAChD,CAAC,EAAA,CAEgB,SAAS,YAAY,wBAAwB,MAAM,OAAO,CAAC;AAC9E;AAEA,MAAM,uBAAuB,OAC3B,UAEA,YACkB;CAClB,IAAI,CAAC,UACH;CAGF,IAAI;EACF,MAAM,SAAS,OAAO;CACxB,QAAQ,CAKR;AACF;AAEA,MAAa,uBAAuB,OAClC,MAEA,UAEA,qBACuD;CACvD,IAAI,OAAO,QAAQ,IAAI,GAAG;EACxB,IAAI,OAAO,QAAQ,QAAQ,GACzB,MAAM,qBAAqB,kBAAkB,SAAS,KAAK;EAG7D,OAAO,OAAO,IAAmC,KAAK,KAAK;CAC7D;CAEA,IAAI,OAAO,QAAQ,QAAQ,GAAG;EAC5B,MAAM,qBAAqB,kBAAkB,SAAS,KAAK;EAE3D,OAAO,OAAO,IAAmC,SAAS,KAAK;CACjE;CAEA,OAAO,OAAO,GAAkC,KAAK,KAAK;AAC5D;;;;;;;;;;;;;;;;;;;;;;;AC5DA,MAAM,qBAAmD,EACvD,MACA,SACA,KACA,UAAU,iBACV,uBAIA,OAAO,IAAI,mBAAmB;CAC5B,MAAM,WAAW,OAAO,OAAO,MAAM,UAAU,OAAO,CAAC;CAEvD,MAAM,QAAQ,MAAM,KAAK;CAEzB,IAAI,WAAqD,OAAO,GAAG;CAEnE,MAAM,aAAa,YAAY;EAC7B,WAAW,MAAM,WAAW,MAAM,UAAU,OAAO;CACrD,CAAC;CAED,MAAM,OAAO,MAAM,gBAAgB,IAAI,QAAQ,CAAC;CAEhD,MAAM,MAAM,MAAM;CAElB,OAAO,MAAM,qBAAqB,MAAM,UAAU,gBAAgB;AACpE,CAAC;AAEH,MAAa,WAAW;;AAEtB,kBACF"}

package/dist/{internal-identity-DmUpBeeL.mjs → internal-identity-CbXoZIfw.mjs}

@@ -1,4 +1,4 @@
-import { a as ServiceTagCollisionError } from "./errors-Dnjhzbt0.mjs";
+import { f as captureServiceTag, s as ServiceTagCollisionError } from "./registration-drnZk0SY.mjs";
 //#region src/layer/internal-identity.ts
 const serviceMemberNames = (token) => {
 	const names = /* @__PURE__ */ new Set();
@@ -16,7 +16,7 @@ const serviceMemberNames = (token) => {
 * check catches the common incompatible-method collision after erasure.
 */
 const assertServiceCompatibility = (requested, registered, instance) => {
-	if (requested === registered || requested.serviceTag !== registered.serviceTag) return;
+	if (requested === registered || captureServiceTag(requested) !== captureServiceTag(registered)) return;
 	const candidate = Object(instance);
 	if (candidate !== instance) throw new ServiceTagCollisionError(registered, requested);
 	for (const name of serviceMemberNames(requested)) if (!(name in candidate)) throw new ServiceTagCollisionError(registered, requested);
@@ -24,4 +24,4 @@ const assertServiceCompatibility = (requested, registered, instance) => {
 //#endregion
 export { assertServiceCompatibility as t };
 
-//# sourceMappingURL=internal-identity-DmUpBeeL.mjs.map
+//# sourceMappingURL=internal-identity-CbXoZIfw.mjs.map

package/dist/internal-identity-CbXoZIfw.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-identity-CbXoZIfw.mjs","names":[],"sources":["../src/layer/internal-identity.ts"],"sourcesContent":["import { captureServiceTag } from '../service/tag'\nimport type { AnyServiceToken } from '../service'\n\nimport { ServiceTagCollisionError } from './errors'\n\nimport type { LayerRegistration } from './types'\n\ntype LayerAcquiredValue = Awaited<ReturnType<LayerRegistration['acquire']>>\n\nconst serviceMemberNames = (token: AnyServiceToken): readonly (string | symbol)[] => {\n  const names = new Set<string | symbol>()\n  let prototype = token.prototype\n\n  while (prototype && prototype !== Object.prototype) {\n    for (const name of Object.getOwnPropertyNames(prototype)) {\n      if (name !== 'constructor') {\n        names.add(name)\n      }\n    }\n\n    for (const symbol of Object.getOwnPropertySymbols(prototype)) {\n      names.add(symbol)\n    }\n\n    prototype = Object.getPrototypeOf(prototype)\n  }\n\n  return [...names]\n}\n\n/**\n * Check the runtime portion of a same-tag association before returning it.\n * TypeScript remains authoritative for full structural compatibility; this\n * check catches the common incompatible-method collision after erasure.\n */\nexport const assertServiceCompatibility = (\n  requested: AnyServiceToken,\n  registered: AnyServiceToken,\n  instance: LayerAcquiredValue\n): void => {\n  if (requested === registered || captureServiceTag(requested) !== captureServiceTag(registered)) {\n    return\n  }\n\n  const candidate = Object(instance)\n\n  // SAFETY: Service providers are object instances; Object() lets this runtime boundary reject rogue primitive values without trusting their static type.\n  if (candidate !== instance) {\n    throw new ServiceTagCollisionError(registered, requested)\n  }\n\n  for (const name of serviceMemberNames(requested)) {\n    if (!(name in candidate)) {\n      throw new ServiceTagCollisionError(registered, requested)\n    }\n  }\n}\n"],"mappings":";;AASA,MAAM,sBAAsB,UAAyD;CACnF,MAAM,wBAAQ,IAAI,IAAqB;CACvC,IAAI,YAAY,MAAM;CAEtB,OAAO,aAAa,cAAc,OAAO,WAAW;EAClD,KAAK,MAAM,QAAQ,OAAO,oBAAoB,SAAS,GACrD,IAAI,SAAS,eACX,MAAM,IAAI,IAAI;EAIlB,KAAK,MAAM,UAAU,OAAO,sBAAsB,SAAS,GACzD,MAAM,IAAI,MAAM;EAGlB,YAAY,OAAO,eAAe,SAAS;CAC7C;CAEA,OAAO,CAAC,GAAG,KAAK;AAClB;;;;;;AAOA,MAAa,8BACX,WACA,YACA,aACS;CACT,IAAI,cAAc,cAAc,kBAAkB,SAAS,MAAM,kBAAkB,UAAU,GAC3F;CAGF,MAAM,YAAY,OAAO,QAAQ;CAGjC,IAAI,cAAc,UAChB,MAAM,IAAI,yBAAyB,YAAY,SAAS;CAG1D,KAAK,MAAM,QAAQ,mBAAmB,SAAS,GAC7C,IAAI,EAAE,QAAQ,YACZ,MAAM,IAAI,yBAAyB,YAAY,SAAS;AAG9D"}

package/dist/{signal-C1bagvrO.mjs → layer-D56fRdLt.mjs}

@@ -1,11 +1,6 @@
-import { a as ServiceTagCollisionError, l as ServiceRuntimeNotConfiguredError, r as LayerGeneratorYieldError, t as DuplicateServiceError } from "./errors-Dnjhzbt0.mjs";
-import { d as setDefaultRuntimeContextStorage, h as RuntimeContextNotConfiguredError, i as getRuntimeContext, l as makeRuntimeContext, n as currentRuntimeContext, u as runRuntimeContext } from "./context-BUEf1qjL.mjs";
-import { nodeRuntimeContextStorage } from "./runtime/node.mjs";
-//#region src/runtime/default.ts
-/** The Node/Bun storage used by the main Runtime entrypoint. */
-const defaultRuntimeContextStorage = nodeRuntimeContextStorage;
-setDefaultRuntimeContextStorage(defaultRuntimeContextStorage);
-//#endregion
+import { a as LayerGeneratorYieldError, d as ServiceRuntimeNotConfiguredError, f as captureServiceTag, m as validateServiceTag, p as registerServiceTag, r as DuplicateServiceError, s as ServiceTagCollisionError, t as captureLayerRegistrationTag } from "./registration-drnZk0SY.mjs";
+import { h as RuntimeContextNotConfiguredError, i as getRuntimeContext, l as makeRuntimeContext, n as currentRuntimeContext, u as runRuntimeContext } from "./context-BUEf1qjL.mjs";
+import { a as ResourceNotDisposableError, i as getDisposeFinalizer, l as defaultRuntimeContextStorage } from "./signal-D2UTcaaG.mjs";
 //#region src/service/runtime.ts
 /** Provides the resolver context used by Service tokens during execution. */
 var ServiceRuntime = class ServiceRuntime {
@@ -40,6 +35,7 @@ var ServiceRuntime = class ServiceRuntime {
 	}
 	/** Resolve a Service token using the active resolver. */
 	static async resolve(token) {
+		captureServiceTag(token);
 		return await ServiceRuntime.current().resolve(token);
 	}
 };
@@ -69,7 +65,7 @@ var ServiceRuntime = class ServiceRuntime {
 */
 function Service() {
 	return function(tag) {
-		if (tag.length === 0) throw new TypeError("Service tags must not be empty");
+		validateServiceTag(tag);
 		class BaseService {
 			/** The stable logical identity used by Layers and resolver backends. */
 			static serviceTag = tag;
@@ -104,6 +100,7 @@ function Service() {
 				return await ServiceRuntime.resolve(this);
 			}
 		}
+		registerServiceTag(BaseService, tag);
 		return BaseService;
 	};
 }
@@ -142,40 +139,80 @@ var Layer = class Layer {
 	/** The provider registrations retained by this Layer. */
 	providers;
 	constructor(providers) {
-		this.providers = Object.freeze([...providers]);
+		this.providers = Object.freeze(providers.map((provider) => Object.freeze({
+			...provider,
+			serviceTag: captureLayerRegistrationTag(provider)
+		})));
 	}
+	/** A stable provider-free Layer for composition roots with no Services. */
+	static empty = Object.freeze(new Layer([]));
 	static make(service, acquire) {
+		const serviceTag = captureServiceTag(service);
 		const defaultAcquire = () => {
 			return new service();
 		};
 		const normalizedAcquire = normalizeAcquire(acquire ?? defaultAcquire);
 		return new Layer([{
 			service,
+			serviceTag,
 			acquire: normalizedAcquire
 		}]);
 	}
 	/** Create a Layer from an already-constructed Service instance. */
 	static succeed(service, instance) {
+		const serviceTag = captureServiceTag(service);
 		const normalizedAcquire = normalizeAcquire(() => instance);
 		return new Layer([{
 			service,
+			serviceTag,
 			acquire: normalizedAcquire
 		}]);
 	}
+	/** Alias a source Service under a compatible target contract. */
+	static alias(options) {
+		const { from, to } = options;
+		captureServiceTag(from);
+		return Layer.gen(to, async function* () {
+			return await ServiceRuntime.resolve(from);
+		});
+	}
 	/** Define a provider with Runtime-root cleanup. */
 	static scoped(service, acquire, release) {
+		const serviceTag = captureServiceTag(service);
 		return new Layer([{
 			service,
+			serviceTag,
 			acquire: normalizeAcquire(acquire),
 			release: (instance, outcome) => {
 				return release(instance, outcome);
 			}
 		}]);
 	}
+	/** Define a provider with Runtime-root cleanup through its disposal protocol. */
+	static scopedDisposable(service, acquire) {
+		const acquireWithRelease = async () => {
+			const instance = await acquire();
+			const finalizer = getDisposeFinalizer(instance);
+			if (!finalizer) throw new ResourceNotDisposableError();
+			return {
+				instance,
+				release: finalizer
+			};
+		};
+		const serviceTag = captureServiceTag(service);
+		return new Layer([{
+			service,
+			serviceTag,
+			acquire: async () => (await acquireWithRelease()).instance,
+			acquireWithRelease
+		}]);
+	}
 	/** Define a provider whose acquisition can yield contextual Services. */
 	static scopedGen(service, factory, release) {
+		const serviceTag = captureServiceTag(service);
 		return new Layer([{
 			service,
+			serviceTag,
 			acquire: () => runLayerGenerator(service, factory),
 			release: (instance, outcome) => {
 				return release(instance, outcome);
@@ -184,8 +221,10 @@ var Layer = class Layer {
 	}
 	/** Define a provider whose acquisition can yield contextual Services. */
 	static gen(service, factory) {
+		const serviceTag = captureServiceTag(service);
 		return new Layer([{
 			service,
+			serviceTag,
 			acquire: () => runLayerGenerator(service, factory)
 		}]);
 	}
@@ -194,12 +233,13 @@ var Layer = class Layer {
 		const providers = /* @__PURE__ */ new Map();
 		for (const layer of layers) for (const provider of layer.providers) {
 			const service = provider.service;
-			const existing = providers.get(service.serviceTag);
+			const serviceTag = captureLayerRegistrationTag(provider);
+			const existing = providers.get(serviceTag);
 			if (existing) {
 				if (existing.service !== service) throw new ServiceTagCollisionError(existing.service, service);
 				throw new DuplicateServiceError(service);
 			}
-			providers.set(service.serviceTag, provider);
+			providers.set(serviceTag, provider);
 		}
 		return new Layer([...providers.values()]);
 	}
@@ -209,63 +249,21 @@ var Layer = class Layer {
 	}
 	static override(base, ...overrides) {
 		const providers = /* @__PURE__ */ new Map();
-		for (const provider of base.providers) providers.set(provider.service.serviceTag, provider);
-		for (const layer of overrides) for (const provider of layer.providers) providers.set(provider.service.serviceTag, provider);
+		for (const provider of base.providers) providers.set(captureLayerRegistrationTag(provider), provider);
+		for (const layer of overrides) for (const provider of layer.providers) providers.set(captureLayerRegistrationTag(provider), provider);
 		return new Layer([...providers.values()]);
 	}
 };
+Object.defineProperty(Layer, "empty", {
+	value: Layer.empty,
+	writable: false,
+	enumerable: true,
+	configurable: false
+});
 const normalizeAcquire = (acquire) => () => {
 	return acquire();
 };
 //#endregion
-//#region src/runtime/signal.ts
-const neverAbortedSignal = new AbortController().signal;
-/** Link caller, Runtime and shutdown signals without owning the caller's controller. */
-const linkAbortSignals = (...signals) => {
-	const active = signals.filter((signal) => signal !== void 0);
-	if (active.length === 0) return {
-		signal: neverAbortedSignal,
-		dispose: () => {}
-	};
-	if (active.length === 1) return {
-		signal: active[0],
-		dispose: () => {}
-	};
-	const controller = new AbortController();
-	const listeners = [];
-	let disposed = false;
-	const dispose = () => {
-		if (disposed) return;
-		disposed = true;
-		for (const [source, listener] of listeners) source.removeEventListener("abort", listener);
-		listeners.length = 0;
-	};
-	const abortFrom = (source) => {
-		if (controller.signal.aborted) return;
-		controller.abort(source.reason);
-		dispose();
-	};
-	for (const source of active) {
-		if (source.aborted) {
-			abortFrom(source);
-			break;
-		}
-		const listener = () => abortFrom(source);
-		listeners.push([source, listener]);
-		source.addEventListener("abort", listener, { once: true });
-	}
-	return {
-		signal: controller.signal,
-		dispose
-	};
-};
-/** Return the current cooperative-cancellation signal. */
-const currentAbortSignal = () => currentRuntimeContext().signal ?? neverAbortedSignal;
-/** Yieldable access to the signal of the current Runtime execution. */
-const CurrentAbortSignal = { *[Symbol.iterator]() {
-	return currentAbortSignal();
-} };
-//#endregion
-export { ServiceRuntime as a, Service as i, linkAbortSignals as n, defaultRuntimeContextStorage as o, Layer as r, CurrentAbortSignal as t };
+export { Service as n, ServiceRuntime as r, Layer as t };
 
-//# sourceMappingURL=signal-C1bagvrO.mjs.map
+//# sourceMappingURL=layer-D56fRdLt.mjs.map

package/dist/layer-D56fRdLt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer-D56fRdLt.mjs","names":["Constructor"],"sources":["../src/service/runtime.ts","../src/service/service.ts","../src/layer/internal.ts","../src/layer/layer.ts"],"sourcesContent":["import { ServiceRuntimeNotConfiguredError } from './errors'\nimport { captureServiceTag } from './tag'\n\nimport { RuntimeContextNotConfiguredError } from '../runtime/errors'\n\nimport {\n  currentRuntimeContext,\n  getRuntimeContext,\n  makeRuntimeContext,\n  runRuntimeContext\n} from '../runtime/context'\n\nimport { defaultRuntimeContextStorage } from '../runtime/default'\n\nimport type { AnyServiceToken } from './types'\n\nimport type { RuntimeContextStorage } from '../runtime/context'\n\n/** Resolves class-backed Service tokens for a runtime execution. */\nexport interface ServiceResolver {\n  /** Resolve a token to its corresponding Service instance. */\n  resolve<T extends AnyServiceToken>(token: T): InstanceType<T> | PromiseLike<InstanceType<T>>\n}\n\n/** Provides the resolver context used by Service tokens during execution. */\nexport class ServiceRuntime {\n  /**\n   * Run a callback with a resolver available to `yield* Service` expressions.\n   *\n   * The context is scoped to the callback and is restored afterward.\n   *\n   * @example\n   * ```ts\n   * const value = ServiceRuntime.run(resolver, () => {\n   *   return ServiceRuntime.resolve(Database)\n   * })\n   * ```\n   */\n  static run<A>(\n    resolver: ServiceResolver,\n    program: () => A,\n    storage: RuntimeContextStorage = defaultRuntimeContextStorage\n  ): A {\n    const current = getRuntimeContext(storage)\n    const context = makeRuntimeContext(\n      resolver,\n      current?.scope,\n      current?.resolver === resolver ? current.resolutionPath : [],\n      current?.signal,\n      current?.resolver === resolver ? current : undefined\n    )\n\n    return runRuntimeContext(storage, context, program)\n  }\n\n  /** Return the resolver active in the current execution context. */\n  static current(): ServiceResolver {\n    let context\n\n    try {\n      context = currentRuntimeContext()\n    } catch (cause) {\n      if (cause instanceof RuntimeContextNotConfiguredError) {\n        throw new ServiceRuntimeNotConfiguredError()\n      }\n\n      throw cause\n    }\n\n    if (!context.resolver) {\n      throw new ServiceRuntimeNotConfiguredError()\n    }\n\n    return context.resolver\n  }\n\n  /** Resolve a Service token using the active resolver. */\n  static async resolve<T extends AnyServiceToken>(token: T): Promise<InstanceType<T>> {\n    captureServiceTag(token)\n    const resolver = ServiceRuntime.current()\n\n    return await resolver.resolve(token)\n  }\n}\n","import { ServiceRuntime } from './runtime'\nimport { registerServiceTag, validateServiceTag } from './tag'\n\nimport type { ServiceRequirement } from '../effect/types'\n\nimport type {\n  AnyService,\n  AnyServiceToken,\n  ServiceClass,\n  ServiceContract,\n  ServiceIdentity,\n  ServiceIdentityTypeId,\n  ServiceInstance,\n  ServiceRequirements,\n  ServiceTag,\n  ServiceToken,\n  ServiceTokenOf\n} from './types'\n\ntype ServiceTagLiteral<Tag extends string> = string extends Tag\n  ? never\n  : Tag extends ''\n    ? never\n    : Tag\n\ninterface ServiceFactory<Self> {\n  <const Tag extends string>(\n    tag: ServiceTagLiteral<Tag>\n  ): (abstract new () => ServiceIdentity<Tag>) & {\n    readonly name: string\n    readonly serviceTag: Tag\n  } & {\n    readonly of: Service.FactoryOf<Self, Tag>\n    readonly [Symbol.asyncIterator]: (\n      this: ServiceToken<Tag, Self & ServiceIdentity<Tag>>\n    ) => AsyncGenerator<ServiceRequirement<Self>, Self, unknown>\n  }\n}\n\n/**\n * Declare a class-backed Service with a stable string-literal identity.\n *\n * The returned class is simultaneously the implementation type, the runtime\n * dependency token, and the value yielded by `yield*` in an Effect generator.\n * The explicit self type preserves exact instance inference, while the second\n * call captures the tag as a literal for Layer composition and diagnostics.\n *\n * @example\n * ```ts\n * class Database extends Service<Database>()('Database') {\n *   query(): string {\n *     return 'ok'\n *   }\n * }\n *\n * const database = yield* Database\n * database.query()\n * ```\n *\n * @typeParam Self The instance type implemented by the declared Service.\n */\nexport function Service<Self>(): ServiceFactory<Self> {\n  return function <const Tag extends string>(tag: ServiceTagLiteral<Tag>) {\n    validateServiceTag(tag)\n\n    abstract class BaseService implements ServiceIdentity<Tag> {\n      /** The stable logical identity used by Layers and resolver backends. */\n      static readonly serviceTag: Tag = tag\n      declare readonly [ServiceIdentityTypeId]: Tag\n\n      /**\n       * Type-check a structural implementation of this Service.\n       *\n       * This is an identity helper. It returns the supplied value unchanged\n       * and does not invoke a constructor or modify its prototype.\n       *\n       * @example\n       * ```ts\n       * class Database extends Service<Database>()('Database') {\n       *   query(sql: string): string {\n       *     return sql\n       *   }\n       * }\n       *\n       * const database = Database.of({\n       *   query: (sql) => `Result: ${sql}`\n       * })\n       *\n       * database.query('SELECT 1')\n       * // 'Result: SELECT 1'\n       * // database is the original object, not an instance of Database\n       * ```\n       */\n      static of(this: void, implementation: ServiceContract<Self & ServiceIdentity<Tag>>): Self {\n        // SAFETY: ServiceContract removes only the phantom marker; this boundary restores Self.\n        return implementation as Self\n      }\n\n      /** Resolve this Service from the resolver active in the current runtime. */\n      // oxlint-disable-next-line require-yield\n      static async *[Symbol.asyncIterator](\n        this: ServiceToken<Tag, Self & ServiceIdentity<Tag>>\n      ): AsyncGenerator<ServiceRequirement<Self>, Self, unknown> {\n        return await ServiceRuntime.resolve(this)\n      }\n    }\n\n    registerServiceTag(BaseService, tag)\n\n    return BaseService\n  }\n}\n\n/** Type-level aliases for Service tokens and their instance contracts. */\nexport declare namespace Service {\n  /** The widened Service instance constraint. */\n  export type Any = AnyService\n\n  /** A class-backed Service token with a stable tag and instance contract. */\n  export type Token<Tag extends string = string, Instance extends AnyService = any> = ServiceToken<\n    Tag,\n    Instance\n  >\n\n  /** A constructible Service class with a stable tag and instance contract. */\n  export type Class<\n    Tag extends string = string,\n    Instance extends AnyService = AnyService\n  > = ServiceClass<Tag, Instance>\n\n  /** Extract the instance represented by a Service token. */\n  export type Instance<T extends AnyServiceToken> = ServiceInstance<T>\n\n  /** Extract the stable tag represented by a Service instance. */\n  export type Tag<S extends AnyService> = ServiceTag<S>\n\n  /** A branded Service instance identity with a stable tag. */\n  export type Identity<Tag extends string = string> = ServiceIdentity<Tag>\n\n  /** Remove the internal identity marker from a Service implementation contract. */\n  export type Contract<S extends AnyService> = ServiceContract<S>\n\n  /** Extract the Service token represented by a branded Service instance. */\n  export type TokenOf<S extends AnyService> = ServiceTokenOf<S>\n\n  /** Declaration bridge for the recursive structural `Service.of` signature. */\n  export type FactoryOf<Self, Tag extends string> = (\n    this: void,\n    implementation: ServiceContract<Self & ServiceIdentity<Tag>>\n  ) => Self\n\n  /** Extract Effect Service requirements from a Service instance. */\n  export type Requirements<S extends AnyService> = ServiceRequirements<S>\n}\n","import { LayerGeneratorYieldError } from './errors'\n\nimport type { ServiceRequirement } from '../effect/types'\nimport type { ServiceClass } from '../service'\n\nimport type { LayerGenerator } from './types'\n\nexport const runLayerGenerator = async <\n  S extends ServiceClass<any, any>,\n  Yield extends ServiceRequirement<unknown>\n>(\n  service: S,\n  factory: LayerGenerator<S, Yield>\n): Promise<InstanceType<S>> => {\n  const iterator = factory()\n\n  const state = await iterator.next()\n\n  if (!state.done) {\n    try {\n      // SAFETY: The iterator is closed only to discard an invalid yield; its return value is ignored.\n      await iterator.return(undefined as never)\n    } finally {\n      // oxlint-disable-next-line no-unsafe-finally\n      throw new LayerGeneratorYieldError(service)\n    }\n  }\n\n  // SAFETY: The public generator boundary accepts only the requested Service contract.\n  return state.value as InstanceType<S>\n}\n","import type { ServiceRequirement } from '../effect/types'\nimport { ServiceRuntime } from '../service'\nimport { captureServiceTag } from '../service/tag'\nimport type { AnyService, ServiceClass, ServiceContract, ServiceRequirements } from '../service'\nimport { ResourceNotDisposableError } from '../scope'\nimport { getDisposeFinalizer } from '../scope/disposable'\n\nimport type { DisposableResource, ScopeFinalizer, ScopeOutcome } from '../scope'\nimport type { Covariant, Invariant } from '../internal/variance'\nimport type { MaybePromise } from '../utils/types'\n\nimport { DuplicateServiceError, ServiceTagCollisionError } from './errors'\nimport { runLayerGenerator } from './internal'\nimport { captureLayerRegistrationTag } from './registration'\n\nimport type {\n  LayerInput,\n  CompleteInput,\n  LayerResult,\n  MergeResult,\n  OverrideLayerResult,\n  ValidateLayerInput,\n  ValidateLayerTuple,\n  ValidateOverrides,\n  ProvidedEnvironment,\n  RequiredEnvironment\n} from './inference'\nimport type { ProviderEntry } from './metadata'\nimport type { LayerGenerator, LayerGeneratorRequirements, LayerRegistration } from './types'\n\ndeclare const LayerTypeId: unique symbol\n\ninterface LayerVariance<in out Provided, out Required> {\n  readonly _Provided: Invariant<Provided>\n  readonly _Required: Covariant<Required>\n}\n\ntype CapturedLayerAcquisition = {\n  readonly instance: unknown\n  readonly release: ScopeFinalizer\n}\n\ninterface LayerProvider extends LayerRegistration {\n  /** The tag captured before this provider can cross an asynchronous boundary. */\n  readonly serviceTag: string\n\n  /** Provider storage deliberately erases the concrete instance type. */\n  // oxlint-disable-next-line anti-slop/no-unknown-parameters\n  readonly release?: (instance: unknown, outcome: ScopeOutcome) => MaybePromise<void>\n\n  /** Capture acquisition-local cleanup without retaining the acquired instance. */\n  readonly acquireWithRelease?: () => MaybePromise<CapturedLayerAcquisition>\n}\n\n/** A Service class whose constructor can be called without arguments. */\ntype DefaultConstructibleServiceClass<\n  Tag extends string = string,\n  Instance extends AnyService = AnyService\n> = ServiceClass<Tag, Instance> & (new () => Instance)\n\ntype IsUnion<Type, Candidate = Type> = Type extends unknown\n  ? [Candidate] extends [Type]\n    ? false\n    : true\n  : never\n\ntype InvalidUnionAliasToken = {\n  readonly __betterEffectUnionLayerAliasToken: unique symbol\n}\n\ntype RejectUnionAliasToken<Token> = IsUnion<Token> extends true ? InvalidUnionAliasToken : unknown\n\ntype LayerAliasOptions<From extends ServiceClass<any, any>, To extends ServiceClass<any, any>> = {\n  readonly from: From\n  readonly to: To\n} & RejectUnionAliasToken<From> &\n  RejectUnionAliasToken<To> &\n  ([ServiceContract<InstanceType<From>>] extends [ServiceContract<InstanceType<To>>]\n    ? unknown\n    : {\n        readonly __betterEffectIncompatibleLayerAlias: unique symbol\n      })\n\n/**\n * Declarative collection of Service providers.\n *\n * A Layer describes how to acquire implementations; it does not execute\n * providers until a `Runtime` is created. Use `merge` to compose distinct\n * providers and `override` when replacing an existing provider intentionally.\n *\n * @example\n * ```ts\n * const AppLive = Layer.merge(\n *   Layer.succeed(Database, database),\n *   Layer.make(UserRepository)\n * )\n *\n * const runtime = await Runtime.make(AppLive, backend)\n * ```\n */\nexport class Layer<\n  in out Provided extends AnyService = AnyService,\n  out Required extends AnyService = AnyService\n> {\n  declare readonly [LayerTypeId]: LayerVariance<Provided, Required>\n\n  /** The provider registrations retained by this Layer. */\n  readonly providers: readonly LayerProvider[]\n\n  private constructor(providers: readonly LayerProvider[]) {\n    this.providers = Object.freeze(\n      providers.map((provider) =>\n        Object.freeze({\n          ...provider,\n          serviceTag: captureLayerRegistrationTag(provider)\n        })\n      )\n    )\n  }\n\n  /** A stable provider-free Layer for composition roots with no Services. */\n  static readonly empty: Layer<never, never> = Object.freeze(new Layer<never, never>([]))\n\n  /** Create a Layer that lazily acquires a Service instance. */\n  static make<S extends DefaultConstructibleServiceClass<any, any>>(\n    service: S\n  ): LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>>\n\n  static make<S extends ServiceClass<any, any>>(\n    service: S,\n    acquire: () => MaybePromise<ServiceContract<InstanceType<S>>>\n  ): LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>>\n\n  static make<S extends ServiceClass<any, any>>(\n    service: S,\n    acquire?: () => MaybePromise<ServiceContract<InstanceType<S>>>\n  ): LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>> {\n    const serviceTag = captureServiceTag(service)\n    const defaultAcquire = (): InstanceType<S> => {\n      // SAFETY: The no-argument overload constrains `service` to a default constructible class.\n      const Constructor = service as new () => InstanceType<S>\n\n      return new Constructor()\n    }\n\n    const normalizedAcquire = normalizeAcquire<S>(acquire ?? defaultAcquire)\n\n    // SAFETY: Runtime storage erases only the concrete provider metadata; the public constructor result restores its typed provenance.\n    return new Layer([\n      {\n        service,\n        serviceTag,\n        acquire: normalizedAcquire\n      }\n    ]) as LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>>\n  }\n\n  /** Create a Layer from an already-constructed Service instance. */\n  static succeed<S extends ServiceClass<any, any>>(\n    service: S,\n    instance: ServiceContract<InstanceType<S>>\n  ): LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>> {\n    const serviceTag = captureServiceTag(service)\n    const normalizedAcquire = normalizeAcquire<S>(() => instance)\n\n    // SAFETY: The structural instance has been checked against the requested Service contract.\n    return new Layer([\n      {\n        service,\n        serviceTag,\n        acquire: normalizedAcquire\n      }\n    ]) as LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>>\n  }\n\n  /** Alias a source Service under a compatible target contract. */\n  static alias<From extends ServiceClass<any, any>, To extends ServiceClass<any, any>>(\n    options: LayerAliasOptions<From, To>\n  ): LayerResult<\n    ProviderEntry<InstanceType<To>, InstanceType<From> | ServiceRequirements<InstanceType<To>>>\n  > {\n    const { from, to } = options\n    void captureServiceTag(from)\n\n    // Keep alias acquisition in the normal Layer generator path so Runtime supplies the active resolver and resolution diagnostics.\n    // oxlint-disable-next-line require-yield\n    const alias = Layer.gen(to, async function* () {\n      const source = await ServiceRuntime.resolve(from)\n\n      // SAFETY: LayerAliasOptions checks that the source implementation satisfies the target contract.\n      return source as ServiceContract<InstanceType<To>>\n    })\n\n    // SAFETY: The alias factory resolves the declared source token before returning the target contract.\n    return alias as LayerResult<\n      ProviderEntry<InstanceType<To>, InstanceType<From> | ServiceRequirements<InstanceType<To>>>\n    >\n  }\n\n  /** Define a provider with Runtime-root cleanup. */\n  static scoped<S extends ServiceClass<any, any>>(\n    service: S,\n    acquire: () => MaybePromise<ServiceContract<InstanceType<S>>>,\n    release: (instance: InstanceType<S>, outcome: ScopeOutcome) => MaybePromise<void>\n  ): LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>> {\n    const serviceTag = captureServiceTag(service)\n\n    // SAFETY: The public callbacks constrain acquisition and release to the requested Service.\n    return new Layer([\n      {\n        service,\n        serviceTag,\n        acquire: normalizeAcquire<S>(acquire),\n        release: (instance, outcome) => {\n          // SAFETY: The backend invokes release with the instance acquired for this token.\n          return release(instance as InstanceType<S>, outcome)\n        }\n      }\n    ]) as LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>>\n  }\n\n  /** Define a provider with Runtime-root cleanup through its disposal protocol. */\n  static scopedDisposable<S extends ServiceClass<any, any>>(\n    service: S,\n    acquire: () => MaybePromise<ServiceContract<InstanceType<S>> & DisposableResource>\n  ): LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>> {\n    const acquireWithRelease = async (): Promise<CapturedLayerAcquisition> => {\n      const instance = await acquire()\n      const finalizer = getDisposeFinalizer(instance)\n\n      if (!finalizer) {\n        throw new ResourceNotDisposableError()\n      }\n\n      return { instance, release: finalizer }\n    }\n\n    const serviceTag = captureServiceTag(service)\n\n    // SAFETY: The public callback constrains the acquired value and this runtime-only carrier is erased at the Layer boundary.\n    return new Layer([\n      {\n        service,\n        serviceTag,\n        acquire: async () => (await acquireWithRelease()).instance,\n        acquireWithRelease\n      }\n    ]) as LayerResult<ProviderEntry<InstanceType<S>, ServiceRequirements<InstanceType<S>>>>\n  }\n\n  /** Define a provider whose acquisition can yield contextual Services. */\n  static scopedGen<S extends ServiceClass<any, any>, Yield extends ServiceRequirement<unknown>>(\n    service: S,\n    factory: LayerGenerator<S, Yield>,\n    release: (instance: InstanceType<S>, outcome: ScopeOutcome) => MaybePromise<void>\n  ): LayerResult<ProviderEntry<InstanceType<S>, LayerGeneratorRequirements<S, Yield>>> {\n    const serviceTag = captureServiceTag(service)\n\n    // SAFETY: The generator and release callback are checked against the requested Service.\n    return new Layer([\n      {\n        service,\n        serviceTag,\n        acquire: () => runLayerGenerator(service, factory),\n        release: (instance, outcome) => {\n          // SAFETY: The backend invokes release with the instance acquired for this token.\n          return release(instance as InstanceType<S>, outcome)\n        }\n      }\n    ]) as LayerResult<ProviderEntry<InstanceType<S>, LayerGeneratorRequirements<S, Yield>>>\n  }\n\n  /** Define a provider whose acquisition can yield contextual Services. */\n  static gen<S extends ServiceClass<any, any>, Yield extends ServiceRequirement<unknown>>(\n    service: S,\n    factory: LayerGenerator<S, Yield>\n  ): LayerResult<ProviderEntry<InstanceType<S>, LayerGeneratorRequirements<S, Yield>>> {\n    const serviceTag = captureServiceTag(service)\n\n    // SAFETY: The generator result is normalized to the requested Service at the runtime boundary.\n    return new Layer([\n      {\n        service,\n        serviceTag,\n        acquire: () => runLayerGenerator(service, factory)\n      }\n    ]) as LayerResult<ProviderEntry<InstanceType<S>, LayerGeneratorRequirements<S, Yield>>>\n  }\n\n  /** Compose Layers without replacing providers. */\n  static merge<const Layers extends readonly LayerInput[]>(\n    ...layers: Layers & ValidateLayerTuple<Layers>\n  ): MergeResult<Layers> {\n    const providers = new Map<string, LayerProvider>()\n\n    for (const layer of layers) {\n      for (const provider of layer.providers) {\n        const service = provider.service\n        const serviceTag = captureLayerRegistrationTag(provider)\n        const existing = providers.get(serviceTag)\n\n        if (existing) {\n          if (existing.service !== service) {\n            throw new ServiceTagCollisionError(existing.service, service)\n          }\n\n          throw new DuplicateServiceError(service)\n        }\n\n        providers.set(serviceTag, provider)\n      }\n    }\n\n    // SAFETY: The heterogeneous provider list is erased only at this internal storage boundary.\n    return new Layer([...providers.values()]) as MergeResult<Layers>\n  }\n\n  /** Mark a Layer composition root as complete without changing its runtime value. */\n  static complete<L extends LayerInput>(layer: L & CompleteInput<L>): L {\n    return layer\n  }\n\n  /** Replace providers in a base Layer, using tag identity and compatible contracts. */\n  static override<Base extends LayerInput>(\n    base: Base & ValidateLayerInput<Base>\n  ): OverrideLayerResult<Base, readonly []>\n\n  static override<\n    Base extends LayerInput,\n    const Overrides extends readonly [LayerInput, ...LayerInput[]]\n  >(\n    base: Base & ValidateLayerInput<Base>,\n    ...overrides: Overrides & ValidateOverrides<Base, Overrides>\n  ): OverrideLayerResult<Base, Overrides>\n\n  static override<Base extends LayerInput, const Overrides extends readonly LayerInput[]>(\n    base: Base & ValidateLayerInput<Base>,\n    ...overrides: Overrides & ValidateOverrides<Base, Overrides>\n  ): OverrideLayerResult<Base, Overrides>\n\n  static override(base: LayerInput, ...overrides: readonly LayerInput[]): Layer<any, any> {\n    const providers = new Map<string, LayerProvider>()\n\n    for (const provider of base.providers) {\n      providers.set(captureLayerRegistrationTag(provider), provider)\n    }\n\n    for (const layer of overrides) {\n      for (const provider of layer.providers) {\n        providers.set(captureLayerRegistrationTag(provider), provider)\n      }\n    }\n\n    // SAFETY: Runtime provider replacement preserves the computed override metadata.\n    return new Layer([...providers.values()]) as Layer<any, any>\n  }\n}\n\n// TypeScript's `readonly` does not affect the runtime property descriptor. Keep\n// the class field's enumerable behavior while locking the singleton binding.\nObject.defineProperty(Layer, 'empty', {\n  value: Layer.empty,\n  writable: false,\n  enumerable: true,\n  configurable: false\n})\n\nconst normalizeAcquire =\n  <S extends ServiceClass<any, any>>(\n    acquire: () => MaybePromise<ServiceContract<InstanceType<S>>>\n  ): (() => MaybePromise<InstanceType<S>>) =>\n  () => {\n    // SAFETY: ServiceContract removes only the declaration-only identity; runtime values are unchanged.\n    return acquire() as MaybePromise<InstanceType<S>>\n  }\n\n/** Type-level aliases for inspecting Layer environments and completeness. */\nexport declare namespace Layer {\n  /** The widened Layer shape accepted by generic Layer infrastructure. */\n  export type Any = LayerInput\n\n  /** Extract the branded Service instances provided by a Layer. */\n  export type Provided<L extends LayerInput> = ProvidedEnvironment<L>\n\n  /** Extract the external Service requirements of a Layer. */\n  export type Required<L extends LayerInput> = RequiredEnvironment<L>\n\n  /** Extract the Services still missing from a Layer composition. */\n  export type Missing<L extends LayerInput> = RequiredEnvironment<L>\n\n  /** Validate a Layer's requirements and input shape. */\n  export type Complete<L extends LayerInput> = CompleteInput<L>\n}\n"],"mappings":"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"}

package/dist/node-context-DWsCUBRa.d.mts

@@ -0,0 +1,12 @@
+import { c as RuntimeContextStorage, s as RuntimeContext } from "./index-heuaRmXR.mjs";
+//#region src/runtime/node-context.d.ts
+/** RuntimeContextStorage backed by Node/Bun async context propagation. */
+declare class NodeRuntimeContextStorage implements RuntimeContextStorage {
+  run<A>(context: RuntimeContext, program: () => A): A;
+  current(): RuntimeContext;
+}
+/** Shared Node/Bun storage used by the compatibility APIs and default Runtime. */
+declare const nodeRuntimeContextStorage: NodeRuntimeContextStorage;
+//#endregion
+export { nodeRuntimeContextStorage as n, NodeRuntimeContextStorage as t };
+//# sourceMappingURL=node-context-DWsCUBRa.d.mts.map

package/dist/node-context-DWsCUBRa.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-context-DWsCUBRa.d.mts","names":[],"sources":["../src/runtime/node-context.ts"],"mappings":";;;cA2Ba,qCAAqC;EAChD,IAAI,GAAG,SAAS,gBAAgB,eAAe,IAAI;EAInD,WAAW;;;cAYA,2BAAyB"}

package/dist/node-context-lggRF4bR.mjs

@@ -0,0 +1,25 @@
+import { f as setRuntimeContextFrameCarrier, h as RuntimeContextNotConfiguredError, m as withActiveRuntimeContextStorage, r as currentRuntimeContextFrame } from "./context-BUEf1qjL.mjs";
+import { AsyncLocalStorage } from "node:async_hooks";
+//#region src/runtime/node-context.ts
+const asyncLocalStorage = new AsyncLocalStorage();
+setRuntimeContextFrameCarrier({
+	run: (frame, program) => asyncLocalStorage.run(frame, program),
+	current: () => asyncLocalStorage.getStore()
+});
+/** RuntimeContextStorage backed by Node/Bun async context propagation. */
+var NodeRuntimeContextStorage = class {
+	run(context, program) {
+		return withActiveRuntimeContextStorage(this, context, program);
+	}
+	current() {
+		const frame = currentRuntimeContextFrame();
+		if (!frame || frame.storage !== this) throw new RuntimeContextNotConfiguredError();
+		return frame.context;
+	}
+};
+/** Shared Node/Bun storage used by the compatibility APIs and default Runtime. */
+const nodeRuntimeContextStorage = new NodeRuntimeContextStorage();
+//#endregion
+export { nodeRuntimeContextStorage as n, NodeRuntimeContextStorage as t };
+
+//# sourceMappingURL=node-context-lggRF4bR.mjs.map

package/dist/node-context-lggRF4bR.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-context-lggRF4bR.mjs","names":[],"sources":["../src/runtime/node-context.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\n\nimport { RuntimeContextNotConfiguredError } from './errors'\n\nimport {\n  currentRuntimeContextFrame,\n  setRuntimeContextFrameCarrier,\n  withActiveRuntimeContextStorage\n} from './context'\n\nimport type {\n  ActiveRuntimeContextFrame,\n  RuntimeContext,\n  RuntimeContextFrameCarrier,\n  RuntimeContextStorage\n} from './context'\n\nconst asyncLocalStorage = new AsyncLocalStorage<ActiveRuntimeContextFrame>()\n\nconst frameCarrier: RuntimeContextFrameCarrier = {\n  run: (frame, program) => asyncLocalStorage.run(frame, program),\n  current: () => asyncLocalStorage.getStore()\n}\n\nsetRuntimeContextFrameCarrier(frameCarrier)\n\n/** RuntimeContextStorage backed by Node/Bun async context propagation. */\nexport class NodeRuntimeContextStorage implements RuntimeContextStorage {\n  run<A>(context: RuntimeContext, program: () => A): A {\n    return withActiveRuntimeContextStorage(this, context, program)\n  }\n\n  current(): RuntimeContext {\n    const frame = currentRuntimeContextFrame()\n\n    if (!frame || frame.storage !== this) {\n      throw new RuntimeContextNotConfiguredError()\n    }\n\n    return frame.context\n  }\n}\n\n/** Shared Node/Bun storage used by the compatibility APIs and default Runtime. */\nexport const nodeRuntimeContextStorage = new NodeRuntimeContextStorage()\n\nexport { RuntimeContextNotConfiguredError } from './errors'\n\nexport type { RuntimeContext, RuntimeContextStorage } from './context'\n"],"mappings":";;;AAiBA,MAAM,oBAAoB,IAAI,kBAA6C;AAO3E,8BAA8B;CAJ5B,MAAM,OAAO,YAAY,kBAAkB,IAAI,OAAO,OAAO;CAC7D,eAAe,kBAAkB,SAAS;AAGH,CAAC;;AAG1C,IAAa,4BAAb,MAAwE;CACtE,IAAO,SAAyB,SAAqB;EACnD,OAAO,gCAAgC,MAAM,SAAS,OAAO;CAC/D;CAEA,UAA0B;EACxB,MAAM,QAAQ,2BAA2B;EAEzC,IAAI,CAAC,SAAS,MAAM,YAAY,MAC9B,MAAM,IAAI,iCAAiC;EAG7C,OAAO,MAAM;CACf;AACF;;AAGA,MAAa,4BAA4B,IAAI,0BAA0B"}

package/dist/node.d.mts

@@ -0,0 +1,51 @@
+import { C as EffectError, E as EffectSuccess, c as RuntimeContextStorage, s as RuntimeContext } from "./index-heuaRmXR.mjs";
+import { C as CompleteExecution, D as LayerInput, M as ProvidedEnvironment, T as CompleteInput, r as RuntimeOptions, y as LayerBackend } from "./outcome-CB43bnFW.mjs";
+import { t as RuntimeContextNotConfiguredError } from "./errors-BKcsQ0ip.mjs";
+import "./index-CX6iAoCB.mjs";
+import { n as nodeRuntimeContextStorage, t as NodeRuntimeContextStorage } from "./node-context-DWsCUBRa.mjs";
+import { Result } from "better-result";
+//#region src/runtime/node-runtime.d.ts
+/** Process signals supported by the Node.js/Bun process boundary. */
+type NodeRuntimeSignal = 'SIGINT' | 'SIGTERM';
+/** Translate a successful main result to a process exit code. */
+type NodeRuntimeSuccessHandler<Success> = (value: Success) => number;
+/** Translate a typed main failure to a process exit code. */
+type NodeRuntimeFailureHandler<Failure> = (error: Failure) => number;
+/** Observe a thrown or rejected main defect while it remains a rejected Promise. */
+type NodeRuntimeDefectHandler = (cause: unknown) => number | void;
+/** Options for the Node.js/Bun process boundary. */
+type NodeRuntimeOptions<Success = unknown, Failure = unknown> = RuntimeOptions & {
+  /** Process signals that request cooperative shutdown. Defaults to SIGINT and SIGTERM. */
+  readonly signals?: readonly NodeRuntimeSignal[];
+  /** Map a nominal Result.ok value, or a plain successful value, to an exit code. */
+  readonly onSuccess?: NodeRuntimeSuccessHandler<Success>;
+  /** Map a nominal Result.err error to an exit code. */
+  readonly onFailure?: NodeRuntimeFailureHandler<Failure>;
+  /** Observe a defect. Defects are rethrown after the handler runs. */
+  readonly onDefect?: NodeRuntimeDefectHandler;
+};
+type NonResultMainSuccess<Value> = Value extends Result<any, any> ? never : Value;
+type PlainMainSuccess<Value> = NonResultMainSuccess<Awaited<Value>>;
+type MainSuccess<Value> = EffectSuccess<Value> | PlainMainSuccess<Value>;
+type MainFailure<Value> = EffectError<Value>;
+type MainOptions<Value> = NodeRuntimeOptions<MainSuccess<Value>, MainFailure<Value>>;
+/** Node.js/Bun process lifecycle helpers. */
+declare class NodeRuntime {
+  /**
+   * Run a typed main Program, translate its final result to `process.exitCode`,
+   * and dispose the Runtime when the program or a configured process signal settles.
+   */
+  static runMain<A, L extends LayerInput>(layer: L & CompleteInput<L>, backend: LayerBackend, program: CompleteExecution<ProvidedEnvironment<L>, A>, options?: MainOptions<A>): Promise<Awaited<A>>;
+  static runMain<A, L extends LayerInput>(layer: L & CompleteInput<L>, program: CompleteExecution<ProvidedEnvironment<L>, A>, options?: MainOptions<A>): Promise<Awaited<A>>;
+  static runMain<A, L extends LayerInput>(layer: L & CompleteInput<L>, options: MainOptions<A>, program: CompleteExecution<ProvidedEnvironment<L>, A>): Promise<Awaited<A>>;
+}
+/** Type-level aliases for the Node.js/Bun process boundary. */
+declare namespace NodeRuntime {
+  /** Options for `NodeRuntime.runMain`. */
+  type Options<Success = unknown, Failure = unknown> = NodeRuntimeOptions<Success, Failure>;
+  /** A process signal accepted by `NodeRuntime.runMain`. */
+  type Signal = NodeRuntimeSignal;
+}
+//#endregion
+export { NodeRuntime, NodeRuntimeContextStorage, type NodeRuntimeDefectHandler, type NodeRuntimeFailureHandler, type NodeRuntimeOptions, type NodeRuntimeSignal, type NodeRuntimeSuccessHandler, type RuntimeContext, RuntimeContextNotConfiguredError, type RuntimeContextStorage, nodeRuntimeContextStorage };
+//# sourceMappingURL=node.d.mts.map

package/dist/node.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.mts","names":[],"sources":["../src/runtime/node-runtime.ts"],"mappings":";;;;;;;;KAoBY;;KAGA,0BAA0B,YAAY,OAAO;;KAG7C,0BAA0B,YAAY,OAAO;;KAG7C,4BAA4B;;KAG5B,mBAAmB,mBAAmB,qBAAqB;;WAE5D,mBAAmB;;WAEnB,YAAY,0BAA0B;;WAEtC,YAAY,0BAA0B;;WAEtC,WAAW;;KAGjB,qBAAqB,SAAS,cAAc,2BAA+B;KAE3E,iBAAiB,SAAS,qBAAqB,QAAQ;KAEvD,YAAY,SAAS,cAAc,SAAS,iBAAiB;KAE7D,YAAY,SAAS,YAAY;KAEjC,YAAY,SAAS,mBAAmB,YAAY,QAAQ,YAAY;;cAqMhE;;;;;SAKJ,QAAQ,GAAG,UAAU,YAC1B,OAAO,IAAI,cAAc,IACzB,SAAS,cACT,SAAS,kBAAkB,oBAAoB,IAAI,IACnD,UAAU,YAAY,KACrB,QAAQ,QAAQ;SAEZ,QAAQ,GAAG,UAAU,YAC1B,OAAO,IAAI,cAAc,IACzB,SAAS,kBAAkB,oBAAoB,IAAI,IACnD,UAAU,YAAY,KACrB,QAAQ,QAAQ;SAEZ,QAAQ,GAAG,UAAU,YAC1B,OAAO,IAAI,cAAc,IACzB,SAAS,YAAY,IACrB,SAAS,kBAAkB,oBAAoB,IAAI,KAClD,QAAQ,QAAQ;;;kBA8NI;;OAEX,QAAQ,mBAAmB,qBAAqB,mBAAmB,SAAS;;OAG5E,SAAS"}