@c9up/archive 0.1.19 → 0.1.21

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 (87) hide show
  1. package/README.md +96 -3
  2. package/dist/ArchiveProvider.d.ts +8 -2
  3. package/dist/ArchiveProvider.d.ts.map +1 -1
  4. package/dist/ArchiveProvider.js +73 -1
  5. package/dist/ArchiveProvider.js.map +1 -1
  6. package/dist/DriveManager.d.ts +16 -6
  7. package/dist/DriveManager.d.ts.map +1 -1
  8. package/dist/DriveManager.js +23 -6
  9. package/dist/DriveManager.js.map +1 -1
  10. package/dist/GcsDriver.d.ts +14 -9
  11. package/dist/GcsDriver.d.ts.map +1 -1
  12. package/dist/GcsDriver.js +202 -98
  13. package/dist/GcsDriver.js.map +1 -1
  14. package/dist/S3Driver.d.ts +11 -7
  15. package/dist/S3Driver.d.ts.map +1 -1
  16. package/dist/S3Driver.js +73 -110
  17. package/dist/S3Driver.js.map +1 -1
  18. package/dist/StaticMiddleware.d.ts +5 -1
  19. package/dist/StaticMiddleware.d.ts.map +1 -1
  20. package/dist/StaticMiddleware.js +114 -13
  21. package/dist/StaticMiddleware.js.map +1 -1
  22. package/dist/StorageManager.d.ts +36 -4
  23. package/dist/StorageManager.d.ts.map +1 -1
  24. package/dist/StorageManager.js +360 -137
  25. package/dist/StorageManager.js.map +1 -1
  26. package/dist/augmentations.d.ts +17 -0
  27. package/dist/augmentations.d.ts.map +1 -1
  28. package/dist/errno.d.ts +6 -0
  29. package/dist/errno.d.ts.map +1 -0
  30. package/dist/errno.js +11 -0
  31. package/dist/errno.js.map +1 -0
  32. package/dist/index.d.ts +2 -1
  33. package/dist/index.d.ts.map +1 -1
  34. package/dist/index.js.map +1 -1
  35. package/dist/keys.d.ts +34 -0
  36. package/dist/keys.d.ts.map +1 -0
  37. package/dist/keys.js +88 -0
  38. package/dist/keys.js.map +1 -0
  39. package/dist/local-signature.d.ts +32 -0
  40. package/dist/local-signature.d.ts.map +1 -0
  41. package/dist/local-signature.js +58 -0
  42. package/dist/local-signature.js.map +1 -0
  43. package/dist/move-to-disk.d.ts +24 -0
  44. package/dist/move-to-disk.d.ts.map +1 -0
  45. package/dist/move-to-disk.js +167 -0
  46. package/dist/move-to-disk.js.map +1 -0
  47. package/dist/objects.d.ts.map +1 -1
  48. package/dist/objects.js +5 -2
  49. package/dist/objects.js.map +1 -1
  50. package/dist/provider-fetch.d.ts +36 -0
  51. package/dist/provider-fetch.d.ts.map +1 -0
  52. package/dist/provider-fetch.js +158 -0
  53. package/dist/provider-fetch.js.map +1 -0
  54. package/dist/services/main.d.ts +1 -1
  55. package/dist/services/main.d.ts.map +1 -1
  56. package/dist/services/main.js +14 -1
  57. package/dist/services/main.js.map +1 -1
  58. package/dist/signed-route.d.ts +18 -6
  59. package/dist/signed-route.d.ts.map +1 -1
  60. package/dist/signed-route.js +186 -31
  61. package/dist/signed-route.js.map +1 -1
  62. package/dist/streams.d.ts +36 -0
  63. package/dist/streams.d.ts.map +1 -0
  64. package/dist/streams.js +108 -0
  65. package/dist/streams.js.map +1 -0
  66. package/dist/testing/FakeStorage.d.ts.map +1 -1
  67. package/dist/testing/FakeStorage.js +2 -1
  68. package/dist/testing/FakeStorage.js.map +1 -1
  69. package/package.json +7 -3
  70. package/src/ArchiveProvider.ts +106 -4
  71. package/src/DriveManager.ts +38 -8
  72. package/src/GcsDriver.ts +256 -139
  73. package/src/S3Driver.ts +87 -130
  74. package/src/StaticMiddleware.ts +124 -13
  75. package/src/StorageManager.ts +433 -147
  76. package/src/augmentations.ts +24 -1
  77. package/src/errno.ts +10 -0
  78. package/src/index.ts +2 -0
  79. package/src/keys.ts +104 -0
  80. package/src/local-signature.ts +76 -0
  81. package/src/move-to-disk.ts +234 -0
  82. package/src/objects.ts +5 -2
  83. package/src/provider-fetch.ts +171 -0
  84. package/src/services/main.ts +15 -2
  85. package/src/signed-route.ts +216 -36
  86. package/src/streams.ts +118 -0
  87. package/src/testing/FakeStorage.ts +2 -3
