@digital-alchemy/core 24.8.4 → 24.9.4

package/dist/services/wiring.extension.js

@@ -0,0 +1,437 @@
+/* eslint-disable unicorn/no-process-exit */
+import { EventEmitter } from "events";
+import { ACTIVE_SLEEPS, BootstrapException, buildSortOrder, COERCE_CONTEXT, CreateLibrary, each, eachSeries, NONE, SINGLE, WIRE_PROJECT, wireOrder, WIRING_CONTEXT, } from "../helpers";
+import { ALS, InternalDefinition, is } from ".";
+import { Configuration, INITIALIZE, INJECTED_DEFINITIONS, LOAD_PROJECT, } from "./configuration.extension";
+import { CreateLifecycle } from "./lifecycle.extension";
+import { Logger } from "./logger.extension";
+import { Scheduler } from "./scheduler.extension";
+// #MARK: CreateBoilerplate
+function createBoilerplate() {
+    // ! DO NOT MOVE TO ANOTHER FILE !
+    // While it SEEMS LIKE this can be safely moved, it causes code init race conditions.
+    return CreateLibrary({
+        configuration: {
+            ALS_ENABLED: {
+                type: "string",
+            },
+            /**
+             * Only usable by **cli switch**.
+             * Pass path to a config file for loader
+             *
+             * ```bash
+             * node dist/app.js --config ~/.config/my_app.ini
+             * ```
+             */
+            CONFIG: {
+                description: [
+                    "Consumable as CLI switch only",
+                    "If provided, all other file based configurations will be ignored",
+                    "Environment variables + CLI switches will operate normally",
+                ].join(". "),
+                type: "string",
+            },
+            /**
+             * > by default true when:
+             *
+             * ```typescript
+             * NODE_ENV === "test*"
+             * ```
+             *
+             * ---
+             *
+             * When set
+             */
+            IS_TEST: {
+                // test | testing
+                default: process.env.NODE_ENV?.startsWith("test"),
+                description: "Quick reference for if this app is currently running with test mode",
+                type: "boolean",
+            },
+            /**
+             * ### `trace`
+             *
+             * Very noisy, contains extra details about what's going on in the internals.
+             *
+             * ### `debug`
+             *
+             * Additional diagnostic information about operations being form. `"did a thing w/ {name}"` is common.
+             *
+             * ### `info`
+             *
+             * Notifications for high level events, and app code.
+             *
+             * ### `warn`
+             *
+             * Notification that an non-critical issue happened.
+             *
+             * ### `error`
+             *
+             * Error logs are produced from unexpected situations.
+             *
+             * When an external API sends back an error messages, or tools are being used in a detectably wrong way.
+             *
+             * ### `fatal`
+             *
+             * Produce a log at the highest importance level, not common
+             *
+             * ### `silent`
+             *
+             * Emit no logs at all
+             */
+            LOG_LEVEL: {
+                default: "trace",
+                description: "Minimum log level to process",
+                enum: ["silent", "trace", "info", "warn", "debug", "error", "fatal"],
+                type: "string",
+            },
+            /**
+             * Reference to `process.env.NODE_ENV` by default, `"local"` if not provided
+             */
+            NODE_ENV: {
+                default: process.env.NODE_ENV || "local",
+                type: "string",
+            },
+        },
+        name: "boilerplate",
+        priorityInit: ["als", "configuration", "logger", "scheduler"],
+        services: {
+            /**
+             * [AsyncLocalStorage](https://nodejs.org/api/async_context.html) hooks
+             *
+             * Use to pass data around bypassing business logic and insert data into logs
+             */
+            als: ALS,
+            /**
+             * @internal
+             *
+             * Exposed via `internal.boilerplate.configuration`
+             *
+             * Used to directly modify application configuration
+             */
+            configuration: Configuration,
+            /**
+             * @internal
+             *
+             * Exposed via `internal.boilerplate.logger`
+             *
+             * Used to modify the way the logger works at runtime
+             */
+            logger: Logger,
+            /**
+             * @internal
+             *
+             * Used to generate the scheduler that will get injected into other services
+             */
+            scheduler: Scheduler,
+        },
+    });
+}
+// (re)defined at bootstrap
+// unclear if this variable even serves a purpose beyond types
+export let LIB_BOILERPLATE;
+const RUNNING_APPLICATIONS = new Map();
+// #MARK: QuickShutdown
+async function quickShutdown(reason) {
+    await each([...RUNNING_APPLICATIONS.values()], async (application) => {
+        application.logger.warn({ reason }, `starting shutdown`);
+        await application.teardown();
+    });
+}
+// #MARK: processEvents
+const processEvents = new Map([
+    [
+        "SIGTERM",
+        async () => {
+            await quickShutdown("SIGTERM");
+            process.exit();
+        },
+    ],
+    [
+        "SIGINT",
+        async () => {
+            await quickShutdown("SIGINT");
+            process.exit();
+        },
+    ],
+    // ["uncaughtException", () => {}],
+    // ["unhandledRejection", (reason, promise) => {}],
+]);
+const DECIMALS = 2;
+const BOILERPLATE = (internal) => internal.boot.loadedModules.get("boilerplate");
+// #MARK: CreateApplication
+export function CreateApplication({ name, services = {}, configurationLoaders, libraries = [], configuration = {}, priorityInit = [], }) {
+    let internal;
+    if (!is.empty(priorityInit)) {
+        priorityInit.forEach(name => {
+            if (!is.function(services[name])) {
+                throw new BootstrapException(WIRING_CONTEXT, "MISSING_PRIORITY_SERVICE", `${name} was listed as priority init, but was not found in services`);
+            }
+        });
+    }
+    const serviceApis = {};
+    const application = {
+        [WIRE_PROJECT]: async (internal) => {
+            BOILERPLATE(internal)?.configuration?.[LOAD_PROJECT](name, configuration);
+            await eachSeries(wireOrder(priorityInit, Object.keys(services)), async (service) => {
+                serviceApis[service] = await wireService(name, service, services[service], internal.boot.lifecycle.events, internal);
+            });
+            const append = internal.boot.options?.appendService;
+            if (!is.empty(append)) {
+                await eachSeries(Object.keys(append), async (service) => {
+                    await wireService(name, service, append[service], internal.boot.lifecycle.events, internal);
+                });
+            }
+            internal.boot.constructComplete.add(name);
+        },
+        booted: false,
+        bootstrap: async (options) => {
+            if (application.booted) {
+                throw new BootstrapException(WIRING_CONTEXT, "DOUBLE_BOOT", "Application is already booted! Cannot bootstrap again");
+            }
+            internal = new InternalDefinition();
+            await bootstrap(application, options, internal);
+            application.booted = true;
+            RUNNING_APPLICATIONS.set(name, application);
+        },
+        configuration,
+        configurationLoaders,
+        libraries,
+        logger: undefined,
+        name,
+        priorityInit,
+        serviceApis,
+        services,
+        async teardown() {
+            if (!application.booted) {
+                processEvents.forEach((callback, event) => process.removeListener(event, callback));
+                return;
+            }
+            await teardown(internal, application.logger);
+            internal?.utils?.event?.removeAllListeners?.();
+            application.booted = false;
+            internal = undefined;
+        },
+        type: "application",
+    };
+    return application;
+}
+// #MARK: WireService
+async function wireService(project, service, definition, lifecycle, internal) {
+    const mappings = internal.boot.moduleMappings.get(project) ?? {};
+    mappings[service] = definition;
+    internal.boot.moduleMappings.set(project, mappings);
+    const context = COERCE_CONTEXT(`${project}:${service}`);
+    // logger gets defined first, so this really is only for the start of the start of bootstrapping
+    const boilerplate = BOILERPLATE(internal);
+    const logger = boilerplate?.logger?.context(context);
+    const loaded = internal.boot.loadedModules.get(project) ?? {};
+    internal.boot.loadedModules.set(project, loaded);
+    try {
+        logger?.trace({ name: wireService }, `initializing`);
+        const inject = Object.fromEntries([...internal.boot.loadedModules.keys()].map(project => [
+            project,
+            internal.boot.loadedModules.get(project),
+        ]));
+        loaded[service] = (await definition({
+            ...inject,
+            als: boilerplate.als,
+            config: boilerplate?.configuration?.[INJECTED_DEFINITIONS](),
+            context,
+            event: internal?.utils?.event,
+            internal,
+            lifecycle,
+            logger,
+            scheduler: boilerplate?.scheduler?.(context),
+        }));
+        return loaded[service];
+    }
+    catch (error) {
+        // Init errors at this level are considered blocking / fatal
+        // eslint-disable-next-line no-console
+        console.error("initialization error", error);
+        process.exit();
+    }
+}
+const runPreInit = async (internal) => {
+    const duration = await internal.boot.lifecycle.exec("PreInit");
+    internal.boot.completedLifecycleEvents.add("PreInit");
+    return duration;
+};
+const runPostConfig = async (internal) => {
+    const duration = await internal.boot.lifecycle.exec("PostConfig");
+    internal.boot.completedLifecycleEvents.add("PostConfig");
+    return duration;
+};
+const runBootstrap = async (internal) => {
+    const duration = await internal.boot.lifecycle.exec("Bootstrap");
+    internal.boot.completedLifecycleEvents.add("Bootstrap");
+    return duration;
+};
+const runReady = async (internal) => {
+    const duration = await internal.boot.lifecycle.exec("Ready");
+    internal.boot.completedLifecycleEvents.add("Ready");
+    return duration;
+};
+// #MARK: Bootstrap
+async function bootstrap(application, options, internal) {
+    const initTime = performance.now();
+    internal.boot = {
+        application,
+        completedLifecycleEvents: new Set(),
+        constructComplete: new Set(),
+        lifecycle: CreateLifecycle(),
+        loadedModules: new Map(),
+        moduleMappings: new Map(),
+        options,
+        phase: "bootstrap",
+        startup: new Date(),
+    };
+    process.title = application.name;
+    try {
+        const STATS = {};
+        const CONSTRUCT = {};
+        // pre-create loaded module for boilerplate, so it can be attached to `internal`
+        // this allows it to be used as part of `internal` during boilerplate construction
+        // otherwise it'd only be there for everyone else
+        const api = {};
+        internal.boilerplate = api;
+        internal.boot.loadedModules.set("boilerplate", api);
+        STATS.Construct = CONSTRUCT;
+        // * Recreate base eventemitter
+        internal.utils.event = new EventEmitter();
+        internal.utils.event.setMaxListeners(NONE);
+        // ? Some libraries need to be aware of
+        // * Generate a new boilerplate module
+        LIB_BOILERPLATE = createBoilerplate();
+        // * Wire it
+        let start = performance.now();
+        await LIB_BOILERPLATE[WIRE_PROJECT](internal, wireService);
+        CONSTRUCT.boilerplate = `${(performance.now() - start).toFixed(DECIMALS)}ms`;
+        // ~ configuration
+        api.configuration?.[LOAD_PROJECT](LIB_BOILERPLATE.name, LIB_BOILERPLATE.configuration);
+        const logger = api.logger.context(WIRING_CONTEXT);
+        application.logger = logger;
+        logger.info({ name: bootstrap }, `[boilerplate] wiring complete`);
+        // * Wire in various shutdown events
+        processEvents.forEach((callback, event) => {
+            process.on(event, callback);
+            logger.trace({ event, name: bootstrap }, "register shutdown event");
+        });
+        // * Add in libraries
+        application.libraries ??= [];
+        if (!is.undefined(options?.appendLibrary)) {
+            const list = is.array(options.appendLibrary)
+                ? options.appendLibrary
+                : [options.appendLibrary];
+            list.forEach(append => {
+                application.libraries.some((library, index) => {
+                    if (append.name === library.name) {
+                        // remove existing
+                        logger.warn({ name: append.name }, `replacing library`);
+                        application.libraries.splice(index, SINGLE);
+                        return true;
+                    }
+                    return false;
+                });
+                logger.info({ name: append.name }, `appending library`);
+                // append
+                application.libraries.push(append);
+            });
+        }
+        const order = buildSortOrder(application, logger);
+        await eachSeries(order, async (i) => {
+            start = performance.now();
+            logger.info({ name: bootstrap }, `[%s] init project`, i.name);
+            await i[WIRE_PROJECT](internal, wireService);
+            CONSTRUCT[i.name] = `${(performance.now() - start).toFixed(DECIMALS)}ms`;
+        });
+        logger.trace({ name: bootstrap }, `library wiring complete`);
+        // * Finally the application
+        if (options?.bootLibrariesFirst) {
+            logger.warn({ name: bootstrap }, `bootLibrariesFirst`);
+        }
+        else {
+            logger.info({ name: bootstrap }, `init application`);
+            start = performance.now();
+            await application[WIRE_PROJECT](internal, wireService);
+            CONSTRUCT[application.name] = `${(performance.now() - start).toFixed(DECIMALS)}ms`;
+        }
+        // ? Configuration values provided bootstrap take priority over module level
+        if (!is.empty(options?.configuration)) {
+            api.configuration.merge(options?.configuration);
+        }
+        // - Kick off lifecycle
+        logger.debug({ name: bootstrap }, `[PreInit] running lifecycle callbacks`);
+        STATS.PreInit = await runPreInit(internal);
+        // - Pull in user configurations
+        logger.debug({ name: bootstrap }, "loading configuration");
+        const config = BOILERPLATE(internal)?.configuration;
+        STATS.Configure = await config?.[INITIALIZE](application);
+        // - Run through other events in order
+        logger.debug({ name: bootstrap }, `[PostConfig] running lifecycle callbacks`);
+        STATS.PostConfig = await runPostConfig(internal);
+        logger.debug({ name: bootstrap }, `[Bootstrap] running lifecycle callbacks`);
+        STATS.Bootstrap = await runBootstrap(internal);
+        if (options?.bootLibrariesFirst) {
+            // * mental note
+            // running between bootstrap & ready seems most appropriate
+            // resources are expected to *technically* be ready at this point, but not finalized
+            // reference examples:
+            // - hass: socket is open & resources are ready
+            // - fastify: bindings are available but port isn't listening
+            logger.info({ name: bootstrap }, `late init application`);
+            start = performance.now();
+            await application[WIRE_PROJECT](internal, wireService);
+            CONSTRUCT[application.name] = `${(performance.now() - start).toFixed(DECIMALS)}ms`;
+        }
+        logger.debug({ name: bootstrap }, `[Ready] running lifecycle callbacks`);
+        STATS.Ready = await runReady(internal);
+        STATS.Total = `${(performance.now() - initTime).toFixed(DECIMALS)}ms`;
+        // * App is ready!
+        logger.info(options?.showExtraBootStats
+            ? { ...STATS, name: bootstrap }
+            : { Total: STATS.Total, name: bootstrap }, `[%s] application bootstrapped`, application.name);
+        internal.boot.phase = "running";
+    }
+    catch (error) {
+        if (options?.configuration?.boilerplate?.LOG_LEVEL !== "silent") {
+            // eslint-disable-next-line no-console
+            console.error("bootstrap failed", error);
+        }
+        process.exit();
+    }
+}
+// #MARK: Teardown
+async function teardown(internal, logger) {
+    // * Announce
+    logger.warn({ name: teardown }, `received teardown request`);
+    internal.boot.phase = "teardown";
+    try {
+        // * PreShutdown
+        logger.debug({ name: teardown }, `[PreShutdown] running lifecycle callbacks`);
+        await internal.boot.lifecycle.exec("PreShutdown");
+        internal.boot.completedLifecycleEvents.add("PreShutdown");
+        // * Formally shutting down
+        logger.info({ name: teardown }, `tearing down application`);
+        logger.debug({ name: teardown }, `[ShutdownStart] running lifecycle callbacks`);
+        await internal.boot.lifecycle.exec("ShutdownStart");
+        internal.boot.completedLifecycleEvents.add("ShutdownStart");
+        // - clean up active `sleep` calls (can keep tests open and stuff)
+        ACTIVE_SLEEPS.forEach(i => i.kill("stop"));
+        logger.debug({ name: teardown }, `[ShutdownComplete] running lifecycle callbacks`);
+        await internal.boot.lifecycle.exec("ShutdownComplete");
+        internal.boot.completedLifecycleEvents.add("ShutdownComplete");
+    }
+    catch (error) {
+        // ! oof
+        global.console.error({ error }, "error occurred during teardown, some lifecycle events may be incomplete");
+    }
+    // * Final resource cleanup, attempt to reset everything possible
+    logger.info({
+        name: teardown,
+        started_at: internal.utils.relativeDate(internal.boot.startup),
+    }, `application terminated`);
+    processEvents.forEach((callback, event) => process.removeListener(event, callback));
+}
+//# sourceMappingURL=wiring.extension.js.map

