@digital-alchemy/core 0.1.0

package/dist/automation/helpers/sequence.helper.d.ts

@@ -0,0 +1,55 @@
+import { sleep, TBlackHole, TContext } from "../../utilities";
+export type SequenceWatchOptions<DATA extends object = object, MATCH extends string = string> = {
+    /**
+     * Additional log context
+     */
+    context: TContext;
+    /**
+     * Pre-filter to only events of a given type
+     */
+    event_type: string;
+    /**
+     * Code to run on match
+     */
+    exec: () => TBlackHole;
+    /**
+     * Pick objects of relevance out of the event stream
+     */
+    filter: (data: DATA) => boolean;
+    /**
+     * text label
+     *
+     * - for metrics
+     * - for resetting
+     */
+    label?: string;
+    /**
+     * States from controller to match
+     */
+    match: MATCH[];
+    /**
+     * "path.to.property"
+     */
+    path: string;
+    /**
+     * Normally a watcher must wait 1500 as a "cooling off" / "waiting for more states to match with to come in"
+     *
+     * - `self`: after activating, reset the progress of this particular activate event so it can re-activate immediately
+     *
+     * - `tag:${string}`: reset ALL sequence watchers that share the same tag
+     */
+    reset?: TSequenceReset;
+};
+export type TSequenceReset = "self" | {
+    label: string | string[];
+};
+export type ActiveWatcher = {
+    interrupt: ReturnType<typeof sleep>;
+    match: string[];
+    label: string;
+    reset: TSequenceReset;
+};
+export type TrackedOptions = SequenceWatchOptions & {
+    id: string;
+};
+export type GenericFilter = (data: object) => boolean;

package/dist/automation/helpers/sequence.helper.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=sequence.helper.js.map

package/dist/automation/helpers/sequence.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.helper.js","sourceRoot":"","sources":["../../../src/automation/helpers/sequence.helper.ts"],"names":[],"mappings":""}

package/dist/automation/helpers/solar.helper.d.ts

@@ -0,0 +1,3 @@
+export declare function getJD(date: Date): number;
+export declare function calcSolNoon(longitude: number): Date;
+export declare function calcSunriseSet(rise: boolean, angle: number, latitude: number, longitude: number): Date | "error";

package/dist/automation/helpers/solar.helper.js

