@vielzeug/conduit 1.0.2

package/dist/types.d.ts

@@ -0,0 +1,169 @@
+export type Token<T = unknown> = symbol & {
+    __type?: T;
+};
+export declare function token<T>(description: string): Token<T>;
+export type ScopeToken = symbol & {
+    __scopeToken?: never;
+};
+/**
+ * Creates a named scope token. Factories registered with a ScopeToken lifetime
+ * are only resolvable from a container created with createScope(scopeToken).
+ */
+export declare function scope(name: string): ScopeToken;
+/** Caching strategy for factory registrations. Named scopes use a ScopeToken. */
+export type Lifetime = 'singleton' | 'transient' | ScopeToken;
+export type ValueOptions<T> = {
+    dispose?: (instance: T) => Promise<void> | void;
+};
+export type FactoryOptions<T> = {
+    /** Optional statically-declared dependencies. Used for early validation in `freeze()`. */
+    deps?: readonly Token<any>[];
+    dispose?: (instance: T) => Promise<void> | void;
+    lifetime?: Lifetime;
+};
+/** Minimal resolver passed to every factory function. */
+export interface FactoryResolver {
+    resolve<T>(tok: Token<T>): Promise<T>;
+    /**
+     * Resolve synchronously. Works for value providers and already-resolved
+     * singleton/scoped instances. Throws `ConduitSyncResolutionError` if the instance
+     * has not been resolved yet.
+     */
+    resolveSync<T>(tok: Token<T>): T;
+}
+export type ContainerModule = (container: Container) => Promise<void> | void;
+export type ContainerEvent = {
+    description: string;
+    kind: 'factory' | 'value';
+    source: string;
+    type: 'register';
+} | {
+    description: string;
+    source: string;
+    type: 'resolve';
+} | {
+    source: string;
+    type: 'dispose';
+};
+export type ContainerEventListener = (event: ContainerEvent) => void;
+export type ResolveResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    error: unknown;
+    ok: false;
+};
+/**
+ * Infer the resolved-value tuple type from a `readonly` array of tokens.
+ * Mirrors the return type of `resolveMany`.
+ *
+ * @example
+ * const TOKENS = [AuthToken, LoggerToken] as const;
+ * type Services = InferTokenTypes<typeof TOKENS>;
+ * // → [AuthService, Logger]
+ */
+export type InferTokenTypes<T extends readonly Token<any>[]> = {
+    [K in keyof T]: T[K] extends Token<infer U> ? U : never;
+};
+/** Interceptor called after every successful resolution. Receives the token and resolved value. */
+export type ResolveInterceptor = <T>(tok: Token<T>, value: T) => void;
+export type ContainerNode = {
+    /** Statically-declared dependency token descriptions (from `deps:` option). */
+    deps?: string[];
+    description: string;
+    kind: 'factory' | 'value';
+    /** 'singleton', 'transient', or 'scope:<name>' for named scopes. */
+    lifetime?: 'singleton' | 'transient' | `scope:${string}`;
+};
+export type ContainerGraph = {
+    nodes: ContainerNode[];
+};
+export interface Container {
+    /** Delegates to `dispose()`. Enables `await using` declarations. */
+    [Symbol.asyncDispose](): Promise<void>;
+    /** Human-readable identifier for this container. Set via createContainer({ name }). */
+    readonly name: string;
+    /** `AbortSignal` aborted when the container is disposed. Use to tie external lifecycles to this container. */
+    readonly disposalSignal: AbortSignal;
+    /** Whether the container has been disposed. */
+    readonly disposed: boolean;
+    /** Register a static value. */
+    value<T>(tok: Token<T>, val: T, opts?: ValueOptions<T>): this;
+    /**
+     * Register a factory. The factory receives a `FactoryResolver` to resolve
+     * its own dependencies lazily via `resolver.resolve(Token)`.
+     */
+    factory<T>(tok: Token<T>, fn: (resolver: FactoryResolver) => Promise<T> | T, opts?: FactoryOptions<T>): this;
+    /** Check whether a token is registered (walks parent chain). */
+    has<T>(tok: Token<T>): boolean;
+    /** Resolve a single registered provider. */
+    resolve<T>(tok: Token<T>): Promise<T>;
+    /**
+     * Resolve a token synchronously.
+     * Works for value registrations and already-resolved singleton/scope instances.
+     * Throws `ConduitSyncResolutionError` for transient factories or unresolved singletons.
+     * Rethrows the cached rejection if the factory previously failed.
+     */
+    resolveSync<T>(tok: Token<T>): T;
+    /**
+     * Resolve multiple tokens in parallel, returning a typed tuple.
+     */
+    resolveMany<const D extends Token<any>[]>(toks: D): Promise<{
+        [K in keyof D]: D[K] extends Token<infer U> ? U : never;
+    }>;
+    /**
+     * Eagerly resolve all registered singleton factories across the entire
+     * container hierarchy. Useful for startup validation and pre-warming
+     * `resolveSync()` hot paths.
+     *
+     * Pass `{ includeScoped: true }` to also pre-warm named-scope factories
+     * registered on the current scope container.
+     */
+    resolveAll(opts?: {
+        includeScoped?: boolean;
+    }): Promise<void>;
+    /**
+     * Return a serializable graph of every registered token.
+     * By default traverses the full parent chain (deep: true).
+     */
+    inspect(opts?: {
+        deep?: boolean;
+    }): ContainerGraph;
+    /**
+     * Validate the registration graph without freezing it.
+     * Checks statically-declared `deps`: throws `ConduitProviderNotFoundError` if a
+     * declared dep is missing, or `ConduitCircularDependencyError` if they form a cycle.
+     * Throws `ConduitDisposedError` if the container is already disposed.
+     */
+    validate(): this;
+    /**
+     * Freeze the container, locking it against further registrations.
+     * After `freeze()`, `value()` and `factory()` throw `ConduitFrozenError`.
+     * Validates statically-declared `deps`: throws `ConduitProviderNotFoundError` if a
+     * declared dep is missing, or `ConduitCircularDependencyError` if they form a cycle.
+     * Idempotent — calling `freeze()` again on an already-frozen container is a no-op.
+     * Note: cycle detection for lazy (undeclared) deps happens at resolve time.
+     */
+    freeze(): this;
+    /**
+     * Create a child scope container. If `scopeToken` is provided, factories
+     * registered with that token as their lifetime are resolved and cached here.
+     * Omit `scopeToken` for a plain child container with no named scope.
+     */
+    createScope(scopeToken?: ScopeToken, opts?: {
+        name?: string;
+    }): Container;
+    /**
+     * Subscribe to container events (register, resolve, dispose).
+     * Events propagate up to parent containers. Returns an unsubscribe function.
+     */
+    on(listener: ContainerEventListener): () => void;
+    /**
+     * Register an interceptor called after every successful resolution.
+     * Returns an unsubscribe function. Interceptor errors are swallowed.
+     */
+    onResolve(interceptor: ResolveInterceptor): () => void;
+    /** Dispose the container, running all registered cleanup hooks in parallel. */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,11 @@
+//#region src/types.ts
+function e(e) {
+	return Symbol(e);
+}
+function t(e) {
+	return Symbol(e);
+}
+//#endregion
+export { t as scope, e as token };
+
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["// ---------------------------------------------------------------------------\n// Token\n// ---------------------------------------------------------------------------\n\nexport type Token<T = unknown> = symbol & { __type?: T };\n\nexport function token<T>(description: string): Token<T> {\n  return Symbol(description) as Token<T>;\n}\n\n// ---------------------------------------------------------------------------\n// ScopeToken — named lifecycle scopes\n// ---------------------------------------------------------------------------\n\nexport type ScopeToken = symbol & { __scopeToken?: never };\n\n/**\n * Creates a named scope token. Factories registered with a ScopeToken lifetime\n * are only resolvable from a container created with createScope(scopeToken).\n */\nexport function scope(name: string): ScopeToken {\n  return Symbol(name) as ScopeToken;\n}\n\n// ---------------------------------------------------------------------------\n// Lifetime & options\n// ---------------------------------------------------------------------------\n\n/** Caching strategy for factory registrations. Named scopes use a ScopeToken. */\nexport type Lifetime = 'singleton' | 'transient' | ScopeToken;\n\nexport type ValueOptions<T> = {\n  dispose?: (instance: T) => Promise<void> | void;\n};\n\nexport type FactoryOptions<T> = {\n  /** Optional statically-declared dependencies. Used for early validation in `freeze()`. */\n  deps?: readonly Token<any>[];\n  dispose?: (instance: T) => Promise<void> | void;\n  lifetime?: Lifetime;\n};\n\n// ---------------------------------------------------------------------------\n// Resolver — injected into factories\n// ---------------------------------------------------------------------------\n\n/** Minimal resolver passed to every factory function. */\nexport interface FactoryResolver {\n  resolve<T>(tok: Token<T>): Promise<T>;\n  /**\n   * Resolve synchronously. Works for value providers and already-resolved\n   * singleton/scoped instances. Throws `ConduitSyncResolutionError` if the instance\n   * has not been resolved yet.\n   */\n  resolveSync<T>(tok: Token<T>): T;\n}\n\n// ---------------------------------------------------------------------------\n// ContainerModule — grouping and async setup\n// ---------------------------------------------------------------------------\n\nexport type ContainerModule = (container: Container) => Promise<void> | void;\n\n// ---------------------------------------------------------------------------\n// Events — observable container state\n// ---------------------------------------------------------------------------\n\nexport type ContainerEvent =\n  | { description: string; kind: 'factory' | 'value'; source: string; type: 'register' }\n  | { description: string; source: string; type: 'resolve' }\n  | { source: string; type: 'dispose' };\n\nexport type ContainerEventListener = (event: ContainerEvent) => void;\n\n// ---------------------------------------------------------------------------\n// Result type\n// ---------------------------------------------------------------------------\n\nexport type ResolveResult<T> = { ok: true; value: T } | { error: unknown; ok: false };\n\n/**\n * Infer the resolved-value tuple type from a `readonly` array of tokens.\n * Mirrors the return type of `resolveMany`.\n *\n * @example\n * const TOKENS = [AuthToken, LoggerToken] as const;\n * type Services = InferTokenTypes<typeof TOKENS>;\n * // → [AuthService, Logger]\n */\nexport type InferTokenTypes<T extends readonly Token<any>[]> = {\n  [K in keyof T]: T[K] extends Token<infer U> ? U : never;\n};\n\n/** Interceptor called after every successful resolution. Receives the token and resolved value. */\nexport type ResolveInterceptor = <T>(tok: Token<T>, value: T) => void;\n\n// ---------------------------------------------------------------------------\n// ContainerGraph — inspect() output\n// ---------------------------------------------------------------------------\n\nexport type ContainerNode = {\n  /** Statically-declared dependency token descriptions (from `deps:` option). */\n  deps?: string[];\n  description: string;\n  kind: 'factory' | 'value';\n  /** 'singleton', 'transient', or 'scope:<name>' for named scopes. */\n  lifetime?: 'singleton' | 'transient' | `scope:${string}`;\n};\n\nexport type ContainerGraph = {\n  nodes: ContainerNode[];\n};\n\n// ---------------------------------------------------------------------------\n// Container public interface\n// ---------------------------------------------------------------------------\n\nexport interface Container {\n  /** Delegates to `dispose()`. Enables `await using` declarations. */\n  [Symbol.asyncDispose](): Promise<void>;\n  /** Human-readable identifier for this container. Set via createContainer({ name }). */\n  readonly name: string;\n\n  /** `AbortSignal` aborted when the container is disposed. Use to tie external lifecycles to this container. */\n  readonly disposalSignal: AbortSignal;\n\n  /** Whether the container has been disposed. */\n  readonly disposed: boolean;\n\n  /** Register a static value. */\n  value<T>(tok: Token<T>, val: T, opts?: ValueOptions<T>): this;\n\n  /**\n   * Register a factory. The factory receives a `FactoryResolver` to resolve\n   * its own dependencies lazily via `resolver.resolve(Token)`.\n   */\n  factory<T>(tok: Token<T>, fn: (resolver: FactoryResolver) => Promise<T> | T, opts?: FactoryOptions<T>): this;\n\n  /** Check whether a token is registered (walks parent chain). */\n  has<T>(tok: Token<T>): boolean;\n\n  /** Resolve a single registered provider. */\n  resolve<T>(tok: Token<T>): Promise<T>;\n\n  /**\n   * Resolve a token synchronously.\n   * Works for value registrations and already-resolved singleton/scope instances.\n   * Throws `ConduitSyncResolutionError` for transient factories or unresolved singletons.\n   * Rethrows the cached rejection if the factory previously failed.\n   */\n  resolveSync<T>(tok: Token<T>): T;\n\n  /**\n   * Resolve multiple tokens in parallel, returning a typed tuple.\n   */\n  resolveMany<const D extends Token<any>[]>(\n    toks: D,\n  ): Promise<{ [K in keyof D]: D[K] extends Token<infer U> ? U : never }>;\n\n  /**\n   * Eagerly resolve all registered singleton factories across the entire\n   * container hierarchy. Useful for startup validation and pre-warming\n   * `resolveSync()` hot paths.\n   *\n   * Pass `{ includeScoped: true }` to also pre-warm named-scope factories\n   * registered on the current scope container.\n   */\n  resolveAll(opts?: { includeScoped?: boolean }): Promise<void>;\n\n  /**\n   * Return a serializable graph of every registered token.\n   * By default traverses the full parent chain (deep: true).\n   */\n  inspect(opts?: { deep?: boolean }): ContainerGraph;\n\n  /**\n   * Validate the registration graph without freezing it.\n   * Checks statically-declared `deps`: throws `ConduitProviderNotFoundError` if a\n   * declared dep is missing, or `ConduitCircularDependencyError` if they form a cycle.\n   * Throws `ConduitDisposedError` if the container is already disposed.\n   */\n  validate(): this;\n\n  /**\n   * Freeze the container, locking it against further registrations.\n   * After `freeze()`, `value()` and `factory()` throw `ConduitFrozenError`.\n   * Validates statically-declared `deps`: throws `ConduitProviderNotFoundError` if a\n   * declared dep is missing, or `ConduitCircularDependencyError` if they form a cycle.\n   * Idempotent — calling `freeze()` again on an already-frozen container is a no-op.\n   * Note: cycle detection for lazy (undeclared) deps happens at resolve time.\n   */\n  freeze(): this;\n\n  /**\n   * Create a child scope container. If `scopeToken` is provided, factories\n   * registered with that token as their lifetime are resolved and cached here.\n   * Omit `scopeToken` for a plain child container with no named scope.\n   */\n  createScope(scopeToken?: ScopeToken, opts?: { name?: string }): Container;\n\n  /**\n   * Subscribe to container events (register, resolve, dispose).\n   * Events propagate up to parent containers. Returns an unsubscribe function.\n   */\n  on(listener: ContainerEventListener): () => void;\n\n  /**\n   * Register an interceptor called after every successful resolution.\n   * Returns an unsubscribe function. Interceptor errors are swallowed.\n   */\n  onResolve(interceptor: ResolveInterceptor): () => void;\n\n  /** Dispose the container, running all registered cleanup hooks in parallel. */\n  dispose(): Promise<void>;\n}\n"],"mappings":";AAMA,SAAgB,EAAS,GAA+B;CACtD,OAAO,OAAO,CAAW;AAC3B;AAYA,SAAgB,EAAM,GAA0B;CAC9C,OAAO,OAAO,CAAI;AACpB"}

