tscommons-esm-async 0.0.2

package/dist/classes/commons-claim-pool.d.mts

@@ -0,0 +1,14 @@
+export declare class CommonsClaimPool<ResourceT = undefined> {
+    private maxClaimable;
+    private timeoutToClaim;
+    private active;
+    private pendingTimeouts;
+    private available;
+    private allocated;
+    constructor(maxClaimable: number, timeoutToClaim: number, resources?: ResourceT[]);
+    claim(): string | false;
+    getResource(uid: string): ResourceT;
+    claimOrPend(): Promise<string>;
+    free(uid: string): void;
+    runWithinPool<ReturnT = void>(callback: (resource?: ResourceT) => Promise<ReturnT>): Promise<ReturnT>;
+}

package/dist/classes/commons-claim-pool.mjs

@@ -0,0 +1,106 @@
+import { commonsArrayRemove, commonsBase62GenerateLongRandomId } from 'tscommons-esm-core';
+import { commonsAsyncAbortTimeout, commonsAsyncTimeout } from '../helpers/commons-async.mjs';
+export class CommonsClaimPool {
+    maxClaimable;
+    timeoutToClaim;
+    active = [];
+    pendingTimeouts = [];
+    available;
+    allocated = new Map();
+    constructor(maxClaimable, timeoutToClaim, resources) {
+        this.maxClaimable = maxClaimable;
+        this.timeoutToClaim = timeoutToClaim;
+        if (resources) {
+            if (resources.length !== maxClaimable)
+                throw new Error('Available resources does not match the max claimable');
+            this.available = [...resources];
+        }
+    }
+    claim() {
+        if (this.active.length >= this.maxClaimable)
+            return false;
+        const uid = commonsBase62GenerateLongRandomId();
+        this.active.push(uid);
+        if (this.available) {
+            const resource = this.available.shift();
+            if (!resource)
+                throw new Error('Assertion failure. No resource avaliable');
+            this.allocated.set(uid, resource);
+        }
+        return uid;
+    }
+    getResource(uid) {
+        if (!this.available)
+            throw new Error('Resources are not available');
+        if (!this.allocated.has(uid))
+            throw new Error('Resource has not been allocated to this uid');
+        return this.allocated.get(uid);
+    }
+    claimOrPend() {
+        const internalTimeoutUid = commonsBase62GenerateLongRandomId();
+        const internalSpinUid = commonsBase62GenerateLongRandomId();
+        return new Promise((resolve, reject) => {
+            let timedout = false;
+            void (async () => {
+                try {
+                    await commonsAsyncTimeout(this.timeoutToClaim, internalTimeoutUid);
+                }
+                catch (_e) {
+                    // do nothing
+                }
+                timedout = true;
+                commonsAsyncAbortTimeout(internalSpinUid);
+            })();
+            void (async () => {
+                while (!timedout) {
+                    const uid = this.claim();
+                    if (uid) {
+                        commonsAsyncAbortTimeout(internalTimeoutUid);
+                        commonsAsyncAbortTimeout(internalSpinUid);
+                        resolve(uid);
+                        return;
+                    }
+                    try {
+                        await commonsAsyncTimeout(100, internalSpinUid); // 100ms spin
+                    }
+                    catch (_e) {
+                        // do nothing
+                    }
+                }
+                reject(new Error('Timeout pending to claim a pool space'));
+            })();
+        });
+    }
+    free(uid) {
+        commonsArrayRemove(this.active, uid);
+        if (this.available) {
+            try {
+                const existing = this.getResource(uid);
+                this.allocated.delete(uid);
+                this.available.push(existing);
+            }
+            catch (_e) {
+                // ignore
+            }
+        }
+        for (const pendingTimeout of this.pendingTimeouts) {
+            commonsAsyncAbortTimeout(pendingTimeout);
+        }
+    }
+    async runWithinPool(callback) {
+        const uid = await this.claimOrPend();
+        try {
+            if (this.available) {
+                const resource = this.getResource(uid);
+                return await callback(resource);
+            }
+            else {
+                return await callback();
+            }
+        }
+        finally {
+            this.free(uid);
+        }
+    }
+}
+//# sourceMappingURL=commons-claim-pool.mjs.map

package/dist/classes/commons-claim-pool.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"commons-claim-pool.mjs","sourceRoot":"","sources":["../../src/classes/commons-claim-pool.mts"],"names":[],"mappings":"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"}

package/dist/classes/commons-memory-observable.d.mts

@@ -0,0 +1,7 @@
+import { Observable } from 'rxjs';
+export declare class CommonsMemoryObservable<T> {
+    private observable;
+    private value;
+    constructor(observable: Observable<T>, value: T);
+    get(): T;
+}

package/dist/classes/commons-memory-observable.mjs

@@ -0,0 +1,16 @@
+export class CommonsMemoryObservable {
+    observable;
+    value;
+    constructor(observable, value) {
+        this.observable = observable;
+        this.value = value;
+        this.observable
+            .subscribe((v) => {
+            this.value = v;
+        });
+    }
+    get() {
+        return this.value;
+    }
+}
+//# sourceMappingURL=commons-memory-observable.mjs.map

package/dist/classes/commons-memory-observable.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"commons-memory-observable.mjs","sourceRoot":"","sources":["../../src/classes/commons-memory-observable.mts"],"names":[],"mappings":"AAEA,MAAM,OAAO,uBAAuB;IAEzB;IACA;IAFV,YACU,UAAyB,EACzB,KAAQ;QADR,eAAU,GAAV,UAAU,CAAe;QACzB,UAAK,GAAL,KAAK,CAAG;QAEjB,IAAI,CAAC,UAAU;aACZ,SAAS,CACR,CAAC,CAAI,EAAQ,EAAE;YACd,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QAChB,CAAC,CACF,CAAC;IACL,CAAC;IAEM,GAAG;QACT,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;CACD"}

package/dist/classes/commons-schedule.d.mts

@@ -0,0 +1,14 @@
+import { TCommonsScheduleTime } from '../types/tcommons-schedule-time.mjs';
+export declare class CommonsSchedule {
+    private id;
+    private static doesMatchSchedule;
+    private schedules;
+    private isRunning;
+    constructor(id: string);
+    schedule(at: TCommonsScheduleTime, callback: () => Promise<void>, id?: string): void;
+    clearSchedule(id: string): void;
+    private dispatch;
+    start(): boolean;
+    stop(): boolean;
+    parse<T>(json: unknown[], toAction: (_: string) => T | undefined, callback: (_: T) => Promise<void>): void;
+}

package/dist/classes/commons-schedule.mjs