@@ -0,0 +1,262 @@
+"use strict";
+/* eslint-disable @typescript-eslint/no-magic-numbers, @typescript-eslint/ban-ts-comment */
+// @ts-nocheck
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calcSunriseSet = exports.calcSolNoon = exports.getJD = void 0;
+//
+// NOTE: This file is `sun.js` from the `solar-calc` library, with some light tweaks
+// This code wasn't built with modern types in mind, and has some weird interactions in places.
+// It accomplishes what I need, and as long as I don't look at it, it can't hurt me
+// See the solar-calc extension for the rest of the implementation
+//
+const formatDate = function formatDate(date, minutes) {
+    const seconds = (minutes - Math.floor(minutes)) * 60;
+    return new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate(), 0, minutes, seconds));
+};
+function calcTimeJulianCent(jd) {
+    const T = (jd - 2_451_545) / 36_525;
+    return T;
+}
+function isLeapYear(yr) {
+    return (yr % 4 === 0 && yr % 100 !== 0) || yr % 400 === 0;
+}
+function calcDoyFromJD(jd) {
+    const z = Math.floor(jd + 0.5);
+    const f = jd + 0.5 - z;
+    let A;
+    if (z < 2_299_161) {
+        A = z;
+    }
+    else {
+        const alpha = Math.floor((z - 1_867_216.25) / 36_524.25);
+        A = z + 1 + alpha - Math.floor(alpha / 4);
+    }
+    const B = A + 1524;
+    const C = Math.floor((B - 122.1) / 365.25);
+    const D = Math.floor(365.25 * C);
+    const E = Math.floor((B - D) / 30.6001);
+    const day = B - D - Math.floor(30.6001 * E) + f;
+    const month = E < 14 ? E - 1 : E - 13;
+    const year = month > 2 ? C - 4716 : C - 4715;
+    const k = isLeapYear(year) ? 1 : 2;
+    const doy = Math.floor((275 * month) / 9) - k * Math.floor((month + 9) / 12) + day - 30;
+    return doy;
+}
+function radToDeg(angleRad) {
+    return (180 * angleRad) / Math.PI;
+}
+function degToRad(angleDeg) {
+    return (Math.PI * angleDeg) / 180;
+}
+function calcGeomMeanLongSun(t) {
+    let L0 = 280.466_46 + t * (36_000.769_83 + t * 0.000_303_2);
+    while (L0 > 360) {
+        L0 -= 360;
+    }
+    while (L0 < 0) {
+        L0 += 360;
+    }
+    return L0; // in degrees
+}
+function calcGeomMeanAnomalySun(t) {
+    const M = 357.529_11 + t * (35_999.050_29 - 0.000_153_7 * t);
+    return M; // in degrees
+}
+function calcEccentricityEarthOrbit(t) {
+    const e = 0.016_708_634 - t * (0.000_042_037 + 1.267e-7 * t);
+    return e; // unitless
+}
+function calcSunEqOfCenter(t) {
+    const m = calcGeomMeanAnomalySun(t);
+    const mrad = degToRad(m);
+    const sinm = Math.sin(mrad);
+    const sin2m = Math.sin(mrad + mrad);
+    const sin3m = Math.sin(mrad + mrad + mrad);
+    const C = sinm * (1.914_602 - t * (0.004_817 + 0.000_014 * t)) +
+        sin2m * (0.019_993 - 0.000_101 * t) +
+        sin3m * 0.000_289;
+    return C; // in degrees
+}
+function calcSunTrueLong(t) {
+    const l0 = calcGeomMeanLongSun(t);
+    const c = calcSunEqOfCenter(t);
+    const O = l0 + c;
+    return O; // in degrees
+}
+function calcSunApparentLong(t) {
+    const o = calcSunTrueLong(t);
+    const omega = 125.04 - 1934.136 * t;
+    const lambda = o - 0.005_69 - 0.004_78 * Math.sin(degToRad(omega));
+    return lambda; // in degrees
+}
+function calcMeanObliquityOfEcliptic(t) {
+    const seconds = 21.448 - t * (46.815 + t * (0.000_59 - t * 0.001_813));
+    const e0 = 23 + (26 + seconds / 60) / 60;
+    return e0; // in degrees
+}
+function calcObliquityCorrection(t) {
+    const e0 = calcMeanObliquityOfEcliptic(t);
+    const omega = 125.04 - 1934.136 * t;
+    const e = e0 + 0.002_56 * Math.cos(degToRad(omega));
+    return e; // in degrees
+}
+function calcSunDeclination(t) {
+    const e = calcObliquityCorrection(t);
+    const lambda = calcSunApparentLong(t);
+    const sint = Math.sin(degToRad(e)) * Math.sin(degToRad(lambda));
+    const theta = radToDeg(Math.asin(sint));
+    return theta; // in degrees
+}
+function calcEquationOfTime(t) {
+    const epsilon = calcObliquityCorrection(t);
+    const l0 = calcGeomMeanLongSun(t);
+    const e = calcEccentricityEarthOrbit(t);
+    const m = calcGeomMeanAnomalySun(t);
+    let y = Math.tan(degToRad(epsilon) / 2);
+    y *= y;
+    const sin2l0 = Math.sin(2 * degToRad(l0));
+    const sinm = Math.sin(degToRad(m));
+    const cos2l0 = Math.cos(2 * degToRad(l0));
+    const sin4l0 = Math.sin(4 * degToRad(l0));
+    const sin2m = Math.sin(2 * degToRad(m));
+    const Etime = y * sin2l0 -
+        2 * e * sinm +
+        4 * e * y * sinm * cos2l0 -
+        0.5 * y * y * sin4l0 -
+        1.25 * e * e * sin2m;
+    return radToDeg(Etime) * 4; // in minutes of time
+}
+function calcHourAngle(angle, lat, solarDec) {
+    const latRad = degToRad(lat);
+    const sdRad = degToRad(solarDec);
+    const HAarg = Math.cos(degToRad(90 + angle)) / (Math.cos(latRad) * Math.cos(sdRad)) -
+        Math.tan(latRad) * Math.tan(sdRad);
+    const HA = Math.acos(HAarg);
+    return HA; // in radians (for sunset, use -HA)
+}
+function isNumber(inputValue) {
+    let oneDecimal = false;
+    const inputString = "" + inputValue;
+    for (let i = 0; i < inputString.length; i++) {
+        const oneChar = inputString.charAt(i);
+        if (i === 0 && (oneChar === "-" || oneChar === "+")) {
+            continue;
+        }
+        if (oneChar === "." && !oneDecimal) {
+            oneDecimal = true;
+            continue;
+        }
+        if (oneChar < "0" || oneChar > "9") {
+            return false;
+        }
+    }
+    return true;
+}
+function getJD(date) {
+    const year = date.getFullYear();
+    const month = date.getMonth() + 1;
+    const day = date.getDate();
+    const A = Math.floor(year / 100);
+    const B = 2 - A + Math.floor(A / 4);
+    const JD = Math.floor(365.25 * (year + 4716)) +
+        Math.floor(30.6001 * (month + 1)) +
+        day +
+        B -
+        1524.5;
+    return JD;
+}
+exports.getJD = getJD;
+function calcSolNoon(longitude) {
+    const date = new Date();
+    const jd = getJD(date);
+    const noon = calcTimeJulianCent(jd - longitude / 360);
+    let eqTime = calcEquationOfTime(noon);
+    const solNoonOffset = 720 - longitude * 4 - eqTime; // in minutes
+    const newt = calcTimeJulianCent(jd + solNoonOffset / 1440);
+    eqTime = calcEquationOfTime(newt);
+    let solNoonLocal = 720 - longitude * 4 - eqTime; // in minutes
+    while (solNoonLocal < 0) {
+        solNoonLocal += 1440;
+    }
+    while (solNoonLocal >= 1440) {
+        solNoonLocal -= 1440;
+    }
+    return formatDate(date, solNoonLocal);
+    // return timeString(solNoonLocal, 3);
+}
+exports.calcSolNoon = calcSolNoon;
+function dayString(jd) {
+    if (jd < 900_000 || jd > 2_817_000) {
+        return "error";
+    }
+    else {
+        const z = Math.floor(jd + 0.5);
+        const f = jd + 0.5 - z;
+        let A;
+        if (z < 2_299_161) {
+            A = z;
+        }
+        else {
+            const alpha = Math.floor((z - 1_867_216.25) / 36_524.25);
+            A = z + 1 + alpha - Math.floor(alpha / 4);
+        }
+        const B = A + 1524;
+        const C = Math.floor((B - 122.1) / 365.25);
+        const D = Math.floor(365.25 * C);
+        const E = Math.floor((B - D) / 30.6001);
+        const day = B - D - Math.floor(30.6001 * E) + f;
+        const month = E < 14 ? E - 1 : E - 13;
+        const year = month > 2 ? C - 4716 : C - 4715;
+        return new Date(Date.UTC(year, month - 1, day, 0, 0, 0));
+    }
+}
+function calcSunriseSetUTC(rise, angle, JD, latitude, longitude) {
+    const t = calcTimeJulianCent(JD);
+    const eqTime = calcEquationOfTime(t);
+    const solarDec = calcSunDeclination(t);
+    let hourAngle = calcHourAngle(angle, latitude, solarDec);
+    //alert("HA = " + radToDeg(hourAngle));
+    if (!rise)
+        hourAngle = -hourAngle;
+    const delta = longitude + radToDeg(hourAngle);
+    const timeUTC = 720 - 4 * delta - eqTime; // in minutes
+    return timeUTC;
+}
+function calcSunriseSet(rise, angle, latitude, longitude) {
+    const date = new Date();
+    const JD = getJD(date);
+    // rise = 1 for sunrise, 0 for sunset
+    const timeUTC = calcSunriseSetUTC(rise, angle, JD, latitude, longitude);
+    const newTimeUTC = calcSunriseSetUTC(rise, angle, JD + timeUTC / 1440, latitude, longitude);
+    if (isNumber(newTimeUTC)) {
+        return formatDate(date, newTimeUTC);
+    }
+    else {
+        // no sunrise/set found
+        const doy = calcDoyFromJD(JD);
+        let jdy;
+        if ((latitude > 66.4 && doy > 79 && doy < 267) ||
+            (latitude < -66.4 && (doy < 83 || doy > 263))) {
+            //previous sunrise/next sunset
+            jdy = calcJDofNextPreviousRiseSet(!rise, rise, angle, JD, latitude, longitude);
+            return dayString(jdy);
+        }
+        else {
+            //previous sunset/next sunrise
+            jdy = calcJDofNextPreviousRiseSet(rise, rise, angle, JD, latitude, longitude);
+            return dayString(jdy);
+        }
+    }
+}
+exports.calcSunriseSet = calcSunriseSet;
+function calcJDofNextPreviousRiseSet(next, rise, type, JD, latitude, longitude) {
+    let julianday = JD;
+    const increment = next ? 1 : -1;
+    let time = calcSunriseSetUTC(rise, type, julianday, latitude, longitude);
+    while (!isNumber(time)) {
+        julianday += increment;
+        time = calcSunriseSetUTC(rise, type, julianday, latitude, longitude);
+    }
+    return julianday;
+}
+//# sourceMappingURL=solar.helper.js.map

