@ezez/utils 1.1.0 → 1.4.0

package/esm/ensurePrefix.d.ts

@@ -0,0 +1,3 @@
+declare const ensurePrefix: (string: string, prefix: string) => string;
+export { ensurePrefix, };
+//# sourceMappingURL=ensurePrefix.d.ts.map

package/esm/ensurePrefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensurePrefix.d.ts","sourceRoot":"","sources":["../src/ensurePrefix.ts"],"names":[],"mappings":"AAQA,QAAA,MAAM,YAAY,WAAY,MAAM,UAAU,MAAM,WAKnD,CAAC;AAEF,OAAO,EACH,YAAY,GACf,CAAC"}

package/esm/ensurePrefix.js

@@ -0,0 +1,8 @@
+const ensurePrefix = (string, prefix) => {
+    if (string.startsWith(prefix)) {
+        return string;
+    }
+    return prefix + string;
+};
+export { ensurePrefix, };
+//# sourceMappingURL=ensurePrefix.js.map

package/esm/ensurePrefix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensurePrefix.js","sourceRoot":"","sources":["../src/ensurePrefix.ts"],"names":[],"mappings":"AAQA,MAAM,YAAY,GAAG,CAAC,MAAc,EAAE,MAAc,EAAE,EAAE;IACpD,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;QAC3B,OAAO,MAAM,CAAC;KACjB;IACD,OAAO,MAAM,GAAG,MAAM,CAAC;AAC3B,CAAC,CAAC;AAEF,OAAO,EACH,YAAY,GACf,CAAC"}

package/esm/ensureSuffix.d.ts

@@ -0,0 +1,3 @@
+declare const ensureSuffix: (string: string, suffix: string) => string;
+export { ensureSuffix, };
+//# sourceMappingURL=ensureSuffix.d.ts.map

package/esm/ensureSuffix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureSuffix.d.ts","sourceRoot":"","sources":["../src/ensureSuffix.ts"],"names":[],"mappings":"AAQA,QAAA,MAAM,YAAY,WAAY,MAAM,UAAU,MAAM,WAKnD,CAAC;AAEF,OAAO,EACH,YAAY,GACf,CAAC"}

package/esm/ensureSuffix.js

@@ -0,0 +1,8 @@
+const ensureSuffix = (string, suffix) => {
+    if (string.endsWith(suffix)) {
+        return string;
+    }
+    return string + suffix;
+};
+export { ensureSuffix, };
+//# sourceMappingURL=ensureSuffix.js.map

package/esm/ensureSuffix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureSuffix.js","sourceRoot":"","sources":["../src/ensureSuffix.ts"],"names":[],"mappings":"AAQA,MAAM,YAAY,GAAG,CAAC,MAAc,EAAE,MAAc,EAAE,EAAE;IACpD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;QACzB,OAAO,MAAM,CAAC;KACjB;IACD,OAAO,MAAM,GAAG,MAAM,CAAC;AAC3B,CAAC,CAAC;AAEF,OAAO,EACH,YAAY,GACf,CAAC"}

package/esm/ensureTimestamp.d.ts

@@ -0,0 +1,3 @@
+declare const ensureTimestamp: (date: Date | number) => number;
+export { ensureTimestamp, };
+//# sourceMappingURL=ensureTimestamp.d.ts.map

package/esm/ensureTimestamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureTimestamp.d.ts","sourceRoot":"","sources":["../src/ensureTimestamp.ts"],"names":[],"mappings":"AAQA,QAAA,MAAM,eAAe,SAAU,IAAI,GAAG,MAAM,KAAG,MAK9C,CAAC;AAEF,OAAO,EACH,eAAe,GAClB,CAAC"}

package/esm/ensureTimestamp.js

@@ -0,0 +1,8 @@
+const ensureTimestamp = (date) => {
+    if (typeof date === "number") {
+        return date;
+    }
+    return date.getTime();
+};
+export { ensureTimestamp, };
+//# sourceMappingURL=ensureTimestamp.js.map

