@scalar/helpers 0.0.13 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @scalar/helpers
 
+## 0.1.1
+
+### Patch Changes
+
+- [#7289](https://github.com/scalar/scalar/pull/7289) [`9c9dbba`](https://github.com/scalar/scalar/commit/9c9dbbaa940667303f0ace59469fd78c2a741937) Thanks [@amritk](https://github.com/amritk)! - feat: move debounce to helpers and add max wait
+
+- [#7252](https://github.com/scalar/scalar/pull/7252) [`4bec1ba`](https://github.com/scalar/scalar/commit/4bec1ba332e919c4ee32dcfbfb07bd8ee42c4d74) Thanks [@hwkr](https://github.com/hwkr)! - fix(api-reference): improve wrapping of long strings
+
+## 0.1.0
+
+### Minor Changes
+
+- [#7235](https://github.com/scalar/scalar/pull/7235) [`c1ecd0c`](https://github.com/scalar/scalar/commit/c1ecd0c6096f3fbe2e3d8ad3794ea718bb6bce66) Thanks [@marcalexiei](https://github.com/marcalexiei)! - feat(helpers): add `node:path` polyfill
+
+### Patch Changes
+
+- [#7266](https://github.com/scalar/scalar/pull/7266) [`fddf294`](https://github.com/scalar/scalar/commit/fddf294b00dd8c9eb5c713c338f2ec6e3f62523d) Thanks [@amritk](https://github.com/amritk)! - fix: remove useage of crypto.subtle in all contexts
+
 ## 0.0.13
 
 ### Patch Changes

package/dist/general/debounce.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Options for configuring the debounce behavior.
+ */
+export type DebounceOptions = {
+    /** The delay in milliseconds before executing the function. Defaults to 100ms. */
+    delay?: number;
+    /** Maximum time in milliseconds to wait before forcing execution, even with continuous calls. */
+    maxWait?: number;
+};
+/**
+ * Creates a debounced function executor that delays execution until after a specified time.
+ * Multiple calls with the same key will cancel previous pending executions.
+ *
+ * This is useful for batching rapid updates (like auto-save or API calls) to avoid
+ * unnecessary processing or network requests.
+ *
+ * @param options - Configuration options for delay, maxWait, and key separator
+ * @returns A function that accepts a key array and callback to execute
+ *
+ * @example
+ * const debouncedSave = debounce({ delay: 328 })
+ * debouncedSave.execute(['user', '123'], () => saveUser(user))
+ *
+ * @example
+ * // With maxWait to guarantee execution even with continuous calls
+ * const debouncedSave = debounce({ delay: 328, maxWait: 2000 })
+ * debouncedSave.execute(['user', '123'], () => saveUser(user))
+ */
+export declare const debounce: (options?: DebounceOptions) => {
+    execute: (key: string, fn: () => unknown | Promise<unknown>) => void;
+    cleanup: () => void;
+};
+//# sourceMappingURL=debounce.d.ts.map

package/dist/general/debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/general/debounce.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iGAAiG;IACjG,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,QAAQ,GAAI,UAAS,eAAoB;mBA6C9B,MAAM,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAG,IAAI;mBAvCrD,IAAI;CAiEzB,CAAA"}

package/dist/general/debounce.js

@@ -0,0 +1,55 @@
+const debounce = (options = {}) => {
+  const { delay = 328, maxWait } = options;
+  const timeouts = /* @__PURE__ */ new Map();
+  const maxWaitTimeouts = /* @__PURE__ */ new Map();
+  const latestFunctions = /* @__PURE__ */ new Map();
+  const cleanup = () => {
+    timeouts.forEach(clearTimeout);
+    maxWaitTimeouts.forEach(clearTimeout);
+    timeouts.clear();
+    maxWaitTimeouts.clear();
+    latestFunctions.clear();
+  };
+  const executeAndCleanup = (key) => {
+    const fn = latestFunctions.get(key);
+    const timeout = timeouts.get(key);
+    if (timeout !== void 0) {
+      clearTimeout(timeout);
+      timeouts.delete(key);
+    }
+    const maxWaitTimeout = maxWaitTimeouts.get(key);
+    if (maxWaitTimeout !== void 0) {
+      clearTimeout(maxWaitTimeout);
+      maxWaitTimeouts.delete(key);
+    }
+    latestFunctions.delete(key);
+    if (fn !== void 0) {
+      try {
+        fn();
+      } catch {
+      }
+    }
+  };
+  const execute = (key, fn) => {
+    latestFunctions.set(key, fn);
+    const existingTimeout = timeouts.get(key);
+    if (existingTimeout !== void 0) {
+      clearTimeout(existingTimeout);
+    }
+    timeouts.set(
+      key,
+      setTimeout(() => executeAndCleanup(key), delay)
+    );
+    if (maxWait !== void 0 && !maxWaitTimeouts.has(key)) {
+      maxWaitTimeouts.set(
+        key,
+        setTimeout(() => executeAndCleanup(key), maxWait)
+      );
+    }
+  };
+  return { execute, cleanup };
+};
+export {
+  debounce
+};
+//# sourceMappingURL=debounce.js.map

package/dist/general/debounce.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/general/debounce.ts"],
+  "sourcesContent": ["/**\n * Options for configuring the debounce behavior.\n */\nexport type DebounceOptions = {\n  /** The delay in milliseconds before executing the function. Defaults to 100ms. */\n  delay?: number\n  /** Maximum time in milliseconds to wait before forcing execution, even with continuous calls. */\n  maxWait?: number\n}\n\n/**\n * Creates a debounced function executor that delays execution until after a specified time.\n * Multiple calls with the same key will cancel previous pending executions.\n *\n * This is useful for batching rapid updates (like auto-save or API calls) to avoid\n * unnecessary processing or network requests.\n *\n * @param options - Configuration options for delay, maxWait, and key separator\n * @returns A function that accepts a key array and callback to execute\n *\n * @example\n * const debouncedSave = debounce({ delay: 328 })\n * debouncedSave.execute(['user', '123'], () => saveUser(user))\n *\n * @example\n * // With maxWait to guarantee execution even with continuous calls\n * const debouncedSave = debounce({ delay: 328, maxWait: 2000 })\n * debouncedSave.execute(['user', '123'], () => saveUser(user))\n */\nexport const debounce = (options: DebounceOptions = {}) => {\n  const { delay = 328, maxWait } = options\n  const timeouts = new Map<string, ReturnType<typeof setTimeout>>()\n  const maxWaitTimeouts = new Map<string, ReturnType<typeof setTimeout>>()\n  const latestFunctions = new Map<string, () => unknown | Promise<unknown>>()\n\n  const cleanup = (): void => {\n    timeouts.forEach(clearTimeout)\n    maxWaitTimeouts.forEach(clearTimeout)\n    timeouts.clear()\n    maxWaitTimeouts.clear()\n    latestFunctions.clear()\n  }\n\n  /** Executes the function and cleans up all associated timeouts */\n  const executeAndCleanup = (key: string): void => {\n    // Get the latest function for this key\n    const fn = latestFunctions.get(key)\n\n    // Clear both timeout types\n    const timeout = timeouts.get(key)\n    if (timeout !== undefined) {\n      clearTimeout(timeout)\n      timeouts.delete(key)\n    }\n\n    const maxWaitTimeout = maxWaitTimeouts.get(key)\n    if (maxWaitTimeout !== undefined) {\n      clearTimeout(maxWaitTimeout)\n      maxWaitTimeouts.delete(key)\n    }\n\n    // Clear the latest function reference\n    latestFunctions.delete(key)\n\n    // Execute the function if it exists\n    if (fn !== undefined) {\n      try {\n        fn()\n      } catch {\n        // Errors are silently caught to prevent the debounce mechanism from breaking\n      }\n    }\n  }\n\n  const execute = (key: string, fn: () => unknown | Promise<unknown>): void => {\n    // Store the latest function for this key\n    latestFunctions.set(key, fn)\n\n    // Clear existing debounce timeout\n    const existingTimeout = timeouts.get(key)\n    if (existingTimeout !== undefined) {\n      clearTimeout(existingTimeout)\n    }\n\n    // Set debounce timeout\n    timeouts.set(\n      key,\n      setTimeout(() => executeAndCleanup(key), delay),\n    )\n\n    // Set maxWait timeout only if configured and this is a new sequence\n    if (maxWait !== undefined && !maxWaitTimeouts.has(key)) {\n      maxWaitTimeouts.set(\n        key,\n        setTimeout(() => executeAndCleanup(key), maxWait),\n      )\n    }\n  }\n\n  return { execute, cleanup }\n}\n"],
+  "mappings": "AA6BO,MAAM,WAAW,CAAC,UAA2B,CAAC,MAAM;AACzD,QAAM,EAAE,QAAQ,KAAK,QAAQ,IAAI;AACjC,QAAM,WAAW,oBAAI,IAA2C;AAChE,QAAM,kBAAkB,oBAAI,IAA2C;AACvE,QAAM,kBAAkB,oBAAI,IAA8C;AAE1E,QAAM,UAAU,MAAY;AAC1B,aAAS,QAAQ,YAAY;AAC7B,oBAAgB,QAAQ,YAAY;AACpC,aAAS,MAAM;AACf,oBAAgB,MAAM;AACtB,oBAAgB,MAAM;AAAA,EACxB;AAGA,QAAM,oBAAoB,CAAC,QAAsB;AAE/C,UAAM,KAAK,gBAAgB,IAAI,GAAG;AAGlC,UAAM,UAAU,SAAS,IAAI,GAAG;AAChC,QAAI,YAAY,QAAW;AACzB,mBAAa,OAAO;AACpB,eAAS,OAAO,GAAG;AAAA,IACrB;AAEA,UAAM,iBAAiB,gBAAgB,IAAI,GAAG;AAC9C,QAAI,mBAAmB,QAAW;AAChC,mBAAa,cAAc;AAC3B,sBAAgB,OAAO,GAAG;AAAA,IAC5B;AAGA,oBAAgB,OAAO,GAAG;AAG1B,QAAI,OAAO,QAAW;AACpB,UAAI;AACF,WAAG;AAAA,MACL,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AAEA,QAAM,UAAU,CAAC,KAAa,OAA+C;AAE3E,oBAAgB,IAAI,KAAK,EAAE;AAG3B,UAAM,kBAAkB,SAAS,IAAI,GAAG;AACxC,QAAI,oBAAoB,QAAW;AACjC,mBAAa,eAAe;AAAA,IAC9B;AAGA,aAAS;AAAA,MACP;AAAA,MACA,WAAW,MAAM,kBAAkB,GAAG,GAAG,KAAK;AAAA,IAChD;AAGA,QAAI,YAAY,UAAa,CAAC,gBAAgB,IAAI,GAAG,GAAG;AACtD,sBAAgB;AAAA,QACd;AAAA,QACA,WAAW,MAAM,kBAAkB,GAAG,GAAG,OAAO;AAAA,MAClD;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,SAAS,QAAQ;AAC5B;",
+  "names": []
+}

package/dist/node/path.d.ts

@@ -0,0 +1,23 @@
+export declare function resolve(...parameters: Array<string>): string;
+export declare function normalize(inputPath: string): string;
+export declare function isAbsolute(path: string): boolean;
+export declare function join(...paths: string[]): string;
+export declare function relative(from: string, to: string): string;
+export declare const sep = "/";
+export declare const delimiter = ":";
+export declare function dirname(path: string): string;
+export declare function basename(path: string, ext?: string): string;
+export declare function extname(path: string): string;
+export declare const path: {
+    extname: typeof extname;
+    basename: typeof basename;
+    dirname: typeof dirname;
+    sep: string;
+    delimiter: string;
+    relative: typeof relative;
+    join: typeof join;
+    isAbsolute: typeof isAbsolute;
+    normalize: typeof normalize;
+    resolve: typeof resolve;
+};
+//# sourceMappingURL=path.d.ts.map

package/dist/node/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/node/path.ts"],"names":[],"mappings":"AAgEA,wBAAgB,OAAO,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,UA6BnD;AAID,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAkBnD;AAGD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAGD,wBAAgB,IAAI,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,UAWtC;AAID,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,UA6ChD;AAED,eAAO,MAAM,GAAG,MAAM,CAAA;AACtB,eAAO,MAAM,SAAS,MAAM,CAAA;AAE5B,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgB5C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,eAAO,MAAM,IAAI;;;;;;;;;;;CAWhB,CAAA"}

package/dist/node/path.js

@@ -0,0 +1,157 @@
+function normalizeArray(parts, allowAboveRoot) {
+  let up = 0;
+  for (let i = parts.length - 1; i >= 0; i--) {
+    const last = parts[i];
+    if (last === ".") {
+      parts.splice(i, 1);
+    } else if (last === "..") {
+      parts.splice(i, 1);
+      up++;
+    } else if (up) {
+      parts.splice(i, 1);
+      up--;
+    }
+  }
+  if (allowAboveRoot) {
+    for (; up--; up) {
+      parts.unshift("..");
+    }
+  }
+  return parts;
+}
+const splitPathRe = /^(\/?|)([\s\S]*?)((?:\.{1,2}|[^/]+?|)(\.[^./]*|))(?:[/]*)$/;
+const splitPath = (filename) => splitPathRe.exec(filename).slice(1);
+function resolve(...parameters) {
+  let resolvedPath = "", resolvedAbsolute = false;
+  for (let i = parameters.length - 1; i >= -1 && !resolvedAbsolute; i--) {
+    const path2 = i >= 0 ? parameters[i] : "/";
+    if (typeof path2 !== "string") {
+      throw new TypeError("Arguments to path.resolve must be strings");
+    }
+    if (!path2) {
+      continue;
+    }
+    resolvedPath = path2 + "/" + resolvedPath;
+    resolvedAbsolute = path2.charAt(0) === "/";
+  }
+  resolvedPath = normalizeArray(
+    resolvedPath.split("/").filter((p) => !!p),
+    !resolvedAbsolute
+  ).join("/");
+  return (resolvedAbsolute ? "/" : "") + resolvedPath || ".";
+}
+function normalize(inputPath) {
+  const isPathAbsolute = isAbsolute(inputPath), trailingSlash = inputPath.slice(-1) === "/";
+  let path2 = normalizeArray(
+    inputPath.split("/").filter((p) => !!p),
+    !isPathAbsolute
+  ).join("/");
+  if (!path2 && !isPathAbsolute) {
+    path2 = ".";
+  }
+  if (path2 && trailingSlash) {
+    path2 += "/";
+  }
+  return (isPathAbsolute ? "/" : "") + path2;
+}
+function isAbsolute(path2) {
+  return path2.charAt(0) === "/";
+}
+function join(...paths) {
+  return normalize(
+    paths.filter((p) => {
+      if (typeof p !== "string") {
+        throw new TypeError("Arguments to path.join must be strings");
+      }
+      return p;
+    }).join("/")
+  );
+}
+function relative(from, to) {
+  const fromResolved = resolve(from).substring(1);
+  const toResolved = resolve(to).substring(1);
+  function trim(arr) {
+    let start = 0;
+    for (; start < arr.length; start++) {
+      if (arr[start] !== "") {
+        break;
+      }
+    }
+    let end = arr.length - 1;
+    for (; end >= 0; end--) {
+      if (arr[end] !== "") {
+        break;
+      }
+    }
+    if (start > end) {
+      return [];
+    }
+    return arr.slice(start, end - start + 1);
+  }
+  const fromParts = trim(fromResolved.split("/"));
+  const toParts = trim(toResolved.split("/"));
+  const length = Math.min(fromParts.length, toParts.length);
+  let samePartsLength = length;
+  for (let i = 0; i < length; i++) {
+    if (fromParts[i] !== toParts[i]) {
+      samePartsLength = i;
+      break;
+    }
+  }
+  let outputParts = [];
+  for (let i = samePartsLength; i < fromParts.length; i++) {
+    outputParts.push("..");
+  }
+  outputParts = outputParts.concat(toParts.slice(samePartsLength));
+  return outputParts.join("/");
+}
+const sep = "/";
+const delimiter = ":";
+function dirname(path2) {
+  const result = splitPath(path2);
+  const root = result[0];
+  let dir = result[1];
+  if (!root && !dir) {
+    return ".";
+  }
+  if (dir) {
+    dir = dir.slice(0, -1);
+  }
+  return root + dir;
+}
+function basename(path2, ext) {
+  let f = splitPath(path2)[2];
+  if (ext && f.slice(-ext.length) === ext) {
+    f = f.slice(0, -ext.length);
+  }
+  return f;
+}
+function extname(path2) {
+  return splitPath(path2)[3];
+}
+const path = {
+  extname,
+  basename,
+  dirname,
+  sep,
+  delimiter,
+  relative,
+  join,
+  isAbsolute,
+  normalize,
+  resolve
+};
+export {
+  basename,
+  delimiter,
+  dirname,
+  extname,
+  isAbsolute,
+  join,
+  normalize,
+  path,
+  relative,
+  resolve,
+  sep
+};
+//# sourceMappingURL=path.js.map

package/dist/node/path.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/node/path.ts"],
+  "sourcesContent": ["// Copyright Joyent, Inc. and other Node contributors.\n//\n// Permission is hereby granted, free of charge, to any person obtaining a\n// copy of this software and associated documentation files (the\n// \"Software\"), to deal in the Software without restriction, including\n// without limitation the rights to use, copy, modify, merge, publish,\n// distribute, sublicense, and/or sell copies of the Software, and to permit\n// persons to whom the Software is furnished to do so, subject to the\n// following conditions:\n//\n// The above copyright notice and this permission notice shall be included\n// in all copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS\n// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\n// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN\n// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,\n// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR\n// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE\n// USE OR OTHER DEALINGS IN THE SOFTWARE.\n\n// resolves . and .. elements in a path array with directory names there\n// must be no slashes, empty elements, or device names (c:\\) in the array\n// (so also no leading and trailing slashes - it does not distinguish\n// relative and absolute paths)\n\n// !! WARNING !!\n// The original implementation included ponyfills for `filters` and `substr`.\n// These have been removed in favor of native implementations supported by the current platforms.\n// See: https://github.com/scalar/scalar/pull/7235#discussion_r2484230212\n\nfunction normalizeArray(parts: Array<string>, allowAboveRoot: boolean): Array<string> {\n  // if the path tries to go above the root, `up` ends up > 0\n  let up = 0\n  for (let i = parts.length - 1; i >= 0; i--) {\n    const last = parts[i]\n    if (last === '.') {\n      parts.splice(i, 1)\n    } else if (last === '..') {\n      parts.splice(i, 1)\n      up++\n    } else if (up) {\n      parts.splice(i, 1)\n      up--\n    }\n  }\n\n  // if the path is allowed to go above the root, restore leading ..s\n  if (allowAboveRoot) {\n    for (; up--; up) {\n      parts.unshift('..')\n    }\n  }\n\n  return parts\n}\n\n// Split a filename into [root, dir, basename, ext], unix version\n// 'root' is just a slash, or nothing.\nconst splitPathRe = /^(\\/?|)([\\s\\S]*?)((?:\\.{1,2}|[^/]+?|)(\\.[^./]*|))(?:[/]*)$/\nconst splitPath = (filename: string): Array<string> | undefined => splitPathRe.exec(filename)!.slice(1)\n\n// path.resolve([from ...], to)\n// posix version\nexport function resolve(...parameters: Array<string>) {\n  let resolvedPath = '',\n    resolvedAbsolute = false\n\n  for (let i = parameters.length - 1; i >= -1 && !resolvedAbsolute; i--) {\n    const path = i >= 0 ? parameters[i] : '/'\n\n    // Skip empty and invalid entries\n    if (typeof path !== 'string') {\n      throw new TypeError('Arguments to path.resolve must be strings')\n    }\n    if (!path) {\n      continue\n    }\n\n    resolvedPath = path + '/' + resolvedPath\n    resolvedAbsolute = path.charAt(0) === '/'\n  }\n\n  // At this point the path should be resolved to a full absolute path, but\n  // handle relative paths to be safe (might happen when process.cwd() fails)\n\n  // Normalize the path\n  resolvedPath = normalizeArray(\n    resolvedPath.split('/').filter((p) => !!p),\n    !resolvedAbsolute,\n  ).join('/')\n\n  return (resolvedAbsolute ? '/' : '') + resolvedPath || '.'\n}\n\n// path.normalize(path)\n// posix version\nexport function normalize(inputPath: string): string {\n  const isPathAbsolute = isAbsolute(inputPath),\n    trailingSlash = inputPath.slice(-1) === '/'\n\n  // Normalize the path\n  let path = normalizeArray(\n    inputPath.split('/').filter((p) => !!p),\n    !isPathAbsolute,\n  ).join('/')\n\n  if (!path && !isPathAbsolute) {\n    path = '.'\n  }\n  if (path && trailingSlash) {\n    path += '/'\n  }\n\n  return (isPathAbsolute ? '/' : '') + path\n}\n\n// posix version\nexport function isAbsolute(path: string): boolean {\n  return path.charAt(0) === '/'\n}\n\n// posix version\nexport function join(...paths: string[]) {\n  return normalize(\n    paths\n      .filter((p) => {\n        if (typeof p !== 'string') {\n          throw new TypeError('Arguments to path.join must be strings')\n        }\n        return p\n      })\n      .join('/'),\n  )\n}\n\n// path.relative(from, to)\n// posix version\nexport function relative(from: string, to: string) {\n  const fromResolved = resolve(from).substring(1)\n  const toResolved = resolve(to).substring(1)\n\n  function trim(arr: Array<string>): Array<string> {\n    let start = 0\n    for (; start < arr.length; start++) {\n      if (arr[start] !== '') {\n        break\n      }\n    }\n\n    let end = arr.length - 1\n    for (; end >= 0; end--) {\n      if (arr[end] !== '') {\n        break\n      }\n    }\n\n    if (start > end) {\n      return []\n    }\n    return arr.slice(start, end - start + 1)\n  }\n\n  const fromParts = trim(fromResolved.split('/'))\n  const toParts = trim(toResolved.split('/'))\n\n  const length = Math.min(fromParts.length, toParts.length)\n  let samePartsLength = length\n  for (let i = 0; i < length; i++) {\n    if (fromParts[i] !== toParts[i]) {\n      samePartsLength = i\n      break\n    }\n  }\n\n  let outputParts = []\n  for (let i = samePartsLength; i < fromParts.length; i++) {\n    outputParts.push('..')\n  }\n\n  outputParts = outputParts.concat(toParts.slice(samePartsLength))\n\n  return outputParts.join('/')\n}\n\nexport const sep = '/'\nexport const delimiter = ':'\n\nexport function dirname(path: string): string {\n  const result = splitPath(path) as Array<string>\n  const root = result[0]\n  let dir = result[1]\n\n  if (!root && !dir) {\n    // No dirname whatsoever\n    return '.'\n  }\n\n  if (dir) {\n    // It has a dirname, strip trailing slash\n    dir = dir.slice(0, -1)\n  }\n\n  return (root as string) + dir\n}\n\nexport function basename(path: string, ext?: string): string {\n  let f = splitPath(path)![2] as string\n  // TODO: make this comparison case-insensitive on windows?\n  if (ext && f.slice(-ext.length) === ext) {\n    f = f.slice(0, -ext.length)\n  }\n  return f\n}\n\nexport function extname(path: string): string {\n  return splitPath(path)![3] as string\n}\n\nexport const path = {\n  extname,\n  basename,\n  dirname,\n  sep,\n  delimiter,\n  relative,\n  join,\n  isAbsolute,\n  normalize,\n  resolve,\n}\n"],
+  "mappings": "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",
+  "names": ["path"]
+}

package/dist/regex/find-variables.d.ts

@@ -1,5 +1,12 @@
 /**
  * Find all strings wrapped in {} or {{}} in value.
+ *
+ * @param value - The string to find variables in
+ * @param includePath - Whether to include path variables {single}
+ * @param includeEnv - Whether to include environment variables {{double}}
  */
-export declare const findVariables: (value: string) => (string | undefined)[];
+export declare const findVariables: (value: string, { includePath, includeEnv }?: {
+    includePath?: boolean;
+    includeEnv?: boolean;
+}) => string[];
 //# sourceMappingURL=find-variables.d.ts.map

package/dist/regex/find-variables.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-variables.d.ts","sourceRoot":"","sources":["../../src/regex/find-variables.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,2BACiE,CAAA"}
+{"version":3,"file":"find-variables.d.ts","sourceRoot":"","sources":["../../src/regex/find-variables.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GACxB,OAAO,MAAM,EACb,8BAA2C;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,KAC9F,MAAM,EAON,CAAA"}

package/dist/regex/find-variables.js

@@ -1,5 +1,7 @@
 import { REGEX } from "./regex-helpers.js";
-const findVariables = (value) => [...value.matchAll(REGEX.PATH), ...value.matchAll(REGEX.VARIABLES)].map((match) => match[1]?.trim()) || [];
+const findVariables = (value, { includePath = true, includeEnv = true } = {}) => [includePath && REGEX.PATH, includeEnv && REGEX.VARIABLES].flatMap(
+  (regex) => regex ? [...value.matchAll(regex)].map((match) => match[1]?.trim()).filter((variable) => variable !== void 0) : []
+);
 export {
   findVariables
 };

package/dist/regex/find-variables.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/regex/find-variables.ts"],
-  "sourcesContent": ["import { REGEX } from './regex-helpers'\n\n/**\n * Find all strings wrapped in {} or {{}} in value.\n */\nexport const findVariables = (value: string) =>\n  [...value.matchAll(REGEX.PATH), ...value.matchAll(REGEX.VARIABLES)].map((match) => match[1]?.trim()) || []\n"],
-  "mappings": "AAAA,SAAS,aAAa;AAKf,MAAM,gBAAgB,CAAC,UAC5B,CAAC,GAAG,MAAM,SAAS,MAAM,IAAI,GAAG,GAAG,MAAM,SAAS,MAAM,SAAS,CAAC,EAAE,IAAI,CAAC,UAAU,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;",
+  "sourcesContent": ["import { REGEX } from './regex-helpers'\n\n/**\n * Find all strings wrapped in {} or {{}} in value.\n *\n * @param value - The string to find variables in\n * @param includePath - Whether to include path variables {single}\n * @param includeEnv - Whether to include environment variables {{double}}\n */\nexport const findVariables = (\n  value: string,\n  { includePath = true, includeEnv = true }: { includePath?: boolean; includeEnv?: boolean } = {},\n): string[] =>\n  [includePath && REGEX.PATH, includeEnv && REGEX.VARIABLES].flatMap((regex) =>\n    regex\n      ? [...value.matchAll(regex)]\n          .map((match) => match[1]?.trim())\n          .filter((variable): variable is string => variable !== undefined)\n      : [],\n  )\n"],
+  "mappings": "AAAA,SAAS,aAAa;AASf,MAAM,gBAAgB,CAC3B,OACA,EAAE,cAAc,MAAM,aAAa,KAAK,IAAqD,CAAC,MAE9F,CAAC,eAAe,MAAM,MAAM,cAAc,MAAM,SAAS,EAAE;AAAA,EAAQ,CAAC,UAClE,QACI,CAAC,GAAG,MAAM,SAAS,KAAK,CAAC,EACtB,IAAI,CAAC,UAAU,MAAM,CAAC,GAAG,KAAK,CAAC,EAC/B,OAAO,CAAC,aAAiC,aAAa,MAAS,IAClE,CAAC;AACP;",
   "names": []
 }

package/dist/regex/regex-helpers.d.ts

@@ -1,12 +1,19 @@
+/**
+ * Collection of regular expressions used throughout the application.
+ * These patterns handle URL parsing, variable detection, and reference path extraction.
+ */
 export declare const REGEX: {
     /** Checks for a valid scheme */
     readonly PROTOCOL: RegExp;
     /** Finds multiple slashes after the scheme to replace with a single slash */
     readonly MULTIPLE_SLASHES: RegExp;
+    /** Finds all variables wrapped in {{double}} */
     readonly VARIABLES: RegExp;
+    /** Finds all variables wrapped in {single} */
     readonly PATH: RegExp;
     /** Finds the name of the schema from the ref path */
     readonly REF_NAME: RegExp;
+    /** Finds template variables in multiple formats: {{var}}, {var}, or :var */
     readonly TEMPLATE_VARIABLE: RegExp;
 };
 //# sourceMappingURL=regex-helpers.d.ts.map

package/dist/regex/regex-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"regex-helpers.d.ts","sourceRoot":"","sources":["../../src/regex/regex-helpers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK;IAChB,gCAAgC;;IAEhC,6EAA6E;;;;IAI7E,qDAAqD;;;CAG7C,CAAA"}
+{"version":3,"file":"regex-helpers.d.ts","sourceRoot":"","sources":["../../src/regex/regex-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,KAAK;IAChB,gCAAgC;;IAEhC,6EAA6E;;IAE7E,gDAAgD;;IAEhD,8CAA8C;;IAE9C,qDAAqD;;IAErD,4EAA4E;;CAEpE,CAAA"}

package/dist/regex/regex-helpers.js

@@ -3,10 +3,13 @@ const REGEX = {
   PROTOCOL: /^(?:https?|ftp|file|mailto|tel|data|wss?)*:\/\//,
   /** Finds multiple slashes after the scheme to replace with a single slash */
   MULTIPLE_SLASHES: /(?<!:)\/{2,}/g,
+  /** Finds all variables wrapped in {{double}} */
   VARIABLES: /{{((?:[^{}]|{[^{}]*})*)}}/g,
+  /** Finds all variables wrapped in {single} */
   PATH: /(?:{)([^{}]+)}(?!})/g,
   /** Finds the name of the schema from the ref path */
   REF_NAME: /\/([^\/]+)$/,
+  /** Finds template variables in multiple formats: {{var}}, {var}, or :var */
   TEMPLATE_VARIABLE: /{{\s*([^}\s]+?)\s*}}|{\s*([^}\s]+?)\s*}|:\b[\w.]+\b/g
 };
 export {

package/dist/regex/regex-helpers.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/regex/regex-helpers.ts"],
-  "sourcesContent": ["export const REGEX = {\n  /** Checks for a valid scheme */\n  PROTOCOL: /^(?:https?|ftp|file|mailto|tel|data|wss?)*:\\/\\//,\n  /** Finds multiple slashes after the scheme to replace with a single slash */\n  MULTIPLE_SLASHES: /(?<!:)\\/{2,}/g,\n  VARIABLES: /{{((?:[^{}]|{[^{}]*})*)}}/g,\n  PATH: /(?:{)([^{}]+)}(?!})/g,\n  /** Finds the name of the schema from the ref path */\n  REF_NAME: /\\/([^\\/]+)$/,\n  TEMPLATE_VARIABLE: /{{\\s*([^}\\s]+?)\\s*}}|{\\s*([^}\\s]+?)\\s*}|:\\b[\\w.]+\\b/g,\n} as const\n"],
-  "mappings": "AAAO,MAAM,QAAQ;AAAA;AAAA,EAEnB,UAAU;AAAA;AAAA,EAEV,kBAAkB;AAAA,EAClB,WAAW;AAAA,EACX,MAAM;AAAA;AAAA,EAEN,UAAU;AAAA,EACV,mBAAmB;AACrB;",
+  "sourcesContent": ["/**\n * Collection of regular expressions used throughout the application.\n * These patterns handle URL parsing, variable detection, and reference path extraction.\n */\nexport const REGEX = {\n  /** Checks for a valid scheme */\n  PROTOCOL: /^(?:https?|ftp|file|mailto|tel|data|wss?)*:\\/\\//,\n  /** Finds multiple slashes after the scheme to replace with a single slash */\n  MULTIPLE_SLASHES: /(?<!:)\\/{2,}/g,\n  /** Finds all variables wrapped in {{double}} */\n  VARIABLES: /{{((?:[^{}]|{[^{}]*})*)}}/g,\n  /** Finds all variables wrapped in {single} */\n  PATH: /(?:{)([^{}]+)}(?!})/g,\n  /** Finds the name of the schema from the ref path */\n  REF_NAME: /\\/([^\\/]+)$/,\n  /** Finds template variables in multiple formats: {{var}}, {var}, or :var */\n  TEMPLATE_VARIABLE: /{{\\s*([^}\\s]+?)\\s*}}|{\\s*([^}\\s]+?)\\s*}|:\\b[\\w.]+\\b/g,\n} as const\n"],
+  "mappings": "AAIO,MAAM,QAAQ;AAAA;AAAA,EAEnB,UAAU;AAAA;AAAA,EAEV,kBAAkB;AAAA;AAAA,EAElB,WAAW;AAAA;AAAA,EAEX,MAAM;AAAA;AAAA,EAEN,UAAU;AAAA;AAAA,EAEV,mBAAmB;AACrB;",
   "names": []
 }

