@bitblit/ratchet-common 4.0.419-alpha → 4.0.421-alpha

package/lib/lang/composite-last-success-provider.js

@@ -0,0 +1,27 @@
+export class CompositeLastSuccessProvider {
+    sources;
+    mostRecent;
+    constructor(src, mostRecentSrc = true) {
+        if (!src || src.length == 0) {
+            throw Error('Cannot create composite provider with null/empty sources');
+        }
+        this.sources = src;
+        this.mostRecent = mostRecentSrc;
+    }
+    lastSuccess() {
+        let rval = null;
+        this.sources.forEach((s) => {
+            const val = s.lastSuccess();
+            if (val != null) {
+                if (rval == null) {
+                    rval = val;
+                }
+                else {
+                    rval = (val > rval && this.mostRecent) || (val < rval && !this.mostRecent) ? val : rval;
+                }
+            }
+        });
+        return rval;
+    }
+}
+//# sourceMappingURL=composite-last-success-provider.js.map

package/lib/lang/composite-last-success-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-last-success-provider.js","sourceRoot":"","sources":["../../src/lang/composite-last-success-provider.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,4BAA4B;IAC/B,OAAO,CAAwB;IAC/B,UAAU,CAAU;IAE5B,YAAY,GAA0B,EAAE,aAAa,GAAG,IAAI;QAC1D,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,aAAa,CAAC;IAClC,CAAC;IAEM,WAAW;QAChB,IAAI,IAAI,GAAW,IAAI,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACzB,MAAM,GAAG,GAAW,CAAC,CAAC,WAAW,EAAE,CAAC;YACpC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;gBAChB,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;oBACjB,IAAI,GAAG,GAAG,CAAC;gBACb,CAAC;qBAAM,CAAC;oBACN,IAAI,GAAG,CAAC,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;gBAC1F,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/lang/date-ratchet.d.ts

@@ -0,0 +1,11 @@
+export declare class DateRatchet {
+    static COMMON_US_DATE_FORMAT: string;
+    static DEFAULT_DATE_FORMAT: string;
+    static FULL_DATE_FORMAT: string;
+    static PACIFIC_TIME_ZONE: string;
+    static UTC_TIME_ZONE: string;
+    static formatFullDate(input: Date): string;
+    static formatDefaultDateOnly(input: Date): string;
+    static parseDefaultDate(input: string): Date;
+    static parseCommonUsDate(input: string): Date;
+}

package/lib/lang/date-ratchet.js

@@ -0,0 +1,30 @@
+import { DateTime } from 'luxon';
+export class DateRatchet {
+    static COMMON_US_DATE_FORMAT = 'MM/dd/yyyy';
+    static DEFAULT_DATE_FORMAT = 'yyyy-MM-dd';
+    static FULL_DATE_FORMAT = 'yyyy-MM-dd_HH_mm_ss';
+    static PACIFIC_TIME_ZONE = 'America/Los_Angeles';
+    static UTC_TIME_ZONE = 'etc/UTC';
+    static formatFullDate(input) {
+        return DateTime.fromJSDate(input).toFormat(DateRatchet.FULL_DATE_FORMAT);
+    }
+    static formatDefaultDateOnly(input) {
+        return DateTime.fromJSDate(input).toFormat(DateRatchet.DEFAULT_DATE_FORMAT);
+    }
+    static parseDefaultDate(input) {
+        const rval = DateTime.fromFormat(input, DateRatchet.DEFAULT_DATE_FORMAT).toJSDate();
+        return rval;
+    }
+    static parseCommonUsDate(input) {
+        let rval = null;
+        if (input) {
+            let templ = DateRatchet.COMMON_US_DATE_FORMAT;
+            if (input.indexOf('-') === 2) {
+                templ = templ.split('/').join('-');
+            }
+            rval = DateTime.fromFormat(input, templ).toJSDate();
+        }
+        return rval;
+    }
+}
+//# sourceMappingURL=date-ratchet.js.map