package/dist/utils.cjs

@@ -0,0 +1,2 @@
+const e=require("./errors.cjs");async function t(t,n){try{return await t.resolve(n)}catch(t){if(t instanceof e.ConduitProviderNotFoundError)return;throw t}}async function n(e,n,r){let i=await t(e,n);return i===void 0?r:i}async function r(t,n){try{return{ok:!0,value:await t.resolve(n)}}catch(t){if(t instanceof e.ConduitProviderNotFoundError)return{error:t,ok:!1};throw t}}function i(t,n){try{return t.resolveSync(n)}catch(t){if(t instanceof e.ConduitProviderNotFoundError)return;throw t}}function a(e,t,n){let r=i(e,t);return r===void 0?n:r}function o(t,n){try{return{ok:!0,value:t.resolveSync(n)}}catch(t){if(t instanceof e.ConduitProviderNotFoundError)return{error:t,ok:!1};throw t}}async function s(e,...t){for(let n of t)await n(e);return e}exports.loadModules=s,exports.resolveOptional=t,exports.resolveOrDefault=n,exports.resolveSyncOptional=i,exports.resolveSyncOrDefault=a,exports.tryResolve=r,exports.trySyncResolve=o;
+//# sourceMappingURL=utils.cjs.map

package/dist/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","names":[],"sources":["../src/utils.ts"],"sourcesContent":["import type { Container, ContainerModule, ResolveResult, Token } from './types.js';\n\nimport { ConduitProviderNotFoundError } from './errors.js';\n\n/**\n * Resolve a token, returning `undefined` when not registered.\n * Re-throws any error other than `ConduitProviderNotFoundError`.\n */\nexport async function resolveOptional<T>(container: Container, tok: Token<T>): Promise<T | undefined> {\n  try {\n    return await container.resolve(tok);\n  } catch (error) {\n    if (error instanceof ConduitProviderNotFoundError) return undefined;\n\n    throw error;\n  }\n}\n\n/**\n * Resolve a token, returning `defaultValue` when not registered.\n * Re-throws any error other than `ConduitProviderNotFoundError`.\n */\nexport async function resolveOrDefault<T>(container: Container, tok: Token<T>, defaultValue: T): Promise<T> {\n  const result = await resolveOptional(container, tok);\n\n  return result === undefined ? defaultValue : result;\n}\n\n/**\n * Resolve a token, returning a result object instead of throwing.\n * Returns `{ ok: true, value }` on success or `{ ok: false, error }` when the\n * token is not registered. Re-throws all other errors — including\n * `ConduitDisposedError` and `ConduitCircularDependencyError`.\n */\nexport async function tryResolve<T>(container: Container, tok: Token<T>): Promise<ResolveResult<T>> {\n  try {\n    const value = await container.resolve(tok);\n\n    return { ok: true, value };\n  } catch (error) {\n    if (error instanceof ConduitProviderNotFoundError) return { error, ok: false };\n\n    throw error;\n  }\n}\n\n/**\n * Resolve a token synchronously, returning `undefined` when not registered.\n * Re-throws `ConduitSyncResolutionError`, `ConduitScopedResolutionError`, and `ConduitDisposedError`.\n */\nexport function resolveSyncOptional<T>(container: Container, tok: Token<T>): T | undefined {\n  try {\n    return container.resolveSync(tok);\n  } catch (error) {\n    if (error instanceof ConduitProviderNotFoundError) return undefined;\n\n    throw error;\n  }\n}\n\n/**\n * Resolve a token synchronously, returning `defaultValue` when not registered.\n * Re-throws `ConduitSyncResolutionError`, `ConduitScopedResolutionError`, and `ConduitDisposedError`.\n */\nexport function resolveSyncOrDefault<T>(container: Container, tok: Token<T>, defaultValue: T): T {\n  const result = resolveSyncOptional(container, tok);\n\n  return result === undefined ? defaultValue : result;\n}\n\n/**\n * Resolve a token synchronously, returning a result object instead of throwing.\n * Returns `{ ok: true, value }` on success or `{ ok: false, error }` when the\n * token is not registered. Re-throws all other errors — including\n * `ConduitSyncResolutionError`, `ConduitDisposedError`, and `ConduitScopedResolutionError`.\n */\nexport function trySyncResolve<T>(container: Container, tok: Token<T>): ResolveResult<T> {\n  try {\n    const value = container.resolveSync(tok);\n\n    return { ok: true, value };\n  } catch (error) {\n    if (error instanceof ConduitProviderNotFoundError) return { error, ok: false };\n\n    throw error;\n  }\n}\n\n/**\n * Apply container modules sequentially (each module may be async).\n * Returns the container for chaining.\n */\nexport async function loadModules(container: Container, ...modules: ContainerModule[]): Promise<Container> {\n  for (const mod of modules) await mod(container);\n\n  return container;\n}\n"],"mappings":"gCAQA,eAAsB,EAAmB,EAAsB,EAAuC,CACpG,GAAI,CACF,OAAO,MAAM,EAAU,QAAQ,CAAG,CACpC,OAAS,EAAO,CACd,GAAI,aAAiB,EAAA,6BAA8B,OAEnD,MAAM,CACR,CACF,CAMA,eAAsB,EAAoB,EAAsB,EAAe,EAA6B,CAC1G,IAAM,EAAS,MAAM,EAAgB,EAAW,CAAG,EAEnD,OAAO,IAAW,IAAA,GAAY,EAAe,CAC/C,CAQA,eAAsB,EAAc,EAAsB,EAA0C,CAClG,GAAI,CAGF,MAAO,CAAE,GAAI,GAAM,MAAA,MAFC,EAAU,QAAQ,CAAG,CAEhB,CAC3B,OAAS,EAAO,CACd,GAAI,aAAiB,EAAA,6BAA8B,MAAO,CAAE,QAAO,GAAI,EAAM,EAE7E,MAAM,CACR,CACF,CAMA,SAAgB,EAAuB,EAAsB,EAA8B,CACzF,GAAI,CACF,OAAO,EAAU,YAAY,CAAG,CAClC,OAAS,EAAO,CACd,GAAI,aAAiB,EAAA,6BAA8B,OAEnD,MAAM,CACR,CACF,CAMA,SAAgB,EAAwB,EAAsB,EAAe,EAAoB,CAC/F,IAAM,EAAS,EAAoB,EAAW,CAAG,EAEjD,OAAO,IAAW,IAAA,GAAY,EAAe,CAC/C,CAQA,SAAgB,EAAkB,EAAsB,EAAiC,CACvF,GAAI,CAGF,MAAO,CAAE,GAAI,GAAM,MAFL,EAAU,YAAY,CAEjB,CAAM,CAC3B,OAAS,EAAO,CACd,GAAI,aAAiB,EAAA,6BAA8B,MAAO,CAAE,QAAO,GAAI,EAAM,EAE7E,MAAM,CACR,CACF,CAMA,eAAsB,EAAY,EAAsB,GAAG,EAAgD,CACzG,IAAK,IAAM,KAAO,EAAS,MAAM,EAAI,CAAS,EAE9C,OAAO,CACT"}

