foldkit-media 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (73) hide show
  1. package/README.md +167 -66
  2. package/client.d.ts +2 -2
  3. package/dist/{asset-BNQ_j5tO.d.mts → asset-BLo8VWmd.d.mts} +32 -5
  4. package/dist/asset-BLo8VWmd.d.mts.map +1 -0
  5. package/dist/browser/index.d.mts +86 -4
  6. package/dist/browser/index.d.mts.map +1 -1
  7. package/dist/browser/index.mjs +88 -7
  8. package/dist/browser/index.mjs.map +1 -1
  9. package/dist/cloudflare/index.d.mts +13 -9
  10. package/dist/cloudflare/index.d.mts.map +1 -1
  11. package/dist/cloudflare/index.mjs +28 -12
  12. package/dist/cloudflare/index.mjs.map +1 -1
  13. package/dist/{describe-DdYvLhMY.d.mts → describe-BOgc0xbR.d.mts} +2 -6
  14. package/dist/describe-BOgc0xbR.d.mts.map +1 -0
  15. package/dist/{describe-Cqr63Gxa.mjs → describe-C6sWA_8p.mjs} +10 -10
  16. package/dist/describe-C6sWA_8p.mjs.map +1 -0
  17. package/dist/{errors-qETj7Pgi.mjs → errors-BhEgXJ4m.mjs} +2 -3
  18. package/dist/{errors-qETj7Pgi.mjs.map → errors-BhEgXJ4m.mjs.map} +1 -1
  19. package/dist/{format-BmfnR4jg.mjs → format-BCRTFU9j.mjs} +2 -3
  20. package/dist/{format-BmfnR4jg.mjs.map → format-BCRTFU9j.mjs.map} +1 -1
  21. package/dist/{icon-CowP8fQ0.mjs → icon-0A2dBtqj.mjs} +3 -4
  22. package/dist/{icon-CowP8fQ0.mjs.map → icon-0A2dBtqj.mjs.map} +1 -1
  23. package/dist/{icon-ClqtprHT.d.mts → icon-BGtxExTN.d.mts} +1 -2
  24. package/dist/{icon-ClqtprHT.d.mts.map → icon-BGtxExTN.d.mts.map} +1 -1
  25. package/dist/icons/index.d.mts +1 -3
  26. package/dist/icons/index.d.mts.map +1 -1
  27. package/dist/icons/index.mjs +2 -3
  28. package/dist/index.d.mts +13 -15
  29. package/dist/index.d.mts.map +1 -1
  30. package/dist/index.mjs +19 -21
  31. package/dist/index.mjs.map +1 -1
  32. package/dist/{limits-B6C9OOLl.mjs → limits-B4hHpyfE.mjs} +2 -3
  33. package/dist/{limits-B6C9OOLl.mjs.map → limits-B4hHpyfE.mjs.map} +1 -1
  34. package/dist/{provider-DztvQjOr.d.mts → provider-CB0nqu0m.d.mts} +21 -16
  35. package/dist/provider-CB0nqu0m.d.mts.map +1 -0
  36. package/dist/{rolldown-runtime-8H4AJuhK.mjs → rolldown-runtime-BJohB4LM.mjs} +1 -2
  37. package/dist/server/index.d.mts +34 -27
  38. package/dist/server/index.d.mts.map +1 -1
  39. package/dist/server/index.mjs +174 -8
  40. package/dist/server/index.mjs.map +1 -1
  41. package/dist/{services-BeakQl7F.mjs → services-7B4hsQM7.mjs} +3 -4
  42. package/dist/{services-BeakQl7F.mjs.map → services-7B4hsQM7.mjs.map} +1 -1
  43. package/dist/{services-Ck-7dhIP.d.mts → services-BZoK2VOY.d.mts} +3 -5
  44. package/dist/services-BZoK2VOY.d.mts.map +1 -0
  45. package/dist/sharp/index.d.mts +2 -4
  46. package/dist/sharp/index.d.mts.map +1 -1
  47. package/dist/sharp/index.mjs +5 -6
  48. package/dist/{upload-C5YM5jZR.mjs → stores-CxraN3kt.mjs} +128 -228
  49. package/dist/stores-CxraN3kt.mjs.map +1 -0
  50. package/dist/unpic/index.d.mts +2 -4
  51. package/dist/unpic/index.d.mts.map +1 -1
  52. package/dist/unpic/index.mjs +2 -3
  53. package/dist/{upload-C4_inwfv.d.mts → upload-lVLMRJoC.d.mts} +53 -24
  54. package/dist/upload-lVLMRJoC.d.mts.map +1 -0
  55. package/dist/{variant-BOg1M0Wj.d.mts → variant-B-vyMmFB.d.mts} +2 -3
  56. package/dist/{variant-BOg1M0Wj.d.mts.map → variant-B-vyMmFB.d.mts.map} +1 -1
  57. package/dist/vite/index.d.mts +1 -5
  58. package/dist/vite/index.d.mts.map +1 -1
  59. package/dist/vite/index.mjs +7 -9
  60. package/dist/vite/index.mjs.map +1 -1
  61. package/dist/{widths-BEa9odY6.mjs → widths-qp3jshiF.mjs} +3 -4
  62. package/dist/{widths-BEa9odY6.mjs.map → widths-qp3jshiF.mjs.map} +1 -1
  63. package/dist/{widths-Cg7-x89y.d.mts → widths-upkgLdek.d.mts} +1 -3
  64. package/dist/widths-upkgLdek.d.mts.map +1 -0
  65. package/package.json +6 -6
  66. package/dist/asset-BNQ_j5tO.d.mts.map +0 -1
  67. package/dist/describe-Cqr63Gxa.mjs.map +0 -1
  68. package/dist/describe-DdYvLhMY.d.mts.map +0 -1
  69. package/dist/provider-DztvQjOr.d.mts.map +0 -1
  70. package/dist/services-Ck-7dhIP.d.mts.map +0 -1
  71. package/dist/upload-C4_inwfv.d.mts.map +0 -1
  72. package/dist/upload-C5YM5jZR.mjs.map +0 -1
  73. package/dist/widths-Cg7-x89y.d.mts.map +0 -1
@@ -1,29 +1,13 @@
1
- import { n as mimeType, t as Format } from "./format-BmfnR4jg.mjs";
2
- import { d as revisionOf, f as standard, i as ImageAsset, l as Spelling, n as describe, o as ContentHash, s as PATH, u as respell } from "./describe-Cqr63Gxa.mjs";
3
- import { t as nonNegativeInteger } from "./limits-B6C9OOLl.mjs";
4
- import { n as OriginalTooLarge, t as OriginalNotFound } from "./errors-qETj7Pgi.mjs";
5
- import { n as Transformer, r as Variants, t as Originals } from "./services-BeakQl7F.mjs";
6
- import { Cache, Context, Duration, Effect, Layer, Match, Option, Schema, Stream } from "effect";
7
- import { HttpApi, HttpApiBuilder, HttpApiEndpoint, HttpApiGroup, HttpApiSchema } from "effect/http-api";
8
- import { HttpRouter, HttpServer, HttpServerResponse } from "effect/http";
1
+ import { n as mimeType, t as Format } from "./format-BCRTFU9j.mjs";
2
+ import { a as ImageAsset, i as HashedAsset, n as describe } from "./describe-C6sWA_8p.mjs";
3
+ import { t as nonNegativeInteger } from "./limits-B4hHpyfE.mjs";
4
+ import { n as OriginalTooLarge, t as OriginalNotFound } from "./errors-BhEgXJ4m.mjs";
5
+ import { r as Variants, t as Originals } from "./services-7B4hsQM7.mjs";
6
+ import { Context, Duration, Effect, Layer, Match, Option, Schema, Stream } from "effect";
7
+ import { HttpApi, HttpApiBuilder, HttpApiEndpoint, HttpApiGroup } from "effect/http-api";
8
+ import { HttpServerResponse } from "effect/http";
9
9
  import { KeyValueStore, RateLimiter } from "effect/persistence";
10
- //#region src/server/api.ts
11
- /**
12
- * The media server's HTTP API: one route, a variant of an original named by
13
- * its content hash. The route takes its params as text, and the handler
14
- * decodes them with the space's Schema, the one `Provider.hosted` encodes
15
- * with, so a variant outside the space is refused before any work, and that
16
- * refusal, like every answer, carries the headers `headersFor` decides.
17
- */
18
- const MediaApi = HttpApi.make("foldkit-media").add(HttpApiGroup.make("images").add(HttpApiEndpoint.get("variant", PATH, {
19
- params: {
20
- hash: Schema.String,
21
- variant: Schema.String
22
- },
23
- success: HttpApiSchema.StreamUint8Array()
24
- })));
25
- //#endregion
26
- //#region src/server/headers.ts
10
+ // src/server/headers.ts
27
11
  /** Where a variant came from: the edge's cache, the server's store, or made for this request. */
