@digital-alchemy/core 26.1.9 → 26.5.1

package/dist/helpers/logger.mjs

@@ -1,23 +1,63 @@
+/**
+ * Logger interface and configuration — dual-arity log methods, color schemes,
+ * and a last-resort stderr writer.
+ *
+ * @remarks
+ * The logger supports six severity levels (trace, debug, info, warn, error, fatal)
+ * and dual-arity calls: `logger.info("message")` or `logger.info({ context, id }, "message")`.
+ * The logger service wraps this interface with chalk/stdout formatting, ALS
+ * integration, and LOG_LEVEL filtering. `fatalLog` is the last-resort writer for
+ * fatal conditions that cannot use the logger (e.g., during bootstrap failure).
+ */
 import fs from "node:fs";
 import { is, SINGLE } from "../index.mjs";
+/**
+ * Mapping from log level to console color for pretty-printed output.
+ */
 export const METHOD_COLORS = new Map([
     ["trace", "grey"],
     ["debug", "blue"],
+    ["info", "green"],
     ["warn", "yellow"],
     ["error", "red"],
-    ["info", "green"],
     ["fatal", "magenta"],
 ]);
+/**
+ * Event name for log level configuration updates.
+ *
+ * @internal
+ */
 export const EVENT_UPDATE_LOG_LEVELS = "EVENT_UPDATE_LOG_LEVELS";
