wherever-dev 0.18.4 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/dist/builtin-extensions.d.ts +28 -0
  2. package/dist/builtin-extensions.d.ts.map +1 -0
  3. package/dist/builtin-extensions.js +28 -0
  4. package/dist/builtin-extensions.js.map +1 -0
  5. package/dist/config-dir.d.ts +13 -0
  6. package/dist/config-dir.d.ts.map +1 -0
  7. package/dist/config-dir.js +18 -0
  8. package/dist/config-dir.js.map +1 -0
  9. package/dist/extension-lifecycle.d.ts +3 -2
  10. package/dist/extension-lifecycle.d.ts.map +1 -1
  11. package/dist/extension-lifecycle.js +8 -4
  12. package/dist/extension-lifecycle.js.map +1 -1
  13. package/dist/index.js +377 -35
  14. package/dist/index.js.map +1 -1
  15. package/dist/pi-sdk-policy.d.ts +91 -0
  16. package/dist/pi-sdk-policy.d.ts.map +1 -0
  17. package/dist/pi-sdk-policy.js +173 -0
  18. package/dist/pi-sdk-policy.js.map +1 -0
  19. package/dist/pi-sdk.d.ts +56 -0
  20. package/dist/pi-sdk.d.ts.map +1 -0
  21. package/dist/pi-sdk.js +124 -0
  22. package/dist/pi-sdk.js.map +1 -0
  23. package/dist/protocol.d.ts +23 -0
  24. package/dist/protocol.d.ts.map +1 -1
  25. package/dist/session-pool.d.ts +56 -12
  26. package/dist/session-pool.d.ts.map +1 -1
  27. package/dist/session-pool.js +108 -36
  28. package/dist/session-pool.js.map +1 -1
  29. package/dist/upload-gate.d.ts +96 -0
  30. package/dist/upload-gate.d.ts.map +1 -0
  31. package/dist/upload-gate.js +109 -0
  32. package/dist/upload-gate.js.map +1 -0
  33. package/dist/upload-staging.d.ts +172 -0
  34. package/dist/upload-staging.d.ts.map +1 -0
  35. package/dist/upload-staging.js +368 -0
  36. package/dist/upload-staging.js.map +1 -0
  37. package/package.json +5 -3
  38. package/public/_app/immutable/assets/{0.BnOlDJL_.css → 0.Cb5vRzMp.css} +1 -1
  39. package/public/_app/immutable/chunks/{wEbpki5g.js → B4u7MCsa.js} +2 -2
  40. package/public/_app/immutable/chunks/{wEbpki5g.js.map → B4u7MCsa.js.map} +1 -1
  41. package/public/_app/immutable/chunks/{D7qz2w2U.js → CMMpRRWm.js} +2 -2
  42. package/public/_app/immutable/chunks/{D7qz2w2U.js.map → CMMpRRWm.js.map} +1 -1
  43. package/public/_app/immutable/chunks/{Ds-VJGnt.js → D7cniAcl.js} +2 -2
  44. package/public/_app/immutable/chunks/{Ds-VJGnt.js.map → D7cniAcl.js.map} +1 -1
  45. package/public/_app/immutable/entry/{app.DTMeXTQG.js → app.B09hP3rk.js} +3 -3
  46. package/public/_app/immutable/entry/{app.DTMeXTQG.js.map → app.B09hP3rk.js.map} +1 -1
  47. package/public/_app/immutable/entry/start.DsunIvKH.js +2 -0
  48. package/public/_app/immutable/entry/start.DsunIvKH.js.map +1 -0
  49. package/public/_app/immutable/nodes/{0.CCTuxjIi.js → 0.Bl6oKVU5.js} +2 -2
  50. package/public/_app/immutable/nodes/{0.CCTuxjIi.js.map → 0.Bl6oKVU5.js.map} +1 -1
  51. package/public/_app/immutable/nodes/{1.5ZhRu6ko.js → 1.H6kc-Qsz.js} +2 -2
  52. package/public/_app/immutable/nodes/{1.5ZhRu6ko.js.map → 1.H6kc-Qsz.js.map} +1 -1
  53. package/public/_app/immutable/nodes/2.B6sChdvF.js +120 -0
  54. package/public/_app/immutable/nodes/2.B6sChdvF.js.map +1 -0
  55. package/public/_app/version.json +1 -1
  56. package/public/index.html +11 -11
  57. package/public/service-worker.js +1 -1
  58. package/public/_app/immutable/entry/start.CwhL7q0v.js +0 -2
  59. package/public/_app/immutable/entry/start.CwhL7q0v.js.map +0 -1
  60. package/public/_app/immutable/nodes/2.DOUZvKq4.js +0 -120
  61. package/public/_app/immutable/nodes/2.DOUZvKq4.js.map +0 -1