28
12
  const From = Schema.Literals([
29
13
  "edge",
@@ -67,8 +51,10 @@ const Answer = Schema.TaggedUnion({
67
51
  Exhausted: {},
68
52
  /** An upload kept; its facts are the body. */
69
53
  Uploaded: {},
70
- /** The upload policy refused the request. */
54
+ /** The upload policy refused who is asking. */
71
55
  Forbidden: {},
56
+ /** The upload policy could not tell who is asking: an untrusted origin, a session ended. */
57
+ Unauthenticated: {},
72
58
  /** An upload that is not an image the server reads. */
73
59
  Unsupported: {},
74
60
  /** The facts of an image named by URL; the facts are the body. */
@@ -96,14 +82,15 @@ const statusOf = Answer.match({
96
82
  Exhausted: () => 503,
97
83
  Uploaded: () => 201,
98
84
  Forbidden: () => 403,
85
+ Unauthenticated: () => 401,
99
86
  Unsupported: () => 415,
100
87
  Described: () => 200,
101
88
  Unavailable: () => 422
102
89
  });
103
90
  /**
104
91
  * Every response's headers, decided in one place, so the server, the edge
105
- * and a static host cannot disagree. A variant's URL names its bytes, so it
106
- * is kept for a year. A refusal of a variant is not: another release, or the
92
+ * and a static host cannot disagree. A variant's URL names the variant, and
93
+ * a new way of making it is a new revision, so it is kept for a year. A refusal of a variant is not: another release, or the
107
94
  * same one configured otherwise, may answer it, so only a CDN keeps it,
108
95
  * briefly; a failure is never kept. Every image may be read by a canvas on
109
96
  * another origin, and its type is never sniffed.
@@ -142,6 +129,7 @@ const headersFor = (answer) => ({
142
129
  }),
143
130
  Uploaded: () => ({ "cache-control": "no-store" }),
144
131
  Forbidden: () => ({ "cache-control": "no-store" }),
132
+ Unauthenticated: () => ({ "cache-control": "no-store" }),
145
133
  Unsupported: () => ({ "cache-control": "no-store" }),
146
134
  Described: () => ({ "cache-control": "no-store" }),
147
135
  Unavailable: () => ({ "cache-control": "no-store" })
@@ -149,8 +137,7 @@ const headersFor = (answer) => ({
149
137
  });
150
138
  /** Whether an `If-None-Match` names `etag` (weakly, as a GET compares, or `*`). */
151
139
  const matches = (ifNoneMatch, etag) => ifNoneMatch !== void 0 && ifNoneMatch.split(",").map((tag) => tag.trim().replace(/^W\//, "")).some((tag) => tag === "*" || tag === etag);
152
- //#endregion
153
- //#region src/server/admission.ts
140
+ // src/server/admission.ts
154
141
  /** The client has made too many variants lately; it may try again after `retryAfterSeconds`. */
155
142
  var RateLimited = class extends Schema.TaggedError()("RateLimited", { retryAfterSeconds: Schema.Number }, { httpApiStatus: 429 }) {};
156
143
  /**
@@ -179,184 +166,7 @@ const admissionRateLimiter = (options) => Layer.effect(Admission, Effect.gen(fun
179
166
  RateLimitStoreError: () => Effect.logWarning("Media: the rate limiter failed; admitting", error)
180
167
  }))) };
181
168
  }));
182
- //#endregion
183
- //#region src/server/handlers.ts
184
- /** The Cloudflare Images binding reads at most 20 MB; a store's own limit may be lower. */
185
- const DEFAULT_MAX_BYTES$2 = 20971520;
186
- const defaultClientOf = (request) => request.headers["cf-connecting-ip"] ?? Option.getOrElse(request.remoteAddress, () => "unknown");
187
- const optionsOf = (answer) => ({
188
- status: statusOf(answer),
189
- headers: headersFor(answer)
190
- });
191
- const served = (etag, from, encoded) => HttpServerResponse.uint8Array(encoded.bytes, {
192
- ...optionsOf(Answer.cases.Variant.make({
193
- etag,
194
- from
195
- })),
196
- contentType: encoded.contentType
197
- });
198
- const notModified = (etag) => HttpServerResponse.empty(optionsOf(Answer.cases.NotModified.make({ etag })));
199
- const refused$1 = (answer) => HttpServerResponse.jsonUnsafe({ error: answer._tag }, optionsOf(answer));
200
- /**
201
- * The handlers of `MediaApi`'s one route. The path is decoded against the
202
- * space; a variant kept is served as kept, and one the request already holds
203
- * (`If-None-Match`) is a 304 before the store is read; otherwise the original
204
- * is read, transformed, kept and served. Every answer, a refusal included,
205
- * goes through `headersFor`, and a failure is never the original in the
206
- * variant's place.
207
- */
208
- const handlers = (options = {}) => {
209
- const { space = standard, maxBytes: requestedMaxBytes = DEFAULT_MAX_BYTES$2, coalesce = false, clientOf = defaultClientOf } = options;
210
- const maxBytes = nonNegativeInteger("maxBytes", requestedMaxBytes);
211
- const decodeHash = Schema.decodeUnknownOption(ContentHash);
212
- const decodeVariant = Schema.decodeUnknownOption(space.schema);
213
- const isSpelling = Schema.is(Spelling);
214
- const spell = Schema.encodeSync(space.schema);
215
- return HttpApiBuilder.group(MediaApi, "images", (group) => Effect.gen(function* () {
216
- const originals = yield* Originals;
217
- const transformer = yield* Transformer;
218
- const variants = yield* Variants;
219
- const admit = Option.match(yield* Effect.serviceOption(Admission), {
220
- onNone: () => (_client) => Effect.void,
221
- onSome: (admission) => admission.admit
222
- });
223
- const make = Effect.fn("Media.make")(function* (hash, variant) {
224
- const original = yield* originals.get(hash);
225
- if (original.size > maxBytes) return yield* new OriginalTooLarge({
226
- size: original.size,
227
- limit: maxBytes,
228
- unit: "bytes"
229
- });
230
- return yield* transformer.transform(original, variant);
231
- });
232
- const makeAndKeep = (key, hash, variant) => make(hash, variant).pipe(Effect.tap((made) => variants.put(key, made)));
233
- const shared = yield* Cache.make({
234
- capacity: 1e4,
235
- timeToLive: 0,
236
- lookup: (key) => {
237
- const at = key.indexOf("/");
238
- const variant = Schema.decodeUnknownSync(space.schema)(key.slice(at + 1));
239
- return makeAndKeep(key, key.slice(0, at), variant);
240
- }
241
- });
242
- const serve = Effect.fn("Media.serve")(function* (hash, variant, ifNoneMatch, client) {
243
- const key = `${hash}/${spell(variant)}`;
244
- const etag = `"${key}"`;
245
- if (matches(ifNoneMatch, etag)) return notModified(etag);
246
- return yield* Option.match(yield* variants.get(key), {
247
- onSome: ({ encoded, from }) => Effect.succeed(served(etag, from, encoded)),
248
- onNone: () => admit(client).pipe(Effect.andThen(coalesce ? Cache.get(shared, key) : makeAndKeep(key, hash, variant)), Effect.map((made) => served(etag, "made", made)), Effect.catchTags({
249
- OriginalNotFound: () => Effect.succeed(refused$1(Answer.cases.NotFound.make({}))),
250
- OriginalTooLarge: () => Effect.succeed(refused$1(Answer.cases.TooLarge.make({}))),
251
- TransformFailed: () => Effect.succeed(refused$1(Answer.cases.Failed.make({}))),
252
- QuotaExhausted: () => Effect.succeed(refused$1(Answer.cases.Exhausted.make({}))),
253
- RateLimited: ({ retryAfterSeconds }) => Effect.succeed(refused$1(Answer.cases.RateLimited.make({ retryAfterSeconds })))
254
- }))
255
- });
256
- });
257
- /**
258
- * A spelling of the grammar this space does not read. An earlier revision of a variant
259
- * it makes is served while kept and else sent to its current URL; anything else (a later
260
- * revision, a width another release offers) is `Unoffered`, kept briefly.
261
- */
262
- const elsewhere = (hash, spelling, ifNoneMatch) => {
263
- const current = respell(spelling, space.revision);
264
- if (revisionOf(spelling) >= space.revision || Option.isNone(decodeVariant(current))) return Effect.succeed(refused$1(Answer.cases.Unoffered.make({})));
265
- const key = `${hash}/${spelling}`;
266
- const etag = `"${key}"`;
267
- if (matches(ifNoneMatch, etag)) return Effect.succeed(notModified(etag));
268
- return Effect.map(variants.get(key), (kept) => Option.match(kept, {
269
- onSome: ({ encoded, from }) => served(etag, from, encoded),
270
- onNone: () => refused$1(Answer.cases.Moved.make({ location: PATH.replace(":hash", hash).replace(":variant", current) }))
271
- }));
272
- };
273
- return group.handle("variant", ({ params, request }) => Option.match(Option.all([decodeHash(params.hash), decodeVariant(params.variant)]), {
274
- onNone: () => Option.match(decodeHash(params.hash), {
275
- onNone: () => Effect.succeed(refused$1(Answer.cases.Malformed.make({}))),
276
- onSome: (hash) => isSpelling(params.variant) ? elsewhere(hash, params.variant, request.headers["if-none-match"]) : Effect.succeed(refused$1(Answer.cases.Malformed.make({})))
277
- }),
278
- onSome: ([hash, variant]) => serve(hash, variant, request.headers["if-none-match"], clientOf(request))
279
- }));
280
- }));
281
- };
282
- /**
283
- * The media server as an Effect HTTP application: its route registered with
284
- * the `HttpRouter`, needing `Originals`, `Transformer` and `Variants`.
285
- */
286
- const layer = (options = {}) => HttpApiBuilder.layer(MediaApi).pipe(Layer.provide(handlers({
287
- coalesce: true,
288
- ...options
289
- })));
290
- /**
291
- * A Worker's fetch handler over `app`, built from each environment's bindings
292
- * once and kept, since a Worker hands every request the same bindings. A
293
- * layer that fails to build answers a 500.
294
- */
295
- const fetchOf = (app) => {
296
- const built = /* @__PURE__ */ new WeakMap();
297
- return (request, env) => {
298
- const known = built.get(env);
299
- if (known !== void 0) return known(request);
300
- const { handler } = HttpRouter.toWebHandler(app(env).pipe(Layer.provide(HttpServer.layerServices)), { disableLogger: true });
301
- const answer = (incoming) => handler(incoming);
302
- built.set(env, answer);
303
- return answer(request);
304
- };
305
- };
306
- /**
307
- * The media server as a Worker's fetch handler, its services from each
308
- * environment's bindings. It answers its own route and 404s anything else, so
309
- * route to it by path (`/_image/`).
310
- */
311
- const serveFetch = (options) => fetchOf((env) => layer({
312
- coalesce: false,
313
- ...options
314
- }).pipe(Layer.provide(options.layer(env))));
315
- //#endregion
316
- //#region src/server/stores.ts
317
- const mediaTypeOf = (key) => {
318
- const extension = key.slice(key.lastIndexOf(".") + 1);
319
- return Schema.is(Format)(extension) ? mimeType(extension) : "application/octet-stream";
320
- };
321
- /**
322
- * `Variants` over a `KeyValueStore`. A variant's bytes are its value and its
323
- * media type is its key's extension, so nothing else is stored. A store that
324
- * fails is logged and read as a miss, or a write it drops: a variant is a
325
- * cache, and the request is answered either way.
326
- */
327
- const makeVariants = (store) => ({
328
- get: (key) => store.getUint8Array(key).pipe(Effect.map((bytes) => Option.map(Option.fromNullishOr(bytes), (value) => ({
329
- encoded: {
330
- bytes: new Uint8Array(value),
331
- contentType: mediaTypeOf(key)
332
- },
333
- from: "store"
334
- }))), Effect.catch((error) => Effect.logWarning("Media: the variant store failed a read", error).pipe(Effect.as(Option.none())))),
335
- put: (key, encoded) => store.set(key, encoded.bytes).pipe(Effect.catch((error) => Effect.logWarning("Media: the variant store failed a write", error)))
336
- });
337
- /**
338
- * Variants kept in the application's `KeyValueStore`, under `prefix`:
339
- * `KeyValueStore.layerMemory` for tests, `layerFileSystem` on a disk,
340
- * `layerSql` over SQLite or D1.
341
- */
342
- const variantsKeyValueStore = (options = {}) => Layer.effect(Variants, Effect.gen(function* () {
343
- const store = yield* KeyValueStore.KeyValueStore;
344
- return makeVariants(KeyValueStore.prefix(store, options.prefix ?? "variants/"));
345
- }));
346
- /**
347
- * Originals in the application's `KeyValueStore`, each under its content
348
- * hash after `prefix`. A store that fails is a defect, not a missing
349
- * original: the original is the data, and a 404 would say it is gone.
350
- */
351
- const originalsKeyValueStore = (options = {}) => Layer.effect(Originals, Effect.gen(function* () {
352
- const store = KeyValueStore.prefix(yield* KeyValueStore.KeyValueStore, options.prefix ?? "");
353
- return { get: (hash) => store.getUint8Array(hash).pipe(Effect.orDie, Effect.flatMap((bytes) => bytes === void 0 ? Effect.fail(new OriginalNotFound({ hash })) : Effect.succeed({
354
- body: new Blob([new Uint8Array(bytes)]).stream(),
355
- size: bytes.byteLength
356
- }))) };
357
- }));
358
- //#endregion
359
- //#region src/server/facts.ts
169
+ // src/server/facts.ts
360
170
  /** No facts could be read for the image at `url`; `reason` says why, for the build's report. */
361
171
  var FactsUnavailable = class extends Schema.TaggedError()("FactsUnavailable", {
362
172
  url: Schema.String,
@@ -463,8 +273,7 @@ const factsOf = (url, options) => {
463
273
  return asset;
464
274
  });
465
275
  };
466
- //#endregion
467
- //#region src/server/upload.ts
276
+ // src/server/upload.ts
468
277
  /**
469
278
  * Where an original enters: `POST /_media/upload` takes an image's bytes,
470
279
  * reads its facts (`describe`, through the `Inspector`), keeps the bytes
@@ -477,15 +286,34 @@ const factsOf = (url, options) => {
477
286
  * its services: an upload, and the facts of an image named by URL.
478
287
  */
479
288
  const UploadApi = HttpApi.make("foldkit-media-upload").add(HttpApiGroup.make("uploads").add(HttpApiEndpoint.post("upload", "/_media/upload"), HttpApiEndpoint.get("facts", "/_media/facts")));
480
- /** Keeps an uploaded original under its content hash: the one writer of what `Originals` reads. */
289
+ /**
290
+ * Keeps an uploaded original under its content hash, and the facts the
291
+ * server read from it beside it: the one writer of what `Originals` and
292
+ * `StoredFacts` read. The bytes are kept first, so kept facts mean kept bytes.
293
+ */
481
294
  var Uploads = class extends Context.Service()("foldkit-media/Uploads") {};
295
+ /**
296
+ * The facts the upload route read from an original, by its hash: what an
297
+ * application stores, rather than facts a client sends back. None for a hash
298
+ * nobody uploaded, or one kept before facts were.
299
+ */
300
+ var StoredFacts = class extends Context.Service()("foldkit-media/StoredFacts") {};
301
+ /** Where an upload's facts are kept, beside its bytes under the same prefix. */
302
+ const factsKey = (hash) => `facts/${hash}`;
303
+ const encodeFacts = (facts) => JSON.stringify(Schema.encodeSync(ImageAsset)(facts));
304
+ const decodeFacts = (stored) => Schema.decodeUnknownSync(Schema.fromJsonString(HashedAsset))(stored);
482
305
  /** The request may not upload. Why stays with the policy: the answer says only no. */
483
306
  var UploadForbidden = class extends Schema.TaggedError()("UploadForbidden", {}, { httpApiStatus: 403 }) {};
484
307
  /**
485
- * Who may upload, asked of every request before its body is read. The route
486
- * has no default: an application that serves uploads says who may (a
487
- * `foldkit-guard` policy over the session, an API key), so a server is never
488
- * open to every upload by omission.
308
+ * The policy could not tell who is asking (an untrusted origin, a session
309
+ * that ended), so the client should sign in again rather than give up.
310
+ */
311
+ var UploadUnauthenticated = class extends Schema.TaggedError()("UploadUnauthenticated", {}, { httpApiStatus: 401 }) {};
312
+ /**
313
+ * Who may upload, asked of every request before its body is read, with the
314
+ * route it is for. The route has no default: an application that serves
315
+ * uploads says who may (`foldkit-guard/media` over the session, a secret), so
316
+ * a server is never open to every upload by omission.
489
317
  */
490
318
  var UploadPolicy = class extends Context.Service()("foldkit-media/UploadPolicy") {};
491
319
  /** The Cloudflare Images binding reads at most 20 MB; so does the variant server by default. */
@@ -537,28 +365,31 @@ const uploadHandlers = (options = {}) => {
537
365
  allow: options.facts?.allow ?? []
538
366
  };
539
367
  return group.handle("upload", ({ request }) => Effect.gen(function* () {
540
- yield* policy.admit(request);
368
+ yield* policy.admit(request, "Upload");
541
369
  if (!(request.headers["content-type"] ?? "").startsWith("image/")) return refused(Answer.cases.Unsupported.make({}));
542
370
  const bytes = yield* bodyOf(request, maxBytes);
543
371
  const described = yield* describe("upload", bytes);
544
372
  const hash = Option.getOrThrow(described.hash);
545
- yield* uploads.put(hash, bytes);
546
- return answered(Answer.cases.Uploaded.make({}), encode({
373
+ const facts = {
547
374
  ...described,
548
375
  key: hash
549
- }));
376
+ };
377
+ yield* uploads.put(hash, bytes, facts);
378
+ return answered(Answer.cases.Uploaded.make({}), encode(facts));
550
379
  }).pipe(Effect.provide(services), Effect.catchTags({
551
380
  UploadForbidden: () => Effect.succeed(refused(Answer.cases.Forbidden.make({}))),
381
+ UploadUnauthenticated: () => Effect.succeed(refused(Answer.cases.Unauthenticated.make({}))),
552
382
  OriginalTooLarge: () => Effect.succeed(refused(Answer.cases.TooLarge.make({}))),
553
383
  TransformFailed: () => Effect.succeed(refused(Answer.cases.Unsupported.make({}))),
554
384
  HttpServerError: () => Effect.succeed(refused(Answer.cases.Malformed.make({})))
555
385
  }), Effect.withSpan("Media.upload"))).handle("facts", ({ request }) => Effect.gen(function* () {
556
- yield* policy.admit(request);
386
+ yield* policy.admit(request, "DescribeUrl");
557
387
  const url = new URL(request.url, "http://media.invalid").searchParams.get("url");
558
388
  if (url === null) return refused(Answer.cases.Malformed.make({}));
559
389
  return answered(Answer.cases.Described.make({}), encode(yield* factsOf(url, facts)));
560
390
  }).pipe(Effect.provide(services), Effect.catchTags({
561
391
  UploadForbidden: () => Effect.succeed(refused(Answer.cases.Forbidden.make({}))),
392
+ UploadUnauthenticated: () => Effect.succeed(refused(Answer.cases.Unauthenticated.make({}))),
562
393
  FactsUnavailable: () => Effect.succeed(refused(Answer.cases.Unavailable.make({})))
563
394
  }), Effect.withSpan("Media.facts")));
564
395
  }));
@@ -570,11 +401,31 @@ const uploadHandlers = (options = {}) => {
570
401
  */
571
402
  const uploadLayer = (options = {}) => HttpApiBuilder.layer(UploadApi).pipe(Layer.provide(uploadHandlers(options)));
572
403
  /**
573
- * The upload route as a Worker's fetch handler, its services from each
574
- * environment's bindings (`uploadsR2`, `inspectorImages`, and the
575
- * application's `UploadPolicy`). Route `/_media/upload` to it.
404
+ * Policies tried in turn, the first to admit winning: a deployment's secret
405
+ * for scripts beside sessions for editors. A refusal tries the next; when
406
+ * every one refuses, the last refusal is the answer. Each is built once, with
407
+ * the combined layer, and closes with it.
576
408
  */
577
- const serveUploadFetch = (options) => fetchOf((env) => uploadLayer(options).pipe(Layer.provide(options.layer(env))));
409
+ const uploadPolicyAny = (...policies) => Layer.effect(UploadPolicy, Effect.gen(function* () {
410
+ const [head, ...tail] = policies;
411
+ const first = Context.get(yield* Layer.build(head), UploadPolicy);
412
+ const rest = [];
413
+ for (const policy of tail) rest.push(Context.get(yield* Layer.build(policy), UploadPolicy));
414
+ return { admit: (request, route) => rest.reduce((asked, next) => Effect.catch(asked, () => next.admit(request, route)), first.admit(request, route)) };
415
+ }));
416
+ const digestOf = (text) => Effect.promise(() => crypto.subtle.digest("SHA-256", new TextEncoder().encode(text))).pipe(Effect.map((digest) => new Uint8Array(digest)));
417
+ /**
418
+ * Admits a request whose `Authorization` is `Bearer <token>`, and with no
419
+ * token (unset or empty) admits nobody, whatever it sends. The two are
420
+ * compared by digest, every byte, so the time taken says nothing of the
421
+ * token. For a deployment's secret (`wrangler secret put`); who may upload
422
+ * by session is the application's own `UploadPolicy`.
423
+ */
424
+ const uploadPolicyBearer = (token) => Layer.succeed(UploadPolicy, { admit: (request) => Effect.all([digestOf(request.headers["authorization"] ?? ""), digestOf(`Bearer ${token}`)]).pipe(Effect.flatMap(([given, expected]) => {
425
+ let difference = token === void 0 || token === "" ? 1 : 0;
426
+ for (let at = 0; at < expected.length; at++) difference |= given[at] ^ expected[at];
427
+ return difference === 0 ? Effect.void : Effect.fail(new UploadForbidden({}));
428
+ })) });
578
429
  /**
579
430
  * Uploads kept in the application's `KeyValueStore`, each under its content
580
431
  * hash after `prefix`: the same keys `originalsKeyValueStore` reads, with the
@@ -582,9 +433,58 @@ const serveUploadFetch = (options) => fetchOf((env) => uploadLayer(options).pipe
582
433
  */
583
434
  const uploadsKeyValueStore = (options = {}) => Layer.effect(Uploads, Effect.gen(function* () {
584
435
  const store = KeyValueStore.prefix(yield* KeyValueStore.KeyValueStore, options.prefix ?? "");
585
- return { put: (hash, bytes) => store.set(hash, bytes).pipe(Effect.orDie) };
436
+ return { put: (hash, bytes, facts) => store.set(hash, bytes).pipe(Effect.andThen(store.set(factsKey(hash), encodeFacts(facts))), Effect.orDie) };
437
+ }));
438
+ /**
439
+ * Upload facts read back from the application's `KeyValueStore`, under the
440
+ * same `prefix` as `uploadsKeyValueStore`. A store that fails is a defect.
441
+ */
442
+ const storedFactsKeyValueStore = (options = {}) => Layer.effect(StoredFacts, Effect.gen(function* () {
443
+ const store = KeyValueStore.prefix(yield* KeyValueStore.KeyValueStore, options.prefix ?? "");
444
+ return { get: (hash) => store.get(factsKey(hash)).pipe(Effect.map((found) => Option.map(Option.fromNullishOr(found), decodeFacts)), Effect.orDie) };
445
+ }));
446
+ // src/server/stores.ts
447
+ const mediaTypeOf = (key) => {
448
+ const extension = key.slice(key.lastIndexOf(".") + 1);
449
+ return Schema.is(Format)(extension) ? mimeType(extension) : "application/octet-stream";
450
+ };
451
+ /**
452
+ * `Variants` over a `KeyValueStore`. A variant's bytes are its value and its
453
+ * media type is its key's extension, so nothing else is stored. A store that
454
+ * fails is logged and read as a miss, or a write it drops: a variant is a
455
+ * cache, and the request is answered either way.
456
+ */
457
+ const makeVariants = (store) => ({
458
+ get: (key) => store.getUint8Array(key).pipe(Effect.map((bytes) => Option.map(Option.fromNullishOr(bytes), (value) => ({
459
+ encoded: {
460
+ bytes: new Uint8Array(value),
461
+ contentType: mediaTypeOf(key)
462
+ },
463
+ from: "store"
464
+ }))), Effect.catch((error) => Effect.logWarning("Media: the variant store failed a read", error).pipe(Effect.as(Option.none())))),
465
+ put: (key, encoded) => store.set(key, encoded.bytes).pipe(Effect.catch((error) => Effect.logWarning("Media: the variant store failed a write", error)))
466
+ });
467
+ /**
468
+ * Variants kept in the application's `KeyValueStore`, under `prefix`:
469
+ * `KeyValueStore.layerMemory` for tests, `layerFileSystem` on a disk,
470
+ * `layerSql` over SQLite or D1.
471
+ */
472
+ const variantsKeyValueStore = (options = {}) => Layer.effect(Variants, Effect.gen(function* () {
473
+ const store = yield* KeyValueStore.KeyValueStore;
474
+ return makeVariants(KeyValueStore.prefix(store, options.prefix ?? "variants/"));
475
+ }));
476
+ /**
477
+ * Originals in the application's `KeyValueStore`, each under its content
478
+ * hash after `prefix`. A store that fails is a defect, not a missing
479
+ * original: the original is the data, and a 404 would say it is gone.
480
+ */
481
+ const originalsKeyValueStore = (options = {}) => Layer.effect(Originals, Effect.gen(function* () {
482
+ const store = KeyValueStore.prefix(yield* KeyValueStore.KeyValueStore, options.prefix ?? "");
483
+ return { get: (hash) => store.getUint8Array(hash).pipe(Effect.orDie, Effect.flatMap((bytes) => bytes === void 0 ? Effect.fail(new OriginalNotFound({ hash })) : Effect.succeed({
484
+ body: new Blob([new Uint8Array(bytes)]).stream(),
485
+ size: bytes.byteLength
486
+ }))) };
586
487
  }));
587
- //#endregion
588
- export { MediaApi as C, statusOf as S, Admission as _, serveUploadFetch as a, Answer as b, uploadsKeyValueStore as c, makeVariants as d, originalsKeyValueStore as f, serveFetch as g, layer as h, Uploads as i, FactsUnavailable as l, handlers as m, UploadForbidden as n, uploadHandlers as o, variantsKeyValueStore as p, UploadPolicy as r, uploadLayer as s, UploadApi as t, factsOf as u, RateLimited as v, headersFor as x, admissionRateLimiter as y };
488
+ export { admissionRateLimiter as C, statusOf as D, matches as E, RateLimited as S, headersFor as T, uploadPolicyBearer as _, UploadApi as a, factsOf as b, UploadUnauthenticated as c, encodeFacts as d, factsKey as f, uploadPolicyAny as g, uploadLayer as h, StoredFacts as i, Uploads as l, uploadHandlers as m, originalsKeyValueStore as n, UploadForbidden as o, storedFactsKeyValueStore as p, variantsKeyValueStore as r, UploadPolicy as s, makeVariants as t, decodeFacts as u, uploadsKeyValueStore as v, Answer as w, Admission as x, FactsUnavailable as y };
589
489
 
590
- //# sourceMappingURL=upload-C5YM5jZR.mjs.map
490
+ //# sourceMappingURL=stores-CxraN3kt.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stores-CxraN3kt.mjs","names":["DEFAULT_MAX_BYTES"],"sources":["../src/server/headers.ts","../src/server/admission.ts","../src/server/facts.ts","../src/server/upload.ts","../src/server/stores.ts"],"sourcesContent":["import { Schema } from 'effect'\n\n/** Where a variant came from: the edge's cache, the server's store, or made for this request. */\nexport const From = Schema.Literals(['edge', 'store', 'made'])\nexport type From = typeof From.Type\n\n/** Every answer the media server gives, and nothing else: each has its status and its headers. */\nexport const Answer = Schema.TaggedUnion({\n /** A variant's bytes. */\n Variant: { etag: Schema.String, from: From },\n /** The variant the request's `If-None-Match` already holds. */\n NotModified: { etag: Schema.String },\n /**\n * No URL of this server's grammar. A later release may read it (a new format\n * or parameter, in a rollout), so it is kept as briefly as `NotFound`.\n */\n Malformed: {},\n /** No original under the hash: an upload may yet put one there. */\n NotFound: {},\n /**\n * A spelling of the grammar outside this space: another release (the next\n * one, in a rollout) may offer it, so it is kept as briefly as `NotFound`.\n */\n Unoffered: {},\n /**\n * A variant of an earlier revision, made no longer and not kept: its URL now names the\n * current revision's, at `location`. A 302 kept briefly, since a rollback to that revision,\n * or a server of it still in the rollout, answers the old URL again.\n */\n Moved: { location: Schema.String },\n /** The original is larger than the server reads: a server configured to read more may. */\n TooLarge: {},\n /** The transformer failed: perhaps not for good. */\n Failed: {},\n /** The client has had too many variants made lately. */\n RateLimited: { retryAfterSeconds: Schema.Number },\n /** The host's allowance is spent. */\n Exhausted: {},\n /** An upload kept; its facts are the body. */\n Uploaded: {},\n /** The upload policy refused who is asking. */\n Forbidden: {},\n /** The upload policy could not tell who is asking: an untrusted origin, a session ended. */\n Unauthenticated: {},\n /** An upload that is not an image the server reads. */\n Unsupported: {},\n /** The facts of an image named by URL; the facts are the body. */\n Described: {},\n /** No facts could be read for that URL: a host not allowed, a read that failed, no image. */\n Unavailable: {},\n})\nexport type Answer = typeof Answer.Type\n\nconst YEAR = 'public, max-age=31536000, immutable'\n\n// What may yet be answered: the browser keeps nothing, and the edge a minute, to blunt a crawler.\nconst BRIEFLY: Readonly<Record<string, string>> = {\n 'cache-control': 'no-store',\n 'cdn-cache-control': 'public, max-age=60',\n}\n\n// Retry a spent allowance after an hour: the host's window is not known here.\nconst EXHAUSTED_RETRY_SECONDS = '3600'\n\n/** The status of each answer. */\nexport const statusOf: (answer: Answer) => number = Answer.match({\n Variant: () => 200,\n NotModified: () => 304,\n Malformed: () => 400,\n NotFound: () => 404,\n Unoffered: () => 404,\n Moved: () => 302,\n TooLarge: () => 413,\n Failed: () => 502,\n RateLimited: () => 429,\n Exhausted: () => 503,\n Uploaded: () => 201,\n Forbidden: () => 403,\n Unauthenticated: () => 401,\n Unsupported: () => 415,\n Described: () => 200,\n Unavailable: () => 422,\n})\n\n/**\n * Every response's headers, decided in one place, so the server, the edge\n * and a static host cannot disagree. A variant's URL names the variant, and\n * a new way of making it is a new revision, so it is kept for a year. A refusal of a variant is not: another release, or the\n * same one configured otherwise, may answer it, so only a CDN keeps it,\n * briefly; a failure is never kept. Every image may be read by a canvas on\n * another origin, and its type is never sniffed.\n */\nexport const headersFor = (answer: Answer): Readonly<Record<string, string>> => ({\n 'x-content-type-options': 'nosniff',\n 'access-control-allow-origin': '*',\n 'cross-origin-resource-policy': 'cross-origin',\n 'timing-allow-origin': '*',\n ...Answer.match(answer, {\n Variant: ({ etag, from }): Record<string, string> => ({\n 'cache-control': YEAR,\n etag,\n 'server-timing': `media;desc=\"${from}\"`,\n }),\n NotModified: ({ etag }): Record<string, string> => ({ 'cache-control': YEAR, etag }),\n Malformed: (): Record<string, string> => BRIEFLY,\n NotFound: (): Record<string, string> => BRIEFLY,\n Unoffered: (): Record<string, string> => BRIEFLY,\n Moved: ({ location }): Record<string, string> => ({ ...BRIEFLY, location }),\n TooLarge: (): Record<string, string> => BRIEFLY,\n Failed: (): Record<string, string> => ({ 'cache-control': 'no-store' }),\n RateLimited: ({ retryAfterSeconds }): Record<string, string> => ({\n 'cache-control': 'no-store',\n 'retry-after': String(retryAfterSeconds),\n }),\n Exhausted: (): Record<string, string> => ({\n 'cache-control': 'no-store',\n 'retry-after': EXHAUSTED_RETRY_SECONDS,\n }),\n // An upload's answers are about one request, and are never kept.\n Uploaded: (): Record<string, string> => ({ 'cache-control': 'no-store' }),\n Forbidden: (): Record<string, string> => ({ 'cache-control': 'no-store' }),\n Unauthenticated: (): Record<string, string> => ({ 'cache-control': 'no-store' }),\n Unsupported: (): Record<string, string> => ({ 'cache-control': 'no-store' }),\n Described: (): Record<string, string> => ({ 'cache-control': 'no-store' }),\n Unavailable: (): Record<string, string> => ({ 'cache-control': 'no-store' }),\n }),\n})\n\n/** Whether an `If-None-Match` names `etag` (weakly, as a GET compares, or `*`). */\nexport const matches = (ifNoneMatch: string | undefined, etag: string): boolean =>\n ifNoneMatch !== undefined &&\n ifNoneMatch\n .split(',')\n .map(tag => tag.trim().replace(/^W\\//, ''))\n .some(tag => tag === '*' || tag === etag)\n","import { Context, Duration, Effect, Layer, Match, Schema } from 'effect'\nimport { RateLimiter } from 'effect/persistence'\n\n/** The client has made too many variants lately; it may try again after `retryAfterSeconds`. */\nexport class RateLimited extends Schema.TaggedError<RateLimited>()(\n 'RateLimited',\n { retryAfterSeconds: Schema.Number },\n { httpApiStatus: 429 },\n) {}\n\n/**\n * Whether a client may have a variant made now. Asked only on a miss, after\n * the store and before the original is read: a variant already made costs a\n * read, and only making one costs work. Optional: without it, every miss is\n * admitted.\n */\nexport class Admission extends Context.Service<\n Admission,\n { readonly admit: (client: string) => Effect.Effect<void, RateLimited> }\n>()('foldkit-media/Admission') {}\n\n/**\n * Admission through Effect's `RateLimiter`, `limit` misses a client per\n * `window`, over the limiter's store (`RateLimiter.layerStoreMemory` for one\n * process, Redis for several). A store that fails admits the request, logged:\n * a limiter that is down should not take the images down with it.\n */\nexport const admissionRateLimiter = (options: {\n readonly limit: number\n readonly window: Duration.Input\n readonly algorithm?: 'fixed-window' | 'token-bucket'\n}): Layer.Layer<Admission, never, RateLimiter.RateLimiter> =>\n Layer.effect(\n Admission,\n Effect.gen(function* () {\n const limiter = yield* RateLimiter.RateLimiter\n return {\n admit: (client: string) =>\n limiter\n .consume({\n key: `foldkit-media:${client}`,\n limit: options.limit,\n window: options.window,\n algorithm: options.algorithm ?? 'token-bucket',\n onExceeded: 'fail',\n })\n .pipe(\n Effect.asVoid,\n Effect.catch(error =>\n Match.valueTags(error.reason, {\n RateLimitExceeded: ({ retryAfter }) =>\n Effect.fail(\n new RateLimited({\n retryAfterSeconds: Math.max(1, Math.ceil(Duration.toSeconds(retryAfter))),\n }),\n ),\n RateLimitStoreError: () =>\n Effect.logWarning('Media: the rate limiter failed; admitting', error),\n }),\n ),\n ),\n }\n }),\n )\n","import { Effect, Option, Schema } from 'effect'\nimport type { KeyValueStore } from 'effect/persistence'\nimport { ImageAsset } from '../asset.js'\nimport { describe, type Inspector } from '../describe.js'\nimport { nonNegativeInteger } from '../limits.js'\n\n/** No facts could be read for the image at `url`; `reason` says why, for the build's report. */\nexport class FactsUnavailable extends Schema.TaggedError<FactsUnavailable>()('FactsUnavailable', {\n url: Schema.String,\n reason: Schema.String,\n}) {}\n\nconst Cached = Schema.Struct({\n target: Schema.String,\n etag: Schema.OptionFromNullOr(Schema.String),\n asset: ImageAsset,\n})\nconst CachedJson = Schema.fromJsonString(Cached)\n\n// A redirect chain longer than this is refused, not followed.\nconst MAX_REDIRECTS = 3\n\nconst DEFAULT_MAX_BYTES = 20 * 1024 * 1024\n\nexport interface FactsOptions {\n /** The hosts an original may be read from, matched exactly: `cdn.example.com`, not a suffix. */\n readonly allow: ReadonlyArray<string>\n /** The largest original read, in bytes, counted as it streams. */\n readonly maxBytes?: number\n /** Facts kept by URL and revalidated with the original's `ETag`. */\n readonly cache?: KeyValueStore.KeyValueStore\n /** How to fetch; the platform's `fetch` by default. */\n readonly fetch?: (request: Request) => Promise<Response>\n}\n\n/**\n * The facts of an image a page names only by URL (a rich-text image, a CMS\n * block), so it is drawn with its box and placeholder like any other: its\n * original read from an allowed host and described (`describe`), with the\n * URL as its key. Only `https` on a host in `allow`, at its default port, is read, and every\n * redirect is checked again, so content cannot point the build at an\n * internal address. Kept in `cache`, an unchanged original is asked for\n * with its `ETag` and not read or inspected again.\n */\nexport const factsOf = (\n url: string,\n options: FactsOptions,\n): Effect.Effect<ImageAsset, FactsUnavailable, Inspector> => {\n const unavailable = (reason: string) => new FactsUnavailable({ url, reason })\n const fetchOne = options.fetch ?? ((request: Request) => fetch(request))\n const maxBytes = nonNegativeInteger('maxBytes', options.maxBytes ?? DEFAULT_MAX_BYTES)\n // An allowed host on its own port alone: another port of it is another service.\n const allowed = (target: URL) =>\n target.protocol === 'https:' && target.port === '' && options.allow.includes(target.hostname)\n const cacheKey = `facts/${url}`\n\n const readCached = Option.match(Option.fromNullishOr(options.cache), {\n onNone: () => Effect.succeed(Option.none<typeof Cached.Type>()),\n onSome: store =>\n store.get(cacheKey).pipe(\n Effect.map(text =>\n Option.flatMap(Option.fromNullishOr(text), Schema.decodeUnknownOption(CachedJson)),\n ),\n Effect.catch(() => Effect.succeed(Option.none<typeof Cached.Type>())),\n ),\n })\n\n const request = (cached: Option.Option<typeof Cached.Type>) =>\n Effect.tryPromise({\n try: async () => {\n let target = new URL(url)\n for (let hop = 0; hop <= MAX_REDIRECTS; hop++) {\n if (!allowed(target))\n return { refused: `${target.origin} is not an allowed host` } as const\n const etag = Option.flatMap(cached, entry =>\n entry.target === target.href ? entry.etag : Option.none(),\n )\n const headers = Option.match(etag, {\n onNone: () => ({}),\n onSome: tag => ({ 'if-none-match': tag }),\n })\n const response = await fetchOne(new Request(target, { headers, redirect: 'manual' }))\n const location = response.headers.get('location')\n if (\n response.status < 300 ||\n response.status >= 400 ||\n response.status === 304 ||\n location === null\n ) {\n return { response, target: target.href } as const\n }\n target = new URL(location, target)\n }\n return { refused: `more than ${MAX_REDIRECTS} redirects` } as const\n },\n catch: cause => unavailable(`the fetch failed: ${String(cause)}`),\n })\n\n // Counted as it streams: a missing or false Content-Length does not let a larger body through.\n const bytesOf = (response: Response) =>\n Effect.tryPromise({\n try: async () => {\n const chunks: Array<Uint8Array> = []\n let size = 0\n const reader = response.body?.getReader()\n for (\n let read = await reader?.read();\n read !== undefined && !read.done;\n read = await reader?.read()\n ) {\n size += read.value.byteLength\n if (size > maxBytes) {\n await reader?.cancel()\n return undefined\n }\n chunks.push(read.value)\n }\n const bytes = new Uint8Array(size)\n let at = 0\n for (const chunk of chunks) {\n bytes.set(chunk, at)\n at += chunk.byteLength\n }\n return bytes\n },\n catch: cause => unavailable(`the body could not be read: ${String(cause)}`),\n })\n\n return Effect.gen(function* () {\n const cached = yield* readCached\n const answer = yield* request(cached)\n if ('refused' in answer) return yield* unavailable(answer.refused)\n const { response, target } = answer\n const unchanged = Option.filter(cached, entry => entry.target === target)\n if (response.status === 304 && Option.isSome(unchanged)) return unchanged.value.asset\n if (response.status !== 200)\n return yield* unavailable(`the original answered ${response.status}`)\n const bytes = yield* bytesOf(response)\n if (bytes === undefined)\n return yield* unavailable(`the original is larger than ${maxBytes} bytes`)\n const asset = yield* describe(url, bytes).pipe(\n Effect.mapError(error => unavailable(`the original could not be inspected: ${error._tag}`)),\n )\n const store = options.cache\n if (store !== undefined) {\n const entry = Schema.encodeSync(CachedJson)({\n target,\n etag: Option.fromNullishOr(response.headers.get('etag')),\n asset,\n })\n yield* store.set(cacheKey, entry).pipe(Effect.ignore)\n }\n return asset\n })\n}\n","/**\n * Where an original enters: `POST /_media/upload` takes an image's bytes,\n * reads its facts (`describe`, through the `Inspector`), keeps the bytes\n * under their content hash (`Uploads`), and answers the facts as an\n * `ImageAsset`, for whoever registers them (a CMS's asset row). The bytes\n * travel once, over HTTP; only the facts go on to the application's data.\n */\nimport { Context, Effect, Layer, Option, Schema, Stream } from 'effect'\nimport { HttpServerResponse, type HttpServerRequest } from 'effect/http'\nimport { HttpApi, HttpApiBuilder, HttpApiEndpoint, HttpApiGroup } from 'effect/http-api'\nimport { KeyValueStore } from 'effect/persistence'\nimport { HashedAsset, ImageAsset } from '../asset.js'\nimport { describe, type Inspector } from '../describe.js'\nimport { nonNegativeInteger } from '../limits.js'\nimport { OriginalTooLarge } from './errors.js'\nimport { factsOf, type FactsOptions } from './facts.js'\nimport { Answer, headersFor, statusOf } from './headers.js'\n\n/**\n * Where an original's facts enter, apart from `MediaApi`, so the variant server needs none of\n * its services: an upload, and the facts of an image named by URL.\n */\nexport const UploadApi = HttpApi.make('foldkit-media-upload').add(\n HttpApiGroup.make('uploads').add(\n HttpApiEndpoint.post('upload', '/_media/upload'),\n HttpApiEndpoint.get('facts', '/_media/facts'),\n ),\n)\n\n/**\n * Keeps an uploaded original under its content hash, and the facts the\n * server read from it beside it: the one writer of what `Originals` and\n * `StoredFacts` read. The bytes are kept first, so kept facts mean kept bytes.\n */\nexport class Uploads extends Context.Service<\n Uploads,\n {\n readonly put: (\n hash: string,\n bytes: Uint8Array<ArrayBuffer>,\n facts: ImageAsset,\n ) => Effect.Effect<void>\n }\n>()('foldkit-media/Uploads') {}\n\n/**\n * The facts the upload route read from an original, by its hash: what an\n * application stores, rather than facts a client sends back. None for a hash\n * nobody uploaded, or one kept before facts were.\n */\nexport class StoredFacts extends Context.Service<\n StoredFacts,\n { readonly get: (hash: string) => Effect.Effect<Option.Option<HashedAsset>> }\n>()('foldkit-media/StoredFacts') {}\n\n/** Where an upload's facts are kept, beside its bytes under the same prefix. */\nexport const factsKey = (hash: string): string => `facts/${hash}`\n\nexport const encodeFacts = (facts: ImageAsset): string =>\n JSON.stringify(Schema.encodeSync(ImageAsset)(facts))\n\n// Facts the route wrote are hashed; any other entry is a defect, never a silent none.\nexport const decodeFacts = (stored: string): HashedAsset =>\n Schema.decodeUnknownSync(Schema.fromJsonString(HashedAsset))(stored)\n\n/** The request may not upload. Why stays with the policy: the answer says only no. */\nexport class UploadForbidden extends Schema.TaggedError<UploadForbidden>()(\n 'UploadForbidden',\n {},\n { httpApiStatus: 403 },\n) {}\n\n/**\n * The policy could not tell who is asking (an untrusted origin, a session\n * that ended), so the client should sign in again rather than give up.\n */\nexport class UploadUnauthenticated extends Schema.TaggedError<UploadUnauthenticated>()(\n 'UploadUnauthenticated',\n {},\n { httpApiStatus: 401 },\n) {}\n\n/** Which route the policy is asked about: an upload, or the facts of an image named by URL. */\nexport type UploadRoute = 'Upload' | 'DescribeUrl'\n\n/**\n * Who may upload, asked of every request before its body is read, with the\n * route it is for. The route has no default: an application that serves\n * uploads says who may (`foldkit-guard/media` over the session, a secret), so\n * a server is never open to every upload by omission.\n */\nexport class UploadPolicy extends Context.Service<\n UploadPolicy,\n {\n readonly admit: (\n request: HttpServerRequest.HttpServerRequest,\n route: UploadRoute,\n ) => Effect.Effect<void, UploadForbidden | UploadUnauthenticated>\n }\n>()('foldkit-media/UploadPolicy') {}\n\n/** The Cloudflare Images binding reads at most 20 MB; so does the variant server by default. */\nconst DEFAULT_MAX_BYTES = 20 * 1024 * 1024\n\nexport interface UploadOptions {\n /** The largest upload read, in bytes; a larger one is a 413, read no further. */\n readonly maxBytes?: number\n /**\n * How `GET /_media/facts?url=` reads an image named by URL (`factsOf`): the hosts it may\n * fetch from, and a cache. No hosts unless given, so a server names every host it reads.\n */\n readonly facts?: Omit<FactsOptions, 'allow'> & { readonly allow?: ReadonlyArray<string> }\n}\n\nconst answered = (answer: Answer, body: unknown) =>\n HttpServerResponse.jsonUnsafe(body, { status: statusOf(answer), headers: headersFor(answer) })\n\nconst refused = (answer: Answer) => answered(answer, { error: answer._tag })\n\n/** The body, refused past `maxBytes` as it streams: a declared length is the client's to write, so it is not read. */\nconst bodyOf = (request: HttpServerRequest.HttpServerRequest, maxBytes: number) =>\n Effect.gen(function* () {\n const chunks: Array<Uint8Array> = []\n let size = 0\n yield* request.stream.pipe(\n Stream.runForEach(chunk =>\n Effect.suspend(() => {\n size += chunk.byteLength\n if (size > maxBytes) {\n return Effect.fail(new OriginalTooLarge({ size, limit: maxBytes, unit: 'bytes' }))\n }\n chunks.push(chunk)\n return Effect.void\n }),\n ),\n )\n const bytes = new Uint8Array(size)\n let at = 0\n for (const chunk of chunks) {\n bytes.set(chunk, at)\n at += chunk.byteLength\n }\n return bytes\n })\n\n/**\n * The upload route's handler. It asks the `UploadPolicy` first; takes only\n * an `image/*` body, which a browser cannot send to another origin without a\n * preflight this route never answers, so a cookie alone cannot upload from\n * another site; reads at most `maxBytes`; and refuses what the `Inspector`\n * cannot read as an image (415). Its answer is the facts, with the hash as\n * the key, `201`.\n */\nexport const uploadHandlers = (options: UploadOptions = {}) => {\n const maxBytes = nonNegativeInteger('maxBytes', options.maxBytes ?? DEFAULT_MAX_BYTES)\n const encode = Schema.encodeSync(ImageAsset)\n return HttpApiBuilder.group(UploadApi, 'uploads', group =>\n Effect.gen(function* () {\n const uploads = yield* Uploads\n const policy = yield* UploadPolicy\n const services = yield* Effect.context<Inspector>()\n const facts = { ...options.facts, allow: options.facts?.allow ?? [] }\n return group\n .handle('upload', ({ request }) =>\n Effect.gen(function* () {\n yield* policy.admit(request, 'Upload')\n if (!(request.headers['content-type'] ?? '').startsWith('image/')) {\n return refused(Answer.cases.Unsupported.make({}))\n }\n const bytes = yield* bodyOf(request, maxBytes)\n const described = yield* describe('upload', bytes)\n const hash = Option.getOrThrow(described.hash)\n const facts = { ...described, key: hash }\n yield* uploads.put(hash, bytes, facts)\n return answered(Answer.cases.Uploaded.make({}), encode(facts))\n }).pipe(\n Effect.provide(services),\n Effect.catchTags({\n UploadForbidden: () => Effect.succeed(refused(Answer.cases.Forbidden.make({}))),\n UploadUnauthenticated: () =>\n Effect.succeed(refused(Answer.cases.Unauthenticated.make({}))),\n OriginalTooLarge: () => Effect.succeed(refused(Answer.cases.TooLarge.make({}))),\n TransformFailed: () => Effect.succeed(refused(Answer.cases.Unsupported.make({}))),\n // The body broke off or could not be read: the request's fault, not the server's.\n HttpServerError: () => Effect.succeed(refused(Answer.cases.Malformed.make({}))),\n }),\n Effect.withSpan('Media.upload'),\n ),\n )\n .handle('facts', ({ request }) =>\n Effect.gen(function* () {\n yield* policy.admit(request, 'DescribeUrl')\n const url = new URL(request.url, 'http://media.invalid').searchParams.get('url')\n if (url === null) return refused(Answer.cases.Malformed.make({}))\n return answered(Answer.cases.Described.make({}), encode(yield* factsOf(url, facts)))\n }).pipe(\n Effect.provide(services),\n Effect.catchTags({\n UploadForbidden: () => Effect.succeed(refused(Answer.cases.Forbidden.make({}))),\n UploadUnauthenticated: () =>\n Effect.succeed(refused(Answer.cases.Unauthenticated.make({}))),\n // Why stays in the server: a host refused, a read failed, a file that is no image.\n FactsUnavailable: () => Effect.succeed(refused(Answer.cases.Unavailable.make({}))),\n }),\n Effect.withSpan('Media.facts'),\n ),\n )\n }),\n )\n}\n\n/**\n * The upload route as an Effect HTTP application, registered with the\n * `HttpRouter` beside the variant server's, needing `Uploads`, an\n * `Inspector` and the `UploadPolicy`.\n */\nexport const uploadLayer = (options: UploadOptions = {}) =>\n HttpApiBuilder.layer(UploadApi).pipe(Layer.provide(uploadHandlers(options)))\n\n/**\n * Policies tried in turn, the first to admit winning: a deployment's secret\n * for scripts beside sessions for editors. A refusal tries the next; when\n * every one refuses, the last refusal is the answer. Each is built once, with\n * the combined layer, and closes with it.\n */\nexport const uploadPolicyAny = <E, R>(\n ...policies: readonly [\n Layer.Layer<UploadPolicy, E, R>,\n Layer.Layer<UploadPolicy, E, R>,\n ...ReadonlyArray<Layer.Layer<UploadPolicy, E, R>>,\n ]\n): Layer.Layer<UploadPolicy, E, R> =>\n Layer.effect(\n UploadPolicy,\n Effect.gen(function* () {\n const [head, ...tail] = policies\n const first = Context.get(yield* Layer.build(head), UploadPolicy)\n const rest: Array<typeof UploadPolicy.Service> = []\n for (const policy of tail) rest.push(Context.get(yield* Layer.build(policy), UploadPolicy))\n return {\n admit: (request, route) =>\n rest.reduce(\n (asked, next) => Effect.catch(asked, () => next.admit(request, route)),\n first.admit(request, route),\n ),\n }\n }),\n )\n\nconst digestOf = (text: string) =>\n Effect.promise(() => crypto.subtle.digest('SHA-256', new TextEncoder().encode(text))).pipe(\n Effect.map(digest => new Uint8Array(digest)),\n )\n\n/**\n * Admits a request whose `Authorization` is `Bearer <token>`, and with no\n * token (unset or empty) admits nobody, whatever it sends. The two are\n * compared by digest, every byte, so the time taken says nothing of the\n * token. For a deployment's secret (`wrangler secret put`); who may upload\n * by session is the application's own `UploadPolicy`.\n */\nexport const uploadPolicyBearer = (token: string | undefined): Layer.Layer<UploadPolicy> =>\n Layer.succeed(UploadPolicy, {\n admit: request =>\n Effect.all([\n digestOf(request.headers['authorization'] ?? ''),\n digestOf(`Bearer ${token}`),\n ]).pipe(\n Effect.flatMap(([given, expected]) => {\n let difference = token === undefined || token === '' ? 1 : 0\n for (let at = 0; at < expected.length; at++) difference |= given[at]! ^ expected[at]!\n return difference === 0 ? Effect.void : Effect.fail(new UploadForbidden({}))\n }),\n ),\n })\n\n/**\n * Uploads kept in the application's `KeyValueStore`, each under its content\n * hash after `prefix`: the same keys `originalsKeyValueStore` reads, with the\n * same `prefix`. A store that fails is a defect: an upload it dropped is lost.\n */\nexport const uploadsKeyValueStore = (\n options: { readonly prefix?: string } = {},\n): Layer.Layer<Uploads, never, KeyValueStore.KeyValueStore> =>\n Layer.effect(\n Uploads,\n Effect.gen(function* () {\n const store = KeyValueStore.prefix(yield* KeyValueStore.KeyValueStore, options.prefix ?? '')\n return {\n put: (hash: string, bytes: Uint8Array<ArrayBuffer>, facts: ImageAsset) =>\n store\n .set(hash, bytes)\n .pipe(Effect.andThen(store.set(factsKey(hash), encodeFacts(facts))), Effect.orDie),\n }\n }),\n )\n\n/**\n * Upload facts read back from the application's `KeyValueStore`, under the\n * same `prefix` as `uploadsKeyValueStore`. A store that fails is a defect.\n */\nexport const storedFactsKeyValueStore = (\n options: { readonly prefix?: string } = {},\n): Layer.Layer<StoredFacts, never, KeyValueStore.KeyValueStore> =>\n Layer.effect(\n StoredFacts,\n Effect.gen(function* () {\n const store = KeyValueStore.prefix(yield* KeyValueStore.KeyValueStore, options.prefix ?? '')\n return {\n get: (hash: string) =>\n store.get(factsKey(hash)).pipe(\n Effect.map(found => Option.map(Option.fromNullishOr(found), decodeFacts)),\n Effect.orDie,\n ),\n }\n }),\n )\n","import { Effect, Layer, Option, Schema } from 'effect'\nimport { KeyValueStore } from 'effect/persistence'\nimport { Format, mimeType } from '../format.js'\nimport { OriginalNotFound } from './errors.js'\nimport { Originals, Variants } from './services.js'\n\n// A key ends in its variant's spelling (`<hash>/w640.avif`), which names the format.\nconst mediaTypeOf = (key: string): string => {\n const extension = key.slice(key.lastIndexOf('.') + 1)\n return Schema.is(Format)(extension) ? mimeType(extension) : 'application/octet-stream'\n}\n\n/**\n * `Variants` over a `KeyValueStore`. A variant's bytes are its value and its\n * media type is its key's extension, so nothing else is stored. A store that\n * fails is logged and read as a miss, or a write it drops: a variant is a\n * cache, and the request is answered either way.\n */\nexport const makeVariants = (store: KeyValueStore.KeyValueStore): Variants['Service'] => ({\n get: key =>\n store.getUint8Array(key).pipe(\n Effect.map(bytes =>\n Option.map(Option.fromNullishOr(bytes), value => ({\n encoded: { bytes: new Uint8Array(value), contentType: mediaTypeOf(key) },\n from: 'store' as const,\n })),\n ),\n Effect.catch(error =>\n Effect.logWarning('Media: the variant store failed a read', error).pipe(\n Effect.as(Option.none()),\n ),\n ),\n ),\n put: (key, encoded) =>\n store\n .set(key, encoded.bytes)\n .pipe(\n Effect.catch(error => Effect.logWarning('Media: the variant store failed a write', error)),\n ),\n})\n\n/**\n * Variants kept in the application's `KeyValueStore`, under `prefix`:\n * `KeyValueStore.layerMemory` for tests, `layerFileSystem` on a disk,\n * `layerSql` over SQLite or D1.\n */\nexport const variantsKeyValueStore = (\n options: { readonly prefix?: string } = {},\n): Layer.Layer<Variants, never, KeyValueStore.KeyValueStore> =>\n Layer.effect(\n Variants,\n Effect.gen(function* () {\n const store = yield* KeyValueStore.KeyValueStore\n return makeVariants(KeyValueStore.prefix(store, options.prefix ?? 'variants/'))\n }),\n )\n\n/**\n * Originals in the application's `KeyValueStore`, each under its content\n * hash after `prefix`. A store that fails is a defect, not a missing\n * original: the original is the data, and a 404 would say it is gone.\n */\nexport const originalsKeyValueStore = (\n options: { readonly prefix?: string } = {},\n): Layer.Layer<Originals, never, KeyValueStore.KeyValueStore> =>\n Layer.effect(\n Originals,\n Effect.gen(function* () {\n const store = KeyValueStore.prefix(yield* KeyValueStore.KeyValueStore, options.prefix ?? '')\n return {\n get: (hash: string) =>\n store.getUint8Array(hash).pipe(\n Effect.orDie,\n Effect.flatMap(bytes =>\n bytes === undefined\n ? Effect.fail(new OriginalNotFound({ hash }))\n : Effect.succeed({\n body: new Blob([new Uint8Array(bytes)]).stream(),\n size: bytes.byteLength,\n }),\n ),\n ),\n }\n }),\n )\n"],"mappings":"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"}
@@ -1,7 +1,6 @@
1
- import { i as Format, r as Encoding, t as Widths } from "../widths-Cg7-x89y.mjs";
2
- import { t as Provider } from "../provider-DztvQjOr.mjs";
1
+ import { i as Format, r as Encoding, t as Widths } from "../widths-upkgLdek.mjs";
2
+ import { n as Provider } from "../provider-CB0nqu0m.mjs";
3
3
  import { Option } from "effect";
4
- //#region src/unpic/index.d.ts
5
4
  export interface DetectOptions {
6
5
  /** The widths offered: `Widths.standard` unless given. */
7
6
  readonly widths?: Widths | undefined;
@@ -23,5 +22,4 @@ export interface DetectOptions {
23
22
  * naming AVIF over a JPEG would be a lie.
24
23
  */
25
24
  export declare const detect: (url: string, options?: DetectOptions) => Option.Option<Provider>;
26
- //#endregion
27
25
  //# sourceMappingURL=index.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":["Widths.Widths"],"sources":["../../src/unpic/index.ts"],"mappings":";;;;iBAYiB;;WAEN,SAASA;;;;;WAKT,UAAU,cAAc;;WAExB,WAAW;;WAEX;;;;;;;;;qBAUE,SAAM,aAAe,UAAW,kBAAqB,OAAO,OAAO"}
1
+ {"version":3,"file":"index.d.mts","names":["Widths.Widths"],"sources":["../../src/unpic/index.ts"],"mappings":";;;iBAYiB;;WAEN,SAASA;;;;;WAKT,UAAU,cAAc;;WAExB,WAAW;;WAEX;;;;;;;;;qBAUE,SAAM,aAAe,UAAW,kBAAqB,OAAO,OAAO"}
@@ -1,7 +1,7 @@
1
- import { r as standard } from "../widths-BEa9odY6.mjs";
1
+ import { r as standard } from "../widths-qp3jshiF.mjs";
2
2
  import { Option } from "effect";
3
3
  import { getProviderForUrl, transformUrl } from "unpic";
4
- //#region src/unpic/index.ts
4
+ // src/unpic/index.ts
5
5
  /**
6
6
  * Images on a host that resizes them itself (Shopify, Cloudinary, imgix,
7
7
  * Contentful, and the rest unpic knows), as a `Provider`: each candidate is
@@ -38,7 +38,6 @@ const detect = (url, options = {}) => {
38
38
  }
39
39
  });
40
40
  };
41
- //#endregion
42
41
  export { detect };
43
42
 
44
43
  //# sourceMappingURL=index.mjs.map