package/dist/string/add-word-breaks.d.ts

@@ -0,0 +1,32 @@
+/**
+ * A list of preset styles for word breaks
+ */
+declare const PRESETS: {
+    /** Breaks on `/` and `-` for urls or file paths */
+    readonly path: RegExp;
+    /**
+     * Breaks on capitals, `_` and `.` for properties written in
+     * camel, pascal or snake case
+     */
+    readonly property: RegExp;
+};
+/** Word break options */
+type WordBreakOptions = {
+    /**
+     * Presets for word wrapping
+     */
+    preset?: keyof typeof PRESETS;
+    /**
+     * Explicit regex to allow wrapping on, overrides any `preset`
+     */
+    regex?: RegExp;
+};
+/**
+ * String utility to add word break opportunities
+ *
+ * Adds a zero-width space before certain characters to allow improved
+ * line wrapping in the. Allows wrapping on "/" and * "-" by default.
+ */
+export declare const addWordBreaks: (label: string, opts?: WordBreakOptions) => string;
+export {};
+//# sourceMappingURL=add-word-breaks.d.ts.map

package/dist/string/add-word-breaks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-word-breaks.d.ts","sourceRoot":"","sources":["../../src/string/add-word-breaks.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,QAAA,MAAM,OAAO;IACX,mDAAmD;;IAEnD;;;OAGG;;CAEsC,CAAA;AAE3C,yBAAyB;AACzB,KAAK,gBAAgB,GAAG;IACtB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,OAAO,OAAO,CAAA;IAC7B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,OAAM,gBAAqB,KAAG,MAI1E,CAAA"}

