better-effect 0.13.0 → 0.14.0

package/dist/{index-BodMy6rO.d.mts → index-ClNndn2-.d.mts}

@@ -1,9 +1,83 @@
-import { M as AnyService, h as ScopeOutcome } from "./index-AiKM71-u.mjs";
-import { _ as CompleteInput, a as RuntimeShutdownDiagnostic, d as LayerBackend, g as CompleteExecutionLayer, h as CompleteExecution, i as RuntimeRunOptions, n as RuntimeDisposeOptions, p as Layer, r as RuntimeOptions, w as ProvidedEnvironment, y as LayerInput } from "./outcome-DI8LPIQ4.mjs";
-import "./observer-9nhbL7Pr.mjs";
-import "./index-DAKn0qHk.mjs";
-import "./index-CCi07kUw.mjs";
+import { $ as CompleteInput, F as RuntimeTaskMetadata, Lt as AnyService, Q as CompleteExecutionLayer, V as LayerBackend, Z as CompleteExecution, _ as RuntimeRunOptions, bt as ScopeOutcome, d as RuntimeExecutorRequest, g as RuntimeOptions, h as RuntimeDisposeOptions, ot as ProvidedEnvironment, t as Layer, tt as LayerInput, u as RuntimeExecutor, v as RuntimeShutdownDiagnostic } from "./layer-C2OaqTmB.mjs";
+import "./index-Cy1VsU-u.mjs";
+import "./index-3Bkl-sxS.mjs";
 import { Result, UnhandledException } from "better-result";
