@baseplate-dev/utils 0.1.3 → 0.2.0

package/dist/fs/index.d.ts

@@ -4,6 +4,7 @@ export * from './file-exists.js';
 export * from './find-nearest-package-json.js';
 export * from './handle-not-found-error.js';
 export * from './read-json-with-schema.js';
+export * from './remove-empty-directories.js';
 export * from './write-json.js';
 export * from './write-stable-pretty-json.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fs/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fs/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iBAAiB,CAAC;AAChC,cAAc,+BAA+B,CAAC"}

package/dist/fs/index.js

@@ -4,6 +4,7 @@ export * from './file-exists.js';
 export * from './find-nearest-package-json.js';
 export * from './handle-not-found-error.js';
 export * from './read-json-with-schema.js';
+export * from './remove-empty-directories.js';
 export * from './write-json.js';
 export * from './write-stable-pretty-json.js';
 //# sourceMappingURL=index.js.map

package/dist/fs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fs/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fs/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iBAAiB,CAAC;AAChC,cAAc,+BAA+B,CAAC"}

package/dist/fs/read-json-with-schema.d.ts

@@ -1,4 +1,4 @@
-import { type z } from 'zod';
+import type { z } from 'zod';
 /**
  * Reads a file, parses its content as JSON, and validates it against a Zod schema.
  * @param filePath - The path to the file.

package/dist/fs/read-json-with-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-json-with-schema.d.ts","sourceRoot":"","sources":["../../src/fs/read-json-with-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,CAAC,EAAY,MAAM,KAAK,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAC1D,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAoBtB"}
+{"version":3,"file":"read-json-with-schema.d.ts","sourceRoot":"","sources":["../../src/fs/read-json-with-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAK7B;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAC1D,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAoBtB"}

package/dist/fs/read-json-with-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-json-with-schema.js","sourceRoot":"","sources":["../../src/fs/read-json-with-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAU,QAAQ,EAAE,MAAM,KAAK,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,MAAS;IAET,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAY,CAAC;QACtD,yFAAyF;QACzF,OAAO,MAAO,MAAM,CAAC,UAAU,CAAC,UAAU,CAA0B,CAAC;IACvE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,SAAS,CACjB,yBAAyB,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,EACrD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACjC,MAAM,IAAI,SAAS,CAAC,yBAAyB,QAAQ,EAAE,EAAE;gBACvD,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"read-json-with-schema.js","sourceRoot":"","sources":["../../src/fs/read-json-with-schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,MAAS;IAET,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAY,CAAC;QACtD,yFAAyF;QACzF,OAAO,MAAO,MAAM,CAAC,UAAU,CAAC,UAAU,CAA0B,CAAC;IACvE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,SAAS,CACjB,yBAAyB,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,EACrD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACjC,MAAM,IAAI,SAAS,CAAC,yBAAyB,QAAQ,EAAE,EAAE;gBACvD,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/fs/remove-empty-directories.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Recursively removes empty directories.
+ */
+export declare function removeEmptyDirectories(directory: string): Promise<void>;
+//# sourceMappingURL=remove-empty-directories.d.ts.map

package/dist/fs/remove-empty-directories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-empty-directories.d.ts","sourceRoot":"","sources":["../../src/fs/remove-empty-directories.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB7E"}

package/dist/fs/remove-empty-directories.js

@@ -0,0 +1,21 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+/**
+ * Recursively removes empty directories.
+ */
+export async function removeEmptyDirectories(directory) {
+    const entries = await fs.readdir(directory, { withFileTypes: true });
+    // Process subdirectories first
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            const subdirectory = path.join(directory, entry.name);
+            await removeEmptyDirectories(subdirectory);
+        }
+    }
+    // Check if directory is now empty
+    const remainingEntries = await fs.readdir(directory);
+    if (remainingEntries.length === 0) {
+        await fs.rmdir(directory);
+    }
+}
+//# sourceMappingURL=remove-empty-directories.js.map

package/dist/fs/remove-empty-directories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-empty-directories.js","sourceRoot":"","sources":["../../src/fs/remove-empty-directories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,SAAiB;IAC5D,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAErE,+BAA+B;IAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,sBAAsB,CAAC,YAAY,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,MAAM,gBAAgB,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACrD,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/objects/index.d.ts

@@ -1,3 +1,4 @@
 export * from './safe-merge.js';
+export * from './sort-keys-recursive.js';
 export * from './sort-object-keys.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/objects/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/objects/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/dist/objects/index.js

@@ -1,3 +1,4 @@
 export * from './safe-merge.js';
