@digital-alchemy/core 26.1.9 → 26.5.1

package/dist/services/is.service.mjs.map

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

package/dist/services/lifecycle.service.d.mts

@@ -1,5 +1,31 @@
 import type { LifecycleStages, TLifecycleBase } from "../index.mts";
+/**
+ * Lifecycle event registry for per-bootstrap stage callbacks.
+ *
+ * @remarks
+ * Creates and owns a Map of lifecycle stage names to callback lists. Exposes
+ * seven hook attachment methods (`onPreInit`, `onPostConfig`, etc.) that queue
+ * callbacks for later execution. The returned `exec()` method is called by the
+ * wiring engine at each stage to fire callbacks in strict order: positive
+ * priorities (high to low), unprioritized (any order), negative priorities
+ * (high to low). Each stage is fired only once; subsequent attaches on a stage
+ * that has already executed fire the callback immediately.
+ */
 export declare function CreateLifecycle(): {
+    /**
+     * Event hook registry for all seven lifecycle stages.
+     */
     events: TLifecycleBase;
+    /**
+     * Execute all callbacks for a named lifecycle stage in strict order.
+     *
+     * @remarks
+     * Splits callbacks by priority: positive (high to low), unprioritized (any
+     * order), negative (high to low). Runs positive and negative series in order,
+     * unprioritized in parallel. Removes the stage from the map after execution
+     * so that late-attaching callbacks to an executed stage fire immediately.
+     *
+     * @returns Execution duration in milliseconds.
+     */
     exec(stage: LifecycleStages): Promise<string>;
 };

package/dist/services/lifecycle.service.mjs

@@ -2,28 +2,91 @@ import { DOWN, each, eachSeries, LIFECYCLE_STAGES, UP } from "../index.mjs";
 import { is } from "./is.service.mjs";
 const PRE_CALLBACKS_START = 0;
 const DECIMALS = 2;
