@zajno/common 2.3.17 → 2.4.0

package/esm/dates/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/dates/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAQlC,MAAM,KAAW,WAAW,CAqD3B;AArDD,WAAiB,WAAW;IAUxB,IAAiB,QAAQ,CA0CxB;IA1CD,WAAiB,QAAQ;QAErB,SAAgB,IAAI,CAAC,CAAuB;YACxC,QAAQ,CAAC,EAAE,CAAC;gBACR,KAAK,aAAa,CAAC,CAAC,CAAC;oBACjB,OAAO,CAAC,CAAC;gBACb,CAAC;gBACD,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACZ,OAAO,IAAI,CAAC;gBAChB,CAAC;gBACD,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACZ,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC/B,CAAC;gBACD,KAAK,MAAM,CAAC,CAAC,CAAC;oBACV,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC/B,CAAC;gBACD,KAAK,KAAK,CAAC,CAAC,CAAC;oBACT,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC7B,CAAC;gBACD,KAAK,MAAM,CAAC,CAAC,CAAC;oBACV,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC3B,CAAC;gBACD,OAAO,CAAC,CAAC,CAAC;oBACN,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;gBAC/C,CAAC;YACL,CAAC;QACL,CAAC;QAxBe,aAAI,OAwBnB,CAAA;QAED,SAAgB,OAAO,CAAC,MAAc,EAAE,CAAuB,EAAE,EAAwB;YACrF,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;YACtB,OAAO,EAAE,GAAG,IAAI,CAAC;QACrB,CAAC;QAJe,gBAAO,UAItB,CAAA;QAED,SAAgB,KAAK,CAAC,IAAmB,EAAE,MAAc,EAAE,WAAiC;YACxF,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1B,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,GAAG,CAAC;YACf,CAAC;YAED,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QAChE,CAAC;QAPe,cAAK,QAOpB,CAAA;IACL,CAAC,EA1CgB,QAAQ,GAAR,oBAAQ,KAAR,oBAAQ,QA0CxB;AACL,CAAC,EArDgB,WAAW,KAAX,WAAW,QAqD3B"}

package/esm/dates/tz.js

@@ -0,0 +1,49 @@
+/** This is experimental stuff, so no tests provided, see comments in the code */
+export var Timezones;
+(function (Timezones) {
+    Timezones.Current = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    Timezones.CurrentOffset = new Date().getTimezoneOffset();
+    // https://stackoverflow.com/a/64262840/9053142
+    // tested locally, but it's hard to write tests since they are based on the local timezone, browser implementation and whether DST is active
+    // it's recommended to wrap with try/catch and don't rely it will always work
+    Timezones.getOffset = (timeZone) => {
+        const timeZoneName = Intl.DateTimeFormat('ia', {
+            timeZoneName: 'longOffset',
+            timeZone,
+        })
+            .formatToParts()
+            .find((i) => i.type === 'timeZoneName')
+            ?.value;
+        const offset = timeZoneName?.slice(3);
+        if (!offset) {
+            return 0;
+        }
+        const matchData = offset.match(/([+-])(\d+)(?::(\d+))?/);
+        if (!matchData) {
+            throw new Error(`cannot parse timezone name: ${timeZoneName} given from ${timeZone}`);
+        }
+        const [, sign, hour, minute] = matchData;
+        let result = parseInt(hour, 10) * 60;
+        if (minute) {
+            result += parseInt(minute, 10);
+        }
+        if (sign === '+') {
+            result *= -1;
+        }
+        return result;
+    };
+    // Tests may look like this:
+    /*
+        expect(Timezones.getOffset('America/New_York')).toBe(240);
+        expect(Timezones.getOffset('Europe/Paris')).toBe(-120);
+        expect(Timezones.getOffset('Europe/Kiev')).toBe(-180);
+        expect(Timezones.getOffset('Asia/Kolkata')).toBe(-270);
+    */
+    function shiftToTimeZone(date, tz) {
+        const offset = typeof tz === 'number' ? tz : Timezones.getOffset(tz);
+        const shifted = new Date(date.getTime() + offset * 60 * 1000);
+        return shifted;
+    }
+    Timezones.shiftToTimeZone = shiftToTimeZone;
+})(Timezones || (Timezones = {}));
+//# sourceMappingURL=tz.js.map

