@kutur-kit/assets 0.0.0-stage → 0.1.0-alpha.0

package/dist/testing/AssetBucketContract.js

@@ -0,0 +1,124 @@
+import { ByteSize, Effect, Option, Result, Schema, Stream } from "effect";
+import * as AssetBucket from "../AssetBucket.js";
+/** The bucket the cases use. Back it with the implementation under test. */
+export class ContractBucket extends AssetBucket.Service()("assets-contract") {
+}
+const text = (value) => new TextEncoder().encode(value);
+const put = (key, chunks, contentType = "text/plain", cacheControl) => Effect.flatMap(ContractBucket, (bucket) => bucket.put({ key, contentType, cacheControl, body: Stream.fromIterable(chunks.map(text)) }));
+// The stored body as text, or null when the object is missing.
+const read = (key) => Effect.flatMap(ContractBucket, (bucket) => bucket.get(key)).pipe(Effect.flatMap(Option.match({
+    onNone: () => Effect.succeed(null),
+    onSome: ({ body }) => Stream.runCollect(body).pipe(Effect.map((chunks) => chunks.map((chunk) => new TextDecoder().decode(chunk)).join(""))),
+})));
+const head = (key) => Effect.flatMap(ContractBucket, (bucket) => bucket.head(key));
+const remove = (key) => Effect.flatMap(ContractBucket, (bucket) => bucket.delete(key));
+const expectEqual = (label, expected, received) => {
+    const [want, got] = [expected, received].map((value) => JSON.stringify(value));
+    return want === got
+        ? Effect.void
+        : Effect.die(new Error(`AssetBucket contract violated: ${label}\nexpected: ${want}\nreceived: ${got}`));
+};
+const expectBody = (key, expected) => Effect.flatMap(read(key), (body) => expectEqual(`body of ${key}`, expected, body));
+// Encoding checks that sizes are ByteSize values and drops fields stores may add.
+const encodeInfo = Schema.encodeEffect(Schema.toCodecJson(Schema.NullOr(Schema.Struct({
+    size: Schema.ByteSize,
+    contentType: Schema.String,
+    cacheControl: Schema.optionalKey(Schema.String),
+}))));
+// No cache control compares equal whether a store omits it or sets it to undefined.
+const comparable = (info) => {
+    if (info === null)
+        return null;
+    const { size, contentType, cacheControl } = info;
+    return cacheControl === undefined ? { size, contentType } : { size, contentType, cacheControl };
+};
+const expectInfo = (label, expected, received) => Effect.flatMap(Effect.all([encodeInfo(comparable(expected)), encodeInfo(comparable(received))]), ([want, got]) => expectEqual(label, want, got)).pipe(Effect.orDie);
+const expectHead = (key, expected) => Effect.flatMap(head(key), (info) => expectInfo(`head of ${key}`, expected, Option.getOrNull(info)));
+const stored = "contract/stored.txt";
+const nested = "contract/nested";
+const child = "contract/nested/child";
+export const cases = [
+    {
+        name: "returns the stored bytes and info",
+        run: Effect.gen(function* () {
+            const info = yield* put(stored, ["hello, ", "", "wörld"], "text/plain; charset=utf-8");
+            const expected = { size: ByteSize.bytes(13), contentType: "text/plain; charset=utf-8" };
+            yield* expectInfo("put info", expected, info);
+            yield* expectHead(stored, expected);
+            yield* expectBody(stored, "hello, wörld");
+            const object = yield* Effect.flatMap(ContractBucket, (bucket) => bucket.get(stored));
+            yield* expectInfo(`get info of ${stored}`, expected, Option.getOrNull(Option.map(object, ({ info }) => info)));
+        }).pipe(Effect.orDie),
+    },
+    {
+        name: "stores empty objects",
+        run: Effect.gen(function* () {
+            yield* put(stored, [], "application/octet-stream");
+            yield* expectHead(stored, { size: ByteSize.zero, contentType: "application/octet-stream" });
+            yield* expectBody(stored, "");
+        }).pipe(Effect.orDie),
+    },
+    {
+        name: "replaces an object on put",
+        run: Effect.gen(function* () {
+            yield* put(stored, ["first version"]);
+            yield* put(stored, ["second"], "text/markdown");
+            yield* expectHead(stored, { size: ByteSize.bytes(6), contentType: "text/markdown" });
+            yield* expectBody(stored, "second");
+        }).pipe(Effect.orDie),
+    },
+    {
+        name: "stores the cache control an object is served with, and replaces it on put",
+        run: Effect.gen(function* () {
+            const immutable = "public, max-age=31536000, immutable";
+            const info = yield* put(stored, ["cached"], "text/plain", immutable);
+            const expected = {
+                size: ByteSize.bytes(6),
+                contentType: "text/plain",
+                cacheControl: immutable,
+            };
+            yield* expectInfo("put info", expected, info);
+            yield* expectHead(stored, expected);
+            const object = yield* Effect.flatMap(ContractBucket, (bucket) => bucket.get(stored));
+            yield* expectInfo(`get info of ${stored}`, expected, Option.getOrNull(Option.map(object, ({ info }) => info)));
+            yield* put(stored, ["uncached"]);
+            yield* expectHead(stored, { size: ByteSize.bytes(8), contentType: "text/plain" });
+        }).pipe(Effect.orDie),
+    },
+    {
+        name: "keeps a key and the keys nested under it apart",
+        run: Effect.gen(function* () {
+            yield* put(nested, ["parent"]);
+            yield* put(child, ["child"]);
+            yield* remove(child);
+            yield* expectBody(nested, "parent");
+            yield* expectBody(child, null);
+            yield* put(child, ["child"]);
+            yield* remove(nested);
+            yield* expectBody(child, "child");
+        }).pipe(Effect.orDie),
+    },
+    {
+        name: "reports missing objects and deletes them more than once",
+        run: Effect.gen(function* () {
+            yield* put(stored, ["to delete"]);
+            yield* remove(stored);
+            yield* expectHead(stored, null);
+            yield* expectBody(stored, null);
+            yield* remove(stored);
+        }).pipe(Effect.orDie),
+    },
+    {
+        name: "keeps the previous object when a body fails",
+        run: Effect.gen(function* () {
+            yield* put(stored, ["previous"]);
+            const failing = Stream.concat(Stream.make(text("partial")), Stream.fail("body failed"));
+            const bucket = yield* ContractBucket;
+            const result = yield* Effect.result(bucket.put({ key: stored, contentType: "text/plain", body: failing }));
+            yield* expectEqual("error of a put whose body failed", "body failed", Result.isFailure(result) ? result.failure : "success");
+            yield* expectHead(stored, { size: ByteSize.bytes(8), contentType: "text/plain" });
+            yield* expectBody(stored, "previous");
+        }).pipe(Effect.orDie),
+    },
+];
+//# sourceMappingURL=AssetBucketContract.js.map