+export * from './sort-keys-recursive.js';
 export * from './sort-object-keys.js';
 //# sourceMappingURL=index.js.map

package/dist/objects/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/objects/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/objects/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/dist/objects/sort-keys-recursive.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Recursively sorts all keys in an object, including nested objects and arrays.
+ *
+ * @param obj - The object to sort recursively.
+ * @returns A new object with all keys sorted recursively.
+ */
+export declare function sortKeysRecursive<T>(obj: T): T;
+//# sourceMappingURL=sort-keys-recursive.d.ts.map

package/dist/objects/sort-keys-recursive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-keys-recursive.d.ts","sourceRoot":"","sources":["../../src/objects/sort-keys-recursive.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAc9C"}

package/dist/objects/sort-keys-recursive.js

@@ -0,0 +1,18 @@
+/**
+ * Recursively sorts all keys in an object, including nested objects and arrays.
+ *
+ * @param obj - The object to sort recursively.
+ * @returns A new object with all keys sorted recursively.
+ */
+export function sortKeysRecursive(obj) {
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(sortKeysRecursive);
+    }
+    return Object.fromEntries(Object.entries(obj)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([key, value]) => [key, sortKeysRecursive(value)]));
+}
+//# sourceMappingURL=sort-keys-recursive.js.map

package/dist/objects/sort-keys-recursive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-keys-recursive.js","sourceRoot":"","sources":["../../src/objects/sort-keys-recursive.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAI,GAAM;IACzC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAM,CAAC;IACzC,CAAC;IAED,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;SAChB,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CACrD,CAAC;AACT,CAAC"}

package/dist/paths/index.d.ts

@@ -1,3 +1,5 @@
 export * from './get-common-path-prefix.js';
+export * from './normalize-path-separators.js';
 export * from './posix-join.js';
+export * from './safe-path-join.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/paths/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/paths/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/paths/index.js

@@ -1,3 +1,5 @@
 export * from './get-common-path-prefix.js';
+export * from './normalize-path-separators.js';
 export * from './posix-join.js';
+export * from './safe-path-join.js';
 //# sourceMappingURL=index.js.map

package/dist/paths/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/paths/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/paths/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/paths/normalize-path-separators.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Normalizes path separators from Windows (\) to Unix (/) format.
+ * @param filePath The path to normalize
+ * @returns The path with Unix separators
+ */
+export declare function normalizePathSeparators(filePath: string): string;
+//# sourceMappingURL=normalize-path-separators.d.ts.map

package/dist/paths/normalize-path-separators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-path-separators.d.ts","sourceRoot":"","sources":["../../src/paths/normalize-path-separators.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/paths/normalize-path-separators.js

@@ -0,0 +1,10 @@
+import path from 'node:path';
+/**
+ * Normalizes path separators from Windows (\) to Unix (/) format.
+ * @param filePath The path to normalize
+ * @returns The path with Unix separators
+ */
+export function normalizePathSeparators(filePath) {
+    return filePath.replaceAll(path.win32.sep, path.posix.sep);
+}
+//# sourceMappingURL=normalize-path-separators.js.map

package/dist/paths/normalize-path-separators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-path-separators.js","sourceRoot":"","sources":["../../src/paths/normalize-path-separators.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC7D,CAAC"}

package/dist/paths/safe-path-join.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Safely joins paths ensuring the result is always within the parent directory.
+ * This prevents directory traversal attacks by resolving the path and checking
+ * that it remains within the parent directory boundaries.
+ *
+ * @param parentDir - The parent directory that the result must be within
+ * @param ...segments - Path segments to join to the parent directory
+ * @returns The joined path that is guaranteed to be within the parent directory
+ * @throws Error if the resulting path would be outside the parent directory
+ *
+ * @example
+ * ```ts
+ * // Valid paths
+ * safePathJoin('/home/user', 'documents', 'file.txt')
+ * // Returns: '/home/user/documents/file.txt'
+ *
+ * // Throws error - attempts to escape parent directory
+ * safePathJoin('/home/user', '../../../etc/passwd')
+ * // Throws: Error: Path traversal detected
+ *
+ * // Handles complex paths safely
+ * safePathJoin('/home/user', 'docs/../documents/./file.txt')
+ * // Returns: '/home/user/documents/file.txt'
+ * ```
+ */
+export declare function safePathJoin(parentDir: string, ...segments: string[]): string;
+//# sourceMappingURL=safe-path-join.d.ts.map

package/dist/paths/safe-path-join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-path-join.d.ts","sourceRoot":"","sources":["../../src/paths/safe-path-join.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAoD7E"}