package/esm/dates/tz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tz.js","sourceRoot":"","sources":["../../../src/dates/tz.ts"],"names":[],"mappings":"AACA,iFAAiF;AACjF,MAAM,KAAW,SAAS,CAoDzB;AApDD,WAAiB,SAAS;IAET,iBAAO,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC;IAC3D,uBAAa,GAAG,IAAI,IAAI,EAAE,CAAC,iBAAiB,EAAE,CAAC;IAE5D,+CAA+C;IAC/C,4IAA4I;IAC5I,6EAA6E;IAChE,mBAAS,GAAG,CAAC,QAAgB,EAAE,EAAE;QAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE;YAC3C,YAAY,EAAE,YAAY;YAC1B,QAAQ;SACX,CAAC;aACG,aAAa,EAAE;aACf,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC;YACvC,EAAE,KAAK,CAAC;QAEZ,MAAM,MAAM,GAAG,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,CAAC,CAAC;QACb,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACzD,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,+BAA+B,YAAY,eAAe,QAAQ,EAAE,CAAC,CAAC;QAC1F,CAAC;QAED,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;QACzC,IAAI,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC;QACrC,IAAI,MAAM,EAAE,CAAC;YACT,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,CAAC,CAAC;QACjB,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;IAEF,4BAA4B;IAC5B;;;;;MAKE;IAEF,SAAgB,eAAe,CAAC,IAAU,EAAE,EAAmB;QAC3D,MAAM,MAAM,GAAG,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAA,SAAS,CAAC,EAAE,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC9D,OAAO,OAAO,CAAC;IACnB,CAAC;IAJe,yBAAe,kBAI9B,CAAA;AACL,CAAC,EApDgB,SAAS,KAAT,SAAS,QAoDzB"}

package/esm/dates/yearDate.js

@@ -0,0 +1,35 @@
+import { getDate } from './parse';
+export var YearDate;
+(function (YearDate) {
+    function isValid(yd) {
+        return yd && typeof yd.day === 'number' && typeof yd.month === 'number';
+    }
+    YearDate.isValid = isValid;
+    function matches(yearDate, date, local = false) {
+        const d = getDate(date);
+        return local
+            ? d.getMonth() === yearDate?.month && d.getDate() === yearDate?.day
+            : d.getUTCMonth() === yearDate?.month && d.getUTCDate() === yearDate?.day;
+    }
+    YearDate.matches = matches;
+    function toDate(yd, year = new Date().getUTCFullYear()) {
+        if (!yd) {
+            return null;
+        }
+        return new Date(Date.UTC(year, yd.month || 0, yd.day || 1, 12));
+    }
+    YearDate.toDate = toDate;
+    function fromDate(date) {
+        const d = getDate(date);
+        return {
+            month: d.getUTCMonth(),
+            day: d.getUTCDate(),
+        };
+    }
+    YearDate.fromDate = fromDate;
+    function equals(yd1, yd2) {
+        return yd1?.month === yd2?.month && yd1?.day === yd1?.month;
+    }
+    YearDate.equals = equals;
+})(YearDate || (YearDate = {}));
+//# sourceMappingURL=yearDate.js.map

package/esm/dates/yearDate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yearDate.js","sourceRoot":"","sources":["../../../src/dates/yearDate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAKlC,MAAM,KAAW,QAAQ,CA8BxB;AA9BD,WAAiB,QAAQ;IACrB,SAAgB,OAAO,CAAC,EAAY;QAChC,OAAO,EAAE,IAAI,OAAO,EAAE,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,EAAE,CAAC,KAAK,KAAK,QAAQ,CAAC;IAC5E,CAAC;IAFe,gBAAO,UAEtB,CAAA;IAED,SAAgB,OAAO,CAAC,QAAkB,EAAE,IAAmB,EAAE,KAAK,GAAG,KAAK;QAC1E,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACxB,OAAO,KAAK;YACR,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,QAAQ,EAAE,GAAG;YACnE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC,UAAU,EAAE,KAAK,QAAQ,EAAE,GAAG,CAAC;IAClF,CAAC;IALe,gBAAO,UAKtB,CAAA;IAED,SAAgB,MAAM,CAAC,EAAY,EAAE,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,cAAc,EAAE;QACnE,IAAI,CAAC,EAAE,EAAE,CAAC;YACN,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACpE,CAAC;IALe,eAAM,SAKrB,CAAA;IAED,SAAgB,QAAQ,CAAC,IAAmB;QACxC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACxB,OAAO;YACH,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE;YACtB,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE;SACtB,CAAC;IACN,CAAC;IANe,iBAAQ,WAMvB,CAAA;IAED,SAAgB,MAAM,CAAC,GAAa,EAAE,GAAa;QAC/C,OAAO,GAAG,EAAE,KAAK,KAAK,GAAG,EAAE,KAAK,IAAI,GAAG,EAAE,GAAG,KAAK,GAAG,EAAE,KAAK,CAAC;IAChE,CAAC;IAFe,eAAM,SAErB,CAAA;AACL,CAAC,EA9BgB,QAAQ,KAAR,QAAQ,QA8BxB"}

