better-effect 0.10.0 → 0.11.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/runtime/explicit.d.mts

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

package/dist/runtime/node.d.mts

@@ -1,4 +1,4 @@
-import { c as RuntimeContextStorage, s as RuntimeContext } from "../index-CULgSzUw.mjs";
+import { c as RuntimeContextStorage, s as RuntimeContext } from "../index-heuaRmXR.mjs";
 import { t as RuntimeContextNotConfiguredError } from "../errors-BKcsQ0ip.mjs";
 //#region src/runtime/node.d.ts
 /** RuntimeContextStorage backed by Node/Bun async context propagation. */