@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.
- package/README.md +96 -3
- package/dist/ArchiveProvider.d.ts +8 -2
- package/dist/ArchiveProvider.d.ts.map +1 -1
- package/dist/ArchiveProvider.js +73 -1
- package/dist/ArchiveProvider.js.map +1 -1
- package/dist/DriveManager.d.ts +16 -6
- package/dist/DriveManager.d.ts.map +1 -1
- package/dist/DriveManager.js +23 -6
- package/dist/DriveManager.js.map +1 -1
- package/dist/GcsDriver.d.ts +14 -9
- package/dist/GcsDriver.d.ts.map +1 -1
- package/dist/GcsDriver.js +202 -98
- package/dist/GcsDriver.js.map +1 -1
- package/dist/S3Driver.d.ts +11 -7
- package/dist/S3Driver.d.ts.map +1 -1
- package/dist/S3Driver.js +73 -110
- package/dist/S3Driver.js.map +1 -1
- package/dist/StaticMiddleware.d.ts +5 -1
- package/dist/StaticMiddleware.d.ts.map +1 -1
- package/dist/StaticMiddleware.js +114 -13
- package/dist/StaticMiddleware.js.map +1 -1
- package/dist/StorageManager.d.ts +36 -4
- package/dist/StorageManager.d.ts.map +1 -1
- package/dist/StorageManager.js +360 -137
- package/dist/StorageManager.js.map +1 -1
- package/dist/augmentations.d.ts +17 -0
- package/dist/augmentations.d.ts.map +1 -1
- package/dist/errno.d.ts +6 -0
- package/dist/errno.d.ts.map +1 -0
- package/dist/errno.js +11 -0
- package/dist/errno.js.map +1 -0
- package/dist/index.d.ts +2 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/keys.d.ts +34 -0
- package/dist/keys.d.ts.map +1 -0
- package/dist/keys.js +88 -0
- package/dist/keys.js.map +1 -0
- package/dist/local-signature.d.ts +32 -0
- package/dist/local-signature.d.ts.map +1 -0
- package/dist/local-signature.js +58 -0
- package/dist/local-signature.js.map +1 -0
- package/dist/move-to-disk.d.ts +24 -0
- package/dist/move-to-disk.d.ts.map +1 -0
- package/dist/move-to-disk.js +167 -0
- package/dist/move-to-disk.js.map +1 -0
- package/dist/objects.d.ts.map +1 -1
- package/dist/objects.js +5 -2
- package/dist/objects.js.map +1 -1
- package/dist/provider-fetch.d.ts +36 -0
- package/dist/provider-fetch.d.ts.map +1 -0
- package/dist/provider-fetch.js +158 -0
- package/dist/provider-fetch.js.map +1 -0
- package/dist/services/main.d.ts +1 -1
- package/dist/services/main.d.ts.map +1 -1
- package/dist/services/main.js +14 -1
- package/dist/services/main.js.map +1 -1
- package/dist/signed-route.d.ts +18 -6
- package/dist/signed-route.d.ts.map +1 -1
- package/dist/signed-route.js +186 -31
- package/dist/signed-route.js.map +1 -1
- package/dist/streams.d.ts +36 -0
- package/dist/streams.d.ts.map +1 -0
- package/dist/streams.js +108 -0
- package/dist/streams.js.map +1 -0
- package/dist/testing/FakeStorage.d.ts.map +1 -1
- package/dist/testing/FakeStorage.js +2 -1
- package/dist/testing/FakeStorage.js.map +1 -1
- package/package.json +7 -3
- package/src/ArchiveProvider.ts +106 -4
- package/src/DriveManager.ts +38 -8
- package/src/GcsDriver.ts +256 -139
- package/src/S3Driver.ts +87 -130
- package/src/StaticMiddleware.ts +124 -13
- package/src/StorageManager.ts +433 -147
- package/src/augmentations.ts +24 -1
- package/src/errno.ts +10 -0
- package/src/index.ts +2 -0
- package/src/keys.ts +104 -0
- package/src/local-signature.ts +76 -0
- package/src/move-to-disk.ts +234 -0
- package/src/objects.ts +5 -2
- package/src/provider-fetch.ts +171 -0
- package/src/services/main.ts +15 -2
- package/src/signed-route.ts +216 -36
- package/src/streams.ts +118 -0
- 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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"}
|
package/dist/objects.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../src/objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;
|
|
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
|
-
|
|
35
|
-
|
|
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
|
}
|
package/dist/objects.js.map
CHANGED
|
@@ -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;
|
|
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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"}
|
package/dist/services/main.d.ts
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
*
|
|
10
10
|
* Populated by `ArchiveProvider.boot()`.
|
|
11
11
|
*/
|
|
12
|
-
import
|
|
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,
|
|
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"}
|
package/dist/services/main.js
CHANGED
|
@@ -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
|
-
|
|
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;
|
|
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"}
|
package/dist/signed-route.d.ts
CHANGED
|
@@ -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 `
|
|
7
|
-
*
|
|
8
|
-
*
|
|
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
|
-
|
|
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
|
-
/**
|
|
51
|
-
*
|
|
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
|
|
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"}
|