@minvws/mgo-utils 0.1.1-2 → 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+## 0.1.2 (2026-10-08)
+
+### 🚀 Features
+
+- **utils:** add omitUndefined ([e7d507ec](https://github.com/minvws/nl-mgo-app-web-private/commit/e7d507ec))
+- **utils:** add seeded mock factory helper ([a09013c8](https://github.com/minvws/nl-mgo-app-web-private/commit/a09013c8))
+- **utils:** add expectJson helper for tests ([3bcb4a74](https://github.com/minvws/nl-mgo-app-web-private/commit/3bcb4a74))
+- **utils:** add includesAll ([cad84f1e](https://github.com/minvws/nl-mgo-app-web-private/commit/cad84f1e))
+- **utils:** add has intersection helper ([c63a51ca](https://github.com/minvws/nl-mgo-app-web-private/commit/c63a51ca))
+- **utils:** add fallback slug for empty/undefined values when creating unique slugs ([62b52120](https://github.com/minvws/nl-mgo-app-web-private/commit/62b52120))
+- add AllOrNone utility type ([1740434e](https://github.com/minvws/nl-mgo-app-web-private/commit/1740434e))
+- update utils package to be node compatible ([1c8a12ee](https://github.com/minvws/nl-mgo-app-web-private/commit/1c8a12ee))
+- add initial nx config ([#798](https://github.com/minvws/nl-mgo-app-web-private/pull/798))
+
+### 🩹 Fixes
+
+- remove DOM dependencies ([19cc83ba](https://github.com/minvws/nl-mgo-app-web-private/commit/19cc83ba))
+- **utils:** avoid factory method trigger during setup ([498db9cc](https://github.com/minvws/nl-mgo-app-web-private/commit/498db9cc))
+
+### ❤️ Thank You
+
+- Geert Fokke
+- Otto Boekesteijn

package/dist/createJsonApi/createJsonApi.d.ts

@@ -0,0 +1,10 @@
+type Func = (...args: any[]) => any;
+type JsonParam<TParams extends readonly any[]> = {
+    [K in keyof TParams]: string;
+};
+type JsonInterfacedFunction<F> = F extends (...args: infer T) => infer R ? (...args: JsonParam<T>) => R extends undefined ? string | undefined : string : never;
+export declare function createJsonApi<T extends Func>(func: T, options?: {
+    lossless?: boolean;
+}): JsonInterfacedFunction<T>;
+export {};
+//# sourceMappingURL=createJsonApi.d.ts.map

package/dist/createJsonApi/createJsonApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJsonApi.d.ts","sourceRoot":"","sources":["../../src/createJsonApi/createJsonApi.ts"],"names":[],"mappings":"AAGA,KAAK,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAGpC,KAAK,SAAS,CAAC,OAAO,SAAS,SAAS,GAAG,EAAE,IAAI;KAC5C,CAAC,IAAI,MAAM,OAAO,GAAG,MAAM;CAC/B,CAAC;AAEF,KAAK,sBAAsB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,GAClE,CAAC,GAAG,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAC5E,KAAK,CAAC;AAQZ,wBAAgB,aAAa,CAAC,CAAC,SAAS,IAAI,EACxC,IAAI,EAAE,CAAC,EACP,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACrC,sBAAsB,CAAC,CAAC,CAAC,CAa3B"}

package/dist/createJsonApi/createJsonApi.js

@@ -0,0 +1,16 @@
+import { losslessParse, losslessStringify } from '@minvws/mgo-utils';
+function isPromise(value) {
+    return (typeof value === 'object' && typeof value?.then === 'function');
+}
+export function createJsonApi(func, options = {}) {
+    const parse = options.lossless ? losslessParse : (value) => JSON.parse(value);
+    const stringify = options.lossless ? losslessStringify : JSON.stringify;
+    const replaceUndefinedWithNull = (_key, value) => value === undefined ? null : value;
+    return function (...args) {
+        const result = func(...args.map(parse));
+        if (isPromise(result)) {
+            return result.then((value) => stringify(value, replaceUndefinedWithNull));
+        }
+        return stringify(result, replaceUndefinedWithNull);
+    };
+}

package/dist/hasIntersection/hasIntersection.d.ts

@@ -0,0 +1,2 @@
+export declare function hasIntersection<T>(a: T[], b: T[]): boolean;
+//# sourceMappingURL=hasIntersection.d.ts.map

package/dist/hasIntersection/hasIntersection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasIntersection.d.ts","sourceRoot":"","sources":["../../src/hasIntersection/hasIntersection.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,OAAO,CAG1D"}

package/dist/hasIntersection/hasIntersection.js

@@ -0,0 +1,4 @@
+export function hasIntersection(a, b) {
+    const setB = new Set(b);
+    return a.some((item) => setB.has(item));
+}

package/dist/includesAll/includesAll.d.ts

@@ -0,0 +1,2 @@
+export declare function includesAll<T>(a: readonly T[], b: readonly T[]): boolean;
+//# sourceMappingURL=includesAll.d.ts.map

package/dist/includesAll/includesAll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"includesAll.d.ts","sourceRoot":"","sources":["../../src/includesAll/includesAll.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,OAAO,CAGxE"}

package/dist/includesAll/includesAll.js

@@ -0,0 +1,4 @@
+export function includesAll(a, b) {
+    const setA = new Set(a);
+    return b.every((item) => setA.has(item));
+}

package/dist/index.d.ts

@@ -1,9 +1,13 @@
 export * from './types/index.js';
+export * from './createJsonApi/createJsonApi.js';
 export * from './defer/defer.js';
 export * from './flushCallStack/flushCallStack.js';
+export * from './hasIntersection/hasIntersection.js';
+export * from './includesAll/includesAll.js';
 export * from './isNonNullish/isNonNullish.js';
 export * from './isNullish/isNullish.js';
-export * from './log/log.js';
 export * from './lossless/lossless.js';
+export * from './map/map.js';
+export * from './omitUndefined/omitUndefined.js';
 export * from './uniqueSlug/uniqueSlug.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AAEjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AAEjC,cAAc,kCAAkC,CAAC;AACjD,cAAc,kBAAkB,CAAC;AACjC,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC"}

package/dist/index.js

@@ -1,8 +1,12 @@
 export * from './types/index.js';
+export * from './createJsonApi/createJsonApi.js';
 export * from './defer/defer.js';
 export * from './flushCallStack/flushCallStack.js';
+export * from './hasIntersection/hasIntersection.js';
+export * from './includesAll/includesAll.js';
 export * from './isNonNullish/isNonNullish.js';
 export * from './isNullish/isNullish.js';
-export * from './log/log.js';
 export * from './lossless/lossless.js';
+export * from './map/map.js';
+export * from './omitUndefined/omitUndefined.js';
 export * from './uniqueSlug/uniqueSlug.js';

package/dist/map/map.d.ts

@@ -0,0 +1,17 @@
+import { type Nullable } from '../types/Nullable.js';
+/**
+ * Creates an array of values by running each element in collection thru iteratee.
+ * If the collection is empty or undefined it will return undefined, unless the `returnEmpty` parameter is set to true.
+ * The resulting array will NOT contain any undefined or null values.
+ *
+ * @example
+ * const iteratee = (x: string | null | undefined) => x;
+ * map(undefined, iteratee); // => undefined
+ * map(undefined, iteratee, true); // => []
+ * map([], iteratee); // => undefined
+ * map(['foo', 'bar'], iteratee); // => ['foo', 'bar']
+ * map(['foo', undefined, 'bar', null, undefined], iteratee); // => ['foo', 'bar']
+ */
+export declare function map<Items extends unknown[], Iteratee extends (arg: Items[number], key: number) => unknown, T = NonNullable<ReturnType<Iteratee>>>(items: Nullable<Items>, iteratee: Iteratee, returnEmpty: true): T[];
+export declare function map<Items extends unknown[], Iteratee extends (arg: Items[number], key: number) => unknown, T = NonNullable<ReturnType<Iteratee>>>(items: Nullable<Items>, iteratee: Iteratee, returnEmpty?: false): T[] | undefined;
+//# sourceMappingURL=map.d.ts.map

package/dist/map/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/map/map.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,wBAAgB,GAAG,CACf,KAAK,SAAS,OAAO,EAAE,EACvB,QAAQ,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,EAC7D,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,EACvC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC;AACtE,wBAAgB,GAAG,CACf,KAAK,SAAS,OAAO,EAAE,EACvB,QAAQ,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,EAC7D,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,EACvC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,SAAS,CAAC"}

package/dist/map/map.js

@@ -0,0 +1,7 @@
+import { isNonNullish } from '../isNonNullish/isNonNullish.js';
+export function map(items, iteratee, returnEmpty = false) {
+    if (!items?.length) {
+        return returnEmpty ? [] : undefined;
+    }
+    return items.map(iteratee).filter(isNonNullish);
+}

package/dist/omitUndefined/omitUndefined.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Omits all undefined values from an object.
+ * @example
+ * ```ts
+ * omitUndefined({ a: 1, b: undefined, c: 3 }) // { a: 1, c: 3 }
+ * ```
+ */
+export declare function omitUndefined<T extends Record<string, unknown>>(value: T): Partial<T>;
+//# sourceMappingURL=omitUndefined.d.ts.map

package/dist/omitUndefined/omitUndefined.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"omitUndefined.d.ts","sourceRoot":"","sources":["../../src/omitUndefined/omitUndefined.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAIrF"}

package/dist/omitUndefined/omitUndefined.js

@@ -0,0 +1,10 @@
+/**
+ * Omits all undefined values from an object.
+ * @example
+ * ```ts
+ * omitUndefined({ a: 1, b: undefined, c: 3 }) // { a: 1, c: 3 }
+ * ```
+ */
+export function omitUndefined(value) {
+    return Object.fromEntries(Object.entries(value).filter(([_, propValue]) => propValue !== undefined));
+}

package/dist/types/AllOrNone.d.ts

@@ -0,0 +1,8 @@
+import type { SetOptional } from 'type-fest';
+/**
+ * Either the full object `T`, with all required keys - or - none of the keys
+ */
+export type AllOrNone<T> = T | SetOptional<{
+    [K in keyof T]: never;
+}, keyof T>;
+//# sourceMappingURL=AllOrNone.d.ts.map

package/dist/types/AllOrNone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AllOrNone.d.ts","sourceRoot":"","sources":["../../src/types/AllOrNone.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,KAAK;CAAE,EAAE,MAAM,CAAC,CAAC,CAAC"}

package/dist/types/AllOrNone.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -1,2 +1,3 @@
+export * from './AllOrNone.js';
 export * from './Nullable.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/types/index.js

@@ -1 +1,2 @@
+export * from './AllOrNone.js';
 export * from './Nullable.js';

package/dist/uniqueSlug/uniqueSlug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uniqueSlug.d.ts","sourceRoot":"","sources":["../../src/uniqueSlug/uniqueSlug.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAStE"}
+{"version":3,"file":"uniqueSlug.d.ts","sourceRoot":"","sources":["../../src/uniqueSlug/uniqueSlug.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAYtE"}

package/dist/uniqueSlug/uniqueSlug.js

@@ -1,6 +1,9 @@
 import { kebabCase } from 'lodash-es';
 export function createUniqueSlug(value, existingSlugs) {
-    const slug = kebabCase(value);
+    let slug = kebabCase(value);
+    if (slug.length === 0) {
+        slug = 'undefined';
+    }
     let uniqueSlug = slug;
     let i = 2;
     while (existingSlugs.includes(uniqueSlug)) {

package/package.json

@@ -2,13 +2,14 @@
   "name": "@minvws/mgo-utils",
   "license": "EUPL-1.2",
   "type": "module",
-  "version": "0.1.1-2",
+  "version": "0.1.2",
   "repository": {
     "type": "git",
     "url": "https://github.com/minvws/nl-mgo-app-web"
   },
   "files": [
-    "dist/"
+    "dist/",
+    "CHANGELOG.md"
   ],
   "exports": {
     "./package.json": "./package.json",
@@ -17,16 +18,20 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./test/shared": {
+      "development": "./test/shared/index.ts"
     }
   },
   "dependencies": {
-    "lodash-es": "^4.17.21",
-    "lossless-json": "^4.0.1"
+    "lodash-es": "^4.18.1",
+    "lossless-json": "^4.3.1"
   },
   "devDependencies": {
-    "@faker-js/faker": "^8.4.1",
+    "@faker-js/faker": "^10.6.0",
     "@types/lodash-es": "^4.17.12",
-    "type-fest": "^4.23.0",
+    "@types/node": "^24.1.0",
+    "type-fest": "^5.10.0",
     "typescript": "^5.4.5"
   },
   "scripts": {}