@yefengr/pi-reach 0.0.4 → 0.0.6

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 (53) hide show
  1. package/dist/attachments/reservation.fixture.d.ts +1 -0
  2. package/dist/attachments/reservation.fixture.js +25 -0
  3. package/dist/attachments/reservation.fixture.js.map +1 -0
  4. package/dist/attachments/reservations.d.ts +21 -0
  5. package/dist/attachments/reservations.js +189 -0
  6. package/dist/attachments/reservations.js.map +1 -0
  7. package/dist/attachments/safe-files.d.ts +17 -0
  8. package/dist/attachments/safe-files.js +108 -0
  9. package/dist/attachments/safe-files.js.map +1 -0
  10. package/dist/attachments/storage-path.d.ts +4 -0
  11. package/dist/attachments/storage-path.js +47 -0
  12. package/dist/attachments/storage-path.js.map +1 -0
  13. package/dist/attachments/store.d.ts +55 -0
  14. package/dist/attachments/store.js +536 -0
  15. package/dist/attachments/store.js.map +1 -0
  16. package/dist/attachments/types.d.ts +48 -0
  17. package/dist/attachments/types.js +20 -0
  18. package/dist/attachments/types.js.map +1 -0
  19. package/dist/index.js +30 -24
  20. package/dist/index.js.map +1 -1
  21. package/dist/runtime/attachment_binding.d.ts +17 -0
  22. package/dist/runtime/attachment_binding.js +70 -0
  23. package/dist/runtime/attachment_binding.js.map +1 -0
  24. package/dist/runtime/create_owner_binding.d.ts +27 -0
  25. package/dist/runtime/create_owner_binding.js +22 -0
  26. package/dist/runtime/create_owner_binding.js.map +1 -0
  27. package/dist/timeline/attachment_content.d.ts +21 -0
  28. package/dist/timeline/attachment_content.js +83 -0
  29. package/dist/timeline/attachment_content.js.map +1 -0
  30. package/dist/timeline/attachment_delivery.d.ts +65 -0
  31. package/dist/timeline/attachment_delivery.js +150 -0
  32. package/dist/timeline/attachment_delivery.js.map +1 -0
  33. package/dist/timeline/runtime.d.ts +4 -2
  34. package/dist/timeline/runtime.js +33 -34
  35. package/dist/timeline/runtime.js.map +1 -1
  36. package/dist/timeline/user_delivery.d.ts +7 -0
  37. package/dist/timeline/user_delivery.js +21 -12
  38. package/dist/timeline/user_delivery.js.map +1 -1
  39. package/dist/timeline/user_delivery_binding.d.ts +6 -1
  40. package/dist/timeline/user_delivery_binding.js +17 -1
  41. package/dist/timeline/user_delivery_binding.js.map +1 -1
  42. package/dist/timeline/v2_service.d.ts +6 -1
  43. package/dist/timeline/v2_service.js +16 -8
  44. package/dist/timeline/v2_service.js.map +1 -1
  45. package/dist/vendor/protocol/session/attachments.d.ts +78 -0
  46. package/dist/vendor/protocol/session/attachments.js +150 -0
  47. package/dist/vendor/protocol/session/frames.d.ts +500 -0
  48. package/dist/vendor/protocol/session/frames.js +37 -4
  49. package/dist/vendor/protocol/session/index.d.ts +1 -0
  50. package/dist/vendor/protocol/session/index.js +1 -0
  51. package/dist/vendor/protocol/session/schema.d.ts +2 -2
  52. package/dist/vendor/protocol/session/schema.js +2 -0
  53. package/package.json +1 -1