package/dist/automation/helpers/solar.helper.js.map

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

package/dist/automation/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./automation.module";
+export * from "./extensions";
+export * from "./helpers";

package/dist/automation/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const dayjs_1 = tslib_1.__importDefault(require("dayjs"));
+const isBetween_1 = tslib_1.__importDefault(require("dayjs/plugin/isBetween"));
+dayjs_1.default.extend(isBetween_1.default);
+tslib_1.__exportStar(require("./automation.module"), exports);
+tslib_1.__exportStar(require("./extensions"), exports);
+tslib_1.__exportStar(require("./helpers"), exports);
+//# sourceMappingURL=index.js.map

package/dist/automation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/automation/index.ts"],"names":[],"mappings":";;;AAAA,0DAA0B;AAC1B,+EAA+C;AAC/C,eAAK,CAAC,MAAM,CAAC,mBAAS,CAAC,CAAC;AAExB,8DAAoC;AACpC,uDAA6B;AAC7B,oDAA0B"}

package/dist/boilerplate/extensions/cache.extension.d.ts

@@ -0,0 +1,24 @@
+import { TServiceParams } from "..";
+export interface ICacheDriver {
+    get<T>(key: string, defaultValue?: T): Promise<T | undefined>;
+    set<T>(key: string, value: T, ttl: number): Promise<void>;
+    del(key: string): Promise<void>;
+    keys(pattern?: string): Promise<string[]>;
+}
+export declare enum CacheProviders {
+    redis = "redis",
+    memory = "memory"
+}
+export declare function Cache({ logger, lifecycle, config }: TServiceParams): TCache;
+export type TCache = {
+    del: (key: string) => Promise<void>;
+    get: <T>(key: string, defaultValue?: T) => Promise<T>;
+    set: <T>(key: string, value: T, ttl?: number) => Promise<void>;
+    keys: (pattern?: string) => Promise<string[]>;
+    setClient: (client: ICacheDriver) => void;
+};
+declare module "../../utilities" {
+    interface ZCCDefinition {
+        cache: TCache;
+    }
+}