package/dist/string/add-word-breaks.js

@@ -0,0 +1,19 @@
+const ZWSP = "\u200B";
+const PRESETS = {
+  /** Breaks on `/` and `-` for urls or file paths */
+  "path": /[\/-]/,
+  /**
+   * Breaks on capitals, `_` and `.` for properties written in
+   * camel, pascal or snake case
+   */
+  "property": /[A-Z\_\.-]/
+};
+const addWordBreaks = (label, opts = {}) => {
+  const { preset = "path", regex } = opts;
+  const wrapRegex = new RegExp(regex ?? PRESETS[preset], "g");
+  return label.replace(wrapRegex, `${ZWSP}$&`);
+};
+export {
+  addWordBreaks
+};
+//# sourceMappingURL=add-word-breaks.js.map

package/dist/string/add-word-breaks.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/string/add-word-breaks.ts"],
+  "sourcesContent": ["/**\n * Unicode character for zero-width space\n *\n * @see https://en.wikipedia.org/wiki/Zero-width_space\n */\nconst ZWSP = '\\u200B'\n\n/**\n * A list of preset styles for word breaks\n */\nconst PRESETS = {\n  /** Breaks on `/` and `-` for urls or file paths */\n  'path': /[\\/-]/,\n  /**\n   * Breaks on capitals, `_` and `.` for properties written in\n   * camel, pascal or snake case\n   */\n  'property': /[A-Z\\_\\.-]/,\n} as const satisfies Record<string, RegExp>\n\n/** Word break options */\ntype WordBreakOptions = {\n  /**\n   * Presets for word wrapping\n   */\n  preset?: keyof typeof PRESETS\n  /**\n   * Explicit regex to allow wrapping on, overrides any `preset`\n   */\n  regex?: RegExp\n}\n\n/**\n * String utility to add word break opportunities\n *\n * Adds a zero-width space before certain characters to allow improved\n * line wrapping in the. Allows wrapping on \"/\" and * \"-\" by default.\n */\nexport const addWordBreaks = (label: string, opts: WordBreakOptions = {}): string => {\n  const { preset = 'path', regex } = opts\n  const wrapRegex = new RegExp(regex ?? PRESETS[preset], 'g')\n  return label.replace(wrapRegex, `${ZWSP}$&`)\n}\n"],
+  "mappings": "AAKA,MAAM,OAAO;AAKb,MAAM,UAAU;AAAA;AAAA,EAEd,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA,EAKR,YAAY;AACd;AAoBO,MAAM,gBAAgB,CAAC,OAAe,OAAyB,CAAC,MAAc;AACnF,QAAM,EAAE,SAAS,QAAQ,MAAM,IAAI;AACnC,QAAM,YAAY,IAAI,OAAO,SAAS,QAAQ,MAAM,GAAG,GAAG;AAC1D,SAAO,MAAM,QAAQ,WAAW,GAAG,IAAI,IAAI;AAC7C;",
+  "names": []
+}

