@streetjs/storage 1.0.0

package/dist/tests/backblaze-driver.test.js

@@ -0,0 +1,185 @@
+// Unit tests for the Backblaze B2 driver submodule (task 28.5).
+//
+// Backblaze B2 exposes a fully S3-compatible API, so the driver is a thin
+// specialization of the shared S3-style base: it fixes the driver name to
+// "backblaze" and either accepts an injected S3ClientLike or builds its own
+// client from connection config via a lazy dynamic import() of the optional
+// peer SDK. These tests exercise the injected-client path with an in-memory
+// fake (no external service, no SDK), assert the name/contract behavior, and
+// confirm the self-built path throws StorageConfigError when the SDK is absent.
+//
+// Requirements: 2.1, 2.3, 3.3
+import test from "node:test";
+import assert from "node:assert/strict";
+import { BackblazeB2Driver, createBackblazeB2Driver, BACKBLAZE_DRIVER_NAME, } from "../drivers/backblaze.js";
+import { StorageConfigError } from "../errors.js";
+import { NotFoundError } from "../errors.js";
+import { registerStorageDriverContractTests } from "./contract.js";
+const FIXED_NOW = 1_700_000_000_000;
+const fixedClock = () => FIXED_NOW;
+function bytes(str) {
+    return new TextEncoder().encode(str);
+}
+/** A minimal in-memory S3ClientLike standing in for the B2 S3 endpoint. */
+function makeFakeClient({ withMultipart = true } = {}) {
+    const objects = new Map();
+    const uploads = new Map();
+    let seed = 0;
+    const client = {
+        async putObject({ key, body, contentType, metadata }) {
+            objects.set(key, {
+                body: body.slice(),
+                contentType,
+                metadata: metadata ? { ...metadata } : undefined,
+            });
+            return { etag: `${key}-etag` };
+        },
+        async getObject({ key }) {
+            const obj = objects.get(key);
+            if (obj === undefined)
+                return null;
+            return {
+                body: obj.body.slice(),
+                contentType: obj.contentType,
+                etag: `${key}-etag`,
+                size: obj.body.byteLength,
+                lastModified: FIXED_NOW,
+                metadata: obj.metadata,
+            };
+        },
+        async headObject({ key }) {
+            const obj = objects.get(key);
+            if (obj === undefined)
+                return null;
+            return {
+                contentType: obj.contentType,
+                etag: `${key}-etag`,
+                size: obj.body.byteLength,
+                lastModified: FIXED_NOW,
+                metadata: obj.metadata,
+            };
+        },
+        async deleteObject({ key }) {
+            objects.delete(key);
+        },
+        async listObjects({ prefix }) {
+            return [...objects.entries()]
+                .filter(([key]) => key.startsWith(prefix))
+                .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+                .map(([key, obj]) => ({ key, size: obj.body.byteLength, updatedAt: FIXED_NOW }));
+        },
+    };
+    if (withMultipart) {
+        client.createMultipartUpload = async ({ key, contentType, metadata }) => {
+            const uploadId = `upload-${(seed += 1)}`;
+            uploads.set(uploadId, { key, contentType, metadata, parts: new Map() });
+            return { uploadId };
+        };
+        client.uploadPart = async ({ uploadId, partNumber, body }) => {
+            uploads.get(uploadId).parts.set(partNumber, body.slice());
+            return { etag: `${uploadId}-${partNumber}` };
+        };
+        client.completeMultipartUpload = async ({ uploadId, parts }) => {
+            const session = uploads.get(uploadId);
+            const ordered = [...parts].sort((a, b) => a.partNumber - b.partNumber);
+            const buffers = ordered.map((p) => Buffer.from(session.parts.get(p.partNumber)));
+            objects.set(session.key, {
+                body: new Uint8Array(Buffer.concat(buffers)),
+                contentType: session.contentType,
+                metadata: session.metadata,
+            });
+            uploads.delete(uploadId);
+            return { etag: `${session.key}-etag` };
+        };
+        client.abortMultipartUpload = async ({ uploadId }) => {
+            uploads.delete(uploadId);
+        };
+    }
+    return { client, objects, uploads };
+}
+// ── name ────────────────────────────────────────────────────────────────────
+test("driver name is fixed to 'backblaze'", () => {
+    const { client } = makeFakeClient();
+    const driver = createBackblazeB2Driver(client, { clock: fixedClock });
+    assert.equal(driver.name, BACKBLAZE_DRIVER_NAME);
+    assert.equal(driver.name, "backblaze");
+});
+test("BackblazeB2Driver class constructs with name 'backblaze'", () => {
+    const { client } = makeFakeClient();
+    const driver = new BackblazeB2Driver(client, { clock: fixedClock });
+    assert.equal(driver.name, "backblaze");
+});
+test("injected-client factory is synchronous (returns a driver, not a promise)", () => {
+    const { client } = makeFakeClient();
+    const driver = createBackblazeB2Driver(client);
+    assert.equal(typeof driver.put, "function");
+    assert.notEqual(typeof driver.then, "function");
+});
+// ── primitives round-trip through the injected client ──────────────────────────
+test("put/get round-trips bytes and typed metadata", async () => {
+    const { client } = makeFakeClient();
+    const driver = createBackblazeB2Driver(client, { clock: fixedClock });
+    const content = bytes("backblaze payload");
+    await driver.put("docs/file.txt", content, {
+        contentType: "text/plain",
+        owner: "user-1",
+        accessLevel: "public",
+        custom: { label: "invoice" },
+    });
+    const result = await driver.get("docs/file.txt");
+    assert.equal(result.found, true);
+    assert.deepEqual(result.bytes, content);
+    assert.equal(result.metadata.contentType, "text/plain");
+    assert.equal(result.metadata.owner, "user-1");
+    assert.equal(result.metadata.accessLevel, "public");
+    assert.deepEqual(result.metadata.custom, { label: "invoice" });
+});
+test("get/stat report a missing key consistently", async () => {
+    const { client } = makeFakeClient();
+    const driver = createBackblazeB2Driver(client, { clock: fixedClock });
+    assert.deepEqual(await driver.get("missing"), { found: false });
+    assert.equal(await driver.stat("missing"), null);
+    await assert.rejects(() => driver.getStream("missing"), NotFoundError);
+});
+test("native multipart delegates through the client when available", async () => {
+    const { client } = makeFakeClient({ withMultipart: true });
+    const driver = createBackblazeB2Driver(client, { clock: fixedClock });
+    assert.notEqual(driver.multipart, undefined);
+    const mp = driver.multipart;
+    const uploadId = await mp.create("big/file.bin", {});
+    const p1 = await mp.uploadPart(uploadId, 1, bytes("part-one-"));
+    const p2 = await mp.uploadPart(uploadId, 2, bytes("part-two"));
+    await mp.complete(uploadId, [p1, p2]);
+    const result = await driver.get("big/file.bin");
+    assert.equal(result.found, true);
+    assert.deepEqual(result.bytes, bytes("part-one-part-two"));
+});
+test("native capabilities are delegated when injected via options", () => {
+    const { client } = makeFakeClient();
+    const versioning = { snapshot: async () => null, list: async () => [], restore: async () => ({}), deleteVersion: async () => { } };
+    const lifecycle = { apply: async () => [] };
+    const signedUrl = { sign: async () => "url", verify: () => ({ valid: true }) };
+    const driver = createBackblazeB2Driver(client, {
+        clock: fixedClock,
+        capabilities: { versioning, lifecycle, signedUrl },
+    });
+    assert.equal(driver.versioning, versioning);
+    assert.equal(driver.lifecycle, lifecycle);
+    assert.equal(driver.signedUrl, signedUrl);
+});
+// ── self-built client path (lazy dynamic import of an absent optional SDK) ──────
+test("building own client without the SDK installed throws StorageConfigError", async () => {
+    await assert.rejects(() => createBackblazeB2Driver({
+        bucket: "my-bucket",
+        endpoint: "https://s3.us-west-002.backblazeb2.com",
+        region: "us-west-002",
+        credentials: { accessKeyId: "keyId", secretAccessKey: "appKey" },
+    }), (error) => {
+        assert.ok(error instanceof StorageConfigError);
+        assert.equal(error.provider, "backblaze");
+        return true;
+    });
+});
+// ── shared contract-conformance suite ───────────────────────────────────────────
+registerStorageDriverContractTests("backblaze", () => createBackblazeB2Driver(makeFakeClient().client, { clock: fixedClock }), test);
+//# sourceMappingURL=backblaze-driver.test.js.map