package/esm/ensureTimestamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureTimestamp.js","sourceRoot":"","sources":["../src/ensureTimestamp.ts"],"names":[],"mappings":"AAQA,MAAM,eAAe,GAAG,CAAC,IAAmB,EAAU,EAAE;IACpD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;QAC1B,OAAO,IAAI,CAAC;KACf;IACD,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;AAC1B,CAAC,CAAC;AAEF,OAAO,EACH,eAAe,GAClB,CAAC"}

package/esm/escapeRegExp.d.ts

@@ -0,0 +1,3 @@
+declare const escapeRegExp: (string: string) => string;
+export { escapeRegExp, };
+//# sourceMappingURL=escapeRegExp.d.ts.map

package/esm/escapeRegExp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escapeRegExp.d.ts","sourceRoot":"","sources":["../src/escapeRegExp.ts"],"names":[],"mappings":"AAUA,QAAA,MAAM,YAAY,WAAY,MAAM,WAEnC,CAAC;AAEF,OAAO,EACH,YAAY,GACf,CAAC"}

package/esm/escapeRegExp.js

@@ -0,0 +1,5 @@
+const escapeRegExp = (string) => {
+    return string.replace(/[/\-\\^$*+?.()|[\]{}]/g, "\\$&");
+};
+export { escapeRegExp, };
+//# sourceMappingURL=escapeRegExp.js.map

package/esm/escapeRegExp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escapeRegExp.js","sourceRoot":"","sources":["../src/escapeRegExp.ts"],"names":[],"mappings":"AAUA,MAAM,YAAY,GAAG,CAAC,MAAc,EAAE,EAAE;IACpC,OAAO,MAAM,CAAC,OAAO,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC,CAAC;AAEF,OAAO,EACH,YAAY,GACf,CAAC"}

package/esm/index.d.ts

@@ -1,8 +1,13 @@
+export * from "./ensurePrefix.js";
+export * from "./ensureSuffix.js";
 export * from "./cap.js";
 export * from "./capitalize.js";
 export * from "./coalesce.js";
 export * from "./ensureArray.js";
+export * from "./ensureDate.js";
 export * from "./ensureError.js";
+export * from "./ensureTimestamp.js";
+export * from "./escapeRegExp.js";
 export * from "./get.js";
 export * from "./getMultiple.js";
 export * from "./insertSeparator.js";
@@ -21,12 +26,17 @@ export * from "./omit.js";
 export * from "./pick.js";
 export * from "./pull.js";
 export * from "./remove.js";
+export * from "./replace.js";
 export * from "./rethrow.js";
+export * from "./safe.js";
 export * from "./scale.js";
 export * from "./seq.js";
 export * from "./set.js";
 export * from "./setImmutable.js";
 export * from "./sortBy.js";
+export * from "./sortProps.js";
+export * from "./stripPrefix.js";
+export * from "./stripSuffix.js";
 export * from "./throttle.js";
 export * from "./truthy.js";
 export * from "./wait.js";

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/esm/index.js

@@ -1,8 +1,13 @@
+export * from "./ensurePrefix.js";
+export * from "./ensureSuffix.js";
 export * from "./cap.js";
 export * from "./capitalize.js";
 export * from "./coalesce.js";
 export * from "./ensureArray.js";
+export * from "./ensureDate.js";
 export * from "./ensureError.js";
+export * from "./ensureTimestamp.js";
+export * from "./escapeRegExp.js";
 export * from "./get.js";
 export * from "./getMultiple.js";
 export * from "./insertSeparator.js";
@@ -21,12 +26,17 @@ export * from "./omit.js";
 export * from "./pick.js";
 export * from "./pull.js";
 export * from "./remove.js";
+export * from "./replace.js";
 export * from "./rethrow.js";
+export * from "./safe.js";
 export * from "./scale.js";
 export * from "./seq.js";
 export * from "./set.js";
 export * from "./setImmutable.js";
 export * from "./sortBy.js";