@@ -0,0 +1,131 @@
+import { commonsBase62GenerateRandomId, commonsTypeIsNumberArray } from 'tscommons-esm-core';
+import { commonsAsyncInterval, commonsAsyncAbortInterval } from '../helpers/commons-async.mjs';
+import { isTCommonsSchedule } from '../types/tcommons-schedule.mjs';
+import { ECommonsInvocation } from '../enums/ecommons-invocation.mjs';
+export class CommonsSchedule {
+    id;
+    static doesMatchSchedule(test, at) {
+        const years = [];
+        if (at.year !== undefined) {
+            if (commonsTypeIsNumberArray(at.year))
+                years.push(...at.year);
+            else
+                years.push(at.year);
+        }
+        if (years.length > 0 && !years.includes(test.getFullYear()))
+            return false;
+        const months = [];
+        if (at.month !== undefined) {
+            if (commonsTypeIsNumberArray(at.month))
+                months.push(...at.month);
+            else
+                months.push(at.month);
+        }
+        if (months.length > 0 && !months.includes(test.getMonth()))
+            return false;
+        const days = [];
+        if (at.day !== undefined) {
+            if (commonsTypeIsNumberArray(at.day))
+                days.push(...at.day);
+            else
+                days.push(at.day);
+        }
+        if (days.length > 0 && !days.includes(test.getDate()))
+            return false;
+        const dows = [];
+        if (at.dow !== undefined) {
+            if (commonsTypeIsNumberArray(at.dow))
+                dows.push(...at.dow);
+            else
+                dows.push(at.dow);
+        }
+        if (dows.length > 0 && !dows.includes(test.getDay()))
+            return false;
+        const hours = [];
+        if (at.hour !== undefined) {
+            if (commonsTypeIsNumberArray(at.hour))
+                hours.push(...at.hour);
+            else
+                hours.push(at.hour);
+        }
+        if (hours.length > 0 && !hours.includes(test.getHours()))
+            return false;
+        const minutes = [];
+        if (at.minute !== undefined) {
+            if (commonsTypeIsNumberArray(at.minute))
+                minutes.push(...at.minute);
+            else
+                minutes.push(at.minute);
+        }
+        if (minutes.length > 0 && !minutes.includes(test.getMinutes()))
+            return false;
+        const seconds = [];
+        if (at.second !== undefined) {
+            if (commonsTypeIsNumberArray(at.second))
+                seconds.push(...at.second);
+            else
+                seconds.push(at.second);
+        }
+        if (seconds.length > 0 && !seconds.includes(test.getSeconds()))
+            return false;
+        return true;
+    }
+    schedules = new Map();
+    isRunning = false;
+    constructor(id) {
+        this.id = id;
+    }
+    schedule(at, callback, id) {
+        if (id && this.schedules.has(id))
+            this.clearSchedule(id);
+        if (!id)
+            id = commonsBase62GenerateRandomId();
+        const schedule = {
+            at: at,
+            callback: callback
+        };
+        this.schedules.set(id, schedule);
+    }
+    clearSchedule(id) {
+        this.schedules.delete(id);
+    }
+    dispatch() {
+        const now = new Date();
+        for (const schedule of Array.from(this.schedules.values())) {
+            if (!CommonsSchedule.doesMatchSchedule(now, schedule.at))
+                continue;
+            void (async () => {
+                await schedule.callback();
+            })();
+        }
+    }
+    start() {
+        if (this.isRunning)
+            return false;
+        commonsAsyncInterval(1000, ECommonsInvocation.FIXED, 
+        // eslint-disable-next-line @typescript-eslint/require-await
+        async () => {
+            this.dispatch();
+        }, `schedule_${this.id}`);
+        return true;
+    }
+    stop() {
+        if (!this.isRunning)
+            return false;
+        commonsAsyncAbortInterval(`schedule_${this.id}`);
+        return true;
+    }
+    parse(json, toAction, callback) {
+        for (const schedule of json) {
+            if (!isTCommonsSchedule(schedule))
+                throw new Error('Schedule JSON contains an invalid entry');
+            const action = toAction(schedule.action);
+            if (action === undefined)
+                throw new Error('Schedule JSON contains an invalid action');
+            this.schedule(schedule.at, async () => {
+                await callback(action);
+            });
+        }
+    }
+}
+//# sourceMappingURL=commons-schedule.mjs.map

package/dist/classes/commons-schedule.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"commons-schedule.mjs","sourceRoot":"","sources":["../../src/classes/commons-schedule.mts"],"names":[],"mappings":"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"}

package/dist/classes/commons-state-thread.d.mts

@@ -0,0 +1,17 @@
+import { ICommonsStateful } from '../interfaces/icommons-stateful.mjs';
+import { ECommonsRunState } from '../enums/ecommons-run-state.mjs';
+export declare abstract class CommonsStateThread implements ICommonsStateful {
+    static maximumTimeoutThread(timeout: number, callback: (stateful: ICommonsStateful) => Promise<void>): Promise<boolean>;
+    private state;
+    private timedOut;
+    private aborted;
+    private error;
+    constructor();
+    getState(): ECommonsRunState;
+    protected abstract run(): Promise<void>;
+    isAborted(): boolean;
+    isTimedOut(): boolean;
+    getError(): Error | undefined;
+    start(timeout: number, changed?: () => void): void;
+    abort(): void;
+}

package/dist/classes/commons-state-thread.mjs

@@ -0,0 +1,91 @@
+import { commonsBase62GenerateRandomId } from 'tscommons-esm-core';
+import { commonsAsyncTimeout, commonsAsyncAbortTimeout } from '../helpers/commons-async.mjs';
+import { ECommonsRunState } from '../enums/ecommons-run-state.mjs';
+export class CommonsStateThread {
+    static async maximumTimeoutThread(timeout, callback) {
+        const thread = new (class extends CommonsStateThread {
+            async run() {
+                await callback(this);
+            }
+        })();
+        return new Promise((resolve, reject) => {
+            thread.start(timeout, () => {
+                switch (thread.getState()) {
+                    case ECommonsRunState.PRE: // never happens, but doesn't hurt
+                    case ECommonsRunState.RUNNING:
+                        return;
+                    case ECommonsRunState.ERROR:
+                        reject(thread.getError() || new Error('Unknown thread error'));
+                        return;
+                    case ECommonsRunState.COMPLETED:
+                        resolve(true);
+                        return;
+                    case ECommonsRunState.TIMEDOUT:
+                    case ECommonsRunState.ABORTED:
+                        resolve(false);
+                        return;
+                }
+                throw new Error('Unknown thread state');
+            });
+        });
+    }
+    state;
+    timedOut = false;
+    aborted = false;
+    error;
+    constructor() {
+        this.state = ECommonsRunState.PRE;
+    }
+    getState() {
+        return this.state;
+    }
+    isAborted() {
+        return this.aborted;
+    }
+    isTimedOut() {
+        return this.timedOut;
+    }
+    getError() {
+        return this.error;
+    }
+    start(timeout, changed) {
+        this.state = ECommonsRunState.RUNNING;
+        if (changed)
+            changed();
+        const internalId = commonsBase62GenerateRandomId();
+        void (async () => {
+            try {
+                await commonsAsyncTimeout(timeout, internalId);
+                this.timedOut = true;
+                this.abort();
+            }
+            catch (_) {
+                // abort timeout, so ignore
+            }
+        })();
+        void (async () => {
+            try {
+                await this.run();
+                if (this.timedOut)
+                    this.state = ECommonsRunState.TIMEDOUT;
+                else if (this.aborted)
+                    this.state = ECommonsRunState.ABORTED;
+                else
+                    this.state = ECommonsRunState.COMPLETED;
+            }
+            catch (e) {
+                this.error = e;
+                this.state = ECommonsRunState.ERROR;
+            }
+            finally {
+                commonsAsyncAbortTimeout(internalId);
+                if (changed)
+                    changed();
+            }
+        })();
+    }
+    abort() {
+        this.aborted = true;
+    }
+}
+//# sourceMappingURL=commons-state-thread.mjs.map