package/dist/testing/AssetBucketContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetBucketContract.js","sourceRoot":"","sources":["../../src/testing/AssetBucketContract.ts"],"names":[],"mappings":"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"}

package/dist/testing/AssetSigningContract.d.ts

@@ -0,0 +1,18 @@
+import { Effect } from "effect";
+import { HttpClient } from "effect/http";
+import * as AssetSigning from "../AssetSigning.ts";
+import { ContractBucket } from "./AssetBucketContract.ts";
+/**
+ * Checks a `Signing` implementation and the storage it signs for, over HTTP:
+ * signed requests succeed, and requests that differ from what was signed are
+ * refused without changing what is stored, and a signed upload writes once. Provide the `ContractBucket`, its
+ * `Signing` and an `HttpClient` that can reach the signed URLs. Expiry is not
+ * checked: it depends on the storage's clock. Cases delete the keys they
+ * use under `contract/` first, so storage may keep objects between cases.
+ */
+export interface Case {
+    readonly name: string;
+    readonly run: Effect.Effect<void, never, ContractBucket | AssetSigning.SigningOf<ContractBucket> | HttpClient.HttpClient>;
+}
+export declare const cases: ReadonlyArray<Case>;
+//# sourceMappingURL=AssetSigningContract.d.ts.map