package/esm/fields/filter.js

@@ -0,0 +1,25 @@
+export function filterFields(source, ...fields) {
+    const res = {};
+    fields.forEach(k => {
+        if (typeof k === 'object') {
+            const v = source[k.key];
+            if (k.filter(v)) {
+                res[k.key] = v;
+            }
+        }
+        else {
+            const v = source[k];
+            if (v) {
+                res[k] = v;
+            }
+        }
+    });
+    return res;
+}
+(function (filterFields) {
+    function Truethy() { return (v) => !!v; }
+    filterFields.Truethy = Truethy;
+    function NotNull() { return v => v != null; }
+    filterFields.NotNull = NotNull;
+})(filterFields || (filterFields = {}));
+//# sourceMappingURL=filter.js.map

package/esm/fields/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/fields/filter.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,YAAY,CAAI,MAAkB,EAAE,GAAG,MAA+D;IAClH,MAAM,GAAG,GAAe,EAAG,CAAC;IAE5B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QACf,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;gBACd,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,EAAE,CAAC;gBACJ,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACf,CAAC;QACL,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACf,CAAC;AAED,WAAiB,YAAY;IACzB,SAAgB,OAAO,KAAwB,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAAnD,oBAAO,UAA4C,CAAA;IACnE,SAAgB,OAAO,KAAwB,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IAAvD,oBAAO,UAAgD,CAAA;AAC3E,CAAC,EAHgB,YAAY,KAAZ,YAAY,QAG5B"}

package/esm/fields/index.js

@@ -0,0 +1,4 @@
+export * from './filter';
+export * from './update';
+export * from './transfer';
+//# sourceMappingURL=index.js.map

package/esm/fields/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/fields/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/esm/fields/skip.js

@@ -0,0 +1,29 @@
+export var SkipOptions;
+(function (SkipOptions) {
+    function shouldSkip(v, skip) {
+        if (v == null && skip === 'null') {
+            return true;
+        }
+        if (!v && (skip === 'falsy' || skip === true)) {
+            return true;
+        }
+        return false;
+    }
+    SkipOptions.shouldSkip = shouldSkip;
+})(SkipOptions || (SkipOptions = {}));
+export var SkipCondition;
+(function (SkipCondition) {
+    function shouldSkip(condition, key, val) {
+        if (typeof condition === 'function') {
+            if (condition(key, val)) {
+                return true;
+            }
+        }
+        else if (SkipOptions.shouldSkip(val, condition)) {
+            return true;
+        }
+        return false;
+    }
+    SkipCondition.shouldSkip = shouldSkip;
+})(SkipCondition || (SkipCondition = {}));
+//# sourceMappingURL=skip.js.map

package/esm/fields/skip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skip.js","sourceRoot":"","sources":["../../../src/fields/skip.ts"],"names":[],"mappings":"AAUA,MAAM,KAAW,WAAW,CAW3B;AAXD,WAAiB,WAAW;IACxB,SAAgB,UAAU,CAAU,CAAW,EAAE,IAAiB;QAC9D,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YAC5C,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IATe,sBAAU,aASzB,CAAA;AACL,CAAC,EAXgB,WAAW,KAAX,WAAW,QAW3B;AAID,MAAM,KAAW,aAAa,CAY7B;AAZD,WAAiB,aAAa;IAC1B,SAAgB,UAAU,CAAoC,SAAiC,EAAE,GAAS,EAAE,GAAmB;QAC3H,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;YAClC,IAAI,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;aAAM,IAAI,WAAW,CAAC,UAAU,CAAU,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC;YACzD,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,KAAK,CAAC;IACjB,CAAC;IAVe,wBAAU,aAUzB,CAAA;AACL,CAAC,EAZgB,aAAa,KAAb,aAAa,QAY7B"}

