@streetjs/storage 1.0.1 → 1.0.2

package/dist/tests/contract.d.ts

@@ -0,0 +1,150 @@
+/**
+ * @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";
+/**
+ * Report whether an optional provider SDK module specifier can be resolved in
+ * this process, without importing/evaluating it as a side effect.
+ *
+ * Several driver unit test suites (Supabase, GCS, Azure) assert that
+ * `connectXDriver` throws `StorageConfigError` specifically *because* the
+ * optional peer SDK is absent. That assertion's precondition — the SDK is
+ * unresolvable — holds by default, but Node module resolution is process-wide,
+ * not test-file-scoped: a live-integration test run that installs the SDKs (to
+ * exercise genuine round-trips; see non-s3-integration.test.ts) makes the SDK
+ * resolvable for every test file sharing that `node --test` process. Callers use
+ * this probe to honestly skip that specific guard test in that situation, rather
+ * than reporting a false failure, matching this package's established
+ * honest-skip convention (Requirement 27.3/27.4).
+ *
+ * @param {string} specifier The module specifier to probe (e.g. `"@supabase/supabase-js"`).
+ * @returns {Promise<boolean>} `true` when the specifier resolves to an installed module.
+ */
+export declare function isSdkResolvable(specifier: string): boolean;
+/**
+ * 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;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAO1D;AAID;;;;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

@@ -0,0 +1,250 @@
+/**
+ * @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";
+// ── Optional-SDK resolvability probe ──────────────────────────────────────────
+/**
+ * Report whether an optional provider SDK module specifier can be resolved in
+ * this process, without importing/evaluating it as a side effect.
+ *
+ * Several driver unit test suites (Supabase, GCS, Azure) assert that
+ * `connectXDriver` throws `StorageConfigError` specifically *because* the
+ * optional peer SDK is absent. That assertion's precondition — the SDK is
+ * unresolvable — holds by default, but Node module resolution is process-wide,
+ * not test-file-scoped: a live-integration test run that installs the SDKs (to
+ * exercise genuine round-trips; see non-s3-integration.test.ts) makes the SDK
+ * resolvable for every test file sharing that `node --test` process. Callers use
+ * this probe to honestly skip that specific guard test in that situation, rather
+ * than reporting a false failure, matching this package's established
+ * honest-skip convention (Requirement 27.3/27.4).
+ *
+ * @param {string} specifier The module specifier to probe (e.g. `"@supabase/supabase-js"`).
+ * @returns {Promise<boolean>} `true` when the specifier resolves to an installed module.
+ */
+export function isSdkResolvable(specifier) {
+    try {
+        import.meta.resolve(specifier);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ── 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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streetjs/storage",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "StreetJS unified storage framework: a strongly-typed, plugin-first, driver-based object storage layer with zero-dependency in-memory and filesystem drivers, streaming, validation, metadata, multipart, resumable uploads, signed URLs, versioning, lifecycle, access control, and optional cloud provider integrations (S3, R2, Supabase, GCS, Azure, MinIO, Backblaze) isolated behind optional submodules.",
   "type": "module",
   "main": "./dist/index.js",
@@ -52,8 +52,6 @@
     "!dist/**/*.test.js.map",
     "!dist/**/*.test.d.ts",
     "!dist/**/*.test.d.ts.map",
-    "!dist/tests/**",
-    "!dist/**/__tests__/**",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"