package/dist/classes/commons-state-thread.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"commons-state-thread.mjs","sourceRoot":"","sources":["../../src/classes/commons-state-thread.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAI7F,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,MAAM,OAAgB,kBAAkB;IAChC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CACtC,OAAe,EACf,QAAuD;QAExD,MAAM,MAAM,GAAuB,IAAI,CAAC,KAAM,SAAQ,kBAAkB;YAChE,KAAK,CAAC,GAAG;gBACf,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;SACD,CAAC,EAAE,CAAC;QAEL,OAAO,IAAI,OAAO,CAAC,CAAC,OAAqC,EAAE,MAA+B,EAAQ,EAAE;YACnG,MAAM,CAAC,KAAK,CACV,OAAO,EACP,GAAS,EAAE;gBACV,QAAQ,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;oBAC3B,KAAK,gBAAgB,CAAC,GAAG,CAAC,CAAC,kCAAkC;oBAC7D,KAAK,gBAAgB,CAAC,OAAO;wBAC5B,OAAO;oBACR,KAAK,gBAAgB,CAAC,KAAK;wBAC1B,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC;wBAC/D,OAAO;oBACR,KAAK,gBAAgB,CAAC,SAAS;wBAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;wBACd,OAAO;oBACR,KAAK,gBAAgB,CAAC,QAAQ,CAAC;oBAC/B,KAAK,gBAAgB,CAAC,OAAO;wBAC5B,OAAO,CAAC,KAAK,CAAC,CAAC;wBACf,OAAO;gBACT,CAAC;gBAED,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACzC,CAAC,CACF,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAmB;IAExB,QAAQ,GAAY,KAAK,CAAC;IAC1B,OAAO,GAAY,KAAK,CAAC;IACzB,KAAK,CAAkB;IAE/B;QACC,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC;IACnC,CAAC;IAEM,QAAQ;QACd,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAIM,SAAS;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAEM,UAAU;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAEM,QAAQ;QACd,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,OAAoB;QACjD,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC;QACtC,IAAI,OAAO;YAAE,OAAO,EAAE,CAAC;QAEvB,MAAM,UAAU,GAAG,6BAA6B,EAAE,CAAC;QAEnD,KAAK,CAAC,KAAK,IAAmB,EAAE;YAC/B,IAAI,CAAC;gBACJ,MAAM,mBAAmB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;gBAE/C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACrB,IAAI,CAAC,KAAK,EAAE,CAAC;YACd,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACZ,2BAA2B;YAC5B,CAAC;QACF,CAAC,CAAC,EAAE,CAAC;QAEL,KAAK,CAAC,KAAK,IAAmB,EAAE;YAC/B,IAAI,CAAC;gBACJ,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;gBAEjB,IAAI,IAAI,CAAC,QAAQ;oBAAE,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC;qBACrD,IAAI,IAAI,CAAC,OAAO;oBAAE,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC;;oBACxD,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,SAAS,CAAC;YAC9C,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACZ,IAAI,CAAC,KAAK,GAAG,CAAU,CAAC;gBACxB,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC;YACrC,CAAC;oBAAS,CAAC;gBACV,wBAAwB,CAAC,UAAU,CAAC,CAAC;gBACrC,IAAI,OAAO;oBAAE,OAAO,EAAE,CAAC;YACxB,CAAC;QACF,CAAC,CAAC,EAAE,CAAC;IACN,CAAC;IAEM,KAAK;QACX,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACrB,CAAC;CACD"}

package/dist/classes/commons-synchronised.d.mts

@@ -0,0 +1,6 @@
+import { ECommonsSynchronisedTimeoutAction } from '../enums/ecommons-synchronised-timeout-action.mjs';
+export declare class CommonsSynchronised {
+    private semaphores;
+    synchronised<T>(context: string, timeout: number, timeoutAction: ECommonsSynchronisedTimeoutAction, callback: (claimed?: boolean) => Promise<T>): Promise<T>;
+    attempt(context: string, timeout: number, timeoutAction: ECommonsSynchronisedTimeoutAction): Promise<boolean>;
+}

package/dist/classes/commons-synchronised.mjs

@@ -0,0 +1,43 @@
+import { CommonsSemaphore } from '../helpers/commons-semaphore.mjs';
+import { ECommonsSynchronisedTimeoutAction } from '../enums/ecommons-synchronised-timeout-action.mjs';
+export class CommonsSynchronised {
+    semaphores = new Map();
+    async synchronised(context, timeout, timeoutAction, callback // the ? is for backwards compatibility
+    ) {
+        if (!this.semaphores.has(context))
+            this.semaphores.set(context, new CommonsSemaphore());
+        const semaphore = this.semaphores.get(context);
+        let claimed = false;
+        try {
+            await semaphore.claim(timeout);
+            claimed = true;
+        }
+        catch (_e) {
+            claimed = false;
+        }
+        if (!claimed && timeoutAction === ECommonsSynchronisedTimeoutAction.ABORT)
+            throw new Error('Timeout on synchronised block');
+        try {
+            return await callback(claimed);
+        }
+        finally {
+            if (claimed)
+                semaphore.release();
+        }
+    }
+    attempt(context, timeout, timeoutAction) {
+        return new Promise((resolve, reject) => {
+            void (async () => {
+                try {
+                    await this.synchronised(context, timeout, timeoutAction, async (claimed) => {
+                        resolve(claimed || false); // the || false is just for typescript, as synchronised always returns boolean
+                    });
+                }
+                catch (e) {
+                    reject(e);
+                }
+            })();
+        });
+    }
+}
+//# sourceMappingURL=commons-synchronised.mjs.map

