foldkit-media 0.3.1 → 0.5.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 (175) hide show
  1. package/README.md +65 -4
  2. package/dist/{asset-BLo8VWmd.d.mts → asset.d.ts} +10 -11
  3. package/dist/asset.d.ts.map +1 -0
  4. package/dist/asset.js +66 -0
  5. package/dist/asset.js.map +1 -0
  6. package/dist/browser/index.d.ts +15 -0
  7. package/dist/browser/index.d.ts.map +1 -0
  8. package/dist/browser/index.js +69 -0
  9. package/dist/browser/index.js.map +1 -0
  10. package/dist/browser/{index.d.mts → upload.d.ts} +5 -16
  11. package/dist/browser/upload.d.ts.map +1 -0
  12. package/dist/browser/upload.js +87 -0
  13. package/dist/browser/upload.js.map +1 -0
  14. package/dist/cloudflare/{index.d.mts → index.d.ts} +8 -6
  15. package/dist/cloudflare/index.d.ts.map +1 -0
  16. package/dist/cloudflare/{index.mjs → index.js} +35 -15
  17. package/dist/cloudflare/index.js.map +1 -0
  18. package/dist/describe.d.ts +32 -0
  19. package/dist/describe.d.ts.map +1 -0
  20. package/dist/describe.js +30 -0
  21. package/dist/describe.js.map +1 -0
  22. package/dist/format.d.ts +12 -0
  23. package/dist/format.d.ts.map +1 -0
  24. package/dist/{format-BCRTFU9j.mjs → format.js} +2 -2
  25. package/dist/format.js.map +1 -0
  26. package/dist/{icon-BGtxExTN.d.mts → icon.d.ts} +14 -17
  27. package/dist/icon.d.ts.map +1 -0
  28. package/dist/{icon-0A2dBtqj.mjs → icon.js} +2 -12
  29. package/dist/icon.js.map +1 -0
  30. package/dist/icons/{index.d.mts → index.d.ts} +2 -2
  31. package/dist/icons/index.d.ts.map +1 -0
  32. package/dist/icons/{index.mjs → index.js} +2 -2
  33. package/dist/icons/index.js.map +1 -0
  34. package/dist/index.d.ts +11 -0
  35. package/dist/index.js +10 -0
  36. package/dist/layout.d.ts +60 -0
  37. package/dist/layout.d.ts.map +1 -0
  38. package/dist/layout.js +72 -0
  39. package/dist/layout.js.map +1 -0
  40. package/dist/limits.d.ts +3 -0
  41. package/dist/limits.d.ts.map +1 -0
  42. package/dist/{limits-B4hHpyfE.mjs → limits.js} +2 -2
  43. package/dist/limits.js.map +1 -0
  44. package/dist/picture.d.ts +88 -0
  45. package/dist/picture.d.ts.map +1 -0
  46. package/dist/picture.js +113 -0
  47. package/dist/picture.js.map +1 -0
  48. package/dist/placeholder.d.ts +16 -0
  49. package/dist/placeholder.d.ts.map +1 -0
  50. package/dist/placeholder.js +38 -0
  51. package/dist/placeholder.js.map +1 -0
  52. package/dist/{provider-CB0nqu0m.d.mts → provider.d.ts} +16 -19
  53. package/dist/provider.d.ts.map +1 -0
  54. package/dist/provider.js +93 -0
  55. package/dist/provider.js.map +1 -0
  56. package/dist/server/admission.d.ts +31 -0
  57. package/dist/server/admission.d.ts.map +1 -0
  58. package/dist/server/admission.js +41 -0
  59. package/dist/server/admission.js.map +1 -0
  60. package/dist/server/api.d.ts +14 -0
  61. package/dist/server/api.d.ts.map +1 -0
  62. package/dist/server/api.js +21 -0
  63. package/dist/server/api.js.map +1 -0
  64. package/dist/server/diagnostics.d.ts +53 -0
  65. package/dist/server/diagnostics.d.ts.map +1 -0
  66. package/dist/server/diagnostics.js +50 -0
  67. package/dist/server/diagnostics.js.map +1 -0
  68. package/dist/server/errors.d.ts +24 -0
  69. package/dist/server/errors.d.ts.map +1 -0
  70. package/dist/{errors-BhEgXJ4m.mjs → server/errors.js} +2 -2
  71. package/dist/server/errors.js.map +1 -0
  72. package/dist/server/facts.d.ts +36 -0
  73. package/dist/server/facts.d.ts.map +1 -0
  74. package/dist/server/facts.js +126 -0
  75. package/dist/server/facts.js.map +1 -0
  76. package/dist/server/fetch.d.ts +29 -0
  77. package/dist/server/fetch.d.ts.map +1 -0
  78. package/dist/server/fetch.js +32 -0
  79. package/dist/server/fetch.js.map +1 -0
  80. package/dist/server/handlers.d.ts +48 -0
  81. package/dist/server/handlers.d.ts.map +1 -0
  82. package/dist/server/handlers.js +151 -0
  83. package/dist/server/handlers.js.map +1 -0
  84. package/dist/server/headers.d.ts +47 -0
  85. package/dist/server/headers.d.ts.map +1 -0
  86. package/dist/server/headers.js +134 -0
  87. package/dist/server/headers.js.map +1 -0
  88. package/dist/server/index.d.ts +13 -0
  89. package/dist/server/index.js +12 -0
  90. package/dist/server/materialize.d.ts +36 -0
  91. package/dist/server/materialize.d.ts.map +1 -0
  92. package/dist/server/materialize.js +62 -0
  93. package/dist/server/materialize.js.map +1 -0
  94. package/dist/{services-BZoK2VOY.d.mts → server/services.d.ts} +12 -12
  95. package/dist/server/services.d.ts.map +1 -0
  96. package/dist/{services-7B4hsQM7.mjs → server/services.js} +3 -3
  97. package/dist/server/services.js.map +1 -0
  98. package/dist/server/stores.d.ts +27 -0
  99. package/dist/server/stores.d.ts.map +1 -0
  100. package/dist/server/stores.js +62 -0
  101. package/dist/server/stores.js.map +1 -0
  102. package/dist/server/upload.d.ts +113 -0
  103. package/dist/server/upload.d.ts.map +1 -0
  104. package/dist/server/upload.js +185 -0
  105. package/dist/server/upload.js.map +1 -0
  106. package/dist/sharp/{index.d.mts → index.d.ts} +3 -3
  107. package/dist/sharp/index.d.ts.map +1 -0
  108. package/dist/sharp/{index.mjs → index.js} +11 -9
  109. package/dist/sharp/index.js.map +1 -0
  110. package/dist/unpic/{index.d.mts → index.d.ts} +5 -4
  111. package/dist/unpic/index.d.ts.map +1 -0
  112. package/dist/unpic/{index.mjs → index.js} +3 -3
  113. package/dist/unpic/index.js.map +1 -0
  114. package/dist/{variant-B-vyMmFB.d.mts → variant.d.ts} +15 -18
  115. package/dist/variant.d.ts.map +1 -0
  116. package/dist/variant.js +75 -0
  117. package/dist/variant.js.map +1 -0
  118. package/dist/vite/{index.d.mts → icons.d.ts} +1 -19
  119. package/dist/vite/icons.d.ts.map +1 -0
  120. package/dist/vite/{index.mjs → icons.js} +7 -168
  121. package/dist/vite/icons.js.map +1 -0
  122. package/dist/vite/images.d.ts +20 -0
  123. package/dist/vite/images.d.ts.map +1 -0
  124. package/dist/vite/images.js +167 -0
  125. package/dist/vite/images.js.map +1 -0
  126. package/dist/vite/index.d.ts +3 -0
  127. package/dist/vite/index.js +3 -0
  128. package/dist/widths.d.ts +22 -0
  129. package/dist/widths.d.ts.map +1 -0
  130. package/dist/{widths-qp3jshiF.mjs → widths.js} +2 -8
  131. package/dist/widths.js.map +1 -0
  132. package/package.json +23 -22
  133. package/dist/asset-BLo8VWmd.d.mts.map +0 -1
  134. package/dist/browser/index.d.mts.map +0 -1
  135. package/dist/browser/index.mjs +0 -150
  136. package/dist/browser/index.mjs.map +0 -1
  137. package/dist/cloudflare/index.d.mts.map +0 -1
  138. package/dist/cloudflare/index.mjs.map +0 -1
  139. package/dist/describe-BOgc0xbR.d.mts +0 -52
  140. package/dist/describe-BOgc0xbR.d.mts.map +0 -1
  141. package/dist/describe-C6sWA_8p.mjs +0 -171
  142. package/dist/describe-C6sWA_8p.mjs.map +0 -1
  143. package/dist/errors-BhEgXJ4m.mjs.map +0 -1
  144. package/dist/format-BCRTFU9j.mjs.map +0 -1
  145. package/dist/icon-0A2dBtqj.mjs.map +0 -1
  146. package/dist/icon-BGtxExTN.d.mts.map +0 -1
  147. package/dist/icons/index.d.mts.map +0 -1
  148. package/dist/icons/index.mjs.map +0 -1
  149. package/dist/index.d.mts +0 -157
  150. package/dist/index.d.mts.map +0 -1
  151. package/dist/index.mjs +0 -322
  152. package/dist/index.mjs.map +0 -1
  153. package/dist/limits-B4hHpyfE.mjs.map +0 -1
  154. package/dist/provider-CB0nqu0m.d.mts.map +0 -1
  155. package/dist/rolldown-runtime-BJohB4LM.mjs +0 -13
  156. package/dist/server/index.d.mts +0 -170
  157. package/dist/server/index.d.mts.map +0 -1
  158. package/dist/server/index.mjs +0 -231
  159. package/dist/server/index.mjs.map +0 -1
  160. package/dist/services-7B4hsQM7.mjs.map +0 -1
  161. package/dist/services-BZoK2VOY.d.mts.map +0 -1
  162. package/dist/sharp/index.d.mts.map +0 -1
  163. package/dist/sharp/index.mjs.map +0 -1
  164. package/dist/stores-CxraN3kt.mjs +0 -490
  165. package/dist/stores-CxraN3kt.mjs.map +0 -1
  166. package/dist/unpic/index.d.mts.map +0 -1
  167. package/dist/unpic/index.mjs.map +0 -1
  168. package/dist/upload-lVLMRJoC.d.mts +0 -160
  169. package/dist/upload-lVLMRJoC.d.mts.map +0 -1
  170. package/dist/variant-B-vyMmFB.d.mts.map +0 -1
  171. package/dist/vite/index.d.mts.map +0 -1
  172. package/dist/vite/index.mjs.map +0 -1
  173. package/dist/widths-qp3jshiF.mjs.map +0 -1
  174. package/dist/widths-upkgLdek.d.mts +0 -36
  175. package/dist/widths-upkgLdek.d.mts.map +0 -1
