@clear-capabilities/agentic-security-scanner 0.185.0 → 0.186.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 (167) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/bin/agentic-security.js +24 -1
  3. package/dist/1128.index.js +25 -21
  4. package/dist/2584.index.js +1 -1
  5. package/dist/4171.index.js +2 -2
  6. package/dist/5752.index.js +466 -0
  7. package/dist/7405.index.js +1 -1
  8. package/dist/8158.index.js +1713 -0
  9. package/dist/8798.index.js +1 -1
  10. package/dist/9382.index.js +2 -2
  11. package/dist/9579.index.js +1 -1
  12. package/dist/agentic-security.mjs +29 -29
  13. package/dist/agentic-security.mjs.sha256 +1 -1
  14. package/dist/{0b301d45b231f144a1b4.json → ca62ee93079be4c24eee.json} +7 -7
  15. package/package.json +7 -7
  16. package/src/dataflow/CLAUDE.md +6 -3
  17. package/src/dataflow/access-paths.js +12 -2
  18. package/src/dataflow/demand-query.js +279 -40
  19. package/src/dataflow/dep-fingerprint.js +1 -1
  20. package/src/dataflow/exploit-prover.js +6 -2
  21. package/src/dataflow/ir-cache.js +268 -0
  22. package/src/dataflow/privacy-taint.js +7 -0
  23. package/src/engine.js +62 -5
  24. package/src/ir/CLAUDE.md +4 -0
  25. package/src/ir/callgraph.js +36 -8
  26. package/src/ir/index.js +18 -4
  27. package/src/ir/parser-js.js +10 -0
  28. package/src/language/CLAUDE.md +13 -0
  29. package/src/language/nix-option-types.js +170 -0
  30. package/src/language/nix-script-taint.js +46 -3
  31. package/src/language/nix-secrets.js +20 -2
  32. package/src/lineage/CLAUDE.md +2 -1
  33. package/src/lineage/smt-orchestrator.js +47 -11
  34. package/src/lineage/smt-z3-backend.js +294 -0
  35. package/src/posture/CLAUDE.md +5 -1
  36. package/src/posture/business-logic.js +16 -7
  37. package/src/posture/dag-commands.js +442 -0
  38. package/src/posture/finding-defaults.js +19 -0
  39. package/src/posture/git-history.js +91 -1
  40. package/src/sast/CLAUDE.md +2 -0
  41. package/src/sast/_call-args.js +70 -0
  42. package/src/sast/init-scope.js +87 -0
  43. package/src/sast/listen-bind-address.js +49 -0
  44. package/src/sast/redirect-target.js +106 -0
  45. package/src/sast/reflected-input.js +76 -0
  46. package/src/sast/send-file-root.js +27 -0
  47. package/src/sast/sensitive-data-logging.js +38 -1
  48. package/dist/119.index.js +0 -197
  49. package/dist/128.index.js +0 -129
  50. package/dist/1293.index.js +0 -5689
  51. package/dist/1336.index.js +0 -16331
  52. package/dist/1351.index.js +0 -133
  53. package/dist/1387.index.js +0 -271
  54. package/dist/1437.index.js +0 -23
  55. package/dist/1445.index.js +0 -110
  56. package/dist/1505.index.js +0 -151
  57. package/dist/1557.index.js +0 -293
  58. package/dist/1621.index.js +0 -311
  59. package/dist/1751.index.js +0 -160
  60. package/dist/1765.index.js +0 -727
  61. package/dist/1861.index.js +0 -690
  62. package/dist/1906.index.js +0 -433
  63. package/dist/208.index.js +0 -1631
  64. package/dist/2223.index.js +0 -159
  65. package/dist/2238.index.js +0 -295
  66. package/dist/2530.index.js +0 -152
  67. package/dist/2565.index.js +0 -116
  68. package/dist/2574.index.js +0 -127
  69. package/dist/2620.index.js +0 -345
  70. package/dist/2773.index.js +0 -98
  71. package/dist/2775.index.js +0 -32
  72. package/dist/2966.index.js +0 -171
  73. package/dist/2972.index.js +0 -87
  74. package/dist/2991.index.js +0 -131
  75. package/dist/3063.index.js +0 -833
  76. package/dist/3075.index.js +0 -227
  77. package/dist/3121.index.js +0 -297
  78. package/dist/3314.index.js +0 -263
  79. package/dist/3480.index.js +0 -1822
  80. package/dist/3481.index.js +0 -24
  81. package/dist/3506.index.js +0 -268
  82. package/dist/3533.index.js +0 -591
  83. package/dist/3653.index.js +0 -450
  84. package/dist/3740.index.js +0 -722
  85. package/dist/3822.index.js +0 -131
  86. package/dist/3868.index.js +0 -292
  87. package/dist/3918.index.js +0 -192
  88. package/dist/4090.index.js +0 -288
  89. package/dist/4113.index.js +0 -1286
  90. package/dist/4121.index.js +0 -1190
  91. package/dist/4142.index.js +0 -690
  92. package/dist/4168.index.js +0 -509
  93. package/dist/4281.index.js +0 -993
  94. package/dist/4336.index.js +0 -436
  95. package/dist/4387.index.js +0 -532
  96. package/dist/4413.index.js +0 -302
  97. package/dist/4476.index.js +0 -4510
  98. package/dist/4491.index.js +0 -133
  99. package/dist/4538.index.js +0 -185
  100. package/dist/4684.index.js +0 -319
  101. package/dist/4740.index.js +0 -165
  102. package/dist/4780.index.js +0 -209
  103. package/dist/4802.index.js +0 -225
  104. package/dist/4812.index.js +0 -379
  105. package/dist/4835.index.js +0 -126
  106. package/dist/494.index.js +0 -226
  107. package/dist/4991.index.js +0 -549
  108. package/dist/5199.index.js +0 -305
  109. package/dist/5216.index.js +0 -109
  110. package/dist/5439.index.js +0 -301
  111. package/dist/5443.index.js +0 -97
  112. package/dist/5496.index.js +0 -377
  113. package/dist/5738.index.js +0 -240
  114. package/dist/5801.index.js +0 -588
  115. package/dist/5817.index.js +0 -714
  116. package/dist/5858.index.js +0 -223
  117. package/dist/5933.index.js +0 -143
  118. package/dist/601.index.js +0 -23
  119. package/dist/6173.index.js +0 -273
  120. package/dist/6291.index.js +0 -1871
  121. package/dist/6312.index.js +0 -666
  122. package/dist/634.index.js +0 -16182
  123. package/dist/644.index.js +0 -87
  124. package/dist/6508.index.js +0 -283
  125. package/dist/6560.index.js +0 -645
  126. package/dist/6576.index.js +0 -422
  127. package/dist/6579.index.js +0 -271
  128. package/dist/6655.index.js +0 -3221
  129. package/dist/6745.index.js +0 -305
  130. package/dist/6818.index.js +0 -21642
  131. package/dist/6932.index.js +0 -1190
  132. package/dist/6972.index.js +0 -167
  133. package/dist/6995.index.js +0 -163
  134. package/dist/7249.index.js +0 -191
  135. package/dist/7372.index.js +0 -1197
  136. package/dist/7546.index.js +0 -541
  137. package/dist/76.index.js +0 -448
  138. package/dist/7879.index.js +0 -163
  139. package/dist/8025.index.js +0 -130
  140. package/dist/8054.index.js +0 -248
  141. package/dist/808.index.js +0 -1330
  142. package/dist/8097.index.js +0 -201
  143. package/dist/8126.index.js +0 -191
  144. package/dist/8178.index.js +0 -78
  145. package/dist/8382.index.js +0 -93
  146. package/dist/8408.index.js +0 -261
  147. package/dist/8540.index.js +0 -174
  148. package/dist/8635.index.js +0 -802
  149. package/dist/8688.index.js +0 -410
  150. package/dist/8699.index.js +0 -779
  151. package/dist/8891.index.js +0 -457
  152. package/dist/8916.index.js +0 -885
  153. package/dist/9146.index.js +0 -170
  154. package/dist/9168.index.js +0 -841
  155. package/dist/9292.index.js +0 -369
  156. package/dist/9422.index.js +0 -866
  157. package/dist/9440.index.js +0 -453
  158. package/dist/9479.index.js +0 -152
  159. package/dist/9481.index.js +0 -220
  160. package/dist/9539.index.js +0 -100
  161. package/dist/9547.index.js +0 -103
  162. package/dist/9692.index.js +0 -90
  163. package/dist/9800.index.js +0 -462
  164. package/dist/9899.index.js +0 -138
  165. package/dist/9981.index.js +0 -206
  166. package/dist/999.index.js +0 -117
  167. package/dist/9999.index.js +0 -1698