package/dist/utils.d.ts

@@ -0,0 +1,41 @@
+import type { Container, ContainerModule, ResolveResult, Token } from './types.js';
+/**
+ * Resolve a token, returning `undefined` when not registered.
+ * Re-throws any error other than `ConduitProviderNotFoundError`.
+ */
+export declare function resolveOptional<T>(container: Container, tok: Token<T>): Promise<T | undefined>;
+/**
+ * Resolve a token, returning `defaultValue` when not registered.
+ * Re-throws any error other than `ConduitProviderNotFoundError`.
+ */
+export declare function resolveOrDefault<T>(container: Container, tok: Token<T>, defaultValue: T): Promise<T>;
+/**
+ * Resolve a token, returning a result object instead of throwing.
+ * Returns `{ ok: true, value }` on success or `{ ok: false, error }` when the
+ * token is not registered. Re-throws all other errors — including
+ * `ConduitDisposedError` and `ConduitCircularDependencyError`.
+ */
+export declare function tryResolve<T>(container: Container, tok: Token<T>): Promise<ResolveResult<T>>;
+/**
+ * Resolve a token synchronously, returning `undefined` when not registered.
+ * Re-throws `ConduitSyncResolutionError`, `ConduitScopedResolutionError`, and `ConduitDisposedError`.
+ */
+export declare function resolveSyncOptional<T>(container: Container, tok: Token<T>): T | undefined;
+/**
+ * Resolve a token synchronously, returning `defaultValue` when not registered.
+ * Re-throws `ConduitSyncResolutionError`, `ConduitScopedResolutionError`, and `ConduitDisposedError`.
+ */
+export declare function resolveSyncOrDefault<T>(container: Container, tok: Token<T>, defaultValue: T): T;
+/**
+ * Resolve a token synchronously, returning a result object instead of throwing.
+ * Returns `{ ok: true, value }` on success or `{ ok: false, error }` when the
+ * token is not registered. Re-throws all other errors — including
+ * `ConduitSyncResolutionError`, `ConduitDisposedError`, and `ConduitScopedResolutionError`.
+ */
+export declare function trySyncResolve<T>(container: Container, tok: Token<T>): ResolveResult<T>;
+/**
+ * Apply container modules sequentially (each module may be async).
+ * Returns the container for chaining.
+ */
+export declare function loadModules(container: Container, ...modules: ContainerModule[]): Promise<Container>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAInF;;;GAGG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAQpG;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAI1G;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAUlG;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAQzF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAI/F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAUvF;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAIzG"}