package/dist/string/create-hash.d.ts

@@ -1,6 +1,8 @@
 /**
  * Simple 32 bit non-secure hash from a string input
  *
+ * @deprecated Use generateHash from @scalar/json-magic/helpers/generate-hash instead
+ *
  * @see https://stackoverflow.com/a/7616484/1624255
  */
 export declare const createHash: (input?: string) => number;

package/dist/string/create-hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-hash.d.ts","sourceRoot":"","sources":["../../src/string/create-hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,KAAG,MAe3C,CAAA"}
+{"version":3,"file":"create-hash.d.ts","sourceRoot":"","sources":["../../src/string/create-hash.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,KAAG,MAe3C,CAAA"}

package/dist/string/create-hash.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/string/create-hash.ts"],
-  "sourcesContent": ["/**\n * Simple 32 bit non-secure hash from a string input\n *\n * @see https://stackoverflow.com/a/7616484/1624255\n */\nexport const createHash = (input?: string): number => {\n  let chr = 0\n  let hash = 0\n  let i = 0\n\n  if (!input?.length) {\n    return hash\n  }\n\n  for (i = 0; i < input.length; i++) {\n    chr = input.charCodeAt(i)\n    hash = (hash << 5) - hash + chr\n    hash |= 0 // Convert to 32bit integer\n  }\n  return hash\n}\n"],
-  "mappings": "AAKO,MAAM,aAAa,CAAC,UAA2B;AACpD,MAAI,MAAM;AACV,MAAI,OAAO;AACX,MAAI,IAAI;AAER,MAAI,CAAC,OAAO,QAAQ;AAClB,WAAO;AAAA,EACT;AAEA,OAAK,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACjC,UAAM,MAAM,WAAW,CAAC;AACxB,YAAQ,QAAQ,KAAK,OAAO;AAC5B,YAAQ;AAAA,EACV;AACA,SAAO;AACT;",
+  "sourcesContent": ["/**\n * Simple 32 bit non-secure hash from a string input\n *\n * @deprecated Use generateHash from @scalar/json-magic/helpers/generate-hash instead\n *\n * @see https://stackoverflow.com/a/7616484/1624255\n */\nexport const createHash = (input?: string): number => {\n  let chr = 0\n  let hash = 0\n  let i = 0\n\n  if (!input?.length) {\n    return hash\n  }\n\n  for (i = 0; i < input.length; i++) {\n    chr = input.charCodeAt(i)\n    hash = (hash << 5) - hash + chr\n    hash |= 0 // Convert to 32bit integer\n  }\n  return hash\n}\n"],
+  "mappings": "AAOO,MAAM,aAAa,CAAC,UAA2B;AACpD,MAAI,MAAM;AACV,MAAI,OAAO;AACX,MAAI,IAAI;AAER,MAAI,CAAC,OAAO,QAAQ;AAClB,WAAO;AAAA,EACT;AAEA,OAAK,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACjC,UAAM,MAAM,WAAW,CAAC;AACxB,YAAQ,QAAQ,KAAK,OAAO;AAC5B,YAAQ;AAAA,EACV;AACA,SAAO;AACT;",
   "names": []
 }