+//#region src/function/pipe.d.ts
+type Unary<A, B> = (value: A) => B;
+declare function pipe<A>(value: A): A;
+declare function pipe<A, B>(value: A, ab: Unary<A, B>): B;
+declare function pipe<A, B, C>(value: A, ab: Unary<A, B>, bc: Unary<B, C>): C;
+declare function pipe<A, B, C, D>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>): D;
+declare function pipe<A, B, C, D, E>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>): E;
+declare function pipe<A, B, C, D, E, F>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>): F;
+declare function pipe<A, B, C, D, E, F, G>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>, fg: Unary<F, G>): G;
+declare function pipe<A, B, C, D, E, F, G, H>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>, fg: Unary<F, G>, gh: Unary<G, H>): H;
+declare function pipe<A, B, C, D, E, F, G, H, I>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>, fg: Unary<F, G>, gh: Unary<G, H>, hi: Unary<H, I>): I;
+declare function pipe<A, B, C, D, E, F, G, H, I, J>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>, fg: Unary<F, G>, gh: Unary<G, H>, hi: Unary<H, I>, ij: Unary<I, J>): J;
+declare function pipe<A, B, C, D, E, F, G, H, I, J, K>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>, fg: Unary<F, G>, gh: Unary<G, H>, hi: Unary<H, I>, ij: Unary<I, J>, jk: Unary<J, K>): K;
+//#endregion
+//#region src/resource/errors.d.ts
+declare const ResourceReleaseFailure_base: import("better-result").TaggedErrorClass<"ResourceReleaseFailure">;
+/** Describes a failure encountered while releasing a Resource. */
+declare class ResourceReleaseFailure extends ResourceReleaseFailure_base<{
+  readonly resource: string;
+  readonly cause: unknown;
+  readonly message: string;
+}> {}
+//#endregion
+//#region src/resource/types.d.ts
+/** A value that may be delivered synchronously or through a thenable. */
+type MaybePromise<T> = T | PromiseLike<T>;
+/** A synchronous or asynchronous better-result Result operation. */
+type AsyncResult<T, E> = MaybePromise<Result<T, E>>;
+/** The allowed return value of a custom Resource release callback. */
+type ReleaseOutcome = void | Result<void, unknown>;
+/** Receives release failures for diagnostics without changing error precedence. */
+type ReleaseFailureObserver = (failure: ResourceReleaseFailure) => MaybePromise<void>;
+/** Options controlling `Resource.acquireUseRelease`. */
+type AcquireUseReleaseOptions<R, A, AcquireError, UseError> = {
+  /** Human-readable name included in release failures. */
+  readonly name: string;
+  /** Acquire the resource. A failure skips use and release. */
+  readonly acquire: () => AsyncResult<R, AcquireError>;
+  /** Use the acquired resource. Release is attempted afterward. */
+  readonly use: (resource: R) => AsyncResult<A, UseError>;
+  /** Release the resource, or omit it to use its disposal protocol. */
+  readonly release?: (resource: R) => MaybePromise<ReleaseOutcome>;
+  /**
+   * Observe cleanup failures without changing error precedence. This is most
+   * useful when both `use` and `release` can fail.
+   */
+  readonly onReleaseFailure?: ReleaseFailureObserver;
+};
+//#endregion
+//#region src/resource/resource.d.ts
+/**
+ * Acquire a resource, use it, and always attempt release afterward.
+ *
+ * Acquisition, use, and release may be synchronous or asynchronous Result
+ * operations. If both use and release fail, the use error remains primary and
+ * `onReleaseFailure` receives the cleanup failure as a diagnostic.
+ *
+ * When `release` is omitted, `Symbol.asyncDispose` is preferred over
+ * `Symbol.dispose`.
+ *
+ * @example
+ * ```ts
+ * const result = await Resource.acquireUseRelease({
+ *   name: 'database connection',
+ *   acquire: () => connect(),
+ *   use: (connection) => query(connection),
+ *   release: (connection) => connection.close()
+ * })
+ * ```
+ */
+declare const acquireUseRelease: <R, A, AcquireError, UseError>({ name, acquire, use, release, onReleaseFailure }: AcquireUseReleaseOptions<R, A, AcquireError, UseError>) => Promise<Result<A, AcquireError | UseError | UnhandledException | ResourceReleaseFailure>>;
+declare const Resource: {
+  /** Acquire, use, and release a resource with deterministic error precedence. */
+  readonly acquireUseRelease: typeof acquireUseRelease;
+};
+//#endregion
 //#region src/runtime/types.d.ts
 /** A detached diagnostic view of one active Runtime execution. */
 type RuntimeExecutionInspection = {
@@ -11,6 +85,10 @@ type RuntimeExecutionInspection = {
   readonly name?: string;
   readonly startedAt: number;
 };
+/** A detached diagnostic view of one active Scope-owned task. */
+type RuntimeTaskInspection = RuntimeTaskMetadata & {
+  readonly state: 'running';
+};
 /**
  * A detached, immutable diagnostic view of a Runtime.
  *
@@ -19,10 +97,12 @@ type RuntimeExecutionInspection = {
  * primitive or readiness guarantee.
  */
 type RuntimeInspection = {
-  readonly state: 'active' | 'disposing' | 'disposed';
+  readonly state: 'active' | 'quiescing' | 'draining' | 'aborting' | 'releasing' | 'disposed';
   readonly warmup: 'idle' | 'running' | 'completed' | 'failed';
   readonly activeExecutions: number;
   readonly executions: readonly RuntimeExecutionInspection[];
+  readonly activeTasks: number;
+  readonly tasks: readonly RuntimeTaskInspection[];
   readonly services: readonly string[];
   readonly shutdownSignalAborted: boolean;
 };
@@ -56,6 +136,7 @@ type RuntimeOptionsInput = RuntimeOptions & RuntimeRunOptions;
  */
 declare class Runtime<Provided extends AnyService = any> {
   private readonly handle;
+  readonly executor: RuntimeExecutor<Provided>;
   private constructor();
   /**
    * Create a long-lived Runtime that owns its Layer resources.
@@ -80,6 +161,8 @@ declare class Runtime<Provided extends AnyService = any> {
   static run<A, L extends LayerInput>(layer: L & CompleteInput<L>, options: RuntimeOptionsInput, program: CompleteExecution<ProvidedEnvironment<L>, A>): Promise<Awaited<A>>;
   /** Run a callback with a managed Runtime and always dispose it afterward. */
   static use<A, L extends LayerInput>(layer: L & CompleteInput<L>, use: (runtime: Runtime<ProvidedEnvironment<L>>) => A | PromiseLike<A>, options?: RuntimeOptions): Promise<Awaited<A>>;
+  /** Request the non-owning executor view from the current Runtime context. */
+  static executor<Requested extends AnyService>(): RuntimeExecutorRequest<Requested>;
   /** Resolve every Layer provider and dispose the Runtime if warmup fails. */
   warmup(): Promise<void>;
   /** Return a detached diagnostic snapshot without changing Runtime state. */
@@ -113,6 +196,8 @@ declare namespace Runtime {
   type Inspection = RuntimeInspection;
   /** Detached diagnostic view of one active execution. */
   type ExecutionInspection = RuntimeExecutionInspection;
+  /** Non-owning view that can start child Runtime executions. */
+  type Executor<Provided extends AnyService = any> = RuntimeExecutor<Provided>;
 }
 //#endregion
 //#region src/runtime/signal.d.ts
@@ -121,60 +206,5 @@ declare const CurrentAbortSignal: {
   readonly [Symbol.iterator]: () => Generator<never, AbortSignal, unknown>;
 };
 //#endregion
-//#region src/function/pipe.d.ts
-type Unary<A, B> = (value: A) => B;
-declare function pipe<A>(value: A): A;
-declare function pipe<A, B>(value: A, ab: Unary<A, B>): B;
-declare function pipe<A, B, C>(value: A, ab: Unary<A, B>, bc: Unary<B, C>): C;
-declare function pipe<A, B, C, D>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>): D;
-declare function pipe<A, B, C, D, E>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>): E;
-declare function pipe<A, B, C, D, E, F>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>): F;
-declare function pipe<A, B, C, D, E, F, G>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>, fg: Unary<F, G>): G;
-declare function pipe<A, B, C, D, E, F, G, H>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>, fg: Unary<F, G>, gh: Unary<G, H>): H;
-declare function pipe<A, B, C, D, E, F, G, H, I>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>, fg: Unary<F, G>, gh: Unary<G, H>, hi: Unary<H, I>): I;
-declare function pipe<A, B, C, D, E, F, G, H, I, J>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>, fg: Unary<F, G>, gh: Unary<G, H>, hi: Unary<H, I>, ij: Unary<I, J>): J;
-declare function pipe<A, B, C, D, E, F, G, H, I, J, K>(value: A, ab: Unary<A, B>, bc: Unary<B, C>, cd: Unary<C, D>, de: Unary<D, E>, ef: Unary<E, F>, fg: Unary<F, G>, gh: Unary<G, H>, hi: Unary<H, I>, ij: Unary<I, J>, jk: Unary<J, K>): K;
-//#endregion
-//#region src/resource/errors.d.ts
-declare const ResourceReleaseFailure_base: import("better-result").TaggedErrorClass<"ResourceReleaseFailure">;
-/** Describes a failure encountered while releasing a Resource. */
-declare class ResourceReleaseFailure extends ResourceReleaseFailure_base<{
-  readonly resource: string;
-  readonly cause: unknown;
-  readonly message: string;
-}> {}
-//#endregion
-//#region src/resource/types.d.ts
-/** A value that may be delivered synchronously or through a thenable. */
-type MaybePromise<T> = T | PromiseLike<T>;
-/** A synchronous or asynchronous better-result Result operation. */
-type AsyncResult<T, E> = MaybePromise<Result<T, E>>;
-/** The allowed return value of a custom Resource release callback. */
-type ReleaseOutcome = void | Result<void, unknown>;
-/** Receives release failures for diagnostics without changing error precedence. */
-type ReleaseFailureObserver = (failure: ResourceReleaseFailure) => MaybePromise<void>;
-/** Options controlling `Resource.acquireUseRelease`. */
-type AcquireUseReleaseOptions<R, A, AcquireError, UseError> = {
-  /** Human-readable name included in release failures. */
-  readonly name: string;
-  /** Acquire the resource. A failure skips use and release. */
-  readonly acquire: () => AsyncResult<R, AcquireError>;
-  /** Use the acquired resource. Release is attempted afterward. */
-  readonly use: (resource: R) => AsyncResult<A, UseError>;
-  /** Release the resource, or omit it to use its disposal protocol. */
-  readonly release?: (resource: R) => MaybePromise<ReleaseOutcome>;
-  /**
-   * Observe cleanup failures without changing error precedence. This is most
-   * useful when both `use` and `release` can fail.
-   */
-  readonly onReleaseFailure?: ReleaseFailureObserver;
-};
-//#endregion
-//#region src/resource/resource.d.ts
-declare const Resource: {
-  /** Acquire, use, and release a resource with deterministic error precedence. */
-  readonly acquireUseRelease: <R, A, AcquireError, UseError>({ name, acquire, use, release, onReleaseFailure }: AcquireUseReleaseOptions<R, A, AcquireError, UseError>) => Promise<Result<A, AcquireError | UseError | UnhandledException | ResourceReleaseFailure>>;
-};
-//#endregion
-export { ReleaseOutcome as a, CurrentAbortSignal as c, RuntimeFor as d, RuntimeInspection as f, ReleaseFailureObserver as i, Runtime as l, AcquireUseReleaseOptions as n, ResourceReleaseFailure as o, AsyncResult as r, pipe as s, Resource as t, RuntimeExecutionInspection as u };
-//# sourceMappingURL=index-BodMy6rO.d.mts.map
+export { RuntimeInspection as a, AcquireUseReleaseOptions as c, ReleaseOutcome as d, ResourceReleaseFailure as f, RuntimeFor as i, AsyncResult as l, Runtime as n, RuntimeTaskInspection as o, pipe as p, RuntimeExecutionInspection as r, Resource as s, CurrentAbortSignal as t, ReleaseFailureObserver as u };
+//# sourceMappingURL=index-ClNndn2-.d.mts.map

