@baseplate-dev/utils 0.3.3 → 0.3.4

package/dist/crypto/hash.d.ts

@@ -1,2 +1,2 @@
-export declare function hashWithSHA256(content: string | ArrayBuffer): Promise<string>;
+export declare function hashWithSHA256(content: string | ArrayBuffer | Buffer): Promise<string>;
 //# sourceMappingURL=hash.d.ts.map

package/dist/crypto/hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/crypto/hash.ts"],"names":[],"mappings":"AAQA,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,GAAG,WAAW,GAC5B,OAAO,CAAC,MAAM,CAAC,CAKjB"}
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/crypto/hash.ts"],"names":[],"mappings":"AAcA,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,GACrC,OAAO,CAAC,MAAM,CAAC,CAKjB"}

package/dist/crypto/hash.js

@@ -1,7 +1,11 @@
 function normalizeContent(content) {
     if (typeof content === 'string') {
         const encoder = new TextEncoder();
-        return encoder.encode(content);
+        const { buffer } = encoder.encode(content);
+        if (!(buffer instanceof ArrayBuffer)) {
+            throw new TypeError('Buffer is not an ArrayBuffer');
+        }
+        return buffer;
     }
     return content;
 }

package/dist/crypto/hash.js.map

@@ -1 +1 @@
-{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/crypto/hash.ts"],"names":[],"mappings":"AAAA,SAAS,gBAAgB,CAAC,OAA6B;IACrD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA6B;IAE7B,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IAClD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC"}
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/crypto/hash.ts"],"names":[],"mappings":"AAAA,SAAS,gBAAgB,CACvB,OAAsC;IAEtC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,CAAC,MAAM,YAAY,WAAW,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,SAAS,CAAC,8BAA8B,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAsC;IAEtC,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IAClD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC"}

package/dist/fs/write-stable-pretty-json.d.ts

@@ -6,5 +6,5 @@
  * @param filePath - The path to the file.
  * @param data - The data to write to the file.
  */
-export declare function writeStablePrettyJson(filePath: string, data: Record<string, unknown>): Promise<void>;
+export declare function writeStablePrettyJson(filePath: string, data: object): Promise<void>;
 //# sourceMappingURL=write-stable-pretty-json.d.ts.map

package/dist/fs/write-stable-pretty-json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-stable-pretty-json.d.ts","sourceRoot":"","sources":["../../src/fs/write-stable-pretty-json.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAGf"}
+{"version":3,"file":"write-stable-pretty-json.d.ts","sourceRoot":"","sources":["../../src/fs/write-stable-pretty-json.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/fs/write-stable-pretty-json.js.map

@@ -1 +1 @@
-{"version":3,"file":"write-stable-pretty-json.js","sourceRoot":"","sources":["../../src/fs/write-stable-pretty-json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAgB,EAChB,IAA6B;IAE7B,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"write-stable-pretty-json.js","sourceRoot":"","sources":["../../src/fs/write-stable-pretty-json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAgB,EAChB,IAAY;IAEZ,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;AACxD,CAAC"}

package/dist/string/find-closest-match.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Finds the n closest matches to a target string from an array of strings using Levenshtein distance.
+ *
+ * @param target - The string to find matches for
+ * @param candidates - Array of candidate strings to search through
+ * @param n - Number of closest matches to return (defaults to 1)
+ * @returns Array of the n closest matches, sorted by distance (closest first)
+ *
+ * @example
+ * ```typescript
+ * const candidates = ['apple', 'banana', 'orange', 'grape'];
+ * const matches = findClosestMatch('aple', candidates, 2);
+ * // Returns: ['apple', 'grape'] (assuming these are the 2 closest matches)
+ * ```
+ */
+export declare function findClosestMatch(target: string, candidates: string[], n?: number): string[];
+//# sourceMappingURL=find-closest-match.d.ts.map

package/dist/string/find-closest-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-closest-match.d.ts","sourceRoot":"","sources":["../../src/string/find-closest-match.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAAE,EACpB,CAAC,SAAI,GACJ,MAAM,EAAE,CA0BV"}

package/dist/string/find-closest-match.js

@@ -0,0 +1,40 @@
+import { distance } from 'fastest-levenshtein';
+/**
+ * Finds the n closest matches to a target string from an array of strings using Levenshtein distance.
+ *
+ * @param target - The string to find matches for
+ * @param candidates - Array of candidate strings to search through
+ * @param n - Number of closest matches to return (defaults to 1)
+ * @returns Array of the n closest matches, sorted by distance (closest first)
+ *
+ * @example
+ * ```typescript
+ * const candidates = ['apple', 'banana', 'orange', 'grape'];
+ * const matches = findClosestMatch('aple', candidates, 2);
+ * // Returns: ['apple', 'grape'] (assuming these are the 2 closest matches)
+ * ```
+ */
+export function findClosestMatch(target, candidates, n = 1) {
+    if (candidates.length === 0) {
+        return [];
+    }
+    if (n <= 0) {
+        return [];
+    }
+    // Calculate distances for all candidates
+    const distances = candidates.map((candidate, index) => ({
+        candidate,
+        distance: distance(target, candidate),
+        index,
+    }));
+    // Sort by distance (ascending) and then by original index for stable sorting
+    distances.sort((a, b) => {
+        if (a.distance !== b.distance) {
+            return a.distance - b.distance;
+        }
+        return a.index - b.index;
+    });
+    // Return the n closest matches
+    return distances.slice(0, n).map((item) => item.candidate);
+}
+//# sourceMappingURL=find-closest-match.js.map

package/dist/string/find-closest-match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-closest-match.js","sourceRoot":"","sources":["../../src/string/find-closest-match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,UAAoB,EACpB,CAAC,GAAG,CAAC;IAEL,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,yCAAyC;IACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACtD,SAAS;QACT,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;QACrC,KAAK;KACN,CAAC,CAAC,CAAC;IAEJ,6EAA6E;IAC7E,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACtB,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC9B,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;QACjC,CAAC;QACD,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,+BAA+B;IAC/B,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC7D,CAAC"}

package/dist/string/index.d.ts

@@ -1,4 +1,5 @@
 export * from './convert-case-with-prefix.js';
+export * from './find-closest-match.js';
 export * from './quot.js';
 export * from './random-key.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}

package/dist/string/index.js

@@ -1,4 +1,5 @@
 export * from './convert-case-with-prefix.js';
+export * from './find-closest-match.js';
 export * from './quot.js';
 export * from './random-key.js';
 //# sourceMappingURL=index.js.map

package/dist/string/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baseplate-dev/utils",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Shared utility functions for Baseplate",
   "keywords": [
     "utilities",
@@ -39,19 +39,20 @@
   ],
   "dependencies": {
     "es-toolkit": "1.31.0",
+    "fastest-levenshtein": "^1.0.16",
     "nanoid": "5.0.9",
     "sort-keys": "^5.1.0",
     "tinyqueue": "3.0.0",
-    "zod": "3.24.1"
+    "zod": "3.25.76"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
+    "@types/node": "^22.17.2",
     "eslint": "9.32.0",
     "memfs": "4.15.1",
     "prettier": "3.6.2",
-    "typescript": "5.7.3",
+    "typescript": "5.8.3",
     "vitest": "3.2.4",
-    "@baseplate-dev/tools": "0.3.3"
+    "@baseplate-dev/tools": "0.3.4"
   },
   "engines": {
     "node": "^22.0.0"