@kwiz/common 1.0.1

package/src/helpers/objects.ts

@@ -0,0 +1,256 @@
+import { makeUniqueArray } from "./collections.base";
+import { jsonParse } from "./json";
+import { isDate, isFunction, isNotEmptyArray, isNullOrEmptyString, isNullOrUndefined, isObject, isPrimitiveValue, primitiveTypes } from "./typecheckers";
+
+/** global window, safe for testing and environments without a browser */
+export var $w = typeof window === "undefined" ? {
+    setTimeout: setTimeout,
+    clearTimeout: clearTimeout
+} as any as Window : window;
+
+/** wrapper for hasOwnProperty that satisfies https://eslint.org/docs/latest/rules/no-prototype-builtins */
+export function hasOwnProperty(obj: any, prop: string) {
+    if (!isNullOrUndefined(obj)) {
+        return Object.prototype.hasOwnProperty.call(obj, prop);
+    }
+    return false;
+}
+
+/* eslint-disable-next-line @typescript-eslint/no-empty-function */
+export var noop = async () => { };
+
+/** get or create kwizcom object from top window or current window, set allowFromTop if you want to try to get from window.top */
+export function getKWizComGlobal(allowFromTop?: boolean) {
+    if (allowFromTop) {
+        try {
+            $w.top["kwizcom"] = $w.top["kwizcom"] || {};
+            return $w.top["kwizcom"] as IKWizComGlobals;
+        } catch (ex) { }
+    }
+    $w["kwizcom"] = $w["kwizcom"] || {};
+    return $w["kwizcom"] as IKWizComGlobals;
+}
+/** get or create kwizcom.globals dictionary from top window or current window. Add or return key:name initialize as defaults or blank object if does not already exist */
+export function getGlobal<T>(name: string, defaults?: T, notFromTop?: boolean) {
+    var kGlobal = getKWizComGlobal(notFromTop !== true);
+    kGlobal.globals = kGlobal.globals || {};
+
+    if (!kGlobal.globals[name]) {
+        if (isObject(defaults)) {
+            // eslint-disable-next-line @typescript-eslint/ban-types
+            kGlobal.globals[name] = { ...(defaults as object) };
+        } else {
+            kGlobal.globals[name] = {};
+        }
+    }
+    return kGlobal.globals[name] as T;
+}
+
+/**
+ * Automatically bind all functions of instance to instance
+ * Note: if you use knockout, you should skip ko.isObservable
+ * @param instance
+ */
+//eslint-disable-next-line @typescript-eslint/ban-types
+export function autoBind(instance: any, skip?: (name: string, f: Function) => boolean) {
+    let funcitonNames = getAllFunctionNames(instance, 1);
+    funcitonNames.forEach(prop => {
+        const val = instance[prop];
+        if (!isFunction(skip) || !skip(prop, val))
+            instance[prop] = val.bind(instance);
+    });
+}
+
+/** Implements Object.assign which does not exist in IE
+ *  Copies properties over from overrides into original object
+ *  Merge default and override settings: var merged = assign({},defaults,props)
+ *  Create deep copy of object by var copy = assign({},obj) */
+export function assign<T>(original: Partial<T>, ...overrides: Partial<T>[]): T {
+    if (original === undefined || original === null) {
+        throw new TypeError('Cannot convert first argument to object');
+    }
+
+    var to = Object(original);
+    if (overrides && overrides.length > 0)
+        overrides.forEach(o => {
+            if (!isNullOrUndefined(o)) {
+                var keysArray = Object.keys(Object(o));
+                for (var nextIndex = 0, len = keysArray.length; nextIndex < len; nextIndex++) {
+                    var nextKey = keysArray[nextIndex];
+                    var desc = Object.getOwnPropertyDescriptor(o, nextKey);
+                    if (typeof (desc.value) === "undefined" || desc.value === null) {
+                        to[nextKey] = desc.value;
+                    }
+                    else if (typeof (desc.value) === "object") {
+                        //reference type, call assign  recursively. fixed problem that object value types from overrides were modified when the returnd object was modified.
+                        if (!Array.isArray(desc.value)) {
+                            to[nextKey] = assign({}, desc.value);
+                        } else {
+                            to[nextKey] = assign([], desc.value);
+                        }
+                    } else {
+                        if (desc !== undefined && desc.enumerable) {
+                            to[nextKey] = desc.value;//this will make a shallow copy, altering the override object o[nextKey];
+                        }
+                    }
+                }
+            }
+        });
+    return to as T;
+}
+
+export function primitivesEqual(o1: primitiveTypes, o2: primitiveTypes) {
+    let normalize = (oo: any) => {
+        if (isNullOrEmptyString(oo))
+            return null;
+        else if (isDate(oo))
+            return oo.getTime();
+        return oo;
+    };
+    o1 = normalize(o1);
+    o2 = normalize(o2);
+
+    return o1 === o2;
+}
+export function objectsEqual<T extends object>(o1: T, o2: T, ignoreKeys?: string[]) {
+    let isPrimitive1 = isPrimitiveValue(o1);
+    let isPrimitive2 = isPrimitiveValue(o2);
+
+    if (isPrimitive1 !== isPrimitive2) return false;//one primitive other not?
+    if (isPrimitive1)
+        return primitivesEqual(o1 as unknown as primitiveTypes, o2 as unknown as primitiveTypes);
+
+    if (isFunction(o1) || isFunction(o2)) {
+        try {
+            return o1.toString() === o2.toString();
+        } catch (e) {
+            return false;
+        }
+    }
+
+    ignoreKeys = ignoreKeys || [];
+    let allKeys = makeUniqueArray(Object.keys(o1).concat(Object.keys(o2))).filter(key => !ignoreKeys.includes(key));
+    for (let i = 0; i < allKeys.length; i++) {
+        let key = allKeys[i];
+        if (!objectsEqual(o1[key], o2[key], ignoreKeys))
+            return false;
+    }
+    return true;
+}
+export function jsonClone<T>(obj: T): T {
+    //todo: check if assign utility method is faster
+    if (isNullOrUndefined(obj)) return null;
+    let result = obj;
+    try { result = jsonParse<T>(JSON.stringify(obj)); }
+    catch (e) {
+        if (isNotEmptyArray(obj))
+            result = (obj as any).slice();
+        else
+            result = obj;
+    }
+
+    //clone date objects
+    try { cloneDatesOnObjectRecursivily(obj, result); } catch (e) { }
+    return result;
+}
+
+function cloneDatesOnObjectRecursivily(obj1, obj2) {
+    Object.keys(obj1).forEach(key => {
+        let v = obj1[key];
+        if (v === null)
+            obj2[key] = null;
+        else if (isDate(v))
+            obj2[key] = new Date(v.getTime());
+        else if (isObject(v) && Object.keys(v).length) {
+            let v2 = obj2[key];
+            if (isObject(v2))
+                cloneDatesOnObjectRecursivily(v, v2);
+        }
+    });
+}
+
+/** if an object in this path doesnt exist under parent - creates it.*/
+export function ensureObjectPath(objectPath: string, defaultValue: any = {}, parent: any = $w) {
+    if (isNullOrEmptyString(objectPath)) return;
+    let parts = objectPath.split('.');
+    for (let i = 0; i < parts.length; i++) {
+        let partName = parts[i];
+        if (i === parts.length - 1)//last
+        {
+            if (isNullOrUndefined(parent[partName]))
+                parent[partName] = defaultValue;
+        }
+        else {
+            if (isNullOrUndefined(parent[partName]))
+                parent[partName] = {};
+            parent = parent[partName];
+        }
+    }
+}
+
+/** If o has propb and not propa - will copy propb into propa and remove propb */
+export function keepOne(o: any, propa: string, propb: string) {
+    /* using the unkown type doesn't work in modern apps project */
+    if (isObject(o)) {
+        if (!hasOwnProperty(o, propa) && hasOwnProperty(o, propb)) {
+            o[propa] = o[propb];
+            delete o[propb];
+        }
+    }
+}
+
+/**return all members and functions of an object, including inherited ones from its base class, excluding the constructor
+ * send prototypeLevels to limit the number of prototype climbs to get functions from. 0 means unlimited.
+ */
+export function getAllMemberNames(instance: any, prototypeLevels: number): string[] {
+    let props: string[] = [];
+    let obj = instance;
+    let level = 0;
+    let unlimitedLevels = prototypeLevels < 0;
+
+    do {
+        props.push(...Object.getOwnPropertyNames(obj));
+        obj = Object.getPrototypeOf(obj);
+        level++;
+    }
+    while (unlimitedLevels ? !!obj : !!obj && level <= prototypeLevels);
+
+    return makeUniqueArray(props.filter(p => p !== 'constructor' && p !== 'dispose'));
+}
+/**return all functions of an object, including inherited ones from its base class, excluding the constructor
+ * send prototypeLevels to limit the number of prototype climbs to get functions from. 0 means unlimited.
+ */
+export function getAllFunctionNames(instance: any, prototypeLevels: number): string[] {
+    return getAllMemberNames(instance, prototypeLevels).filter(p => isFunction(instance[p]));
+}
+
+/** generic implementation of Object.values */
+export function objectValues<T = any>(obj: any): T[] {
+    return Object.keys(obj).map((key) => {
+        return obj[key];
+    }) as T[];
+}
+
+class DefaultProp<T>{
+    private _value: T;
+    private _defaultValue: T | (() => T);
+    private isValid: (value: T) => boolean;
+    public set value(newValue: T) { this._value = newValue; }
+    public get value() {
+        if (!this.isValid(this._value)) {
+            this._value = isFunction(this._defaultValue)
+                ? (this._defaultValue as () => T)()
+                : this._defaultValue;
+        }
+        return this._value;
+    }
+    public constructor(defaultValue: T | (() => T), initialValue?: T, isValid?: (value: T) => boolean) {
+        this._defaultValue = defaultValue;
+        this._value = initialValue;
+        this.isValid = isFunction(isValid) ? isValid : v => !isNullOrUndefined(v);
+    }
+}
+/** creates a safe property, if the value is null/undefined or empty string - it will return the default value. */
+export function GetDefaultProp<T>(defaultValue: T | (() => T), initialValue?: T, isValid?: (value: T) => boolean) {
+    return new DefaultProp(defaultValue, initialValue, isValid);
+}

