@augment-vir/common 23.3.4 → 24.0.0

package/dist/cjs/augments/{array.js → array/array.js}

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.filterMap = exports.arrayToObject = exports.groupArrayBy = exports.repeatArray = exports.typedMap = exports.typedArrayIncludes = exports.trimArrayStrings = exports.flatten2dArray = exports.filterOutIndexes = void 0;
-const object_entries_1 = require("./object/object-entries");
+const object_entries_1 = require("../object/object-entries");
 function filterOutIndexes(array, indexes) {
     return array.filter((_, index) => !indexes.includes(index));
 }

package/dist/cjs/augments/array/remove-duplicates.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeDuplicates = void 0;
+function removeDuplicates(originalArray, calculateUniqueIdCallback) {
+    const grouped = new Map();
+    return originalArray.filter((entry) => {
+        const uniqueId = calculateUniqueIdCallback(entry);
+        if (grouped.get(uniqueId)) {
+            return false;
+        }
+        else {
+            grouped.set(uniqueId, entry);
+            return true;
+        }
+    });
+}
+exports.removeDuplicates = removeDuplicates;

package/dist/cjs/augments/error.js

@@ -52,9 +52,9 @@ function ensureErrorAndPrependMessage(maybeError, prependMessage) {
     return error;
 }
 exports.ensureErrorAndPrependMessage = ensureErrorAndPrependMessage;
