@inventarch/distribution 0.0.0-stage → 1.0.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 (166) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +4 -0
  3. package/README.md +2 -2
  4. package/SPEC.md +3 -0
  5. package/assets/host-launcher.mjs +167 -0
  6. package/dist/acquire.d.ts +13 -0
  7. package/dist/acquire.d.ts.map +1 -0
  8. package/dist/acquire.js +46 -0
  9. package/dist/acquire.js.map +1 -0
  10. package/dist/archive.d.ts +20 -0
  11. package/dist/archive.d.ts.map +1 -0
  12. package/dist/archive.js +158 -0
  13. package/dist/archive.js.map +1 -0
  14. package/dist/authoring-assets.d.ts +11 -0
  15. package/dist/authoring-assets.d.ts.map +1 -0
  16. package/dist/authoring-assets.js +251 -0
  17. package/dist/authoring-assets.js.map +1 -0
  18. package/dist/bounded-fetch.d.ts +17 -0
  19. package/dist/bounded-fetch.d.ts.map +1 -0
  20. package/dist/bounded-fetch.js +67 -0
  21. package/dist/bounded-fetch.js.map +1 -0
  22. package/dist/cli.d.ts +3 -0
  23. package/dist/cli.d.ts.map +1 -0
  24. package/dist/cli.js +29 -0
  25. package/dist/cli.js.map +1 -0
  26. package/dist/command.d.ts +6 -0
  27. package/dist/command.d.ts.map +1 -0
  28. package/dist/command.js +189 -0
  29. package/dist/command.js.map +1 -0
  30. package/dist/config.d.ts +4 -0
  31. package/dist/config.d.ts.map +1 -0
  32. package/dist/config.js +43 -0
  33. package/dist/config.js.map +1 -0
  34. package/dist/decisions.d.ts +26 -0
  35. package/dist/decisions.d.ts.map +1 -0
  36. package/dist/decisions.js +119 -0
  37. package/dist/decisions.js.map +1 -0
  38. package/dist/files.d.ts +38 -0
  39. package/dist/files.d.ts.map +1 -0
  40. package/dist/files.js +224 -0
  41. package/dist/files.js.map +1 -0
  42. package/dist/guard-registration.d.ts +95 -0
  43. package/dist/guard-registration.d.ts.map +1 -0
  44. package/dist/guard-registration.js +282 -0
  45. package/dist/guard-registration.js.map +1 -0
  46. package/dist/host-home.d.ts +33 -0
  47. package/dist/host-home.d.ts.map +1 -0
  48. package/dist/host-home.js +116 -0
  49. package/dist/host-home.js.map +1 -0
  50. package/dist/host-modes.d.ts +13 -0
  51. package/dist/host-modes.d.ts.map +1 -0
  52. package/dist/host-modes.js +36 -0
  53. package/dist/host-modes.js.map +1 -0
  54. package/dist/host-observe.d.ts +24 -0
  55. package/dist/host-observe.d.ts.map +1 -0
  56. package/dist/host-observe.js +233 -0
  57. package/dist/host-observe.js.map +1 -0
  58. package/dist/host.d.ts +100 -0
  59. package/dist/host.d.ts.map +1 -0
  60. package/dist/host.js +505 -0
  61. package/dist/host.js.map +1 -0
  62. package/dist/hosts.d.ts +66 -0
  63. package/dist/hosts.d.ts.map +1 -0
  64. package/dist/hosts.js +39 -0
  65. package/dist/hosts.js.map +1 -0
  66. package/dist/ia-home.d.ts +15 -0
  67. package/dist/ia-home.d.ts.map +1 -0
  68. package/dist/ia-home.js +101 -0
  69. package/dist/ia-home.js.map +1 -0
  70. package/dist/install.d.ts +56 -0
  71. package/dist/install.d.ts.map +1 -0
  72. package/dist/install.js +402 -0
  73. package/dist/install.js.map +1 -0
  74. package/dist/installation-core.d.ts +41 -0
  75. package/dist/installation-core.d.ts.map +1 -0
  76. package/dist/installation-core.js +163 -0
  77. package/dist/installation-core.js.map +1 -0
  78. package/dist/inventory.d.ts +3 -0
  79. package/dist/inventory.d.ts.map +1 -0
  80. package/dist/inventory.js +49 -0
  81. package/dist/inventory.js.map +1 -0
  82. package/dist/json-edit.d.ts +19 -0
  83. package/dist/json-edit.d.ts.map +1 -0
  84. package/dist/json-edit.js +81 -0
  85. package/dist/json-edit.js.map +1 -0
  86. package/dist/lifecycle-registration.d.ts +46 -0
  87. package/dist/lifecycle-registration.d.ts.map +1 -0
  88. package/dist/lifecycle-registration.js +332 -0
  89. package/dist/lifecycle-registration.js.map +1 -0
  90. package/dist/minting.d.ts +46 -0
  91. package/dist/minting.d.ts.map +1 -0
  92. package/dist/minting.js +192 -0
  93. package/dist/minting.js.map +1 -0
  94. package/dist/native-command.d.ts +6 -0
  95. package/dist/native-command.d.ts.map +1 -0
  96. package/dist/native-command.js +273 -0
  97. package/dist/native-command.js.map +1 -0
  98. package/dist/pack.d.ts +4 -0
  99. package/dist/pack.d.ts.map +1 -0
  100. package/dist/pack.js +30 -0
  101. package/dist/pack.js.map +1 -0
  102. package/dist/plugin-home.d.ts +45 -0
  103. package/dist/plugin-home.d.ts.map +1 -0
  104. package/dist/plugin-home.js +371 -0
  105. package/dist/plugin-home.js.map +1 -0
  106. package/dist/projection.d.ts +45 -0
  107. package/dist/projection.d.ts.map +1 -0
  108. package/dist/projection.js +218 -0
  109. package/dist/projection.js.map +1 -0
  110. package/dist/publication.d.ts +20 -0
  111. package/dist/publication.d.ts.map +1 -0
  112. package/dist/publication.js +284 -0
  113. package/dist/publication.js.map +1 -0
  114. package/dist/registry-admission.d.ts +5 -0
  115. package/dist/registry-admission.d.ts.map +1 -0
  116. package/dist/registry-admission.js +17 -0
  117. package/dist/registry-admission.js.map +1 -0
  118. package/dist/registry-build.d.ts +35 -0
  119. package/dist/registry-build.d.ts.map +1 -0
  120. package/dist/registry-build.js +156 -0
  121. package/dist/registry-build.js.map +1 -0
  122. package/dist/registry-config.d.ts +32 -0
  123. package/dist/registry-config.d.ts.map +1 -0
  124. package/dist/registry-config.js +191 -0
  125. package/dist/registry-config.js.map +1 -0
  126. package/dist/registry-layout.d.ts +41 -0
  127. package/dist/registry-layout.d.ts.map +1 -0
  128. package/dist/registry-layout.js +142 -0
  129. package/dist/registry-layout.js.map +1 -0
  130. package/dist/registry-resolve.d.ts +56 -0
  131. package/dist/registry-resolve.d.ts.map +1 -0
  132. package/dist/registry-resolve.js +406 -0
  133. package/dist/registry-resolve.js.map +1 -0
  134. package/dist/registry-source.d.ts +37 -0
  135. package/dist/registry-source.d.ts.map +1 -0
  136. package/dist/registry-source.js +101 -0
  137. package/dist/registry-source.js.map +1 -0
  138. package/dist/registry.d.ts +10 -0
  139. package/dist/registry.d.ts.map +1 -0
  140. package/dist/registry.js +6 -0
  141. package/dist/registry.js.map +1 -0
  142. package/dist/resolve.d.ts +31 -0
  143. package/dist/resolve.d.ts.map +1 -0
  144. package/dist/resolve.js +115 -0
  145. package/dist/resolve.js.map +1 -0
  146. package/dist/services.d.ts +179 -0
  147. package/dist/services.d.ts.map +1 -0
  148. package/dist/services.js +290 -0
  149. package/dist/services.js.map +1 -0
  150. package/dist/snapshot.d.ts +19 -0
  151. package/dist/snapshot.d.ts.map +1 -0
  152. package/dist/snapshot.js +309 -0
  153. package/dist/snapshot.js.map +1 -0
  154. package/dist/transfer.d.ts +22 -0
  155. package/dist/transfer.d.ts.map +1 -0
  156. package/dist/transfer.js +98 -0
  157. package/dist/transfer.js.map +1 -0
  158. package/dist/updates.d.ts +57 -0
  159. package/dist/updates.d.ts.map +1 -0
  160. package/dist/updates.js +174 -0
  161. package/dist/updates.js.map +1 -0
  162. package/dist/ustar.d.ts +28 -0
  163. package/dist/ustar.d.ts.map +1 -0
  164. package/dist/ustar.js +145 -0
  165. package/dist/ustar.js.map +1 -0
  166. package/package.json +305 -3
