@streetjs/storage 1.0.0 → 1.0.1

package/dist/tests/validation.test.js

@@ -1,135 +0,0 @@
-// Unit tests for the pre-persistence validation pipeline of @streetjs/storage.
-//
-// Covers the built-in validators (MIME type, extension, size, filename,
-// checksum, custom), their ordering/short-circuit behavior, and the facade
-// wiring: when `config.validation` is set, a rejected upload aborts with a
-// ValidationError and leaves NO object stored (Requirements 9.1, 9.2, 9.3, 9.4).
-//
-// Uses the Node.js built-in test runner (node:test), executed via
-// `node --test dist/tests/*.test.js`.
-//
-// Requirements: 9.1, 9.2, 9.3, 9.4
-import test from "node:test";
-import assert from "node:assert/strict";
-import { Readable } from "node:stream";
-import { ValidationPipeline } from "../validation.js";
-import { createStorage } from "../facade.js";
-import { ValidationError } from "../errors.js";
-// ── Pipeline-level tests ──────────────────────────────────────────────────────
-test("MIME type validator accepts allowed exact and wildcard types", async () => {
-    const pipeline = new ValidationPipeline({ allowedMimeTypes: ["image/png", "text/*"] });
-    assert.equal((await pipeline.validate({ key: "a.png", size: 1, contentType: "image/png" })).ok, true);
-    assert.equal((await pipeline.validate({ key: "a.txt", size: 1, contentType: "text/plain" })).ok, true);
-});
-test("MIME type validator rejects disallowed or missing content type", async () => {
-    const pipeline = new ValidationPipeline({ allowedMimeTypes: ["image/png"] });
-    const disallowed = await pipeline.validate({ key: "a.gif", size: 1, contentType: "image/gif" });
-    assert.equal(disallowed.ok, false);
-    assert.ok(disallowed.error.includes("image/gif"));
-    const missing = await pipeline.validate({ key: "a", size: 1 });
-    assert.equal(missing.ok, false);
-});
-test("extension validator normalizes dots and case", async () => {
-    const pipeline = new ValidationPipeline({ allowedExtensions: [".PNG", "jpg"] });
-    assert.equal((await pipeline.validate({ key: "photos/a.png", size: 1 })).ok, true);
-    assert.equal((await pipeline.validate({ key: "photos/a.JPG", size: 1 })).ok, true);
-    const bad = await pipeline.validate({ key: "photos/a.gif", size: 1 });
-    assert.equal(bad.ok, false);
-    const none = await pipeline.validate({ key: "photos/noext", size: 1 });
-    assert.equal(none.ok, false);
-});
-test("size validator rejects content larger than maxSize", async () => {
-    const pipeline = new ValidationPipeline({ maxSize: 10 });
-    assert.equal((await pipeline.validate({ key: "a", size: 10 })).ok, true);
-    const tooBig = await pipeline.validate({ key: "a", size: 11 });
-    assert.equal(tooBig.ok, false);
-    assert.ok(tooBig.error.includes("11"));
-});
-test("filename validator matches against the final path segment", async () => {
-    const pipeline = new ValidationPipeline({ filenamePattern: /^[a-z0-9_-]+\.txt$/ });
-    assert.equal((await pipeline.validate({ key: "dir/valid_name.txt", size: 1 })).ok, true);
-    const bad = await pipeline.validate({ key: "dir/Bad Name.txt", size: 1 });
-    assert.equal(bad.ok, false);
-});
-test("filename validator with a global pattern is not stateful across calls", async () => {
-    const pipeline = new ValidationPipeline({ filenamePattern: /\.txt$/g });
-    assert.equal((await pipeline.validate({ key: "a.txt", size: 1 })).ok, true);
-    assert.equal((await pipeline.validate({ key: "b.txt", size: 1 })).ok, true);
-});
-test("checksum validator requires a non-empty checksum when configured", async () => {
-    const pipeline = new ValidationPipeline({ requireChecksum: true });
-    assert.equal((await pipeline.validate({ key: "a", size: 1, checksum: "abc" })).ok, true);
-    assert.equal((await pipeline.validate({ key: "a", size: 1 })).ok, false);
-    assert.equal((await pipeline.validate({ key: "a", size: 1, checksum: "" })).ok, false);
-});
-test("custom validator result is returned verbatim and runs last", async () => {
-    const pipeline = new ValidationPipeline({
-        custom: (input) => ({ ok: false, error: `custom rejected ${input.key}` }),
-    });
-    const result = await pipeline.validate({ key: "x", size: 1 });
-    assert.equal(result.ok, false);
-    assert.equal(result.error, "custom rejected x");
-});
-test("pipeline short-circuits on the first rejection in order", async () => {
-    // Size (validator 3) rejects; the custom validator (validator 6) must not run.
-    let customRan = false;
-    const pipeline = new ValidationPipeline({
-        maxSize: 5,
-        custom: () => {
-            customRan = true;
-            return { ok: true };
-        },
-    });
-    const result = await pipeline.validate({ key: "a", size: 100 });
-    assert.equal(result.ok, false);
-    assert.equal(customRan, false);
-});
-test("empty config accepts everything", async () => {
-    const pipeline = new ValidationPipeline({});
-    assert.equal((await pipeline.validate({ key: "anything", size: 12345 })).ok, true);
-});
-// ── Facade wiring tests ────────────────────────────────────────────────────────
-test("facade put rejects invalid uploads and stores no object", async () => {
-    const storage = createStorage({
-        provider: "memory",
-        validation: { maxSize: 4 },
-    });
-    await assert.rejects(() => storage.put("big.bin", new Uint8Array([1, 2, 3, 4, 5])), (err) => err instanceof ValidationError);
-    assert.equal(await storage.exists("big.bin"), false);
-});
-test("facade put persists valid uploads when validation passes", async () => {
-    const storage = createStorage({
-        provider: "memory",
-        validation: { maxSize: 16, allowedExtensions: ["txt"] },
-    });
-    const meta = await storage.put("notes/a.txt", "hello");
-    assert.equal(meta.key, "notes/a.txt");
-    assert.equal(await storage.exists("notes/a.txt"), true);
-});
-test("facade putStream rejects invalid uploads and stores no object", async () => {
-    const storage = createStorage({
-        provider: "memory",
-        validation: { maxSize: 3 },
-    });
-    const stream = Readable.from([Buffer.from([1, 2, 3, 4, 5, 6])]);
-    await assert.rejects(() => storage.putStream("stream.bin", stream), (err) => err instanceof ValidationError);
-    assert.equal(await storage.exists("stream.bin"), false);
-});
-test("facade putStream persists valid uploads and preserves bytes", async () => {
-    const storage = createStorage({
-        provider: "memory",
-        validation: { maxSize: 1024 },
-    });
-    const content = Buffer.from("streamed payload");
-    const stream = Readable.from([content]);
-    await storage.putStream("ok.bin", stream);
-    const result = await storage.get("ok.bin");
-    assert.equal(result.found, true);
-    assert.deepEqual(result.bytes, new Uint8Array(content));
-});
-test("facade without validation config performs no validation", async () => {
-    const storage = createStorage({ provider: "memory" });
-    await storage.put("huge.bin", new Uint8Array(1000));
-    assert.equal(await storage.exists("huge.bin"), true);
-});
-//# sourceMappingURL=validation.test.js.map

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

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

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

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

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

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