package/src/helpers/promises.test.js

@@ -0,0 +1,18 @@
+import assert from 'assert/strict';
+import test from 'node:test';
+import { promiseOnce } from './promises';
+
+
+test('promiseOnce', async t => {
+    var promiseOnceTester = promiseOnce("promiseOnceTester", async () => {
+        return Date.now();
+    });
+
+    let value = await promiseOnceTester;
+    await t.test("First call", t => assert.strictEqual(value > 0, true));
+    //check cache
+    let value2 = await promiseOnceTester;
+    await t.test("Second call", t => assert.strictEqual(value === value2, true));
+    let value3 = await promiseOnceTester;
+    await t.test("Third call", t => assert.strictEqual(value === value3, true));
+});

package/src/helpers/promises.ts

@@ -0,0 +1,102 @@
+import { IDictionary } from "./_dependencies";
+import { hasOwnProperty } from "./objects";
+import { isFunction, isNullOrUndefined, isNumeric } from "./typecheckers";
+
+var promises: IDictionary<Promise<any>> = {};
+/** key has to be unique for the promise name + its parameters
+ * Usage: export var initTests = promiseOnce("initTests", async () => { ... });
+ * Usage with variables:
+ * function DiscoverTenantInfo(hostName: string) {
+ *    return promiseOnce(`DiscoverTenantInfo|${hostName}`, async () => {...});
+ * }
+ */
+export async function promiseOnce<T>(key: string, promise: () => Promise<T>, isValidResult?: (result: T) => Promise<boolean>): Promise<T> {
+    if (hasOwnProperty(promises, key) && isFunction(isValidResult)) {
+        //we have en existing pending promise...
+        let queuedResult: T = null;
+        try { queuedResult = await promises[key]; } catch (e) { }
+        if ((await isValidResult(queuedResult)) !== true)
+            delete promises[key];
+    }
+
+
+    if (!hasOwnProperty(promises, key)) {
+        promises[key] = promise();
+    }
+    return promises[key];
+}
+
+export function promiseAllSequential<T = any>(asyncFuncs: (() => Promise<T>)[]): Promise<T[]> {
+    if (!Array.isArray(asyncFuncs) || !asyncFuncs.length) {
+        return Promise.resolve([]);
+    }
+    return asyncFuncs.reduce((promiseChain, currentTaskcurrentTask) => (
+        promiseChain.then((result) => {
+            let taskResult = currentTaskcurrentTask();
+            if (isNullOrUndefined(taskResult) || !isFunction(taskResult.then))//culprit - found one that did not return a promise?! make one.
+                taskResult = Promise.resolve() as any as Promise<T>;
+
+            return taskResult.then(Array.prototype.concat.bind(result));
+        })
+    ), Promise.resolve([]));
+}
+
+export function promiseNParallel<T>(asyncFuncs: (() => Promise<T>)[], maxParallel?: number): Promise<T[]> {
+    if (!Array.isArray(asyncFuncs) || !asyncFuncs.length) {
+        return Promise.resolve([]);
+    }
+    if (!isNumeric(maxParallel)) {
+        maxParallel = asyncFuncs.length;
+    }
+
+    var startChain = () => {
+        var chainData = [];
+
+        if (asyncFuncs.length) {
+            let next = (data: T) => {
+                chainData.push(data);
+                return asyncFuncs.length ? (asyncFuncs.shift())().then(next) : chainData;
+            };
+            return (asyncFuncs.shift())().then(next);
+        } else {
+            return Promise.resolve(chainData);
+        }
+    };
+
+    var chains = [];
+    for (var k = 0; k < maxParallel; k += 1) {
+        chains.push(startChain());
+    }
+
+    return Promise.all(chains).then(d => {
+        //flatten results
+        return d.reduce((acc, val) => acc.concat(val), []);
+    });
+}
+
+/** provides an asnyc sleep function that allows you to delay async/wait calls  */
+export function sleepAsync(seconds?: number): Promise<void> {
+    return new Promise(resolve => {
+        window.setTimeout(() => resolve(), seconds > 0 ? seconds * 1000 : 3000);
+    });
+}
+
+/** provides the ability to retry an async function n times with a optional delay between calls */
+export async function retryAsync<T>(fn: (...args) => Promise<T>, numberOfRetries: number, seconds = 1) {
+    let error: Error = null;
+
+    for (let i = 0; i < numberOfRetries; i++) {
+        try {
+            error = null;
+            await sleepAsync(i === 0 ? 0 : seconds);
+            return await fn();
+        } catch (ex) {
+            error = ex;
+        }
+    }
+
+    if (error) {
+        throw error;
+    }
+    throw new Error(`Failed retrying ${numberOfRetries} times`);
+}

