@streetjs/storage 1.0.0 → 1.0.2

package/dist/tests/prop-driver-equivalence.test.js

@@ -1,163 +0,0 @@
-// Property-based test: Memory and Local drivers are observationally equivalent.
-//
-// Property 18 (Memory and Local drivers are observationally equivalent): for an
-// arbitrary sequence of object operations (put/get/exists/delete/list/stat)
-// applied identically to a `MemoryStorageDriver` and a `LocalStorageDriver`
-// (both constructed with the SAME injected fixed clock, the Local driver bound
-// to a fresh temp dir), the observable results are equivalent at every step —
-// object existence, content bytes, and returned metadata (contentType, size,
-// checksum, etag, accessLevel, owner, tenant, custom). The two zero-dependency
-// drivers are interchangeable, so the same generated op sequence must produce
-// the same observations on both.
-//
-// Uses the Node.js built-in test runner (node:test) with fast-check for input
-// generation, executed via `node --test dist/tests/*.test.js`. fast-check is
-// configured with { numRuns: 100 } per the design's property-testing contract.
-//
-// Feature: unified-storage-framework, Property 18: Memory and Local drivers are observationally equivalent
-//
-// Validates: Requirements 2.2, 26.6
-import test from "node:test";
-import assert from "node:assert/strict";
-import * as fs from "node:fs/promises";
-import * as os from "node:os";
-import * as path from "node:path";
-import fc from "fast-check";
-import { MemoryStorageDriver } from "../drivers/memory.js";
-import { LocalStorageDriver } from "../drivers/local.js";
-/** A fixed clock so both drivers stamp identical timestamps for the same op. */
-const fixedClock = () => 1_700_000_000_000;
-/** The valid AccessLevel values (Requirement 11.1). */
-const ACCESS_LEVELS = [
-    "public",
-    "private",
-    "signed",
-    "authenticated",
-    "role-based",
-    "tenant-aware",
-];
-/**
- * A fixed pool of filesystem-safe keys. No key is a directory-component prefix
- * of another (e.g. there is never both a file `docs` and a file `docs/x`), so
- * the Local driver's on-disk layout can represent any subset the op sequence
- * touches without a file/directory collision — keeping the two drivers on equal
- * footing for the observable behavior under test.
- */
-const KEYS = [
-    "alpha.txt",
-    "beta.txt",
-    "docs/one.txt",
-    "docs/two.txt",
-    "docs/sub/three.txt",
-    "images/a.png",
-    "images/b.png",
-];
-/** Prefixes exercised by `list`, including the empty (match-all) prefix. */
-const PREFIXES = ["", "docs/", "docs/sub/", "images/", "alpha.txt", "doc", "images/a.png"];
-const keyArb = fc.constantFrom(...KEYS);
-const contentArb = fc.uint8Array({ minLength: 0, maxLength: 64 });
-/** Custom metadata with JSON-round-trippable values so it can compare exactly. */
-const customArb = fc.dictionary(fc.string({ maxLength: 12 }), fc.oneof(fc.string(), fc.integer(), fc.boolean()), { maxKeys: 4 });
-/** Arbitrary write-time metadata; every field optional to cover the defaults. */
-const writeMetadataArb = fc.record({
-    contentType: fc.string({ minLength: 1, maxLength: 30 }),
-    owner: fc.string({ minLength: 1, maxLength: 30 }),
-    tenant: fc.string({ minLength: 1, maxLength: 30 }),
-    accessLevel: fc.constantFrom(...ACCESS_LEVELS),
-    custom: customArb,
-}, { requiredKeys: [] });
-/** Optional list options; both drivers implement these identically. */
-const listOptionsArb = fc.record({
-    limit: fc.integer({ min: 1, max: 5 }),
-    cursor: fc.constantFrom(...KEYS),
-    delimiter: fc.boolean(),
-}, { requiredKeys: [] });
-/** A single object operation applied identically to both drivers. */
-const operationArb = fc.oneof(fc.record({ type: fc.constant("put"), key: keyArb, bytes: contentArb, meta: writeMetadataArb }), fc.record({ type: fc.constant("get"), key: keyArb }), fc.record({ type: fc.constant("exists"), key: keyArb }), fc.record({ type: fc.constant("delete"), key: keyArb }), fc.record({ type: fc.constant("stat"), key: keyArb }), fc.record({ type: fc.constant("list"), prefix: fc.constantFrom(...PREFIXES), options: listOptionsArb }));
-const sequenceArb = fc.array(operationArb, { minLength: 1, maxLength: 30 });
-/**
- * Project a metadata record onto the observable field set the property compares.
- * `owner`/`tenant` collapse absent-vs-undefined to `null` so a driver that
- * persists metadata through JSON (which drops `undefined` keys) compares equal
- * to one that keeps the key present with an `undefined` value.
- */
-function projectMetadata(meta) {
-    if (meta === null || meta === undefined) {
-        return null;
-    }
-    return {
-        key: meta.key,
-        size: meta.size,
-        contentType: meta.contentType,
-        checksum: meta.checksum,
-        etag: meta.etag,
-        accessLevel: meta.accessLevel,
-        owner: meta.owner ?? null,
-        tenant: meta.tenant ?? null,
-        // Spread into a plain object so a null-prototype custom map (as produced by
-        // fast-check's dictionary generator and kept verbatim by the in-memory
-        // driver) compares equal by content to the plain object the Local driver
-        // reconstructs from its JSON sidecar. The observable custom fields are the
-        // key/value pairs, not the object's internal prototype tag.
-        custom: { ...(meta.custom ?? {}) },
-        createdAt: meta.createdAt,
-        updatedAt: meta.updatedAt,
-    };
-}
-/** Apply one operation to a driver and return its canonical observation. */
-async function applyOp(driver, op) {
-    switch (op.type) {
-        case "put": {
-            const meta = await driver.put(op.key, op.bytes, op.meta);
-            return { type: "put", meta: projectMetadata(meta) };
-        }
-        case "get": {
-            const result = await driver.get(op.key);
-            return {
-                type: "get",
-                found: result.found,
-                bytes: result.found ? Array.from(result.bytes) : null,
-                meta: result.found ? projectMetadata(result.metadata) : null,
-            };
-        }
-        case "exists": {
-            return { type: "exists", exists: await driver.exists(op.key) };
-        }
-        case "delete": {
-            await driver.delete(op.key);
-            return { type: "delete" };
-        }
-        case "stat": {
-            return { type: "stat", meta: projectMetadata(await driver.stat(op.key)) };
-        }
-        case "list": {
-            const items = await driver.list(op.prefix, op.options);
-            return {
-                type: "list",
-                items: items.map((item) => ({ key: item.key, size: item.size, updatedAt: item.updatedAt })),
-            };
-        }
-        default:
-            throw new Error(`unknown op type: ${op.type}`);
-    }
-}
-test("Feature: unified-storage-framework, Property 18: Memory and Local drivers are observationally equivalent", async () => {
-    await fc.assert(fc.asyncProperty(sequenceArb, async (operations) => {
-        // Fresh temp dir + fresh drivers per run keep every sequence independent.
-        const root = await fs.mkdtemp(path.join(os.tmpdir(), "streetjs-driver-equiv-"));
-        const memory = new MemoryStorageDriver({ clock: fixedClock });
-        const local = new LocalStorageDriver({ root, clock: fixedClock });
-        try {
-            for (let i = 0; i < operations.length; i++) {
-                const op = operations[i];
-                const memObs = await applyOp(memory, op);
-                const localObs = await applyOp(local, op);
-                assert.deepEqual(localObs, memObs, `observation diverged at step ${i} for op ${JSON.stringify(op.type)} (key=${"key" in op ? op.key : op.prefix})`);
-            }
-        }
-        finally {
-            await fs.rm(root, { recursive: true, force: true });
-        }
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-driver-equivalence.test.js.map

package/dist/tests/prop-driver-equivalence.test.js.map

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

package/dist/tests/prop-lifecycle.test.d.ts

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

package/dist/tests/prop-lifecycle.test.d.ts.map

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

package/dist/tests/prop-lifecycle.test.js

@@ -1,83 +0,0 @@
-// Property-based test for the storage facade's lifecycle engine (task 15.2).
-//
-// Property 14: Lifecycle action applies exactly once. For an arbitrary set of
-// objects (each placed at a controllable age) and a `delete-after-days` rule
-// with an arbitrary day threshold, evaluating the rule via
-// `storage.applyLifecycle(rule)` at a fixed clock instant actions each
-// qualifying object EXACTLY ONCE:
-//
-//   - the first evaluation's outcomes are exactly the set of objects whose age
-//     meets the threshold (one `deleted` outcome per qualifying object), and
-//   - a second evaluation of the same rule at the same clock instant produces
-//     no further outcomes, because every actioned object has been removed from
-//     the space a subsequent scan enumerates.
-//
-// A controllable clock makes object ages deterministic: each object is written
-// at `now - ageDays` so its age at evaluation time is exactly `ageDays`. Backed
-// by the zero-dependency in-memory provider (no native `lifecycle` capability,
-// so the engine simulates evaluation over the driver primitives). Exercised
-// with fast-check at { numRuns: 100 }; executed via the Node.js built-in test
-// runner (`node --test dist/tests/*.test.js`).
-//
-// Feature: unified-storage-framework, Property 14
-// Validates: Requirements 13.2, 26.6
-import test from "node:test";
-import assert from "node:assert/strict";
-import fc from "fast-check";
-import { createStorage } from "../index.js";
-import { MemoryStorageDriver } from "../drivers/memory.js";
-const DAY = 24 * 60 * 60 * 1000;
-// A fixed evaluation instant, chosen large enough that every object's write
-// time (`NOW - ageDays * DAY`) stays positive for the age ranges used here.
-const NOW = 1_700_000_000_000;
-test("Feature: unified-storage-framework, Property 14 — lifecycle action applies exactly once", { concurrency: false }, async () => {
-    await fc.assert(fc.asyncProperty(
-    // An arbitrary set of objects with unique, application-visible keys
-    // (never a reserved bookkeeping prefix, which age-based rules skip),
-    // each with a deterministic age in days and arbitrary byte content.
-    fc.uniqueArray(fc.record({
-        key: fc
-            .string({ minLength: 1 })
-            .filter((k) => !k.startsWith(".") && k.trim().length > 0),
-        ageDays: fc.integer({ min: 0, max: 60 }),
-        content: fc.uint8Array(),
-    }), { selector: (o) => o.key, maxLength: 12 }), 
-    // An arbitrary day threshold for the delete-after-days rule.
-    fc.integer({ min: 1, max: 30 }), async (objects, thresholdDays) => {
-        // A controllable clock shared by the driver and the facade so both
-        // object creation time and lifecycle age are deterministic.
-        let clockValue = NOW;
-        const clock = () => clockValue;
-        const driver = new MemoryStorageDriver({ clock });
-        const storage = createStorage({ provider: "memory", driver, clock });
-        // Place each object so its age at NOW is exactly `ageDays`.
-        for (const { key, ageDays, content } of objects) {
-            clockValue = NOW - ageDays * DAY;
-            await storage.put(key, content);
-        }
-        // Evaluate the rule at the fixed instant NOW.
-        clockValue = NOW;
-        const rule = { type: "delete-after-days", days: thresholdDays };
-        // The qualifying set: objects at least `thresholdDays` old.
-        const expectedKeys = objects
-            .filter((o) => o.ageDays >= thresholdDays)
-            .map((o) => o.key)
-            .sort();
-        const first = await storage.applyLifecycle(rule);
-        // Every outcome is a delete, and the actioned keys are exactly the
-        // qualifying set — each qualifying object actioned exactly once.
-        assert.ok(first.every((o) => o.action === "deleted"));
-        assert.deepEqual(first.map((o) => o.key).sort(), expectedKeys);
-        // No duplicate outcomes within a single evaluation.
-        assert.equal(new Set(first.map((o) => o.key)).size, first.length);
-        // A second evaluation at the same instant produces no further
-        // outcomes: already-actioned objects are not re-actioned.
-        const second = await storage.applyLifecycle(rule);
-        assert.deepEqual(second, []);
-        // Qualifying objects are gone; non-qualifying objects remain.
-        for (const { key, ageDays } of objects) {
-            assert.equal(await storage.exists(key), ageDays < thresholdDays);
-        }
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-lifecycle.test.js.map

package/dist/tests/prop-lifecycle.test.js.map

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

package/dist/tests/prop-list.test.d.ts

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

package/dist/tests/prop-list.test.d.ts.map

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

package/dist/tests/prop-list.test.js

@@ -1,53 +0,0 @@
-// Property-based test for the storage facade `list(prefix)` operation.
-//
-// Feature: unified-storage-framework, Property 6 — List returns exactly the
-// prefix-matching keys. For an arbitrary set of stored objects and an arbitrary
-// prefix, `list(prefix)` returns exactly the set of stored keys that begin with
-// that prefix: no key that starts with the prefix is missing, and no key that
-// does not start with the prefix is included.
-//
-// Uses the public facade via `createStorage({ provider: 'memory' })`, the
-// Node.js built-in test runner (node:test), and fast-check configured with
-// { numRuns: 100 }. Executed via `node --test dist/tests/*.test.js`.
-//
-// Validates: Requirements 4.9
-import test from "node:test";
-import assert from "node:assert/strict";
-import fc from "fast-check";
-import { createStorage } from "../index.js";
-// A key generator that produces non-empty keys drawn from a small alphabet so
-// that shared prefixes arise frequently, exercising the prefix-matching logic
-// on both matching and non-matching keys.
-const keyArb = fc.stringMatching(/^[a-c/]{1,6}$/).filter((k) => k.length > 0);
-test("Feature: unified-storage-framework, Property 6 — list returns exactly the prefix-matching keys", async () => {
-    await fc.assert(fc.asyncProperty(
-    // A set of unique keys, each paired with arbitrary string content.
-    fc.uniqueArray(fc.tuple(keyArb, fc.string()), {
-        selector: ([key]) => key,
-        minLength: 0,
-        maxLength: 12,
-    }), 
-    // An arbitrary prefix, possibly empty, possibly unrelated to any key.
-    fc.stringMatching(/^[a-c/]{0,4}$/), async (entries, prefix) => {
-        const storage = createStorage({ provider: "memory" });
-        for (const [key, content] of entries) {
-            await storage.put(key, content, {});
-        }
-        const listed = await storage.list(prefix);
-        // Observed keys returned by list(prefix).
-        const observed = new Set(listed.map((item) => item.key));
-        // Expected keys: exactly the stored keys that start with the prefix.
-        const expected = new Set(entries
-            .map(([key]) => key)
-            .filter((key) => key.startsWith(prefix)));
-        // Same cardinality and same membership => exactly equal sets.
-        assert.equal(observed.size, expected.size);
-        for (const key of expected) {
-            assert.ok(observed.has(key), `expected listed key: ${key}`);
-        }
-        for (const key of observed) {
-            assert.ok(key.startsWith(prefix), `unexpected non-matching key listed: ${key}`);
-        }
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-list.test.js.map

package/dist/tests/prop-list.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"prop-list.test.js","sourceRoot":"","sources":["../../src/tests/prop-list.test.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,EAAE;AACF,4EAA4E;AAC5E,gFAAgF;AAChF,gFAAgF;AAChF,8EAA8E;AAC9E,8CAA8C;AAC9C,EAAE;AACF,0EAA0E;AAC1E,2EAA2E;AAC3E,qEAAqE;AACrE,EAAE;AACF,8BAA8B;AAE9B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,8EAA8E;AAC9E,8EAA8E;AAC9E,0CAA0C;AAC1C,MAAM,MAAM,GAAG,EAAE,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAE9E,IAAI,CACF,gGAAgG,EAChG,KAAK,IAAI,EAAE;IACT,MAAM,EAAE,CAAC,MAAM,CACb,EAAE,CAAC,aAAa;IACd,mEAAmE;IACnE,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE;QAC5C,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG;QACxB,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,EAAE;KACd,CAAC;IACF,sEAAsE;IACtE,EAAE,CAAC,cAAc,CAAC,eAAe,CAAC,EAClC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;QACxB,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEtD,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,OAAO,EAAE,CAAC;YACrC,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE1C,0CAA0C;QAC1C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAEzD,qEAAqE;QACrE,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,OAAO;aACJ,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC;aACnB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAC3C,CAAC;QAEF,8DAA8D;QAC9D,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,wBAAwB,GAAG,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,CAAC,EAAE,CACP,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EACtB,uCAAuC,GAAG,EAAE,CAC7C,CAAC;QACJ,CAAC;IACH,CAAC,CACF,EACD,EAAE,OAAO,EAAE,GAAG,EAAE,CACjB,CAAC;AACJ,CAAC,CACF,CAAC"}

package/dist/tests/prop-metadata.test.d.ts

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

package/dist/tests/prop-metadata.test.d.ts.map

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

package/dist/tests/prop-metadata.test.js

@@ -1,87 +0,0 @@
-// Property-based test for the storage facade metadata round-trip guarantee.
-//
-// Feature: unified-storage-framework, Property 5: Metadata round-trips through
-// write and read.
-//
-// For arbitrary keys, byte contents, and write-time metadata (contentType,
-// owner, tenant, accessLevel, and custom fields), after `put(key, bytes,
-// options)` followed by `stat(key)` (and `get(key)`):
-//   - the write-supplied fields on the returned metadata equal what was written
-//     (owner/tenant/custom exactly; contentType/accessLevel fall back to the
-//     canonical defaults when the write omits them), and
-//   - the computed fields (size, checksum, etag, createdAt, updatedAt) are all
-//     present and consistent with the persisted content.
-//
-// Uses the Node.js built-in test runner (node:test) and fast-check at
-// `{ numRuns: 100 }`, exercising the public facade via
-// `createStorage({ provider: 'memory' })` with a fixed clock so timestamps are
-// deterministic. Executed via `node --test dist/tests/*.test.js`.
-//
-// Validates: Requirements 10.2, 26.4
-import test from "node:test";
-import assert from "node:assert/strict";
-import fc from "fast-check";
-import { createStorage } from "../facade.js";
-import { DEFAULT_ACCESS_LEVEL, DEFAULT_CONTENT_TYPE } from "../metadata.js";
-/** A fixed clock so object timestamps are deterministic across runs. */
-const fixedClock = () => 1_700_000_000_000;
-/** The valid AccessLevel values (Requirement 11.1). */
-const ACCESS_LEVELS = [
-    "public",
-    "private",
-    "signed",
-    "authenticated",
-    "role-based",
-    "tenant-aware",
-];
-/** Arbitrary object content (including empty), persisted as a Uint8Array. */
-const contentArb = fc.uint8Array({ minLength: 0, maxLength: 256 });
-/** Non-empty object keys. */
-const keyArb = fc.string({ minLength: 1, maxLength: 40 });
-/**
- * Arbitrary custom metadata map with comparable JSON-ish values so it can be
- * asserted to round-trip exactly via deepEqual.
- */
-const customArb = fc.dictionary(fc.string({ maxLength: 20 }), fc.oneof(fc.string(), fc.integer(), fc.boolean()), { maxKeys: 5 });
-/**
- * Arbitrary write-time metadata. Each field is optional (may be absent) so the
- * property covers both explicitly-supplied values and the default fallbacks.
- */
-const writeMetadataArb = fc.record({
-    contentType: fc.string({ minLength: 1, maxLength: 40 }),
-    owner: fc.string({ minLength: 1, maxLength: 40 }),
-    tenant: fc.string({ minLength: 1, maxLength: 40 }),
-    accessLevel: fc.constantFrom(...ACCESS_LEVELS),
-    custom: customArb,
-}, { requiredKeys: [] });
-test("Feature: unified-storage-framework, Property 5: Metadata round-trips through write and read", async () => {
-    await fc.assert(fc.asyncProperty(keyArb, contentArb, writeMetadataArb, async (key, content, write) => {
-        // A fresh store per case keeps each key/content pair independent.
-        const storage = createStorage({ provider: "memory", clock: fixedClock });
-        const putMeta = await storage.put(key, content, write);
-        const statMeta = await storage.stat(key);
-        const getResult = await storage.get(key);
-        assert.notEqual(statMeta, null, "stat must return metadata for a written key");
-        assert.equal(getResult.found, true, "get must find a written key");
-        // The write-supplied fields must equal what was written on every surface
-        // that returns metadata (put, stat, get).
-        for (const meta of [putMeta, statMeta, getResult.metadata]) {
-            assert.ok(meta, "metadata must be present on every surface");
-            assert.equal(meta.owner, write.owner, "owner must round-trip");
-            assert.equal(meta.tenant, write.tenant, "tenant must round-trip");
-            assert.equal(meta.contentType, write.contentType ?? DEFAULT_CONTENT_TYPE, "contentType must round-trip (or fall back to the default)");
-            assert.equal(meta.accessLevel, write.accessLevel ?? DEFAULT_ACCESS_LEVEL, "accessLevel must round-trip (or fall back to the default)");
-            assert.deepEqual(meta.custom, write.custom ?? {}, "custom fields must round-trip (or default to {})");
-            // The computed fields must be present and consistent with the content.
-            assert.equal(meta.size, content.byteLength, "size must equal the content byte length");
-            assert.equal(typeof meta.checksum, "string", "checksum must be present");
-            assert.ok(meta.checksum.length > 0, "checksum must be non-empty");
-            assert.equal(typeof meta.etag, "string", "etag must be present");
-            assert.ok(meta.etag.length > 0, "etag must be non-empty");
-            assert.equal(typeof meta.createdAt, "number", "createdAt must be present");
-            assert.equal(typeof meta.updatedAt, "number", "updatedAt must be present");
-        }
-        await storage.close();
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-metadata.test.js.map

package/dist/tests/prop-metadata.test.js.map

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

package/dist/tests/prop-move.test.d.ts

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

package/dist/tests/prop-move.test.d.ts.map

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

package/dist/tests/prop-move.test.js

@@ -1,67 +0,0 @@
-// Property test: move relocates content and removes the source.
-//
-// Feature: unified-storage-framework, Property 3: Move relocates content and
-// removes the source.
-// Validates: Requirements 4.7, 4.8, 26.3
-//
-// Req 4.7: `move(source, destination)` relocates the object — the content
-//   becomes available at `destination` and the source object is removed.
-// Req 4.8: after a successful relocation the source key no longer exists.
-// Req 26.3: the observable move semantics hold across arbitrary keys/content.
-//
-// Strategy: through the real facade built with the zero-dependency memory
-// provider (`createStorage({ provider: "memory" })`), for arbitrary DISTINCT
-// source/destination keys and arbitrary content bytes:
-//   1. `put(source, bytes)` stores the content,
-//   2. `move(source, dest)` relocates it, and we assert the four observable
-//      consequences of a successful move:
-//        (a) the move result is `{ moved: true }`,
-//        (b) `get(dest)` returns bytes byte-for-byte equal to the original,
-//        (c) `exists(source)` is now false, and
-//        (d) `get(source)` reports `{ found: false }`.
-// A control case guards the not-found path: moving a source that was never
-// stored returns `{ moved: false }` without throwing.
-//
-// Uses the Node.js built-in test runner (node:test) and fast-check at the
-// spec-mandated `{ numRuns: 100 }`.
-import test from "node:test";
-import assert from "node:assert/strict";
-import fc from "fast-check";
-import { createStorage } from "../index.js";
-/**
- * Generate two distinct, non-empty object keys. fast-check's `uniqueArray`
- * guarantees the pair differs, so `source` and `destination` never collide
- * (a collision would make "removes the source" ambiguous).
- */
-const distinctKeys = fc
-    .uniqueArray(fc.string({ minLength: 1, maxLength: 40 }).filter((s) => s.trim().length > 0), { minLength: 2, maxLength: 2 })
-    .map(([source, destination]) => ({ source, destination }));
-test("Feature: unified-storage-framework, Property 3: move relocates content and removes the source", async () => {
-    await fc.assert(fc.asyncProperty(distinctKeys, fc.uint8Array({ minLength: 0, maxLength: 512 }), async ({ source, destination }, content) => {
-        const storage = createStorage({ provider: "memory" });
-        await storage.put(source, content);
-        const result = await storage.move(source, destination);
-        // (a) the move reports success.
-        assert.equal(result.moved, true);
-        // (b) the destination now holds the original bytes, unchanged.
-        const atDest = await storage.get(destination);
-        assert.equal(atDest.found, true);
-        assert.deepEqual(atDest.bytes, content);
-        // (c) the source no longer exists.
-        assert.equal(await storage.exists(source), false);
-        // (d) reading the source reports not-found (never throws).
-        const atSource = await storage.get(source);
-        assert.equal(atSource.found, false);
-    }), { numRuns: 100 });
-});
-test("Feature: unified-storage-framework, Property 3: moving a missing source returns { moved: false }", async () => {
-    await fc.assert(fc.asyncProperty(distinctKeys, async ({ source, destination }) => {
-        const storage = createStorage({ provider: "memory" });
-        // Nothing was ever stored under `source`.
-        const result = await storage.move(source, destination);
-        assert.equal(result.moved, false);
-        // No object is fabricated at the destination.
-        assert.equal(await storage.exists(destination), false);
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-move.test.js.map

package/dist/tests/prop-move.test.js.map

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

package/dist/tests/prop-multipart-abort.test.d.ts

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

package/dist/tests/prop-multipart-abort.test.d.ts.map

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

package/dist/tests/prop-multipart-abort.test.js

@@ -1,48 +0,0 @@
-// Property-based test for the storage facade's multipart abort guarantee.
-//
-// Property 9 (Abort leaves no object): for an arbitrary key and an arbitrary
-// list of parts uploaded via `createMultipartUpload` → `uploadPart` for each
-// part, calling `abortMultipartUpload(uploadId)` discards every uploaded part
-// and creates no completed object. After the abort the target key must not
-// exist (`exists(key) === false`) and reading it must report not-found, so no
-// leftover final object is ever produced by the aborted upload (Requirement
-// 6.4). The abort path runs over the zero-dependency `memory` provider — the
-// identical code path every provider shares — exercised via the public facade.
-//
-// Uses the Node.js built-in test runner (node:test) with fast-check for input
-// generation, executed via `node --test dist/tests/*.test.js`. fast-check is
-// configured with { numRuns: 100 } per the design's property-testing contract.
-//
-// Feature: unified-storage-framework, Property 9: Abort leaves no object
-//
-// Validates: Requirements 6.4
-import test from "node:test";
-import assert from "node:assert/strict";
-import fc from "fast-check";
-import { createStorage } from "../index.js";
-test("Feature: unified-storage-framework, Property 9: Abort leaves no object", async () => {
-    await fc.assert(fc.asyncProperty(
-    // An arbitrary target key for the multipart upload and an arbitrary
-    // ordered list of parts. At least one part is generated so there is
-    // always something to upload before aborting; individual parts may be
-    // empty, exercising abort after zero-length segments.
-    fc.string(), fc.array(fc.uint8Array(), { minLength: 1, maxLength: 8 }), async (key, parts) => {
-        // A fresh store per run keeps each key/parts pair independent.
-        const storage = createStorage({ provider: "memory" });
-        // ── Upload parts, then abort ──────────────────────────────────────
-        const uploadId = await storage.createMultipartUpload(key);
-        for (let index = 0; index < parts.length; index += 1) {
-            // Part numbers are 1-based positive integers assigned in order.
-            await storage.uploadPart(uploadId, index + 1, parts[index]);
-        }
-        await storage.abortMultipartUpload(uploadId);
-        // The aborted upload must create no completed object at the key: the
-        // key must not exist and reading it must report not-found (no
-        // leftover final object).
-        assert.equal(await storage.exists(key), false, "aborted multipart upload must leave no object at the target key");
-        const result = await storage.get(key);
-        assert.equal(result.found, false, "reading the target key after abort must report not-found");
-        await storage.close();
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-multipart-abort.test.js.map

package/dist/tests/prop-multipart-abort.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"prop-multipart-abort.test.js","sourceRoot":"","sources":["../../src/tests/prop-multipart-abort.test.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,+EAA+E;AAC/E,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,+EAA+E;AAC/E,EAAE;AACF,yEAAyE;AACzE,EAAE;AACF,8BAA8B;AAE9B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,IAAI,CACF,wEAAwE,EACxE,KAAK,IAAI,EAAE;IACT,MAAM,EAAE,CAAC,MAAM,CACb,EAAE,CAAC,aAAa;IACd,oEAAoE;IACpE,oEAAoE;IACpE,sEAAsE;IACtE,sDAAsD;IACtD,EAAE,CAAC,MAAM,EAAE,EACX,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EACzD,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACnB,+DAA+D;QAC/D,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEtD,qEAAqE;QACrE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAC1D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACrD,gEAAgE;YAChE,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAE7C,qEAAqE;QACrE,8DAA8D;QAC9D,0BAA0B;QAC1B,MAAM,CAAC,KAAK,CACV,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EACzB,KAAK,EACL,iEAAiE,CAClE,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CACV,MAAM,CAAC,KAAK,EACZ,KAAK,EACL,0DAA0D,CAC3D,CAAC;QAEF,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC,CACF,EACD,EAAE,OAAO,EAAE,GAAG,EAAE,CACjB,CAAC;AACJ,CAAC,CACF,CAAC"}

package/dist/tests/prop-multipart.test.d.ts

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

package/dist/tests/prop-multipart.test.d.ts.map

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