package/dist/boilerplate/extensions/cache.extension.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cache = exports.CacheProviders = void 0;
+const __1 = require("../..");
+const __2 = require("..");
+var CacheProviders;
+(function (CacheProviders) {
+    CacheProviders["redis"] = "redis";
+    CacheProviders["memory"] = "memory";
+})(CacheProviders || (exports.CacheProviders = CacheProviders = {}));
+function Cache({ logger, lifecycle, config }) {
+    let client;
+    const prefix = () => config.boilerplate.CACHE_PREFIX || __1.ZCC.application.name;
+    function fullKeyName(key) {
+        return `${config.boilerplate.CACHE_PREFIX}${key}`;
+    }
+    lifecycle.onPostConfig(async () => {
+        if (client) {
+            return;
+        }
+        logger.trace({ provider: config.boilerplate.CACHE_PROVIDER }, `init cache`);
+        if (config.boilerplate.CACHE_PROVIDER === "redis") {
+            client = await (0, __2.createRedisDriver)({ config, logger });
+            return;
+        }
+        client = await (0, __2.createMemoryDriver)({ config, logger });
+    });
+    const cache = {
+        [Symbol.for("cache_logger")]: logger,
+        del: async (key) => {
+            try {
+                const fullKey = fullKeyName(key);
+                await client.del(fullKey);
+                __2.CACHE_DELETE_OPERATIONS_TOTAL.inc({
+                    key: fullKey,
+                    prefix: prefix(),
+                });
+            }
+            catch (error) {
+                __2.CACHE_DRIVER_ERROR_COUNT.labels("del").inc();
+                logger.error({ error }, `cache delete error`);
+            }
+        },
+        get: async (key, defaultValue) => {
+            try {
+                const fullKey = fullKeyName(key);
+                const result = await client.get(fullKey);
+                __2.CACHE_GET_OPERATIONS_TOTAL.inc({
+                    hit_miss: __1.is.undefined(result) ? "miss" : "hit",
+                    key: fullKey,
+                    prefix: prefix(),
+                });
+                return __1.is.undefined(result) ? defaultValue : result;
+            }
+            catch (error) {
+                logger.warn({ defaultValue, error, key }, `cache lookup error`);
+                __2.CACHE_DRIVER_ERROR_COUNT.labels("get").inc();
+                return defaultValue;
+            }
+        },
+        keys: async (pattern = "") => {
+            try {
+                const fullPattern = fullKeyName(pattern);
+                const keys = await client.keys(fullPattern);
+                return keys.map(key => key.slice(Math.max(__1.NONE, prefix().length)));
+            }
+            catch (error) {
+                __2.CACHE_DRIVER_ERROR_COUNT.labels("keys").inc();
+                logger.warn({ error }, `cache keys error`);
+                return [];
+            }
+        },
+        set: async (key, value, ttl = config.boilerplate.CACHE_TTL) => {
+            try {
+                const fullKey = fullKeyName(key);
+                await client.set(fullKey, value, ttl);
+                __2.CACHE_SET_OPERATIONS_TOTAL.inc({
+                    key: fullKey,
+                    prefix: config.boilerplate.CACHE_PREFIX,
+                });
+            }
+            catch (error) {
+                __2.CACHE_DRIVER_ERROR_COUNT.labels("set").inc();
+                logger.error({ error }, `cache set error`);
+            }
+        },
+        setClient: newClient => {
+            logger.debug(`using new cache driver`);
+            client = newClient;
+        },
+    };
+    __1.ZCC.cache = cache;
+    return cache;
+}
+exports.Cache = Cache;
+//# sourceMappingURL=cache.extension.js.map