package/lib/lang/date-ratchet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-ratchet.js","sourceRoot":"","sources":["../../src/lang/date-ratchet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AASjC,MAAM,OAAO,WAAW;IACf,MAAM,CAAC,qBAAqB,GAAG,YAAY,CAAC;IAC5C,MAAM,CAAC,mBAAmB,GAAG,YAAY,CAAC;IAC1C,MAAM,CAAC,gBAAgB,GAAG,qBAAqB,CAAC;IAEhD,MAAM,CAAC,iBAAiB,GAAG,qBAAqB,CAAC;IACjD,MAAM,CAAC,aAAa,GAAG,SAAS,CAAC;IAEjC,MAAM,CAAC,cAAc,CAAC,KAAW;QACtC,OAAO,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAC3E,CAAC;IAEM,MAAM,CAAC,qBAAqB,CAAC,KAAW;QAC7C,OAAO,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAC9E,CAAC;IAEM,MAAM,CAAC,gBAAgB,CAAC,KAAa;QAC1C,MAAM,IAAI,GAAS,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC1F,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CAAC,iBAAiB,CAAC,KAAa;QAC3C,IAAI,IAAI,GAAS,IAAI,CAAC;QACtB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,KAAK,GAAW,WAAW,CAAC,qBAAqB,CAAC;YACtD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrC,CAAC;YACD,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC"}

package/lib/lang/duration-ratchet.d.ts

@@ -0,0 +1,7 @@
+import { DurationLike } from 'luxon';
+export declare class DurationRatchet {
+    static formatMsDuration(ms: number, includeMS?: boolean): string;
+    static colonFormatMsDuration(ms: number, includeMS?: boolean): string;
+    static daysBetween(d1: Date, d2: Date): number;
+    static createSteps(startEpochMS: number, endEpochMS: number, timezone: string, outputFormat: string, stepUnit: DurationLike): string[];
+}

package/lib/lang/duration-ratchet.js

@@ -0,0 +1,43 @@
+import { DateTime } from 'luxon';
+import { NumberRatchet } from './number-ratchet.js';
+export class DurationRatchet {
+    static formatMsDuration(ms, includeMS = false) {
+        const rem_ms = Math.floor(ms % 1000);
+        const seconds = Math.floor(ms / 1000) % 60;
+        const minutes = Math.floor(ms / (1000 * 60)) % 60;
+        const hours = Math.floor(ms / (1000 * 60 * 60)) % 24;
+        const days = Math.floor(ms / (1000 * 60 * 60 * 24));
+        const f = NumberRatchet.leadingZeros;
+        let rval = f(hours, 2) + 'h' + f(minutes, 2) + 'm';
+        rval += includeMS ? f(seconds, 2) + '.' + f(rem_ms, 3) + 's' : f(seconds, 2) + 's';
+        if (days > 0) {
+            rval = days + 'd' + rval;
+        }
+        return rval;
+    }
+    static colonFormatMsDuration(ms, includeMS = false) {
+        const rem_ms = ms % 1000;
+        const seconds = Math.floor(ms / 1000) % 60;
+        const minutes = Math.floor(ms / (1000 * 60)) % 60;
+        const hours = Math.floor(ms / (1000 * 60 * 60));
+        const f = NumberRatchet.leadingZeros;
+        let rval = f(hours, 2) + ':' + f(minutes, 2) + ':';
+        rval += includeMS ? f(seconds, 2) + '.' + f(rem_ms, 3) : f(seconds, 2);
+        return rval;
+    }
+    static daysBetween(d1, d2) {
+        const dur = DateTime.fromJSDate(d1).diff(DateTime.fromJSDate(d2));
+        return dur.days;
+    }
+    static createSteps(startEpochMS, endEpochMS, timezone, outputFormat, stepUnit) {
+        let curDate = DateTime.fromMillis(startEpochMS).setZone(timezone);
+        const endDate = DateTime.fromMillis(endEpochMS);
+        const rval = [];
+        while (curDate < endDate) {
+            rval.push(curDate.toFormat(outputFormat));
+            curDate = curDate.plus(stepUnit);
+        }
+        return rval;
+    }
+}
+//# sourceMappingURL=duration-ratchet.js.map