package/dist/index-ClNndn2-.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-ClNndn2-.d.mts","names":[],"sources":["../src/function/pipe.ts","../src/resource/errors.ts","../src/resource/types.ts","../src/resource/resource.ts","../src/runtime/types.ts","../src/runtime/runtime.ts","../src/runtime/signal.ts"],"mappings":"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"}

package/dist/{index-DAKn0qHk.d.mts → index-Cy1VsU-u.d.mts}

@@ -1,6 +1,4 @@
-import { N as AnyServiceToken } from "./index-AiKM71-u.mjs";
-import { d as LayerBackend, f as LayerBackendDisposeOptions, m as LayerRegistration } from "./outcome-DI8LPIQ4.mjs";
-import "./observer-9nhbL7Pr.mjs";
+import { G as LayerRegistration, H as LayerBackendDisposeOptions, Rt as AnyServiceToken, V as LayerBackend } from "./layer-C2OaqTmB.mjs";
 //#region src/layer/map-layer-backend.d.ts
 /** Native map-backed Layer backend used by Runtime when no adapter is supplied. */
 declare class MapLayerBackend implements LayerBackend {
@@ -16,4 +14,4 @@ declare class MapLayerBackend implements LayerBackend {
 }
 //#endregion
 export { MapLayerBackend as t };
-//# sourceMappingURL=index-DAKn0qHk.d.mts.map
+//# sourceMappingURL=index-Cy1VsU-u.d.mts.map

package/dist/index-Cy1VsU-u.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-Cy1VsU-u.d.mts","names":[],"sources":["../src/layer/map-layer-backend.ts"],"mappings":";;;cAca,2BAA2B;mBACrB;mBAEA;mBAEA;;EAGjB,SAAS,cAAc;;EAiBjB,QAAQ,UAAU,iBAAiB,OAAO,IAAI,QAAQ,aAAa;;EA6CnE,WAAW,UAAU,6BAA6B"}

package/dist/index.d.mts

@@ -1,8 +1,6 @@
-import { B as ServiceTag, C as EffectError, D as EffectYield, E as EffectSuccess, F as ServiceContract, H as ServiceToken, I as ServiceIdentity, M as AnyService, N as AnyServiceToken, P as ServiceClass, R as ServiceInstance, T as EffectRequirements, U as ServiceTokenOf, _ as ScopeCloseError, a as ServiceResolver, b as Service, c as RuntimeContextStorage, d as CleanupFailureDiagnostic, f as DisposableResource, g as ResourceNotDisposableError, h as ScopeOutcome, i as ServiceRuntimeNotConfiguredError, j as ServiceRequirement, l as CloseableScope, m as ScopeFinalizer, n as ServiceAcquisitionError, o as ServiceRuntime, r as ServiceNotFoundError, s as RuntimeContext, t as CircularDependencyError, u as Scope, v as ScopeClosedError, x as AnyEffect, y as ScopeRuntimeNotConfiguredError, z as ServiceRequirements } from "./index-AiKM71-u.mjs";
-import { a as RuntimeShutdownDiagnostic, c as LayerGeneratorYieldError, d as LayerBackend, f as LayerBackendDisposeOptions, i as RuntimeRunOptions, l as LayerRegistrationError, m as LayerRegistration, n as RuntimeDisposeOptions, o as DuplicateServiceError, p as Layer, r as RuntimeOptions, s as LayerDisposeError, t as CleanupFailureObserver, u as ServiceTagCollisionError } from "./outcome-DI8LPIQ4.mjs";
-import { a as RuntimeObserver, c as RuntimeServiceResolveEvent, i as RuntimeExecutionStartEvent, n as RuntimeExecutionEndEvent, o as RuntimeResourceReleaseEvent, r as RuntimeExecutionMetadata, s as RuntimeServiceAcquireEvent, t as RuntimeExecutionAttributes } from "./observer-9nhbL7Pr.mjs";
-import { t as MapLayerBackend } from "./index-DAKn0qHk.mjs";
-import { a as ReleaseOutcome, c as CurrentAbortSignal, d as RuntimeFor, f as RuntimeInspection, i as ReleaseFailureObserver, l as Runtime, n as AcquireUseReleaseOptions, o as ResourceReleaseFailure, r as AsyncResult, s as pipe, t as Resource, u as RuntimeExecutionInspection } from "./index-BodMy6rO.mjs";
-import { t as RuntimeContextNotConfiguredError } from "./errors-BKcsQ0ip.mjs";
-import { n as Program, r as ProgramAllOptions, t as Effect } from "./index-CCi07kUw.mjs";
-export { type AcquireUseReleaseOptions, type AnyEffect, type AnyService, type AnyServiceToken, type AsyncResult, CircularDependencyError, type CleanupFailureDiagnostic, type CleanupFailureObserver, type CloseableScope, CurrentAbortSignal, type DisposableResource, DuplicateServiceError, Effect, type EffectError, type EffectRequirements, type EffectSuccess, type EffectYield, Layer, type LayerBackend, type LayerBackendDisposeOptions, LayerDisposeError, LayerGeneratorYieldError, type LayerRegistration, LayerRegistrationError, MapLayerBackend, Program, type ProgramAllOptions, type ReleaseFailureObserver, type ReleaseOutcome, Resource, ResourceNotDisposableError, ResourceReleaseFailure, Runtime, type RuntimeContext, RuntimeContextNotConfiguredError, type RuntimeContextStorage, type RuntimeDisposeOptions, type RuntimeExecutionAttributes, type RuntimeExecutionEndEvent, type RuntimeExecutionInspection, type RuntimeExecutionMetadata, type RuntimeExecutionStartEvent, type RuntimeFor, type RuntimeInspection, RuntimeObserver, type RuntimeOptions, type RuntimeResourceReleaseEvent, type RuntimeRunOptions, type RuntimeServiceAcquireEvent, type RuntimeServiceResolveEvent, type RuntimeShutdownDiagnostic, Scope, ScopeCloseError, ScopeClosedError, type ScopeFinalizer, type ScopeOutcome, ScopeRuntimeNotConfiguredError, Service, ServiceAcquisitionError, type ServiceClass, type ServiceContract, type ServiceIdentity, type ServiceInstance, ServiceNotFoundError, type ServiceRequirement, type ServiceRequirements, type ServiceResolver, ServiceRuntime, ServiceRuntimeNotConfiguredError, type ServiceTag, ServiceTagCollisionError, type ServiceToken, type ServiceTokenOf, pipe };
+import { A as RuntimeServiceAcquireEvent, At as EffectRequirements, Bt as ServiceContract, C as RuntimeExecutionStartEvent, Ct as ScopeClosedError, D as RuntimeLifecycleStartEvent, E as RuntimeLifecycleReleaseEvent, Et as AnyEffect, F as RuntimeTaskMetadata, G as LayerRegistration, H as LayerBackendDisposeOptions, Ht as ServiceInstance, I as RuntimeTaskStartEvent, It as ServiceRequirement, J as LayerGeneratorYieldError, K as DuplicateServiceError, Kt as ServiceToken, L as ScopedTask, Lt as AnyService, M as RuntimeShutdownEvent, Mt as EffectYield, N as RuntimeShutdownPhase, O as RuntimeObserver, Ot as EffectError, P as RuntimeTaskEndEvent, R as ScopedTaskExit, Rt as AnyServiceToken, S as RuntimeExecutionMetadata, St as ScopeCloseError, T as RuntimeLifecycleEventMetadata, Tt as Service, U as LayerLifecycle, Ut as ServiceRequirements, V as LayerBackend, Vt as ServiceIdentity, W as LayerQuiesce, Wt as ServiceTag, X as ServiceTagCollisionError, Y as LayerRegistrationError, _ as RuntimeRunOptions, _t as DisposableResource, a as ServiceRuntimeNotConfiguredError, b as RuntimeExecutionAttributes, bt as ScopeOutcome, c as RuntimeContext, f as RuntimeManagedExecution, g as RuntimeOptions, gt as CleanupFailureDiagnostic, h as RuntimeDisposeOptions, ht as Scope, i as ServiceNotFoundError, j as RuntimeServiceResolveEvent, jt as EffectSuccess, k as RuntimeResourceReleaseEvent, l as RuntimeContextStorage, m as CleanupFailureObserver, mt as CloseableScope, n as CircularDependencyError, o as ServiceResolver, p as RuntimeManagedPlan, q as LayerDisposeError, qt as ServiceTokenOf, r as ServiceAcquisitionError, s as ServiceRuntime, t as Layer, u as RuntimeExecutor, v as RuntimeShutdownDiagnostic, w as RuntimeLifecycleEndEvent, wt as ScopeRuntimeNotConfiguredError, x as RuntimeExecutionEndEvent, xt as ResourceNotDisposableError, y as RuntimeShutdownReason, yt as ScopeFinalizer, z as ScopedTaskState, zt as ServiceClass } from "./layer-C2OaqTmB.mjs";
+import { t as MapLayerBackend } from "./index-Cy1VsU-u.mjs";
+import { n as Program, r as ProgramAllOptions, t as Effect } from "./index-3Bkl-sxS.mjs";
+import { a as RuntimeInspection, c as AcquireUseReleaseOptions, d as ReleaseOutcome, f as ResourceReleaseFailure, i as RuntimeFor, l as AsyncResult, n as Runtime, o as RuntimeTaskInspection, p as pipe, r as RuntimeExecutionInspection, s as Resource, t as CurrentAbortSignal, u as ReleaseFailureObserver } from "./index-ClNndn2-.mjs";
+import { r as RuntimeExecutorNotConfiguredError, t as RuntimeContextNotConfiguredError } from "./errors-CpHMzPiP.mjs";
+export { type AcquireUseReleaseOptions, type AnyEffect, type AnyService, type AnyServiceToken, type AsyncResult, CircularDependencyError, type CleanupFailureDiagnostic, type CleanupFailureObserver, type CloseableScope, CurrentAbortSignal, type DisposableResource, DuplicateServiceError, Effect, type EffectError, type EffectRequirements, type EffectSuccess, type EffectYield, Layer, type LayerBackend, type LayerBackendDisposeOptions, LayerDisposeError, LayerGeneratorYieldError, type LayerLifecycle, type LayerQuiesce, type LayerRegistration, LayerRegistrationError, MapLayerBackend, Program, type ProgramAllOptions, type ReleaseFailureObserver, type ReleaseOutcome, Resource, ResourceNotDisposableError, ResourceReleaseFailure, Runtime, type RuntimeContext, RuntimeContextNotConfiguredError, type RuntimeContextStorage, type RuntimeDisposeOptions, type RuntimeExecutionAttributes, type RuntimeExecutionEndEvent, type RuntimeExecutionInspection, type RuntimeExecutionMetadata, type RuntimeExecutionStartEvent, type RuntimeExecutor, RuntimeExecutorNotConfiguredError, type RuntimeFor, type RuntimeInspection, type RuntimeLifecycleEndEvent, type RuntimeLifecycleEventMetadata, type RuntimeLifecycleReleaseEvent, type RuntimeLifecycleStartEvent, type RuntimeManagedExecution, type RuntimeManagedPlan, RuntimeObserver, type RuntimeOptions, type RuntimeResourceReleaseEvent, type RuntimeRunOptions, type RuntimeServiceAcquireEvent, type RuntimeServiceResolveEvent, type RuntimeShutdownDiagnostic, type RuntimeShutdownEvent, type RuntimeShutdownPhase, type RuntimeShutdownReason, type RuntimeTaskEndEvent, type RuntimeTaskInspection, type RuntimeTaskMetadata, type RuntimeTaskStartEvent, Scope, ScopeCloseError, ScopeClosedError, type ScopeFinalizer, type ScopeOutcome, ScopeRuntimeNotConfiguredError, type ScopedTask, type ScopedTaskExit, type ScopedTaskState, Service, ServiceAcquisitionError, type ServiceClass, type ServiceContract, type ServiceIdentity, type ServiceInstance, ServiceNotFoundError, type ServiceRequirement, type ServiceRequirements, type ServiceResolver, ServiceRuntime, ServiceRuntimeNotConfiguredError, type ServiceTag, ServiceTagCollisionError, type ServiceToken, type ServiceTokenOf, pipe };

package/dist/index.mjs

@@ -1,11 +1,10 @@
-import { a as LayerGeneratorYieldError, c as CircularDependencyError, d as ServiceRuntimeNotConfiguredError, i as LayerDisposeError, l as ServiceAcquisitionError, o as LayerRegistrationError, r as DuplicateServiceError, s as ServiceTagCollisionError, u as ServiceNotFoundError } from "./registration-drnZk0SY.mjs";
-import { h as RuntimeContextNotConfiguredError } from "./context-BphfFUMO.mjs";
-import { a as ScopeClosedError, i as ScopeCloseError, o as ScopeRuntimeNotConfiguredError, r as ResourceNotDisposableError, t as disposeResource } from "./disposable-CP-Q2H3l.mjs";
-import { n as Service, r as ServiceRuntime, t as Layer } from "./layer-D16GKxuX.mjs";
-import { i as Scope } from "./program-metadata-BxjGkT17.mjs";
-import { i as MapLayerBackend, n as RuntimeObserver, t as Runtime } from "./runtime-C_55ofnL.mjs";
-import { n as Program, t as Effect } from "./effect-CPdV7Yv8.mjs";
-import { t as CurrentAbortSignal } from "./signal-nfgFyNCk.mjs";
+import { a as LayerGeneratorYieldError, c as CircularDependencyError, d as ServiceRuntimeNotConfiguredError, i as LayerDisposeError, l as ServiceAcquisitionError, o as LayerRegistrationError, r as DuplicateServiceError, s as ServiceTagCollisionError, u as ServiceNotFoundError } from "./registration-Bwe2GbVu.mjs";
+import { _ as RuntimeExecutorNotConfiguredError, h as RuntimeContextNotConfiguredError } from "./context-DSGSqcJj.mjs";
+import { a as ResourceNotDisposableError, c as ScopeRuntimeNotConfiguredError, l as ServiceRuntime, o as ScopeCloseError, r as disposeResource, s as ScopeClosedError, t as Layer } from "./layer-2kjHVv4N.mjs";
+import { t as Service } from "./service-CO9VJQYa.mjs";
+import { a as RuntimeObserver, c as MapLayerBackend, l as Scope, t as Runtime } from "./runtime-qpcVwaz_.mjs";
+import { t as CurrentAbortSignal } from "./signal-5Rg9bUUe.mjs";
+import { n as Program, t as Effect } from "./effect-W0IQXY8P.mjs";
 import { Result, TaggedError } from "better-result";
 //#region src/function/pipe.ts
 function pipe(value, ...operations) {
@@ -89,6 +88,6 @@ const Resource = {
 /** Acquire, use, and release a resource with deterministic error precedence. */
 acquireUseRelease };
 //#endregion
-export { CircularDependencyError, CurrentAbortSignal, DuplicateServiceError, Effect, Layer, LayerDisposeError, LayerGeneratorYieldError, LayerRegistrationError, MapLayerBackend, Program, Resource, ResourceNotDisposableError, ResourceReleaseFailure, Runtime, RuntimeContextNotConfiguredError, RuntimeObserver, Scope, ScopeCloseError, ScopeClosedError, ScopeRuntimeNotConfiguredError, Service, ServiceAcquisitionError, ServiceNotFoundError, ServiceRuntime, ServiceRuntimeNotConfiguredError, ServiceTagCollisionError, pipe };
+export { CircularDependencyError, CurrentAbortSignal, DuplicateServiceError, Effect, Layer, LayerDisposeError, LayerGeneratorYieldError, LayerRegistrationError, MapLayerBackend, Program, Resource, ResourceNotDisposableError, ResourceReleaseFailure, Runtime, RuntimeContextNotConfiguredError, RuntimeExecutorNotConfiguredError, RuntimeObserver, Scope, ScopeCloseError, ScopeClosedError, ScopeRuntimeNotConfiguredError, Service, ServiceAcquisitionError, ServiceNotFoundError, ServiceRuntime, ServiceRuntimeNotConfiguredError, ServiceTagCollisionError, pipe };
 
 //# sourceMappingURL=index.mjs.map

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"],"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"}
+{"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-CbXoZIfw.mjs → internal-identity-BuHBtP0k.mjs}

@@ -1,4 +1,4 @@
-import { f as captureServiceTag, s as ServiceTagCollisionError } from "./registration-drnZk0SY.mjs";
+import { f as captureServiceTag, s as ServiceTagCollisionError } from "./registration-Bwe2GbVu.mjs";
 //#region src/layer/internal-identity.ts
 const serviceMemberNames = (token) => {
 	const names = /* @__PURE__ */ new Set();
@@ -24,4 +24,4 @@ const assertServiceCompatibility = (requested, registered, instance) => {
 //#endregion
 export { assertServiceCompatibility as t };
 
-//# sourceMappingURL=internal-identity-CbXoZIfw.mjs.map
+//# sourceMappingURL=internal-identity-BuHBtP0k.mjs.map

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

@@ -1 +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"}
+{"version":3,"file":"internal-identity-BuHBtP0k.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"}