package/dist/tests/backblaze-driver.test.js.map

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

package/dist/tests/bridge-degradation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bridge-degradation.test.d.ts.map

package/dist/tests/bridge-degradation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-degradation.test.d.ts","sourceRoot":"","sources":["../../src/tests/bridge-degradation.test.ts"],"names":[],"mappings":""}

package/dist/tests/bridge-degradation.test.js

@@ -0,0 +1,138 @@
+// Cross-bridge graceful-degradation unit tests for the storage facade
+// (task 21.4).
+//
+// Tasks 21.1/21.2/21.3 each proved a single bridge degrades gracefully in
+// isolation (events-bridge.test.js, queue-bridge.test.js,
+// realtime-bridge.test.js). This file adds the focused CROSS-bridge coverage
+// that specifically satisfies task 21.4's intent: with the Events, Queue AND
+// Realtime bridges wired simultaneously, object and upload operations must
+// still succeed whether every bridge is ABSENT or every bridge THROWS, and the
+// events published must carry the affected key + metadata.
+//
+// Covered:
+//  - all three bridges absent → put/get/delete/putStream/resumeUpload succeed
+//    (17.3, 19.3).
+//  - all three bridges throwing simultaneously → the same operations still
+//    succeed and return correct results (17.4, 19.3).
+//  - with a live (recording) events bridge alongside a throwing queue + throwing
+//    realtime bridge, the published events still carry key + metadata; asserted
+//    for storage.uploaded (key + full metadata) and storage.deleted (key)
+//    (18.2).
+//
+// Uses the Node.js built-in test runner (node:test); executed via
+// `node --test dist/tests/*.test.js`.
+//
+// Requirements: 17.3, 17.4, 18.2, 19.3
+import test from "node:test";
+import assert from "node:assert/strict";
+import { Readable } from "node:stream";
+import { createStorage } from "../index.js";
+/** A bridge trio whose every method throws synchronously on use. */
+function throwingBridges() {
+    return {
+        events: {
+            publish() {
+                throw new Error("events bus down");
+            },
+        },
+        queue: {
+            dispatch() {
+                throw new Error("queue down");
+            },
+        },
+        realtime: {
+            broadcast() {
+                throw new Error("realtime down");
+            },
+        },
+    };
+}
+/** A recording EventsLike double capturing every published (event, payload). */
+function recordingEvents() {
+    const published = [];
+    return {
+        published,
+        publish(event, payload) {
+            published.push({ event, payload: payload });
+        },
+    };
+}
+test("with NO bridges configured, object + upload operations all succeed (Req 17.3, 19.3)", async () => {
+    const storage = createStorage({ provider: "memory" });
+    // Object operations.
+    const meta = await storage.put("k", "v");
+    assert.equal(meta.key, "k");
+    const got = await storage.get("k");
+    assert.equal(got.found, true);
+    await storage.delete("k");
+    assert.equal(await storage.exists("k"), false);
+    // Streaming upload.
+    const streamed = await storage.putStream("s", Readable.from([Buffer.from("stream-bytes")]));
+    assert.equal(streamed.key, "s");
+    assert.equal(await storage.exists("s"), true);
+    // Resumable upload.
+    const sessionId = await storage.startUpload("r");
+    const resumed = await storage.resumeUpload(sessionId, Readable.from([Buffer.from("resumed")]));
+    assert.equal(resumed.key, "r");
+    assert.equal(await storage.exists("r"), true);
+});
+test("with ALL THREE bridges throwing simultaneously, object operations still succeed (Req 17.4, 19.3)", async () => {
+    const storage = createStorage({ provider: "memory", bridges: throwingBridges() });
+    // put on a new key succeeds and returns metadata despite every bridge throwing.
+    const meta = await storage.put("k", "v", { contentType: "text/plain" });
+    assert.equal(meta.key, "k");
+    // get returns the stored bytes.
+    const got = await storage.get("k");
+    assert.equal(got.found, true);
+    // put overwriting (storage.updated path) still succeeds.
+    const updated = await storage.put("k", "v2");
+    assert.equal(updated.key, "k");
+    // delete succeeds and removes the object.
+    await storage.delete("k");
+    assert.equal(await storage.exists("k"), false);
+});
+test("with ALL THREE bridges throwing simultaneously, streaming + resumable uploads still succeed (Req 17.4, 19.3)", async () => {
+    const storage = createStorage({ provider: "memory", bridges: throwingBridges() });
+    // putStream broadcasts started/completed through a throwing realtime bridge —
+    // the upload must still complete.
+    const streamed = await storage.putStream("s", Readable.from([Buffer.from("stream-bytes")]));
+    assert.equal(streamed.key, "s");
+    assert.equal(await storage.exists("s"), true);
+    // resumeUpload likewise broadcasts through the throwing realtime bridge.
+    const sessionId = await storage.startUpload("r");
+    const resumed = await storage.resumeUpload(sessionId, Readable.from([Buffer.from("resumed")]));
+    assert.equal(resumed.key, "r");
+    assert.equal(await storage.exists("r"), true);
+});
+test("published events carry key + metadata even while queue + realtime bridges throw (Req 18.2)", async () => {
+    const events = recordingEvents();
+    const storage = createStorage({
+        provider: "memory",
+        bridges: {
+            events,
+            queue: {
+                dispatch() {
+                    throw new Error("queue down");
+                },
+            },
+            realtime: {
+                broadcast() {
+                    throw new Error("realtime down");
+                },
+            },
+        },
+    });
+    await storage.put("photo.png", "bytes", { contentType: "image/png" });
+    await storage.delete("photo.png");
+    assert.deepEqual(events.published.map((e) => e.event), ["storage.uploaded", "storage.deleted"]);
+    // storage.uploaded carries the affected key AND the full object metadata.
+    const uploaded = events.published[0].payload;
+    assert.equal(uploaded.key, "photo.png");
+    assert.ok(uploaded.metadata, "uploaded event must carry metadata");
+    assert.equal(uploaded.metadata.key, "photo.png");
+    assert.equal(uploaded.metadata.contentType, "image/png");
+    // storage.deleted carries the affected key.
+    const deleted = events.published[1].payload;
+    assert.equal(deleted.key, "photo.png");
+});
+//# sourceMappingURL=bridge-degradation.test.js.map