package/dist/string/truncate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Truncates a string to a specified length and adds an ellipsis if it's longer in JS
+ *
+ * @param str - The string to truncate
+ * @param maxLength - The maximum length before truncation (default: 18)
+ * @returns The truncated string with ellipsis if needed
+ *
+ * @example
+ * truncate('Very long name that needs truncation') // 'Very long name th…'
+ * truncate('Short') // 'Short'
+ */
+export declare const truncate: (str: string, maxLength?: number) => string;
+//# sourceMappingURL=truncate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../src/string/truncate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,EAAE,kBAAc,KAAG,MAKtD,CAAA"}

package/dist/string/truncate.js

@@ -0,0 +1,10 @@
+const truncate = (str, maxLength = 18) => {
+  if (str.length <= maxLength) {
+    return str;
+  }
+  return str.slice(0, maxLength) + "\u2026";
+};
+export {
+  truncate
+};
+//# sourceMappingURL=truncate.js.map

package/dist/string/truncate.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/string/truncate.ts"],
+  "sourcesContent": ["/**\n * Truncates a string to a specified length and adds an ellipsis if it's longer in JS\n *\n * @param str - The string to truncate\n * @param maxLength - The maximum length before truncation (default: 18)\n * @returns The truncated string with ellipsis if needed\n *\n * @example\n * truncate('Very long name that needs truncation') // 'Very long name th\u2026'\n * truncate('Short') // 'Short'\n */\nexport const truncate = (str: string, maxLength = 18): string => {\n  if (str.length <= maxLength) {\n    return str\n  }\n  return str.slice(0, maxLength) + '\u2026'\n}\n"],
+  "mappings": "AAWO,MAAM,WAAW,CAAC,KAAa,YAAY,OAAe;AAC/D,MAAI,IAAI,UAAU,WAAW;AAC3B,WAAO;AAAA,EACT;AACA,SAAO,IAAI,MAAM,GAAG,SAAS,IAAI;AACnC;",
+  "names": []
+}