package/dist/paths/safe-path-join.js

@@ -0,0 +1,64 @@
+import path from 'node:path';
+/**
+ * Safely joins paths ensuring the result is always within the parent directory.
+ * This prevents directory traversal attacks by resolving the path and checking
+ * that it remains within the parent directory boundaries.
+ *
+ * @param parentDir - The parent directory that the result must be within
+ * @param ...segments - Path segments to join to the parent directory
+ * @returns The joined path that is guaranteed to be within the parent directory
+ * @throws Error if the resulting path would be outside the parent directory
+ *
+ * @example
+ * ```ts
+ * // Valid paths
+ * safePathJoin('/home/user', 'documents', 'file.txt')
+ * // Returns: '/home/user/documents/file.txt'
+ *
+ * // Throws error - attempts to escape parent directory
+ * safePathJoin('/home/user', '../../../etc/passwd')
+ * // Throws: Error: Path traversal detected
+ *
+ * // Handles complex paths safely
+ * safePathJoin('/home/user', 'docs/../documents/./file.txt')
+ * // Returns: '/home/user/documents/file.txt'
+ * ```
+ */
+export function safePathJoin(parentDir, ...segments) {
+    // Normalize the parent directory to handle any . or .. in it
+    const normalizedParent = path.resolve(parentDir);
+    // Check for absolute paths in segments (which would escape the parent)
+    for (const segment of segments) {
+        if (path.isAbsolute(segment)) {
+            throw new Error(`Path traversal detected: Absolute path segment "${segment}" is not allowed`);
+        }
+    }
+    // Join all segments together
+    const joined = path.join(normalizedParent, ...segments);
+    // Resolve to get the absolute path
+    const resolved = path.resolve(joined);
+    // Special case for root directory
+    if (normalizedParent === path.sep || normalizedParent === path.resolve('/')) {
+        // When parent is root, we need to check if we're trying to go above root
+        if (resolved !== normalizedParent &&
+            !resolved.startsWith(normalizedParent)) {
+            throw new Error(`Path traversal detected: Cannot navigate outside root directory`);
+        }
+        return resolved;
+    }
+    // Check if the resolved path is within the parent directory
+    // Add path separator to ensure exact directory match (not just prefix match)
+    const parentWithSep = normalizedParent.endsWith(path.sep)
+        ? normalizedParent
+        : normalizedParent + path.sep;
+    // Special case: if resolved is exactly the parent directory
+    if (resolved === normalizedParent) {
+        return resolved;
+    }
+    // Check if resolved path starts with parent directory
+    if (!resolved.startsWith(parentWithSep)) {
+        throw new Error(`Path traversal detected: Resolved path "${resolved}" is outside parent directory "${normalizedParent}"`);
+    }
+    return resolved;
+}
+//# sourceMappingURL=safe-path-join.js.map

package/dist/paths/safe-path-join.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-path-join.js","sourceRoot":"","sources":["../../src/paths/safe-path-join.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,GAAG,QAAkB;IACnE,6DAA6D;IAC7D,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEjD,uEAAuE;IACvE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,mDAAmD,OAAO,kBAAkB,CAC7E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,QAAQ,CAAC,CAAC;IAExD,mCAAmC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtC,kCAAkC;IAClC,IAAI,gBAAgB,KAAK,IAAI,CAAC,GAAG,IAAI,gBAAgB,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5E,yEAAyE;QACzE,IACE,QAAQ,KAAK,gBAAgB;YAC7B,CAAC,QAAQ,CAAC,UAAU,CAAC,gBAAgB,CAAC,EACtC,CAAC;YACD,MAAM,IAAI,KAAK,CACb,iEAAiE,CAClE,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,4DAA4D;IAC5D,6EAA6E;IAC7E,MAAM,aAAa,GAAG,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;QACvD,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC;IAEhC,4DAA4D;IAC5D,IAAI,QAAQ,KAAK,gBAAgB,EAAE,CAAC;QAClC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,sDAAsD;IACtD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,2CAA2C,QAAQ,kCAAkC,gBAAgB,GAAG,CACzG,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/string/index.d.ts

@@ -1,3 +1,3 @@
 export * from './quot.js';
-export * from './random-uid.js';
+export * from './random-key.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/string/index.js

@@ -1,3 +1,3 @@
 export * from './quot.js';
-export * from './random-uid.js';
+export * from './random-key.js';
 //# sourceMappingURL=index.js.map

package/dist/string/random-key.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generate a random key string made up of numbers, lowercase, and uppercase letters
+ * @returns A random key string
+ */
+export declare function randomKey(length?: number): string;
+//# sourceMappingURL=random-key.d.ts.map

