@digital-alchemy/core 24.8.4 → 24.9.4

package/dist/helpers/module.helper.js

@@ -0,0 +1,131 @@
+import { CreateApplication } from "../services";
+import { TestRunner } from "../testing";
+import { deepExtend } from "./extend.helper";
+import { CreateLibrary, } from "./wiring.helper";
+export function createModule(options) {
+    function extend(extendOptions) {
+        const appendLibrary = new Map();
+        let services = { ...workingModule.services };
+        const extend = {
+            appendLibrary: (library) => {
+                const name = library.name;
+                if (appendLibrary.has(name)) {
+                    throw new Error(`${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`);
+                }
+                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`);
+                }
+                // @ts-expect-error the interface makes this type properly, idc
+                services[name] = service;
+                return extend;
+            },
+            omitService: (...keys) => {
+                services = Object.fromEntries(Object.entries(services).filter(([i]) => !keys.includes(i)));
+                return extend;
+            },
+            pickService: (...keys) => {
+                services = Object.fromEntries(Object.entries(services).filter(([i]) => keys.includes(i)));
+                return extend;
+            },
+            rebuild: (incoming) => {
+                services = incoming;
+                return extend;
+            },
+            replaceLibrary: (library) => {
+                const name = library.name;
+                if (appendLibrary.has(name)) {
+                    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`);
+                    }
+                    appendLibrary.set(name, library);
+                }
+                return extend;
+            },
+            // @ts-expect-error I don't care
+            replaceService: (name, target) => {
+                if (!(name in services)) {
+                    throw new Error(`${String(name)} does not exist to replace`);
+                }
+                // @ts-expect-error I don't care
+                services[name] = target;
+                return extend;
+            },
+            toApplication: () => {
+                const depends = {};
+                workingModule.depends.forEach(i => (depends[i.name] = i));
+                appendLibrary.forEach((value, key) => (depends[key] = value));
+                return CreateApplication({
+                    configuration: deepExtend({}, workingModule.configuration),
+                    libraries: Object.values(depends),
+                    // @ts-expect-error wrapper problems
+                    name: extendOptions?.name || options.name,
+                    // @ts-expect-error wrapper problems
+                    priorityInit: [...workingModule.priorityInit],
+                    services,
+                });
+            },
+            toLibrary: () => {
+                const depends = {};
+                workingModule.depends.forEach(i => (depends[i.name] = i));
+                appendLibrary.forEach((value, key) => (depends[key] = value));
+                return CreateLibrary({
+                    configuration: deepExtend({}, workingModule.configuration),
+                    depends: Object.values(depends),
+                    // @ts-expect-error wrapper problems
+                    name: extendOptions?.name || options.name,
+                    optionalDepends: workingModule.optionalDepends,
+                    // @ts-expect-error wrapper problems
+                    priorityInit: [...workingModule.priorityInit],
+                    services,
+                });
+            },
+            toTest: () => {
+                return TestRunner({ target: extend.toApplication() });
+            },
+        };
+        return extend;
+    }
+    const workingModule = {
+        configuration: options.configuration,
+        depends: options.depends,
+        extend,
+        name: options.name,
+        optionalDepends: options.optionalDepends ?? [],
+        priorityInit: options.priorityInit,
+        services: options.services ?? {},
+    };
+    return workingModule;
+}
+createModule.fromApplication = (application) => {
+    return createModule({
+        configuration: application.configuration || {},
+        depends: application.libraries || [],
+        name: application.name,
+        optionalDepends: [],
+        priorityInit: application.priorityInit || [],
+        services: application.services,
+    });
+};
+createModule.fromLibrary = (library) => {
+    return createModule({
+        configuration: library.configuration || {},
+        depends: library.depends || [],
+        name: library.name,
+        optionalDepends: library.optionalDepends || [],
+        priorityInit: library.priorityInit || [],
+        services: library.services,
+    });
+};
+//# sourceMappingURL=module.helper.js.map

package/dist/helpers/module.helper.js.map

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

package/dist/helpers/utilities.helper.d.ts

@@ -30,12 +30,11 @@ export declare const WEEK: number;
 export declare const SECOND = 1000;
 export declare const PERCENT = 100;
 export declare const YEAR: number;
