@furystack/utils 4.0.0 → 4.0.1

package/esm/debounce.js

@@ -0,0 +1,19 @@
+/**
+ * @param method The method that should be debounced
+ * @param debounceMs The timeout in millisecs
+ * @returns a method that wraps the original one with an async debounce
+ */
+export const debounce = (method, debounceMs = 250) => {
+    let timeout;
+    return ((...args) => {
+        if (timeout) {
+            clearTimeout(timeout);
+        }
+        timeout = setTimeout(() => {
+            method(...args);
+            timeout ?? clearTimeout(timeout);
+            timeout = undefined;
+        }, debounceMs);
+    });
+};
+//# sourceMappingURL=debounce.js.map

package/esm/debounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../src/debounce.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAoC,MAAoC,EAAE,UAAU,GAAG,GAAG,EAAE,EAAE;IACpH,IAAI,OAAkD,CAAA;IACtD,OAAO,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE;QACzB,IAAI,OAAO,EAAE;YACX,YAAY,CAAC,OAAO,CAAC,CAAA;SACtB;QACD,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YACxB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAA;YACf,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAA;YAChC,OAAO,GAAG,SAAS,CAAA;QACrB,CAAC,EAAE,UAAU,CAAC,CAAA;IAChB,CAAC,CAAiC,CAAA;AACpC,CAAC,CAAA"}

package/esm/deep-merge.js

@@ -0,0 +1,29 @@
+/**
+ * Deep merge two objects.
+ * @param  target The source object to be merged
+ * @param sources The source objects
+ * @returns A new instance with the merged values
+ */
+export const deepMerge = (target, ...sources) => {
+    if (!sources.length) {
+        return target;
+    }
+    const merged = { ...target };
+    for (const source of sources) {
+        if (!source) {
+            continue;
+        }
+        const keys = Object.keys(source);
+        for (const key of keys) {
+            if (!(source[key] instanceof Array) && typeof source[key] === 'object' && typeof target[key] === 'object') {
+                merged[key] = deepMerge(target[key], source[key]);
+            }
+            else if (source[key] !== undefined) {
+                ;
+                merged[key] = source[key];
+            }
+        }
+    }
+    return merged;
+};
+//# sourceMappingURL=deep-merge.js.map

package/esm/deep-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-merge.js","sourceRoot":"","sources":["../src/deep-merge.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAI,MAAS,EAAE,GAAG,OAA0C,EAAE,EAAE;IACvF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;QACnB,OAAO,MAAM,CAAA;KACd;IACD,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;IAC5B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE;QAC5B,IAAI,CAAC,MAAM,EAAE;YACX,SAAQ;SACT;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAmB,CAAA;QAClD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE;YACtB,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE;gBACzG,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;aAClD;iBAAM,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE;gBACpC,CAAC;gBAAC,MAAM,CAAC,GAAG,CAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;aACpC;SACF;KACF;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/esm/disposable.js

