@furystack/utils 7.0.2 → 8.0.0

package/esm/trace.js

@@ -1,139 +0,0 @@
-import { ObservableValue } from './observable-value.js';
-/**
- * Helper class that can be used to trace method calls programmatically
- *
- * Usage example:
- * ```ts
- * const methodTracer: IDisposable = Trace.method({
- *     object: myObjectInstance,           // You can define an object constructor for static methods as well
- *     method: myObjectInstance.method,    // The method to be tracked
- *     isAsync: true,                      // if you set to async, method finished will be *await*-ed
- *     onCalled: (traceData) => {
- *         console.log("Method called:", traceData)
- *     },
- *     onFinished: (traceData) => {
- *         console.log("Method call finished:", traceData)
- *     },
- *     onError: (traceData) => {
- *         console.log("Method throwed an error:", traceData)
- *     }
- * });
- * ```
- */
-export class Trace {
-    static objectTraces = new Map();
-    static getMethodTrace(object, method) {
-        const objectTrace = this.objectTraces.get(object);
-        return objectTrace.methodMappings.get(method.name);
-    }
-    static traceStart(methodTrace, args) {
-        const startDateTime = new Date();
-        const traceValue = {
-            methodArguments: args,
-            startDateTime,
-        };
-        methodTrace.callObservable.setValue(traceValue);
-        return traceValue;
-    }
-    static traceFinished(methodTrace, args, callTrace, returned) {
-        const finishedTrace = {
-            methodArguments: args,
-            startDateTime: callTrace.startDateTime,
-            finishedDateTime: new Date(),
-            returned,
-        };
-        methodTrace.finishedObservable.setValue(finishedTrace);
-    }
-    static traceError(methodTrace, args, callTrace, error) {
-        const errorTrace = {
-            methodArguments: args,
-            startDateTime: callTrace.startDateTime,
-            errorDateTime: new Date(),
-            error,
-        };
-        methodTrace.errorObservable.setValue(errorTrace);
-        return errorTrace;
-    }
-    static callMethod(object, method, args) {
-        const methodTrace = this.getMethodTrace(object, method);
-        const start = this.traceStart(methodTrace, args);
-        try {
-            const returned = methodTrace.originalMethod.call(object, ...args);
-            this.traceFinished(methodTrace, args, start, returned);
-            return returned;
-        }
-        catch (error) {
-            this.traceError(methodTrace, args, start, error);
-            throw error;
-        }
-    }
-    static async callMethodAsync(object, method, args) {
-        const methodTrace = this.getMethodTrace(object, method);
-        const start = this.traceStart(methodTrace, args);
-        try {
-            const returned = await methodTrace.originalMethod.call(object, ...args);
-            this.traceFinished(methodTrace, args, start, returned);
-            return returned;
-        }
-        catch (error) {
-            this.traceError(methodTrace, args, start, error);
-            throw error;
-        }
-    }
-    /**
-     * Creates an observer that will be observe method calls, finishes and errors
-     * @param options The options object for the trace
-     * @returns the trace object that can be disposed after usage
-     */
-    static method(options) {
-        // add object mapping
-        if (!this.objectTraces.has(options.object)) {
-            this.objectTraces.set(options.object, {
-                methodMappings: new Map(),
-            });
-        }
-        // setup override if needed
-        if (!options.method.isTraced) {
-            const overriddenMethod = options.isAsync
-                ? (...args) => this.callMethodAsync(options.object, options.method, args)
-                : (...args) => this.callMethod(options.object, options.method, args);
-            Object.defineProperty(overriddenMethod, 'name', { value: options.method.name });
-            Object.defineProperty(overriddenMethod, 'isTraced', { value: options.method.name });
-            options.object[options.method.name] = overriddenMethod;
-        }
-        const objectTrace = this.objectTraces.get(options.object);
-        // add method mapping if needed
-        if (!objectTrace.methodMappings.has(options.method.name)) {
-            objectTrace.methodMappings.set(options.method.name, {
-                originalMethod: options.method,
-                callObservable: new ObservableValue({
-                    methodArguments: [],
-                    startDateTime: new Date(''),
-                }),
-                finishedObservable: new ObservableValue({
-                    methodArguments: [],
-                    startDateTime: new Date(''),
-                    finishedDateTime: new Date(''),
-                    returned: undefined,
-                }),
-                errorObservable: new ObservableValue({
-                    methodArguments: [],
-                    startDateTime: new Date(''),
-                    errorDateTime: new Date(''),
-                    error: undefined,
-                }),
-            });
-        }
-        const methodTrace = objectTrace.methodMappings.get(options.method.name);
-        const callbacks = [
-            options.onCalled && methodTrace.callObservable.subscribe(options.onCalled),
-            options.onFinished && methodTrace.finishedObservable.subscribe(options.onFinished),
-            options.onError && methodTrace.errorObservable.subscribe(options.onError),
-        ];
-        // Subscribe and return the observer
-        return {
-            dispose: () => callbacks.forEach((c) => c && c.dispose()),
-        };
-    }
-}
-//# sourceMappingURL=trace.js.map