package/esm/fields/transfer.js

@@ -0,0 +1,41 @@
+export function transferFields(source, predicate, destination, ...fields) {
+    let count = 0;
+    fields.forEach(f => {
+        const v = source[f];
+        if (!predicate || predicate(f, v)) {
+            destination[f] = v;
+            ++count;
+        }
+    });
+    return count;
+}
+(function (transferFields) {
+    function truthy(source, destination, ...fields) {
+        return transferFields(source, (f, v) => !!v, destination, ...fields);
+    }
+    transferFields.truthy = truthy;
+    function notNull(source, destination, ...fields) {
+        return transferFields(source, (f, v) => v != null, destination, ...fields);
+    }
+    transferFields.notNull = notNull;
+    function defined(source, destination, ...fields) {
+        return transferFields(source, (f, v) => v !== undefined, destination, ...fields);
+    }
+    transferFields.defined = defined;
+    function changed(source, compare, destination, ...fields) {
+        return transferFields(source, (f, v) => v !== undefined && source[f] !== compare[f], destination, ...fields);
+    }
+    transferFields.changed = changed;
+})(transferFields || (transferFields = {}));
+export function hasChangedFields(left, right, ...fields) {
+    return fields.some(f => left[f] !== right[f]);
+}
+export function extractChangedFields(source, image, ...fields) {
+    const res = {};
+    const count = transferFields(source, (f, v) => v !== undefined && v !== image[f], res, ...fields);
+    return {
+        transferred: count,
+        result: res,
+    };
+}
+//# sourceMappingURL=transfer.js.map

package/esm/fields/transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.js","sourceRoot":"","sources":["../../../src/fields/transfer.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,cAAc,CAC1B,MAAS,EACT,SAAiD,EACjD,WAAuB,EACvB,GAAG,MAAmB;IAEtB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QACf,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAChC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACnB,EAAE,KAAK,CAAC;QACZ,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,WAAiB,cAAc;IAC3B,SAAgB,MAAM,CAClB,MAAS,EACT,WAAuB,EACvB,GAAG,MAAmB;QAEtB,OAAO,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,CAAC;IACzE,CAAC;IANe,qBAAM,SAMrB,CAAA;IAED,SAAgB,OAAO,CACnB,MAAS,EACT,WAAuB,EACvB,GAAG,MAAmB;QAEtB,OAAO,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,CAAC;IAC/E,CAAC;IANe,sBAAO,UAMtB,CAAA;IAED,SAAgB,OAAO,CACnB,MAAS,EACT,WAAuB,EACvB,GAAG,MAAmB;QAEtB,OAAO,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,CAAC;IACrF,CAAC;IANe,sBAAO,UAMtB,CAAA;IAED,SAAgB,OAAO,CACnB,MAAS,EACT,OAAU,EACV,WAAuB,EACvB,GAAG,MAAmB;QAEtB,OAAO,cAAc,CACjB,MAAM,EACN,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EACrD,WAAW,EACX,GAAG,MAAM,CACZ,CAAC;IACN,CAAC;IAZe,sBAAO,UAYtB,CAAA;AACL,CAAC,EAtCgB,cAAc,KAAd,cAAc,QAsC9B;AAED,MAAM,UAAU,gBAAgB,CAAI,IAAO,EAAE,KAAQ,EAAE,GAAG,MAAmB;IACzE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAOD,MAAM,UAAU,oBAAoB,CAChC,MAAkB,EAClB,KAAQ,EACR,GAAG,MAAmB;IAEtB,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,cAAc,CACxB,MAAM,EACN,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAC3C,GAAG,EACH,GAAG,MAAM,CACZ,CAAC;IACF,OAAO;QACH,WAAW,EAAE,KAAK;QAClB,MAAM,EAAE,GAAG;KACd,CAAC;AACN,CAAC"}

package/esm/fields/update.js