@@ -0,0 +1,56 @@
+/**
+ *
+ * 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
+ * })
+ * ```
+ */
+/** */
+/**
+ * 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 = (resource, callback) => {
+    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 (resource, callback) => {
+    try {
+        return await callback(resource);
+    }
+    finally {
+        const disposeResult = resource.dispose();
+        if (disposeResult instanceof Promise) {
+            await disposeResult;
+        }
+    }
+};
+//# sourceMappingURL=disposable.js.map

package/esm/disposable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposable.js","sourceRoot":"","sources":["../src/disposable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM;AAaN;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAiC,QAAW,EAAE,QAA4B,EAAE,EAAE;IACjG,IAAI;QACF,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAA;KAC1B;YAAS;QACR,QAAQ,CAAC,OAAO,EAAE,CAAA;KACnB;AACH,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC7B,QAAW,EACX,QAAqC,EACrC,EAAE;IACF,IAAI;QACF,OAAO,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAA;KAChC;YAAS;QACR,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAA;QACxC,IAAI,aAAa,YAAY,OAAO,EAAE;YACpC,MAAM,aAAa,CAAA;SACpB;KACF;AACH,CAAC,CAAA"}

package/esm/index.js

@@ -0,0 +1,11 @@
+export * from './disposable';
+export * from './deep-merge';
+export * from './debounce';
+export * from './observable-value';
+export * from './value-observer';
+export * from './path-helper';
+export * from './sleep-async';
+export * from './sort-by';
+export * from './trace';
+export * from './tuple';
+//# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA"}

package/esm/observable-value.js

@@ -0,0 +1,109 @@
+import { ValueObserver } from './value-observer';
+/**
+ * Error thrown when you try to retrieve or set an observable value that is already disposed.
+ */
+export class ObservableAlreadyDisposedError extends Error {
+    constructor() {
+        super('Observable already disposed');
+    }
+}
+/**
+ * Defines an ObservableValue value object.
+ *
+ * You can set and get its value with it's *setValue()* and *getValue()* methods and you can subscribe to value changes with *subscribe()*
+ *
+ * Usage example:
+ * ```ts
+ * const observableValue = new ObservableValue<number>(0);
+ * const observer = observableValue.subscribe((newValue) => {
+ * console.log("Value changed:", newValue);
+ * });
+ * // To update the value
+ * observableValue.setValue(Math.random());
+ * // if you want to dispose a single observer
+ * observer.dispose();
+ * // if you want to dispose the whole observableValue with all of its observers:
+ * observableValue.dispose();
+ * ```
+ * @param T Generic argument to indicate the value type
+ */
+export class ObservableValue {
+    get isDisposed() {
+        return this._isDisposed;
+    }
+    /**
+     * Disposes the ObservableValue object, removes all observers
+     */
+    dispose() {
+        this.observers.clear();
+        this._isDisposed = true;
+    }
+    /**
+     * Subscribes to a value changes
+     * @param callback The callback method that will be called on each change
+     * @param getLast Will call the callback with the last known value right after subscription
+     * @returns The ValueObserver instance
+     */
+    subscribe(callback, getLast = false) {
+        if (this._isDisposed) {
+            throw new ObservableAlreadyDisposedError();
+        }
+        const observer = new ValueObserver(this, callback);
+        this.observers.add(observer);
+        if (getLast) {
+            callback(this.currentValue);
+        }
+        return observer;
+    }
+    /**
+     * The observer will unsubscribe from the Observable
+     * @param observer The ValueObserver instance
+     * @returns if unsubscribing was successfull
+     */
+    unsubscribe(observer) {
+        return this.observers.delete(observer);
+    }
+    /**
+     * Gets the current Value
+     * @returns The current value
+     */
+    getValue() {
+        if (this._isDisposed) {
+            throw new ObservableAlreadyDisposedError();
+        }
+        return this.currentValue;
+    }
+    /**
+     * Sets a new value and notifies the observers.
+     * @param newValue The new value to be set
+     */
+    setValue(newValue) {
+        if (this._isDisposed) {
+            throw new ObservableAlreadyDisposedError();
+        }
+        if (this.currentValue !== newValue) {
+            this.currentValue = newValue;
+            for (const subscription of this.observers) {
+                subscription.callback(newValue);
+            }
+        }
+    }
+    /**
+     * Gets the observers
+     * @returns The subscribed observers
+     */
+    getObservers() {
+        return [...this.observers];
+    }
+    /**
+     * @param initialValue Optional initial value
+     */
+    constructor(initialValue) {
+        this._isDisposed = false;
+        this.observers = new Set();
+        if (initialValue !== undefined) {
+            this.currentValue = initialValue;
+        }
+    }
+}
+//# sourceMappingURL=observable-value.js.map

package/esm/observable-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observable-value.js","sourceRoot":"","sources":["../src/observable-value.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD;;GAEG;AACH,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IACvD;QACE,KAAK,CAAC,6BAA6B,CAAC,CAAA;IACtC,CAAC;CACF;AAOD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,eAAe;IAC1B,IAAW,UAAU;QACnB,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;IAID;;OAEG;IACI,OAAO;QACZ,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;QACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;IACzB,CAAC;IAID;;;;;OAKG;IACI,SAAS,CAAC,QAAgC,EAAE,OAAO,GAAG,KAAK;QAChE,IAAI,IAAI,CAAC,WAAW,EAAE;YACpB,MAAM,IAAI,8BAA8B,EAAE,CAAA;SAC3C;QACD,MAAM,QAAQ,GAAG,IAAI,aAAa,CAAI,IAAI,EAAE,QAAQ,CAAC,CAAA;QACrD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC5B,IAAI,OAAO,EAAE;YACX,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;SAC5B;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,QAA0B;QAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACxC,CAAC;IAED;;;OAGG;IACI,QAAQ;QACb,IAAI,IAAI,CAAC,WAAW,EAAE;YACpB,MAAM,IAAI,8BAA8B,EAAE,CAAA;SAC3C;QACD,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;IAED;;;OAGG;IACI,QAAQ,CAAC,QAAW;QACzB,IAAI,IAAI,CAAC,WAAW,EAAE;YACpB,MAAM,IAAI,8BAA8B,EAAE,CAAA;SAC3C;QACD,IAAI,IAAI,CAAC,YAAY,KAAK,QAAQ,EAAE;YAClC,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAA;YAC5B,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,SAAS,EAAE;gBACzC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;aAChC;SACF;IACH,CAAC;IAED;;;OAGG;IACI,YAAY;QACjB,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAoC,CAAA;IAC/D,CAAC;IAED;;OAEG;IACH,YAAY,YAAgB;QA7EpB,gBAAW,GAAG,KAAK,CAAA;QASnB,cAAS,GAA0B,IAAI,GAAG,EAAE,CAAA;QAqElD,IAAI,YAAY,KAAK,SAAS,EAAE;YAC9B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;SACjC;IACH,CAAC;CACF"}