package/dist/tests/bridge-degradation.test.js.map

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

package/dist/tests/cli.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.test.d.ts.map

package/dist/tests/cli.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.test.d.ts","sourceRoot":"","sources":["../../src/tests/cli.test.ts"],"names":[],"mappings":""}

package/dist/tests/cli.test.js

@@ -0,0 +1,127 @@
+// cli.test.js — unit tests for the @streetjs/storage CLI generators and the
+// storage:verify command (Requirements 21.2, 21.4).
+//
+// Covers three concerns:
+//   (1) Generator name validation — isValidGeneratorName / generateStorage
+//       reject invalid names and accept valid PascalCase identifiers.
+//   (2) Compile-clean scaffold output — the generated `contents` imports only
+//       public @streetjs/storage symbols (createStorage + StorageConfig) and
+//       wires them into a typed factory.
+//   (3) storage:verify pass/fail reporting — StorageCommands.storageVerify
+//       reports a pass for the built-in memory provider (process.exitCode is
+//       not set to 1) and a failure for an unknown/misconfigured provider
+//       (process.exitCode === 1).
+//
+// Uses the Node.js built-in test runner (node:test); executed via
+// `node --test dist/tests/*.test.js`.
+import test from "node:test";
+import assert from "node:assert/strict";
+import { generateStorage, isValidGeneratorName, isValidProvider, DEFAULT_STORAGE_DIR, } from "../cli/generators.js";
+import { StorageCommands } from "../cli/commands.js";
+// ── Helpers ───────────────────────────────────────────────────────────────────
+/** Build a ParsedArgs object matching the shape streetjs' parseArgv produces. */
+function parsedArgs(options = {}) {
+    const { command = null, positional = [], flags = {} } = options;
+    return { command, positional, flags };
+}
+/**
+ * Run `fn` while capturing everything written to console.log/console.error and
+ * with process.exitCode reset, restoring both afterwards. Returns the captured
+ * output plus the exitCode observed after `fn` completes.
+ */
+async function captureRun(fn) {
+    const originalLog = console.log;
+    const originalError = console.error;
+    const originalExitCode = process.exitCode;
+    const logs = [];
+    const errors = [];
+    console.log = (...args) => logs.push(args.join(" "));
+    console.error = (...args) => errors.push(args.join(" "));
+    process.exitCode = undefined;
+    try {
+        await fn();
+        return { logs, errors, exitCode: process.exitCode };
+    }
+    finally {
+        console.log = originalLog;
+        console.error = originalError;
+        process.exitCode = originalExitCode;
+    }
+}
+// ── (1) Generator name validation ──────────────────────────────────────────────
+test("isValidGeneratorName rejects invalid names and accepts PascalCase", () => {
+    // Invalid: empty, non-identifier, leading digit, hyphen/space/dot.
+    assert.equal(isValidGeneratorName(""), false);
+    assert.equal(isValidGeneratorName("1Uploads"), false);
+    assert.equal(isValidGeneratorName("my-storage"), false);
+    assert.equal(isValidGeneratorName("my storage"), false);
+    assert.equal(isValidGeneratorName("Up.loads"), false);
+    assert.equal(isValidGeneratorName("$Uploads"), false);
+    // Valid: identifier-safe tokens including PascalCase.
+    assert.equal(isValidGeneratorName("Uploads"), true);
+    assert.equal(isValidGeneratorName("UserAvatars"), true);
+    assert.equal(isValidGeneratorName("A1"), true);
+    assert.equal(isValidGeneratorName("uploads"), true);
+});
+test("generateStorage throws for invalid names before producing output", () => {
+    assert.throws(() => generateStorage(""), /Invalid generator name/);
+    assert.throws(() => generateStorage("bad-name"), /Invalid generator name/);
+    assert.throws(() => generateStorage("9lives"), /Invalid generator name/);
+});
+test("generateStorage throws for a non-built-in provider", () => {
+    assert.throws(() => generateStorage("Uploads", DEFAULT_STORAGE_DIR, "s3"), /Invalid storage provider/);
+    assert.equal(isValidProvider("memory"), true);
+    assert.equal(isValidProvider("local"), true);
+    assert.equal(isValidProvider("s3"), false);
+});
+// ── (2) Compile-clean scaffold output ──────────────────────────────────────────
+test("generateStorage emits a scaffold importing only public @streetjs/storage symbols", () => {
+    const result = generateStorage("Uploads");
+    // Path is derived from the PascalCase class name under the default dir.
+    assert.ok(result.path.endsWith("UploadsStorage.ts"), `unexpected path: ${result.path}`);
+    const contents = result.contents;
+    // Imports only the public package entry point (no deep/internal imports).
+    assert.match(contents, /import \{ createStorage \} from "@streetjs\/storage";/);
+    assert.match(contents, /import type \{ Storage, StorageConfig \} from "@streetjs\/storage";/);
+    assert.ok(!/from "\.\//.test(contents) && !/from "\.\.\//.test(contents), "scaffold must not import from relative/internal paths");
+    // Wires a typed StorageConfig and a factory that calls createStorage.
+    assert.match(contents, /: StorageConfig = \{/);
+    assert.match(contents, /provider: "memory"/);
+    assert.match(contents, /export function createUploadsStorage\(\): Storage \{/);
+    assert.match(contents, /return createStorage\(/);
+});
+test("generateStorage local provider scaffold supplies a root and stays on the public surface", () => {
+    const result = generateStorage("Assets", DEFAULT_STORAGE_DIR, "local");
+    const contents = result.contents;
+    assert.match(contents, /provider: "local"/);
+    assert.match(contents, /root: "\.\/var\/assets"/);
+    assert.match(contents, /import \{ createStorage \} from "@streetjs\/storage";/);
+});
+// ── (3) storage:verify pass/fail reporting ──────────────────────────────────────
+test("storageVerify reports a pass for the built-in memory provider", async () => {
+    const commands = new StorageCommands();
+    const args = parsedArgs({ command: "storage:verify", flags: { provider: "memory" } });
+    const { logs, exitCode } = await captureRun(() => commands.storageVerify(args));
+    // A passing run must NOT set a failure exit code.
+    assert.notEqual(exitCode, 1);
+    const output = logs.join("\n");
+    assert.match(output, /Contract conformance for driver "memory"/);
+    assert.match(output, /— PASS\./);
+    // No FAIL check lines expected.
+    assert.ok(!/\[FAIL\]/.test(output), "memory provider should have no failing checks");
+});
+test("storageVerify reports failure for an unknown provider (exitCode 1)", async () => {
+    const commands = new StorageCommands();
+    const args = parsedArgs({ command: "storage:verify", flags: { provider: "does-not-exist" } });
+    const { errors, exitCode } = await captureRun(() => commands.storageVerify(args));
+    assert.equal(exitCode, 1);
+    assert.match(errors.join("\n"), /Unknown storage provider "does-not-exist"/);
+});
+test("storageVerify reports failure for a misconfigured local provider (missing root)", async () => {
+    const commands = new StorageCommands();
+    const args = parsedArgs({ command: "storage:verify", flags: { provider: "local" } });
+    const { errors, exitCode } = await captureRun(() => commands.storageVerify(args));
+    assert.equal(exitCode, 1);
+    assert.match(errors.join("\n"), /"local" storage provider requires a "root" directory/);
+});
+//# sourceMappingURL=cli.test.js.map

package/dist/tests/cli.test.js.map

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

package/dist/tests/contract.d.ts

@@ -0,0 +1,131 @@
+/**
+ * @streetjs/storage — the shared, parameterized contract-conformance suite.
+ *
+ * Requirement 2 states that every provider implements one `StorageDriver`
+ * contract with identical observable behavior: object existence, content bytes,
+ * and returned metadata must be equivalent across drivers (Requirement 2.1,
+ * 2.3), and a missing key must be reported the same way everywhere
+ * (Requirement 2.4). This module encodes the observable core of that contract
+ * as a **reusable, driver-agnostic conformance suite** so the exact same checks
+ * can be run against any {@link StorageDriver} — the zero-dependency Memory and
+ * Local drivers, the in-process testing doubles, and every cloud driver.
+ *
+ * The suite is designed to be consumed in two ways from one definition:
+ *
+ * - **Programmatically** (returns pass/fail results). {@link runStorageDriverContract}
+ *   runs every check against a freshly constructed driver and returns a
+ *   {@link ContractReport} describing which checks passed. This is what the
+ *   `storage:verify` CLI command (task 24.2) uses to report whether the
+ *   configured driver satisfies the contract, and what Property 19 (task 27.3)
+ *   uses to assert that every driver conforms.
+ * - **As node:test tests**. {@link registerStorageDriverContractTests} turns each
+ *   check into a `node:test` case using a caller-supplied `test` function, so a
+ *   thin `*.test.js` can run the suite against Memory + Local without this
+ *   support module importing `node:test` itself (keeping it importable from the
+ *   CLI, which has no test runner in scope).
+ *
+ * Each check receives its **own freshly constructed driver** (from the supplied
+ * factory) so checks are fully isolated and order-independent. Assertions use
+ * `node:assert/strict`; a check throws on failure and returns normally on
+ * success. The checked behaviors are:
+ *
+ * 1. **existence** — `put` then `exists(key)` is `true`; `exists(other)` is `false`.
+ * 2. **byte round-trip** — `put(key, bytes)` then `get(key)` yields
+ *    `{ found: true }` with content bytes exactly equal to the input.
+ * 3. **not-found (get)** — `get(missing)` yields `{ found: false }`.
+ * 4. **not-found (stat)** — `stat(missing)` yields `null`.
+ * 5. **metadata shape** — `put` returns the complete typed
+ *    {@link StorageObjectMetadata} field set with correctly typed values.
+ *
+ * This module is a support module under `src/tests/` (not itself a `*.test.js`
+ * picked up by the default test glob); it is imported by tests and by the CLI.
+ *
+ * _Requirements: 2.1, 2.3, 2.4_
+ */
+import type { StorageDriver } from "../driver.js";
+/**
+ * A single named conformance check. {@link run} performs the check against the
+ * supplied driver and throws (via `node:assert`) when the driver violates the
+ * contract; it returns normally when the check passes.
+ */
+export interface ContractCheck {
+    /** Stable, human-readable check name (e.g. "byte round-trip"). */
+    readonly name: string;
+    /** The acceptance-criteria reference this check exercises. */
+    readonly requirement: string;
+    /** Run the check against `driver`; throws on violation. */
+    run(driver: StorageDriver): Promise<void>;
+}
+/** The outcome of running a single {@link ContractCheck}. */
+export interface ContractCheckResult {
+    readonly name: string;
+    readonly requirement: string;
+    readonly passed: boolean;
+    /** The failure message when {@link passed} is `false`. */
+    readonly error?: string;
+}
+/** The aggregate outcome of running the whole suite against one driver. */
+export interface ContractReport {
+    /** The `name` of the driver under test (e.g. "memory", "local", "s3"). */
+    readonly driver: string;
+    /** `true` when every check passed. */
+    readonly passed: boolean;
+    /** Per-check results, in suite order. */
+    readonly results: readonly ContractCheckResult[];
+}
+/**
+ * Produces a fresh {@link StorageDriver} to test. A new instance is requested
+ * for each check so the checks are isolated from one another; the factory may
+ * be async (e.g. to allocate a temp directory for the Local driver).
+ */
+export type StorageDriverFactory = () => StorageDriver | Promise<StorageDriver>;
+/**
+ * A minimal `node:test`-style runner: a function taking a test name and an async
+ * body. Callers pass `test` from `node:test`; typing it structurally keeps this
+ * module free of a hard `node:test` import so it stays importable from the CLI.
+ */
+export type TestRunner = (name: string, fn: () => void | Promise<void>) => unknown;
+/**
+ * The ordered set of observable-behavior checks that make up the driver
+ * contract-conformance suite. Exported so consumers can inspect, subset, or
+ * extend the list; most callers use {@link runStorageDriverContract} or
+ * {@link registerStorageDriverContractTests} instead.
+ */
+export declare const storageDriverContractChecks: readonly ContractCheck[];
+/** Options for {@link runStorageDriverContract}. */
+export interface RunContractOptions {
+    /** Override the checks to run. Defaults to {@link storageDriverContractChecks}. */
+    readonly checks?: readonly ContractCheck[];
+}
+/**
+ * Run the contract-conformance suite against a driver and return a pass/fail
+ * {@link ContractReport}. Each check is executed against a freshly constructed
+ * driver from `makeDriver` so the checks never interfere with one another.
+ *
+ * This never throws for a contract violation — a failing check is captured as a
+ * `passed: false` entry with its error message — so a consumer such as the
+ * `storage:verify` CLI (task 24.2) can render every result. Property 19
+ * (task 27.3) uses the returned {@link ContractReport.passed} to assert
+ * conformance across drivers.
+ *
+ * @param makeDriver Factory producing a fresh driver for each check.
+ * @param options Optional override of the checks to run.
+ */
+export declare function runStorageDriverContract(makeDriver: StorageDriverFactory, options?: RunContractOptions): Promise<ContractReport>;
+/**
+ * Register each contract check as an individual `node:test` case using the
+ * supplied `test` runner. A thin `*.test.js` passes `test` from `node:test` and
+ * a driver factory; each check runs against a fresh driver and fails the test if
+ * the driver violates the contract.
+ *
+ * Taking the runner as a parameter keeps this module free of a hard `node:test`
+ * import, so it remains importable from non-test contexts (e.g. the CLI's
+ * `storage:verify`).
+ *
+ * @param label Prefix for each generated test name (e.g. the driver label).
+ * @param makeDriver Factory producing a fresh driver for each check.
+ * @param runner The `test` function from `node:test` (or a compatible runner).
+ * @param checks Optional override of the checks to run.
+ */
+export declare function registerStorageDriverContractTests(label: string, makeDriver: StorageDriverFactory, runner: TestRunner, checks?: readonly ContractCheck[]): void;
+//# sourceMappingURL=contract.d.ts.map

package/dist/tests/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/tests/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAMlD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAClD;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAEhF;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC;AAmEnF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,aAAa,EAuE/D,CAAC;AAIF,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,mFAAmF;IACnF,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAC5C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,oBAAoB,EAChC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,cAAc,CAAC,CA0BzB;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,UAAU,EAClB,MAAM,GAAE,SAAS,aAAa,EAAgC,GAC7D,IAAI,CAON"}