package/lib/lang/duration-ratchet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration-ratchet.js","sourceRoot":"","sources":["../../src/lang/duration-ratchet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA0B,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMpD,MAAM,OAAO,eAAe;IACnB,MAAM,CAAC,gBAAgB,CAAC,EAAU,EAAE,SAAS,GAAG,KAAK;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAEpD,MAAM,CAAC,GAAG,aAAa,CAAC,YAAY,CAAC;QACrC,IAAI,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC;QACnD,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC;QACnF,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACb,IAAI,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CAAC,qBAAqB,CAAC,EAAU,EAAE,SAAS,GAAG,KAAK;QAC/D,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAEhD,MAAM,CAAC,GAAG,aAAa,CAAC,YAAY,CAAC;QACrC,IAAI,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC;QACnD,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CAAC,WAAW,CAAC,EAAQ,EAAE,EAAQ;QAC1C,MAAM,GAAG,GAAa,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5E,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IAEM,MAAM,CAAC,WAAW,CACvB,YAAoB,EACpB,UAAkB,EAClB,QAAgB,EAChB,YAAoB,EACpB,QAAsB;QAEtB,IAAI,OAAO,GAAa,QAAQ,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAa,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAE1D,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,OAAO,OAAO,GAAG,OAAO,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;YAC1C,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/lang/enum-ratchet.d.ts

@@ -0,0 +1,5 @@
+export declare class EnumRatchet {
+    static listEnumKeys(enumeration: any): string[];
+    static keyToEnum<T>(enumeration: any, val: string, caseSensitive?: boolean): T;
+    static parseCsvToEnumArray<T>(enumeration: any, input: string): T[];
+}

package/lib/lang/enum-ratchet.js

@@ -0,0 +1,31 @@
+import { $enum } from 'ts-enum-util';
+import { StringRatchet } from './string-ratchet.js';
+export class EnumRatchet {
+    static listEnumKeys(enumeration) {
+        const rval = $enum(enumeration).getValues();
+        return rval;
+    }
+    static keyToEnum(enumeration, val, caseSensitive = false) {
+        const e = $enum(enumeration);
+        let rval = null;
+        if (val) {
+            rval = e.asValueOrDefault(val, null);
+            if (!rval && !caseSensitive) {
+                const keys = EnumRatchet.listEnumKeys(enumeration);
+                const mKey = keys.find((k) => k.toUpperCase() === val.toUpperCase());
+                if (mKey) {
+                    rval = e.asValueOrDefault(mKey, null);
+                }
+            }
+        }
+        return rval;
+    }
+    static parseCsvToEnumArray(enumeration, input) {
+        const split = StringRatchet.trimToEmpty(input)
+            .split(',')
+            .map((s) => s.trim());
+        const rval = split.map((s) => EnumRatchet.keyToEnum(enumeration, s)).filter((s) => !!s);
+        return rval;
+    }
+}
+//# sourceMappingURL=enum-ratchet.js.map

package/lib/lang/enum-ratchet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-ratchet.js","sourceRoot":"","sources":["../../src/lang/enum-ratchet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAe,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASpD,MAAM,OAAO,WAAW;IACf,MAAM,CAAC,YAAY,CAAC,WAAgB;QACzC,MAAM,IAAI,GAAa,KAAK,CAAC,WAAW,CAAC,CAAC,SAAS,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CAAC,SAAS,CAAI,WAAgB,EAAE,GAAW,EAAE,aAAa,GAAG,KAAK;QAC7E,MAAM,CAAC,GAAgB,KAAK,CAAC,WAAW,CAAC,CAAC;QAC1C,IAAI,IAAI,GAAM,IAAI,CAAC;QACnB,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,GAAG,CAAC,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACrC,IAAI,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBAE5B,MAAM,IAAI,GAAa,WAAW,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;gBAC7D,MAAM,IAAI,GAAW,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC7E,IAAI,IAAI,EAAE,CAAC;oBACT,IAAI,GAAG,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CAAC,mBAAmB,CAAI,WAAgB,EAAE,KAAa;QAClE,MAAM,KAAK,GAAa,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC;aACrD,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACxB,MAAM,IAAI,GAAQ,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,SAAS,CAAI,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChG,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/lang/error-ratchet.d.ts

@@ -0,0 +1,6 @@
+export declare class ErrorRatchet {
+    static safeStringifyErr(err: any, log?: boolean): string;
+    static asErr(input: any): Error;
+    static fErr(format: string, ...input: any[]): Error;
+    static throwFormattedErr(format: string, ...input: any[]): Error;
+}