package/dist/boilerplate/extensions/cache.extension.js.map

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

package/dist/boilerplate/extensions/configuration.extension.d.ts

@@ -0,0 +1,23 @@
+import { ApplicationDefinition, CodeConfigDefinition, ConfigLoader, KnownConfigs, OptionalModuleConfiguration, PartialConfiguration, ServiceMap, TInjectedConfig, TServiceParams } from "../helpers";
+export declare const INITIALIZE: unique symbol;
+export declare const LOAD_PROJECT: unique symbol;
+export declare const EVENT_CONFIGURATION_UPDATED = "event_configuration_updated";
+export declare const INJECTED_DEFINITIONS: unique symbol;
+export declare function Configuration({ context, event, lifecycle, logger, }: TServiceParams): ConfigManager;
+export type ConfigManager = {
+    addConfigLoader: (loader: ConfigLoader) => Set<ConfigLoader>;
+    [INJECTED_DEFINITIONS]: () => TInjectedConfig;
+    [LOAD_PROJECT]: (library: keyof TInjectedConfig, definitions: CodeConfigDefinition) => KnownConfigs;
+    [INITIALIZE]: <S extends ServiceMap, C extends OptionalModuleConfiguration>(application: ApplicationDefinition<S, C>) => Promise<void>;
+    merge: (merge: Partial<PartialConfiguration>) => PartialConfiguration & Partial<PartialConfiguration>;
+    set<Project extends keyof TInjectedConfig, Property extends keyof TInjectedConfig[Project]>(project: Project, property: Property, value: TInjectedConfig[Project][Property]): void;
+};
+type ExcludeSymbolKeys<T> = {
+    [Key in keyof T as Key extends symbol ? never : Key]: T[Key];
+};
+declare module "../../utilities" {
+    interface ZCCDefinition {
+        config: ExcludeSymbolKeys<ConfigManager>;
+    }
+}
+export {};