package/esm/path-helper.js

@@ -0,0 +1,66 @@
+/**
+ * Helper class for path-related functions and methods
+ *
+ * The class contains general helper methods for joining, splitting, modifying and validating paths.
+ */
+export class PathHelper {
+    /**
+     * Trims the slash characters from the beginning and from the end of the path to avoid duplicated slashes
+     * @param {string} path The source path that should be trimmed
+     * @returns the trimmed path
+     */
+    static trimSlashes(path) {
+        while (path.endsWith('/')) {
+            path = path.substring(0, path.length - 1);
+        }
+        while (path.startsWith('/')) {
+            path = path.substring(1, path.length);
+        }
+        return path;
+    }
+    /**
+     * Splits a full path into path segments,
+     * e.g.: /Root/Example/stuff
+     * @param path The path to be splitted
+     * @returns {string[]} the segments for the path
+     */
+    static getSegments(path) {
+        return path.split('/').filter((segment) => segment && segment.length);
+    }
+    /**
+     * Method that allows to join paths without multiple or missing slashes
+     * @param args The list of the paths to join
+     * @returns the joined path string
+     */
+    static joinPaths(...args) {
+        return args.map(this.trimSlashes).join('/');
+    }
+    /**
+     * Checks if the ancestorPath is really the ancestor of the descendantPath
+     * @param {string} ancestorPath the ancestor path
+     * @param {string} descendantPath the descendant path
+     * @returns {boolean} if the provided path is the ancestor of the descendant
+     */
+    static isAncestorOf(ancestorPath, descendantPath) {
+        return descendantPath.indexOf(`${this.joinPaths(ancestorPath)}/`) === 0;
+    }
+    /**
+     * Returns the parent path from a specified path.
+     * e.g. "/Root/Example/Content" will return "/Root/Example"
+     *
+     * "Root" will always return "Root"
+     * @param path The content path
+     * @returns the parent path
+     */
+    static getParentPath(path) {
+        const segments = this.getSegments(path);
+        if (segments.length > 1) {
+            segments.pop();
+        }
+        return segments.join('/');
+    }
+    static normalize(path) {
+        return this.getSegments(path).join('/');
+    }
+}
+//# sourceMappingURL=path-helper.js.map

package/esm/path-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-helper.js","sourceRoot":"","sources":["../src/path-helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,UAAU;IACrB;;;;OAIG;IACI,MAAM,CAAC,WAAW,CAAC,IAAY;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;YACzB,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;SAC1C;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;YAC3B,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;SACtC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,WAAW,CAAC,IAAY;QACpC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IACvE,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,SAAS,CAAC,GAAG,IAAc;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC7C,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,YAAY,CAAC,YAAoB,EAAE,cAAsB;QACrE,OAAO,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACzE,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,aAAa,CAAC,IAAY;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QACvC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;YACvB,QAAQ,CAAC,GAAG,EAAE,CAAA;SACf;QACD,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC;IAEM,MAAM,CAAC,SAAS,CAAC,IAAY;QAClC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACzC,CAAC;CACF"}

package/esm/sleep-async.js

@@ -0,0 +1,8 @@
+/**
+ * Returns a simple promise that will be resolved within a discrete timeout
+ * @param timeout The timeout in millisecs
+ */
+export const sleepAsync = (timeout = 250) => new Promise((resolve) => setTimeout(() => {
+    resolve();
+}, timeout));
+//# sourceMappingURL=sleep-async.js.map

package/esm/sleep-async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep-async.js","sourceRoot":"","sources":["../src/sleep-async.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,EAAE,CAC1C,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAC5B,UAAU,CAAC,GAAG,EAAE;IACd,OAAO,EAAE,CAAA;AACX,CAAC,EAAE,OAAO,CAAC,CACZ,CAAA"}