package/lib/lang/error-ratchet.js

@@ -0,0 +1,45 @@
+import { Logger } from '../logger/logger.js';
+import util from 'util';
+export class ErrorRatchet {
+    static safeStringifyErr(err, log = true) {
+        let rval = 'ERR WAS NULL';
+        if (err) {
+            if (err['message']) {
+                rval = err['message'];
+            }
+            else {
+                try {
+                    rval = JSON.stringify(err);
+                }
+                catch (err2) {
+                    Logger.error('Failed to json stringify: %s', err2);
+                    rval = String(err);
+                }
+            }
+        }
+        if (log) {
+            Logger.error('%s', rval, err);
+        }
+        return rval;
+    }
+    static asErr(input) {
+        let rval = null;
+        if (input) {
+            if (input instanceof Error) {
+                rval = input;
+            }
+            else {
+                rval = new Error('Force-Cast to error : ' + String(input));
+            }
+        }
+        return rval;
+    }
+    static fErr(format, ...input) {
+        const msg = util.format(format, ...input);
+        return new Error(msg);
+    }
+    static throwFormattedErr(format, ...input) {
+        throw ErrorRatchet.fErr(format, ...input);
+    }
+}
+//# sourceMappingURL=error-ratchet.js.map

package/lib/lang/error-ratchet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-ratchet.js","sourceRoot":"","sources":["../../src/lang/error-ratchet.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,OAAO,YAAY;IAChB,MAAM,CAAC,gBAAgB,CAAC,GAAQ,EAAE,GAAG,GAAG,IAAI;QACjD,IAAI,IAAI,GAAG,cAAc,CAAC;QAC1B,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBACnB,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC;oBACH,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBAC7B,CAAC;gBAAC,OAAO,IAAI,EAAE,CAAC;oBACd,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,IAAI,CAAC,CAAC;oBACnD,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAGM,MAAM,CAAC,KAAK,CAAC,KAAU;QAC5B,IAAI,IAAI,GAAU,IAAI,CAAC;QACvB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,IAAI,GAAG,KAAK,CAAC;YACf,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,IAAI,KAAK,CAAC,wBAAwB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CAAC,IAAI,CAAC,MAAc,EAAE,GAAG,KAAY;QAChD,MAAM,GAAG,GAAW,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;QAClD,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAEM,MAAM,CAAC,iBAAiB,CAAC,MAAc,EAAE,GAAG,KAAY;QAC7D,MAAM,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/lib/lang/esm-ratchet.d.ts

@@ -0,0 +1,7 @@
+export declare class EsmRatchet {
+    private static readonly DYNAMIC_IMPORT_CACHE;
+    static fetchDirName(root: string): string;
+    static fetchFileName(root: string): string;
+    static cachedTypedDynamicImport<T>(libPath: string, importName?: string, requiredKeys?: string[], swallowErrorIfMissing?: boolean): Promise<T>;
+    static typedDynamicImport<T>(libPath: string, importName?: string, requiredKeys?: string[], swallowErrorIfMissing?: boolean): Promise<T>;
+}

package/lib/lang/esm-ratchet.js