package/dist/services/wiring.extension.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./mock-logger";
+export * from "./test-module";

package/dist/testing/index.js

@@ -0,0 +1,3 @@
+export * from "./mock-logger";
+export * from "./test-module";
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/testing/mock-logger.d.ts

@@ -0,0 +1,2 @@
+import { ILogger } from "../helpers";
+export declare function createMockLogger(): ILogger;

package/dist/testing/mock-logger.js

@@ -0,0 +1,11 @@
+export function createMockLogger() {
+    return {
+        debug: jest.fn(),
+        error: jest.fn(),
+        fatal: jest.fn(),
+        info: jest.fn(),
+        trace: jest.fn(),
+        warn: jest.fn(),
+    };
+}
+//# sourceMappingURL=mock-logger.js.map

package/dist/testing/mock-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-logger.js","sourceRoot":"","sources":["../../src/testing/mock-logger.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;QAChB,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;QAChB,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;QAChB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;QACf,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;QAChB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;KAChB,CAAC;AACJ,CAAC"}

package/dist/testing/test-module.d.ts

@@ -0,0 +1,112 @@
+import { ApplicationDefinition, ConfigLoader, ILogger, LibraryDefinition, LoggerOptions, ModuleConfiguration, OptionalModuleConfiguration, PartialConfiguration, ServiceFunction, ServiceMap, TConfigLogLevel, TLibrary } from "../helpers";
+export type CreateTestingLibraryOptions<S extends ServiceMap, C extends OptionalModuleConfiguration> = {
+    /**
+     * default: testing
+     */
+    name?: string;
+    target?: LibraryDefinition<S, C> | ApplicationDefinition<S, C>;
+};
+type TestingBootstrapOptions = {
+    /**
+     * default: false
+     *
+     * set to true to have this test emit logs
+     */
+    emitLogs?: boolean;
+    /**
+     * mostly useful for testing deep internals
+     */
+    configLoader?: ConfigLoader;
+    /**
+     * pass through to bootstrap params
+     */
+    loggerOptions?: LoggerOptions;
+    /**
+     * default: false
+     *
+     * Should testing apps consider config file / environment variables?
+     */
+    loadConfigs?: boolean;
+    /**
+     * replacement logger object to use
+     *
+     * default: **NOOP**
+     */
+    customLogger?: ILogger;
+    /**
+     * matches regular bootstrap options
+     */
+    bootLibrariesFirst?: boolean;
+    /**
+     * default values to use for configurations, before user values come in
+     */
+    configuration?: PartialConfiguration;
+    /**
+     * @internal
+     *
+     * define a configuration for the unit tests
+     *
+     * > **note**: you probably don't need to do this, it's not even documented
+     */
+    module_config?: ModuleConfiguration;
+};
+export type LibraryTestRunner<T> = T extends LibraryDefinition<infer S, infer C> ? iTestRunner<S, C> : never;
+export type ApplicationTestRunner<T> = T extends ApplicationDefinition<infer S, infer C> ? iTestRunner<S, C> : never;
+export type iTestRunner<S extends ServiceMap, C extends OptionalModuleConfiguration> = {
+    /**
+     * chained calls deep merge options together
+     */
+    configure: (configuration: PartialConfiguration) => iTestRunner<S, C>;
+    /**
+     * chained calls deep merge options together
+     */
+    setOptions: (options: TestingBootstrapOptions) => iTestRunner<S, C>;
+    /**
+     * sets flag to true
+     */
+    bootLibrariesFirst: () => iTestRunner<S, C>;
+    /**
+     * for debugging, single command to enable logging on this test
+     */
+    emitLogs: (log_level?: TConfigLogLevel) => iTestRunner<S, C>;
+    /**
+     * chained calls add multiple setup functions
+     */
+    setup: (test: ServiceFunction) => iTestRunner<S, C>;
+    /**
+     * returns reference to app that was booted
+     */
+    run: (test: ServiceFunction) => Promise<ApplicationDefinition<ServiceMap, OptionalModuleConfiguration>>;
+    /**
+     * add a library to the runner beyond what the target module requested
+     */
+    appendLibrary: (library: TLibrary) => iTestRunner<S, C>;
+    /**
+     * inject an extra service to your module
+     *
+     * by default will take the function name as context, can optionally provide the name as 2nd param (if it even matters)
+     */
+    appendService: (service: ServiceFunction, name?: string) => iTestRunner<S, C>;
+    /**
+     * substitute a library for another by name
+     */
+    replaceLibrary: (name: string, library: TLibrary) => iTestRunner<S, C>;
+    /**
+     * substitute a service for another in your module
+     *
+     * does not check if the substitution is valid
+     */
+    replaceService: (name: string, service: ServiceFunction) => iTestRunner<S, C>;
+    /**
+     * reference to the app teardown internally
+     *
+     * clean up your testing resources!
+     */
+    teardown: () => Promise<void>;
+    type: "test";
+};
+/**
+ * library optional
+ */
+export declare function TestRunner<S extends ServiceMap, C extends OptionalModuleConfiguration>(options?: CreateTestingLibraryOptions<S, C>): iTestRunner<S, C>;
+export {};