-function wrapInTry(inputs) {
+function wrapInTry(callback, inputs) {
     try {
-        const returnValue = inputs.callback();
+        const returnValue = callback();
         if (returnValue instanceof Promise) {
             return returnValue.catch((error) => {
                 if (inputs.catchCallback) {

package/dist/cjs/index.js

@@ -15,7 +15,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./augments/ansi"), exports);
-__exportStar(require("./augments/array"), exports);
+__exportStar(require("./augments/array/array"), exports);
+__exportStar(require("./augments/array/remove-duplicates"), exports);
 __exportStar(require("./augments/async"), exports);
 __exportStar(require("./augments/boolean"), exports);
 __exportStar(require("./augments/common-number"), exports);
@@ -50,7 +51,6 @@ __exportStar(require("./augments/regexp"), exports);
 __exportStar(require("./augments/string/prefixes"), exports);
 __exportStar(require("./augments/string/search-params"), exports);
 __exportStar(require("./augments/string/suffixes"), exports);
-__exportStar(require("./augments/string/url"), exports);
 __exportStar(require("./augments/string/uuid"), exports);
 __exportStar(require("./augments/time"), exports);
 __exportStar(require("./augments/truncate-number"), exports);

package/dist/esm/augments/{array.js → array/array.js}

@@ -1,4 +1,4 @@
-import { typedObjectFromEntries } from './object/object-entries';
+import { typedObjectFromEntries } from '../object/object-entries';
 export function filterOutIndexes(array, indexes) {
     return array.filter((_, index) => !indexes.includes(index));
 }

package/dist/esm/augments/array/remove-duplicates.js

@@ -0,0 +1,13 @@
+export function removeDuplicates(originalArray, calculateUniqueIdCallback) {
+    const grouped = new Map();
+    return originalArray.filter((entry) => {
+        const uniqueId = calculateUniqueIdCallback(entry);
+        if (grouped.get(uniqueId)) {
+            return false;
+        }
+        else {
+            grouped.set(uniqueId, entry);
+            return true;
+        }
+    });
+}

package/dist/esm/augments/error.js

@@ -44,9 +44,9 @@ export function ensureErrorAndPrependMessage(maybeError, prependMessage) {
     error.message = `${prependMessage}: ${error.message}`;
     return error;
 }
-export function wrapInTry(inputs) {
+export function wrapInTry(callback, inputs) {
     try {
-        const returnValue = inputs.callback();
+        const returnValue = callback();
         if (returnValue instanceof Promise) {
             return returnValue.catch((error) => {
                 if (inputs.catchCallback) {

package/dist/esm/index.js

@@ -1,5 +1,6 @@
 export * from './augments/ansi';
-export * from './augments/array';
+export * from './augments/array/array';
+export * from './augments/array/remove-duplicates';
 export * from './augments/async';
 export * from './augments/boolean';
 export * from './augments/common-number';
@@ -34,7 +35,6 @@ export * from './augments/regexp';
 export * from './augments/string/prefixes';
 export * from './augments/string/search-params';
 export * from './augments/string/suffixes';
-export * from './augments/string/url';
 export * from './augments/string/uuid';
 export * from './augments/time';
 export * from './augments/truncate-number';

package/dist/types/augments/{array.d.ts → array/array.d.ts}

@@ -1,5 +1,5 @@
-import { AtLeastTuple } from './tuple';
-import { ArrayElement } from './type';
+import { AtLeastTuple } from '../tuple';
+import { ArrayElement } from '../type';
 export declare function filterOutIndexes<T>(array: ReadonlyArray<T>, indexes: ReadonlyArray<number>): T[];
 export declare function flatten2dArray<T>(array2d: ReadonlyArray<ReadonlyArray<T>>): T[];
 export type AtLeastOneEntryArray<ArrayGeneric extends ReadonlyArray<any>> = AtLeastTuple<ArrayElement<ArrayGeneric>, 1>;

package/dist/types/augments/array/remove-duplicates.d.ts

@@ -0,0 +1 @@
+export declare function removeDuplicates<Entry, UniqueId>(originalArray: ReadonlyArray<Readonly<Entry>>, calculateUniqueIdCallback: (entry: Readonly<Entry>) => UniqueId): Readonly<Entry>[];

package/dist/types/augments/error.d.ts

@@ -9,12 +9,10 @@ export declare function combineErrorMessages(errors?: ReadonlyArray<Error | stri
 export declare function extractErrorMessage(maybeError: unknown): string;
 export declare function ensureError(maybeError: unknown): Error;
 export declare function ensureErrorAndPrependMessage(maybeError: unknown, prependMessage: string): Error;
-export type TryWrapInputs<CallbackReturn, FallbackReturn> = {
-    callback: () => CallbackReturn;
-} & RequireExactlyOne<{
+export type TryWrapConfig<FallbackReturn> = RequireExactlyOne<{
     fallbackValue: FallbackReturn;
     catchCallback: (error: unknown) => FallbackReturn;
 }>;
-export declare function wrapInTry<CallbackReturn, FallbackReturn>(inputs: TryWrapInputs<CallbackReturn, FallbackReturn>): FallbackReturn | CallbackReturn;
+export declare function wrapInTry<CallbackReturn, FallbackReturn>(callback: () => CallbackReturn, inputs: TryWrapConfig<FallbackReturn>): FallbackReturn | CallbackReturn;
 export declare function executeAndReturnError<CallbackGeneric extends NoInputsFunction<PromiseLike<any>>>(callback: CallbackGeneric): Promise<Error | Awaited<ReturnType<CallbackGeneric>>>;
 export declare function executeAndReturnError<CallbackGeneric extends NoInputsFunction>(callback: CallbackGeneric): Error | ReturnType<CallbackGeneric>;

package/dist/types/augments/object/matches-object-shape.d.ts

@@ -1,4 +1,4 @@
-import { AtLeastOneEntryArray } from '../array';
+import { AtLeastOneEntryArray } from '../array/array';
 import { NoInfer } from '../type';
 /**
  * Checks that the first input, testThisOne, matches the object shape of the second input,

package/dist/types/index.d.ts

@@ -1,5 +1,6 @@
 export * from './augments/ansi';
-export * from './augments/array';
+export * from './augments/array/array';
+export * from './augments/array/remove-duplicates';
 export * from './augments/async';
 export * from './augments/boolean';
 export * from './augments/common-number';
@@ -34,7 +35,6 @@ export * from './augments/regexp';
 export * from './augments/string/prefixes';
 export * from './augments/string/search-params';
 export * from './augments/string/suffixes';
-export * from './augments/string/url';
 export * from './augments/string/uuid';
 export * from './augments/time';
 export * from './augments/truncate-number';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@augment-vir/common",
-    "version": "23.3.4",
+    "version": "24.0.0",
     "homepage": "https://github.com/electrovir/augment-vir/tree/main/packages/common",
     "bugs": {
         "url": "https://github.com/electrovir/augment-vir/issues"
@@ -26,7 +26,7 @@
     "dependencies": {
         "browser-or-node": "^2.1.1",
         "run-time-assertions": "^1.0.0",
-        "type-fest": "^4.10.2"
+        "type-fest": "^4.12.0"
     },
     "devDependencies": {
         "typescript": "5.3.3"

package/dist/cjs/augments/string/url.js

@@ -1,73 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.joinUrlParts = void 0;
-const protocolSplit = '://';
-/**
- * Joins all given arguments together as if they were parts of a URL. Preserves trailing slashes and
- * removes consecutive slashes in the path.
- *
- * @example: joinToUrl('https://example.com', 'path1', 'path2/', '/path3/') === 'https://example.com/path1/path2/path3/'
- */
-function joinUrlParts(...urlParts) {
-    const rawJoined = urlParts.join('/');
-    const [protocol, rawRest = '',] = rawJoined.includes(protocolSplit)
-        ? rawJoined.split(protocolSplit)
-        : [
-            '',
-            rawJoined,
-        ];
-    let mapSearchParamsStarted = false;
-    let reduceSearchParamsStarted = false;
-    const fixedRest = rawRest
-        .replace(/\/{2,}/g, '/')
-        .split('/')
-        .map((part) => {
-        if (part.includes('?') || mapSearchParamsStarted) {
-            mapSearchParamsStarted = true;
-            return part;
-        }
-        else {
-            return part;
-        }
-    })
-        .reduce((fillingUpArray, currentEntry, currentIndex, inputArray) => {
-        if (reduceSearchParamsStarted) {
-            return fillingUpArray;
-        }
-        const nextEntry = inputArray[currentIndex + 1];
-        let newEntry = currentEntry;
-        const nextHasQuestion = !currentEntry.includes('?') && nextEntry?.startsWith('?');
-        if (nextEntry?.startsWith('?') || nextHasQuestion) {
-            reduceSearchParamsStarted = true;
-            let foundHash = false;
-            const subsequentSearchParams = inputArray
-                .slice(nextHasQuestion ? currentIndex + 2 : currentIndex + 1)
-                .reduce((joinedParams, currentParam) => {
-                if (currentParam.includes('#')) {
-                    foundHash = true;
-                }
-                if (foundHash) {
-                    return joinedParams.concat(currentParam);
-                }
-                else {
-                    return [
-                        joinedParams,
-                        currentParam,
-                    ].join('&');
-                }
-            }, '');
-            newEntry = [
-                currentEntry,
-                nextEntry,
-                subsequentSearchParams,
-            ].join('');
-        }
-        return fillingUpArray.concat(newEntry);
-    }, []);
-    return [
-        protocol,
-        protocol ? protocolSplit : '',
-        fixedRest.join('/'),
-    ].join('');
-}
-exports.joinUrlParts = joinUrlParts;

package/dist/esm/augments/string/url.js

@@ -1,69 +0,0 @@
-const protocolSplit = '://';
-/**
- * Joins all given arguments together as if they were parts of a URL. Preserves trailing slashes and
- * removes consecutive slashes in the path.
- *
- * @example: joinToUrl('https://example.com', 'path1', 'path2/', '/path3/') === 'https://example.com/path1/path2/path3/'
- */
-export function joinUrlParts(...urlParts) {
-    const rawJoined = urlParts.join('/');
-    const [protocol, rawRest = '',] = rawJoined.includes(protocolSplit)
-        ? rawJoined.split(protocolSplit)
-        : [
-            '',
-            rawJoined,
-        ];
-    let mapSearchParamsStarted = false;
-    let reduceSearchParamsStarted = false;
-    const fixedRest = rawRest
-        .replace(/\/{2,}/g, '/')
-        .split('/')
-        .map((part) => {
-        if (part.includes('?') || mapSearchParamsStarted) {
-            mapSearchParamsStarted = true;
-            return part;
-        }
-        else {
-            return part;
-        }
-    })
-        .reduce((fillingUpArray, currentEntry, currentIndex, inputArray) => {
-        if (reduceSearchParamsStarted) {
-            return fillingUpArray;
-        }
-        const nextEntry = inputArray[currentIndex + 1];
-        let newEntry = currentEntry;
-        const nextHasQuestion = !currentEntry.includes('?') && nextEntry?.startsWith('?');
-        if (nextEntry?.startsWith('?') || nextHasQuestion) {
-            reduceSearchParamsStarted = true;
-            let foundHash = false;
-            const subsequentSearchParams = inputArray
-                .slice(nextHasQuestion ? currentIndex + 2 : currentIndex + 1)
-                .reduce((joinedParams, currentParam) => {
-                if (currentParam.includes('#')) {
-                    foundHash = true;
-                }
-                if (foundHash) {
-                    return joinedParams.concat(currentParam);
-                }
-                else {
-                    return [
-                        joinedParams,
-                        currentParam,
-                    ].join('&');
-                }
-            }, '');
-            newEntry = [
-                currentEntry,
-                nextEntry,
-                subsequentSearchParams,
-            ].join('');
-        }
-        return fillingUpArray.concat(newEntry);
-    }, []);
-    return [
-        protocol,
-        protocol ? protocolSplit : '',
-        fixedRest.join('/'),
-    ].join('');
-}

package/dist/types/augments/string/url.d.ts

@@ -1,7 +0,0 @@
-/**
- * Joins all given arguments together as if they were parts of a URL. Preserves trailing slashes and
- * removes consecutive slashes in the path.
- *
- * @example: joinToUrl('https://example.com', 'path1', 'path2/', '/path3/') === 'https://example.com/path1/path2/path3/'
- */
-export declare function joinUrlParts(...urlParts: ReadonlyArray<string>): string;