@kwiz/common 1.0.2 → 1.0.3

package/src/helpers/objects.ts

@@ -1,256 +0,0 @@
-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

@@ -1,18 +0,0 @@
-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

@@ -1,102 +0,0 @@
-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

@@ -1,27 +0,0 @@
-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

@@ -1,104 +0,0 @@
-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

@@ -1,132 +0,0 @@
-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)}`;
-}