@parrel/ledger 0.0.0-stage → 5.0.1

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 (239) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +793 -2
  3. package/dist/cli/commands.d.ts +51 -0
  4. package/dist/cli/commands.d.ts.map +1 -0
  5. package/dist/cli/commands.js +968 -0
  6. package/dist/cli/commands.js.map +1 -0
  7. package/dist/cli/index.d.ts +24 -0
  8. package/dist/cli/index.d.ts.map +1 -0
  9. package/dist/cli/index.js +35 -0
  10. package/dist/cli/index.js.map +1 -0
  11. package/dist/cli/parrel.d.ts +3 -0
  12. package/dist/cli/parrel.d.ts.map +1 -0
  13. package/dist/cli/parrel.js +5 -0
  14. package/dist/cli/parrel.js.map +1 -0
  15. package/dist/cli/utils/angular-setup.d.ts +14 -0
  16. package/dist/cli/utils/angular-setup.d.ts.map +1 -0
  17. package/dist/cli/utils/angular-setup.js +96 -0
  18. package/dist/cli/utils/angular-setup.js.map +1 -0
  19. package/dist/cli/utils/api-tree-builder.d.ts +24 -0
  20. package/dist/cli/utils/api-tree-builder.d.ts.map +1 -0
  21. package/dist/cli/utils/api-tree-builder.js +146 -0
  22. package/dist/cli/utils/api-tree-builder.js.map +1 -0
  23. package/dist/cli/utils/bundle-reader.d.ts +185 -0
  24. package/dist/cli/utils/bundle-reader.d.ts.map +1 -0
  25. package/dist/cli/utils/bundle-reader.js +518 -0
  26. package/dist/cli/utils/bundle-reader.js.map +1 -0
  27. package/dist/cli/utils/collision-detector.d.ts +21 -0
  28. package/dist/cli/utils/collision-detector.d.ts.map +1 -0
  29. package/dist/cli/utils/collision-detector.js +53 -0
  30. package/dist/cli/utils/collision-detector.js.map +1 -0
  31. package/dist/cli/utils/map-fields.d.ts +42 -0
  32. package/dist/cli/utils/map-fields.d.ts.map +1 -0
  33. package/dist/cli/utils/map-fields.js +90 -0
  34. package/dist/cli/utils/map-fields.js.map +1 -0
  35. package/dist/cli/utils/map-validator.d.ts +42 -0
  36. package/dist/cli/utils/map-validator.d.ts.map +1 -0
  37. package/dist/cli/utils/map-validator.js +119 -0
  38. package/dist/cli/utils/map-validator.js.map +1 -0
  39. package/dist/cli/utils/media-file.d.ts +41 -0
  40. package/dist/cli/utils/media-file.d.ts.map +1 -0
  41. package/dist/cli/utils/media-file.js +72 -0
  42. package/dist/cli/utils/media-file.js.map +1 -0
  43. package/dist/cli/utils/media-validator.d.ts +10 -0
  44. package/dist/cli/utils/media-validator.d.ts.map +1 -0
  45. package/dist/cli/utils/media-validator.js +85 -0
  46. package/dist/cli/utils/media-validator.js.map +1 -0
  47. package/dist/cli/utils/mock-augmenter.d.ts +19 -0
  48. package/dist/cli/utils/mock-augmenter.d.ts.map +1 -0
  49. package/dist/cli/utils/mock-augmenter.js +102 -0
  50. package/dist/cli/utils/mock-augmenter.js.map +1 -0
  51. package/dist/cli/utils/mock-validator.d.ts +27 -0
  52. package/dist/cli/utils/mock-validator.d.ts.map +1 -0
  53. package/dist/cli/utils/mock-validator.js +214 -0
  54. package/dist/cli/utils/mock-validator.js.map +1 -0
  55. package/dist/cli/utils/project-dir.d.ts +24 -0
  56. package/dist/cli/utils/project-dir.d.ts.map +1 -0
  57. package/dist/cli/utils/project-dir.js +32 -0
  58. package/dist/cli/utils/project-dir.js.map +1 -0
  59. package/dist/cli/utils/schema-loader.d.ts +19 -0
  60. package/dist/cli/utils/schema-loader.d.ts.map +1 -0
  61. package/dist/cli/utils/schema-loader.js +101 -0
  62. package/dist/cli/utils/schema-loader.js.map +1 -0
  63. package/dist/cli/utils/server-entry.d.ts +34 -0
  64. package/dist/cli/utils/server-entry.d.ts.map +1 -0
  65. package/dist/cli/utils/server-entry.js +111 -0
  66. package/dist/cli/utils/server-entry.js.map +1 -0
  67. package/dist/cli/utils/sync.d.ts +116 -0
  68. package/dist/cli/utils/sync.d.ts.map +1 -0
  69. package/dist/cli/utils/sync.js +134 -0
  70. package/dist/cli/utils/sync.js.map +1 -0
  71. package/dist/client/index.d.ts +39 -0
  72. package/dist/client/index.d.ts.map +1 -0
  73. package/dist/client/index.js +88 -0
  74. package/dist/client/index.js.map +1 -0
  75. package/dist/core/browser-session.d.ts +5 -0
  76. package/dist/core/browser-session.d.ts.map +1 -0
  77. package/dist/core/browser-session.js +12 -0
  78. package/dist/core/browser-session.js.map +1 -0
  79. package/dist/core/cache.d.ts +80 -0
  80. package/dist/core/cache.d.ts.map +1 -0
  81. package/dist/core/cache.js +95 -0
  82. package/dist/core/cache.js.map +1 -0
  83. package/dist/core/client.d.ts +64 -0
  84. package/dist/core/client.d.ts.map +1 -0
  85. package/dist/core/client.js +281 -0
  86. package/dist/core/client.js.map +1 -0
  87. package/dist/core/config.d.ts +20 -0
  88. package/dist/core/config.d.ts.map +1 -0
  89. package/dist/core/config.js +32 -0
  90. package/dist/core/config.js.map +1 -0
  91. package/dist/core/copy-read.d.ts +25 -0
  92. package/dist/core/copy-read.d.ts.map +1 -0
  93. package/dist/core/copy-read.js +123 -0
  94. package/dist/core/copy-read.js.map +1 -0
  95. package/dist/core/define-ledger.d.ts +38 -0
  96. package/dist/core/define-ledger.d.ts.map +1 -0
  97. package/dist/core/define-ledger.js +65 -0
  98. package/dist/core/define-ledger.js.map +1 -0
  99. package/dist/core/deprecated.d.ts +16 -0
  100. package/dist/core/deprecated.d.ts.map +1 -0
  101. package/dist/core/deprecated.js +14 -0
  102. package/dist/core/deprecated.js.map +1 -0
  103. package/dist/core/env.d.ts +103 -0
  104. package/dist/core/env.d.ts.map +1 -0
  105. package/dist/core/env.js +208 -0
  106. package/dist/core/env.js.map +1 -0
  107. package/dist/core/error-codes.generated.d.ts +12 -0
  108. package/dist/core/error-codes.generated.d.ts.map +1 -0
  109. package/dist/core/error-codes.generated.js +3 -0
  110. package/dist/core/error-codes.generated.js.map +1 -0
  111. package/dist/core/get-content.d.ts +62 -0
  112. package/dist/core/get-content.d.ts.map +1 -0
  113. package/dist/core/get-content.js +86 -0
  114. package/dist/core/get-content.js.map +1 -0
  115. package/dist/core/get-media.d.ts +58 -0
  116. package/dist/core/get-media.d.ts.map +1 -0
  117. package/dist/core/get-media.js +89 -0
  118. package/dist/core/get-media.js.map +1 -0
  119. package/dist/core/manifest.d.ts +38 -0
  120. package/dist/core/manifest.d.ts.map +1 -0
  121. package/dist/core/manifest.js +93 -0
  122. package/dist/core/manifest.js.map +1 -0
  123. package/dist/core/media-proxy.d.ts +41 -0
  124. package/dist/core/media-proxy.d.ts.map +1 -0
  125. package/dist/core/media-proxy.js +219 -0
  126. package/dist/core/media-proxy.js.map +1 -0
  127. package/dist/core/package-info.d.ts +34 -0
  128. package/dist/core/package-info.d.ts.map +1 -0
  129. package/dist/core/package-info.js +39 -0
  130. package/dist/core/package-info.js.map +1 -0
  131. package/dist/core/parrel-error.d.ts +160 -0
  132. package/dist/core/parrel-error.d.ts.map +1 -0
  133. package/dist/core/parrel-error.js +198 -0
  134. package/dist/core/parrel-error.js.map +1 -0
  135. package/dist/core/transform-content.d.ts +42 -0
  136. package/dist/core/transform-content.d.ts.map +1 -0
  137. package/dist/core/transform-content.js +185 -0
  138. package/dist/core/transform-content.js.map +1 -0
  139. package/dist/core/types.d.ts +406 -0
  140. package/dist/core/types.d.ts.map +1 -0
  141. package/dist/core/types.js +11 -0
  142. package/dist/core/types.js.map +1 -0
  143. package/dist/errors/error-messages.generated.d.ts +5 -0
  144. package/dist/errors/error-messages.generated.d.ts.map +1 -0
  145. package/dist/errors/error-messages.generated.js +971 -0
  146. package/dist/errors/error-messages.generated.js.map +1 -0
  147. package/dist/errors/get-error-info.d.ts +29 -0
  148. package/dist/errors/get-error-info.d.ts.map +1 -0
  149. package/dist/errors/get-error-info.js +43 -0
  150. package/dist/errors/get-error-info.js.map +1 -0
  151. package/dist/errors/index.d.ts +4 -0
  152. package/dist/errors/index.d.ts.map +1 -0
  153. package/dist/errors/index.js +4 -0
  154. package/dist/errors/index.js.map +1 -0
  155. package/dist/errors/types.d.ts +19 -0
  156. package/dist/errors/types.d.ts.map +1 -0
  157. package/dist/errors/types.js +2 -0
  158. package/dist/errors/types.js.map +1 -0
  159. package/dist/generated.d.ts +29 -0
  160. package/dist/generated.d.ts.map +1 -0
  161. package/dist/generated.js +29 -0
  162. package/dist/generated.js.map +1 -0
  163. package/dist/index.d.ts +19 -0
  164. package/dist/index.d.ts.map +1 -0
  165. package/dist/index.js +16 -0
  166. package/dist/index.js.map +1 -0
  167. package/dist/mock/dev-media.d.ts +15 -0
  168. package/dist/mock/dev-media.d.ts.map +1 -0
  169. package/dist/mock/dev-media.js +52 -0
  170. package/dist/mock/dev-media.js.map +1 -0
  171. package/dist/mock/file-store.d.ts +44 -0
  172. package/dist/mock/file-store.d.ts.map +1 -0
  173. package/dist/mock/file-store.js +170 -0
  174. package/dist/mock/file-store.js.map +1 -0
  175. package/dist/mock/index.d.ts +4 -0
  176. package/dist/mock/index.d.ts.map +1 -0
  177. package/dist/mock/index.js +3 -0
  178. package/dist/mock/index.js.map +1 -0
  179. package/dist/mock/media-fields.d.ts +25 -0
  180. package/dist/mock/media-fields.d.ts.map +1 -0
  181. package/dist/mock/media-fields.js +54 -0
  182. package/dist/mock/media-fields.js.map +1 -0
  183. package/dist/mock/mock-adapter.d.ts +65 -0
  184. package/dist/mock/mock-adapter.d.ts.map +1 -0
  185. package/dist/mock/mock-adapter.js +431 -0
  186. package/dist/mock/mock-adapter.js.map +1 -0
  187. package/dist/mock/mock-errors.d.ts +18 -0
  188. package/dist/mock/mock-errors.d.ts.map +1 -0
  189. package/dist/mock/mock-errors.js +56 -0
  190. package/dist/mock/mock-errors.js.map +1 -0
  191. package/dist/mock/node-import.d.ts +13 -0
  192. package/dist/mock/node-import.d.ts.map +1 -0
  193. package/dist/mock/node-import.js +16 -0
  194. package/dist/mock/node-import.js.map +1 -0
  195. package/dist/mock/seed-mock-store.d.ts +14 -0
  196. package/dist/mock/seed-mock-store.d.ts.map +1 -0
  197. package/dist/mock/seed-mock-store.js +106 -0
  198. package/dist/mock/seed-mock-store.js.map +1 -0
  199. package/dist/mock/shared-memory-store.d.ts +35 -0
  200. package/dist/mock/shared-memory-store.d.ts.map +1 -0
  201. package/dist/mock/shared-memory-store.js +46 -0
  202. package/dist/mock/shared-memory-store.js.map +1 -0
  203. package/dist/next/dev-rendering-helpers.d.ts +78 -0
  204. package/dist/next/dev-rendering-helpers.d.ts.map +1 -0
  205. package/dist/next/dev-rendering-helpers.js +103 -0
  206. package/dist/next/dev-rendering-helpers.js.map +1 -0
  207. package/dist/next/index.d.ts +35 -0
  208. package/dist/next/index.d.ts.map +1 -0
  209. package/dist/next/index.js +33 -0
  210. package/dist/next/index.js.map +1 -0
  211. package/dist/next/next-cache-adapter.d.ts +11 -0
  212. package/dist/next/next-cache-adapter.d.ts.map +1 -0
  213. package/dist/next/next-cache-adapter.js +12 -0
  214. package/dist/next/next-cache-adapter.js.map +1 -0
  215. package/dist/nuxt/index.d.ts +22 -0
  216. package/dist/nuxt/index.d.ts.map +1 -0
  217. package/dist/nuxt/index.js +57 -0
  218. package/dist/nuxt/index.js.map +1 -0
  219. package/dist/sveltekit/index.d.ts +35 -0
  220. package/dist/sveltekit/index.d.ts.map +1 -0
  221. package/dist/sveltekit/index.js +56 -0
  222. package/dist/sveltekit/index.js.map +1 -0
  223. package/dist/ui/content-editor.d.ts +9 -0
  224. package/dist/ui/content-editor.d.ts.map +1 -0
  225. package/dist/ui/content-editor.js +27 -0
  226. package/dist/ui/content-editor.js.map +1 -0
  227. package/dist/ui/index.d.ts +8 -0
  228. package/dist/ui/index.d.ts.map +1 -0
  229. package/dist/ui/index.js +8 -0
  230. package/dist/ui/index.js.map +1 -0
  231. package/dist/ui/ledger-overlay.d.ts +10 -0
  232. package/dist/ui/ledger-overlay.d.ts.map +1 -0
  233. package/dist/ui/ledger-overlay.js +27 -0
  234. package/dist/ui/ledger-overlay.js.map +1 -0
  235. package/dist/ui/media-uploader.d.ts +9 -0
  236. package/dist/ui/media-uploader.d.ts.map +1 -0
  237. package/dist/ui/media-uploader.js +27 -0
  238. package/dist/ui/media-uploader.js.map +1 -0
  239. package/package.json +134 -6