@@ -0,0 +1 @@
1
+ {"version":3,"file":"move-to-disk.js","sourceRoot":"","sources":["../src/move-to-disk.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../src/objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACX,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,MAAM,qBAAqB,CAAC;AAE7B;;;GAGG;AACH,qBAAa,cAAc;IAKP,MAAM,EAAE,MAAM;IAJjC,MAAM,EAAE,KAAK,CAAS;IACtB,WAAW,EAAE,IAAI,CAAQ;IACzB,IAAI,EAAE,MAAM,CAAC;gBAEM,MAAM,EAAE,MAAM;CAGjC;AAED;;;;;GAKG;AACH,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,SAAS;;IACrB,MAAM,EAAE,IAAI,CAAQ;IACpB,WAAW,EAAE,KAAK,CAAS;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;gBAID,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAOnE,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAI1B,qEAAqE;IACrE,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI7B,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAI/B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;IAI3C;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;IAKhC,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAIpC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAIzB,kFAAkF;IAClF,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC;IAIrC,mEAAmE;IACnE,kBAAkB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIxE;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;IAYzC,YAAY,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAGlE"}
1
+ {"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../src/objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACX,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,MAAM,qBAAqB,CAAC;AAE7B;;;GAGG;AACH,qBAAa,cAAc;IAKP,MAAM,EAAE,MAAM;IAJjC,MAAM,EAAE,KAAK,CAAS;IACtB,WAAW,EAAE,IAAI,CAAQ;IACzB,IAAI,EAAE,MAAM,CAAC;gBAEM,MAAM,EAAE,MAAM;CAGjC;AAED;;;;;GAKG;AACH,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,SAAS;;IACrB,MAAM,EAAE,IAAI,CAAQ;IACpB,WAAW,EAAE,KAAK,CAAS;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;gBAID,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,QAAQ;IASnE,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAI1B,qEAAqE;IACrE,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI7B,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAI/B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;IAI3C;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;IAKhC,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAIpC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAIzB,kFAAkF;IAClF,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC;IAIrC,mEAAmE;IACnE,kBAAkB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIxE;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;IAYzC,YAAY,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAGlE"}
package/dist/objects.js CHANGED
@@ -9,6 +9,7 @@
9
9
  * listings.
10
10
  */
11
11
  import { basename } from "node:path";
12
+ import { normalizeKey } from "./keys.js";
12
13
  /**
13
14
  * Representation of a directory in a non-recursive listing. Mirrors
14
15
  * flydrive's `DriveDirectory`.
@@ -31,8 +32,10 @@ export class DriveFile {
31
32
  #driver;
32
33
  #metadata;
33
34
  constructor(key, driver, metadata) {
34
- this.key = key;
35
- this.name = basename(key);
35
+ // Normalised like every key a disk accepts, so a handle built from a
36
+ // stored snapshot or an untrusted name cannot address outside the disk.
37
+ this.key = normalizeKey(key);
38
+ this.name = basename(this.key);
36
39
  this.#driver = driver;
37
40
  this.#metadata = metadata;
38
41
  }
@@ -1 +1 @@
1
- {"version":3,"file":"objects.js","sourceRoot":"","sources":["../src/objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAQrC;;;GAGG;AACH,MAAM,OAAO,cAAc;IAKP;IAJnB,MAAM,GAAU,KAAK,CAAC;IACtB,WAAW,GAAS,IAAI,CAAC;IACzB,IAAI,CAAS;IAEb,YAAmB,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;QAChC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CACD;AAmBD,MAAM,OAAO,SAAS;IACrB,MAAM,GAAS,IAAI,CAAC;IACpB,WAAW,GAAU,KAAK,CAAC;IAC3B,GAAG,CAAS;IACZ,IAAI,CAAS;IACb,OAAO,CAAgB;IACvB,SAAS,CAAY;IAErB,YAAY,GAAW,EAAE,MAAqB,EAAE,QAAmB;QAClE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,MAAM;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,qEAAqE;IACrE,GAAG;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,QAAQ;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,SAAS;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,WAAW;QACV,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED,aAAa;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,kFAAkF;IAClF,cAAc;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,mEAAmE;IACnE,kBAAkB,CAAC,OAA0B;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU;QACf,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,OAAO;YACN,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE;YACjD,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,WAAW,EAAE,QAAQ,CAAC,WAAW;SACjC,CAAC;IACH,CAAC;IAED,YAAY,CAAC,OAA0B;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;CACD"}
1
+ {"version":3,"file":"objects.js","sourceRoot":"","sources":["../src/objects.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ /**
2
+ * One request to a storage provider, bounded by an IDLE timeout.
3
+ *
4
+ * The bound has to catch a provider that stops answering, and nothing else.
5
+ * A wall-clock signal on the whole exchange (`AbortSignal.timeout` handed to
6
+ * `fetch`) also covers the body, in both directions: a 2 GB download piped to
7
+ * a slow client, or a 5 MiB part sent over a slow uplink, failed once it had
8
+ * been running for the configured time, however steadily it was progressing.
9
+ *
10
+ * So the timer measures only the time spent WAITING ON THE PROVIDER:
11
+ *
12
+ * - while the request body goes out, it restarts every time the transport
13
+ * asks for the next slice (the provider is accepting bytes);
14
+ * - while the response headers are awaited, it runs;
15
+ * - while the response body is read, it runs only between asking the
16
+ * provider for a chunk and receiving it. A consumer that reads slowly is
17
+ * not the provider stalling, so the clock is stopped while the consumer
18
+ * holds a chunk.
19
+ */
20
+ /**
21
+ * `fetch` with an idle timeout of `ms` (0 or less disables it).
22
+ *
23
+ * The returned response's body, when it has one, is a stream that keeps the
24
+ * same idle bound while it is read; a stall surfaces as
25
+ * `E_ARCHIVE_REQUEST_TIMEOUT` from the read, not as a hang.
26
+ */
27
+ export declare function fetchWithIdleTimeout(url: string, init: RequestInit, ms: number): Promise<Response>;
28
+ /**
29
+ * Bytes as a request body, without copying when they can be shared.
30
+ *
31
+ * A Node `Buffer` may sit on a `SharedArrayBuffer`, which a request body
32
+ * cannot be: the view is reused as is over a plain `ArrayBuffer`, and copied
33
+ * only otherwise.
34
+ */
35
+ export declare function requestBody(bytes: Uint8Array): Uint8Array<ArrayBuffer>;
36
+ //# sourceMappingURL=provider-fetch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider-fetch.d.ts","sourceRoot":"","sources":["../src/provider-fetch.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;GAkBG;AAoBH;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACzC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,MAAM,GACR,OAAO,CAAC,QAAQ,CAAC,CAuGnB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAAC,WAAW,CAAC,CAKtE"}
@@ -0,0 +1,158 @@
1
+ /// <reference lib="dom" />
2
+ // Uses the WHATWG fetch/streams globals, which live in the DOM lib even on
3
+ // Node. Referenced here so a consumer whose `lib` omits DOM still typechecks
4
+ // our sources.
5
+ /**
6
+ * One request to a storage provider, bounded by an IDLE timeout.
7
+ *
8
+ * The bound has to catch a provider that stops answering, and nothing else.
9
+ * A wall-clock signal on the whole exchange (`AbortSignal.timeout` handed to
10
+ * `fetch`) also covers the body, in both directions: a 2 GB download piped to
11
+ * a slow client, or a 5 MiB part sent over a slow uplink, failed once it had
12
+ * been running for the configured time, however steadily it was progressing.
13
+ *
14
+ * So the timer measures only the time spent WAITING ON THE PROVIDER:
15
+ *
16
+ * - while the request body goes out, it restarts every time the transport
17
+ * asks for the next slice (the provider is accepting bytes);
18
+ * - while the response headers are awaited, it runs;
19
+ * - while the response body is read, it runs only between asking the
20
+ * provider for a chunk and receiving it. A consumer that reads slowly is
21
+ * not the provider stalling, so the clock is stopped while the consumer
22
+ * holds a chunk.
23
+ */
24
+ import { ArchiveError } from "./errors.js";
25
+ /** Size of the slices an outgoing body is handed to the transport in. */
26
+ const UPLOAD_SLICE = 64 * 1024;
27
+ /** Statuses a `Response` may not be constructed with a body for. */
28
+ const NULL_BODY_STATUSES = new Set([101, 103, 204, 205, 304]);
29
+ function timeoutError(ms) {
30
+ return new ArchiveError("E_ARCHIVE_REQUEST_TIMEOUT", `The storage provider did not answer within ${ms}ms.`, {
31
+ hint: "The bound is an idle timeout: raise `requestTimeoutMs` for a slow link, or check connectivity to the bucket.",
32
+ });
33
+ }
34
+ /**
35
+ * `fetch` with an idle timeout of `ms` (0 or less disables it).
36
+ *
37
+ * The returned response's body, when it has one, is a stream that keeps the
38
+ * same idle bound while it is read; a stall surfaces as
39
+ * `E_ARCHIVE_REQUEST_TIMEOUT` from the read, not as a hang.
40
+ */
41
+ export async function fetchWithIdleTimeout(url, init, ms) {
42
+ if (ms <= 0)
43
+ return fetch(url, init);
44
+ const controller = new AbortController();
45
+ let timer;
46
+ let timedOut = false;
47
+ const stop = () => {
48
+ if (timer !== undefined)
49
+ clearTimeout(timer);
50
+ timer = undefined;
51
+ };
52
+ const arm = () => {
53
+ stop();
54
+ timer = setTimeout(() => {
55
+ timedOut = true;
56
+ controller.abort(timeoutError(ms));
57
+ }, ms);
58
+ };
59
+ // `duplex` is what Node's fetch requires for a stream body; the DOM lib's
60
+ // RequestInit predates it.
61
+ const request = {
62
+ ...init,
63
+ signal: controller.signal,
64
+ };
65
+ const body = init.body;
66
+ if (body instanceof Uint8Array && body.byteLength > UPLOAD_SLICE) {
67
+ // Handed over slice by slice, so each request for the next slice is
68
+ // evidence the provider is still taking bytes. The declared length
69
+ // keeps the request a plain fixed-length one: providers refuse a
70
+ // chunked PUT, and a stream body would otherwise be sent chunked.
71
+ const headers = new Headers(init.headers);
72
+ headers.set("content-length", String(body.byteLength));
73
+ let offset = 0;
74
+ request.headers = headers;
75
+ request.body = new ReadableStream({
76
+ pull(stream) {
77
+ arm();
78
+ const end = Math.min(offset + UPLOAD_SLICE, body.byteLength);
79
+ stream.enqueue(body.subarray(offset, end));
80
+ offset = end;
81
+ if (offset >= body.byteLength)
82
+ stream.close();
83
+ },
84
+ }, { highWaterMark: 0 });
85
+ request.duplex = "half";
86
+ }
87
+ arm();
88
+ let response;
89
+ try {
90
+ response = await fetch(url, request);
91
+ }
92
+ catch (err) {
93
+ stop();
94
+ if (timedOut)
95
+ throw timeoutError(ms);
96
+ throw err;
97
+ }
98
+ stop();
99
+ const source = response.body;
100
+ // A null-body status cannot be rebuilt with a body, and has none to read.
101
+ if (source === null || NULL_BODY_STATUSES.has(response.status)) {
102
+ return response;
103
+ }
104
+ // Locked on the first read only: a caller that never reads the body (a
105
+ // DELETE, a HEAD-like check) leaves it exactly as fetch returned it.
106
+ let locked;
107
+ const reader = () => {
108
+ locked ??= source.getReader();
109
+ return locked;
110
+ };
111
+ const guarded = new ReadableStream({
112
+ async pull(stream) {
113
+ const upstream = reader();
114
+ arm();
115
+ let chunk;
116
+ try {
117
+ chunk = await upstream.read();
118
+ }
119
+ catch (err) {
120
+ stop();
121
+ if (timedOut)
122
+ throw timeoutError(ms);
123
+ throw err;
124
+ }
125
+ stop();
126
+ if (chunk.done)
127
+ stream.close();
128
+ else
129
+ stream.enqueue(chunk.value);
130
+ },
131
+ cancel(reason) {
132
+ stop();
133
+ return reader().cancel(reason);
134
+ },
135
+ },
136
+ // Pull only on demand: the clock must not run on read-ahead the
137
+ // consumer has not asked for.
138
+ { highWaterMark: 0 });
139
+ return new Response(guarded, {
140
+ status: response.status,
141
+ statusText: response.statusText,
142
+ headers: response.headers,
143
+ });
144
+ }
145
+ /**
146
+ * Bytes as a request body, without copying when they can be shared.
147
+ *
148
+ * A Node `Buffer` may sit on a `SharedArrayBuffer`, which a request body
149
+ * cannot be: the view is reused as is over a plain `ArrayBuffer`, and copied
150
+ * only otherwise.
151
+ */
152
+ export function requestBody(bytes) {
153
+ const { buffer } = bytes;
154
+ return buffer instanceof ArrayBuffer
155
+ ? new Uint8Array(buffer, bytes.byteOffset, bytes.byteLength)
156
+ : new Uint8Array(bytes);
157
+ }
158
+ //# sourceMappingURL=provider-fetch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"provider-fetch.js","sourceRoot":"","sources":["../src/provider-fetch.ts"],"names":[],"mappings":"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"}
@@ -9,7 +9,7 @@
9
9
  *
10
10
  * Populated by `ArchiveProvider.boot()`.
11
11
  */
12
- import type { StorageManager } from "../StorageManager.js";
12
+ import { StorageManager } from "../StorageManager.js";
13
13
  /** @internal Bind the singleton (called by ArchiveProvider). */
14
14
  export declare function setStorage(value: StorageManager): void;
15
15
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAGtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,cAAc,GAAG,IAAI,CAGtE;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,IAAI,cAAc,GAAG,SAAS,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED,QAAA,MAAM,OAAO,EAAE,cAyBb,CAAC;AAEH,eAAe,OAAO,CAAC"}
1
+ {"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAKtD,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAGtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,cAAc,GAAG,IAAI,CAGtE;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,IAAI,cAAc,GAAG,SAAS,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAeD,QAAA,MAAM,OAAO,EAAE,cAyBb,CAAC;AAEH,eAAe,OAAO,CAAC"}
@@ -9,6 +9,7 @@
9
9
  *
10
10
  * Populated by `ArchiveProvider.boot()`.
11
11
  */
12
+ import { StorageManager } from "../StorageManager.js";
12
13
  let instance;
13
14
  let resolve;
14
15
  /** @internal Bind the singleton (called by ArchiveProvider). */
@@ -46,7 +47,19 @@ export function getStorage() {
46
47
  export function clearStorage() {
47
48
  instance = undefined;
48
49
  }
49
- const storage = new Proxy({}, {
50
+ /**
51
+ * The proxy's target: an object of the right type that is never used —
52
+ * every read goes to the bound instance through the `get` trap. Built from
53
+ * the prototype and proven by `instanceof`, so no cast stands in for it.
54
+ */
55
+ function inertTarget() {
56
+ const target = Object.create(StorageManager.prototype);
57
+ if (!(target instanceof StorageManager)) {
58
+ throw new Error("[archive] could not build the storage accessor");
59
+ }
60
+ return target;
61
+ }
62
+ const storage = new Proxy(inertTarget(), {
50
63
  get(_target, prop) {
51
64
  // A module loader inspects what it imports before anyone uses it: it reads
52
65
  // `then` to decide whether the namespace is thenable, and various symbols
@@ -1 +1 @@
1
- {"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,IAAI,QAAoC,CAAC;AACzC,IAAI,OAA2C,CAAC;AAEhD,gEAAgE;AAChE,MAAM,UAAU,UAAU,CAAC,KAAqB;IAC/C,QAAQ,GAAG,KAAK,CAAC;IACjB,OAAO,GAAG,SAAS,CAAC;AACrB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA6B;IAC/D,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO;IACnC,OAAO,GAAG,OAAO,CAAC;AACnB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,UAAU;IACzB,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY;IAC3B,QAAQ,GAAG,SAAS,CAAC;AACtB,CAAC;AAED,MAAM,OAAO,GAAmB,IAAI,KAAK,CAAC,EAAoB,EAAE;IAC/D,GAAG,CAAC,OAAO,EAAE,IAAI;QAChB,2EAA2E;QAC3E,0EAA0E;QAC1E,8DAA8D;QAC9D,0EAA0E;QAC1E,0EAA0E;QAC1E,wEAAwE;QACxE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACjD,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACrD,QAAQ,GAAG,OAAO,EAAE,CAAC;YACrB,OAAO,GAAG,SAAS,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACd,iFAAiF;gBAChF,6EAA6E;gBAC7E,4CAA4C,CAC7C,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACnE,CAAC;CACD,CAAC,CAAC;AAEH,eAAe,OAAO,CAAC"}
1
+ {"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/services/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,IAAI,QAAoC,CAAC;AACzC,IAAI,OAA2C,CAAC;AAEhD,gEAAgE;AAChE,MAAM,UAAU,UAAU,CAAC,KAAqB;IAC/C,QAAQ,GAAG,KAAK,CAAC;IACjB,OAAO,GAAG,SAAS,CAAC;AACrB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA6B;IAC/D,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO;IACnC,OAAO,GAAG,OAAO,CAAC;AACnB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,UAAU;IACzB,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY;IAC3B,QAAQ,GAAG,SAAS,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW;IACnB,MAAM,MAAM,GAAY,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAChE,IAAI,CAAC,CAAC,MAAM,YAAY,cAAc,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,OAAO,GAAmB,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE;IACxD,GAAG,CAAC,OAAO,EAAE,IAAI;QAChB,2EAA2E;QAC3E,0EAA0E;QAC1E,8DAA8D;QAC9D,0EAA0E;QAC1E,0EAA0E;QAC1E,wEAAwE;QACxE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACjD,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACrD,QAAQ,GAAG,OAAO,EAAE,CAAC;YACrB,OAAO,GAAG,SAAS,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACd,iFAAiF;gBAChF,6EAA6E;gBAC7E,4CAA4C,CAC7C,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACnE,CAAC;CACD,CAAC,CAAC;AAEH,eAAe,OAAO,CAAC"}
@@ -3,9 +3,12 @@
3
3
  *
4
4
  * Verifies the HMAC produced by {@link LocalDriver.getSignedUrl} and,
5
5
  * on success, serves the file from the driver. Tampered signatures →
6
- * 403 `E_INVALID_SIGNATURE`. Expired `exp` → 403 `E_EXPIRED_SIGNATURE`.
7
- * Missing query params → falls through to `next()` so unsigned routes
8
- * can coexist on the same prefix.
6
+ * 403 `E_ARCHIVE_INVALID_SIGNATURE`. Expired `exp` → 403
7
+ * `E_ARCHIVE_EXPIRED_SIGNATURE`. A valid signature for a file that is not
8
+ * stored → 404 `E_ARCHIVE_NOT_FOUND`.
9
+ * No signature at all → the file's visibility decides: a public file is
10
+ * served, a private one refused with 403 `E_ARCHIVE_ACCESS_DENIED`, and a
11
+ * name that is not stored falls through to `next()`.
9
12
  *
10
13
  * @implements Story 43.2 AC 5
11
14
  */
@@ -20,7 +23,11 @@ import type { LocalDriver, StorageManager } from "./StorageManager.js";
20
23
  export interface SignedRouteResponse {
21
24
  status(code: number): SignedRouteResponse;
22
25
  header(name: string, value: string): SignedRouteResponse;
23
- sendBuffer(buf: Buffer): void;
26
+ /**
27
+ * Send a readable as the body. The framework's response streams it to
28
+ * the client; the file is never held in memory whole.
29
+ */
30
+ stream(body: NodeJS.ReadableStream): Promise<void> | void;
24
31
  json(data: unknown): void;
25
32
  }
26
33
  export interface SignedRouteHttpContext {
@@ -47,8 +54,13 @@ export interface SignedRouteOptions {
47
54
  * recompute the expected signature.
48
55
  */
49
56
  driver: LocalDriver;
50
- /** URL prefix for signed file serving (default: `/storage`). Must
51
- * match the prefix used by `LocalDriver.url()`. */
57
+ /**
58
+ * URL prefix for file serving. Defaults to — and must equal — the
59
+ * driver's `routeBasePath` (`driver.getRouteBasePath()`), which is what
60
+ * its URLs are built on. Configure the path on the driver; a different
61
+ * value here is refused at construction (`E_ARCHIVE_PREFIX_MISMATCH`)
62
+ * rather than producing a route that can never match a signed URL.
63
+ */
52
64
  prefix?: string;
53
65
  }
54
66
  type SignedRouteMiddleware = (ctx: SignedRouteHttpContext, next: () => Promise<void>) => Promise<void>;
@@ -1 +1 @@
1
- {"version":3,"file":"signed-route.d.ts","sourceRoot":"","sources":["../src/signed-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAC1C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACzD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE;QACR,MAAM,IAAI,MAAM,CAAC;QACjB,IAAI,IAAI,MAAM,CAAC;QACf;;;;;;WAMG;QACH,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;KACzC,CAAC;IACF,QAAQ,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,cAAc,CAAC;IACxB;;;;OAIG;IACH,MAAM,EAAE,WAAW,CAAC;IACpB;wDACoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,qBAAqB,GAAG,CAC5B,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACrB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;;GAGG;AACH,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,kBAAkB,GACzB,qBAAqB,CAoHvB"}
1
+ {"version":3,"file":"signed-route.d.ts","sourceRoot":"","sources":["../src/signed-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,OAAO,KAAK,EACX,WAAW,EAEX,cAAc,EACd,MAAM,qBAAqB,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAC1C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACzD;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1D,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE;QACR,MAAM,IAAI,MAAM,CAAC;QACjB,IAAI,IAAI,MAAM,CAAC;QACf;;;;;;WAMG;QACH,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;KACzC,CAAC;IACF,QAAQ,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,cAAc,CAAC;IACxB;;;;OAIG;IACH,MAAM,EAAE,WAAW,CAAC;IACpB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,qBAAqB,GAAG,CAC5B,GAAG,EAAE,sBAAsB,EAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACrB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;;GAGG;AACH,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,kBAAkB,GACzB,qBAAqB,CA8OvB"}