package/esm/trace.js.map

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

package/esm/trace.spec.d.ts

@@ -1,2 +0,0 @@
-export declare const traceTests: import("vitest").SuiteCollector<{}>;
-//# sourceMappingURL=trace.spec.d.ts.map

package/esm/trace.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trace.spec.d.ts","sourceRoot":"","sources":["../src/trace.spec.ts"],"names":[],"mappings":"AA+BA,eAAO,MAAM,UAAU,qCAwKrB,CAAA"}

package/esm/trace.spec.js

@@ -1,184 +0,0 @@
-import { describe, it, expect, vi } from 'vitest';
-import { Trace } from './trace.js';
-class MockClass {
-    testValue;
-    constructor(testValue) {
-        this.testValue = testValue;
-    }
-    testError(msg) {
-        throw Error(msg);
-    }
-    testScope() {
-        return this.testValue;
-    }
-    static addStatic(...args) {
-        return args.reduce((a, b) => a + b, 0);
-    }
-    addInstance(...args) {
-        return args.reduce((a, b) => a + b, 0);
-    }
-    async addInstanceAsync(...args) {
-        return args.reduce((a, b) => a + b, 0);
-    }
-    async testErrorAsync(msg) {
-        throw Error(msg);
-    }
-}
-export const traceTests = describe('Trace tests', () => {
-    describe('Static method traces', () => {
-        it('Static Methods call should be traced with args', () => {
-            const args = [1, 2, 3];
-            const doneCallback = vi.fn();
-            const observer = Trace.method({
-                object: MockClass,
-                method: MockClass.addStatic,
-                onCalled: (traceData) => {
-                    expect(args).toEqual(traceData.methodArguments);
-                    observer.dispose();
-                    doneCallback();
-                },
-            });
-            MockClass.addStatic(...args);
-            expect(doneCallback).toBeCalled();
-        });
-        it('Static Methods call should be traced with args and return value', () => {
-            const args = [1, 2, 3];
-            const doneCallback = vi.fn();
-            const observer = Trace.method({
-                object: MockClass,
-                method: MockClass.addStatic,
-                onFinished: (traceData) => {
-                    expect(args).toEqual(traceData.methodArguments);
-                    expect(traceData.returned).toBe(1 + 2 + 3);
-                    observer.dispose();
-                    doneCallback();
-                },
-            });
-            MockClass.addStatic(...args);
-            expect(doneCallback).toBeCalled();
-        });
-        it("shouldn't be triggered after observer is disposed", () => {
-            const args = [1, 2, 3];
-            const shouldNotCall = vi.fn();
-            const doneCallback = vi.fn();
-            const observer = Trace.method({
-                object: MockClass,
-                method: MockClass.addStatic,
-                onCalled: () => {
-                    shouldNotCall("Shouldn't be triggered here");
-                },
-            });
-            const observer2 = Trace.method({
-                object: MockClass,
-                method: MockClass.addStatic,
-                onCalled: () => {
-                    observer2.dispose();
-                    doneCallback();
-                },
-            });
-            observer.dispose();
-            const returned = MockClass.addStatic(...args);
-            expect(returned).toEqual(1 + 2 + 3);
-            expect(doneCallback).toBeCalled();
-            expect(shouldNotCall).not.toBeCalled();
-        });
-    });
-    describe('Instance method traces', () => {
-        it('should be traced with arguments', () => {
-            const instance = new MockClass();
-            const args = [1, 2, 3];
-            const doneCallback = vi.fn();
-            const observer = Trace.method({
-                object: instance,
-                method: instance.addInstance,
-                onFinished: (traceData) => {
-                    expect(args).toEqual(traceData.methodArguments);
-                    expect(traceData.returned).toBe(1 + 2 + 3);
-                    observer.dispose();
-                    doneCallback();
-                },
-            });
-            instance.addInstance(...args);
-            expect(doneCallback).toBeCalled();
-        });
-        it('should be traced asynchronously', async () => {
-            const instance = new MockClass();
-            const args = [1, 2, 3];
-            const doneCallback = vi.fn();
-            const observer = Trace.method({
-                object: instance,
-                method: instance.addInstanceAsync,
-                isAsync: true,
-                onFinished: (traceData) => {
-                    expect(args).toEqual(traceData.methodArguments);
-                    const { returned } = traceData;
-                    expect(returned).toBe(1 + 2 + 3);
-                    observer.dispose();
-                    doneCallback();
-                },
-            });
-            await instance.addInstanceAsync(...args);
-            expect(doneCallback).toBeCalled();
-        });
-        it("should have a valid 'this' scope", () => {
-            const instance = new MockClass('testValue');
-            const doneCallback = vi.fn();
-            const observer = Trace.method({
-                object: instance,
-                method: instance.testScope,
-                onFinished: (traceData) => {
-                    if (traceData.returned) {
-                        expect(traceData.returned).toBe('testValue');
-                        observer.dispose();
-                        doneCallback();
-                    }
-                },
-            });
-            expect(instance.testScope()).toBe('testValue');
-            expect(doneCallback).toBeCalled();
-        });
-        it('should handle throwing errors', () => {
-            const instance = new MockClass('testValue');
-            const doneCallback = vi.fn();
-            const observer = Trace.method({
-                object: instance,
-                method: instance.testError,
-                onError: (traceData) => {
-                    if (traceData.error) {
-                        expect(traceData.error.message).toBe('message');
-                        observer.dispose();
-                        doneCallback();
-                    }
-                },
-            });
-            expect(() => {
-                instance.testError('message');
-            }).toThrow();
-            expect(doneCallback).toBeCalled();
-        });
-        it('should handle throwing errors with asyncs', async () => {
-            const instance = new MockClass('testValue');
-            const doneCallback = vi.fn();
-            const observer = Trace.method({
-                object: instance,
-                method: instance.testErrorAsync,
-                isAsync: true,
-                onError: (traceData) => {
-                    if (traceData.error) {
-                        expect(traceData.error.message).toBe('message');
-                        observer.dispose();
-                        doneCallback();
-                    }
-                },
-            });
-            try {
-                await instance.testErrorAsync('message');
-            }
-            catch (error) {
-                // ignore
-            }
-            expect(doneCallback).toBeCalled();
-        });
-    });
-});
-//# sourceMappingURL=trace.spec.js.map