package/dist/classes/commons-synchronised.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"commons-synchronised.mjs","sourceRoot":"","sources":["../../src/classes/commons-synchronised.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,EAAE,iCAAiC,EAAE,MAAM,mDAAmD,CAAC;AAEtG,MAAM,OAAO,mBAAmB;IACvB,UAAU,GAAkC,IAAI,GAAG,EAA4B,CAAC;IAEjF,KAAK,CAAC,YAAY,CACvB,OAAe,EACf,OAAe,EACf,aAAgD,EAChD,QAA2C,CAAC,uCAAuC;;QAEpF,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,gBAAgB,EAAE,CAAC,CAAC;QACxF,MAAM,SAAS,GAAqB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;QAElE,IAAI,OAAO,GAAY,KAAK,CAAC;QAC7B,IAAI,CAAC;YACJ,MAAM,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC/B,OAAO,GAAG,IAAI,CAAC;QAChB,CAAC;QAAC,OAAO,EAAE,EAAE,CAAC;YACb,OAAO,GAAG,KAAK,CAAC;QACjB,CAAC;QAED,IAAI,CAAC,OAAO,IAAI,aAAa,KAAK,iCAAiC,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAE5H,IAAI,CAAC;YACJ,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;gBAAS,CAAC;YACV,IAAI,OAAO;gBAAE,SAAS,CAAC,OAAO,EAAE,CAAC;QAClC,CAAC;IACF,CAAC;IAEM,OAAO,CACZ,OAAe,EACf,OAAe,EACf,aAAgD;QAEjD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAmC,EAAE,MAA+B,EAAQ,EAAE;YACjG,KAAK,CAAC,KAAK,IAAmB,EAAE;gBAC/B,IAAI,CAAC;oBACJ,MAAM,IAAI,CAAC,YAAY,CACrB,OAAO,EACP,OAAO,EACP,aAAa,EACb,KAAK,EAAE,OAAiB,EAAiB,EAAE;wBAC1C,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,8EAA8E;oBAC1G,CAAC,CACF,CAAC;gBACH,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACZ,MAAM,CAAC,CAAU,CAAC,CAAC;gBACpB,CAAC;YACF,CAAC,CAAC,EAAE,CAAC;QACN,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}

package/dist/enums/ecommons-invocation.d.mts

@@ -0,0 +1,5 @@
+export declare enum ECommonsInvocation {
+    FIXED = "fixed",
+    WHEN = "when",
+    IF = "if"
+}

package/dist/enums/ecommons-invocation.mjs

@@ -0,0 +1,10 @@
+export var ECommonsInvocation;
+(function (ECommonsInvocation) {
+    // run as normal; cycle per interval
+    ECommonsInvocation["FIXED"] = "fixed";
+    // restart interval when cycle complete
+    ECommonsInvocation["WHEN"] = "when";
+    // only run cycle if last one complete
+    ECommonsInvocation["IF"] = "if";
+})(ECommonsInvocation || (ECommonsInvocation = {}));
+//# sourceMappingURL=ecommons-invocation.mjs.map

package/dist/enums/ecommons-invocation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecommons-invocation.mjs","sourceRoot":"","sources":["../../src/enums/ecommons-invocation.mts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,kBASX;AATD,WAAY,kBAAkB;IAC7B,oCAAoC;IACpC,qCAAe,CAAA;IAEf,uCAAuC;IACvC,mCAAa,CAAA;IAEb,sCAAsC;IACtC,+BAAS,CAAA;AACV,CAAC,EATW,kBAAkB,KAAlB,kBAAkB,QAS7B"}

package/dist/enums/ecommons-run-state.d.mts

@@ -0,0 +1,11 @@
+export declare enum ECommonsRunState {
+    PRE = "pre",
+    RUNNING = "running",
+    COMPLETED = "completed",
+    TIMEDOUT = "timedout",
+    ERROR = "error",
+    ABORTED = "aborted"
+}
+export declare function fromECommonsRunState(value: ECommonsRunState): string;
+export declare function toECommonsRunState(value: string): ECommonsRunState | undefined;
+export declare function isECommonsRunState(test: unknown): test is ECommonsRunState;

package/dist/enums/ecommons-run-state.mjs

@@ -0,0 +1,52 @@
+import { commonsTypeIsString } from 'tscommons-esm-core';
+export var ECommonsRunState;
+(function (ECommonsRunState) {
+    ECommonsRunState["PRE"] = "pre";
+    ECommonsRunState["RUNNING"] = "running";
+    ECommonsRunState["COMPLETED"] = "completed";
+    ECommonsRunState["TIMEDOUT"] = "timedout";
+    ECommonsRunState["ERROR"] = "error";
+    ECommonsRunState["ABORTED"] = "aborted";
+})(ECommonsRunState || (ECommonsRunState = {}));
+export function fromECommonsRunState(value) {
+    switch (value) {
+        case ECommonsRunState.PRE:
+            return ECommonsRunState.PRE.toString();
+        case ECommonsRunState.RUNNING:
+            return ECommonsRunState.RUNNING.toString();
+        case ECommonsRunState.COMPLETED:
+            return ECommonsRunState.COMPLETED.toString();
+        case ECommonsRunState.TIMEDOUT:
+            return ECommonsRunState.TIMEDOUT.toString();
+        case ECommonsRunState.ERROR:
+            return ECommonsRunState.ERROR.toString();
+        case ECommonsRunState.ABORTED:
+            return ECommonsRunState.ABORTED.toString();
+        default:
+            throw new Error('Unknown ECommonsRunState');
+    }
+}
+export function toECommonsRunState(value) {
+    switch (value.toLowerCase()) {
+        case ECommonsRunState.PRE.toString():
+            return ECommonsRunState.PRE;
+        case ECommonsRunState.RUNNING.toString():
+            return ECommonsRunState.RUNNING;
+        case ECommonsRunState.COMPLETED.toString():
+            return ECommonsRunState.COMPLETED;
+        case ECommonsRunState.TIMEDOUT.toString():
+            return ECommonsRunState.TIMEDOUT;
+        case ECommonsRunState.ERROR.toString():
+            return ECommonsRunState.ERROR;
+        case ECommonsRunState.ABORTED.toString():
+            return ECommonsRunState.ABORTED;
+        default:
+            return undefined;
+    }
+}
+export function isECommonsRunState(test) {
+    if (!commonsTypeIsString(test))
+        return false;
+    return toECommonsRunState(test) !== undefined;
+}
+//# sourceMappingURL=ecommons-run-state.mjs.map

package/dist/enums/ecommons-run-state.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecommons-run-state.mjs","sourceRoot":"","sources":["../../src/enums/ecommons-run-state.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,CAAN,IAAY,gBAOX;AAPD,WAAY,gBAAgB;IAC1B,+BAAW,CAAA;IACX,uCAAmB,CAAA;IACnB,2CAAuB,CAAA;IACvB,yCAAqB,CAAA;IACrB,mCAAe,CAAA;IACf,uCAAmB,CAAA;AACrB,CAAC,EAPW,gBAAgB,KAAhB,gBAAgB,QAO3B;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAuB;IAC3D,QAAQ,KAAK,EAAE,CAAC;QACf,KAAK,gBAAgB,CAAC,GAAG;YACxB,OAAO,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QACxC,KAAK,gBAAgB,CAAC,OAAO;YAC5B,OAAO,gBAAgB,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC5C,KAAK,gBAAgB,CAAC,SAAS;YAC9B,OAAO,gBAAgB,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;QAC9C,KAAK,gBAAgB,CAAC,QAAQ;YAC7B,OAAO,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC7C,KAAK,gBAAgB,CAAC,KAAK;YAC1B,OAAO,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC1C,KAAK,gBAAgB,CAAC,OAAO;YAC5B,OAAO,gBAAgB,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC5C;YACC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;AACF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC/C,QAAQ,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QAC7B,KAAK,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE;YACnC,OAAO,gBAAgB,CAAC,GAAG,CAAC;QAC7B,KAAK,gBAAgB,CAAC,OAAO,CAAC,QAAQ,EAAE;YACvC,OAAO,gBAAgB,CAAC,OAAO,CAAC;QACjC,KAAK,gBAAgB,CAAC,SAAS,CAAC,QAAQ,EAAE;YACzC,OAAO,gBAAgB,CAAC,SAAS,CAAC;QACnC,KAAK,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,EAAE;YACxC,OAAO,gBAAgB,CAAC,QAAQ,CAAC;QAClC,KAAK,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE;YACrC,OAAO,gBAAgB,CAAC,KAAK,CAAC;QAC/B,KAAK,gBAAgB,CAAC,OAAO,CAAC,QAAQ,EAAE;YACvC,OAAO,gBAAgB,CAAC,OAAO,CAAC;QACjC;YACC,OAAO,SAAS,CAAC;IACnB,CAAC;AACF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC/C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAE7C,OAAO,kBAAkB,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;AAC/C,CAAC"}

package/dist/enums/ecommons-synchronised-timeout-action.d.mts

@@ -0,0 +1,4 @@
+export declare enum ECommonsSynchronisedTimeoutAction {
+    PROCEED = "proceed",
+    ABORT = "abort"
+}

package/dist/enums/ecommons-synchronised-timeout-action.mjs

@@ -0,0 +1,6 @@
+export var ECommonsSynchronisedTimeoutAction;
+(function (ECommonsSynchronisedTimeoutAction) {
+    ECommonsSynchronisedTimeoutAction["PROCEED"] = "proceed";
+    ECommonsSynchronisedTimeoutAction["ABORT"] = "abort";
+})(ECommonsSynchronisedTimeoutAction || (ECommonsSynchronisedTimeoutAction = {}));
+//# sourceMappingURL=ecommons-synchronised-timeout-action.mjs.map

package/dist/enums/ecommons-synchronised-timeout-action.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecommons-synchronised-timeout-action.mjs","sourceRoot":"","sources":["../../src/enums/ecommons-synchronised-timeout-action.mts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,iCAGX;AAHD,WAAY,iCAAiC;IAC5C,wDAAmB,CAAA;IACnB,oDAAe,CAAA;AAChB,CAAC,EAHW,iCAAiC,KAAjC,iCAAiC,QAG5C"}

package/dist/helpers/commons-async.d.mts

@@ -0,0 +1,5 @@
+import { ECommonsInvocation } from '../enums/ecommons-invocation.mjs';
+export declare function commonsAsyncTimeout(ms: number, id?: string): Promise<void>;
+export declare function commonsAsyncAbortTimeout(id: string): void;
+export declare function commonsAsyncInterval(ms: number, approach: ECommonsInvocation, callback: () => Promise<void>, id?: string): void;
+export declare function commonsAsyncAbortInterval(id: string): void;

package/dist/helpers/commons-async.mjs

@@ -0,0 +1,118 @@
+import { commonsBase62GenerateRandomId } from 'tscommons-esm-core';
+import { ECommonsInvocation } from '../enums/ecommons-invocation.mjs';
+const timeouts = new Map();
+// has to any, as node.js uses Timer and Angular uses number
+const intervals = new Map();
+const isInCycle = new Map();
+const idUid = new Map();
+const isAborted = new Map();
+function internalClearTimeout(id) {
+    clearTimeout(timeouts.get(id).thread);
+    timeouts.delete(id);
+}
+export function commonsAsyncTimeout(ms, id) {
+    if (id && timeouts.has(id))
+        internalClearTimeout(id);
+    return new Promise((resolve, reject) => {
+        const thread = setTimeout(() => {
+            if (id && timeouts.has(id))
+                internalClearTimeout(id);
+            resolve();
+        }, ms);
+        if (id) {
+            timeouts.set(id, {
+                thread: thread,
+                reject: () => {
+                    reject(new Error('abortTimeout called'));
+                }
+            });
+        }
+    });
+}
+export function commonsAsyncAbortTimeout(id) {
+    if (timeouts.has(id)) {
+        const reject = timeouts.get(id).reject;
+        internalClearTimeout(id);
+        reject();
+    }
+}
+function commonsAsyncClearInterval(id) {
+    clearInterval(intervals.get(id)); // eslint-disable-line
+    intervals.delete(id);
+    const internalId = idUid.get(id);
+    if (internalId !== undefined)
+        isInCycle.delete(internalId);
+    idUid.delete(id);
+}
+export function commonsAsyncInterval(ms, approach, callback, id) {
+    if (id && intervals.has(id))
+        commonsAsyncClearInterval(id);
+    switch (approach) {
+        case ECommonsInvocation.FIXED: {
+            const thread = setInterval(async () => {
+                await callback();
+            }, ms);
+            if (id)
+                intervals.set(id, thread);
+            break;
+        }
+        case ECommonsInvocation.WHEN: {
+            const cycle = async () => {
+                if (id !== undefined)
+                    isAborted.set(id, false);
+                const isAbortedCallback = () => {
+                    if (id === undefined)
+                        return false;
+                    return isAborted.get(id) || false;
+                };
+                let first = true;
+                while (!isAbortedCallback()) {
+                    try {
+                        if (first) {
+                            first = false;
+                            continue;
+                        }
+                        await callback();
+                    }
+                    catch (ex) {
+                        // can't throw as it would abort the while loop
+                        console.log(ex);
+                    }
+                    finally {
+                        await commonsAsyncTimeout(ms);
+                    }
+                }
+                if (id !== undefined)
+                    isAborted.delete(id);
+            };
+            void cycle();
+            break;
+        }
+        case ECommonsInvocation.IF: {
+            const internalId = commonsBase62GenerateRandomId();
+            if (id)
+                idUid.set(id, internalId);
+            isInCycle.set(internalId, false);
+            commonsAsyncInterval(ms, ECommonsInvocation.FIXED, async () => {
+                if (isInCycle.get(internalId))
+                    return;
+                try {
+                    isInCycle.set(internalId, true);
+                    await callback();
+                }
+                finally {
+                    isInCycle.set(internalId, false);
+                }
+            }, id);
+            break;
+        }
+    }
+}
+export function commonsAsyncAbortInterval(id) {
+    if (isAborted.has(id))
+        isAborted.set(id, true);
+    if (intervals.has(id)) {
+        commonsAsyncClearInterval(id);
+    }
+}
+//# sourceMappingURL=commons-async.mjs.map

package/dist/helpers/commons-async.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"commons-async.mjs","sourceRoot":"","sources":["../../src/helpers/commons-async.mts"],"names":[],"mappings":"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"}