@@ -1,369 +0,0 @@
1
- export const id = 9292;
2
- export const ids = [9292,119];
3
- export const modules = {
4
-
5
- /***/ 69292:
6
- /***/ ((__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) => {
7
-
8
- /* harmony export */ __webpack_require__.d(__webpack_exports__, {
9
- /* harmony export */ ImageArchiveError: () => (/* binding */ ImageArchiveError),
10
- /* harmony export */ t: () => (/* binding */ parseImageArchive)
11
- /* harmony export */ });
12
- /* harmony import */ var node_crypto__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(77598);
13
- /* harmony import */ var _safe_tar_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(30119);
14
- // Parses a Docker-save ("docker-archive") or OCI-layout ("oci-archive") tar
15
- // into one normalized shape, without executing or daemon-mounting the image
16
- // (PRD 5 Safety Requirements: "OCI inspection should not require executing
17
- // the image"). Built entirely on `safe-tar.js` — every byte read here passes
18
- // through the same entry-count/size/path/decompression guards.
19
-
20
-
21
-
22
- class ImageArchiveError extends Error {
23
- constructor(message, code) {
24
- super(message);
25
- this.name = 'ImageArchiveError';
26
- this.code = code;
27
- }
28
- }
29
-
30
- function safeJsonParse(buf, what) {
31
- try {
32
- return JSON.parse(buf.toString('utf8'));
33
- } catch (err) {
34
- throw new ImageArchiveError(`${what} is not valid JSON: ${err.message}`, 'malformed_manifest');
35
- }
36
- }
37
-
38
- function readOuterEntries(buf, limits) {
39
- const outer = (0,_safe_tar_js__WEBPACK_IMPORTED_MODULE_1__/* .decompressIfGzip */ .zr)(buf, limits);
40
- const byName = new Map();
41
- const unsafeEntries = [];
42
- for (const e of (0,_safe_tar_js__WEBPACK_IMPORTED_MODULE_1__/* .readTarEntries */ .ET)(outer, limits)) {
43
- if (e.unsafe) {
44
- unsafeEntries.push({ name: e.name });
45
- continue;
46
- }
47
- byName.set(e.name, e);
48
- }
49
- return { byName, unsafeEntries };
50
- }
51
-
52
- function extractConfigShape(configObj) {
53
- const cfg = (configObj && configObj.config) || {};
54
- return {
55
- architecture: configObj.architecture || null,
56
- os: configObj.os || null,
57
- labels: (cfg.Labels && typeof cfg.Labels === 'object') ? { ...cfg.Labels } : {},
58
- entrypoint: Array.isArray(cfg.Entrypoint) ? [...cfg.Entrypoint] : null,
59
- cmd: Array.isArray(cfg.Cmd) ? [...cfg.Cmd] : null,
60
- history: Array.isArray(configObj.history)
61
- ? configObj.history.map((h) => ({ createdBy: h.created_by || null, created: h.created || null, emptyLayer: !!h.empty_layer }))
62
- : [],
63
- rootfsDiffIds: (configObj.rootfs && Array.isArray(configObj.rootfs.diff_ids)) ? [...configObj.rootfs.diff_ids] : [],
64
- };
65
- }
66
-
67
- function parseDockerArchive(byName, outerUnsafe, limits) {
68
- const manifestEntry = byName.get('manifest.json');
69
- const manifestArr = safeJsonParse(manifestEntry.data, 'manifest.json');
70
- if (!Array.isArray(manifestArr) || manifestArr.length === 0) {
71
- throw new ImageArchiveError('manifest.json contains no images', 'empty_manifest');
72
- }
73
- if (manifestArr.length > 1) {
74
- throw new ImageArchiveError(`manifest.json describes ${manifestArr.length} images; image scan expects exactly one`, 'multi_image_archive');
75
- }
76
- const m = manifestArr[0];
77
- if (typeof m.Config !== 'string' || !Array.isArray(m.Layers)) {
78
- throw new ImageArchiveError('manifest.json entry is missing Config or Layers', 'malformed_manifest');
79
- }
80
- const configEntry = byName.get(m.Config);
81
- if (!configEntry) throw new ImageArchiveError(`manifest.json references missing config "${m.Config}"`, 'missing_blob');
82
- const configObj = safeJsonParse(configEntry.data, m.Config);
83
- const configDigest = `sha256:${node_crypto__WEBPACK_IMPORTED_MODULE_0__.createHash('sha256').update(configEntry.data).digest('hex')}`;
84
-
85
- const layers = [];
86
- for (let i = 0; i < m.Layers.length; i++) {
87
- const layerPath = m.Layers[i];
88
- const entry = byName.get(layerPath);
89
- if (!entry) throw new ImageArchiveError(`manifest.json references missing layer "${layerPath}"`, 'missing_blob');
90
- const tar = (0,_safe_tar_js__WEBPACK_IMPORTED_MODULE_1__/* .decompressIfGzip */ .zr)(entry.data, limits);
91
- layers.push({ index: i, path: layerPath, diffId: configObj?.rootfs?.diff_ids?.[i] || null, tar, sizeBytes: entry.size });
92
- }
93
-
94
- return {
95
- format: 'docker-archive',
96
- digest: configDigest,
97
- digestKind: 'config',
98
- repoTags: Array.isArray(m.RepoTags) ? m.RepoTags : [],
99
- config: extractConfigShape(configObj),
100
- layers,
101
- unsafeEntries: outerUnsafe,
102
- };
103
- }
104
-
105
- function parseOciArchive(byName, outerUnsafe, limits) {
106
- const indexObj = safeJsonParse(byName.get('index.json').data, 'index.json');
107
- const manifests = Array.isArray(indexObj.manifests) ? indexObj.manifests : [];
108
- if (manifests.length === 0) throw new ImageArchiveError('index.json lists no manifests', 'empty_manifest');
109
- if (manifests.length > 1) {
110
- throw new ImageArchiveError(`index.json describes ${manifests.length} manifests; image scan expects exactly one`, 'multi_image_archive');
111
- }
112
- const manifestDigest = manifests[0].digest;
113
- if (typeof manifestDigest !== 'string' || !manifestDigest.startsWith('sha256:')) {
114
- throw new ImageArchiveError('index.json manifest entry has no sha256 digest', 'malformed_manifest');
115
- }
116
- const manifestBlobPath = `blobs/sha256/${manifestDigest.slice('sha256:'.length)}`;
117
- const manifestEntry = byName.get(manifestBlobPath);
118
- if (!manifestEntry) throw new ImageArchiveError(`index.json references missing manifest blob "${manifestBlobPath}"`, 'missing_blob');
119
- const manifestObj = safeJsonParse(manifestEntry.data, manifestBlobPath);
120
-
121
- const configDigest = manifestObj.config && manifestObj.config.digest;
122
- if (typeof configDigest !== 'string' || !configDigest.startsWith('sha256:')) {
123
- throw new ImageArchiveError('image manifest has no config digest', 'malformed_manifest');
124
- }
125
- const configBlobPath = `blobs/sha256/${configDigest.slice('sha256:'.length)}`;
126
- const configEntry = byName.get(configBlobPath);
127
- if (!configEntry) throw new ImageArchiveError(`manifest references missing config blob "${configBlobPath}"`, 'missing_blob');
128
- const configObj = safeJsonParse(configEntry.data, configBlobPath);
129
-
130
- const layerDescs = Array.isArray(manifestObj.layers) ? manifestObj.layers : [];
131
- const layers = [];
132
- for (let i = 0; i < layerDescs.length; i++) {
133
- const d = layerDescs[i];
134
- if (typeof d.digest !== 'string' || !d.digest.startsWith('sha256:')) {
135
- throw new ImageArchiveError(`layer ${i} has no sha256 digest`, 'malformed_manifest');
136
- }
137
- const blobPath = `blobs/sha256/${d.digest.slice('sha256:'.length)}`;
138
- const entry = byName.get(blobPath);
139
- if (!entry) throw new ImageArchiveError(`manifest references missing layer blob "${blobPath}"`, 'missing_blob');
140
- const tar = (0,_safe_tar_js__WEBPACK_IMPORTED_MODULE_1__/* .decompressIfGzip */ .zr)(entry.data, limits);
141
- layers.push({ index: i, path: blobPath, diffId: d.digest, mediaType: d.mediaType || null, tar, sizeBytes: entry.size });
142
- }
143
-
144
- return {
145
- format: 'oci-archive',
146
- digest: manifestDigest,
147
- digestKind: 'manifest',
148
- repoTags: [],
149
- config: extractConfigShape(configObj),
150
- layers,
151
- unsafeEntries: outerUnsafe,
152
- };
153
- }
154
-
155
- /**
156
- * Parses an in-memory tar buffer (already read from disk/stdin by the
157
- * caller — this module never touches the filesystem or network) as either a
158
- * `docker save`-shaped archive or an OCI-layout archive. Throws
159
- * ImageArchiveError for anything it cannot recognize or whose manifest
160
- * references a blob that isn't present — never guesses or substitutes a
161
- * default.
162
- */
163
- function parseImageArchive(buf, limits = _safe_tar_js__WEBPACK_IMPORTED_MODULE_1__/* .DEFAULT_LIMITS */ .dR) {
164
- if (!Buffer.isBuffer(buf)) throw new ImageArchiveError('image archive input must be a Buffer', 'bad_input');
165
- const { byName, unsafeEntries } = readOuterEntries(buf, limits);
166
- if (byName.has('manifest.json')) return parseDockerArchive(byName, unsafeEntries, limits);
167
- if (byName.has('index.json') && byName.has('oci-layout')) return parseOciArchive(byName, unsafeEntries, limits);
168
- throw new ImageArchiveError(
169
- 'archive is neither a docker-archive (manifest.json) nor an oci-archive (oci-layout + index.json)',
170
- 'unrecognized_format',
171
- );
172
- }
173
-
174
-
175
- /***/ }),
176
-
177
- /***/ 30119:
178
- /***/ ((__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) => {
179
-
180
- /* harmony export */ __webpack_require__.d(__webpack_exports__, {
181
- /* harmony export */ ET: () => (/* binding */ readTarEntries),
182
- /* harmony export */ Jn: () => (/* binding */ whiteoutTarget),
183
- /* harmony export */ TarSafetyError: () => (/* binding */ TarSafetyError),
184
- /* harmony export */ dR: () => (/* binding */ DEFAULT_LIMITS),
185
- /* harmony export */ l0: () => (/* binding */ isWhiteoutName),
186
- /* harmony export */ zr: () => (/* binding */ decompressIfGzip)
187
- /* harmony export */ });
188
- /* unused harmony export isSafeEntryName */
189
- /* harmony import */ var node_zlib__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(38522);
190
- // Hand-rolled, hardened POSIX/GNU tar reader for OCI/Docker image archives.
191
- //
192
- // Why hand-rolled instead of a dependency: this repo has no tar library (see
193
- // `src/artifact/CLAUDE.md`), and PRD 5's own Safety Requirements ask for exact
194
- // control over the failure modes a generic tar library treats as implementation
195
- // detail: malicious entry paths, decompression bombs, giant layers, oversized
196
- // archives. Rolling it ourselves means every one of those limits is a named,
197
- // tested constant in this file rather than a library default we'd have to audit.
198
- //
199
- // Scope: ustar + GNU longname ('L' typeflag) + base-256 size fields. PAX extended
200
- // headers ('x'/'g') and GNU longlink ('K') are structurally skipped (their data
201
- // block is consumed so offsets stay correct, but their content is not applied) —
202
- // a disclosed limitation, not a silent one. Real docker-save/oci-archive output
203
- // from Go's archive/tar for images in this size/complexity class essentially
204
- // never needs them; synthetic fixtures in this codebase never emit them either.
205
-
206
-
207
- const BLOCK = 512;
208
-
209
- const DEFAULT_LIMITS = Object.freeze({
210
- maxEntries: 200_000,
211
- maxEntrySize: 512 * 1024 * 1024, // 512MB per tar entry
212
- maxTotalSize: 4 * 1024 * 1024 * 1024, // 4GB per archive (sum of entry sizes)
213
- maxGunzipOutput: 4 * 1024 * 1024 * 1024, // decompression-bomb guard
214
- });
215
-
216
- class TarSafetyError extends Error {
217
- constructor(message, code) {
218
- super(message);
219
- this.name = 'TarSafetyError';
220
- this.code = code;
221
- }
222
- }
223
-
224
- function parseSizeField(buf) {
225
- if (buf[0] & 0x80) {
226
- // GNU base-256 extension for sizes that don't fit in octal-ASCII.
227
- let n = 0n;
228
- for (let i = 1; i < buf.length; i++) n = (n << 8n) | BigInt(buf[i]);
229
- return Number(n);
230
- }
231
- const s = buf.toString('ascii').replace(/\0.*$/, '').trim();
232
- if (!s) return 0;
233
- const n = parseInt(s, 8);
234
- return Number.isFinite(n) ? n : 0;
235
- }
236
-
237
- function cstr(buf) {
238
- return buf.toString('utf8').replace(/\0.*$/, '');
239
- }
240
-
241
- // A tar entry name is unsafe when it would escape a virtual extraction root:
242
- // absolute paths, `..` segments, embedded NULs, or an unreasonable length.
243
- // Because this module never writes to a real filesystem path (every caller
244
- // keeps extracted content in an in-memory Map keyed by this string), the
245
- // classic zip-slip *write* vulnerability cannot occur here — but a hostile
246
- // name must still never be silently treated as an ordinary path by downstream
247
- // manifest/package-DB matching, so unsafe entries are flagged, never dropped
248
- // silently and never accepted as-is.
249
- function isSafeEntryName(name) {
250
- if (typeof name !== 'string' || name.length === 0 || name.length > 4096) return false;
251
- if (name.includes('\0')) return false;
252
- const norm = name.replace(/\\/g, '/');
253
- if (norm.startsWith('/')) return false;
254
- if (norm.split('/').some((p) => p === '..')) return false;
255
- return true;
256
- }
257
-
258
- function isWhiteoutName(name) {
259
- return (name.split('/').pop() || '').startsWith('.wh.');
260
- }
261
-
262
- // Resolves a whiteout entry name to what it deletes. `.wh..wh..opq` marks a
263
- // directory as "opaque" (everything from earlier layers under it is hidden,
264
- // not individually deleted) — reported distinctly so callers don't conflate
265
- // it with a single-file deletion.
266
- function whiteoutTarget(name) {
267
- const parts = name.split('/');
268
- const base = parts.pop();
269
- if (base === '.wh..wh..opq') return { opaque: true, dir: parts.join('/') };
270
- return { opaque: false, path: [...parts, base.slice(4)].join('/') };
271
- }
272
-
273
- // Decompresses a gzip member with a hard output-size cap (Node's native
274
- // ERR_BUFFER_TOO_LARGE on overflow — no custom streaming counter needed).
275
- // Returns the input unchanged when it isn't gzip-magic (plain tar).
276
- function decompressIfGzip(buf, limits = DEFAULT_LIMITS) {
277
- if (buf.length >= 2 && buf[0] === 0x1f && buf[1] === 0x8b) {
278
- try {
279
- return node_zlib__WEBPACK_IMPORTED_MODULE_0__.gunzipSync(buf, { maxOutputLength: limits.maxGunzipOutput });
280
- } catch (err) {
281
- if (err && err.code === 'ERR_BUFFER_TOO_LARGE') {
282
- throw new TarSafetyError('decompressed layer exceeds the decompression-bomb guard', 'gunzip_too_large');
283
- }
284
- throw new TarSafetyError(`gzip stream is malformed: ${err.message}`, 'gunzip_malformed');
285
- }
286
- }
287
- return buf;
288
- }
289
-
290
- /**
291
- * Reads a decompressed tar buffer and yields one record per entry:
292
- * { name, size, typeflag, linkname, data, unsafe }
293
- * `data` is a Buffer view into `buf` (never copied) for safe entries, `null`
294
- * for unsafe ones. Throws TarSafetyError (never returns a partial result) the
295
- * moment any configured limit is exceeded.
296
- */
297
- function* readTarEntries(buf, limits = DEFAULT_LIMITS) {
298
- if (!Buffer.isBuffer(buf)) throw new TarSafetyError('tar input must be a Buffer', 'bad_input');
299
- let offset = 0;
300
- let count = 0;
301
- let totalSize = 0;
302
- let pendingLongName = null;
303
-
304
- while (offset + BLOCK <= buf.length) {
305
- const header = buf.subarray(offset, offset + BLOCK);
306
- if (header.every((b) => b === 0)) {
307
- offset += BLOCK;
308
- continue; // end-of-archive zero-fill padding
309
- }
310
-
311
- count += 1;
312
- if (count > limits.maxEntries) {
313
- throw new TarSafetyError(`tar archive has more than ${limits.maxEntries} entries`, 'too_many_entries');
314
- }
315
-
316
- let name = cstr(header.subarray(0, 100));
317
- const typeflag = String.fromCharCode(header[156] || 0);
318
- const linkname = cstr(header.subarray(157, 257));
319
- const magic = header.subarray(257, 263).toString('ascii');
320
- const prefix = magic.startsWith('ustar') ? cstr(header.subarray(345, 500)) : '';
321
- if (prefix) name = `${prefix}/${name}`;
322
- const size = parseSizeField(header.subarray(124, 136));
323
-
324
- offset += BLOCK;
325
-
326
- if (size < 0 || !Number.isFinite(size)) {
327
- throw new TarSafetyError(`tar entry "${name}" has an invalid size field`, 'bad_size');
328
- }
329
- if (size > limits.maxEntrySize) {
330
- throw new TarSafetyError(`tar entry "${name}" (${size} bytes) exceeds the per-entry size limit`, 'entry_too_large');
331
- }
332
- totalSize += size;
333
- if (totalSize > limits.maxTotalSize) {
334
- throw new TarSafetyError('tar archive exceeds the total-size limit', 'archive_too_large');
335
- }
336
-
337
- const dataBlocks = Math.ceil(size / BLOCK);
338
- if (offset + size > buf.length) {
339
- throw new TarSafetyError(`tar entry "${name}" claims more data than the archive contains`, 'truncated');
340
- }
341
- const data = size > 0 ? buf.subarray(offset, offset + size) : Buffer.alloc(0);
342
- offset += dataBlocks * BLOCK;
343
-
344
- const resolvedName = pendingLongName ? pendingLongName : name;
345
- pendingLongName = null;
346
-
347
- if (typeflag === 'L') {
348
- // GNU longname: this entry's data IS the next entry's real name.
349
- pendingLongName = cstr(data);
350
- continue;
351
- }
352
- if (typeflag === 'K' || typeflag === 'x' || typeflag === 'g') {
353
- // GNU longlink / PAX extended header — structurally skipped (see header comment).
354
- continue;
355
- }
356
-
357
- if (!isSafeEntryName(resolvedName)) {
358
- yield { name: resolvedName, size, typeflag, linkname, data: null, unsafe: true };
359
- continue;
360
- }
361
-
362
- yield { name: resolvedName.replace(/\\/g, '/'), size, typeflag, linkname, data, unsafe: false };
363
- }
364
- }
365
-
366
-
367
- /***/ })
368
-
369
- };