+export * from "./sortProps.js";
+export * from "./stripPrefix.js";
+export * from "./stripSuffix.js";
 export * from "./throttle.js";
 export * from "./truthy.js";
 export * from "./wait.js";

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/esm/isPlainObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isPlainObject.d.ts","sourceRoot":"","sources":["../src/isPlainObject.ts"],"names":[],"mappings":"AAIA,QAAA,MAAM,aAAa,UAAW,OAAO,YAQpC,CAAC;AAEF,OAAO,EACH,aAAa,GAChB,CAAC"}
+{"version":3,"file":"isPlainObject.d.ts","sourceRoot":"","sources":["../src/isPlainObject.ts"],"names":[],"mappings":"AASA,QAAA,MAAM,aAAa,UAAW,OAAO,YAQpC,CAAC;AAEF,OAAO,EACH,aAAa,GAChB,CAAC"}

package/esm/isPlainObject.js.map

@@ -1 +1 @@
-{"version":3,"file":"isPlainObject.js","sourceRoot":"","sources":["../src/isPlainObject.ts"],"names":[],"mappings":"AAIA,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAC7C,KAAK;OACF,OAAO,KAAK,KAAK,QAAQ;OACzB,CACC,KAAK,CAAC,WAAW,KAAK,MAAM;WACzB,CAAC,CAAC,aAAa,IAAI,KAAK,CAAC;WACzB,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAC/D,CACJ,CAAC;AAEF,OAAO,EACH,aAAa,GAChB,CAAC"}
+{"version":3,"file":"isPlainObject.js","sourceRoot":"","sources":["../src/isPlainObject.ts"],"names":[],"mappings":"AASA,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAC7C,KAAK;OACF,OAAO,KAAK,KAAK,QAAQ;OACzB,CACC,KAAK,CAAC,WAAW,KAAK,MAAM;WACzB,CAAC,CAAC,aAAa,IAAI,KAAK,CAAC;WACzB,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAC/D,CACJ,CAAC;AAEF,OAAO,EACH,aAAa,GAChB,CAAC"}

package/esm/replace.d.ts

@@ -0,0 +1,3 @@
+declare const replace: (source: string, replaceMap: Record<string, string>) => string;
+export { replace, };
+//# sourceMappingURL=replace.d.ts.map

package/esm/replace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace.d.ts","sourceRoot":"","sources":["../src/replace.ts"],"names":[],"mappings":"AAUA,QAAA,MAAM,OAAO,WAAY,MAAM,cAAc,OAAO,MAAM,EAAE,MAAM,CAAC,WAIlE,CAAC;AAEF,OAAO,EACH,OAAO,GACV,CAAC"}

package/esm/replace.js

@@ -0,0 +1,7 @@
+import { escapeRegExp } from "./escapeRegExp.js";
+const replace = (source, replaceMap) => {
+    const regex = new RegExp(Object.keys(replaceMap).map(escapeRegExp).join("|"), "g");
+    return source.replace(regex, (matched) => replaceMap[matched]);
+};
+export { replace, };
+//# sourceMappingURL=replace.js.map

package/esm/replace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace.js","sourceRoot":"","sources":["../src/replace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AASjD,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,UAAkC,EAAE,EAAE;IAEnE,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACnF,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF,OAAO,EACH,OAAO,GACV,CAAC"}

package/esm/safe.d.ts

@@ -0,0 +1,4 @@
+declare function safe<T>(fn: () => T): T | undefined;
+declare function safe<T, Y>(fn: () => T, def: Y): T | Y;
+export { safe };
+//# sourceMappingURL=safe.d.ts.map

package/esm/safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe.d.ts","sourceRoot":"","sources":["../src/safe.ts"],"names":[],"mappings":"AAAA,iBAAS,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;AAC7C,iBAAS,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAsBhD,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/esm/safe.js

@@ -0,0 +1,10 @@
+function safe(fn, def) {
+    try {
+        return fn();
+    }
+    catch {
+        return def;
+    }
+}
+export { safe };
+//# sourceMappingURL=safe.js.map

package/esm/safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe.js","sourceRoot":"","sources":["../src/safe.ts"],"names":[],"mappings":"AAaA,SAAS,IAAI,CAAO,EAAW,EAAE,GAAO;IAEpC,IAAI;QACA,OAAO,EAAE,EAAE,CAAC;KACf;IACD,MAAM;QACF,OAAO,GAAG,CAAC;KACd;AACL,CAAC;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/esm/sortProps.d.ts

