footprintjs 10.5.0 → 10.7.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.
- package/CLAUDE.md +2 -1
- package/dist/esm/index.d.ts +13 -2
- package/dist/esm/index.js +5 -3
- package/dist/esm/lib/attempt/backoff.d.ts +96 -0
- package/dist/esm/lib/attempt/backoff.js +173 -0
- package/dist/esm/lib/attempt/deadline.d.ts +0 -5
- package/dist/esm/lib/attempt/deadline.js +2 -27
- package/dist/esm/lib/attempt/index.d.ts +6 -4
- package/dist/esm/lib/attempt/index.js +6 -5
- package/dist/esm/lib/attempt/runner.js +3 -2
- package/dist/esm/lib/capture/readSources.d.ts +13 -2
- package/dist/esm/lib/capture/readSources.js +11 -3
- package/dist/esm/lib/capture/sourceOwnership.d.ts +21 -0
- package/dist/esm/lib/capture/sourceOwnership.js +133 -0
- package/dist/esm/lib/capture/sourceOwnershipFormat.d.ts +35 -0
- package/dist/esm/lib/capture/sourceOwnershipFormat.js +31 -0
- package/dist/esm/lib/capture/storedReadSourceCounts.d.ts +5 -1
- package/dist/esm/lib/capture/storedReadSourceCounts.js +15 -11
- package/dist/esm/lib/capture/storedReadSources.js +21 -5
- package/dist/esm/lib/capture/storedSourceOwnership.d.ts +8 -0
- package/dist/esm/lib/capture/storedSourceOwnership.js +100 -0
- package/dist/esm/lib/detach/drivers/setTimeout.d.ts +4 -2
- package/dist/esm/lib/detach/drivers/setTimeout.js +12 -2
- package/dist/esm/lib/detach/flush.d.ts +6 -1
- package/dist/esm/lib/detach/flush.js +8 -6
- package/dist/esm/lib/engine/handlers/StageRunner.js +2 -1
- package/dist/esm/lib/memory/StageContext.d.ts +3 -0
- package/dist/esm/lib/memory/StageContext.js +29 -8
- package/dist/esm/lib/memory/frameTypes.d.ts +2 -0
- package/dist/esm/lib/memory/frameTypes.js +1 -1
- package/dist/esm/lib/observer-queue/deferredDispatcher.d.ts +8 -1
- package/dist/esm/lib/observer-queue/deferredDispatcher.js +13 -6
- package/dist/esm/lib/recorder/AttemptRecorder.js +8 -9
- package/dist/esm/lib/runner/FlowChartExecutor.d.ts +7 -2
- package/dist/esm/lib/runner/FlowChartExecutor.js +8 -3
- package/dist/esm/lib/runner/captureHistory.js +6 -4
- package/dist/esm/lib/runner/deadline.js +3 -2
- package/dist/esm/lib/runner/recordSink.d.ts +2 -1
- package/dist/esm/lib/runner/recordSink.js +12 -7
- package/dist/esm/lib/sinks/fileSink.js +7 -6
- package/dist/esm/lib/sinks/indexedAdmission.d.ts +14 -0
- package/dist/esm/lib/sinks/indexedAdmission.js +77 -0
- package/dist/esm/lib/sinks/indexedIO.d.ts +14 -0
- package/dist/esm/lib/sinks/indexedIO.js +98 -0
- package/dist/esm/lib/sinks/indexedRecordFile.d.ts +3 -0
- package/dist/esm/lib/sinks/indexedRecordFile.js +120 -0
- package/dist/esm/lib/sinks/indexedScan.d.ts +6 -0
- package/dist/esm/lib/sinks/indexedScan.js +73 -0
- package/dist/esm/lib/sinks/indexedTypes.d.ts +60 -0
- package/dist/esm/lib/sinks/indexedTypes.js +2 -0
- package/dist/esm/lib/timers/longTimeout.d.ts +37 -0
- package/dist/esm/lib/timers/longTimeout.js +56 -0
- package/dist/esm/sinks.d.ts +2 -0
- package/dist/esm/sinks.js +2 -1
- package/dist/index.js +8 -3
- package/dist/lib/attempt/backoff.js +178 -0
- package/dist/lib/attempt/deadline.js +4 -30
- package/dist/lib/attempt/index.js +9 -6
- package/dist/lib/attempt/runner.js +4 -3
- package/dist/lib/capture/readSources.js +11 -3
- package/dist/lib/capture/sourceOwnership.js +138 -0
- package/dist/lib/capture/sourceOwnershipFormat.js +35 -0
- package/dist/lib/capture/storedReadSourceCounts.js +15 -11
- package/dist/lib/capture/storedReadSources.js +21 -5
- package/dist/lib/capture/storedSourceOwnership.js +104 -0
- package/dist/lib/detach/drivers/setTimeout.js +12 -2
- package/dist/lib/detach/flush.js +8 -6
- package/dist/lib/engine/handlers/StageRunner.js +2 -1
- package/dist/lib/memory/StageContext.js +29 -8
- package/dist/lib/memory/frameTypes.js +1 -1
- package/dist/lib/observer-queue/deferredDispatcher.js +13 -6
- package/dist/lib/recorder/AttemptRecorder.js +8 -9
- package/dist/lib/runner/FlowChartExecutor.js +8 -3
- package/dist/lib/runner/captureHistory.js +6 -4
- package/dist/lib/runner/deadline.js +3 -2
- package/dist/lib/runner/recordSink.js +12 -7
- package/dist/lib/sinks/fileSink.js +7 -6
- package/dist/lib/sinks/indexedAdmission.js +85 -0
- package/dist/lib/sinks/indexedIO.js +108 -0
- package/dist/lib/sinks/indexedRecordFile.js +124 -0
- package/dist/lib/sinks/indexedScan.js +77 -0
- package/dist/lib/sinks/indexedTypes.js +3 -0
- package/dist/lib/timers/longTimeout.js +60 -0
- package/dist/sinks.js +4 -2
- package/dist/types/index.d.ts +13 -2
- package/dist/types/lib/attempt/backoff.d.ts +96 -0
- package/dist/types/lib/attempt/deadline.d.ts +0 -5
- package/dist/types/lib/attempt/index.d.ts +6 -4
- package/dist/types/lib/capture/readSources.d.ts +13 -2
- package/dist/types/lib/capture/sourceOwnership.d.ts +21 -0
- package/dist/types/lib/capture/sourceOwnershipFormat.d.ts +35 -0
- package/dist/types/lib/capture/storedReadSourceCounts.d.ts +5 -1
- package/dist/types/lib/capture/storedSourceOwnership.d.ts +8 -0
- package/dist/types/lib/detach/drivers/setTimeout.d.ts +4 -2
- package/dist/types/lib/detach/flush.d.ts +6 -1
- package/dist/types/lib/memory/StageContext.d.ts +3 -0
- package/dist/types/lib/memory/frameTypes.d.ts +2 -0
- package/dist/types/lib/observer-queue/deferredDispatcher.d.ts +8 -1
- package/dist/types/lib/runner/FlowChartExecutor.d.ts +7 -2
- package/dist/types/lib/runner/recordSink.d.ts +2 -1
- package/dist/types/lib/sinks/indexedAdmission.d.ts +14 -0
- package/dist/types/lib/sinks/indexedIO.d.ts +14 -0
- package/dist/types/lib/sinks/indexedRecordFile.d.ts +3 -0
- package/dist/types/lib/sinks/indexedScan.d.ts +6 -0
- package/dist/types/lib/sinks/indexedTypes.d.ts +60 -0
- package/dist/types/lib/timers/longTimeout.d.ts +37 -0
- package/dist/types/sinks.d.ts +2 -0
- package/package.json +2 -2
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import { ownData } from '../capture/noteShape.js';
|
|
2
|
+
export class IndexedRefusal extends Error {
|
|
3
|
+
reason;
|
|
4
|
+
constructor(reason) {
|
|
5
|
+
super('indexed record file: evidence unavailable');
|
|
6
|
+
this.reason = reason;
|
|
7
|
+
}
|
|
8
|
+
}
|
|
9
|
+
/** An index key, not a source-ID or record codec. Canonical record admission remains in Foottrace. */
|
|
10
|
+
export function indexedAddress(value) {
|
|
11
|
+
const run = ownData(value, 'logRunId');
|
|
12
|
+
const path = ownData(value, 'drillPath');
|
|
13
|
+
if (typeof run !== 'string' || !run.length || run.length > 2048 || !Array.isArray(path))
|
|
14
|
+
throw new IndexedRefusal('invalid-data');
|
|
15
|
+
const length = Object.getOwnPropertyDescriptor(path, 'length')?.value;
|
|
16
|
+
if (Object.getPrototypeOf(path) !== Array.prototype || !Number.isSafeInteger(length) || length > 64)
|
|
17
|
+
throw new IndexedRefusal('invalid-data');
|
|
18
|
+
const segments = [];
|
|
19
|
+
for (let index = 0; index < length; index++) {
|
|
20
|
+
const segment = Object.getOwnPropertyDescriptor(path, String(index))?.value;
|
|
21
|
+
if (typeof segment !== 'string' || !segment.length || segment.length > 2048)
|
|
22
|
+
throw new IndexedRefusal('invalid-data');
|
|
23
|
+
segments.push(segment);
|
|
24
|
+
}
|
|
25
|
+
return JSON.stringify([run, segments]);
|
|
26
|
+
}
|
|
27
|
+
function limit(options, name, fallback, maximum) {
|
|
28
|
+
const configured = ownData(options, name);
|
|
29
|
+
const value = configured === undefined ? fallback : configured;
|
|
30
|
+
if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 1 || value > maximum)
|
|
31
|
+
throw new TypeError('openIndexedRecordFile: invalid host limits');
|
|
32
|
+
return value;
|
|
33
|
+
}
|
|
34
|
+
export function indexedLimits(options) {
|
|
35
|
+
if (!options || Object.getPrototypeOf(options) !== Object.prototype)
|
|
36
|
+
throw new TypeError('openIndexedRecordFile: explicit host authorization required');
|
|
37
|
+
for (const key of Reflect.ownKeys(options)) {
|
|
38
|
+
const descriptor = Object.getOwnPropertyDescriptor(options, key);
|
|
39
|
+
if (!descriptor || !Object.prototype.hasOwnProperty.call(descriptor, 'value'))
|
|
40
|
+
throw new TypeError('openIndexedRecordFile: options must be plain data');
|
|
41
|
+
if (typeof key !== 'string' ||
|
|
42
|
+
!['allowedScopes', 'maxBytes', 'maxEntryBytes', 'maxEntries', 'maxScopeBytes', 'timeoutMs', 'signal'].includes(key))
|
|
43
|
+
throw new TypeError('openIndexedRecordFile: unsupported host option');
|
|
44
|
+
}
|
|
45
|
+
const scopes = ownData(options, 'allowedScopes');
|
|
46
|
+
if (!Array.isArray(scopes) || Object.getPrototypeOf(scopes) !== Array.prototype || scopes.length > 256)
|
|
47
|
+
throw new TypeError('openIndexedRecordFile: explicit host authorization required');
|
|
48
|
+
const allowed = new Set();
|
|
49
|
+
try {
|
|
50
|
+
for (let index = 0; index < scopes.length; index++)
|
|
51
|
+
allowed.add(indexedAddress(Object.getOwnPropertyDescriptor(scopes, String(index))?.value));
|
|
52
|
+
}
|
|
53
|
+
catch {
|
|
54
|
+
throw new TypeError('openIndexedRecordFile: invalid authorized scope');
|
|
55
|
+
}
|
|
56
|
+
const signal = ownData(options, 'signal');
|
|
57
|
+
if (signal !== undefined && !(signal instanceof AbortSignal))
|
|
58
|
+
throw new TypeError('openIndexedRecordFile: invalid cancellation signal');
|
|
59
|
+
return {
|
|
60
|
+
allowed,
|
|
61
|
+
maxBytes: limit(options, 'maxBytes', 64 * 1024 * 1024, 256 * 1024 * 1024),
|
|
62
|
+
maxEntryBytes: limit(options, 'maxEntryBytes', 8 * 1024 * 1024, 8 * 1024 * 1024),
|
|
63
|
+
maxEntries: limit(options, 'maxEntries', 16384, 65536),
|
|
64
|
+
maxScopeBytes: limit(options, 'maxScopeBytes', 8 * 1024 * 1024, 64 * 1024 * 1024),
|
|
65
|
+
timeoutMs: limit(options, 'timeoutMs', 10000, 30000),
|
|
66
|
+
...(signal && { signal }),
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
export function refused(error) {
|
|
70
|
+
return { status: 'unknown', reason: error instanceof IndexedRefusal ? error.reason : 'unavailable' };
|
|
71
|
+
}
|
|
72
|
+
/** Filesystem errors and rejected bytes are never interpolated into a served reason. */
|
|
73
|
+
export function checkSignal(signal) {
|
|
74
|
+
if (signal.aborted)
|
|
75
|
+
throw new IndexedRefusal('cancelled');
|
|
76
|
+
}
|
|
77
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXhlZEFkbWlzc2lvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9saWIvc2lua3MvaW5kZXhlZEFkbWlzc2lvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFHbEQsTUFBTSxPQUFPLGNBQWUsU0FBUSxLQUFLO0lBQ2xCO0lBQXJCLFlBQXFCLE1BQStCO1FBQ2xELEtBQUssQ0FBQywyQ0FBMkMsQ0FBQyxDQUFDO1FBRGhDLFdBQU0sR0FBTixNQUFNLENBQXlCO0lBRXBELENBQUM7Q0FDRjtBQUVELHNHQUFzRztBQUN0RyxNQUFNLFVBQVUsY0FBYyxDQUFDLEtBQWM7SUFDM0MsTUFBTSxHQUFHLEdBQUcsT0FBTyxDQUFDLEtBQUssRUFBRSxVQUFVLENBQUMsQ0FBQztJQUN2QyxNQUFNLElBQUksR0FBRyxPQUFPLENBQUMsS0FBSyxFQUFFLFdBQVcsQ0FBQyxDQUFDO0lBQ3pDLElBQUksT0FBTyxHQUFHLEtBQUssUUFBUSxJQUFJLENBQUMsR0FBRyxDQUFDLE1BQU0sSUFBSSxHQUFHLENBQUMsTUFBTSxHQUFHLElBQUksSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDO1FBQ3JGLE1BQU0sSUFBSSxjQUFjLENBQUMsY0FBYyxDQUFDLENBQUM7SUFDM0MsTUFBTSxNQUFNLEdBQUcsTUFBTSxDQUFDLHdCQUF3QixDQUFDLElBQUksRUFBRSxRQUFRLENBQUMsRUFBRSxLQUFLLENBQUM7SUFDdEUsSUFBSSxNQUFNLENBQUMsY0FBYyxDQUFDLElBQUksQ0FBQyxLQUFLLEtBQUssQ0FBQyxTQUFTLElBQUksQ0FBQyxNQUFNLENBQUMsYUFBYSxDQUFDLE1BQU0sQ0FBQyxJQUFJLE1BQU0sR0FBRyxFQUFFO1FBQ2pHLE1BQU0sSUFBSSxjQUFjLENBQUMsY0FBYyxDQUFDLENBQUM7SUFDM0MsTUFBTSxRQUFRLEdBQWEsRUFB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QUFDLEtBQWM7SUFDcEMsT0FBTyxFQUFFLE1BQU0sRUFBRSxTQUFTLEVBQUUsTUFBTSxFQUFFLEtBQUssWUFBWSxjQUFjLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLGFBQWEsRUFBRSxDQUFDO0FBQ3ZHLENBQUM7QUFFRCx3RkFBd0Y7QUFDeEYsTUFBTSxVQUFVLFdBQVcsQ0FBQyxNQUFtQjtJQUM3QyxJQUFJLE1BQU0sQ0FBQyxPQUFPO1FBQUUsTUFBTSxJQUFJLGNBQWMsQ0FBQyxXQUFXLENBQUMsQ0FBQztBQUM1RCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgb3duRGF0YSB9IGZyb20gJy4uL2NhcHR1cmUvbm90ZVNoYXBlLmpzJztcbmltcG9ydCB0eXBlIHsgSW5kZXhlZExpbWl0cywgSW5kZXhlZFJlY29yZEZpbGVPcHRpb25zLCBJbmRleGVkUmVjb3JkRmlsZVJlYXNvbiB9IGZyb20gJy4vaW5kZXhlZFR5cGVzLmpzJztcblxuZXhwb3J0IGNsYXNzIEluZGV4ZWRSZWZ1c2FsIGV4dGVuZHMgRXJyb3Ige1xuICBjb25zdHJ1Y3RvcihyZWFkb25seSByZWFzb246IEluZGV4ZWRSZWNvcmRGaWxlUmVhc29uKSB7XG4gICAgc3VwZXIoJ2luZGV4ZWQgcmVjb3JkIGZpbGU6IGV2aWRlbmNlIHVuYXZhaWxhYmxlJyk7XG4gIH1cbn1cblxuLyoqIEFuIGluZGV4IGtleSwgbm90IGEgc291cmNlLUlEIG9yIHJlY29yZCBjb2RlYy4gQ2Fub25pY2FsIHJlY29yZCBhZG1pc3Npb24gcmVtYWlucyBpbiBGb290dHJhY2UuICovXG5leHBvcnQgZnVuY3Rpb24gaW5kZXhlZEFkZHJlc3ModmFsdWU6IHVua25vd24pOiBzdHJpbmcge1xuICBjb25zdCBydW4gPSBvd25EYXRhKHZhbHVlLCAnbG9nUnVuSWQnKTtcbiAgY29uc3QgcGF0aCA9IG93bkRhdGEodmFsdWUsICdkcmlsbFBhdGgnKTtcbiAgaWYgKHR5cGVvZiBydW4gIT09ICdzdHJpbmcnIHx8ICFydW4ubGVuZ3RoIHx8IHJ1bi5sZW5ndGggPiAyMDQ4IHx8ICFBcnJheS5pc0FycmF5KHBhdGgpKVxuICAgIHRocm93IG5ldyBJbmRleGVkUmVmdXNhbCgnaW52YWxpZC1kYXRhJyk7XG4gIGNvbnN0IGxlbmd0aCA9IE9iamVjdC5nZXRPd25Qcm9wZXJ0eURlc2NyaXB0b3IocGF0aCwgJ2xlbmd0aCcpPy52YWx1ZTtcbiAgaWYgKE9iamVjdC5nZXRQcm90b3R5cGVPZihwYXRoKSAhPT0gQXJyYXkucHJvdG90eXBlIHx8ICFOdW1iZXIuaXNTYWZlSW50ZWdlcihsZW5ndGgpIHx8IGxlbmd0aCA+IDY0KVxuICAgIHRocm93IG5ldyBJbmRleGVkUmVmdXNhbCgnaW52YWxpZC1kYXRhJyk7XG4gIGNvbnN0IHNlZ21lbnRzOiBzdHJpbmdbXSA9IFtdO1xuICBmb3IgKGxldCBpbmRleCA9IDA7IGluZGV4IDwgbGVuZ3RoOyBpbmRleCsrKSB7XG4gICAgY29uc3Qgc2VnbWVudCA9IE9iamVjdC5nZXRPd25Qcm9wZXJ0eURlc2NyaXB0b3IocGF0aCwgU3RyaW5nKGluZGV4KSk/LnZhbHVlO1xuICAgIGlmICh0eXBlb2Ygc2VnbWVudCAhPT0gJ3N0cmluZycgfHwgIXNlZ21lbnQubGVuZ3RoIHx8IHNlZ21lbnQubGVuZ3RoID4gMjA0OClcbiAgICAgIHRocm93IG5ldyBJbmRleGVkUmVmdXNhbCgnaW52YWxpZC1kYXRhJyk7XG4gICAgc2VnbWVudHMucHVzaChzZWdtZW50KTtcbiAgfVxuICByZXR1cm4gSlNPTi5zdHJpbmdpZnkoW3J1biwgc2VnbWVudHNdKTtcbn1cblxuZnVuY3Rpb24gbGltaXQob3B0aW9uczogdW5rbm93biwgbmFtZTogc3RyaW5nLCBmYWxsYmFjazogbnVtYmVyLCBtYXhpbXVtOiBudW1iZXIpOiBudW1iZXIge1xuICBjb25zdCBjb25maWd1cmVkID0gb3duRGF0YShvcHRpb25zLCBuYW1lKTtcbiAgY29uc3QgdmFsdWUgPSBjb25maWd1cmVkID09PSB1bmRlZmluZWQgPyBmYWxsYmFjayA6IGNvbmZpZ3VyZWQ7XG4gIGlmICh0eXBlb2YgdmFsdWUgIT09ICdudW1iZXInIHx8ICFOdW1iZXIuaXNTYWZlSW50ZWdlcih2YWx1ZSkgfHwgdmFsdWUgPCAxIHx8IHZhbHVlID4gbWF4aW11bSlcbiAgICB0aHJvdyBuZXcgVHlwZUVycm9yKCdvcGVuSW5kZXhlZFJlY29yZEZpbGU6IGludmFsaWQgaG9zdCBsaW1pdHMnKTtcbiAgcmV0dXJuIHZhbHVlO1xufVxuXG5leHBvcnQgZnVuY3Rpb24gaW5kZXhlZExpbWl0cyhvcHRpb25zOiBJbmRleGVkUmVjb3JkRmlsZU9wdGlvbnMpOiBJbmRleGVkTGltaXRzIHtcbiAgaWYgKCFvcHRpb25zIHx8IE9iamVjdC5nZXRQcm90b3R5cGVPZihvcHRpb25zKSAhPT0gT2JqZWN0LnByb3RvdHlwZSlcbiAgICB0aHJvdyBuZXcgVHlwZUVycm9yKCdvcGVuSW5kZXhlZFJlY29yZEZpbGU6IGV4cGxpY2l0IGhvc3QgYXV0aG9yaXphdGlvbiByZXF1aXJlZCcpO1xuICBmb3IgKGNvbnN0IGtleSBvZiBSZWZsZWN0Lm93bktleXMob3B0aW9ucykpIHtcbiAgICBjb25zdCBkZXNjcmlwdG9yID0gT2JqZWN0LmdldE93blByb3BlcnR5RGVzY3JpcHRvcihvcHRpb25zLCBrZXkpO1xuICAgIGlmICghZGVzY3JpcHRvciB8fCAhT2JqZWN0LnByb3RvdHlwZS5oYXNPd25Qcm9wZXJ0eS5jYWxsKGRlc2NyaXB0b3IsICd2YWx1ZScpKVxuICAgICAgdGhyb3cgbmV3IFR5cGVFcnJvcignb3BlbkluZGV4ZWRSZWNvcmRGaWxlOiBvcHRpb25zIG11c3QgYmUgcGxhaW4gZGF0YScpO1xuICAgIGlmIChcbiAgICAgIHR5cGVvZiBrZXkgIT09ICdzdHJpbmcnIHx8XG4gICAgICAhWydhbGxvd2VkU2NvcGVzJywgJ21heEJ5dGVzJywgJ21heEVudHJ5Qnl0ZXMnLCAnbWF4RW50cmllcycsICdtYXhTY29wZUJ5dGVzJywgJ3RpbWVvdXRNcycsICdzaWduYWwnXS5pbmNsdWRlcyhcbiAgICAgICAga2V5LFxuICAgICAgKVxuICAgIClcbiAgICAgIHRocm93IG5ldyBUeXBlRXJyb3IoJ29wZW5JbmRleGVkUmVjb3JkRmlsZTogdW5zdXBwb3J0ZWQgaG9zdCBvcHRpb24nKTtcbiAgfVxuICBjb25zdCBzY29wZXMgPSBvd25EYXRhKG9wdGlvbnMsICdhbGxvd2VkU2NvcGVzJyk7XG4gIGlmICghQXJyYXkuaXNBcnJheShzY29wZXMpIHx8IE9iamVjdC5nZXRQcm90b3R5cGVPZihzY29wZXMpICE9PSBBcnJheS5wcm90b3R5cGUgfHwgc2NvcGVzLmxlbmd0aCA+IDI1NilcbiAgICB0aHJvdyBuZXcgVHlwZUVycm9yKCdvcGVuSW5kZXhlZFJlY29yZEZpbGU6IGV4cGxpY2l0IGhvc3QgYXV0aG9yaXphdGlvbiByZXF1aXJlZCcpO1xuICBjb25zdCBhbGxvd2VkID0gbmV3IFNldDxzdHJpbmc+KCk7XG4gIHRyeSB7XG4gICAgZm9yIChsZXQgaW5kZXggPSAwOyBpbmRleCA8IHNjb3Blcy5sZW5ndGg7IGluZGV4KyspXG4gICAgICBhbGxvd2VkLmFkZChpbmRleGVkQWRkcmVzcyhPYmplY3QuZ2V0T3duUHJvcGVydHlEZXNjcmlwdG9yKHNjb3BlcywgU3RyaW5nKGluZGV4KSk/LnZhbHVlKSk7XG4gIH0gY2F0Y2gge1xuICAgIHRocm93IG5ldyBUeXBlRXJyb3IoJ29wZW5JbmRleGVkUmVjb3JkRmlsZTogaW52YWxpZCBhdXRob3JpemVkIHNjb3BlJyk7XG4gIH1cbiAgY29uc3Qgc2lnbmFsID0gb3duRGF0YShvcHRpb25zLCAnc2lnbmFsJykgYXMgQWJvcnRTaWduYWwgfCB1bmRlZmluZWQ7XG4gIGlmIChzaWduYWwgIT09IHVuZGVmaW5lZCAmJiAhKHNpZ25hbCBpbnN0YW5jZW9mIEFib3J0U2lnbmFsKSlcbiAgICB0aHJvdyBuZXcgVHlwZUVycm9yKCdvcGVuSW5kZXhlZFJlY29yZEZpbGU6IGludmFsaWQgY2FuY2VsbGF0aW9uIHNpZ25hbCcpO1xuICByZXR1cm4ge1xuICAgIGFsbG93ZWQsXG4gICAgbWF4Qnl0ZXM6IGxpbWl0KG9wdGlvbnMsICdtYXhCeXRlcycsIDY0ICogMTAyNCAqIDEwMjQsIDI1NiAqIDEwMjQgKiAxMDI0KSxcbiAgICBtYXhFbnRyeUJ5dGVzOiBsaW1pdChvcHRpb25zLCAnbWF4RW50cnlCeXRlcycsIDggKiAxMDI0ICogMTAyNCwgOCAqIDEwMjQgKiAxMDI0KSxcbiAgICBtYXhFbnRyaWVzOiBsaW1pdChvcHRpb25zLCAnbWF4RW50cmllcycsIDE2Mzg0LCA2NTUzNiksXG4gICAgbWF4U2NvcGVCeXRlczogbGltaXQob3B0aW9ucywgJ21heFNjb3BlQnl0ZXMnLCA4ICogMTAyNCAqIDEwMjQsIDY0ICogMTAyNCAqIDEwMjQpLFxuICAgIHRpbWVvdXRNczogbGltaXQob3B0aW9ucywgJ3RpbWVvdXRNcycsIDEwMDAwLCAzMDAwMCksXG4gICAgLi4uKHNpZ25hbCAmJiB7IHNpZ25hbCB9KSxcbiAgfTtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIHJlZnVzZWQoZXJyb3I6IHVua25vd24pOiB7IHJlYWRvbmx5IHN0YXR1czogJ3Vua25vd24nOyByZWFkb25seSByZWFzb246IEluZGV4ZWRSZWNvcmRGaWxlUmVhc29uIH0ge1xuICByZXR1cm4geyBzdGF0dXM6ICd1bmtub3duJywgcmVhc29uOiBlcnJvciBpbnN0YW5jZW9mIEluZGV4ZWRSZWZ1c2FsID8gZXJyb3IucmVhc29uIDogJ3VuYXZhaWxhYmxlJyB9O1xufVxuXG4vKiogRmlsZXN5c3RlbSBlcnJvcnMgYW5kIHJlamVjdGVkIGJ5dGVzIGFyZSBuZXZlciBpbnRlcnBvbGF0ZWQgaW50byBhIHNlcnZlZCByZWFzb24uICovXG5leHBvcnQgZnVuY3Rpb24gY2hlY2tTaWduYWwoc2lnbmFsOiBBYm9ydFNpZ25hbCk6IHZvaWQge1xuICBpZiAoc2lnbmFsLmFib3J0ZWQpIHRocm93IG5ldyBJbmRleGVkUmVmdXNhbCgnY2FuY2VsbGVkJyk7XG59XG4iXX0=
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { IndexedRecordUnknown } from './indexedTypes.js';
|
|
2
|
+
/** The path is a host capability, never a path constructed from a stored run or requested node. */
|
|
3
|
+
export declare function openIndexedDescriptor(path: string): number;
|
|
4
|
+
export declare function fileIdentity(fd: number): {
|
|
5
|
+
readonly key: string;
|
|
6
|
+
readonly size: number;
|
|
7
|
+
};
|
|
8
|
+
export declare function assertIdentity(fd: number, key: string): void;
|
|
9
|
+
export declare function digest(bytes: Uint8Array): string;
|
|
10
|
+
/** Positional bytes only; exact short-read accounting is retained even when a later check refuses them. */
|
|
11
|
+
export declare function readBytes(fd: number, offset: number, bytes: number, signal: AbortSignal, count: (bytes: number) => void, submitted?: () => void): Promise<Uint8Array>;
|
|
12
|
+
export declare function closeDescriptor(fd: number): Promise<void>;
|
|
13
|
+
/** A timeout bounds the wait, never frees an unfinished operation's file/slot. */
|
|
14
|
+
export declare function boundedIndexedWork<T>(work: (signal: AbortSignal) => Promise<T>, timeoutMs: number, signal: AbortSignal | undefined, settled: () => void): Promise<T | IndexedRecordUnknown>;
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto';
|
|
2
|
+
import { close, constants, fstatSync, openSync, read } from 'node:fs';
|
|
3
|
+
import { getuid } from 'node:process';
|
|
4
|
+
import { setLongTimeout } from '../timers/longTimeout.js';
|
|
5
|
+
import { checkSignal, IndexedRefusal } from './indexedAdmission.js';
|
|
6
|
+
/** The path is a host capability, never a path constructed from a stored run or requested node. */
|
|
7
|
+
export function openIndexedDescriptor(path) {
|
|
8
|
+
if (typeof path !== 'string' || !path.length)
|
|
9
|
+
throw new TypeError('openIndexedRecordFile: invalid path');
|
|
10
|
+
return openSync(path, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0));
|
|
11
|
+
}
|
|
12
|
+
export function fileIdentity(fd) {
|
|
13
|
+
const stat = fstatSync(fd);
|
|
14
|
+
const uid = typeof getuid === 'function' ? getuid() : undefined;
|
|
15
|
+
if (!stat.isFile() ||
|
|
16
|
+
stat.nlink !== 1 ||
|
|
17
|
+
(uid !== undefined && (stat.uid !== uid || (stat.mode & 0o022) !== 0)) ||
|
|
18
|
+
!Number.isSafeInteger(stat.size) ||
|
|
19
|
+
stat.size < 0)
|
|
20
|
+
throw new IndexedRefusal('unavailable');
|
|
21
|
+
return { key: JSON.stringify([stat.dev, stat.ino, stat.size, stat.mtimeMs, stat.ctimeMs]), size: stat.size };
|
|
22
|
+
}
|
|
23
|
+
export function assertIdentity(fd, key) {
|
|
24
|
+
if (fileIdentity(fd).key !== key)
|
|
25
|
+
throw new IndexedRefusal('stale');
|
|
26
|
+
}
|
|
27
|
+
export function digest(bytes) {
|
|
28
|
+
return createHash('sha256').update(bytes).digest('hex');
|
|
29
|
+
}
|
|
30
|
+
/** Positional bytes only; exact short-read accounting is retained even when a later check refuses them. */
|
|
31
|
+
export async function readBytes(fd, offset, bytes, signal, count, submitted) {
|
|
32
|
+
const buffer = new Uint8Array(bytes);
|
|
33
|
+
let filled = 0;
|
|
34
|
+
while (filled < bytes) {
|
|
35
|
+
checkSignal(signal);
|
|
36
|
+
const length = await new Promise((resolve, reject) => {
|
|
37
|
+
submitted?.();
|
|
38
|
+
read(fd, buffer, filled, bytes - filled, offset + filled, (error, amount) => {
|
|
39
|
+
if (error)
|
|
40
|
+
reject(error);
|
|
41
|
+
else
|
|
42
|
+
resolve(amount);
|
|
43
|
+
});
|
|
44
|
+
});
|
|
45
|
+
count(length);
|
|
46
|
+
if (!length)
|
|
47
|
+
throw new IndexedRefusal('stale');
|
|
48
|
+
filled += length;
|
|
49
|
+
}
|
|
50
|
+
checkSignal(signal);
|
|
51
|
+
return buffer;
|
|
52
|
+
}
|
|
53
|
+
export function closeDescriptor(fd) {
|
|
54
|
+
return new Promise((resolve) => close(fd, () => resolve()));
|
|
55
|
+
}
|
|
56
|
+
/** A timeout bounds the wait, never frees an unfinished operation's file/slot. */
|
|
57
|
+
export async function boundedIndexedWork(work, timeoutMs, signal, settled) {
|
|
58
|
+
if (signal?.aborted) {
|
|
59
|
+
settled();
|
|
60
|
+
return { status: 'unknown', reason: 'cancelled' };
|
|
61
|
+
}
|
|
62
|
+
const controller = new AbortController();
|
|
63
|
+
const deadline = performance.now() + timeoutMs;
|
|
64
|
+
let interrupt = () => undefined;
|
|
65
|
+
const interrupted = new Promise((resolve) => (interrupt = resolve));
|
|
66
|
+
const cancel = () => {
|
|
67
|
+
controller.abort();
|
|
68
|
+
interrupt({ status: 'unknown', reason: 'cancelled' });
|
|
69
|
+
};
|
|
70
|
+
signal?.addEventListener('abort', cancel, { once: true });
|
|
71
|
+
// The one long-timer law (`timers/longTimeout.ts`); the door admits at most 30 000 ms today.
|
|
72
|
+
const cancelTimer = setLongTimeout(() => {
|
|
73
|
+
controller.abort();
|
|
74
|
+
interrupt({ status: 'unknown', reason: 'timeout' });
|
|
75
|
+
}, timeoutMs);
|
|
76
|
+
const running = Promise.resolve()
|
|
77
|
+
.then(() => work(controller.signal))
|
|
78
|
+
.then((value) => {
|
|
79
|
+
if (performance.now() < deadline)
|
|
80
|
+
return value;
|
|
81
|
+
controller.abort();
|
|
82
|
+
return { status: 'unknown', reason: 'timeout' };
|
|
83
|
+
}, (error) => {
|
|
84
|
+
if (performance.now() < deadline)
|
|
85
|
+
throw error;
|
|
86
|
+
controller.abort();
|
|
87
|
+
return { status: 'unknown', reason: 'timeout' };
|
|
88
|
+
});
|
|
89
|
+
running.then(settled, settled);
|
|
90
|
+
try {
|
|
91
|
+
return await Promise.race([running, interrupted]);
|
|
92
|
+
}
|
|
93
|
+
finally {
|
|
94
|
+
cancelTimer();
|
|
95
|
+
signal?.removeEventListener('abort', cancel);
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXhlZElPLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2xpYi9zaW5rcy9pbmRleGVkSU8udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUN6QyxPQUFPLEVBQUUsS0FBSyxFQUFFLFNBQVMsRUFBRSxTQUFTLEVBQUUsUUFBUSxFQUFFLElBQUksRUFBRSxNQUFNLFNBQVMsQ0FBQztBQUN0RSxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sY0FBYyxDQUFDO0FBRXRDLE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUMxRCxPQUFPLEVBQUUsV0FBVyxFQUFFLGNBQWMsRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBR3BFLG1HQUFtRztBQUNuRyxNQUFNLFVBQVUscUJBQXFCLENBQUMsSUFBWTtJQUNoRCxJQUFJLE9BQU8sSUFBSSxLQUFLLFFBQVEsSUFBSSxDQUFDLElBQUksQ0FBQyxNQUFNO1FBQUUsTUFBTSxJQUFJLFNBQVMsQ0FBQyxxQ0FBcUMsQ0FBQyxDQUFDO0lBQ3pHLE9BQU8sUUFBUSxDQUFDLElBQUksRUFBRSxTQUFTLENBQUMsUUFBUSxHQUFHLENBQUMsU0FBUyxDQUFDLFVBQVUsSUFBSSxDQUFDLENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQyxVQUFVLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQztBQUN4RyxDQUFDO0FBRUQsTUFBTSxVQUFVLFlBQVksQ0FBQyxFQUFVO0lBQ3JDLE1BQU0sSUFBSSxHQUFHLFNBQVMsQ0FBQyxFQUFFLENBQUMsQ0FBQztJQUMzQixNQUFNLEdBQUcsR0FBRyxPQUFPLE1BQU0sS0FBSyxVQUFVLENBQUMsQ0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUM7SUFDaEUsSUFDRSxDQUFDLElBQUksQ0FBQyxNQUFNLEVBQUU7UUFDZCxJQUFJLENBQUMsS0FBSyxLQUFLLENBQUM7UUFDaEIsQ0FBQyxHQUFHLEtBQUssU0FBUyxJQUFJLENBQUMsSUFBSSxDQUFDLEdBQUcsS0FBSyxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxHQUFHLEtBQUssQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO1FBQ3RFLENBQUMsTUFBTSxDQUFDLGFBQWEsQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDO1FBQ2hDLElBQUksQ0FBQyxJQUFJLEdBQUcsQ0FBQztRQUViLE1BQU0sSUFBSSxjQUFjLENBQUMsYUFBYSxDQUFDLENBQUM7SUFDMUMsT0FBTyxFQUFFLEdBQUcsRUFBRSxJQUFJLENBQUMsU0FBUyxDQUFDLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxJQUFJLENBQUMsR0FBRyxFQUFFLElBQUksQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLE9BQU8sRUFBRSxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUMsRUFBRSxJQUFJLEVBQUUsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDO0FBQy9HLENBQUM7QUFFRCxNQUFNLFVBQVUsY0FBYyxDQUFDLEVBQVUsRUFBRSxHQUFXO0lBQ3BELElBQUksWUFBWSxDQUFDLEVBQUUsQ0FBQyxDQUFDLEdBQUcsS0FBSyxHQUFHO1FBQUUsTUFBTSxJQUFJLGNBQWMsQ0FBQyxPQUFPLENBQUMsQ0FBQztBQUN0RSxDQUFDO0FBRUQsTUFBTSxVQUFVLE1BQU0sQ0FBQyxLQUFpQjtJQUN0QyxPQUFPLFVBQVUsQ0FBQyxRQUFRLENBQUMsQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDO0FBQzFELENBQUM7QUFFRCwyR0FBMkc7QUFDM0csTUFBTSxDQUFDLEtBQUssVUFBVSxTQUFTLENBQzdCLEVBQVUsRUFDVixNQUFjLEVBQ2QsS0FBYSxFQUNiLE1BQW1CLEVBQ25CLEtBQThCLEVBQzlCLFNBQXNCO0lBRXRCLE1BQU0sTUFBTSxHQUFHLElBQUksVUFBVSxDQUFDLEtBQUssQ0FBQyxDQUFDO0lBQ3JDLElBQUksTUFBTSxHQUFHLENBQUMsQ0FBQztJQUNmLE9BQU8sTUFBTSxHQUFHLEtBQUssRUFBRSxDQUFDO1FBQ3RCLFdBQVcsQ0FBQyxNQUFNLENBQUMsQ0FBQztRQUNwQixNQUFNLE1BQU0sR0FBRyxNQUFNLElBQUksT0FBTyxDQUFTLENBQUMsT0FBTyxFQUFFLE1BQU0sRUFBRSxFQUFFO1lBQzNELFNBQVMsRUFBRSxFQUFFLENBQUM7WUFDZCxJQUFJLENBQUMsRUFBRSxFQUFFLE1BQU0sRUFBRSxNQUFNLEVBQUUsS0FBSyxHQUFHLE1BQU0sRUFBRSxNQUFNLEdBQUcsTUFBTSxFQUFFLENBQUMsS0FBSyxFQUFFLE1BQU0sRUFBRSxFQUFFO2dCQUMxRSxJQUFJLEtBQUs7b0JBQUUsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDOztvQkFDcEIsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDO1lBQ3ZCLENBQUMsQ0FBQyxDQUFDO1FBQ0wsQ0FBQyxDQUFDLENBQUM7UUFDSCxLQUFLLENBQUMsTUFBTSxDQUFDLENBQUM7UUFDZCxJQUFJLENBQUMsTUFBTTtZQUFFLE1BQU0sSUFBSSxjQUFjLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDL0MsTUFBTSxJQUFJLE1BQU0sQ0FBQztJQUNuQixDQUFDO0lBQ0QsV0FBVyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQ3BCLE9BQU8sTUFBTSxDQUFDO0FBQ2hCLENBQUM7QUFFRCxNQUFNLFVBQVUsZUFBZSxDQUFDLEVBQVU7SUFDeEMsT0FBTyxJQUFJLE9BQU8sQ0FBQyxDQUFDLE9BQU8sRUFBRSxFQUFFLENBQUMsS0FBSyxDQUFDLEVBQUUsRUFBRSxHQUFHLEVBQUUsQ0FBQyxPQUFPLEVBQUUsQ0FBQyxDQUFDLENBQUM7QUFDOUQsQ0FBQztBQUVELGtGQUFrRjtBQUNsRixNQUFNLENBQUMsS0FBSyxVQUFVLGtCQUFrQixDQUN0QyxJQUF5QyxFQUN6QyxTQUFpQixFQUNqQixNQUErQixFQUMvQixPQUFtQjtJQUVuQixJQUFJLE1BQU0sRUFBRSxPQUFPLEVBQUUsQ0FBQztRQUNwQixPQUFPLEVBQUUsQ0FBQztRQUNWLE9BQU8sRUFBRSxNQUFNLEVBQUUsU0FBUyxFQUFFLE1BQU0sRUFBRSxXQUFXLEVBQUUsQ0FBQztJQUNwRCxDQUFDO0lBQ0QsTUFBTSxVQUFVLEdBQUcsSUFBSSxlQUFlLEVBQUUsQ0FBQztJQUN6QyxNQUFNLFFBQVEsR0FBRyxXQUFXLENBQUMsR0FBRyxFQUFFLEdBQUcsU0FBUyxDQUFDO0lBQy9DLElBQUksU0FBUyxHQUEyQyxHQUFHLEVBQUUsQ0FBQyxTQUFTLENBQUM7SUFDeEUsTUFBTSxXQUFXLEdBQUcsSUFBSSxPQUFPLENBQXVCLENBQUMsT0FBTyxFQUFFLEVBQUUsQ0FBQyxDQUFDLFNBQVMsR0FBRyxPQUFPLENBQUMsQ0FBQyxDQUFDO0lBQzFGLE1BQU0sTUFBTSxHQUFHLEdBQUcsRUFBRTtRQUNsQixVQUFVLENBQUMsS0FBSyxFQUFFLENBQUM7UUFDbkIsU0FBUyxDQUFDLEVBQUUsTUFBTSxFQUFFLFNBQVMsRUFBRSxNQUFNLEVBQUUsV0FBVyxFQUFFLENBQUMsQ0FBQztJQUN4RCxDQUFDLENBQUM7SUFDRixNQUFNLEVBQUUsZ0JBQWdCLENBQUMsT0FBTyxFQUFFLE1BQU0sRUFBRSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO0lBQzFELDZGQUE2RjtJQUM3RixNQUFNLFdBQVcsR0FBRyxjQUFjLENBQUMsR0FBRyxFQUFFO1FBQ3RDLFVBQVUsQ0FBQyxLQUFLLEVBQUUsQ0FBQztRQUNuQixTQUFTLENBQUMsRUFBRSxNQUFNLEVBQUUsU0FBUyxFQUFFLE1BQU0sRUFBRSxTQUFTLEVBQUUsQ0FBQyxDQUFDO0lBQ3RELENBQUMsRUFBRSxTQUFTLENBQUMsQ0FBQztJQUNkLE1BQU0sT0FBTyxHQUFHLE9BQU8sQ0FBQyxPQUFPLEVBQUU7U0FDOUIsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDLElBQUksQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDLENBQUM7U0FDbkMsSUFBSSxDQUNILENBQUMsS0FBSyxFQUFFLEVBQUU7UUFDUixJQUFJLFdBQVcsQ0FBQyxHQUFHLEVBQUUsR0FBRyxRQUFRO1lBQUUsT0FBTyxLQUFLLENBQUM7UUFDL0MsVUFBVSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ25CLE9BQU8sRUFBRSxNQUFNLEVBQUUsU0FBUyxFQUFFLE1BQU0sRUFBRSxTQUFTLEVBQVcsQ0FBQztJQUMzRCxDQUFDLEVBQ0QsQ0FBQyxLQUFjLEVBQUUsRUFBRTtRQUNqQixJQUFJLFdBQVcsQ0FBQyxHQUFHLEVBQUUsR0FBRyxRQUFRO1lBQUUsTUFBTSxLQUFLLENBQUM7UUFDOUMsVUFBVSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ25CLE9BQU8sRUFBRSxNQUFNLEVBQUUsU0FBUyxFQUFFLE1BQU0sRUFBRSxTQUFTLEVBQVcsQ0FBQztJQUMzRCxDQUFDLENBQ0YsQ0FBQztJQUNKLE9BQU8sQ0FBQyxJQUFJLENBQUMsT0FBTyxFQUFFLE9BQU8sQ0FBQyxDQUFDO0lBQy9CLElBQUksQ0FBQztRQUNILE9BQU8sTUFBTSxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUMsT0FBTyxFQUFFLFdBQVcsQ0FBQyxDQUFDLENBQUM7SUFDcEQsQ0FBQztZQUFTLENBQUM7UUFDVCxXQUFXLEVBQUUsQ0FBQztRQUNkLE1BQU0sRUFBRSxtQkFBbUIsQ0FBQyxPQUFPLEVBQUUsTUFBTSxDQUFDLENBQUM7SUFDL0MsQ0FBQztBQUNILENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBjcmVhdGVIYXNoIH0gZnJvbSAnbm9kZTpjcnlwdG8nO1xuaW1wb3J0IHsgY2xvc2UsIGNvbnN0YW50cywgZnN0YXRTeW5jLCBvcGVuU3luYywgcmVhZCB9IGZyb20gJ25vZGU6ZnMnO1xuaW1wb3J0IHsgZ2V0dWlkIH0gZnJvbSAnbm9kZTpwcm9jZXNzJztcblxuaW1wb3J0IHsgc2V0TG9uZ1RpbWVvdXQgfSBmcm9tICcuLi90aW1lcnMvbG9uZ1RpbWVvdXQuanMnO1xuaW1wb3J0IHsgY2hlY2tTaWduYWwsIEluZGV4ZWRSZWZ1c2FsIH0gZnJvbSAnLi9pbmRleGVkQWRtaXNzaW9uLmpzJztcbmltcG9ydCB0eXBlIHsgSW5kZXhlZFJlY29yZFVua25vd24gfSBmcm9tICcuL2luZGV4ZWRUeXBlcy5qcyc7XG5cbi8qKiBUaGUgcGF0aCBpcyBhIGhvc3QgY2FwYWJpbGl0eSwgbmV2ZXIgYSBwYXRoIGNvbnN0cnVjdGVkIGZyb20gYSBzdG9yZWQgcnVuIG9yIHJlcXVlc3RlZCBub2RlLiAqL1xuZXhwb3J0IGZ1bmN0aW9uIG9wZW5JbmRleGVkRGVzY3JpcHRvcihwYXRoOiBzdHJpbmcpOiBudW1iZXIge1xuICBpZiAodHlwZW9mIHBhdGggIT09ICdzdHJpbmcnIHx8ICFwYXRoLmxlbmd0aCkgdGhyb3cgbmV3IFR5cGVFcnJvcignb3BlbkluZGV4ZWRSZWNvcmRGaWxlOiBpbnZhbGlkIHBhdGgnKTtcbiAgcmV0dXJuIG9wZW5TeW5jKHBhdGgsIGNvbnN0YW50cy5PX1JET05MWSB8IChjb25zdGFudHMuT19OT0ZPTExPVyA/PyAwKSB8IChjb25zdGFudHMuT19OT05CTE9DSyA/PyAwKSk7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBmaWxlSWRlbnRpdHkoZmQ6IG51bWJlcik6IHsgcmVhZG9ubHkga2V5OiBzdHJpbmc7IHJlYWRvbmx5IHNpemU6IG51bWJlciB9IHtcbiAgY29uc3Qgc3RhdCA9IGZzdGF0U3luYyhmZCk7XG4gIGNvbnN0IHVpZCA9IHR5cGVvZiBnZXR1aWQgPT09ICdmdW5jdGlvbicgPyBnZXR1aWQoKSA6IHVuZGVmaW5lZDtcbiAgaWYgKFxuICAgICFzdGF0LmlzRmlsZSgpIHx8XG4gICAgc3RhdC5ubGluayAhPT0gMSB8fFxuICAgICh1aWQgIT09IHVuZGVmaW5lZCAmJiAoc3RhdC51aWQgIT09IHVpZCB8fCAoc3RhdC5tb2RlICYgMG8wMjIpICE9PSAwKSkgfHxcbiAgICAhTnVtYmVyLmlzU2FmZUludGVnZXIoc3RhdC5zaXplKSB8fFxuICAgIHN0YXQuc2l6ZSA8IDBcbiAgKVxuICAgIHRocm93IG5ldyBJbmRleGVkUmVmdXNhbCgndW5hdmFpbGFibGUnKTtcbiAgcmV0dXJuIHsga2V5OiBKU09OLnN0cmluZ2lmeShbc3RhdC5kZXYsIHN0YXQuaW5vLCBzdGF0LnNpemUsIHN0YXQubXRpbWVNcywgc3RhdC5jdGltZU1zXSksIHNpemU6IHN0YXQuc2l6ZSB9O1xufVxuXG5leHBvcnQgZnVuY3Rpb24gYXNzZXJ0SWRlbnRpdHkoZmQ6IG51bWJlciwga2V5OiBzdHJpbmcpOiB2b2lkIHtcbiAgaWYgKGZpbGVJZGVudGl0eShmZCkua2V5ICE9PSBrZXkpIHRocm93IG5ldyBJbmRleGVkUmVmdXNhbCgnc3RhbGUnKTtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIGRpZ2VzdChieXRlczogVWludDhBcnJheSk6IHN0cmluZyB7XG4gIHJldHVybiBjcmVhdGVIYXNoKCdzaGEyNTYnKS51cGRhdGUoYnl0ZXMpLmRpZ2VzdCgnaGV4Jyk7XG59XG5cbi8qKiBQb3NpdGlvbmFsIGJ5dGVzIG9ubHk7IGV4YWN0IHNob3J0LXJlYWQgYWNjb3VudGluZyBpcyByZXRhaW5lZCBldmVuIHdoZW4gYSBsYXRlciBjaGVjayByZWZ1c2VzIHRoZW0uICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gcmVhZEJ5dGVzKFxuICBmZDogbnVtYmVyLFxuICBvZmZzZXQ6IG51bWJlcixcbiAgYnl0ZXM6IG51bWJlcixcbiAgc2lnbmFsOiBBYm9ydFNpZ25hbCxcbiAgY291bnQ6IChieXRlczogbnVtYmVyKSA9PiB2b2lkLFxuICBzdWJtaXR0ZWQ/OiAoKSA9PiB2b2lkLFxuKTogUHJvbWlzZTxVaW50OEFycmF5PiB7XG4gIGNvbnN0IGJ1ZmZlciA9IG5ldyBVaW50OEFycmF5KGJ5dGVzKTtcbiAgbGV0IGZpbGxlZCA9IDA7XG4gIHdoaWxlIChmaWxsZWQgPCBieXRlcykge1xuICAgIGNoZWNrU2lnbmFsKHNpZ25hbCk7XG4gICAgY29uc3QgbGVuZ3RoID0gYXdhaXQgbmV3IFByb21pc2U8bnVtYmVyPigocmVzb2x2ZSwgcmVqZWN0KSA9PiB7XG4gICAgICBzdWJtaXR0ZWQ/LigpO1xuICAgICAgcmVhZChmZCwgYnVmZmVyLCBmaWxsZWQsIGJ5dGVzIC0gZmlsbGVkLCBvZmZzZXQgKyBmaWxsZWQsIChlcnJvciwgYW1vdW50KSA9PiB7XG4gICAgICAgIGlmIChlcnJvcikgcmVqZWN0KGVycm9yKTtcbiAgICAgICAgZWxzZSByZXNvbHZlKGFtb3VudCk7XG4gICAgICB9KTtcbiAgICB9KTtcbiAgICBjb3VudChsZW5ndGgpO1xuICAgIGlmICghbGVuZ3RoKSB0aHJvdyBuZXcgSW5kZXhlZFJlZnVzYWwoJ3N0YWxlJyk7XG4gICAgZmlsbGVkICs9IGxlbmd0aDtcbiAgfVxuICBjaGVja1NpZ25hbChzaWduYWwpO1xuICByZXR1cm4gYnVmZmVyO1xufVxuXG5leHBvcnQgZnVuY3Rpb24gY2xvc2VEZXNjcmlwdG9yKGZkOiBudW1iZXIpOiBQcm9taXNlPHZvaWQ+IHtcbiAgcmV0dXJuIG5ldyBQcm9taXNlKChyZXNvbHZlKSA9PiBjbG9zZShmZCwgKCkgPT4gcmVzb2x2ZSgpKSk7XG59XG5cbi8qKiBBIHRpbWVvdXQgYm91bmRzIHRoZSB3YWl0LCBuZXZlciBmcmVlcyBhbiB1bmZpbmlzaGVkIG9wZXJhdGlvbidzIGZpbGUvc2xvdC4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBib3VuZGVkSW5kZXhlZFdvcms8VD4oXG4gIHdvcms6IChzaWduYWw6IEFib3J0U2lnbmFsKSA9PiBQcm9taXNlPFQ+LFxuICB0aW1lb3V0TXM6IG51bWJlcixcbiAgc2lnbmFsOiBBYm9ydFNpZ25hbCB8IHVuZGVmaW5lZCxcbiAgc2V0dGxlZDogKCkgPT4gdm9pZCxcbik6IFByb21pc2U8VCB8IEluZGV4ZWRSZWNvcmRVbmtub3duPiB7XG4gIGlmIChzaWduYWw/LmFib3J0ZWQpIHtcbiAgICBzZXR0bGVkKCk7XG4gICAgcmV0dXJuIHsgc3RhdHVzOiAndW5rbm93bicsIHJlYXNvbjogJ2NhbmNlbGxlZCcgfTtcbiAgfVxuICBjb25zdCBjb250cm9sbGVyID0gbmV3IEFib3J0Q29udHJvbGxlcigpO1xuICBjb25zdCBkZWFkbGluZSA9IHBlcmZvcm1hbmNlLm5vdygpICsgdGltZW91dE1zO1xuICBsZXQgaW50ZXJydXB0OiAocmVhc29uOiBJbmRleGVkUmVjb3JkVW5rbm93bikgPT4gdm9pZCA9ICgpID0+IHVuZGVmaW5lZDtcbiAgY29uc3QgaW50ZXJydXB0ZWQgPSBuZXcgUHJvbWlzZTxJbmRleGVkUmVjb3JkVW5rbm93bj4oKHJlc29sdmUpID0+IChpbnRlcnJ1cHQgPSByZXNvbHZlKSk7XG4gIGNvbnN0IGNhbmNlbCA9ICgpID0+IHtcbiAgICBjb250cm9sbGVyLmFib3J0KCk7XG4gICAgaW50ZXJydXB0KHsgc3RhdHVzOiAndW5rbm93bicsIHJlYXNvbjogJ2NhbmNlbGxlZCcgfSk7XG4gIH07XG4gIHNpZ25hbD8uYWRkRXZlbnRMaXN0ZW5lcignYWJvcnQnLCBjYW5jZWwsIHsgb25jZTogdHJ1ZSB9KTtcbiAgLy8gVGhlIG9uZSBsb25nLXRpbWVyIGxhdyAoYHRpbWVycy9sb25nVGltZW91dC50c2ApOyB0aGUgZG9vciBhZG1pdHMgYXQgbW9zdCAzMCAwMDAgbXMgdG9kYXkuXG4gIGNvbnN0IGNhbmNlbFRpbWVyID0gc2V0TG9uZ1RpbWVvdXQoKCkgPT4ge1xuICAgIGNvbnRyb2xsZXIuYWJvcnQoKTtcbiAgICBpbnRlcnJ1cHQoeyBzdGF0dXM6ICd1bmtub3duJywgcmVhc29uOiAndGltZW91dCcgfSk7XG4gIH0sIHRpbWVvdXRNcyk7XG4gIGNvbnN0IHJ1bm5pbmcgPSBQcm9taXNlLnJlc29sdmUoKVxuICAgIC50aGVuKCgpID0+IHdvcmsoY29udHJvbGxlci5zaWduYWwpKVxuICAgIC50aGVuKFxuICAgICAgKHZhbHVlKSA9PiB7XG4gICAgICAgIGlmIChwZXJmb3JtYW5jZS5ub3coKSA8IGRlYWRsaW5lKSByZXR1cm4gdmFsdWU7XG4gICAgICAgIGNvbnRyb2xsZXIuYWJvcnQoKTtcbiAgICAgICAgcmV0dXJuIHsgc3RhdHVzOiAndW5rbm93bicsIHJlYXNvbjogJ3RpbWVvdXQnIH0gYXMgY29uc3Q7XG4gICAgICB9LFxuICAgICAgKGVycm9yOiB1bmtub3duKSA9PiB7XG4gICAgICAgIGlmIChwZXJmb3JtYW5jZS5ub3coKSA8IGRlYWRsaW5lKSB0aHJvdyBlcnJvcjtcbiAgICAgICAgY29udHJvbGxlci5hYm9ydCgpO1xuICAgICAgICByZXR1cm4geyBzdGF0dXM6ICd1bmtub3duJywgcmVhc29uOiAndGltZW91dCcgfSBhcyBjb25zdDtcbiAgICAgIH0sXG4gICAgKTtcbiAgcnVubmluZy50aGVuKHNldHRsZWQsIHNldHRsZWQpO1xuICB0cnkge1xuICAgIHJldHVybiBhd2FpdCBQcm9taXNlLnJhY2UoW3J1bm5pbmcsIGludGVycnVwdGVkXSk7XG4gIH0gZmluYWxseSB7XG4gICAgY2FuY2VsVGltZXIoKTtcbiAgICBzaWduYWw/LnJlbW92ZUV2ZW50TGlzdGVuZXIoJ2Fib3J0JywgY2FuY2VsKTtcbiAgfVxufVxuIl19
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import type { IndexedRecordFileOptions, IndexedRecordFileResult } from './indexedTypes.js';
|
|
2
|
+
/** Explicit bounded whole-file preparation, followed by authorized positional scope reads from that immutable file. */
|
|
3
|
+
export declare function openIndexedRecordFile(path: string, options: IndexedRecordFileOptions): Promise<IndexedRecordFileResult>;
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
import { ownData } from '../capture/noteShape.js';
|
|
2
|
+
import { checkSignal, indexedAddress, indexedLimits, IndexedRefusal, refused } from './indexedAdmission.js';
|
|
3
|
+
import { assertIdentity, boundedIndexedWork, closeDescriptor, digest, fileIdentity, openIndexedDescriptor, readBytes, } from './indexedIO.js';
|
|
4
|
+
import { scanIndexedFile } from './indexedScan.js';
|
|
5
|
+
/** Explicit bounded whole-file preparation, followed by authorized positional scope reads from that immutable file. */
|
|
6
|
+
export async function openIndexedRecordFile(path, options) {
|
|
7
|
+
const limits = indexedLimits(options);
|
|
8
|
+
if (limits.signal?.aborted)
|
|
9
|
+
return { status: 'unknown', reason: 'cancelled' };
|
|
10
|
+
let fd;
|
|
11
|
+
try {
|
|
12
|
+
fd = openIndexedDescriptor(path);
|
|
13
|
+
}
|
|
14
|
+
catch {
|
|
15
|
+
return { status: 'unknown', reason: 'unavailable' };
|
|
16
|
+
}
|
|
17
|
+
const stats = { preparationBytes: 0, scopeBytes: 0, readCalls: 0 };
|
|
18
|
+
let prepared = false;
|
|
19
|
+
let abandoned = false;
|
|
20
|
+
let running = false;
|
|
21
|
+
let closePromise;
|
|
22
|
+
const release = () => (closePromise ??= closeDescriptor(fd));
|
|
23
|
+
try {
|
|
24
|
+
const identity = fileIdentity(fd);
|
|
25
|
+
running = true;
|
|
26
|
+
const result = await boundedIndexedWork((signal) => scanIndexedFile(fd, identity, limits, signal, (bytes) => (stats.preparationBytes += bytes)), limits.timeoutMs, limits.signal, () => {
|
|
27
|
+
running = false;
|
|
28
|
+
if (abandoned)
|
|
29
|
+
release();
|
|
30
|
+
});
|
|
31
|
+
if (!(result instanceof Map))
|
|
32
|
+
return result;
|
|
33
|
+
prepared = true;
|
|
34
|
+
return { status: 'ready', reader: indexedReader(fd, identity.key, result, limits, stats) };
|
|
35
|
+
}
|
|
36
|
+
catch (error) {
|
|
37
|
+
return refused(error);
|
|
38
|
+
}
|
|
39
|
+
finally {
|
|
40
|
+
if (!prepared) {
|
|
41
|
+
abandoned = true;
|
|
42
|
+
if (!running)
|
|
43
|
+
await release();
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
function indexedReader(fd, identity, index, limits, stats) {
|
|
48
|
+
let closed = false;
|
|
49
|
+
let active = false;
|
|
50
|
+
let finishClose;
|
|
51
|
+
let closePromise;
|
|
52
|
+
const release = () => {
|
|
53
|
+
if (closed && !active)
|
|
54
|
+
closeDescriptor(fd).then(() => finishClose?.());
|
|
55
|
+
};
|
|
56
|
+
return Object.freeze({
|
|
57
|
+
get stats() {
|
|
58
|
+
return Object.freeze({ ...stats });
|
|
59
|
+
},
|
|
60
|
+
async readScope(address, context) {
|
|
61
|
+
try {
|
|
62
|
+
if (context !== undefined &&
|
|
63
|
+
(!context ||
|
|
64
|
+
Object.getPrototypeOf(context) !== Object.prototype ||
|
|
65
|
+
(Object.getOwnPropertyDescriptor(context, 'signal') !== undefined &&
|
|
66
|
+
!Object.prototype.hasOwnProperty.call(Object.getOwnPropertyDescriptor(context, 'signal'), 'value'))))
|
|
67
|
+
throw new IndexedRefusal('invalid-data');
|
|
68
|
+
const signal = context === undefined ? undefined : ownData(context, 'signal');
|
|
69
|
+
if (signal !== undefined && !(signal instanceof AbortSignal))
|
|
70
|
+
throw new IndexedRefusal('invalid-data');
|
|
71
|
+
if (signal?.aborted)
|
|
72
|
+
throw new IndexedRefusal('cancelled');
|
|
73
|
+
if (closed)
|
|
74
|
+
throw new IndexedRefusal('closed');
|
|
75
|
+
const key = indexedAddress(address);
|
|
76
|
+
if (!limits.allowed.has(key))
|
|
77
|
+
throw new IndexedRefusal('not-permitted');
|
|
78
|
+
if (active)
|
|
79
|
+
throw new IndexedRefusal('busy');
|
|
80
|
+
assertIdentity(fd, identity);
|
|
81
|
+
const ranges = index.get(key);
|
|
82
|
+
if (!ranges)
|
|
83
|
+
throw new IndexedRefusal('no-match');
|
|
84
|
+
active = true;
|
|
85
|
+
return await boundedIndexedWork((inner) => loadIndexedScope(fd, identity, key, ranges, inner, (bytes) => (stats.scopeBytes += bytes), () => stats.readCalls++), limits.timeoutMs, signal, () => {
|
|
86
|
+
active = false;
|
|
87
|
+
release();
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
catch (error) {
|
|
91
|
+
return refused(error);
|
|
92
|
+
}
|
|
93
|
+
},
|
|
94
|
+
close() {
|
|
95
|
+
if (!closePromise) {
|
|
96
|
+
closed = true;
|
|
97
|
+
closePromise = new Promise((resolve) => (finishClose = resolve));
|
|
98
|
+
release();
|
|
99
|
+
}
|
|
100
|
+
return closePromise;
|
|
101
|
+
},
|
|
102
|
+
});
|
|
103
|
+
}
|
|
104
|
+
async function loadIndexedScope(fd, identity, key, ranges, signal, count, submitted) {
|
|
105
|
+
const entries = [];
|
|
106
|
+
for (const range of ranges) {
|
|
107
|
+
checkSignal(signal);
|
|
108
|
+
const bytes = await readBytes(fd, range.offset, range.bytes, signal, count, submitted);
|
|
109
|
+
if (digest(bytes) !== range.digest)
|
|
110
|
+
throw new IndexedRefusal('stale');
|
|
111
|
+
const entry = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes));
|
|
112
|
+
if (indexedAddress(ownData(entry, 'address')) !== key)
|
|
113
|
+
throw new IndexedRefusal('invalid-data');
|
|
114
|
+
entries.push(entry);
|
|
115
|
+
}
|
|
116
|
+
assertIdentity(fd, identity);
|
|
117
|
+
checkSignal(signal);
|
|
118
|
+
return { status: 'loaded', entries, bytesRead: ranges.reduce((total, range) => total + range.bytes, 0) };
|
|
119
|
+
}
|
|
120
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXhlZFJlY29yZEZpbGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvbGliL3NpbmtzL2luZGV4ZWRSZWNvcmRGaWxlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUNsRCxPQUFPLEVBQUUsV0FBVyxFQUFFLGNBQWMsRUFBRSxhQUFhLEVBQUUsY0FBYyxFQUFFLE9BQU8sRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQzVHLE9BQU8sRUFDTCxjQUFjLEVBQ2Qsa0JBQWtCLEVBQ2xCLGVBQWUsRUFDZixNQUFNLEVBQ04sWUFBWSxFQUNaLHFCQUFxQixFQUNyQixTQUFTLEdBQ1YsTUFBTSxnQkFBZ0IsQ0FBQztBQUN4QixPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFXbkQsdUhBQXVIO0FBQ3ZILE1BQU0sQ0FBQyxLQUFLLFVBQVUscUJBQXFCLENBQ3pDLElBQVksRUFDWixPQUFpQztJQUVqQyxNQUFNLE1BQU0sR0FBRyxhQUFhLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDdEMsSUFBSSxNQUFNLENBQUMsTUFBTSxFQUFFLE9BQU87UUFBRSxPQUFPLEVBQUUsTUFBTSxFQUFFLFNBQVMsRUFBRSxNQUFNLEVBQUUsV0FBVyxFQUFFLENBQUM7SUFDOUUsSUFBSSxFQUFVLENBQUM7SUFDZixJQUFJLENBQUM7UUFDSCxFQUFFLEdBQUcscUJBQXFCLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDbkMsQ0FBQztJQUFDLE1BQU0sQ0FBQztRQUNQLE9BQU8sRUFBRSxNQUFNLEVBQUUsU0FBUyxFQUFFLE1BQU0sRUFBRSxhQUFhLEVBQUUsQ0FBQztJQUN0RCxDQUFDO0lBQ0QsTUFBTSxLQUFLLEdBQUcsRUFBRSxnQkFBZ0IsRUFBRSxDQUFDLEVBQUUsVUFBVSxFQUFFLENBQUMsRUFBRSxTQUFTLEVBQUUsQ0FBQyxFQUFFLENBQUM7SUFD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QUMsQ0FBQztRQUN2RixJQUFJLE1BQU0sQ0FBQyxLQUFLLENBQUMsS0FBSyxLQUFLLENBQUMsTUFBTTtZQUFFLE1BQU0sSUFBSSxjQUFjLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDdEUsTUFBTSxLQUFLLEdBQVksSUFBSSxDQUFDLEtBQUssQ0FBQyxJQUFJLFdBQVcsQ0FBQyxPQUFPLEVBQUUsRUFBRSxLQUFLLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQztRQUMzRixJQUFJLGNBQWMsQ0FBQyxPQUFPLENBQUMsS0FBSyxFQUFFLFNBQVMsQ0FBQyxDQUFDLEtBQUssR0FBRztZQUFFLE1BQU0sSUFBSSxjQUFjLENBQUMsY0FBYyxDQUFDLENBQUM7UUFDaEcsT0FBTyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUN0QixDQUFDO0lBQ0QsY0FBYyxDQUFDLEVBQUUsRUFBRSxRQUFRLENBQUMsQ0FBQztJQUM3QixXQUFXLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDcEIsT0FBTyxFQUFFLE1BQU0sRUFBRSxRQUFRLEVBQUUsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLENBQUMsTUFBTSxDQUFDLENBQUMsS0FBSyxFQUFFLEtBQUssRUFBRSxFQUFFLENBQUMsS0FBSyxHQUFHLEtBQUssQ0FBQyxLQUFLLEVBQUUsQ0FBQyxDQUFDLEVBQUUsQ0FBQztBQUMzRyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHR5cGUgeyBMb2dBZGRyZXNzIH0gZnJvbSAnZm9vdHRyYWNlJztcblxuaW1wb3J0IHsgb3duRGF0YSB9IGZyb20gJy4uL2NhcHR1cmUvbm90ZVNoYXBlLmpzJztcbmltcG9ydCB7IGNoZWNrU2lnbmFsLCBpbmRleGVkQWRkcmVzcywgaW5kZXhlZExpbWl0cywgSW5kZXhlZFJlZnVzYWwsIHJlZnVzZWQgfSBmcm9tICcuL2luZGV4ZWRBZG1pc3Npb24uanMnO1xuaW1wb3J0IHtcbiAgYXNzZXJ0SWRlbnRpdHksXG4gIGJvdW5kZWRJbmRleGVkV29yayxcbiAgY2xvc2VEZXNjcmlwdG9yLFxuICBkaWdlc3QsXG4gIGZpbGVJZGVudGl0eSxcbiAgb3BlbkluZGV4ZWREZXNjcmlwdG9yLFxuICByZWFkQnl0ZXMsXG59IGZyb20gJy4vaW5kZXhlZElPLmpzJztcbmltcG9ydCB7IHNjYW5JbmRleGVkRmlsZSB9IGZyb20gJy4vaW5kZXhlZFNjYW4uanMnO1xuaW1wb3J0IHR5cGUge1xuICBJbmRleGVkTGltaXRzLFxuICBJbmRleGVkUmFuZ2UsXG4gIEluZGV4ZWRSZWNvcmRGaWxlLFxuICBJbmRleGVkUmVjb3JkRmlsZU9wdGlvbnMsXG4gIEluZGV4ZWRSZWNvcmRGaWxlUmVzdWx0LFxuICBJbmRleGVkUmVjb3JkU2NvcGUsXG4gIEluZGV4ZWRSZWNvcmRVbmtub3duLFxufSBmcm9tICcuL2luZGV4ZWRUeXBlcy5qcyc7XG5cbi8qKiBFeHBsaWNpdCBib3VuZGVkIHdob2xlLWZpbGUgcHJlcGFyYXRpb24sIGZvbGxvd2VkIGJ5IGF1dGhvcml6ZWQgcG9zaXRpb25hbCBzY29wZSByZWFkcyBmcm9tIHRoYXQgaW1tdXRhYmxlIGZpbGUuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gb3BlbkluZGV4ZWRSZWNvcmRGaWxlKFxuICBwYXRoOiBzdHJpbmcsXG4gIG9wdGlvbnM6IEluZGV4ZWRSZWNvcmRGaWxlT3B0aW9ucyxcbik6IFByb21pc2U8SW5kZXhlZFJlY29yZEZpbGVSZXN1bHQ+IHtcbiAgY29uc3QgbGltaXRzID0gaW5kZXhlZExpbWl0cyhvcHRpb25zKTtcbiAgaWYgKGxpbWl0cy5zaWduYWw/LmFib3J0ZWQpIHJldHVybiB7IHN0YXR1czogJ3Vua25vd24nLCByZWFzb246ICdjYW5jZWxsZWQnIH07XG4gIGxldCBmZDogbnVtYmVyO1xuICB0cnkge1xuICAgIGZkID0gb3BlbkluZGV4ZWREZXNjcmlwdG9yKHBhdGgpO1xuICB9IGNhdGNoIHtcbiAgICByZXR1cm4geyBzdGF0dXM6ICd1bmtub3duJywgcmVhc29uOiAndW5hdmFpbGFibGUnIH07XG4gIH1cbiAgY29uc3Qgc3RhdHMgPSB7IHByZXBhcmF0aW9uQnl0ZXM6IDAsIHNjb3BlQnl0ZXM6IDAsIHJlYWRDYWxsczogMCB9O1xuICBsZXQgcHJlcGFyZWQgPSBmYWxzZTtcbiAgbGV0IGFiYW5kb25lZCA9IGZhbHNlO1xuICBsZXQgcnVubmluZyA9IGZhbHNlO1xuICBsZXQgY2xvc2VQcm9taXNlOiBQcm9taXNlPHZvaWQ+IHwgdW5kZWZpbmVkO1xuICBjb25zdCByZWxlYXNlID0gKCkgPT4gKGNsb3NlUHJvbWlzZSA/Pz0gY2xvc2VEZXNjcmlwdG9yKGZkKSk7XG4gIHRyeSB7XG4gICAgY29uc3QgaWRlbnRpdHkgPSBmaWxlSWRlbnRpdHkoZmQpO1xuICAgIHJ1bm5pbmcgPSB0cnVlO1xuICAgIGNvbnN0IHJlc3VsdCA9IGF3YWl0IGJvdW5kZWRJbmRleGVkV29yayhcbiAgICAgIChzaWduYWwpID0+IHNjYW5JbmRleGVkRmlsZShmZCwgaWRlbnRpdHksIGxpbWl0cywgc2lnbmFsLCAoYnl0ZXMpID0+IChzdGF0cy5wcmVwYXJhdGlvbkJ5dGVzICs9IGJ5dGVzKSksXG4gICAgICBsaW1pdHMudGltZW91dE1zLFxuICAgICAgbGltaXRzLnNpZ25hbCxcbiAgICAgICgpID0+IHtcbiAgICAgICAgcnVubmluZyA9IGZhbHNlO1xuICAgICAgICBpZiAoYWJhbmRvbmVkKSByZWxlYXNlKCk7XG4gICAgICB9LFxuICAgICk7XG4gICAgaWYgKCEocmVzdWx0IGluc3RhbmNlb2YgTWFwKSkgcmV0dXJuIHJlc3VsdDtcbiAgICBwcmVwYXJlZCA9IHRydWU7XG4gICAgcmV0dXJuIHsgc3RhdHVzOiAncmVhZHknLCByZWFkZXI6IGluZGV4ZWRSZWFkZXIoZmQsIGlkZW50aXR5LmtleSwgcmVzdWx0LCBsaW1pdHMsIHN0YXRzKSB9O1xuICB9IGNhdGNoIChlcnJvcikge1xuICAgIHJldHVybiByZWZ1c2VkKGVycm9yKTtcbiAgfSBmaW5hbGx5IHtcbiAgICBpZiAoIXByZXBhcmVkKSB7XG4gICAgICBhYmFuZG9uZWQgPSB0cnVlO1xuICAgICAgaWYgKCFydW5uaW5nKSBhd2FpdCByZWxlYXNlKCk7XG4gICAgfVxuICB9XG59XG5cbmZ1bmN0aW9uIGluZGV4ZWRSZWFkZXIoXG4gIGZkOiBudW1iZXIsXG4gIGlkZW50aXR5OiBzdHJpbmcsXG4gIGluZGV4OiBSZWFkb25seU1hcDxzdHJpbmcsIHJlYWRvbmx5IEluZGV4ZWRSYW5nZVtdPixcbiAgbGltaXRzOiBJbmRleGVkTGltaXRzLFxuICBzdGF0czogeyBwcmVwYXJhdGlvbkJ5dGVzOiBudW1iZXI7IHNjb3BlQnl0ZXM6IG51bWJlcjsgcmVhZENhbGxzOiBudW1iZXIgfSxcbik6IEluZGV4ZWRSZWNvcmRGaWxlIHtcbiAgbGV0IGNsb3NlZCA9IGZhbHNlO1xuICBsZXQgYWN0aXZlID0gZmFsc2U7XG4gIGxldCBmaW5pc2hDbG9zZTogKCgpID0+IHZvaWQpIHwgdW5kZWZpbmVkO1xuICBsZXQgY2xvc2VQcm9taXNlOiBQcm9taXNlPHZvaWQ+IHwgdW5kZWZpbmVkO1xuICBjb25zdCByZWxlYXNlID0gKCkgPT4ge1xuICAgIGlmIChjbG9zZWQgJiYgIWFjdGl2ZSkgY2xvc2VEZXNjcmlwdG9yKGZkKS50aGVuKCgpID0+IGZpbmlzaENsb3NlPy4oKSk7XG4gIH07XG4gIHJldHVybiBPYmplY3QuZnJlZXplKHtcbiAgICBnZXQgc3RhdHMoKSB7XG4gICAgICByZXR1cm4gT2JqZWN0LmZyZWV6ZSh7IC4uLnN0YXRzIH0pO1xuICAgIH0sXG4gICAgYXN5bmMgcmVhZFNjb3BlKGFkZHJlc3M6IExvZ0FkZHJlc3MsIGNvbnRleHQ/OiB7IHJlYWRvbmx5IHNpZ25hbD86IEFib3J0U2lnbmFsIH0pIHtcbiAgICAgIHRyeSB7XG4gICAgICAgIGlmIChcbiAgICAgICAgICBjb250ZXh0ICE9PSB1bmRlZmluZWQgJiZcbiAgICAgICAgICAoIWNvbnRleHQgfHxcbiAgICAgICAgICAgIE9iamVjdC5nZXRQcm90b3R5cGVPZihjb250ZXh0KSAhPT0gT2JqZWN0LnByb3RvdHlwZSB8fFxuICAgICAgICAgICAgKE9iamVjdC5nZXRPd25Qcm9wZXJ0eURlc2NyaXB0b3IoY29udGV4dCwgJ3NpZ25hbCcpICE9PSB1bmRlZmluZWQgJiZcbiAgICAgICAgICAgICAgIU9iamVjdC5wcm90b3R5cGUuaGFzT3duUHJvcGVydHkuY2FsbChPYmplY3QuZ2V0T3duUHJvcGVydHlEZXNjcmlwdG9yKGNvbnRleHQsICdzaWduYWwnKSwgJ3ZhbHVlJykpKVxuICAgICAgICApXG4gICAgICAgICAgdGhyb3cgbmV3IEluZGV4ZWRSZWZ1c2FsKCdpbnZhbGlkLWRhdGEnKTtcbiAgICAgICAgY29uc3Qgc2lnbmFsID0gY29udGV4dCA9PT0gdW5kZWZpbmVkID8gdW5kZWZpbmVkIDogKG93bkRhdGEoY29udGV4dCwgJ3NpZ25hbCcpIGFzIEFib3J0U2lnbmFsIHwgdW5kZWZpbmVkKTtcbiAgICAgICAgaWYgKHNpZ25hbCAhPT0gdW5kZWZpbmVkICYmICEoc2lnbmFsIGluc3RhbmNlb2YgQWJvcnRTaWduYWwpKSB0aHJvdyBuZXcgSW5kZXhlZFJlZnVzYWwoJ2ludmFsaWQtZGF0YScpO1xuICAgICAgICBpZiAoc2lnbmFsPy5hYm9ydGVkKSB0aHJvdyBuZXcgSW5kZXhlZFJlZnVzYWwoJ2NhbmNlbGxlZCcpO1xuICAgICAgICBpZiAoY2xvc2VkKSB0aHJvdyBuZXcgSW5kZXhlZFJlZnVzYWwoJ2Nsb3NlZCcpO1xuICAgICAgICBjb25zdCBrZXkgPSBpbmRleGVkQWRkcmVzcyhhZGRyZXNzKTtcbiAgICAgICAgaWYgKCFsaW1pdHMuYWxsb3dlZC5oYXMoa2V5KSkgdGhyb3cgbmV3IEluZGV4ZWRSZWZ1c2FsKCdub3QtcGVybWl0dGVkJyk7XG4gICAgICAgIGlmIChhY3RpdmUpIHRocm93IG5ldyBJbmRleGVkUmVmdXNhbCgnYnVzeScpO1xuICAgICAgICBhc3NlcnRJZGVudGl0eShmZCwgaWRlbnRpdHkpO1xuICAgICAgICBjb25zdCByYW5nZXMgPSBpbmRleC5nZXQoa2V5KTtcbiAgICAgICAgaWYgKCFyYW5nZXMpIHRocm93IG5ldyBJbmRleGVkUmVmdXNhbCgnbm8tbWF0Y2gnKTtcbiAgICAgICAgYWN0aXZlID0gdHJ1ZTtcbiAgICAgICAgcmV0dXJuIGF3YWl0IGJvdW5kZWRJbmRleGVkV29yayhcbiAgICAgICAgICAoaW5uZXIpID0+XG4gICAgICAgICAgICBsb2FkSW5kZXhlZFNjb3BlKFxuICAgICAgICAgICAgICBmZCxcbiAgICAgICAgICAgICAgaWRlbnRpdHksXG4gICAgICAgICAgICAgIGtleSxcbiAgICAgICAgICAgICAgcmFuZ2VzLFxuICAgICAgICAgICAgICBpbm5lcixcbiAgICAgICAgICAgICAgKGJ5dGVzKSA9PiAoc3RhdHMuc2NvcGVCeXRlcyArPSBieXRlcyksXG4gICAgICAgICAgICAgICgpID0+IHN0YXRzLnJlYWRDYWxscysrLFxuICAgICAgICAgICAgKSxcbiAgICAgICAgICBsaW1pdHMudGltZW91dE1zLFxuICAgICAgICAgIHNpZ25hbCxcbiAgICAgICAgICAoKSA9PiB7XG4gICAgICAgICAgICBhY3RpdmUgPSBmYWxzZTtcbiAgICAgICAgICAgIHJlbGVhc2UoKTtcbiAgICAgICAgICB9LFxuICAgICAgICApO1xuICAgICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgICAgcmV0dXJuIHJlZnVzZWQoZXJyb3IpO1xuICAgICAgfVxuICAgIH0sXG4gICAgY2xvc2UoKSB7XG4gICAgICBpZiAoIWNsb3NlUHJvbWlzZSkge1xuICAgICAgICBjbG9zZWQgPSB0cnVlO1xuICAgICAgICBjbG9zZVByb21pc2UgPSBuZXcgUHJvbWlzZTx2b2lkPigocmVzb2x2ZSkgPT4gKGZpbmlzaENsb3NlID0gcmVzb2x2ZSkpO1xuICAgICAgICByZWxlYXNlKCk7XG4gICAgICB9XG4gICAgICByZXR1cm4gY2xvc2VQcm9taXNlO1xuICAgIH0sXG4gIH0pO1xufVxuXG5hc3luYyBmdW5jdGlvbiBsb2FkSW5kZXhlZFNjb3BlKFxuICBmZDogbnVtYmVyLFxuICBpZGVudGl0eTogc3RyaW5nLFxuICBrZXk6IHN0cmluZyxcbiAgcmFuZ2VzOiByZWFkb25seSBJbmRleGVkUmFuZ2VbXSxcbiAgc2lnbmFsOiBBYm9ydFNpZ25hbCxcbiAgY291bnQ6IChieXRlczogbnVtYmVyKSA9PiB2b2lkLFxuICBzdWJtaXR0ZWQ6ICgpID0+IHZvaWQsXG4pOiBQcm9taXNlPEluZGV4ZWRSZWNvcmRTY29wZSB8IEluZGV4ZWRSZWNvcmRVbmtub3duPiB7XG4gIGNvbnN0IGVudHJpZXM6IHVua25vd25bXSA9IFtdO1xuICBmb3IgKGNvbnN0IHJhbmdlIG9mIHJhbmdlcykge1xuICAgIGNoZWNrU2lnbmFsKHNpZ25hbCk7XG4gICAgY29uc3QgYnl0ZXMgPSBhd2FpdCByZWFkQnl0ZXMoZmQsIHJhbmdlLm9mZnNldCwgcmFuZ2UuYnl0ZXMsIHNpZ25hbCwgY291bnQsIHN1Ym1pdHRlZCk7XG4gICAgaWYgKGRpZ2VzdChieXRlcykgIT09IHJhbmdlLmRpZ2VzdCkgdGhyb3cgbmV3IEluZGV4ZWRSZWZ1c2FsKCdzdGFsZScpO1xuICAgIGNvbnN0IGVudHJ5OiB1bmtub3duID0gSlNPTi5wYXJzZShuZXcgVGV4dERlY29kZXIoJ3V0Zi04JywgeyBmYXRhbDogdHJ1ZSB9KS5kZWNvZGUoYnl0ZXMpKTtcbiAgICBpZiAoaW5kZXhlZEFkZHJlc3Mob3duRGF0YShlbnRyeSwgJ2FkZHJlc3MnKSkgIT09IGtleSkgdGhyb3cgbmV3IEluZGV4ZWRSZWZ1c2FsKCdpbnZhbGlkLWRhdGEnKTtcbiAgICBlbnRyaWVzLnB1c2goZW50cnkpO1xuICB9XG4gIGFzc2VydElkZW50aXR5KGZkLCBpZGVudGl0eSk7XG4gIGNoZWNrU2lnbmFsKHNpZ25hbCk7XG4gIHJldHVybiB7IHN0YXR1czogJ2xvYWRlZCcsIGVudHJpZXMsIGJ5dGVzUmVhZDogcmFuZ2VzLnJlZHVjZSgodG90YWwsIHJhbmdlKSA9PiB0b3RhbCArIHJhbmdlLmJ5dGVzLCAwKSB9O1xufVxuIl19
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import type { IndexedLimits, IndexedRange } from './indexedTypes.js';
|
|
2
|
+
/** One whole-file preparation pass. Only authorized range metadata is retained, never the archive's values. */
|
|
3
|
+
export declare function scanIndexedFile(fd: number, identity: {
|
|
4
|
+
readonly key: string;
|
|
5
|
+
readonly size: number;
|
|
6
|
+
}, limits: IndexedLimits, signal: AbortSignal, count: (bytes: number) => void): Promise<Map<string, readonly IndexedRange[]>>;
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import { ownData } from '../capture/noteShape.js';
|
|
2
|
+
import { checkSignal, indexedAddress, IndexedRefusal } from './indexedAdmission.js';
|
|
3
|
+
import { assertIdentity, digest, readBytes } from './indexedIO.js';
|
|
4
|
+
/** One whole-file preparation pass. Only authorized range metadata is retained, never the archive's values. */
|
|
5
|
+
export async function scanIndexedFile(fd, identity, limits, signal, count) {
|
|
6
|
+
if (identity.size > limits.maxBytes)
|
|
7
|
+
throw new IndexedRefusal('too-large');
|
|
8
|
+
const index = new Map();
|
|
9
|
+
const totals = new Map();
|
|
10
|
+
let entries = 0;
|
|
11
|
+
let lineStart = 0;
|
|
12
|
+
let pieces = [];
|
|
13
|
+
let lineBytes = 0;
|
|
14
|
+
const append = (piece) => {
|
|
15
|
+
lineBytes += piece.length;
|
|
16
|
+
if (lineBytes > limits.maxEntryBytes)
|
|
17
|
+
throw new IndexedRefusal('too-large');
|
|
18
|
+
if (piece.length)
|
|
19
|
+
pieces.push(piece);
|
|
20
|
+
};
|
|
21
|
+
const decoder = new TextDecoder('utf-8', { fatal: true });
|
|
22
|
+
for (let position = 0; position < identity.size;) {
|
|
23
|
+
checkSignal(signal);
|
|
24
|
+
const chunk = await readBytes(fd, position, Math.min(65536, identity.size - position), signal, count);
|
|
25
|
+
position += chunk.length;
|
|
26
|
+
let start = 0;
|
|
27
|
+
for (let end = 0; end < chunk.length; end++) {
|
|
28
|
+
if (chunk[end] !== 10)
|
|
29
|
+
continue;
|
|
30
|
+
append(chunk.subarray(start, end + 1));
|
|
31
|
+
// Assemble once at the delimiter, rather than repeatedly copying a growing partial line.
|
|
32
|
+
const bytes = new Uint8Array(lineBytes);
|
|
33
|
+
let filled = 0;
|
|
34
|
+
for (const piece of pieces) {
|
|
35
|
+
bytes.set(piece, filled);
|
|
36
|
+
filled += piece.length;
|
|
37
|
+
}
|
|
38
|
+
const text = decoder.decode(bytes);
|
|
39
|
+
if (text.trim()) {
|
|
40
|
+
if (++entries > limits.maxEntries)
|
|
41
|
+
throw new IndexedRefusal('too-large');
|
|
42
|
+
let row;
|
|
43
|
+
try {
|
|
44
|
+
row = JSON.parse(text);
|
|
45
|
+
}
|
|
46
|
+
catch {
|
|
47
|
+
throw new IndexedRefusal('invalid-data');
|
|
48
|
+
}
|
|
49
|
+
const scope = indexedAddress(ownData(row, 'address'));
|
|
50
|
+
if (limits.allowed.has(scope)) {
|
|
51
|
+
const total = (totals.get(scope) ?? 0) + bytes.length;
|
|
52
|
+
if (total > limits.maxScopeBytes)
|
|
53
|
+
throw new IndexedRefusal('too-large');
|
|
54
|
+
totals.set(scope, total);
|
|
55
|
+
const ranges = index.get(scope) ?? [];
|
|
56
|
+
ranges.push({ offset: lineStart, bytes: bytes.length, digest: digest(bytes) });
|
|
57
|
+
index.set(scope, ranges);
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
lineStart += bytes.length;
|
|
61
|
+
pieces = [];
|
|
62
|
+
lineBytes = 0;
|
|
63
|
+
start = end + 1;
|
|
64
|
+
}
|
|
65
|
+
append(chunk.subarray(start));
|
|
66
|
+
}
|
|
67
|
+
if (lineBytes)
|
|
68
|
+
throw new IndexedRefusal('invalid-data'); // a torn tail never becomes an absent event
|
|
69
|
+
assertIdentity(fd, identity.key);
|
|
70
|
+
checkSignal(signal);
|
|
71
|
+
return index;
|
|
72
|
+
}
|
|
73
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXhlZFNjYW4uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvbGliL3NpbmtzL2luZGV4ZWRTY2FuLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUNsRCxPQUFPLEVBQUUsV0FBVyxFQUFFLGNBQWMsRUFBRSxjQUFjLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUNwRixPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sRUFBRSxTQUFTLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUduRSwrR0FBK0c7QUFDL0csTUFBTSxDQUFDLEtBQUssVUFBVSxlQUFlLENBQ25DLEVBQVUsRUFDVixRQUF5RCxFQUN6RCxNQUFxQixFQUNyQixNQUFtQixFQUNuQixLQUE4QjtJQUU5QixJQUFJLFFBQVEsQ0FBQyxJQUFJLEdBQUcsTUFBTSxDQUFDLFFBQVE7UUFBRSxNQUFNLElBQUksY0FBYyxDQUFDLFdBQVcsQ0FBQyxDQUFDO0lBQzNFLE1BQU0sS0FBSyxHQUFHLElBQUksR0FBRyxFQUEwQixDQUFDO0lBQ2hELE1BQU0sTUFBTSxHQUFHLElBQUksR0FBRyxFQUFrQixDQUFDO0lBQ3pDLElBQUksT0FBTyxHQUFHLENBQUMsQ0FBQztJQUNoQixJQUFJLFNBQVMsR0FBRyxDQUFDLENBQUM7SUFDbEIsSUFBSSxNQUFNLEdBQWlCLEVBQUUsQ0FBQztJQUM5QixJQUFJLFNBQVMsR0FBRyxDQUFDLENBQUM7SUFDbEIsTUFBTSxNQUFNLEdBQUcsQ0FBQyxLQUFpQixFQUFFLEVBQUU7UUFDbkMsU0FBUyxJQUFJLEtBQUssQ0FBQyxNQUFNLENBQUM7UUFDMUIsSUFBSSxTQUFTLEdBQUcsTUFBTSxDQUFDLGFBQWE7WUFBRSxNQUFNLElBQUksY0FBYyxDQUFDLFdBQVcsQ0FBQyxDQUFDO1FBQzVFLElBQUksS0FBSyxDQUFDLE1BQU07WUFBRSxNQUFNLENBQUMsSUFBSSxDQUFD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LENBQUMsS0FBSyxFQUFFLE1BQU0sQ0FBQyxDQUFDO2dCQUMzQixDQUFDO1lBQ0gsQ0FBQztZQUNELFNBQVMsSUFBSSxLQUFLLENBQUMsTUFBTSxDQUFDO1lBQzFCLE1BQU0sR0FBRyxFQUFFLENBQUM7WUFDWixTQUFTLEdBQUcsQ0FBQyxDQUFDO1lBQ2QsS0FBSyxHQUFHLEdBQUcsR0FBRyxDQUFDLENBQUM7UUFDbEIsQ0FBQztRQUNELE1BQU0sQ0FBQyxLQUFLLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUM7SUFDaEMsQ0FBQztJQUNELElBQUksU0FBUztRQUFFLE1BQU0sSUFBSSxjQUFjLENBQUMsY0FBYyxDQUFDLENBQUMsQ0FBQyw0Q0FBNEM7SUFDckcsY0FBYyxDQUFDLEVBQUUsRUFBRSxRQUFRLENBQUMsR0FBRyxDQUFDLENBQUM7SUFDakMsV0FBVyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQ3BCLE9BQU8sS0FBSyxDQUFDO0FBQ2YsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IG93bkRhdGEgfSBmcm9tICcuLi9jYXB0dXJlL25vdGVTaGFwZS5qcyc7XG5pbXBvcnQgeyBjaGVja1NpZ25hbCwgaW5kZXhlZEFkZHJlc3MsIEluZGV4ZWRSZWZ1c2FsIH0gZnJvbSAnLi9pbmRleGVkQWRtaXNzaW9uLmpzJztcbmltcG9ydCB7IGFzc2VydElkZW50aXR5LCBkaWdlc3QsIHJlYWRCeXRlcyB9IGZyb20gJy4vaW5kZXhlZElPLmpzJztcbmltcG9ydCB0eXBlIHsgSW5kZXhlZExpbWl0cywgSW5kZXhlZFJhbmdlIH0gZnJvbSAnLi9pbmRleGVkVHlwZXMuanMnO1xuXG4vKiogT25lIHdob2xlLWZpbGUgcHJlcGFyYXRpb24gcGFzcy4gT25seSBhdXRob3JpemVkIHJhbmdlIG1ldGFkYXRhIGlzIHJldGFpbmVkLCBuZXZlciB0aGUgYXJjaGl2ZSdzIHZhbHVlcy4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBzY2FuSW5kZXhlZEZpbGUoXG4gIGZkOiBudW1iZXIsXG4gIGlkZW50aXR5OiB7IHJlYWRvbmx5IGtleTogc3RyaW5nOyByZWFkb25seSBzaXplOiBudW1iZXIgfSxcbiAgbGltaXRzOiBJbmRleGVkTGltaXRzLFxuICBzaWduYWw6IEFib3J0U2lnbmFsLFxuICBjb3VudDogKGJ5dGVzOiBudW1iZXIpID0+IHZvaWQsXG4pOiBQcm9taXNlPE1hcDxzdHJpbmcsIHJlYWRvbmx5IEluZGV4ZWRSYW5nZVtdPj4ge1xuICBpZiAoaWRlbnRpdHkuc2l6ZSA+IGxpbWl0cy5tYXhCeXRlcykgdGhyb3cgbmV3IEluZGV4ZWRSZWZ1c2FsKCd0b28tbGFyZ2UnKTtcbiAgY29uc3QgaW5kZXggPSBuZXcgTWFwPHN0cmluZywgSW5kZXhlZFJhbmdlW10+KCk7XG4gIGNvbnN0IHRvdGFscyA9IG5ldyBNYXA8c3RyaW5nLCBudW1iZXI+KCk7XG4gIGxldCBlbnRyaWVzID0gMDtcbiAgbGV0IGxpbmVTdGFydCA9IDA7XG4gIGxldCBwaWVjZXM6IFVpbnQ4QXJyYXlbXSA9IFtdO1xuICBsZXQgbGluZUJ5dGVzID0gMDtcbiAgY29uc3QgYXBwZW5kID0gKHBpZWNlOiBVaW50OEFycmF5KSA9PiB7XG4gICAgbGluZUJ5dGVzICs9IHBpZWNlLmxlbmd0aDtcbiAgICBpZiAobGluZUJ5dGVzID4gbGltaXRzLm1heEVudHJ5Qnl0ZXMpIHRocm93IG5ldyBJbmRleGVkUmVmdXNhbCgndG9vLWxhcmdlJyk7XG4gICAgaWYgKHBpZWNlLmxlbmd0aCkgcGllY2VzLnB1c2gocGllY2UpO1xuICB9O1xuICBjb25zdCBkZWNvZGVyID0gbmV3IFRleHREZWNvZGVyKCd1dGYtOCcsIHsgZmF0YWw6IHRydWUgfSk7XG4gIGZvciAobGV0IHBvc2l0aW9uID0gMDsgcG9zaXRpb24gPCBpZGVudGl0eS5zaXplOyApIHtcbiAgICBjaGVja1NpZ25hbChzaWduYWwpO1xuICAgIGNvbnN0IGNodW5rID0gYXdhaXQgcmVhZEJ5dGVzKGZkLCBwb3NpdGlvbiwgTWF0aC5taW4oNjU1MzYsIGlkZW50aXR5LnNpemUgLSBwb3NpdGlvbiksIHNpZ25hbCwgY291bnQpO1xuICAgIHBvc2l0aW9uICs9IGNodW5rLmxlbmd0aDtcbiAgICBsZXQgc3RhcnQgPSAwO1xuICAgIGZvciAobGV0IGVuZCA9IDA7IGVuZCA8IGNodW5rLmxlbmd0aDsgZW5kKyspIHtcbiAgICAgIGlmIChjaHVua1tlbmRdICE9PSAxMCkgY29udGludWU7XG4gICAgICBhcHBlbmQoY2h1bmsuc3ViYXJyYXkoc3RhcnQsIGVuZCArIDEpKTtcbiAgICAgIC8vIEFzc2VtYmxlIG9uY2UgYXQgdGhlIGRlbGltaXRlciwgcmF0aGVyIHRoYW4gcmVwZWF0ZWRseSBjb3B5aW5nIGEgZ3Jvd2luZyBwYXJ0aWFsIGxpbmUuXG4gICAgICBjb25zdCBieXRlcyA9IG5ldyBVaW50OEFycmF5KGxpbmVCeXRlcyk7XG4gICAgICBsZXQgZmlsbGVkID0gMDtcbiAgICAgIGZvciAoY29uc3QgcGllY2Ugb2YgcGllY2VzKSB7XG4gICAgICAgIGJ5dGVzLnNldChwaWVjZSwgZmlsbGVkKTtcbiAgICAgICAgZmlsbGVkICs9IHBpZWNlLmxlbmd0aDtcbiAgICAgIH1cbiAgICAgIGNvbnN0IHRleHQgPSBkZWNvZGVyLmRlY29kZShieXRlcyk7XG4gICAgICBpZiAodGV4dC50cmltKCkpIHtcbiAgICAgICAgaWYgKCsrZW50cmllcyA+IGxpbWl0cy5tYXhFbnRyaWVzKSB0aHJvdyBuZXcgSW5kZXhlZFJlZnVzYWwoJ3Rvby1sYXJnZScpO1xuICAgICAgICBsZXQgcm93OiB1bmtub3duO1xuICAgICAgICB0cnkge1xuICAgICAgICAgIHJvdyA9IEpTT04ucGFyc2UodGV4dCk7XG4gICAgICAgIH0gY2F0Y2gge1xuICAgICAgICAgIHRocm93IG5ldyBJbmRleGVkUmVmdXNhbCgnaW52YWxpZC1kYXRhJyk7XG4gICAgICAgIH1cbiAgICAgICAgY29uc3Qgc2NvcGUgPSBpbmRleGVkQWRkcmVzcyhvd25EYXRhKHJvdywgJ2FkZHJlc3MnKSk7XG4gICAgICAgIGlmIChsaW1pdHMuYWxsb3dlZC5oYXMoc2NvcGUpKSB7XG4gICAgICAgICAgY29uc3QgdG90YWwgPSAodG90YWxzLmdldChzY29wZSkgPz8gMCkgKyBieXRlcy5sZW5ndGg7XG4gICAgICAgICAgaWYgKHRvdGFsID4gbGltaXRzLm1heFNjb3BlQnl0ZXMpIHRocm93IG5ldyBJbmRleGVkUmVmdXNhbCgndG9vLWxhcmdlJyk7XG4gICAgICAgICAgdG90YWxzLnNldChzY29wZSwgdG90YWwpO1xuICAgICAgICAgIGNvbnN0IHJhbmdlcyA9IGluZGV4LmdldChzY29wZSkgPz8gW107XG4gICAgICAgICAgcmFuZ2VzLnB1c2goeyBvZmZzZXQ6IGxpbmVTdGFydCwgYnl0ZXM6IGJ5dGVzLmxlbmd0aCwgZGlnZXN0OiBkaWdlc3QoYnl0ZXMpIH0pO1xuICAgICAgICAgIGluZGV4LnNldChzY29wZSwgcmFuZ2VzKTtcbiAgICAgICAgfVxuICAgICAgfVxuICAgICAgbGluZVN0YXJ0ICs9IGJ5dGVzLmxlbmd0aDtcbiAgICAgIHBpZWNlcyA9IFtdO1xuICAgICAgbGluZUJ5dGVzID0gMDtcbiAgICAgIHN0YXJ0ID0gZW5kICsgMTtcbiAgICB9XG4gICAgYXBwZW5kKGNodW5rLnN1YmFycmF5KHN0YXJ0KSk7XG4gIH1cbiAgaWYgKGxpbmVCeXRlcykgdGhyb3cgbmV3IEluZGV4ZWRSZWZ1c2FsKCdpbnZhbGlkLWRhdGEnKTsgLy8gYSB0b3JuIHRhaWwgbmV2ZXIgYmVjb21lcyBhbiBhYnNlbnQgZXZlbnRcbiAgYXNzZXJ0SWRlbnRpdHkoZmQsIGlkZW50aXR5LmtleSk7XG4gIGNoZWNrU2lnbmFsKHNpZ25hbCk7XG4gIHJldHVybiBpbmRleDtcbn1cbiJdfQ==
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import type { LogAddress } from 'foottrace';
|
|
2
|
+
/** Host authorization is fixed before any stored entry is read. It is never inferred from the index. */
|
|
3
|
+
export interface IndexedRecordFileOptions {
|
|
4
|
+
readonly allowedScopes: readonly LogAddress[];
|
|
5
|
+
/** Preparation scans at most this many file bytes. Default 64 MiB, maximum 256 MiB. */
|
|
6
|
+
readonly maxBytes?: number;
|
|
7
|
+
/** Maximum encoded JSON line. Default 8 MiB, maximum 8 MiB. */
|
|
8
|
+
readonly maxEntryBytes?: number;
|
|
9
|
+
/** Maximum entries indexed across the file. Default 16,384, maximum 65,536. */
|
|
10
|
+
readonly maxEntries?: number;
|
|
11
|
+
/** Maximum bytes read by one selected-scope request. Default 8 MiB, maximum 64 MiB. */
|
|
12
|
+
readonly maxScopeBytes?: number;
|
|
13
|
+
/** Bounds each preparation/read wait; unfinished filesystem work retains its slot. Default 10s, maximum 30s. */
|
|
14
|
+
readonly timeoutMs?: number;
|
|
15
|
+
readonly signal?: AbortSignal;
|
|
16
|
+
}
|
|
17
|
+
export type IndexedRecordFileReason = 'cancelled' | 'timeout' | 'unavailable' | 'invalid-data' | 'too-large' | 'not-permitted' | 'no-match' | 'stale' | 'busy' | 'closed';
|
|
18
|
+
export interface IndexedRecordUnknown {
|
|
19
|
+
readonly status: 'unknown';
|
|
20
|
+
readonly reason: IndexedRecordFileReason;
|
|
21
|
+
}
|
|
22
|
+
export interface IndexedRecordScope {
|
|
23
|
+
readonly status: 'loaded';
|
|
24
|
+
/** Raw untrusted entries for public readStoredRecord/readStoredCapture; loading grants no completeness. */
|
|
25
|
+
readonly entries: readonly unknown[];
|
|
26
|
+
readonly bytesRead: number;
|
|
27
|
+
}
|
|
28
|
+
/** One immutable-file selection capability. No path, descriptor, mutable index or discovered run catalog is served. */
|
|
29
|
+
export interface IndexedRecordFile {
|
|
30
|
+
/** Returned-byte counters and actual scope-read submissions (including failed and pending requests). */
|
|
31
|
+
readonly stats: {
|
|
32
|
+
readonly preparationBytes: number;
|
|
33
|
+
readonly scopeBytes: number;
|
|
34
|
+
readonly readCalls: number;
|
|
35
|
+
};
|
|
36
|
+
readScope(address: LogAddress, context?: {
|
|
37
|
+
readonly signal?: AbortSignal;
|
|
38
|
+
}): Promise<IndexedRecordScope | IndexedRecordUnknown>;
|
|
39
|
+
/** Stop new work immediately, release the descriptor after in-flight work settles. Idempotent. */
|
|
40
|
+
close(): Promise<void>;
|
|
41
|
+
}
|
|
42
|
+
export type IndexedRecordFileResult = {
|
|
43
|
+
readonly status: 'ready';
|
|
44
|
+
readonly reader: IndexedRecordFile;
|
|
45
|
+
} | IndexedRecordUnknown;
|
|
46
|
+
/** @internal Only the preparation pass produces ranges; they never cross the public boundary. */
|
|
47
|
+
export interface IndexedRange {
|
|
48
|
+
readonly offset: number;
|
|
49
|
+
readonly bytes: number;
|
|
50
|
+
readonly digest: string;
|
|
51
|
+
}
|
|
52
|
+
export interface IndexedLimits {
|
|
53
|
+
readonly allowed: ReadonlySet<string>;
|
|
54
|
+
readonly maxBytes: number;
|
|
55
|
+
readonly maxEntryBytes: number;
|
|
56
|
+
readonly maxEntries: number;
|
|
57
|
+
readonly maxScopeBytes: number;
|
|
58
|
+
readonly timeoutMs: number;
|
|
59
|
+
readonly signal?: AbortSignal;
|
|
60
|
+
}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
export {};
|
|
2
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXhlZFR5cGVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2xpYi9zaW5rcy9pbmRleGVkVHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB0eXBlIHsgTG9nQWRkcmVzcyB9IGZyb20gJ2Zvb3R0cmFjZSc7XG5cbi8qKiBIb3N0IGF1dGhvcml6YXRpb24gaXMgZml4ZWQgYmVmb3JlIGFueSBzdG9yZWQgZW50cnkgaXMgcmVhZC4gSXQgaXMgbmV2ZXIgaW5mZXJyZWQgZnJvbSB0aGUgaW5kZXguICovXG5leHBvcnQgaW50ZXJmYWNlIEluZGV4ZWRSZWNvcmRGaWxlT3B0aW9ucyB7XG4gIHJlYWRvbmx5IGFsbG93ZWRTY29wZXM6IHJlYWRvbmx5IExvZ0FkZHJlc3NbXTtcbiAgLyoqIFByZXBhcmF0aW9uIHNjYW5zIGF0IG1vc3QgdGhpcyBtYW55IGZpbGUgYnl0ZXMuIERlZmF1bHQgNjQgTWlCLCBtYXhpbXVtIDI1NiBNaUIuICovXG4gIHJlYWRvbmx5IG1heEJ5dGVzPzogbnVtYmVyO1xuICAvKiogTWF4aW11bSBlbmNvZGVkIEpTT04gbGluZS4gRGVmYXVsdCA4IE1pQiwgbWF4aW11bSA4IE1pQi4gKi9cbiAgcmVhZG9ubHkgbWF4RW50cnlCeXRlcz86IG51bWJlcjtcbiAgLyoqIE1heGltdW0gZW50cmllcyBpbmRleGVkIGFjcm9zcyB0aGUgZmlsZS4gRGVmYXVsdCAxNiwzODQsIG1heGltdW0gNjUsNTM2LiAqL1xuICByZWFkb25seSBtYXhFbnRyaWVzPzogbnVtYmVyO1xuICAvKiogTWF4aW11bSBieXRlcyByZWFkIGJ5IG9uZSBzZWxlY3RlZC1zY29wZSByZXF1ZXN0LiBEZWZhdWx0IDggTWlCLCBtYXhpbXVtIDY0IE1pQi4gKi9cbiAgcmVhZG9ubHkgbWF4U2NvcGVCeXRlcz86IG51bWJlcjtcbiAgLyoqIEJvdW5kcyBlYWNoIHByZXBhcmF0aW9uL3JlYWQgd2FpdDsgdW5maW5pc2hlZCBmaWxlc3lzdGVtIHdvcmsgcmV0YWlucyBpdHMgc2xvdC4gRGVmYXVsdCAxMHMsIG1heGltdW0gMzBzLiAqL1xuICByZWFkb25seSB0aW1lb3V0TXM/OiBudW1iZXI7XG4gIHJlYWRvbmx5IHNpZ25hbD86IEFib3J0U2lnbmFsO1xufVxuXG5leHBvcnQgdHlwZSBJbmRleGVkUmVjb3JkRmlsZVJlYXNvbiA9XG4gIHwgJ2NhbmNlbGxlZCdcbiAgfCAndGltZW91dCdcbiAgfCAndW5hdmFpbGFibGUnXG4gIHwgJ2ludmFsaWQtZGF0YSdcbiAgfCAndG9vLWxhcmdlJ1xuICB8ICdub3QtcGVybWl0dGVkJ1xuICB8ICduby1tYXRjaCdcbiAgfCAnc3RhbGUnXG4gIHwgJ2J1c3knXG4gIHwgJ2Nsb3NlZCc7XG5cbmV4cG9ydCBpbnRlcmZhY2UgSW5kZXhlZFJlY29yZFVua25vd24ge1xuICByZWFkb25seSBzdGF0dXM6ICd1bmtub3duJztcbiAgcmVhZG9ubHkgcmVhc29uOiBJbmRleGVkUmVjb3JkRmlsZVJlYXNvbjtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBJbmRleGVkUmVjb3JkU2NvcGUge1xuICByZWFkb25seSBzdGF0dXM6ICdsb2FkZWQnO1xuICAvKiogUmF3IHVudHJ1c3RlZCBlbnRyaWVzIGZvciBwdWJsaWMgcmVhZFN0b3JlZFJlY29yZC9yZWFkU3RvcmVkQ2FwdHVyZTsgbG9hZGluZyBncmFudHMgbm8gY29tcGxldGVuZXNzLiAqL1xuICByZWFkb25seSBlbnRyaWVzOiByZWFkb25seSB1bmtub3duW107XG4gIHJlYWRvbmx5IGJ5dGVzUmVhZDogbnVtYmVyO1xufVxuXG4vKiogT25lIGltbXV0YWJsZS1maWxlIHNlbGVjdGlvbiBjYXBhYmlsaXR5LiBObyBwYXRoLCBkZXNjcmlwdG9yLCBtdXRhYmxlIGluZGV4IG9yIGRpc2NvdmVyZWQgcnVuIGNhdGFsb2cgaXMgc2VydmVkLiAqL1xuZXhwb3J0IGludGVyZmFjZSBJbmRleGVkUmVjb3JkRmlsZSB7XG4gIC8qKiBSZXR1cm5lZC1ieXRlIGNvdW50ZXJzIGFuZCBhY3R1YWwgc2NvcGUtcmVhZCBzdWJtaXNzaW9ucyAoaW5jbHVkaW5nIGZhaWxlZCBhbmQgcGVuZGluZyByZXF1ZXN0cykuICovXG4gIHJlYWRvbmx5IHN0YXRzOiB7IHJlYWRvbmx5IHByZXBhcmF0aW9uQnl0ZXM6IG51bWJlcjsgcmVhZG9ubHkgc2NvcGVCeXRlczogbnVtYmVyOyByZWFkb25seSByZWFkQ2FsbHM6IG51bWJlciB9O1xuICByZWFkU2NvcGUoXG4gICAgYWRkcmVzczogTG9nQWRkcmVzcyxcbiAgICBjb250ZXh0PzogeyByZWFkb25seSBzaWduYWw/OiBBYm9ydFNpZ25hbCB9LFxuICApOiBQcm9taXNlPEluZGV4ZWRSZWNvcmRTY29wZSB8IEluZGV4ZWRSZWNvcmRVbmtub3duPjtcbiAgLyoqIFN0b3AgbmV3IHdvcmsgaW1tZWRpYXRlbHksIHJlbGVhc2UgdGhlIGRlc2NyaXB0b3IgYWZ0ZXIgaW4tZmxpZ2h0IHdvcmsgc2V0dGxlcy4gSWRlbXBvdGVudC4gKi9cbiAgY2xvc2UoKTogUHJvbWlzZTx2b2lkPjtcbn1cblxuZXhwb3J0IHR5cGUgSW5kZXhlZFJlY29yZEZpbGVSZXN1bHQgPVxuICB8IHsgcmVhZG9ubHkgc3RhdHVzOiAncmVhZHknOyByZWFkb25seSByZWFkZXI6IEluZGV4ZWRSZWNvcmRGaWxlIH1cbiAgfCBJbmRleGVkUmVjb3JkVW5rbm93bjtcblxuLyoqIEBpbnRlcm5hbCBPbmx5IHRoZSBwcmVwYXJhdGlvbiBwYXNzIHByb2R1Y2VzIHJhbmdlczsgdGhleSBuZXZlciBjcm9zcyB0aGUgcHVibGljIGJvdW5kYXJ5LiAqL1xuZXhwb3J0IGludGVyZmFjZSBJbmRleGVkUmFuZ2Uge1xuICByZWFkb25seSBvZmZzZXQ6IG51bWJlcjtcbiAgcmVhZG9ubHkgYnl0ZXM6IG51bWJlcjtcbiAgcmVhZG9ubHkgZGlnZXN0OiBzdHJpbmc7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgSW5kZXhlZExpbWl0cyB7XG4gIHJlYWRvbmx5IGFsbG93ZWQ6IFJlYWRvbmx5U2V0PHN0cmluZz47XG4gIHJlYWRvbmx5IG1heEJ5dGVzOiBudW1iZXI7XG4gIHJlYWRvbmx5IG1heEVudHJ5Qnl0ZXM6IG51bWJlcjtcbiAgcmVhZG9ubHkgbWF4RW50cmllczogbnVtYmVyO1xuICByZWFkb25seSBtYXhTY29wZUJ5dGVzOiBudW1iZXI7XG4gIHJlYWRvbmx5IHRpbWVvdXRNczogbnVtYmVyO1xuICByZWFkb25seSBzaWduYWw/OiBBYm9ydFNpZ25hbDtcbn1cbiJdfQ==
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* timers/longTimeout.ts — the ONE long-timer law: how the library arms a host timer for a limit of any length.
|
|
3
|
+
*
|
|
4
|
+
* A host timer holds at most 2^31 − 1 ms (about 24.8 days). Node turns a longer delay — `Infinity` included — into
|
|
5
|
+
* 1 ms, with a `TimeoutOverflowWarning`, so a raw `setTimeout(fn, limit)` gives up at once exactly when the caller
|
|
6
|
+
* asked to wait longest. Every wait of a caller-supplied length is armed here: an attempt's cap and the wait between
|
|
7
|
+
* attempts (`attempt/runner.ts`), the run's deadline (`attempt/deadline.ts · armDeadline`,
|
|
8
|
+
* `runner/deadline.ts · armRun`), the drains and flushes that wait at most a caller's `timeoutMs`
|
|
9
|
+
* (`observer-queue/deferredDispatcher.ts · drain`, `detach/flush.ts · flushAllDetached`, `runner/recordSink.ts ·
|
|
10
|
+
* flush`, `sinks/fileSink.ts`), the bounded reads (`sinks/indexedIO.ts`, `recorder/AttemptRecorder.ts`,
|
|
11
|
+
* `runner/captureHistory.ts`) and the `setTimeout` detach driver. `test/architecture/timer-law.test.ts` refuses a raw
|
|
12
|
+
* host timer — or any other way of reaching one — anywhere else in `src/`.
|
|
13
|
+
*
|
|
14
|
+
* THE LAW, by the limit:
|
|
15
|
+
* - `Infinity` — no limit: NO timer is armed and `fn` never runs, so nothing keeps the process alive on its account.
|
|
16
|
+
* The work the limit bounds decides when the wait ends.
|
|
17
|
+
* - a finite delay past 2^31 − 1 ms — waited in chunks of at most 2^31 − 1 ms, so it never fires early and never in
|
|
18
|
+
* 1 ms: a 30-day deadline fires after 30 days.
|
|
19
|
+
* - anything else that is not a number > 0 (`0`, a negative, `-Infinity`, `NaN`) — already due: `fn` runs on the
|
|
20
|
+
* next timer turn, as the host runs `setTimeout(fn, 0)`.
|
|
21
|
+
*
|
|
22
|
+
* A LEAF in its own neutral folder (`timers/`, L0 in scripts/layering.config.cjs): it imports nothing, so any layer —
|
|
23
|
+
* the observer queue (L1) as much as the engine — arms its limits with the one law.
|
|
24
|
+
*/
|
|
25
|
+
/** How a long timer is armed. */
|
|
26
|
+
export interface LongTimeoutOptions {
|
|
27
|
+
/**
|
|
28
|
+
* Unref every host timer it arms (where the host has `unref`), so a timer that only BOUNDS a wait never keeps the
|
|
29
|
+
* process alive on its own. Off by default: the engine's own limits keep a run alive while it waits.
|
|
30
|
+
*/
|
|
31
|
+
readonly unref?: boolean;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* `setTimeout` for a limit of any length, by the law above. Returns the one call that cancels it — a no-op when no
|
|
35
|
+
* timer was armed (`Infinity`).
|
|
36
|
+
*/
|
|
37
|
+
export declare function setLongTimeout(fn: () => void, ms: number, options?: LongTimeoutOptions): () => void;
|