package/esm/sort-by.js

@@ -0,0 +1,15 @@
+export const compareBy = (entity1, entity2, field, direction) => {
+    const a = direction === 'asc' ? entity1 : entity2;
+    const b = direction === 'asc' ? entity2 : entity1;
+    if (a[field] < b[field]) {
+        return -1;
+    }
+    if (a[field] > b[field]) {
+        return 1;
+    }
+    return 0;
+};
+Array.prototype.sortBy = function (key, direction = 'asc') {
+    return this.sort((a, b) => compareBy(a, b, key, direction));
+};
+//# sourceMappingURL=sort-by.js.map

package/esm/sort-by.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-by.js","sourceRoot":"","sources":["../src/sort-by.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,SAAS,GAAG,CAAuB,OAAU,EAAE,OAAU,EAAE,KAAQ,EAAE,SAAyB,EAAE,EAAE;IAC7G,MAAM,CAAC,GAAG,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;IACjD,MAAM,CAAC,GAAG,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;IACjD,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE;QACvB,OAAO,CAAC,CAAC,CAAA;KACV;IACD,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE;QACvB,OAAO,CAAC,CAAA;KACT;IACD,OAAO,CAAC,CAAA;AACV,CAAC,CAAA;AAED,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,UAAU,GAAG,EAAE,SAAS,GAAG,KAAK;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAA;AAC7D,CAAC,CAAA"}

package/esm/trace.js

@@ -0,0 +1,127 @@
+import { ObservableValue } from './observable-value';
+/**
+ * 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)
+ *     }
+ * });
+ * ```
+ */
+class Trace {
+    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(),
+                finishedObservable: new ObservableValue(),
+                errorObservable: new ObservableValue(),
+            });
+        }
+        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()),
+        };
+    }
+}
+Trace.objectTraces = new Map();
+export { Trace };
+//# sourceMappingURL=trace.js.map

package/esm/trace.js.map

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

package/esm/tuple.js

@@ -0,0 +1,7 @@
+/**
+ * Factory method for creating a Tuple instance.
+ * @param args The argument list to create
+ * @returns alma asd
+ */
+export const tuple = (...args) => args;
+//# sourceMappingURL=tuple.js.map

package/esm/tuple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tuple.js","sourceRoot":"","sources":["../src/tuple.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAqB,GAAG,IAAO,EAAE,EAAE,CAAC,IAAI,CAAA"}

package/esm/value-observer.js

@@ -0,0 +1,40 @@
+/**
+ * Defines a generic ValueObserver instance
+ *
+ * A ValueObserver is created whenever you subscribe for an *ObservableValue* changes.
+ *
+ * Usage example:
+ * ```ts
+ *
+ * const observableValue = new ObservableValue<number>(0);
+ * const observer = observableValue.subscribe((newValue) => {
+ * console.log("Value changed:", newValue);
+ * });
+ *
+ * // To update the value
+ * observableValue.setValue(Math.random());
+ * // if you want to dispose a single observer
+ * observer.dispose();
+ * // if you want to dispose the whole observableValue with all of its observers:
+ * observableValue.dispose();
+ * ```
+ * @param T This type parameter is the value type to observe
+ */
+export class ValueObserver {
+    /**
+     * Disposes the ValueObserver instance. Unsubscribes from the observable
+     */
+    dispose() {
+        this.observable.unsubscribe(this);
+    }
+    /**
+     * @constructs ValueObserver<T> the ValueObserver instance
+     * @param observable The related Observable object
+     * @param callback The callback that will be fired on change
+     */
+    constructor(observable, callback) {
+        this.observable = observable;
+        this.callback = callback;
+    }
+}
+//# sourceMappingURL=value-observer.js.map

package/esm/value-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-observer.js","sourceRoot":"","sources":["../src/value-observer.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,aAAa;IACxB;;OAEG;IACI,OAAO;QACZ,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC;IAED;;;;OAIG;IACH,YAA4B,UAA8B,EAAS,QAAgC;QAAvE,eAAU,GAAV,UAAU,CAAoB;QAAS,aAAQ,GAAR,QAAQ,CAAwB;IAAG,CAAC;CACxG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@furystack/utils",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "General utilities",
   "type": "module",
   "scripts": {
@@ -21,7 +21,7 @@
     }
   },
   "files": [
-    "dist",
+    "esm",
     "types",
     "src"
   ],