@vizhub/viz-utils 1.0.1 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +52 -4
- package/dist/dateToTimestamp.d.ts +3 -0
- package/dist/dateToTimestamp.d.ts.map +1 -0
- package/dist/dateToTimestamp.test.d.ts +2 -0
- package/dist/dateToTimestamp.test.d.ts.map +1 -0
- package/dist/fileCollectionToVizFiles.d.ts +3 -0
- package/dist/fileCollectionToVizFiles.d.ts.map +1 -0
- package/dist/fileCollectionToVizFiles.test.d.ts +2 -0
- package/dist/fileCollectionToVizFiles.test.d.ts.map +1 -0
- package/dist/index.cjs +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +14 -11
- package/dist/index.js.map +1 -1
- package/dist/timestampToDate.d.ts +3 -0
- package/dist/timestampToDate.d.ts.map +1 -0
- package/dist/timestampToDate.test.d.ts +2 -0
- package/dist/timestampToDate.test.d.ts.map +1 -0
- package/package.json +8 -6
package/README.md
CHANGED
|
@@ -23,7 +23,7 @@ Generates a unique VizId (a UUID v4 string without dashes) for a visualization.
|
|
|
23
23
|
```typescript
|
|
24
24
|
import { generateVizId } from "@vizhub/viz-utils";
|
|
25
25
|
|
|
26
|
-
const newVizId = generateVizId(); // e.g. "
|
|
26
|
+
const newVizId = generateVizId(); // e.g. "550e8400e29b41d4a716446655440000"
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
#### `generateVizFileId(): string`
|
|
@@ -33,7 +33,7 @@ Generates a unique VizFileId (an 8-character hexadecimal string) for a file with
|
|
|
33
33
|
```typescript
|
|
34
34
|
import { generateVizFileId } from "@vizhub/viz-utils";
|
|
35
35
|
|
|
36
|
-
const newFileId = generateVizFileId(); // e.g. "
|
|
36
|
+
const newFileId = generateVizFileId(); // e.g. "550e8400"
|
|
37
37
|
```
|
|
38
38
|
|
|
39
39
|
### Validation
|
|
@@ -53,6 +53,30 @@ isVizId("12345678901234567890123456789012"); // true if valid
|
|
|
53
53
|
isVizId("invalid-id"); // false
|
|
54
54
|
```
|
|
55
55
|
|
|
56
|
+
### Time Utilities
|
|
57
|
+
|
|
58
|
+
#### `dateToTimestamp(date: Date): VizTimestamp`
|
|
59
|
+
|
|
60
|
+
Converts a JavaScript Date object to a Unix timestamp (seconds since epoch). The result is floored to remove milliseconds.
|
|
61
|
+
|
|
62
|
+
```typescript
|
|
63
|
+
import { dateToTimestamp } from "@vizhub/viz-utils";
|
|
64
|
+
|
|
65
|
+
const date = new Date("2023-01-01T00:00:00.000Z");
|
|
66
|
+
const timestamp = dateToTimestamp(date); // 1672531200
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
#### `timestampToDate(timestamp: VizTimestamp): Date`
|
|
70
|
+
|
|
71
|
+
Converts a Unix timestamp (seconds since epoch) to a JavaScript Date object.
|
|
72
|
+
|
|
73
|
+
```typescript
|
|
74
|
+
import { timestampToDate } from "@vizhub/viz-utils";
|
|
75
|
+
|
|
76
|
+
const timestamp = 1672531200;
|
|
77
|
+
const date = timestampToDate(timestamp); // 2023-01-01T00:00:00.000Z
|
|
78
|
+
```
|
|
79
|
+
|
|
56
80
|
### File Operations
|
|
57
81
|
|
|
58
82
|
#### `getFileText(content: VizContent, fileName: string): string | null`
|
|
@@ -87,14 +111,37 @@ Returns an empty object if:
|
|
|
87
111
|
import { vizFilesToFileCollection } from "@vizhub/viz-utils";
|
|
88
112
|
|
|
89
113
|
const vizFiles = {
|
|
90
|
-
|
|
91
|
-
|
|
114
|
+
"550e8400": { name: "index.html", text: "<html>Test</html>" },
|
|
115
|
+
e29b41d4: { name: "script.js", text: 'console.log("Hello");' },
|
|
92
116
|
};
|
|
93
117
|
|
|
94
118
|
const fileCollection = vizFilesToFileCollection(vizFiles);
|
|
95
119
|
// Result: { "index.html": "<html>Test</html>", "script.js": 'console.log("Hello");' }
|
|
96
120
|
```
|
|
97
121
|
|
|
122
|
+
#### `fileCollectionToVizFiles(files: FileCollection): VizFiles`
|
|
123
|
+
|
|
124
|
+
Converts a simple file collection (keyed by filename) to VizFiles format (keyed by generated file ID).
|
|
125
|
+
Returns an empty object if:
|
|
126
|
+
|
|
127
|
+
- No files are provided
|
|
128
|
+
- The files object is empty
|
|
129
|
+
|
|
130
|
+
```typescript
|
|
131
|
+
import { fileCollectionToVizFiles } from "@vizhub/viz-utils";
|
|
132
|
+
|
|
133
|
+
const fileCollection = {
|
|
134
|
+
"index.html": "<html>Test</html>",
|
|
135
|
+
"script.js": 'console.log("Hello");',
|
|
136
|
+
};
|
|
137
|
+
|
|
138
|
+
const vizFiles = fileCollectionToVizFiles(fileCollection);
|
|
139
|
+
// Result: {
|
|
140
|
+
// "550e8400": { name: "index.html", text: "<html>Test</html>" },
|
|
141
|
+
// "e29b41d4": { name: "script.js", text: 'console.log("Hello");' }
|
|
142
|
+
// }
|
|
143
|
+
```
|
|
144
|
+
|
|
98
145
|
## Types
|
|
99
146
|
|
|
100
147
|
This package uses the following types from `@vizhub/viz-types`:
|
|
@@ -104,6 +151,7 @@ This package uses the following types from `@vizhub/viz-types`:
|
|
|
104
151
|
- `VizContent`: The content of a visualization, including its files
|
|
105
152
|
- `VizFile`: A file with a name and text content
|
|
106
153
|
- `VizFiles`: A collection of files, indexed by their VizFileId
|
|
154
|
+
- `VizTimestamp`: A Unix timestamp representing seconds since epoch
|
|
107
155
|
|
|
108
156
|
## License
|
|
109
157
|
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dateToTimestamp.d.ts","sourceRoot":"","sources":["../src/dateToTimestamp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,eAAO,MAAM,eAAe,GAAI,MAAM,IAAI,KAAG,YACV,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dateToTimestamp.test.d.ts","sourceRoot":"","sources":["../src/dateToTimestamp.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fileCollectionToVizFiles.d.ts","sourceRoot":"","sources":["../src/fileCollectionToVizFiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7D,eAAO,MAAM,wBAAwB,GAAI,OAAO,cAAc,KAAG,QAKhE,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fileCollectionToVizFiles.test.d.ts","sourceRoot":"","sources":["../src/fileCollectionToVizFiles.test.ts"],"names":[],"mappings":""}
|
package/dist/index.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const
|
|
1
|
+
"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;
|
|
2
2
|
//# sourceMappingURL=index.cjs.map
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.cjs","sources":["../src/isVizId.ts","../src/generateVizId.ts","../src/generateVizFileId.ts","../src/getFileText.ts","../src/vizFilesToFileCollection.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
|
|
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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -3,4 +3,7 @@ export { generateVizId } from "./generateVizId";
|
|
|
3
3
|
export { generateVizFileId } from "./generateVizFileId";
|
|
4
4
|
export { getFileText } from "./getFileText";
|
|
5
5
|
export { vizFilesToFileCollection } from "./vizFilesToFileCollection";
|
|
6
|
+
export { fileCollectionToVizFiles } from "./fileCollectionToVizFiles";
|
|
7
|
+
export { dateToTimestamp } from "./dateToTimestamp";
|
|
8
|
+
export { timestampToDate } from "./timestampToDate";
|
|
6
9
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"
|
|
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"}
|
package/dist/index.js
CHANGED
|
@@ -1,29 +1,32 @@
|
|
|
1
|
-
const
|
|
1
|
+
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 = () => {
|
|
2
2
|
const e = new Uint8Array(16);
|
|
3
3
|
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(
|
|
4
4
|
""
|
|
5
5
|
);
|
|
6
|
-
},
|
|
6
|
+
}, l = () => s().substring(0, 8), a = (e, t) => {
|
|
7
7
|
if (e && e.files)
|
|
8
8
|
for (const r of Object.keys(e.files)) {
|
|
9
|
-
const
|
|
10
|
-
if (
|
|
11
|
-
return
|
|
9
|
+
const o = e.files[r];
|
|
10
|
+
if (o.name === t)
|
|
11
|
+
return o.text;
|
|
12
12
|
}
|
|
13
13
|
return null;
|
|
14
|
-
},
|
|
14
|
+
}, u = (e) => {
|
|
15
15
|
const t = {};
|
|
16
16
|
if (!e)
|
|
17
17
|
return t;
|
|
18
18
|
for (const r of Object.values(e))
|
|
19
19
|
t[r.name] = r.text;
|
|
20
20
|
return t;
|
|
21
|
-
};
|
|
21
|
+
}, 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);
|
|
22
22
|
export {
|
|
23
|
-
|
|
23
|
+
g as dateToTimestamp,
|
|
24
|
+
c as fileCollectionToVizFiles,
|
|
25
|
+
l as generateVizFileId,
|
|
24
26
|
s as generateVizId,
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
27
|
+
a as getFileText,
|
|
28
|
+
f as isVizId,
|
|
29
|
+
d as timestampToDate,
|
|
30
|
+
u as vizFilesToFileCollection
|
|
28
31
|
};
|
|
29
32
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sources":["../src/isVizId.ts","../src/generateVizId.ts","../src/generateVizFileId.ts","../src/getFileText.ts","../src/vizFilesToFileCollection.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
|
|
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;"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"timestampToDate.d.ts","sourceRoot":"","sources":["../src/timestampToDate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,eAAO,MAAM,eAAe,GAAI,WAAW,YAAY,KAAG,IAC9B,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"timestampToDate.test.d.ts","sourceRoot":"","sources":["../src/timestampToDate.test.ts"],"names":[],"mappings":""}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vizhub/viz-utils",
|
|
3
|
-
"version": "1.0
|
|
3
|
+
"version": "1.3.0",
|
|
4
4
|
"description": "Utility functions for use across VizHub packages.",
|
|
5
5
|
"main": "./dist/index.cjs",
|
|
6
6
|
"module": "./dist/index.js",
|
|
@@ -36,13 +36,15 @@
|
|
|
36
36
|
},
|
|
37
37
|
"homepage": "https://github.com/vizhub-core/viz-utils#readme",
|
|
38
38
|
"dependencies": {
|
|
39
|
-
"@vizhub/viz-types": "^0.
|
|
39
|
+
"@vizhub/viz-types": "^0.2.0"
|
|
40
40
|
},
|
|
41
41
|
"devDependencies": {
|
|
42
|
-
"
|
|
43
|
-
"
|
|
44
|
-
"
|
|
45
|
-
"
|
|
42
|
+
"@types/node": "^24.0.14",
|
|
43
|
+
"npm-check-updates": "^18.0.1",
|
|
44
|
+
"prettier": "^3.6.2",
|
|
45
|
+
"typescript": "^5.8.3",
|
|
46
|
+
"vite": "^7.0.5",
|
|
47
|
+
"vitest": "^3.2.4"
|
|
46
48
|
},
|
|
47
49
|
"publishConfig": {
|
|
48
50
|
"access": "public"
|