@geekmidas/constructs 10.0.0-alpha.166 → 10.0.0-alpha.167
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/dist/{Cron-D_sfaMGz.d.cts → Cron-Ca_qHQu2.d.cts} +2 -2
- package/dist/{Cron-D6Y7BBt3.d.mts.map → Cron-Ca_qHQu2.d.cts.map} +1 -1
- package/dist/{Cron-D6Y7BBt3.d.mts → Cron-DPJiR7Lt.d.mts} +2 -2
- package/dist/{Cron-D_sfaMGz.d.cts.map → Cron-DPJiR7Lt.d.mts.map} +1 -1
- package/dist/{CronBuilder-4BZhkChG.d.mts → CronBuilder-BC4za5Bx.d.mts} +4 -4
- package/dist/{CronBuilder-4BZhkChG.d.mts.map → CronBuilder-BC4za5Bx.d.mts.map} +1 -1
- package/dist/{CronBuilder-C91MVLSr.d.cts → CronBuilder-C3RrAF1-.d.cts} +4 -4
- package/dist/{CronBuilder-C91MVLSr.d.cts.map → CronBuilder-C3RrAF1-.d.cts.map} +1 -1
- package/dist/{Endpoint-YYwjqtS1.d.cts → Endpoint-BlIZLsBQ.d.cts} +5 -5
- package/dist/{Endpoint-BUoDD96P.d.mts.map → Endpoint-BlIZLsBQ.d.cts.map} +1 -1
- package/dist/{Endpoint-BUoDD96P.d.mts → Endpoint-DC7mreOr.d.mts} +5 -5
- package/dist/{Endpoint-YYwjqtS1.d.cts.map → Endpoint-DC7mreOr.d.mts.map} +1 -1
- package/dist/{EndpointFactory-BbVOeryo.d.mts → EndpointFactory-DCmnCmkX.d.mts} +5 -5
- package/dist/{EndpointFactory-BbVOeryo.d.mts.map → EndpointFactory-DCmnCmkX.d.mts.map} +1 -1
- package/dist/{EndpointFactory-Hh1r6J_C.d.cts → EndpointFactory-cVTb8kCc.d.cts} +5 -5
- package/dist/{EndpointFactory-Hh1r6J_C.d.cts.map → EndpointFactory-cVTb8kCc.d.cts.map} +1 -1
- package/dist/{ObjectSubscriberBuilder-DfzXQEKW.d.mts → ObjectSubscriberBuilder-AwGKoUKy.d.mts} +2 -2
- package/dist/{ObjectSubscriberBuilder-DfzXQEKW.d.mts.map → ObjectSubscriberBuilder-AwGKoUKy.d.mts.map} +1 -1
- package/dist/{ObjectSubscriberBuilder-LWkey_oq.d.cts → ObjectSubscriberBuilder-CB6imsX4.d.cts} +2 -2
- package/dist/{ObjectSubscriberBuilder-LWkey_oq.d.cts.map → ObjectSubscriberBuilder-CB6imsX4.d.cts.map} +1 -1
- package/dist/{ProcessorBuilder-_jdZlbfW.d.cts → ProcessorBuilder-CeEZ2vCx.d.cts} +2 -2
- package/dist/{ProcessorBuilder-D4oYvZeG.d.mts.map → ProcessorBuilder-CeEZ2vCx.d.cts.map} +1 -1
- package/dist/{ProcessorBuilder-D4oYvZeG.d.mts → ProcessorBuilder-CwIlm75W.d.mts} +2 -2
- package/dist/{ProcessorBuilder-_jdZlbfW.d.cts.map → ProcessorBuilder-CwIlm75W.d.mts.map} +1 -1
- package/dist/{QueueBuilder-CVS_qPuo.d.mts → QueueBuilder-CUERv8jt.d.mts} +2 -2
- package/dist/{QueueBuilder-CVS_qPuo.d.mts.map → QueueBuilder-CUERv8jt.d.mts.map} +1 -1
- package/dist/{QueueBuilder-SQli59An.d.cts → QueueBuilder-CmB1vOgn.d.cts} +2 -2
- package/dist/{QueueBuilder-SQli59An.d.cts.map → QueueBuilder-CmB1vOgn.d.cts.map} +1 -1
- package/dist/adaptors/aws.d.cts +2 -2
- package/dist/adaptors/aws.d.mts +2 -2
- package/dist/adaptors/awsWebsocket.d.cts +1 -1
- package/dist/adaptors/awsWebsocket.d.mts +1 -1
- package/dist/adaptors/hono.d.cts +1 -1
- package/dist/adaptors/hono.d.mts +1 -1
- package/dist/adaptors/testing.cjs +1 -1
- package/dist/adaptors/testing.cjs.map +1 -1
- package/dist/adaptors/testing.d.cts +5 -5
- package/dist/adaptors/testing.d.cts.map +1 -1
- package/dist/adaptors/testing.d.mts +5 -5
- package/dist/adaptors/testing.d.mts.map +1 -1
- package/dist/adaptors/testing.mjs +1 -1
- package/dist/adaptors/testing.mjs.map +1 -1
- package/dist/{auth-DnB9H9KL.d.mts → auth-1yI2wR-4.d.cts} +6 -6
- package/dist/{auth-BqWz2JxC.d.cts.map → auth-1yI2wR-4.d.cts.map} +1 -1
- package/dist/{auth-BqWz2JxC.d.cts → auth-D4NMXgLt.d.mts} +6 -6
- package/dist/{auth-DnB9H9KL.d.mts.map → auth-D4NMXgLt.d.mts.map} +1 -1
- package/dist/auth.d.cts +1 -1
- package/dist/auth.d.mts +1 -1
- package/dist/{cache-CCHcO9Oo.d.mts → cache-0VoeOTF9.d.mts} +2 -2
- package/dist/{cache-CCHcO9Oo.d.mts.map → cache-0VoeOTF9.d.mts.map} +1 -1
- package/dist/{cache-CQjMNPrC.d.cts → cache-CW-sArzS.d.cts} +2 -2
- package/dist/{cache-CQjMNPrC.d.cts.map → cache-CW-sArzS.d.cts.map} +1 -1
- package/dist/cache.d.cts +1 -1
- package/dist/cache.d.mts +1 -1
- package/dist/{construct-interface-CSA9VeWM.d.mts → construct-interface-DhbaONW2.d.cts} +20 -4
- package/dist/construct-interface-DhbaONW2.d.cts.map +1 -0
- package/dist/{construct-interface-DugP0E5q.d.cts → construct-interface-DxfkFxkl.d.mts} +20 -4
- package/dist/construct-interface-DxfkFxkl.d.mts.map +1 -0
- package/dist/construct-interface.cjs +9 -0
- package/dist/construct-interface.cjs.map +1 -1
- package/dist/construct-interface.d.cts +2 -2
- package/dist/construct-interface.d.mts +2 -2
- package/dist/construct-interface.mjs +9 -1
- package/dist/construct-interface.mjs.map +1 -1
- package/dist/credential.d.cts +1 -1
- package/dist/credential.d.mts +1 -1
- package/dist/crons/index.d.cts +2 -2
- package/dist/crons/index.d.mts +2 -2
- package/dist/database/kysely.d.cts +1 -1
- package/dist/database/kysely.d.mts +1 -1
- package/dist/email.d.cts +1 -1
- package/dist/email.d.mts +1 -1
- package/dist/encryption.d.cts +1 -1
- package/dist/encryption.d.mts +1 -1
- package/dist/endpoints/index.d.cts +2 -2
- package/dist/endpoints/index.d.mts +2 -2
- package/dist/external-api.d.cts +1 -1
- package/dist/external-api.d.mts +1 -1
- package/dist/{fake-BqhP8RRQ.d.mts → fake-BvOXkZmj.d.mts} +2 -2
- package/dist/{fake-BqhP8RRQ.d.mts.map → fake-BvOXkZmj.d.mts.map} +1 -1
- package/dist/{fake-DqieDYYA.d.cts → fake-Djx8E0o1.d.cts} +2 -2
- package/dist/{fake-DqieDYYA.d.cts.map → fake-Djx8E0o1.d.cts.map} +1 -1
- package/dist/file-server.cjs +79 -20
- package/dist/file-server.cjs.map +1 -1
- package/dist/file-server.d.cts +35 -17
- package/dist/file-server.d.cts.map +1 -1
- package/dist/file-server.d.mts +35 -17
- package/dist/file-server.d.mts.map +1 -1
- package/dist/file-server.mjs +80 -22
- package/dist/file-server.mjs.map +1 -1
- package/dist/functions/index.d.cts +1 -1
- package/dist/functions/index.d.mts +1 -1
- package/dist/{inbox-CR3L1fOI.d.cts → inbox-BjvMs7EJ.d.cts} +2 -2
- package/dist/{inbox-CR3L1fOI.d.cts.map → inbox-BjvMs7EJ.d.cts.map} +1 -1
- package/dist/{inbox-YOdxlyfj.d.mts → inbox-C8bOR9UL.d.mts} +2 -2
- package/dist/{inbox-YOdxlyfj.d.mts.map → inbox-C8bOR9UL.d.mts.map} +1 -1
- package/dist/inbox.d.cts +1 -1
- package/dist/inbox.d.mts +1 -1
- package/dist/{index-DPTHa6Ud.d.cts → index-DaK-C7N3.d.cts} +2 -2
- package/dist/{index-BoQ3-M-K.d.mts.map → index-DaK-C7N3.d.cts.map} +1 -1
- package/dist/{index-BoQ3-M-K.d.mts → index-vCS4HBEG.d.mts} +2 -2
- package/dist/{index-DPTHa6Ud.d.cts.map → index-vCS4HBEG.d.mts.map} +1 -1
- package/dist/{kysely-CebjCWTl.d.cts → kysely-2HqIQ2fC.d.cts} +3 -3
- package/dist/{kysely-CebjCWTl.d.cts.map → kysely-2HqIQ2fC.d.cts.map} +1 -1
- package/dist/{kysely-De5rAC-E.d.mts → kysely-BGvpd_ZH.d.mts} +3 -3
- package/dist/{kysely-De5rAC-E.d.mts.map → kysely-BGvpd_ZH.d.mts.map} +1 -1
- package/dist/mobile-app.cjs +5 -1
- package/dist/mobile-app.cjs.map +1 -1
- package/dist/mobile-app.d.cts +5 -1
- package/dist/mobile-app.d.cts.map +1 -1
- package/dist/mobile-app.d.mts +5 -1
- package/dist/mobile-app.d.mts.map +1 -1
- package/dist/mobile-app.mjs +6 -2
- package/dist/mobile-app.mjs.map +1 -1
- package/dist/object-storage.cjs +6 -6
- package/dist/object-storage.cjs.map +1 -1
- package/dist/object-storage.d.cts +3 -3
- package/dist/object-storage.d.cts.map +1 -1
- package/dist/object-storage.d.mts +3 -3
- package/dist/object-storage.d.mts.map +1 -1
- package/dist/object-storage.mjs +6 -6
- package/dist/object-storage.mjs.map +1 -1
- package/dist/processors/index.d.cts +1 -1
- package/dist/processors/index.d.mts +1 -1
- package/dist/queue/index.d.cts +1 -1
- package/dist/queue/index.d.mts +1 -1
- package/dist/random-password.d.cts +1 -1
- package/dist/random-password.d.mts +1 -1
- package/dist/rest-api.d.cts +4 -4
- package/dist/rest-api.d.mts +4 -4
- package/dist/site.cjs +6 -1
- package/dist/site.cjs.map +1 -1
- package/dist/site.d.cts +7 -2
- package/dist/site.d.cts.map +1 -1
- package/dist/site.d.mts +7 -2
- package/dist/site.d.mts.map +1 -1
- package/dist/site.mjs +7 -2
- package/dist/site.mjs.map +1 -1
- package/dist/subscribers/index.d.cts +1 -1
- package/dist/subscribers/index.d.mts +1 -1
- package/dist/{telemetry-CObow3Dn.d.mts → telemetry-BirKau0X.d.mts} +2 -2
- package/dist/{telemetry-C1oqncFY.d.cts.map → telemetry-BirKau0X.d.mts.map} +1 -1
- package/dist/{telemetry-C1oqncFY.d.cts → telemetry-DjJgtQ_N.d.cts} +2 -2
- package/dist/{telemetry-CObow3Dn.d.mts.map → telemetry-DjJgtQ_N.d.cts.map} +1 -1
- package/dist/telemetry.d.cts +1 -1
- package/dist/telemetry.d.mts +1 -1
- package/dist/{websocket-api-DkF8Hva-.d.cts → websocket-api-B1Wl3tg4.d.cts} +3 -3
- package/dist/{websocket-api-CPEzJyDt.d.mts.map → websocket-api-B1Wl3tg4.d.cts.map} +1 -1
- package/dist/{websocket-api-CPEzJyDt.d.mts → websocket-api-CvnPDSZB.d.mts} +3 -3
- package/dist/{websocket-api-DkF8Hva-.d.cts.map → websocket-api-CvnPDSZB.d.mts.map} +1 -1
- package/dist/websocket-api.d.cts +1 -1
- package/dist/websocket-api.d.mts +1 -1
- package/dist/worker.d.cts +8 -8
- package/dist/worker.d.mts +8 -8
- package/package.json +31 -31
- package/dist/construct-interface-CSA9VeWM.d.mts.map +0 -1
- package/dist/construct-interface-DugP0E5q.d.cts.map +0 -1
package/dist/file-server.cjs
CHANGED
|
@@ -47,6 +47,49 @@ var BucketOptionOnOrigin = class extends Error {
|
|
|
47
47
|
this.name = "BucketOptionOnOrigin";
|
|
48
48
|
}
|
|
49
49
|
};
|
|
50
|
+
/**
|
|
51
|
+
* A bucket method called on a file server's client that was handed only its
|
|
52
|
+
* public address — a frontend's plain edge.
|
|
53
|
+
*/
|
|
54
|
+
var FileServerReadOnly = class extends Error {
|
|
55
|
+
id;
|
|
56
|
+
method;
|
|
57
|
+
key;
|
|
58
|
+
constructor(id, method, key) {
|
|
59
|
+
super(`'${id}' was reached through its public address only, so it serves and cannot ${method}(): ${key} is not in this process's environment. A site or app whose server half writes or presigns depends on '${id}'.server instead — .dependsOn([${id.charAt(0).toLowerCase()}${id.slice(1)}.server]).`);
|
|
60
|
+
this.id = id;
|
|
61
|
+
this.method = method;
|
|
62
|
+
this.key = key;
|
|
63
|
+
this.name = "FileServerReadOnly";
|
|
64
|
+
}
|
|
65
|
+
};
|
|
66
|
+
/** Names asked of any object, which a read-only client must not answer. */
|
|
67
|
+
const INTROSPECTED = /* @__PURE__ */ new Set([
|
|
68
|
+
"then",
|
|
69
|
+
"toJSON",
|
|
70
|
+
"constructor",
|
|
71
|
+
"asymmetricMatch",
|
|
72
|
+
"$$typeof",
|
|
73
|
+
"nodeType",
|
|
74
|
+
"inspect"
|
|
75
|
+
]);
|
|
76
|
+
/**
|
|
77
|
+
* The bucket half of a client that has no bucket: every method throws
|
|
78
|
+
* {@link FileServerReadOnly}, naming itself.
|
|
79
|
+
*
|
|
80
|
+
* A proxy rather than a list of stubs, so a method the storage client grows
|
|
81
|
+
* later refuses the same way. What a runtime asks of any object is left
|
|
82
|
+
* alone: `then`, because a client is resolved from a promise, and the names a
|
|
83
|
+
* serialiser or a test's printer looks for.
|
|
84
|
+
*/
|
|
85
|
+
function readOnlyStorage(id, key) {
|
|
86
|
+
return new Proxy({}, { get(_target, property) {
|
|
87
|
+
if (typeof property !== "string" || INTROSPECTED.has(property)) return;
|
|
88
|
+
return () => {
|
|
89
|
+
throw new FileServerReadOnly(id, property, key);
|
|
90
|
+
};
|
|
91
|
+
} });
|
|
92
|
+
}
|
|
50
93
|
/** A key was asked to be served unsigned, and no open pattern admits it. */
|
|
51
94
|
var NotOpen = class extends Error {
|
|
52
95
|
key;
|
|
@@ -92,10 +135,10 @@ var FileServer = class {
|
|
|
92
135
|
if (options.origin && options.expire) throw new BucketOptionOnOrigin(canonical, originId, "expire");
|
|
93
136
|
this.expire = require_expire.expiryDays(canonical, options.expire);
|
|
94
137
|
this.derivedDays = options.derived ? require_expire.expiryDays(canonical, { [_geekmidas_manifest.DERIVED_PREFIX]: options.derived })?.[_geekmidas_manifest.DERIVED_PREFIX] : void 0;
|
|
95
|
-
this.surfaceId =
|
|
138
|
+
this.surfaceId = (0, _geekmidas_manifest.fileServerSurfaceId)(canonical);
|
|
96
139
|
this.keys = {
|
|
97
|
-
origin: (0, _geekmidas_manifest.provideKey)(originId, "
|
|
98
|
-
server: (0, _geekmidas_manifest.
|
|
140
|
+
origin: (0, _geekmidas_manifest.provideKey)(originId, "connectionString"),
|
|
141
|
+
server: (0, _geekmidas_manifest.providedKeyFor)(this.surfaceId, "file-server", "url")
|
|
99
142
|
};
|
|
100
143
|
this.service = {
|
|
101
144
|
serviceName: (0, _geekmidas_manifest.serviceKey)(canonical),
|
|
@@ -145,20 +188,14 @@ var FileServer = class {
|
|
|
145
188
|
});
|
|
146
189
|
}
|
|
147
190
|
/**
|
|
148
|
-
* The served surface
|
|
149
|
-
*
|
|
150
|
-
* Depending on the `FileServer` itself points at the **bucket** — its
|
|
151
|
-
* canonical node — which is right for a handler: it presigns and writes. But
|
|
152
|
-
* a bucket's URL is never public, so a site depending on it gets nothing
|
|
153
|
-
* inlined, which is correct and also useless.
|
|
191
|
+
* The served surface: what a site's or a mobile app's plain
|
|
192
|
+
* `.dependsOn([uploads])` points at.
|
|
154
193
|
*
|
|
155
|
-
*
|
|
156
|
-
*
|
|
157
|
-
*
|
|
158
|
-
* `database.reader()` uses, and for the same reason — one construct owning
|
|
159
|
-
* two addresses needs a way to name the second.
|
|
194
|
+
* Its address is public, so the frontend is built with it
|
|
195
|
+
* (`VITE_UPLOADS_URL`) — and it is all the frontend gets: no bucket, no
|
|
196
|
+
* key. A backend's plain edge is to the bucket, as it presigns and writes.
|
|
160
197
|
*/
|
|
161
|
-
get
|
|
198
|
+
get publicFace() {
|
|
162
199
|
const surface = this.declare().find((declaration) => declaration.id === this.surfaceId);
|
|
163
200
|
return {
|
|
164
201
|
id: this.surfaceId,
|
|
@@ -166,6 +203,23 @@ var FileServer = class {
|
|
|
166
203
|
};
|
|
167
204
|
}
|
|
168
205
|
/**
|
|
206
|
+
* Everything: the bucket, its credentials, and the address it is served
|
|
207
|
+
* on.
|
|
208
|
+
*
|
|
209
|
+
* What a backend's plain edge already is. A frontend asks for it by name —
|
|
210
|
+
* `.dependsOn([uploads.server])` — when its server half uploads or
|
|
211
|
+
* presigns: a full-stack site's, never a bundle's. The bucket's connection
|
|
212
|
+
* is never inlined into a bundle either way; only the served address is.
|
|
213
|
+
*/
|
|
214
|
+
get server() {
|
|
215
|
+
const originId = this.options.origin?.id ?? this.id;
|
|
216
|
+
const declarations = this.options.origin ? this.options.origin.declare() : this.declare();
|
|
217
|
+
return {
|
|
218
|
+
id: originId,
|
|
219
|
+
declare: () => declarations
|
|
220
|
+
};
|
|
221
|
+
}
|
|
222
|
+
/**
|
|
169
223
|
* The bucket and the surface over it — or just the surface, when the bucket
|
|
170
224
|
* was declared elsewhere.
|
|
171
225
|
*
|
|
@@ -198,17 +252,21 @@ var FileServer = class {
|
|
|
198
252
|
/**
|
|
199
253
|
* The bucket's client, with the serving half added.
|
|
200
254
|
*
|
|
201
|
-
* Both
|
|
255
|
+
* Both keys are read here, which is also how the environment reaches a
|
|
202
256
|
* handler: the sniffer records what this reads, so `.dependsOn([uploads])`
|
|
203
|
-
* carries the bucket
|
|
204
|
-
* down beside the handler.
|
|
257
|
+
* carries the bucket's connection and the server's address without either
|
|
258
|
+
* being written down beside the handler.
|
|
259
|
+
*
|
|
260
|
+
* Without the connection — a site's or an app's plain edge, which is to
|
|
261
|
+
* the public face — the client serves and does nothing else: its bucket
|
|
262
|
+
* methods throw {@link FileServerReadOnly}.
|
|
205
263
|
*/
|
|
206
264
|
async connect(options) {
|
|
207
265
|
const { origin, server } = options.envParser.create((get) => ({
|
|
208
|
-
origin: get(this.keys.origin).string(),
|
|
266
|
+
origin: get(this.keys.origin).string().optional(),
|
|
209
267
|
server: get(this.keys.server).string()
|
|
210
268
|
})).parse();
|
|
211
|
-
const storage = (0, _geekmidas_storage.createStorageClient)(origin);
|
|
269
|
+
const storage = origin ? (0, _geekmidas_storage.createStorageClient)(origin) : readOnlyStorage(this.id, this.keys.origin);
|
|
212
270
|
const base = server.replace(/\/+$/, "");
|
|
213
271
|
const serve = (key) => {
|
|
214
272
|
if (!this.serves(key)) throw new NotOpen(key, this.open);
|
|
@@ -272,6 +330,7 @@ function globToRegExp(pattern) {
|
|
|
272
330
|
//#endregion
|
|
273
331
|
exports.BucketOptionOnOrigin = BucketOptionOnOrigin;
|
|
274
332
|
exports.FileServer = FileServer;
|
|
333
|
+
exports.FileServerReadOnly = FileServerReadOnly;
|
|
275
334
|
exports.ImmutableNotOpen = ImmutableNotOpen;
|
|
276
335
|
exports.NotOpen = NotOpen;
|
|
277
336
|
exports.ProcessorNotOnThisServer = ProcessorNotOnThisServer;
|
package/dist/file-server.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"file-server.cjs","names":["canonicalId","expiryDays","DERIVED_PREFIX","provideKey","serviceKey","createStorageClient","ProcessorBuilder","parsePattern","DEFAULT_LOGGER","fillPattern"],"sources":["../src/file-server.ts"],"sourcesContent":["/**\n * `FileServer` — a domain that serves a bucket's objects.\n *\n * `ObjectStorage` is the bucket: it writes, it presigns, and its URL is never\n * public. Serving those objects on a domain is a different thing, and it is a\n * construct of its own rather than a flag on the bucket — see\n * `docs/design/constructs-paradigm.md`, \"Why a separate construct, and what it\n * costs\", for the comparison that rules the other two shapes out.\n *\n * ```ts\n * export const uploads = new FileServer('Uploads', { open: ['brand/**'] });\n *\n * uploads.getUploadURL({ path, contentType }) // an S3 presign at the bucket\n * uploads.url('brand/logo.png') // open path — no signature\n * uploads.signedUrl('invoices/7.pdf') // one object, one recipient\n * ```\n *\n * **One construct, one client, both halves.** How a file lands in the bucket is\n * the same whether or not it is served, so splitting the upload half from the\n * serving half would be ceremony rather than safety. The client is a *superset*\n * of `StorageClient`, made literal in the type, so anything taking\n * `services.uploads` keeps compiling when the construct behind it grows a\n * serving half.\n *\n * **The id names the bucket, not the surface.** This is the detail that has to\n * be right before anything ships, because getting it backwards is destructive:\n * the migration people actually perform is serving a bucket they already have,\n * and naming the bucket after the construct makes that edit *add* a node rather\n * than rename the one holding the data.\n */\n\nimport type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport {\n\ttype ConstructName,\n\tcanonicalId,\n\tDERIVED_PREFIX,\n\ttype Declaration,\n\tprovideKey,\n\tserviceKey,\n} from '@geekmidas/manifest';\nimport type { Service, ServiceRegisterOptions } from '@geekmidas/services';\nimport { createStorageClient, type StorageClient } from '@geekmidas/storage';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { Construct, Declarable } from './construct-interface';\nimport { expiryDays, type ObjectExpiry } from './expire';\nimport type { Processor } from './processors/Processor';\nimport { ProcessorBuilder } from './processors/ProcessorBuilder';\nimport {\n\tfillPattern,\n\ttype PatternParams,\n\tparsePattern,\n} from './processors/pattern';\nimport type { Telemetry } from './telemetry';\n\n/**\n * A key an open pattern admits.\n *\n * The same template-literal trick `ConstructName` uses, so `open` is checked at\n * the call site rather than only at the edge:\n *\n * ```ts\n * files.url('brand/logo.png') // ok\n * files.url(`avatars/${id}.png`) // ok — a template literal still matches\n * files.url('invoices/7.pdf') // not assignable — never served unsigned\n * ```\n *\n * A single star and a double star resolve to the same type, stated rather than\n * discovered: a template literal cannot exclude `/`, so this is a prefix-and-\n * suffix guard while the *exact* pattern is enforced by the bucket policy, by\n * the cache behaviour, and by this construct's own runtime check. The type says\n * plausibly open; the infrastructure says definitely.\n */\nexport type Served<P extends string> = P extends `${infer Head}**`\n\t? `${Head}${string}`\n\t: P extends `${infer Head}*${infer Tail}`\n\t\t? `${Head}${string}${Tail}`\n\t\t: P;\n\n/** What consuming a file server hands you: a bucket client that also serves. */\nexport interface FileServerClient<TOpen extends string = never>\n\textends StorageClient {\n\t/**\n\t * The unsigned address of an open object.\n\t *\n\t * Compile-checked against the declared patterns, *and* checked again at\n\t * runtime — a JavaScript caller gets no compiler, and minting an unsigned\n\t * URL for a private object is a leak rather than a mistake.\n\t *\n\t * @throws {NotOpen} when the key matches no declared pattern.\n\t */\n\turl(key: Served<TOpen>): string;\n\n\t/**\n\t * The same thing for a key the compiler cannot see.\n\t *\n\t * A fully dynamic key does not type, which is correct and is also the case\n\t * people will hit — so the escape hatch is a named method rather than a\n\t * cast, and it runs the *same* runtime check rather than being a way around\n\t * it.\n\t *\n\t * @throws {NotOpen} when the key matches no declared pattern.\n\t */\n\topenUrl(key: string): string;\n\n\t/**\n\t * A signed address for one object and one recipient.\n\t *\n\t * Today this is an **S3 presign at the bucket**, which is what works\n\t * unchanged against MinIO locally and against S3 deployed. It is deliberately\n\t * not described as a CDN URL: CloudFront signing is a different mechanism,\n\t * with different keys, against a different host, and it needs key material\n\t * this construct does not yet declare.\n\t *\n\t * @param expiresIn - minutes, matching `getUploadURL`.\n\t */\n\tsignedUrl(key: string, expiresIn?: number): Promise<string>;\n\n\t/**\n\t * The address of a processor's derivative of an open object — the\n\t * thumbnail, not the original.\n\t *\n\t * @throws {NotOpen} when the key matches no declared pattern.\n\t * @throws {ProcessorNotOnThisServer} for another file server's processor.\n\t */\n\tprocessedUrl<\n\t\tTPattern extends string,\n\t\tTSchema extends StandardSchemaV1 | undefined,\n\t>(\n\t\tprocessor: Processor<TPattern, TSchema, any, any>,\n\t\tparams: ProcessorUrlParams<TPattern, TSchema>,\n\t\tkey: string,\n\t): string;\n}\n\n/**\n * What addresses a derivative: the values the processor's schema accepts —\n * its input, since these go into a path — or, without one, the raw strings.\n */\nexport type ProcessorUrlParams<\n\tTPattern extends string,\n\tTSchema extends StandardSchemaV1 | undefined,\n> = TSchema extends StandardSchemaV1\n\t? StandardSchemaV1.InferInput<TSchema>\n\t: PatternParams<TPattern>;\n\n/** A processed URL was asked of a file server the processor is not on. */\nexport class ProcessorNotOnThisServer extends Error {\n\tconstructor(\n\t\treadonly pattern: string,\n\t\treadonly server: string,\n\t\treadonly expected: string,\n\t) {\n\t\tsuper(\n\t\t\t`The processor at '${pattern}' belongs to '${server}', not '${expected}'. ` +\n\t\t\t\t`Ask its own file server for the URL: services.<its id>.processedUrl(…).`,\n\t\t);\n\t\tthis.name = 'ProcessorNotOnThisServer';\n\t}\n}\n\nexport interface FileServerOptions<TOpen extends string = never> {\n\t/**\n\t * Paths served without a signature. Everything else needs one.\n\t *\n\t * Private by default: a bucket where forgetting a flag publishes user\n\t * uploads is the wrong default, so this is an exception list, and listing it\n\t * in code means exactly one set of paths is unauthenticated and it is\n\t * reviewable in a diff.\n\t *\n\t * Uploading is deliberately *not* restricted to these. Writing to a path\n\t * that happens to be open is ordinary; the only asymmetry worth enforcing is\n\t * that you cannot hand out an unsigned URL for something the server would\n\t * refuse to serve unsigned.\n\t */\n\topen?: readonly TOpen[];\n\t/**\n\t * Open paths whose objects never change once written — keyed by a content\n\t * hash or a file id — so every client may keep them forever: the edge\n\t * sends `Cache-Control: public, max-age=31536000, immutable`, over\n\t * whatever the object was stored with.\n\t *\n\t * A subset of `open`, because a signed object is never served by the edge.\n\t * Only say it of paths whose keys are written once: a client holding an\n\t * immutable copy never asks again.\n\t */\n\timmutable?: readonly string[];\n\t/** Keep previous versions of an object. */\n\tversioned?: boolean;\n\t/**\n\t * Delete the objects under each prefix this many days after they were\n\t * written — `{ 'previews/': { days: 7 } }`. A setting of the bucket this\n\t * server vends, so it cannot be given with `origin`.\n\t */\n\texpire?: ObjectExpiry;\n\t/**\n\t * How long its processors' derivatives are kept in the bucket before it\n\t * deletes them — 30 days unless said. They are remade on the next request,\n\t * so this trades storage for the work of making one again.\n\t */\n\tderived?: { readonly days: number };\n\t/**\n\t * What its processor unit emits — the `Telemetry` construct, as a worker\n\t * takes it: each request is a span, and the deploy hands the unit the\n\t * `OTEL_*` keys its stage resolves.\n\t */\n\ttelemetry?: Telemetry;\n\t/**\n\t * A bucket declared elsewhere, instead of one of this server's own.\n\t *\n\t * `new FileServer('Uploads')` declares both nodes; this fronts a bucket that\n\t * already exists, which is also how the two edges come back when you want\n\t * them separately — a handler depending on the bucket writes, a handler\n\t * depending on the server mints URLs.\n\t */\n\torigin?: Declarable;\n}\n\n/** An immutable pattern that no open pattern admits. */\nexport class ImmutableNotOpen extends Error {\n\tconstructor(\n\t\treadonly id: string,\n\t\treadonly pattern: string,\n\t\treadonly open: readonly string[],\n\t) {\n\t\tsuper(\n\t\t\t`'${id}' says '${pattern}' is immutable, and no open path admits it` +\n\t\t\t\t(open.length ? ` (open: ${open.join(', ')})` : ' — it opens none') +\n\t\t\t\t'. Only an open path is served by the edge, so only one can be ' +\n\t\t\t\t'cached there: add it to `open`, or narrow it to one that is.',\n\t\t);\n\t\tthis.name = 'ImmutableNotOpen';\n\t}\n}\n\n/**\n * A bucket setting given to a file server that fronts a bucket declared\n * elsewhere — where the bucket's own construct is the one that says it.\n */\nexport class BucketOptionOnOrigin extends Error {\n\tconstructor(\n\t\treadonly server: string,\n\t\treadonly origin: string,\n\t\treadonly option: string,\n\t) {\n\t\tsuper(\n\t\t\t`'${server}' fronts '${origin}', which declares itself, so '${option}' ` +\n\t\t\t\t`belongs on the construct that declares '${origin}', not on the file server.`,\n\t\t);\n\t\tthis.name = 'BucketOptionOnOrigin';\n\t}\n}\n\n/** A key was asked to be served unsigned, and no open pattern admits it. */\nexport class NotOpen extends Error {\n\tconstructor(\n\t\treadonly key: string,\n\t\treadonly open: readonly string[],\n\t) {\n\t\tsuper(\n\t\t\t`'${key}' is not served without a signature. ` +\n\t\t\t\t(open.length\n\t\t\t\t\t? `Open paths: ${open.join(', ')}. Use signedUrl() for anything else.`\n\t\t\t\t\t: 'This file server declares no open paths, so every object needs signedUrl().'),\n\t\t);\n\t\tthis.name = 'NotOpen';\n\t}\n}\n\nexport class FileServer<\n\tTName extends string = string,\n\tTOpen extends string = never,\n> implements Construct<TName, FileServerClient<TOpen>>\n{\n\treadonly id: TName;\n\treadonly service: Service<Uncapitalize<TName>, FileServerClient<TOpen>>;\n\n\t/** The id of the surface node, as opposed to the bucket's. */\n\treadonly surfaceId: string;\n\n\tprivate readonly open: readonly string[];\n\tprivate readonly immutable: readonly string[];\n\n\t/** The vended bucket's expiry, checked once: prefix → days. */\n\tprivate readonly expire: Record<string, number> | undefined;\n\n\t/** Days its processors' derivatives are kept, when it says. */\n\tprivate readonly derivedDays: number | undefined;\n\n\t/**\n\t * Declared once and read by both `declare()` and `connect()`, so the keys the\n\t * target publishes and the keys the client reads cannot drift.\n\t */\n\tprivate readonly keys: { origin: string; server: string };\n\n\t/**\n\t * How a processor reaches the bucket: the bucket's own URL and nothing of\n\t * the serving half, which a processor never needs. A field, not a getter:\n\t * services are cached by object identity.\n\t */\n\tprivate readonly origin: Service<string, StorageClient>;\n\n\tconstructor(\n\t\tid: ConstructName<TName>,\n\t\tprivate readonly options: FileServerOptions<TOpen> = {},\n\t) {\n\t\tconst canonical = canonicalId(id as string);\n\n\t\tthis.id = canonical as TName;\n\t\tthis.open = options.open ?? [];\n\t\tthis.immutable = options.immutable ?? [];\n\t\tfor (const pattern of this.immutable) {\n\t\t\tif (!this.covers(pattern)) {\n\t\t\t\tthrow new ImmutableNotOpen(canonical, pattern, this.open);\n\t\t\t}\n\t\t}\n\n\t\t// The surface takes the suffix and the bucket keeps the plain id, which\n\t\t// is what makes \"serve a bucket I already have\" an edit that adds a node\n\t\t// instead of renaming the one holding the data.\n\t\tconst originId = options.origin?.id ?? canonical;\n\t\tif (options.origin && options.expire) {\n\t\t\tthrow new BucketOptionOnOrigin(canonical, originId, 'expire');\n\t\t}\n\t\tthis.expire = expiryDays(canonical, options.expire);\n\t\tthis.derivedDays = options.derived\n\t\t\t? expiryDays(canonical, { [DERIVED_PREFIX]: options.derived })?.[\n\t\t\t\t\tDERIVED_PREFIX\n\t\t\t\t]\n\t\t\t: undefined;\n\t\tthis.surfaceId = `${canonical}Server`;\n\n\t\tthis.keys = {\n\t\t\torigin: provideKey(originId, 'url'),\n\t\t\tserver: provideKey(this.surfaceId, 'url'),\n\t\t};\n\n\t\t// A field, not a getter: consumers cache services by object identity.\n\t\tthis.service = {\n\t\t\tserviceName: serviceKey(canonical) as Uncapitalize<TName>,\n\t\t\tregister: (registerOptions) => this.connect(registerOptions),\n\t\t};\n\n\t\tconst originKey = this.keys.origin;\n\t\tthis.origin = {\n\t\t\tserviceName: `${serviceKey(originId)}ProcessorOrigin`,\n\t\t\tregister: ({ envParser }) => {\n\t\t\t\tconst { url } = envParser\n\t\t\t\t\t.create((get) => ({ url: get(originKey).string() }))\n\t\t\t\t\t.parse();\n\t\t\t\treturn createStorageClient(url);\n\t\t\t},\n\t\t};\n\t}\n\n\t/**\n\t * A processor behind one path pattern of this server: a handler that makes\n\t * a derivative of an open object on read.\n\t *\n\t * ```ts\n\t * export const thumbnails = assets\n\t * .process('/i/:width/*')\n\t * .params(z.object({ width: z.enum(['64', '256', '1024']) }))\n\t * .native(['sharp'])\n\t * .handle(async ({ params, object }) => ({\n\t * body: await sharp(await object.bytes()).resize(Number(params.width)).webp().toBuffer(),\n\t * contentType: 'image/webp',\n\t * cache: 'immutable',\n\t * }));\n\t * ```\n\t *\n\t * Open paths only: a key no `open` pattern admits is answered 404, as an\n\t * unsigned read of it would be.\n\t *\n\t * @throws {ProcessorPatternInvalid} for a pattern the edge cannot route.\n\t */\n\tprocess<TPattern extends `/${string}/*`>(\n\t\tpattern: TPattern,\n\t\toptions: { logger?: Logger } = {},\n\t): ProcessorBuilder<TPattern> {\n\t\treturn new ProcessorBuilder<TPattern>({\n\t\t\tparsed: parsePattern(pattern),\n\t\t\tsurfaceId: this.surfaceId,\n\t\t\tbucketId: this.options.origin?.id ?? this.id,\n\t\t\torigin: this.origin,\n\t\t\tserves: (key) => this.serves(key),\n\t\t\tlogger: (options.logger ?? DEFAULT_LOGGER) as Logger,\n\t\t\tnative: [],\n\t\t\tservices: [],\n\t\t\tconstructs: [],\n\t\t});\n\t}\n\n\t/**\n\t * The served surface, as something an edge can point at.\n\t *\n\t * Depending on the `FileServer` itself points at the **bucket** — its\n\t * canonical node — which is right for a handler: it presigns and writes. But\n\t * a bucket's URL is never public, so a site depending on it gets nothing\n\t * inlined, which is correct and also useless.\n\t *\n\t * This is the other half: `.dependsOn([uploads.server])` points at the\n\t * surface, whose address *is* public, and is what puts\n\t * `VITE_UPLOADS_SERVER_URL` in a bundle. The same accessor shape\n\t * `database.reader()` uses, and for the same reason — one construct owning\n\t * two addresses needs a way to name the second.\n\t */\n\tget server(): Declarable {\n\t\tconst surface = this.declare().find(\n\t\t\t(declaration) => declaration.id === this.surfaceId,\n\t\t);\n\n\t\treturn {\n\t\t\tid: this.surfaceId,\n\t\t\tdeclare: () => (surface ? [surface] : []),\n\t\t};\n\t}\n\n\t/**\n\t * The bucket and the surface over it — or just the surface, when the bucket\n\t * was declared elsewhere.\n\t *\n\t * The surface names its origin through `of`, which is what makes the\n\t * reference check work: an origin resolving to nothing is a build failure,\n\t * the same guarantee `assertDerivations` already gives a reader and a schema\n\t * tenant.\n\t */\n\tdeclare(): Declaration[] {\n\t\tconst origin = this.options.origin;\n\n\t\tconst surface: Declaration = {\n\t\t\tkind: 'file-server',\n\t\t\tid: this.surfaceId,\n\t\t\tof: origin?.id ?? this.id,\n\t\t\t...(this.open.length ? { open: this.open } : {}),\n\t\t\t...(this.immutable.length ? { immutable: this.immutable } : {}),\n\t\t\t...(this.derivedDays !== undefined\n\t\t\t\t? { derivedDays: this.derivedDays }\n\t\t\t\t: {}),\n\t\t\t...(this.options.telemetry\n\t\t\t\t? { telemetry: this.options.telemetry.id }\n\t\t\t\t: {}),\n\t\t\tprovides: [this.keys.server],\n\t\t};\n\n\t\t// A vended bucket is declared here; a given one already declares itself,\n\t\t// and declaring it twice is the duplication the whole model removes.\n\t\tif (origin) return [surface];\n\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'objects',\n\t\t\t\tid: this.id,\n\t\t\t\tprovides: [this.keys.origin],\n\t\t\t\t...(this.options.versioned ? { versioned: true } : {}),\n\t\t\t\t...(this.expire ? { expire: this.expire } : {}),\n\t\t\t},\n\t\t\tsurface,\n\t\t];\n\t}\n\n\t/**\n\t * The bucket's client, with the serving half added.\n\t *\n\t * Both addresses are read here, which is also how the environment reaches a\n\t * handler: the sniffer records what this reads, so `.dependsOn([uploads])`\n\t * carries the bucket URL and the server URL without either being written\n\t * down beside the handler.\n\t */\n\tprivate async connect(\n\t\toptions: ServiceRegisterOptions,\n\t): Promise<FileServerClient<TOpen>> {\n\t\tconst { origin, server } = options.envParser\n\t\t\t.create((get) => ({\n\t\t\t\torigin: get(this.keys.origin).string(),\n\t\t\t\tserver: get(this.keys.server).string(),\n\t\t\t}))\n\t\t\t.parse();\n\n\t\tconst storage = createStorageClient(origin);\n\t\tconst base = server.replace(/\\/+$/, '');\n\n\t\tconst serve = (key: string): string => {\n\t\t\tif (!this.serves(key)) throw new NotOpen(key, this.open);\n\n\t\t\treturn `${base}/${key.replace(/^\\/+/, '')}`;\n\t\t};\n\n\t\t// Delegating rather than copying: the bucket half is whatever the driver\n\t\t// produced, including anything it grows later, and only the serving half\n\t\t// is added on top.\n\t\treturn Object.assign(Object.create(storage) as StorageClient, {\n\t\t\turl: serve as (key: Served<TOpen>) => string,\n\t\t\topenUrl: serve,\n\t\t\tsignedUrl: (key: string, expiresIn?: number) =>\n\t\t\t\tstorage.getDownloadURL({ path: key } as never, expiresIn),\n\t\t\tprocessedUrl: (\n\t\t\t\tprocessor: Processor<string, any, any, any>,\n\t\t\t\tparams: Record<string, string | number>,\n\t\t\t\tkey: string,\n\t\t\t) => {\n\t\t\t\tif (processor.surfaceId !== this.surfaceId) {\n\t\t\t\t\tthrow new ProcessorNotOnThisServer(\n\t\t\t\t\t\tprocessor.pattern,\n\t\t\t\t\t\tprocessor.surfaceId,\n\t\t\t\t\t\tthis.surfaceId,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tif (!this.serves(key)) throw new NotOpen(key, this.open);\n\t\t\t\treturn `${base}${fillPattern(processor.parsed, params, key)}`;\n\t\t\t},\n\t\t}) as FileServerClient<TOpen>;\n\t}\n\n\t/**\n\t * Whether an open pattern admits a key.\n\t *\n\t * The runtime half of {@link Served}, and stricter than it: here a single\n\t * star stops at a segment boundary and a double star does not, which is the\n\t * distinction a template-literal type cannot draw and the infrastructure\n\t * does.\n\t */\n\tprivate serves(key: string): boolean {\n\t\treturn this.open.some((pattern) => globToRegExp(pattern).test(key));\n\t}\n\n\t/**\n\t * Whether every key a pattern admits is open: the pattern itself, each of\n\t * its wildcards taken as a segment of its own, is a key an open pattern\n\t * serves — `brand/logos/*` under `brand/**`, but not `**` under `brand/**`.\n\t */\n\tprivate covers(pattern: string): boolean {\n\t\treturn this.serves(pattern.replace(/\\*\\*/g, 'x/x').replace(/\\*/g, 'x'));\n\t}\n}\n\n/**\n * One open pattern as an anchored expression.\n *\n * A double star crosses `/`; a single star does not. Both are consumed in one\n * left-to-right pass rather than by substitution, so a pattern cannot be\n * rewritten into a placeholder that a later pass mistakes for literal text.\n */\nfunction globToRegExp(pattern: string): RegExp {\n\tlet source = '';\n\n\tfor (let index = 0; index < pattern.length; index++) {\n\t\tconst character = pattern[index];\n\n\t\tif (character !== '*') {\n\t\t\tsource += character?.replace(/[.+^${}()|[\\]\\\\?]/, '\\\\$&') ?? '';\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (pattern[index + 1] === '*') {\n\t\t\tsource += '.*';\n\t\t\tindex++;\n\t\t\tcontinue;\n\t\t}\n\n\t\tsource += '[^/]*';\n\t}\n\n\treturn new RegExp(`^${source}$`);\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"file-server.cjs","names":["canonicalId","expiryDays","DERIVED_PREFIX","fileServerSurfaceId","provideKey","providedKeyFor","serviceKey","createStorageClient","ProcessorBuilder","parsePattern","DEFAULT_LOGGER","fillPattern"],"sources":["../src/file-server.ts"],"sourcesContent":["/**\n * `FileServer` — a domain that serves a bucket's objects.\n *\n * `ObjectStorage` is the bucket: it writes, it presigns, and its URL is never\n * public. Serving those objects on a domain is a different thing, and it is a\n * construct of its own rather than a flag on the bucket — see\n * `docs/design/constructs-paradigm.md`, \"Why a separate construct, and what it\n * costs\", for the comparison that rules the other two shapes out.\n *\n * ```ts\n * export const uploads = new FileServer('Uploads', { open: ['brand/**'] });\n *\n * uploads.getUploadURL({ path, contentType }) // an S3 presign at the bucket\n * uploads.url('brand/logo.png') // open path — no signature\n * uploads.signedUrl('invoices/7.pdf') // one object, one recipient\n * ```\n *\n * **One construct, one client, both halves.** How a file lands in the bucket is\n * the same whether or not it is served, so splitting the upload half from the\n * serving half would be ceremony rather than safety. The client is a *superset*\n * of `StorageClient`, made literal in the type, so anything taking\n * `services.uploads` keeps compiling when the construct behind it grows a\n * serving half.\n *\n * **The id names the bucket, not the surface.** This is the detail that has to\n * be right before anything ships, because getting it backwards is destructive:\n * the migration people actually perform is serving a bucket they already have,\n * and naming the bucket after the construct makes that edit *add* a node rather\n * than rename the one holding the data.\n */\n\nimport type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport {\n\ttype ConstructName,\n\tcanonicalId,\n\tDERIVED_PREFIX,\n\ttype Declaration,\n\tfileServerSurfaceId,\n\tprovidedKeyFor,\n\tprovideKey,\n\tserviceKey,\n} from '@geekmidas/manifest';\nimport type { Service, ServiceRegisterOptions } from '@geekmidas/services';\nimport { createStorageClient, type StorageClient } from '@geekmidas/storage';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type {\n\tConstruct,\n\tDeclarable,\n\tHasPublicFace,\n} from './construct-interface';\nimport { expiryDays, type ObjectExpiry } from './expire';\nimport type { Processor } from './processors/Processor';\nimport { ProcessorBuilder } from './processors/ProcessorBuilder';\nimport {\n\tfillPattern,\n\ttype PatternParams,\n\tparsePattern,\n} from './processors/pattern';\nimport type { Telemetry } from './telemetry';\n\n/**\n * A key an open pattern admits.\n *\n * The same template-literal trick `ConstructName` uses, so `open` is checked at\n * the call site rather than only at the edge:\n *\n * ```ts\n * files.url('brand/logo.png') // ok\n * files.url(`avatars/${id}.png`) // ok — a template literal still matches\n * files.url('invoices/7.pdf') // not assignable — never served unsigned\n * ```\n *\n * A single star and a double star resolve to the same type, stated rather than\n * discovered: a template literal cannot exclude `/`, so this is a prefix-and-\n * suffix guard while the *exact* pattern is enforced by the bucket policy, by\n * the cache behaviour, and by this construct's own runtime check. The type says\n * plausibly open; the infrastructure says definitely.\n */\nexport type Served<P extends string> = P extends `${infer Head}**`\n\t? `${Head}${string}`\n\t: P extends `${infer Head}*${infer Tail}`\n\t\t? `${Head}${string}${Tail}`\n\t\t: P;\n\n/** What consuming a file server hands you: a bucket client that also serves. */\nexport interface FileServerClient<TOpen extends string = never>\n\textends StorageClient {\n\t/**\n\t * The unsigned address of an open object.\n\t *\n\t * Compile-checked against the declared patterns, *and* checked again at\n\t * runtime — a JavaScript caller gets no compiler, and minting an unsigned\n\t * URL for a private object is a leak rather than a mistake.\n\t *\n\t * @throws {NotOpen} when the key matches no declared pattern.\n\t */\n\turl(key: Served<TOpen>): string;\n\n\t/**\n\t * The same thing for a key the compiler cannot see.\n\t *\n\t * A fully dynamic key does not type, which is correct and is also the case\n\t * people will hit — so the escape hatch is a named method rather than a\n\t * cast, and it runs the *same* runtime check rather than being a way around\n\t * it.\n\t *\n\t * @throws {NotOpen} when the key matches no declared pattern.\n\t */\n\topenUrl(key: string): string;\n\n\t/**\n\t * A signed address for one object and one recipient.\n\t *\n\t * Today this is an **S3 presign at the bucket**, which is what works\n\t * unchanged against MinIO locally and against S3 deployed. It is deliberately\n\t * not described as a CDN URL: CloudFront signing is a different mechanism,\n\t * with different keys, against a different host, and it needs key material\n\t * this construct does not yet declare.\n\t *\n\t * @param expiresIn - minutes, matching `getUploadURL`.\n\t */\n\tsignedUrl(key: string, expiresIn?: number): Promise<string>;\n\n\t/**\n\t * The address of a processor's derivative of an open object — the\n\t * thumbnail, not the original.\n\t *\n\t * @throws {NotOpen} when the key matches no declared pattern.\n\t * @throws {ProcessorNotOnThisServer} for another file server's processor.\n\t */\n\tprocessedUrl<\n\t\tTPattern extends string,\n\t\tTSchema extends StandardSchemaV1 | undefined,\n\t>(\n\t\tprocessor: Processor<TPattern, TSchema, any, any>,\n\t\tparams: ProcessorUrlParams<TPattern, TSchema>,\n\t\tkey: string,\n\t): string;\n}\n\n/**\n * What addresses a derivative: the values the processor's schema accepts —\n * its input, since these go into a path — or, without one, the raw strings.\n */\nexport type ProcessorUrlParams<\n\tTPattern extends string,\n\tTSchema extends StandardSchemaV1 | undefined,\n> = TSchema extends StandardSchemaV1\n\t? StandardSchemaV1.InferInput<TSchema>\n\t: PatternParams<TPattern>;\n\n/** A processed URL was asked of a file server the processor is not on. */\nexport class ProcessorNotOnThisServer extends Error {\n\tconstructor(\n\t\treadonly pattern: string,\n\t\treadonly server: string,\n\t\treadonly expected: string,\n\t) {\n\t\tsuper(\n\t\t\t`The processor at '${pattern}' belongs to '${server}', not '${expected}'. ` +\n\t\t\t\t`Ask its own file server for the URL: services.<its id>.processedUrl(…).`,\n\t\t);\n\t\tthis.name = 'ProcessorNotOnThisServer';\n\t}\n}\n\nexport interface FileServerOptions<TOpen extends string = never> {\n\t/**\n\t * Paths served without a signature. Everything else needs one.\n\t *\n\t * Private by default: a bucket where forgetting a flag publishes user\n\t * uploads is the wrong default, so this is an exception list, and listing it\n\t * in code means exactly one set of paths is unauthenticated and it is\n\t * reviewable in a diff.\n\t *\n\t * Uploading is deliberately *not* restricted to these. Writing to a path\n\t * that happens to be open is ordinary; the only asymmetry worth enforcing is\n\t * that you cannot hand out an unsigned URL for something the server would\n\t * refuse to serve unsigned.\n\t */\n\topen?: readonly TOpen[];\n\t/**\n\t * Open paths whose objects never change once written — keyed by a content\n\t * hash or a file id — so every client may keep them forever: the edge\n\t * sends `Cache-Control: public, max-age=31536000, immutable`, over\n\t * whatever the object was stored with.\n\t *\n\t * A subset of `open`, because a signed object is never served by the edge.\n\t * Only say it of paths whose keys are written once: a client holding an\n\t * immutable copy never asks again.\n\t */\n\timmutable?: readonly string[];\n\t/** Keep previous versions of an object. */\n\tversioned?: boolean;\n\t/**\n\t * Delete the objects under each prefix this many days after they were\n\t * written — `{ 'previews/': { days: 7 } }`. A setting of the bucket this\n\t * server vends, so it cannot be given with `origin`.\n\t */\n\texpire?: ObjectExpiry;\n\t/**\n\t * How long its processors' derivatives are kept in the bucket before it\n\t * deletes them — 30 days unless said. They are remade on the next request,\n\t * so this trades storage for the work of making one again.\n\t */\n\tderived?: { readonly days: number };\n\t/**\n\t * What its processor unit emits — the `Telemetry` construct, as a worker\n\t * takes it: each request is a span, and the deploy hands the unit the\n\t * `OTEL_*` keys its stage resolves.\n\t */\n\ttelemetry?: Telemetry;\n\t/**\n\t * A bucket declared elsewhere, instead of one of this server's own.\n\t *\n\t * `new FileServer('Uploads')` declares both nodes; this fronts a bucket that\n\t * already exists, which is also how the two edges come back when you want\n\t * them separately — a handler depending on the bucket writes, a handler\n\t * depending on the server mints URLs.\n\t */\n\torigin?: Declarable;\n}\n\n/** An immutable pattern that no open pattern admits. */\nexport class ImmutableNotOpen extends Error {\n\tconstructor(\n\t\treadonly id: string,\n\t\treadonly pattern: string,\n\t\treadonly open: readonly string[],\n\t) {\n\t\tsuper(\n\t\t\t`'${id}' says '${pattern}' is immutable, and no open path admits it` +\n\t\t\t\t(open.length ? ` (open: ${open.join(', ')})` : ' — it opens none') +\n\t\t\t\t'. Only an open path is served by the edge, so only one can be ' +\n\t\t\t\t'cached there: add it to `open`, or narrow it to one that is.',\n\t\t);\n\t\tthis.name = 'ImmutableNotOpen';\n\t}\n}\n\n/**\n * A bucket setting given to a file server that fronts a bucket declared\n * elsewhere — where the bucket's own construct is the one that says it.\n */\nexport class BucketOptionOnOrigin extends Error {\n\tconstructor(\n\t\treadonly server: string,\n\t\treadonly origin: string,\n\t\treadonly option: string,\n\t) {\n\t\tsuper(\n\t\t\t`'${server}' fronts '${origin}', which declares itself, so '${option}' ` +\n\t\t\t\t`belongs on the construct that declares '${origin}', not on the file server.`,\n\t\t);\n\t\tthis.name = 'BucketOptionOnOrigin';\n\t}\n}\n\n/**\n * A bucket method called on a file server's client that was handed only its\n * public address — a frontend's plain edge.\n */\nexport class FileServerReadOnly extends Error {\n\tconstructor(\n\t\treadonly id: string,\n\t\treadonly method: string,\n\t\treadonly key: string,\n\t) {\n\t\tsuper(\n\t\t\t`'${id}' was reached through its public address only, so it serves ` +\n\t\t\t\t`and cannot ${method}(): ${key} is not in this process's environment. ` +\n\t\t\t\t`A site or app whose server half writes or presigns depends on ` +\n\t\t\t\t`'${id}'.server instead — .dependsOn([${id.charAt(0).toLowerCase()}${id.slice(1)}.server]).`,\n\t\t);\n\t\tthis.name = 'FileServerReadOnly';\n\t}\n}\n\n/** Names asked of any object, which a read-only client must not answer. */\nconst INTROSPECTED = new Set([\n\t'then',\n\t'toJSON',\n\t'constructor',\n\t'asymmetricMatch',\n\t'$$typeof',\n\t'nodeType',\n\t'inspect',\n]);\n\n/**\n * The bucket half of a client that has no bucket: every method throws\n * {@link FileServerReadOnly}, naming itself.\n *\n * A proxy rather than a list of stubs, so a method the storage client grows\n * later refuses the same way. What a runtime asks of any object is left\n * alone: `then`, because a client is resolved from a promise, and the names a\n * serialiser or a test's printer looks for.\n */\nfunction readOnlyStorage(id: string, key: string): StorageClient {\n\treturn new Proxy({} as StorageClient, {\n\t\tget(_target, property) {\n\t\t\tif (typeof property !== 'string' || INTROSPECTED.has(property)) return;\n\t\t\treturn () => {\n\t\t\t\tthrow new FileServerReadOnly(id, property, key);\n\t\t\t};\n\t\t},\n\t});\n}\n\n/** A key was asked to be served unsigned, and no open pattern admits it. */\nexport class NotOpen extends Error {\n\tconstructor(\n\t\treadonly key: string,\n\t\treadonly open: readonly string[],\n\t) {\n\t\tsuper(\n\t\t\t`'${key}' is not served without a signature. ` +\n\t\t\t\t(open.length\n\t\t\t\t\t? `Open paths: ${open.join(', ')}. Use signedUrl() for anything else.`\n\t\t\t\t\t: 'This file server declares no open paths, so every object needs signedUrl().'),\n\t\t);\n\t\tthis.name = 'NotOpen';\n\t}\n}\n\nexport class FileServer<\n\tTName extends string = string,\n\tTOpen extends string = never,\n> implements Construct<TName, FileServerClient<TOpen>>, HasPublicFace\n{\n\treadonly id: TName;\n\treadonly service: Service<Uncapitalize<TName>, FileServerClient<TOpen>>;\n\n\t/** The id of the surface node, as opposed to the bucket's. */\n\treadonly surfaceId: string;\n\n\tprivate readonly open: readonly string[];\n\tprivate readonly immutable: readonly string[];\n\n\t/** The vended bucket's expiry, checked once: prefix → days. */\n\tprivate readonly expire: Record<string, number> | undefined;\n\n\t/** Days its processors' derivatives are kept, when it says. */\n\tprivate readonly derivedDays: number | undefined;\n\n\t/**\n\t * Declared once and read by both `declare()` and `connect()`, so the keys the\n\t * target publishes and the keys the client reads cannot drift.\n\t */\n\tprivate readonly keys: { origin: string; server: string };\n\n\t/**\n\t * How a processor reaches the bucket: the bucket's own URL and nothing of\n\t * the serving half, which a processor never needs. A field, not a getter:\n\t * services are cached by object identity.\n\t */\n\tprivate readonly origin: Service<string, StorageClient>;\n\n\tconstructor(\n\t\tid: ConstructName<TName>,\n\t\tprivate readonly options: FileServerOptions<TOpen> = {},\n\t) {\n\t\tconst canonical = canonicalId(id as string);\n\n\t\tthis.id = canonical as TName;\n\t\tthis.open = options.open ?? [];\n\t\tthis.immutable = options.immutable ?? [];\n\t\tfor (const pattern of this.immutable) {\n\t\t\tif (!this.covers(pattern)) {\n\t\t\t\tthrow new ImmutableNotOpen(canonical, pattern, this.open);\n\t\t\t}\n\t\t}\n\n\t\t// The surface takes the suffix and the bucket keeps the plain id, which\n\t\t// is what makes \"serve a bucket I already have\" an edit that adds a node\n\t\t// instead of renaming the one holding the data.\n\t\tconst originId = options.origin?.id ?? canonical;\n\t\tif (options.origin && options.expire) {\n\t\t\tthrow new BucketOptionOnOrigin(canonical, originId, 'expire');\n\t\t}\n\t\tthis.expire = expiryDays(canonical, options.expire);\n\t\tthis.derivedDays = options.derived\n\t\t\t? expiryDays(canonical, { [DERIVED_PREFIX]: options.derived })?.[\n\t\t\t\t\tDERIVED_PREFIX\n\t\t\t\t]\n\t\t\t: undefined;\n\t\tthis.surfaceId = fileServerSurfaceId(canonical);\n\n\t\tthis.keys = {\n\t\t\torigin: provideKey(originId, 'connectionString'),\n\t\t\tserver: providedKeyFor(this.surfaceId, 'file-server', 'url'),\n\t\t};\n\n\t\t// A field, not a getter: consumers cache services by object identity.\n\t\tthis.service = {\n\t\t\tserviceName: serviceKey(canonical) as Uncapitalize<TName>,\n\t\t\tregister: (registerOptions) => this.connect(registerOptions),\n\t\t};\n\n\t\tconst originKey = this.keys.origin;\n\t\tthis.origin = {\n\t\t\tserviceName: `${serviceKey(originId)}ProcessorOrigin`,\n\t\t\tregister: ({ envParser }) => {\n\t\t\t\tconst { url } = envParser\n\t\t\t\t\t.create((get) => ({ url: get(originKey).string() }))\n\t\t\t\t\t.parse();\n\t\t\t\treturn createStorageClient(url);\n\t\t\t},\n\t\t};\n\t}\n\n\t/**\n\t * A processor behind one path pattern of this server: a handler that makes\n\t * a derivative of an open object on read.\n\t *\n\t * ```ts\n\t * export const thumbnails = assets\n\t * .process('/i/:width/*')\n\t * .params(z.object({ width: z.enum(['64', '256', '1024']) }))\n\t * .native(['sharp'])\n\t * .handle(async ({ params, object }) => ({\n\t * body: await sharp(await object.bytes()).resize(Number(params.width)).webp().toBuffer(),\n\t * contentType: 'image/webp',\n\t * cache: 'immutable',\n\t * }));\n\t * ```\n\t *\n\t * Open paths only: a key no `open` pattern admits is answered 404, as an\n\t * unsigned read of it would be.\n\t *\n\t * @throws {ProcessorPatternInvalid} for a pattern the edge cannot route.\n\t */\n\tprocess<TPattern extends `/${string}/*`>(\n\t\tpattern: TPattern,\n\t\toptions: { logger?: Logger } = {},\n\t): ProcessorBuilder<TPattern> {\n\t\treturn new ProcessorBuilder<TPattern>({\n\t\t\tparsed: parsePattern(pattern),\n\t\t\tsurfaceId: this.surfaceId,\n\t\t\tbucketId: this.options.origin?.id ?? this.id,\n\t\t\torigin: this.origin,\n\t\t\tserves: (key) => this.serves(key),\n\t\t\tlogger: (options.logger ?? DEFAULT_LOGGER) as Logger,\n\t\t\tnative: [],\n\t\t\tservices: [],\n\t\t\tconstructs: [],\n\t\t});\n\t}\n\n\t/**\n\t * The served surface: what a site's or a mobile app's plain\n\t * `.dependsOn([uploads])` points at.\n\t *\n\t * Its address is public, so the frontend is built with it\n\t * (`VITE_UPLOADS_URL`) — and it is all the frontend gets: no bucket, no\n\t * key. A backend's plain edge is to the bucket, as it presigns and writes.\n\t */\n\tget publicFace(): Declarable {\n\t\tconst surface = this.declare().find(\n\t\t\t(declaration) => declaration.id === this.surfaceId,\n\t\t);\n\n\t\treturn {\n\t\t\tid: this.surfaceId,\n\t\t\tdeclare: () => (surface ? [surface] : []),\n\t\t};\n\t}\n\n\t/**\n\t * Everything: the bucket, its credentials, and the address it is served\n\t * on.\n\t *\n\t * What a backend's plain edge already is. A frontend asks for it by name —\n\t * `.dependsOn([uploads.server])` — when its server half uploads or\n\t * presigns: a full-stack site's, never a bundle's. The bucket's connection\n\t * is never inlined into a bundle either way; only the served address is.\n\t */\n\tget server(): Declarable {\n\t\tconst originId = this.options.origin?.id ?? this.id;\n\t\tconst declarations = this.options.origin\n\t\t\t? this.options.origin.declare()\n\t\t\t: this.declare();\n\n\t\treturn { id: originId, declare: () => declarations };\n\t}\n\n\t/**\n\t * The bucket and the surface over it — or just the surface, when the bucket\n\t * was declared elsewhere.\n\t *\n\t * The surface names its origin through `of`, which is what makes the\n\t * reference check work: an origin resolving to nothing is a build failure,\n\t * the same guarantee `assertDerivations` already gives a reader and a schema\n\t * tenant.\n\t */\n\tdeclare(): Declaration[] {\n\t\tconst origin = this.options.origin;\n\n\t\tconst surface: Declaration = {\n\t\t\tkind: 'file-server',\n\t\t\tid: this.surfaceId,\n\t\t\tof: origin?.id ?? this.id,\n\t\t\t...(this.open.length ? { open: this.open } : {}),\n\t\t\t...(this.immutable.length ? { immutable: this.immutable } : {}),\n\t\t\t...(this.derivedDays !== undefined\n\t\t\t\t? { derivedDays: this.derivedDays }\n\t\t\t\t: {}),\n\t\t\t...(this.options.telemetry\n\t\t\t\t? { telemetry: this.options.telemetry.id }\n\t\t\t\t: {}),\n\t\t\tprovides: [this.keys.server],\n\t\t};\n\n\t\t// A vended bucket is declared here; a given one already declares itself,\n\t\t// and declaring it twice is the duplication the whole model removes.\n\t\tif (origin) return [surface];\n\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'objects',\n\t\t\t\tid: this.id,\n\t\t\t\tprovides: [this.keys.origin],\n\t\t\t\t...(this.options.versioned ? { versioned: true } : {}),\n\t\t\t\t...(this.expire ? { expire: this.expire } : {}),\n\t\t\t},\n\t\t\tsurface,\n\t\t];\n\t}\n\n\t/**\n\t * The bucket's client, with the serving half added.\n\t *\n\t * Both keys are read here, which is also how the environment reaches a\n\t * handler: the sniffer records what this reads, so `.dependsOn([uploads])`\n\t * carries the bucket's connection and the server's address without either\n\t * being written down beside the handler.\n\t *\n\t * Without the connection — a site's or an app's plain edge, which is to\n\t * the public face — the client serves and does nothing else: its bucket\n\t * methods throw {@link FileServerReadOnly}.\n\t */\n\tprivate async connect(\n\t\toptions: ServiceRegisterOptions,\n\t): Promise<FileServerClient<TOpen>> {\n\t\tconst { origin, server } = options.envParser\n\t\t\t.create((get) => ({\n\t\t\t\torigin: get(this.keys.origin).string().optional(),\n\t\t\t\tserver: get(this.keys.server).string(),\n\t\t\t}))\n\t\t\t.parse();\n\n\t\tconst storage = origin\n\t\t\t? createStorageClient(origin)\n\t\t\t: readOnlyStorage(this.id, this.keys.origin);\n\t\tconst base = server.replace(/\\/+$/, '');\n\n\t\tconst serve = (key: string): string => {\n\t\t\tif (!this.serves(key)) throw new NotOpen(key, this.open);\n\n\t\t\treturn `${base}/${key.replace(/^\\/+/, '')}`;\n\t\t};\n\n\t\t// Delegating rather than copying: the bucket half is whatever the driver\n\t\t// produced, including anything it grows later, and only the serving half\n\t\t// is added on top.\n\t\treturn Object.assign(Object.create(storage) as StorageClient, {\n\t\t\turl: serve as (key: Served<TOpen>) => string,\n\t\t\topenUrl: serve,\n\t\t\tsignedUrl: (key: string, expiresIn?: number) =>\n\t\t\t\tstorage.getDownloadURL({ path: key } as never, expiresIn),\n\t\t\tprocessedUrl: (\n\t\t\t\tprocessor: Processor<string, any, any, any>,\n\t\t\t\tparams: Record<string, string | number>,\n\t\t\t\tkey: string,\n\t\t\t) => {\n\t\t\t\tif (processor.surfaceId !== this.surfaceId) {\n\t\t\t\t\tthrow new ProcessorNotOnThisServer(\n\t\t\t\t\t\tprocessor.pattern,\n\t\t\t\t\t\tprocessor.surfaceId,\n\t\t\t\t\t\tthis.surfaceId,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tif (!this.serves(key)) throw new NotOpen(key, this.open);\n\t\t\t\treturn `${base}${fillPattern(processor.parsed, params, key)}`;\n\t\t\t},\n\t\t}) as FileServerClient<TOpen>;\n\t}\n\n\t/**\n\t * Whether an open pattern admits a key.\n\t *\n\t * The runtime half of {@link Served}, and stricter than it: here a single\n\t * star stops at a segment boundary and a double star does not, which is the\n\t * distinction a template-literal type cannot draw and the infrastructure\n\t * does.\n\t */\n\tprivate serves(key: string): boolean {\n\t\treturn this.open.some((pattern) => globToRegExp(pattern).test(key));\n\t}\n\n\t/**\n\t * Whether every key a pattern admits is open: the pattern itself, each of\n\t * its wildcards taken as a segment of its own, is a key an open pattern\n\t * serves — `brand/logos/*` under `brand/**`, but not `**` under `brand/**`.\n\t */\n\tprivate covers(pattern: string): boolean {\n\t\treturn this.serves(pattern.replace(/\\*\\*/g, 'x/x').replace(/\\*/g, 'x'));\n\t}\n}\n\n/**\n * One open pattern as an anchored expression.\n *\n * A double star crosses `/`; a single star does not. Both are consumed in one\n * left-to-right pass rather than by substitution, so a pattern cannot be\n * rewritten into a placeholder that a later pass mistakes for literal text.\n */\nfunction globToRegExp(pattern: string): RegExp {\n\tlet source = '';\n\n\tfor (let index = 0; index < pattern.length; index++) {\n\t\tconst character = pattern[index];\n\n\t\tif (character !== '*') {\n\t\t\tsource += character?.replace(/[.+^${}()|[\\]\\\\?]/, '\\\\$&') ?? '';\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (pattern[index + 1] === '*') {\n\t\t\tsource += '.*';\n\t\t\tindex++;\n\t\t\tcontinue;\n\t\t}\n\n\t\tsource += '[^/]*';\n\t}\n\n\treturn new RegExp(`^${source}$`);\n}\n"],"mappings":"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"}
|
package/dist/file-server.d.cts
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { n as StandardSchemaV1 } from "./index-DdRjYhiJ.cjs";
|
|
2
|
-
import { i as Declarable, n as Construct } from "./construct-interface-
|
|
3
|
-
import { n as Telemetry } from "./telemetry-
|
|
2
|
+
import { a as HasPublicFace, i as Declarable, n as Construct } from "./construct-interface-DhbaONW2.cjs";
|
|
3
|
+
import { n as Telemetry } from "./telemetry-DjJgtQ_N.cjs";
|
|
4
4
|
import { r as ObjectExpiry } from "./expire-C586zznE.cjs";
|
|
5
|
-
import { f as PatternParams, i as Processor, t as ProcessorBuilder } from "./ProcessorBuilder-
|
|
5
|
+
import { f as PatternParams, i as Processor, t as ProcessorBuilder } from "./ProcessorBuilder-CeEZ2vCx.cjs";
|
|
6
6
|
import { Logger } from "@geekmidas/logger";
|
|
7
7
|
import { Service } from "@geekmidas/services";
|
|
8
8
|
import { ConstructName, Declaration } from "@geekmidas/manifest";
|
|
@@ -158,13 +158,23 @@ export declare class BucketOptionOnOrigin extends Error {
|
|
|
158
158
|
readonly option: string;
|
|
159
159
|
constructor(server: string, origin: string, option: string);
|
|
160
160
|
}
|
|
161
|
+
/**
|
|
162
|
+
* A bucket method called on a file server's client that was handed only its
|
|
163
|
+
* public address — a frontend's plain edge.
|
|
164
|
+
*/
|
|
165
|
+
export declare class FileServerReadOnly extends Error {
|
|
166
|
+
readonly id: string;
|
|
167
|
+
readonly method: string;
|
|
168
|
+
readonly key: string;
|
|
169
|
+
constructor(id: string, method: string, key: string);
|
|
170
|
+
}
|
|
161
171
|
/** A key was asked to be served unsigned, and no open pattern admits it. */
|
|
162
172
|
export declare class NotOpen extends Error {
|
|
163
173
|
readonly key: string;
|
|
164
174
|
readonly open: readonly string[];
|
|
165
175
|
constructor(key: string, open: readonly string[]);
|
|
166
176
|
}
|
|
167
|
-
export declare class FileServer<TName extends string = string, TOpen extends string = never> implements Construct<TName, FileServerClient<TOpen
|
|
177
|
+
export declare class FileServer<TName extends string = string, TOpen extends string = never> implements Construct<TName, FileServerClient<TOpen>>, HasPublicFace {
|
|
168
178
|
private readonly options;
|
|
169
179
|
readonly id: TName;
|
|
170
180
|
readonly service: Service<Uncapitalize<TName>, FileServerClient<TOpen>>;
|
|
@@ -213,18 +223,22 @@ export declare class FileServer<TName extends string = string, TOpen extends str
|
|
|
213
223
|
logger?: Logger;
|
|
214
224
|
}): ProcessorBuilder<TPattern>;
|
|
215
225
|
/**
|
|
216
|
-
* The served surface
|
|
226
|
+
* The served surface: what a site's or a mobile app's plain
|
|
227
|
+
* `.dependsOn([uploads])` points at.
|
|
217
228
|
*
|
|
218
|
-
*
|
|
219
|
-
*
|
|
220
|
-
*
|
|
221
|
-
|
|
229
|
+
* Its address is public, so the frontend is built with it
|
|
230
|
+
* (`VITE_UPLOADS_URL`) — and it is all the frontend gets: no bucket, no
|
|
231
|
+
* key. A backend's plain edge is to the bucket, as it presigns and writes.
|
|
232
|
+
*/
|
|
233
|
+
get publicFace(): Declarable;
|
|
234
|
+
/**
|
|
235
|
+
* Everything: the bucket, its credentials, and the address it is served
|
|
236
|
+
* on.
|
|
222
237
|
*
|
|
223
|
-
*
|
|
224
|
-
*
|
|
225
|
-
*
|
|
226
|
-
*
|
|
227
|
-
* two addresses needs a way to name the second.
|
|
238
|
+
* What a backend's plain edge already is. A frontend asks for it by name —
|
|
239
|
+
* `.dependsOn([uploads.server])` — when its server half uploads or
|
|
240
|
+
* presigns: a full-stack site's, never a bundle's. The bucket's connection
|
|
241
|
+
* is never inlined into a bundle either way; only the served address is.
|
|
228
242
|
*/
|
|
229
243
|
get server(): Declarable;
|
|
230
244
|
/**
|
|
@@ -240,10 +254,14 @@ export declare class FileServer<TName extends string = string, TOpen extends str
|
|
|
240
254
|
/**
|
|
241
255
|
* The bucket's client, with the serving half added.
|
|
242
256
|
*
|
|
243
|
-
* Both
|
|
257
|
+
* Both keys are read here, which is also how the environment reaches a
|
|
244
258
|
* handler: the sniffer records what this reads, so `.dependsOn([uploads])`
|
|
245
|
-
* carries the bucket
|
|
246
|
-
* down beside the handler.
|
|
259
|
+
* carries the bucket's connection and the server's address without either
|
|
260
|
+
* being written down beside the handler.
|
|
261
|
+
*
|
|
262
|
+
* Without the connection — a site's or an app's plain edge, which is to
|
|
263
|
+
* the public face — the client serves and does nothing else: its bucket
|
|
264
|
+
* methods throw {@link FileServerReadOnly}.
|
|
247
265
|
*/
|
|
248
266
|
private connect;
|
|
249
267
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"file-server.d.cts","names":[],"sources":["../src/file-server.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"file-server.d.cts","names":[],"sources":["../src/file-server.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;YA+EY,OAAO,oBAAoB,mBAAmB,cACpD,kBACH,mBAAmB,cAAc,YAC7B,gBAAgB,SACnB;;iBAGa,iBAAiB,sCACzB;;;;;;;;;;EAUR,IAAI,KAAK,OAAO;;;;;;;;;;;EAYhB,QAAQ;;;;;;;;;;;;EAaR,UAAU,aAAa,qBAAqB;;;;;;;;EAS5C,aACC,yBACA,gBAAgB,8BAEhB,WAAW,UAAU,UAAU,oBAC/B,QAAQ,mBAAmB,UAAU,UACrC;;;;;;YAQU,mBACX,yBACA,gBAAgB,gCACb,gBAAgB,mBACjB,iBAAiB,WAAW,WAC5B,cAAc;;qBAGJ,iCAAiC;WAEnC;WACA;WACA;EAHV,YACU,iBACA,gBACA;;iBAUM,kBAAkB;;;;;;;;;;;;;;EAclC,gBAAgB;;;;;;;;;;;EAWhB;;EAEA;;;;;;EAMA,SAAS;;;;;;EAMT;aAAqB;;;;;;;EAMrB,YAAY;;;;;;;;;EASZ,SAAS;;;qBAIG,yBAAyB;WAE3B;WACA;WACA;EAHV,YACU,YACA,iBACA;;;;;;qBAgBE,6BAA6B;WAE/B;WACA;WACA;EAHV,YACU,gBACA,gBACA;;;;;;qBAcE,2BAA2B;WAE7B;WACA;WACA;EAHV,YACU,YACA,gBACA;;;qBA4CE,gBAAgB;WAElB;WACA;EAFV,YACU,aACA;;qBAYE,WACZ,+BACA,yCACY,UAAU,OAAO,iBAAiB,SAAS;mBAgCrC;WA9BT,IAAI;WACJ,SAAS,QAAQ,aAAa,QAAQ,iBAAiB;;WAGvD;mBAEQ;mBACA;;mBAGA;;mBAGA;;;;;mBAMA;;;;;;mBAOA;EAEjB,YACC,IAAI,cAAc,QACD,UAAS,kBAAkB;;;;;;;;;;;;;;;;;;;;;;EAwE7C,QAAQ,iCACP,SAAS,UACT;IAAW,SAAS;MAClB,iBAAiB;;;;;;;;;MAsBhB,cAAc;;;;;;;;;;MAoBd,UAAU;;;;;;;;;;EAkBd,WAAW;;;;;;;;;;;;;UA8CG;;;;;;;;;UAuDN;;;;;;UASA"}
|
package/dist/file-server.d.mts
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { n as StandardSchemaV1 } from "./index-DdRjYhiJ.mjs";
|
|
2
|
-
import { i as Declarable, n as Construct } from "./construct-interface-
|
|
3
|
-
import { n as Telemetry } from "./telemetry-
|
|
2
|
+
import { a as HasPublicFace, i as Declarable, n as Construct } from "./construct-interface-DxfkFxkl.mjs";
|
|
3
|
+
import { n as Telemetry } from "./telemetry-BirKau0X.mjs";
|
|
4
4
|
import { r as ObjectExpiry } from "./expire-C586zznE.mjs";
|
|
5
|
-
import { f as PatternParams, i as Processor, t as ProcessorBuilder } from "./ProcessorBuilder-
|
|
5
|
+
import { f as PatternParams, i as Processor, t as ProcessorBuilder } from "./ProcessorBuilder-CwIlm75W.mjs";
|
|
6
6
|
import { ConstructName, Declaration } from "@geekmidas/manifest";
|
|
7
7
|
import { StorageClient } from "@geekmidas/storage";
|
|
8
8
|
import { Service } from "@geekmidas/services";
|
|
@@ -158,13 +158,23 @@ export declare class BucketOptionOnOrigin extends Error {
|
|
|
158
158
|
readonly option: string;
|
|
159
159
|
constructor(server: string, origin: string, option: string);
|
|
160
160
|
}
|
|
161
|
+
/**
|
|
162
|
+
* A bucket method called on a file server's client that was handed only its
|
|
163
|
+
* public address — a frontend's plain edge.
|
|
164
|
+
*/
|
|
165
|
+
export declare class FileServerReadOnly extends Error {
|
|
166
|
+
readonly id: string;
|
|
167
|
+
readonly method: string;
|
|
168
|
+
readonly key: string;
|
|
169
|
+
constructor(id: string, method: string, key: string);
|
|
170
|
+
}
|
|
161
171
|
/** A key was asked to be served unsigned, and no open pattern admits it. */
|
|
162
172
|
export declare class NotOpen extends Error {
|
|
163
173
|
readonly key: string;
|
|
164
174
|
readonly open: readonly string[];
|
|
165
175
|
constructor(key: string, open: readonly string[]);
|
|
166
176
|
}
|
|
167
|
-
export declare class FileServer<TName extends string = string, TOpen extends string = never> implements Construct<TName, FileServerClient<TOpen
|
|
177
|
+
export declare class FileServer<TName extends string = string, TOpen extends string = never> implements Construct<TName, FileServerClient<TOpen>>, HasPublicFace {
|
|
168
178
|
private readonly options;
|
|
169
179
|
readonly id: TName;
|
|
170
180
|
readonly service: Service<Uncapitalize<TName>, FileServerClient<TOpen>>;
|
|
@@ -213,18 +223,22 @@ export declare class FileServer<TName extends string = string, TOpen extends str
|
|
|
213
223
|
logger?: Logger;
|
|
214
224
|
}): ProcessorBuilder<TPattern>;
|
|
215
225
|
/**
|
|
216
|
-
* The served surface
|
|
226
|
+
* The served surface: what a site's or a mobile app's plain
|
|
227
|
+
* `.dependsOn([uploads])` points at.
|
|
217
228
|
*
|
|
218
|
-
*
|
|
219
|
-
*
|
|
220
|
-
*
|
|
221
|
-
|
|
229
|
+
* Its address is public, so the frontend is built with it
|
|
230
|
+
* (`VITE_UPLOADS_URL`) — and it is all the frontend gets: no bucket, no
|
|
231
|
+
* key. A backend's plain edge is to the bucket, as it presigns and writes.
|
|
232
|
+
*/
|
|
233
|
+
get publicFace(): Declarable;
|
|
234
|
+
/**
|
|
235
|
+
* Everything: the bucket, its credentials, and the address it is served
|
|
236
|
+
* on.
|
|
222
237
|
*
|
|
223
|
-
*
|
|
224
|
-
*
|
|
225
|
-
*
|
|
226
|
-
*
|
|
227
|
-
* two addresses needs a way to name the second.
|
|
238
|
+
* What a backend's plain edge already is. A frontend asks for it by name —
|
|
239
|
+
* `.dependsOn([uploads.server])` — when its server half uploads or
|
|
240
|
+
* presigns: a full-stack site's, never a bundle's. The bucket's connection
|
|
241
|
+
* is never inlined into a bundle either way; only the served address is.
|
|
228
242
|
*/
|
|
229
243
|
get server(): Declarable;
|
|
230
244
|
/**
|
|
@@ -240,10 +254,14 @@ export declare class FileServer<TName extends string = string, TOpen extends str
|
|
|
240
254
|
/**
|
|
241
255
|
* The bucket's client, with the serving half added.
|
|
242
256
|
*
|
|
243
|
-
* Both
|
|
257
|
+
* Both keys are read here, which is also how the environment reaches a
|
|
244
258
|
* handler: the sniffer records what this reads, so `.dependsOn([uploads])`
|
|
245
|
-
* carries the bucket
|
|
246
|
-
* down beside the handler.
|
|
259
|
+
* carries the bucket's connection and the server's address without either
|
|
260
|
+
* being written down beside the handler.
|
|
261
|
+
*
|
|
262
|
+
* Without the connection — a site's or an app's plain edge, which is to
|
|
263
|
+
* the public face — the client serves and does nothing else: its bucket
|
|
264
|
+
* methods throw {@link FileServerReadOnly}.
|
|
247
265
|
*/
|
|
248
266
|
private connect;
|
|
249
267
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"file-server.d.mts","names":[],"sources":["../src/file-server.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"file-server.d.mts","names":[],"sources":["../src/file-server.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;YA+EY,OAAO,oBAAoB,mBAAmB,cACpD,kBACH,mBAAmB,cAAc,YAC7B,gBAAgB,SACnB;;iBAGa,iBAAiB,sCACzB;;;;;;;;;;EAUR,IAAI,KAAK,OAAO;;;;;;;;;;;EAYhB,QAAQ;;;;;;;;;;;;EAaR,UAAU,aAAa,qBAAqB;;;;;;;;EAS5C,aACC,yBACA,gBAAgB,8BAEhB,WAAW,UAAU,UAAU,oBAC/B,QAAQ,mBAAmB,UAAU,UACrC;;;;;;YAQU,mBACX,yBACA,gBAAgB,gCACb,gBAAgB,mBACjB,iBAAiB,WAAW,WAC5B,cAAc;;qBAGJ,iCAAiC;WAEnC;WACA;WACA;EAHV,YACU,iBACA,gBACA;;iBAUM,kBAAkB;;;;;;;;;;;;;;EAclC,gBAAgB;;;;;;;;;;;EAWhB;;EAEA;;;;;;EAMA,SAAS;;;;;;EAMT;aAAqB;;;;;;;EAMrB,YAAY;;;;;;;;;EASZ,SAAS;;;qBAIG,yBAAyB;WAE3B;WACA;WACA;EAHV,YACU,YACA,iBACA;;;;;;qBAgBE,6BAA6B;WAE/B;WACA;WACA;EAHV,YACU,gBACA,gBACA;;;;;;qBAcE,2BAA2B;WAE7B;WACA;WACA;EAHV,YACU,YACA,gBACA;;;qBA4CE,gBAAgB;WAElB;WACA;EAFV,YACU,aACA;;qBAYE,WACZ,+BACA,yCACY,UAAU,OAAO,iBAAiB,SAAS;mBAgCrC;WA9BT,IAAI;WACJ,SAAS,QAAQ,aAAa,QAAQ,iBAAiB;;WAGvD;mBAEQ;mBACA;;mBAGA;;mBAGA;;;;;mBAMA;;;;;;mBAOA;EAEjB,YACC,IAAI,cAAc,QACD,UAAS,kBAAkB;;;;;;;;;;;;;;;;;;;;;;EAwE7C,QAAQ,iCACP,SAAS,UACT;IAAW,SAAS;MAClB,iBAAiB;;;;;;;;;MAsBhB,cAAc;;;;;;;;;;MAoBd,UAAU;;;;;;;;;;EAkBd,WAAW;;;;;;;;;;;;;UA8CG;;;;;;;;;UAuDN;;;;;;UASA"}
|
package/dist/file-server.mjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { r as expiryDays } from "./expire-CpzUAfr9.mjs";
|
|
2
2
|
import { a as parsePattern, o as ProcessorBuilder, r as fillPattern } from "./pattern-C1CEcglD.mjs";
|
|
3
|
-
import { DERIVED_PREFIX, canonicalId, provideKey, serviceKey } from "@geekmidas/manifest";
|
|
3
|
+
import { DERIVED_PREFIX, canonicalId, fileServerSurfaceId, provideKey, providedKeyFor, serviceKey } from "@geekmidas/manifest";
|
|
4
4
|
import { createStorageClient } from "@geekmidas/storage";
|
|
5
5
|
import { DEFAULT_LOGGER } from "@geekmidas/logger/console";
|
|
6
6
|
//#region src/file-server.ts
|
|
@@ -46,6 +46,49 @@ var BucketOptionOnOrigin = class extends Error {
|
|
|
46
46
|
this.name = "BucketOptionOnOrigin";
|
|
47
47
|
}
|
|
48
48
|
};
|
|
49
|
+
/**
|
|
50
|
+
* A bucket method called on a file server's client that was handed only its
|
|
51
|
+
* public address — a frontend's plain edge.
|
|
52
|
+
*/
|
|
53
|
+
var FileServerReadOnly = class extends Error {
|
|
54
|
+
id;
|
|
55
|
+
method;
|
|
56
|
+
key;
|
|
57
|
+
constructor(id, method, key) {
|
|
58
|
+
super(`'${id}' was reached through its public address only, so it serves and cannot ${method}(): ${key} is not in this process's environment. A site or app whose server half writes or presigns depends on '${id}'.server instead — .dependsOn([${id.charAt(0).toLowerCase()}${id.slice(1)}.server]).`);
|
|
59
|
+
this.id = id;
|
|
60
|
+
this.method = method;
|
|
61
|
+
this.key = key;
|
|
62
|
+
this.name = "FileServerReadOnly";
|
|
63
|
+
}
|
|
64
|
+
};
|
|
65
|
+
/** Names asked of any object, which a read-only client must not answer. */
|
|
66
|
+
const INTROSPECTED = /* @__PURE__ */ new Set([
|
|
67
|
+
"then",
|
|
68
|
+
"toJSON",
|
|
69
|
+
"constructor",
|
|
70
|
+
"asymmetricMatch",
|
|
71
|
+
"$$typeof",
|
|
72
|
+
"nodeType",
|
|
73
|
+
"inspect"
|
|
74
|
+
]);
|
|
75
|
+
/**
|
|
76
|
+
* The bucket half of a client that has no bucket: every method throws
|
|
77
|
+
* {@link FileServerReadOnly}, naming itself.
|
|
78
|
+
*
|
|
79
|
+
* A proxy rather than a list of stubs, so a method the storage client grows
|
|
80
|
+
* later refuses the same way. What a runtime asks of any object is left
|
|
81
|
+
* alone: `then`, because a client is resolved from a promise, and the names a
|
|
82
|
+
* serialiser or a test's printer looks for.
|
|
83
|
+
*/
|
|
84
|
+
function readOnlyStorage(id, key) {
|
|
85
|
+
return new Proxy({}, { get(_target, property) {
|
|
86
|
+
if (typeof property !== "string" || INTROSPECTED.has(property)) return;
|
|
87
|
+
return () => {
|
|
88
|
+
throw new FileServerReadOnly(id, property, key);
|
|
89
|
+
};
|
|
90
|
+
} });
|
|
91
|
+
}
|
|
49
92
|
/** A key was asked to be served unsigned, and no open pattern admits it. */
|
|
50
93
|
var NotOpen = class extends Error {
|
|
51
94
|
key;
|
|
@@ -91,10 +134,10 @@ var FileServer = class {
|
|
|
91
134
|
if (options.origin && options.expire) throw new BucketOptionOnOrigin(canonical, originId, "expire");
|
|
92
135
|
this.expire = expiryDays(canonical, options.expire);
|
|
93
136
|
this.derivedDays = options.derived ? expiryDays(canonical, { [DERIVED_PREFIX]: options.derived })?.[DERIVED_PREFIX] : void 0;
|
|
94
|
-
this.surfaceId =
|
|
137
|
+
this.surfaceId = fileServerSurfaceId(canonical);
|
|
95
138
|
this.keys = {
|
|
96
|
-
origin: provideKey(originId, "
|
|
97
|
-
server:
|
|
139
|
+
origin: provideKey(originId, "connectionString"),
|
|
140
|
+
server: providedKeyFor(this.surfaceId, "file-server", "url")
|
|
98
141
|
};
|
|
99
142
|
this.service = {
|
|
100
143
|
serviceName: serviceKey(canonical),
|
|
@@ -144,20 +187,14 @@ var FileServer = class {
|
|
|
144
187
|
});
|
|
145
188
|
}
|
|
146
189
|
/**
|
|
147
|
-
* The served surface
|
|
148
|
-
*
|
|
149
|
-
* Depending on the `FileServer` itself points at the **bucket** — its
|
|
150
|
-
* canonical node — which is right for a handler: it presigns and writes. But
|
|
151
|
-
* a bucket's URL is never public, so a site depending on it gets nothing
|
|
152
|
-
* inlined, which is correct and also useless.
|
|
190
|
+
* The served surface: what a site's or a mobile app's plain
|
|
191
|
+
* `.dependsOn([uploads])` points at.
|
|
153
192
|
*
|
|
154
|
-
*
|
|
155
|
-
*
|
|
156
|
-
*
|
|
157
|
-
* `database.reader()` uses, and for the same reason — one construct owning
|
|
158
|
-
* two addresses needs a way to name the second.
|
|
193
|
+
* Its address is public, so the frontend is built with it
|
|
194
|
+
* (`VITE_UPLOADS_URL`) — and it is all the frontend gets: no bucket, no
|
|
195
|
+
* key. A backend's plain edge is to the bucket, as it presigns and writes.
|
|
159
196
|
*/
|
|
160
|
-
get
|
|
197
|
+
get publicFace() {
|
|
161
198
|
const surface = this.declare().find((declaration) => declaration.id === this.surfaceId);
|
|
162
199
|
return {
|
|
163
200
|
id: this.surfaceId,
|
|
@@ -165,6 +202,23 @@ var FileServer = class {
|
|
|
165
202
|
};
|
|
166
203
|
}
|
|
167
204
|
/**
|
|
205
|
+
* Everything: the bucket, its credentials, and the address it is served
|
|
206
|
+
* on.
|
|
207
|
+
*
|
|
208
|
+
* What a backend's plain edge already is. A frontend asks for it by name —
|
|
209
|
+
* `.dependsOn([uploads.server])` — when its server half uploads or
|
|
210
|
+
* presigns: a full-stack site's, never a bundle's. The bucket's connection
|
|
211
|
+
* is never inlined into a bundle either way; only the served address is.
|
|
212
|
+
*/
|
|
213
|
+
get server() {
|
|
214
|
+
const originId = this.options.origin?.id ?? this.id;
|
|
215
|
+
const declarations = this.options.origin ? this.options.origin.declare() : this.declare();
|
|
216
|
+
return {
|
|
217
|
+
id: originId,
|
|
218
|
+
declare: () => declarations
|
|
219
|
+
};
|
|
220
|
+
}
|
|
221
|
+
/**
|
|
168
222
|
* The bucket and the surface over it — or just the surface, when the bucket
|
|
169
223
|
* was declared elsewhere.
|
|
170
224
|
*
|
|
@@ -197,17 +251,21 @@ var FileServer = class {
|
|
|
197
251
|
/**
|
|
198
252
|
* The bucket's client, with the serving half added.
|
|
199
253
|
*
|
|
200
|
-
* Both
|
|
254
|
+
* Both keys are read here, which is also how the environment reaches a
|
|
201
255
|
* handler: the sniffer records what this reads, so `.dependsOn([uploads])`
|
|
202
|
-
* carries the bucket
|
|
203
|
-
* down beside the handler.
|
|
256
|
+
* carries the bucket's connection and the server's address without either
|
|
257
|
+
* being written down beside the handler.
|
|
258
|
+
*
|
|
259
|
+
* Without the connection — a site's or an app's plain edge, which is to
|
|
260
|
+
* the public face — the client serves and does nothing else: its bucket
|
|
261
|
+
* methods throw {@link FileServerReadOnly}.
|
|
204
262
|
*/
|
|
205
263
|
async connect(options) {
|
|
206
264
|
const { origin, server } = options.envParser.create((get) => ({
|
|
207
|
-
origin: get(this.keys.origin).string(),
|
|
265
|
+
origin: get(this.keys.origin).string().optional(),
|
|
208
266
|
server: get(this.keys.server).string()
|
|
209
267
|
})).parse();
|
|
210
|
-
const storage = createStorageClient(origin);
|
|
268
|
+
const storage = origin ? createStorageClient(origin) : readOnlyStorage(this.id, this.keys.origin);
|
|
211
269
|
const base = server.replace(/\/+$/, "");
|
|
212
270
|
const serve = (key) => {
|
|
213
271
|
if (!this.serves(key)) throw new NotOpen(key, this.open);
|
|
@@ -269,6 +327,6 @@ function globToRegExp(pattern) {
|
|
|
269
327
|
return new RegExp(`^${source}$`);
|
|
270
328
|
}
|
|
271
329
|
//#endregion
|
|
272
|
-
export { BucketOptionOnOrigin, FileServer, ImmutableNotOpen, NotOpen, ProcessorNotOnThisServer };
|
|
330
|
+
export { BucketOptionOnOrigin, FileServer, FileServerReadOnly, ImmutableNotOpen, NotOpen, ProcessorNotOnThisServer };
|
|
273
331
|
|
|
274
332
|
//# sourceMappingURL=file-server.mjs.map
|