+export declare const ACTIVE_SLEEPS: Set<SleepReturn>;
 type SleepReturn = Promise<void> & {
-    kill: (execute: "stop" | "continue") => void;
+    kill: (execute?: "stop" | "continue") => void;
 };
 /**
- * Defaults to 1000 (1 second).
- *
  * #MARK: Simple usage
  *
  * ```typescript
@@ -53,25 +52,15 @@ type SleepReturn = Promise<void> & {
  * console.log(end - start); // 1000, because we stopped it early and executed
  * ```
  */
-export declare function sleep(target?: number | Date): SleepReturn;
+export declare function sleep(target: number | Date): SleepReturn;
 export declare const ACTIVE_THROTTLE: Set<string>;
 export declare const ACTIVE_DEBOUNCE: Map<string, SleepReturn>;
-/**
- * allow initial call, then block for a period
- */
-export declare function throttle(identifier: string, timeout: number): Promise<void>;
 /**
  * wait for duration after call before allowing next, extends for calls inside window
  */
 export declare function debounce(identifier: string, timeout: number): Promise<void>;
 export declare const asyncNoop: () => Promise<void>;
 export declare const noop: () => void;
-/**
- * #MARK: (re)peat
- *
- * Create an array of length, where the values are filled with a provided fill value, or (index + 1) as default value
- */
-export declare function PEAT<T = number>(length: number, fill?: T): T[];
 export type TBlackHole = unknown | void | Promise<void>;
 export type TAnyFunction = (...data: unknown[]) => TBlackHole;
 export {};

package/dist/helpers/utilities.helper.js

@@ -1,56 +1,48 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.noop = exports.asyncNoop = exports.ACTIVE_DEBOUNCE = exports.ACTIVE_THROTTLE = exports.YEAR = exports.PERCENT = exports.SECOND = exports.WEEK = exports.DAY = exports.HOUR = exports.MINUTE = exports.DOWN = exports.NOT_FOUND = exports.NO_CHANGE = exports.EMPTY = exports.FIRST = exports.NONE = exports.START = exports.LABEL = exports.SAME = exports.SINGLE = exports.INCREMENT = exports.ARRAY_OFFSET = exports.VALUE = exports.UP = exports.INVERT_VALUE = exports.DEFAULT_LIMIT = exports.TWO_THIRDS = exports.ONE_THIRD = exports.HALF = exports.PAIR = exports.EVEN = void 0;
-exports.sleep = sleep;
-exports.throttle = throttle;
-exports.debounce = debounce;
-exports.PEAT = PEAT;
-const is_extension_1 = require("../extensions/is.extension");
+import { is } from "../services/is.extension";
 /* eslint-disable @typescript-eslint/no-magic-numbers */
-exports.EVEN = 2;
-exports.PAIR = 2;
-exports.HALF = 0.5;
-exports.ONE_THIRD = 1 / 3;
-exports.TWO_THIRDS = 2 / 3;
+export const EVEN = 2;
+export const PAIR = 2;
+export const HALF = 0.5;
+export const ONE_THIRD = 1 / 3;
+export const TWO_THIRDS = 2 / 3;
 /**
  * Good for a surprising number of situations
  */
-exports.DEFAULT_LIMIT = 5;
-exports.INVERT_VALUE = -1;
+export const DEFAULT_LIMIT = 5;
+export const INVERT_VALUE = -1;
 // Sort
-exports.UP = 1;
+export const UP = 1;
 // [LABEL,VALUE]
-exports.VALUE = 1;
+export const VALUE = 1;
 // Standard value
-exports.ARRAY_OFFSET = 1;
+export const ARRAY_OFFSET = 1;
 // array[number +- increment]
-exports.INCREMENT = 1;
+export const INCREMENT = 1;
 // Generic one-ness
-exports.SINGLE = 1;
+export const SINGLE = 1;
 // Sorting
-exports.SAME = 0;
+export const SAME = 0;
 // [LABEL,VALUE]
-exports.LABEL = 0;
+export const LABEL = 0;
 // Generic start of something
-exports.START = 0;
-exports.NONE = 0;
-exports.FIRST = 0;
-exports.EMPTY = 0;
-exports.NO_CHANGE = 0;
+export const START = 0;
+export const NONE = 0;
+export const FIRST = 0;
+export const EMPTY = 0;
+export const NO_CHANGE = 0;
 // Testing of indexes
-exports.NOT_FOUND = -1;
+export const NOT_FOUND = -1;
 // Sorting