@@ -0,0 +1,3 @@
+declare const sortProps: <T extends Record<string, unknown>>(object: T, asc?: boolean) => T;
+export { sortProps, };
+//# sourceMappingURL=sortProps.d.ts.map

package/esm/sortProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortProps.d.ts","sourceRoot":"","sources":["../src/sortProps.ts"],"names":[],"mappings":"AAOA,QAAA,MAAM,SAAS,oEASd,CAAC;AAEF,OAAO,EACH,SAAS,GACZ,CAAC"}

package/esm/sortProps.js

@@ -0,0 +1,16 @@
+const sortProps = (object, asc = true) => {
+    const sorted = {};
+    const keys = Object.keys(object);
+    if (asc) {
+        keys.sort();
+    }
+    else {
+        keys.sort().reverse();
+    }
+    for (const key of keys) {
+        sorted[key] = object[key];
+    }
+    return sorted;
+};
+export { sortProps, };
+//# sourceMappingURL=sortProps.js.map

package/esm/sortProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortProps.js","sourceRoot":"","sources":["../src/sortProps.ts"],"names":[],"mappings":"AAOA,MAAM,SAAS,GAAG,CAAoC,MAAS,EAAE,GAAG,GAAG,IAAI,EAAK,EAAE;IAC9E,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,GAAG,EAAE;QAAE,IAAI,CAAC,IAAI,EAAE,CAAC;KAAE;SACpB;QAAE,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;KAAE;IAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE;QACpB,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;KAC7B;IACD,OAAO,MAAW,CAAC;AACvB,CAAC,CAAC;AAEF,OAAO,EACH,SAAS,GACZ,CAAC"}

package/esm/stripPrefix.d.ts

@@ -0,0 +1,3 @@
+declare const stripPrefix: (from: string, prefix: string) => string;
+export { stripPrefix, };
+//# sourceMappingURL=stripPrefix.d.ts.map

package/esm/stripPrefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripPrefix.d.ts","sourceRoot":"","sources":["../src/stripPrefix.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,WAAW,SAAU,MAAM,UAAU,MAAM,KAAG,MAKnD,CAAC;AAEF,OAAO,EACH,WAAW,GACd,CAAC"}

package/esm/stripPrefix.js

@@ -0,0 +1,8 @@
+const stripPrefix = (from, prefix) => {
+    if (from.startsWith(prefix)) {
+        return from.slice(prefix.length);
+    }
+    return from;
+};
+export { stripPrefix, };
+//# sourceMappingURL=stripPrefix.js.map

package/esm/stripPrefix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripPrefix.js","sourceRoot":"","sources":["../src/stripPrefix.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,MAAc,EAAU,EAAE;IACzD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;KACpC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,OAAO,EACH,WAAW,GACd,CAAC"}

package/esm/stripSuffix.d.ts

@@ -0,0 +1,3 @@
+declare const stripSuffix: (from: string, suffix: string) => string;
+export { stripSuffix, };
+//# sourceMappingURL=stripSuffix.d.ts.map

package/esm/stripSuffix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripSuffix.d.ts","sourceRoot":"","sources":["../src/stripSuffix.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,WAAW,SAAU,MAAM,UAAU,MAAM,KAAG,MAKnD,CAAC;AAEF,OAAO,EACH,WAAW,GACd,CAAC"}

package/esm/stripSuffix.js

@@ -0,0 +1,8 @@
+const stripSuffix = (from, suffix) => {
+    if (from.endsWith(suffix)) {
+        return from.slice(0, -suffix.length);
+    }
+    return from;
+};
+export { stripSuffix, };
+//# sourceMappingURL=stripSuffix.js.map

