foldkit-media 0.0.0-stage → 0.2.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.
- package/LICENSE +21 -0
- package/README.md +637 -2
- package/client.d.ts +10 -0
- package/dist/asset-Dlkss5qp.d.mts +80 -0
- package/dist/asset-Dlkss5qp.d.mts.map +1 -0
- package/dist/browser/index.d.mts +15 -0
- package/dist/browser/index.d.mts.map +1 -0
- package/dist/browser/index.mjs +69 -0
- package/dist/browser/index.mjs.map +1 -0
- package/dist/cloudflare/index.d.mts +54 -0
- package/dist/cloudflare/index.d.mts.map +1 -0
- package/dist/cloudflare/index.mjs +163 -0
- package/dist/cloudflare/index.mjs.map +1 -0
- package/dist/describe-CivKHl4x.d.mts +56 -0
- package/dist/describe-CivKHl4x.d.mts.map +1 -0
- package/dist/describe-h9F5stgR.mjs +174 -0
- package/dist/describe-h9F5stgR.mjs.map +1 -0
- package/dist/errors-qETj7Pgi.mjs +21 -0
- package/dist/errors-qETj7Pgi.mjs.map +1 -0
- package/dist/format-BmfnR4jg.mjs +21 -0
- package/dist/format-BmfnR4jg.mjs.map +1 -0
- package/dist/icon-ClqtprHT.d.mts +89 -0
- package/dist/icon-ClqtprHT.d.mts.map +1 -0
- package/dist/icon-CowP8fQ0.mjs +185 -0
- package/dist/icon-CowP8fQ0.mjs.map +1 -0
- package/dist/icons/index.d.mts +51 -0
- package/dist/icons/index.d.mts.map +1 -0
- package/dist/icons/index.mjs +320 -0
- package/dist/icons/index.mjs.map +1 -0
- package/dist/index.d.mts +160 -0
- package/dist/index.d.mts.map +1 -0
- package/dist/index.mjs +326 -0
- package/dist/index.mjs.map +1 -0
- package/dist/limits-B6C9OOLl.mjs +13 -0
- package/dist/limits-B6C9OOLl.mjs.map +1 -0
- package/dist/provider-g0Vlvlrb.d.mts +81 -0
- package/dist/provider-g0Vlvlrb.d.mts.map +1 -0
- package/dist/rolldown-runtime-8H4AJuhK.mjs +14 -0
- package/dist/server/index.d.mts +181 -0
- package/dist/server/index.d.mts.map +1 -0
- package/dist/server/index.mjs +235 -0
- package/dist/server/index.mjs.map +1 -0
- package/dist/services-8_h0ubLB.d.mts +54 -0
- package/dist/services-8_h0ubLB.d.mts.map +1 -0
- package/dist/services-BeakQl7F.mjs +39 -0
- package/dist/services-BeakQl7F.mjs.map +1 -0
- package/dist/sharp/index.d.mts +21 -0
- package/dist/sharp/index.d.mts.map +1 -0
- package/dist/sharp/index.mjs +103 -0
- package/dist/sharp/index.mjs.map +1 -0
- package/dist/stores-BtmSl8X3.mjs +448 -0
- package/dist/stores-BtmSl8X3.mjs.map +1 -0
- package/dist/unpic/index.d.mts +27 -0
- package/dist/unpic/index.d.mts.map +1 -0
- package/dist/unpic/index.mjs +44 -0
- package/dist/unpic/index.mjs.map +1 -0
- package/dist/upload-kp0_oK76.d.mts +131 -0
- package/dist/upload-kp0_oK76.d.mts.map +1 -0
- package/dist/variant-BOg1M0Wj.d.mts +69 -0
- package/dist/variant-BOg1M0Wj.d.mts.map +1 -0
- package/dist/vite/index.d.mts +41 -0
- package/dist/vite/index.d.mts.map +1 -0
- package/dist/vite/index.mjs +330 -0
- package/dist/vite/index.mjs.map +1 -0
- package/dist/widths-BEa9odY6.mjs +40 -0
- package/dist/widths-BEa9odY6.mjs.map +1 -0
- package/dist/widths-Cg7-x89y.d.mts +38 -0
- package/dist/widths-Cg7-x89y.d.mts.map +1 -0
- package/package.json +107 -3
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import { Option, Schema } from "effect";
|
|
2
|
+
//#region src/asset.d.ts
|
|
3
|
+
/** What stands in an image's place until it loads. */
|
|
4
|
+
declare const Placeholder: Schema.TaggedUnion<{
|
|
5
|
+
readonly Color: Schema.TaggedStruct<"Color", {
|
|
6
|
+
readonly value: Schema.String;
|
|
7
|
+
}>;
|
|
8
|
+
readonly LowRes: Schema.TaggedStruct<"LowRes", {}>;
|
|
9
|
+
readonly ThumbHash: Schema.TaggedStruct<"ThumbHash", {
|
|
10
|
+
readonly hash: Schema.String;
|
|
11
|
+
}>;
|
|
12
|
+
}>;
|
|
13
|
+
type Placeholder = typeof Placeholder.Type;
|
|
14
|
+
/** Where an image's subject is, from its top left (0, 0) to its bottom right (1, 1). */
|
|
15
|
+
declare const Focus: Schema.Struct<{
|
|
16
|
+
readonly x: Schema.Finite;
|
|
17
|
+
readonly y: Schema.Finite;
|
|
18
|
+
}>;
|
|
19
|
+
type Focus = typeof Focus.Type;
|
|
20
|
+
/**
|
|
21
|
+
* The facts of one original image, derived from it once and stored beside it.
|
|
22
|
+
* `key` is where the original lives, as its provider reads it. `hash` is the
|
|
23
|
+
* original's content hash, absent for an image never read; `alpha` says
|
|
24
|
+
* whether it has transparent pixels. `focus`, the one fact an editor sets
|
|
25
|
+
* rather than one derived, is where a crop keeps the subject; a stored asset
|
|
26
|
+
* without it reads as none.
|
|
27
|
+
*/
|
|
28
|
+
declare const ImageAsset: Schema.Struct<{
|
|
29
|
+
readonly key: Schema.String;
|
|
30
|
+
readonly width: Schema.Int;
|
|
31
|
+
readonly height: Schema.Int;
|
|
32
|
+
readonly alpha: Schema.Boolean;
|
|
33
|
+
readonly hash: Schema.OptionFromNullOr<Schema.String>;
|
|
34
|
+
readonly placeholder: Schema.OptionFromNullOr<Schema.TaggedUnion<{
|
|
35
|
+
readonly Color: Schema.TaggedStruct<"Color", {
|
|
36
|
+
readonly value: Schema.String;
|
|
37
|
+
}>;
|
|
38
|
+
readonly LowRes: Schema.TaggedStruct<"LowRes", {}>;
|
|
39
|
+
readonly ThumbHash: Schema.TaggedStruct<"ThumbHash", {
|
|
40
|
+
readonly hash: Schema.String;
|
|
41
|
+
}>;
|
|
42
|
+
}>>;
|
|
43
|
+
readonly focus: Schema.OptionFromOptionalNullOr<Schema.Struct<{
|
|
44
|
+
readonly x: Schema.Finite;
|
|
45
|
+
readonly y: Schema.Finite;
|
|
46
|
+
}>>;
|
|
47
|
+
}>;
|
|
48
|
+
type ImageAsset = typeof ImageAsset.Type;
|
|
49
|
+
/**
|
|
50
|
+
* Facts that name the original by its content hash: what a build or an upload
|
|
51
|
+
* answers, and what `Provider.hosted` needs to write a URL.
|
|
52
|
+
*/
|
|
53
|
+
type HashedAsset = ImageAsset & {
|
|
54
|
+
readonly hash: Option.Some<string>;
|
|
55
|
+
};
|
|
56
|
+
declare const isHashed: (asset: ImageAsset) => asset is HashedAsset;
|
|
57
|
+
/** `ImageAsset`, refusing facts with no content hash. */
|
|
58
|
+
declare const HashedAsset: Schema.refine<HashedAsset, Schema.Struct<{
|
|
59
|
+
readonly key: Schema.String;
|
|
60
|
+
readonly width: Schema.Int;
|
|
61
|
+
readonly height: Schema.Int;
|
|
62
|
+
readonly alpha: Schema.Boolean;
|
|
63
|
+
readonly hash: Schema.OptionFromNullOr<Schema.String>;
|
|
64
|
+
readonly placeholder: Schema.OptionFromNullOr<Schema.TaggedUnion<{
|
|
65
|
+
readonly Color: Schema.TaggedStruct<"Color", {
|
|
66
|
+
readonly value: Schema.String;
|
|
67
|
+
}>;
|
|
68
|
+
readonly LowRes: Schema.TaggedStruct<"LowRes", {}>;
|
|
69
|
+
readonly ThumbHash: Schema.TaggedStruct<"ThumbHash", {
|
|
70
|
+
readonly hash: Schema.String;
|
|
71
|
+
}>;
|
|
72
|
+
}>>;
|
|
73
|
+
readonly focus: Schema.OptionFromOptionalNullOr<Schema.Struct<{
|
|
74
|
+
readonly x: Schema.Finite;
|
|
75
|
+
readonly y: Schema.Finite;
|
|
76
|
+
}>>;
|
|
77
|
+
}>>;
|
|
78
|
+
//#endregion
|
|
79
|
+
export { isHashed as a, Placeholder as i, HashedAsset as n, ImageAsset as r, Focus as t };
|
|
80
|
+
//# sourceMappingURL=asset-Dlkss5qp.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"asset-Dlkss5qp.d.mts","names":[],"sources":["../src/asset.ts"],"mappings":";;;cAuCa,aAAW,OAAA;;;;;;;;;KAYZ,qBAAqB,YAAY;;cAOhC,OAAK,OAAA;;;;KACN,eAAe,MAAM;;;;;;;;;cAUpB,YAAU,OAAA;;;;;;;;;;;;;;;;;;;;KASX,oBAAoB,WAAW;;;;;KAM/B,cAAc;WAAwB,MAAM,OAAO;;cAElD,WAAQ,OAAW,eAAa,SAAS;;cAGzC,aAAW,OAAA,OAAA,aAAA,OAAA"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { n as Inspector } from "../describe-CivKHl4x.mjs";
|
|
2
|
+
import { Layer } from "effect";
|
|
3
|
+
//#region src/browser/index.d.ts
|
|
4
|
+
/**
|
|
5
|
+
* The `Inspector` in a browser or a web worker: the size from the decoded
|
|
6
|
+
* picture, a thumbnail drawn on an `OffscreenCanvas`, and alpha where any
|
|
7
|
+
* decoded pixel is not opaque. A file the browser cannot decode is
|
|
8
|
+
* `TransformFailed`; one above `maxPixels` is `OriginalTooLarge`, its pixels
|
|
9
|
+
* released at once.
|
|
10
|
+
*/
|
|
11
|
+
export declare const inspectorBrowser: (options?: {
|
|
12
|
+
readonly maxPixels?: number;
|
|
13
|
+
}) => Layer.Layer<Inspector>;
|
|
14
|
+
//#endregion
|
|
15
|
+
//# sourceMappingURL=index.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/browser/index.ts"],"mappings":";;;;;;;;;;qBA4Ba,mBAAgB;WACP;MACnB,MAAM,MAAM"}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { t as Inspector } from "../describe-h9F5stgR.mjs";
|
|
2
|
+
import { t as nonNegativeInteger } from "../limits-B6C9OOLl.mjs";
|
|
3
|
+
import { i as TransformFailed, n as OriginalTooLarge } from "../errors-qETj7Pgi.mjs";
|
|
4
|
+
import { Effect, Layer, Option } from "effect";
|
|
5
|
+
//#region src/browser/index.ts
|
|
6
|
+
/**
|
|
7
|
+
* An image's facts read in the browser, where it is chosen: `describe(key,
|
|
8
|
+
* bytes)` over `inspectorBrowser()` gives its `ImageAsset`, size, hash and
|
|
9
|
+
* ThumbHash included, before it is uploaded or stored, with no server to ask.
|
|
10
|
+
* The browser's own decoder reads it, so what it cannot show is refused here.
|
|
11
|
+
*/
|
|
12
|
+
const THUMBNAIL_SIDE = 100;
|
|
13
|
+
const ALPHA_TILE_SIDE = 512;
|
|
14
|
+
const DEFAULT_MAX_PIXELS = 5e7;
|
|
15
|
+
/**
|
|
16
|
+
* The `Inspector` in a browser or a web worker: the size from the decoded
|
|
17
|
+
* picture, a thumbnail drawn on an `OffscreenCanvas`, and alpha where any
|
|
18
|
+
* decoded pixel is not opaque. A file the browser cannot decode is
|
|
19
|
+
* `TransformFailed`; one above `maxPixels` is `OriginalTooLarge`, its pixels
|
|
20
|
+
* released at once.
|
|
21
|
+
*/
|
|
22
|
+
const inspectorBrowser = (options = {}) => {
|
|
23
|
+
const maxPixels = nonNegativeInteger("maxPixels", options.maxPixels ?? DEFAULT_MAX_PIXELS);
|
|
24
|
+
return Layer.succeed(Inspector, { inspect: (bytes) => Effect.acquireUseRelease(Effect.tryPromise({
|
|
25
|
+
try: () => createImageBitmap(new Blob([bytes])),
|
|
26
|
+
catch: () => new TransformFailed({})
|
|
27
|
+
}), (bitmap) => Effect.gen(function* () {
|
|
28
|
+
const { width, height } = bitmap;
|
|
29
|
+
if (width * height > maxPixels) return yield* new OriginalTooLarge({
|
|
30
|
+
size: width * height,
|
|
31
|
+
limit: maxPixels,
|
|
32
|
+
unit: "pixels"
|
|
33
|
+
});
|
|
34
|
+
const alphaCanvas = new OffscreenCanvas(Math.min(width, ALPHA_TILE_SIDE), Math.min(height, ALPHA_TILE_SIDE));
|
|
35
|
+
const alphaContext = alphaCanvas.getContext("2d");
|
|
36
|
+
if (alphaContext === null) return yield* new TransformFailed({});
|
|
37
|
+
let alpha = false;
|
|
38
|
+
for (let top = 0; top < height && !alpha; top += ALPHA_TILE_SIDE) for (let left = 0; left < width && !alpha; left += ALPHA_TILE_SIDE) {
|
|
39
|
+
const tileWidth = Math.min(ALPHA_TILE_SIDE, width - left);
|
|
40
|
+
const tileHeight = Math.min(ALPHA_TILE_SIDE, height - top);
|
|
41
|
+
alphaCanvas.width = tileWidth;
|
|
42
|
+
alphaCanvas.height = tileHeight;
|
|
43
|
+
alphaContext.drawImage(bitmap, left, top, tileWidth, tileHeight, 0, 0, tileWidth, tileHeight);
|
|
44
|
+
const pixels = alphaContext.getImageData(0, 0, tileWidth, tileHeight).data;
|
|
45
|
+
for (let at = 3; at < pixels.length && !alpha; at += 4) alpha = pixels[at] < 255;
|
|
46
|
+
}
|
|
47
|
+
const scale = Math.min(1, THUMBNAIL_SIDE / Math.max(width, height));
|
|
48
|
+
const side = (length) => Math.max(1, Math.round(length * scale));
|
|
49
|
+
const canvas = new OffscreenCanvas(side(width), side(height));
|
|
50
|
+
const context = canvas.getContext("2d");
|
|
51
|
+
if (context === null) return yield* new TransformFailed({});
|
|
52
|
+
context.drawImage(bitmap, 0, 0, canvas.width, canvas.height);
|
|
53
|
+
const rgba = new Uint8Array(context.getImageData(0, 0, canvas.width, canvas.height).data.buffer);
|
|
54
|
+
return {
|
|
55
|
+
width,
|
|
56
|
+
height,
|
|
57
|
+
alpha,
|
|
58
|
+
thumbnail: Option.some({
|
|
59
|
+
width: canvas.width,
|
|
60
|
+
height: canvas.height,
|
|
61
|
+
rgba
|
|
62
|
+
})
|
|
63
|
+
};
|
|
64
|
+
}), (bitmap) => Effect.sync(() => bitmap.close())) });
|
|
65
|
+
};
|
|
66
|
+
//#endregion
|
|
67
|
+
export { inspectorBrowser };
|
|
68
|
+
|
|
69
|
+
//# sourceMappingURL=index.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.mjs","names":[],"sources":["../../src/browser/index.ts"],"sourcesContent":["/**\n * An image's facts read in the browser, where it is chosen: `describe(key,\n * bytes)` over `inspectorBrowser()` gives its `ImageAsset`, size, hash and\n * ThumbHash included, before it is uploaded or stored, with no server to ask.\n * The browser's own decoder reads it, so what it cannot show is refused here.\n */\nimport { Effect, Layer, Option } from 'effect'\nimport { Inspector } from '../describe.js'\nimport { nonNegativeInteger } from '../limits.js'\nimport { OriginalTooLarge, TransformFailed } from '../server/errors.js'\n\n// A ThumbHash is made from at most 100 pixels a side.\nconst THUMBNAIL_SIDE = 100\n\n// Bound each canvas readback while still checking every decoded pixel.\nconst ALPHA_TILE_SIDE = 512\n\n// About 50 megapixels, as the Node inspector. The browser decodes the file before its size is\n// known, so this bounds the canvas work after the decode, not the decode itself.\nconst DEFAULT_MAX_PIXELS = 50_000_000\n\n/**\n * The `Inspector` in a browser or a web worker: the size from the decoded\n * picture, a thumbnail drawn on an `OffscreenCanvas`, and alpha where any\n * decoded pixel is not opaque. A file the browser cannot decode is\n * `TransformFailed`; one above `maxPixels` is `OriginalTooLarge`, its pixels\n * released at once.\n */\nexport const inspectorBrowser = (\n options: { readonly maxPixels?: number } = {},\n): Layer.Layer<Inspector> => {\n const maxPixels = nonNegativeInteger('maxPixels', options.maxPixels ?? DEFAULT_MAX_PIXELS)\n return Layer.succeed(Inspector, {\n inspect: bytes =>\n Effect.acquireUseRelease(\n Effect.tryPromise({\n try: () => createImageBitmap(new Blob([bytes])),\n catch: () => new TransformFailed({}),\n }),\n bitmap =>\n Effect.gen(function* () {\n const { width, height } = bitmap\n if (width * height > maxPixels) {\n return yield* new OriginalTooLarge({\n size: width * height,\n limit: maxPixels,\n unit: 'pixels',\n })\n }\n const alphaCanvas = new OffscreenCanvas(\n Math.min(width, ALPHA_TILE_SIDE),\n Math.min(height, ALPHA_TILE_SIDE),\n )\n const alphaContext = alphaCanvas.getContext('2d')\n if (alphaContext === null) return yield* new TransformFailed({})\n let alpha = false\n for (let top = 0; top < height && !alpha; top += ALPHA_TILE_SIDE) {\n for (let left = 0; left < width && !alpha; left += ALPHA_TILE_SIDE) {\n const tileWidth = Math.min(ALPHA_TILE_SIDE, width - left)\n const tileHeight = Math.min(ALPHA_TILE_SIDE, height - top)\n alphaCanvas.width = tileWidth\n alphaCanvas.height = tileHeight\n alphaContext.drawImage(\n bitmap,\n left,\n top,\n tileWidth,\n tileHeight,\n 0,\n 0,\n tileWidth,\n tileHeight,\n )\n const pixels = alphaContext.getImageData(0, 0, tileWidth, tileHeight).data\n for (let at = 3; at < pixels.length && !alpha; at += 4) alpha = pixels[at]! < 255\n }\n }\n const scale = Math.min(1, THUMBNAIL_SIDE / Math.max(width, height))\n const side = (length: number) => Math.max(1, Math.round(length * scale))\n const canvas = new OffscreenCanvas(side(width), side(height))\n const context = canvas.getContext('2d')\n if (context === null) return yield* new TransformFailed({})\n context.drawImage(bitmap, 0, 0, canvas.width, canvas.height)\n const rgba = new Uint8Array(\n context.getImageData(0, 0, canvas.width, canvas.height).data.buffer,\n )\n return {\n width,\n height,\n alpha,\n thumbnail: Option.some({ width: canvas.width, height: canvas.height, rgba }),\n }\n }),\n bitmap => Effect.sync(() => bitmap.close()),\n ),\n })\n}\n"],"mappings":";;;;;;;;;;;AAYA,MAAM,iBAAiB;AAGvB,MAAM,kBAAkB;AAIxB,MAAM,qBAAqB;;;;;;;;AAS3B,MAAa,oBACX,UAA2C,CAAC,MACjB;CAC3B,MAAM,YAAY,mBAAmB,aAAa,QAAQ,aAAa,kBAAkB;CACzF,OAAO,MAAM,QAAQ,WAAW,EAC9B,UAAS,UACP,OAAO,kBACL,OAAO,WAAW;EAChB,WAAW,kBAAkB,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;EAC9C,aAAa,IAAI,gBAAgB,CAAC,CAAC;CACrC,CAAC,IACD,WACE,OAAO,IAAI,aAAa;EACtB,MAAM,EAAE,OAAO,WAAW;EAC1B,IAAI,QAAQ,SAAS,WACnB,OAAO,OAAO,IAAI,iBAAiB;GACjC,MAAM,QAAQ;GACd,OAAO;GACP,MAAM;EACR,CAAC;EAEH,MAAM,cAAc,IAAI,gBACtB,KAAK,IAAI,OAAO,eAAe,GAC/B,KAAK,IAAI,QAAQ,eAAe,CAClC;EACA,MAAM,eAAe,YAAY,WAAW,IAAI;EAChD,IAAI,iBAAiB,MAAM,OAAO,OAAO,IAAI,gBAAgB,CAAC,CAAC;EAC/D,IAAI,QAAQ;EACZ,KAAK,IAAI,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,OAAO,iBAC/C,KAAK,IAAI,OAAO,GAAG,OAAO,SAAS,CAAC,OAAO,QAAQ,iBAAiB;GAClE,MAAM,YAAY,KAAK,IAAI,iBAAiB,QAAQ,IAAI;GACxD,MAAM,aAAa,KAAK,IAAI,iBAAiB,SAAS,GAAG;GACzD,YAAY,QAAQ;GACpB,YAAY,SAAS;GACrB,aAAa,UACX,QACA,MACA,KACA,WACA,YACA,GACA,GACA,WACA,UACF;GACA,MAAM,SAAS,aAAa,aAAa,GAAG,GAAG,WAAW,UAAU,CAAC,CAAC;GACtE,KAAK,IAAI,KAAK,GAAG,KAAK,OAAO,UAAU,CAAC,OAAO,MAAM,GAAG,QAAQ,OAAO,MAAO;EAChF;EAEF,MAAM,QAAQ,KAAK,IAAI,GAAG,iBAAiB,KAAK,IAAI,OAAO,MAAM,CAAC;EAClE,MAAM,QAAQ,WAAmB,KAAK,IAAI,GAAG,KAAK,MAAM,SAAS,KAAK,CAAC;EACvE,MAAM,SAAS,IAAI,gBAAgB,KAAK,KAAK,GAAG,KAAK,MAAM,CAAC;EAC5D,MAAM,UAAU,OAAO,WAAW,IAAI;EACtC,IAAI,YAAY,MAAM,OAAO,OAAO,IAAI,gBAAgB,CAAC,CAAC;EAC1D,QAAQ,UAAU,QAAQ,GAAG,GAAG,OAAO,OAAO,OAAO,MAAM;EAC3D,MAAM,OAAO,IAAI,WACf,QAAQ,aAAa,GAAG,GAAG,OAAO,OAAO,OAAO,MAAM,CAAC,CAAC,KAAK,MAC/D;EACA,OAAO;GACL;GACA;GACA;GACA,WAAW,OAAO,KAAK;IAAE,OAAO,OAAO;IAAO,QAAQ,OAAO;IAAQ;GAAK,CAAC;EAC7E;CACF,CAAC,IACH,WAAU,OAAO,WAAW,OAAO,MAAM,CAAC,CAC5C,EACJ,CAAC;AACH"}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import { n as Inspector } from "../describe-CivKHl4x.mjs";
|
|
2
|
+
import { a as Uploads, p as Admission } from "../upload-kp0_oK76.mjs";
|
|
3
|
+
import { a as Transformer, i as Originals, o as Variants } from "../services-8_h0ubLB.mjs";
|
|
4
|
+
import { Layer } from "effect";
|
|
5
|
+
import { KeyValueStore } from "effect/persistence";
|
|
6
|
+
import { Cache as Cache$1, ImagesBinding, R2Bucket, RateLimit } from "@cloudflare/workers-types";
|
|
7
|
+
//#region src/cloudflare/index.d.ts
|
|
8
|
+
/** Originals in an R2 bucket, each under its content hash. */
|
|
9
|
+
export declare const originalsR2: (bucket: R2Bucket) => Layer.Layer<Originals>;
|
|
10
|
+
/** Uploads into an R2 bucket, each under its content hash: what `originalsR2` reads. */
|
|
11
|
+
export declare const uploadsR2: (bucket: R2Bucket) => Layer.Layer<Uploads>;
|
|
12
|
+
/**
|
|
13
|
+
* The Images binding as the transformer. It scales down, never up, and names
|
|
14
|
+
* the format, so the variant is what its URL says. A spent allowance is
|
|
15
|
+
* `QuotaExhausted`; any other refusal is `TransformFailed`, its reason logged.
|
|
16
|
+
*/
|
|
17
|
+
export declare const transformerImages: (images: ImagesBinding) => Layer.Layer<Transformer>;
|
|
18
|
+
/**
|
|
19
|
+
* An R2 bucket as an Effect `KeyValueStore`, for anything that keeps bytes by
|
|
20
|
+
* key: `variantsKeyValueStore`, `originalsKeyValueStore`, or the
|
|
21
|
+
* application's own. `clear` and `size` list the whole bucket.
|
|
22
|
+
*/
|
|
23
|
+
export declare const keyValueStoreR2: (bucket: R2Bucket) => Layer.Layer<KeyValueStore.KeyValueStore>;
|
|
24
|
+
/**
|
|
25
|
+
* Variants kept in R2 under `prefix`, so one made last month is not made, and
|
|
26
|
+
* billed, again: `variantsKeyValueStore` over `keyValueStoreR2`. With `cache`,
|
|
27
|
+
* the Cache API stands in front of it: `true` for the Worker's
|
|
28
|
+
* `caches.default`, or a cache of your own (`await caches.open(…)`).
|
|
29
|
+
*/
|
|
30
|
+
export declare const variantsR2: (bucket: R2Bucket, options?: {
|
|
31
|
+
readonly prefix?: string;
|
|
32
|
+
readonly cache?: Cache$1 | true;
|
|
33
|
+
}) => Layer.Layer<Variants>;
|
|
34
|
+
/**
|
|
35
|
+
* Admission through a Workers rate-limit binding (`[[ratelimits]]`), whose
|
|
36
|
+
* limit and period are its configuration. It answers yes or no, not when, so
|
|
37
|
+
* a refusal says to retry after `retryAfterSeconds` (the binding's period, 60
|
|
38
|
+
* by default). A binding that fails admits the request, logged.
|
|
39
|
+
*/
|
|
40
|
+
export declare const admissionRateLimit: (binding: RateLimit, options?: {
|
|
41
|
+
readonly retryAfterSeconds?: number;
|
|
42
|
+
}) => Layer.Layer<Admission>;
|
|
43
|
+
/**
|
|
44
|
+
* The `Inspector` through the Images binding: an original's size from `info`,
|
|
45
|
+
* which costs no transformation. It makes no thumbnail, since raw pixels are
|
|
46
|
+
* not offered offline and could not be tested, so an original described here
|
|
47
|
+
* has no ThumbHash; and as `info` does not say whether pixels are
|
|
48
|
+
* transparent, every format but JPEG is taken to be, which costs a
|
|
49
|
+
* placeholder, never shows a wrong one. An SVG, which has no size in pixels,
|
|
50
|
+
* is refused.
|
|
51
|
+
*/
|
|
52
|
+
export declare const inspectorImages: (images: ImagesBinding) => Layer.Layer<Inspector>;
|
|
53
|
+
//#endregion
|
|
54
|
+
//# sourceMappingURL=index.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.mts","names":["Cache"],"sources":["../../src/cloudflare/index.ts"],"mappings":";;;;;;;;qBAuBa,cAAW,QAAY,aAAW,MAAM,MAAM;;qBAiB9C,YAAS,QAAY,aAAW,MAAM,MAAM;;;;;;qBAgB5C,oBAAiB,QAAY,kBAAgB,MAAM,MAAM;;;;;;qBAsCzD,kBAAe,QAAY,aAAW,MAAM,MAAM,cAAc;;;;;;;qBA2HhE,aAAU,QACb,UAAQ;WACI;WAA0B,QAAQA;MACrD,MAAM,MAAM;;;;;;;qBAiBF,qBAAkB,SACpB,WAAS;WACE;MACnB,MAAM,MAAM;;;;;;;;;;qBA0BF,kBAAe,QAAY,kBAAgB,MAAM,MAAM"}
|
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
import { t as Inspector } from "../describe-h9F5stgR.mjs";
|
|
2
|
+
import { i as TransformFailed, r as QuotaExhausted, t as OriginalNotFound } from "../errors-qETj7Pgi.mjs";
|
|
3
|
+
import { h as RateLimited, m as Admission, s as Uploads, t as makeVariants } from "../stores-BtmSl8X3.mjs";
|
|
4
|
+
import { n as Transformer, r as Variants, t as Originals } from "../services-BeakQl7F.mjs";
|
|
5
|
+
import { Effect, Layer, Option } from "effect";
|
|
6
|
+
import { KeyValueStore } from "effect/persistence";
|
|
7
|
+
//#region src/cloudflare/index.ts
|
|
8
|
+
/** Originals in an R2 bucket, each under its content hash. */
|
|
9
|
+
const originalsR2 = (bucket) => Layer.succeed(Originals, { get: (hash) => Effect.promise(() => bucket.get(hash)).pipe(Effect.flatMap((object) => object === null ? Effect.fail(new OriginalNotFound({ hash })) : Effect.succeed({
|
|
10
|
+
body: object.body,
|
|
11
|
+
size: object.size
|
|
12
|
+
}))) });
|
|
13
|
+
/** Uploads into an R2 bucket, each under its content hash: what `originalsR2` reads. */
|
|
14
|
+
const uploadsR2 = (bucket) => Layer.succeed(Uploads, { put: (hash, bytes) => Effect.promise(() => bucket.put(hash, bytes)).pipe(Effect.asVoid) });
|
|
15
|
+
const QUOTA_EXHAUSTED = 9422;
|
|
16
|
+
const isImagesError = (cause) => typeof cause === "object" && cause !== null && typeof Reflect.get(cause, "code") === "number";
|
|
17
|
+
/**
|
|
18
|
+
* The Images binding as the transformer. It scales down, never up, and names
|
|
19
|
+
* the format, so the variant is what its URL says. A spent allowance is
|
|
20
|
+
* `QuotaExhausted`; any other refusal is `TransformFailed`, its reason logged.
|
|
21
|
+
*/
|
|
22
|
+
const transformerImages = (images) => Layer.succeed(Transformer, { transform: (original, variant) => Effect.tryPromise({
|
|
23
|
+
try: async () => {
|
|
24
|
+
const result = await images.input(original.body).transform({
|
|
25
|
+
width: variant.width,
|
|
26
|
+
fit: "scale-down"
|
|
27
|
+
}).output({
|
|
28
|
+
format: `image/${variant.format}`,
|
|
29
|
+
...Option.match(variant.quality, {
|
|
30
|
+
onNone: () => ({}),
|
|
31
|
+
onSome: (quality) => ({ quality })
|
|
32
|
+
})
|
|
33
|
+
});
|
|
34
|
+
const response = result.response();
|
|
35
|
+
return {
|
|
36
|
+
bytes: new Uint8Array(await response.arrayBuffer()),
|
|
37
|
+
contentType: result.contentType()
|
|
38
|
+
};
|
|
39
|
+
},
|
|
40
|
+
catch: (cause) => cause
|
|
41
|
+
}).pipe(Effect.catch((cause) => isImagesError(cause) && cause.code === QUOTA_EXHAUSTED ? Effect.fail(new QuotaExhausted({})) : Effect.logWarning("Media.transform failed", cause).pipe(Effect.andThen(Effect.fail(new TransformFailed({})))))) });
|
|
42
|
+
/**
|
|
43
|
+
* An R2 bucket as an Effect `KeyValueStore`, for anything that keeps bytes by
|
|
44
|
+
* key: `variantsKeyValueStore`, `originalsKeyValueStore`, or the
|
|
45
|
+
* application's own. `clear` and `size` list the whole bucket.
|
|
46
|
+
*/
|
|
47
|
+
const keyValueStoreR2 = (bucket) => Layer.succeed(KeyValueStore.KeyValueStore, r2Store(bucket));
|
|
48
|
+
const r2Store = (bucket) => {
|
|
49
|
+
const attempt = (method, key, run) => Effect.tryPromise({
|
|
50
|
+
try: run,
|
|
51
|
+
catch: (cause) => new KeyValueStore.KeyValueStoreError({
|
|
52
|
+
message: `R2 ${method} failed`,
|
|
53
|
+
method,
|
|
54
|
+
...key === void 0 ? {} : { key },
|
|
55
|
+
cause
|
|
56
|
+
})
|
|
57
|
+
});
|
|
58
|
+
const keys = async () => {
|
|
59
|
+
const found = [];
|
|
60
|
+
let cursor;
|
|
61
|
+
do {
|
|
62
|
+
const page = await bucket.list(cursor === void 0 ? {} : { cursor });
|
|
63
|
+
found.push(...page.objects.map((object) => object.key));
|
|
64
|
+
cursor = page.truncated ? page.cursor : void 0;
|
|
65
|
+
} while (cursor !== void 0);
|
|
66
|
+
return found;
|
|
67
|
+
};
|
|
68
|
+
return KeyValueStore.make({
|
|
69
|
+
get: (key) => attempt("get", key, async () => (await bucket.get(key))?.text()),
|
|
70
|
+
getUint8Array: (key) => attempt("getUint8Array", key, async () => {
|
|
71
|
+
const object = await bucket.get(key);
|
|
72
|
+
return object === null ? void 0 : new Uint8Array(await object.arrayBuffer());
|
|
73
|
+
}),
|
|
74
|
+
set: (key, value) => attempt("set", key, async () => void await bucket.put(key, value)),
|
|
75
|
+
remove: (key) => attempt("remove", key, () => bucket.delete(key)),
|
|
76
|
+
clear: attempt("clear", void 0, async () => {
|
|
77
|
+
const all = await keys();
|
|
78
|
+
for (let at = 0; at < all.length; at += 1e3) await bucket.delete(all.slice(at, at + 1e3));
|
|
79
|
+
}),
|
|
80
|
+
size: attempt("size", void 0, async () => (await keys()).length)
|
|
81
|
+
});
|
|
82
|
+
};
|
|
83
|
+
const edgeKey = (key) => `https://foldkit-media.invalid/${key}`;
|
|
84
|
+
/**
|
|
85
|
+
* Variants with the edge's Cache API in front: read there first, and filled
|
|
86
|
+
* from what is kept behind it, so a popular variant is served from the edge.
|
|
87
|
+
*/
|
|
88
|
+
const withEdge = (behind, edge) => {
|
|
89
|
+
const fill = (key, encoded) => Effect.tryPromise({
|
|
90
|
+
try: () => edge.put(edgeKey(key), new Response(encoded.bytes, { headers: {
|
|
91
|
+
"content-type": encoded.contentType,
|
|
92
|
+
"cache-control": "public, max-age=31536000, immutable"
|
|
93
|
+
} })),
|
|
94
|
+
catch: (cause) => cause
|
|
95
|
+
}).pipe(Effect.catch((cause) => Effect.logWarning("Media: the edge cache failed a write", cause)));
|
|
96
|
+
const behindEdge = (key) => behind.get(key).pipe(Effect.tap((found) => Option.match(found, {
|
|
97
|
+
onNone: () => Effect.void,
|
|
98
|
+
onSome: (kept) => fill(key, kept.encoded)
|
|
99
|
+
})));
|
|
100
|
+
return {
|
|
101
|
+
get: (key) => Effect.tryPromise({
|
|
102
|
+
try: async () => {
|
|
103
|
+
const hit = await edge.match(edgeKey(key));
|
|
104
|
+
return hit === void 0 ? Option.none() : Option.some({
|
|
105
|
+
encoded: {
|
|
106
|
+
bytes: new Uint8Array(await hit.arrayBuffer()),
|
|
107
|
+
contentType: hit.headers.get("content-type") ?? "application/octet-stream"
|
|
108
|
+
},
|
|
109
|
+
from: "edge"
|
|
110
|
+
});
|
|
111
|
+
},
|
|
112
|
+
catch: (cause) => cause
|
|
113
|
+
}).pipe(Effect.catch((cause) => Effect.logWarning("Media: the edge cache failed a read", cause).pipe(Effect.as(Option.none()))), Effect.flatMap((found) => Option.isSome(found) ? Effect.succeed(found) : behindEdge(key))),
|
|
114
|
+
put: (key, encoded) => behind.put(key, encoded).pipe(Effect.andThen(fill(key, encoded)))
|
|
115
|
+
};
|
|
116
|
+
};
|
|
117
|
+
const cacheOf = (cache) => {
|
|
118
|
+
if (cache !== true) return cache;
|
|
119
|
+
if (typeof caches === "undefined") throw new Error("variantsR2: `cache: true` reads the Worker global `caches.default`, which this runtime lacks");
|
|
120
|
+
return caches.default;
|
|
121
|
+
};
|
|
122
|
+
/**
|
|
123
|
+
* Variants kept in R2 under `prefix`, so one made last month is not made, and
|
|
124
|
+
* billed, again: `variantsKeyValueStore` over `keyValueStoreR2`. With `cache`,
|
|
125
|
+
* the Cache API stands in front of it: `true` for the Worker's
|
|
126
|
+
* `caches.default`, or a cache of your own (`await caches.open(…)`).
|
|
127
|
+
*/
|
|
128
|
+
const variantsR2 = (bucket, options = {}) => {
|
|
129
|
+
const kept = makeVariants(KeyValueStore.prefix(r2Store(bucket), options.prefix ?? "variants/"));
|
|
130
|
+
return Layer.succeed(Variants, Option.match(Option.fromNullishOr(options.cache), {
|
|
131
|
+
onNone: () => kept,
|
|
132
|
+
onSome: (cache) => withEdge(kept, cacheOf(cache))
|
|
133
|
+
}));
|
|
134
|
+
};
|
|
135
|
+
/**
|
|
136
|
+
* Admission through a Workers rate-limit binding (`[[ratelimits]]`), whose
|
|
137
|
+
* limit and period are its configuration. It answers yes or no, not when, so
|
|
138
|
+
* a refusal says to retry after `retryAfterSeconds` (the binding's period, 60
|
|
139
|
+
* by default). A binding that fails admits the request, logged.
|
|
140
|
+
*/
|
|
141
|
+
const admissionRateLimit = (binding, options = {}) => Layer.succeed(Admission, { admit: (client) => Effect.tryPromise(() => binding.limit({ key: `foldkit-media:${client}` })).pipe(Effect.catch((error) => Effect.logWarning("Media: the rate limit binding failed; admitting", error).pipe(Effect.as({ success: true }))), Effect.flatMap(({ success }) => success ? Effect.void : Effect.fail(new RateLimited({ retryAfterSeconds: options.retryAfterSeconds ?? 60 })))) });
|
|
142
|
+
/**
|
|
143
|
+
* The `Inspector` through the Images binding: an original's size from `info`,
|
|
144
|
+
* which costs no transformation. It makes no thumbnail, since raw pixels are
|
|
145
|
+
* not offered offline and could not be tested, so an original described here
|
|
146
|
+
* has no ThumbHash; and as `info` does not say whether pixels are
|
|
147
|
+
* transparent, every format but JPEG is taken to be, which costs a
|
|
148
|
+
* placeholder, never shows a wrong one. An SVG, which has no size in pixels,
|
|
149
|
+
* is refused.
|
|
150
|
+
*/
|
|
151
|
+
const inspectorImages = (images) => Layer.succeed(Inspector, { inspect: (bytes) => Effect.tryPromise({
|
|
152
|
+
try: () => images.info(new Blob([bytes]).stream()),
|
|
153
|
+
catch: (cause) => cause
|
|
154
|
+
}).pipe(Effect.flatMap((info) => "width" in info ? Effect.succeed({
|
|
155
|
+
width: info.width,
|
|
156
|
+
height: info.height,
|
|
157
|
+
alpha: info.format !== "image/jpeg",
|
|
158
|
+
thumbnail: Option.none()
|
|
159
|
+
}) : Effect.fail(info)), Effect.catch((cause) => Effect.logWarning("Media.inspect failed", cause).pipe(Effect.andThen(Effect.fail(new TransformFailed({})))))) });
|
|
160
|
+
//#endregion
|
|
161
|
+
export { admissionRateLimit, inspectorImages, keyValueStoreR2, originalsR2, transformerImages, uploadsR2, variantsR2 };
|
|
162
|
+
|
|
163
|
+
//# sourceMappingURL=index.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.mjs","names":[],"sources":["../../src/cloudflare/index.ts"],"sourcesContent":["/**\n * The media server's services on Cloudflare: originals in R2, the Images\n * binding as the transformer, and variants kept in R2 behind the Cache API.\n * Each takes the binding it needs, so build them in `serveFetch`'s `layer`\n * from the request's environment.\n */\nimport type {\n Cache,\n CacheStorage,\n ImagesBinding,\n R2Bucket,\n RateLimit,\n} from '@cloudflare/workers-types'\nimport { Effect, Layer, Option } from 'effect'\nimport { KeyValueStore } from 'effect/persistence'\nimport { Admission, RateLimited } from '../server/admission.js'\nimport { Inspector } from '../describe.js'\nimport { OriginalNotFound, QuotaExhausted, TransformFailed } from '../server/errors.js'\nimport { Originals, Transformer, Variants, type Encoded, type Kept } from '../server/services.js'\nimport { Uploads } from '../server/upload.js'\nimport { makeVariants } from '../server/stores.js'\n\n/** Originals in an R2 bucket, each under its content hash. */\nexport const originalsR2 = (bucket: R2Bucket): Layer.Layer<Originals> =>\n Layer.succeed(Originals, {\n get: hash =>\n Effect.promise(() => bucket.get(hash)).pipe(\n Effect.flatMap(object =>\n object === null\n ? Effect.fail(new OriginalNotFound({ hash }))\n : Effect.succeed({\n // The two runtimes' stream types differ only in their declarations.\n body: object.body as unknown as ReadableStream<Uint8Array>,\n size: object.size,\n }),\n ),\n ),\n })\n\n/** Uploads into an R2 bucket, each under its content hash: what `originalsR2` reads. */\nexport const uploadsR2 = (bucket: R2Bucket): Layer.Layer<Uploads> =>\n Layer.succeed(Uploads, {\n put: (hash, bytes) => Effect.promise(() => bucket.put(hash, bytes)).pipe(Effect.asVoid),\n })\n\n// Cloudflare's code for a spent transformation allowance.\nconst QUOTA_EXHAUSTED = 9422\n\nconst isImagesError = (cause: unknown): cause is { readonly code: number } =>\n typeof cause === 'object' && cause !== null && typeof Reflect.get(cause, 'code') === 'number'\n\n/**\n * The Images binding as the transformer. It scales down, never up, and names\n * the format, so the variant is what its URL says. A spent allowance is\n * `QuotaExhausted`; any other refusal is `TransformFailed`, its reason logged.\n */\nexport const transformerImages = (images: ImagesBinding): Layer.Layer<Transformer> =>\n Layer.succeed(Transformer, {\n transform: (original, variant) =>\n Effect.tryPromise({\n try: async () => {\n const result = await images\n .input(original.body as unknown as Parameters<ImagesBinding['input']>[0])\n .transform({ width: variant.width, fit: 'scale-down' })\n .output({\n format: `image/${variant.format}`,\n ...Option.match(variant.quality, {\n onNone: () => ({}),\n onSome: quality => ({ quality }),\n }),\n })\n const response = result.response()\n return {\n bytes: new Uint8Array(await response.arrayBuffer()),\n contentType: result.contentType(),\n }\n },\n catch: cause => cause,\n }).pipe(\n Effect.catch((cause): Effect.Effect<never, QuotaExhausted | TransformFailed> =>\n isImagesError(cause) && cause.code === QUOTA_EXHAUSTED\n ? Effect.fail(new QuotaExhausted({}))\n : Effect.logWarning('Media.transform failed', cause).pipe(\n Effect.andThen(Effect.fail(new TransformFailed({}))),\n ),\n ),\n ),\n })\n\n/**\n * An R2 bucket as an Effect `KeyValueStore`, for anything that keeps bytes by\n * key: `variantsKeyValueStore`, `originalsKeyValueStore`, or the\n * application's own. `clear` and `size` list the whole bucket.\n */\nexport const keyValueStoreR2 = (bucket: R2Bucket): Layer.Layer<KeyValueStore.KeyValueStore> =>\n Layer.succeed(KeyValueStore.KeyValueStore, r2Store(bucket))\n\nconst r2Store = (bucket: R2Bucket): KeyValueStore.KeyValueStore => {\n const attempt = <A>(method: string, key: string | undefined, run: () => Promise<A>) =>\n Effect.tryPromise({\n try: run,\n catch: cause =>\n new KeyValueStore.KeyValueStoreError({\n message: `R2 ${method} failed`,\n method,\n ...(key === undefined ? {} : { key }),\n cause,\n }),\n })\n // Every key in the bucket, a page of listing at a time.\n const keys = async () => {\n const found: Array<string> = []\n let cursor: string | undefined\n do {\n const page = await bucket.list(cursor === undefined ? {} : { cursor })\n found.push(...page.objects.map(object => object.key))\n cursor = page.truncated ? page.cursor : undefined\n } while (cursor !== undefined)\n return found\n }\n return KeyValueStore.make({\n get: key => attempt('get', key, async () => (await bucket.get(key))?.text()),\n getUint8Array: key =>\n attempt('getUint8Array', key, async () => {\n const object = await bucket.get(key)\n return object === null ? undefined : new Uint8Array(await object.arrayBuffer())\n }),\n set: (key, value) => attempt('set', key, async () => void (await bucket.put(key, value))),\n remove: key => attempt('remove', key, () => bucket.delete(key)),\n clear: attempt('clear', undefined, async () => {\n const all = await keys()\n // R2 deletes at most 1,000 keys a call.\n for (let at = 0; at < all.length; at += 1000) await bucket.delete(all.slice(at, at + 1000))\n }),\n size: attempt('size', undefined, async () => (await keys()).length),\n })\n}\n\n// The Cache API keys by request; this origin is never fetched.\nconst edgeKey = (key: string) => `https://foldkit-media.invalid/${key}`\n\n/**\n * Variants with the edge's Cache API in front: read there first, and filled\n * from what is kept behind it, so a popular variant is served from the edge.\n */\nconst withEdge = (behind: Variants['Service'], edge: Cache): Variants['Service'] => {\n const fill = (key: string, encoded: Encoded) =>\n Effect.tryPromise({\n try: () =>\n edge.put(\n edgeKey(key),\n // The page's Response and workers-types' differ only in their declarations.\n new Response(encoded.bytes, {\n headers: {\n 'content-type': encoded.contentType,\n 'cache-control': 'public, max-age=31536000, immutable',\n },\n }) as never,\n ),\n catch: cause => cause,\n }).pipe(Effect.catch(cause => Effect.logWarning('Media: the edge cache failed a write', cause)))\n const behindEdge = (key: string) =>\n behind.get(key).pipe(\n Effect.tap(found =>\n Option.match(found, {\n onNone: () => Effect.void,\n onSome: kept => fill(key, kept.encoded),\n }),\n ),\n )\n return {\n get: key =>\n Effect.tryPromise({\n try: async () => {\n const hit = await edge.match(edgeKey(key))\n return hit === undefined\n ? Option.none<Kept>()\n : Option.some({\n encoded: {\n bytes: new Uint8Array(await hit.arrayBuffer()),\n contentType: hit.headers.get('content-type') ?? 'application/octet-stream',\n },\n from: 'edge' as const,\n })\n },\n catch: cause => cause,\n }).pipe(\n Effect.catch(cause =>\n Effect.logWarning('Media: the edge cache failed a read', cause).pipe(\n Effect.as(Option.none<Kept>()),\n ),\n ),\n Effect.flatMap(found => (Option.isSome(found) ? Effect.succeed(found) : behindEdge(key))),\n ),\n put: (key, encoded) => behind.put(key, encoded).pipe(Effect.andThen(fill(key, encoded))),\n }\n}\n\n// A Worker's global, which the DOM's `CacheStorage` declares without `default`.\ndeclare const caches: CacheStorage | undefined\n\nconst cacheOf = (cache: Cache | true): Cache => {\n if (cache !== true) return cache\n if (typeof caches === 'undefined') {\n throw new Error(\n 'variantsR2: `cache: true` reads the Worker global `caches.default`, which this runtime lacks',\n )\n }\n return caches.default\n}\n\n/**\n * Variants kept in R2 under `prefix`, so one made last month is not made, and\n * billed, again: `variantsKeyValueStore` over `keyValueStoreR2`. With `cache`,\n * the Cache API stands in front of it: `true` for the Worker's\n * `caches.default`, or a cache of your own (`await caches.open(…)`).\n */\nexport const variantsR2 = (\n bucket: R2Bucket,\n options: { readonly prefix?: string; readonly cache?: Cache | true } = {},\n): Layer.Layer<Variants> => {\n const kept = makeVariants(KeyValueStore.prefix(r2Store(bucket), options.prefix ?? 'variants/'))\n return Layer.succeed(\n Variants,\n Option.match(Option.fromNullishOr(options.cache), {\n onNone: () => kept,\n onSome: cache => withEdge(kept, cacheOf(cache)),\n }),\n )\n}\n\n/**\n * Admission through a Workers rate-limit binding (`[[ratelimits]]`), whose\n * limit and period are its configuration. It answers yes or no, not when, so\n * a refusal says to retry after `retryAfterSeconds` (the binding's period, 60\n * by default). A binding that fails admits the request, logged.\n */\nexport const admissionRateLimit = (\n binding: RateLimit,\n options: { readonly retryAfterSeconds?: number } = {},\n): Layer.Layer<Admission> =>\n Layer.succeed(Admission, {\n admit: client =>\n Effect.tryPromise(() => binding.limit({ key: `foldkit-media:${client}` })).pipe(\n Effect.catch(error =>\n Effect.logWarning('Media: the rate limit binding failed; admitting', error).pipe(\n Effect.as({ success: true }),\n ),\n ),\n Effect.flatMap(({ success }) =>\n success\n ? Effect.void\n : Effect.fail(new RateLimited({ retryAfterSeconds: options.retryAfterSeconds ?? 60 })),\n ),\n ),\n })\n\n/**\n * The `Inspector` through the Images binding: an original's size from `info`,\n * which costs no transformation. It makes no thumbnail, since raw pixels are\n * not offered offline and could not be tested, so an original described here\n * has no ThumbHash; and as `info` does not say whether pixels are\n * transparent, every format but JPEG is taken to be, which costs a\n * placeholder, never shows a wrong one. An SVG, which has no size in pixels,\n * is refused.\n */\nexport const inspectorImages = (images: ImagesBinding): Layer.Layer<Inspector> =>\n Layer.succeed(Inspector, {\n inspect: bytes =>\n Effect.tryPromise({\n try: () =>\n images.info(\n new Blob([bytes]).stream() as unknown as Parameters<ImagesBinding['info']>[0],\n ),\n catch: cause => cause,\n }).pipe(\n Effect.flatMap(info =>\n // An SVG's answer has no width: it has no size in pixels.\n 'width' in info\n ? Effect.succeed({\n width: info.width,\n height: info.height,\n alpha: info.format !== 'image/jpeg',\n thumbnail: Option.none(),\n })\n : Effect.fail(info),\n ),\n Effect.catch(cause =>\n Effect.logWarning('Media.inspect failed', cause).pipe(\n Effect.andThen(Effect.fail(new TransformFailed({}))),\n ),\n ),\n ),\n })\n"],"mappings":"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"}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import { r as ImageAsset } from "./asset-Dlkss5qp.mjs";
|
|
2
|
+
import { Context, Effect, Option, Schema } from "effect";
|
|
3
|
+
//#region src/server/errors.d.ts
|
|
4
|
+
declare const OriginalNotFound_base: Schema.Class<OriginalNotFound, Schema.TaggedStruct<"OriginalNotFound", {
|
|
5
|
+
readonly hash: Schema.String;
|
|
6
|
+
}>, import("effect/Cause").YieldableError>;
|
|
7
|
+
/** No original is stored under this hash. */
|
|
8
|
+
declare class OriginalNotFound extends OriginalNotFound_base {}
|
|
9
|
+
declare const OriginalTooLarge_base: Schema.Class<OriginalTooLarge, Schema.TaggedStruct<"OriginalTooLarge", {
|
|
10
|
+
readonly size: Schema.Number;
|
|
11
|
+
readonly limit: Schema.Number;
|
|
12
|
+
readonly unit: Schema.Literals<readonly ["bytes", "pixels"]>;
|
|
13
|
+
}>, import("effect/Cause").YieldableError>;
|
|
14
|
+
/** The original is larger than the server will read: in bytes, or in pixels once decoded. */
|
|
15
|
+
declare class OriginalTooLarge extends OriginalTooLarge_base {}
|
|
16
|
+
declare const TransformFailed_base: Schema.Class<TransformFailed, Schema.TaggedStruct<"TransformFailed", {}>, import("effect/Cause").YieldableError>;
|
|
17
|
+
/**
|
|
18
|
+
* The transformer could not make the variant: the original is not an image it
|
|
19
|
+
* reads, or it failed. Its reason stays in the server's log, not the response.
|
|
20
|
+
*/
|
|
21
|
+
declare class TransformFailed extends TransformFailed_base {}
|
|
22
|
+
declare const QuotaExhausted_base: Schema.Class<QuotaExhausted, Schema.TaggedStruct<"QuotaExhausted", {}>, import("effect/Cause").YieldableError>;
|
|
23
|
+
/** The host's transformation allowance is spent; variants already made still serve. */
|
|
24
|
+
declare class QuotaExhausted extends QuotaExhausted_base {}
|
|
25
|
+
//#endregion
|
|
26
|
+
//#region src/describe.d.ts
|
|
27
|
+
/** A picture at most 100 pixels a side, as raw RGBA: what a ThumbHash is made from. */
|
|
28
|
+
interface Thumbnail {
|
|
29
|
+
readonly width: number;
|
|
30
|
+
readonly height: number;
|
|
31
|
+
readonly rgba: Uint8Array;
|
|
32
|
+
}
|
|
33
|
+
/** What an inspector reads of an original. */
|
|
34
|
+
interface Inspected {
|
|
35
|
+
readonly width: number;
|
|
36
|
+
readonly height: number;
|
|
37
|
+
/** Whether it may have transparent pixels; an inspector that cannot tell says yes. */
|
|
38
|
+
readonly alpha: boolean;
|
|
39
|
+
/** None where the inspector cannot make one (the Images binding offline makes no raw pixels). */
|
|
40
|
+
readonly thumbnail: Option.Option<Thumbnail>;
|
|
41
|
+
}
|
|
42
|
+
declare const Inspector_base: Context.ServiceClass<Inspector, "foldkit-media/Inspector", {
|
|
43
|
+
readonly inspect: (bytes: Uint8Array<ArrayBuffer>) => Effect.Effect<Inspected, TransformFailed | OriginalTooLarge>;
|
|
44
|
+
}>;
|
|
45
|
+
/** Reads an original's facts: its size, its alpha, and a thumbnail. */
|
|
46
|
+
declare class Inspector extends Inspector_base {}
|
|
47
|
+
/**
|
|
48
|
+
* An original's facts, as an `ImageAsset` under `key`: its size and alpha
|
|
49
|
+
* from the `Inspector`, its SHA-256, and a ThumbHash placeholder where the
|
|
50
|
+
* inspector made a thumbnail. Where an original enters (an upload, a build, a
|
|
51
|
+
* page's content naming a URL), so its facts are derived once and stored.
|
|
52
|
+
*/
|
|
53
|
+
declare const describe: (key: string, bytes: Uint8Array<ArrayBuffer>) => Effect.Effect<ImageAsset, TransformFailed | OriginalTooLarge, Inspector>;
|
|
54
|
+
//#endregion
|
|
55
|
+
export { OriginalNotFound as a, TransformFailed as c, describe as i, Inspector as n, OriginalTooLarge as o, Thumbnail as r, QuotaExhausted as s, Inspected as t };
|
|
56
|
+
//# sourceMappingURL=describe-CivKHl4x.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"describe-CivKHl4x.d.mts","names":[],"sources":["../src/server/errors.ts","../src/describe.ts"],"mappings":";;;;;;;cAGa,yBAAyB;;;;;;;cAOzB,yBAAyB;;;;;;cAUzB,wBAAwB;;;cAOxB,uBAAuB;;;;UCrBnB;WACN;WACA;WACA,MAAM;;;UAIA;WACN;WACA;;WAEA;;WAEA,WAAW,OAAO,OAAO;;;WAOd,UAChB,OAAO,WAAW,iBACf,OAAO,OAAO,WAAW,kBAAkB;;;cALvC,kBAAkB;;;;;;;cAoBlB,WAAQ,aACR,OACJ,WAAW,iBACjB,OAAO,OAAO,YAAY,kBAAkB,kBAAkB"}
|