upload-safety 0.0.0-stage → 0.2.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 (68) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +188 -2
  3. package/dist/check-upload.d.ts +23 -0
  4. package/dist/check-upload.d.ts.map +1 -0
  5. package/dist/check-upload.js +22 -0
  6. package/dist/check-upload.js.map +1 -0
  7. package/dist/excel-macro-sheets.d.ts +12 -0
  8. package/dist/excel-macro-sheets.d.ts.map +1 -0
  9. package/dist/excel-macro-sheets.js +51 -0
  10. package/dist/excel-macro-sheets.js.map +1 -0
  11. package/dist/heif-metadata.d.ts +14 -0
  12. package/dist/heif-metadata.d.ts.map +1 -0
  13. package/dist/heif-metadata.js +216 -0
  14. package/dist/heif-metadata.js.map +1 -0
  15. package/dist/index.d.ts +7 -0
  16. package/dist/index.d.ts.map +1 -0
  17. package/dist/index.js +7 -0
  18. package/dist/index.js.map +1 -0
  19. package/dist/ole-streams.d.ts +15 -0
  20. package/dist/ole-streams.d.ts.map +1 -0
  21. package/dist/ole-streams.js +192 -0
  22. package/dist/ole-streams.js.map +1 -0
  23. package/dist/pdf-active-content.d.ts +3 -0
  24. package/dist/pdf-active-content.d.ts.map +1 -0
  25. package/dist/pdf-active-content.js +130 -0
  26. package/dist/pdf-active-content.js.map +1 -0
  27. package/dist/pdf-encryption.d.ts +70 -0
  28. package/dist/pdf-encryption.d.ts.map +1 -0
  29. package/dist/pdf-encryption.js +576 -0
  30. package/dist/pdf-encryption.js.map +1 -0
  31. package/dist/photo-metadata.d.ts +14 -0
  32. package/dist/photo-metadata.d.ts.map +1 -0
  33. package/dist/photo-metadata.js +307 -0
  34. package/dist/photo-metadata.js.map +1 -0
  35. package/dist/powerpoint-vba.d.ts +14 -0
  36. package/dist/powerpoint-vba.d.ts.map +1 -0
  37. package/dist/powerpoint-vba.js +122 -0
  38. package/dist/powerpoint-vba.js.map +1 -0
  39. package/dist/text-content.d.ts +7 -0
  40. package/dist/text-content.d.ts.map +1 -0
  41. package/dist/text-content.js +83 -0
  42. package/dist/text-content.js.map +1 -0
  43. package/dist/upload-allowlist.d.ts +48 -0
  44. package/dist/upload-allowlist.d.ts.map +1 -0
  45. package/dist/upload-allowlist.js +560 -0
  46. package/dist/upload-allowlist.js.map +1 -0
  47. package/dist/xml-markup.d.ts +12 -0
  48. package/dist/xml-markup.d.ts.map +1 -0
  49. package/dist/xml-markup.js +83 -0
  50. package/dist/xml-markup.js.map +1 -0
  51. package/dist/zip-entries.d.ts +34 -0
  52. package/dist/zip-entries.d.ts.map +1 -0
  53. package/dist/zip-entries.js +222 -0
  54. package/dist/zip-entries.js.map +1 -0
  55. package/package.json +62 -5
  56. package/src/check-upload.ts +50 -0
  57. package/src/excel-macro-sheets.ts +52 -0
  58. package/src/heif-metadata.ts +232 -0
  59. package/src/index.ts +6 -0
  60. package/src/ole-streams.ts +226 -0
  61. package/src/pdf-active-content.ts +138 -0
  62. package/src/pdf-encryption.ts +629 -0
  63. package/src/photo-metadata.ts +325 -0
  64. package/src/powerpoint-vba.ts +136 -0
  65. package/src/text-content.ts +85 -0
  66. package/src/upload-allowlist.ts +657 -0
  67. package/src/xml-markup.ts +85 -0
  68. package/src/zip-entries.ts +255 -0