@@ -1,490 +0,0 @@
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
- import { KeyValueStore, RateLimiter } from "effect/persistence";
10
- // src/server/headers.ts
11
- /** Where a variant came from: the edge's cache, the server's store, or made for this request. */
12
- const From = Schema.Literals([
13
- "edge",
14
- "store",
15
- "made"
16
- ]);
17
- /** Every answer the media server gives, and nothing else: each has its status and its headers. */
18
- const Answer = Schema.TaggedUnion({
19
- /** A variant's bytes. */
20
- Variant: {
21
- etag: Schema.String,
22
- from: From
23
- },
24
- /** The variant the request's `If-None-Match` already holds. */
25
- NotModified: { etag: Schema.String },
26
- /**
27
- * No URL of this server's grammar. A later release may read it (a new format
28
- * or parameter, in a rollout), so it is kept as briefly as `NotFound`.
29
- */
30
- Malformed: {},
31
- /** No original under the hash: an upload may yet put one there. */
32
- NotFound: {},
33
- /**
34
- * A spelling of the grammar outside this space: another release (the next
35
- * one, in a rollout) may offer it, so it is kept as briefly as `NotFound`.
36
- */
37
- Unoffered: {},
38
- /**
39
- * A variant of an earlier revision, made no longer and not kept: its URL now names the
40
- * current revision's, at `location`. A 302 kept briefly, since a rollback to that revision,
41
- * or a server of it still in the rollout, answers the old URL again.
42
- */
43
- Moved: { location: Schema.String },
44
- /** The original is larger than the server reads: a server configured to read more may. */
45
- TooLarge: {},
46
- /** The transformer failed: perhaps not for good. */
47
- Failed: {},
48
- /** The client has had too many variants made lately. */
49
- RateLimited: { retryAfterSeconds: Schema.Number },
50
- /** The host's allowance is spent. */
51
- Exhausted: {},
52
- /** An upload kept; its facts are the body. */
53
- Uploaded: {},
54
- /** The upload policy refused who is asking. */
55
- Forbidden: {},
56
- /** The upload policy could not tell who is asking: an untrusted origin, a session ended. */
57
- Unauthenticated: {},
58
- /** An upload that is not an image the server reads. */
59
- Unsupported: {},
60
- /** The facts of an image named by URL; the facts are the body. */
61
- Described: {},
62
- /** No facts could be read for that URL: a host not allowed, a read that failed, no image. */
63
- Unavailable: {}
64
- });
65
- const YEAR = "public, max-age=31536000, immutable";
66
- const BRIEFLY = {
67
- "cache-control": "no-store",
68
- "cdn-cache-control": "public, max-age=60"
69
- };
70
- const EXHAUSTED_RETRY_SECONDS = "3600";
71
- /** The status of each answer. */
72
- const statusOf = Answer.match({
73
- Variant: () => 200,
74
- NotModified: () => 304,
75
- Malformed: () => 400,
76
- NotFound: () => 404,
77
- Unoffered: () => 404,
78
- Moved: () => 302,
79
- TooLarge: () => 413,
80
- Failed: () => 502,
81
- RateLimited: () => 429,
82
- Exhausted: () => 503,
83
- Uploaded: () => 201,
84
- Forbidden: () => 403,
85
- Unauthenticated: () => 401,
86
- Unsupported: () => 415,
87
- Described: () => 200,
88
- Unavailable: () => 422
89
- });
90
- /**
91
- * Every response's headers, decided in one place, so the server, the edge
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
94
- * same one configured otherwise, may answer it, so only a CDN keeps it,
95
- * briefly; a failure is never kept. Every image may be read by a canvas on
96
- * another origin, and its type is never sniffed.
97
- */
98
- const headersFor = (answer) => ({
99
- "x-content-type-options": "nosniff",
100
- "access-control-allow-origin": "*",
101
- "cross-origin-resource-policy": "cross-origin",
102
- "timing-allow-origin": "*",
103
- ...Answer.match(answer, {
104
- Variant: ({ etag, from }) => ({
105
- "cache-control": YEAR,
106
- etag,
107
- "server-timing": `media;desc="${from}"`
108
- }),
109
- NotModified: ({ etag }) => ({
110
- "cache-control": YEAR,
111
- etag
112
- }),
113
- Malformed: () => BRIEFLY,
114
- NotFound: () => BRIEFLY,
115
- Unoffered: () => BRIEFLY,
116
- Moved: ({ location }) => ({
117
- ...BRIEFLY,
118
- location
119
- }),
120
- TooLarge: () => BRIEFLY,
121
- Failed: () => ({ "cache-control": "no-store" }),
122
- RateLimited: ({ retryAfterSeconds }) => ({
123
- "cache-control": "no-store",
124
- "retry-after": String(retryAfterSeconds)
125
- }),
126
- Exhausted: () => ({
127
- "cache-control": "no-store",
128
- "retry-after": EXHAUSTED_RETRY_SECONDS
129
- }),
130
- Uploaded: () => ({ "cache-control": "no-store" }),
131
- Forbidden: () => ({ "cache-control": "no-store" }),
132
- Unauthenticated: () => ({ "cache-control": "no-store" }),
133
- Unsupported: () => ({ "cache-control": "no-store" }),
134
- Described: () => ({ "cache-control": "no-store" }),
135
- Unavailable: () => ({ "cache-control": "no-store" })
136
- })
137
- });
138
- /** Whether an `If-None-Match` names `etag` (weakly, as a GET compares, or `*`). */
139
- const matches = (ifNoneMatch, etag) => ifNoneMatch !== void 0 && ifNoneMatch.split(",").map((tag) => tag.trim().replace(/^W\//, "")).some((tag) => tag === "*" || tag === etag);
140
- // src/server/admission.ts
141
- /** The client has made too many variants lately; it may try again after `retryAfterSeconds`. */
142
- var RateLimited = class extends Schema.TaggedError()("RateLimited", { retryAfterSeconds: Schema.Number }, { httpApiStatus: 429 }) {};
143
- /**
144
- * Whether a client may have a variant made now. Asked only on a miss, after
145
- * the store and before the original is read: a variant already made costs a
146
- * read, and only making one costs work. Optional: without it, every miss is
147
- * admitted.
148
- */
149
- var Admission = class extends Context.Service()("foldkit-media/Admission") {};
150
- /**
151
- * Admission through Effect's `RateLimiter`, `limit` misses a client per
152
- * `window`, over the limiter's store (`RateLimiter.layerStoreMemory` for one
153
- * process, Redis for several). A store that fails admits the request, logged:
154
- * a limiter that is down should not take the images down with it.
155
- */
156
- const admissionRateLimiter = (options) => Layer.effect(Admission, Effect.gen(function* () {
157
- const limiter = yield* RateLimiter.RateLimiter;
158
- return { admit: (client) => limiter.consume({
159
- key: `foldkit-media:${client}`,
160
- limit: options.limit,
161
- window: options.window,
162
- algorithm: options.algorithm ?? "token-bucket",
163
- onExceeded: "fail"
164
- }).pipe(Effect.asVoid, Effect.catch((error) => Match.valueTags(error.reason, {
165
- RateLimitExceeded: ({ retryAfter }) => Effect.fail(new RateLimited({ retryAfterSeconds: Math.max(1, Math.ceil(Duration.toSeconds(retryAfter))) })),
166
- RateLimitStoreError: () => Effect.logWarning("Media: the rate limiter failed; admitting", error)
167
- }))) };
168
- }));
169
- // src/server/facts.ts
170
- /** No facts could be read for the image at `url`; `reason` says why, for the build's report. */
171
- var FactsUnavailable = class extends Schema.TaggedError()("FactsUnavailable", {
172
- url: Schema.String,
173
- reason: Schema.String
174
- }) {};
175
- const Cached = Schema.Struct({
176
- target: Schema.String,
177
- etag: Schema.OptionFromNullOr(Schema.String),
178
- asset: ImageAsset
179
- });
180
- const CachedJson = Schema.fromJsonString(Cached);
181
- const MAX_REDIRECTS = 3;
182
- const DEFAULT_MAX_BYTES$1 = 20971520;
183
- /**
184
- * The facts of an image a page names only by URL (a rich-text image, a CMS
185
- * block), so it is drawn with its box and placeholder like any other: its
186
- * original read from an allowed host and described (`describe`), with the
187
- * URL as its key. Only `https` on a host in `allow`, at its default port, is read, and every
188
- * redirect is checked again, so content cannot point the build at an
189
- * internal address. Kept in `cache`, an unchanged original is asked for
190
- * with its `ETag` and not read or inspected again.
191
- */
192
- const factsOf = (url, options) => {
193
- const unavailable = (reason) => new FactsUnavailable({
194
- url,
195
- reason
196
- });
197
- const fetchOne = options.fetch ?? ((request) => fetch(request));
198
- const maxBytes = nonNegativeInteger("maxBytes", options.maxBytes ?? DEFAULT_MAX_BYTES$1);
199
- const allowed = (target) => target.protocol === "https:" && target.port === "" && options.allow.includes(target.hostname);
200
- const cacheKey = `facts/${url}`;
201
- const readCached = Option.match(Option.fromNullishOr(options.cache), {
202
- onNone: () => Effect.succeed(Option.none()),
203
- onSome: (store) => store.get(cacheKey).pipe(Effect.map((text) => Option.flatMap(Option.fromNullishOr(text), Schema.decodeUnknownOption(CachedJson))), Effect.catch(() => Effect.succeed(Option.none())))
204
- });
205
- const request = (cached) => Effect.tryPromise({
206
- try: async () => {
207
- let target = new URL(url);
208
- for (let hop = 0; hop <= MAX_REDIRECTS; hop++) {
209
- if (!allowed(target)) return { refused: `${target.origin} is not an allowed host` };
210
- const etag = Option.flatMap(cached, (entry) => entry.target === target.href ? entry.etag : Option.none());
211
- const headers = Option.match(etag, {
212
- onNone: () => ({}),
213
- onSome: (tag) => ({ "if-none-match": tag })
214
- });
215
- const response = await fetchOne(new Request(target, {
216
- headers,
217
- redirect: "manual"
218
- }));
219
- const location = response.headers.get("location");
220
- if (response.status < 300 || response.status >= 400 || response.status === 304 || location === null) return {
221
- response,
222
- target: target.href
223
- };
224
- target = new URL(location, target);
225
- }
226
- return { refused: `more than ${MAX_REDIRECTS} redirects` };
227
- },
228
- catch: (cause) => unavailable(`the fetch failed: ${String(cause)}`)
229
- });
230
- const bytesOf = (response) => Effect.tryPromise({
231
- try: async () => {
232
- const chunks = [];
233
- let size = 0;
234
- const reader = response.body?.getReader();
235
- for (let read = await reader?.read(); read !== void 0 && !read.done; read = await reader?.read()) {
236
- size += read.value.byteLength;
237
- if (size > maxBytes) {
238
- await reader?.cancel();
239
- return;
240
- }
241
- chunks.push(read.value);
242
- }
243
- const bytes = new Uint8Array(size);
244
- let at = 0;
245
- for (const chunk of chunks) {
246
- bytes.set(chunk, at);
247
- at += chunk.byteLength;
248
- }
249
- return bytes;
250
- },
251
- catch: (cause) => unavailable(`the body could not be read: ${String(cause)}`)
252
- });
253
- return Effect.gen(function* () {
254
- const cached = yield* readCached;
255
- const answer = yield* request(cached);
256
- if ("refused" in answer) return yield* unavailable(answer.refused);
257
- const { response, target } = answer;
258
- const unchanged = Option.filter(cached, (entry) => entry.target === target);
259
- if (response.status === 304 && Option.isSome(unchanged)) return unchanged.value.asset;
260
- if (response.status !== 200) return yield* unavailable(`the original answered ${response.status}`);
261
- const bytes = yield* bytesOf(response);
262
- if (bytes === void 0) return yield* unavailable(`the original is larger than ${maxBytes} bytes`);
263
- const asset = yield* describe(url, bytes).pipe(Effect.mapError((error) => unavailable(`the original could not be inspected: ${error._tag}`)));
264
- const store = options.cache;
265
- if (store !== void 0) {
266
- const entry = Schema.encodeSync(CachedJson)({
267
- target,
268
- etag: Option.fromNullishOr(response.headers.get("etag")),
269
- asset
270
- });
271
- yield* store.set(cacheKey, entry).pipe(Effect.ignore);
272
- }
273
- return asset;
274
- });
275
- };
276
- // src/server/upload.ts
277
- /**
278
- * Where an original enters: `POST /_media/upload` takes an image's bytes,
279
- * reads its facts (`describe`, through the `Inspector`), keeps the bytes
280
- * under their content hash (`Uploads`), and answers the facts as an
281
- * `ImageAsset`, for whoever registers them (a CMS's asset row). The bytes
282
- * travel once, over HTTP; only the facts go on to the application's data.
283
- */
284
- /**
285
- * Where an original's facts enter, apart from `MediaApi`, so the variant server needs none of
286
- * its services: an upload, and the facts of an image named by URL.
287
- */
288
- const UploadApi = HttpApi.make("foldkit-media-upload").add(HttpApiGroup.make("uploads").add(HttpApiEndpoint.post("upload", "/_media/upload"), HttpApiEndpoint.get("facts", "/_media/facts")));
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
- */
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);
305
- /** The request may not upload. Why stays with the policy: the answer says only no. */
306
- var UploadForbidden = class extends Schema.TaggedError()("UploadForbidden", {}, { httpApiStatus: 403 }) {};
307
- /**
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.
317
- */
318
- var UploadPolicy = class extends Context.Service()("foldkit-media/UploadPolicy") {};
319
- /** The Cloudflare Images binding reads at most 20 MB; so does the variant server by default. */
320
- const DEFAULT_MAX_BYTES = 20971520;
321
- const answered = (answer, body) => HttpServerResponse.jsonUnsafe(body, {
322
- status: statusOf(answer),
323
- headers: headersFor(answer)
324
- });
325
- const refused = (answer) => answered(answer, { error: answer._tag });
326
- /** The body, refused past `maxBytes` as it streams: a declared length is the client's to write, so it is not read. */
327
- const bodyOf = (request, maxBytes) => Effect.gen(function* () {
328
- const chunks = [];
329
- let size = 0;
330
- yield* request.stream.pipe(Stream.runForEach((chunk) => Effect.suspend(() => {
331
- size += chunk.byteLength;
332
- if (size > maxBytes) return Effect.fail(new OriginalTooLarge({
333
- size,
334
- limit: maxBytes,
335
- unit: "bytes"
336
- }));
337
- chunks.push(chunk);
338
- return Effect.void;
339
- })));
340
- const bytes = new Uint8Array(size);
341
- let at = 0;
342
- for (const chunk of chunks) {
343
- bytes.set(chunk, at);
344
- at += chunk.byteLength;
345
- }
346
- return bytes;
347
- });
348
- /**
349
- * The upload route's handler. It asks the `UploadPolicy` first; takes only
350
- * an `image/*` body, which a browser cannot send to another origin without a
351
- * preflight this route never answers, so a cookie alone cannot upload from
352
- * another site; reads at most `maxBytes`; and refuses what the `Inspector`
353
- * cannot read as an image (415). Its answer is the facts, with the hash as
354
- * the key, `201`.
355
- */
356
- const uploadHandlers = (options = {}) => {
357
- const maxBytes = nonNegativeInteger("maxBytes", options.maxBytes ?? DEFAULT_MAX_BYTES);
358
- const encode = Schema.encodeSync(ImageAsset);
359
- return HttpApiBuilder.group(UploadApi, "uploads", (group) => Effect.gen(function* () {
360
- const uploads = yield* Uploads;
361
- const policy = yield* UploadPolicy;
362
- const services = yield* Effect.context();
363
- const facts = {
364
- ...options.facts,
365
- allow: options.facts?.allow ?? []
366
- };
367
- return group.handle("upload", ({ request }) => Effect.gen(function* () {
368
- yield* policy.admit(request, "Upload");
369
- if (!(request.headers["content-type"] ?? "").startsWith("image/")) return refused(Answer.cases.Unsupported.make({}));
370
- const bytes = yield* bodyOf(request, maxBytes);
371
- const described = yield* describe("upload", bytes);
372
- const hash = Option.getOrThrow(described.hash);
373
- const facts = {
374
- ...described,
375
- key: hash
376
- };
377
- yield* uploads.put(hash, bytes, facts);
378
- return answered(Answer.cases.Uploaded.make({}), encode(facts));
379
- }).pipe(Effect.provide(services), Effect.catchTags({
380
- UploadForbidden: () => Effect.succeed(refused(Answer.cases.Forbidden.make({}))),
381
- UploadUnauthenticated: () => Effect.succeed(refused(Answer.cases.Unauthenticated.make({}))),
382
- OriginalTooLarge: () => Effect.succeed(refused(Answer.cases.TooLarge.make({}))),
383
- TransformFailed: () => Effect.succeed(refused(Answer.cases.Unsupported.make({}))),
384
- HttpServerError: () => Effect.succeed(refused(Answer.cases.Malformed.make({})))
385
- }), Effect.withSpan("Media.upload"))).handle("facts", ({ request }) => Effect.gen(function* () {
386
- yield* policy.admit(request, "DescribeUrl");
387
- const url = new URL(request.url, "http://media.invalid").searchParams.get("url");
388
- if (url === null) return refused(Answer.cases.Malformed.make({}));
389
- return answered(Answer.cases.Described.make({}), encode(yield* factsOf(url, facts)));
390
- }).pipe(Effect.provide(services), Effect.catchTags({
391
- UploadForbidden: () => Effect.succeed(refused(Answer.cases.Forbidden.make({}))),
392
- UploadUnauthenticated: () => Effect.succeed(refused(Answer.cases.Unauthenticated.make({}))),
393
- FactsUnavailable: () => Effect.succeed(refused(Answer.cases.Unavailable.make({})))
394
- }), Effect.withSpan("Media.facts")));
395
- }));
396
- };
397
- /**
398
- * The upload route as an Effect HTTP application, registered with the
399
- * `HttpRouter` beside the variant server's, needing `Uploads`, an
400
- * `Inspector` and the `UploadPolicy`.
401
- */
402
- const uploadLayer = (options = {}) => HttpApiBuilder.layer(UploadApi).pipe(Layer.provide(uploadHandlers(options)));
403
- /**
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.
408
- */
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
- })) });
429
- /**
430
- * Uploads kept in the application's `KeyValueStore`, each under its content
431
- * hash after `prefix`: the same keys `originalsKeyValueStore` reads, with the
432
- * same `prefix`. A store that fails is a defect: an upload it dropped is lost.
433
- */
434
- const uploadsKeyValueStore = (options = {}) => Layer.effect(Uploads, Effect.gen(function* () {
435
- const store = KeyValueStore.prefix(yield* KeyValueStore.KeyValueStore, options.prefix ?? "");
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
- }))) };
487
- }));
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 };
489
-
490
- //# sourceMappingURL=stores-CxraN3kt.mjs.map
@@ -1 +0,0 @@
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 +0,0 @@
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 +0,0 @@
1
- {"version":3,"file":"index.mjs","names":["Widths.standard"],"sources":["../../src/unpic/index.ts"],"sourcesContent":["/**\n * Images on a host that resizes them itself (Shopify, Cloudinary, imgix,\n * Contentful, and the rest unpic knows), as a `Provider`: each candidate is\n * the host's own URL for that width, so no server of ours runs and nothing is\n * stored. unpic, an optional peer, reads the host from the URL and writes it.\n */\nimport { Option } from 'effect'\nimport { getProviderForUrl, transformUrl, type ImageCdn } from 'unpic'\nimport type { Encoding, Format } from '../format.js'\nimport type { Provider } from '../provider.js'\nimport * as Widths from '../widths.js'\n\nexport interface DetectOptions {\n /** The widths offered: `Widths.standard` unless given. */\n readonly widths?: Widths.Widths | undefined\n /**\n * Formats offered as `source`s, most preferred first. None unless given: the\n * `img` asks for `auto`, and the host picks the format from `Accept`.\n */\n readonly sources?: ReadonlyArray<Format> | undefined\n /** What the `img` asks for: `auto` unless given. */\n readonly fallback?: Encoding | undefined\n /** The encoder's quality, where the host takes one. */\n readonly quality?: number | undefined\n}\n\n/**\n * The provider of `url`'s host, or none when unpic knows no host for it. The\n * provider answers only for an asset on a host of the same kind (its `key` is\n * the image's URL, written on its own host), and none for a format the host does not take: unpic writes no\n * format for some hosts (Shopify's chooses from `Accept`), and a `source`\n * naming AVIF over a JPEG would be a lie.\n */\nexport const detect = (url: string, options: DetectOptions = {}): Option.Option<Provider> => {\n const cdn: ImageCdn | false = getProviderForUrl(url)\n if (cdn === false) return Option.none()\n const quality = options.quality === undefined ? {} : { quality: options.quality }\n const write = (key: string, width: number, format: Format | undefined) =>\n transformUrl({\n url: key,\n provider: cdn,\n width,\n ...quality,\n ...(format === undefined ? {} : { format }),\n })\n // A host that takes a format writes two formats differently.\n const takesFormat = write(url, 640, 'avif') !== write(url, 640, 'webp')\n return Option.some({\n widths: options.widths ?? Widths.standard,\n sources: options.sources ?? [],\n fallback: options.fallback ?? 'auto',\n url: (asset, { width, encoding }) => {\n if (getProviderForUrl(asset.key) !== cdn) return Option.none()\n if (encoding !== 'auto' && !takesFormat) return Option.none()\n return Option.fromNullishOr(\n write(asset.key, width, encoding === 'auto' ? undefined : encoding),\n )\n },\n })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAiCA,MAAa,UAAU,KAAa,UAAyB,CAAC,MAA+B;CAC3F,MAAM,MAAwB,kBAAkB,GAAG;CACnD,IAAI,QAAQ,OAAO,OAAO,OAAO,KAAK;CACtC,MAAM,UAAU,QAAQ,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,QAAQ,QAAQ;CAChF,MAAM,SAAS,KAAa,OAAe,WACzC,aAAa;EACX,KAAK;EACL,UAAU;EACV;EACA,GAAG;EACH,GAAI,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO;CAC3C,CAAC;CAEH,MAAM,cAAc,MAAM,KAAK,KAAK,MAAM,MAAM,MAAM,KAAK,KAAK,MAAM;CACtE,OAAO,OAAO,KAAK;EACjB,QAAQ,QAAQ,UAAUA;EAC1B,SAAS,QAAQ,WAAW,CAAC;EAC7B,UAAU,QAAQ,YAAY;EAC9B,MAAM,OAAO,EAAE,OAAO,eAAe;GACnC,IAAI,kBAAkB,MAAM,GAAG,MAAM,KAAK,OAAO,OAAO,KAAK;GAC7D,IAAI,aAAa,UAAU,CAAC,aAAa,OAAO,OAAO,KAAK;GAC5D,OAAO,OAAO,cACZ,MAAM,MAAM,KAAK,OAAO,aAAa,SAAS,KAAA,IAAY,QAAQ,CACpE;EACF;CACF,CAAC;AACH"}