@@ -0,0 +1,536 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { constants } from "node:fs";
3
+ import { open, unlink } from "node:fs/promises";
4
+ import { homedir } from "node:os";
5
+ import { dirname, join, resolve as resolvePath } from "node:path";
6
+ import { ATTACHMENT_CHUNK_BYTES, ATTACHMENT_MAX_COUNT, ATTACHMENT_MAX_FILE_BYTES, ATTACHMENT_MAX_IN_FLIGHT, ATTACHMENT_MAX_MESSAGE_BYTES, attachmentDescriptorSchema, attachmentIdsSchema, idSchema, } from "../vendor/protocol/session/index.js";
7
+ import { DiskReservation } from "./reservations.js";
8
+ import { attachmentStoragePath } from "./storage-path.js";
9
+ import { assertDirectories, assertOwnedDirectory, assertRegularFile, createOwnedDirectory, createPrivateFile, ensurePrivateDirectory, removeOwnedDirectory, } from "./safe-files.js";
10
+ import { AttachmentStoreError, nodeErrorHasCode, storeError, } from "./types.js";
11
+ export { AttachmentStoreError } from "./types.js";
12
+ const DEFAULT_FREE_BYTES = 64 * 1024 * 1024;
13
+ const MAX_OWNER_PENDING = ATTACHMENT_MAX_COUNT * ATTACHMENT_MAX_IN_FLIGHT;
14
+ const MAX_METADATA_RECORDS = 4096;
15
+ // 包括已失效租约尚未完成清理的资源,避免快速 reset 堆积磁盘任务。
16
+ const MAX_GLOBAL_ACTIVE = MAX_OWNER_PENDING;
17
+ function isUpload(entry) {
18
+ return "tail" in entry;
19
+ }
20
+ function freezeDescriptor(descriptor) {
21
+ if (descriptor.preview)
22
+ Object.freeze(descriptor.preview);
23
+ return Object.freeze(descriptor);
24
+ }
25
+ export class AttachmentStore {
26
+ options;
27
+ root;
28
+ floor;
29
+ uploads = new Map();
30
+ byAttachment = new Map();
31
+ resources = new Set();
32
+ metadataLimit;
33
+ ownerPending = new Map();
34
+ cleanups = new Set();
35
+ sessionId;
36
+ lease;
37
+ disposed = false;
38
+ disposing;
39
+ constructor(options) {
40
+ this.options = options;
41
+ if (!idSchema.safeParse(options.runtimeId).success ||
42
+ !Number.isSafeInteger(options.minFreeBytes ?? DEFAULT_FREE_BYTES) ||
43
+ (options.minFreeBytes ?? DEFAULT_FREE_BYTES) < 0)
44
+ throw new AttachmentStoreError("invalid_upload");
45
+ this.root = resolvePath(options.rootDir ?? join(homedir(), ".pi", "pi-reach", "attachments"));
46
+ this.floor = BigInt(options.minFreeBytes ?? DEFAULT_FREE_BYTES);
47
+ this.metadataLimit = options.testHooks?.metadataLimit ?? MAX_METADATA_RECORDS;
48
+ if (!Number.isSafeInteger(this.metadataLimit) || this.metadataLimit < 1 || this.metadataLimit > MAX_METADATA_RECORDS) {
49
+ throw new AttachmentStoreError("invalid_upload");
50
+ }
51
+ }
52
+ scopeFor(sessionId) {
53
+ if (this.disposed || !idSchema.safeParse(sessionId).success)
54
+ throw new AttachmentStoreError("invalid_scope");
55
+ if (this.sessionId !== sessionId)
56
+ this.resetScope(sessionId);
57
+ return this.lease;
58
+ }
59
+ resetScope(sessionId) {
60
+ if (this.disposed || !idSchema.safeParse(sessionId).success)
61
+ throw new AttachmentStoreError("invalid_scope");
62
+ this.sessionId = sessionId;
63
+ this.lease = randomUUID();
64
+ this.uploads = new Map();
65
+ this.byAttachment = new Map();
66
+ // 索引只覆盖当前租约;此前失败的清理仍在资源集合中,后续 reset 也须重试。
67
+ for (const entry of this.resources) {
68
+ if (entry.retained)
69
+ continue;
70
+ entry.cancelled = true;
71
+ void this.scheduleCleanup(entry).catch(() => undefined);
72
+ }
73
+ // 旧 retained / 墓碑立即释放;原件仅留磁盘。活资源清理后释放最后引用。
74
+ }
75
+ validScope(scope) {
76
+ return !this.disposed && idSchema.safeParse(scope.ownerId).success &&
77
+ scope.sessionId === this.sessionId && scope.uploadScope === this.lease;
78
+ }
79
+ checkScope(scope) {
80
+ if (!this.validScope(scope))
81
+ throw new AttachmentStoreError("invalid_scope");
82
+ }
83
+ key(scope, uploadId) {
84
+ this.checkScope(scope);
85
+ if (!idSchema.safeParse(uploadId).success)
86
+ throw new AttachmentStoreError("invalid_upload");
87
+ return JSON.stringify([scope.ownerId, scope.sessionId, scope.uploadScope, uploadId]);
88
+ }
89
+ newUpload(key, scope) {
90
+ return {
91
+ key, scope: { ...scope }, hash: createHash("sha256"), received: 0, complete: false,
92
+ cancelled: false, retained: false, tail: Promise.resolve(), pending: 0,
93
+ };
94
+ }
95
+ checkMetadataBudget(scope) {
96
+ const ownerCount = [...this.uploads.values()].filter((entry) => entry.scope.ownerId === scope.ownerId).length;
97
+ if (this.uploads.size >= this.metadataLimit || ownerCount >= this.metadataLimit) {
98
+ throw new AttachmentStoreError("busy", true);
99
+ }
100
+ }
101
+ /** 仅测试观察数量,不包含路径、元信息或原始错误。 */
102
+ debugCounts() {
103
+ return { records: this.uploads.size, attachments: this.byAttachment.size, resources: this.resources.size,
104
+ cleanups: this.cleanups.size, pending: [...this.ownerPending.values()].reduce((sum, count) => sum + count, 0) };
105
+ }
106
+ state(upload, uploadId) {
107
+ if (!isUpload(upload) || (upload.cancelled && !upload.retained)) {
108
+ return { uploadId, receivedBytes: upload.received, status: "cancelled" };
109
+ }
110
+ return {
111
+ uploadId, receivedBytes: upload.received, status: upload.complete ? "complete" : "receiving",
112
+ ...(upload.complete ? { attachment: upload.descriptor } : {}),
113
+ };
114
+ }
115
+ enqueue(upload, operation, internal = false) {
116
+ const owner = upload.scope.ownerId;
117
+ const pending = this.ownerPending.get(owner) ?? 0;
118
+ if (!internal && (upload.pending >= ATTACHMENT_MAX_IN_FLIGHT || pending >= MAX_OWNER_PENDING)) {
119
+ return Promise.reject(new AttachmentStoreError("busy", true));
120
+ }
121
+ upload.pending++;
122
+ this.ownerPending.set(owner, pending + 1);
123
+ const task = upload.tail.then(async () => {
124
+ if (!internal)
125
+ this.checkScope(upload.scope);
126
+ try {
127
+ return await operation();
128
+ }
129
+ catch (error) {
130
+ throw storeError(error);
131
+ }
132
+ });
133
+ upload.tail = task.then(() => undefined, () => undefined).finally(() => {
134
+ upload.pending--;
135
+ const remaining = (this.ownerPending.get(owner) ?? 1) - 1;
136
+ if (remaining)
137
+ this.ownerPending.set(owner, remaining);
138
+ else
139
+ this.ownerPending.delete(owner);
140
+ });
141
+ return task;
142
+ }
143
+ get(scope, uploadId) {
144
+ const upload = this.uploads.get(this.key(scope, uploadId));
145
+ if (!upload)
146
+ throw new AttachmentStoreError("not_found");
147
+ return upload;
148
+ }
149
+ assertFile(upload, finished = false) {
150
+ try {
151
+ if (!upload.path)
152
+ throw new AttachmentStoreError("invalid_upload");
153
+ assertDirectories(dirname(upload.path));
154
+ if (upload.directory)
155
+ assertOwnedDirectory(upload.directory);
156
+ const stat = assertRegularFile(upload.path);
157
+ if (stat.ino !== upload.inode || stat.dev !== upload.device || stat.nlink !== 1 ||
158
+ (finished && stat.size !== upload.input?.byteLength))
159
+ throw new AttachmentStoreError("invalid_upload");
160
+ }
161
+ catch (error) {
162
+ throw storeError(error);
163
+ }
164
+ }
165
+ checkedState(upload, uploadId) {
166
+ this.checkScope(upload.scope);
167
+ if (upload.failure && !upload.cancelled)
168
+ throw upload.failure;
169
+ return this.state(upload, uploadId);
170
+ }
171
+ async begin(scope, input) {
172
+ const key = this.key(scope, input.uploadId);
173
+ if (Number.isFinite(input.byteLength) && input.byteLength > ATTACHMENT_MAX_FILE_BYTES) {
174
+ throw new AttachmentStoreError("too_large");
175
+ }
176
+ const parsed = attachmentDescriptorSchema.safeParse({
177
+ attachment_id: randomUUID(), file_name: input.fileName, mime_type: input.mimeType,
178
+ byte_length: input.byteLength, sha256: input.sha256, ...(input.preview ? { preview: input.preview } : {}),
179
+ });
180
+ if (!parsed.success)
181
+ throw new AttachmentStoreError("invalid_upload");
182
+ const normalized = {
183
+ uploadId: input.uploadId, fileName: parsed.data.file_name, mimeType: parsed.data.mime_type,
184
+ byteLength: parsed.data.byte_length, sha256: parsed.data.sha256,
185
+ ...(parsed.data.preview ? { preview: parsed.data.preview } : {}),
186
+ };
187
+ const existing = this.uploads.get(key);
188
+ if (existing) {
189
+ if (!isUpload(existing) || existing.cancelled)
190
+ return this.state(existing, input.uploadId);
191
+ if (JSON.stringify(existing.input) !== JSON.stringify(normalized))
192
+ throw new AttachmentStoreError("invalid_upload");
193
+ return this.enqueue(existing, async () => this.checkedState(existing, input.uploadId));
194
+ }
195
+ this.checkMetadataBudget(scope);
196
+ if (this.resources.size >= MAX_GLOBAL_ACTIVE || (this.ownerPending.get(scope.ownerId) ?? 0) >= MAX_OWNER_PENDING) {
197
+ throw new AttachmentStoreError("busy", true);
198
+ }
199
+ const active = [...this.resources].filter((upload) => upload.scope.ownerId === scope.ownerId);
200
+ if (active.length >= ATTACHMENT_MAX_COUNT ||
201
+ active.reduce((sum, upload) => sum + (upload.input?.byteLength ?? 0), 0) + input.byteLength > ATTACHMENT_MAX_MESSAGE_BYTES) {
202
+ throw new AttachmentStoreError("too_large");
203
+ }
204
+ const upload = this.newUpload(key, scope);
205
+ upload.input = normalized;
206
+ upload.descriptor = freezeDescriptor(parsed.data);
207
+ // 首次 begin 即冻结本地日期;入队延迟或跨午夜重试都不改变原件位置。
208
+ const path = attachmentStoragePath(this.root, parsed.data.attachment_id, normalized.fileName, new Date());
209
+ this.uploads.set(key, upload);
210
+ this.resources.add(upload);
211
+ return this.enqueue(upload, async () => {
212
+ if (upload.cancelled)
213
+ return this.state(upload, input.uploadId);
214
+ try {
215
+ ensurePrivateDirectory(this.root);
216
+ upload.reservation = new DiskReservation(this.root, this.options.runtimeId, input.uploadId, input.byteLength, this.floor, this.options.testHooks);
217
+ await upload.reservation.publish();
218
+ if (upload.cancelled || !this.validScope(scope)) {
219
+ await this.cleanup(upload);
220
+ return this.checkedState(upload, input.uploadId);
221
+ }
222
+ const attachmentDirectory = dirname(path);
223
+ ensurePrivateDirectory(dirname(attachmentDirectory));
224
+ createOwnedDirectory(attachmentDirectory, (directory) => { upload.directory = directory; });
225
+ upload.handle = await (this.options.testHooks?.createFile ?? createPrivateFile)(path);
226
+ // 成功独占创建后才记录路径;失败不得触碰预先存在的文件。
227
+ upload.path = path;
228
+ const stat = await upload.handle.stat();
229
+ upload.inode = stat.ino;
230
+ upload.device = stat.dev;
231
+ await this.options.testHooks?.afterCreate?.(upload.handle);
232
+ this.byAttachment.set(parsed.data.attachment_id, upload);
233
+ return this.checkedState(upload, input.uploadId);
234
+ }
235
+ catch (error) {
236
+ const failure = storeError(error);
237
+ upload.failure = failure;
238
+ try {
239
+ await this.cleanup(upload);
240
+ }
241
+ catch {
242
+ upload.cancelled = true;
243
+ }
244
+ if (!upload.cancelled && this.uploads.get(key) === upload)
245
+ this.uploads.delete(key);
246
+ throw failure;
247
+ }
248
+ });
249
+ }
250
+ async write(scope, uploadId, offset, bytes) {
251
+ const upload = this.get(scope, uploadId);
252
+ if (!Number.isSafeInteger(offset) || offset < 0 || bytes.byteLength < 1 || bytes.byteLength > ATTACHMENT_CHUNK_BYTES) {
253
+ throw new AttachmentStoreError("invalid_upload");
254
+ }
255
+ if (!isUpload(upload))
256
+ return this.state(upload, uploadId);
257
+ // 请求入队时复制,调用方不可在等待期间修改同一 ArrayBuffer。
258
+ const data = Buffer.from(bytes);
259
+ return this.enqueue(upload, async () => {
260
+ if (upload.cancelled)
261
+ return this.state(upload, uploadId);
262
+ if (upload.failure)
263
+ throw upload.failure;
264
+ this.assertFile(upload);
265
+ if (offset < upload.received) {
266
+ if (offset + data.length > upload.received)
267
+ throw new AttachmentStoreError("offset_mismatch");
268
+ await this.compareChunk(upload, offset, data);
269
+ return this.checkedState(upload, uploadId);
270
+ }
271
+ if (offset !== upload.received)
272
+ throw new AttachmentStoreError("offset_mismatch");
273
+ if (upload.received + data.length > upload.input.byteLength)
274
+ throw new AttachmentStoreError("too_large");
275
+ await upload.reservation.check();
276
+ await this.options.testHooks?.beforeWrite?.();
277
+ if (upload.cancelled || !this.validScope(scope))
278
+ return this.checkedState(upload, uploadId);
279
+ this.assertFile(upload);
280
+ let written = 0;
281
+ try {
282
+ while (written < data.length) {
283
+ const chunk = data.subarray(written);
284
+ const count = this.options.testHooks?.write ?
285
+ await this.options.testHooks.write(upload.handle, chunk, offset + written) :
286
+ (await upload.handle.write(chunk, 0, chunk.length, offset + written)).bytesWritten;
287
+ if (!Number.isSafeInteger(count) || count <= 0 || count > chunk.length)
288
+ throw new AttachmentStoreError("io_error", true);
289
+ written += count;
290
+ }
291
+ }
292
+ catch (error) {
293
+ try {
294
+ await upload.handle.truncate(upload.received);
295
+ }
296
+ catch {
297
+ upload.cancelled = true;
298
+ this.scheduleCleanup(upload);
299
+ }
300
+ throw error;
301
+ }
302
+ upload.hash.update(data);
303
+ upload.received += data.length;
304
+ await this.options.testHooks?.afterWrite?.(data.length);
305
+ // 整块确实落盘后才减少预留;失败时旧账本仍保守占预算。
306
+ await upload.reservation.reduce(upload.input.byteLength - upload.received);
307
+ return this.checkedState(upload, uploadId);
308
+ });
309
+ }
310
+ async compareChunk(upload, offset, data) {
311
+ const temporary = !upload.handle;
312
+ const handle = upload.handle ?? await open(upload.path, constants.O_RDONLY | constants.O_NOFOLLOW);
313
+ try {
314
+ const stat = await handle.stat();
315
+ if (!stat.isFile() || stat.ino !== upload.inode || stat.dev !== upload.device || stat.nlink !== 1) {
316
+ throw new AttachmentStoreError("invalid_upload");
317
+ }
318
+ const previous = Buffer.alloc(data.length);
319
+ let read = 0;
320
+ while (read < previous.length) {
321
+ const result = await handle.read(previous, read, previous.length - read, offset + read);
322
+ if (!result.bytesRead)
323
+ throw new AttachmentStoreError("io_error", true);
324
+ read += result.bytesRead;
325
+ }
326
+ if (!previous.equals(data))
327
+ throw new AttachmentStoreError("integrity_mismatch");
328
+ }
329
+ finally {
330
+ if (temporary)
331
+ await handle.close();
332
+ }
333
+ }
334
+ async finish(scope, uploadId) {
335
+ const upload = this.get(scope, uploadId);
336
+ if (!isUpload(upload))
337
+ return this.state(upload, uploadId);
338
+ return this.enqueue(upload, async () => {
339
+ if (upload.cancelled || upload.complete)
340
+ return this.checkedState(upload, uploadId);
341
+ if (upload.received !== upload.input.byteLength ||
342
+ upload.hash.copy().digest("hex") !== upload.input.sha256)
343
+ throw new AttachmentStoreError("integrity_mismatch");
344
+ this.assertFile(upload, true);
345
+ if (upload.handle) {
346
+ await upload.handle.sync();
347
+ await upload.handle.close();
348
+ upload.handle = undefined;
349
+ }
350
+ await upload.reservation.remove();
351
+ this.checkScope(scope);
352
+ if (!upload.cancelled)
353
+ upload.complete = true;
354
+ return this.state(upload, uploadId);
355
+ });
356
+ }
357
+ async status(scope, uploadId) {
358
+ const upload = this.get(scope, uploadId);
359
+ if (!isUpload(upload))
360
+ return this.state(upload, uploadId);
361
+ return this.enqueue(upload, async () => this.checkedState(upload, uploadId));
362
+ }
363
+ async cancel(scope, uploadId) {
364
+ const key = this.key(scope, uploadId);
365
+ let upload = this.uploads.get(key);
366
+ if (!upload) {
367
+ this.checkMetadataBudget(scope);
368
+ upload = { scope: { ...scope }, cancelled: true, received: 0 };
369
+ this.uploads.set(key, upload);
370
+ }
371
+ if (!isUpload(upload) || upload.retained)
372
+ return this.state(upload, uploadId);
373
+ upload.cancelled = true;
374
+ await this.scheduleCleanup(upload);
375
+ return this.checkedState(upload, uploadId);
376
+ }
377
+ async discard(scope, attachmentId) {
378
+ this.checkScope(scope);
379
+ if (!idSchema.safeParse(attachmentId).success)
380
+ throw new AttachmentStoreError("invalid_upload");
381
+ const upload = this.byAttachment.get(attachmentId);
382
+ if (!upload) {
383
+ // 墓碑沿用有界 uploads 账本,不另存可无限增长的附件 ID 索引。
384
+ const cancelled = [...this.uploads.values()].some((entry) => !isUpload(entry) && entry.attachmentId === attachmentId &&
385
+ entry.scope.ownerId === scope.ownerId && entry.scope.sessionId === scope.sessionId && entry.scope.uploadScope === scope.uploadScope);
386
+ if (cancelled)
387
+ return "cancelled";
388
+ throw new AttachmentStoreError("not_found");
389
+ }
390
+ if (upload.scope.ownerId !== scope.ownerId || upload.scope.sessionId !== scope.sessionId ||
391
+ upload.scope.uploadScope !== scope.uploadScope)
392
+ throw new AttachmentStoreError("not_found");
393
+ if (upload.retained)
394
+ return "retained";
395
+ await this.cancel(scope, upload.input.uploadId);
396
+ return "cancelled";
397
+ }
398
+ resolve(scope, attachmentIds) {
399
+ this.checkScope(scope);
400
+ if (!attachmentIdsSchema.safeParse(attachmentIds).success)
401
+ throw new AttachmentStoreError("invalid_upload");
402
+ let total = 0;
403
+ const resolved = attachmentIds.map((id) => {
404
+ const upload = this.byAttachment.get(id);
405
+ if (!upload || upload.scope.ownerId !== scope.ownerId || upload.scope.sessionId !== scope.sessionId ||
406
+ upload.scope.uploadScope !== scope.uploadScope)
407
+ throw new AttachmentStoreError("not_found");
408
+ if (upload.cancelled || !upload.complete)
409
+ throw new AttachmentStoreError(upload.cancelled ? "cancelled" : "invalid_upload");
410
+ this.assertFile(upload, true);
411
+ total += upload.descriptor.byte_length;
412
+ return Object.freeze({ descriptor: upload.descriptor, path: upload.path });
413
+ });
414
+ if (total > ATTACHMENT_MAX_MESSAGE_BYTES)
415
+ throw new AttachmentStoreError("too_large");
416
+ return Object.freeze(resolved);
417
+ }
418
+ retain(scope, attachmentIds) {
419
+ const resolved = this.resolve(scope, attachmentIds);
420
+ // 同步先完成全部校验再标记;cancel/dispose 无法在中间插入。
421
+ for (const item of resolved) {
422
+ const upload = this.byAttachment.get(item.descriptor.attachment_id);
423
+ upload.retained = true;
424
+ this.resources.delete(upload);
425
+ }
426
+ }
427
+ async cleanup(upload) {
428
+ if (upload.retained)
429
+ return;
430
+ let failure;
431
+ const attempt = async (operation) => {
432
+ try {
433
+ await operation();
434
+ }
435
+ catch (error) {
436
+ failure ??= storeError(error);
437
+ }
438
+ };
439
+ try {
440
+ // stat 初始化失败仍必须关句柄;只有能证明 inode 所有权时才删除路径。
441
+ if (upload.handle && upload.inode === undefined) {
442
+ await attempt(async () => {
443
+ const stat = await upload.handle.stat();
444
+ upload.inode = stat.ino;
445
+ upload.device = stat.dev;
446
+ });
447
+ }
448
+ if (upload.path) {
449
+ await attempt(async () => {
450
+ if (upload.inode === undefined)
451
+ throw new AttachmentStoreError("invalid_upload");
452
+ try {
453
+ assertDirectories(dirname(upload.path));
454
+ if (upload.directory)
455
+ assertOwnedDirectory(upload.directory);
456
+ const stat = assertRegularFile(upload.path);
457
+ if (stat.ino !== upload.inode || stat.dev !== upload.device || stat.nlink !== 1) {
458
+ throw new AttachmentStoreError("invalid_upload");
459
+ }
460
+ await unlink(upload.path);
461
+ }
462
+ catch (error) {
463
+ if (!nodeErrorHasCode(error, "ENOENT"))
464
+ throw error;
465
+ }
466
+ upload.path = undefined;
467
+ });
468
+ }
469
+ }
470
+ finally {
471
+ if (upload.handle) {
472
+ await attempt(async () => {
473
+ await upload.handle.close();
474
+ upload.handle = undefined;
475
+ });
476
+ }
477
+ // 原件路径和句柄均释放后才清理目录;失败保留 identity 供后续真实重试。
478
+ if (!upload.path && !upload.handle && upload.directory) {
479
+ await attempt(async () => {
480
+ removeOwnedDirectory(upload.directory);
481
+ upload.directory = undefined;
482
+ });
483
+ }
484
+ await attempt(async () => {
485
+ await upload.reservation?.remove();
486
+ upload.reservation = undefined;
487
+ });
488
+ }
489
+ // 失败仍占有界资源预算;仅完整释放后提交成功墓碑并撤销该资源的旧错误。
490
+ upload.cleanupFailure = failure;
491
+ if (failure)
492
+ throw failure;
493
+ this.resources.delete(upload);
494
+ if (upload.descriptor && this.byAttachment.get(upload.descriptor.attachment_id) === upload) {
495
+ this.byAttachment.delete(upload.descriptor.attachment_id);
496
+ }
497
+ if (upload.cancelled && this.uploads.get(upload.key) === upload) {
498
+ this.uploads.set(upload.key, { scope: upload.scope, cancelled: true, received: upload.received,
499
+ ...(upload.descriptor ? { attachmentId: upload.descriptor.attachment_id } : {}) });
500
+ }
501
+ }
502
+ scheduleCleanup(upload) {
503
+ if (upload.cleanupTask)
504
+ return upload.cleanupTask;
505
+ const task = this.enqueue(upload, () => this.cleanup(upload), true)
506
+ .finally(() => { upload.cleanupTask = undefined; });
507
+ upload.cleanupTask = task;
508
+ const observed = task.catch(() => undefined);
509
+ this.cleanups.add(observed);
510
+ void observed.then(() => this.cleanups.delete(observed));
511
+ return task;
512
+ }
513
+ dispose() {
514
+ if (this.disposing)
515
+ return this.disposing;
516
+ this.disposed = true;
517
+ for (const upload of this.resources) {
518
+ upload.cancelled = true;
519
+ void this.scheduleCleanup(upload).catch(() => undefined);
520
+ }
521
+ this.disposing = (async () => {
522
+ await Promise.all([...this.cleanups]);
523
+ const failure = [...this.resources].find((upload) => upload.cleanupFailure)?.cleanupFailure;
524
+ if (failure)
525
+ throw failure;
526
+ this.uploads.clear();
527
+ this.byAttachment.clear();
528
+ })().catch((error) => {
529
+ // 保留失败资源,但不缓存拒绝结果;重复 dispose 必须再次执行磁盘清理。
530
+ this.disposing = undefined;
531
+ throw error;
532
+ });
533
+ return this.disposing;
534
+ }
535
+ }
536
+ //# sourceMappingURL=store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/attachments/store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,48 @@
1
+ import type { AttachmentDescriptor, AttachmentPreview } from "../vendor/protocol/session/index.js";
2
+ import type { FileHandle } from "node:fs/promises";
3
+ export type AttachmentErrorCode = "invalid_scope" | "not_found" | "invalid_upload" | "too_large" | "busy" | "no_space" | "io_error" | "integrity_mismatch" | "offset_mismatch" | "cancelled";
4
+ export declare class AttachmentStoreError extends Error {
5
+ readonly code: AttachmentErrorCode;
6
+ readonly retryable: boolean;
7
+ constructor(code: AttachmentErrorCode, retryable?: boolean);
8
+ }
9
+ export interface AttachmentScope {
10
+ ownerId: string;
11
+ sessionId: string;
12
+ uploadScope: string;
13
+ }
14
+ export interface AttachmentBeginInput {
15
+ uploadId: string;
16
+ fileName: string;
17
+ mimeType: string;
18
+ byteLength: number;
19
+ sha256: string;
20
+ preview?: AttachmentPreview;
21
+ }
22
+ export interface AttachmentUploadState {
23
+ uploadId: string;
24
+ receivedBytes: number;
25
+ status: "receiving" | "complete" | "cancelled";
26
+ attachment?: AttachmentDescriptor;
27
+ }
28
+ /** 仅用于隔离测试;生产默认始终使用真实 statfs 和 FileHandle.write。 */
29
+ export interface AttachmentStoreTestHooks {
30
+ availableBytes?: () => bigint | Promise<bigint>;
31
+ /** 假磁盘默认按字节分配;真实磁盘始终取 statfs.bsize。 */
32
+ allocationUnitBytes?: number;
33
+ /** 仅原件创建的故障注入;账本仍使用真实独占创建。 */
34
+ createFile?: (path: string) => Promise<FileHandle>;
35
+ afterCreate?: (handle: FileHandle) => void | Promise<void>;
36
+ metadataLimit?: number;
37
+ beforeWrite?: () => void | Promise<void>;
38
+ write?: (handle: FileHandle, bytes: Uint8Array, position: number) => Promise<number>;
39
+ afterWrite?: (byteLength: number) => void | Promise<void>;
40
+ }
41
+ export interface AttachmentStoreOptions {
42
+ rootDir?: string;
43
+ runtimeId: string;
44
+ minFreeBytes?: number;
45
+ testHooks?: AttachmentStoreTestHooks;
46
+ }
47
+ export declare function storeError(error: unknown): AttachmentStoreError;
48
+ export declare function nodeErrorHasCode(error: unknown, code: string): boolean;
@@ -0,0 +1,20 @@
1
+ export class AttachmentStoreError extends Error {
2
+ code;
3
+ retryable;
4
+ constructor(code, retryable = false) {
5
+ super(`Attachment operation failed (${code}).`);
6
+ this.code = code;
7
+ this.retryable = retryable;
8
+ this.name = "AttachmentStoreError";
9
+ }
10
+ }
11
+ export function storeError(error) {
12
+ if (error instanceof AttachmentStoreError)
13
+ return error;
14
+ const code = typeof error === "object" && error !== null && "code" in error ? error.code : undefined;
15
+ return new AttachmentStoreError(code === "ENOSPC" ? "no_space" : "io_error", true);
16
+ }
17
+ export function nodeErrorHasCode(error, code) {
18
+ return typeof error === "object" && error !== null && "code" in error && error.code === code;
19
+ }
20
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/attachments/types.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACxB;IAAoC;IAAzD,YAAqB,IAAyB,EAAW,YAAY,KAAK;QACxE,KAAK,CAAC,gCAAgC,IAAI,IAAI,CAAC,CAAC;QAD7B,SAAI,GAAJ,IAAI,CAAqB;QAAW,cAAS,GAAT,SAAS,CAAQ;QAExE,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AA6CD,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,KAAK,YAAY,oBAAoB;QAAE,OAAO,KAAK,CAAC;IACxD,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACrG,OAAO,IAAI,oBAAoB,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,IAAY;IAC3D,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AAC/F,CAAC"}