@@ -0,0 +1,307 @@
1
+ /**
2
+ * Removes what a photo tells about where, when and with what it was taken (EXIF with GPS,
3
+ * XMP, IPTC, comments) without decoding it: JPEG segments and PNG and WebP chunks are dropped
4
+ * whole, so the image data stays byte for byte. Only the orientation is written back, since
5
+ * without it a portrait photo from a phone opens on its side. HEIF images are handled in
6
+ * `heif-metadata.ts`.
7
+ */
8
+ import { crc32 } from 'node:zlib';
9
+ import { stripHeif } from './heif-metadata.js';
10
+ const ORIENTATION_TAG = 0x0112;
11
+ const SHORT_TYPE = 3;
12
+ const UPRIGHT = 1;
13
+ const MAX_ORIENTATION = 8;
14
+ const JPEG_START = 0xd8;
15
+ const JPEG_END = 0xd9;
16
+ const START_OF_SCAN = 0xda;
17
+ // Markers without a length: TEM and the restart markers RST0 to RST7.
18
+ const TEMPORARY = 0x01;
19
+ const RESTART_FIRST = 0xd0;
20
+ const RESTART_LAST = 0xd7;
21
+ const APP0 = 0xe0;
22
+ const APP1 = 0xe1;
23
+ const APP2 = 0xe2;
24
+ const APP14 = 0xee;
25
+ const APP15 = 0xef;
26
+ const COMMENT = 0xfe;
27
+ const EXIF_HEADER = Buffer.from('Exif\0\0', 'latin1');
28
+ const JFIF_HEADERS = ['JFIF\0', 'JFXX\0'];
29
+ const ICC_HEADER = 'ICC_PROFILE\0';
30
+ const PNG_SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
31
+ // The chunks that draw the image (also as APNG), as the JPEG side keeps only known segments; any other,
32
+ // standard or not, may carry metadata.
33
+ const PNG_IMAGE_CHUNKS = new Set([
34
+ 'IHDR', 'PLTE', 'IDAT', 'IEND', 'tRNS', 'cHRM', 'gAMA', 'iCCP', 'sBIT', 'sRGB', 'cICP', 'mDCV', 'cLLI',
35
+ 'bKGD', 'hIST', 'pHYs', 'sPLT', 'acTL', 'fcTL', 'fdAT',
36
+ ]);
37
+ const WEBP_HEADER_SIZE = 12;
38
+ const RIFF_CHUNK_HEADER_SIZE = 8;
39
+ // The chunks that draw the image, as for PNG; EXIF, XMP and any other chunk may carry metadata.
40
+ const WEBP_IMAGE_CHUNKS = new Set(['VP8X', 'VP8 ', 'VP8L', 'ALPH', 'ANIM', 'ANMF', 'ICCP']);
41
+ const WEBP_BITSTREAM_CHUNKS = new Set(['VP8 ', 'VP8L', 'ANMF']);
42
+ /** VP8X flags of the metadata chunks, in the first byte of its payload. */
43
+ const VP8X_EXIF = 0x08;
44
+ const VP8X_XMP = 0x04;
45
+ /** The orientation (1 to 8) in IFD0 of a TIFF block, or undefined when there is none or it does not read. */
46
+ function readOrientation(tiff) {
47
+ const order = tiff.toString('latin1', 0, 2);
48
+ if (tiff.length < 8 || (order !== 'II' && order !== 'MM')) {
49
+ return undefined;
50
+ }
51
+ const little = order === 'II';
52
+ const u16 = (offset) => (little ? tiff.readUInt16LE(offset) : tiff.readUInt16BE(offset));
53
+ const ifd = little ? tiff.readUInt32LE(4) : tiff.readUInt32BE(4);
54
+ if (u16(2) !== 42 || ifd + 2 > tiff.length) {
55
+ return undefined;
56
+ }
57
+ for (let index = 0; index < u16(ifd); index++) {
58
+ const entry = ifd + 2 + index * 12;
59
+ if (entry + 12 > tiff.length) {
60
+ return undefined;
61
+ }
62
+ if (u16(entry) === ORIENTATION_TAG && u16(entry + 2) === SHORT_TYPE) {
63
+ const orientation = u16(entry + 8);
64
+ return orientation >= UPRIGHT && orientation <= MAX_ORIENTATION ? orientation : undefined;
65
+ }
66
+ }
67
+ return undefined;
68
+ }
69
+ /** A little-endian TIFF block whose IFD0 holds the orientation and nothing else. */
70
+ function orientationTiff(orientation) {
71
+ const tiff = Buffer.alloc(26);
72
+ tiff.write('II', 0, 'latin1');
73
+ tiff.writeUInt16LE(42, 2);
74
+ tiff.writeUInt32LE(8, 4);
75
+ tiff.writeUInt16LE(1, 8);
76
+ tiff.writeUInt16LE(ORIENTATION_TAG, 10);
77
+ tiff.writeUInt16LE(SHORT_TYPE, 12);
78
+ tiff.writeUInt32LE(1, 14);
79
+ tiff.writeUInt16LE(orientation, 18);
80
+ return tiff;
81
+ }
82
+ /** JFIF, the colour profile and Adobe's colour transform (CMYK needs it); every other application segment carries metadata. */
83
+ function keepsJpegSegment(marker, payload) {
84
+ if (marker === COMMENT) {
85
+ return false;
86
+ }
87
+ if (marker < APP0 || marker > APP15) {
88
+ return true;
89
+ }
90
+ if (marker === APP0) {
91
+ return JFIF_HEADERS.includes(payload.toString('latin1', 0, 5));
92
+ }
93
+ return (marker === APP2 && payload.toString('latin1', 0, ICC_HEADER.length) === ICC_HEADER) || marker === APP14;
94
+ }
95
+ /**
96
+ * Where the entropy-coded data after a scan header ends: at the first marker, where a 0xFF
97
+ * is neither stuffed (0xFF00), a restart marker (0xFFD0 to 0xFFD7) nor fill before a marker.
98
+ */
99
+ function findScanEnd(bytes, from) {
100
+ for (let offset = from; offset + 1 < bytes.length; offset++) {
101
+ const next = bytes[offset + 1];
102
+ if (bytes[offset] === 0xff && next !== 0x00 && next !== 0xff && (next < RESTART_FIRST || next > RESTART_LAST)) {
103
+ return offset;
104
+ }
105
+ }
106
+ return bytes.length;
107
+ }
108
+ function jpegSegment(marker, payload) {
109
+ const header = Buffer.from([0xff, marker, 0, 0]);
110
+ header.writeUInt16BE(payload.length + 2, 2);
111
+ return Buffer.concat([header, payload]);
112
+ }
113
+ /**
114
+ * The JPEG up to its end marker without metadata segments, or null when its structure does not read
115
+ * before the image data. Past that it is as lenient as image viewers: a photo cut off in transfer keeps
116
+ * what arrived, stray bytes between segments are skipped.
117
+ */
118
+ function stripJpeg(bytes) {
119
+ if (bytes.length < 4 || bytes[0] !== 0xff || bytes[1] !== JPEG_START) {
120
+ return null;
121
+ }
122
+ const parts = [bytes.subarray(0, 2)];
123
+ // EXIF follows JFIF when there is one, as JFIF must come first.
124
+ let exifIndex = 1;
125
+ let orientation;
126
+ let scanned = false;
127
+ const finish = () => {
128
+ if (orientation !== undefined && orientation !== UPRIGHT) {
129
+ parts.splice(exifIndex, 0, jpegSegment(APP1, Buffer.concat([EXIF_HEADER, orientationTiff(orientation)])));
130
+ }
131
+ return Buffer.concat(parts);
132
+ };
133
+ let offset = 2;
134
+ while (offset + 1 < bytes.length) {
135
+ const marker = bytes[offset + 1];
136
+ if (bytes[offset] !== 0xff || marker === 0xff) {
137
+ offset++;
138
+ continue;
139
+ }
140
+ if (marker === JPEG_END) {
141
+ if (!scanned) {
142
+ return null;
143
+ }
144
+ parts.push(bytes.subarray(offset, offset + 2));
145
+ // Anything after the end, such as further images with their own EXIF, is cut off.
146
+ return finish();
147
+ }
148
+ if (marker === TEMPORARY || (marker >= RESTART_FIRST && marker <= RESTART_LAST)) {
149
+ parts.push(bytes.subarray(offset, offset + 2));
150
+ offset += 2;
151
+ continue;
152
+ }
153
+ const length = offset + 4 <= bytes.length ? bytes.readUInt16BE(offset + 2) : 0;
154
+ const end = offset + 2 + length;
155
+ if (length < 2 || end > bytes.length) {
156
+ return scanned ? finish() : null;
157
+ }
158
+ const payload = bytes.subarray(offset + 4, end);
159
+ if (marker === APP1 && payload.subarray(0, EXIF_HEADER.length).equals(EXIF_HEADER)) {
160
+ orientation ??= readOrientation(payload.subarray(EXIF_HEADER.length));
161
+ }
162
+ if (keepsJpegSegment(marker, payload)) {
163
+ parts.push(bytes.subarray(offset, end));
164
+ if (marker === APP0 && parts.length === 2) {
165
+ exifIndex = 2;
166
+ }
167
+ }
168
+ offset = end;
169
+ if (marker === START_OF_SCAN) {
170
+ scanned = true;
171
+ const scanEnd = findScanEnd(bytes, offset);
172
+ parts.push(bytes.subarray(offset, scanEnd));
173
+ offset = scanEnd;
174
+ }
175
+ }
176
+ return scanned ? finish() : null;
177
+ }
178
+ function pngChunk(type, data) {
179
+ const typeAndData = Buffer.concat([Buffer.from(type, 'latin1'), data]);
180
+ const chunk = Buffer.alloc(typeAndData.length + 8);
181
+ chunk.writeUInt32BE(data.length, 0);
182
+ typeAndData.copy(chunk, 4);
183
+ chunk.writeUInt32BE(crc32(typeAndData), chunk.length - 4);
184
+ return chunk;
185
+ }
186
+ /** The PNG up to its end chunk without metadata chunks, or null when its chunks do not read. */
187
+ function stripPng(bytes) {
188
+ if (!bytes.subarray(0, PNG_SIGNATURE.length).equals(PNG_SIGNATURE)) {
189
+ return null;
190
+ }
191
+ const parts = [PNG_SIGNATURE];
192
+ // eXIf must come before the image data; right after the header is always early enough.
193
+ let exifIndex = 1;
194
+ let orientation;
195
+ for (let offset = PNG_SIGNATURE.length; offset + 12 <= bytes.length;) {
196
+ const length = bytes.readUInt32BE(offset);
197
+ const end = offset + 12 + length;
198
+ if (end > bytes.length) {
199
+ return null;
200
+ }
201
+ const type = bytes.toString('latin1', offset + 4, offset + 8);
202
+ if (type === 'eXIf') {
203
+ orientation ??= readOrientation(bytes.subarray(offset + 8, offset + 8 + length));
204
+ }
205
+ if (PNG_IMAGE_CHUNKS.has(type)) {
206
+ parts.push(bytes.subarray(offset, end));
207
+ }
208
+ if (type === 'IHDR') {
209
+ exifIndex = parts.length;
210
+ }
211
+ if (type === 'IEND') {
212
+ if (orientation !== undefined && orientation !== UPRIGHT) {
213
+ parts.splice(exifIndex, 0, pngChunk('eXIf', orientationTiff(orientation)));
214
+ }
215
+ return Buffer.concat(parts);
216
+ }
217
+ offset = end;
218
+ }
219
+ return null;
220
+ }
221
+ function riffChunk(type, payload) {
222
+ const chunk = Buffer.alloc(RIFF_CHUNK_HEADER_SIZE + payload.length + (payload.length & 1));
223
+ chunk.write(type, 0, 'latin1');
224
+ chunk.writeUInt32LE(payload.length, 4);
225
+ payload.copy(chunk, RIFF_CHUNK_HEADER_SIZE);
226
+ return chunk;
227
+ }
228
+ /**
229
+ * The WebP without metadata chunks, or null when its chunks do not read or none draws the image.
230
+ * Bytes after the RIFF size are cut off. The orientation needs the extended format (VP8X) to be
231
+ * written back, as a simple WebP cannot hold EXIF at all.
232
+ */
233
+ function stripWebp(bytes) {
234
+ if (bytes.length < WEBP_HEADER_SIZE || bytes.toString('latin1', 0, 4) !== 'RIFF' || bytes.toString('latin1', 8, 12) !== 'WEBP') {
235
+ return null;
236
+ }
237
+ const end = RIFF_CHUNK_HEADER_SIZE + bytes.readUInt32LE(4);
238
+ if (end > bytes.length) {
239
+ return null;
240
+ }
241
+ const chunks = [];
242
+ let extended;
243
+ let orientation;
244
+ let drawn = false;
245
+ for (let offset = WEBP_HEADER_SIZE; offset < end;) {
246
+ const dataStart = offset + RIFF_CHUNK_HEADER_SIZE;
247
+ const dataEnd = dataStart + (dataStart <= end ? bytes.readUInt32LE(offset + 4) : 0);
248
+ if (dataStart > end || dataEnd > end) {
249
+ return null;
250
+ }
251
+ const type = bytes.toString('latin1', offset, offset + 4);
252
+ const payload = bytes.subarray(dataStart, dataEnd);
253
+ if (type === 'EXIF') {
254
+ // The format wants the TIFF block alone; some writers put the JPEG `Exif` header first.
255
+ orientation ??= readOrientation(payload.subarray(0, EXIF_HEADER.length).equals(EXIF_HEADER) ? payload.subarray(EXIF_HEADER.length) : payload);
256
+ }
257
+ if (WEBP_IMAGE_CHUNKS.has(type)) {
258
+ if (type === 'VP8X') {
259
+ extended ??= { index: chunks.length, flags: Buffer.from(payload) };
260
+ }
261
+ chunks.push(riffChunk(type, payload));
262
+ drawn ||= WEBP_BITSTREAM_CHUNKS.has(type);
263
+ }
264
+ offset = dataEnd + ((dataEnd - dataStart) & 1);
265
+ }
266
+ if (!drawn) {
267
+ return null;
268
+ }
269
+ if (extended?.flags.length) {
270
+ const { index, flags } = extended;
271
+ const writesOrientation = orientation !== undefined && orientation !== UPRIGHT;
272
+ flags[0] = (flags[0] & ~(VP8X_EXIF | VP8X_XMP)) | (writesOrientation ? VP8X_EXIF : 0);
273
+ chunks[index] = riffChunk('VP8X', flags);
274
+ if (writesOrientation) {
275
+ // EXIF goes after the image data.
276
+ chunks.push(riffChunk('EXIF', orientationTiff(orientation)));
277
+ }
278
+ }
279
+ const header = Buffer.alloc(WEBP_HEADER_SIZE);
280
+ header.write('RIFF', 0, 'latin1');
281
+ header.writeUInt32LE(4 + chunks.reduce((sum, chunk) => sum + chunk.length, 0), 4);
282
+ header.write('WEBP', 8, 'latin1');
283
+ return Buffer.concat([header, ...chunks]);
284
+ }
285
+ /**
286
+ * The bytes to store for an upload: a photo without its metadata, any other file
287
+ * unchanged; null for a photo whose structure does not read.
288
+ */
289
+ export function stripPhotoMetadata(extension, bytes) {
290
+ const content = Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength);
291
+ switch (extension) {
292
+ case 'jpg':
293
+ case 'jpeg':
294
+ return stripJpeg(content);
295
+ case 'png':
296
+ return stripPng(content);
297
+ case 'webp':
298
+ return stripWebp(content);
299
+ case 'heic':
300
+ case 'heif':
301
+ case 'avif':
302
+ return stripHeif(content);
303
+ default:
304
+ return bytes;
305
+ }
306
+ }
307
+ //# sourceMappingURL=photo-metadata.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"photo-metadata.js","sourceRoot":"","sources":["../src/photo-metadata.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Finds out whether a legacy PowerPoint file (.ppt) holds a VBA project or an embedded OLE
3
+ * object. PowerPoint compresses both into its document stream as ExOleObjStg records, so no
4
+ * storage shows in the OLE directory; the VBAInfoAtom of the DocumentContainer also says
5
+ * whether there is a project.
6
+ */
7
+ /** Whether the CurrentUserAtom marks the file as encrypted. */
8
+ export declare function isEncryptedPowerPoint(currentUser: Buffer): boolean;
9
+ /**
10
+ * Whether a user edit's persist directory points at an OLE object storage, or at a
11
+ * DocumentContainer that holds a VBA project; null for an encrypted or malformed file.
12
+ */
13
+ export declare function hasPowerPointCode(stream: Buffer, currentUser: Buffer): boolean | null;
14
+ //# sourceMappingURL=powerpoint-vba.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"powerpoint-vba.d.ts","sourceRoot":"","sources":["../src/powerpoint-vba.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqEH,+DAA+D;AAC/D,wBAAgB,qBAAqB,CAAE,WAAW,EAAE,MAAM,GAAI,OAAO,CAGpE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAI,OAAO,GAAG,IAAI,CAmDvF"}
@@ -0,0 +1,122 @@
1
+ /**
2
+ * Finds out whether a legacy PowerPoint file (.ppt) holds a VBA project or an embedded OLE
3
+ * object. PowerPoint compresses both into its document stream as ExOleObjStg records, so no
4
+ * storage shows in the OLE directory; the VBAInfoAtom of the DocumentContainer also says
5
+ * whether there is a project.
6
+ */
7
+ const RECORD_HEADER_SIZE = 8;
8
+ const CURRENT_USER_ATOM = 0x0ff6;
9
+ /** The atom's header, size, token and the offset of the current edit. */
10
+ const CURRENT_USER_FIELDS_END = 20;
11
+ // Encrypted files carry another token; their records cannot be read without the password.
12
+ const UNENCRYPTED_TOKEN = 0xe391c05f;
13
+ const ENCRYPTED_TOKEN = 0xf3d1c4df;
14
+ const USER_EDIT_ATOM = 0x0ff5;
15
+ const USER_EDIT_SIZE = 28;
16
+ const PERSIST_DIRECTORY_ATOM = 0x1772;
17
+ const DOCUMENT_CONTAINER = 0x03e8;
18
+ /** RT_ExternalOleObjectStg, the storage of an embedded object or of the VBA project. */
19
+ const EX_OLE_OBJECT_STORAGE = 0x1011;
20
+ // DocumentContainer > DocInfoListContainer > VBAInfoContainer > VBAInfoAtom.
21
+ const VBA_INFO_PATH = [0x07d0, 0x03ff, 0x0400];
22
+ const VBA_INFO_SIZE = 12;
23
+ /** Caps far above real files (at most a few hundred of each) that bound a crafted one. */
24
+ const MAX_EDITS = 4096;
25
+ const MAX_PERSIST_OFFSETS = 65536;
26
+ const MAX_RECORDS = 65536;
27
+ function readRecord(stream, offset) {
28
+ if (offset + RECORD_HEADER_SIZE > stream.length) {
29
+ return null;
30
+ }
31
+ const end = offset + RECORD_HEADER_SIZE + stream.readUInt32LE(offset + 4);
32
+ return end <= stream.length ? { type: stream.readUInt16LE(offset + 2), start: offset + RECORD_HEADER_SIZE, end } : null;
33
+ }
34
+ /** The records within a container's body, or null when one runs past it or the budget runs out. */
35
+ function readChildren(stream, container, budget) {
36
+ const children = [];
37
+ for (let offset = container.start; offset < container.end;) {
38
+ const child = readRecord(stream, offset);
39
+ if (!child || child.end > container.end || --budget.records < 0) {
40
+ return null;
41
+ }
42
+ children.push(child);
43
+ offset = child.end;
44
+ }
45
+ return children;
46
+ }
47
+ /** Whether a DocumentContainer's VBAInfoAtom sets `fHasMacros` or a `persistIdRef`, or null when malformed. */
48
+ function documentHasVba(stream, document, budget) {
49
+ let records = [document];
50
+ for (const type of VBA_INFO_PATH) {
51
+ const children = records.map((record) => readChildren(stream, record, budget));
52
+ if (children.includes(null)) {
53
+ return null;
54
+ }
55
+ records = children.flat().filter((child) => child?.type === type);
56
+ }
57
+ if (records.some((atom) => atom.end - atom.start < VBA_INFO_SIZE)) {
58
+ return null;
59
+ }
60
+ // A reference alone counts, in case PowerPoint loads the project despite a cleared flag.
61
+ return records.some((atom) => stream.readUInt32LE(atom.start) !== 0 || stream.readUInt32LE(atom.start + 4) !== 0);
62
+ }
63
+ /** Whether the CurrentUserAtom marks the file as encrypted. */
64
+ export function isEncryptedPowerPoint(currentUser) {
65
+ const user = readRecord(currentUser, 0);
66
+ return user?.type === CURRENT_USER_ATOM && user.end >= CURRENT_USER_FIELDS_END && currentUser.readUInt32LE(12) === ENCRYPTED_TOKEN;
67
+ }
68
+ /**
69
+ * Whether a user edit's persist directory points at an OLE object storage, or at a
70
+ * DocumentContainer that holds a VBA project; null for an encrypted or malformed file.
71
+ */
72
+ export function hasPowerPointCode(stream, currentUser) {
73
+ const user = readRecord(currentUser, 0);
74
+ if (user?.type !== CURRENT_USER_ATOM || user.end < CURRENT_USER_FIELDS_END ||
75
+ currentUser.readUInt32LE(12) !== UNENCRYPTED_TOKEN) {
76
+ return null;
77
+ }
78
+ const visited = new Set();
79
+ const documents = new Set();
80
+ let persistOffsets = 0;
81
+ let editOffset = currentUser.readUInt32LE(16);
82
+ do {
83
+ const edit = readRecord(stream, editOffset);
84
+ if (edit?.type !== USER_EDIT_ATOM || edit.end - edit.start < USER_EDIT_SIZE ||
85
+ visited.has(editOffset) || visited.size === MAX_EDITS) {
86
+ return null;
87
+ }
88
+ visited.add(editOffset);
89
+ const directory = readRecord(stream, stream.readUInt32LE(edit.start + 12));
90
+ if (directory?.type !== PERSIST_DIRECTORY_ATOM) {
91
+ return null;
92
+ }
93
+ // Each entry packs a 20-bit first persist ID and a 12-bit count of the offsets that follow.
94
+ for (let position = directory.start; position < directory.end;) {
95
+ const count = position + 4 <= directory.end ? stream.readUInt32LE(position) >>> 20 : -1;
96
+ const offsetsEnd = position + 4 + count * 4;
97
+ persistOffsets += count;
98
+ if (count < 0 || offsetsEnd > directory.end || persistOffsets > MAX_PERSIST_OFFSETS) {
99
+ return null;
100
+ }
101
+ for (let entry = position + 4; entry < offsetsEnd; entry += 4) {
102
+ const offset = stream.readUInt32LE(entry);
103
+ const type = readRecord(stream, offset)?.type;
104
+ if (type === EX_OLE_OBJECT_STORAGE) {
105
+ return true;
106
+ }
107
+ if (type === DOCUMENT_CONTAINER) {
108
+ documents.add(offset);
109
+ }
110
+ }
111
+ position = offsetsEnd;
112
+ }
113
+ editOffset = stream.readUInt32LE(edit.start + 8);
114
+ } while (editOffset !== 0);
115
+ if (!documents.size) {
116
+ return null;
117
+ }
118
+ const budget = { records: MAX_RECORDS };
119
+ const verdicts = Array.from(documents, (offset) => documentHasVba(stream, readRecord(stream, offset), budget));
120
+ return verdicts.includes(null) ? null : verdicts.includes(true);
121
+ }
122
+ //# sourceMappingURL=powerpoint-vba.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"powerpoint-vba.js","sourceRoot":"","sources":["../src/powerpoint-vba.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Checks that a text upload is text, and that a CSV file holds no formula that runs something
3
+ * when Excel or another spreadsheet opens it (CSV injection).
4
+ */
5
+ /** Whether a text upload is text, and for CSV free of formulas that call a function or DDE. */
6
+ export declare function inspectText(bytes: Uint8Array, csv: boolean): 'valid' | 'macros' | 'mismatch';
7
+ //# sourceMappingURL=text-content.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"text-content.d.ts","sourceRoot":"","sources":["../src/text-content.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmEH,+FAA+F;AAC/F,wBAAgB,WAAW,CAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,GAAI,OAAO,GAAG,QAAQ,GAAG,UAAU,CAa9F"}
@@ -0,0 +1,83 @@
1
+ /**
2
+ * Checks that a text upload is text, and that a CSV file holds no formula that runs something
3
+ * when Excel or another spreadsheet opens it (CSV injection).
4
+ */
5
+ const UTF16LE_BOM = [0xff, 0xfe];
6
+ const UTF16BE_BOM = [0xfe, 0xff];
7
+ const UTF8_BOM = '';
8
+ // Text has tabs, line breaks and form feeds, but no other control characters; NUL marks UTF-16 without a byte order mark or binary data.
9
+ const CONTROL_CHARACTER = /[\0-\x08\x0b\x0e-\x1f\x7f]/;
10
+ // Excel and others evaluate a cell that starts with one of these (after spaces, tabs or quotes).
11
+ const FORMULA_START = /^[\s"]*[=+\-@]/;
12
+ // A formula runs something through a function call (HYPERLINK, WEBSERVICE) or a DDE source (`cmd|'/c calc'!A1`).
13
+ // Excel allows no space between a function and its parenthesis, so numbers such as `-5`, `+49 (30) 1234` or
14
+ // `+66 2 550 6555; Counter (Gate A)` and plain arithmetic stay allowed.
15
+ const FUNCTION_CALL_OR_DDE = /[A-Za-z_][\w.]*\(|\|/;
16
+ // Splitting on every common delimiter at once only finds more cell starts than a spreadsheet would.
17
+ const CELL_DELIMITERS = /[,;\t\r\n]/g;
18
+ function startsWith(bytes, signature) {
19
+ return signature.every((byte, index) => bytes[index] === byte);
20
+ }
21
+ /** The text of an upload: UTF-16 by its byte order mark, else UTF-8, else Latin-1 (as Windows code pages read). */
22
+ function decodeText(bytes) {
23
+ if (startsWith(bytes, UTF16LE_BOM) || startsWith(bytes, UTF16BE_BOM)) {
24
+ const encoding = startsWith(bytes, UTF16LE_BOM) ? 'utf-16le' : 'utf-16be';
25
+ try {
26
+ return new TextDecoder(encoding, { fatal: true }).decode(bytes);
27
+ }
28
+ catch {
29
+ return '\0';
30
+ }
31
+ }
32
+ try {
33
+ return new TextDecoder('utf-8', { fatal: true, ignoreBOM: true }).decode(bytes).replace(UTF8_BOM, '');
34
+ }
35
+ catch {
36
+ return Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength).toString('latin1');
37
+ }
38
+ }
39
+ /** The cells of a CSV text, unquoted, split on any common delimiter; quoted cells may span lines. */
40
+ function* readCells(text) {
41
+ let position = 0;
42
+ while (position <= text.length) {
43
+ let cell = '';
44
+ if (text[position] === '"') {
45
+ position++;
46
+ for (;;) {
47
+ const close = text.indexOf('"', position);
48
+ if (close < 0) {
49
+ cell += text.slice(position);
50
+ position = text.length;
51
+ break;
52
+ }
53
+ cell += text.slice(position, close);
54
+ position = close + 1;
55
+ if (text[position] !== '"') {
56
+ break;
57
+ }
58
+ cell += '"';
59
+ position++;
60
+ }
61
+ }
62
+ CELL_DELIMITERS.lastIndex = position;
63
+ const end = CELL_DELIMITERS.exec(text)?.index ?? text.length;
64
+ yield cell + text.slice(position, end);
65
+ position = end + 1;
66
+ }
67
+ }
68
+ /** Whether a text upload is text, and for CSV free of formulas that call a function or DDE. */
69
+ export function inspectText(bytes, csv) {
70
+ const text = decodeText(bytes);
71
+ if (CONTROL_CHARACTER.test(text)) {
72
+ return 'mismatch';
73
+ }
74
+ if (csv) {
75
+ for (const cell of readCells(text)) {
76
+ if (FORMULA_START.test(cell) && FUNCTION_CALL_OR_DDE.test(cell)) {
77
+ return 'macros';
78
+ }
79
+ }
80
+ }
81
+ return 'valid';
82
+ }
83
+ //# sourceMappingURL=text-content.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"text-content.js","sourceRoot":"","sources":["../src/text-content.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,48 @@
1
+ /**
2
+ * Strict allowlist + validation for document uploads: PDF, MS Office (also the
3
+ * legacy formats), LibreOffice, photos (JPEG, PNG, WebP, HEIC/HEIF, AVIF) and CSV and text. Validation happens on three axes: file
4
+ * extension, declared MIME type, and the actual content, i.e. the magic-byte
5
+ * signature plus the parts a file of that kind always has. Extension and MIME
6
+ * alone are trivially spoofed.
7
+ */
8
+ export type AllowedExtension = 'pdf' | 'doc' | 'docx' | 'ppt' | 'pptx' | 'xls' | 'xlsx' | 'odt' | 'ods' | 'odp' | 'jpg' | 'jpeg' | 'png' | 'webp' | 'heic' | 'heif' | 'avif' | 'csv' | 'txt';
9
+ export declare const ALLOWED_EXTENSIONS: readonly AllowedExtension[];
10
+ /** The `accept` attribute value for a file input that takes `extensions`. */
11
+ export declare function acceptAttribute(extensions?: readonly AllowedExtension[]): string;
12
+ export interface UploadDescriptor {
13
+ filename: string;
14
+ mimeType: string;
15
+ size: number;
16
+ }
17
+ export interface UploadOptions {
18
+ maxBytes: number;
19
+ /** Narrows the built-in allowlist; defaults to every type in it. */
20
+ allowedExtensions?: readonly AllowedExtension[];
21
+ }
22
+ export type DescriptorRejection = 'empty' | 'too-large' | 'type-not-allowed' | 'mime-mismatch';
23
+ export type ValidationResult = {
24
+ ok: true;
25
+ extension: AllowedExtension;
26
+ sanitizedFilename: string;
27
+ } | {
28
+ ok: false;
29
+ reason: DescriptorRejection;
30
+ };
31
+ export declare function getExtension(filename: string): string;
32
+ /** Strips directory components and control characters from a user filename. */
33
+ export declare function sanitizeFilename(filename: string): string;
34
+ /**
35
+ * Validates a descriptor (no byte access). Use {@link inspectFileContent} in
36
+ * addition once the bytes are available.
37
+ */
38
+ export declare function validateUploadDescriptor(descriptor: UploadDescriptor, { maxBytes, allowedExtensions }: UploadOptions): ValidationResult;
39
+ /** The canonical MIME type to persist for a validated extension. */
40
+ export declare function getCanonicalMimeType(extension: AllowedExtension): string;
41
+ /** What an upload's bytes turned out to be; `macros` and `encrypted` get their own refusal messages. */
42
+ export type FileContentVerdict = 'valid' | 'macros' | 'encrypted' | 'mismatch';
43
+ /**
44
+ * Checks once that a file's bytes are what `extension` claims: the signature
45
+ * of its family and every part a file of that kind contains, but no macros.
46
+ */
47
+ export declare function inspectFileContent(extension: AllowedExtension, bytes: Uint8Array): FileContentVerdict;
48
+ //# sourceMappingURL=upload-allowlist.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upload-allowlist.d.ts","sourceRoot":"","sources":["../src/upload-allowlist.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,MAAM,MAAM,gBAAgB,GACzB,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAChF,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AA4Y9E,eAAO,MAAM,kBAAkB,EAAE,SAAS,gBAAgB,EAAoD,CAAC;AAE/G,6EAA6E;AAC7E,wBAAgB,eAAe,CAAE,UAAU,GAAE,SAAS,gBAAgB,EAAuB,GAAI,MAAM,CAEtG;AAKD,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAChD;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,WAAW,GAAG,kBAAkB,GAAG,eAAe,CAAC;AAE/F,MAAM,MAAM,gBAAgB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,gBAAgB,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAE9C,wBAAgB,YAAY,CAAE,QAAQ,EAAE,MAAM,GAAI,MAAM,CAMvD;AA4BD,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAE,QAAQ,EAAE,MAAM,GAAI,MAAM,CAsB3D;AAMD;;;GAGG;AACH,wBAAgB,wBAAwB,CACvC,UAAU,EAAE,gBAAgB,EAC5B,EAAE,QAAQ,EAAE,iBAAsC,EAAE,EAAE,aAAa,GACjE,gBAAgB,CAwBlB;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAE,SAAS,EAAE,gBAAgB,GAAI,MAAM,CAE1E;AA+BD,wGAAwG;AACxG,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;AAE/E;;;GAGG;AACH,wBAAgB,kBAAkB,CAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,UAAU,GAAI,kBAAkB,CAwEvG"}