@streetjs/storage 1.0.0

package/dist/tests/access.test.js

@@ -0,0 +1,270 @@
+// Unit tests for the provider-agnostic access controller of @streetjs/storage.
+//
+// Covers the AccessController decision rules directly (permissive default,
+// public-read allowance, bridge-governed deny/permit for every access level)
+// and the facade wiring: with a configured `config.auth` bridge, a denied
+// operation throws an AuthorizationError and performs no persistence/read;
+// with NO bridge configured the facade stays fully permissive (Requirements
+// 11.1, 11.2, 11.3, 11.4).
+//
+// Uses the Node.js built-in test runner (node:test), executed via
+// `node --test dist/tests/*.test.js`.
+//
+// Requirements: 11.1, 11.2, 11.3, 11.4
+import test from "node:test";
+import assert from "node:assert/strict";
+import { AccessController } from "../access.js";
+import { createStorage } from "../facade.js";
+import { AuthorizationError } from "../errors.js";
+// A tiny structural AuthLike bridge whose `can` is driven by an injected fn.
+function makeAuth(decision) {
+    const calls = [];
+    return {
+        calls,
+        can(context) {
+            calls.push(context);
+            return typeof decision === "function" ? decision(context) : decision;
+        },
+    };
+}
+// ── Controller-level tests ────────────────────────────────────────────────────
+test("controller with no auth bridge is permissive and not enforced", async () => {
+    const access = new AccessController();
+    assert.equal(access.enforced, false);
+    // Even a normally-restricted level is permitted when nothing is configured.
+    await access.authorize({ key: "k", operation: "write", accessLevel: "private" });
+    await access.authorize({ key: "k", operation: "read", accessLevel: "role-based" });
+});
+test("controller reports enforced when an auth bridge is configured", () => {
+    const access = new AccessController({ auth: makeAuth(true) });
+    assert.equal(access.enforced, true);
+});
+test("controller supports every access level and denies when the bridge says false", async () => {
+    const levels = ["public", "private", "signed", "authenticated", "role-based", "tenant-aware"];
+    for (const accessLevel of levels) {
+        const access = new AccessController({ auth: makeAuth(false) });
+        // A write is denied for every level when the bridge returns false (11.1/11.3).
+        await assert.rejects(() => access.authorize({ key: "k", operation: "write", accessLevel }), (err) => err instanceof AuthorizationError && err.accessLevel === accessLevel);
+    }
+});
+test("controller permits when the bridge returns true", async () => {
+    const auth = makeAuth(true);
+    const access = new AccessController({ auth });
+    await access.authorize({
+        key: "docs/a.txt",
+        operation: "read",
+        accessLevel: "authenticated",
+        owner: "alice",
+        tenant: "acme",
+    });
+    // The full context is forwarded to the bridge (11.2).
+    assert.deepEqual(auth.calls[0], {
+        key: "docs/a.txt",
+        operation: "read",
+        accessLevel: "authenticated",
+        owner: "alice",
+        tenant: "acme",
+    });
+});
+test("public reads are permitted without authentication (bridge returns false)", async () => {
+    // Even when the bridge denies by default, a public READ is still allowed
+    // unless the bridge is treating public as the blocking factor. Here the
+    // bridge only blocks writes; public reads pass (Requirement 11.4).
+    const access = new AccessController({
+        auth: makeAuth((ctx) => ctx.operation !== "write"),
+    });
+    await access.authorize({ key: "p", operation: "read", accessLevel: "public" });
+});
+test("public reads can still be blocked by a configured factor", async () => {
+    // A bridge that explicitly returns false blocks even a public read
+    // ("unless another configured factor blocks", Requirement 11.4).
+    const access = new AccessController({ auth: makeAuth(false) });
+    await assert.rejects(() => access.authorize({ key: "p", operation: "read", accessLevel: "public" }), (err) => err instanceof AuthorizationError);
+});
+test("controller awaits an async bridge decision", async () => {
+    const access = new AccessController({ auth: makeAuth(async () => false) });
+    await assert.rejects(() => access.authorize({ key: "k", operation: "read", accessLevel: "private" }), (err) => err instanceof AuthorizationError);
+});
+// ── Facade wiring tests ─────────────────────────────────────────────────────
+test("facade stays permissive when no auth bridge is configured", async () => {
+    const storage = createStorage({ provider: "memory" });
+    const meta = await storage.put("a.txt", "hello", { accessLevel: "private" });
+    assert.equal(meta.key, "a.txt");
+    const got = await storage.get("a.txt");
+    assert.equal(got.found, true);
+    await storage.delete("a.txt");
+    assert.equal(await storage.exists("a.txt"), false);
+});
+test("facade put denial throws AuthorizationError and persists nothing", async () => {
+    const storage = createStorage({
+        provider: "memory",
+        auth: makeAuth((ctx) => ctx.operation !== "write"),
+    });
+    await assert.rejects(() => storage.put("secret.txt", "top secret", { accessLevel: "private" }), (err) => err instanceof AuthorizationError && err.operation === "write");
+    // Nothing was written.
+    assert.equal(await storage.exists("secret.txt"), false);
+});
+test("facade get denial throws AuthorizationError and returns no bytes", async () => {
+    // The bridge permits the initial write but denies reads.
+    let allowRead = true;
+    const storage = createStorage({
+        provider: "memory",
+        auth: makeAuth((ctx) => (ctx.operation === "read" ? allowRead : true)),
+    });
+    await storage.put("doc.txt", "content", { accessLevel: "authenticated" });
+    allowRead = false;
+    await assert.rejects(() => storage.get("doc.txt"), (err) => err instanceof AuthorizationError && err.operation === "read");
+});
+test("facade get of a public object is permitted without authentication", async () => {
+    // The bridge permits the seeding write and any public read, but denies every
+    // non-public read. A public object must remain readable (Requirement 11.4).
+    const storage = createStorage({
+        provider: "memory",
+        auth: makeAuth((ctx) => ctx.operation === "write" || ctx.accessLevel === "public"),
+    });
+    await storage.put("pub.txt", "hello", { accessLevel: "public" });
+    const got = await storage.get("pub.txt");
+    assert.equal(got.found, true);
+    assert.equal(new TextDecoder().decode(got.bytes), "hello");
+});
+test("facade delete denial throws AuthorizationError and keeps the object", async () => {
+    let allowDelete = true;
+    const storage = createStorage({
+        provider: "memory",
+        auth: makeAuth((ctx) => (ctx.operation === "delete" ? allowDelete : true)),
+    });
+    await storage.put("keep.txt", "content", { accessLevel: "private" });
+    allowDelete = false;
+    await assert.rejects(() => storage.delete("keep.txt"), (err) => err instanceof AuthorizationError && err.operation === "delete");
+    assert.equal(await storage.exists("keep.txt"), true);
+});
+// ── Task 16.2: exhaustive per-level allow/deny + auth-bridge integration ─────
+//
+// The cases above prove the permissive default, the public-read allowance, and
+// a single deny path per level (write). The block below rounds out the access
+// decision matrix required by this task: an explicit ALLOW *and* an explicit
+// DENY for EACH access level, across read/write/delete, plus context-driven
+// role-based and tenant-aware decisions and an async bridge that permits.
+//
+// Requirements: 11.1, 11.3, 11.4
+const ALL_LEVELS = [
+    "public",
+    "private",
+    "signed",
+    "authenticated",
+    "role-based",
+    "tenant-aware",
+];
+const ALL_OPERATIONS = ["read", "write", "delete"];
+test("controller permits every access level across every operation when the bridge allows", async () => {
+    for (const accessLevel of ALL_LEVELS) {
+        for (const operation of ALL_OPERATIONS) {
+            const auth = makeAuth(true);
+            const access = new AccessController({ auth });
+            // Should resolve without throwing for allow (11.1).
+            await access.authorize({ key: `k/${accessLevel}`, operation, accessLevel });
+            // The bridge was consulted with the exact context (11.2 wiring).
+            assert.deepEqual(auth.calls.at(-1), {
+                key: `k/${accessLevel}`,
+                operation,
+                accessLevel,
+                owner: undefined,
+                tenant: undefined,
+            });
+        }
+    }
+});
+test("controller denies every access level across write/delete when the bridge blocks", async () => {
+    // Read is validated separately below because `public` reads have a distinct
+    // rule; here we cover the uniformly-denied write and delete operations for
+    // EACH level (11.3).
+    for (const accessLevel of ALL_LEVELS) {
+        for (const operation of ["write", "delete"]) {
+            const access = new AccessController({ auth: makeAuth(false) });
+            await assert.rejects(() => access.authorize({ key: "k", operation, accessLevel }), (err) => err instanceof AuthorizationError &&
+                err.accessLevel === accessLevel &&
+                err.operation === operation);
+        }
+    }
+});
+test("controller denies non-public reads for every restricted level when the bridge blocks", async () => {
+    // A `read` is denied for every NON-public level when the bridge returns false
+    // (public reads are covered by the dedicated 11.4 cases above).
+    for (const accessLevel of ALL_LEVELS.filter((l) => l !== "public")) {
+        const access = new AccessController({ auth: makeAuth(false) });
+        await assert.rejects(() => access.authorize({ key: "k", operation: "read", accessLevel }), (err) => err instanceof AuthorizationError && err.accessLevel === accessLevel);
+    }
+});
+test("signed access level allows and denies strictly per the bridge decision", async () => {
+    const allow = new AccessController({ auth: makeAuth(true) });
+    await allow.authorize({ key: "s", operation: "read", accessLevel: "signed" });
+    const deny = new AccessController({ auth: makeAuth(false) });
+    await assert.rejects(() => deny.authorize({ key: "s", operation: "read", accessLevel: "signed" }), (err) => err instanceof AuthorizationError && err.accessLevel === "signed");
+});
+test("authenticated access level allows and denies strictly per the bridge decision", async () => {
+    const allow = new AccessController({ auth: makeAuth(true) });
+    await allow.authorize({ key: "a", operation: "write", accessLevel: "authenticated" });
+    const deny = new AccessController({ auth: makeAuth(false) });
+    await assert.rejects(() => deny.authorize({ key: "a", operation: "write", accessLevel: "authenticated" }), (err) => err instanceof AuthorizationError && err.accessLevel === "authenticated");
+});
+test("role-based decisions key on the bridge's view of the context", async () => {
+    // A structural bridge modelling roles: only the owner "admin" may write a
+    // role-based object; everyone else is denied. This exercises the bridge
+    // integration for role-based access (11.1/11.2/11.3).
+    const roleBridge = makeAuth((ctx) => ctx.owner === "admin");
+    const access = new AccessController({ auth: roleBridge });
+    await access.authorize({
+        key: "r",
+        operation: "write",
+        accessLevel: "role-based",
+        owner: "admin",
+    });
+    await assert.rejects(() => access.authorize({
+        key: "r",
+        operation: "write",
+        accessLevel: "role-based",
+        owner: "guest",
+    }), (err) => err instanceof AuthorizationError && err.accessLevel === "role-based");
+});
+test("tenant-aware decisions isolate access to the matching tenant", async () => {
+    // A structural bridge modelling tenant isolation: access is granted only when
+    // the context tenant matches the bridge's expected tenant (11.1/11.2/11.3).
+    const expectedTenant = "acme";
+    const tenantBridge = makeAuth((ctx) => ctx.tenant === expectedTenant);
+    const access = new AccessController({ auth: tenantBridge });
+    await access.authorize({
+        key: "t",
+        operation: "read",
+        accessLevel: "tenant-aware",
+        tenant: "acme",
+    });
+    await assert.rejects(() => access.authorize({
+        key: "t",
+        operation: "read",
+        accessLevel: "tenant-aware",
+        tenant: "other-corp",
+    }), (err) => err instanceof AuthorizationError && err.accessLevel === "tenant-aware");
+});
+test("controller permits when an async bridge resolves true", async () => {
+    // Complements the existing async-deny case: an async bridge that resolves
+    // true must be awaited and permit the operation.
+    const access = new AccessController({ auth: makeAuth(async () => true) });
+    await access.authorize({ key: "k", operation: "write", accessLevel: "private" });
+});
+test("private access level allows and denies strictly per the bridge decision", async () => {
+    const allow = new AccessController({ auth: makeAuth(true) });
+    await allow.authorize({ key: "pv", operation: "delete", accessLevel: "private" });
+    const deny = new AccessController({ auth: makeAuth(false) });
+    await assert.rejects(() => deny.authorize({ key: "pv", operation: "delete", accessLevel: "private" }), (err) => err instanceof AuthorizationError && err.accessLevel === "private");
+});
+test("facade put of a role-based object is denied for a non-owner and persists nothing", async () => {
+    // End-to-end auth-bridge integration through the facade for a role-based
+    // level: a non-admin writer is denied and no object is persisted (11.3).
+    const storage = createStorage({
+        provider: "memory",
+        auth: makeAuth((ctx) => ctx.owner === "admin"),
+    });
+    await assert.rejects(() => storage.put("role.txt", "data", { accessLevel: "role-based", owner: "guest" }), (err) => err instanceof AuthorizationError && err.operation === "write");
+    assert.equal(await storage.exists("role.txt"), false);
+});
+//# sourceMappingURL=access.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,183 @@
+// Unit tests for the Azure Blob driver submodule (task 29.3). Azure Blob does
+// not speak the S3 wire shape, so this driver maps the StorageDriver contract
+// directly onto a structural AzureBlobClientLike (not the S3-style base). These
+// tests exercise the injected-client path with an in-memory AzureBlobClientLike
+// double (no `@azure/storage-blob` SDK, no external service), the
+// StorageConfigError guard when no client is injected, the lazy-SDK connect
+// path when the SDK is absent, and the shared driver contract-conformance suite.
+//
+// Requirements: 2.1, 2.3, 3.3
+import test from "node:test";
+import assert from "node:assert/strict";
+import { createAzureBlobDriver, connectAzureBlobDriver } from "../drivers/azure.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 AzureBlobClientLike double. */
+function makeFakeClient() {
+    const blobs = new Map(); // blobName -> { body, contentType, metadata }
+    return {
+        async upload({ blobName, body, contentType, metadata }) {
+            blobs.set(blobName, {
+                body: body.slice(),
+                contentType,
+                metadata: metadata ? { ...metadata } : undefined,
+            });
+            return { etag: `"${blobName}-etag"` };
+        },
+        async download({ blobName }) {
+            const blob = blobs.get(blobName);
+            if (blob === undefined)
+                return null;
+            return {
+                body: blob.body.slice(),
+                contentType: blob.contentType,
+                etag: `"${blobName}-etag"`,
+                contentLength: blob.body.byteLength,
+                lastModified: FIXED_NOW,
+                metadata: blob.metadata,
+            };
+        },
+        async getProperties({ blobName }) {
+            const blob = blobs.get(blobName);
+            if (blob === undefined)
+                return null;
+            return {
+                contentType: blob.contentType,
+                etag: `"${blobName}-etag"`,
+                contentLength: blob.body.byteLength,
+                lastModified: FIXED_NOW,
+                metadata: blob.metadata,
+            };
+        },
+        async deleteBlob({ blobName }) {
+            blobs.delete(blobName);
+        },
+        async exists({ blobName }) {
+            return blobs.has(blobName);
+        },
+        async listBlobs({ prefix }) {
+            return [...blobs.entries()]
+                .filter(([name]) => name.startsWith(prefix))
+                .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+                .map(([name, blob]) => ({
+                name,
+                contentLength: blob.body.byteLength,
+                lastModified: FIXED_NOW,
+            }));
+        },
+    };
+}
+function makeDriver() {
+    return createAzureBlobDriver(makeFakeClient(), { clock: fixedClock });
+}
+// ── name ──────────────────────────────────────────────────────────────────────
+test("driver name is azure", () => {
+    assert.equal(makeDriver().name, "azure");
+});
+// ── injected-client primitives round-trip ─────────────────────────────────────
+test("put/get round-trips bytes and typed metadata over the injected client", async () => {
+    const driver = makeDriver();
+    const content = bytes("azure blob payload");
+    await driver.put("container/key.txt", content, {
+        contentType: "text/plain",
+        owner: "user-7",
+        tenant: "tenant-q",
+        accessLevel: "public",
+        custom: { label: "report" },
+    });
+    const result = await driver.get("container/key.txt");
+    assert.equal(result.found, true);
+    assert.deepEqual(result.bytes, content);
+    assert.equal(result.metadata.contentType, "text/plain");
+    assert.equal(result.metadata.owner, "user-7");
+    assert.equal(result.metadata.tenant, "tenant-q");
+    assert.equal(result.metadata.accessLevel, "public");
+    assert.deepEqual(result.metadata.custom, { label: "report" });
+    assert.equal(result.metadata.size, content.byteLength);
+});
+test("exists/delete/stat/list behave consistently", async () => {
+    const driver = makeDriver();
+    await driver.put("d/a.txt", bytes("a"), {});
+    await driver.put("d/b.txt", bytes("bb"), {});
+    assert.equal(await driver.exists("d/a.txt"), true);
+    assert.equal(await driver.exists("d/missing.txt"), false);
+    const stat = await driver.stat("d/b.txt");
+    assert.ok(stat);
+    assert.equal(stat.size, 2);
+    assert.equal(await driver.stat("d/missing.txt"), null);
+    const items = await driver.list("d/");
+    assert.deepEqual(items.map((i) => i.key), ["d/a.txt", "d/b.txt"]);
+    await driver.delete("d/a.txt");
+    assert.equal(await driver.exists("d/a.txt"), false);
+});
+test("list honors the limit option", async () => {
+    const driver = makeDriver();
+    await driver.put("p/1.txt", bytes("1"), {});
+    await driver.put("p/2.txt", bytes("2"), {});
+    await driver.put("p/3.txt", bytes("3"), {});
+    const items = await driver.list("p/", { limit: 2 });
+    assert.deepEqual(items.map((i) => i.key), ["p/1.txt", "p/2.txt"]);
+});
+test("get on a missing key reports found:false", async () => {
+    const driver = makeDriver();
+    const result = await driver.get("nope");
+    assert.equal(result.found, false);
+});
+test("overwrite preserves createdAt and advances updatedAt semantics", async () => {
+    const driver = makeDriver();
+    const first = await driver.put("k.txt", bytes("one"), {});
+    const second = await driver.put("k.txt", bytes("two-longer"), {});
+    assert.equal(second.createdAt, first.createdAt);
+    assert.equal(second.size, bytes("two-longer").byteLength);
+});
+// ── streaming ───────────────────────────────────────────────────────────────
+test("putStream/getStream round-trips content", async () => {
+    const { Readable } = await import("node:stream");
+    const driver = makeDriver();
+    const content = bytes("streamed azure content");
+    await driver.putStream("s/obj.bin", Readable.from([Buffer.from(content)]), {});
+    const stream = await driver.getStream("s/obj.bin");
+    const chunks = [];
+    for await (const chunk of stream)
+        chunks.push(chunk);
+    assert.deepEqual(new Uint8Array(Buffer.concat(chunks)), content);
+});
+test("getStream throws on a missing key", async () => {
+    const driver = makeDriver();
+    await assert.rejects(() => driver.getStream("absent"));
+});
+// ── advanced capabilities left undefined for facade simulation ────────────────
+test("advanced capabilities are left undefined for facade simulation", () => {
+    const driver = makeDriver();
+    assert.equal(driver.multipart, undefined);
+    assert.equal(driver.resumable, undefined);
+    assert.equal(driver.versioning, undefined);
+    assert.equal(driver.signedUrl, undefined);
+    assert.equal(driver.lifecycle, undefined);
+});
+// ── configuration guards ──────────────────────────────────────────────────────
+test("createAzureBlobDriver throws StorageConfigError when no client is injected", () => {
+    assert.throws(() => createAzureBlobDriver(undefined), (err) => {
+        assert.ok(err instanceof StorageConfigError);
+        assert.equal(err.provider, "azure");
+        return true;
+    });
+});
+test("connectAzureBlobDriver throws StorageConfigError when the Azure SDK is absent", async () => {
+    await assert.rejects(() => connectAzureBlobDriver({
+        container: "c",
+        connectionString: "UseDevelopmentStorage=true",
+    }), (err) => {
+        assert.ok(err instanceof StorageConfigError);
+        assert.equal(err.provider, "azure");
+        return true;
+    });
+});
+// ── shared contract-conformance suite ─────────────────────────────────────────
+registerStorageDriverContractTests("azure", () => createAzureBlobDriver(makeFakeClient(), { clock: fixedClock }), test);
+//# sourceMappingURL=azure-driver.test.js.map

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

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

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

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

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

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