@streetjs/storage 1.0.0 → 1.0.1

package/dist/tests/observability.test.js

@@ -1,240 +0,0 @@
-// Unit + integration tests for the storage observability wiring (task 22.1).
-//
-// Verifies the Requirement 23 semantics over the zero-dependency `memory`
-// provider and the real core MetricsRegistry / HealthCheckRegistry:
-//
-//  - the facade tracks live stats (uploads/downloads/bytes/active/failed/usage/
-//    multipart/resumable) surfaced by `storage.stats()` (23.2);
-//  - `storage.probe()` delegates to the driver's probe or returns a sensible
-//    default when the driver has no probe (23.3);
-//  - registerStorageObservability registers metrics idempotently against the
-//    existing MetricsRegistry (23.1, 23.2, 23.4) and a health check against the
-//    existing HealthCheckRegistry sourced from probe() (23.3);
-//  - configuring config.metrics/config.health wires observability on the facade
-//    and drives the counters/gauges as operations occur.
-//
-// Uses the Node.js built-in test runner (node:test); executed via
-// `node --test dist/tests/*.test.js`.
-//
-// Requirements: 23.1, 23.2, 23.3, 23.4
-import test from "node:test";
-import assert from "node:assert/strict";
-import { HealthCheckRegistry, MetricsRegistry, Counter, Gauge, Histogram } from "streetjs";
-import { createStorage, registerStorageObservability, STORAGE_HEALTH_CHECK_NAME, STORAGE_UPLOADS_METRIC, STORAGE_DOWNLOADS_METRIC, STORAGE_BYTES_UPLOADED_METRIC, STORAGE_BYTES_DOWNLOADED_METRIC, STORAGE_ACTIVE_UPLOADS_METRIC, STORAGE_FAILED_UPLOADS_METRIC, STORAGE_USAGE_METRIC, STORAGE_LATENCY_METRIC, STORAGE_MULTIPART_METRIC, STORAGE_RESUMABLE_METRIC, } from "../index.js";
-test("stats() starts zeroed and is available without any registry (Req 23.2)", async () => {
-    const storage = createStorage({ provider: "memory" });
-    assert.deepEqual(storage.stats(), {
-        uploads: 0,
-        downloads: 0,
-        bytesUploaded: 0,
-        bytesDownloaded: 0,
-        activeUploads: 0,
-        failedUploads: 0,
-        storageUsage: 0,
-        multipartUploads: 0,
-        resumableSessions: 0,
-    });
-});
-test("put/get advance uploads/downloads and byte counters (Req 23.2)", async () => {
-    const storage = createStorage({ provider: "memory" });
-    await storage.put("a.txt", "hello"); // 5 bytes
-    await storage.put("b.txt", "worldd"); // 6 bytes
-    const got = await storage.get("a.txt");
-    assert.equal(got.found, true);
-    const stats = storage.stats();
-    assert.equal(stats.uploads, 2);
-    assert.equal(stats.bytesUploaded, 11);
-    assert.equal(stats.storageUsage, 11);
-    assert.equal(stats.downloads, 1);
-    assert.equal(stats.bytesDownloaded, 5);
-    assert.equal(stats.failedUploads, 0);
-});
-test("a failed upload (rejected by validation) increments failedUploads (Req 23.2)", async () => {
-    const storage = createStorage({
-        provider: "memory",
-        validation: { maxSize: 3 },
-    });
-    await assert.rejects(() => storage.put("big.txt", "too-large"));
-    const stats = storage.stats();
-    assert.equal(stats.failedUploads, 1);
-    assert.equal(stats.uploads, 0);
-});
-test("multipart and resumable operations advance their counters (Req 23.2)", async () => {
-    const storage = createStorage({ provider: "memory" });
-    await storage.createMultipartUpload("m1");
-    await storage.createMultipartUpload("m2");
-    await storage.startUpload("r1");
-    const stats = storage.stats();
-    assert.equal(stats.multipartUploads, 2);
-    assert.equal(stats.resumableSessions, 1);
-});
-test("activeUploads returns to zero after a stream upload completes (Req 23.2)", async () => {
-    const storage = createStorage({ provider: "memory" });
-    const { Readable } = await import("node:stream");
-    await storage.putStream("s.txt", Readable.from([Buffer.from("streamed")]));
-    const stats = storage.stats();
-    assert.equal(stats.activeUploads, 0);
-    assert.equal(stats.uploads, 1);
-    assert.equal(stats.bytesUploaded, 8);
-});
-test("probe() returns an all-available default when the driver has no probe (Req 23.3)", async () => {
-    const storage = createStorage({ provider: "memory" });
-    const probe = await storage.probe();
-    assert.deepEqual(probe, {
-        connectivity: true,
-        writable: true,
-        readable: true,
-        quotaAvailable: true,
-    });
-});
-test("probe() delegates to the driver's probe when present (Req 23.3)", async () => {
-    const driverProbe = {
-        connectivity: true,
-        writable: false,
-        readable: true,
-        quotaAvailable: true,
-    };
-    // A minimal driver implementing the mandatory primitives + probe.
-    const driver = {
-        name: "fake",
-        async put() {
-            return {
-                key: "k",
-                size: 0,
-                contentType: "application/octet-stream",
-                etag: "e",
-                checksum: "c",
-                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() {
-            throw new Error("unused");
-        },
-        async getStream() {
-            throw new Error("unused");
-        },
-        async probe() {
-            return driverProbe;
-        },
-    };
-    const storage = createStorage({ provider: "fake", driver });
-    assert.deepEqual(await storage.probe(), driverProbe);
-});
-test("config.metrics registers all storage metrics of the correct kind and reflects live counts (Req 23.1, 23.2)", async () => {
-    const metrics = new MetricsRegistry();
-    const storage = createStorage({ provider: "memory", metrics });
-    // All metrics registered with the correct kind.
-    assert.ok(metrics.get(STORAGE_UPLOADS_METRIC) instanceof Counter);
-    assert.ok(metrics.get(STORAGE_DOWNLOADS_METRIC) instanceof Counter);
-    assert.ok(metrics.get(STORAGE_BYTES_UPLOADED_METRIC) instanceof Counter);
-    assert.ok(metrics.get(STORAGE_BYTES_DOWNLOADED_METRIC) instanceof Counter);
-    assert.ok(metrics.get(STORAGE_FAILED_UPLOADS_METRIC) instanceof Counter);
-    assert.ok(metrics.get(STORAGE_MULTIPART_METRIC) instanceof Counter);
-    assert.ok(metrics.get(STORAGE_RESUMABLE_METRIC) instanceof Counter);
-    assert.ok(metrics.get(STORAGE_ACTIVE_UPLOADS_METRIC) instanceof Gauge);
-    assert.ok(metrics.get(STORAGE_USAGE_METRIC) instanceof Gauge);
-    assert.ok(metrics.get(STORAGE_LATENCY_METRIC) instanceof Histogram);
-    await storage.put("a.txt", "hello"); // 5 bytes
-    await storage.get("a.txt");
-    assert.match(metrics.get(STORAGE_UPLOADS_METRIC).render(), /storage_uploads_total 1/);
-    assert.match(metrics.get(STORAGE_DOWNLOADS_METRIC).render(), /storage_downloads_total 1/);
-    assert.match(metrics.get(STORAGE_BYTES_UPLOADED_METRIC).render(), /storage_bytes_uploaded_total 5/);
-    assert.match(metrics.get(STORAGE_BYTES_DOWNLOADED_METRIC).render(), /storage_bytes_downloaded_total 5/);
-    assert.match(metrics.get(STORAGE_USAGE_METRIC).render(), /storage_usage_bytes 5/);
-    assert.match(metrics.get(STORAGE_LATENCY_METRIC).render(), /storage_operation_latency_seconds_count 2/);
-    await storage.close();
-});
-test("config.health registers the storage health check reporting up over the memory driver (Req 23.3)", async () => {
-    const health = new HealthCheckRegistry();
-    const storage = createStorage({ provider: "memory", health });
-    const live = await health.runLiveness();
-    assert.ok(STORAGE_HEALTH_CHECK_NAME in live.checks);
-    const check = live.checks[STORAGE_HEALTH_CHECK_NAME];
-    assert.equal(check.status, "up");
-    assert.equal(check.details.connectivity, true);
-    assert.equal(check.details.writable, true);
-    assert.equal(check.details.readable, true);
-    assert.equal(check.details.quotaAvailable, true);
-    await storage.close();
-});
-test("the health check reports down when the driver probe reports a failing dimension (Req 23.3)", async () => {
-    const health = new HealthCheckRegistry();
-    const driver = {
-        name: "fake",
-        async put() {
-            throw new Error("unused");
-        },
-        async get() {
-            return { found: false };
-        },
-        async exists() {
-            return false;
-        },
-        async delete() { },
-        async stat() {
-            return null;
-        },
-        async list() {
-            return [];
-        },
-        async putStream() {
-            throw new Error("unused");
-        },
-        async getStream() {
-            throw new Error("unused");
-        },
-        async probe() {
-            return { connectivity: true, writable: false, readable: true, quotaAvailable: true };
-        },
-    };
-    const storage = createStorage({ provider: "fake", driver, health });
-    const live = await health.runLiveness();
-    assert.equal(live.checks[STORAGE_HEALTH_CHECK_NAME].status, "down");
-    assert.equal(live.checks[STORAGE_HEALTH_CHECK_NAME].details.writable, false);
-    await storage.close();
-});
-test("registration is idempotent against a shared registry (Req 23.1)", async () => {
-    const metrics = new MetricsRegistry();
-    const first = registerStorageObservability({ metrics });
-    // A second registration against the same registry must not throw.
-    let second;
-    assert.doesNotThrow(() => {
-        second = registerStorageObservability({ metrics });
-    });
-    const storage = createStorage({ provider: "memory", metrics });
-    first.attach(storage);
-    second.attach(storage);
-    await storage.put("k", "v");
-    assert.doesNotThrow(() => {
-        first.refresh();
-        second.refresh();
-        metrics.collect();
-    });
-    first.close();
-    second.close();
-    await storage.close();
-});
-test("with no registries, operations proceed and telemetry is a complete no-op (Req 23.4)", async () => {
-    const storage = createStorage({ provider: "memory" });
-    const metadata = await storage.put("k", "v");
-    assert.equal(metadata.key, "k");
-    assert.equal(storage.stats().uploads, 1);
-    await storage.close();
-});
-//# sourceMappingURL=observability.test.js.map

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

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

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

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

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

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

package/dist/tests/plugin.test.js

@@ -1,112 +0,0 @@
-// src/tests/plugin.test.js
-// Unit tests for StoragePlugin load/unload (task 23.2).
-//
-// These cover the two behaviors the task mandates:
-//
-//   1. After `onLoad`, the plugin exposes the live Storage facade through its
-//      `storage` accessor and that facade is usable (put/get round-trips)
-//      (Requirements 20.1, 20.3).
-//   2. After `onUnload`, resources are released: the `storage` accessor becomes
-//      `undefined`, the facade's `close()` is called (which stops the
-//      observability refresh timer), and any declarative `wireBridges` detach
-//      functions are invoked (Requirement 20.3).
-//
-// A minimal SandboxedApp-like stub is passed to the hooks — the plugin ignores
-// the app beyond the hook signatures, resolving its metrics/health registries
-// from the plugin options instead. Uses the Node.js built-in test runner
-// (node:test); executed via `node --test dist/tests/*.test.js`.
-//
-// Requirements: 20.1, 20.3
-import test from "node:test";
-import assert from "node:assert/strict";
-import { HealthCheckRegistry, MetricsRegistry } from "streetjs";
-import { StoragePlugin, STORAGE_HEALTH_CHECK_NAME, STORAGE_UPLOADS_METRIC, } from "../index.js";
-/** A minimal SandboxedApp-like stub: exposes only `use` / `on`. */
-function fakeApp() {
-    return { use() { }, on() { } };
-}
-test("onLoad exposes a usable Storage facade via the `storage` accessor (Req 20.1, 20.3)", async () => {
-    const plugin = new StoragePlugin({ provider: "memory" });
-    // No facade before load.
-    assert.equal(plugin.storage, undefined, "no facade before load");
-    await plugin.onLoad(fakeApp());
-    // The accessor now exposes the live facade.
-    assert.ok(plugin.storage, "facade exposed after load");
-    const storage = plugin.storage;
-    // The exposed facade is actually usable — a put/get round-trips.
-    const written = await storage.put("greeting.txt", "hello world");
-    assert.equal(written.key, "greeting.txt");
-    const read = await storage.get("greeting.txt");
-    assert.equal(read.found, true);
-    assert.equal(Buffer.from(read.bytes).toString("utf8"), "hello world");
-    await plugin.onUnload(fakeApp());
-});
-test("onUnload releases resources: accessor cleared, close() called, detachers invoked (Req 20.3)", async () => {
-    let attached = 0;
-    let detached = 0;
-    let bridgedStorage;
-    const plugin = new StoragePlugin({
-        provider: "memory",
-        wireBridges: [
-            (storage) => {
-                attached += 1;
-                bridgedStorage = storage;
-                // Returning a detach function that MUST be called on unload.
-                return () => {
-                    detached += 1;
-                };
-            },
-            () => {
-                attached += 1;
-                // A bridge that returns nothing is allowed (no detach registered).
-            },
-        ],
-    });
-    await plugin.onLoad(fakeApp());
-    assert.equal(attached, 2, "both wireBridges attach fns ran on load");
-    assert.equal(bridgedStorage, plugin.storage, "the attach fn received the live facade");
-    assert.equal(detached, 0, "detach not called before unload");
-    // Spy on the facade's close() so we can assert it is called on unload.
-    const facade = plugin.storage;
-    assert.ok(facade, "facade exposed after load");
-    let closeCalls = 0;
-    const originalClose = facade.close.bind(facade);
-    facade.close = async () => {
-        closeCalls += 1;
-        return originalClose();
-    };
-    await plugin.onUnload(fakeApp());
-    // The accessor is cleared, close() ran exactly once, and the returned detach
-    // function was invoked.
-    assert.equal(plugin.storage, undefined, "facade accessor cleared after unload");
-    assert.equal(closeCalls, 1, "facade close() called on unload");
-    assert.equal(detached, 1, "the returned detach function was called on unload");
-});
-test("observability from plugin-option registries loads and unloads cleanly (Req 20.3)", async () => {
-    const metrics = new MetricsRegistry();
-    const health = new HealthCheckRegistry();
-    const plugin = new StoragePlugin({ provider: "memory", metrics, health });
-    await plugin.onLoad(fakeApp());
-    // Observability wired from the plugin-option registries on load: the storage
-    // health check is registered and the storage metrics are present.
-    const live = await health.runLiveness();
-    assert.ok(STORAGE_HEALTH_CHECK_NAME in live.checks, "storage health check registered on load");
-    assert.equal(metrics.has(STORAGE_UPLOADS_METRIC), true, "storage metrics registered on load");
-    // Unload releases cleanly (stops the observability refresh timer) without throwing.
-    await assert.doesNotReject(() => plugin.onUnload(fakeApp()));
-    assert.equal(plugin.storage, undefined, "facade cleared after unload");
-});
-test("onLoad is idempotent — a second load reuses the same facade", async () => {
-    const plugin = new StoragePlugin({ provider: "memory" });
-    await plugin.onLoad(fakeApp());
-    const first = plugin.storage;
-    await plugin.onLoad(fakeApp());
-    assert.equal(plugin.storage, first, "facade identity unchanged on a second onLoad");
-    await plugin.onUnload(fakeApp());
-});
-test("onUnload is a no-op when never loaded", async () => {
-    const plugin = new StoragePlugin({ provider: "memory" });
-    await assert.doesNotReject(() => plugin.onUnload(fakeApp()));
-    assert.equal(plugin.storage, undefined);
-});
-//# sourceMappingURL=plugin.test.js.map

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

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

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

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

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

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

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

@@ -1,59 +0,0 @@
-// Property-based test for concurrent write isolation on the storage facade.
-//
-// Feature: unified-storage-framework, Property 17: Concurrent uploads never
-// corrupt data.
-//
-// For an arbitrary set of DISTINCT keys, each paired with its own byte content,
-// performing all `put` operations CONCURRENTLY (`Promise.all`) against a single
-// storage instance results in every key holding exactly its own content. No
-// key observes another key's bytes (no cross-contamination), and no bytes are
-// corrupted: reading each key back yields bytes exactly equal to the content
-// that was intended for that key.
-//
-// Uses the Node.js built-in test runner (node:test) and fast-check at
-// `{ numRuns: 100 }`, exercising the public facade via
-// `createStorage({ provider: 'memory' })` imported from the built package
-// entry point (`../index.js`), executed via `node --test dist/tests/*.test.js`.
-//
-// Validates: Requirements 26.6
-import test from "node:test";
-import assert from "node:assert/strict";
-import fc from "fast-check";
-import { createStorage } from "../index.js";
-/** A fixed clock so object timestamps are deterministic across runs. */
-const fixedClock = () => 1_700_000_000_000;
-/**
- * An arbitrary set of distinct keys each mapped to its own byte content.
- *
- * `fc.uniqueArray` on non-empty keys guarantees the keys are DISTINCT, so each
- * concurrent `put` targets a different object and the property genuinely tests
- * cross-key isolation rather than last-writer-wins on a shared key. `minLength:
- * 2` ensures there is always genuine concurrency to exercise.
- */
-const distinctEntriesArb = fc
-    .uniqueArray(fc.string({ minLength: 1, maxLength: 40 }), {
-    minLength: 2,
-    maxLength: 25,
-})
-    .chain((keys) => fc.tuple(fc.constant(keys), fc.array(fc.uint8Array({ minLength: 0, maxLength: 256 }), {
-    minLength: keys.length,
-    maxLength: keys.length,
-})))
-    .map(([keys, contents]) => keys.map((key, index) => [key, contents[index]]));
-test("Feature: unified-storage-framework, Property 17: Concurrent uploads never corrupt data", async () => {
-    await fc.assert(fc.asyncProperty(distinctEntriesArb, async (entries) => {
-        // A single shared storage instance receives every concurrent write.
-        const storage = createStorage({ provider: "memory", clock: fixedClock });
-        // Fire all puts CONCURRENTLY against the one instance.
-        await Promise.all(entries.map(([key, content]) => storage.put(key, content)));
-        // Every key must hold exactly its own content — read them all back
-        // concurrently and assert byte-for-byte equality with the intended value.
-        await Promise.all(entries.map(async ([key, content]) => {
-            const result = await storage.get(key);
-            assert.equal(result.found, true, `key ${JSON.stringify(key)} must be present after concurrent writes`);
-            assert.deepEqual(result.bytes, content, `key ${JSON.stringify(key)} must hold exactly its own content (no cross-contamination)`);
-        }));
-        await storage.close();
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-concurrent.test.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"prop-concurrent.test.js","sourceRoot":"","sources":["../../src/tests/prop-concurrent.test.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,EAAE;AACF,4EAA4E;AAC5E,gBAAgB;AAChB,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,kCAAkC;AAClC,EAAE;AACF,sEAAsE;AACtE,uDAAuD;AACvD,0EAA0E;AAC1E,gFAAgF;AAChF,EAAE;AACF,+BAA+B;AAE/B,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,wEAAwE;AACxE,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,iBAAiB,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,kBAAkB,GAAG,EAAE;KAC1B,WAAW,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,EAAE;IACvD,SAAS,EAAE,CAAC;IACZ,SAAS,EAAE,EAAE;CACd,CAAC;KACD,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CACd,EAAE,CAAC,KAAK,CACN,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EACjB,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,EAAE;IACxD,SAAS,EAAE,IAAI,CAAC,MAAM;IACtB,SAAS,EAAE,IAAI,CAAC,MAAM;CACvB,CAAC,CACH,CACF;KACA,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CACxB,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAwB,EAAE,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CACvE,CAAC;AAEJ,IAAI,CAAC,wFAAwF,EAAE,KAAK,IAAI,EAAE;IACxG,MAAM,EAAE,CAAC,MAAM,CACb,EAAE,CAAC,aAAa,CAAC,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACrD,oEAAoE;QACpE,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QAEzE,uDAAuD;QACvD,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QAE9E,mEAAmE;QACnE,0EAA0E;QAC1E,MAAM,OAAO,CAAC,GAAG,CACf,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE;YACnC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;YACvG,MAAM,CAAC,SAAS,CACd,MAAM,CAAC,KAAK,EACZ,OAAO,EACP,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,6DAA6D,CACxF,CAAC;QACJ,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC,CAAC,EACF,EAAE,OAAO,EAAE,GAAG,EAAE,CACjB,CAAC;AACJ,CAAC,CAAC,CAAC"}

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

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

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

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

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

@@ -1,63 +0,0 @@
-// Property-based test for the storage facade `copy` operation.
-//
-// Feature: unified-storage-framework, Property 2: Copy is non-mutating and
-// duplicates content.
-//
-// For arbitrary, distinct source/destination keys and arbitrary content, after
-// `put(source, bytes)` followed by `copy(source, dest)`:
-//   - the source still returns the original bytes (unchanged),
-//   - the destination returns bytes equal to the source content, and
-//   - the copy result is `{ copied: true }`.
-// Additionally, copying a source key that was never written returns
-// `{ copied: false }` and creates nothing at the destination.
-//
-// Uses the Node.js built-in test runner (node:test) and fast-check at
-// `{ numRuns: 100 }`, exercising the public facade via
-// `createStorage({ provider: 'memory' })` imported from the built package
-// entry point (`../index.js`), executed via `node --test dist/tests/*.test.js`.
-//
-// Validates: Requirements 4.5, 26.3
-import test from "node:test";
-import assert from "node:assert/strict";
-import fc from "fast-check";
-import { createStorage } from "../index.js";
-/** A fixed clock so object timestamps are deterministic across runs. */
-const fixedClock = () => 1_700_000_000_000;
-/**
- * Arbitrary object content: arbitrary byte arrays (including empty) mapped to a
- * Uint8Array, which is what the facade/driver persists.
- */
-const contentArb = fc.uint8Array({ minLength: 0, maxLength: 256 });
-/**
- * Two distinct, non-empty object keys. Keys are constrained to non-empty
- * strings and the pair is filtered so the source and destination never collide
- * (a copy onto itself is a different scenario than "duplicate to a new key").
- */
-const distinctKeysArb = fc
-    .tuple(fc.string({ minLength: 1, maxLength: 40 }), fc.string({ minLength: 1, maxLength: 40 }))
-    .filter(([source, dest]) => source !== dest);
-test("Feature: unified-storage-framework, Property 2: Copy is non-mutating and duplicates content", async () => {
-    await fc.assert(fc.asyncProperty(distinctKeysArb, contentArb, async ([source, dest], content) => {
-        // A fresh storage instance per case keeps runs independent.
-        const storage = createStorage({ provider: "memory", clock: fixedClock });
-        // ── Copy of a missing source: no-op that creates nothing ────────────────
-        const missing = await storage.copy(source, dest);
-        assert.equal(missing.copied, false, "copy of a missing source must report copied:false");
-        assert.equal(await storage.exists(source), false, "missing source must not be created by copy");
-        assert.equal(await storage.exists(dest), false, "destination must not be created when source is missing");
-        // ── Copy after a real write: duplicates content, source unchanged ───────
-        await storage.put(source, content);
-        const result = await storage.copy(source, dest);
-        assert.equal(result.copied, true, "copy of an existing source must report copied:true");
-        // Source still returns the original bytes (non-mutating).
-        const afterSource = await storage.get(source);
-        assert.equal(afterSource.found, true, "source must still exist after copy");
-        assert.deepEqual(afterSource.bytes, content, "source bytes must be unchanged after copy");
-        // Destination returns bytes equal to the source content (duplicated).
-        const afterDest = await storage.get(dest);
-        assert.equal(afterDest.found, true, "destination must exist after copy");
-        assert.deepEqual(afterDest.bytes, content, "destination bytes must equal the source content");
-        await storage.close();
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-copy.test.js.map

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

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

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

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

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

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

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

@@ -1,35 +0,0 @@
-// Property-based test for the storage facade's delete semantics.
-//
-// Property 4: Delete removes visibility. For any stored object, after
-// `put(key, bytes)` then `delete(key)`, the object becomes invisible through
-// every read surface: `exists(key)` is false, `get(key)` reports not-found,
-// and `stat(key)` returns null.
-//
-// Backed by the zero-dependency in-memory provider via `createStorage({
-// provider: 'memory' })`, exercised across arbitrary keys and byte contents
-// 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 4
-// Validates: Requirements 4.4, 26.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 4 — delete removes visibility", async () => {
-    await fc.assert(fc.asyncProperty(
-    // Arbitrary non-empty keys and arbitrary byte contents.
-    fc.string({ minLength: 1 }), fc.uint8Array(), async (key, content) => {
-        const storage = createStorage({ provider: "memory" });
-        await storage.put(key, content);
-        await storage.delete(key);
-        // exists reports false after delete.
-        assert.equal(await storage.exists(key), false);
-        // get reports not-found (never throws).
-        const result = await storage.get(key);
-        assert.equal(result.found, false);
-        // stat returns null for the deleted key.
-        assert.equal(await storage.stat(key), null);
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-delete.test.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"prop-delete.test.js","sourceRoot":"","sources":["../../src/tests/prop-delete.test.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,sEAAsE;AACtE,6EAA6E;AAC7E,4EAA4E;AAC5E,gCAAgC;AAChC,EAAE;AACF,wEAAwE;AACxE,4EAA4E;AAC5E,8EAA8E;AAC9E,+CAA+C;AAC/C,EAAE;AACF,iDAAiD;AACjD,oCAAoC;AAEpC,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,IAAI,CACF,4EAA4E,EAC5E,KAAK,IAAI,EAAE;IACT,MAAM,EAAE,CAAC,MAAM,CACb,EAAE,CAAC,aAAa;IACd,wDAAwD;IACxD,EAAE,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAC3B,EAAE,CAAC,UAAU,EAAE,EACf,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;QACrB,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEtD,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAChC,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAE1B,qCAAqC;QACrC,MAAM,CAAC,KAAK,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QAE/C,wCAAwC;QACxC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAElC,yCAAyC;QACzC,MAAM,CAAC,KAAK,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC,CACF,EACD,EAAE,OAAO,EAAE,GAAG,EAAE,CACjB,CAAC;AACJ,CAAC,CACF,CAAC"}

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

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

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

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