package/dist/utils.js

@@ -0,0 +1,62 @@
+import { ConduitProviderNotFoundError as e } from "./errors.js";
+//#region src/utils.ts
+async function t(t, n) {
+	try {
+		return await t.resolve(n);
+	} catch (t) {
+		if (t instanceof e) return;
+		throw t;
+	}
+}
+async function n(e, n, r) {
+	let i = await t(e, n);
+	return i === void 0 ? r : i;
+}
+async function r(t, n) {
+	try {
+		return {
+			ok: !0,
+			value: await t.resolve(n)
+		};
+	} catch (t) {
+		if (t instanceof e) return {
+			error: t,
+			ok: !1
+		};
+		throw t;
+	}
+}
+function i(t, n) {
+	try {
+		return t.resolveSync(n);
+	} catch (t) {
+		if (t instanceof e) return;
+		throw t;
+	}
+}
+function a(e, t, n) {
+	let r = i(e, t);
+	return r === void 0 ? n : r;
+}
+function o(t, n) {
+	try {
+		return {
+			ok: !0,
+			value: t.resolveSync(n)
+		};
+	} catch (t) {
+		if (t instanceof e) return {
+			error: t,
+			ok: !1
+		};
+		throw t;
+	}
+}
+async function s(e, ...t) {
+	for (let n of t) await n(e);
+	return e;
+}
+//#endregion
+export { s as loadModules, t as resolveOptional, n as resolveOrDefault, i as resolveSyncOptional, a as resolveSyncOrDefault, r as tryResolve, o as trySyncResolve };
+
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../src/utils.ts"],"sourcesContent":["import type { Container, ContainerModule, ResolveResult, Token } from './types.js';\n\nimport { ConduitProviderNotFoundError } from './errors.js';\n\n/**\n * Resolve a token, returning `undefined` when not registered.\n * Re-throws any error other than `ConduitProviderNotFoundError`.\n */\nexport async function resolveOptional<T>(container: Container, tok: Token<T>): Promise<T | undefined> {\n  try {\n    return await container.resolve(tok);\n  } catch (error) {\n    if (error instanceof ConduitProviderNotFoundError) return undefined;\n\n    throw error;\n  }\n}\n\n/**\n * Resolve a token, returning `defaultValue` when not registered.\n * Re-throws any error other than `ConduitProviderNotFoundError`.\n */\nexport async function resolveOrDefault<T>(container: Container, tok: Token<T>, defaultValue: T): Promise<T> {\n  const result = await resolveOptional(container, tok);\n\n  return result === undefined ? defaultValue : result;\n}\n\n/**\n * Resolve a token, returning a result object instead of throwing.\n * Returns `{ ok: true, value }` on success or `{ ok: false, error }` when the\n * token is not registered. Re-throws all other errors — including\n * `ConduitDisposedError` and `ConduitCircularDependencyError`.\n */\nexport async function tryResolve<T>(container: Container, tok: Token<T>): Promise<ResolveResult<T>> {\n  try {\n    const value = await container.resolve(tok);\n\n    return { ok: true, value };\n  } catch (error) {\n    if (error instanceof ConduitProviderNotFoundError) return { error, ok: false };\n\n    throw error;\n  }\n}\n\n/**\n * Resolve a token synchronously, returning `undefined` when not registered.\n * Re-throws `ConduitSyncResolutionError`, `ConduitScopedResolutionError`, and `ConduitDisposedError`.\n */\nexport function resolveSyncOptional<T>(container: Container, tok: Token<T>): T | undefined {\n  try {\n    return container.resolveSync(tok);\n  } catch (error) {\n    if (error instanceof ConduitProviderNotFoundError) return undefined;\n\n    throw error;\n  }\n}\n\n/**\n * Resolve a token synchronously, returning `defaultValue` when not registered.\n * Re-throws `ConduitSyncResolutionError`, `ConduitScopedResolutionError`, and `ConduitDisposedError`.\n */\nexport function resolveSyncOrDefault<T>(container: Container, tok: Token<T>, defaultValue: T): T {\n  const result = resolveSyncOptional(container, tok);\n\n  return result === undefined ? defaultValue : result;\n}\n\n/**\n * Resolve a token synchronously, returning a result object instead of throwing.\n * Returns `{ ok: true, value }` on success or `{ ok: false, error }` when the\n * token is not registered. Re-throws all other errors — including\n * `ConduitSyncResolutionError`, `ConduitDisposedError`, and `ConduitScopedResolutionError`.\n */\nexport function trySyncResolve<T>(container: Container, tok: Token<T>): ResolveResult<T> {\n  try {\n    const value = container.resolveSync(tok);\n\n    return { ok: true, value };\n  } catch (error) {\n    if (error instanceof ConduitProviderNotFoundError) return { error, ok: false };\n\n    throw error;\n  }\n}\n\n/**\n * Apply container modules sequentially (each module may be async).\n * Returns the container for chaining.\n */\nexport async function loadModules(container: Container, ...modules: ContainerModule[]): Promise<Container> {\n  for (const mod of modules) await mod(container);\n\n  return container;\n}\n"],"mappings":";;AAQA,eAAsB,EAAmB,GAAsB,GAAuC;CACpG,IAAI;EACF,OAAO,MAAM,EAAU,QAAQ,CAAG;CACpC,SAAS,GAAO;EACd,IAAI,aAAiB,GAA8B;EAEnD,MAAM;CACR;AACF;AAMA,eAAsB,EAAoB,GAAsB,GAAe,GAA6B;CAC1G,IAAM,IAAS,MAAM,EAAgB,GAAW,CAAG;CAEnD,OAAO,MAAW,KAAA,IAAY,IAAe;AAC/C;AAQA,eAAsB,EAAc,GAAsB,GAA0C;CAClG,IAAI;EAGF,OAAO;GAAE,IAAI;GAAM,OAAA,MAFC,EAAU,QAAQ,CAAG;EAEhB;CAC3B,SAAS,GAAO;EACd,IAAI,aAAiB,GAA8B,OAAO;GAAE;GAAO,IAAI;EAAM;EAE7E,MAAM;CACR;AACF;AAMA,SAAgB,EAAuB,GAAsB,GAA8B;CACzF,IAAI;EACF,OAAO,EAAU,YAAY,CAAG;CAClC,SAAS,GAAO;EACd,IAAI,aAAiB,GAA8B;EAEnD,MAAM;CACR;AACF;AAMA,SAAgB,EAAwB,GAAsB,GAAe,GAAoB;CAC/F,IAAM,IAAS,EAAoB,GAAW,CAAG;CAEjD,OAAO,MAAW,KAAA,IAAY,IAAe;AAC/C;AAQA,SAAgB,EAAkB,GAAsB,GAAiC;CACvF,IAAI;EAGF,OAAO;GAAE,IAAI;GAAM,OAFL,EAAU,YAAY,CAEjB;EAAM;CAC3B,SAAS,GAAO;EACd,IAAI,aAAiB,GAA8B,OAAO;GAAE;GAAO,IAAI;EAAM;EAE7E,MAAM;CACR;AACF;AAMA,eAAsB,EAAY,GAAsB,GAAG,GAAgD;CACzG,KAAK,IAAM,KAAO,GAAS,MAAM,EAAI,CAAS;CAE9C,OAAO;AACT"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@vielzeug/conduit",
+  "version": "1.0.2",
+  "description": "Lightweight dependency injection container — singletons, transient instances, factories, and named scopes",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "vite build && pnpm run build:bundle && pnpm run build:types",
+    "build:types": "tsc -p tsconfig.declarations.json",
+    "fix": "eslint --fix src",
+    "lint": "eslint src",
+    "prepublishOnly": "pnpm run build",
+    "preview": "vite preview",
+    "test": "vitest",
+    "build:bundle": "vite build --config vite.bundle.config.ts"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.0",
+    "typescript": "~6.0.3",
+    "vite": "^8.1.3",
+    "vitest": "^4.1.9"
+  }
+}