package/esm/stripSuffix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripSuffix.js","sourceRoot":"","sources":["../src/stripSuffix.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,MAAc,EAAU,EAAE;IACzD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;KACxC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,OAAO,EACH,WAAW,GACd,CAAC"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@ezez/utils",
-  "version": "1.1.0",
+  "version": "1.4.0",
   "repository": "https://github.com/dzek69/bottom-line.git",
   "author": "Jacek Nowacki @dzek69 <git-public@dzek.eu>",
   "license": "MIT",
   "scripts": {
     "test": "NODE_ENV=test jest",
     "test:lodashImports": "node test/lodash-tree.cjs",
-    "docs": "typedoc src/index.ts --skipErrorChecking --out docs --includeVersion --pluginPages ./pagesconfig.json",
+    "docs": "typedoc src/index.ts --skipErrorChecking --out docs --includeVersion",
     "compile": "yarn compile:esm && yarn compile:cjs",
     "compile:esm": "rm -rf esm && tsc --project tsconfig.esm.json && node ./build-scripts/compile.esm.after.mjs",
     "compile:cjs": "rm -rf dist && tsc --project tsconfig.cjs.json && node ./build-scripts/compile.cjs.after.mjs",
@@ -35,31 +35,31 @@
   "module": "./esm/index.js",
   "type": "module",
   "devDependencies": {
-    "@babel/core": "^7.19.3",
-    "@babel/preset-env": "^7.19.3",
-    "@babel/preset-typescript": "^7.18.6",
-    "@dzek69/eslint-config-base": "^2.3.0",
-    "@dzek69/eslint-config-typescript": "^1.0.2",
-    "@types/jest": "^29.0.3",
+    "@babel/core": "^7.21.4",
+    "@babel/preset-env": "^7.21.4",
+    "@babel/preset-typescript": "^7.21.4",
+    "@dzek69/eslint-config-base": "^2.4.0",
+    "@dzek69/eslint-config-import": "^1.2.0",
+    "@dzek69/eslint-config-import-typescript": "^1.0.0",
+    "@dzek69/eslint-config-typescript": "^1.1.0",
+    "@knodes/typedoc-plugin-pages": "^0.23.4",
+    "@types/jest": "^29.5.0",
     "@types/lodash": "^4.14.168",
-    "@typescript-eslint/eslint-plugin": "^5.38.1",
-    "@typescript-eslint/parser": "^5.38.1",
+    "@typescript-eslint/eslint-plugin": "^5.58.0",
+    "@typescript-eslint/parser": "^5.58.0",
     "babel-plugin-module-extension": "^0.1.3",
-    "eslint": "^8.24.0",
-    "fs-extra": "^10.1.0",
-    "husky": "^8.0.1",
-    "jest": "^29.1.1",
+    "eslint": "^8.38.0",
+    "eslint-plugin-import": "^2.27.5",
+    "fs-extra": "^11.1.1",
+    "husky": "^8.0.3",
+    "jest": "^29.5.0",
     "lodash": "^4.17.21",
     "must": "^0.13.4",
-    "nodemon": "^2.0.20",
+    "nodemon": "^2.0.22",
+    "prettier": "^2.8.7",
     "ts-node": "^10.9.1",
-    "typedoc": "^0.23.15",
-    "typescript": "^4.9.5",
-    "eslint-plugin-import": "^2.26.0",
-    "@dzek69/eslint-config-import": "^1.0.0",
-    "@dzek69/eslint-config-import-typescript": "^1.0.0",
-    "@knodes/typedoc-plugin-pages": "^0.23.1",
-    "prettier": "^2.8.3"
+    "typedoc": "^0.23.28",
+    "typescript": "^5.0.4"
   },
   "husky": {
     "hooks": {
@@ -67,7 +67,7 @@
     }
   },
   "libraryTemplate": {
-    "version": "3.8.0",
+    "version": "3.9.1",
     "language": "typescript",
     "fixDefaultForCommonJS": false,
     "jsx": false

package/src/coalesce.ts

@@ -2,8 +2,8 @@
  * Returns first non-nil (not undefined, not null) value from given arguments.
  *
  * @param {...*} args - values
- * @example coalesce(null, undefined, void 0, 5); // returns 5
- * @example coalesce(4, null, 6, undefined); // returns 4
+ * @example coalesce(null, undefined, void 1, 5); // returns 5 (mind the `void`)
+ * @example coalesce(0, null, 6, undefined); // returns 0
  * @example coalesce(undefined); // returns null
  * @example coalesce(); // returns null
  * @returns {*|null} first non-nil value or null

package/src/ensureArray.ts

@@ -1,5 +1,5 @@
 /**
- * Wraps value in an array until the value is already an array
+ * Wraps value in an array unless the value is already an array
  * @param {*} value - value to be wrapped
  * @returns {Array}
  */

package/src/ensureDate.spec.ts

@@ -0,0 +1,13 @@
+import { ensureDate } from "./ensureDate.js";
+
+describe("ensureDate", function() {
+    it("should convert timestamps to date instances", function() {
+        ensureDate(123456789).must.be.instanceOf(Date);
+        ensureDate(123456789).getTime().must.equal(123456789);
+    });
+
+    it("should return the same date instance", function() {
+        const date = new Date(123456789);
+        ensureDate(date).must.equal(date);
+    });
+});

package/src/ensureDate.ts

@@ -0,0 +1,18 @@
+/**
+ * Ensure that the date value is a Date instance
+ *
+ * @example ensureDate(123456789); // Date(123456789)
+ * @example ensureDate(new Date(123456789)); // Date(123456789) -- same instance as given
+ * @see {@link ensureTimestamp}
+ * @param {Date | number} date - date value
+ */
+const ensureDate = (date: Date | number): Date => {
+    if (typeof date === "number") {
+        return new Date(date);
+    }
+    return date;
+};
+
+export {
+    ensureDate,
+};

package/src/ensureError.ts

@@ -1,5 +1,12 @@
 /**
  * Ensures given value is an instance of Error.
+ *
+ * This is for simple use cases only, for maximum flexibility use `@ezez/errors` package.
+ * @example ensureError(new Error("test")); // returns given Error instance (not modified)
+ * @example ensureError("test");
+ * // ^ returns new Error instance with error message: "Expected error instance, got something else: test"
+ * @example ensureError({});
+ * // ^ returns new Error instance with error message: "Expected error instance, got something else: [object Object]"
  * @param {*} e - value to check
  * @returns Error - original error or new Error instance
  */

package/src/ensurePrefix.spec.ts

@@ -0,0 +1,11 @@
+import { ensurePrefix } from "./ensurePrefix.js";
+
+describe("ensure prefix", function() {
+    it("adds prefix", function() {
+        ensurePrefix("1234bbcc", "0x").must.equal("0x1234bbcc");
+    });
+
+    it("doesn't add prefix if already present", function() {
+        ensurePrefix("0x1234bbcc", "0x").must.equal("0x1234bbcc");
+    });
+});

package/src/ensurePrefix.ts

@@ -0,0 +1,18 @@
+/**
+ * Add prefix to string if it doesn't already have it
+ *
+ * @example ensurePrefix("1234bbcc", "0x") -> "0x1234bbcc"
+ * @example ensurePrefix("0x1234bbcc", "0x") -> "0x1234bbcc"
+ * @param {string} string - string to add prefix to
+ * @param {string} prefix - prefix to add
+ */
+const ensurePrefix = (string: string, prefix: string) => {
+    if (string.startsWith(prefix)) {
+        return string;
+    }
+    return prefix + string;
+};
+
+export {
+    ensurePrefix,
+};

package/src/ensureSuffix.spec.ts

@@ -0,0 +1,11 @@
+import { ensureSuffix } from "./ensureSuffix.js";
+
+describe("ensure suffix", function() {
+    it("adds suffix to a string", function() {
+        ensureSuffix("hello world", ".").must.equal("hello world.");
+    });
+
+    it("doesn't add suffix if already present", function() {
+        ensureSuffix("hello world.", ".").must.equal("hello world.");
+    });
+});

package/src/ensureSuffix.ts

@@ -0,0 +1,18 @@
+/**
+ * Add suffix to string if it does not already end with it
+ *
+ * @example ensureSuffix("hello world", ".") -> "hello world."
+ * @example ensureSuffix("hello world.", ".") -> "hello world."
+ * @param {string} string - string to add suffix to
+ * @param {string} suffix - suffix to add
+ */
+const ensureSuffix = (string: string, suffix: string) => {
+    if (string.endsWith(suffix)) {
+        return string;
+    }
+    return string + suffix;
+};
+
+export {
+    ensureSuffix,
+};

package/src/ensureTimestamp.spec.ts

@@ -0,0 +1,11 @@
+import { ensureTimestamp } from "./ensureTimestamp.js";
+
+describe("ensure timestamp", function() {
+    it("returns number if number given", function() {
+        ensureTimestamp(123456789).must.equal(123456789);
+    });
+
+    it("returns number if date given", function() {
+        ensureTimestamp(new Date(123456789)).must.equal(123456789);
+    });
+});

package/src/ensureTimestamp.ts

@@ -0,0 +1,18 @@
+/**
+ * Ensures that the given date value is a numeric timestamp.
+ *
+ * @example ensureTimestamp(123456789); // 123456789
+ * @example ensureTimestamp(new Date(123456789)); // 123456789
+ * @see {@link ensureDate}
+ * @param {Date | number} date - date value
+ */
+const ensureTimestamp = (date: Date | number): number => {
+    if (typeof date === "number") {
+        return date;
+    }
+    return date.getTime();
+};
+
+export {
+    ensureTimestamp,
+};

package/src/escapeRegExp.spec.ts

@@ -0,0 +1,31 @@
+import { escapeRegExp } from "./escapeRegExp.js";
+
+describe("escapeRegExp", () => {
+    it("it should escape dot", () => {
+        const userName = ".";
+        const regex = new RegExp(`^(maciek|${escapeRegExp(userName)})$`);
+        const result = regex.test("maciek");
+        result.must.be.true();
+
+        const result2 = regex.test("stefan");
+        result2.must.be.false();
+
+        const result3 = regex.test(",");
+        result3.must.be.false();
+
+        const result4 = regex.test(".");
+        result4.must.be.true();
+
+        const result5 = regex.test("...");
+        result5.must.be.false();
+    });
+
+    it("should escape complex string", () => {
+        const userName = "([{^|";
+        const fn = () => new RegExp(`^(maciek|${escapeRegExp(userName)})$`);
+        fn.must.not.throw();
+
+        const fnNoEscape = () => new RegExp(`^(maciek|${userName})$`);
+        fnNoEscape.must.throw();
+    });
+});

package/src/escapeRegExp.ts

@@ -0,0 +1,17 @@
+/**
+ * Escapes a string to be used in a regular expression.
+ * From: https://stackoverflow.com/a/3561711
+ * @param string - string to escape
+ * @example ```typescript
+ * const badName = "([{^|";
+ * const regex = new RegExp(`^(maciek|${escapeRegExp(badName)})$`); // won't crash
+ * regex.test(badName); // true
+ * ```
+ */
+const escapeRegExp = (string: string) => {
+    return string.replace(/[/\-\\^$*+?.()|[\]{}]/g, "\\$&");
+};
+
+export {
+    escapeRegExp,
+};

package/src/index.ts

@@ -1,9 +1,14 @@
 /* eslint-disable import/max-dependencies */
+export * from "./ensurePrefix.js";
+export * from "./ensureSuffix.js";
 export * from "./cap.js";
 export * from "./capitalize.js";
 export * from "./coalesce.js";
 export * from "./ensureArray.js";
+export * from "./ensureDate.js";
 export * from "./ensureError.js";
+export * from "./ensureTimestamp.js";
+export * from "./escapeRegExp.js";
 export * from "./get.js";
 export * from "./getMultiple.js";
 export * from "./insertSeparator.js";
@@ -22,12 +27,17 @@ export * from "./omit.js";
 export * from "./pick.js";
 export * from "./pull.js";
 export * from "./remove.js";
+export * from "./replace.js";
 export * from "./rethrow.js";
+export * from "./safe.js";
 export * from "./scale.js";
 export * from "./seq.js";
 export * from "./set.js";
 export * from "./setImmutable.js";
 export * from "./sortBy.js";
+export * from "./sortProps.js";
+export * from "./stripPrefix.js";
+export * from "./stripSuffix.js";
 export * from "./throttle.js";
 export * from "./truthy.js";
 export * from "./wait.js";