@streetjs/storage 1.0.0 → 1.0.1

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":""}

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

@@ -1,65 +0,0 @@
-// Property-based test for the storage facade's multipart upload guarantee.
-//
-// Property 8 (Multipart equals a single upload): for arbitrary content split
-// into arbitrary ordered parts, performing a multipart upload
-// (`createMultipartUpload` → `uploadPart` for each part in order →
-// `completeMultipartUpload`) produces an object whose bytes are exactly equal
-// to a single `put` of the concatenation of those parts. Equality is checked
-// both by the raw stored bytes and by the content checksum the drivers compute,
-// so the multipart assembly path is proven observationally identical to the
-// single-shot write path (Requirement 6.3). Both uploads run 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 8: Multipart equals a single upload
-//
-// Validates: Requirements 6.3, 26.5
-import test from "node:test";
-import assert from "node:assert/strict";
-import { Buffer } from "node:buffer";
-import fc from "fast-check";
-import { createStorage } from "../facade.js";
-test("Feature: unified-storage-framework, Property 8: Multipart equals a single upload", async () => {
-    await fc.assert(fc.asyncProperty(
-    // A key for both objects and an arbitrary ordered list of parts. At
-    // least one part is generated so there is always something to upload;
-    // individual parts may be empty, exercising the assembly of 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" });
-        // The concatenation of the parts, in the order they will be uploaded,
-        // is the exact byte sequence a single `put` would persist.
-        const concatenated = Buffer.concat(parts.map((part) => Buffer.from(part)));
-        // ── Multipart upload path ─────────────────────────────────────────
-        const multipartKey = `${key}/multipart`;
-        const uploadId = await storage.createMultipartUpload(multipartKey);
-        const storedParts = [];
-        for (let index = 0; index < parts.length; index += 1) {
-            // Part numbers are 1-based positive integers assigned in order.
-            const stored = await storage.uploadPart(uploadId, index + 1, parts[index]);
-            storedParts.push(stored);
-        }
-        const multipartMeta = await storage.completeMultipartUpload(uploadId, storedParts);
-        // ── Single upload path ────────────────────────────────────────────
-        const singleKey = `${key}/single`;
-        const singleMeta = await storage.put(singleKey, concatenated);
-        // The assembled object must equal a single put of the concatenation,
-        // both in raw bytes and in the computed content checksum.
-        const multipartResult = await storage.get(multipartKey);
-        const singleResult = await storage.get(singleKey);
-        assert.equal(multipartResult.found, true);
-        assert.equal(singleResult.found, true);
-        assert.ok(multipartResult.bytes);
-        assert.ok(singleResult.bytes);
-        assert.deepEqual(Buffer.from(multipartResult.bytes), Buffer.from(singleResult.bytes));
-        assert.deepEqual(Buffer.from(multipartResult.bytes), concatenated);
-        assert.equal(multipartMeta.checksum, singleMeta.checksum);
-        assert.equal(multipartMeta.size, singleMeta.size);
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-multipart.test.js.map

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

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

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

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

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

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

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

@@ -1,78 +0,0 @@
-// Property-based test for the resumable upload equivalence guarantee.
-//
-// Property 10 (Resumable equals uninterrupted): for arbitrary content, a
-// resumable upload — optionally interrupted partway (a first `resumeUpload`
-// whose source stream errors after emitting a prefix) and then resumed with the
-// object's full content — produces an object byte-identical to an equivalent
-// single, uninterrupted `put` of the same content on a separate store. The
-// upload is driven through `startUpload` → (optional failing `resumeUpload`) →
-// `resumeUpload(full stream)`; the resulting bytes and checksum are compared
-// against a plain `put` on an independent `memory` store.
-//
-// This exercises the facade's ResumableManager over the zero-dependency
-// `memory` provider, driving the identical offset-tracked resume code path
-// every provider shares (Requirements 7.2, 7.3), and asserts the cross-path
-// determinism the framework guarantees (Requirement 26.5).
-//
-// 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 10: Resumable equals uninterrupted
-//
-// Validates: Requirements 7.2, 7.3, 26.5
-import test from "node:test";
-import assert from "node:assert/strict";
-import { Readable } from "node:stream";
-import { Buffer } from "node:buffer";
-import fc from "fast-check";
-import { createStorage } from "../facade.js";
-test("Feature: unified-storage-framework, Property 10: Resumable equals uninterrupted", async () => {
-    await fc.assert(fc.asyncProperty(fc.string(), fc.uint8Array(), 
-    // `interrupt` decides whether the upload is interrupted before its
-    // final resume; `prefixLen` (bounded to the content) picks how many
-    // bytes the interrupted resume persists before erroring.
-    fc.boolean(), fc.nat(), async (key, content, interrupt, prefixLen) => {
-        const payload = Buffer.from(content);
-        // The resumable store: start a session, optionally interrupt, then
-        // resume with the FULL content.
-        const resumableStore = createStorage({ provider: "memory" });
-        const sessionId = await resumableStore.startUpload(key, {});
-        if (interrupt && payload.byteLength > 0) {
-            // Emit a prefix of the content then error partway, simulating a
-            // network interruption. Only the prefix is persisted (Req 7.2).
-            const cut = prefixLen % payload.byteLength;
-            const prefix = payload.subarray(0, cut);
-            const failing = new Readable({
-                read() {
-                    if (prefix.byteLength > 0) {
-                        this.push(prefix);
-                    }
-                    this.destroy(new Error("network interruption"));
-                },
-            });
-            await assert.rejects(() => resumableStore.resumeUpload(sessionId, failing), /network interruption/);
-            // No final object exists yet after an interrupted resume.
-            assert.equal(await resumableStore.exists(key), false);
-        }
-        // Resume with the full content: the manager appends only the bytes
-        // beyond the persisted offset and completes (Req 7.3).
-        const resumedMeta = await resumableStore.resumeUpload(sessionId, Readable.from([payload]));
-        // The reference store: a single, uninterrupted put of the same bytes.
-        const referenceStore = createStorage({ provider: "memory" });
-        const singleMeta = await referenceStore.put(key, new Uint8Array(payload), {});
-        // Byte-identical object: same size and checksum as the single put.
-        assert.equal(resumedMeta.size, singleMeta.size);
-        assert.equal(resumedMeta.checksum, singleMeta.checksum);
-        // And the stored bytes read back equal on both stores.
-        const resumedGet = await resumableStore.get(key);
-        const referenceGet = await referenceStore.get(key);
-        assert.equal(resumedGet.found, true);
-        assert.equal(referenceGet.found, true);
-        assert.ok(resumedGet.bytes);
-        assert.ok(referenceGet.bytes);
-        assert.deepEqual(Buffer.from(resumedGet.bytes), payload);
-        assert.deepEqual(Buffer.from(resumedGet.bytes), Buffer.from(referenceGet.bytes));
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-resumable.test.js.map

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

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

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

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

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

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

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

@@ -1,120 +0,0 @@
-// Property-based test for the storage facade `search(filters)` operation.
-//
-// Feature: unified-storage-framework, Property 15 — Search returns exactly the
-// matching objects. For an arbitrary set of stored objects (with varied
-// owner/tenant/contentType/size/custom metadata) and an arbitrary combination
-// of SearchFilters, `storage.search(filters)` returns EXACTLY the set of
-// objects that satisfy EVERY supplied filter (conjunctive / AND semantics):
-// no matching object is missing and no non-matching object is included. When
-// no object satisfies the filters, the result is the empty set.
-//
-// The expected set is computed independently of the implementation and
-// compared for exact set equality.
-//
-// 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 16.2, 16.3
-import test from "node:test";
-import assert from "node:assert/strict";
-import fc from "fast-check";
-import { createStorage } from "../index.js";
-// UTF-8 byte length, matching how the facade encodes string payloads before
-// the driver records `size`.
-const byteSize = (content) => new TextEncoder().encode(content).length;
-// Domains kept small so filters match frequently, exercising both the
-// "matches" and "excludes nothing/everything" branches.
-const ownerArb = fc.option(fc.constantFrom("alice", "bob"), { nil: undefined });
-const tenantArb = fc.option(fc.constantFrom("acme", "globex"), { nil: undefined });
-const contentTypeArb = fc.constantFrom("image/jpeg", "image/png", "text/plain");
-const categoryArb = fc.option(fc.constantFrom("invoice", "receipt"), { nil: undefined });
-// Keys drawn from a small alphabet so shared prefixes arise often. The alphabet
-// excludes '.', so no key collides with the reserved internal key spaces.
-const keyArb = fc.stringMatching(/^[a-c/]{1,6}$/).filter((k) => k.length > 0);
-// An object to store: a key, content (whose byte length gives size), and
-// varied metadata.
-const objectArb = fc.record({
-    key: keyArb,
-    content: fc.string({ maxLength: 6 }),
-    owner: ownerArb,
-    tenant: tenantArb,
-    contentType: contentTypeArb,
-    category: categoryArb,
-});
-// Arbitrary SearchFilters. Every field is optional (undefined => no
-// constraint). Filter domains deliberately include values that may match
-// nothing (e.g. owner "carol") so the empty-result case is covered.
-const filtersArb = fc.record({
-    prefix: fc.option(fc.stringMatching(/^[a-c/]{0,3}$/), { nil: undefined }),
-    contentType: fc.option(fc.constantFrom("image/jpeg", "image/png", "text/plain", "application/pdf"), {
-        nil: undefined,
-    }),
-    owner: fc.option(fc.constantFrom("alice", "bob", "carol"), { nil: undefined }),
-    tenant: fc.option(fc.constantFrom("acme", "globex", "initech"), { nil: undefined }),
-    minSize: fc.option(fc.integer({ min: 0, max: 6 }), { nil: undefined }),
-    maxSize: fc.option(fc.integer({ min: 0, max: 6 }), { nil: undefined }),
-    metadata: fc.option(fc.constantFrom({ category: "invoice" }, { category: "receipt" }), {
-        nil: undefined,
-    }),
-});
-// Independent reference implementation of the AND-semantics filter, evaluated
-// against the known write-time metadata of a stored object.
-function satisfies(obj, filters) {
-    const size = byteSize(obj.content);
-    const custom = obj.category !== undefined ? { category: obj.category } : {};
-    if (filters.prefix !== undefined && !obj.key.startsWith(filters.prefix))
-        return false;
-    if (filters.contentType !== undefined && obj.contentType !== filters.contentType)
-        return false;
-    if (filters.owner !== undefined && obj.owner !== filters.owner)
-        return false;
-    if (filters.tenant !== undefined && obj.tenant !== filters.tenant)
-        return false;
-    if (filters.minSize !== undefined && size < filters.minSize)
-        return false;
-    if (filters.maxSize !== undefined && size > filters.maxSize)
-        return false;
-    if (filters.metadata !== undefined) {
-        for (const [field, value] of Object.entries(filters.metadata)) {
-            if (custom[field] !== value)
-                return false;
-        }
-    }
-    return true;
-}
-test("Feature: unified-storage-framework, Property 15 — search returns exactly the matching objects", async () => {
-    await fc.assert(fc.asyncProperty(fc.uniqueArray(objectArb, {
-        selector: (obj) => obj.key,
-        minLength: 0,
-        maxLength: 12,
-    }), filtersArb, async (objects, filters) => {
-        const storage = createStorage({ provider: "memory" });
-        for (const obj of objects) {
-            const metadata = {
-                contentType: obj.contentType,
-            };
-            if (obj.owner !== undefined)
-                metadata.owner = obj.owner;
-            if (obj.tenant !== undefined)
-                metadata.tenant = obj.tenant;
-            if (obj.category !== undefined)
-                metadata.custom = { category: obj.category };
-            await storage.put(obj.key, obj.content, metadata);
-        }
-        const result = await storage.search(filters);
-        const observed = new Set(result.map((item) => item.key));
-        // Expected: exactly the stored keys whose object satisfies every filter.
-        const expected = new Set(objects.filter((obj) => satisfies(obj, filters)).map((obj) => obj.key));
-        // Exact set equality: same cardinality + same membership (no extras,
-        // none missing). An empty expected set implies an empty result.
-        assert.equal(observed.size, expected.size, `size mismatch: observed ${[...observed]} vs expected ${[...expected]}`);
-        for (const key of expected) {
-            assert.ok(observed.has(key), `missing matching key: ${key}`);
-        }
-        for (const key of observed) {
-            assert.ok(expected.has(key), `unexpected non-matching key: ${key}`);
-        }
-    }), { numRuns: 100 });
-});
-//# sourceMappingURL=prop-search.test.js.map

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

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

package/dist/tests/prop-signed-url.test.d.ts

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

package/dist/tests/prop-signed-url.test.d.ts.map

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