@@ -0,0 +1,73 @@
+export function updateField(target, source, diff, key, hasChanged = null) {
+    return updateFieldExtended(target, source, diff, t => t[key], (t, v) => t[key] = v, hasChanged);
+}
+export function updateFieldExtended(target, source, diff, get, set, hasChanged = null) {
+    const _hasChanged = hasChanged ?? ((v1, v2) => (get(v1) !== get(v2)));
+    let changed = true;
+    if (get(source) !== undefined && _hasChanged(source, target)) {
+        changed = true;
+        set(diff, get(target));
+        set(target, get(source));
+    }
+    return changed;
+}
+const DefaultComparator = (v1, v2) => v1 === v2;
+const DefaultUpdater = (v1, v2) => Object.assign(v1, v2);
+export function updateArray(target, source, options) {
+    if (!source) {
+        return { changed: 0, result: target };
+    }
+    let changed = 0;
+    const result = Array.isArray(target)
+        ? (options?.clone ? target.slice() : target)
+        : [];
+    const comparator = options?.comparator || DefaultComparator;
+    const updater = options?.updater || DefaultUpdater;
+    const onDeleted = options?.hooks?.onDeleted;
+    const onUpdate = options?.hooks?.onUpdated;
+    const onAdded = options?.hooks?.onAdded;
+    // remove all missing elements
+    if (!options?.additive) {
+        for (let i = 0; i < result.length; ++i) {
+            if (source.find(item => comparator(item, result[i])) == null) {
+                // DELETE
+                const removed = result.splice(i, 1);
+                onDeleted?.(removed[0], i);
+                ++changed;
+                --i;
+            }
+        }
+    }
+    const unshift = options?.unshift || false;
+    // add all new elements and update existing
+    source.forEach(item => {
+        const existingIndex = result.findIndex(i => comparator(item, i));
+        const existingItem = result[existingIndex];
+        if (existingIndex < 0) {
+            if (unshift) {
+                result.unshift(item);
+            }
+            else {
+                result.push(item);
+            }
+            onAdded?.(item, unshift ? 0 : result.length - 1);
+            ++changed;
+        }
+        else if (typeof existingItem === 'object') {
+            const before = onUpdate != null ? { ...existingItem } : undefined;
+            result[existingIndex] = updater(existingItem, item);
+            if (onUpdate != null) {
+                onUpdate(before, result[existingIndex], existingIndex);
+            }
+        }
+    });
+    const sorter = options?.sorter;
+    if (sorter !== null) {
+        result.sort(sorter || undefined);
+    }
+    return {
+        result,
+        changed,
+    };
+}
+//# sourceMappingURL=update.js.map

package/esm/fields/update.js.map

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

package/esm/functions/assert.js

@@ -0,0 +1,16 @@
+import { Getter } from '../types';
+import logger from '../logger';
+export function assert(condition, error, objectToLog) {
+    if (condition) {
+        return;
+    }
+    const e = Getter.getValue(error);
+    if (objectToLog) {
+        logger.error('Assertion failed:', e, Getter.getValue(objectToLog));
+    }
+    if (typeof e === 'string') {
+        throw new Error(e);
+    }
+    throw e;
+}
+//# sourceMappingURL=assert.js.map

package/esm/functions/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../../src/functions/assert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,MAAM,MAAM,WAAW,CAAC;AAE/B,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,KAA6B,EAAE,WAAyB;IAC/F,IAAI,SAAS,EAAE,CAAC;QACZ,OAAO;IACX,CAAC;IAED,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,WAAW,EAAE,CAAC;QACd,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,CAAC;AACZ,CAAC"}

package/esm/functions/disposer.js

@@ -0,0 +1,66 @@
+import logger from '../logger';
+export class Disposer {
+    _disposers = [];
+    _map = new Map();
+    _loggerName = null;
+    constructor(loggerName = null) {
+        this._loggerName = loggerName;
+    }
+    setLoggerName(loggerName) {
+        this._loggerName = loggerName;
+        return this;
+    }
+    add(d, id) {
+        if (!d) {
+            return;
+        }
+        const dd = typeof d !== 'function'
+            ? (() => d.dispose ? d.dispose() : null)
+            : d;
+        this._disposers.push(dd);
+        if (id) {
+            // dispose previous identified disposer
+            if (this._map.has(id)) {
+                this.execute(id);
+            }
+            this._map.set(id, dd);
+        }
+    }
+    execute(id) {
+        const d = this._map.get(id);
+        if (!d) {
+            return;
+        }
+        this._map.delete(id);
+        const i = this._disposers.indexOf(d);
+        if (i >= 0) {
+            this._disposers.splice(i, 1);
+        }
+        d();
+    }
+    dispose(log = false) {
+        if (log) {
+            logger.log(`[Disposer:${this._loggerName || '<unknown>'}] Disposing ${this._disposers.length} items including named ones:`, Array.from(this._map.entries()).map(e => e[0]));
+        }
+        const copy = this._disposers.slice().reverse();
+        this._disposers.length = 0;
+        this._map.clear();
+        // this should separate side effects
+        copy.forEach(d => d());
+    }
+}
+export function combineDisposers(...items) {
+    return () => items.forEach(i => i());
+}
+export class Disposable {
+    disposer;
+    _isDisposed = false;
+    constructor(loggerName = null) {
+        this.disposer = new Disposer(loggerName);
+    }
+    dispose = () => {
+        this._isDisposed = true;
+        this.disposer.dispose();
+    };
+}
+//# sourceMappingURL=disposer.js.map

