@yefengr/pi-reach 0.0.3 → 0.0.5

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