@streetjs/storage 1.0.0 → 1.0.1

package/dist/tests/cli.test.js

@@ -1,127 +0,0 @@
-// 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

@@ -1 +0,0 @@
-{"version":3,"file":"cli.test.js","sourceRoot":"","sources":["../../src/tests/cli.test.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,oDAAoD;AACpD,EAAE;AACF,yBAAyB;AACzB,2EAA2E;AAC3E,sEAAsE;AACtE,8EAA8E;AAC9E,6EAA6E;AAC7E,yCAAyC;AACzC,2EAA2E;AAC3E,6EAA6E;AAC7E,0EAA0E;AAC1E,kCAAkC;AAClC,EAAE;AACF,kEAAkE;AAClE,sCAAsC;AAEtC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAIxC,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,iFAAiF;AAEjF,iFAAiF;AACjF,SAAS,UAAU,CACjB,UAII,EAAE;IAEN,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,UAAU,GAAG,EAAE,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAChE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,UAAU,CAAC,EAAiB;IAKzC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAChC,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC;IACpC,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC1C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,EAAE,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;IACtD,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,GAAG,GAAG,WAAW,CAAC;QAC1B,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC;QAC9B,OAAO,CAAC,QAAQ,GAAG,gBAAgB,CAAC;IACtC,CAAC;AACH,CAAC;AAED,kFAAkF;AAElF,IAAI,CAAC,mEAAmE,EAAE,GAAG,EAAE;IAC7E,mEAAmE;IACnE,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IACtD,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,CAAC;IACxD,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,CAAC;IACxD,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IACtD,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IAEtD,sDAAsD;IACtD,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kEAAkE,EAAE,GAAG,EAAE;IAC5E,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,wBAAwB,CAAC,CAAC;IACnE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,wBAAwB,CAAC,CAAC;IAC3E,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC,CAAC;AAC3E,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;IAC9D,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,mBAAmB,EAAE,IAAuB,CAAC,EAC9E,0BAA0B,CAC3B,CAAC;IACF,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEH,kFAAkF;AAElF,IAAI,CAAC,kFAAkF,EAAE,GAAG,EAAE;IAC5F,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IAE1C,wEAAwE;IACxE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,oBAAoB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAExF,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAEjC,0EAA0E;IAC1E,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,uDAAuD,CAAC,CAAC;IAChF,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,qEAAqE,CAAC,CAAC;IAC9F,MAAM,CAAC,EAAE,CACP,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,EAC9D,uDAAuD,CACxD,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IAC/C,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,sDAAsD,CAAC,CAAC;IAC/E,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yFAAyF,EAAE,GAAG,EAAE;IACnG,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IAC5C,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,uDAAuD,CAAC,CAAC;AAClF,CAAC,CAAC,CAAC;AAEH,mFAAmF;AAEnF,IAAI,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;IAC/E,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEtF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhF,kDAAkD;IAClD,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,0CAA0C,CAAC,CAAC;IACjE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjC,gCAAgC;IAChC,MAAM,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,+CAA+C,CAAC,CAAC;AACvF,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;IACpF,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAE9F,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAElF,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC1B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,2CAA2C,CAAC,CAAC;AAC/E,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iFAAiF,EAAE,KAAK,IAAI,EAAE;IACjG,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IAErF,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAElF,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC1B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,sDAAsD,CAAC,CAAC;AAC1F,CAAC,CAAC,CAAC"}

package/dist/tests/contract.d.ts

@@ -1,131 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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"}

package/dist/tests/contract.js

@@ -1,222 +0,0 @@
-/**
- * @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 assert from "node:assert/strict";
-import { STORAGE_METADATA_FIELDS } from "../metadata.js";
-// ── Test fixtures ─────────────────────────────────────────────────────────────
-/** Encode a UTF-8 string into a Uint8Array for storage. */
-function bytesOf(str) {
-    return new TextEncoder().encode(str);
-}
-/** The full set of access levels, used to validate the `accessLevel` field. */
-const ACCESS_LEVELS = [
-    "public",
-    "private",
-    "signed",
-    "authenticated",
-    "role-based",
-    "tenant-aware",
-];
-/**
- * Assert that `metadata` carries the complete typed {@link StorageObjectMetadata}
- * field set with correctly typed values. Uses {@link STORAGE_METADATA_FIELDS} as
- * the single source of truth for the required field names so this check tracks
- * the canonical shape automatically (Requirement 2.1, 10.1).
- */
-function assertMetadataShape(metadata, expected) {
-    assert.ok(metadata !== null && typeof metadata === "object", "put must return a metadata object");
-    // Every canonical field must be present as an own key.
-    for (const field of STORAGE_METADATA_FIELDS) {
-        assert.ok(field in metadata, `metadata is missing required field "${field}"`);
-    }
-    // Identity / value fields must be correctly typed.
-    assert.equal(metadata.key, expected.key, "metadata.key must equal the stored key");
-    assert.equal(metadata.size, expected.size, "metadata.size must equal the byte length");
-    assert.equal(typeof metadata.contentType, "string", "metadata.contentType must be a string");
-    assert.equal(typeof metadata.etag, "string", "metadata.etag must be a string");
-    assert.equal(typeof metadata.checksum, "string", "metadata.checksum must be a string");
-    assert.equal(typeof metadata.createdAt, "number", "metadata.createdAt must be a number");
-    assert.equal(typeof metadata.updatedAt, "number", "metadata.updatedAt must be a number");
-    assert.ok(metadata.custom !== null && typeof metadata.custom === "object", "metadata.custom must be an object");
-    assert.ok(ACCESS_LEVELS.includes(metadata.accessLevel), `metadata.accessLevel must be a valid AccessLevel (got "${metadata.accessLevel}")`);
-    // owner/tenant are optional: absent (undefined) or a string.
-    if (metadata.owner !== undefined) {
-        assert.equal(typeof metadata.owner, "string", "metadata.owner must be a string when present");
-    }
-    if (metadata.tenant !== undefined) {
-        assert.equal(typeof metadata.tenant, "string", "metadata.tenant must be a string when present");
-    }
-}
-// ── The checks ────────────────────────────────────────────────────────────────
-/**
- * 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 const storageDriverContractChecks = [
-    {
-        name: "existence: put then exists reports presence and absence",
-        requirement: "2.1",
-        async run(driver) {
-            const key = "contract/existence.txt";
-            assert.equal(await driver.exists(key), false, "exists must be false before the object is stored");
-            await driver.put(key, bytesOf("present"), {});
-            assert.equal(await driver.exists(key), true, "exists must be true after put");
-            assert.equal(await driver.exists("contract/never-written.txt"), false, "exists must be false for an unrelated key");
-        },
-    },
-    {
-        name: "byte round-trip: get returns the stored bytes unchanged",
-        requirement: "2.1",
-        async run(driver) {
-            const key = "contract/round-trip.bin";
-            // Include boundary byte values so a lossy round-trip is caught.
-            const content = new Uint8Array([0, 1, 127, 128, 254, 255, 65, 66, 67]);
-            await driver.put(key, content, {});
-            const result = await driver.get(key);
-            assert.equal(result.found, true, "get must report found:true for a stored key");
-            assert.ok(result.found === true, "narrowing: result must be the found variant");
-            assert.deepEqual(result.bytes, content, "get must return the exact stored bytes");
-        },
-    },
-    {
-        name: "not-found (get): missing key reports found:false",
-        requirement: "2.4",
-        async run(driver) {
-            const result = await driver.get("contract/absent-get.txt");
-            assert.equal(result.found, false, "get on a missing key must report found:false");
-            assert.ok(result.found === false, "the not-found result must be the { found: false } variant");
-        },
-    },
-    {
-        name: "not-found (stat): missing key reports null",
-        requirement: "2.4",
-        async run(driver) {
-            const meta = await driver.stat("contract/absent-stat.txt");
-            assert.equal(meta, null, "stat on a missing key must return null");
-        },
-    },
-    {
-        name: "metadata shape: put returns the complete typed field set",
-        requirement: "2.1",
-        async run(driver) {
-            const key = "contract/metadata-shape.txt";
-            const content = bytesOf("shape check");
-            const metadata = await driver.put(key, content, {
-                contentType: "text/plain",
-                owner: "user-1",
-                tenant: "tenant-a",
-                accessLevel: "public",
-                custom: { label: "invoice" },
-            });
-            assertMetadataShape(metadata, { key, size: content.byteLength });
-        },
-    },
-];
-/**
- * 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 async function runStorageDriverContract(makeDriver, options) {
-    const checks = options?.checks ?? storageDriverContractChecks;
-    const results = [];
-    let driverName = "unknown";
-    for (const check of checks) {
-        const driver = await makeDriver();
-        driverName = driver.name;
-        try {
-            await check.run(driver);
-            results.push({ name: check.name, requirement: check.requirement, passed: true });
-        }
-        catch (error) {
-            results.push({
-                name: check.name,
-                requirement: check.requirement,
-                passed: false,
-                error: error instanceof Error ? error.message : String(error),
-            });
-        }
-    }
-    return {
-        driver: driverName,
-        passed: results.every((result) => result.passed),
-        results,
-    };
-}
-// ── node:test integration ─────────────────────────────────────────────────────
-/**
- * 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 function registerStorageDriverContractTests(label, makeDriver, runner, checks = storageDriverContractChecks) {
-    for (const check of checks) {
-        runner(`${label}: ${check.name}`, async () => {
-            const driver = await makeDriver();
-            await check.run(driver);
-        });
-    }
-}
-//# sourceMappingURL=contract.js.map

package/dist/tests/contract.js.map

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

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

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

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

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

package/dist/tests/contract.test.js

@@ -1,110 +0,0 @@
-// Contract-conformance suite run against the two zero-dependency drivers.
-//
-// Exercises the shared, parameterized suite from `./contract.js` (task 27.1)
-// against MemoryStorageDriver and LocalStorageDriver, verifying both directions
-// it is consumed in production:
-//
-//   - as node:test cases via registerStorageDriverContractTests (what a driver's
-//     own test file would do), and
-//   - programmatically via runStorageDriverContract (what `storage:verify` and
-//     Property 19 use), asserting the returned report passes for every check.
-//
-// Each check receives a freshly constructed driver from the supplied factory;
-// the Local driver gets a fresh temp directory per instance so checks stay
-// isolated. Executed via `node --test dist/tests/*.test.js`.
-//
-// Requirements: 2.1, 2.3, 2.4
-import test from "node:test";
-import assert from "node:assert/strict";
-import { mkdtempSync, rmSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { runStorageDriverContract, registerStorageDriverContractTests, storageDriverContractChecks, } from "./contract.js";
-import { MemoryStorageDriver } from "../drivers/memory.js";
-import { LocalStorageDriver } from "../drivers/local.js";
-/** A fixed clock for deterministic timestamps. */
-const fixedClock = () => 1_700_000_000_000;
-/** Factory: a fresh in-memory driver per call. */
-function makeMemoryDriver() {
-    return new MemoryStorageDriver({ clock: fixedClock });
-}
-/** Temp roots allocated for Local drivers, cleaned up after the run. */
-const tempRoots = [];
-/** Factory: a fresh filesystem driver rooted at a unique temp dir per call. */
-function makeLocalDriver() {
-    const root = mkdtempSync(join(tmpdir(), "streetjs-storage-contract-"));
-    tempRoots.push(root);
-    return new LocalStorageDriver({ root, clock: fixedClock });
-}
-test.after(() => {
-    for (const root of tempRoots) {
-        rmSync(root, { recursive: true, force: true });
-    }
-});
-// ── As node:test cases (per-driver, per-check) ────────────────────────────────
-registerStorageDriverContractTests("memory driver contract", makeMemoryDriver, test);
-registerStorageDriverContractTests("local driver contract", makeLocalDriver, test);
-// ── Programmatically (the storage:verify / Property 19 consumption path) ──────
-test("runStorageDriverContract reports a full pass for the memory driver", async () => {
-    const report = await runStorageDriverContract(makeMemoryDriver);
-    assert.equal(report.driver, "memory");
-    assert.equal(report.passed, true);
-    assert.equal(report.results.length, storageDriverContractChecks.length);
-    assert.ok(report.results.every((result) => result.passed), `all checks must pass, got: ${JSON.stringify(report.results)}`);
-});
-test("runStorageDriverContract reports a full pass for the local driver", async () => {
-    const report = await runStorageDriverContract(makeLocalDriver);
-    assert.equal(report.driver, "local");
-    assert.equal(report.passed, true);
-    assert.equal(report.results.length, storageDriverContractChecks.length);
-    assert.ok(report.results.every((result) => result.passed), `all checks must pass, got: ${JSON.stringify(report.results)}`);
-});
-test("a non-conforming driver is reported as failed, not thrown", async () => {
-    // A driver that always reports a missing object exists violates the
-    // not-found and round-trip checks; the runner must capture this as failures
-    // rather than throwing.
-    const brokenDriver = {
-        name: "broken",
-        async put(key, bytes) {
-            return {
-                key,
-                size: bytes.byteLength,
-                contentType: "application/octet-stream",
-                etag: "x",
-                checksum: "x",
-                accessLevel: "private",
-                createdAt: 0,
-                updatedAt: 0,
-                custom: {},
-            };
-        },
-        async get() {
-            return { found: false };
-        },
-        async exists() {
-            return false;
-        },
-        async delete() { },
-        async stat() {
-            return null;
-        },
-        async list() {
-            return [];
-        },
-        async putStream(key, _stream, _metadata) {
-            return this.put(key, new Uint8Array(), {});
-        },
-        async getStream() {
-            throw new Error("unsupported");
-        },
-    };
-    const report = await runStorageDriverContract(() => brokenDriver);
-    assert.equal(report.driver, "broken");
-    assert.equal(report.passed, false);
-    // existence and byte round-trip must fail (get always reports not-found);
-    // the two not-found checks and metadata shape still pass.
-    const failed = report.results.filter((result) => !result.passed).map((r) => r.name);
-    assert.ok(failed.some((name) => name.startsWith("existence")), "existence check should fail for the broken driver");
-    assert.ok(failed.some((name) => name.startsWith("byte round-trip")), "byte round-trip check should fail for the broken driver");
-});
-//# sourceMappingURL=contract.test.js.map

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

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

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

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

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

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