package/package.json

@@ -14,7 +14,7 @@
     "helpers",
     "js"
   ],
-  "version": "0.0.13",
+  "version": "0.1.1",
   "engines": {
     "node": ">=20"
   },
@@ -46,6 +46,11 @@
       "types": "./dist/http/*.d.ts",
       "default": "./dist/http/*.js"
     },
+    "./node/*": {
+      "import": "./dist/node/*.js",
+      "types": "./dist/node/*.d.ts",
+      "default": "./dist/node/*.js"
+    },
     "./object/*": {
       "import": "./dist/object/*.js",
       "types": "./dist/object/*.d.ts",

package/dist/crypto/generate-hash.d.ts

@@ -1,15 +0,0 @@
-/**
- * Generates a SHA-256 hexadecimal hash for the provided string input.
- *
- * This function uses the Web Crypto API, returning a lowercase hex string.
- * The resulting hash is deterministic for the same input.
- *
- * @param input - The input string to hash.
- * @returns A Promise that resolves to a hexadecimal string representing the SHA-256 hash.
- *
- * @example
- * const hash = await generateHash('hello world')
- * console.log(hash) // => 'b94d27b9934d3e08a52e52d7da7dabfadeb...'
- */
-export declare const generateHash: (input: string) => Promise<string>;
-//# sourceMappingURL=generate-hash.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"generate-hash.d.ts","sourceRoot":"","sources":["../../src/crypto/generate-hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,GAAU,OAAO,MAAM,KAAG,OAAO,CAAC,MAAM,CAUhE,CAAA"}

package/dist/crypto/generate-hash.js

@@ -1,10 +0,0 @@
-const generateHash = async (input) => {
-  const hashBuffer = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(input));
-  const hashArray = Array.from(new Uint8Array(hashBuffer));
-  const hashHex = hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
-  return hashHex;
-};
-export {
-  generateHash
-};
-//# sourceMappingURL=generate-hash.js.map