+/**
+ * Last-resort logger for fatal conditions that cannot use the normal logger.
+ *
+ * @remarks
+ * Writes directly to `stderr` bypassing the logger service. Use only when the
+ * logger is not available (e.g., during bootstrap failure before services are
+ * wired). If `data` is an Error, extracts and formats `name`, `cause`, `message`,
+ * and stack trace; otherwise, JSON-stringifies it. Always adds a trailing newline.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await bootstrap();
+ * } catch (error) {
+ *   fatalLog("bootstrap failed", error);
+ *   process.exit(1);
+ * }
+ * ```
+ */
 export function fatalLog(message, data) {
     if (data) {
         if (data instanceof Error) {
+            // extract structured error fields with fallback defaults
             const cause = is.string(data?.cause) && !is.empty(data?.cause) ? ` - ${data.cause}` : "";
             const stack = data.stack ? `\n` + data.stack.split("\n").slice(SINGLE).join("\n") : ``;
             const errorOutput = `${data.name || "Error"}${cause}: ${data.message || "Unknown error"}${stack}`;
             message = [message, errorOutput].join("\n");
         }
         else {
+            // pretty-print non-error data
             message = [message, JSON.stringify(data, undefined, "  ")].join("\n");
         }
     }

package/dist/helpers/logger.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"logger.mjs","sourceRoot":"","sources":["../../src/helpers/logger.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAIzB,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AA+E1C,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAgC;IAClE,CAAC,OAAO,EAAE,MAAM,CAAC;IACjB,CAAC,OAAO,EAAE,MAAM,CAAC;IACjB,CAAC,MAAM,EAAE,QAAQ,CAAC;IAClB,CAAC,OAAO,EAAE,KAAK,CAAC;IAChB,CAAC,MAAM,EAAE,OAAO,CAAC;IACjB,CAAC,OAAO,EAAE,SAAS,CAAC;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAyB,CAAC;AAEjE,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,IAAc;IACtD,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,IAAI,YAAY,KAAK,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvF,MAAM,WAAW,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,GAAG,KAAK,KAAK,IAAI,CAAC,OAAO,IAAI,eAAe,GAAG,KAAK,EAAE,CAAC;YAClG,OAAO,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,OAAO,IAAI,CAAC,CAAC;AAClD,CAAC"}
+{"version":3,"file":"logger.mjs","sourceRoot":"","sources":["../../src/helpers/logger.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AAIzB,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAqN1C;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAgC;IAClE,CAAC,OAAO,EAAE,MAAM,CAAC;IACjB,CAAC,OAAO,EAAE,MAAM,CAAC;IACjB,CAAC,MAAM,EAAE,OAAO,CAAC;IACjB,CAAC,MAAM,EAAE,QAAQ,CAAC;IAClB,CAAC,OAAO,EAAE,KAAK,CAAC;IAChB,CAAC,OAAO,EAAE,SAAS,CAAC;CACrB,CAAC,CAAC;AAOH;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAyB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,IAAc;IACtD,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,IAAI,YAAY,KAAK,EAAE,CAAC;YAC1B,yDAAyD;YACzD,MAAM,KAAK,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvF,MAAM,WAAW,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,GAAG,KAAK,KAAK,IAAI,CAAC,OAAO,IAAI,eAAe,GAAG,KAAK,EAAE,CAAC;YAClG,OAAO,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,8BAA8B;YAC9B,OAAO,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,OAAO,IAAI,CAAC,CAAC;AAClD,CAAC"}

package/dist/helpers/module.d.mts

@@ -2,13 +2,31 @@ import type { Except, Merge } from "type-fest";
 import type { iTestRunner } from "../index.mts";
 import type { OptionalModuleConfiguration } from "./config.mts";
 import type { ApplicationDefinition, LibraryDefinition, ServiceFunction, ServiceMap, TLibrary } from "./wiring.mts";
+/**
+ * Options that control how {@link DigitalAlchemyModule.extend} behaves when
+ * forking a module into a modified copy.
+ */
 export type ExtendOptions = {
+    /** Override the name given to the extended module. */
     name?: string;
     /**
      * default: true
      */
     keepConfiguration?: boolean;
 };
+/**
+ * Intermediate representation of a Digital Alchemy module before it is
+ * committed to a concrete form (library, application, or test runner).
+ *
+ * @remarks
+ * A `DigitalAlchemyModule` holds the full set of services and configuration
+ * that would be passed to `CreateLibrary` or `CreateApplication`, but defers
+ * that commitment so callers can compose and mutate before export.
+ *
+ * Call `.extend()` to obtain a {@link ModuleExtension} builder, then chain
+ * mutations before finalising with `.toLibrary()`, `.toApplication()`, or
+ * `.toTest()`.
+ */
 export type DigitalAlchemyModule<S extends ServiceMap, C extends OptionalModuleConfiguration> = {
     services: S;
     configuration: C;
@@ -18,6 +36,14 @@ export type DigitalAlchemyModule<S extends ServiceMap, C extends OptionalModuleC
     priorityInit: string[];
     extend: (options?: ExtendOptions) => ModuleExtension<S, C>;
 };
+/**
+ * Input shape required to construct a {@link DigitalAlchemyModule}.
+ *
+ * @remarks
+ * Mirrors `LibraryConfigurationOptions` but without the `type` discriminant or
+ * the runtime wiring symbol — those are added by `CreateLibrary` /
+ * `CreateApplication` at export time.
+ */
 export type CreateModuleOptions<S extends ServiceMap, C extends OptionalModuleConfiguration> = {
     services: S;
     configuration: C;
@@ -27,46 +53,130 @@ export type CreateModuleOptions<S extends ServiceMap, C extends OptionalModuleCo
     priorityInit: string[];
 };
 /**
+ * Chainable builder returned by {@link DigitalAlchemyModule.extend}.
+ *
+ * @remarks
+ * Each mutation method returns the same `ModuleExtension` instance (or a
+ * narrowed variant of it), enabling fluent composition. The builder holds
+ * mutable references to the service map and dependency list; calling any
+ * terminal method (`.toLibrary()`, `.toApplication()`, `.toTest()`) reads the
+ * current state and produces an immutable definition.
+ *
+ * **Method categories:**
+ * - *Dependency mutations:* `appendLibrary`, `replaceLibrary`
+ * - *Service mutations:* `appendService`, `replaceService`, `pickService`,
+ *   `omitService`, `rebuild`
+ * - *Terminal exports:* `toApplication`, `toLibrary`, `toTest`
+ *
  * commands mutate module
  */
 export type ModuleExtension<S extends ServiceMap, C extends OptionalModuleConfiguration> = {
+    /**
+     * Add a new library dependency not present in the base module.
+     *
+     * @remarks
+     * Throws if the library name is already appended or exists in the base
+     * `depends` list — use `replaceLibrary` in that case.
+     */
     appendLibrary: (library: TLibrary) => ModuleExtension<S, C>;
+    /**
+     * Inject an additional service that is not declared in the base module.
+     *
+     * @remarks
+     * Throws if a service with the same name already exists — use
+     * `replaceService` in that case.
+     */
     appendService: (name: string, target: ServiceFunction) => ModuleExtension<S, C>;
     /**
+     * Swap a library dependency by name.
+     *
      * name must match existing library
      */
     replaceLibrary: (library: TLibrary) => ModuleExtension<S, C>;
     /**
+     * Swap an existing service implementation while keeping the same key.
+     *
+     * @remarks
+     * The return type is narrowed to reflect the new function's signature.
+     * Throws if `name` does not exist in the current service map.
+     *
      * name must match existing service
      */
     replaceService: <TARGET extends keyof S, FN extends ServiceFunction>(name: TARGET, target: FN) => ModuleExtension<Merge<S, {
         [key in TARGET]: FN;
     }>, C>;
     /**
+     * Reduce the service map to only the named services.
+     *
+     * @remarks
+     * Throws if any supplied name does not exist in the current service map.
+     *
      * throws if any service does not exist
      */
     pickService: <PICK extends keyof S>(...services: PICK[]) => ModuleExtension<Pick<S, PICK>, C>;
     /**
+     * Remove specific services from the service map.
+     *
+     * @remarks
+     * Throws if any supplied name does not exist in the current service map.
+     *
      * throws if any service does not exist
      */
     omitService: <OMIT extends keyof S>(...services: OMIT[]) => ModuleExtension<Except<S, OMIT>, C>;
     /**
+     * Replace the entire service map with a new set.
+     *
+     * @remarks
+     * `services` must extend `S` (i.e., it must be API-compatible with the
+     * original map). Use when rebuilding several services at once.
+     *
      * build api compatible replacement (potentially adding)
      */
     rebuild: <REPLACEMENTS extends S>(services: Partial<REPLACEMENTS>) => ModuleExtension<REPLACEMENTS, C>;
     /**
+     * Finalise as an {@link ApplicationDefinition} for use with `bootstrap`.
+     *
      * export as application
      */
     toApplication: () => ApplicationDefinition<S, C>;
     /**
+     * Finalise as a {@link LibraryDefinition} for use as a dependency.
+     *
      * export as library
      */
     toLibrary: () => LibraryDefinition<S, C>;
     /**
+     * Finalise as an `iTestRunner` for use in vitest specs.
+     *
+     * @remarks
+     * Internally calls `.toApplication()` and wraps the result in a `TestRunner`.
+     * Prefer `.toTest()` in spec files over manually constructing both.
+     *
      * export as test
      */
     toTest: () => iTestRunner<S, C>;
 };
+/**
+ * Construct a new {@link DigitalAlchemyModule} from a raw options object.
+ *
+ * @remarks
+ * `createModule` is the entry point for the chainable module pattern. It
+ * captures the options into a working module object and exposes `.extend()` to
+ * begin the mutation chain. No library or application definition is produced
+ * until a terminal method is called on the resulting {@link ModuleExtension}.
+ *
+ * Use the static helpers `createModule.fromApplication` and
+ * `createModule.fromLibrary` to seed the builder from an existing definition
+ * instead of building from scratch.
+ *
+ * Typical call sequence:
+ * ```typescript
+ * createModule({ name: "my-lib", services, configuration, depends: [], priorityInit: [] })
+ *   .extend()
+ *   .appendLibrary(someLibrary)
+ *   .toLibrary();
+ * ```
+ */
 export declare function createModule<S extends ServiceMap, C extends OptionalModuleConfiguration>(options: CreateModuleOptions<S, C>): DigitalAlchemyModule<S, C>;
 export declare namespace createModule {
     var fromApplication: <S extends ServiceMap, C extends OptionalModuleConfiguration>(application: ApplicationDefinition<S, C>) => DigitalAlchemyModule<S, C>;

package/dist/helpers/module.mjs

@@ -1,7 +1,32 @@
 import { CreateApplication, TestRunner } from "../index.mjs";
+import { BootstrapException } from "./errors.mjs";
 import { deepExtend } from "./extend.mjs";
 import { CreateLibrary } from "./wiring.mjs";
-// #MARK: createModule
+// pure-helper file has no TServiceParams; tag bootstrap errors with a stable
+// module-scoped context so consumers can identify the origin in stack traces
+const MODULE_CONTEXT = "digital-alchemy:module";
+// --- createModule factory -----------------------------------------------------
+/**
+ * Construct a new {@link DigitalAlchemyModule} from a raw options object.
+ *
+ * @remarks
+ * `createModule` is the entry point for the chainable module pattern. It
+ * captures the options into a working module object and exposes `.extend()` to
+ * begin the mutation chain. No library or application definition is produced
+ * until a terminal method is called on the resulting {@link ModuleExtension}.
+ *
+ * Use the static helpers `createModule.fromApplication` and
+ * `createModule.fromLibrary` to seed the builder from an existing definition
+ * instead of building from scratch.
+ *
+ * Typical call sequence:
+ * ```typescript
+ * createModule({ name: "my-lib", services, configuration, depends: [], priorityInit: [] })
+ *   .extend()
+ *   .appendLibrary(someLibrary)
+ *   .toLibrary();
+ * ```
+ */
 export function createModule(options) {
     function extend(extendOptions) {
         const appendLibrary = new Map();
@@ -10,18 +35,20 @@ export function createModule(options) {
             appendLibrary: (library) => {
                 const name = library.name;
                 if (appendLibrary.has(name)) {
-                    throw new Error(`${name} already is appended`);
+                    throw new BootstrapException(MODULE_CONTEXT, "LIBRARY_ALREADY_APPENDED", `${name} already is appended`);
                 }
                 const exists = workingModule.depends.some(i => i.name === name);
                 if (exists) {
-                    throw new Error(`${name} exists as a library in base, use replaceLibrary`);
+                    // base depends list owns this name; callers must use replaceLibrary to swap it
+                    throw new BootstrapException(MODULE_CONTEXT, "LIBRARY_USE_REPLACE", `${name} exists as a library in base, use replaceLibrary`);
                 }
                 appendLibrary.set(name, library);
                 return extend;
             },
             appendService: (name, service) => {
                 if (name in services) {
-                    throw new Error(`${name} exists as a service in base, use replaceService`);
+                    // service already registered; callers must explicitly opt into replacement
+                    throw new BootstrapException(MODULE_CONTEXT, "SERVICE_USE_REPLACE", `${name} exists as a service in base, use replaceService`);
                 }
                 // @ts-expect-error the interface makes this type properly, idc
                 services[name] = service;
@@ -42,12 +69,14 @@ export function createModule(options) {
             replaceLibrary: (library) => {
                 const name = library.name;
                 if (appendLibrary.has(name)) {
+                    // already in the appended set — replace in-place
                     appendLibrary.set(name, library);
                 }
                 else {
                     const exists = workingModule.depends.some(i => i.name === name);
                     if (!exists) {
-                        throw new Error(`${name} does not exist in module yet`);
+                        // neither appended nor in base depends; require explicit append first
+                        throw new BootstrapException(MODULE_CONTEXT, "LIBRARY_NOT_FOUND", `${name} does not exist in module yet`);
                     }
                     appendLibrary.set(name, library);
                 }
@@ -56,13 +85,14 @@ export function createModule(options) {
             // @ts-expect-error I don't care
             replaceService: (name, target) => {
                 if (!(name in services)) {
-                    throw new Error(`${String(name)} does not exist to replace`);
+                    throw new BootstrapException(MODULE_CONTEXT, "SERVICE_NOT_FOUND", `${String(name)} does not exist to replace`);
                 }
                 // @ts-expect-error I don't care
                 services[name] = target;
                 return extend;
             },
             toApplication: () => {
+                // merge base depends and appended libraries; appended wins on name collision
                 const depends = {};
                 workingModule.depends?.forEach(i => (depends[i.name] = i));
                 appendLibrary.forEach((value, key) => (depends[key] = value));
@@ -77,6 +107,7 @@ export function createModule(options) {
                 });
             },
             toLibrary: () => {
+                // same merge logic as toApplication; both export forms share the same dependency union
                 const depends = {};
                 workingModule.depends?.forEach(i => (depends[i.name] = i));
                 appendLibrary.forEach((value, key) => (depends[key] = value));
@@ -108,6 +139,16 @@ export function createModule(options) {
     };
     return workingModule;
 }
+// --- Static helpers on createModule -------------------------------------------
+/**
+ * Seed a {@link DigitalAlchemyModule} from an existing
+ * {@link ApplicationDefinition}.
+ *
+ * @remarks
+ * Copies services, configuration, libraries, and `priorityInit` into the
+ * intermediate module shape so callers can fork and modify an application
+ * without reconstructing it from scratch.
+ */
 // #MARK: fromApplication
 createModule.fromApplication = (application) => {
     return createModule({
@@ -119,6 +160,14 @@ createModule.fromApplication = (application) => {
         services: application.services,
     });
 };
+/**
+ * Seed a {@link DigitalAlchemyModule} from an existing
+ * {@link LibraryDefinition}.
+ *
+ * @remarks
+ * Mirrors `fromApplication` but for library definitions, preserving
+ * `optionalDepends` which applications do not carry.
+ */
 // #MARK: fromLibrary
 createModule.fromLibrary = (library) => {
     return createModule({

package/dist/helpers/module.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"module.mjs","sourceRoot":"","sources":["../../src/helpers/module.mts"],"names":[],"mappings":"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"}
+{"version":3,"file":"module.mjs","sourceRoot":"","sources":["../../src/helpers/module.mts"],"names":[],"mappings":"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"}

package/dist/helpers/service-runner.d.mts

@@ -1,3 +1,13 @@
+/**
+ * Minimal single-service bootstrap helper for scripts and one-off operations.
+ *
+ * @remarks
+ * `ServiceRunner` creates a complete DI graph for a single service, handling
+ * all wiring, lifecycle, and teardown. It is useful for scripts that need
+ * access to the full framework without building an application. The service
+ * function receives the same `TServiceParams` as a normal service, allowing
+ * access to config, logger, scheduler, and other boilerplate.
+ */
 import type { OptionalModuleConfiguration } from "./config.mts";
 import type { ApplicationConfigurationOptions, BootstrapOptions, ConfigTypes, ServiceMap, TInjectedConfig, TServiceParams } from "./wiring.mts";
 type ServiceRunnerConfiguration<C extends OptionalModuleConfiguration, NAME extends string> = Omit<ApplicationConfigurationOptions<ServiceMap, C>, "services" | "name" | "priorityInit"> & {
@@ -7,7 +17,23 @@ type LocalServiceParams<C extends OptionalModuleConfiguration, NAME extends stri
     config: TInjectedConfig & Record<NAME, ConfigTypes<C>>;
 };
 /**
- * Type safe way to kick off a mini service / script
+ * Bootstrap and run a single typed service with full framework support.
+ *
+ * @remarks
+ * Creates an application with a single service, invokes its bootstrap lifecycle,
+ * and returns when the service completes. The service runs synchronously within
+ * the context of a fully-initialized DI graph, with access to all boilerplate
+ * services (logger, scheduler, lifecycle, config, etc.).
+ *
+ * @example
+ * ```typescript
+ * await ServiceRunner(
+ *   { configuration: { myLib: {...} } },
+ *   ({ logger, config }) => {
+ *     logger.info("running with config:", config.myLib);
+ *   }
+ * );
+ * ```
  */
 export declare function ServiceRunner<C extends OptionalModuleConfiguration, NAME extends string = "dynamic">({ bootstrap, ...config }: ServiceRunnerConfiguration<C, NAME> & {
     bootstrap?: BootstrapOptions;

package/dist/helpers/service-runner.mjs

@@ -1,6 +1,32 @@
+/**
+ * Minimal single-service bootstrap helper for scripts and one-off operations.
+ *
+ * @remarks
+ * `ServiceRunner` creates a complete DI graph for a single service, handling
+ * all wiring, lifecycle, and teardown. It is useful for scripts that need
+ * access to the full framework without building an application. The service
+ * function receives the same `TServiceParams` as a normal service, allowing
+ * access to config, logger, scheduler, and other boilerplate.
+ */
 import { CreateApplication } from "../index.mjs";
 /**
- * Type safe way to kick off a mini service / script
+ * Bootstrap and run a single typed service with full framework support.
+ *
+ * @remarks
+ * Creates an application with a single service, invokes its bootstrap lifecycle,
+ * and returns when the service completes. The service runs synchronously within
+ * the context of a fully-initialized DI graph, with access to all boilerplate
+ * services (logger, scheduler, lifecycle, config, etc.).
+ *
+ * @example
+ * ```typescript
+ * await ServiceRunner(
+ *   { configuration: { myLib: {...} } },
+ *   ({ logger, config }) => {
+ *     logger.info("running with config:", config.myLib);
+ *   }
+ * );
+ * ```
  */
 export async function ServiceRunner({ bootstrap, ...config }, service) {
     await CreateApplication({

package/dist/helpers/service-runner.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"service-runner.mjs","sourceRoot":"","sources":["../../src/helpers/service-runner.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAwBjD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAIjC,EAAE,SAAS,EAAE,GAAG,MAAM,EAA0E,EAChG,OAAsE;IAEtE,MAAM,iBAAiB,CAAC;QACtB,0DAA0D;QAC1D,IAAI,EAAE,SAAS;QACf,oCAAoC;QACpC,GAAG,MAAM;QACT,QAAQ,EAAE;YACR,OAAO,EAAE,OAA0B;SACpC;KACF,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"service-runner.mjs","sourceRoot":"","sources":["../../src/helpers/service-runner.mts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAwBjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAIjC,EAAE,SAAS,EAAE,GAAG,MAAM,EAA0E,EAChG,OAAsE;IAEtE,MAAM,iBAAiB,CAAC;QACtB,0DAA0D;QAC1D,IAAI,EAAE,SAAS;QACf,oCAAoC;QACpC,GAAG,MAAM;QACT,QAAQ,EAAE;YACR,OAAO,EAAE,OAA0B;SACpC;KACF,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;AAC1B,CAAC"}