@vizhub/viz-utils 1.3.0 → 1.4.0

package/README.md

@@ -36,6 +36,16 @@ import { generateVizFileId } from "@vizhub/viz-utils";
 const newFileId = generateVizFileId(); // e.g. "550e8400"
 ```
 
+#### `generateRunId(): string`
+
+Generates a unique RunId (an 8-character hexadecimal string) for a run within a visualization, for use as the `vizContent.runId` property.
+
+```typescript
+import { generateRunId } from "@vizhub/viz-utils";
+
+const newRunId = generateRunId(); // e.g. "550e8400"
+```
+
 ### Validation
 
 #### `isVizId(str: string): boolean`

package/dist/generateRunId.d.ts

@@ -0,0 +1,2 @@
+export declare const generateRunId: () => import("@vizhub/viz-types").VizFileId;
+//# sourceMappingURL=generateRunId.d.ts.map

package/dist/generateRunId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateRunId.d.ts","sourceRoot":"","sources":["../src/generateRunId.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,aAAa,6CAAoB,CAAC"}

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=e=>e.length!==32||!/^[0-9a-f]{32}$/i.test(e)?!1:e[12]==="4",s=()=>typeof globalThis.crypto<"u"?globalThis.crypto:require("node:crypto").webcrypto,a=s(),r=()=>{const e=new Uint8Array(16);return a.getRandomValues(e),e[6]=e[6]&15|64,e[8]=e[8]&63|128,Array.from(e,t=>t.toString(16).padStart(2,"0")).join("")},n=()=>r().substring(0,8),f=(e,t)=>{if(e&&e.files)for(const i of Object.keys(e.files)){const o=e.files[i];if(o.name===t)return o.text}return null},u=e=>{const t={};if(!e)return t;for(const i of Object.values(e))t[i.name]=i.text;return t},c=e=>Object.entries(e).reduce((t,[i,o])=>(t[n()]={name:i,text:o},t),{}),d=e=>Math.floor(e.getTime()/1e3),g=e=>new Date(e*1e3);exports.dateToTimestamp=d;exports.fileCollectionToVizFiles=c;exports.generateVizFileId=n;exports.generateVizId=r;exports.getFileText=f;exports.isVizId=l;exports.timestampToDate=g;exports.vizFilesToFileCollection=u;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=e=>e.length!==32||!/^[0-9a-f]{32}$/i.test(e)?!1:e[12]==="4",s=()=>typeof globalThis.crypto<"u"?globalThis.crypto:require("node:crypto").webcrypto,a=s(),n=()=>{const e=new Uint8Array(16);return a.getRandomValues(e),e[6]=e[6]&15|64,e[8]=e[8]&63|128,Array.from(e,t=>t.toString(16).padStart(2,"0")).join("")},r=()=>n().substring(0,8),u=r,c=(e,t)=>{if(e&&e.files)for(const i of Object.keys(e.files)){const o=e.files[i];if(o.name===t)return o.text}return null},f=e=>{const t={};if(!e)return t;for(const i of Object.values(e))t[i.name]=i.text;return t},d=e=>Object.entries(e).reduce((t,[i,o])=>(t[r()]={name:i,text:o},t),{}),g=e=>Math.floor(e.getTime()/1e3),T=e=>new Date(e*1e3);exports.dateToTimestamp=g;exports.fileCollectionToVizFiles=d;exports.generateRunId=u;exports.generateVizFileId=r;exports.generateVizId=n;exports.getFileText=c;exports.isVizId=l;exports.timestampToDate=T;exports.vizFilesToFileCollection=f;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/isVizId.ts","../src/generateVizId.ts","../src/generateVizFileId.ts","../src/getFileText.ts","../src/vizFilesToFileCollection.ts","../src/fileCollectionToVizFiles.ts","../src/dateToTimestamp.ts","../src/timestampToDate.ts"],"sourcesContent":["import type { VizId } from \"@vizhub/viz-types\";\n\n// Checks if a string was generated by `generateId` from interactors.\nexport const isVizId = (str: string): boolean => {\n  // First check if the length is exactly 32 characters\n  if (str.length !== 32) {\n    return false;\n  }\n\n  // Regular expression for a 32-character hexadecimal string\n  let uuidV4NoDashRegex = /^[0-9a-f]{32}$/i;\n\n  // Check if the string matches the regular expression\n  if (!uuidV4NoDashRegex.test(str)) {\n    return false;\n  }\n\n  // Check if the 13th character is '4' (indicating UUID v4)\n  // and the 17th character is one of '8', '9', 'a', 'b' (indicating the variant)\n  return (\n    str[12] === \"4\"\n    // &&\n    // ['8', '9', 'a', 'b'].includes(str[16].toLowerCase())\n  );\n};\n","import type { VizId } from \"@vizhub/viz-types\";\n\n// Resolve a Web‑Crypto‑compatible `crypto` object.\n// • Browsers & Node 19 +   → globalThis.crypto\n// • Anything else (rare)   → use node:crypto's webcrypto\nconst getCryptoObj = (): Crypto => {\n  if (typeof globalThis.crypto !== \"undefined\") {\n    return globalThis.crypto as Crypto;\n  }\n  // Use require instead of import to avoid top-level await\n  // This will only run in Node.js environments\n  return require(\"node:crypto\").webcrypto as Crypto;\n};\n\nconst cryptoObj = getCryptoObj();\n\n/**\n * Generates a dash‑free RFC 4122‑compliant UUID v4 (32 hex chars).\n * Works in all evergreen browsers and Node 19 + without extra deps.\n */\nexport const generateVizId = (): VizId => {\n  const bytes = new Uint8Array(16);\n  cryptoObj.getRandomValues(bytes);\n\n  // RFC 4122: set version (4) and variant (10xx)\n  bytes[6] = (bytes[6] & 0x0f) | 0x40;\n  bytes[8] = (bytes[8] & 0x3f) | 0x80;\n\n  return Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\")).join(\n    \"\",\n  ) as VizId;\n};\n","import type { VizFileId } from \"@vizhub/viz-types\";\nimport { generateVizId } from \"./generateVizId\";\n\n// Generates a file id\nexport const generateVizFileId = (): VizFileId =>\n  generateVizId().substring(0, 8);\n","import { VizContent } from \"@vizhub/viz-types\";\n\n// Gets the text content of a file with the given name.\n// Returns null if not found.\nexport const getFileText = (\n  content: VizContent,\n  fileName: string,\n): string | null => {\n  if (content && content.files) {\n    for (const fileId of Object.keys(content.files)) {\n      const file = content.files[fileId];\n      if (file.name === fileName) {\n        return file.text;\n      }\n    }\n  }\n  return null;\n};\n","import type { VizFiles, FileCollection } from \"@vizhub/viz-types\";\n\n/**\n * Converts VizContent to FileCollection format.\n */\nexport const vizFilesToFileCollection = (files?: VizFiles): FileCollection => {\n  const fileCollection: FileCollection = {};\n\n  // Return empty object if files is undefined\n  if (!files) {\n    return fileCollection;\n  }\n\n  // Convert each VizFile to the FileCollection format\n  for (const file of Object.values(files)) {\n    fileCollection[file.name] = file.text;\n  }\n\n  return fileCollection;\n};\n","import { FileCollection, VizFiles } from \"@vizhub/viz-types\";\nimport { generateVizFileId } from \"./generateVizFileId\";\n\nexport const fileCollectionToVizFiles = (files: FileCollection): VizFiles => {\n  return Object.entries(files).reduce((acc, [name, text]) => {\n    acc[generateVizFileId()] = { name, text };\n    return acc;\n  }, {} as VizFiles);\n};\n","import type { VizTimestamp } from \"@vizhub/viz-types\";\n\nexport const dateToTimestamp = (date: Date): VizTimestamp =>\n  Math.floor(date.getTime() / 1000);\n","import type { VizTimestamp } from \"@vizhub/viz-types\";\n\nexport const timestampToDate = (timestamp: VizTimestamp): Date =>\n  new Date(timestamp * 1000);\n"],"names":["isVizId","str","getCryptoObj","cryptoObj","generateVizId","bytes","b","generateVizFileId","getFileText","content","fileName","fileId","file","vizFilesToFileCollection","files","fileCollection","fileCollectionToVizFiles","acc","name","text","dateToTimestamp","date","timestampToDate","timestamp"],"mappings":"gFAGO,MAAMA,EAAWC,GAElBA,EAAI,SAAW,IAQf,CAHoB,kBAGD,KAAKA,CAAG,EACtB,GAMPA,EAAI,EAAE,IAAM,ICfVC,EAAe,IACf,OAAO,WAAW,OAAW,IACxB,WAAW,OAIb,QAAQ,aAAa,EAAE,UAG1BC,EAAYD,EAAA,EAMLE,EAAgB,IAAa,CACxC,MAAMC,EAAQ,IAAI,WAAW,EAAE,EAC/B,OAAAF,EAAU,gBAAgBE,CAAK,EAG/BA,EAAM,CAAC,EAAKA,EAAM,CAAC,EAAI,GAAQ,GAC/BA,EAAM,CAAC,EAAKA,EAAM,CAAC,EAAI,GAAQ,IAExB,MAAM,KAAKA,EAAQC,GAAMA,EAAE,SAAS,EAAE,EAAE,SAAS,EAAG,GAAG,CAAC,EAAE,KAC/D,EAAA,CAEJ,EC3BaC,EAAoB,IAC/BH,EAAA,EAAgB,UAAU,EAAG,CAAC,ECDnBI,EAAc,CACzBC,EACAC,IACkB,CAClB,GAAID,GAAWA,EAAQ,MACrB,UAAWE,KAAU,OAAO,KAAKF,EAAQ,KAAK,EAAG,CAC/C,MAAMG,EAAOH,EAAQ,MAAME,CAAM,EACjC,GAAIC,EAAK,OAASF,EAChB,OAAOE,EAAK,IAEhB,CAEF,OAAO,IACT,ECZaC,EAA4BC,GAAqC,CAC5E,MAAMC,EAAiC,CAAA,EAGvC,GAAI,CAACD,EACH,OAAOC,EAIT,UAAWH,KAAQ,OAAO,OAAOE,CAAK,EACpCC,EAAeH,EAAK,IAAI,EAAIA,EAAK,KAGnC,OAAOG,CACT,EChBaC,EAA4BF,GAChC,OAAO,QAAQA,CAAK,EAAE,OAAO,CAACG,EAAK,CAACC,EAAMC,CAAI,KACnDF,EAAIV,EAAA,CAAmB,EAAI,CAAE,KAAAW,EAAM,KAAAC,CAAA,EAC5BF,GACN,CAAA,CAAc,ECLNG,EAAmBC,GAC9B,KAAK,MAAMA,EAAK,QAAA,EAAY,GAAI,ECDrBC,EAAmBC,GAC9B,IAAI,KAAKA,EAAY,GAAI"}
+{"version":3,"file":"index.cjs","sources":["../src/isVizId.ts","../src/generateVizId.ts","../src/generateVizFileId.ts","../src/generateRunId.ts","../src/getFileText.ts","../src/vizFilesToFileCollection.ts","../src/fileCollectionToVizFiles.ts","../src/dateToTimestamp.ts","../src/timestampToDate.ts"],"sourcesContent":["import type { VizId } from \"@vizhub/viz-types\";\n\n// Checks if a string was generated by `generateId` from interactors.\nexport const isVizId = (str: string): boolean => {\n  // First check if the length is exactly 32 characters\n  if (str.length !== 32) {\n    return false;\n  }\n\n  // Regular expression for a 32-character hexadecimal string\n  let uuidV4NoDashRegex = /^[0-9a-f]{32}$/i;\n\n  // Check if the string matches the regular expression\n  if (!uuidV4NoDashRegex.test(str)) {\n    return false;\n  }\n\n  // Check if the 13th character is '4' (indicating UUID v4)\n  // and the 17th character is one of '8', '9', 'a', 'b' (indicating the variant)\n  return (\n    str[12] === \"4\"\n    // &&\n    // ['8', '9', 'a', 'b'].includes(str[16].toLowerCase())\n  );\n};\n","import type { VizId } from \"@vizhub/viz-types\";\n\n// Resolve a Web‑Crypto‑compatible `crypto` object.\n// • Browsers & Node 19 +   → globalThis.crypto\n// • Anything else (rare)   → use node:crypto's webcrypto\nconst getCryptoObj = (): Crypto => {\n  if (typeof globalThis.crypto !== \"undefined\") {\n    return globalThis.crypto as Crypto;\n  }\n  // Use require instead of import to avoid top-level await\n  // This will only run in Node.js environments\n  return require(\"node:crypto\").webcrypto as Crypto;\n};\n\nconst cryptoObj = getCryptoObj();\n\n/**\n * Generates a dash‑free RFC 4122‑compliant UUID v4 (32 hex chars).\n * Works in all evergreen browsers and Node 19 + without extra deps.\n */\nexport const generateVizId = (): VizId => {\n  const bytes = new Uint8Array(16);\n  cryptoObj.getRandomValues(bytes);\n\n  // RFC 4122: set version (4) and variant (10xx)\n  bytes[6] = (bytes[6] & 0x0f) | 0x40;\n  bytes[8] = (bytes[8] & 0x3f) | 0x80;\n\n  return Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\")).join(\n    \"\",\n  ) as VizId;\n};\n","import type { VizFileId } from \"@vizhub/viz-types\";\nimport { generateVizId } from \"./generateVizId\";\n\n// Generates a file id\nexport const generateVizFileId = (): VizFileId =>\n  generateVizId().substring(0, 8);\n","import { generateVizFileId } from \"./generateVizFileId\";\nexport const generateRunId = generateVizFileId;\n","import { VizContent } from \"@vizhub/viz-types\";\n\n// Gets the text content of a file with the given name.\n// Returns null if not found.\nexport const getFileText = (\n  content: VizContent,\n  fileName: string,\n): string | null => {\n  if (content && content.files) {\n    for (const fileId of Object.keys(content.files)) {\n      const file = content.files[fileId];\n      if (file.name === fileName) {\n        return file.text;\n      }\n    }\n  }\n  return null;\n};\n","import type { VizFiles, FileCollection } from \"@vizhub/viz-types\";\n\n/**\n * Converts VizContent to FileCollection format.\n */\nexport const vizFilesToFileCollection = (files?: VizFiles): FileCollection => {\n  const fileCollection: FileCollection = {};\n\n  // Return empty object if files is undefined\n  if (!files) {\n    return fileCollection;\n  }\n\n  // Convert each VizFile to the FileCollection format\n  for (const file of Object.values(files)) {\n    fileCollection[file.name] = file.text;\n  }\n\n  return fileCollection;\n};\n","import { FileCollection, VizFiles } from \"@vizhub/viz-types\";\nimport { generateVizFileId } from \"./generateVizFileId\";\n\nexport const fileCollectionToVizFiles = (files: FileCollection): VizFiles => {\n  return Object.entries(files).reduce((acc, [name, text]) => {\n    acc[generateVizFileId()] = { name, text };\n    return acc;\n  }, {} as VizFiles);\n};\n","import type { VizTimestamp } from \"@vizhub/viz-types\";\n\nexport const dateToTimestamp = (date: Date): VizTimestamp =>\n  Math.floor(date.getTime() / 1000);\n","import type { VizTimestamp } from \"@vizhub/viz-types\";\n\nexport const timestampToDate = (timestamp: VizTimestamp): Date =>\n  new Date(timestamp * 1000);\n"],"names":["isVizId","str","getCryptoObj","cryptoObj","generateVizId","bytes","b","generateVizFileId","generateRunId","getFileText","content","fileName","fileId","file","vizFilesToFileCollection","files","fileCollection","fileCollectionToVizFiles","acc","name","text","dateToTimestamp","date","timestampToDate","timestamp"],"mappings":"gFAGO,MAAMA,EAAWC,GAElBA,EAAI,SAAW,IAQf,CAHoB,kBAGD,KAAKA,CAAG,EACtB,GAMPA,EAAI,EAAE,IAAM,ICfVC,EAAe,IACf,OAAO,WAAW,OAAW,IACxB,WAAW,OAIb,QAAQ,aAAa,EAAE,UAG1BC,EAAYD,EAAA,EAMLE,EAAgB,IAAa,CACxC,MAAMC,EAAQ,IAAI,WAAW,EAAE,EAC/B,OAAAF,EAAU,gBAAgBE,CAAK,EAG/BA,EAAM,CAAC,EAAKA,EAAM,CAAC,EAAI,GAAQ,GAC/BA,EAAM,CAAC,EAAKA,EAAM,CAAC,EAAI,GAAQ,IAExB,MAAM,KAAKA,EAAQC,GAAMA,EAAE,SAAS,EAAE,EAAE,SAAS,EAAG,GAAG,CAAC,EAAE,KAC/D,EAAA,CAEJ,EC3BaC,EAAoB,IAC/BH,EAAA,EAAgB,UAAU,EAAG,CAAC,ECJnBI,EAAgBD,ECGhBE,EAAc,CACzBC,EACAC,IACkB,CAClB,GAAID,GAAWA,EAAQ,MACrB,UAAWE,KAAU,OAAO,KAAKF,EAAQ,KAAK,EAAG,CAC/C,MAAMG,EAAOH,EAAQ,MAAME,CAAM,EACjC,GAAIC,EAAK,OAASF,EAChB,OAAOE,EAAK,IAEhB,CAEF,OAAO,IACT,ECZaC,EAA4BC,GAAqC,CAC5E,MAAMC,EAAiC,CAAA,EAGvC,GAAI,CAACD,EACH,OAAOC,EAIT,UAAWH,KAAQ,OAAO,OAAOE,CAAK,EACpCC,EAAeH,EAAK,IAAI,EAAIA,EAAK,KAGnC,OAAOG,CACT,EChBaC,EAA4BF,GAChC,OAAO,QAAQA,CAAK,EAAE,OAAO,CAACG,EAAK,CAACC,EAAMC,CAAI,KACnDF,EAAIX,EAAA,CAAmB,EAAI,CAAE,KAAAY,EAAM,KAAAC,CAAA,EAC5BF,GACN,CAAA,CAAc,ECLNG,EAAmBC,GAC9B,KAAK,MAAMA,EAAK,QAAA,EAAY,GAAI,ECDrBC,EAAmBC,GAC9B,IAAI,KAAKA,EAAY,GAAI"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { isVizId } from "./isVizId";
 export { generateVizId } from "./generateVizId";
 export { generateVizFileId } from "./generateVizFileId";
+export { generateRunId } from "./generateRunId";
 export { getFileText } from "./getFileText";
 export { vizFilesToFileCollection } from "./vizFilesToFileCollection";
 export { fileCollectionToVizFiles } from "./fileCollectionToVizFiles";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,9 +1,9 @@
-const f = (e) => e.length !== 32 || !/^[0-9a-f]{32}$/i.test(e) ? !1 : e[12] === "4", i = () => typeof globalThis.crypto < "u" ? globalThis.crypto : require("node:crypto").webcrypto, n = i(), s = () => {
+const a = (e) => e.length !== 32 || !/^[0-9a-f]{32}$/i.test(e) ? !1 : e[12] === "4", i = () => typeof globalThis.crypto < "u" ? globalThis.crypto : require("node:crypto").webcrypto, s = i(), l = () => {
   const e = new Uint8Array(16);
-  return n.getRandomValues(e), e[6] = e[6] & 15 | 64, e[8] = e[8] & 63 | 128, Array.from(e, (t) => t.toString(16).padStart(2, "0")).join(
+  return s.getRandomValues(e), e[6] = e[6] & 15 | 64, e[8] = e[8] & 63 | 128, Array.from(e, (t) => t.toString(16).padStart(2, "0")).join(
     ""
   );
-}, l = () => s().substring(0, 8), a = (e, t) => {
+}, n = () => l().substring(0, 8), f = n, u = (e, t) => {
   if (e && e.files)
     for (const r of Object.keys(e.files)) {
       const o = e.files[r];
@@ -11,22 +11,23 @@ const f = (e) => e.length !== 32 || !/^[0-9a-f]{32}$/i.test(e) ? !1 : e[12] ===
         return o.text;
     }
   return null;
-}, u = (e) => {
+}, c = (e) => {
   const t = {};
   if (!e)
     return t;
   for (const r of Object.values(e))
     t[r.name] = r.text;
   return t;
-}, c = (e) => Object.entries(e).reduce((t, [r, o]) => (t[l()] = { name: r, text: o }, t), {}), g = (e) => Math.floor(e.getTime() / 1e3), d = (e) => new Date(e * 1e3);
+}, g = (e) => Object.entries(e).reduce((t, [r, o]) => (t[n()] = { name: r, text: o }, t), {}), d = (e) => Math.floor(e.getTime() / 1e3), b = (e) => new Date(e * 1e3);
 export {
-  g as dateToTimestamp,
-  c as fileCollectionToVizFiles,
-  l as generateVizFileId,
-  s as generateVizId,
-  a as getFileText,
-  f as isVizId,
-  d as timestampToDate,
-  u as vizFilesToFileCollection
+  d as dateToTimestamp,
+  g as fileCollectionToVizFiles,
+  f as generateRunId,
+  n as generateVizFileId,
+  l as generateVizId,
+  u as getFileText,
+  a as isVizId,
+  b as timestampToDate,
+  c as vizFilesToFileCollection
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/isVizId.ts","../src/generateVizId.ts","../src/generateVizFileId.ts","../src/getFileText.ts","../src/vizFilesToFileCollection.ts","../src/fileCollectionToVizFiles.ts","../src/dateToTimestamp.ts","../src/timestampToDate.ts"],"sourcesContent":["import type { VizId } from \"@vizhub/viz-types\";\n\n// Checks if a string was generated by `generateId` from interactors.\nexport const isVizId = (str: string): boolean => {\n  // First check if the length is exactly 32 characters\n  if (str.length !== 32) {\n    return false;\n  }\n\n  // Regular expression for a 32-character hexadecimal string\n  let uuidV4NoDashRegex = /^[0-9a-f]{32}$/i;\n\n  // Check if the string matches the regular expression\n  if (!uuidV4NoDashRegex.test(str)) {\n    return false;\n  }\n\n  // Check if the 13th character is '4' (indicating UUID v4)\n  // and the 17th character is one of '8', '9', 'a', 'b' (indicating the variant)\n  return (\n    str[12] === \"4\"\n    // &&\n    // ['8', '9', 'a', 'b'].includes(str[16].toLowerCase())\n  );\n};\n","import type { VizId } from \"@vizhub/viz-types\";\n\n// Resolve a Web‑Crypto‑compatible `crypto` object.\n// • Browsers & Node 19 +   → globalThis.crypto\n// • Anything else (rare)   → use node:crypto's webcrypto\nconst getCryptoObj = (): Crypto => {\n  if (typeof globalThis.crypto !== \"undefined\") {\n    return globalThis.crypto as Crypto;\n  }\n  // Use require instead of import to avoid top-level await\n  // This will only run in Node.js environments\n  return require(\"node:crypto\").webcrypto as Crypto;\n};\n\nconst cryptoObj = getCryptoObj();\n\n/**\n * Generates a dash‑free RFC 4122‑compliant UUID v4 (32 hex chars).\n * Works in all evergreen browsers and Node 19 + without extra deps.\n */\nexport const generateVizId = (): VizId => {\n  const bytes = new Uint8Array(16);\n  cryptoObj.getRandomValues(bytes);\n\n  // RFC 4122: set version (4) and variant (10xx)\n  bytes[6] = (bytes[6] & 0x0f) | 0x40;\n  bytes[8] = (bytes[8] & 0x3f) | 0x80;\n\n  return Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\")).join(\n    \"\",\n  ) as VizId;\n};\n","import type { VizFileId } from \"@vizhub/viz-types\";\nimport { generateVizId } from \"./generateVizId\";\n\n// Generates a file id\nexport const generateVizFileId = (): VizFileId =>\n  generateVizId().substring(0, 8);\n","import { VizContent } from \"@vizhub/viz-types\";\n\n// Gets the text content of a file with the given name.\n// Returns null if not found.\nexport const getFileText = (\n  content: VizContent,\n  fileName: string,\n): string | null => {\n  if (content && content.files) {\n    for (const fileId of Object.keys(content.files)) {\n      const file = content.files[fileId];\n      if (file.name === fileName) {\n        return file.text;\n      }\n    }\n  }\n  return null;\n};\n","import type { VizFiles, FileCollection } from \"@vizhub/viz-types\";\n\n/**\n * Converts VizContent to FileCollection format.\n */\nexport const vizFilesToFileCollection = (files?: VizFiles): FileCollection => {\n  const fileCollection: FileCollection = {};\n\n  // Return empty object if files is undefined\n  if (!files) {\n    return fileCollection;\n  }\n\n  // Convert each VizFile to the FileCollection format\n  for (const file of Object.values(files)) {\n    fileCollection[file.name] = file.text;\n  }\n\n  return fileCollection;\n};\n","import { FileCollection, VizFiles } from \"@vizhub/viz-types\";\nimport { generateVizFileId } from \"./generateVizFileId\";\n\nexport const fileCollectionToVizFiles = (files: FileCollection): VizFiles => {\n  return Object.entries(files).reduce((acc, [name, text]) => {\n    acc[generateVizFileId()] = { name, text };\n    return acc;\n  }, {} as VizFiles);\n};\n","import type { VizTimestamp } from \"@vizhub/viz-types\";\n\nexport const dateToTimestamp = (date: Date): VizTimestamp =>\n  Math.floor(date.getTime() / 1000);\n","import type { VizTimestamp } from \"@vizhub/viz-types\";\n\nexport const timestampToDate = (timestamp: VizTimestamp): Date =>\n  new Date(timestamp * 1000);\n"],"names":["isVizId","str","getCryptoObj","cryptoObj","generateVizId","bytes","b","generateVizFileId","getFileText","content","fileName","fileId","file","vizFilesToFileCollection","files","fileCollection","fileCollectionToVizFiles","acc","name","text","dateToTimestamp","date","timestampToDate","timestamp"],"mappings":"AAGO,MAAMA,IAAU,CAACC,MAElBA,EAAI,WAAW,MAQf,CAHoB,kBAGD,KAAKA,CAAG,IACtB,KAMPA,EAAI,EAAE,MAAM,KCfVC,IAAe,MACf,OAAO,WAAW,SAAW,MACxB,WAAW,SAIb,QAAQ,aAAa,EAAE,WAG1BC,IAAYD,EAAA,GAMLE,IAAgB,MAAa;AACxC,QAAMC,IAAQ,IAAI,WAAW,EAAE;AAC/B,SAAAF,EAAU,gBAAgBE,CAAK,GAG/BA,EAAM,CAAC,IAAKA,EAAM,CAAC,IAAI,KAAQ,IAC/BA,EAAM,CAAC,IAAKA,EAAM,CAAC,IAAI,KAAQ,KAExB,MAAM,KAAKA,GAAO,CAACC,MAAMA,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EAAE;AAAA,IAC/D;AAAA,EAAA;AAEJ,GC3BaC,IAAoB,MAC/BH,EAAA,EAAgB,UAAU,GAAG,CAAC,GCDnBI,IAAc,CACzBC,GACAC,MACkB;AAClB,MAAID,KAAWA,EAAQ;AACrB,eAAWE,KAAU,OAAO,KAAKF,EAAQ,KAAK,GAAG;AAC/C,YAAMG,IAAOH,EAAQ,MAAME,CAAM;AACjC,UAAIC,EAAK,SAASF;AAChB,eAAOE,EAAK;AAAA,IAEhB;AAEF,SAAO;AACT,GCZaC,IAA2B,CAACC,MAAqC;AAC5E,QAAMC,IAAiC,CAAA;AAGvC,MAAI,CAACD;AACH,WAAOC;AAIT,aAAWH,KAAQ,OAAO,OAAOE,CAAK;AACpC,IAAAC,EAAeH,EAAK,IAAI,IAAIA,EAAK;AAGnC,SAAOG;AACT,GChBaC,IAA2B,CAACF,MAChC,OAAO,QAAQA,CAAK,EAAE,OAAO,CAACG,GAAK,CAACC,GAAMC,CAAI,OACnDF,EAAIV,EAAA,CAAmB,IAAI,EAAE,MAAAW,GAAM,MAAAC,EAAA,GAC5BF,IACN,CAAA,CAAc,GCLNG,IAAkB,CAACC,MAC9B,KAAK,MAAMA,EAAK,QAAA,IAAY,GAAI,GCDrBC,IAAkB,CAACC,MAC9B,IAAI,KAAKA,IAAY,GAAI;"}
+{"version":3,"file":"index.js","sources":["../src/isVizId.ts","../src/generateVizId.ts","../src/generateVizFileId.ts","../src/generateRunId.ts","../src/getFileText.ts","../src/vizFilesToFileCollection.ts","../src/fileCollectionToVizFiles.ts","../src/dateToTimestamp.ts","../src/timestampToDate.ts"],"sourcesContent":["import type { VizId } from \"@vizhub/viz-types\";\n\n// Checks if a string was generated by `generateId` from interactors.\nexport const isVizId = (str: string): boolean => {\n  // First check if the length is exactly 32 characters\n  if (str.length !== 32) {\n    return false;\n  }\n\n  // Regular expression for a 32-character hexadecimal string\n  let uuidV4NoDashRegex = /^[0-9a-f]{32}$/i;\n\n  // Check if the string matches the regular expression\n  if (!uuidV4NoDashRegex.test(str)) {\n    return false;\n  }\n\n  // Check if the 13th character is '4' (indicating UUID v4)\n  // and the 17th character is one of '8', '9', 'a', 'b' (indicating the variant)\n  return (\n    str[12] === \"4\"\n    // &&\n    // ['8', '9', 'a', 'b'].includes(str[16].toLowerCase())\n  );\n};\n","import type { VizId } from \"@vizhub/viz-types\";\n\n// Resolve a Web‑Crypto‑compatible `crypto` object.\n// • Browsers & Node 19 +   → globalThis.crypto\n// • Anything else (rare)   → use node:crypto's webcrypto\nconst getCryptoObj = (): Crypto => {\n  if (typeof globalThis.crypto !== \"undefined\") {\n    return globalThis.crypto as Crypto;\n  }\n  // Use require instead of import to avoid top-level await\n  // This will only run in Node.js environments\n  return require(\"node:crypto\").webcrypto as Crypto;\n};\n\nconst cryptoObj = getCryptoObj();\n\n/**\n * Generates a dash‑free RFC 4122‑compliant UUID v4 (32 hex chars).\n * Works in all evergreen browsers and Node 19 + without extra deps.\n */\nexport const generateVizId = (): VizId => {\n  const bytes = new Uint8Array(16);\n  cryptoObj.getRandomValues(bytes);\n\n  // RFC 4122: set version (4) and variant (10xx)\n  bytes[6] = (bytes[6] & 0x0f) | 0x40;\n  bytes[8] = (bytes[8] & 0x3f) | 0x80;\n\n  return Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\")).join(\n    \"\",\n  ) as VizId;\n};\n","import type { VizFileId } from \"@vizhub/viz-types\";\nimport { generateVizId } from \"./generateVizId\";\n\n// Generates a file id\nexport const generateVizFileId = (): VizFileId =>\n  generateVizId().substring(0, 8);\n","import { generateVizFileId } from \"./generateVizFileId\";\nexport const generateRunId = generateVizFileId;\n","import { VizContent } from \"@vizhub/viz-types\";\n\n// Gets the text content of a file with the given name.\n// Returns null if not found.\nexport const getFileText = (\n  content: VizContent,\n  fileName: string,\n): string | null => {\n  if (content && content.files) {\n    for (const fileId of Object.keys(content.files)) {\n      const file = content.files[fileId];\n      if (file.name === fileName) {\n        return file.text;\n      }\n    }\n  }\n  return null;\n};\n","import type { VizFiles, FileCollection } from \"@vizhub/viz-types\";\n\n/**\n * Converts VizContent to FileCollection format.\n */\nexport const vizFilesToFileCollection = (files?: VizFiles): FileCollection => {\n  const fileCollection: FileCollection = {};\n\n  // Return empty object if files is undefined\n  if (!files) {\n    return fileCollection;\n  }\n\n  // Convert each VizFile to the FileCollection format\n  for (const file of Object.values(files)) {\n    fileCollection[file.name] = file.text;\n  }\n\n  return fileCollection;\n};\n","import { FileCollection, VizFiles } from \"@vizhub/viz-types\";\nimport { generateVizFileId } from \"./generateVizFileId\";\n\nexport const fileCollectionToVizFiles = (files: FileCollection): VizFiles => {\n  return Object.entries(files).reduce((acc, [name, text]) => {\n    acc[generateVizFileId()] = { name, text };\n    return acc;\n  }, {} as VizFiles);\n};\n","import type { VizTimestamp } from \"@vizhub/viz-types\";\n\nexport const dateToTimestamp = (date: Date): VizTimestamp =>\n  Math.floor(date.getTime() / 1000);\n","import type { VizTimestamp } from \"@vizhub/viz-types\";\n\nexport const timestampToDate = (timestamp: VizTimestamp): Date =>\n  new Date(timestamp * 1000);\n"],"names":["isVizId","str","getCryptoObj","cryptoObj","generateVizId","bytes","b","generateVizFileId","generateRunId","getFileText","content","fileName","fileId","file","vizFilesToFileCollection","files","fileCollection","fileCollectionToVizFiles","acc","name","text","dateToTimestamp","date","timestampToDate","timestamp"],"mappings":"AAGO,MAAMA,IAAU,CAACC,MAElBA,EAAI,WAAW,MAQf,CAHoB,kBAGD,KAAKA,CAAG,IACtB,KAMPA,EAAI,EAAE,MAAM,KCfVC,IAAe,MACf,OAAO,WAAW,SAAW,MACxB,WAAW,SAIb,QAAQ,aAAa,EAAE,WAG1BC,IAAYD,EAAA,GAMLE,IAAgB,MAAa;AACxC,QAAMC,IAAQ,IAAI,WAAW,EAAE;AAC/B,SAAAF,EAAU,gBAAgBE,CAAK,GAG/BA,EAAM,CAAC,IAAKA,EAAM,CAAC,IAAI,KAAQ,IAC/BA,EAAM,CAAC,IAAKA,EAAM,CAAC,IAAI,KAAQ,KAExB,MAAM,KAAKA,GAAO,CAACC,MAAMA,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EAAE;AAAA,IAC/D;AAAA,EAAA;AAEJ,GC3BaC,IAAoB,MAC/BH,EAAA,EAAgB,UAAU,GAAG,CAAC,GCJnBI,IAAgBD,GCGhBE,IAAc,CACzBC,GACAC,MACkB;AAClB,MAAID,KAAWA,EAAQ;AACrB,eAAWE,KAAU,OAAO,KAAKF,EAAQ,KAAK,GAAG;AAC/C,YAAMG,IAAOH,EAAQ,MAAME,CAAM;AACjC,UAAIC,EAAK,SAASF;AAChB,eAAOE,EAAK;AAAA,IAEhB;AAEF,SAAO;AACT,GCZaC,IAA2B,CAACC,MAAqC;AAC5E,QAAMC,IAAiC,CAAA;AAGvC,MAAI,CAACD;AACH,WAAOC;AAIT,aAAWH,KAAQ,OAAO,OAAOE,CAAK;AACpC,IAAAC,EAAeH,EAAK,IAAI,IAAIA,EAAK;AAGnC,SAAOG;AACT,GChBaC,IAA2B,CAACF,MAChC,OAAO,QAAQA,CAAK,EAAE,OAAO,CAACG,GAAK,CAACC,GAAMC,CAAI,OACnDF,EAAIX,EAAA,CAAmB,IAAI,EAAE,MAAAY,GAAM,MAAAC,EAAA,GAC5BF,IACN,CAAA,CAAc,GCLNG,IAAkB,CAACC,MAC9B,KAAK,MAAMA,EAAK,QAAA,IAAY,GAAI,GCDrBC,IAAkB,CAACC,MAC9B,IAAI,KAAKA,IAAY,GAAI;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizhub/viz-utils",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Utility functions for use across VizHub packages.",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -36,14 +36,14 @@
   },
   "homepage": "https://github.com/vizhub-core/viz-utils#readme",
   "dependencies": {
-    "@vizhub/viz-types": "^0.2.0"
+    "@vizhub/viz-types": "^0.4.0"
   },
   "devDependencies": {
-    "@types/node": "^24.0.14",
-    "npm-check-updates": "^18.0.1",
+    "@types/node": "^24.1.0",
+    "npm-check-updates": "^18.0.2",
     "prettier": "^3.6.2",
-    "typescript": "^5.8.3",
-    "vite": "^7.0.5",
+    "typescript": "^5.9.2",
+    "vite": "^7.0.6",
     "vitest": "^3.2.4"
   },
   "publishConfig": {