@streetjs/storage 1.0.0 → 1.0.1

package/dist/tests/prop-signed-url.test.js

@@ -1,74 +0,0 @@
-// Property-based test for the storage facade's signed URL expiry guarantee.
-//
-// Property 11 (Signed URL expiry is honored): for an arbitrary key, operation
-// (GET/PUT/DELETE), and expiry window, a signed URL minted at time T with
-// `expiresInMs = E` verifies as VALID for its authorized operation when checked
-// at any instant strictly before `T + E`, and verifies as INVALID with reason
-// `'expired'` when checked at any instant at or after `T + E`.
-//
-// Time is made deterministic with an injected, controllable clock passed to
-// `createStorage({ provider: 'memory', signingSecret, clock })`. The facade
-// mints the URL over the zero-dependency memory provider (which has no native
-// signed-URL capability, so the HMAC simulation path runs). A second
-// `SignedUrlService` constructed with the SAME signing secret verifies the URL
-// at an explicit check time via its `verify(url, op, now)` path, exercising the
-// same code every provider shares (Requirements 8.1, 8.3, 8.4, 26.6).
-//
-// Uses the Node.js built-in test runner (node:test) with fast-check for input
-// generation, executed via `node --test dist/tests/*.test.js`, configured with
-// { numRuns: 100 } per the design's property-testing contract.
-//
-// Feature: unified-storage-framework, Property 11: Signed URL expiry is honored
-//
-// Validates: Requirements 8.1, 8.3, 8.4, 26.6
-import test from "node:test";
-import assert from "node:assert/strict";
-import fc from "fast-check";
-import { createStorage } from "../facade.js";
-import { SignedUrlService } from "../signed-url.js";
-const SIGNING_SECRET = "prop-11-signing-secret";
-test("Feature: unified-storage-framework, Property 11: Signed URL expiry is honored", async () => {
-    await fc.assert(fc.asyncProperty(
-    // An arbitrary object key.
-    fc.string(), 
-    // The single operation the URL authorizes (Requirement 8.1).
-    fc.constantFrom("GET", "PUT", "DELETE"), 
-    // The mint instant T as epoch milliseconds.
-    fc.integer({ min: 0, max: 2 ** 40 }), 
-    // A strictly-positive expiry window E, so the URL is valid at mint time.
-    fc.integer({ min: 1, max: 2 ** 32 }), 
-    // An offset relative to the expiry instant (T + E). A negative offset
-    // lands strictly before expiry (must be VALID); a non-negative offset
-    // lands at or after expiry (must be 'expired'). The range straddles zero
-    // so both branches are exercised across the 100 runs.
-    fc.integer({ min: -(2 ** 20), max: 2 ** 20 }), async (key, op, mintTime, expiresInMs, offsetFromExpiry) => {
-        // A controllable clock so minting stamps expiry as T + E deterministically.
-        let now = mintTime;
-        const clock = () => now;
-        const storage = createStorage({
-            provider: "memory",
-            signingSecret: SIGNING_SECRET,
-            clock,
-        });
-        // Mint through the facade at time T; expiry = T + E.
-        const url = await storage.signedUrl(key, op, { expiresInMs });
-        const expiry = mintTime + expiresInMs;
-        // Independent verifier sharing only the secret; the check time is
-        // supplied explicitly so expiry is driven deterministically.
-        const verifier = new SignedUrlService({ signingSecret: SIGNING_SECRET });
-        const checkTime = expiry + offsetFromExpiry;
-        const verification = verifier.verify(url, op, checkTime);
-        if (checkTime < expiry) {
-            // Strictly before T + E: the URL is valid for its authorized op.
-            assert.equal(verification.valid, true);
-            assert.equal(verification.key, key);
-            assert.equal(verification.op, op);
-        }
-        else {
-            // At or after T + E: the URL is invalid, specifically 'expired'.
-            assert.equal(verification.valid, false);
-            assert.equal(verification.reason, "expired");
-        }
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-signed-url.test.js.map

package/dist/tests/prop-signed-url.test.js.map

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

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

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

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

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

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

@@ -1,34 +0,0 @@
-// Property-based test for the storage facade streaming round-trip guarantee.
-//
-// Property 7 (Streaming preserves bytes): for arbitrary keys and byte contents,
-// persisting bytes with `putStream(key, Readable.from([bytes]))` and then
-// reading them back with `getStream(key)` (collecting every emitted chunk)
-// yields content bytes exactly equal to the original input. This exercises the
-// facade over the zero-dependency `memory` provider, driving the identical
-// streaming code path every provider shares (Requirement 5.1, 5.2, 5.4).
-//
-// 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 7: Streaming preserves bytes
-//
-// Validates: Requirements 5.1, 5.2, 5.4
-import test from "node:test";
-import assert from "node:assert/strict";
-import { Readable } from "node:stream";
-import { buffer as streamToBuffer } from "node:stream/consumers";
-import fc from "fast-check";
-import { createStorage } from "../facade.js";
-test("Feature: unified-storage-framework, Property 7: Streaming preserves bytes", async () => {
-    await fc.assert(fc.asyncProperty(fc.string(), fc.uint8Array(), async (key, content) => {
-        // A fresh store per run keeps each key/content pair independent.
-        const storage = createStorage({ provider: "memory" });
-        // Build the source stream from the raw bytes and stream it in.
-        await storage.putStream(key, Readable.from([Buffer.from(content)]));
-        // Collect all emitted chunks from the readable back into a buffer.
-        const out = await streamToBuffer(await storage.getStream(key));
-        assert.deepEqual(new Uint8Array(out), content);
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-streaming.test.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"prop-streaming.test.js","sourceRoot":"","sources":["../../src/tests/prop-streaming.test.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,EAAE;AACF,gFAAgF;AAChF,0EAA0E;AAC1E,2EAA2E;AAC3E,+EAA+E;AAC/E,2EAA2E;AAC3E,yEAAyE;AACzE,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,+EAA+E;AAC/E,EAAE;AACF,4EAA4E;AAC5E,EAAE;AACF,wCAAwC;AAExC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,IAAI,CACF,2EAA2E,EAC3E,KAAK,IAAI,EAAE;IACT,MAAM,EAAE,CAAC,MAAM,CACb,EAAE,CAAC,aAAa,CACd,EAAE,CAAC,MAAM,EAAE,EACX,EAAE,CAAC,UAAU,EAAE,EACf,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;QACrB,iEAAiE;QACjE,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEtD,+DAA+D;QAC/D,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAEpE,mEAAmE;QACnE,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAE/D,MAAM,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC,CACF,EACD,EAAE,OAAO,EAAE,GAAG,EAAE,CACjB,CAAC;AACJ,CAAC,CACF,CAAC"}

package/dist/tests/prop-upload-download.test.d.ts

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

package/dist/tests/prop-upload-download.test.d.ts.map

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

package/dist/tests/prop-upload-download.test.js

@@ -1,30 +0,0 @@
-// Property-based test for the storage facade round-trip guarantee.
-//
-// Property 1 (Upload/download preserves bytes): for arbitrary keys and byte
-// contents, persisting bytes with `put(key, bytes)` and then reading them back
-// with `get(key)` yields `found: true` and content bytes exactly equal to the
-// original input. This exercises the facade over the zero-dependency `memory`
-// provider, driving the identical code path every provider shares.
-//
-// 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 1: Upload/download preserves bytes
-//
-// Validates: Requirements 4.1, 4.2, 26.2
-import test from "node:test";
-import assert from "node:assert/strict";
-import fc from "fast-check";
-import { createStorage } from "../facade.js";
-test("Feature: unified-storage-framework, Property 1: Upload/download preserves bytes", async () => {
-    await fc.assert(fc.asyncProperty(fc.string(), fc.uint8Array(), async (key, content) => {
-        // A fresh store per run keeps each key/content pair independent.
-        const storage = createStorage({ provider: "memory" });
-        await storage.put(key, content);
-        const result = await storage.get(key);
-        assert.equal(result.found, true);
-        assert.deepEqual(result.bytes, content);
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-upload-download.test.js.map

package/dist/tests/prop-upload-download.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"prop-upload-download.test.js","sourceRoot":"","sources":["../../src/tests/prop-upload-download.test.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,8EAA8E;AAC9E,mEAAmE;AACnE,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,+EAA+E;AAC/E,EAAE;AACF,kFAAkF;AAClF,EAAE;AACF,yCAAyC;AAEzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,IAAI,CACF,iFAAiF,EACjF,KAAK,IAAI,EAAE;IACT,MAAM,EAAE,CAAC,MAAM,CACb,EAAE,CAAC,aAAa,CACd,EAAE,CAAC,MAAM,EAAE,EACX,EAAE,CAAC,UAAU,EAAE,EACf,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;QACrB,iEAAiE;QACjE,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,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEtC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC,CACF,EACD,EAAE,OAAO,EAAE,GAAG,EAAE,CACjB,CAAC;AACJ,CAAC,CACF,CAAC"}

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

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

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

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

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

@@ -1,50 +0,0 @@
-// Property-based test for the storage facade's validation pipeline guarantee.
-//
-// Property 12 (Validation rejects leave no partial object): a Storage instance
-// configured with a size validator (`validation: { maxSize: N }`) must, for any
-// upload whose byte length exceeds `N`, reject the `put` with a `ValidationError`
-// AND leave no partial object behind (`exists(key)` is false afterward). For any
-// upload within the limit, `put` succeeds and the object then exists. Because the
-// facade runs the validation pipeline before any bytes reach the driver, a
-// rejection can never persist content (Requirements 9.3, 9.4).
-//
-// Backed by the zero-dependency in-memory provider via `createStorage({
-// provider: 'memory', validation: { maxSize } })`, exercised across arbitrary
-// keys, byte contents, and size limits 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 12
-// Validates: Requirements 9.3, 9.4
-import test from "node:test";
-import assert from "node:assert/strict";
-import fc from "fast-check";
-import { createStorage } from "../index.js";
-import { ValidationError } from "../errors.js";
-test("Feature: unified-storage-framework, Property 12 — validation rejects leave no partial object", async () => {
-    await fc.assert(fc.asyncProperty(
-    // Arbitrary non-empty keys and arbitrary byte contents.
-    fc.string({ minLength: 1 }), fc.uint8Array(), 
-    // A non-negative size limit; chosen from a range that straddles typical
-    // fast-check byte-array lengths so both accepted and rejected inputs are
-    // generated across the 100 runs.
-    fc.nat({ max: 16 }), async (key, content, maxSize) => {
-        // A fresh store per run keeps each key/content pair independent.
-        const storage = createStorage({
-            provider: "memory",
-            validation: { maxSize },
-        });
-        const violatesLimit = content.byteLength > maxSize;
-        if (violatesLimit) {
-            // The oversized upload must be rejected with a ValidationError...
-            await assert.rejects(() => storage.put(key, content), (error) => error instanceof ValidationError);
-            // ...and must leave no partial object stored.
-            assert.equal(await storage.exists(key), false);
-        }
-        else {
-            // A within-limit upload succeeds and the object then exists.
-            await storage.put(key, content);
-            assert.equal(await storage.exists(key), true);
-        }
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-validation.test.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"prop-validation.test.js","sourceRoot":"","sources":["../../src/tests/prop-validation.test.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,kFAAkF;AAClF,iFAAiF;AACjF,kFAAkF;AAClF,2EAA2E;AAC3E,+DAA+D;AAC/D,EAAE;AACF,wEAAwE;AACxE,8EAA8E;AAC9E,4EAA4E;AAC5E,sFAAsF;AACtF,EAAE;AACF,kDAAkD;AAClD,mCAAmC;AAEnC,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;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,IAAI,CACF,8FAA8F,EAC9F,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;IACf,wEAAwE;IACxE,yEAAyE;IACzE,iCAAiC;IACjC,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,EACnB,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QAC9B,iEAAiE;QACjE,MAAM,OAAO,GAAG,aAAa,CAAC;YAC5B,QAAQ,EAAE,QAAQ;YAClB,UAAU,EAAE,EAAE,OAAO,EAAE;SACxB,CAAC,CAAC;QAEH,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC;QAEnD,IAAI,aAAa,EAAE,CAAC;YAClB,kEAAkE;YAClE,MAAM,MAAM,CAAC,OAAO,CAClB,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,EAC/B,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,YAAY,eAAe,CAC5C,CAAC;YACF,8CAA8C;YAC9C,MAAM,CAAC,KAAK,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,6DAA6D;YAC7D,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAChC,MAAM,CAAC,KAAK,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;IACH,CAAC,CACF,EACD,EAAE,OAAO,EAAE,GAAG,EAAE,CACjB,CAAC;AACJ,CAAC,CACF,CAAC"}

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

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

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

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

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

@@ -1,74 +0,0 @@
-// Property-based test for the storage facade's versioning restore semantics.
-//
-// Feature: unified-storage-framework, Property 13: Version restore reproduces
-// prior state. With versioning enabled (`createStorage({ provider: 'memory',
-// versioning: true, clock })`), for an arbitrary sequence of contents written
-// to a single key, each overwrite snapshots the prior content as a retained
-// Version. Restoring a listed Version makes exactly that Version's prior
-// content current again (bytes equal).
-//
-// The listed Versions are ordered oldest-first by creation time, so with a
-// strictly-increasing clock the i-th listed Version corresponds to the i-th
-// written content (each of the N writes after the first snapshots the content
-// that preceded it, yielding N-1 Versions for contents[0..N-2]).
-//
-// Backed by the zero-dependency in-memory provider, exercised across arbitrary
-// keys and content sequences with fast-check at { numRuns: 100 }. Executed via
-// the Node.js built-in test runner (`node --test dist/tests/*.test.js`).
-//
-// Validates: Requirements 12.1, 12.2, 12.3, 12.4, 26.5
-import test from "node:test";
-import assert from "node:assert/strict";
-import fc from "fast-check";
-import { createStorage } from "../index.js";
-/**
- * A strictly-increasing clock. Each successive write therefore stamps a larger
- * creation time, so the retained Versions enumerate oldest-first in the same
- * order they were written — letting the i-th Version be matched to the i-th
- * written content.
- */
-function makeIncrementingClock() {
-    let now = 1_700_000_000_000;
-    return () => now++;
-}
-/** Arbitrary object content: byte arrays (including empty) as Uint8Array. */
-const contentArb = fc.uint8Array({ minLength: 0, maxLength: 128 });
-/**
- * A sequence of at least two contents written to the same key, so at least one
- * overwrite (and therefore at least one retained Version) occurs.
- */
-const contentSequenceArb = fc.array(contentArb, { minLength: 2, maxLength: 6 });
-test("Feature: unified-storage-framework, Property 13 — version restore reproduces prior state", async () => {
-    await fc.assert(fc.asyncProperty(fc.string({ minLength: 1, maxLength: 40 }), contentSequenceArb, async (key, contents) => {
-        // A fresh, versioned storage instance per case keeps runs independent.
-        const storage = createStorage({
-            provider: "memory",
-            versioning: true,
-            clock: makeIncrementingClock(),
-        });
-        // Write the full sequence to the same key; each write after the first
-        // overwrites the prior content and snapshots it as a Version (12.1).
-        for (const content of contents) {
-            await storage.put(key, content);
-        }
-        // Each of the N writes after the first produces exactly one Version,
-        // enumerated oldest-first (12.2).
-        const versions = await storage.listVersions(key);
-        assert.equal(versions.length, contents.length - 1, "one retained Version per overwrite");
-        // Restoring the i-th listed Version reproduces exactly contents[i],
-        // the content that preceded the (i+1)-th write (12.3). Restoring does
-        // not itself create a new Version, so the Version set is stable and
-        // every listed Version remains restorable (12.4).
-        for (let i = 0; i < versions.length; i++) {
-            const meta = await storage.restoreVersion(key, versions[i].versionId);
-            assert.equal(meta.key, key, "restore returns metadata for the key");
-            const got = await storage.get(key);
-            assert.equal(got.found, true, "restored object is readable");
-            assert.deepEqual(got.bytes, contents[i], "restored content equals the Version's prior content (bytes equal)");
-            // The Version set is unchanged by a restore.
-            assert.equal((await storage.listVersions(key)).length, versions.length, "restore does not add or remove Versions");
-        }
-        await storage.close();
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-versioning.test.js.map

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

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

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

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

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

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

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

@@ -1,111 +0,0 @@
-// Unit tests for the Queue integration bridge wired into the storage facade
-// (task 21.2).
-//
-// Verifies the Requirement 17 / 28.3 graceful-degradation semantics over the
-// zero-dependency `memory` provider:
-//
-//  - bridgeStorageQueue dispatches the correct typed job name + payload through
-//    the structural QueueLike bridge (17.1).
-//  - a synchronous throw from the queue is fully isolated — never propagates
-//    into the caller (17.4).
-//  - an asynchronous rejection from the queue is fully isolated (17.4).
-//  - with no queue bridge configured, storage operations proceed unaffected
-//    (17.3).
-//  - configuring a queue bridge (present, throwing, or absent) never breaks the
-//    storage operation path.
-//
-// Uses the Node.js built-in test runner (node:test); executed via
-// `node --test dist/tests/*.test.js`.
-//
-// Requirements: 17.1, 17.2, 17.3, 17.4, 28.3
-import test from "node:test";
-import assert from "node:assert/strict";
-import { createStorage, bridgeStorageQueue } from "../index.js";
-/** A recording QueueLike double capturing every dispatched (job, payload). */
-function recordingQueue() {
-    const dispatched = [];
-    return {
-        dispatched,
-        dispatch(job, payload) {
-            dispatched.push({ job, payload: payload });
-        },
-    };
-}
-test("bridgeStorageQueue dispatches typed job names with key + options (Req 17.1)", () => {
-    const queue = recordingQueue();
-    const publisher = bridgeStorageQueue(queue);
-    publisher.thumbnail("photo.png", { size: 128 });
-    publisher.virusScan("upload.bin");
-    publisher.ocr("scan.tiff");
-    publisher.pdfProcess("doc.pdf");
-    publisher.transcode("video.mov");
-    publisher.imageOptimize("photo.png");
-    publisher.archive("report.csv");
-    assert.deepEqual(queue.dispatched.map((d) => d.job), [
-        "storage.thumbnail",
-        "storage.virus-scan",
-        "storage.ocr",
-        "storage.pdf-process",
-        "storage.transcode",
-        "storage.image-optimize",
-        "storage.archive",
-    ]);
-    assert.equal(queue.dispatched[0].payload.key, "photo.png");
-    assert.deepEqual(queue.dispatched[0].payload.options, { size: 128 });
-    assert.equal(queue.dispatched[1].payload.key, "upload.bin");
-});
-test("dispatch() passes an already-named job straight through (Req 17.1)", () => {
-    const queue = recordingQueue();
-    const publisher = bridgeStorageQueue(queue);
-    publisher.dispatch("storage.archive", { key: "k" });
-    assert.equal(queue.dispatched.length, 1);
-    assert.equal(queue.dispatched[0].job, "storage.archive");
-    assert.equal(queue.dispatched[0].payload.key, "k");
-});
-test("a synchronous dispatch failure never throws into the caller (Req 17.4)", () => {
-    const publisher = bridgeStorageQueue({
-        dispatch() {
-            throw new Error("queue down");
-        },
-    });
-    assert.doesNotThrow(() => publisher.thumbnail("photo.png"));
-    assert.doesNotThrow(() => publisher.dispatch("storage.archive", { key: "k" }));
-});
-test("an asynchronous dispatch rejection never throws into the caller (Req 17.4)", async () => {
-    const publisher = bridgeStorageQueue({
-        dispatch() {
-            return Promise.reject(new Error("async queue down"));
-        },
-    });
-    assert.doesNotThrow(() => publisher.transcode("video.mov"));
-    // Give any swallowed rejection a tick to settle without an unhandled error.
-    await new Promise((resolve) => setTimeout(resolve, 0));
-});
-test("facade wires a queue publisher when config.bridges.queue is present (Req 17.1)", async () => {
-    const queue = recordingQueue();
-    const storage = createStorage({ provider: "memory", bridges: { queue } });
-    // The bridge is constructed and held; storage operations remain unaffected.
-    const metadata = await storage.put("photo.png", "bytes", { contentType: "image/png" });
-    assert.equal(metadata.key, "photo.png");
-    assert.equal(await storage.exists("photo.png"), true);
-});
-test("a throwing queue never breaks storage operations (Req 17.4)", async () => {
-    const throwingQueue = {
-        dispatch() {
-            throw new Error("queue down");
-        },
-    };
-    const storage = createStorage({ provider: "memory", bridges: { queue: throwingQueue } });
-    const metadata = await storage.put("k", "v");
-    assert.equal(metadata.key, "k");
-    await storage.delete("k");
-    assert.equal(await storage.exists("k"), false);
-});
-test("with no queue bridge configured, operations proceed unaffected (Req 17.3)", async () => {
-    const storage = createStorage({ provider: "memory" });
-    const metadata = await storage.put("k", "v");
-    assert.equal(metadata.key, "k");
-    await storage.delete("k");
-    assert.equal(await storage.exists("k"), false);
-});
-//# sourceMappingURL=queue-bridge.test.js.map

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

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

package/dist/tests/r2-driver.test.d.ts

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

package/dist/tests/r2-driver.test.d.ts.map

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

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

@@ -1,143 +0,0 @@
-// Unit tests for the CloudflareR2Driver submodule (task 28.3). R2 is the shared
-// S3-style base pinned to the "r2" provider name with an R2 endpoint/credential
-// specialization for the build-its-own-client path. A fake in-memory
-// S3ClientLike stands in for the provider SDK so the driver is exercised with no
-// external service and no SDK dependency.
-//
-// Coverage:
-//  - createCloudflareR2Driver wraps an injected S3ClientLike, name === "r2"
-//  - the CloudflareR2Driver class is constructible and pinned to "r2"
-//  - primitives round-trip typed metadata across the client boundary
-//  - the shared driver contract-conformance suite passes against the driver
-//  - connectCloudflareR2Driver validates required config (StorageConfigError)
-//  - connectCloudflareR2Driver throws StorageConfigError when the S3 SDK is
-//    absent and no client was injected (the SDK is not installed here)
-//
-// Requirements: 2.1, 2.3, 3.3
-import test from "node:test";
-import assert from "node:assert/strict";
-import { CloudflareR2Driver, createCloudflareR2Driver, connectCloudflareR2Driver, } from "../drivers/r2.js";
-import { StorageConfigError } from "../errors.js";
-import { registerStorageDriverContractTests } from "./contract.js";
-const FIXED_NOW = 1_700_000_000_000;
-const fixedClock = () => FIXED_NOW;
-function bytes(str) {
-    return new TextEncoder().encode(str);
-}
-/** A minimal in-memory S3ClientLike standing in for the R2 (S3-API) client. */
-function makeFakeClient() {
-    const objects = new Map(); // key -> { body, contentType, metadata }
-    return {
-        async putObject({ key, body, contentType, metadata }) {
-            objects.set(key, {
-                body: body.slice(),
-                contentType,
-                metadata: metadata ? { ...metadata } : undefined,
-            });
-            return { etag: `"${key}-etag"` };
-        },
-        async getObject({ key }) {
-            const obj = objects.get(key);
-            if (obj === undefined) {
-                return null;
-            }
-            return {
-                body: obj.body.slice(),
-                contentType: obj.contentType,
-                etag: `"${key}-etag"`,
-                size: obj.body.byteLength,
-                lastModified: FIXED_NOW,
-                metadata: obj.metadata,
-            };
-        },
-        async headObject({ key }) {
-            const obj = objects.get(key);
-            if (obj === undefined) {
-                return null;
-            }
-            return {
-                contentType: obj.contentType,
-                etag: `"${key}-etag"`,
-                size: obj.body.byteLength,
-                lastModified: FIXED_NOW,
-                metadata: obj.metadata,
-            };
-        },
-        async deleteObject({ key }) {
-            objects.delete(key);
-        },
-        async listObjects({ prefix }) {
-            return [...objects.entries()]
-                .filter(([key]) => key.startsWith(prefix))
-                .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
-                .map(([key, obj]) => ({ key, size: obj.body.byteLength, updatedAt: FIXED_NOW }));
-        },
-    };
-}
-// ── name / construction ─────────────────────────────────────────────────────────
-test("createCloudflareR2Driver wraps an injected client and names it r2", () => {
-    const driver = createCloudflareR2Driver(makeFakeClient(), { clock: fixedClock });
-    assert.equal(driver.name, "r2");
-});
-test("CloudflareR2Driver class is constructible and pinned to r2", async () => {
-    const driver = new CloudflareR2Driver(makeFakeClient(), { clock: fixedClock });
-    assert.equal(driver.name, "r2");
-    const meta = await driver.put("k", bytes("v"), {});
-    assert.equal(meta.key, "k");
-});
-// ── primitives round-trip across the client boundary ─────────────────────────────
-test("put/get round-trips bytes and typed metadata", async () => {
-    const driver = createCloudflareR2Driver(makeFakeClient(), { clock: fixedClock });
-    const content = bytes("cloudflare r2 payload");
-    await driver.put("docs/r2.txt", content, {
-        contentType: "text/plain",
-        owner: "user-9",
-        tenant: "tenant-z",
-        accessLevel: "public",
-        custom: { region: "auto" },
-    });
-    const result = await driver.get("docs/r2.txt");
-    assert.equal(result.found, true);
-    assert.deepEqual(result.bytes, content);
-    assert.equal(result.metadata.contentType, "text/plain");
-    assert.equal(result.metadata.owner, "user-9");
-    assert.equal(result.metadata.tenant, "tenant-z");
-    assert.equal(result.metadata.accessLevel, "public");
-    assert.deepEqual(result.metadata.custom, { region: "auto" });
-});
-test("get on a missing key reports found:false (not an error)", async () => {
-    const driver = createCloudflareR2Driver(makeFakeClient(), { clock: fixedClock });
-    const result = await driver.get("missing");
-    assert.equal(result.found, false);
-});
-// ── build-its-own-client path (SDK isolation) ────────────────────────────────────
-test("connectCloudflareR2Driver validates required config", async () => {
-    await assert.rejects(() => connectCloudflareR2Driver({
-        accountId: "",
-        bucket: "media",
-        accessKeyId: "AK",
-        secretAccessKey: "SK",
-    }), (error) => {
-        assert.ok(error instanceof StorageConfigError);
-        assert.equal(error.provider, "r2");
-        return true;
-    });
-});
-test("connectCloudflareR2Driver throws StorageConfigError when the S3 SDK is absent", async () => {
-    // The optional @aws-sdk/client-s3 peer is not installed in this workspace, so
-    // the lazy dynamic import must fail and surface a StorageConfigError rather
-    // than an unhandled module-resolution error.
-    await assert.rejects(() => connectCloudflareR2Driver({
-        accountId: "acct-123",
-        bucket: "media",
-        accessKeyId: "AK",
-        secretAccessKey: "SK",
-    }), (error) => {
-        assert.ok(error instanceof StorageConfigError);
-        assert.equal(error.provider, "r2");
-        return true;
-    });
-});
-// ── shared contract-conformance suite ────────────────────────────────────────────
-registerStorageDriverContractTests("r2", () => createCloudflareR2Driver(makeFakeClient(), { clock: fixedClock }), test);
-//# sourceMappingURL=r2-driver.test.js.map

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

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

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

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

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

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