package/dist/tests/versioning.test.js

@@ -1,128 +0,0 @@
-// Unit tests for the versioning manager wired into the storage facade
-// (task 14.1).
-//
-// Verifies the Requirement 12 semantics over the zero-dependency `memory`
-// provider (which has no native `versioning` capability, so the manager
-// simulates version snapshots over the driver primitives under reserved
-// `.versions/<key>/<versionId>` keys):
-//
-//  - overwriting a versioned key snapshots the prior content; unlimited
-//    Versions are retained (12.1).
-//  - listVersions returns the retained Version identifiers for a key (12.2).
-//  - restoreVersion makes a listed Version's content the current content (12.3).
-//  - deleteVersion removes only that Version and retains the rest (12.4).
-//  - a versioning-mechanism failure allows the overwrite to proceed WITHOUT
-//    creating a Version (12.5).
-//  - with versioning disabled no Versions are recorded.
-//
-// Uses the Node.js built-in test runner (node:test); executed via
-// `node --test dist/tests/*.test.js`.
-//
-// Requirements: 12.1, 12.2, 12.3, 12.4, 12.5
-import test from "node:test";
-import assert from "node:assert/strict";
-import { createStorage } from "../facade.js";
-import { VersioningManager } from "../versioning.js";
-import { MemoryStorageDriver } from "../drivers/memory.js";
-import { NotFoundError } from "../errors.js";
-const fixedClock = () => 1_700_000_000_000;
-test("overwrite snapshots prior content and retains unlimited Versions (Req 12.1)", async () => {
-    const storage = createStorage({ provider: "memory", versioning: true, clock: fixedClock });
-    await storage.put("doc", "v1", { contentType: "text/plain" });
-    await storage.put("doc", "v2", { contentType: "text/plain" });
-    await storage.put("doc", "v3", { contentType: "text/plain" });
-    // Three writes → the two overwrites each snapshot the prior content.
-    const versions = await storage.listVersions("doc");
-    assert.equal(versions.length, 2);
-    // Current content is the latest write.
-    const got = await storage.get("doc");
-    assert.equal(Buffer.from(got.bytes).toString(), "v3");
-});
-test("first write to a key creates no Version (Req 12.1)", async () => {
-    const storage = createStorage({ provider: "memory", versioning: true, clock: fixedClock });
-    await storage.put("fresh", "only");
-    assert.deepEqual(await storage.listVersions("fresh"), []);
-});
-test("listVersions returns retained Version identifiers (Req 12.2)", async () => {
-    const storage = createStorage({ provider: "memory", versioning: true, clock: fixedClock });
-    await storage.put("k", "a");
-    await storage.put("k", "b");
-    const versions = await storage.listVersions("k");
-    assert.equal(versions.length, 1);
-    assert.equal(typeof versions[0].versionId, "string");
-    assert.ok(versions[0].versionId.length > 0);
-    assert.equal(versions[0].size, Buffer.byteLength("a"));
-});
-test("restoreVersion makes a Version's content current (Req 12.3)", async () => {
-    const storage = createStorage({ provider: "memory", versioning: true, clock: fixedClock });
-    await storage.put("k", "original", { contentType: "text/plain" });
-    await storage.put("k", "changed", { contentType: "text/plain" });
-    const [v1] = await storage.listVersions("k");
-    const meta = await storage.restoreVersion("k", v1.versionId);
-    assert.equal(meta.key, "k");
-    const got = await storage.get("k");
-    assert.equal(Buffer.from(got.bytes).toString(), "original");
-});
-test("restoreVersion of an unknown Version throws NotFoundError", async () => {
-    const storage = createStorage({ provider: "memory", versioning: true, clock: fixedClock });
-    await storage.put("k", "x");
-    await assert.rejects(() => storage.restoreVersion("k", "nope"), NotFoundError);
-});
-test("deleteVersion removes only that Version and retains the rest (Req 12.4)", async () => {
-    const storage = createStorage({ provider: "memory", versioning: true, clock: fixedClock });
-    await storage.put("k", "a");
-    await storage.put("k", "b");
-    await storage.put("k", "c");
-    const versions = await storage.listVersions("k");
-    assert.equal(versions.length, 2);
-    await storage.deleteVersion("k", versions[0].versionId);
-    const remaining = await storage.listVersions("k");
-    assert.equal(remaining.length, 1);
-    assert.equal(remaining[0].versionId, versions[1].versionId);
-});
-test("versioning failure allows the overwrite to proceed without a Version (Req 12.5)", async () => {
-    // A driver whose get() throws simulates a versioning-mechanism failure while
-    // snapshotting. The overwrite must still succeed and record no Version.
-    const base = new MemoryStorageDriver({ clock: fixedClock });
-    let failNextGet = false;
-    const flaky = {
-        ...base,
-        name: "flaky",
-        put: (key, bytes, meta) => base.put(key, bytes, meta),
-        get: (key) => {
-            if (failNextGet) {
-                return Promise.reject(new Error("snapshot storage constraint"));
-            }
-            return base.get(key);
-        },
-        exists: (key) => base.exists(key),
-        delete: (key) => base.delete(key),
-        stat: (key) => base.stat(key),
-        list: (prefix, options) => base.list(prefix, options),
-        putStream: (key, stream, meta) => base.putStream(key, stream, meta),
-        getStream: (key) => base.getStream(key),
-    };
-    const storage = createStorage({ provider: "custom", driver: flaky, versioning: true });
-    await storage.put("k", "v1");
-    // Force the snapshot read to fail on the overwrite.
-    failNextGet = true;
-    const meta = await storage.put("k", "v2");
-    failNextGet = false;
-    assert.equal(meta.key, "k");
-    const got = await storage.get("k");
-    assert.equal(Buffer.from(got.bytes).toString(), "v2");
-    // No Version was created because the snapshot failed (listVersions reads
-    // succeed again once the flag is cleared).
-    assert.deepEqual(await storage.listVersions("k"), []);
-});
-test("with versioning disabled no Versions are recorded", async () => {
-    const storage = createStorage({ provider: "memory", clock: fixedClock });
-    await storage.put("k", "a");
-    await storage.put("k", "b");
-    assert.deepEqual(await storage.listVersions("k"), []);
-});
-test("VersioningManager is exported and constructible", () => {
-    const manager = new VersioningManager(new MemoryStorageDriver({ clock: fixedClock }));
-    assert.ok(manager instanceof VersioningManager);
-});
-//# sourceMappingURL=versioning.test.js.map

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

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