@@ -0,0 +1,172 @@
1
+ /**
2
+ * Server-side staging for RESUMABLE, CHUNKED uploads (docs/adr/0012).
3
+ *
4
+ * One server-owned directory, `getWhereverStateDir()/upload-staging/`, holds every
5
+ * in-flight upload as two entries keyed by the client-generated `uploadId`:
6
+ *
7
+ * - `<uploadId>` the partial file; its SIZE is the acknowledged offset;
8
+ * - `<uploadId>.json` the sidecar (`UploadSidecar`), the durable record of what
9
+ * the upload is (`sessionId`, `filename`, `size`), where it
10
+ * goes (`targetDir`, resolved ONCE at begin) and, once
11
+ * finished, where it went (`done`, `savedPath`).
12
+ *
13
+ * The sidecar is what makes completion idempotent across a lost reply or a server
14
+ * restart: a repeated begin or finish of a finished id answers with the recorded
15
+ * `savedPath` instead of writing a second copy.
16
+ *
17
+ * Every operation on one `uploadId` runs through a per-id SERIAL QUEUE, and the
18
+ * `offset === currentOffset` check of a chunk runs INSIDE it, so two sockets
19
+ * racing chunks for the same id (a resumed upload whose old socket is still
20
+ * flushing) can never interleave writes or both be accepted for one offset.
21
+ *
22
+ * This module knows nothing about WebSockets, sessions or the write gate: the
23
+ * caller passes an `authorize(sidecar)` callback that runs inside the queue, so a
24
+ * gate verdict is taken against the sidecar the write will actually use.
25
+ */
26
+ /** Wire capability advertised in `connected.capabilities`. */
27
+ export declare const UPLOAD_CAPABILITY = "upload.v1";
28
+ /** Hard cap on one chunk's payload. Small enough that heartbeat frames interleave. */
29
+ export declare const UPLOAD_CHUNK_MAX_BYTES: number;
30
+ /** Staging entries untouched for this long are garbage-collected. */
31
+ export declare const UPLOAD_STAGING_MAX_AGE_MS: number;
32
+ /** First byte of a binary chunk frame. */
33
+ export declare const CHUNK_FRAME_KIND = 1;
34
+ /** Second byte of a binary chunk frame. */
35
+ export declare const CHUNK_FRAME_VERSION = 1;
36
+ /** A client-generated upload id: URL-safe, 22..64 chars (>= 128 random bits base64url). */
37
+ export declare function isValidUploadId(id: unknown): id is string;
38
+ export interface UploadSidecar {
39
+ uploadId: string;
40
+ sessionId: string;
41
+ filename: string;
42
+ size: number;
43
+ mime?: string;
44
+ /** Absolute target folder, resolved once at begin from the painted cwd. */
45
+ targetDir: string;
46
+ createdAt: number;
47
+ /** True once the file has been moved to `savedPath`. */
48
+ done?: boolean;
49
+ /**
50
+ * The final path. Written BEFORE the move (with `done` unset), so a crash
51
+ * between the move and recording `done` is completed by the next finish rather
52
+ * than producing a second, differently-named copy.
53
+ */
54
+ savedPath?: string;
55
+ }
56
+ export type ParsedChunkFrame = {
57
+ ok: true;
58
+ uploadId: string;
59
+ offset: number;
60
+ payload: Buffer;
61
+ } | {
62
+ ok: false;
63
+ uploadId: string;
64
+ error: string;
65
+ };
66
+ /**
67
+ * Parse `[u8 kind=1][u8 version=1][u8 idLen][uploadId ascii][u64 offset BE][payload]`.
68
+ * `uploadId` is returned whenever it could be read, so the refusal can be routed.
69
+ */
70
+ export declare function parseChunkFrame(buf: Buffer): ParsedChunkFrame;
71
+ /** Build a chunk frame (used by tests and as the reference encoder). */
72
+ export declare function encodeChunkFrame(uploadId: string, offset: number, payload: Uint8Array): Buffer;
73
+ /** Answer of begin / chunk: the server's offset. */
74
+ export type OffsetResult = {
75
+ ok: true;
76
+ offset: number;
77
+ size: number;
78
+ sessionId: string;
79
+ done?: boolean;
80
+ savedPath?: string;
81
+ accepted?: boolean;
82
+ } | {
83
+ ok: false;
84
+ error: string;
85
+ sessionId: string;
86
+ };
87
+ export type FinishResult = {
88
+ ok: true;
89
+ savedPath: string;
90
+ filename: string;
91
+ sessionId: string;
92
+ } | {
93
+ ok: false;
94
+ error: string;
95
+ sessionId: string;
96
+ };
97
+ /** Returns a refusal reason, or null when the operation may proceed. */
98
+ export type Authorize = (sidecar: UploadSidecar) => string | null;
99
+ export interface UploadStagingOptions {
100
+ /** The staging directory (`<state dir>/upload-staging`). Created lazily. */
101
+ dir: string;
102
+ /** Injectable for the EXDEV test. Defaults to `fs.promises.rename`. */
103
+ rename?: (from: string, to: string) => Promise<void>;
104
+ /** Injectable clock. */
105
+ now?: () => number;
106
+ maxAgeMs?: number;
107
+ }
108
+ export interface BeginRequest {
109
+ uploadId: string;
110
+ sessionId: string;
111
+ filename: string;
112
+ size: number;
113
+ mime?: string;
114
+ /** Resolved only for a NEW id; a known id keeps its recorded target. */
115
+ targetDir: () => string;
116
+ }
117
+ export declare class UploadStaging {
118
+ readonly dir: string;
119
+ private readonly renameFn;
120
+ private readonly now;
121
+ private readonly maxAgeMs;
122
+ private readonly queues;
123
+ constructor(opts: UploadStagingOptions);
124
+ partialPath(uploadId: string): string;
125
+ sidecarPath(uploadId: string): string;
126
+ /** Run `fn` after every earlier operation on `uploadId` has settled. */
127
+ private enqueue;
128
+ readSidecar(uploadId: string): Promise<UploadSidecar | null>;
129
+ private writeSidecar;
130
+ private partialSize;
131
+ /**
132
+ * Start or resume an upload. Idempotent: a known id must match the sidecar's
133
+ * `sessionId`, `size` and `filename`, and answers with the bytes already
134
+ * staged; a finished id answers `{ offset: size, done: true, savedPath }`.
135
+ */
136
+ begin(req: BeginRequest, authorize?: Authorize): Promise<OffsetResult>;
137
+ /**
138
+ * Write one chunk at `offset`. Accepted only when `offset` equals the bytes
139
+ * already staged (checked inside the serial queue); otherwise answers with the
140
+ * true offset and `accepted: false`, which is how a client realigns.
141
+ */
142
+ writeChunk(uploadId: string, offset: number, payload: Buffer, authorize?: Authorize): Promise<OffsetResult>;
143
+ /**
144
+ * Move a complete upload into its target dir and record it. Repeated finishes
145
+ * (lost reply, restart) return the same `savedPath`.
146
+ *
147
+ * Decision (recorded at the choice site): a finish before every byte is staged
148
+ * is a refusal (`ok: false` with the staged/declared counts), not an
149
+ * `upload_offset` realign. A conforming client only finishes after its last
150
+ * ack reached `size`, so this is a client bug, and answering with an offset
151
+ * would let a buggy client loop silently. The alternative (reply with the true
152
+ * offset so the client resends) was considered and rejected for that reason.
153
+ */
154
+ finish(uploadId: string, sessionId: string, authorize?: Authorize, nameFor?: (filename: string) => string): Promise<FinishResult>;
155
+ /** Rename, falling back to copy + unlink across filesystems (`EXDEV`). */
156
+ private move;
157
+ /**
158
+ * Delete an unfinished upload's partial and sidecar. A finished id is left
159
+ * alone (its sidecar keeps completion idempotent; the saved file is the
160
+ * user's). Returns a refusal reason or null.
161
+ */
162
+ abort(uploadId: string, sessionId: string): Promise<string | null>;
163
+ /**
164
+ * Remove every staging entry (partial, sidecar, leftover `.tmp`) whose newest
165
+ * mtime is older than `maxAgeMs`, skipping ids with a queued operation.
166
+ * Returns the number of upload ids removed.
167
+ */
168
+ gc(): Promise<number>;
169
+ /** Is `p` (already resolved) the staging dir or inside it? Lexical and realpath. */
170
+ contains(p: string): boolean;
171
+ }
172
+ //# sourceMappingURL=upload-staging.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upload-staging.d.ts","sourceRoot":"","sources":["../src/upload-staging.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,368 @@
1
+ /**
2
+ * Server-side staging for RESUMABLE, CHUNKED uploads (docs/adr/0012).
3
+ *
4
+ * One server-owned directory, `getWhereverStateDir()/upload-staging/`, holds every
5
+ * in-flight upload as two entries keyed by the client-generated `uploadId`:
6
+ *
7
+ * - `<uploadId>` the partial file; its SIZE is the acknowledged offset;
8
+ * - `<uploadId>.json` the sidecar (`UploadSidecar`), the durable record of what
9
+ * the upload is (`sessionId`, `filename`, `size`), where it
10
+ * goes (`targetDir`, resolved ONCE at begin) and, once
11
+ * finished, where it went (`done`, `savedPath`).
12
+ *
13
+ * The sidecar is what makes completion idempotent across a lost reply or a server
14
+ * restart: a repeated begin or finish of a finished id answers with the recorded
15
+ * `savedPath` instead of writing a second copy.
16
+ *
17
+ * Every operation on one `uploadId` runs through a per-id SERIAL QUEUE, and the
18
+ * `offset === currentOffset` check of a chunk runs INSIDE it, so two sockets
19
+ * racing chunks for the same id (a resumed upload whose old socket is still
20
+ * flushing) can never interleave writes or both be accepted for one offset.
21
+ *
22
+ * This module knows nothing about WebSockets, sessions or the write gate: the
23
+ * caller passes an `authorize(sidecar)` callback that runs inside the queue, so a
24
+ * gate verdict is taken against the sidecar the write will actually use.
25
+ */
26
+ import fs from 'node:fs';
27
+ import fsp from 'node:fs/promises';
28
+ import path from 'node:path';
29
+ /** Wire capability advertised in `connected.capabilities`. */
30
+ export const UPLOAD_CAPABILITY = 'upload.v1';
31
+ /** Hard cap on one chunk's payload. Small enough that heartbeat frames interleave. */
32
+ export const UPLOAD_CHUNK_MAX_BYTES = 1024 * 1024;
33
+ /** Staging entries untouched for this long are garbage-collected. */
34
+ export const UPLOAD_STAGING_MAX_AGE_MS = 24 * 60 * 60 * 1000;
35
+ /** First byte of a binary chunk frame. */
36
+ export const CHUNK_FRAME_KIND = 1;
37
+ /** Second byte of a binary chunk frame. */
38
+ export const CHUNK_FRAME_VERSION = 1;
39
+ const UPLOAD_ID_RE = /^[A-Za-z0-9_-]{22,64}$/;
40
+ /** A client-generated upload id: URL-safe, 22..64 chars (>= 128 random bits base64url). */
41
+ export function isValidUploadId(id) {
42
+ return typeof id === 'string' && UPLOAD_ID_RE.test(id);
43
+ }
44
+ /**
45
+ * Parse `[u8 kind=1][u8 version=1][u8 idLen][uploadId ascii][u64 offset BE][payload]`.
46
+ * `uploadId` is returned whenever it could be read, so the refusal can be routed.
47
+ */
48
+ export function parseChunkFrame(buf) {
49
+ if (buf.length < 3)
50
+ return { ok: false, uploadId: '', error: 'Malformed upload chunk (too short).' };
51
+ if (buf[0] !== CHUNK_FRAME_KIND)
52
+ return { ok: false, uploadId: '', error: 'Unknown binary frame kind.' };
53
+ if (buf[1] !== CHUNK_FRAME_VERSION) {
54
+ return { ok: false, uploadId: '', error: `Unsupported upload chunk version ${buf[1]}.` };
55
+ }
56
+ const idLen = buf[2];
57
+ const headerLen = 3 + idLen + 8;
58
+ if (buf.length < headerLen)
59
+ return { ok: false, uploadId: '', error: 'Malformed upload chunk (truncated header).' };
60
+ const uploadId = buf.subarray(3, 3 + idLen).toString('latin1');
61
+ if (!isValidUploadId(uploadId))
62
+ return { ok: false, uploadId: '', error: 'Invalid uploadId.' };
63
+ const big = buf.readBigUInt64BE(3 + idLen);
64
+ if (big > BigInt(Number.MAX_SAFE_INTEGER))
65
+ return { ok: false, uploadId, error: 'Invalid chunk offset.' };
66
+ const payload = buf.subarray(headerLen);
67
+ if (payload.length > UPLOAD_CHUNK_MAX_BYTES) {
68
+ return {
69
+ ok: false,
70
+ uploadId,
71
+ error: `Upload chunk too large (${payload.length} bytes, the limit is ${UPLOAD_CHUNK_MAX_BYTES} bytes).`,
72
+ };
73
+ }
74
+ return { ok: true, uploadId, offset: Number(big), payload };
75
+ }
76
+ /** Build a chunk frame (used by tests and as the reference encoder). */
77
+ export function encodeChunkFrame(uploadId, offset, payload) {
78
+ const id = Buffer.from(uploadId, 'latin1');
79
+ const head = Buffer.alloc(3 + id.length + 8);
80
+ head[0] = CHUNK_FRAME_KIND;
81
+ head[1] = CHUNK_FRAME_VERSION;
82
+ head[2] = id.length;
83
+ id.copy(head, 3);
84
+ head.writeBigUInt64BE(BigInt(offset), 3 + id.length);
85
+ return Buffer.concat([head, Buffer.from(payload)]);
86
+ }
87
+ export class UploadStaging {
88
+ dir;
89
+ renameFn;
90
+ now;
91
+ maxAgeMs;
92
+ queues = new Map();
93
+ constructor(opts) {
94
+ this.dir = path.resolve(opts.dir);
95
+ this.renameFn = opts.rename ?? ((a, b) => fsp.rename(a, b));
96
+ this.now = opts.now ?? Date.now;
97
+ this.maxAgeMs = opts.maxAgeMs ?? UPLOAD_STAGING_MAX_AGE_MS;
98
+ }
99
+ partialPath(uploadId) {
100
+ return path.join(this.dir, uploadId);
101
+ }
102
+ sidecarPath(uploadId) {
103
+ return path.join(this.dir, `${uploadId}.json`);
104
+ }
105
+ /** Run `fn` after every earlier operation on `uploadId` has settled. */
106
+ enqueue(uploadId, fn) {
107
+ const prev = this.queues.get(uploadId) ?? Promise.resolve();
108
+ const run = prev.then(fn, fn);
109
+ const tail = run.catch(() => { });
110
+ this.queues.set(uploadId, tail);
111
+ tail.then(() => {
112
+ if (this.queues.get(uploadId) === tail)
113
+ this.queues.delete(uploadId);
114
+ });
115
+ return run;
116
+ }
117
+ async readSidecar(uploadId) {
118
+ try {
119
+ const raw = await fsp.readFile(this.sidecarPath(uploadId), 'utf8');
120
+ const s = JSON.parse(raw);
121
+ return s && typeof s === 'object' && s.uploadId === uploadId ? s : null;
122
+ }
123
+ catch {
124
+ return null;
125
+ }
126
+ }
127
+ async writeSidecar(s) {
128
+ await fsp.mkdir(this.dir, { recursive: true });
129
+ const tmp = `${this.sidecarPath(s.uploadId)}.tmp`;
130
+ await fsp.writeFile(tmp, JSON.stringify(s));
131
+ await fsp.rename(tmp, this.sidecarPath(s.uploadId));
132
+ }
133
+ async partialSize(uploadId) {
134
+ try {
135
+ return (await fsp.stat(this.partialPath(uploadId))).size;
136
+ }
137
+ catch {
138
+ return null;
139
+ }
140
+ }
141
+ /**
142
+ * Start or resume an upload. Idempotent: a known id must match the sidecar's
143
+ * `sessionId`, `size` and `filename`, and answers with the bytes already
144
+ * staged; a finished id answers `{ offset: size, done: true, savedPath }`.
145
+ */
146
+ begin(req, authorize) {
147
+ return this.enqueue(req.uploadId, async () => {
148
+ const existing = await this.readSidecar(req.uploadId);
149
+ if (existing) {
150
+ if (existing.sessionId !== req.sessionId) {
151
+ return { ok: false, sessionId: req.sessionId, error: 'This upload id belongs to a different session.' };
152
+ }
153
+ if (existing.size !== req.size || existing.filename !== req.filename) {
154
+ return {
155
+ ok: false,
156
+ sessionId: req.sessionId,
157
+ error: 'This upload id is already in use for a different file.',
158
+ };
159
+ }
160
+ const refused = authorize?.(existing);
161
+ if (refused)
162
+ return { ok: false, sessionId: existing.sessionId, error: refused };
163
+ if (existing.done && existing.savedPath) {
164
+ return { ok: true, offset: existing.size, size: existing.size, sessionId: existing.sessionId, done: true, savedPath: existing.savedPath };
165
+ }
166
+ let offset = await this.partialSize(req.uploadId);
167
+ if (offset === null) {
168
+ await fsp.writeFile(this.partialPath(req.uploadId), Buffer.alloc(0));
169
+ offset = 0;
170
+ }
171
+ return { ok: true, offset, size: existing.size, sessionId: existing.sessionId };
172
+ }
173
+ const sidecar = {
174
+ uploadId: req.uploadId,
175
+ sessionId: req.sessionId,
176
+ filename: req.filename,
177
+ size: req.size,
178
+ ...(req.mime ? { mime: req.mime } : {}),
179
+ targetDir: '',
180
+ createdAt: this.now(),
181
+ };
182
+ const refused = authorize?.(sidecar);
183
+ if (refused)
184
+ return { ok: false, sessionId: req.sessionId, error: refused };
185
+ sidecar.targetDir = path.resolve(req.targetDir());
186
+ await fsp.mkdir(this.dir, { recursive: true });
187
+ await fsp.writeFile(this.partialPath(req.uploadId), Buffer.alloc(0));
188
+ await this.writeSidecar(sidecar);
189
+ return { ok: true, offset: 0, size: req.size, sessionId: req.sessionId };
190
+ });
191
+ }
192
+ /**
193
+ * Write one chunk at `offset`. Accepted only when `offset` equals the bytes
194
+ * already staged (checked inside the serial queue); otherwise answers with the
195
+ * true offset and `accepted: false`, which is how a client realigns.
196
+ */
197
+ writeChunk(uploadId, offset, payload, authorize) {
198
+ return this.enqueue(uploadId, async () => {
199
+ const s = await this.readSidecar(uploadId);
200
+ if (!s)
201
+ return { ok: false, sessionId: '', error: 'Unknown upload (send upload_begin first).' };
202
+ const refused = authorize?.(s);
203
+ if (refused)
204
+ return { ok: false, sessionId: s.sessionId, error: refused };
205
+ if (s.done) {
206
+ return { ok: true, offset: s.size, size: s.size, sessionId: s.sessionId, done: true, savedPath: s.savedPath, accepted: false };
207
+ }
208
+ const current = await this.partialSize(uploadId);
209
+ if (current === null)
210
+ return { ok: false, sessionId: s.sessionId, error: 'Upload partial is missing (send upload_begin again).' };
211
+ if (offset !== current) {
212
+ return { ok: true, offset: current, size: s.size, sessionId: s.sessionId, accepted: false };
213
+ }
214
+ if (current + payload.length > s.size) {
215
+ return {
216
+ ok: false,
217
+ sessionId: s.sessionId,
218
+ error: `Upload chunk overruns the declared size (${current + payload.length} > ${s.size} bytes).`,
219
+ };
220
+ }
221
+ const fh = await fsp.open(this.partialPath(uploadId), 'r+');
222
+ try {
223
+ if (payload.length > 0)
224
+ await fh.write(payload, 0, payload.length, current);
225
+ }
226
+ finally {
227
+ await fh.close();
228
+ }
229
+ return { ok: true, offset: current + payload.length, size: s.size, sessionId: s.sessionId, accepted: true };
230
+ });
231
+ }
232
+ /**
233
+ * Move a complete upload into its target dir and record it. Repeated finishes
234
+ * (lost reply, restart) return the same `savedPath`.
235
+ *
236
+ * Decision (recorded at the choice site): a finish before every byte is staged
237
+ * is a refusal (`ok: false` with the staged/declared counts), not an
238
+ * `upload_offset` realign. A conforming client only finishes after its last
239
+ * ack reached `size`, so this is a client bug, and answering with an offset
240
+ * would let a buggy client loop silently. The alternative (reply with the true
241
+ * offset so the client resends) was considered and rejected for that reason.
242
+ */
243
+ finish(uploadId, sessionId, authorize, nameFor) {
244
+ return this.enqueue(uploadId, async () => {
245
+ const s = await this.readSidecar(uploadId);
246
+ if (!s)
247
+ return { ok: false, sessionId, error: 'Unknown upload (send upload_begin first).' };
248
+ if (s.sessionId !== sessionId) {
249
+ return { ok: false, sessionId, error: 'This upload id belongs to a different session.' };
250
+ }
251
+ const refused = authorize?.(s);
252
+ if (refused)
253
+ return { ok: false, sessionId, error: refused };
254
+ if (s.done && s.savedPath)
255
+ return { ok: true, savedPath: s.savedPath, filename: s.filename, sessionId };
256
+ const staged = await this.partialSize(uploadId);
257
+ if (staged === null) {
258
+ // A crash after the move but before `done` was recorded: the file is
259
+ // already at the recorded path.
260
+ if (s.savedPath && fs.existsSync(s.savedPath)) {
261
+ await this.writeSidecar({ ...s, done: true });
262
+ return { ok: true, savedPath: s.savedPath, filename: s.filename, sessionId };
263
+ }
264
+ return { ok: false, sessionId, error: 'Upload partial is missing (send upload_begin again).' };
265
+ }
266
+ if (staged !== s.size) {
267
+ return { ok: false, sessionId, error: `Upload incomplete (${staged} of ${s.size} bytes received).` };
268
+ }
269
+ let savedPath = s.savedPath;
270
+ if (!savedPath) {
271
+ const name = nameFor ? nameFor(s.filename) : `${this.now()}_${path.basename(s.filename)}`;
272
+ savedPath = path.join(s.targetDir, name);
273
+ await this.writeSidecar({ ...s, savedPath });
274
+ }
275
+ await fsp.mkdir(path.dirname(savedPath), { recursive: true });
276
+ await this.move(this.partialPath(uploadId), savedPath);
277
+ await this.writeSidecar({ ...s, savedPath, done: true });
278
+ return { ok: true, savedPath, filename: s.filename, sessionId };
279
+ });
280
+ }
281
+ /** Rename, falling back to copy + unlink across filesystems (`EXDEV`). */
282
+ async move(from, to) {
283
+ try {
284
+ await this.renameFn(from, to);
285
+ }
286
+ catch (err) {
287
+ if (err?.code !== 'EXDEV')
288
+ throw err;
289
+ await fsp.copyFile(from, to);
290
+ await fsp.unlink(from);
291
+ }
292
+ }
293
+ /**
294
+ * Delete an unfinished upload's partial and sidecar. A finished id is left
295
+ * alone (its sidecar keeps completion idempotent; the saved file is the
296
+ * user's). Returns a refusal reason or null.
297
+ */
298
+ abort(uploadId, sessionId) {
299
+ return this.enqueue(uploadId, async () => {
300
+ const s = await this.readSidecar(uploadId);
301
+ if (!s) {
302
+ await fsp.rm(this.partialPath(uploadId), { force: true });
303
+ return null;
304
+ }
305
+ if (s.sessionId !== sessionId)
306
+ return 'This upload id belongs to a different session.';
307
+ if (s.done)
308
+ return null;
309
+ await fsp.rm(this.partialPath(uploadId), { force: true });
310
+ await fsp.rm(this.sidecarPath(uploadId), { force: true });
311
+ return null;
312
+ });
313
+ }
314
+ /**
315
+ * Remove every staging entry (partial, sidecar, leftover `.tmp`) whose newest
316
+ * mtime is older than `maxAgeMs`, skipping ids with a queued operation.
317
+ * Returns the number of upload ids removed.
318
+ */
319
+ async gc() {
320
+ let names;
321
+ try {
322
+ names = await fsp.readdir(this.dir);
323
+ }
324
+ catch {
325
+ return 0;
326
+ }
327
+ const newest = new Map();
328
+ const files = new Map();
329
+ for (const name of names) {
330
+ const id = name.split('.')[0];
331
+ let mtime;
332
+ try {
333
+ mtime = (await fsp.stat(path.join(this.dir, name))).mtimeMs;
334
+ }
335
+ catch {
336
+ continue;
337
+ }
338
+ newest.set(id, Math.max(newest.get(id) ?? 0, mtime));
339
+ files.set(id, [...(files.get(id) ?? []), name]);
340
+ }
341
+ const cutoff = this.now() - this.maxAgeMs;
342
+ let removed = 0;
343
+ for (const [id, mtime] of newest) {
344
+ if (mtime >= cutoff || this.queues.has(id))
345
+ continue;
346
+ for (const name of files.get(id) ?? []) {
347
+ await fsp.rm(path.join(this.dir, name), { force: true });
348
+ }
349
+ removed++;
350
+ }
351
+ return removed;
352
+ }
353
+ /** Is `p` (already resolved) the staging dir or inside it? Lexical and realpath. */
354
+ contains(p) {
355
+ const dirs = new Set([this.dir]);
356
+ try {
357
+ dirs.add(fs.realpathSync(this.dir));
358
+ }
359
+ catch { }
360
+ const target = path.resolve(p);
361
+ for (const d of dirs) {
362
+ if (target === d || target.startsWith(d.endsWith(path.sep) ? d : d + path.sep))
363
+ return true;
364
+ }
365
+ return false;
366
+ }
367
+ }
368
+ //# sourceMappingURL=upload-staging.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upload-staging.js","sourceRoot":"","sources":["../src/upload-staging.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "wherever-dev",
3
- "version": "0.18.4",
3
+ "version": "0.19.0",
4
4
  "description": "Standalone multi-session server for pi coding agent (wherever.dev)",
5
5
  "homepage": "https://github.com/wighawag/wherever#readme",
6
6
  "repository": {
@@ -25,14 +25,16 @@
25
25
  "public"
26
26
  ],
27
27
  "dependencies": {
28
- "@earendil-works/pi-ai": "0.80.6",
29
- "@earendil-works/pi-coding-agent": "0.80.6",
28
+ "@earendil-works/pi-ai": "1.4.0",
29
+ "@earendil-works/pi-coding-agent": "1.4.0",
30
30
  "memonaut": "^0.1.0",
31
+ "semver": "^7.7.0",
31
32
  "typebox": "^1.1.38",
32
33
  "ws": "^8.18.0"
33
34
  },
34
35
  "devDependencies": {
35
36
  "@types/node": "^22.0.0",
37
+ "@types/semver": "^7.7.0",
36
38
  "@types/ws": "^8.5.13",
37
39
  "tsx": "^4.19.0",
38
40
  "typescript": "^5.7.0",