@zivue/zuuid 0.1.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.
Files changed (49) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/LICENSE +21 -0
  3. package/README.md +368 -0
  4. package/dist/client.d.ts +29 -0
  5. package/dist/client.d.ts.map +1 -0
  6. package/dist/client.js +39 -0
  7. package/dist/entity.d.ts +106 -0
  8. package/dist/entity.d.ts.map +1 -0
  9. package/dist/entity.js +101 -0
  10. package/dist/hash.d.ts +3 -0
  11. package/dist/hash.d.ts.map +1 -0
  12. package/dist/hash.js +9 -0
  13. package/dist/identity.d.ts +14 -0
  14. package/dist/identity.d.ts.map +1 -0
  15. package/dist/identity.js +39 -0
  16. package/dist/index.d.ts +9 -0
  17. package/dist/index.d.ts.map +1 -0
  18. package/dist/index.js +8 -0
  19. package/dist/providers/tmdb/client.d.ts +30 -0
  20. package/dist/providers/tmdb/client.d.ts.map +1 -0
  21. package/dist/providers/tmdb/client.js +92 -0
  22. package/dist/providers/tmdb/constants.d.ts +5 -0
  23. package/dist/providers/tmdb/constants.d.ts.map +1 -0
  24. package/dist/providers/tmdb/constants.js +4 -0
  25. package/dist/providers/tmdb/index.d.ts +7 -0
  26. package/dist/providers/tmdb/index.d.ts.map +1 -0
  27. package/dist/providers/tmdb/index.js +6 -0
  28. package/dist/providers/tmdb/movie.d.ts +164 -0
  29. package/dist/providers/tmdb/movie.d.ts.map +1 -0
  30. package/dist/providers/tmdb/movie.js +537 -0
  31. package/dist/providers/tmdb/person.d.ts +84 -0
  32. package/dist/providers/tmdb/person.d.ts.map +1 -0
  33. package/dist/providers/tmdb/person.js +345 -0
  34. package/dist/providers/tmdb/tv.d.ts +181 -0
  35. package/dist/providers/tmdb/tv.d.ts.map +1 -0
  36. package/dist/providers/tmdb/tv.js +522 -0
  37. package/dist/providers/tmdb/types.d.ts +36 -0
  38. package/dist/providers/tmdb/types.d.ts.map +1 -0
  39. package/dist/providers/tmdb/types.js +1 -0
  40. package/dist/source.d.ts +35 -0
  41. package/dist/source.d.ts.map +1 -0
  42. package/dist/source.js +53 -0
  43. package/dist/types.d.ts +5 -0
  44. package/dist/types.d.ts.map +1 -0
  45. package/dist/types.js +1 -0
  46. package/dist/uuid.d.ts +3 -0
  47. package/dist/uuid.d.ts.map +1 -0
  48. package/dist/uuid.js +32 -0
  49. package/package.json +72 -0
package/dist/uuid.js ADDED
@@ -0,0 +1,32 @@
1
+ const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
2
+ export function normalizeUuid(value) {
3
+ const normalized = value.trim().toLowerCase();
4
+ if (!UUID_PATTERN.test(normalized)) {
5
+ throw new Error(`invalid UUID: ${value}`);
6
+ }
7
+ return normalized;
8
+ }
9
+ export async function uuidV5(name, namespace) {
10
+ const namespaceBytes = uuidToBytes(namespace);
11
+ const nameBytes = new TextEncoder().encode(name);
12
+ const bytes = new Uint8Array(namespaceBytes.length + nameBytes.length);
13
+ bytes.set(namespaceBytes);
14
+ bytes.set(nameBytes, namespaceBytes.length);
15
+ const digest = new Uint8Array(await globalThis.crypto.subtle.digest("SHA-1", bytes));
16
+ const uuid = digest.slice(0, 16);
17
+ uuid[6] = (uuid[6] & 0x0f) | 0x50;
18
+ uuid[8] = (uuid[8] & 0x3f) | 0x80;
19
+ return bytesToUuid(uuid);
20
+ }
21
+ function uuidToBytes(uuid) {
22
+ const hex = normalizeUuid(uuid).replaceAll("-", "");
23
+ const bytes = new Uint8Array(16);
24
+ for (let index = 0; index < bytes.length; index += 1) {
25
+ bytes[index] = Number.parseInt(hex.slice(index * 2, index * 2 + 2), 16);
26
+ }
27
+ return bytes;
28
+ }
29
+ function bytesToUuid(bytes) {
30
+ const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
31
+ return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`;
32
+ }
package/package.json ADDED
@@ -0,0 +1,72 @@
1
+ {
2
+ "name": "@zivue/zuuid",
3
+ "version": "0.1.0",
4
+ "description": "TypeScript helpers for fetching, searching, and transforming Zuuid datasets.",
5
+ "type": "module",
6
+ "license": "MIT",
7
+ "author": "Zivue",
8
+ "repository": {
9
+ "type": "git",
10
+ "url": "git+ssh://git@github.com/zivue/zuuid.git"
11
+ },
12
+ "bugs": {
13
+ "url": "https://github.com/zivue/zuuid/issues"
14
+ },
15
+ "homepage": "https://github.com/zivue/zuuid#readme",
16
+ "keywords": [
17
+ "zuuid",
18
+ "uuid-v5",
19
+ "metadata",
20
+ "dataset",
21
+ "tmdb"
22
+ ],
23
+ "files": [
24
+ "dist",
25
+ "README.md",
26
+ "CHANGELOG.md",
27
+ "LICENSE"
28
+ ],
29
+ "exports": {
30
+ ".": {
31
+ "types": "./dist/index.d.ts",
32
+ "import": "./dist/index.js"
33
+ },
34
+ "./providers/tmdb": {
35
+ "types": "./dist/providers/tmdb/index.d.ts",
36
+ "import": "./dist/providers/tmdb/index.js"
37
+ },
38
+ "./providers/tmdb/movie": {
39
+ "types": "./dist/providers/tmdb/movie.d.ts",
40
+ "import": "./dist/providers/tmdb/movie.js"
41
+ },
42
+ "./providers/tmdb/tv": {
43
+ "types": "./dist/providers/tmdb/tv.d.ts",
44
+ "import": "./dist/providers/tmdb/tv.js"
45
+ },
46
+ "./providers/tmdb/person": {
47
+ "types": "./dist/providers/tmdb/person.d.ts",
48
+ "import": "./dist/providers/tmdb/person.js"
49
+ }
50
+ },
51
+ "types": "./dist/index.d.ts",
52
+ "publishConfig": {
53
+ "access": "public"
54
+ },
55
+ "sideEffects": false,
56
+ "engines": {
57
+ "node": ">=18"
58
+ },
59
+ "scripts": {
60
+ "build": "tsc -p tsconfig.json",
61
+ "clean": "rm -rf dist",
62
+ "example:tmdb": "npm run example:tmdb-fetch --",
63
+ "example:tmdb-fetch": "npm run build && node examples/tmdb-fetch.mjs",
64
+ "example:tmdb-search": "npm run build && node examples/tmdb-search.mjs",
65
+ "prepublishOnly": "npm run clean && npm run test",
66
+ "test": "npm run build && node --test test/*.test.mjs",
67
+ "typecheck": "tsc -p tsconfig.json --noEmit"
68
+ },
69
+ "devDependencies": {
70
+ "typescript": "^5.8.3"
71
+ }
72
+ }