@dereekb/util 9.24.16 → 9.24.18

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [9.24.18](https://github.com/dereekb/dbx-components/compare/v9.24.17-dev...v9.24.18) (2023-07-30)
+
+
+
+## [9.24.17](https://github.com/dereekb/dbx-components/compare/v9.24.16-dev...v9.24.17) (2023-07-24)
+
+
+
 ## [9.24.16](https://github.com/dereekb/dbx-components/compare/v9.24.15-dev...v9.24.16) (2023-07-14)
 
 

package/fetch/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [9.24.18](https://github.com/dereekb/dbx-components/compare/v9.24.17-dev...v9.24.18) (2023-07-30)
+
+
+
+## [9.24.17](https://github.com/dereekb/dbx-components/compare/v9.24.16-dev...v9.24.17) (2023-07-24)
+
+
+
 ## [9.24.16](https://github.com/dereekb/dbx-components/compare/v9.24.15-dev...v9.24.16) (2023-07-14)
 
 

package/fetch/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@dereekb/util/fetch",
-  "version": "9.24.16",
+  "version": "9.24.18",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
   "dependencies": {},
   "peerDependencies": {
-    "@dereekb/util": "9.24.16",
+    "@dereekb/util": "9.24.18",
     "lodash.isequal": "^4.5.0",
     "make-error": "^1.3.0",
     "class-validator": "^0.13.2",

package/package.json

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

package/src/lib/contact/phone.d.ts

@@ -1,7 +1,21 @@
+import { Maybe } from '../value/maybe.type';
 /**
  * Phone number string input. No format specified.
+ *
+ * Examples:
+ * - 4567890
+ * - 123-456-7890
+ * - (123) 456-7890
+ * - 1234567890
+ * - +1234567890
+ * - +1-555-555-5555
+ * - 2345678;ext=123
  */
 export declare type PhoneNumber = string;
+/**
+ * 1-6 digit extension number
+ */
+export declare type PhoneExtensionNumber = string;
 /**
  * E.164 Standardized Phone Number. Always starts with a +
  *
@@ -14,3 +28,53 @@ export declare type E164PhoneNumber = `+${PhoneNumber}`;
  * Requires the + to be provided.
  */
 export declare const E164PHONE_NUMBER_REGEX: RegExp;
+/**
+ * Returns true if the input phone number is a valid E164PHONE_NUMBER_REGEX value.
+ *
+ * @param input
+ * @returns
+ */
+export declare function isE164PhoneNumber(input: string, allowExtension?: boolean): input is E164PhoneNumber;
+/**
+ * E.164 Standardized Phone Number. Always starts with a +
+ *
+ * https://en.wikipedia.org/wiki/E.164
+ */
+export declare type E164PhoneNumberWithExtension = `+${PhoneNumber}#${PhoneExtensionNumber}`;
+/**
+ * E164PhoneNumber regex validator with an optional extension.
+ *
+ * Requires the + to be provided.
+ */
+export declare const E164PHONE_NUMBER_WITH_OPTIONAL_EXTENSION_REGEX: RegExp;
+/**
+ * E164PhoneNumber regex validator with an extension.
+ *
+ * Requires the + to be provided.
+ */
+export declare const E164PHONE_NUMBER_WITH_EXTENSION_REGEX: RegExp;
+/**
+ * Returns true if the input phone number is a valid E164PHONE_NUMBER_WITH_EXTENSION_REGEX value.
+ *
+ * @param input
+ * @returns
+ */
+export declare function isE164PhoneNumberWithExtension(input: string): input is E164PhoneNumberWithExtension;
+export declare const PHONE_EXTENSION_NUMBER_REGEX: RegExp;
+/**
+ * Returns true if the input is a valid phone number extension.
+ *
+ * @param input
+ * @returns
+ */
+export declare function isValidPhoneExtensionNumber(input: string): input is PhoneExtensionNumber;
+/**
+ * Removes the extension characters from the input phone number.
+ */
+export declare const removeExtensionFromPhoneNumber: (input: PhoneNumber | E164PhoneNumber | E164PhoneNumberWithExtension) => E164PhoneNumber;
+export interface E164PhoneNumberExtensionPair {
+    number: E164PhoneNumber;
+    extension?: Maybe<PhoneExtensionNumber>;
+}
+export declare function e164PhoneNumberExtensionPair(input: PhoneNumber | E164PhoneNumber | E164PhoneNumberWithExtension): E164PhoneNumberExtensionPair;
+export declare function e164PhoneNumberFromE164PhoneNumberExtensionPair(input: E164PhoneNumberExtensionPair): E164PhoneNumber | E164PhoneNumberWithExtension;

package/src/lib/contact/phone.js

@@ -1,10 +1,71 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.E164PHONE_NUMBER_REGEX = void 0;
+exports.e164PhoneNumberFromE164PhoneNumberExtensionPair = exports.e164PhoneNumberExtensionPair = exports.removeExtensionFromPhoneNumber = exports.isValidPhoneExtensionNumber = exports.PHONE_EXTENSION_NUMBER_REGEX = exports.isE164PhoneNumberWithExtension = exports.E164PHONE_NUMBER_WITH_EXTENSION_REGEX = exports.E164PHONE_NUMBER_WITH_OPTIONAL_EXTENSION_REGEX = exports.isE164PhoneNumber = exports.E164PHONE_NUMBER_REGEX = void 0;
+const replace_1 = require("../string/replace");
 /**
  * E164PhoneNumber regex validator.
  *
  * Requires the + to be provided.
  */
 exports.E164PHONE_NUMBER_REGEX = /^\+[1-9]\d{1,14}$/;
+/**
+ * Returns true if the input phone number is a valid E164PHONE_NUMBER_REGEX value.
+ *
+ * @param input
+ * @returns
+ */
+function isE164PhoneNumber(input, allowExtension = true) {
+    return (allowExtension ? exports.E164PHONE_NUMBER_WITH_OPTIONAL_EXTENSION_REGEX : exports.E164PHONE_NUMBER_REGEX).test(input);
+}
+exports.isE164PhoneNumber = isE164PhoneNumber;
+/**
+ * E164PhoneNumber regex validator with an optional extension.
+ *
+ * Requires the + to be provided.
+ */
+exports.E164PHONE_NUMBER_WITH_OPTIONAL_EXTENSION_REGEX = /^\+[1-9]\d{1,14}(#\d{1,6})?$/;
+/**
+ * E164PhoneNumber regex validator with an extension.
+ *
+ * Requires the + to be provided.
+ */
+exports.E164PHONE_NUMBER_WITH_EXTENSION_REGEX = /^\+[1-9]\d{1,14}(#\d{1,6})$/;
+/**
+ * Returns true if the input phone number is a valid E164PHONE_NUMBER_WITH_EXTENSION_REGEX value.
+ *
+ * @param input
+ * @returns
+ */
+function isE164PhoneNumberWithExtension(input) {
+    return exports.E164PHONE_NUMBER_WITH_EXTENSION_REGEX.test(input);
+}
+exports.isE164PhoneNumberWithExtension = isE164PhoneNumberWithExtension;
+exports.PHONE_EXTENSION_NUMBER_REGEX = /^\d{1,6}$/;
+/**
+ * Returns true if the input is a valid phone number extension.
+ *
+ * @param input
+ * @returns
+ */
+function isValidPhoneExtensionNumber(input) {
+    return exports.PHONE_EXTENSION_NUMBER_REGEX.test(input);
+}
+exports.isValidPhoneExtensionNumber = isValidPhoneExtensionNumber;
+/**
+ * Removes the extension characters from the input phone number.
+ */
+exports.removeExtensionFromPhoneNumber = (0, replace_1.removeCharactersAfterFirstCharacterOccurenceFunction)('#');
+const e164PhoneNumberExtensionPairSplitterFunction = (0, replace_1.splitStringAtFirstCharacterOccurenceFunction)('#');
+function e164PhoneNumberExtensionPair(input) {
+    const split = e164PhoneNumberExtensionPairSplitterFunction(input);
+    return {
+        number: split[0],
+        extension: split[1]
+    };
+}
+exports.e164PhoneNumberExtensionPair = e164PhoneNumberExtensionPair;
+function e164PhoneNumberFromE164PhoneNumberExtensionPair(input) {
+    return input.extension ? `${input.number}#${input.extension}` : input.number;
+}
+exports.e164PhoneNumberFromE164PhoneNumberExtensionPair = e164PhoneNumberFromE164PhoneNumberExtensionPair;
 //# sourceMappingURL=phone.js.map

package/src/lib/contact/phone.js.map

@@ -1 +1 @@
-{"version":3,"file":"phone.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/contact/phone.ts"],"names":[],"mappings":";;;AAYA;;;;GAIG;AACU,QAAA,sBAAsB,GAAG,mBAAmB,CAAC"}
+{"version":3,"file":"phone.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/contact/phone.ts"],"names":[],"mappings":";;;AAAA,+CAAuI;AA6BvI;;;;GAIG;AACU,QAAA,sBAAsB,GAAG,mBAAmB,CAAC;AAE1D;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,KAAa,EAAE,cAAc,GAAG,IAAI;IACpE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,sDAA8C,CAAC,CAAC,CAAC,8BAAsB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChH,CAAC;AAFD,8CAEC;AASD;;;;GAIG;AACU,QAAA,8CAA8C,GAAG,8BAA8B,CAAC;AAE7F;;;;GAIG;AACU,QAAA,qCAAqC,GAAG,6BAA6B,CAAC;AAEnF;;;;;GAKG;AACH,SAAgB,8BAA8B,CAAC,KAAa;IAC1D,OAAO,6CAAqC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAFD,wEAEC;AAEY,QAAA,4BAA4B,GAAG,WAAW,CAAC;AAExD;;;;;GAKG;AACH,SAAgB,2BAA2B,CAAC,KAAa;IACvD,OAAO,oCAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAFD,kEAEC;AAED;;GAEG;AACU,QAAA,8BAA8B,GAAG,IAAA,8DAAoD,EAAC,GAAG,CAA6F,CAAC;AAOpM,MAAM,4CAA4C,GAAG,IAAA,sDAA4C,EAAC,GAAG,CAAC,CAAC;AAEvG,SAAgB,4BAA4B,CAAC,KAAmE;IAC9G,MAAM,KAAK,GAAG,4CAA4C,CAAC,KAAK,CAAC,CAAC;IAElE,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,CAAC,CAAoB;QACnC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;KACpB,CAAC;AACJ,CAAC;AAPD,oEAOC;AAED,SAAgB,+CAA+C,CAAC,KAAmC;IACjG,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;AAC/E,CAAC;AAFD,0GAEC"}

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

@@ -0,0 +1,67 @@
+import { MapFunction } from '../value';
+/**
+ * A bitwise set is limited to 32 values, the numbers 0-31.
+ *
+ * This is because Javascript performs bitwise calculations on 32-bit values.
+ */
+export declare const MAX_BITWISE_SET_SIZE = 32;
+/**
+ * Enum or number value from 0 to 31 that denotes a specific item via index of the bit to measure.
+ */
+export declare type BitwiseEncodedSetIndex = number;
+/**
+ * Set of values that are encoded into a single number.
+ *
+ * The number can include up to 32 unique boolean values.
+ */
+export declare type BitwiseEncodedSet = number;
+/**
+ * Encodes a BitwiseEncodedSet from a set of values.
+ */
+export declare type BitwiseSetEncoder<D extends BitwiseEncodedSetIndex> = (set: Set<D>) => BitwiseEncodedSet;
+export declare function encodeBitwiseSet<D extends BitwiseEncodedSetIndex>(input: Set<D>): BitwiseEncodedSet;
+/**
+ * Decodes an BitwiseEncodedSet to a Set of values.
+ */
+export declare type BitwiseSetDecoder<D extends BitwiseEncodedSetIndex> = (set: BitwiseEncodedSet) => Set<D>;
+export declare function bitwiseSetDecoder<D extends BitwiseEncodedSetIndex>(maxIndex: number): BitwiseSetDecoder<D>;
+export declare const dencodeBitwiseSet: BitwiseSetDecoder<number>;
+/**
+ * Encodes and Decodes a BitwiseEncodedSet, depending on the input.
+ */
+export declare type BitwiseSetDencoder<D extends BitwiseEncodedSetIndex> = BitwiseSetEncoder<D> & BitwiseSetDecoder<D>;
+export declare function bitwiseSetDencoder<D extends BitwiseEncodedSetIndex>(maxIndex?: number): BitwiseSetDencoder<D>;
+/**
+ * Maps the input object to a set of index values.
+ */
+export declare type BitwiseObjectToSetFunction<T extends object, D extends BitwiseEncodedSetIndex> = MapFunction<T, Set<D>>;
+/**
+ * Maps the input object from a set of index values.
+ */
+export declare type BitwiseObjectFromSetFunction<T extends object, D extends BitwiseEncodedSetIndex> = MapFunction<Set<D>, T>;
+/**
+ * Encodes the input object to a BitwiseEncodedSet.
+ */
+export declare type BitwiseObjectEncoder<T extends object> = (object: T) => BitwiseEncodedSet;
+/**
+ * Creates a BitwiseObjectEncoder<T> from the input.
+ *
+ * @param toSetFunction
+ * @returns
+ */
+export declare function bitwiseObjectEncoder<T extends object, D extends BitwiseEncodedSetIndex>(toSetFunction: BitwiseObjectToSetFunction<T, D>): BitwiseObjectEncoder<T>;
+/**
+ * Decodes an object from the input BitwiseEncodedSet.
+ */
+export declare type BitwiseObjectDecoder<T extends object> = (set: BitwiseEncodedSet) => T;
+export declare function bitwiseObjectdecoder<T extends object, D extends BitwiseEncodedSetIndex>(fromSetFunction: BitwiseObjectFromSetFunction<T, D>, maxIndex?: number): BitwiseObjectDecoder<T>;
+/**
+ * Encodes/Decodes an object.
+ */
+export declare type BitwiseObjectDencoder<T extends object> = BitwiseObjectEncoder<T> & BitwiseObjectDecoder<T>;
+export interface BitwiseObjectDencoderConfig<T extends object, D extends BitwiseEncodedSetIndex = BitwiseEncodedSetIndex> {
+    readonly toSetFunction: BitwiseObjectToSetFunction<T, D>;
+    readonly fromSetFunction: BitwiseObjectFromSetFunction<T, D>;
+    readonly maxIndex?: number;
+}
+export declare function bitwiseObjectDencoder<T extends object, D extends BitwiseEncodedSetIndex = BitwiseEncodedSetIndex>(config: BitwiseObjectDencoderConfig<T, D>): BitwiseObjectDencoder<T>;

package/src/lib/number/bitwise.dencoder.js

@@ -0,0 +1,84 @@
+"use strict";
+// MARK: BitwiseSet
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bitwiseObjectDencoder = exports.bitwiseObjectdecoder = exports.bitwiseObjectEncoder = exports.bitwiseSetDencoder = exports.dencodeBitwiseSet = exports.bitwiseSetDecoder = exports.encodeBitwiseSet = exports.MAX_BITWISE_SET_SIZE = void 0;
+/**
+ * A bitwise set is limited to 32 values, the numbers 0-31.
+ *
+ * This is because Javascript performs bitwise calculations on 32-bit values.
+ */
+exports.MAX_BITWISE_SET_SIZE = 32;
+function encodeBitwiseSet(input) {
+    let encodedSet = 0;
+    input.forEach((value) => {
+        encodedSet = encodedSet | (1 << value);
+    });
+    return encodedSet;
+}
+exports.encodeBitwiseSet = encodeBitwiseSet;
+function bitwiseSetDecoder(maxIndex) {
+    return (input) => {
+        let encodedSet = new Set();
+        for (let i = 0; i < maxIndex; i += 1) {
+            if (input & (1 << i)) {
+                encodedSet.add(i);
+            }
+        }
+        return encodedSet;
+    };
+}
+exports.bitwiseSetDecoder = bitwiseSetDecoder;
+exports.dencodeBitwiseSet = bitwiseSetDecoder(exports.MAX_BITWISE_SET_SIZE);
+function bitwiseSetDencoder(maxIndex) {
+    const decoder = maxIndex ? bitwiseSetDecoder(maxIndex) : exports.dencodeBitwiseSet;
+    return ((input) => {
+        if (typeof input === 'number') {
+            return decoder(input);
+        }
+        else if (input != null) {
+            return encodeBitwiseSet(input);
+        }
+        else {
+            return 0;
+        }
+    });
+}
+exports.bitwiseSetDencoder = bitwiseSetDencoder;
+/**
+ * Creates a BitwiseObjectEncoder<T> from the input.
+ *
+ * @param toSetFunction
+ * @returns
+ */
+function bitwiseObjectEncoder(toSetFunction) {
+    return (input) => {
+        const encodedSet = toSetFunction(input);
+        return encodeBitwiseSet(encodedSet);
+    };
+}
+exports.bitwiseObjectEncoder = bitwiseObjectEncoder;
+function bitwiseObjectdecoder(fromSetFunction, maxIndex) {
+    const decoder = maxIndex ? bitwiseSetDecoder(maxIndex) : exports.dencodeBitwiseSet;
+    return (set) => {
+        const decoded = decoder(set);
+        return fromSetFunction(decoded);
+    };
+}
+exports.bitwiseObjectdecoder = bitwiseObjectdecoder;
+function bitwiseObjectDencoder(config) {
+    const encoder = bitwiseObjectEncoder(config.toSetFunction);
+    const decoder = bitwiseObjectdecoder(config.fromSetFunction, config.maxIndex);
+    return ((input) => {
+        if (typeof input === 'number') {
+            return decoder(input);
+        }
+        else if (input != null) {
+            return encoder(input);
+        }
+        else {
+            return 0;
+        }
+    });
+}
+exports.bitwiseObjectDencoder = bitwiseObjectDencoder;
+//# sourceMappingURL=bitwise.dencoder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bitwise.dencoder.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/number/bitwise.dencoder.ts"],"names":[],"mappings":";AAAA,mBAAmB;;;AAInB;;;;GAIG;AACU,QAAA,oBAAoB,GAAG,EAAE,CAAC;AAmBvC,SAAgB,gBAAgB,CAAmC,KAAa;IAC9E,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACtB,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC;AARD,4CAQC;AAOD,SAAgB,iBAAiB,CAAmC,QAAgB;IAClF,OAAO,CAAC,KAAwB,EAAE,EAAE;QAClC,IAAI,UAAU,GAAG,IAAI,GAAG,EAAK,CAAC;QAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE;YACpC,IAAI,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE;gBACpB,UAAU,CAAC,GAAG,CAAC,CAAM,CAAC,CAAC;aACxB;SACF;QAED,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAZD,8CAYC;AAEY,QAAA,iBAAiB,GAAG,iBAAiB,CAAC,4BAAoB,CAAC,CAAC;AAOzE,SAAgB,kBAAkB,CAAmC,QAAiB;IACpF,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,yBAAiB,CAAC;IAE9E,OAAO,CAAC,CAAC,KAAiC,EAAE,EAAE;QAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;YAC7B,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;SACvB;aAAM,IAAI,KAAK,IAAI,IAAI,EAAE;YACxB,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;SAChC;aAAM;YACL,OAAO,CAAC,CAAC;SACV;IACH,CAAC,CAA0B,CAAC;AAC9B,CAAC;AAZD,gDAYC;AAkBD;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAqD,aAA+C;IACtI,OAAO,CAAC,KAAQ,EAAE,EAAE;QAClB,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC,CAAC;AACJ,CAAC;AALD,oDAKC;AAOD,SAAgB,oBAAoB,CAAqD,eAAmD,EAAE,QAAiB;IAC7J,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,yBAAiB,CAAC;IAE9E,OAAO,CAAC,GAAsB,EAAE,EAAE;QAChC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAW,CAAC;QACvC,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC,CAAC;AACJ,CAAC;AAPD,oDAOC;AAaD,SAAgB,qBAAqB,CAA8E,MAAyC;IAC1J,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE9E,OAAO,CAAC,CAAC,KAA4B,EAAE,EAAE;QACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;YAC7B,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;SACvB;aAAM,IAAI,KAAK,IAAI,IAAI,EAAE;YACxB,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;SACvB;aAAM;YACL,OAAO,CAAC,CAAC;SACV;IACH,CAAC,CAA6B,CAAC;AACjC,CAAC;AAbD,sDAaC"}

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

@@ -1,3 +1,4 @@
+export * from './bitwise.dencoder';
 export * from './factory';
 export * from './bound';
 export * from './dollar';

package/src/lib/number/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./bitwise.dencoder"), exports);
 tslib_1.__exportStar(require("./factory"), exports);
 tslib_1.__exportStar(require("./bound"), exports);
 tslib_1.__exportStar(require("./dollar"), exports);

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

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

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

@@ -1,4 +1,5 @@
-import { ArrayOrValue } from '@dereekb/util';
+import { ArrayOrValue } from '../array/array';
+import { Maybe } from '../value/maybe.type';
 import { MapSameFunction } from '../value/map';
 export declare type ReplaceStringsFunction = MapSameFunction<string>;
 export interface ReplaceStringsConfig {
@@ -28,6 +29,70 @@ export declare function findStringsRegexString(find: ArrayOrValue<string>): stri
  * @param input
  */
 export declare function escapeStringForRegex(input: string): string;
-export declare type FindAllCharacterOccurencesFunction = (input: string) => number[];
+export declare type FindAllCharacterOccurencesFunction = (input: string, max?: Maybe<number>) => number[];
 export declare function findAllCharacterOccurencesFunction(characterSet: Set<string>): FindAllCharacterOccurencesFunction;
-export declare function findAllCharacterOccurences(set: Set<string>, input: string): number[];
+/**
+ * First all occurences of the characters from the set in the input string.
+ *
+ * @param set
+ * @param input
+ * @returns
+ */
+export declare function findAllCharacterOccurences(set: Set<string>, input: string, max?: number): number[];
+/**
+ * First the first occurence of a character from the set in the input string.
+ *
+ * @param set
+ * @param input
+ * @returns
+ */
+export declare function findFirstCharacterOccurence(set: Set<string>, input: string): Maybe<number>;
+export declare type SplitStringAtFirstCharacterOccurenceFunction = (input: string) => [string, string | undefined];
+/**
+ * Splits the string into two parts at the first occurence of a string or any string in the set.
+ *
+ * @param set
+ * @param input
+ */
+export declare function splitStringAtFirstCharacterOccurenceFunction(splitAt: string | Set<string>): SplitStringAtFirstCharacterOccurenceFunction;
+export declare function splitStringAtFirstCharacterOccurence(input: string, splitAt: string | Set<string>): [string, string | undefined];
+/**
+ * Keeps all characters from the input string after the first character occurence pre-determined by the function.
+ *
+ * If no trigger characters exist, returns an empty string.
+ */
+export declare type KeepCharactersAfterFirstCharacterOccurenceFunction = (input: string) => string;
+/**
+ * Splits the string into two parts at the first occurence of a string or any string in the set.
+ *
+ * @param set
+ * @param input
+ */
+export declare function keepCharactersAfterFirstCharacterOccurenceFunction(findCharacters: string | Set<string>): KeepCharactersAfterFirstCharacterOccurenceFunction;
+/**
+ * Keeps all characters from the input string after the first character occurence from findCharacters input.
+ *
+ * @param input
+ * @param splitAt
+ * @returns
+ */
+export declare function keepCharactersAfterFirstCharacterOccurence(input: string, findCharacters: string | Set<string>): string;
+/**
+ * Removes all characters from the input string after the first character occurence pre-determined by the function.
+ */
+export declare type RemoveCharactersAfterFirstCharacterOccurenceFunction = (input: string) => string;
+/**
+ * Splits the string into two parts at the first occurence of a string or any string in the set.
+ *
+ * @param set
+ * @param input
+ */
+export declare function removeCharactersAfterFirstCharacterOccurenceFunction(findCharacters: string | Set<string>): RemoveCharactersAfterFirstCharacterOccurenceFunction;
+/**
+ * Removes all characters from the input string after the first character occurence from findCharacters input.
+ *
+ * @param input
+ * @param splitAt
+ * @returns
+ */
+export declare function removeCharactersAfterFirstCharacterOccurence(input: string, findCharacters: string | Set<string>): string;

package/src/lib/string/replace.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findAllCharacterOccurences = exports.findAllCharacterOccurencesFunction = exports.escapeStringForRegex = exports.findStringsRegexString = exports.REGEX_SPECIAL_CHARACTERS_SET = exports.REGEX_SPECIAL_CHARACTERS = exports.replaceStringsFunction = void 0;
-const util_1 = require("@dereekb/util");
+exports.removeCharactersAfterFirstCharacterOccurence = exports.removeCharactersAfterFirstCharacterOccurenceFunction = exports.keepCharactersAfterFirstCharacterOccurence = exports.keepCharactersAfterFirstCharacterOccurenceFunction = exports.splitStringAtFirstCharacterOccurence = exports.splitStringAtFirstCharacterOccurenceFunction = exports.findFirstCharacterOccurence = exports.findAllCharacterOccurences = exports.findAllCharacterOccurencesFunction = exports.escapeStringForRegex = exports.findStringsRegexString = exports.REGEX_SPECIAL_CHARACTERS_SET = exports.REGEX_SPECIAL_CHARACTERS = exports.replaceStringsFunction = void 0;
+const array_1 = require("../array/array");
 const char_1 = require("./char");
 function replaceStringsFunction(config) {
     const { replace: replaceInput, replaceWith } = config;
@@ -18,7 +18,7 @@ exports.REGEX_SPECIAL_CHARACTERS_SET = new Set(exports.REGEX_SPECIAL_CHARACTERS)
  * @param find
  */
 function findStringsRegexString(find) {
-    const input = (0, util_1.asArray)(find);
+    const input = (0, array_1.asArray)(find);
     const escapedInput = input.map(escapeStringForRegex);
     return escapedInput.join('|');
 }
@@ -70,20 +70,112 @@ function escapeStringForRegex(input) {
 }
 exports.escapeStringForRegex = escapeStringForRegex;
 function findAllCharacterOccurencesFunction(characterSet) {
-    return (input) => {
+    return (input, maxToReturn) => {
+        const max = maxToReturn !== null && maxToReturn !== void 0 ? maxToReturn : Number.MAX_SAFE_INTEGER;
         const occurrences = [];
         for (let i = 0; i < input.length; i += 1) {
             const char = input[i];
             if (characterSet.has(char)) {
                 occurrences.push(i);
+                // return if at the max number of occurences
+                if (occurrences.length >= max) {
+                    break;
+                }
             }
         }
         return occurrences;
     };
 }
 exports.findAllCharacterOccurencesFunction = findAllCharacterOccurencesFunction;
-function findAllCharacterOccurences(set, input) {
-    return findAllCharacterOccurencesFunction(set)(input);
+/**
+ * First all occurences of the characters from the set in the input string.
+ *
+ * @param set
+ * @param input
+ * @returns
+ */
+function findAllCharacterOccurences(set, input, max) {
+    return findAllCharacterOccurencesFunction(set)(input, max);
 }
 exports.findAllCharacterOccurences = findAllCharacterOccurences;
+/**
+ * First the first occurence of a character from the set in the input string.
+ *
+ * @param set
+ * @param input
+ * @returns
+ */
+function findFirstCharacterOccurence(set, input) {
+    return findAllCharacterOccurences(set, input, 1)[0];
+}
+exports.findFirstCharacterOccurence = findFirstCharacterOccurence;
+/**
+ * Splits the string into two parts at the first occurence of a string or any string in the set.
+ *
+ * @param set
+ * @param input
+ */
+function splitStringAtFirstCharacterOccurenceFunction(splitAt) {
+    return (input) => {
+        const splitSet = typeof splitAt === 'string' ? new Set([splitAt]) : splitAt;
+        const firstOccurence = findFirstCharacterOccurence(splitSet, input);
+        let result;
+        if (firstOccurence != null) {
+            result = (0, char_1.splitStringAtIndex)(input, firstOccurence, false);
+        }
+        else {
+            result = [input, undefined];
+        }
+        return result;
+    };
+}
+exports.splitStringAtFirstCharacterOccurenceFunction = splitStringAtFirstCharacterOccurenceFunction;
+function splitStringAtFirstCharacterOccurence(input, splitAt) {
+    return splitStringAtFirstCharacterOccurenceFunction(splitAt)(input);
+}
+exports.splitStringAtFirstCharacterOccurence = splitStringAtFirstCharacterOccurence;
+/**
+ * Splits the string into two parts at the first occurence of a string or any string in the set.
+ *
+ * @param set
+ * @param input
+ */
+function keepCharactersAfterFirstCharacterOccurenceFunction(findCharacters) {
+    const splitStringAtFirstCharacterOccurence = splitStringAtFirstCharacterOccurenceFunction(findCharacters);
+    return (input) => { var _a; return (_a = splitStringAtFirstCharacterOccurence(input)[1]) !== null && _a !== void 0 ? _a : ''; };
+}
+exports.keepCharactersAfterFirstCharacterOccurenceFunction = keepCharactersAfterFirstCharacterOccurenceFunction;
+/**
+ * Keeps all characters from the input string after the first character occurence from findCharacters input.
+ *
+ * @param input
+ * @param splitAt
+ * @returns
+ */
+function keepCharactersAfterFirstCharacterOccurence(input, findCharacters) {
+    return keepCharactersAfterFirstCharacterOccurenceFunction(findCharacters)(input);
+}
+exports.keepCharactersAfterFirstCharacterOccurence = keepCharactersAfterFirstCharacterOccurence;
+/**
+ * Splits the string into two parts at the first occurence of a string or any string in the set.
+ *
+ * @param set
+ * @param input
+ */
+function removeCharactersAfterFirstCharacterOccurenceFunction(findCharacters) {
+    const splitStringAtFirstCharacterOccurence = splitStringAtFirstCharacterOccurenceFunction(findCharacters);
+    return (input) => splitStringAtFirstCharacterOccurence(input)[0];
+}
+exports.removeCharactersAfterFirstCharacterOccurenceFunction = removeCharactersAfterFirstCharacterOccurenceFunction;
+/**
+ * Removes all characters from the input string after the first character occurence from findCharacters input.
+ *
+ * @param input
+ * @param splitAt
+ * @returns
+ */
+function removeCharactersAfterFirstCharacterOccurence(input, findCharacters) {
+    return removeCharactersAfterFirstCharacterOccurenceFunction(findCharacters)(input);
+}
+exports.removeCharactersAfterFirstCharacterOccurence = removeCharactersAfterFirstCharacterOccurence;
 //# sourceMappingURL=replace.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"replace.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/string/replace.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"replace.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/string/replace.ts"],"names":[],"mappings":";;;AAAA,0CAAuD;AAGvD,iCAAyE;AAezE,SAAgB,sBAAsB,CAAC,MAA4B;IACjE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IACtD,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IACzD,OAAO,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;AACrE,CAAC;AALD,wDAKC;AAEY,QAAA,wBAAwB,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AACnG,QAAA,4BAA4B,GAAG,IAAI,GAAG,CAAC,gCAAwB,CAAC,CAAC;AAE9E;;;;GAIG;AACH,SAAgB,sBAAsB,CAAC,IAA0B;IAC/D,MAAM,KAAK,GAAG,IAAA,eAAO,EAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACrD,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC;AAJD,wDAIC;AAED;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAAC,KAAa;IAChD;;OAEG;IACH,MAAM,WAAW,GAAG,0BAA0B,CAAC,oCAA4B,EAAE,KAAK,CAAC,CAAC;IAEpF,IAAI,MAAc,CAAC;IAEnB,SAAS,eAAe,CAAC,IAAY;QACnC,OAAO,KAAK,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,QAAQ,WAAW,CAAC,MAAM,EAAE;QAC1B,KAAK,CAAC;YACJ,MAAM,GAAG,KAAK,CAAC;YACf,MAAM;QACR,KAAK,CAAC;YACJ,MAAM,aAAa,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM,GAAG,IAAA,kCAA2B,EAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,gCAAgC;YAC7H,MAAM;QACR;YACE,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC;YAEjC,IAAI,KAAK,GAAW,CAAC,CAAC;YACtB,IAAI,UAAU,GAAW,CAAC,CAAC;YAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE;gBACjC,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;gBAE5B,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC/B,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;gBAC/C,MAAM,IAAI,GAAG,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAEjB,KAAK,GAAG,UAAU,GAAG,CAAC,CAAC;aACxB;YAED,4BAA4B;YAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAEnC,0BAA0B;YAC1B,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACxB,MAAM;KACT;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AA/CD,oDA+CC;AAID,SAAgB,kCAAkC,CAAC,YAAyB;IAC1E,OAAO,CAAC,KAAa,EAAE,WAA2B,EAAE,EAAE;QACpD,MAAM,GAAG,GAAG,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,MAAM,CAAC,gBAAgB,CAAC;QACnD,MAAM,WAAW,GAAa,EAAE,CAAC;QAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;YACxC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAEtB,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;gBAC1B,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAEpB,4CAA4C;gBAC5C,IAAI,WAAW,CAAC,MAAM,IAAI,GAAG,EAAE;oBAC7B,MAAM;iBACP;aACF;SACF;QAED,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC;AApBD,gFAoBC;AAED;;;;;;GAMG;AACH,SAAgB,0BAA0B,CAAC,GAAgB,EAAE,KAAa,EAAE,GAAY;IACtF,OAAO,kCAAkC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC7D,CAAC;AAFD,gEAEC;AAED;;;;;;GAMG;AACH,SAAgB,2BAA2B,CAAC,GAAgB,EAAE,KAAa;IACzE,OAAO,0BAA0B,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAFD,kEAEC;AAID;;;;;GAKG;AACH,SAAgB,4CAA4C,CAAC,OAA6B;IACxF,OAAO,CAAC,KAAa,EAAE,EAAE;QACvB,MAAM,QAAQ,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAC5E,MAAM,cAAc,GAAG,2BAA2B,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACpE,IAAI,MAAoC,CAAC;QAEzC,IAAI,cAAc,IAAI,IAAI,EAAE;YAC1B,MAAM,GAAG,IAAA,yBAAkB,EAAC,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;SAC3D;aAAM;YACL,MAAM,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;SAC7B;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAdD,oGAcC;AAED,SAAgB,oCAAoC,CAAC,KAAa,EAAE,OAA6B;IAC/F,OAAO,4CAA4C,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC;AAFD,oFAEC;AASD;;;;;GAKG;AACH,SAAgB,kDAAkD,CAAC,cAAoC;IACrG,MAAM,oCAAoC,GAAG,4CAA4C,CAAC,cAAc,CAAC,CAAC;IAC1G,OAAO,CAAC,KAAa,EAAE,EAAE,WAAC,OAAA,MAAA,oCAAoC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,mCAAI,EAAE,CAAA,EAAA,CAAC;AACjF,CAAC;AAHD,gHAGC;AAED;;;;;;GAMG;AACH,SAAgB,0CAA0C,CAAC,KAAa,EAAE,cAAoC;IAC5G,OAAO,kDAAkD,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC;AACnF,CAAC;AAFD,gGAEC;AAOD;;;;;GAKG;AACH,SAAgB,oDAAoD,CAAC,cAAoC;IACvG,MAAM,oCAAoC,GAAG,4CAA4C,CAAC,cAAc,CAAC,CAAC;IAC1G,OAAO,CAAC,KAAa,EAAE,EAAE,CAAC,oCAAoC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AAHD,oHAGC;AAED;;;;;;GAMG;AACH,SAAgB,4CAA4C,CAAC,KAAa,EAAE,cAAoC;IAC9G,OAAO,oDAAoD,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC;AACrF,CAAC;AAFD,oGAEC"}

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

@@ -1,5 +1,5 @@
 import { EmailAddress } from '../contact/email';
-import { PhoneNumber } from '../contact/phone';
+import { E164PhoneNumber, E164PhoneNumberExtensionPair, E164PhoneNumberWithExtension, PhoneNumber } from '../contact/phone';
 import { IndexRangeInput } from './../value/indexed';
 import { MapFunction } from '../value/map';
 import { Maybe } from '../value/maybe.type';
@@ -181,4 +181,11 @@ export interface MailToUrl {
 }
 export declare type MailToUrlInput = EmailAddress | MailToUrl;
 export declare function mailToUrlString(input: MailToUrlInput): string;
-export declare function telUrlString(phone: PhoneNumber): string;
+export declare function telUrlString(phone: PhoneNumber | E164PhoneNumber | E164PhoneNumberWithExtension): string;
+/**
+ * Creates a tel url string for the input E164PhoneNumberExtensionPair.
+ *
+ * @param pair
+ * @returns
+ */
+export declare function telUrlStringForE164PhoneNumberPair(pair: E164PhoneNumberExtensionPair): string;

package/src/lib/string/url.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.telUrlString = exports.mailToUrlString = exports.hasHttpPrefix = exports.removeHttpFromUrl = exports.addHttpToUrl = exports.removeWebProtocolPrefix = exports.setWebProtocolPrefix = exports.WEB_PROTOCOL_PREFIX_REGEX = exports.HTTP_OR_HTTPS_REGEX = exports.websiteDomainAndPathPair = exports.websitePathFromWebsiteDomainAndPath = exports.websiteDomainAndPathPairFromWebsiteUrl = exports.websitePathFromWebsiteUrl = exports.fixExtraQueryParameters = exports.websitePathAndQueryPair = exports.isolateWebsitePathFunction = exports.hasWebsiteDomain = exports.WEBSITE_DOMAIN_NAME_REGEX = void 0;
+exports.telUrlStringForE164PhoneNumberPair = exports.telUrlString = exports.mailToUrlString = exports.hasHttpPrefix = exports.removeHttpFromUrl = exports.addHttpToUrl = exports.removeWebProtocolPrefix = exports.setWebProtocolPrefix = exports.WEB_PROTOCOL_PREFIX_REGEX = exports.HTTP_OR_HTTPS_REGEX = exports.websiteDomainAndPathPair = exports.websitePathFromWebsiteDomainAndPath = exports.websiteDomainAndPathPairFromWebsiteUrl = exports.websitePathFromWebsiteUrl = exports.fixExtraQueryParameters = exports.websitePathAndQueryPair = exports.isolateWebsitePathFunction = exports.hasWebsiteDomain = exports.WEBSITE_DOMAIN_NAME_REGEX = void 0;
+const phone_1 = require("../contact/phone");
 const path_1 = require("../path/path");
 const map_1 = require("../value/map");
 const replace_1 = require("./replace");
@@ -193,7 +194,27 @@ function mailToUrlString(input) {
 exports.mailToUrlString = mailToUrlString;
 // MARK: Tel
 function telUrlString(phone) {
+    if ((0, phone_1.isE164PhoneNumber)(phone, true)) {
+        const pair = (0, phone_1.e164PhoneNumberExtensionPair)(phone);
+        return telUrlStringForE164PhoneNumberPair(pair);
+    }
     return `tel:${phone}`;
 }
 exports.telUrlString = telUrlString;
+/**
+ * Creates a tel url string for the input E164PhoneNumberExtensionPair.
+ *
+ * @param pair
+ * @returns
+ */
+function telUrlStringForE164PhoneNumberPair(pair) {
+    // https://stackoverflow.com/questions/9482633/how-do-i-include-extensions-in-the-tel-uri
+    if (pair.extension) {
+        return `tel:${pair.number};${pair.extension}`;
+    }
+    else {
+        return `tel:${pair.number}`;
+    }
+}
+exports.telUrlStringForE164PhoneNumberPair = telUrlStringForE164PhoneNumberPair;
 //# sourceMappingURL=url.js.map

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

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

package/src/lib/type.d.ts

@@ -1,5 +1,9 @@
 import { Merge, NonNever, PickProperties, StrictOmit, UnionToIntersection, Writable } from 'ts-essentials';
 import { Maybe } from './value/maybe.type';
+/**
+ * Boolean, string or number value.
+ */
+export declare type PrimativeValue = boolean | string | number;
 /**
  * Class typing, restricted to types that have a constructor via the new keyword.
  */

package/src/lib/type.js.map

@@ -1 +1 @@
-{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/type.ts"],"names":[],"mappings":";;;AAeA;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAC,GAAQ;IAC9C,OAAO,OAAO,GAAG,KAAK,UAAU,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC;AAC/G,CAAC;AAFD,0DAEC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,GAAY;;IAC1C,OAAO,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA,MAAA,MAAM,CAAC,wBAAwB,CAAC,GAAG,EAAE,WAAW,CAAC,0CAAE,QAAQ,CAAA,CAAC;AACtG,CAAC;AAFD,0CAEC;AAID;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,CAAU;;IACxC,2GAA2G;IAC3G,OAAO,OAAO,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA,MAAA,MAAM,CAAC,wBAAwB,CAAC,CAAC,EAAE,WAAW,CAAC,0CAAE,QAAQ,EAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7M,CAAC;AAHD,0CAGC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,CAAU;IAC3C,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,OAAO,CAAC;AAC1C,CAAC;AAHD,gDAGC"}
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/type.ts"],"names":[],"mappings":";;;AAoBA;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAC,GAAQ;IAC9C,OAAO,OAAO,GAAG,KAAK,UAAU,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC;AAC/G,CAAC;AAFD,0DAEC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,GAAY;;IAC1C,OAAO,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA,MAAA,MAAM,CAAC,wBAAwB,CAAC,GAAG,EAAE,WAAW,CAAC,0CAAE,QAAQ,CAAA,CAAC;AACtG,CAAC;AAFD,0CAEC;AAID;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,CAAU;;IACxC,2GAA2G;IAC3G,OAAO,OAAO,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA,MAAA,MAAM,CAAC,wBAAwB,CAAC,CAAC,EAAE,WAAW,CAAC,0CAAE,QAAQ,EAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7M,CAAC;AAHD,0CAGC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,CAAU;IAC3C,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,OAAO,CAAC;AAC1C,CAAC;AAHD,gDAGC"}

package/test/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [9.24.18](https://github.com/dereekb/dbx-components/compare/v9.24.17-dev...v9.24.18) (2023-07-30)
+
+
+
+## [9.24.17](https://github.com/dereekb/dbx-components/compare/v9.24.16-dev...v9.24.17) (2023-07-24)
+
+
+
 ## [9.24.16](https://github.com/dereekb/dbx-components/compare/v9.24.15-dev...v9.24.16) (2023-07-14)
 
 

package/test/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@dereekb/util/test",
-  "version": "9.24.16",
+  "version": "9.24.18",
   "type": "commonjs",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
   "dependencies": {},
   "peerDependencies": {
-    "@dereekb/util": "9.24.16",
+    "@dereekb/util": "9.24.18",
     "lodash.isequal": "^4.5.0",
     "make-error": "^1.3.0",
     "class-validator": "^0.13.2",