package/src/helpers/random.ts

@@ -0,0 +1,27 @@
+export function getRandomId() {
+    return Date.now().toString(36) + Math.random().toString(36).substring(2);
+}
+
+export function getUniqueId() {
+    var _s_hexcode = ["0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "a", "b", "c", "d", "e", "f"];
+    for (var a = "", c = 0; c < 32; c++) {
+        var b = Math.floor(Math.random() * 16);
+        switch (c) {
+            case 8:
+                a += "-";
+                break;
+            case 12:
+                b = 4;
+                a += "-";
+                break;
+            case 16:
+                b = b & 3 | 8;
+                a += "-";
+                break;
+            case 20:
+                a += "-";
+        }
+        a += _s_hexcode[b];
+    }
+    return a;
+}

package/src/helpers/scheduler/scheduler.test.js

@@ -0,0 +1,104 @@
+import assert from 'assert/strict';
+import test from 'node:test';
+import { isValidSchedule, getNextUTC } from "./scheduler";
+import { ScheduleTypes } from './scheduler';
+
+var startDate = "2020-01-01T05:00Z";
+var invalidOutput = "9999999999";
+var schedules = [
+    { schedule: {}, output: invalidOutput, valid: false },
+    { schedule: { ScheduleType: "x" }, output: invalidOutput, valid: false },
+    {
+        schedule: {
+            ScheduleType: ScheduleTypes.hourly,
+            interval: 24
+        }, output: invalidOutput, valid: false
+    },
+    {
+        name: "move 2 hours",
+        schedule: {
+            ScheduleType: ScheduleTypes.hourly,
+            interval: 2
+        }, output: "2020010107", valid: true
+    },
+    {
+        schedule: {
+            ScheduleType: ScheduleTypes.daily,
+            hours: []
+        }, output: invalidOutput, valid: false
+    },
+    {
+        schedule: {
+            ScheduleType: ScheduleTypes.daily,
+            hours: [5, 2, 9, 26]
+        }, output: invalidOutput, valid: false
+    },
+    {
+        name: "move to next hour in same day",
+        schedule: {
+            ScheduleType: ScheduleTypes.daily,
+            hours: [5, 2, 9, 22]
+        }, output: "2020010109", valid: true
+    },
+    {
+        name: "passed last hour, move to next day",
+        schedule: {
+            ScheduleType: ScheduleTypes.daily,
+            hours: [3, 1, 5, 2]
+        }, output: "2020010201", valid: true
+    },
+    {
+        schedule: {
+            ScheduleType: ScheduleTypes.weekly,
+            hours: []
+        }, output: invalidOutput, valid: false
+    },
+    {
+        schedule: {
+            ScheduleType: ScheduleTypes.weekly,
+            hours: [5, 2, 9, 26],
+            days: [2],
+        }, output: invalidOutput, valid: false
+    },
+    {
+        schedule: {
+            ScheduleType: ScheduleTypes.weekly,
+            hours: [5, 2, 9, 22],
+            days: [5, 2, 7]
+        }, output: invalidOutput, valid: false
+    },
+    {
+        name: "day is no ok, move to next day first hour",
+        schedule: {
+            ScheduleType: ScheduleTypes.weekly,
+            hours: [5, 2, 9, 22],
+            days: [5, 2, 4]
+        }, output: "2020010202", valid: true
+    },
+    {
+        name: "day is not ok, move to first day in next week",
+        schedule: {
+            ScheduleType: ScheduleTypes.weekly,
+            hours: [5, 2, 9, 22],
+            days: [2, 0, 1]
+        }, output: "2020010502", valid: true
+    },
+    {
+        name: "day is ok, move to next hour",
+        schedule: {
+            ScheduleType: ScheduleTypes.weekly,
+            hours: [5, 2, 9, 22],
+            days: [5, 2, 3, 4]
+        }, output: "2020010109", valid: true
+    }
+];
+
+
+test('isValidSchedule', t => {
+    schedules.forEach(s => assert.strictEqual(isValidSchedule(s.schedule), s.valid));
+});
+
+test('getNextUTC', async t => {
+    let date = new Date(startDate);
+    schedules.forEach(s => assert.strictEqual(getNextUTC(date, s.schedule), s.output));
+});

package/src/helpers/scheduler/scheduler.ts

@@ -0,0 +1,132 @@
+import { firstOrNull, sortNumberArrayAsc } from "../collections.base";
+import { cloneDate } from "../date";
+import { padLeft } from "../strings";
+import { isNotEmptyArray, isNullOrUndefined } from "../typecheckers";
+
+export type hourlyInterval = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
+export type hours = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23;
+export type days = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+
+export enum ScheduleTypes {
+    hourly = "hourly",
+    daily = "daily",
+    weekly = "weekly"
+}
+
+export const ScheduleTypesDefinitions: { [Name: string]: { title: string, value: ScheduleTypes }; } = {
+    weekly: {
+        value: ScheduleTypes.weekly,
+        title: "Run on specific days, at specific times"
+    },
+    daily: {
+        value: ScheduleTypes.daily,
+        title: "Run every day, at specific times"
+    },
+    hourly: {
+        value: ScheduleTypes.hourly,
+        title: "Run every few hours"
+    }
+};
+
+export interface IScheduleHourly {
+    ScheduleType: ScheduleTypes.hourly,
+    /** run every x number of hours */
+    interval: hourlyInterval;
+}
+export interface IScheduleDaily {
+    ScheduleType: ScheduleTypes.daily,
+    /** run every day, at these hours */
+    hours: hours[];
+}
+export interface IScheduleWeekly {
+    ScheduleType: ScheduleTypes.weekly,
+    /** run in the following days */
+    days: days[];
+    /** run at these hours */
+    hours: hours[];
+}
+
+export type TypeSchedule = IScheduleHourly | IScheduleDaily | IScheduleWeekly;
+
+export const defaultWeeklySchedule: IScheduleWeekly = {
+    ScheduleType: ScheduleTypes.weekly,
+    days: [1, 2, 3, 4, 5],
+    hours: [0]
+};
+export const defaultDailySchedule: IScheduleDaily = {
+    ScheduleType: ScheduleTypes.daily,
+    hours: [0, 12]
+};
+export const defaultHourlySchedule: IScheduleHourly = {
+    ScheduleType: ScheduleTypes.hourly,
+    interval: 4
+};
+
+export function isValidSchedule(schedule: TypeSchedule) {
+    if (isNullOrUndefined(schedule)) return false;
+    if (schedule.ScheduleType === ScheduleTypes.hourly)
+        return schedule.interval > 0 && schedule.interval <= 12;
+    else if (schedule.ScheduleType === ScheduleTypes.daily) {
+        return isNotEmptyArray(schedule.hours) && schedule.hours.every(h => h >= 0 && h <= 23);
+    }
+    else if (schedule.ScheduleType === ScheduleTypes.weekly) {
+        return isNotEmptyArray(schedule.hours) && schedule.hours.every(h => h >= 0 && h <= 23)
+            && isNotEmptyArray(schedule.days) && schedule.days.every(d => d >= 0 && d <= 6);
+    }
+    else return false;
+}
+/** returns a yyyyMMddHH for the next time this schedule needs to run after the currentDate */
+export function getNextUTC(currentDate: Date, schedule: TypeSchedule): string {
+    if (!isValidSchedule(schedule)) return "9999999999";
+
+    currentDate = cloneDate(currentDate);
+
+    let date = currentDate.getUTCDate();
+    let hour = currentDate.getUTCHours();
+    let day = currentDate.getUTCDay() as days;
+
+    //adjust date based on selected schedule
+    if (schedule.ScheduleType === ScheduleTypes.hourly) {
+        hour += schedule.interval;
+        currentDate.setUTCHours(hour);
+    }
+    else if (schedule.ScheduleType === ScheduleTypes.daily) {
+        //get current hour, see if the next run is today or tomorrow
+        let sortedHours = schedule.hours.sort(sortNumberArrayAsc);
+        let nextHour = firstOrNull(sortedHours.filter(h => h > hour));
+        if (nextHour !== null) {
+            currentDate.setUTCHours(nextHour);
+        }
+        else {
+            //tomorrow at the first scheduled hour
+            currentDate.setUTCHours(sortedHours[0]);
+            currentDate.setUTCDate(date + 1);
+        }
+    }
+    else {
+        //implement weekly
+        let sortedDays = schedule.days.sort(sortNumberArrayAsc);
+        let sortedHours = schedule.hours.sort(sortNumberArrayAsc);
+        let nextHour = firstOrNull(sortedHours.filter(h => h > hour));
+        let nextDay = firstOrNull(sortedDays.filter(h => h > day));
+
+        if (sortedDays.includes(day) && nextHour !== null)//today is allowed
+        {
+            currentDate.setUTCHours(nextHour);
+        }
+        else//move to next allowed day, at first hour allowed
+        {
+            let daysToAdd = nextDay === null
+                ? 7 - day + sortedDays[0]
+                : nextDay - day;
+            currentDate.setUTCHours(sortedHours[0]);
+            currentDate.setUTCDate(date + daysToAdd);
+        }
+    }
+
+    return getUTCDateMarker(currentDate);
+}
+
+export function getUTCDateMarker(date: Date) {
+    return `${date.getUTCFullYear()}${padLeft(date.getUTCMonth() + 1, 2)}${padLeft(date.getUTCDate(), 2)}${padLeft(date.getUTCHours(), 2)}`;
+}