package/dist/string/random-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random-key.d.ts","sourceRoot":"","sources":["../../src/string/random-key.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAK,GAAG,MAAM,CAE7C"}

package/dist/string/{random-uid.js → random-key.js}

@@ -7,10 +7,10 @@ const UPPERCASE = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
  */
 const customNanoid = customAlphabet(`${NUMBERS}${LOWERCASE}${UPPERCASE}_`, 12);
 /**
- * Generate a random ID string made up of numbers, lowercase, and uppercase letters
- * @returns A random ID string
+ * Generate a random key string made up of numbers, lowercase, and uppercase letters
+ * @returns A random key string
  */
-export function randomUid(length = 12) {
+export function randomKey(length = 12) {
     return customNanoid(length);
 }
-//# sourceMappingURL=random-uid.js.map
+//# sourceMappingURL=random-key.js.map

package/dist/string/{random-uid.js.map → random-key.js.map}

@@ -1 +1 @@
-{"version":3,"file":"random-uid.js","sourceRoot":"","sources":["../../src/string/random-uid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC,MAAM,OAAO,GAAG,YAAY,CAAC;AAC7B,MAAM,SAAS,GAAG,4BAA4B,CAAC;AAC/C,MAAM,SAAS,GAAG,4BAA4B,CAAC;AAE/C;;GAEG;AACH,MAAM,YAAY,GAAG,cAAc,CAAC,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,EAAE,EAAE,CAAC,CAAC;AAE/E;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,MAAM,GAAG,EAAE;IACnC,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"random-key.js","sourceRoot":"","sources":["../../src/string/random-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC,MAAM,OAAO,GAAG,YAAY,CAAC;AAC7B,MAAM,SAAS,GAAG,4BAA4B,CAAC;AAC/C,MAAM,SAAS,GAAG,4BAA4B,CAAC;AAE/C;;GAEG;AACH,MAAM,YAAY,GAAG,cAAc,CAAC,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,EAAE,EAAE,CAAC,CAAC;AAE/E;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,MAAM,GAAG,EAAE;IACnC,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/validators/case-validators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"case-validators.d.ts","sourceRoot":"","sources":["../../src/validators/case-validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAiB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAwB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAwB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAAsB,CAAC;AAEvD,eAAO,MAAM,eAAe;IAC1B;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;CAEK,CAAC"}
+{"version":3,"file":"case-validators.d.ts","sourceRoot":"","sources":["../../src/validators/case-validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAiB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAwB,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAwB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAAsB,CAAC;AAEvD,eAAO,MAAM,eAAe;IAC1B;;OAEG;;IAIH;;OAEG;;IAIH;;OAEG;;IAIH;;OAEG;;CAIK,CAAC"}

package/dist/validators/case-validators.js

@@ -19,18 +19,26 @@ export const CASE_VALIDATORS = {
     /**
      * Zod validator for validating kebab case, e.g. "my-project".
      */
-    KEBAB_CASE: z.string().regex(KEBAB_CASE_REGEX),
+    KEBAB_CASE: z.string().regex(KEBAB_CASE_REGEX, {
+        message: 'Must be kebab case (e.g. "my-project")',
+    }),
     /**
      * Zod validator for validating pascal case, e.g. "MyProject".
      */
-    PASCAL_CASE: z.string().regex(PASCAL_CASE_REGEX),
+    PASCAL_CASE: z.string().regex(PASCAL_CASE_REGEX, {
+        message: 'Must be pascal case (e.g. "MyProject")',
+    }),
     /**
      * Zod validator for validating camel case, e.g. "myProject".
      */
-    CAMEL_CASE: z.string().regex(CAMEL_CASE_REGEX),
+    CAMEL_CASE: z.string().regex(CAMEL_CASE_REGEX, {
+        message: 'Must be camel case (e.g. "myProject")',
+    }),
     /**
      * Zod validator for validating constant case, e.g. "MY_PROJECT".
      */
-    CONSTANT_CASE: z.string().regex(CONSTANT_CASE_REGEX),
+    CONSTANT_CASE: z.string().regex(CONSTANT_CASE_REGEX, {
+        message: 'Must be constant case (e.g. "MY_PROJECT")',
+    }),
 };
 //# sourceMappingURL=case-validators.js.map

package/dist/validators/case-validators.js.map

@@ -1 +1 @@
-{"version":3,"file":"case-validators.js","sourceRoot":"","sources":["../../src/validators/case-validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEvD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B;;OAEG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAC9C;;OAEG;IACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC;IAChD;;OAEG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAC9C;;OAEG;IACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC;CAC5C,CAAC"}
+{"version":3,"file":"case-validators.js","sourceRoot":"","sources":["../../src/validators/case-validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEvD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B;;OAEG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,EAAE;QAC7C,OAAO,EAAE,wCAAwC;KAClD,CAAC;IACF;;OAEG;IACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE;QAC/C,OAAO,EAAE,wCAAwC;KAClD,CAAC;IACF;;OAEG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,EAAE;QAC7C,OAAO,EAAE,uCAAuC;KACjD,CAAC;IACF;;OAEG;IACH,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE;QACnD,OAAO,EAAE,2CAA2C;KACrD,CAAC;CACM,CAAC"}

package/dist/validators/transform-with-dynamic-schema.d.ts

@@ -1,4 +1,4 @@
-import { type RefinementCtx, type ZodTypeAny } from 'zod';
+import type { RefinementCtx, ZodTypeAny } from 'zod';
 /**
  * Transforms a value using a dynamic schema and forwards any issues to transform context.
  *

package/dist/validators/transform-with-dynamic-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform-with-dynamic-schema.d.ts","sourceRoot":"","sources":["../../src/validators/transform-with-dynamic-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAK,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AAE7D;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,SAAS,MAAM,EAC7D,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,UAAU,GAAG,SAAS,EACjD,SAAS,CAAC,EAAE,MAAM,KAAK,GACtB,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,KAAK,KAAK,CA6B5C"}
+{"version":3,"file":"transform-with-dynamic-schema.d.ts","sourceRoot":"","sources":["../../src/validators/transform-with-dynamic-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAIrD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,SAAS,MAAM,EAC7D,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,UAAU,GAAG,SAAS,EACjD,SAAS,CAAC,EAAE,MAAM,KAAK,GACtB,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,KAAK,KAAK,CA6B5C"}

package/dist/validators/transform-with-dynamic-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"transform-with-dynamic-schema.js","sourceRoot":"","sources":["../../src/validators/transform-with-dynamic-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,CAAC,EAAmB,MAAM,KAAK,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACxC,QAAiD,EACjD,SAAuB;IAEvB,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACnB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAE9B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAC7B,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,SAAS,CAClD,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBACxC,GAAG,CAAC,QAAQ,CAAC;oBACX,GAAG,KAAK;oBACR,IAAI,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;iBACnE,CAAC,CAAC;YACL,CAAC;YACD,OAAO,CAAC,CAAC,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,SAAS;YACd,CAAC,CAAC;gBACE,GAAG,IAAI;gBACP,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,IAA+B;aACpD;YACH,CAAC,CAAE,MAAM,CAAC,IAAc,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"transform-with-dynamic-schema.js","sourceRoot":"","sources":["../../src/validators/transform-with-dynamic-schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACxC,QAAiD,EACjD,SAAuB;IAEvB,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACnB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAE9B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAC7B,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,SAAS,CAClD,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBACxC,GAAG,CAAC,QAAQ,CAAC;oBACX,GAAG,KAAK;oBACR,IAAI,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;iBACnE,CAAC,CAAC;YACL,CAAC;YACD,OAAO,CAAC,CAAC,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,SAAS;YACd,CAAC,CAAC;gBACE,GAAG,IAAI;gBACP,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,IAA+B;aACpD;YACH,CAAC,CAAE,MAAM,CAAC,IAAc,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,7 +1,16 @@
 {
   "name": "@baseplate-dev/utils",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "Shared utility functions for Baseplate",
+  "keywords": [
+    "utilities",
+    "typescript",
+    "helpers",
+    "common",
+    "baseplate",
+    "full-stack",
+    "code-generation"
+  ],
   "homepage": "https://www.baseplate.dev",
   "repository": {
     "type": "git",
@@ -42,7 +51,7 @@
     "prettier": "3.5.3",
     "typescript": "5.7.3",
     "vitest": "3.0.7",
-    "@baseplate-dev/tools": "0.1.3"
+    "@baseplate-dev/tools": "0.2.0"
   },
   "engines": {
     "node": "^22.0.0"

package/dist/string/random-uid.d.ts

@@ -1,6 +0,0 @@
-/**
- * Generate a random ID string made up of numbers, lowercase, and uppercase letters
- * @returns A random ID string
- */
-export declare function randomUid(length?: number): string;
-//# sourceMappingURL=random-uid.d.ts.map

package/dist/string/random-uid.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"random-uid.d.ts","sourceRoot":"","sources":["../../src/string/random-uid.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAK,GAAG,MAAM,CAE7C"}