package/dist/crypto/generate-hash.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/crypto/generate-hash.ts"],
-  "sourcesContent": ["/**\n * Generates a SHA-256 hexadecimal hash for the provided string input.\n *\n * This function uses the Web Crypto API, returning a lowercase hex string.\n * The resulting hash is deterministic for the same input.\n *\n * @param input - The input string to hash.\n * @returns A Promise that resolves to a hexadecimal string representing the SHA-256 hash.\n *\n * @example\n * const hash = await generateHash('hello world')\n * console.log(hash) // => 'b94d27b9934d3e08a52e52d7da7dabfadeb...'\n */\nexport const generateHash = async (input: string): Promise<string> => {\n  const hashBuffer = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(input))\n\n  // Convert the ArrayBuffer to a Uint8Array\n  const hashArray = Array.from(new Uint8Array(hashBuffer))\n\n  // Convert each byte to its hexadecimal representation and join them\n  const hashHex = hashArray.map((b) => b.toString(16).padStart(2, '0')).join('')\n\n  return hashHex\n}\n"],
-  "mappings": "AAaO,MAAM,eAAe,OAAO,UAAmC;AACpE,QAAM,aAAa,MAAM,OAAO,OAAO,OAAO,WAAW,IAAI,YAAY,EAAE,OAAO,KAAK,CAAC;AAGxF,QAAM,YAAY,MAAM,KAAK,IAAI,WAAW,UAAU,CAAC;AAGvD,QAAM,UAAU,UAAU,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EAAE,KAAK,EAAE;AAE7E,SAAO;AACT;",
-  "names": []
-}