@@ -0,0 +1,65 @@
+import url from 'url';
+import { ErrorRatchet } from './error-ratchet.js';
+import { Logger } from '../logger/logger.js';
+import { StringRatchet } from './string-ratchet.js';
+export class EsmRatchet {
+    static DYNAMIC_IMPORT_CACHE = new Map();
+    static fetchDirName(root) {
+        if (!root) {
+            throw new Error('Need to provide root (should be import.meta.url)');
+        }
+        const rval = url.fileURLToPath(new URL('.', root));
+        return rval;
+    }
+    static fetchFileName(root) {
+        if (!root) {
+            throw new Error('Need to provide root (should be import.meta.url)');
+        }
+        const rval = url.fileURLToPath(root);
+        return rval;
+    }
+    static async cachedTypedDynamicImport(libPath, importName, requiredKeys, swallowErrorIfMissing) {
+        const cacheKey = StringRatchet.trimToNull(importName) ? libPath + '__' + importName : libPath;
+        let rval = EsmRatchet.DYNAMIC_IMPORT_CACHE.get(cacheKey);
+        if (!rval) {
+            rval = EsmRatchet.typedDynamicImport(libPath, importName, requiredKeys, swallowErrorIfMissing);
+            if (rval) {
+                EsmRatchet.DYNAMIC_IMPORT_CACHE.set(cacheKey, rval);
+            }
+        }
+        return rval;
+    }
+    static async typedDynamicImport(libPath, importName, requiredKeys, swallowErrorIfMissing) {
+        let rval;
+        try {
+            rval = await import(libPath);
+        }
+        catch (err) {
+            if (swallowErrorIfMissing) {
+                Logger.debug('Cannot find library %s but swallow specified, returning null', libPath);
+                rval = null;
+            }
+            else {
+                throw ErrorRatchet.fErr('Could not find the "%s" library : %s', libPath, err);
+            }
+        }
+        if (StringRatchet.trimToNull(importName)) {
+            if (rval[importName]) {
+                rval = rval[importName];
+            }
+            else {
+                throw ErrorRatchet.fErr('Imported library %s, tried to load name %s but only found %j', libPath, importName, Object.keys(rval));
+            }
+        }
+        if (requiredKeys?.length && rval) {
+            const keys = Object.keys(rval);
+            requiredKeys.forEach((k) => {
+                if (!keys.includes(k)) {
+                    throw ErrorRatchet.fErr('Failed to import "%s" - required keys are %j, but found %j', libPath, requiredKeys, keys);
+                }
+            });
+        }
+        return rval;
+    }
+}
+//# sourceMappingURL=esm-ratchet.js.map

package/lib/lang/esm-ratchet.js.map

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

package/lib/lang/expiring-object.d.ts

@@ -0,0 +1,20 @@
+import { LoggerLevelName } from '../logger/logger-level-name.js';
+export declare class ExpiringObject<T> {
+    private _config;
+    private _cacheObject;
+    private _lastUpdatedEpochMS;
+    private _timeRemainingMS;
+    constructor(inputConfig?: ExpiringObjectConfig<T>);
+    private defaultConfig;
+    private defaultTimeRemainingMS;
+    update(newValue: T, doNotUpdateClock?: boolean): void;
+    fetchCacheObjectTimeRemainingMS(): Promise<number>;
+    fetch(): Promise<T>;
+}
+export declare class ExpiringObjectConfig<T> {
+    timeToLiveMS?: number;
+    generator?: () => Promise<T>;
+    initialValue?: T;
+    logLevel?: LoggerLevelName;
+    overrideTimeRemainingMS?: (lastUpdatedEpochMS: number) => Promise<number>;
+}

package/lib/lang/expiring-object.js

@@ -0,0 +1,73 @@
+import { Logger } from '../logger/logger.js';
+import { ErrorRatchet } from './error-ratchet.js';
+import { LoggerLevelName } from '../logger/logger-level-name.js';
+export class ExpiringObject {
+    _config;
+    _cacheObject;
+    _lastUpdatedEpochMS;
+    _timeRemainingMS;
+    constructor(inputConfig) {
+        this._config = Object.assign({}, this.defaultConfig(), inputConfig || {});
+        if (this._config.overrideTimeRemainingMS && this._config.timeToLiveMS) {
+            ErrorRatchet.throwFormattedErr('Cannot define both time to live and overrideTimeRemainingMS');
+        }
+        if (!this._config.overrideTimeRemainingMS && !this._config.timeToLiveMS) {
+            ErrorRatchet.throwFormattedErr('Must define exactly one of timeToLiveMS or overrideTimeRemainingMS');
+        }
+        if (this._config.initialValue) {
+            this.update(this._config.initialValue);
+        }
+        this._timeRemainingMS = this._config.overrideTimeRemainingMS || this.defaultTimeRemainingMS;
+    }
+    defaultConfig() {
+        const rval = {
+            generator: null,
+            initialValue: null,
+            logLevel: LoggerLevelName.debug,
+            overrideTimeRemainingMS: null,
+            timeToLiveMS: 1_000 * 60,
+        };
+        return rval;
+    }
+    async defaultTimeRemainingMS(lastUpdatedEpochMS) {
+        let rval = 0;
+        if (lastUpdatedEpochMS) {
+            const ageMS = new Date().getTime() - lastUpdatedEpochMS;
+            rval = Math.max(0, this._config.timeToLiveMS - ageMS);
+        }
+        return rval;
+    }
+    update(newValue, doNotUpdateClock = false) {
+        this._cacheObject = newValue;
+        if (!doNotUpdateClock) {
+            this._lastUpdatedEpochMS = new Date().getTime();
+        }
+        Logger.logByLevel(this._config.logLevel, 'Updated cache value to %j', newValue);
+    }
+    async fetchCacheObjectTimeRemainingMS() {
+        return this._timeRemainingMS(this._lastUpdatedEpochMS);
+    }
+    async fetch() {
+        const remainMS = await this._timeRemainingMS(this._lastUpdatedEpochMS);
+        if (!remainMS) {
+            this._cacheObject = null;
+            this._lastUpdatedEpochMS = null;
+        }
+        if (!this._cacheObject) {
+            if (this._config.generator) {
+                const newValue = await this._config.generator();
+                Logger.logByLevel(this._config.logLevel, 'Auto call to generator returned %j', newValue);
+                this.update(newValue);
+            }
+        }
+        return this._cacheObject;
+    }
+}
+export class ExpiringObjectConfig {
+    timeToLiveMS;
+    generator;
+    initialValue;
+    logLevel;
+    overrideTimeRemainingMS;
+}
+//# sourceMappingURL=expiring-object.js.map