-exports.DOWN = -1;
-exports.MINUTE = 60_000;
-exports.HOUR = 3_600_000;
-exports.DAY = 86_400_000;
-exports.WEEK = 7 * exports.DAY;
-exports.SECOND = 1000;
-exports.PERCENT = 100;
-exports.YEAR = 365 * exports.DAY;
+export const DOWN = -1;
+export const MINUTE = 60_000;
+export const HOUR = 3_600_000;
+export const DAY = 86_400_000;
+export const WEEK = 7 * DAY;
+export const SECOND = 1000;
+export const PERCENT = 100;
+export const YEAR = 365 * DAY;
+export const ACTIVE_SLEEPS = new Set();
 /**
- * Defaults to 1000 (1 second).
- *
  * #MARK: Simple usage
  *
  * ```typescript
@@ -68,58 +60,44 @@ exports.YEAR = 365 * exports.DAY;
  * console.log(end - start); // 1000, because we stopped it early and executed
  * ```
  */
-function sleep(target = exports.SECOND) {
+export function sleep(target) {
     // done function from promise
     let done;
-    const timeout = setTimeout(() => done && done(), is_extension_1.is.date(target) ? target.getTime() - Date.now() : target);
+    const timeout = setTimeout(() => {
+        if (done) {
+            done();
+        }
+        ACTIVE_SLEEPS.delete(out);
+    }, is.date(target) ? target.getTime() - Date.now() : target);
     // Take a normal promise, add a `.kill` to it
     // You can await as normal, or call the function
-    const out = new Promise((i) => (done = i));
+    const out = new Promise(i => (done = i));
+    ACTIVE_SLEEPS.add(out);
     out.kill = (execute = "stop") => {
-        if (execute === "continue") {
-            done && done();
+        ACTIVE_SLEEPS.delete(out);
+        if (execute === "continue" && done) {
+            done();
         }
         clearTimeout(timeout);
         done = undefined;
     };
     return out;
 }
-exports.ACTIVE_THROTTLE = new Set();
-exports.ACTIVE_DEBOUNCE = new Map();
-/**
- * allow initial call, then block for a period
- */
-async function throttle(identifier, timeout) {
-    if (exports.ACTIVE_THROTTLE.has(identifier)) {
-        return;
-    }
-    exports.ACTIVE_THROTTLE.add(identifier);
-    await sleep(timeout);
-    exports.ACTIVE_THROTTLE.delete(identifier);
-}
+export const ACTIVE_THROTTLE = new Set();
+export const ACTIVE_DEBOUNCE = new Map();
 /**
  * wait for duration after call before allowing next, extends for calls inside window
  */
-async function debounce(identifier, timeout) {
-    const current = exports.ACTIVE_DEBOUNCE.get(identifier);
-    if (current) {
+export async function debounce(identifier, timeout) {
+    const current = ACTIVE_DEBOUNCE.get(identifier);
+    if (!is.undefined(current)) {
         current.kill("stop");
     }
     const delay = sleep(timeout);
-    exports.ACTIVE_DEBOUNCE.set(identifier, delay);
+    ACTIVE_DEBOUNCE.set(identifier, delay);
     await delay;
-    exports.ACTIVE_DEBOUNCE.delete(identifier);
-}
-const asyncNoop = async () => await sleep(exports.NONE);
-exports.asyncNoop = asyncNoop;
-const noop = () => { };
-exports.noop = noop;
-/**
- * #MARK: (re)peat
- *
- * Create an array of length, where the values are filled with a provided fill value, or (index + 1) as default value
- */
-function PEAT(length, fill) {
-    return Array.from({ length }).map((_, index) => fill ?? (index + exports.ARRAY_OFFSET));
+    ACTIVE_DEBOUNCE.delete(identifier);
 }
+export const asyncNoop = async () => await sleep(NONE);
+export const noop = () => { };
 //# sourceMappingURL=utilities.helper.js.map

package/dist/helpers/utilities.helper.js.map

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

package/dist/helpers/wiring.helper.d.ts

@@ -1,8 +1,9 @@
+import { AsyncLocalStorage } from "async_hooks";
 import { Dayjs } from "dayjs";
 import { EventEmitter } from "events";
-import { CronExpression, ILogger, InternalDefinition, LIB_BOILERPLATE, TBlackHole, TCache, TContext } from "..";
+import { CronExpression, ILogger, InternalDefinition, LIB_BOILERPLATE, TBlackHole, TConfigLogLevel, TContext } from "..";
 import { AnyConfig, BooleanConfig, ConfigLoader, InternalConfig, NumberConfig, OptionalModuleConfiguration, StringArrayConfig, StringConfig } from "./config.helper";
-import { TChildLifecycle, TLifecycleBase } from "./lifecycle.helper";
+import { TLifecycleBase } from "./lifecycle.helper";
 export type TServiceReturn<OBJECT extends object = object> = void | OBJECT;
 export type TModuleMappings = Record<string, ServiceFunction>;
 export type TResolvedModuleMappings = Record<string, TServiceReturn>;
@@ -30,14 +31,6 @@ export type ScheduleItem = {
 };
 export type SchedulerOptions = {
     exec: () => TBlackHole;
-    /**
-     * if provided, specific metrics will be kept and labelled with provided label
-     *
-     * - execution count
-     * - errors
-     * - execution duration
-     */
-    label?: string;
 };
 /**
  * General code scheduling functions
@@ -76,13 +69,23 @@ type CastConfigResult<T extends AnyConfig> = T extends StringConfig<infer STRING
 export type TInjectedConfig = {
     [ModuleName in keyof ModuleConfigs]: ConfigTypes<ModuleConfigs[ModuleName]>;
 };
+export interface AsyncLogData {
+}
+export interface AsyncLocalData {
+    logs: AsyncLogData;
+}
+export type AlsExtension = {
+    asyncStorage: () => AsyncLocalStorage<AsyncLocalData>;
+    getStore: () => AsyncLocalData;
+    init(source: object, callback: () => TBlackHole): void;
+    getLogData: () => AsyncLogData;
+};
+export type AlsHook = () => object;
 export type TServiceParams = {
     /**
-     * provided by boilerplate library
-     *
-     * contains basic caching methods
+     * hooks for AsyncLocalStorage
      */
-    cache: TCache;
+    als: AlsExtension;
     /**
      * string describing how this service is wired into the main application
      */
@@ -121,7 +124,7 @@ export type TServiceParams = {
 } & {
     [K in ExternalLoadedModules]: GetApis<LoadedModules[K]>;
 };
-type LoadedModuleNames = Extract<keyof LoadedModules, string>;
+export type LoadedModuleNames = Extract<keyof LoadedModules, string>;
 type ExternalLoadedModules = Exclude<LoadedModuleNames, "boilerplate">;
 type ModuleConfigs = {
     [K in LoadedModuleNames]: LoadedModules[K] extends LibraryDefinition<ServiceMap, infer Config> ? Config : LoadedModules[K] extends ApplicationDefinition<ServiceMap, infer Config> ? Config : never;
@@ -129,6 +132,7 @@ type ModuleConfigs = {
 type ConfigTypes<Config> = {
     [Key in keyof Config]: Config[Key] extends AnyConfig ? CastConfigResult<Config[Key]> : never;
 };
+export type ServiceNames<T extends LoadedModuleNames = LoadedModuleNames> = LoadedModules[T] extends LibraryDefinition<infer S, OptionalModuleConfiguration> ? `${T}.${Extract<keyof S, string>}` : never;
 export type GetApis<T> = T extends LibraryDefinition<infer S, OptionalModuleConfiguration> ? GetApisResult<S> : T extends ApplicationDefinition<infer S, OptionalModuleConfiguration> ? GetApisResult<S> : never;
 export type Loader<PARENT extends TConfigurable> = <K extends keyof PARENT["services"]>(serviceName: K) => ReturnType<PARENT["services"][K]> extends Promise<infer AsyncResult> ? AsyncResult : ReturnType<PARENT["services"][K]>;
 export type ServiceFunction<R = unknown> = (params: TServiceParams) => R | Promise<R>;
@@ -144,13 +148,13 @@ export type LibraryConfigurationOptions<S extends ServiceMap, C extends Optional
      * - warnings will be emitted if this library utilizes a different version of a dependency than what the app uses
      * - version provided by app will be substituted
      */
-    depends?: LibraryConfigurationOptions<ServiceMap, OptionalModuleConfiguration>[];
+    depends?: TLibrary[];
     /**
      * Same as depends, but will not error if library is not provided at app level
      *
      * **note**: related variables may come in as undefined, code needs to be built to allow for this
      */
-    optionalDepends?: LibraryConfigurationOptions<ServiceMap, OptionalModuleConfiguration>[];
+    optionalDepends?: TLibrary[];
     configuration?: C;
     /**
      * Define which services should be initialized first. Any remaining services are done at the end in no set order
@@ -196,6 +200,10 @@ export type BootstrapOptions = {
      * use this logger, instead of the baked in one. Maybe you want some custom transports or something? Put your customized thing here
      */
     customLogger?: ILogger;
+    /**
+     * fine tine the built in logger
+     */
+    loggerOptions?: LoggerOptions;
     /**
      * Show detailed boot time statistics
      */
@@ -207,6 +215,49 @@ export type BootstrapOptions = {
      */
     envFile?: string;
 };
+export type LoggerOptions = {
+    /**
+     * Generic data to include as data payload for all logs
+     *
+     * Can be used to provide application tags when using a log aggregator
+     */
+    mergeData?: object;
+    /**
+     * Adjust the format of the timestamp at the start of the log
+     *
+     * > default: ddd HH:mm:ss.SSS
+     */
+    timestampFormat?: string;
+    /**
+     * Pretty format logs
+     *
+     * > default: true
+     */
+    pretty?: boolean;
+    /**
+     * prefix messages with ms since last message
+     *
+     * > default: false
+     */
+    ms?: boolean;
+    /**
+     * add an incrementing counter to every log.
+     * starts at 0 at boot
+     *
+     * > default: false
+     */
+    counter?: boolean;
+    /**
+     * extract details from als module to merge into logs
+     *
+     * > default: false
+     */
+    als?: boolean;
+    /**
+     * Override the `LOG_LEVEL` per service or module
+     */
+    levelOverrides?: Partial<Record<LoadedModuleNames | ServiceNames, TConfigLogLevel>>;
+};
 export declare const WIRE_PROJECT: unique symbol;
 type Wire = {
     /**
@@ -215,20 +266,23 @@ type Wire = {
      * - initializes lifecycle
      * - attaches event emitters
      */
-    [WIRE_PROJECT]: (internal: InternalDefinition, WireService: (project: string, service: string, definition: ServiceFunction, lifecycle: TLifecycleBase, internal: InternalDefinition) => Promise<TServiceReturn<object>>) => Promise<TChildLifecycle>;
+    [WIRE_PROJECT]: (internal: InternalDefinition, WireService: (project: string, service: string, definition: ServiceFunction, lifecycle: TLifecycleBase, internal: InternalDefinition) => Promise<TServiceReturn<object>>) => Promise<TLifecycleBase>;
+};
+export type LibraryDefinition<S extends ServiceMap, C extends OptionalModuleConfiguration> = LibraryConfigurationOptions<S, C> & Wire & {
+    type: "library";
 };
-export type LibraryDefinition<S extends ServiceMap, C extends OptionalModuleConfiguration> = LibraryConfigurationOptions<S, C> & Wire;
 export type ApplicationDefinition<S extends ServiceMap, C extends OptionalModuleConfiguration> = ApplicationConfigurationOptions<S, C> & Wire & {
     logger: ILogger;
+    type: "application";
     booted: boolean;
     bootstrap: (options?: BootstrapOptions) => Promise<void>;
     teardown: () => Promise<void>;
 };
-type TLibrary = LibraryDefinition<ServiceMap, OptionalModuleConfiguration>;
-export declare function BuildSortOrder<S extends ServiceMap, C extends OptionalModuleConfiguration>(app: ApplicationDefinition<S, C>, logger: ILogger): TLibrary[];
+export type TLibrary = LibraryDefinition<ServiceMap, OptionalModuleConfiguration>;
+export declare function buildSortOrder<S extends ServiceMap, C extends OptionalModuleConfiguration>(app: ApplicationDefinition<S, C>, logger: ILogger): TLibrary[];
 export declare const COERCE_CONTEXT: (context: string) => TContext;
 export declare const WIRING_CONTEXT: TContext;
-export declare function ValidateLibrary<S extends ServiceMap>(project: string, serviceList: S): void | never;
-export declare function WireOrder<T extends string>(priority: T[], list: T[]): T[];
+export declare function validateLibrary<S extends ServiceMap>(project: string, serviceList: S): void | never;
+export declare function wireOrder<T extends string>(priority: T[], list: T[]): T[];
 export declare function CreateLibrary<S extends ServiceMap, C extends OptionalModuleConfiguration>({ name: libraryName, configuration, priorityInit, services, depends, optionalDepends, }: LibraryConfigurationOptions<S, C>): LibraryDefinition<S, C>;
 export {};