package/dist/helpers/commons-debouncer.d.mts

@@ -0,0 +1,8 @@
+export declare class CommonsDebouncer<T> {
+    private release;
+    private last;
+    private unique;
+    private history;
+    constructor(release: number);
+    debounce(value: T): T | undefined;
+}

package/dist/helpers/commons-debouncer.mjs

@@ -0,0 +1,25 @@
+export class CommonsDebouncer {
+    release;
+    last = undefined;
+    unique = undefined;
+    history = [];
+    constructor(release) {
+        this.release = release;
+    }
+    debounce(value) {
+        this.last = value;
+        if (this.last !== this.unique) {
+            this.unique = this.last;
+            if (!this.history.includes(this.unique)) {
+                this.history.push(this.unique);
+                setTimeout(() => {
+                    const index = this.history.indexOf(this.unique);
+                    this.history.splice(index, 1);
+                }, this.release);
+                return this.unique;
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=commons-debouncer.mjs.map

package/dist/helpers/commons-debouncer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"commons-debouncer.mjs","sourceRoot":"","sources":["../../src/helpers/commons-debouncer.mts"],"names":[],"mappings":"AAGA,MAAM,OAAO,gBAAgB;IAMnB;IALD,IAAI,GAAgB,SAAS,CAAC;IAC9B,MAAM,GAAgB,SAAS,CAAC;IAChC,OAAO,GAAoB,EAAE,CAAC;IAEtC,YACS,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IACrB,CAAC;IAEG,QAAQ,CAAC,KAAQ;QACvB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QAElB,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC;YAExB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC/B,UAAU,CAAC,GAAS,EAAE;oBACrB,MAAM,KAAK,GAAW,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACxD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC/B,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;gBAEjB,OAAO,IAAI,CAAC,MAAM,CAAC;YACpB,CAAC;QACF,CAAC;QAED,OAAO,SAAS,CAAC;IAClB,CAAC;CACD"}

package/dist/helpers/commons-final-value.d.mts

@@ -0,0 +1,10 @@
+import { Observable } from 'rxjs';
+import { TCommonsFinalValue } from '../types/tcommons-final-value.mjs';
+export declare class CommonsFinalValue<T> {
+    private delay;
+    private onRelease;
+    private timeout;
+    constructor(delay: number);
+    push(value: T): void;
+    releaseObservable(): Observable<TCommonsFinalValue<T>>;
+}

package/dist/helpers/commons-final-value.mjs

@@ -0,0 +1,21 @@
+import { Subject } from 'rxjs';
+export class CommonsFinalValue {
+    delay;
+    onRelease = new Subject();
+    timeout; // has to be unknown, as Node.js uses Timer and Angular uses number
+    constructor(delay) {
+        this.delay = delay;
+    }
+    push(value) {
+        if (this.timeout)
+            clearTimeout(this.timeout);
+        const snapshot = new Date();
+        this.timeout = setTimeout(() => {
+            this.onRelease.next({ value: value, timestamp: snapshot });
+        }, this.delay);
+    }
+    releaseObservable() {
+        return this.onRelease;
+    }
+}
+//# sourceMappingURL=commons-final-value.mjs.map

package/dist/helpers/commons-final-value.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"commons-final-value.mjs","sourceRoot":"","sources":["../../src/helpers/commons-final-value.mts"],"names":[],"mappings":"AAAA,OAAO,EAAc,OAAO,EAAE,MAAM,MAAM,CAAC;AAQ3C,MAAM,OAAO,iBAAiB;IAMnB;IALF,SAAS,GAAmC,IAAI,OAAO,EAAyB,CAAC;IAEjF,OAAO,CAAU,CAAC,mEAAmE;IAE7F,YACU,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IACpB,CAAC;IAEG,IAAI,CAAC,KAAQ;QACnB,IAAI,IAAI,CAAC,OAAO;YAAE,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE7C,MAAM,QAAQ,GAAS,IAAI,IAAI,EAAE,CAAC;QAElC,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,GAAS,EAAE;YACpC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5D,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC;IAEM,iBAAiB;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;CACD"}

package/dist/helpers/commons-grouper.d.mts

@@ -0,0 +1,11 @@
+import { Observable } from 'rxjs';
+export declare class CommonsGrouper<T> {
+    private ignoreEmpty;
+    private onGroup;
+    private interval;
+    private group;
+    constructor(period: number, ignoreEmpty?: boolean);
+    groupObservable(): Observable<T[]>;
+    add(value: T): void;
+    cancel(): void;
+}

package/dist/helpers/commons-grouper.mjs

@@ -0,0 +1,26 @@
+import { Subject } from 'rxjs';
+export class CommonsGrouper {
+    ignoreEmpty;
+    onGroup = new Subject();
+    interval; // has to be unknown, as Node.js uses Timer and Angular uses number
+    group = [];
+    constructor(period, ignoreEmpty = true) {
+        this.ignoreEmpty = ignoreEmpty;
+        this.interval = setInterval(() => {
+            if (this.group.length === 0 && this.ignoreEmpty)
+                return;
+            this.onGroup.next(this.group);
+            this.group = [];
+        }, period);
+    }
+    groupObservable() {
+        return this.onGroup;
+    }
+    add(value) {
+        this.group.push(value);
+    }
+    cancel() {
+        clearInterval(this.interval);
+    }
+}
+//# sourceMappingURL=commons-grouper.mjs.map

package/dist/helpers/commons-grouper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"commons-grouper.mjs","sourceRoot":"","sources":["../../src/helpers/commons-grouper.mts"],"names":[],"mappings":"AAAA,OAAO,EAAc,OAAO,EAAE,MAAM,MAAM,CAAC;AAM3C,MAAM,OAAO,cAAc;IAQhB;IAPF,OAAO,GAAiB,IAAI,OAAO,EAAO,CAAC;IAE3C,QAAQ,CAAU,CAAC,mEAAmE;IACtF,KAAK,GAAQ,EAAE,CAAC;IAExB,YACE,MAAc,EACN,cAAuB,IAAI;QAA3B,gBAAW,GAAX,WAAW,CAAgB;QAEpC,IAAI,CAAC,QAAQ,GAAG,WAAW,CACzB,GAAS,EAAE;YACV,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,WAAW;gBAAE,OAAO;YAExD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QACjB,CAAC,EACD,MAAM,CACP,CAAC;IACH,CAAC;IAEM,eAAe;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAEM,GAAG,CAAC,KAAQ;QAClB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAEM,MAAM;QACZ,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;CACD"}

package/dist/helpers/commons-promise.d.mts

@@ -0,0 +1 @@
+export declare function commonsPromiseTimeout<T>(promise: () => Promise<T>, timeout: number): Promise<T>;

package/dist/helpers/commons-promise.mjs

@@ -0,0 +1,35 @@
+import { commonsBase62GenerateRandomId } from 'tscommons-esm-core';
+import { commonsAsyncAbortTimeout, commonsAsyncTimeout } from './commons-async.mjs';
+export function commonsPromiseTimeout(promise, timeout) {
+    return new Promise((resolve, reject) => {
+        const timeoutId = `commonsAsyncPromiseTimeout_${commonsBase62GenerateRandomId()}`;
+        let completed = false;
+        void Promise.all([
+            (async () => {
+                try {
+                    const outcome = await promise();
+                    resolve(outcome);
+                }
+                catch (e) {
+                    reject(e);
+                }
+                finally {
+                    completed = true;
+                    commonsAsyncAbortTimeout(timeoutId);
+                }
+            })(),
+            (async () => {
+                try {
+                    await commonsAsyncTimeout(timeout, timeoutId);
+                }
+                catch (_e) {
+                    // do nothing
+                }
+                if (!completed)
+                    reject(new Error('Timeout'));
+                completed = true;
+            })()
+        ]);
+    });
+}
+//# sourceMappingURL=commons-promise.mjs.map

package/dist/helpers/commons-promise.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"commons-promise.mjs","sourceRoot":"","sources":["../../src/helpers/commons-promise.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEpF,MAAM,UAAU,qBAAqB,CACnC,OAAyB,EACzB,OAAe;IAEhB,OAAO,IAAI,OAAO,CAAC,CAAC,OAA4B,EAAE,MAA0B,EAAQ,EAAE;QACrF,MAAM,SAAS,GAAW,8BAA8B,6BAA6B,EAAE,EAAE,CAAC;QAC1F,IAAI,SAAS,GAAY,KAAK,CAAC;QAE/B,KAAK,OAAO,CAAC,GAAG,CAAC;YACf,CAAC,KAAK,IAAmB,EAAE;gBAC1B,IAAI,CAAC;oBACJ,MAAM,OAAO,GAAM,MAAM,OAAO,EAAE,CAAC;oBACnC,OAAO,CAAC,OAAO,CAAC,CAAC;gBAClB,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACZ,MAAM,CAAC,CAAU,CAAC,CAAC;gBACpB,CAAC;wBAAS,CAAC;oBACV,SAAS,GAAG,IAAI,CAAC;oBACjB,wBAAwB,CAAC,SAAS,CAAC,CAAC;gBACrC,CAAC;YACF,CAAC,CAAC,EAAE;YACJ,CAAC,KAAK,IAAmB,EAAE;gBAC1B,IAAI,CAAC;oBACJ,MAAM,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;gBAC/C,CAAC;gBAAC,OAAO,EAAE,EAAE,CAAC;oBACb,aAAa;gBACd,CAAC;gBAED,IAAI,CAAC,SAAS;oBAAE,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC7C,SAAS,GAAG,IAAI,CAAC;YAClB,CAAC,CAAC,EAAE;SACL,CAAC,CAAC;IAEJ,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/helpers/commons-semaphore.d.mts

@@ -0,0 +1,5 @@
+export declare class CommonsSemaphore {
+    private flag;
+    claim(timeout: number): Promise<void>;
+    release(): void;
+}

package/dist/helpers/commons-semaphore.mjs

@@ -0,0 +1,26 @@
+import { commonsAsyncTimeout } from './commons-async.mjs';
+export class CommonsSemaphore {
+    flag = false;
+    async claim(timeout) {
+        return new Promise((resolve, reject) => {
+            void (async () => {
+                let t = Math.floor(timeout / 50);
+                while (this.flag) {
+                    // wait
+                    await commonsAsyncTimeout(50);
+                    t--;
+                    if (t < 0) {
+                        reject(new Error('Timeout whilst waiting to claim semaphore'));
+                        return;
+                    }
+                }
+                this.flag = true;
+                resolve();
+            })();
+        });
+    }
+    release() {
+        this.flag = false;
+    }
+}
+//# sourceMappingURL=commons-semaphore.mjs.map

package/dist/helpers/commons-semaphore.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"commons-semaphore.mjs","sourceRoot":"","sources":["../../src/helpers/commons-semaphore.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,OAAO,gBAAgB;IACpB,IAAI,GAAY,KAAK,CAAC;IAEvB,KAAK,CAAC,KAAK,CAAC,OAAe;QACjC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAmB,EAAE,MAA0B,EAAE,EAAE;YAC5E,KAAK,CAAC,KAAK,IAAmB,EAAE;gBAC/B,IAAI,CAAC,GAAW,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;gBAEzC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;oBAClB,OAAO;oBACP,MAAM,mBAAmB,CAAC,EAAE,CAAC,CAAC;oBAC9B,CAAC,EAAE,CAAC;oBACJ,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;wBACX,MAAM,CAAC,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC,CAAC;wBAC/D,OAAO;oBACR,CAAC;gBACF,CAAC;gBACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;gBACjB,OAAO,EAAE,CAAC;YACX,CAAC,CAAC,EAAE,CAAC;QACN,CAAC,CAAC,CAAC;IACJ,CAAC;IAEM,OAAO;QACb,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;IACnB,CAAC;CACD"}

package/dist/index.d.mts

@@ -0,0 +1,19 @@
+import { commonsPromiseTimeout } from './helpers/commons-promise.mjs';
+import { CommonsSemaphore } from './helpers/commons-semaphore.mjs';
+import { commonsAsyncTimeout, commonsAsyncAbortTimeout, commonsAsyncInterval, commonsAsyncAbortInterval } from './helpers/commons-async.mjs';
+import { CommonsDebouncer } from './helpers/commons-debouncer.mjs';
+import { CommonsGrouper } from './helpers/commons-grouper.mjs';
+import { CommonsFinalValue } from './helpers/commons-final-value.mjs';
+import { CommonsMemoryObservable } from './classes/commons-memory-observable.mjs';
+import { CommonsStateThread } from './classes/commons-state-thread.mjs';
+import { CommonsSynchronised } from './classes/commons-synchronised.mjs';
+import { CommonsSchedule } from './classes/commons-schedule.mjs';
+import { CommonsClaimPool } from './classes/commons-claim-pool.mjs';
+import { ECommonsInvocation } from './enums/ecommons-invocation.mjs';
+import { ECommonsSynchronisedTimeoutAction } from './enums/ecommons-synchronised-timeout-action.mjs';
+import { ECommonsRunState, fromECommonsRunState, toECommonsRunState, isECommonsRunState } from './enums/ecommons-run-state.mjs';
+import { TCommonsFinalValue } from './types/tcommons-final-value.mjs';
+import { TCommonsScheduleTime, isTCommonsScheduleTime } from './types/tcommons-schedule-time.mjs';
+import { TCommonsSchedule, isTCommonsSchedule } from './types/tcommons-schedule.mjs';
+import { ICommonsStateful } from './interfaces/icommons-stateful.mjs';
+export { commonsPromiseTimeout, CommonsSemaphore, commonsAsyncTimeout, commonsAsyncAbortTimeout, commonsAsyncInterval, commonsAsyncAbortInterval, CommonsDebouncer, CommonsGrouper, CommonsFinalValue, CommonsMemoryObservable, CommonsStateThread, CommonsSynchronised, CommonsSchedule, CommonsClaimPool, ECommonsInvocation, ECommonsSynchronisedTimeoutAction, ECommonsRunState, fromECommonsRunState, toECommonsRunState, isECommonsRunState, TCommonsFinalValue, TCommonsScheduleTime, isTCommonsScheduleTime, TCommonsSchedule, isTCommonsSchedule, ICommonsStateful };

package/dist/index.mjs

@@ -0,0 +1,18 @@
+import { commonsPromiseTimeout } from './helpers/commons-promise.mjs';
+import { CommonsSemaphore } from './helpers/commons-semaphore.mjs';
+import { commonsAsyncTimeout, commonsAsyncAbortTimeout, commonsAsyncInterval, commonsAsyncAbortInterval } from './helpers/commons-async.mjs';
+import { CommonsDebouncer } from './helpers/commons-debouncer.mjs';
+import { CommonsGrouper } from './helpers/commons-grouper.mjs';
+import { CommonsFinalValue } from './helpers/commons-final-value.mjs';
+import { CommonsMemoryObservable } from './classes/commons-memory-observable.mjs';
+import { CommonsStateThread } from './classes/commons-state-thread.mjs';
+import { CommonsSynchronised } from './classes/commons-synchronised.mjs';
+import { CommonsSchedule } from './classes/commons-schedule.mjs';
+import { CommonsClaimPool } from './classes/commons-claim-pool.mjs';
+import { ECommonsInvocation } from './enums/ecommons-invocation.mjs';
+import { ECommonsSynchronisedTimeoutAction } from './enums/ecommons-synchronised-timeout-action.mjs';
+import { ECommonsRunState, fromECommonsRunState, toECommonsRunState, isECommonsRunState } from './enums/ecommons-run-state.mjs';
+import { isTCommonsScheduleTime } from './types/tcommons-schedule-time.mjs';
+import { isTCommonsSchedule } from './types/tcommons-schedule.mjs';
+export { commonsPromiseTimeout, CommonsSemaphore, commonsAsyncTimeout, commonsAsyncAbortTimeout, commonsAsyncInterval, commonsAsyncAbortInterval, CommonsDebouncer, CommonsGrouper, CommonsFinalValue, CommonsMemoryObservable, CommonsStateThread, CommonsSynchronised, CommonsSchedule, CommonsClaimPool, ECommonsInvocation, ECommonsSynchronisedTimeoutAction, ECommonsRunState, fromECommonsRunState, toECommonsRunState, isECommonsRunState, isTCommonsScheduleTime, isTCommonsSchedule };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,iCAAiC,EAAE,MAAM,kDAAkD,CAAC;AACrG,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAwB,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAClG,OAAO,EAAoB,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAErF,OAAO,EACN,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,iCAAiC,EACjC,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAGlB,sBAAsB,EAEtB,kBAAkB,EAElB,CAAC"}

package/dist/interfaces/icommons-stateful.d.mts

@@ -0,0 +1,5 @@
+import { ECommonsRunState } from '../enums/ecommons-run-state.mjs';
+export interface ICommonsStateful {
+    getState(): ECommonsRunState;
+    isAborted(): boolean;
+}

package/dist/interfaces/icommons-stateful.mjs

@@ -0,0 +1,3 @@
+// This is a true interface similar to Java as opposed to a pseudo-struct interface as per TypeScript
+export {};
+//# sourceMappingURL=icommons-stateful.mjs.map

package/dist/interfaces/icommons-stateful.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"icommons-stateful.mjs","sourceRoot":"","sources":["../../src/interfaces/icommons-stateful.mts"],"names":[],"mappings":"AAAA,qGAAqG"}

package/dist/types/tcommons-final-value.d.mts

@@ -0,0 +1,4 @@
+export type TCommonsFinalValue<T> = {
+    value: T;
+    timestamp: Date;
+};

package/dist/types/tcommons-final-value.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tcommons-final-value.mjs.map

package/dist/types/tcommons-final-value.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tcommons-final-value.mjs","sourceRoot":"","sources":["../../src/types/tcommons-final-value.mts"],"names":[],"mappings":""}

package/dist/types/tcommons-schedule-time.d.mts

@@ -0,0 +1,10 @@
+export type TCommonsScheduleTime = {
+    year?: number | number[];
+    month?: number | number[];
+    day?: number | number[];
+    dow?: number | number[];
+    hour?: number | number[];
+    minute?: number | number[];
+    second?: number | number[];
+};
+export declare function isTCommonsScheduleTime(test: unknown): test is TCommonsScheduleTime;

package/dist/types/tcommons-schedule-time.mjs

@@ -0,0 +1,13 @@
+import { commonsTypeIsObject, commonsTypeHasPropertyNumberOrUndefined, commonsTypeHasPropertyArrayOrUndefined, commonsTypeIsNumberArray, commonsTypeHasPropertyArray } from 'tscommons-esm-core';
+export function isTCommonsScheduleTime(test) {
+    if (!commonsTypeIsObject(test))
+        return false;
+    for (const key of 'year,month,day,dow,hour,minute,second'.split(',')) {
+        if (!commonsTypeHasPropertyNumberOrUndefined(test, key) && !commonsTypeHasPropertyArrayOrUndefined(test, key))
+            return false;
+        if (commonsTypeHasPropertyArray(test, key) && !commonsTypeIsNumberArray(test[key]))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=tcommons-schedule-time.mjs.map

package/dist/types/tcommons-schedule-time.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tcommons-schedule-time.mjs","sourceRoot":"","sources":["../../src/types/tcommons-schedule-time.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,uCAAuC,EACvC,sCAAsC,EACtC,wBAAwB,EACxB,2BAA2B,EAC5B,MAAM,oBAAoB,CAAC;AAY5B,MAAM,UAAU,sBAAsB,CAAC,IAAa;IACnD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAE7C,KAAK,MAAM,GAAG,IAAI,uCAAuC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtE,IAAI,CAAC,uCAAuC,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,IAAI,EAAE,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5H,IAAI,2BAA2B,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAClG,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/types/tcommons-schedule.d.mts

@@ -0,0 +1,6 @@
+import { TCommonsScheduleTime } from './tcommons-schedule-time.mjs';
+export type TCommonsSchedule = {
+    at: TCommonsScheduleTime;
+    action: string;
+};
+export declare function isTCommonsSchedule(test: unknown): test is TCommonsSchedule;

package/dist/types/tcommons-schedule.mjs

@@ -0,0 +1,10 @@
+import { commonsTypeHasPropertyT, commonsTypeHasPropertyString } from 'tscommons-esm-core';
+import { isTCommonsScheduleTime } from './tcommons-schedule-time.mjs';
+export function isTCommonsSchedule(test) {
+    if (!commonsTypeHasPropertyT(test, 'at', isTCommonsScheduleTime))
+        return false;
+    if (!commonsTypeHasPropertyString(test, 'action'))
+        return false;
+    return true;
+}
+//# sourceMappingURL=tcommons-schedule.mjs.map

package/dist/types/tcommons-schedule.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tcommons-schedule.mjs","sourceRoot":"","sources":["../../src/types/tcommons-schedule.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAE3F,OAAO,EAAwB,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAO5F,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC/C,IAAI,CAAC,uBAAuB,CAAuB,IAAI,EAAE,IAAI,EAAE,sBAAsB,CAAC;QAAE,OAAO,KAAK,CAAC;IAErG,IAAI,CAAC,4BAA4B,CAAC,IAAI,EAAE,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAEhE,OAAO,IAAI,CAAC;AACb,CAAC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+	"name": "tscommons-esm-async",
+	"version": "0.0.2",
+	"description": "",
+	"scripts": {
+		"tsc": "./node_modules/typescript/bin/tsc",
+		"preprepare": "rm -rf ./dist; php ~/Dev/etim.php src/ && npm run tsc",
+		"publish-major": "rm -rf dist; npm run tsc && npx eslint . && npm run preprepare && npm version major && npm install && npm publish && git add . && git commit -m 'publish'",
+		"publish-minor": "rm -rf dist; npm run tsc && npx eslint . && npm run preprepare && npm version minor && npm install && npm publish && git add . && git commit -m 'publish'",
+		"publish-patch": "rm -rf dist; npm run tsc && npx eslint . && npm run preprepare && npm version patch && npm install && npm publish && git add . && git commit -m 'publish'"
+	},
+	"main": "dist/index.mjs",
+	"types": "dist/index.d.mjs",
+	"type": "module",
+	"author": "Pete Morris",
+	"license": "ISC",
+	"devDependencies": {
+		"@stylistic/eslint-plugin-ts": "^2.10.1",
+		"eslint-plugin-import": "^2.31.0",
+		"eslint-plugin-prefer-arrow-functions": "^3.4.1",
+		"typescript": "^5.6.3",
+		"typescript-eslint": "^8.14.0"
+	},
+	"files": [
+		"dist/**/*"
+	],
+	"dependencies": {
+		"rxjs": "^7.8.1",
+		"tscommons-esm-core": "^0.0.2"
+	}
+}