package/esm/functions/disposer.js.map

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

package/esm/functions/disposer.symbols.js

@@ -0,0 +1,24 @@
+// Symbol.dispose ??= Symbol('Symbol.dispose');
+if (!('dispose' in Symbol)) {
+    // @ts-expect-error polyfill for Symbol.dispose
+    Symbol.dispose = Symbol('Symbol.dispose');
+}
+// Symbol.asyncDispose ??= Symbol('Symbol.asyncDispose');
+if (!('asyncDispose' in Symbol)) {
+    // @ts-expect-error polyfill for Symbol.asyncDispose
+    Symbol.asyncDispose = Symbol('Symbol.asyncDispose');
+}
+// for demonstration purposes, but use as base class if needed
+export class SymbolDisposable {
+    [Symbol.dispose] = () => this.dispose();
+}
+export function makeSymbolDisposable(obj) {
+    const fn = () => obj.dispose();
+    Object.defineProperty(obj, Symbol.dispose, {
+        get() {
+            return fn;
+        },
+    });
+    return obj;
+}
+//# sourceMappingURL=disposer.symbols.js.map

package/esm/functions/disposer.symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposer.symbols.js","sourceRoot":"","sources":["../../../src/functions/disposer.symbols.ts"],"names":[],"mappings":"AAEA,+CAA+C;AAC/C,IAAI,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,EAAE,CAAC;IACzB,+CAA+C;IAC/C,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAC9C,CAAC;AAED,yDAAyD;AACzD,IAAI,CAAC,CAAC,cAAc,IAAI,MAAM,CAAC,EAAE,CAAC;IAC9B,oDAAoD;IACpD,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AACxD,CAAC;AAED,8DAA8D;AAC9D,MAAM,OAAgB,gBAAgB;IAElC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;CAG3C;AAGD,MAAM,UAAU,oBAAoB,CAAwB,GAAM;IAC9D,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAE/B,MAAM,CAAC,cAAc,CACjB,GAAG,EACH,MAAM,CAAC,OAAO,EACd;QACI,GAAG;YACC,OAAO,EAAE,CAAC;QACd,CAAC;KACJ,CACJ,CAAC;IAEF,OAAO,GAA2B,CAAC;AACvC,CAAC"}

package/esm/functions/safe.js

@@ -0,0 +1,4 @@
+export function catchPromise(promise, cb) {
+    Promise.resolve(promise).catch(err => cb?.(err));
+}
+//# sourceMappingURL=safe.js.map

package/esm/functions/safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe.js","sourceRoot":"","sources":["../../../src/functions/safe.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,YAAY,CAAC,OAA4B,EAAE,EAAuB;IAC9E,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/esm/functions/throttle.js