+/**
+ * Lifecycle event registry for per-bootstrap stage callbacks.
+ *
+ * @remarks
+ * Creates and owns a Map of lifecycle stage names to callback lists. Exposes
+ * seven hook attachment methods (`onPreInit`, `onPostConfig`, etc.) that queue
+ * callbacks for later execution. The returned `exec()` method is called by the
+ * wiring engine at each stage to fire callbacks in strict order: positive
+ * priorities (high to low), unprioritized (any order), negative priorities
+ * (high to low). Each stage is fired only once; subsequent attaches on a stage
+ * that has already executed fire the callback immediately.
+ */
 export function CreateLifecycle() {
     const events = new Map(LIFECYCLE_STAGES.map((event) => [event, []]));
+    /**
+     * Attach a callback to a named lifecycle stage with optional priority.
+     *
+     * @remarks
+     * If the stage has not yet been stored in the map (already executed), the
+     * callback fires immediately unless it is a Shutdown stage (which are never
+     * re-fired after they have been executed).
+     */
     function attachEvent(callback, name, priority) {
         const stageList = events.get(name);
+        // stage already executed (not in the map) — fire immediately unless Shutdown
         if (!is.array(stageList)) {
             if (!name.includes("Shutdown")) {
                 callback();
             }
             return;
         }
+        // stage is still pending; queue the callback with its priority
         stageList.push({ callback, priority });
     }
     return {
+        /**
+         * Event hook registry for all seven lifecycle stages.
+         */
         events: {
+            /**
+             * Pre-initialization hook; safe for initial state setup.
+             *
+             * @remarks
+             * Config is not yet loaded; do not read `config.*` at this stage.
+             */
             onBootstrap: (callback, priority) => attachEvent(callback, "Bootstrap", priority),
+            /**
+             * Post-config hook; all configuration is now available.
+             */
             onPostConfig: (callback, priority) => attachEvent(callback, "PostConfig", priority),
+            /**
+             * Pre-initialization hook; config and modules are loaded.
+             */
             onPreInit: (callback, priority) => attachEvent(callback, "PreInit", priority),
+            /**
+             * Pre-shutdown hook; graceful shutdown is beginning.
+             */
             onPreShutdown: (callback, priority) => attachEvent(callback, "PreShutdown", priority),
+            /**
+             * Ready hook; all services are wired and the app is fully running.
+             *
+             * @remarks
+             * This is the stage where schedulers, servers, and long-running tasks begin.
+             */
             onReady: (callback, priority) => attachEvent(callback, "Ready", priority),
+            /**
+             * Shutdown-complete hook; cleanup is done.
+             */
             onShutdownComplete: (callback, priority) => attachEvent(callback, "ShutdownComplete", priority),
+            /**
+             * Shutdown-start hook; active connections are closing.
+             */
             onShutdownStart: (callback, priority) => attachEvent(callback, "ShutdownStart", priority),
         },
+        /**
+         * Execute all callbacks for a named lifecycle stage in strict order.
+         *
+         * @remarks
+         * Splits callbacks by priority: positive (high to low), unprioritized (any
+         * order), negative (high to low). Runs positive and negative series in order,
+         * unprioritized in parallel. Removes the stage from the map after execution
+         * so that late-attaching callbacks to an executed stage fire immediately.
+         *
+         * @returns Execution duration in milliseconds.
+         */
         async exec(stage) {
             const start = performance.now();
             const list = events.get(stage);
@@ -33,7 +96,7 @@ export function CreateLifecycle() {
                 const quick = list.filter(({ priority }) => priority === undefined);
                 const positive = [];
                 const negative = [];
-                // console.error("HIT 1");
+                // segregate sorted callbacks into positive and negative priority buckets
                 sorted.forEach(i => {
                     if (i.priority >= PRE_CALLBACKS_START) {
                         positive.push(i);
@@ -41,16 +104,11 @@ export function CreateLifecycle() {
                     }
                     negative.push(i);
                 });
-                // * callbacks with a priority greater than 0
-                // high to low (1000 => 0)
+                // execute positive priorities in descending order (high to low)
                 await eachSeries(positive.toSorted((a, b) => (a.priority < b.priority ? UP : DOWN)), async ({ callback }) => await callback());
-                // console.error("HIT 2");
-                // * callbacks without a priority
-                // any order
+                // execute unprioritized callbacks in parallel
                 await each(quick, async ({ callback }) => await callback());
-                // console.error("HIT 3");
-                // * callbacks with a priority less than 0
-                // high to low (-1 => -1000)
+                // execute negative priorities in descending order (-1 to -1000)
                 await eachSeries(negative.toSorted((a, b) => (a.priority < b.priority ? UP : DOWN)), async ({ callback }) => await callback());
             }
             return `${(performance.now() - start).toFixed(DECIMALS)}ms`;

package/dist/services/lifecycle.service.mjs.map

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

package/dist/services/logger.service.d.mts

@@ -1,2 +1,29 @@
 import type { DigitalAlchemyLogger, TServiceParams } from "../index.mts";
+/**
+ * Logger factory — chalk/stdout formatter, ALS integration, level filtering,
+ * multi-target fan-out, and the `context(ctx)` builder.
+ *
+ * @remarks
+ * Owns the module-level `logger` record that maps each log level to a
+ * formatting+routing function. That record is replaced wholesale when a
+ * `customLogger` is provided via bootstrap options.
+ *
+ * The `context(ctx)` method returns a `GetLogger` scoped to a specific
+ * `TContext` string. Each scoped logger evaluates `shouldILog[level]` on every
+ * call so level changes propagated via `EVENT_UPDATE_LOG_LEVELS` take effect
+ * immediately without any per-call config lookup.
+ *
+ * **Pretty format** applies chalk colorization and bracket/brace highlighting
+ * to messages up to `MAX_CUTOFF` characters. Turn it off (e.g. for Docker
+ * log aggregators) via `loggerOptions.pretty = false` in bootstrap options.
+ *
+ * **ALS integration** (`loggerOptions.als = true`) merges per-request data
+ * stored in `AsyncLocalStorage` into every log payload, and can substitute a
+ * thread-local child logger for the default stdout writer.
+ *
+ * **Extra targets** (`addTarget`) accept either a `LogStreamTarget` function
+ * (raw msg + payload) or any object that conforms to `GetLogger` (same level
+ * methods as the default logger). All registered targets receive every log
+ * regardless of the `stdOut` setting.
+ */
 export declare function Logger({ lifecycle, config, event, internal, als, }: TServiceParams): Promise<DigitalAlchemyLogger>;

package/dist/services/logger.service.mjs

@@ -20,6 +20,33 @@ const frontDash = " - ";
 const SYMBOL_START = 1;
 const SYMBOL_END = -1;
 const LEVEL_MAX = 7;
+/**
+ * Logger factory — chalk/stdout formatter, ALS integration, level filtering,
+ * multi-target fan-out, and the `context(ctx)` builder.
+ *
+ * @remarks
+ * Owns the module-level `logger` record that maps each log level to a
+ * formatting+routing function. That record is replaced wholesale when a
+ * `customLogger` is provided via bootstrap options.
+ *
+ * The `context(ctx)` method returns a `GetLogger` scoped to a specific
+ * `TContext` string. Each scoped logger evaluates `shouldILog[level]` on every
+ * call so level changes propagated via `EVENT_UPDATE_LOG_LEVELS` take effect
+ * immediately without any per-call config lookup.
+ *
+ * **Pretty format** applies chalk colorization and bracket/brace highlighting
+ * to messages up to `MAX_CUTOFF` characters. Turn it off (e.g. for Docker
+ * log aggregators) via `loggerOptions.pretty = false` in bootstrap options.
+ *
+ * **ALS integration** (`loggerOptions.als = true`) merges per-request data
+ * stored in `AsyncLocalStorage` into every log payload, and can substitute a
+ * thread-local child logger for the default stdout writer.
+ *
+ * **Extra targets** (`addTarget`) accept either a `LogStreamTarget` function
+ * (raw msg + payload) or any object that conforms to `GetLogger` (same level
+ * methods as the default logger). All registered targets receive every log
+ * regardless of the `stdOut` setting.
+ */
 export async function Logger({ lifecycle, config, event, internal, als, }) {
     const { is } = internal.utils;
     let lastMessage = performance.now();
@@ -33,10 +60,18 @@ export async function Logger({ lifecycle, config, event, internal, als, }) {
     const YELLOW_DASH = chalk.yellowBright(frontDash);
     const BLUE_TICK = chalk.blue(`>`);
     let prettyFormat = is.boolean(loggerOptions.pretty) ? loggerOptions.pretty : true;
-    // make sure the object formatter respects the pretty option
-    // if this is enabled while outputting to docker logs, the output becomes much harder to read
+    // keep inspect colorization in sync with the pretty flag so object dumps
+    // look consistent whether output goes to a TTY or a log aggregator
     inspect.defaultOptions.colors = prettyFormat;
     // #MARK: mergeData
+    /**
+     * Augment a log data object with counter, ALS fields, and `mergeData` overrides.
+     *
+     * @remarks
+     * When `loggerOptions.als` is enabled, reads the current ALS store and merges
+     * it into the payload. Also pulls the optional thread-local child logger that
+     * ALS callers can inject to redirect a specific request's logs somewhere else.
+     */
     function mergeData(data) {
         let out = { ...data, ...loggerOptions.mergeData };
         if (loggerOptions.counter) {
@@ -56,10 +91,26 @@ export async function Logger({ lifecycle, config, event, internal, als, }) {
         return [out, logger];
     }
     // #MARK: prettyFormatMessage
+    /**
+     * Apply chalk syntax highlighting to a log message string.
+     *
+     * @remarks
+     * Only runs when `prettyFormat` is true and the message is under
+     * `MAX_CUTOFF` characters — very long strings are passed through verbatim
+     * to avoid performance degradation from heavy regex over large payloads.
+     *
+     * Highlighting rules:
+     * - `word#word` → yellow (symbol-style identifiers)
+     * - `[A] > [B]` → blue `>` separators
+     * - `[Text]` → bold magenta, brackets stripped
+     * - `{Text}` → bold gray, braces stripped
+     * - Leading ` - ` dash prefix → yellow dash
+     */
     function prettyFormatMessage(message) {
         if (!message) {
             return ``;
         }
+        // skip expensive regex on very long messages or when pretty is disabled
         if (!prettyFormat || message.length > MAX_CUTOFF) {
             return message;
         }
@@ -79,13 +130,16 @@ export async function Logger({ lifecycle, config, event, internal, als, }) {
     }
     if (is.empty(internal.boot.options?.customLogger)) {
         // #MARK: formatter
+        // build a per-level formatter function and store it in the module-level logger record;
+        // each function closes over the shared prettyFormat/extraTargets state so runtime
+        // changes (setPrettyFormat, addTarget) take effect on the next log call
         [...METHOD_COLORS.keys()].forEach(key => {
             logger[key] = (context, ...parameters) => {
                 const [data, child] = mergeData(is.object(parameters[FIRST])
                     ? parameters.shift()
                     : {});
-                // common for functions to be thrown in
-                // extract it's declared name and discard the rest of the info
+                // functions are commonly passed as the `name` field to tag the call-site;
+                // extract the declared `.name` string and discard the function reference
                 data.name = is.object(data.name) || is.function(data.name) ? data.name.name : data.name;
                 // ? full data object representing this log
                 // used with cloud logging (graylog, datadog, etc)
@@ -115,7 +169,8 @@ export async function Logger({ lifecycle, config, event, internal, als, }) {
                     lastMessage = now;
                     rawData.ms = ms;
                 }
-                // emit logs to external targets
+                // emit logs to external targets before the stdOut guard so targets always
+                // receive every message regardless of whether stdout is suppressed
                 extraTargets.forEach(target => {
                     // stream targets, just take all messages and do the exact same thing with them
                     // ex: send to http endpoint
@@ -148,6 +203,7 @@ export async function Logger({ lifecycle, config, event, internal, als, }) {
                     name, 
                     // eslint-disable-next-line sonarjs/no-unused-vars, @typescript-eslint/no-unused-vars
                     context: ctx, ...extra } = data;
+                    // only inspect extra fields that aren't already rendered in the message line
                     if (!is.empty(extra)) {
                         message +=
                             "\n" +
@@ -162,11 +218,14 @@ export async function Logger({ lifecycle, config, event, internal, als, }) {
                                     .join("\n");
                     }
                 }
+                // ALS child logger takes precedence so per-request log redirection works
                 if (child) {
                     child[key](message);
                     return;
                 }
                 // #MARK: globalThis.console
+                // route through the appropriate console method so browser devtools and
+                // Node's built-in log level filtering see the right severity
                 switch (key) {
                     case "warn": {
                         globalThis.console.warn(message);
@@ -192,15 +251,28 @@ export async function Logger({ lifecycle, config, event, internal, als, }) {
         });
     }
     else {
+        // custom logger provided at bootstrap — use it verbatim instead of the built-in formatter
         logger = internal.boot.options.customLogger;
     }
-    // if bootstrap hard coded something specific, then start there
-    // otherwise, be noisy until config loads a user preference
+    // if bootstrap hard coded something specific, then start there;
+    // otherwise be noisy until config loads a user preference
     //
-    // stored as separate variable to cut down on internal config lookups
+    // stored as a separate variable to avoid per-call config proxy lookups
     let CURRENT_LOG_LEVEL = internal.utils.object.get(internal, "boot.options.configuration.boilerplate.LOG_LEVEL") ||
         "trace";
     // #MARK: context
+    /**
+     * Create a `GetLogger` scoped to a specific `TContext` string.
+     *
+     * @remarks
+     * Each returned logger checks `shouldILog[level]` before forwarding the
+     * call, making the check a simple boolean property access on every log line.
+     * `shouldILog` is rebuilt whenever `EVENT_UPDATE_LOG_LEVELS` fires, so
+     * level overrides and global level changes propagate to all existing scoped
+     * loggers automatically.
+     *
+     * Level resolution order: per-service override → module-level override → global level.
+     */
     function context(context) {
         const name = context;
         const shouldILog = {};
@@ -209,7 +281,7 @@ export async function Logger({ lifecycle, config, event, internal, als, }) {
             LOG_LEVELS.forEach((key) => {
                 // global level
                 let target = LOG_LEVEL_PRIORITY[CURRENT_LOG_LEVEL];
-                // override directly
+                // per-service override takes priority over module-level override
                 if (loggerOptions?.levelOverrides?.[name]) {
                     target = LOG_LEVEL_PRIORITY[loggerOptions?.levelOverrides?.[name]];
                     // module level override
@@ -232,6 +304,15 @@ export async function Logger({ lifecycle, config, event, internal, als, }) {
         };
     }
     // #MARK updateShouldLog:
+    /**
+     * Sync `CURRENT_LOG_LEVEL` from config and broadcast a level-update event.
+     *
+     * @remarks
+     * Called after `onPostConfig` (when the user's `LOG_LEVEL` preference is
+     * available) and on every subsequent `boilerplate.LOG_LEVEL` config change.
+     * Emitting `EVENT_UPDATE_LOG_LEVELS` causes every scoped logger's `shouldILog`
+     * map to be rebuilt synchronously so level changes take effect immediately.
+     */
     function updateShouldLog() {
         if (!is.empty(config.boilerplate.LOG_LEVEL)) {
             CURRENT_LOG_LEVEL = config.boilerplate.LOG_LEVEL;
@@ -239,25 +320,68 @@ export async function Logger({ lifecycle, config, event, internal, als, }) {
         event.emit(EVENT_UPDATE_LOG_LEVELS);
     }
     // #MARK: lifecycle
+    // only read config after PostConfig fires; value is undefined before that
     lifecycle.onPostConfig(() => internal.boilerplate.logger.updateShouldLog());
+    // also update whenever LOG_LEVEL is changed at runtime (e.g. via setConfig)
     internal.boilerplate.configuration.onUpdate(() => internal.boilerplate.logger.updateShouldLog(), "boilerplate", "LOG_LEVEL");
+    /**
+     * Register an additional log destination.
+     *
+     * @remarks
+     * Accepts either a `LogStreamTarget` function `(msg, rawData) => void`
+     * or any object that implements the `GetLogger` interface. All registered
+     * targets receive every log message before the `stdOut` guard, so targets
+     * see logs even when `stdOut` is disabled.
+     */
     function addTarget(target) {
         extraTargets.add(target);
     }
     // #MARK: return object
     return {
+        /**
+         * Register an additional log destination (function or `GetLogger` object).
+         */
         addTarget,
+        /**
+         * Create a `GetLogger` scoped to the given context string.
+         */
         context,
+        /**
+         * Access the raw per-level formatter record.
+         * @internal
+         */
         getBaseLogger: () => logger,
+        /**
+         * Return the current pretty-format flag.
+         */
         getPrettyFormat: () => prettyFormat,
+        /**
+         * Apply chalk syntax highlighting to a message string (respects `prettyFormat` flag).
+         */
         prettyFormatMessage,
+        /**
+         * Replace the underlying per-level formatter record.
+         * @internal
+         */
         setBaseLogger: base => (logger = base),
+        /**
+         * Toggle chalk colorization on stdout output.
+         *
+         * @remarks
+         * Also updates `inspect.defaultOptions.colors` so object dumps remain consistent.
+         */
         setPrettyFormat: state => {
             prettyFormat = state;
             inspect.defaultOptions.colors = prettyFormat;
             return prettyFormat;
         },
+        /**
+         * Pre-built scoped logger for the framework's own internal log lines.
+         */
         systemLogger: context("digital-alchemy:system-logger"),
+        /**
+         * Sync the active log level from config and notify all scoped loggers.
+         */
         updateShouldLog,
     };
 }

package/dist/services/logger.service.mjs.map

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

package/dist/services/scheduler.service.d.mts

@@ -1,2 +1,21 @@
 import type { SchedulerBuilder, TServiceParams } from "../index.mts";
+/**
+ * Builder-style scheduler factory injected into every service via `TServiceParams`.
+ *
+ * @remarks
+ * Returns a function that accepts a `TContext` and produces the per-caller scheduler
+ * API (`cron`, `interval`, `sliding`, `setTimeout`, `setInterval`, `sleep`).
+ * This two-level shape is deliberate: the outer factory sets up lifecycle hooks
+ * shared across all callers; the inner function binds the per-caller context so
+ * every scheduled callback is associated with the service that created it.
+ *
+ * All schedules are registered against a shared `stop` set so a single
+ * `onPreShutdown` hook can cleanly cancel every outstanding timer in one pass.
+ * Schedules only start firing after the `onReady` lifecycle event; creating a
+ * scheduler before `onReady` is safe — the job is registered but does not run
+ * until the application is ready.
+ *
+ * Remove callbacks returned from each method are dual-arity:
+ * call them directly (`remove()`) or destructure `{ remove }` — both work.
+ */
 export declare function Scheduler({ logger, lifecycle, internal }: TServiceParams): SchedulerBuilder;