@@ -0,0 +1,174 @@
1
+ import { spawnSync } from 'node:child_process';
2
+ import { SUPPORTED_VERSIONS } from '@inventarch/language';
3
+ import { readHomeFile, writeHomeFile } from './ia-home.js';
4
+ /** Host plugin distribution spec §11 and Amendment item 4. Public layer only: `account` is written by the private layer and kept as found; `nudgedOn` lives in the hook's plugin data, never here. */
5
+ export const UPDATE_CHECK = 'state/update-check.json';
6
+ export const IA_CONFIG = 'config.json';
7
+ export const UPDATE_CHANNELS = ['checkout', 'npm', 'unknown'];
8
+ const DAY = 24 * 3600 * 1000;
9
+ const record = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
10
+ /** The cached check, or null when it is absent, unreadable or not this schema. Never throws and never writes. */
11
+ export function readUpdateCheck(home) {
12
+ try {
13
+ const text = readHomeFile(home, UPDATE_CHECK), value = text === null ? null : JSON.parse(text);
14
+ if (!record(value) ||
15
+ value['schema'] !== 'ia.update-check.v1' ||
16
+ typeof value['checkedAt'] !== 'string' ||
17
+ Number.isNaN(Date.parse(value['checkedAt'])) ||
18
+ !record(value['cli']))
19
+ return null;
20
+ const cli = value['cli'], account = record(value['account']) ? value['account'] : undefined, notices = account !== undefined && Array.isArray(account['notices'])
21
+ ? account['notices'].filter((n) => typeof n === 'string')
22
+ : undefined;
23
+ if (typeof cli['channel'] !== 'string' || typeof cli['current'] !== 'string' || typeof cli['checked'] !== 'boolean')
24
+ return null;
25
+ return {
26
+ schema: 'ia.update-check.v1',
27
+ checkedAt: value['checkedAt'],
28
+ cli: {
29
+ channel: cli['channel'],
30
+ current: cli['current'],
31
+ latest: typeof cli['latest'] === 'string' ? cli['latest'] : null,
32
+ behind: typeof cli['behind'] === 'number' && Number.isInteger(cli['behind']) && cli['behind'] >= 0
33
+ ? cli['behind']
34
+ : null,
35
+ checked: cli['checked'],
36
+ },
37
+ packages: { checked: false },
38
+ ...(account === undefined ? {} : { account: notices === undefined ? {} : { notices } }),
39
+ };
40
+ }
41
+ catch {
42
+ return null;
43
+ }
44
+ }
45
+ /** `~/.ia/config.json`, or null when it is absent or unreadable. Never throws and never writes. */
46
+ export function readIaConfig(home) {
47
+ try {
48
+ const text = readHomeFile(home, IA_CONFIG), value = text === null ? null : JSON.parse(text);
49
+ return record(value)
50
+ ? typeof value['updateCheck'] === 'boolean'
51
+ ? { updateCheck: value['updateCheck'] }
52
+ : {}
53
+ : null;
54
+ }
55
+ catch {
56
+ return null;
57
+ }
58
+ }
59
+ /** §11.1: at most once per 24 h. A timestamp that does not parse, or lies in the future, is due. */
60
+ export const refreshDue = (check, now) => {
61
+ if (check === null)
62
+ return true;
63
+ const age = now.getTime() - Date.parse(check.checkedAt);
64
+ return !(age >= 0 && age < DAY);
65
+ };
66
+ /** §11.1: `IA_NO_UPDATE_CHECK=1`, a non-empty `CI`, or `updateCheck: false` in the IA home's config.json. */
67
+ export const updateCheckDisabled = (env, config) => env['IA_NO_UPDATE_CHECK'] === '1' || (env['CI'] ?? '') !== '' || config?.updateCheck === false;
68
+ /** npm's package-name grammar; the name reaches a shell on Windows, so anything else is never looked up. */
69
+ const NPM_NAME = /^(?:@[a-z0-9][a-z0-9._~-]*\/)?[a-z0-9][a-z0-9._~-]*$/;
70
+ export const liveSources = {
71
+ // One command string with `shell: true`: npm is npm.cmd on Windows, and an argument array beside a shell is DEP0190.
72
+ npm: (name) => {
73
+ if (!NPM_NAME.test(name))
74
+ return null;
75
+ const r = spawnSync(`npm view ${name} dist-tags.latest --json`, {
76
+ shell: true,
77
+ encoding: 'utf8',
78
+ timeout: 15000,
79
+ windowsHide: true,
80
+ });
81
+ try {
82
+ const v = r.status === 0 ? JSON.parse(r.stdout) : null;
83
+ return typeof v === 'string' ? v : null;
84
+ }
85
+ catch {
86
+ return null;
87
+ }
88
+ },
89
+ git: (cwd, args) => {
90
+ const r = spawnSync('git', ['--no-optional-locks', '-C', cwd, ...args], {
91
+ encoding: 'utf8',
92
+ timeout: 5000,
93
+ windowsHide: true,
94
+ });
95
+ return r.status === 0 ? r.stdout.trim() : null;
96
+ },
97
+ };
98
+ /** §11.1: one refresh. npm is asked only for the npm channel; a checkout is counted against its upstream as of the last fetch, and nothing fetches. An unavailable source is `checked: false`, never "up to date". Packages wait for the registry. */
99
+ export function refreshUpdates(input, sources = liveSources) {
100
+ let latest = null, behind = null;
101
+ if (input.channel === 'npm' && input.name !== null)
102
+ latest = sources.npm(input.name);
103
+ if (input.channel === 'checkout' && input.checkout !== null) {
104
+ const count = sources.git(input.checkout, ['rev-list', '--count', 'HEAD..@{upstream}']);
105
+ behind = count !== null && /^\d+$/.test(count) ? Number(count) : null;
106
+ }
107
+ const previous = readUpdateCheck(input.home);
108
+ const check = {
109
+ schema: 'ia.update-check.v1',
110
+ checkedAt: input.now.toISOString(),
111
+ cli: {
112
+ channel: input.channel,
113
+ current: input.current,
114
+ latest,
115
+ behind,
116
+ checked: latest !== null || behind !== null,
117
+ },
118
+ packages: { checked: false },
119
+ ...(previous?.account === undefined ? {} : { account: previous.account }),
120
+ };
121
+ writeHomeFile(input.home, UPDATE_CHECK, JSON.stringify(check, null, 2) + '\n');
122
+ return check;
123
+ }
124
+ const NUMERIC = /^\d+$/;
125
+ const split = (v) => {
126
+ const bare = v.split('+')[0], dash = bare.indexOf('-'), core = dash < 0 ? bare : bare.slice(0, dash);
127
+ return {
128
+ core: core.split('.').map((part) => Number.parseInt(part, 10) || 0),
129
+ pre: dash < 0 ? null : bare.slice(dash + 1).split('.'),
130
+ };
131
+ };
132
+ const comparePart = (a, b) => NUMERIC.test(a) && NUMERIC.test(b)
133
+ ? Number(a) - Number(b)
134
+ : NUMERIC.test(a)
135
+ ? -1
136
+ : NUMERIC.test(b)
137
+ ? 1
138
+ : a < b
139
+ ? -1
140
+ : a > b
141
+ ? 1
142
+ : 0;
143
+ /** Semver order: `+build` is ignored; dotted core parts compare numerically (a non-number counts as 0); a prerelease ranks below its release; two prereleases compare their dot parts, numbers numerically and below words, words lexically. */
144
+ export const compareVersions = (a, b) => {
145
+ const x = split(a), y = split(b);
146
+ for (let i = 0; i < Math.max(x.core.length, y.core.length); i++)
147
+ if ((x.core[i] ?? 0) !== (y.core[i] ?? 0))
148
+ return (x.core[i] ?? 0) - (y.core[i] ?? 0);
149
+ if (x.pre === null || y.pre === null)
150
+ return x.pre === y.pre ? 0 : x.pre === null ? 1 : -1;
151
+ for (let i = 0; i < Math.max(x.pre.length, y.pre.length); i++) {
152
+ const p = x.pre[i], q = y.pre[i];
153
+ if (p === undefined)
154
+ return -1;
155
+ if (q === undefined)
156
+ return 1;
157
+ const c = comparePart(p, q);
158
+ if (c !== 0)
159
+ return c;
160
+ }
161
+ return 0;
162
+ };
163
+ /** §11.2: local only. A workspace language newer than anything this ia reads fails; an older one it no longer reads warns. */
164
+ export function compatibility(workspace, supported = SUPPORTED_VERSIONS) {
165
+ const detail = `Workspace language ${workspace.join(', ')}; this ia reads ${supported.join(', ')}`;
166
+ const missing = workspace.filter((v) => !supported.includes(v));
167
+ if (missing.length === 0)
168
+ return { status: 'ok', detail };
169
+ const newest = supported.slice().sort(compareVersions).at(-1) ?? '0', newer = missing.filter((v) => compareVersions(v, newest) > 0);
170
+ return newer.length > 0
171
+ ? { status: 'fail', detail: `${detail}; ${newer.join(', ')} is newer than this ia can read` }
172
+ : { status: 'warn', detail: `${detail}; ${missing.join(', ')} is no longer read by this ia` };
173
+ }
174
+ //# sourceMappingURL=updates.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"updates.js","sourceRoot":"","sources":["../src/updates.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ export interface TreeLimits {
2
+ readonly files: number;
3
+ readonly file: number;
4
+ readonly expanded: number;
5
+ readonly compressed: number;
6
+ }
7
+ /** The v2 host-cache bounds: 10,000 inventory files (host.ts:37) plus release.json, inventory.json and scripts/ia.mjs, 10,003 files total; 64 MiB per file; 256 MiB of file content, 10,003 x 1024 bytes of per-file tar framing, and 1024 bytes of end-of-archive padding. */
8
+ export declare const HOST_TREE_LIMITS: TreeLimits;
9
+ /** The one header encoding of the ustar-v1 recipe; archive.ts and host payloads share it. */
10
+ export declare function ustarHeader(path: string, size: number, epoch: number): Buffer;
11
+ /** gzip level 9 with the OS byte set to 255. Identical trees give identical bytes on one zlib build; another build (Homebrew's Node links the system zlib) can encode the same tree differently, so verification never re-compresses. */
12
+ export declare function packTree(files: ReadonlyMap<string, Uint8Array>, limits: TreeLimits, epoch?: number): Buffer;
13
+ /** The two ways an envelope is refused: bytes that do not inflate within the bound or fail the trailer, and an envelope outside the recipe. */
14
+ export interface EnvelopeRefusals {
15
+ readonly invalid: string;
16
+ readonly outside: string;
17
+ }
18
+ /**
19
+ * Inflates the recipe's gzip envelope once and returns the USTAR inside it. The header is checked before anything is inflated:
20
+ * RFC 1952 magic and deflate, no flags, zero mtime, an XFL of 0, 2 or 4 (the only values zlib writes), and OS 255. The deflate
21
+ * stream must then use every byte up to the 8-byte trailer, which leaves no room for a second member or a trailing byte, and
22
+ * the trailer's CRC-32 and length must match what it inflated to. Inflating stops at `maxOutputLength`. The deflate bytes
23
+ * themselves are not compared, so any zlib build's encoding passes (Homebrew's Node links the system zlib).
24
+ */
25
+ export declare function inflateCanonical(input: Uint8Array, maxOutputLength: number, refusals: EnvelopeRefusals): Buffer;
26
+ /** Reads only the canonical tree inside the recipe's envelope: the envelope is checked as it is inflated, the tree is rebuilt and compared byte for byte, and the deflate bytes are left to the zlib build that wrote them. */
27
+ export declare function unpackTree(input: Uint8Array, limits: TreeLimits): Map<string, Buffer>;
28
+ //# sourceMappingURL=ustar.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ustar.d.ts","sourceRoot":"","sources":["../src/ustar.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AACD,+QAA+Q;AAC/Q,eAAO,MAAM,gBAAgB,EAAE,UAK7B,CAAC;AAMH,6FAA6F;AAC7F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA4B7E;AAsBD,yOAAyO;AACzO,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,SAAI,GAAG,MAAM,CAKtG;AACD,+IAA+I;AAC/I,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AACD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAsB/G;AACD,+NAA+N;AAC/N,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAuCrF"}
package/dist/ustar.js ADDED
@@ -0,0 +1,145 @@
1
+ import { crc32, gzipSync, inflateRawSync } from 'node:zlib';
2
+ import { fail, portable, utf8 } from './files.js';
3
+ const block = 512;
4
+ /** The v2 host-cache bounds: 10,000 inventory files (host.ts:37) plus release.json, inventory.json and scripts/ia.mjs, 10,003 files total; 64 MiB per file; 256 MiB of file content, 10,003 x 1024 bytes of per-file tar framing, and 1024 bytes of end-of-archive padding. */
5
+ export const HOST_TREE_LIMITS = Object.freeze({
6
+ files: 10_003,
7
+ file: 64 * 1024 * 1024,
8
+ expanded: 256 * 1024 * 1024 + 10_003 * 1024 + 1024,
9
+ compressed: 256 * 1024 * 1024,
10
+ });
11
+ function octal(value, width) {
12
+ const result = value.toString(8);
13
+ if (result.length >= width)
14
+ fail('ARCHIVE-INVALID', 'USTAR integer overflow');
15
+ return result.padStart(width - 1, '0') + '\0';
16
+ }
17
+ /** The one header encoding of the ustar-v1 recipe; archive.ts and host payloads share it. */
18
+ export function ustarHeader(path, size, epoch) {
19
+ portable(path);
20
+ const result = Buffer.alloc(block);
21
+ let name = path, prefix = '';
22
+ if (Buffer.byteLength(name) > 100) {
23
+ const splits = [...path.matchAll(/\//g)].map((m) => m.index);
24
+ const split = splits.find((at) => Buffer.byteLength(path.slice(0, at)) <= 155 && Buffer.byteLength(path.slice(at + 1)) <= 100);
25
+ if (split === undefined)
26
+ fail('ARCHIVE-INVALID', 'Path exceeds portable USTAR fields');
27
+ prefix = path.slice(0, split);
28
+ name = path.slice(split + 1);
29
+ }
30
+ result.write(name, 0, 100, 'utf8');
31
+ result.write(octal(0o644, 8), 100, 8, 'ascii');
32
+ result.write(octal(0, 8), 108, 8, 'ascii');
33
+ result.write(octal(0, 8), 116, 8, 'ascii');
34
+ result.write(octal(size, 12), 124, 12, 'ascii');
35
+ result.write(octal(epoch, 12), 136, 12, 'ascii');
36
+ result.fill(32, 148, 156);
37
+ result.write('0', 156, 1);
38
+ result.write('ustar\0', 257, 6);
39
+ result.write('00', 263, 2);
40
+ result.write(prefix, 345, 155, 'utf8');
41
+ const sum = result.reduce((a, b) => a + b, 0);
42
+ result.write(sum.toString(8).padStart(6, '0') + '\0 ', 148, 8, 'ascii');
43
+ return result;
44
+ }
45
+ /** The canonical USTAR bytes of a tree: sorted entries, fixed epoch, the one header encoding. */
46
+ function ustarTree(files, limits, epoch = 0) {
47
+ if (!Number.isSafeInteger(epoch) || epoch < 0)
48
+ fail('ARCHIVE-INVALID', 'Invalid USTAR epoch');
49
+ if (files.size > limits.files)
50
+ fail('LIMIT-EXCEEDED', 'Tree exceeds its file count');
51
+ const folded = new Set(), chunks = [];
52
+ let expanded = 2 * block;
53
+ for (const [path, input] of [...files].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))) {
54
+ const content = Buffer.from(input);
55
+ portable(path);
56
+ if (folded.has(path.toLowerCase()))
57
+ fail('PATH-UNSAFE', 'Tree paths collide');
58
+ folded.add(path.toLowerCase());
59
+ if (content.length > limits.file)
60
+ fail('LIMIT-EXCEEDED', `File exceeds its bound: ${path}`);
61
+ const padding = (block - (content.length % block)) % block;
62
+ expanded += block + content.length + padding;
63
+ if (expanded > limits.expanded)
64
+ fail('LIMIT-EXCEEDED', 'Expanded tree exceeds its ceiling');
65
+ chunks.push(ustarHeader(path, content.length, epoch), content, Buffer.alloc(padding));
66
+ }
67
+ chunks.push(Buffer.alloc(2 * block));
68
+ return Buffer.concat(chunks);
69
+ }
70
+ /** gzip level 9 with the OS byte set to 255. Identical trees give identical bytes on one zlib build; another build (Homebrew's Node links the system zlib) can encode the same tree differently, so verification never re-compresses. */
71
+ export function packTree(files, limits, epoch = 0) {
72
+ const packed = gzipSync(ustarTree(files, limits, epoch), { level: 9 });
73
+ packed[9] = 255;
74
+ if (packed.length > limits.compressed)
75
+ fail('LIMIT-EXCEEDED', 'Compressed tree exceeds its ceiling');
76
+ return packed;
77
+ }
78
+ /**
79
+ * Inflates the recipe's gzip envelope once and returns the USTAR inside it. The header is checked before anything is inflated:
80
+ * RFC 1952 magic and deflate, no flags, zero mtime, an XFL of 0, 2 or 4 (the only values zlib writes), and OS 255. The deflate
81
+ * stream must then use every byte up to the 8-byte trailer, which leaves no room for a second member or a trailing byte, and
82
+ * the trailer's CRC-32 and length must match what it inflated to. Inflating stops at `maxOutputLength`. The deflate bytes
83
+ * themselves are not compared, so any zlib build's encoding passes (Homebrew's Node links the system zlib).
84
+ */
85
+ export function inflateCanonical(input, maxOutputLength, refusals) {
86
+ const gz = Buffer.from(input.buffer, input.byteOffset, input.byteLength);
87
+ if (gz.length < 20 || gz[0] !== 0x1f || gz[1] !== 0x8b || gz[2] !== 8)
88
+ return fail('ARCHIVE-INVALID', refusals.invalid);
89
+ if (gz[3] !== 0 || gz.readUInt32LE(4) !== 0 || ![0, 2, 4].includes(gz[8]) || gz[9] !== 255)
90
+ return fail('ARCHIVE-INVALID', refusals.outside);
91
+ let tar, consumed;
92
+ try {
93
+ const inflated = inflateRawSync(gz.subarray(10, gz.length - 8), { maxOutputLength, info: true });
94
+ tar = inflated.buffer;
95
+ consumed = inflated.engine.bytesWritten;
96
+ }
97
+ catch {
98
+ return fail('ARCHIVE-INVALID', refusals.invalid);
99
+ }
100
+ // One member's deflate stream ends exactly at its trailer: a second member or a trailing byte leaves input unread.
101
+ if (consumed !== gz.length - 18)
102
+ return fail('ARCHIVE-INVALID', refusals.outside);
103
+ if (crc32(tar) !== gz.readUInt32LE(gz.length - 8) || tar.length % 2 ** 32 !== gz.readUInt32LE(gz.length - 4))
104
+ return fail('ARCHIVE-INVALID', refusals.invalid);
105
+ return tar;
106
+ }
107
+ /** Reads only the canonical tree inside the recipe's envelope: the envelope is checked as it is inflated, the tree is rebuilt and compared byte for byte, and the deflate bytes are left to the zlib build that wrote them. */
108
+ export function unpackTree(input, limits) {
109
+ if (input.length > limits.compressed)
110
+ fail('LIMIT-EXCEEDED', 'Compressed tree exceeds its ceiling');
111
+ const tar = inflateCanonical(input, limits.expanded, {
112
+ invalid: 'Invalid or oversized compressed tree',
113
+ outside: 'Tree is outside the canonical ustar-v1 recipe',
114
+ });
115
+ if (tar.length < 1024 || tar.length % block)
116
+ fail('ARCHIVE-INVALID', 'Invalid USTAR length');
117
+ const files = new Map();
118
+ let at = 0, epoch = 0;
119
+ while (at < tar.length - 1024) {
120
+ const h = tar.subarray(at, at + block);
121
+ if (h.every((byte) => byte === 0))
122
+ break;
123
+ const field = (start, length) => {
124
+ const bytes = h.subarray(start, start + length), zero = bytes.indexOf(0);
125
+ return utf8(Buffer.from(zero < 0 ? bytes : bytes.subarray(0, zero)));
126
+ };
127
+ const prefix = field(345, 155), path = `${prefix ? prefix + '/' : ''}${field(0, 100)}`;
128
+ const sizeField = field(124, 12), epochField = field(136, 12);
129
+ if (!/^[0-7]{11}$/.test(sizeField) || !/^[0-7]{11}$/.test(epochField))
130
+ fail('ARCHIVE-INVALID', 'Invalid USTAR integer');
131
+ const size = parseInt(sizeField, 8);
132
+ epoch = parseInt(epochField, 8);
133
+ if (size > limits.file ||
134
+ files.size >= limits.files ||
135
+ at + block + size > tar.length - 1024 ||
136
+ !h.equals(ustarHeader(path, size, epoch)))
137
+ fail('ARCHIVE-INVALID', 'Invalid header, size, checksum or metadata');
138
+ files.set(path, Buffer.from(tar.subarray(at + block, at + block + size)));
139
+ at += block + Math.ceil(size / block) * block;
140
+ }
141
+ if (!ustarTree(files, limits, epoch).equals(tar))
142
+ fail('ARCHIVE-INVALID', 'Tree is outside the canonical ustar-v1 recipe');
143
+ return files;
144
+ }
145
+ //# sourceMappingURL=ustar.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ustar.js","sourceRoot":"","sources":["../src/ustar.ts"],"names":[],"mappings":"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"}