better-effect 0.5.0 → 0.6.0

package/README.md

@@ -44,9 +44,17 @@ literal is the Service's stable logical identity. Services with identical
 methods but different tags are different dependencies; use a namespaced tag
 such as `@acme/Database` when identities must be shared across packages.
 
-`UserRepository` used `Database`, so `Database` became part of its environment requirements.
+`UserRepository` used `Database`, so `Database` became part of its environment requirements:
 
-No dependency list was written manually.
+```ts
+type FindUser = Awaited<ReturnType<UserRepository['findUser']>>
+// Effect<User, never, Database>
+```
+
+`Effect<A, E, R>` is a type-only facade over a `better-result` Result, not an Effect TS
+instruction tree. Constructors remain the handles used by `yield*`, Layers and resolver backends;
+the public requirement `R` is a union of tagged Service instances. No dependency list was written
+manually.
 
 Services can also describe a contract without requiring a class instance. Use the
 static `of` helper to type-check a structural implementation; it returns the same
@@ -68,6 +76,15 @@ const AuthorizationLive = Layer.succeed(Authorization, authorization)
 `instanceof Authorization`. For services with constructors, private fields or
 other runtime invariants, use `new Authorization(...)` instead.
 
+Service tokens themselves are always declared through `Service<Self>()(tag)`.
+Every instance carries a required, declaration-only `ServiceIdentity<Tag>`; no
+identity property exists at runtime. `Service.Contract<Authorization>` projects
+the marker-free implementation shape accepted by `Service.of` and all Layer
+provider APIs. Those boundaries return or provide the branded Service type
+without modifying the implementation object. `Service.of(...)` does not create
+an alternate token, so the instance contract stays tied to the constructor used
+by Layers and resolver backends.
+
 Provide it and the environment becomes complete:
 
 ```ts
@@ -114,6 +131,40 @@ We call this **typechecked wiring**.
 
 The Services your code uses, the implementations your Layers provide, and the programs your Runtime executes participate in the same type-level contract.
 
+A Layer's public type is `Layer<Provided, Required>`. `Provided` is the Service
+instance union produced by the Layer and `Required` is only the external
+requirement union left after composition. Preserve inferred Layers when possible;
+use `satisfies Layer<Provided, Required>` when checking an application boundary
+without erasing provider provenance.
+
+Generic infrastructure that intentionally erases this metadata can use the
+explicit `Layer.Any` sentinel, including for an empty Layer. Bare Layers,
+partial-`any` shapes and concrete unions such as `Layer<A> | Layer<B>` are not
+implicit unchecked boundaries.
+
+### Discover type helpers from their API
+
+Public type helpers are also grouped under the runtime API they describe:
+
+```ts
+import type { Effect, Layer, Runtime, Scope, Service } from 'better-effect'
+
+type Program = ReturnType<UserRepository['findUser']>
+type Success = Effect.Success<Program>
+type Failure = Effect.Error<Program>
+type Dependencies = Effect.Requirements<Program>
+type Services = Layer.Provided<typeof AppLive>
+type AppRuntime = Runtime.For<typeof AppLive>
+type DatabaseTag = Service.Tag<Database> // 'Database'
+type DatabaseToken = Service.TokenOf<Database> // Service.Token<'Database', Database>
+type Outcome = Scope.Outcome
+```
+
+These are declaration-only aliases and add nothing to the JavaScript bundle.
+The associated `Layer` helpers are intentionally namespaced; use
+`Layer.Provided`, `Layer.Required`, `Layer.Complete` and `Layer.Any` rather than
+low-level provider metadata names.
+
 ---
 
 ## Why better-effect?
@@ -193,9 +244,11 @@ Resources acquired during an individual execution belong to that execution inste
 
 `better-effect` is not a replacement implementation of Effect.
 
-It does not introduce a fiber runtime, scheduler, streams, queues or a public `Effect<A, E, R>` abstraction.
+It does not introduce a fiber runtime, scheduler, streams, queues or a lazy runtime instruction tree.
 
-`Effect.gen` builds on `better-result` generator composition while carrying Service requirements through the TypeScript type system.
+Its public `Effect<A, E, R>` is only a type-level Result facade. `Effect.gen` builds on
+`better-result` generator composition while carrying Service instance requirements through the
+TypeScript type system.
 
 Dependency resolution stays behind a pluggable backend.
 
@@ -270,8 +323,9 @@ Application resources live with the Runtime. Execution resources live with the e
 Keep `better-result` as the source of truth for typed successes, failures, short-circuiting
 and generator control flow. `Effect.gen` delegates to `Result.gen`; it adds only the
 phantom Service requirements that TypeScript needs to check the application environment.
-At runtime, an `EffectResult` is still a `better-result` Result; the requirements exist
-only in the type.
+At runtime, an `Effect<A, E, R>` is still a `better-result` Result; the requirements exist
+only in the type. `Effect.Requirements`, `Layer.Provided`, `Layer.Required` and
+`Runtime.For` expose tagged Service instance unions.
 
 For a linear workflow, `pipe` composes the same kind of program without introducing a
 second Result model or a lazy Effect runtime:

package/dist/adapters/iti.d.mts

@@ -1,4 +1,4 @@
-import { V as AnyServiceToken, t as LayerBackend, v as LayerRegistration } from "../index-D77AvuBl.mjs";
+import { d as LayerRegistration, t as LayerBackend, z as AnyServiceToken } from "../index-DMfjhNR_.mjs";
 //#region src/adapters/iti.d.ts
 /**
  * ITI-backed Layer backend.

package/dist/adapters/iti.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"iti.d.mts","names":[],"sources":["../../src/adapters/iti.ts"],"mappings":";;;;;;;;cAmBa,2BAA2B;UAC9B;mBAES;mBAEA;UAET;;EAgBR,SAAS,cAAc;;EAuBvB,QAAQ,UAAU,iBAAiB,OAAO,IAAI,aAAa,KAAK,YAAY,aAAa;;EAuBnF,cAAc"}
+{"version":3,"file":"iti.d.mts","names":[],"sources":["../../src/adapters/iti.ts"],"mappings":";;;;;;;;cAsBa,2BAA2B;UAC9B;mBAES;mBAEA;UAET;;EAgBR,SAAS,cAAc;;EAuBvB,QAAQ,UAAU,iBAAiB,OAAO,IAAI,aAAa,KAAK,YAAY,aAAa;;EAyBnF,cAAc"}

package/dist/adapters/iti.mjs

@@ -1,5 +1,6 @@
 import { a as ServiceTagCollisionError, o as ServiceNotFoundError, t as DuplicateServiceError } from "../errors-GR3K_nRu.mjs";
-import { t as assertServiceCompatibility } from "../internal-identity-BnZC3Au-.mjs";
+import { t as isPromiseLike } from "../runtime-CDcCF5cb.mjs";
+import { t as assertServiceCompatibility } from "../internal-identity-C6Awrc33.mjs";
 import { createContainer } from "iti";
 //#region src/adapters/iti.ts
 /**
@@ -33,15 +34,15 @@ var ItiLayerBackend = class {
 	}
 	/** Resolve a registered Service through the ITI container. */
 	resolve(token) {
-		if (!this.registered.has(token.serviceTag)) throw new ServiceNotFoundError(token);
 		const registered = this.registered.get(token.serviceTag);
+		if (registered === void 0) throw new ServiceNotFoundError(token);
 		const key = this.keyFor(token);
 		const resolved = this.container.get(key);
 		const validate = (instance) => {
 			assertServiceCompatibility(token, registered, instance);
 			return instance;
 		};
-		if (resolved && typeof resolved.then === "function") return Promise.resolve(resolved).then(validate);
+		if (isPromiseLike(resolved)) return Promise.resolve(resolved).then(validate);
 		return validate(resolved);
 	}
 	/** Dispose all ITI-managed provider instances. */

package/dist/adapters/iti.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"iti.mjs","names":[],"sources":["../../src/adapters/iti.ts"],"sourcesContent":["import { createContainer } from 'iti'\n\nimport {\n  DuplicateServiceError,\n  ServiceTagCollisionError,\n  type LayerBackend,\n  type LayerRegistration\n} from '../layer'\n\nimport { ServiceNotFoundError, type AnyServiceToken } from '../service'\n\nimport { assertServiceCompatibility } from '../layer/internal-identity'\n\n/**\n * ITI-backed Layer backend.\n *\n * Install `iti` as the optional peer dependency and pass an instance to\n * `Runtime.make` when using ITI's container implementation.\n */\nexport class ItiLayerBackend implements LayerBackend {\n  private container: any = createContainer()\n\n  private readonly keys = new Map<string, string>()\n\n  private readonly registered = new Map<string, AnyServiceToken>()\n\n  private keyFor(token: AnyServiceToken): string {\n    const tag = token.serviceTag\n    const existing = this.keys.get(tag)\n\n    if (existing) {\n      return existing\n    }\n\n    const key = `better-effect:${tag}`\n\n    this.keys.set(tag, key)\n\n    return key\n  }\n\n  /** Register a Layer provider under its deterministic Service-tag key. */\n  register(registration: LayerRegistration): void {\n    const token = registration.service\n    const tag = token.serviceTag\n    const existing = this.registered.get(tag)\n\n    if (existing === token) {\n      throw new DuplicateServiceError(token)\n    }\n\n    if (existing) {\n      throw new ServiceTagCollisionError(existing, token)\n    }\n\n    const key = this.keyFor(token)\n\n    this.container = this.container.add({\n      [key]: registration.acquire\n    })\n\n    this.registered.set(tag, token)\n  }\n\n  /** Resolve a registered Service through the ITI container. */\n  resolve<T extends AnyServiceToken>(token: T): InstanceType<T> | PromiseLike<InstanceType<T>> {\n    if (!this.registered.has(token.serviceTag)) {\n      throw new ServiceNotFoundError(token)\n    }\n\n    const registered = this.registered.get(token.serviceTag)\n    const key = this.keyFor(token)\n    const resolved = this.container.get(key) as unknown\n\n    const validate = (instance: unknown): InstanceType<T> => {\n      assertServiceCompatibility(token, registered!, instance)\n\n      return instance as InstanceType<T>\n    }\n\n    if (resolved && typeof (resolved as PromiseLike<unknown>).then === 'function') {\n      return Promise.resolve(resolved).then(validate)\n    }\n\n    return validate(resolved)\n  }\n\n  /** Dispose all ITI-managed provider instances. */\n  async disposeAll(): Promise<void> {\n    await this.container.disposeAll()\n  }\n}\n"],"mappings":";;;;;;;;;;AAmBA,IAAa,kBAAb,MAAqD;CACnD,YAAyB,gBAAgB;CAEzC,uBAAwB,IAAI,IAAoB;CAEhD,6BAA8B,IAAI,IAA6B;CAE/D,OAAe,OAAgC;EAC7C,MAAM,MAAM,MAAM;EAClB,MAAM,WAAW,KAAK,KAAK,IAAI,GAAG;EAElC,IAAI,UACF,OAAO;EAGT,MAAM,MAAM,iBAAiB;EAE7B,KAAK,KAAK,IAAI,KAAK,GAAG;EAEtB,OAAO;CACT;;CAGA,SAAS,cAAuC;EAC9C,MAAM,QAAQ,aAAa;EAC3B,MAAM,MAAM,MAAM;EAClB,MAAM,WAAW,KAAK,WAAW,IAAI,GAAG;EAExC,IAAI,aAAa,OACf,MAAM,IAAI,sBAAsB,KAAK;EAGvC,IAAI,UACF,MAAM,IAAI,yBAAyB,UAAU,KAAK;EAGpD,MAAM,MAAM,KAAK,OAAO,KAAK;EAE7B,KAAK,YAAY,KAAK,UAAU,IAAI,GACjC,MAAM,aAAa,QACtB,CAAC;EAED,KAAK,WAAW,IAAI,KAAK,KAAK;CAChC;;CAGA,QAAmC,OAA0D;EAC3F,IAAI,CAAC,KAAK,WAAW,IAAI,MAAM,UAAU,GACvC,MAAM,IAAI,qBAAqB,KAAK;EAGtC,MAAM,aAAa,KAAK,WAAW,IAAI,MAAM,UAAU;EACvD,MAAM,MAAM,KAAK,OAAO,KAAK;EAC7B,MAAM,WAAW,KAAK,UAAU,IAAI,GAAG;EAEvC,MAAM,YAAY,aAAuC;GACvD,2BAA2B,OAAO,YAAa,QAAQ;GAEvD,OAAO;EACT;EAEA,IAAI,YAAY,OAAQ,SAAkC,SAAS,YACjE,OAAO,QAAQ,QAAQ,QAAQ,CAAC,CAAC,KAAK,QAAQ;EAGhD,OAAO,SAAS,QAAQ;CAC1B;;CAGA,MAAM,aAA4B;EAChC,MAAM,KAAK,UAAU,WAAW;CAClC;AACF"}
+{"version":3,"file":"iti.mjs","names":[],"sources":["../../src/adapters/iti.ts"],"sourcesContent":["import { createContainer } from 'iti'\n\nimport {\n  DuplicateServiceError,\n  ServiceTagCollisionError,\n  type LayerBackend,\n  type LayerRegistration\n} from '../layer'\n\nimport { ServiceNotFoundError, type AnyServiceToken } from '../service'\n\nimport { assertServiceCompatibility } from '../layer/internal-identity'\nimport { isPromiseLike } from '../utils/runtime'\n\ntype LayerAcquiredValue = Awaited<ReturnType<LayerRegistration['acquire']>>\n\n/**\n * ITI-backed Layer backend.\n *\n * Install `iti` as the optional peer dependency and pass an instance to\n * `Runtime.make` when using ITI's container implementation.\n */\nexport class ItiLayerBackend implements LayerBackend {\n  private container: any = createContainer()\n\n  private readonly keys = new Map<string, string>()\n\n  private readonly registered = new Map<string, AnyServiceToken>()\n\n  private keyFor(token: AnyServiceToken): string {\n    const tag = token.serviceTag\n    const existing = this.keys.get(tag)\n\n    if (existing) {\n      return existing\n    }\n\n    const key = `better-effect:${tag}`\n\n    this.keys.set(tag, key)\n\n    return key\n  }\n\n  /** Register a Layer provider under its deterministic Service-tag key. */\n  register(registration: LayerRegistration): void {\n    const token = registration.service\n    const tag = token.serviceTag\n    const existing = this.registered.get(tag)\n\n    if (existing === token) {\n      throw new DuplicateServiceError(token)\n    }\n\n    if (existing) {\n      throw new ServiceTagCollisionError(existing, token)\n    }\n\n    const key = this.keyFor(token)\n\n    this.container = this.container.add({\n      [key]: registration.acquire\n    })\n\n    this.registered.set(tag, token)\n  }\n\n  /** Resolve a registered Service through the ITI container. */\n  resolve<T extends AnyServiceToken>(token: T): InstanceType<T> | PromiseLike<InstanceType<T>> {\n    const registered = this.registered.get(token.serviceTag)\n\n    if (registered === undefined) {\n      throw new ServiceNotFoundError(token)\n    }\n\n    const key = this.keyFor(token)\n    const resolved = this.container.get(key)\n\n    const validate = (instance: LayerAcquiredValue): InstanceType<T> => {\n      assertServiceCompatibility(token, registered, instance)\n\n      // SAFETY: The registered tag and compatibility check establish the constructor-to-instance relationship after ITI erases it.\n      return instance as InstanceType<T>\n    }\n\n    if (isPromiseLike(resolved)) {\n      return Promise.resolve(resolved).then(validate)\n    }\n\n    return validate(resolved)\n  }\n\n  /** Dispose all ITI-managed provider instances. */\n  async disposeAll(): Promise<void> {\n    await this.container.disposeAll()\n  }\n}\n"],"mappings":";;;;;;;;;;;AAsBA,IAAa,kBAAb,MAAqD;CACnD,YAAyB,gBAAgB;CAEzC,uBAAwB,IAAI,IAAoB;CAEhD,6BAA8B,IAAI,IAA6B;CAE/D,OAAe,OAAgC;EAC7C,MAAM,MAAM,MAAM;EAClB,MAAM,WAAW,KAAK,KAAK,IAAI,GAAG;EAElC,IAAI,UACF,OAAO;EAGT,MAAM,MAAM,iBAAiB;EAE7B,KAAK,KAAK,IAAI,KAAK,GAAG;EAEtB,OAAO;CACT;;CAGA,SAAS,cAAuC;EAC9C,MAAM,QAAQ,aAAa;EAC3B,MAAM,MAAM,MAAM;EAClB,MAAM,WAAW,KAAK,WAAW,IAAI,GAAG;EAExC,IAAI,aAAa,OACf,MAAM,IAAI,sBAAsB,KAAK;EAGvC,IAAI,UACF,MAAM,IAAI,yBAAyB,UAAU,KAAK;EAGpD,MAAM,MAAM,KAAK,OAAO,KAAK;EAE7B,KAAK,YAAY,KAAK,UAAU,IAAI,GACjC,MAAM,aAAa,QACtB,CAAC;EAED,KAAK,WAAW,IAAI,KAAK,KAAK;CAChC;;CAGA,QAAmC,OAA0D;EAC3F,MAAM,aAAa,KAAK,WAAW,IAAI,MAAM,UAAU;EAEvD,IAAI,eAAe,KAAA,GACjB,MAAM,IAAI,qBAAqB,KAAK;EAGtC,MAAM,MAAM,KAAK,OAAO,KAAK;EAC7B,MAAM,WAAW,KAAK,UAAU,IAAI,GAAG;EAEvC,MAAM,YAAY,aAAkD;GAClE,2BAA2B,OAAO,YAAY,QAAQ;GAGtD,OAAO;EACT;EAEA,IAAI,cAAc,QAAQ,GACxB,OAAO,QAAQ,QAAQ,QAAQ,CAAC,CAAC,KAAK,QAAQ;EAGhD,OAAO,SAAS,QAAQ;CAC1B;;CAGA,MAAM,aAA4B;EAChC,MAAM,KAAK,UAAU,WAAW;CAClC;AACF"}

package/dist/errors-GR3K_nRu.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors-GR3K_nRu.mjs","names":[],"sources":["../src/service/errors.ts","../src/layer/errors.ts"],"sourcesContent":["import type { AnyServiceToken } from './types'\n\n/** Thrown when a Service is accessed without an active runtime resolver. */\nexport class ServiceRuntimeNotConfiguredError extends Error {\n  constructor() {\n    super('No ServiceResolver is available in the current runtime context')\n\n    this.name = 'ServiceRuntimeNotConfiguredError'\n  }\n}\n\n/** Thrown when a runtime has no provider for the requested Service tag. */\nexport class ServiceNotFoundError extends Error {\n  constructor(readonly service: AnyServiceToken) {\n    super(`Service \"${service.serviceTag}\" was not provided`)\n\n    this.name = 'ServiceNotFoundError'\n  }\n}\n","import type { AnyServiceToken, ServiceClass } from '../service'\n\n/** Thrown when a Layer registers the same Service tag more than once. */\nexport class DuplicateServiceError extends Error {\n  constructor(readonly service: ServiceClass<any>) {\n    super(`Duplicate service tag \"${service.serviceTag}\"`)\n\n    this.name = 'DuplicateServiceError'\n  }\n}\n\n/** Thrown when one Service tag is associated with incompatible constructors. */\nexport class ServiceTagCollisionError extends Error {\n  constructor(\n    readonly existing: AnyServiceToken,\n    readonly incoming: AnyServiceToken\n  ) {\n    super(\n      `Service tag \"${incoming.serviceTag}\" is already associated with \"${existing.name}\" ` +\n        `and cannot be associated with \"${incoming.name}\"`\n    )\n\n    this.name = 'ServiceTagCollisionError'\n  }\n}\n\n/** Thrown when a backend fails while registering a Layer provider. */\nexport class LayerRegistrationError extends Error {\n  constructor(\n    readonly service: ServiceClass<any> | undefined,\n    readonly registrationCause: unknown,\n    readonly cleanupCause?: unknown\n  ) {\n    super(\n      service ? `Failed to register service \"${service.serviceTag}\"` : 'Failed to build Layer',\n      {\n        cause: registrationCause\n      }\n    )\n\n    this.name = 'LayerRegistrationError'\n  }\n}\n\n/** Thrown when one or more Layer-owned resources fail during disposal. */\nexport class LayerDisposeError extends Error {\n  constructor(readonly causes: readonly unknown[]) {\n    super(`Failed to dispose Layer (${causes.length} error${causes.length === 1 ? '' : 's'})`)\n\n    this.name = 'LayerDisposeError'\n  }\n}\n\n/** Thrown when a Layer generator yields a value other than a Service requirement. */\nexport class LayerGeneratorYieldError extends Error {\n  constructor(readonly service: ServiceClass<any>) {\n    super(`Layer.gen(\"${service.serviceTag}\") yielded an unsupported value`)\n\n    this.name = 'LayerGeneratorYieldError'\n  }\n}\n"],"mappings":";;AAGA,IAAa,mCAAb,cAAsD,MAAM;CAC1D,cAAc;EACZ,MAAM,gEAAgE;EAEtE,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,uBAAb,cAA0C,MAAM;CACzB;CAArB,YAAY,SAAmC;EAC7C,MAAM,YAAY,QAAQ,WAAW,mBAAmB;EADrC,KAAA,UAAA;EAGnB,KAAK,OAAO;CACd;AACF;;;;ACfA,IAAa,wBAAb,cAA2C,MAAM;CAC1B;CAArB,YAAY,SAAqC;EAC/C,MAAM,0BAA0B,QAAQ,WAAW,EAAE;EADlC,KAAA,UAAA;EAGnB,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,2BAAb,cAA8C,MAAM;CAEvC;CACA;CAFX,YACE,UACA,UACA;EACA,MACE,gBAAgB,SAAS,WAAW,gCAAgC,SAAS,KAAK,mCAC9C,SAAS,KAAK,EACpD;EANS,KAAA,WAAA;EACA,KAAA,WAAA;EAOT,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,yBAAb,cAA4C,MAAM;CAErC;CACA;CACA;CAHX,YACE,SACA,mBACA,cACA;EACA,MACE,UAAU,+BAA+B,QAAQ,WAAW,KAAK,yBACjE,EACE,OAAO,kBACT,CACF;EATS,KAAA,UAAA;EACA,KAAA,oBAAA;EACA,KAAA,eAAA;EAST,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,oBAAb,cAAuC,MAAM;CACtB;CAArB,YAAY,QAAqC;EAC/C,MAAM,4BAA4B,OAAO,OAAO,QAAQ,OAAO,WAAW,IAAI,KAAK,IAAI,EAAE;EADtE,KAAA,SAAA;EAGnB,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,2BAAb,cAA8C,MAAM;CAC7B;CAArB,YAAY,SAAqC;EAC/C,MAAM,cAAc,QAAQ,WAAW,gCAAgC;EADpD,KAAA,UAAA;EAGnB,KAAK,OAAO;CACd;AACF"}
+{"version":3,"file":"errors-GR3K_nRu.mjs","names":[],"sources":["../src/service/errors.ts","../src/layer/errors.ts"],"sourcesContent":["import type { AnyServiceToken } from './types'\n\n/** Thrown when a Service is accessed without an active runtime resolver. */\nexport class ServiceRuntimeNotConfiguredError extends Error {\n  constructor() {\n    super('No ServiceResolver is available in the current runtime context')\n\n    this.name = 'ServiceRuntimeNotConfiguredError'\n  }\n}\n\n/** Thrown when a runtime has no provider for the requested Service tag. */\nexport class ServiceNotFoundError extends Error {\n  constructor(readonly service: AnyServiceToken) {\n    super(`Service \"${service.serviceTag}\" was not provided`)\n\n    this.name = 'ServiceNotFoundError'\n  }\n}\n","import type { AnyServiceToken, ServiceClass } from '../service'\nimport type { ScopeOutcome } from '../scope'\n\ntype LayerCause = Extract<ScopeOutcome, { readonly status: 'failure' }>['cause']\n\n/** Thrown when a Layer registers the same Service tag more than once. */\nexport class DuplicateServiceError extends Error {\n  constructor(readonly service: ServiceClass<any>) {\n    super(`Duplicate service tag \"${service.serviceTag}\"`)\n\n    this.name = 'DuplicateServiceError'\n  }\n}\n\n/** Thrown when one Service tag is associated with incompatible constructors. */\nexport class ServiceTagCollisionError extends Error {\n  constructor(\n    readonly existing: AnyServiceToken,\n    readonly incoming: AnyServiceToken\n  ) {\n    super(\n      `Service tag \"${incoming.serviceTag}\" is already associated with \"${existing.name}\" ` +\n        `and cannot be associated with \"${incoming.name}\"`\n    )\n\n    this.name = 'ServiceTagCollisionError'\n  }\n}\n\n/** Thrown when a backend fails while registering a Layer provider. */\nexport class LayerRegistrationError extends Error {\n  constructor(\n    readonly service: ServiceClass<any> | undefined,\n    readonly registrationCause: LayerCause,\n    readonly cleanupCause?: LayerCause\n  ) {\n    super(\n      service ? `Failed to register service \"${service.serviceTag}\"` : 'Failed to build Layer',\n      {\n        cause: registrationCause\n      }\n    )\n\n    this.name = 'LayerRegistrationError'\n  }\n}\n\n/** Thrown when one or more Layer-owned resources fail during disposal. */\nexport class LayerDisposeError extends Error {\n  constructor(readonly causes: readonly unknown[]) {\n    super(`Failed to dispose Layer (${causes.length} error${causes.length === 1 ? '' : 's'})`)\n\n    this.name = 'LayerDisposeError'\n  }\n}\n\n/** Thrown when a Layer generator yields a value other than a Service requirement. */\nexport class LayerGeneratorYieldError extends Error {\n  constructor(readonly service: ServiceClass<any>) {\n    super(`Layer.gen(\"${service.serviceTag}\") yielded an unsupported value`)\n\n    this.name = 'LayerGeneratorYieldError'\n  }\n}\n"],"mappings":";;AAGA,IAAa,mCAAb,cAAsD,MAAM;CAC1D,cAAc;EACZ,MAAM,gEAAgE;EAEtE,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,uBAAb,cAA0C,MAAM;CACzB;CAArB,YAAY,SAAmC;EAC7C,MAAM,YAAY,QAAQ,WAAW,mBAAmB;EADrC,KAAA,UAAA;EAGnB,KAAK,OAAO;CACd;AACF;;;;ACZA,IAAa,wBAAb,cAA2C,MAAM;CAC1B;CAArB,YAAY,SAAqC;EAC/C,MAAM,0BAA0B,QAAQ,WAAW,EAAE;EADlC,KAAA,UAAA;EAGnB,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,2BAAb,cAA8C,MAAM;CAEvC;CACA;CAFX,YACE,UACA,UACA;EACA,MACE,gBAAgB,SAAS,WAAW,gCAAgC,SAAS,KAAK,mCAC9C,SAAS,KAAK,EACpD;EANS,KAAA,WAAA;EACA,KAAA,WAAA;EAOT,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,yBAAb,cAA4C,MAAM;CAErC;CACA;CACA;CAHX,YACE,SACA,mBACA,cACA;EACA,MACE,UAAU,+BAA+B,QAAQ,WAAW,KAAK,yBACjE,EACE,OAAO,kBACT,CACF;EATS,KAAA,UAAA;EACA,KAAA,oBAAA;EACA,KAAA,eAAA;EAST,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,oBAAb,cAAuC,MAAM;CACtB;CAArB,YAAY,QAAqC;EAC/C,MAAM,4BAA4B,OAAO,OAAO,QAAQ,OAAO,WAAW,IAAI,KAAK,IAAI,EAAE;EADtE,KAAA,SAAA;EAGnB,KAAK,OAAO;CACd;AACF;;AAGA,IAAa,2BAAb,cAA8C,MAAM;CAC7B;CAArB,YAAY,SAAqC;EAC/C,MAAM,cAAc,QAAQ,WAAW,gCAAgC;EADpD,KAAA,UAAA;EAGnB,KAAK,OAAO;CACd;AACF"}