@@ -0,0 +1,132 @@
+import { createManualPromise } from '../async/misc';
+import { createLogger } from '../logger';
+import { random } from '../math';
+import { catchPromise } from './safe';
+/** Runs a callback after a timeout, ignoring all consecutive calls until the first is processed.  */
+export class ThrottleAction {
+    timeout;
+    _timeoutRef = null;
+    _postponedCb = null;
+    _locked = false;
+    _logger = null;
+    /**
+     * In case previous action has started processing but not finished yet, and the following one is going to start,
+     * this flag allows to run the second in parallel.
+      */
+    _allowParallelRuns = false;
+    _currentRun = null;
+    constructor(timeout = 1000) {
+        this.timeout = timeout;
+    }
+    useParallelRuns() {
+        this._allowParallelRuns = true;
+        return this;
+    }
+    useLogger(logger) {
+        if (typeof logger === 'string') {
+            this._logger = createLogger(logger);
+        }
+        else {
+            this._logger = logger;
+        }
+        return this;
+    }
+    clear() {
+        if (this._timeoutRef) {
+            clearTimeout(this._timeoutRef);
+        }
+        this._timeoutRef = null;
+        this._postponedCb = null;
+    }
+    tryRun(cb, restartTimeout = false) {
+        if (!this._timeoutRef) { // start new timeout
+            if (!this._currentRun) {
+                this._currentRun = createManualPromise();
+            }
+            const result = this._currentRun.promise;
+            this._postponedCb = cb;
+            this._timeoutRef = setTimeout(() => catchPromise(this.forceRun()), this.timeout);
+            return result;
+        }
+        if (restartTimeout) {
+            this.clear();
+            return this.tryRun(cb, false);
+        }
+        return this.getPromise();
+    }
+    forceRun = async () => {
+        const cb = this._postponedCb;
+        const p = this._currentRun;
+        this._currentRun = null;
+        this.clear();
+        if (!this._allowParallelRuns && this._locked) {
+            // This happening when the previous call is still running, while the new one has finished its timeout and is willing to run.
+            // This is probably OK since the running call should cover the current one.
+            // TODO Maybe just don't start timeout if the lock is set?
+            // The reason for not doing that 👆 is there's still a valid case when previous is still working but it's legit to start a new one (e.g. some state has changed already)
+            this._logger?.warn('[ThrottleAction] THROTTLE LOCKED, but another call is forced. Skipping since the behavior is undefined.');
+        }
+        else if (cb) {
+            let result = undefined;
+            const lockId = random(1, 1_000_000);
+            try {
+                this._locked = lockId;
+                result = await cb();
+                p?.resolve(result);
+                return result;
+            }
+            catch (err) {
+                p?.reject(err);
+                return undefined;
+            }
+            finally {
+                if (this._locked === lockId) {
+                    this._locked = false;
+                }
+            }
+        }
+    };
+    getPromise() {
+        return this._currentRun?.promise || Promise.resolve(undefined);
+    }
+}
+export class ThrottleProcessor {
+    process;
+    _queue = [];
+    _action;
+    _promise = null;
+    constructor(process, timeout = 1000) {
+        this.process = process;
+        if (!process) {
+            throw new Error('Arg0 expected: process');
+        }
+        this._action = new ThrottleAction(timeout)
+            .useParallelRuns();
+    }
+    useLogger(logger) {
+        this._action.useLogger(logger);
+        return this;
+    }
+    async push(data) {
+        const index = this._queue.push(data) - 1;
+        const res = await this._action.tryRun(this._process, true);
+        return {
+            result: res,
+            index,
+        };
+    }
+    _process = async () => {
+        if (!this._queue.length) {
+            return;
+        }
+        const objs = this._queue.slice();
+        this._queue.length = 0;
+        return this.process(objs);
+    };
+    clear() {
+        this._action.clear();
+        this._promise?.resolve(undefined);
+        this._promise = null;
+    }
+}
+//# sourceMappingURL=throttle.js.map

package/esm/functions/throttle.js.map

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

package/esm/lazy/light.js

@@ -0,0 +1,20 @@
+export function createLazy(factory) {
+    const _factory = factory;
+    let _instance = undefined;
+    const res = {
+        get value() {
+            if (_instance === undefined) {
+                _instance = _factory();
+            }
+            return _instance;
+        },
+        get currentValue() { return _instance; },
+        get hasValue() { return _instance !== undefined; },
+        reset: () => {
+            _instance = undefined;
+        },
+        dispose: () => res.reset(),
+    };
+    return res;
+}
+//# sourceMappingURL=light.js.map

package/esm/lazy/light.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"light.js","sourceRoot":"","sources":["../../../src/lazy/light.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAI,OAAgB;IAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC;IACzB,IAAI,SAAS,GAAkB,SAAS,CAAC;IAEzC,MAAM,GAAG,GAAa;QAClB,IAAI,KAAK;YACL,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC1B,SAAS,GAAG,QAAQ,EAAE,CAAC;YAC3B,CAAC;YACD,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,IAAI,YAAY,KAAK,OAAO,SAAS,CAAC,CAAC,CAAC;QACxC,IAAI,QAAQ,KAAK,OAAO,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC;QAClD,KAAK,EAAE,GAAG,EAAE;YACR,SAAS,GAAG,SAAS,CAAC;QAC1B,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE;KAC7B,CAAC;IAEF,OAAO,GAAG,CAAC;AACf,CAAC"}