package/lib/lang/expiring-object.js.map

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

package/lib/lang/geolocation-ratchet.d.ts

@@ -0,0 +1,40 @@
+export declare class GeolocationRatchet {
+    private constructor();
+    static distanceBetweenLocations(lat1: number, lon1: number, lat2: number, lon2: number, unit?: string): number;
+    static distanceBetweenRatchetGeoLocations(loc1: RatchetGeoLocation, loc2: RatchetGeoLocation, unit?: string): number;
+    static degreeOfLatLngInMiles(latitudeInDecimalDegress?: number): number;
+    static milesInDegLatLng(miles: number, latitudeInDecimalDegress?: number): number;
+    static centerOfBounds(bounds: RatchetLocationBounds): RatchetGeoLocation;
+    private static calculateSplits;
+    static clusterGeoBounds(inputVal: RatchetLocationBounds[], latSlices?: number, lngSlices?: number): RatchetLocationBounds[];
+    static canonicalizeBounds(inp: RatchetLocationBounds, allowCrossover?: boolean): RatchetLocationBounds;
+    static combineBounds(inp: RatchetLocationBounds[]): RatchetLocationBounds;
+    static roundLocation(r: RatchetGeoLocation, roundDigits: number): RatchetGeoLocation;
+    static locationToBounds(loc: RatchetGeoLocation, radiusMiles: number): RatchetLocationBounds;
+    static sameLocation(loc1: RatchetGeoLocation, loc2: RatchetGeoLocation): boolean;
+    static pointInBounds(pt: RatchetGeoLocation, bound: RatchetLocationBounds): boolean;
+    static pointInAnyBound(pt: RatchetGeoLocation, inBounds: RatchetLocationBounds[], minPointsBeforeMapping?: number): boolean;
+    static pointInRatchetLocationBoundsMap(pt: RatchetGeoLocation, mp: RatchetLocationBoundsMap): boolean;
+    static findRatchetLocationBoundsMapEntry(pt: RatchetGeoLocation, mp: RatchetLocationBoundsMap): RatchetLocationBoundsMapEntry;
+    static buildRatchetLocationBoundsMap(inBounds: RatchetLocationBounds[]): RatchetLocationBoundsMap;
+}
+export interface RatchetGeoLocation {
+    lat: number;
+    lng: number;
+}
+export interface RatchetLocationBounds {
+    origin: RatchetGeoLocation;
+    extent: RatchetGeoLocation;
+}
+export interface RatchetLocationBoundsMap {
+    latOffset: number;
+    lngOffset: number;
+    maxLat: number;
+    maxLng: number;
+    mapping: RatchetLocationBoundsMapEntry[][];
+}
+export interface RatchetLocationBoundsMapEntry {
+    lat: number;
+    lng: number;
+    bounds: RatchetLocationBounds[];
+}