package/dist/testing/AssetSigningContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetSigningContract.d.ts","sourceRoot":"","sources":["../../src/testing/AssetSigningContract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,MAAM,EAAU,MAAM,QAAQ,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAqB,MAAM,aAAa,CAAC;AAE5D,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CACzB,IAAI,EACJ,KAAK,EACL,cAAc,GAAG,YAAY,CAAC,SAAS,CAAC,cAAc,CAAC,GAAG,UAAU,CAAC,UAAU,CAChF,CAAC;CACH;AA0ED,eAAO,MAAM,KAAK,EAAE,aAAa,CAAC,IAAI,CA8JrC,CAAC"}

package/dist/testing/AssetSigningContract.js

@@ -0,0 +1,132 @@
+import { ByteSize, Duration, Effect, Option } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/http";
+import * as AssetSigning from "../AssetSigning.js";
+import { ContractBucket } from "./AssetBucketContract.js";
+const signing = AssetSigning.of(ContractBucket);
+const key = "contract/signed.png";
+const expiresIn = Duration.minutes(5);
+const png = new Uint8Array([0x89, 0x50, 0x4e, 0x47]);
+// Not `no-cache`, which clients add to conditional requests themselves.
+const cacheControl = "public, max-age=60";
+const violated = (message) => Effect.die(new Error(`AssetSigning contract violated: ${message}`));
+const ensure = (holds, message) => (holds ? Effect.void : violated(message));
+const ok = (status) => status >= 200 && status < 300;
+const signPut = (contentType = "image/png", contentLength = png.length) => Effect.flatMap(signing, (signer) => signer.signPut({
+    key,
+    contentType,
+    contentLength: ByteSize.bytes(contentLength),
+    cacheControl,
+    expiresIn,
+}));
+/** Sends a signed request as a client would, with its headers and a body. */
+const send = (signed, options = {}) => HttpClient.execute(HttpClientRequest.make(signed.method)(options.url ?? signed.url).pipe(HttpClientRequest.setHeaders({ ...signed.headers, ...options.headers }), (request) => options.body === undefined
+    ? request
+    : HttpClientRequest.bodyUint8Array(request, options.body, options.headers?.["content-type"] ?? signed.headers["content-type"])));
+// The value of the URL's signature parameter, such as S3's `X-Amz-Signature`.
+const signatureOf = (url) => [...new URL(url, "http://localhost").searchParams].find(([name]) => /signature$/iu.test(name))?.[1] ?? "";
+// Cases start without the objects they check for.
+const clear = Effect.flatMap(ContractBucket, (bucket) => Effect.andThen(bucket.delete(key), bucket.delete("contract/other.png")));
+const stored = Effect.flatMap(ContractBucket, (bucket) => bucket.head(key));
+const expectRefused = (label, response) => ok(response.status)
+    ? violated(`${label} was accepted with ${response.status}`)
+    : Effect.flatMap(stored, (info) => Option.isSome(info) ? violated(`${label} stored an object`) : Effect.void);
+export const cases = [
+    {
+        name: "stores a signed upload and serves it to a signed download",
+        run: Effect.gen(function* () {
+            yield* clear;
+            const put = yield* signPut();
+            const uploaded = yield* send(put, { body: png });
+            yield* ensure(ok(uploaded.status), `a signed upload failed with ${uploaded.status}`);
+            const info = yield* stored;
+            yield* ensure(Option.isSome(info) &&
+                info.value.contentType === "image/png" &&
+                info.value.cacheControl === cacheControl, "a signed upload was not stored with its content type and cache control");
+            const get = yield* Effect.flatMap(signing, (signer) => signer.signGet({ key, expiresIn }));
+            const downloaded = yield* send(get);
+            const body = new Uint8Array(yield* downloaded.arrayBuffer);
+            yield* ensure(downloaded.status === 200 && body.join() === png.join(), "a signed download did not return the upload");
+        }).pipe(Effect.orDie),
+    },
+    {
+        name: "signs uploads with no headers but `uploadHeaders`, which CORS rules allow",
+        run: Effect.gen(function* () {
+            const put = yield* signPut();
+            const allowed = new Set(AssetSigning.uploadHeaders);
+            const others = Object.keys(put.headers).filter((name) => !allowed.has(name));
+            yield* ensure(others.length === 0, `a signed upload needs other headers: ${others.join(", ")}`);
+        }).pipe(Effect.orDie),
+    },
+    {
+        name: "refuses an upload of another content type than signed",
+        run: Effect.gen(function* () {
+            yield* clear;
+            const put = yield* signPut("image/png");
+            yield* expectRefused("an upload as text/html", yield* send(put, { body: png, headers: { "content-type": "text/html" } }));
+        }).pipe(Effect.orDie),
+    },
+    {
+        name: "refuses an upload with another cache control than signed",
+        run: Effect.gen(function* () {
+            yield* clear;
+            const put = yield* signPut();
+            yield* expectRefused("an upload cached for a year", yield* send(put, {
+                body: png,
+                headers: { "cache-control": "public, max-age=31536000, immutable" },
+            }));
+        }).pipe(Effect.orDie),
+    },
+    {
+        name: "refuses an upload of another length than signed",
+        run: Effect.gen(function* () {
+            yield* clear;
+            const put = yield* signPut("image/png", png.length);
+            yield* expectRefused("a longer upload", yield* send(put, { body: new Uint8Array([...png, 0]) }));
+            yield* expectRefused("a shorter upload", yield* send(put, { body: png.slice(1) }));
+        }).pipe(Effect.orDie),
+    },
+    {
+        name: "refuses a signed URL used for another key or with its signature changed",
+        run: Effect.gen(function* () {
+            yield* clear;
+            const put = yield* signPut();
+            const signature = signatureOf(put.url);
+            yield* ensure(signature !== "", "a signed URL has no signature parameter");
+            const flipped = `${signature.slice(0, -1)}${signature.endsWith("0") ? "1" : "0"}`;
+            yield* expectRefused("an upload to another key", yield* send(put, { body: png, url: put.url.replace("signed.png", "other.png") }));
+            yield* expectRefused("an upload with a changed signature", yield* send(put, { body: png, url: put.url.replace(signature, flipped) }));
+            const other = yield* Effect.flatMap(ContractBucket, (bucket) => bucket.head("contract/other.png"));
+            yield* ensure(Option.isNone(other), "an upload to another key was stored");
+        }).pipe(Effect.orDie),
+    },
+    {
+        name: "writes a signed upload once, however its URL is replayed",
+        run: Effect.gen(function* () {
+            yield* clear;
+            const put = yield* signPut();
+            yield* send(put, { body: png });
+            // Same length and type, so only the write-once condition stops it.
+            const other = png.map((byte) => 255 - byte);
+            const { "if-none-match": _, ...unconditional } = put.headers;
+            const replays = [
+                yield* send(put, { body: other }),
+                yield* send({ ...put, headers: unconditional }, { body: other }),
+            ];
+            yield* ensure(replays.every((response) => !ok(response.status)), `a replayed upload was accepted with ${replays.map((response) => response.status).join(", ")}`);
+            const get = yield* Effect.flatMap(signing, (signer) => signer.signGet({ key, expiresIn }));
+            const body = new Uint8Array(yield* (yield* send(get)).arrayBuffer);
+            yield* ensure(body.join() === png.join(), "a replayed upload replaced the object");
+        }).pipe(Effect.orDie),
+    },
+    {
+        name: "refuses a signed upload URL used to download",
+        run: Effect.gen(function* () {
+            yield* clear;
+            const put = yield* signPut();
+            yield* send(put, { body: png });
+            const downloaded = yield* send({ ...put, method: "GET" });
+            yield* ensure(!ok(downloaded.status), "an upload URL served a download");
+        }).pipe(Effect.orDie),
+    },
+];
+//# sourceMappingURL=AssetSigningContract.js.map