package/esm/trace.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"trace.spec.js","sourceRoot":"","sources":["../src/trace.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,MAAM,SAAS;IACO;IAApB,YAAoB,SAAkB;QAAlB,cAAS,GAAT,SAAS,CAAS;IAAG,CAAC;IAEnC,SAAS,CAAC,GAAW;QAC1B,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IAClB,CAAC;IAEM,SAAS;QACd,OAAO,IAAI,CAAC,SAAS,CAAA;IACvB,CAAC;IAEM,MAAM,CAAC,SAAS,CAAa,GAAG,IAAc;QACnD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IACxC,CAAC;IAEM,WAAW,CAAa,GAAG,IAAc;QAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IACxC,CAAC;IAEM,KAAK,CAAC,gBAAgB,CAAa,GAAG,IAAc;QACzD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IACxC,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,GAAW;QACrC,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IAClB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IACrD,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YACtB,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;YAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC5B,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,SAAS,CAAC,SAAS;gBAC3B,QAAQ,EAAE,CAAC,SAAS,EAAE,EAAE;oBACtB,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAA;oBAC/C,QAAQ,CAAC,OAAO,EAAE,CAAA;oBAClB,YAAY,EAAE,CAAA;gBAChB,CAAC;aACF,CAAC,CAAA;YACF,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAA;YAC5B,MAAM,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAA;QACnC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;YACzE,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YACtB,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;YAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC5B,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,SAAS,CAAC,SAAS;gBAC3B,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE;oBACxB,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAA;oBAC/C,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;oBAC1C,QAAQ,CAAC,OAAO,EAAE,CAAA;oBAClB,YAAY,EAAE,CAAA;gBAChB,CAAC;aACF,CAAC,CAAA;YACF,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAA;YAC5B,MAAM,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAA;QACnC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YACtB,MAAM,aAAa,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;YAC7B,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;YAE5B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC5B,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,SAAS,CAAC,SAAS;gBAC3B,QAAQ,EAAE,GAAG,EAAE;oBACb,aAAa,CAAC,6BAA6B,CAAC,CAAA;gBAC9C,CAAC;aACF,CAAC,CAAA;YACF,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC7B,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,SAAS,CAAC,SAAS;gBAC3B,QAAQ,EAAE,GAAG,EAAE;oBACb,SAAS,CAAC,OAAO,EAAE,CAAA;oBACnB,YAAY,EAAE,CAAA;gBAChB,CAAC;aACF,CAAC,CAAA;YACF,QAAQ,CAAC,OAAO,EAAE,CAAA;YAClB,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAA;YAC7C,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;YACnC,MAAM,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAA;YACjC,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,CAAA;QACxC,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,QAAQ,GAAG,IAAI,SAAS,EAAE,CAAA;YAChC,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YACtB,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;YAE5B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC5B,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,QAAQ,CAAC,WAAW;gBAC5B,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE;oBACxB,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAA;oBAC/C,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;oBAC1C,QAAQ,CAAC,OAAO,EAAE,CAAA;oBAClB,YAAY,EAAE,CAAA;gBAChB,CAAC;aACF,CAAC,CAAA;YACF,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAA;YAC7B,MAAM,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAA;QACnC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;YAC/C,MAAM,QAAQ,GAAG,IAAI,SAAS,EAAE,CAAA;YAChC,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YACtB,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;YAE5B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC5B,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,QAAQ,CAAC,gBAAgB;gBACjC,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE;oBACxB,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAA;oBAC/C,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAA;oBAC9B,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;oBAChC,QAAQ,CAAC,OAAO,EAAE,CAAA;oBAClB,YAAY,EAAE,CAAA;gBAChB,CAAC;aACF,CAAC,CAAA;YACF,MAAM,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,CAAA;YACxC,MAAM,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAA;QACnC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,QAAQ,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,CAAA;YAC3C,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;YAE5B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC5B,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,QAAQ,CAAC,SAAS;gBAC1B,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE;oBACxB,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;wBACvB,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;wBAC5C,QAAQ,CAAC,OAAO,EAAE,CAAA;wBAClB,YAAY,EAAE,CAAA;oBAChB,CAAC;gBACH,CAAC;aACF,CAAC,CAAA;YACF,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;YAC9C,MAAM,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAA;QACnC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,QAAQ,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,CAAA;YAC3C,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;YAE5B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC5B,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,QAAQ,CAAC,SAAS;gBAC1B,OAAO,EAAE,CAAC,SAAS,EAAE,EAAE;oBACrB,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;wBACpB,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;wBAC/C,QAAQ,CAAC,OAAO,EAAE,CAAA;wBAClB,YAAY,EAAE,CAAA;oBAChB,CAAC;gBACH,CAAC;aACF,CAAC,CAAA;YACF,MAAM,CAAC,GAAG,EAAE;gBACV,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;YAC/B,CAAC,CAAC,CAAC,OAAO,EAAE,CAAA;YACZ,MAAM,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAA;QACnC,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;YACzD,MAAM,QAAQ,GAAG,IAAI,SAAS,CAAC,WAAW,CAAC,CAAA;YAC3C,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;YAE5B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC5B,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,QAAQ,CAAC,cAAc;gBAC/B,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,SAAS,EAAE,EAAE;oBACrB,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;wBACpB,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;wBAC/C,QAAQ,CAAC,OAAO,EAAE,CAAA;wBAClB,YAAY,EAAE,CAAA;oBAChB,CAAC;gBACH,CAAC;aACF,CAAC,CAAA;YACF,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,cAAc,CAAC,SAAS,CAAC,CAAA;YAC1C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS;YACX,CAAC;YACD,MAAM,CAAC,YAAY,CAAC,CAAC,UAAU,EAAE,CAAA;QACnC,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/src/disposable.spec.ts

@@ -1,130 +0,0 @@
-import { describe, it, expect, vi } from 'vitest'
-import type { Disposable } from './disposable.js'
-import { using, usingAsync } from './disposable.js'
-
-export class MockDisposable implements Disposable {
-  private disposed = false
-  public isDisposed = () => this.disposed
-  /**
-   * Disposes the MockDisposable instance, calls the dispose callback
-   */
-  public dispose = () => {
-    this.disposed = true
-    this.disposeCallback && this.disposeCallback()
-  }
-
-  /**
-   * Mock to throw an error
-   */
-  public whooops() {
-    throw Error('Whooops')
-  }
-
-  /**
-   * Defines the callback that will be called on dispose
-   */
-  public disposeCallback!: () => void
-}
-
-/**
- * Unit tests for disposables
- */
-export const disposableTests = describe('Disposable', () => {
-  it('Can be constructed', () => {
-    using(new MockDisposable(), (d) => {
-      expect(d).toBeInstanceOf(MockDisposable)
-    })
-  })
-
-  it('Should return a value from a callback', () => {
-    const returned = using(new MockDisposable(), () => {
-      return 1
-    })
-    expect(returned).toBe(1)
-  })
-
-  it('Should return a value from an async callback', async () => {
-    const returned = await usingAsync(new MockDisposable(), async () => {
-      return 2
-    })
-    expect(returned).toBe(2)
-  })
-
-  describe('isDisposed', () => {
-    it('should return a correct value before and after disposition', () => {
-      const d = new MockDisposable()
-      expect(d.isDisposed()).toBe(false)
-      d.dispose()
-      expect(d.isDisposed()).toBe(true)
-    })
-  })
-
-  describe('dispose()', () => {
-    it('should be called on error', () => {
-      const callbackMethod = vi.fn()
-      try {
-        using(new MockDisposable(), (d) => {
-          d.disposeCallback = () => {
-            callbackMethod()
-          }
-          d.whooops()
-        })
-      } catch {
-        /** ignore */
-      }
-      expect(callbackMethod).toBeCalled()
-    })
-
-    it('should be called with usingAsync()', async () => {
-      const callbackMethod = vi.fn()
-      await usingAsync(new MockDisposable(), async (d) => {
-        d.disposeCallback = () => {
-          callbackMethod()
-        }
-        return new Promise((resolve) => {
-          setTimeout(resolve, 1)
-        })
-      })
-      expect(callbackMethod).toBeCalled()
-    })
-
-    it('should be called when async fails', async () => {
-      const callbackMethod = vi.fn()
-      try {
-        await usingAsync(new MockDisposable(), async (d) => {
-          d.disposeCallback = () => {
-            callbackMethod()
-          }
-          return new Promise((_resolve, reject) => {
-            setTimeout(reject, 1)
-          })
-        })
-      } catch (error) {
-        /** ignore */
-      }
-      expect(callbackMethod).toBeCalled()
-    })
-
-    it('should await dispose for asyncs with usingAsync()', async () => {
-      class AsyncDispose {
-        /** flag */
-        public isDisposed = false
-        /** set isDisposed with a timeout */
-        public async dispose() {
-          await new Promise<void>((resolve) =>
-            setTimeout(() => {
-              this.isDisposed = true
-              resolve()
-            }, 10),
-          )
-        }
-      }
-
-      const asyncDispose = new AsyncDispose()
-      await usingAsync(asyncDispose, async () => {
-        /** */
-      })
-      expect(asyncDispose.isDisposed).toBe(true)
-    })
-  })
-})

package/src/disposable.ts

@@ -1,69 +0,0 @@
-/**
- *
- * You can implement *IDisposable* resources and use them with a *using()* or *usingAsync()* syntax.
- *
- * Usage example:
- *
- * ```ts
- * class Resource implements IDisposable{
- *       dispose(){
- *           // cleanup logics
- *      }
- * }
- *
- *
- * using(new Resource(), (resource)=>{
- *      // do something with the resource
- * })
- *
- * usingAsync(new Resource(), async (resource)=>{
- *      // do something with the resource, allows awaiting promises
- * })
- * ```
- */
-/** */
-
-/**
- * Resources in using an usingAsync should implement this interface
- *
- */
-export interface Disposable {
-  /**
-   * Method called when the IDisposable is disposed.
-   */
-  dispose: () => void | Promise<void>
-}
-
-/**
- * Method that accepts an IDisposable resource that will be disposed after the callback
- * @param resource The resource that is used in the callback and will be disposed afterwards
- * @param callback The callback that will be executed synchrounously before the resource will be disposed
- * @returns the value that will be returned by the callback method
- */
-export const using = <T extends Disposable, TReturns>(resource: T, callback: (r: T) => TReturns) => {
-  try {
-    return callback(resource)
-  } finally {
-    resource.dispose()
-  }
-}
-
-/**
- * Method that accepts an IDisposable resource that will be disposed after the callback
- * @param resource The resource that is used in the callback and will be disposed afterwards
- * @param callback The callback that will be executed asynchrounously before the resource will be disposed
- * @returns A promise that will be resolved with a return value after the resource is disposed
- */
-export const usingAsync = async <T extends Disposable, TReturns>(
-  resource: T,
-  callback: (r: T) => Promise<TReturns>,
-) => {
-  try {
-    return await callback(resource)
-  } finally {
-    const disposeResult = resource.dispose()
-    if (disposeResult instanceof Promise) {
-      await disposeResult
-    }
-  }
-}