package/dist/boilerplate/extensions/configuration.extension.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Configuration = exports.INJECTED_DEFINITIONS = exports.EVENT_CONFIGURATION_UPDATED = exports.LOAD_PROJECT = exports.INITIALIZE = void 0;
+const async_1 = require("async");
+const object_path_1 = require("object-path");
+const __1 = require("../..");
+const helpers_1 = require("../helpers");
+// # Symbols
+exports.INITIALIZE = Symbol.for("initialize");
+exports.LOAD_PROJECT = Symbol.for("load-project");
+exports.EVENT_CONFIGURATION_UPDATED = "event_configuration_updated";
+exports.INJECTED_DEFINITIONS = Symbol.for("injected-config");
+function Configuration({ context, event, lifecycle, 
+// ! THIS DOES NOT EXIST BEFORE PRE INIT
+logger, }) {
+    // 🙊 but that's illegal!
+    lifecycle.onPreInit(() => (logger = __1.ZCC.logger.context(context)));
+    // # Locals
+    const configLoaders = new Set();
+    const configuration = {};
+    const configDefinitions = new Map();
+    const DEFAULT_LOADERS = [
+        helpers_1.ConfigLoaderEnvironment,
+        helpers_1.ConfigLoaderFile,
+    ];
+    // # Methods
+    // ## Load the config for an app
+    async function Initialize(application) {
+        // * sanity check
+        if (!application) {
+            throw new helpers_1.BootstrapException(context, "NO_APPLICATION", "Cannot load configuration without having defined an application");
+        }
+        // * if a new standalone loader hasn't been defined, use provided
+        if (__1.is.empty(configLoaders)) {
+            logger.debug(`no config loaders defined, adding default`);
+            DEFAULT_LOADERS.forEach((i, index) => configLoaders.add([i, index]));
+        }
+        // * load!
+        await (0, async_1.eachSeries)([...configLoaders.values()].sort(([, a], [, b]) => (a > b ? __1.UP : __1.DOWN)), async ([loader]) => {
+            const merge = await loader({
+                application,
+                configs: configDefinitions,
+            });
+            (0, __1.deepExtend)(configuration, merge);
+        });
+        // * validate
+        // - ensure all required properties have been defined
+        configDefinitions.forEach((definitions, project) => {
+            Object.keys(definitions).forEach(key => {
+                const config = [project, key].join(".");
+                if (definitions[key].required &&
+                    __1.is.undefined((0, object_path_1.get)(configuration, config))) {
+                    // ruh roh
+                    throw new helpers_1.BootstrapException(context, "REQUIRED_CONFIGURATION_MISSING", `Configuration property ${config} is not defined`);
+                }
+            });
+        });
+    }
+    // ## Value that gets injected into services
+    function InjectedDefinitions() {
+        return new Proxy({}, {
+            get(_, project) {
+                return (0, object_path_1.get)(configuration, project) ?? {};
+            },
+        });
+    }
+    // ## Set a configuration value at runtime
+    function SetConfig(project, property, value) {
+        (0, object_path_1.set)(configuration, [project, property].join("."), value);
+        // in case anyone needs a hook
+        event.emit(exports.EVENT_CONFIGURATION_UPDATED);
+    }
+    // ## Provide new values for some config values
+    function Merge(merge) {
+        return (0, __1.deepExtend)(configuration, merge);
+    }
+    // ## Add a library, and it's associated definitions
+    function LoadProject(library, definitions) {
+        (0, object_path_1.set)(configuration, library, {});
+        Object.keys(definitions).forEach(key => {
+            (0, object_path_1.set)(configuration, [library, key].join("."), definitions[key].default);
+        });
+        return configDefinitions.set(library, definitions);
+    }
+    // ## Return object
+    const out = {
+        [exports.INITIALIZE]: Initialize,
+        [exports.INJECTED_DEFINITIONS]: InjectedDefinitions,
+        [exports.LOAD_PROJECT]: LoadProject,
+        addConfigLoader: (loader) => configLoaders.add(loader),
+        merge: Merge,
+        set: SetConfig,
+    };
+    __1.ZCC.config = out;
+    return out;
+}
+exports.Configuration = Configuration;
+//# sourceMappingURL=configuration.extension.js.map

package/dist/boilerplate/extensions/configuration.extension.js.map

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

package/dist/boilerplate/extensions/fetch.extension.d.ts

@@ -0,0 +1,20 @@
+import { DownloadOptions, FetchArguments, FetcherOptions, TServiceParams } from "..";
+export declare function Fetch({ logger, context: parentContext }: TServiceParams): ({ bottleneck, headers: baseHeaders, baseUrl, context: logContext, }: FetcherOptions) => {
+    download: ({ destination, body, headers, label, context, method, ...fetchWith }: DownloadOptions) => Promise<void>;
+    fetch: <T, BODY extends object = undefined>(fetchWith: Partial<FetchArguments<BODY>>) => Promise<T>;
+    setBaseUrl: (url: string) => string;
+    setHeaders: (headers: Record<string, string>) => Record<string, string>;
+};
+export type TFetch = <T, BODY extends object = object>(fetchWith: Partial<FetchArguments<BODY>>) => Promise<T>;
+export type TDownload = (fetchWith: DownloadOptions) => Promise<void>;
+declare module "../../utilities" {
+    interface ZCCDefinition {
+        createFetcher: (options: FetcherOptions) => {
+            download: TDownload;
+            setBaseUrl: (url: string) => void;
+            setHeaders: (headers: Record<string, string>) => void;
+            fetch: TFetch;
+        };
+        fetch: TFetch;
+    }
+}