package/dist/testing/AssetSigningContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetSigningContract.js","sourceRoot":"","sources":["../../src/testing/AssetSigningContract.ts"],"names":[],"mappings":"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"}

package/dist/testing/index.d.ts

@@ -0,0 +1,3 @@
+export * as AssetBucketContract from "./AssetBucketContract.ts";
+export * as AssetSigningContract from "./AssetSigningContract.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,mBAAmB,MAAM,0BAA0B,CAAC;AAEhE,OAAO,KAAK,oBAAoB,MAAM,2BAA2B,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,3 @@
+export * as AssetBucketContract from "./AssetBucketContract.js";
+export * as AssetSigningContract from "./AssetSigningContract.js";
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,mBAAmB,MAAM,0BAA0B,CAAC;AAEhE,OAAO,KAAK,oBAAoB,MAAM,2BAA2B,CAAC"}

package/package.json

@@ -1,6 +1,106 @@
 {
   "name": "@kutur-kit/assets",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-alpha.0",
+  "description": "Typed asset definitions and swappable object storage for Effect.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kutur-labs/kit.git",
+    "directory": "packages/assets"
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./Asset": {
+      "types": "./dist/Asset.d.ts",
+      "default": "./dist/Asset.js"
+    },
+    "./AssetBucket": {
+      "types": "./dist/AssetBucket.d.ts",
+      "default": "./dist/AssetBucket.js"
+    },
+    "./AssetDelivery": {
+      "types": "./dist/AssetDelivery.d.ts",
+      "default": "./dist/AssetDelivery.js"
+    },
+    "./AssetSigning": {
+      "types": "./dist/AssetSigning.d.ts",
+      "default": "./dist/AssetSigning.js"
+    },
+    "./alchemy/r2": {
+      "types": "./dist/alchemy/r2.d.ts",
+      "default": "./dist/alchemy/r2.js"
+    },
+    "./delivery/local": {
+      "types": "./dist/delivery/local.d.ts",
+      "default": "./dist/delivery/local.js"
+    },
+    "./filesystem": {
+      "types": "./dist/filesystem.d.ts",
+      "default": "./dist/filesystem.js"
+    },
+    "./memory": {
+      "types": "./dist/memory.d.ts",
+      "default": "./dist/memory.js"
+    },
+    "./s3": {
+      "types": "./dist/s3.d.ts",
+      "default": "./dist/s3.js"
+    },
+    "./signing/local": {
+      "types": "./dist/signing/local.d.ts",
+      "default": "./dist/signing/local.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@distilled.cloud/aws": "1.0.0-rc.15",
+    "@effect/platform-node": "4.0.5",
+    "@effect/tsgo": "0.53.3",
+    "@effect/vitest": "4.0.5",
+    "@kutur-kit/testcontainers": "0.0.0",
+    "@kutur-kit/tsconfig": "0.1.0-alpha.0",
+    "@stryker-mutator/core": "10.0.0",
+    "@stryker-mutator/vitest-runner": "10.0.0",
+    "@types/node": "24.19.2",
+    "alchemy": "2.0.0-beta.83",
+    "effect": "4.0.5",
+    "publint": "0.3.25",
+    "typescript": "7.0.2",
+    "vitest": "5.0.5"
+  },
+  "peerDependencies": {
+    "@distilled.cloud/aws": "1.0.0-rc.15",
+    "alchemy": "2.0.0-beta.83",
+    "effect": "^4.0.5"
+  },
+  "peerDependenciesMeta": {
+    "@distilled.cloud/aws": {
+      "optional": true
+    },
+    "alchemy": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "node --input-type=module -e 'import { rmSync } from \"node:fs\"; rmSync(\"dist\", { recursive: true, force: true });' && tsc -p tsconfig.build.json",
+    "lint:package": "publint --pack pnpm --strict",
+    "test": "vitest run",
+    "test:mutation": "stryker run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }