@dereekb/util 8.8.1 → 8.10.0

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+# [8.10.0](https://github.com/dereekb/dbx-components/compare/v8.9.1-dev...v8.10.0) (2022-07-04)
+
+
+### Features
+
+* added exists(), uploadStream(), getBytes(), getStream() ([e3fe97e](https://github.com/dereekb/dbx-components/commit/e3fe97e5e985125a5ca653c40fd79c7980845863))
+* added FirebaseStorageContext ([5a30d46](https://github.com/dereekb/dbx-components/commit/5a30d465181d91ce92e7405636fb5414787ac8aa))
+* added list() and list exists() ([388c593](https://github.com/dereekb/dbx-components/commit/388c59350897fcc42d61eb723896e23c42211507))
+* added SlashPath ([8c902ab](https://github.com/dereekb/dbx-components/commit/8c902ab0eb379783320f8a9375486a4e9ce0cd44))
+* added string functions ([1866db5](https://github.com/dereekb/dbx-components/commit/1866db58d96a1d893d01ff2890a9bccb38e2ca61))
+* added upload byte types, delete() ([655088b](https://github.com/dereekb/dbx-components/commit/655088b238ef80097a2f09c539a1282a608f246b))
+
+
+
+## [8.9.1](https://github.com/dereekb/dbx-components/compare/v8.9.0-dev...v8.9.1) (2022-06-30)
+
+
+### Bug Fixes
+
+* fixed LatLngStringRef ([88d9afe](https://github.com/dereekb/dbx-components/commit/88d9afe64e3b6847cf965e0243674e3b057719ee))
+
+
+
+# [8.9.0](https://github.com/dereekb/dbx-components/compare/v8.8.1-dev...v8.9.0) (2022-06-30)
+
+
+### Features
+
+* added firestoreLatLngString() ([2af3e5f](https://github.com/dereekb/dbx-components/commit/2af3e5fcbcae665994df5cc68d1c246b5417a07d))
+
+
+
 ## [8.8.1](https://github.com/dereekb/dbx-components/compare/v8.8.0-dev...v8.8.1) (2022-06-29)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util",
-  "version": "8.8.1",
+  "version": "8.10.0",
   "type": "commonjs",
   "exports": {
     ".": {

package/src/lib/array/array.string.d.ts

@@ -1,25 +1,13 @@
 import { ReadKeyFunction, ReadKeysFunction } from '../key';
-import { DecisionFunctionFactory, MapFunction } from '../value';
+import { MapFunction } from '../value/map';
+import { DecisionFunctionFactory } from '../value/decision';
+import { TransformStringFunctionConfig } from '../string/transform';
 export declare function hasDifferentStringsNoCase(a: string[], b: string[]): boolean;
-export declare function arrayToUppercase(input: string[]): string[];
-export declare function arrayToLowercase(input: string[]): string[];
-export declare type TransformStringsConfig = {
-    /**
-     * Whether or not to store all values as lowercase. Ignored if transform is provided.
-     */
-    toLowercase?: boolean;
-    /**
-     * Whether or not to store all values as uppercase. Ignored if transform is provided.
-     */
-    toUppercase?: boolean;
-    /**
-     * Optional transform function for text.
-     */
-    transform?: TransformSingleStringFunction;
-};
-export declare type TransformSingleStringFunction = MapFunction<string, string>;
+export declare const trimArray: MapFunction<string[], string[]>;
+export declare const arrayToUppercase: MapFunction<string[], string[]>;
+export declare const arrayToLowercase: MapFunction<string[], string[]>;
 export declare type TransformStringsFunction = MapFunction<string[], string[]>;
-export declare function transformStrings(config: TransformStringsConfig): TransformStringsFunction;
+export declare function transformStrings(config: TransformStringFunctionConfig): TransformStringsFunction;
 export declare function toCaseInsensitiveStringArray(values: Iterable<string>): string[];
 export declare function uniqueCaseInsensitiveStrings(values: Iterable<string>): string[];
 export declare function uniqueCaseInsensitiveStringsSet(values: Iterable<string>): Set<string>;
@@ -28,7 +16,7 @@ export declare function findUniqueCaseInsensitiveStrings<T, K extends string = s
 export declare function containsStringAnyCase(values: Iterable<string>, valueToFind: string): boolean;
 export declare function containsAnyStringAnyCase(values: Iterable<string>, valuesToFind: Iterable<string>): boolean;
 export declare function containsAllStringsAnyCase(values: Iterable<string>, valuesToFind: Iterable<string>): boolean;
-export interface FindUniqueStringsTransformConfig extends TransformStringsConfig {
+export interface FindUniqueStringsTransformConfig extends TransformStringFunctionConfig {
     /**
      * Whether or not to compare values as lowercase when finding uniqueness.
      *

package/src/lib/array/array.string.js

@@ -1,27 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.caseInsensitiveFilterByIndexOfDecisionFactory = exports.searchStringFilterFunction = exports.findUniqueTransform = exports.containsAllStringsAnyCase = exports.containsAnyStringAnyCase = exports.containsStringAnyCase = exports.findUniqueCaseInsensitiveStrings = exports.flattenArrayUniqueCaseInsensitiveStrings = exports.uniqueCaseInsensitiveStringsSet = exports.uniqueCaseInsensitiveStrings = exports.toCaseInsensitiveStringArray = exports.transformStrings = exports.arrayToLowercase = exports.arrayToUppercase = exports.hasDifferentStringsNoCase = void 0;
+exports.caseInsensitiveFilterByIndexOfDecisionFactory = exports.searchStringFilterFunction = exports.findUniqueTransform = exports.containsAllStringsAnyCase = exports.containsAnyStringAnyCase = exports.containsStringAnyCase = exports.findUniqueCaseInsensitiveStrings = exports.flattenArrayUniqueCaseInsensitiveStrings = exports.uniqueCaseInsensitiveStringsSet = exports.uniqueCaseInsensitiveStrings = exports.toCaseInsensitiveStringArray = exports.transformStrings = exports.arrayToLowercase = exports.arrayToUppercase = exports.trimArray = exports.hasDifferentStringsNoCase = void 0;
 const array_1 = require("./array");
 const array_unique_1 = require("./array.unique");
-const string_1 = require("../string");
+const string_1 = require("../string/string");
 const set_1 = require("../set/set");
 const iterable_map_1 = require("../iterable/iterable.map");
-const value_1 = require("../value");
+const map_1 = require("../value/map");
+const transform_1 = require("../string/transform");
 function hasDifferentStringsNoCase(a, b) {
     return (0, set_1.hasDifferentValues)(a.map(string_1.caseInsensitiveString), b.map(string_1.caseInsensitiveString));
 }
 exports.hasDifferentStringsNoCase = hasDifferentStringsNoCase;
-function arrayToUppercase(input) {
-    return input.map((x) => x.toUpperCase());
-}
-exports.arrayToUppercase = arrayToUppercase;
-function arrayToLowercase(input) {
-    return input.map((x) => x.toLowerCase());
-}
-exports.arrayToLowercase = arrayToLowercase;
+exports.trimArray = (0, map_1.mapArrayFunction)(transform_1.stringTrimFunction);
+exports.arrayToUppercase = (0, map_1.mapArrayFunction)(transform_1.stringToUppercaseFunction);
+exports.arrayToLowercase = (0, map_1.mapArrayFunction)(transform_1.stringToLowercaseFunction);
 function transformStrings(config) {
-    const transform = config.transform ? (0, value_1.mapArrayFunction)(config.transform) : config.toLowercase ? arrayToLowercase : config.toUppercase ? arrayToUppercase : (0, value_1.mapIdentityFunction)();
-    return transform;
+    const transform = (0, transform_1.transformStringFunction)(config);
+    if ((0, map_1.isMapIdentityFunction)(transform)) {
+        return (0, map_1.mapIdentityFunction)();
+    }
+    else {
+        return (0, map_1.mapArrayFunction)(transform);
+    }
 }
 exports.transformStrings = transformStrings;
 function toCaseInsensitiveStringArray(values) {

package/src/lib/array/array.string.js.map

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

package/src/lib/error/error.d.ts

@@ -37,3 +37,7 @@ export declare type ErrorInput = ErrorWrapper | CodedError | ReadableError | Rea
  * @returns
  */
 export declare function toReadableError(inputError: Maybe<ErrorInput>): Maybe<CodedError | ReadableError>;
+export declare function errorMessageContainsString(input: Maybe<ErrorInput | string>, target: string): boolean;
+export declare type ErrorMessageContainsStringFunction = (input: Maybe<ErrorInput | string>) => boolean;
+export declare function errorMessageContainsStringFunction(target: string): ErrorMessageContainsStringFunction;
+export declare function messageFromError(input: Maybe<ErrorInput | string>): Maybe<string>;

package/src/lib/error/error.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toReadableError = exports.readableError = void 0;
+exports.messageFromError = exports.errorMessageContainsStringFunction = exports.errorMessageContainsString = exports.toReadableError = exports.readableError = void 0;
 const make_error_1 = require("make-error");
+const replace_1 = require("../string/replace");
 function readableError(code, message) {
     return {
         code,
@@ -42,4 +43,20 @@ function toReadableError(inputError) {
     return error;
 }
 exports.toReadableError = toReadableError;
+function errorMessageContainsString(input, target) {
+    return input ? errorMessageContainsStringFunction(target)(input) : false;
+}
+exports.errorMessageContainsString = errorMessageContainsString;
+function errorMessageContainsStringFunction(target) {
+    const regex = new RegExp((0, replace_1.escapeStringForRegex)(target));
+    return (input) => {
+        const message = messageFromError(input);
+        return message ? regex.test(message) : false;
+    };
+}
+exports.errorMessageContainsStringFunction = errorMessageContainsStringFunction;
+function messageFromError(input) {
+    return (typeof input === 'object' ? input.message : input) || input;
+}
+exports.messageFromError = messageFromError;
 //# sourceMappingURL=error.js.map

package/src/lib/error/error.js.map

@@ -1 +1 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/error/error.ts"],"names":[],"mappings":";;;AAAA,2CAAuC;AA2BvC,SAAgB,aAAa,CAAC,IAAqB,EAAE,OAAgB;IACnE,OAAO;QACL,IAAI;QACJ,OAAO;KACR,CAAC;AACJ,CAAC;AALD,sCAKC;AAYD;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,UAA6B;IAC3D,IAAI,KAAwC,CAAC;IAE7C,IAAI,UAAU,EAAE;QACd,IAAK,UAAyB,CAAC,IAAI,EAAE;YACnC,KAAK,GAAG,UAA2B,CAAC;SACrC;aAAM,IAAK,UAA2B,CAAC,IAAI,EAAE;YAC5C,KAAK,GAAI,UAA2B,CAAC,IAAqB,CAAC;SAC5D;aAAM,IAAI,UAAU,YAAY,sBAAS,EAAE;YAC1C,KAAK,GAAG;gBACN,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,MAAM,EAAE,UAAU;aACnB,CAAC;SACH;aAAM;YACL,KAAK,GAAG;gBACN,IAAI,EAAE,OAAO;gBACb,OAAO,EAAG,UAA4B,CAAC,OAAO,IAAI,EAAE;gBACpD,MAAM,EAAE,UAAU;aACnB,CAAC;SACH;KACF;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAxBD,0CAwBC"}
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/error/error.ts"],"names":[],"mappings":";;;AAAA,2CAAuC;AACvC,+CAAyD;AA2BzD,SAAgB,aAAa,CAAC,IAAqB,EAAE,OAAgB;IACnE,OAAO;QACL,IAAI;QACJ,OAAO;KACR,CAAC;AACJ,CAAC;AALD,sCAKC;AAYD;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,UAA6B;IAC3D,IAAI,KAAwC,CAAC;IAE7C,IAAI,UAAU,EAAE;QACd,IAAK,UAAyB,CAAC,IAAI,EAAE;YACnC,KAAK,GAAG,UAA2B,CAAC;SACrC;aAAM,IAAK,UAA2B,CAAC,IAAI,EAAE;YAC5C,KAAK,GAAI,UAA2B,CAAC,IAAqB,CAAC;SAC5D;aAAM,IAAI,UAAU,YAAY,sBAAS,EAAE;YAC1C,KAAK,GAAG;gBACN,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,MAAM,EAAE,UAAU;aACnB,CAAC;SACH;aAAM;YACL,KAAK,GAAG;gBACN,IAAI,EAAE,OAAO;gBACb,OAAO,EAAG,UAA4B,CAAC,OAAO,IAAI,EAAE;gBACpD,MAAM,EAAE,UAAU;aACnB,CAAC;SACH;KACF;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAxBD,0CAwBC;AAED,SAAgB,0BAA0B,CAAC,KAAiC,EAAE,MAAc;IAC1F,OAAO,KAAK,CAAC,CAAC,CAAC,kCAAkC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC3E,CAAC;AAFD,gEAEC;AAID,SAAgB,kCAAkC,CAAC,MAAc;IAC/D,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAA,8BAAoB,EAAC,MAAM,CAAC,CAAC,CAAC;IAEvD,OAAO,CAAC,KAAiC,EAAE,EAAE;QAC3C,MAAM,OAAO,GAAkB,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACvD,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC;AAPD,gFAOC;AAED,SAAgB,gBAAgB,CAAC,KAAiC;IAChE,OAAO,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAuB,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAK,KAAmC,CAAC;AACxH,CAAC;AAFD,4CAEC"}

package/src/lib/index.d.ts

@@ -9,12 +9,14 @@ export * from './getter';
 export * from './iterable';
 export * from './map';
 export * from './model';
+export * from './nodejs';
 export * from './misc';
 export * from './promise';
 export * from './relation';
 export * from './service';
 export * from './set';
 export * from './storage';
+export * from './string';
 export * from './tree';
 export * from './value';
 export * from './boolean';
@@ -27,6 +29,6 @@ export * from './key';
 export * from './number';
 export * from './object';
 export * from './page';
+export * from './path';
 export * from './sort';
-export * from './string';
 export * from './type';

package/src/lib/index.js

@@ -12,12 +12,14 @@ tslib_1.__exportStar(require("./getter"), exports);
 tslib_1.__exportStar(require("./iterable"), exports);
 tslib_1.__exportStar(require("./map"), exports);
 tslib_1.__exportStar(require("./model"), exports);
+tslib_1.__exportStar(require("./nodejs"), exports);
 tslib_1.__exportStar(require("./misc"), exports);
 tslib_1.__exportStar(require("./promise"), exports);
 tslib_1.__exportStar(require("./relation"), exports);
 tslib_1.__exportStar(require("./service"), exports);
 tslib_1.__exportStar(require("./set"), exports);
 tslib_1.__exportStar(require("./storage"), exports);
+tslib_1.__exportStar(require("./string"), exports);
 tslib_1.__exportStar(require("./tree"), exports);
 tslib_1.__exportStar(require("./value"), exports);
 tslib_1.__exportStar(require("./boolean"), exports);
@@ -30,7 +32,7 @@ tslib_1.__exportStar(require("./key"), exports);
 tslib_1.__exportStar(require("./number"), exports);
 tslib_1.__exportStar(require("./object"), exports);
 tslib_1.__exportStar(require("./page"), exports);
+tslib_1.__exportStar(require("./path"), exports);
 tslib_1.__exportStar(require("./sort"), exports);
-tslib_1.__exportStar(require("./string"), exports);
 tslib_1.__exportStar(require("./type"), exports);
 //# sourceMappingURL=index.js.map

package/src/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,kDAAwB;AACxB,sDAA4B;AAC5B,iDAAuB;AACvB,oDAA0B;AAC1B,kDAAwB;AACxB,mDAAyB;AACzB,qDAA2B;AAC3B,mDAAyB;AACzB,qDAA2B;AAC3B,gDAAsB;AACtB,kDAAwB;AACxB,iDAAuB;AACvB,oDAA0B;AAC1B,qDAA2B;AAC3B,oDAA0B;AAC1B,gDAAsB;AACtB,oDAA0B;AAC1B,iDAAuB;AACvB,kDAAwB;AACxB,oDAA0B;AAC1B,iDAAuB;AACvB,sDAA4B;AAC5B,qDAA2B;AAC3B,iDAAuB;AACvB,oDAA0B;AAC1B,gDAAsB;AACtB,mDAAyB;AACzB,mDAAyB;AACzB,iDAAuB;AACvB,iDAAuB;AACvB,mDAAyB;AACzB,iDAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,kDAAwB;AACxB,sDAA4B;AAC5B,iDAAuB;AACvB,oDAA0B;AAC1B,kDAAwB;AACxB,mDAAyB;AACzB,qDAA2B;AAC3B,mDAAyB;AACzB,qDAA2B;AAC3B,gDAAsB;AACtB,kDAAwB;AACxB,mDAAyB;AACzB,iDAAuB;AACvB,oDAA0B;AAC1B,qDAA2B;AAC3B,oDAA0B;AAC1B,gDAAsB;AACtB,oDAA0B;AAC1B,mDAAyB;AACzB,iDAAuB;AACvB,kDAAwB;AACxB,oDAA0B;AAC1B,iDAAuB;AACvB,sDAA4B;AAC5B,qDAA2B;AAC3B,iDAAuB;AACvB,oDAA0B;AAC1B,gDAAsB;AACtB,mDAAyB;AACzB,mDAAyB;AACzB,iDAAuB;AACvB,iDAAuB;AACvB,iDAAuB;AACvB,iDAAuB"}

package/src/lib/nodejs/index.d.ts

@@ -0,0 +1 @@
+export * from './stream';

package/src/lib/nodejs/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./stream"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/nodejs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/nodejs/index.ts"],"names":[],"mappings":";;;AAAA,mDAAyB"}

package/src/lib/nodejs/stream.d.ts

@@ -0,0 +1,22 @@
+/// <reference types="node" />
+/**
+ * Reads the input stream and encodes the data to a string.
+ */
+export declare type ReadableStreamToStringFunction = (stream: NodeJS.ReadableStream) => Promise<string>;
+/**
+ * Creates a new ReadableStreamToStringFunction
+ * @param encoding
+ * @returns
+ */
+export declare function readableStreamToStringFunction(encoding: BufferEncoding): ReadableStreamToStringFunction;
+/**
+ * ReadableStreamToStringFunction for Base64
+ */
+export declare const readableStreamToBase64: ReadableStreamToStringFunction;
+/**
+ * Converts a ReadableStream to a Buffer promise.
+ *
+ * @param encoding
+ * @returns
+ */
+export declare function readableStreamToBuffer(stream: NodeJS.ReadableStream): Promise<Buffer>;

package/src/lib/nodejs/stream.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readableStreamToBuffer = exports.readableStreamToBase64 = exports.readableStreamToStringFunction = void 0;
+/**
+ * Creates a new ReadableStreamToStringFunction
+ * @param encoding
+ * @returns
+ */
+function readableStreamToStringFunction(encoding) {
+    return (stream) => {
+        return readableStreamToBuffer(stream).then((x) => x.toString(encoding));
+    };
+}
+exports.readableStreamToStringFunction = readableStreamToStringFunction;
+/**
+ * ReadableStreamToStringFunction for Base64
+ */
+exports.readableStreamToBase64 = readableStreamToStringFunction('base64');
+/**
+ * Converts a ReadableStream to a Buffer promise.
+ *
+ * @param encoding
+ * @returns
+ */
+function readableStreamToBuffer(stream) {
+    const chunks = [];
+    return new Promise((resolve, reject) => {
+        stream.on('data', (chunk) => chunks.push(Buffer.from(chunk)));
+        stream.on('error', (err) => reject(err));
+        stream.on('end', () => resolve(Buffer.concat(chunks)));
+    });
+}
+exports.readableStreamToBuffer = readableStreamToBuffer;
+//# sourceMappingURL=stream.js.map

package/src/lib/nodejs/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/nodejs/stream.ts"],"names":[],"mappings":";;;AAKA;;;;GAIG;AACH,SAAgB,8BAA8B,CAAC,QAAwB;IACrE,OAAO,CAAC,MAA6B,EAAE,EAAE;QACvC,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC;AACJ,CAAC;AAJD,wEAIC;AAED;;GAEG;AACU,QAAA,sBAAsB,GAAG,8BAA8B,CAAC,QAAQ,CAAC,CAAC;AAE/E;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,MAA6B;IAClE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC;AAPD,wDAOC"}

package/src/lib/number/number.d.ts

@@ -1,4 +1,8 @@
 import { Maybe } from '../value/maybe.type';
+/**
+ * A string represented within a number.
+ */
+export declare type NumberString = string;
 /**
  * Returns true if the input value is divisible by the divisor.
  *

package/src/lib/number/number.js.map

@@ -1 +1 @@
-{"version":3,"file":"number.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/number/number.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,SAAgB,mBAAmB,CAAC,KAAoB,EAAE,OAAe;IACvE,MAAM,SAAS,GAAG,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,CAAC,CAAC,GAAG,OAAO,CAAC;IACzC,OAAO,SAAS,KAAK,CAAC,CAAC;AACzB,CAAC;AAHD,kDAGC;AASD;;;;;;GAMG;AACH,SAAgB,sBAAsB,CAAC,KAAa,EAAE,OAAe;IACnE,MAAM,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAErC,OAAO;QACL,KAAK;QACL,OAAO;QACP,WAAW,EAAE,SAAS,GAAG,OAAO;QAChC,YAAY,EAAE,UAAU,GAAG,OAAO;KACnC,CAAC;AACJ,CAAC;AAXD,wDAWC"}
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/number/number.ts"],"names":[],"mappings":";;;AAOA;;;;;;GAMG;AACH,SAAgB,mBAAmB,CAAC,KAAoB,EAAE,OAAe;IACvE,MAAM,SAAS,GAAG,CAAC,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,CAAC,CAAC,GAAG,OAAO,CAAC;IACzC,OAAO,SAAS,KAAK,CAAC,CAAC;AACzB,CAAC;AAHD,kDAGC;AASD;;;;;;GAMG;AACH,SAAgB,sBAAsB,CAAC,KAAa,EAAE,OAAe;IACnE,MAAM,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAErC,OAAO;QACL,KAAK;QACL,OAAO;QACP,WAAW,EAAE,SAAS,GAAG,OAAO;QAChC,YAAY,EAAE,UAAU,GAAG,OAAO;KACnC,CAAC;AACJ,CAAC;AAXD,wDAWC"}

package/src/lib/number/round.d.ts

@@ -1,3 +1,30 @@
+import { Maybe } from '../value/maybe.type';
+import { NumberString } from './number';
+/**
+ * The number of decimal places ot use.
+ */
+export declare type NumberPrecision = number;
+/**
+ * Same as cutToPrecision, but can take in a string or null/undefined.
+ *
+ * @param input
+ * @param precision
+ * @returns
+ */
+export declare function cutValueToPrecision(input: Maybe<number | NumberString>, precision: NumberPrecision): number;
+/**
+ * Rounds the input
+ */
+export declare type CutValueToPrecisionFunction = ((input: Maybe<number | NumberString>) => number) & {
+    readonly _precision: number;
+};
+/**
+ * Creates a CutValueToPrecisionFunction
+ *
+ * @param precision
+ * @returns
+ */
+export declare function cutValueToPrecisionFunction(precision: NumberPrecision): CutValueToPrecisionFunction;
 /**
  * Rounds the input number to the given precision.
  *
@@ -5,7 +32,15 @@
  * @param precision
  * @returns
  */
-export declare function roundToPrecision(value: number, precision: number): number;
+export declare function roundToPrecision(value: number, precision: NumberPrecision): number;
+/**
+ * Cuts the input number to the given precision. For example, 1.25 with precision 1 will not be rounded up to 1.3, but instead be "cut" to 1.2
+ *
+ * @param value
+ * @param precision
+ * @returns
+ */
+export declare function cutToPrecision(value: number, precision: NumberPrecision): number;
 /**
  * Rounds the number up to a specific "step" that contains it.
  *

package/src/lib/number/round.js

@@ -1,6 +1,43 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.roundNumberUpToStep = exports.roundToPrecision = void 0;
+exports.roundNumberUpToStep = exports.cutToPrecision = exports.roundToPrecision = exports.cutValueToPrecisionFunction = exports.cutValueToPrecision = void 0;
+/**
+ * Same as cutToPrecision, but can take in a string or null/undefined.
+ *
+ * @param input
+ * @param precision
+ * @returns
+ */
+function cutValueToPrecision(input, precision) {
+    return cutValueToPrecisionFunction(precision)(input);
+}
+exports.cutValueToPrecision = cutValueToPrecision;
+/**
+ * Creates a CutValueToPrecisionFunction
+ *
+ * @param precision
+ * @returns
+ */
+function cutValueToPrecisionFunction(precision) {
+    const fn = ((input) => {
+        let value;
+        switch (typeof input) {
+            case 'number':
+                value = input;
+                break;
+            case 'string':
+                value = Number(input);
+                break;
+            default:
+                value = 0;
+                break;
+        }
+        return cutToPrecision(value, precision);
+    });
+    fn._precision = precision;
+    return fn;
+}
+exports.cutValueToPrecisionFunction = cutValueToPrecisionFunction;
 // MARK: Number/Math
 /**
  * Rounds the input number to the given precision.
@@ -13,6 +50,19 @@ function roundToPrecision(value, precision) {
     return +(Math.round(Number(value + 'e+' + precision)) + 'e-' + precision);
 }
 exports.roundToPrecision = roundToPrecision;
+/**
+ * Cuts the input number to the given precision. For example, 1.25 with precision 1 will not be rounded up to 1.3, but instead be "cut" to 1.2
+ *
+ * @param value
+ * @param precision
+ * @returns
+ */
+function cutToPrecision(value, precision) {
+    // use floor for positive numbers, ceil for negative numbers
+    const rndFn = value > 0 ? Math.floor : Math.ceil;
+    return +(rndFn(Number(value + 'e+' + precision)) + 'e-' + precision);
+}
+exports.cutToPrecision = cutToPrecision;
 /**
  * Rounds the number up to a specific "step" that contains it.
  *

package/src/lib/number/round.js.map

@@ -1 +1 @@
-{"version":3,"file":"round.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/number/round.ts"],"names":[],"mappings":";;;AAAA,oBAAoB;AACpB;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,KAAa,EAAE,SAAiB;IAC/D,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAC5E,CAAC;AAFD,4CAEC;AAED;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CAAC,KAAa,EAAE,IAAY;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AACxC,CAAC;AAFD,kDAEC"}
+{"version":3,"file":"round.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/number/round.ts"],"names":[],"mappings":";;;AAWA;;;;;;GAMG;AACH,SAAgB,mBAAmB,CAAC,KAAmC,EAAE,SAA0B;IACjG,OAAO,2BAA2B,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC;AAFD,kDAEC;AASD;;;;;GAKG;AACH,SAAgB,2BAA2B,CAAC,SAA0B;IACpE,MAAM,EAAE,GAA0C,CAAC,CAAC,KAAmC,EAAE,EAAE;QACzF,IAAI,KAAa,CAAC;QAElB,QAAQ,OAAO,KAAK,EAAE;YACpB,KAAK,QAAQ;gBACX,KAAK,GAAG,KAAK,CAAC;gBACd,MAAM;YACR,KAAK,QAAQ;gBACX,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtB,MAAM;YACR;gBACE,KAAK,GAAG,CAAC,CAAC;gBACV,MAAM;SACT;QAED,OAAO,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC,CAAgC,CAAC;IAClC,EAAE,CAAC,UAAU,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAiC,CAAC;AAC3C,CAAC;AApBD,kEAoBC;AAED,oBAAoB;AACpB;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,KAAa,EAAE,SAA0B;IACxE,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAC5E,CAAC;AAFD,4CAEC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAAC,KAAa,EAAE,SAA0B;IACtE,4DAA4D;IAC5D,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IACjD,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AACvE,CAAC;AAJD,wCAIC;AAED;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CAAC,KAAa,EAAE,IAAY;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AACxC,CAAC;AAFD,kDAEC"}

package/src/lib/path/index.d.ts

@@ -0,0 +1 @@
+export * from './path';

package/src/lib/path/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./path"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/path/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/path/index.ts"],"names":[],"mappings":";;;AAAA,iDAAuB"}

package/src/lib/path/path.d.ts

@@ -0,0 +1,157 @@
+import { MapSameFunction } from '../value/map';
+import { ArrayOrValue } from '../array/array';
+import { FactoryWithRequiredInput } from '../getter/getter';
+export declare const SLASH_PATH_SEPARATOR = "/";
+export declare const SLASH_PATH_FILE_TYPE_SEPARATOR = ".";
+export declare type SlashPathSeparatorString = typeof SLASH_PATH_SEPARATOR;
+export declare type SlashFileTypeSeparatorString = typeof SLASH_PATH_FILE_TYPE_SEPARATOR;
+export declare const DEFAULT_SLASH_PATH_ILLEGAL_CHARACTERS: string[];
+/**
+ * Default replacement character for illegal characters.
+ */
+export declare const DEFAULT_SLASH_PATH_ILLEGAL_CHARACTER_REPLACEMENT = "_";
+/**
+ * A forward-slash path string.
+ */
+export declare type SlashPathFolder = `${SlashPathSeparatorString}${string}${SlashPathSeparatorString}` | `${string}${SlashPathSeparatorString}`;
+/**
+ * A file name without a type.
+ */
+export declare type SlashPathFile = string;
+/**
+ * A file name
+ */
+export declare type SlashPathTypedFile = `${string}${SlashFileTypeSeparatorString}${string}`;
+/**
+ * A simple path made up of UTF-8 characters and slashes
+ */
+export declare type SlashPath = SlashPathFolder | SlashPathFile | SlashPathTypedFile;
+/**
+ * Function that modifies the input SlashPath
+ */
+export declare type SlashPathFunction = MapSameFunction<SlashPath>;
+/**
+ * Slash path type
+ * - folder: is a folder
+ * - file: is a file without a type
+ * - typedfile: is a file with a type
+ * - invalid: is an invalid slash path that might contain multiple '.' values, or is an empty string.
+ */
+export declare type SlashPathType = 'folder' | 'file' | 'typedfile' | 'invalid';
+/**
+ * Returns the SlashPathType for the input.
+ *
+ * @param input
+ * @returns
+ */
+export declare function slashPathType(input: SlashPath): SlashPathType;
+export declare function isSlashPathFile(input: string): input is SlashPathTypedFile;
+export declare function isSlashPathFolder(input: string): input is SlashPathFolder;
+export declare function isValidSlashPath(input: string): input is SlashPath;
+/**
+ * Returns the last part of the slash path.
+ *
+ * @param slashPath
+ */
+export declare function slashPathName(slashPath: SlashPath): string;
+/**
+ * Returns each section of a SlashPath
+ *
+ * @param slashPath
+ * @returns
+ */
+export declare function slashPathParts(slashPath: SlashPath): string[];
+/**
+ * Slash path type to enforce.
+ * - relative: path that does not start with a slash
+ * - absolute: path that starts with a slash
+ * - any: either relative or absolute
+ */
+export declare type SlashPathStartType = 'relative' | 'absolute' | 'any';
+/**
+ * Factory use to set the slash path type of the input.
+ */
+export declare type SlashPathStartTypeFactory = SlashPathFunction;
+export declare function slashPathStartTypeFactory(type: SlashPathStartType): SlashPathStartTypeFactory;
+export declare const LEADING_SLASHES_REGEX: RegExp;
+export declare const TRAILING_SLASHES_REGEX: RegExp;
+export declare const TRAILING_FILE_TYPE_SEPARATORS_REGEX: RegExp;
+export declare const ALL_SLASHES_REGEX: RegExp;
+export declare const ALL_DOUBLE_SLASHES_REGEX: RegExp;
+export declare const ALL_SLASH_PATH_FILE_TYPE_SEPARATORS_REGEX: RegExp;
+export declare function toRelativeSlashPathStartType(input: SlashPath): SlashPath;
+/**
+ *
+ * @param input
+ * @returns
+ */
+export declare function toAbsoluteSlashPathStartType(input: SlashPath): SlashPath;
+export declare function fixMultiSlashesInSlashPath(input: SlashPath): SlashPath;
+export declare function replaceMultipleFilePathsInSlashPath(input: SlashPath): SlashPath;
+export declare function removeTrailingFileTypeSeparators(input: SlashPath): SlashPath;
+/**
+ * Replaces all extra and invalidate FilePathTypeSeparator values from the SlashPath, returning a valid SlashPath.
+ *
+ * @param input
+ * @param replaceWith
+ * @returns
+ */
+export declare function replaceInvalidFilePathTypeSeparatorsInSlashPath(input: SlashPath, replaceWith?: string): SlashPath;
+/**
+ * Creates a function that replaces all extra and invalidate FilePathTypeSeparator values from the SlashPath, returning a valid SlashPath.
+ *
+ * @param input
+ * @param replaceWith
+ * @returns
+ */
+export declare function replaceInvalidFilePathTypeSeparatorsInSlashPathFunction(replaceWith?: string): SlashPathFunction;
+/**
+ * Factory used to validate and fix invalid SlashPath input.
+ */
+export declare type SlashPathValidationFactory = SlashPathFunction;
+export interface SlashPathValidationFactoryConfig {
+    /**
+     * Set of illegal characters to find/replace. If not provided, used the DEFAULT_SLASH_PATH_ILLEGAL_CHARACTERS
+     */
+    illegalStrings?: ArrayOrValue<string>;
+    /**
+     * String used to replace all encountered illegal characters.
+     *
+     * Is true by default.
+     */
+    replaceIllegalCharacters?: string | boolean;
+    /**
+     * Whether or not to replace extra dots by treating them as illegal characters.
+     *
+     * Will replace extra dots with the input value, or if true, will replace them with the value for replaceIllegalCharacters.
+     */
+    replaceIllegalDots?: string | boolean;
+    /**
+     * Whether or not to validate a final time after replacing elements and throw an error if it is still not valid.
+     *
+     * Disabled by default unless replaceIllegalCharacters and replaceIllegalDots are false.
+     */
+    throwError?: boolean;
+}
+export declare function slashPathValidationFactory(config?: SlashPathValidationFactoryConfig): SlashPathValidationFactory;
+/**
+ * Factory use to generate/merge file paths together.
+ */
+export declare type SlashPathFactory = FactoryWithRequiredInput<SlashPath, ArrayOrValue<SlashPath>>;
+export interface SlashPathFactoryConfig {
+    /**
+     * SlashPath start type to enforce
+     */
+    startType?: SlashPathStartType;
+    /**
+     * Prefix paths to append
+     */
+    basePath?: ArrayOrValue<SlashPathFolder>;
+    /**
+     * SlashPathValidationFactoryConfig to use for validation.
+     */
+    validate?: boolean | SlashPathValidationFactoryConfig;
+}
+export declare function slashPathFactory(config?: SlashPathFactoryConfig): SlashPathFactory;
+export declare function mergeSlashPaths(paths: SlashPath[]): SlashPath;
+export declare function slashPathInvalidError(): Error;