@@ -0,0 +1,518 @@
1
+ /**
2
+ * A small, strict reader of `.parrel` bundles (the backup format of Ledger, `docs/bundle-format.md` of the Ledger
3
+ * service, version 1). It reads only what that format allows: a zip with the methods stored and deflate, no zip64,
4
+ * no encryption, and entry names that are safe on every file system. It counts the bytes it unpacks itself and never
5
+ * trusts the sizes written in the zip.
6
+ */
7
+ import { createWriteStream } from "node:fs";
8
+ import { open, stat } from "node:fs/promises";
9
+ import { Readable, Transform, Writable } from "node:stream";
10
+ import { pipeline } from "node:stream/promises";
11
+ import { createInflateRaw } from "node:zlib";
12
+ import { ParrelError } from "../../core/parrel-error.js";
13
+ /**
14
+ * The limits of a restore in Ledger: 100000 entries, 16 MiB per JSON entry and 2 GiB in total.
15
+ *
16
+ * @example
17
+ * ```ts
18
+ * const bundle = await openBundle("backup.parrel", DEFAULT_BUNDLE_LIMITS);
19
+ * ```
20
+ */
21
+ export const DEFAULT_BUNDLE_LIMITS = Object.freeze({
22
+ maxEntries: 100_000,
23
+ maxJsonEntryBytes: 16 * 1024 * 1024,
24
+ maxTotalBytes: 2 * 1024 * 1024 * 1024,
25
+ });
26
+ const EOCD_SIGNATURE = 0x06054b50;
27
+ const ZIP64_LOCATOR_SIGNATURE = 0x07064b50;
28
+ const CENTRAL_SIGNATURE = 0x02014b50;
29
+ const LOCAL_SIGNATURE = 0x04034b50;
30
+ const EOCD_SIZE = 22;
31
+ const MAX_COMMENT = 0xffff;
32
+ const ZIP64_EXTRA_ID = 0x0001;
33
+ const FLAG_ENCRYPTED = 0x0001;
34
+ const FLAG_STRONG_ENCRYPTION = 0x0040;
35
+ const READ_CHUNK = 64 * 1024;
36
+ const NAME_MAX = 128;
37
+ const NAME_CHARS = {
38
+ maps: /^[A-Za-z0-9_-]+$/,
39
+ content: /^[A-Za-z0-9_.[\]-]+$/,
40
+ media: /^[A-Za-z0-9_.-]+$/,
41
+ extras: /^[A-Za-z0-9_.-]+$/,
42
+ };
43
+ const FOLDERS = new Set(["maps", "content", "media", "extras"]);
44
+ const WINDOWS_DEVICE = /^(con|prn|aux|nul|com[0-9]|lpt[0-9])$/i;
45
+ function notABundle(file, reason) {
46
+ return new ParrelError("SD05000025", `The file ${file} is not a readable .parrel backup: ${reason}. Download the backup again in the Parrel portal and run the command again.`);
47
+ }
48
+ function formatUnsupported(file, reason) {
49
+ return new ParrelError("SD05000026", `The file ${file} is not a Ledger backup this version of @parrel/ledger can read: ${reason}. Use a .parrel backup of a Ledger service, downloaded in the Parrel portal.`);
50
+ }
51
+ function entryUnsafe(file, entry, reason) {
52
+ return new ParrelError("SD05000027", `The backup ${file} has an entry that cannot be unpacked safely: "${entry}" ${reason}. Use a .parrel backup made by Ledger, without changes.`);
53
+ }
54
+ function tooLarge(file, reason) {
55
+ return new ParrelError("SD05000028", `The backup ${file} is too large to seed: ${reason}. A backup can hold at most 100000 entries, 16 MiB per map or resource and 2 GiB in total.`);
56
+ }
57
+ /** The printable form of an entry name for a message: control and non-ASCII characters escaped. */
58
+ function printable(name) {
59
+ return name.replace(/[^\x20-\x7e]/g, (char) => `\\u${char.charCodeAt(0).toString(16).padStart(4, "0")}`);
60
+ }
61
+ /**
62
+ * Checks the name of one entry against the rules of the format ("Entry names are safe") and returns its folder and
63
+ * name. Throws `SD05000027` for anything else.
64
+ *
65
+ * @example
66
+ * ```ts
67
+ * parseEntryName("b.parrel", "maps/page.json"); // { folder: "maps", name: "page" }
68
+ * parseEntryName("b.parrel", "../x"); // throws SD05000027
69
+ * ```
70
+ */
71
+ export function parseEntryName(file, path) {
72
+ if (path === "manifest.json") {
73
+ return { folder: undefined, name: path };
74
+ }
75
+ const shown = printable(path);
76
+ const parts = path.split("/");
77
+ if (parts.length !== 2 || !FOLDERS.has(parts[0])) {
78
+ throw entryUnsafe(file, shown, "is not in the folder maps/, content/ or media/");
79
+ }
80
+ const folder = parts[0];
81
+ const segment = parts[1];
82
+ if (segment === "") {
83
+ throw entryUnsafe(file, shown, "is a folder entry, which a bundle never has");
84
+ }
85
+ const json = folder === "maps" || folder === "content";
86
+ const name = json && segment.endsWith(".json") ? segment.slice(0, -".json".length) : segment;
87
+ if (name.length < 1 || name.length > NAME_MAX) {
88
+ throw entryUnsafe(file, shown, `has a name that is not 1 to ${NAME_MAX} characters long`);
89
+ }
90
+ if (!/^[A-Za-z0-9]/.test(name) || name.includes("..") || !NAME_CHARS[folder].test(name)) {
91
+ throw entryUnsafe(file, shown, "has a name with characters that a bundle never uses");
92
+ }
93
+ if ((folder === "maps" || folder === "media") && WINDOWS_DEVICE.test(name.replace(/\..*$/, ""))) {
94
+ throw entryUnsafe(file, shown, "has the name of a Windows device");
95
+ }
96
+ return { folder, name };
97
+ }
98
+ async function readAt(handle, position, length) {
99
+ const buffer = Buffer.alloc(length);
100
+ const { bytesRead } = await handle.read(buffer, 0, length, position);
101
+ return buffer.subarray(0, bytesRead);
102
+ }
103
+ const CRC_TABLE = (() => {
104
+ const table = new Uint32Array(256);
105
+ for (let n = 0; n < 256; n++) {
106
+ let c = n;
107
+ for (let k = 0; k < 8; k++) {
108
+ c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
109
+ }
110
+ table[n] = c >>> 0;
111
+ }
112
+ return table;
113
+ })();
114
+ /** Counts the unpacked bytes and their CRC-32, and stops at the first byte over `limit`. */
115
+ class Counter extends Transform {
116
+ limit;
117
+ onOver;
118
+ bytes = 0;
119
+ crc = 0xffffffff;
120
+ constructor(limit, onOver) {
121
+ super();
122
+ this.limit = limit;
123
+ this.onOver = onOver;
124
+ }
125
+ _transform(chunk, _encoding, callback) {
126
+ this.bytes += chunk.length;
127
+ if (this.bytes > this.limit) {
128
+ callback(this.onOver());
129
+ return;
130
+ }
131
+ let crc = this.crc;
132
+ for (let i = 0; i < chunk.length; i++) {
133
+ crc = CRC_TABLE[(crc ^ chunk[i]) & 0xff] ^ (crc >>> 8);
134
+ }
135
+ this.crc = crc;
136
+ callback(null, chunk);
137
+ }
138
+ get crc32() {
139
+ return (this.crc ^ 0xffffffff) >>> 0;
140
+ }
141
+ }
142
+ const states = new WeakMap();
143
+ /** Where the packed bytes of an entry start, read from its local header. */
144
+ async function dataOffset(state, file, entry) {
145
+ const header = await readAt(state.handle, entry.localHeaderOffset, 30);
146
+ if (header.length < 30 || header.readUInt32LE(0) !== LOCAL_SIGNATURE) {
147
+ throw notABundle(file, `the entry "${entry.path}" has no local header`);
148
+ }
149
+ const start = entry.localHeaderOffset + 30 + header.readUInt16LE(26) + header.readUInt16LE(28);
150
+ if (start + entry.compressedSize > state.size) {
151
+ throw notABundle(file, `the entry "${entry.path}" goes past the end of the file`);
152
+ }
153
+ return start;
154
+ }
155
+ /**
156
+ * Unpacks one entry into `sink`, counting the bytes and checking them against `limit`, the size and the CRC-32 that
157
+ * the zip gives. Returns the number of unpacked bytes.
158
+ */
159
+ async function unpack(state, file, entry, limit, onOver, sink) {
160
+ const start = await dataOffset(state, file, entry);
161
+ const counter = new Counter(limit, onOver);
162
+ const source = Readable.from(packedChunks(state.handle, start, entry.compressedSize));
163
+ try {
164
+ if (entry.method === 8) {
165
+ await pipeline(source, createInflateRaw(), counter, sink);
166
+ }
167
+ else {
168
+ await pipeline(source, counter, sink);
169
+ }
170
+ }
171
+ catch (error) {
172
+ if (error instanceof ParrelError) {
173
+ throw error;
174
+ }
175
+ throw notABundle(file, `the entry "${entry.path}" cannot be unpacked`);
176
+ }
177
+ if (counter.bytes !== entry.uncompressedSize || counter.crc32 !== entry.crc32) {
178
+ throw notABundle(file, `the entry "${entry.path}" is damaged`);
179
+ }
180
+ return counter.bytes;
181
+ }
182
+ /** The packed bytes of an entry, read in chunks of 64 KiB. */
183
+ async function* packedChunks(handle, start, length) {
184
+ for (let done = 0; done < length;) {
185
+ const chunk = await readAt(handle, start + done, Math.min(READ_CHUNK, length - done));
186
+ if (chunk.length === 0) {
187
+ return;
188
+ }
189
+ done += chunk.length;
190
+ yield chunk;
191
+ }
192
+ }
193
+ /** A writable that keeps the bytes in memory. */
194
+ function collector() {
195
+ const chunks = [];
196
+ return {
197
+ sink: new Writable({
198
+ write(chunk, _encoding, callback) {
199
+ chunks.push(chunk);
200
+ callback();
201
+ },
202
+ }),
203
+ bytes: () => Buffer.concat(chunks),
204
+ };
205
+ }
206
+ /** A writable that drops the bytes. */
207
+ function discard() {
208
+ return new Writable({
209
+ write(_chunk, _encoding, callback) {
210
+ callback();
211
+ },
212
+ });
213
+ }
214
+ function jsonLimitError(file, entry, limits) {
215
+ return () => tooLarge(file, `the entry "${entry.path}" unpacks to more than ${limits.maxJsonEntryBytes} bytes`);
216
+ }
217
+ /** Reads the central directory: every entry with its name, method, sizes and offset. */
218
+ async function readCentralDirectory(handle, size, file, limits) {
219
+ if (size < EOCD_SIZE) {
220
+ throw notABundle(file, "it is not a zip file");
221
+ }
222
+ const tailLength = Math.min(size, EOCD_SIZE + MAX_COMMENT);
223
+ const tail = await readAt(handle, size - tailLength, tailLength);
224
+ let eocd = -1;
225
+ for (let i = tail.length - EOCD_SIZE; i >= 0; i--) {
226
+ if (tail.readUInt32LE(i) === EOCD_SIGNATURE && i + EOCD_SIZE + tail.readUInt16LE(i + 20) === tail.length) {
227
+ eocd = i;
228
+ break;
229
+ }
230
+ }
231
+ if (eocd < 0) {
232
+ throw notABundle(file, "it is not a zip file");
233
+ }
234
+ if (eocd >= 20 && tail.readUInt32LE(eocd - 20) === ZIP64_LOCATOR_SIGNATURE) {
235
+ throw notABundle(file, "it is a zip64 file, which a bundle never is");
236
+ }
237
+ const disk = tail.readUInt16LE(eocd + 4);
238
+ const cdDisk = tail.readUInt16LE(eocd + 6);
239
+ const onDisk = tail.readUInt16LE(eocd + 8);
240
+ const total = tail.readUInt16LE(eocd + 10);
241
+ const cdSize = tail.readUInt32LE(eocd + 12);
242
+ const cdOffset = tail.readUInt32LE(eocd + 16);
243
+ if (total === 0xffff || cdSize === 0xffffffff || cdOffset === 0xffffffff) {
244
+ throw notABundle(file, "it is a zip64 file, which a bundle never is");
245
+ }
246
+ if (disk !== 0 || cdDisk !== 0 || onDisk !== total) {
247
+ throw notABundle(file, "it is a zip split over several files");
248
+ }
249
+ if (total > limits.maxEntries) {
250
+ throw tooLarge(file, `it has ${total} entries, more than ${limits.maxEntries}`);
251
+ }
252
+ if (cdOffset + cdSize > size - tailLength + eocd) {
253
+ throw notABundle(file, "its central directory is damaged");
254
+ }
255
+ const directory = await readAt(handle, cdOffset, cdSize);
256
+ const entries = [];
257
+ let offset = 0;
258
+ for (let i = 0; i < total; i++) {
259
+ if (offset + 46 > directory.length || directory.readUInt32LE(offset) !== CENTRAL_SIGNATURE) {
260
+ throw notABundle(file, "its central directory is damaged");
261
+ }
262
+ const flags = directory.readUInt16LE(offset + 8);
263
+ const methodRaw = directory.readUInt16LE(offset + 10);
264
+ const crc32 = directory.readUInt32LE(offset + 16);
265
+ const compressedSize = directory.readUInt32LE(offset + 20);
266
+ const uncompressedSize = directory.readUInt32LE(offset + 24);
267
+ const nameLength = directory.readUInt16LE(offset + 28);
268
+ const extraLength = directory.readUInt16LE(offset + 30);
269
+ const commentLength = directory.readUInt16LE(offset + 32);
270
+ const localHeaderOffset = directory.readUInt32LE(offset + 42);
271
+ const end = offset + 46 + nameLength + extraLength + commentLength;
272
+ if (end > directory.length) {
273
+ throw notABundle(file, "its central directory is damaged");
274
+ }
275
+ const path = directory.toString("latin1", offset + 46, offset + 46 + nameLength);
276
+ const extra = directory.subarray(offset + 46 + nameLength, offset + 46 + nameLength + extraLength);
277
+ for (let e = 0; e + 4 <= extra.length; e += 4 + extra.readUInt16LE(e + 2)) {
278
+ if (extra.readUInt16LE(e) === ZIP64_EXTRA_ID) {
279
+ throw notABundle(file, `the entry "${printable(path)}" uses zip64, which a bundle never does`);
280
+ }
281
+ }
282
+ if (compressedSize === 0xffffffff || uncompressedSize === 0xffffffff || localHeaderOffset === 0xffffffff) {
283
+ throw notABundle(file, `the entry "${printable(path)}" uses zip64, which a bundle never does`);
284
+ }
285
+ entries.push({ path, method: 0, crc32, compressedSize, uncompressedSize, localHeaderOffset, flags, methodRaw });
286
+ offset = end;
287
+ }
288
+ return entries;
289
+ }
290
+ function isObject(value) {
291
+ return value !== null && typeof value === "object" && !Array.isArray(value);
292
+ }
293
+ function checkManifest(file, value) {
294
+ if (!isObject(value)) {
295
+ throw formatUnsupported(file, "manifest.json is not a JSON object");
296
+ }
297
+ if (value.format !== "parrel-bundle") {
298
+ throw formatUnsupported(file, `the format is ${JSON.stringify(value.format)}, not "parrel-bundle"`);
299
+ }
300
+ if (value.version !== 1) {
301
+ throw formatUnsupported(file, `the format version is ${JSON.stringify(value.version)}, not 1`);
302
+ }
303
+ if (value.serviceType !== "LEDGER") {
304
+ throw formatUnsupported(file, `the service type is ${JSON.stringify(value.serviceType)}, not "LEDGER"`);
305
+ }
306
+ const counts = value.counts;
307
+ if (!isObject(counts) ||
308
+ !["maps", "content", "media"].every((key) => Number.isInteger(counts[key]) && counts[key] >= 0)) {
309
+ throw formatUnsupported(file, "manifest.json has no valid counts");
310
+ }
311
+ return value;
312
+ }
313
+ /**
314
+ * Opens a `.parrel` bundle and checks it as a whole, in this order, before anything is written anywhere: the file is a
315
+ * zip whose central directory can be read (no zip64, no encryption, only stored and deflate), it has at most
316
+ * `maxEntries` entries, `manifest.json` is a Ledger bundle of version 1, every name is safe, unique and does not
317
+ * collide with another name by case, `counts` match the entries, every map and content entry ends in `.json` and is
318
+ * JSON (a map is an object), and every entry unpacks within the limits with the size and CRC-32 of the zip. Entries
319
+ * in `extras/` are only checked for a safe, unique name; they are never unpacked.
320
+ *
321
+ * Throws a `ParrelError`: `SD05000024` (no such file), `SD05000025` (not a zip, damaged, or counts that do not
322
+ * match), `SD05000026` (not a Ledger bundle of version 1), `SD05000027` (an unsafe or duplicate name) or
323
+ * `SD05000028` (over a limit).
324
+ *
325
+ * @example
326
+ * ```ts
327
+ * const bundle = await openBundle("Ab3xYz9_kQ1w-20261007.parrel");
328
+ * try {
329
+ * console.log(bundle.manifest.counts);
330
+ * } finally {
331
+ * await bundle.close();
332
+ * }
333
+ * ```
334
+ */
335
+ export async function openBundle(file, limits = DEFAULT_BUNDLE_LIMITS) {
336
+ let size;
337
+ try {
338
+ const info = await stat(file);
339
+ if (!info.isFile()) {
340
+ throw new Error("not a file");
341
+ }
342
+ size = info.size;
343
+ }
344
+ catch {
345
+ throw new ParrelError("SD05000024", `The file ${file} does not exist or is not a file. Download the backup of your Ledger service in the Parrel portal and pass its path: npx parrel ledger seed <file.parrel>.`);
346
+ }
347
+ const handle = await open(file, "r");
348
+ const state = { handle, size, limits };
349
+ const bundle = {
350
+ file,
351
+ manifest: undefined,
352
+ maps: [],
353
+ content: [],
354
+ media: [],
355
+ extrasSkipped: 0,
356
+ unpackedBytes: 0,
357
+ close: () => handle.close(),
358
+ };
359
+ states.set(bundle, state);
360
+ try {
361
+ await check(bundle, state);
362
+ return bundle;
363
+ }
364
+ catch (error) {
365
+ await handle.close();
366
+ throw error;
367
+ }
368
+ }
369
+ async function check(bundle, state) {
370
+ const { file } = bundle;
371
+ const { limits } = state;
372
+ const raw = await readCentralDirectory(state.handle, state.size, file, limits);
373
+ for (const entry of raw) {
374
+ if (entry.flags & (FLAG_ENCRYPTED | FLAG_STRONG_ENCRYPTION)) {
375
+ throw notABundle(file, `the entry "${printable(entry.path)}" is encrypted, which a bundle never is`);
376
+ }
377
+ if (entry.methodRaw !== 0 && entry.methodRaw !== 8) {
378
+ throw notABundle(file, `the entry "${printable(entry.path)}" uses compression method ${entry.methodRaw}`);
379
+ }
380
+ }
381
+ const manifestEntry = raw.find((entry) => entry.path === "manifest.json");
382
+ if (!manifestEntry) {
383
+ throw formatUnsupported(file, "it has no manifest.json");
384
+ }
385
+ const toEntry = (entry, folder, name) => ({
386
+ path: entry.path,
387
+ folder,
388
+ name,
389
+ method: entry.methodRaw,
390
+ crc32: entry.crc32,
391
+ compressedSize: entry.compressedSize,
392
+ uncompressedSize: entry.uncompressedSize,
393
+ localHeaderOffset: entry.localHeaderOffset,
394
+ });
395
+ const manifestBytes = await readEntryBytes(state, file, toEntry(manifestEntry, undefined, "manifest.json"));
396
+ let manifestValue;
397
+ try {
398
+ manifestValue = JSON.parse(manifestBytes.toString("utf8"));
399
+ }
400
+ catch {
401
+ throw formatUnsupported(file, "manifest.json is not valid JSON");
402
+ }
403
+ bundle.manifest = checkManifest(file, manifestValue);
404
+ bundle.unpackedBytes += manifestBytes.length;
405
+ const seen = new Set();
406
+ const seenByCase = new Map();
407
+ for (const entry of raw) {
408
+ const { folder, name } = parseEntryName(file, entry.path);
409
+ if (seen.has(entry.path)) {
410
+ throw entryUnsafe(file, printable(entry.path), "appears twice");
411
+ }
412
+ seen.add(entry.path);
413
+ if (folder === "maps" || folder === "media") {
414
+ const key = entry.path.toLowerCase();
415
+ const other = seenByCase.get(key);
416
+ if (other !== undefined) {
417
+ throw entryUnsafe(file, printable(entry.path), `differs from "${printable(other)}" only in case, so they would be one file on Windows and macOS`);
418
+ }
419
+ seenByCase.set(key, entry.path);
420
+ }
421
+ if (folder === undefined) {
422
+ continue;
423
+ }
424
+ if (folder === "extras") {
425
+ bundle.extrasSkipped++;
426
+ continue;
427
+ }
428
+ bundle[folder].push(toEntry(entry, folder, name));
429
+ }
430
+ const { counts } = bundle.manifest;
431
+ for (const folder of ["maps", "content", "media"]) {
432
+ if (counts[folder] !== bundle[folder].length) {
433
+ throw notABundle(file, `manifest.json counts ${counts[folder]} ${folder} entries, but the zip has ${bundle[folder].length}`);
434
+ }
435
+ bundle[folder].sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
436
+ }
437
+ for (const entry of [...bundle.maps, ...bundle.content]) {
438
+ if (!entry.path.endsWith(".json")) {
439
+ throw notABundle(file, `the entry "${entry.path}" is not a .json file`);
440
+ }
441
+ const bytes = await readEntryBytes(state, file, entry);
442
+ spend(bundle, state, bytes.length);
443
+ let value;
444
+ try {
445
+ value = JSON.parse(bytes.toString("utf8"));
446
+ }
447
+ catch {
448
+ throw notABundle(file, `the entry "${entry.path}" is not valid JSON`);
449
+ }
450
+ if (entry.folder === "maps" && !isObject(value)) {
451
+ throw notABundle(file, `the map "${entry.path}" is not a JSON object`);
452
+ }
453
+ }
454
+ for (const entry of bundle.media) {
455
+ const remaining = limits.maxTotalBytes - bundle.unpackedBytes;
456
+ const bytes = await unpack(state, file, entry, remaining, totalOver(file, limits), discard());
457
+ spend(bundle, state, bytes);
458
+ }
459
+ }
460
+ function totalOver(file, limits) {
461
+ return () => tooLarge(file, `it unpacks to more than ${limits.maxTotalBytes} bytes`);
462
+ }
463
+ function spend(bundle, state, bytes) {
464
+ bundle.unpackedBytes += bytes;
465
+ if (bundle.unpackedBytes > state.limits.maxTotalBytes) {
466
+ throw totalOver(bundle.file, state.limits)();
467
+ }
468
+ }
469
+ async function readEntryBytes(state, file, entry) {
470
+ const { sink, bytes } = collector();
471
+ await unpack(state, file, entry, state.limits.maxJsonEntryBytes, jsonLimitError(file, entry, state.limits), sink);
472
+ return bytes();
473
+ }
474
+ function stateOf(bundle) {
475
+ const state = states.get(bundle);
476
+ if (!state) {
477
+ throw new TypeError("This bundle was not opened with openBundle().");
478
+ }
479
+ return state;
480
+ }
481
+ /**
482
+ * Reads one map or content entry of an open bundle as its raw bytes (at most 16 MiB).
483
+ *
484
+ * @example
485
+ * ```ts
486
+ * const bytes = await readEntry(bundle, bundle.maps[0]);
487
+ * await writeFile("maps/page.json", bytes);
488
+ * ```
489
+ */
490
+ export async function readEntry(bundle, entry) {
491
+ return readEntryBytes(stateOf(bundle), bundle.file, entry);
492
+ }
493
+ /**
494
+ * Reads one map or content entry of an open bundle and parses it as JSON.
495
+ *
496
+ * @example
497
+ * ```ts
498
+ * const homepage = await readJsonEntry(bundle, bundle.content[0]);
499
+ * ```
500
+ */
501
+ export async function readJsonEntry(bundle, entry) {
502
+ return JSON.parse((await readEntry(bundle, entry)).toString("utf8"));
503
+ }
504
+ /**
505
+ * Streams one entry of an open bundle to the file `target`, without holding it in memory.
506
+ *
507
+ * @example
508
+ * ```ts
509
+ * for (const entry of bundle.media) {
510
+ * await extractEntry(bundle, entry, path.join(mediaDir, entry.name));
511
+ * }
512
+ * ```
513
+ */
514
+ export async function extractEntry(bundle, entry, target) {
515
+ const state = stateOf(bundle);
516
+ await unpack(state, bundle.file, entry, state.limits.maxTotalBytes, totalOver(bundle.file, state.limits), createWriteStream(target));
517
+ }
518
+ //# sourceMappingURL=bundle-reader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bundle-reader.js","sourceRoot":"","sources":["../../../src/cli/utils/bundle-reader.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Collision Detector - Validates flat schema names
3
+ */
4
+ /**
5
+ * Convert filename to camelCase resource name
6
+ * Example: "home-page.json" -> "homePage"
7
+ */
8
+ export declare function filenameToCamelCase(filename: string): string;
9
+ /**
10
+ * Check for collisions in flat schema names
11
+ * Example: "homePage.json" + "home-page.json" both map to ledgerClient.homePage -> ERROR
12
+ *
13
+ * Returns array of errors if collisions found
14
+ */
15
+ export declare function detectCollisions(schemaNames: string[]): string[];
16
+ /**
17
+ * Validate that all schema names are flat (no nested directories)
18
+ * Example: "homepage.json" ✓, "home/header.json" ✗
19
+ */
20
+ export declare function validateFlatNames(schemaNames: string[]): string[];
21
+ //# sourceMappingURL=collision-detector.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"collision-detector.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/collision-detector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM5D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAuBhE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAYjE"}
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Collision Detector - Validates flat schema names
3
+ */
4
+ /**
5
+ * Convert filename to camelCase resource name
6
+ * Example: "home-page.json" -> "homePage"
7
+ */
8
+ export function filenameToCamelCase(filename) {
9
+ return filename
10
+ .replace(/\.json$/, "")
11
+ .split(/[-_]/)
12
+ .map((part, i) => (i === 0 ? part.toLowerCase() : part.charAt(0).toUpperCase() + part.slice(1)))
13
+ .join("");
14
+ }
15
+ /**
16
+ * Check for collisions in flat schema names
17
+ * Example: "homePage.json" + "home-page.json" both map to ledgerClient.homePage -> ERROR
18
+ *
19
+ * Returns array of errors if collisions found
20
+ */
21
+ export function detectCollisions(schemaNames) {
22
+ const errors = [];
23
+ const camelCaseMap = new Map();
24
+ // Build map of camelCase -> original filenames
25
+ for (const name of schemaNames) {
26
+ const camelCase = filenameToCamelCase(name);
27
+ if (!camelCaseMap.has(camelCase)) {
28
+ camelCaseMap.set(camelCase, []);
29
+ }
30
+ camelCaseMap.get(camelCase).push(name);
31
+ }
32
+ // Check for collisions
33
+ for (const [camelCase, filenames] of camelCaseMap.entries()) {
34
+ if (filenames.length > 1) {
35
+ errors.push(`[parrel] Collision detected: ${filenames.map((f) => `${f}.json`).join(", ")} all map to ledgerClient.${camelCase}. Schema names must be unique after converting to camelCase.`);
36
+ }
37
+ }
38
+ return errors;
39
+ }
40
+ /**
41
+ * Validate that all schema names are flat (no nested directories)
42
+ * Example: "homepage.json" ✓, "home/header.json" ✗
43
+ */
44
+ export function validateFlatNames(schemaNames) {
45
+ const errors = [];
46
+ for (const name of schemaNames) {
47
+ if (name.includes("/") || name.includes("\\")) {
48
+ errors.push(`[parrel] Invalid schema path: ${name}. Nested paths (e.g., home/header.json) are not supported. Use flat names only (e.g., homeHeader.json).`);
49
+ }
50
+ }
51
+ return errors;
52
+ }
53
+ //# sourceMappingURL=collision-detector.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"collision-detector.js","sourceRoot":"","sources":["../../../src/cli/utils/collision-detector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IACnD,OAAO,QAAQ;SACb,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,KAAK,CAAC,MAAM,CAAC;SACb,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;SAC/F,IAAI,CAAC,EAAE,CAAC,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAqB;IACrD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEjD,+CAA+C;IAC/C,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,YAAY,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,uBAAuB;IACvB,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;QAC7D,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CACV,gCAAgC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,4BAA4B,SAAS,8DAA8D,CAC/K,CAAC;QACH,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAqB;IACtD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CACV,iCAAiC,IAAI,yGAAyG,CAC9I,CAAC;QACH,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}