@ezez/utils 2.1.0 → 4.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +37 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +7 -0
- package/dist/index.js.map +1 -1
- package/dist/omit.d.ts +1 -1
- package/dist/omit.d.ts.map +1 -1
- package/dist/omit.js.map +1 -1
- package/dist/replace.d.ts.map +1 -1
- package/dist/replace.js.map +1 -1
- package/dist/replaceDeep.d.ts +5 -1
- package/dist/replaceDeep.d.ts.map +1 -1
- package/dist/replaceDeep.js +3 -20
- package/dist/replaceDeep.js.map +1 -1
- package/dist/replaceDeepByFn.d.ts +7 -0
- package/dist/replaceDeepByFn.d.ts.map +1 -0
- package/dist/replaceDeepByFn.js +47 -0
- package/dist/replaceDeepByFn.js.map +1 -0
- package/dist/safe.d.ts.map +1 -1
- package/dist/safe.js.map +1 -1
- package/dist/sample.d.ts +3 -0
- package/dist/sample.d.ts.map +1 -0
- package/dist/sample.js +8 -0
- package/dist/sample.js.map +1 -0
- package/dist/samples.d.ts +3 -0
- package/dist/samples.d.ts.map +1 -0
- package/dist/samples.js +28 -0
- package/dist/samples.js.map +1 -0
- package/dist/serialize.d.ts.map +1 -1
- package/dist/serialize.js +56 -18
- package/dist/serialize.js.map +1 -1
- package/dist/shuffle.d.ts +3 -0
- package/dist/shuffle.d.ts.map +1 -0
- package/dist/shuffle.js +9 -0
- package/dist/shuffle.js.map +1 -0
- package/dist/toggle.d.ts +3 -0
- package/dist/toggle.d.ts.map +1 -0
- package/dist/toggle.js +15 -0
- package/dist/toggle.js.map +1 -0
- package/dist/trim.d.ts +3 -0
- package/dist/trim.d.ts.map +1 -0
- package/dist/trim.js +10 -0
- package/dist/trim.js.map +1 -0
- package/dist/trimEnd.d.ts +3 -0
- package/dist/trimEnd.d.ts.map +1 -0
- package/dist/trimEnd.js +12 -0
- package/dist/trimEnd.js.map +1 -0
- package/dist/trimStart.d.ts +3 -0
- package/dist/trimStart.d.ts.map +1 -0
- package/dist/trimStart.js +12 -0
- package/dist/trimStart.js.map +1 -0
- package/dist/utils/utils.d.ts +6 -0
- package/dist/utils/utils.d.ts.map +1 -0
- package/dist/utils/utils.js +10 -0
- package/dist/utils/utils.js.map +1 -0
- package/dist/waitFor.d.ts +7 -1
- package/dist/waitFor.d.ts.map +1 -1
- package/dist/waitFor.js +35 -10
- package/dist/waitFor.js.map +1 -1
- package/docs/assets/search.js +1 -1
- package/docs/functions/cap.html +12 -5
- package/docs/functions/capitalize.html +12 -5
- package/docs/functions/coalesce.html +12 -5
- package/docs/functions/compareArrays.html +12 -5
- package/docs/functions/compareProps.html +12 -5
- package/docs/functions/deserialize.html +12 -5
- package/docs/functions/ensureArray.html +12 -5
- package/docs/functions/ensureDate.html +12 -5
- package/docs/functions/ensureError.html +12 -5
- package/docs/functions/ensurePrefix.html +12 -5
- package/docs/functions/ensureSuffix.html +12 -5
- package/docs/functions/ensureTimestamp.html +12 -5
- package/docs/functions/escapeRegExp.html +12 -5
- package/docs/functions/formatDate.html +12 -5
- package/docs/functions/get.html +12 -5
- package/docs/functions/getMultiple.html +12 -5
- package/docs/functions/insertSeparator.html +12 -5
- package/docs/functions/isEmpty.html +12 -5
- package/docs/functions/isNumericString.html +12 -5
- package/docs/functions/isPlainObject.html +12 -5
- package/docs/functions/last.html +12 -5
- package/docs/functions/later-1.html +12 -5
- package/docs/functions/mapAsync.html +12 -5
- package/docs/functions/mapValues.html +12 -5
- package/docs/functions/match.html +12 -5
- package/docs/functions/merge.html +20 -13
- package/docs/functions/mostFrequent.html +12 -5
- package/docs/functions/noop.html +12 -5
- package/docs/functions/occurrences.html +12 -5
- package/docs/functions/omit.html +18 -7
- package/docs/functions/pick.html +13 -6
- package/docs/functions/pull.html +12 -5
- package/docs/functions/remove.html +12 -5
- package/docs/functions/removeCommonProperties.html +12 -5
- package/docs/functions/replace.html +12 -5
- package/docs/functions/replaceDeep.html +23 -7
- package/docs/functions/rethrow.html +12 -5
- package/docs/functions/round.html +12 -5
- package/docs/functions/safe.html +13 -6
- package/docs/functions/sample.html +149 -0
- package/docs/functions/samples.html +159 -0
- package/docs/functions/scale.html +12 -5
- package/docs/functions/seq.html +12 -5
- package/docs/functions/seqEarlyBreak.html +12 -5
- package/docs/functions/serialize.html +12 -5
- package/docs/functions/set.html +12 -5
- package/docs/functions/setImmutable.html +12 -5
- package/docs/functions/shuffle.html +149 -0
- package/docs/functions/sortBy.html +12 -5
- package/docs/functions/sortProps.html +12 -5
- package/docs/functions/stripPrefix.html +12 -5
- package/docs/functions/stripSuffix.html +12 -5
- package/docs/functions/throttle.html +12 -5
- package/docs/functions/toggle.html +154 -0
- package/docs/functions/trim.html +152 -0
- package/docs/functions/trimEnd.html +152 -0
- package/docs/functions/trimStart.html +152 -0
- package/docs/functions/truthy.html +12 -5
- package/docs/functions/unique.html +12 -5
- package/docs/functions/wait.html +12 -5
- package/docs/functions/waitFor.html +23 -18
- package/docs/functions/waitSync.html +12 -5
- package/docs/index.html +11 -4
- package/docs/interfaces/ComparePropsOptions.html +6 -6
- package/docs/interfaces/GetMultipleSource.html +12 -5
- package/docs/interfaces/GetSource.html +12 -5
- package/docs/interfaces/IsNumericStringOptions.html +9 -9
- package/docs/interfaces/OccurencesOptions.html +6 -6
- package/docs/interfaces/SetImmutableSource.html +12 -5
- package/docs/interfaces/SetSource.html +12 -5
- package/docs/interfaces/ThrottleOptions.html +7 -7
- package/docs/interfaces/ThrottledFunctionExtras.html +7 -7
- package/docs/modules.html +18 -4
- package/docs/pages/CHANGELOG.html +150 -61
- package/docs/pages/Introduction.html +11 -4
- package/docs/types/CustomDeserializers.html +12 -5
- package/docs/types/CustomSerializers.html +12 -5
- package/docs/types/Later.html +12 -5
- package/docs/types/MapValuesFn.html +12 -5
- package/docs/types/MatchCallback.html +12 -5
- package/docs/types/SeqEarlyBreaker.html +12 -5
- package/docs/types/SeqFn.html +12 -5
- package/docs/types/SeqFunctions.html +12 -5
- package/docs/types/SetImmutablePath.html +12 -5
- package/docs/types/ThrottledFunction.html +12 -5
- package/docs/variables/mapValuesUNSET.html +12 -5
- package/docs/variables/mergeUNSET.html +12 -5
- package/esm/index.d.ts +7 -0
- package/esm/index.d.ts.map +1 -1
- package/esm/index.js +7 -0
- package/esm/index.js.map +1 -1
- package/esm/omit.d.ts +1 -1
- package/esm/omit.d.ts.map +1 -1
- package/esm/omit.js.map +1 -1
- package/esm/replace.d.ts.map +1 -1
- package/esm/replace.js.map +1 -1
- package/esm/replaceDeep.d.ts +5 -1
- package/esm/replaceDeep.d.ts.map +1 -1
- package/esm/replaceDeep.js +3 -20
- package/esm/replaceDeep.js.map +1 -1
- package/esm/replaceDeepByFn.d.ts +7 -0
- package/esm/replaceDeepByFn.d.ts.map +1 -0
- package/esm/replaceDeepByFn.js +44 -0
- package/esm/replaceDeepByFn.js.map +1 -0
- package/esm/safe.d.ts.map +1 -1
- package/esm/safe.js.map +1 -1
- package/esm/sample.d.ts +3 -0
- package/esm/sample.d.ts.map +1 -0
- package/esm/sample.js +5 -0
- package/esm/sample.js.map +1 -0
- package/esm/samples.d.ts +3 -0
- package/esm/samples.d.ts.map +1 -0
- package/esm/samples.js +25 -0
- package/esm/samples.js.map +1 -0
- package/esm/serialize.d.ts.map +1 -1
- package/esm/serialize.js +56 -18
- package/esm/serialize.js.map +1 -1
- package/esm/shuffle.d.ts +3 -0
- package/esm/shuffle.d.ts.map +1 -0
- package/esm/shuffle.js +6 -0
- package/esm/shuffle.js.map +1 -0
- package/esm/toggle.d.ts +3 -0
- package/esm/toggle.d.ts.map +1 -0
- package/esm/toggle.js +12 -0
- package/esm/toggle.js.map +1 -0
- package/esm/trim.d.ts +3 -0
- package/esm/trim.d.ts.map +1 -0
- package/esm/trim.js +7 -0
- package/esm/trim.js.map +1 -0
- package/esm/trimEnd.d.ts +3 -0
- package/esm/trimEnd.d.ts.map +1 -0
- package/esm/trimEnd.js +9 -0
- package/esm/trimEnd.js.map +1 -0
- package/esm/trimStart.d.ts +3 -0
- package/esm/trimStart.d.ts.map +1 -0
- package/esm/trimStart.js +9 -0
- package/esm/trimStart.js.map +1 -0
- package/esm/utils/utils.d.ts +6 -0
- package/esm/utils/utils.d.ts.map +1 -0
- package/esm/utils/utils.js +7 -0
- package/esm/utils/utils.js.map +1 -0
- package/esm/waitFor.d.ts +7 -1
- package/esm/waitFor.d.ts.map +1 -1
- package/esm/waitFor.js +35 -10
- package/esm/waitFor.js.map +1 -1
- package/package.json +4 -4
- package/pnpm-lock.yaml +1162 -986
- package/src/deserialize.spec.ts +12 -0
- package/src/index.ts +7 -0
- package/src/omit.ts +8 -2
- package/src/pick.ts +1 -1
- package/src/replace.ts +0 -1
- package/src/replaceDeep.spec.ts +91 -0
- package/src/replaceDeep.ts +22 -27
- package/src/replaceDeepByFn.spec.ts +162 -0
- package/src/replaceDeepByFn.ts +93 -0
- package/src/safe.ts +0 -1
- package/src/sample.spec.ts +31 -0
- package/src/sample.ts +11 -0
- package/src/samples.spec.ts +50 -0
- package/src/samples.ts +41 -0
- package/src/serialize.spec.ts +42 -0
- package/src/serialize.ts +65 -18
- package/src/shuffle.spec.ts +39 -0
- package/src/shuffle.ts +13 -0
- package/src/toggle.spec.ts +43 -0
- package/src/toggle.ts +22 -0
- package/src/trim.spec.ts +22 -0
- package/src/trim.ts +23 -0
- package/src/trimEnd.spec.ts +20 -0
- package/src/trimEnd.ts +22 -0
- package/src/trimStart.spec.ts +20 -0
- package/src/trimStart.ts +22 -0
- package/src/utils/utils.ts +11 -0
- package/src/waitFor.spec.ts +141 -0
- package/src/waitFor.ts +69 -18
package/esm/trimStart.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"trimStart.js","sourceRoot":"","sources":["../src/trimStart.ts"],"names":[],"mappings":"AAWA,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,UAAkB,EAAE,EAAE;IACrD,IAAI,CAAC,GAAG,MAAM,CAAC;IACf,OAAO,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;QAC7B,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;KAClC;IACD,OAAO,CAAC,CAAC;AACb,CAAC,CAAC;AAEF,OAAO,EACH,SAAS,GACZ,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,cAAM,WAAW,CAAC,CAAC;IACR,IAAI,EAAE,CAAC,CAAC;gBAEI,IAAI,EAAE,CAAC;CAG7B;AAED,OAAO,EACH,WAAW,GACd,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW;IAGb,YAAmB,IAAO;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;CACJ;AAED,OAAO,EACH,WAAW,GACd,CAAC"}
|
package/esm/waitFor.d.ts
CHANGED
|
@@ -1,3 +1,9 @@
|
|
|
1
|
-
|
|
1
|
+
type MaybePromise<T> = T | Promise<T>;
|
|
2
|
+
type Options = {
|
|
3
|
+
interval?: number;
|
|
4
|
+
timeout?: number;
|
|
5
|
+
maxTries?: number;
|
|
6
|
+
};
|
|
7
|
+
declare const waitFor: <T>(fn: () => MaybePromise<T>, options?: Options) => Promise<T>;
|
|
2
8
|
export { waitFor };
|
|
3
9
|
//# sourceMappingURL=waitFor.d.ts.map
|
package/esm/waitFor.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"waitFor.d.ts","sourceRoot":"","sources":["../src/waitFor.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"waitFor.d.ts","sourceRoot":"","sources":["../src/waitFor.ts"],"names":[],"mappings":"AAKA,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC,KAAK,OAAO,GAAG;IAIX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAIlB,OAAO,CAAC,EAAE,MAAM,CAAC;IAIjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAqBF,QAAA,MAAM,OAAO,2CAA2C,OAAO,eAsD9D,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}
|
package/esm/waitFor.js
CHANGED
|
@@ -1,30 +1,55 @@
|
|
|
1
|
+
import { noop } from "./noop.js";
|
|
1
2
|
const DEFAULT_INTERVAL = 50;
|
|
2
|
-
const
|
|
3
|
+
const defaultOptions = {
|
|
4
|
+
interval: DEFAULT_INTERVAL,
|
|
5
|
+
timeout: Infinity,
|
|
6
|
+
maxTries: Infinity,
|
|
7
|
+
};
|
|
8
|
+
const waitFor = (fn, options = defaultOptions) => {
|
|
3
9
|
return new Promise((resolve, reject) => {
|
|
4
10
|
let intervalTimer, failTimer;
|
|
5
|
-
|
|
11
|
+
const opts = { ...defaultOptions, ...options };
|
|
12
|
+
if (typeof opts.maxTries === "number" && opts.maxTries < 1) {
|
|
13
|
+
reject(new TypeError("[waitFor] maxTries must be greater than 0"));
|
|
14
|
+
return;
|
|
15
|
+
}
|
|
16
|
+
if (Number.isFinite(opts.timeout)) {
|
|
6
17
|
failTimer = setTimeout(() => {
|
|
7
18
|
reject(new Error("[waitFor] Timeout"));
|
|
8
|
-
|
|
9
|
-
}, timeout);
|
|
19
|
+
clearTimeout(intervalTimer);
|
|
20
|
+
}, opts.timeout);
|
|
10
21
|
}
|
|
11
|
-
|
|
22
|
+
let tries = 0;
|
|
23
|
+
const tryFn = (async () => {
|
|
12
24
|
try {
|
|
13
|
-
|
|
14
|
-
|
|
25
|
+
tries++;
|
|
26
|
+
const result = await fn();
|
|
27
|
+
if (result != null && result !== false) {
|
|
15
28
|
clearTimeout(failTimer);
|
|
16
|
-
|
|
29
|
+
clearTimeout(intervalTimer);
|
|
17
30
|
resolve(result);
|
|
18
31
|
}
|
|
32
|
+
else {
|
|
33
|
+
if (Number.isFinite(opts.maxTries) && tries >= opts.maxTries) {
|
|
34
|
+
clearTimeout(failTimer);
|
|
35
|
+
clearTimeout(intervalTimer);
|
|
36
|
+
reject(new Error("[waitFor] Max tries reached"));
|
|
37
|
+
return;
|
|
38
|
+
}
|
|
39
|
+
setTimeout(() => {
|
|
40
|
+
tryFn().catch(noop);
|
|
41
|
+
}, options.interval);
|
|
42
|
+
}
|
|
19
43
|
}
|
|
20
44
|
catch (error) {
|
|
21
45
|
clearTimeout(failTimer);
|
|
22
|
-
|
|
46
|
+
clearTimeout(intervalTimer);
|
|
23
47
|
const e = new Error("[waitFor] check function threw an error");
|
|
24
48
|
e.details = { error };
|
|
25
49
|
reject(e);
|
|
26
50
|
}
|
|
27
|
-
}
|
|
51
|
+
});
|
|
52
|
+
tryFn().catch(noop);
|
|
28
53
|
});
|
|
29
54
|
};
|
|
30
55
|
export { waitFor };
|
package/esm/waitFor.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"waitFor.js","sourceRoot":"","sources":["../src/waitFor.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,EAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"waitFor.js","sourceRoot":"","sources":["../src/waitFor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAoB5B,MAAM,cAAc,GAAsB;IACtC,QAAQ,EAAE,gBAAgB;IAC1B,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,QAAQ;CACrB,CAAC;AAeF,MAAM,OAAO,GAAG,CAAI,EAAyB,EAAE,UAAmB,cAAc,EAAE,EAAE;IAChF,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,IAAI,aAAuB,EAAE,SAAmB,CAAC;QAEjD,MAAM,IAAI,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;QAC/C,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE;YACxD,MAAM,CAAC,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC,CAAC;YACnE,OAAO;SACV;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;YAC/B,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBACxB,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;gBACvC,YAAY,CAAC,aAAa,CAAC,CAAC;YAChC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;SACpB;QAED,IAAI,KAAK,GAAG,CAAC,CAAC;QAGd,MAAM,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE;YACtB,IAAI;gBACA,KAAK,EAAE,CAAC;gBACR,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;gBAE1B,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,KAAK,KAAK,EAAE;oBACpC,YAAY,CAAC,SAAS,CAAC,CAAC;oBACxB,YAAY,CAAC,aAAa,CAAC,CAAC;oBAC5B,OAAO,CAAC,MAAM,CAAC,CAAC;iBACnB;qBACI;oBACD,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE;wBAC1D,YAAY,CAAC,SAAS,CAAC,CAAC;wBACxB,YAAY,CAAC,aAAa,CAAC,CAAC;wBAC5B,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC;wBACjD,OAAO;qBACV;oBAED,UAAU,CAAC,GAAG,EAAE;wBACZ,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACxB,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;iBACxB;aACJ;YACD,OAAO,KAAc,EAAE;gBACnB,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,YAAY,CAAC,aAAa,CAAC,CAAC;gBAE5B,MAAM,CAAC,GAAkC,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;gBAC9F,CAAC,CAAC,OAAO,GAAG,EAAE,KAAK,EAAE,CAAC;gBACtB,MAAM,CAAC,CAAC,CAAC,CAAC;aACb;QACL,CAAC,CAAC,CAAC;QACH,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ezez/utils",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "4.0.0",
|
|
4
4
|
"repository": "https://github.com/dzek69/bottom-line.git",
|
|
5
5
|
"author": "Jacek Nowacki @dzek69 <git-public@dzek.eu>",
|
|
6
6
|
"license": "MIT",
|
|
@@ -35,9 +35,9 @@
|
|
|
35
35
|
"module": "./esm/index.js",
|
|
36
36
|
"type": "module",
|
|
37
37
|
"devDependencies": {
|
|
38
|
-
"@babel/core": "^7.
|
|
39
|
-
"@babel/preset-env": "^7.
|
|
40
|
-
"@babel/preset-typescript": "^7.
|
|
38
|
+
"@babel/core": "^7.24.3",
|
|
39
|
+
"@babel/preset-env": "^7.24.3",
|
|
40
|
+
"@babel/preset-typescript": "^7.24.1",
|
|
41
41
|
"@dzek69/eslint-config-base": "^2.5.0",
|
|
42
42
|
"@dzek69/eslint-config-import": "^1.3.0",
|
|
43
43
|
"@dzek69/eslint-config-import-typescript": "^1.0.1",
|