Reorganize repo structure and standards references

This commit is contained in:
david committed 2026-06-29 05:03:42 +02:00
1 parent 3cb93a81be
commit be2054274d
5885 files changed
+2588 -195

No files matched your search

@@ -0,0 +1,141 @@
import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
import { MemoryAdapter } from "./adapters/memory.js";
import { __resetMemoryWarningForTests, createSharedStore } from "./factory.js";
afterEach(() => {
vi.unstubAllEnvs();
__resetMemoryWarningForTests();
});
beforeEach(() => {
vi.unstubAllEnvs();
});
describe("createSharedStore — adapter selection", () => {
test("falls back to MemoryAdapter when REDIS_URL is unset and warns once", async () => {
vi.stubEnv("REDIS_URL", "");
const warn = vi.fn();
const store = createSharedStore({ namespace: "demo", logger: { warn } });
expect(store.adapter).toBeInstanceOf(MemoryAdapter);
expect(warn).toHaveBeenCalledTimes(1);
// A second store does not emit another warning.
createSharedStore({ namespace: "demo2", logger: { warn } });
expect(warn).toHaveBeenCalledTimes(1);
await store.close();
});
test("uses the provided adapter when one is supplied", async () => {
const adapter = new MemoryAdapter();
const store = createSharedStore({ namespace: "demo", adapter });
expect(store.adapter).toBe(adapter);
await store.close();
});
});
describe("createSharedStore — namespace and key validation", () => {
test("rejects an empty namespace", () => {
expect(() => createSharedStore({ namespace: "", adapter: new MemoryAdapter() })).toThrow(/namespace is required/);
});
test("rejects namespaces with forbidden characters", () => {
expect(() => createSharedStore({ namespace: "bad name", adapter: new MemoryAdapter() })).toThrow(/must match/);
});
test("rejects key suffixes containing pattern characters", async () => {
const store = createSharedStore({ namespace: "demo", adapter: new MemoryAdapter() });
await expect(store.set("key*1", "x")).rejects.toThrow(/forbidden pattern characters/);
await expect(store.get("")).rejects.toThrow(/must not be empty/);
await store.close();
});
test("rejects channels containing pattern characters", async () => {
const store = createSharedStore({ namespace: "demo", adapter: new MemoryAdapter() });
await expect(store.publish("ch*", "x")).rejects.toThrow(/forbidden characters/);
await store.close();
});
test("rejects ttlDefault <= 0", () => {
expect(() =>
createSharedStore({ namespace: "demo", adapter: new MemoryAdapter(), ttlDefault: 0 }),
).toThrow(/positive/);
});
});
describe("createSharedStore — namespace isolation", () => {
test("two stores on the same adapter cannot read each other's keys", async () => {
const adapter = new MemoryAdapter();
const a = createSharedStore({ namespace: "alpha", adapter });
const b = createSharedStore({ namespace: "beta", adapter });
await a.set("k", "from-alpha");
expect(await b.get("k")).toBeNull();
expect(await a.get("k")).toBe("from-alpha");
await a.close();
});
test("scan only returns keys inside the namespace", async () => {
const adapter = new MemoryAdapter();
const a = createSharedStore({ namespace: "alpha", adapter });
const b = createSharedStore({ namespace: "beta", adapter });
await a.set("k1", "1");
await a.set("k2", "2");
await b.set("k1", "x");
const seen: string[] = [];
for await (const key of a.scan("*")) {
seen.push(key);
}
expect(seen.sort()).toEqual(["shared-store:alpha:k1", "shared-store:alpha:k2"]);
await a.close();
});
test("pub/sub channels are namespace-scoped", async () => {
const adapter = new MemoryAdapter();
const a = createSharedStore({ namespace: "alpha", adapter });
const b = createSharedStore({ namespace: "beta", adapter });
const received: string[] = [];
await b.subscribe("invalidate", (msg) => {
received.push(msg);
});
expect(await a.publish("invalidate", "hi")).toBe(0);
await new Promise((resolve) => setTimeout(resolve, 5));
expect(received).toEqual([]);
await a.close();
});
});
describe("createSharedStore — ttlDefault", () => {
test("applies default ttl when set is called without one", async () => {
let now = 0;
const adapter = new MemoryAdapter({ now: () => now });
const store = createSharedStore({ namespace: "demo", adapter, ttlDefault: 5 });
await store.set("k", "v");
now = 10_000;
expect(await store.get("k")).toBeNull();
await store.close();
});
test("does not override an explicit ttl", async () => {
let now = 0;
const adapter = new MemoryAdapter({ now: () => now });
const store = createSharedStore({ namespace: "demo", adapter, ttlDefault: 1 });
await store.set("k", "v", { ttlSeconds: 60 });
now = 5_000;
expect(await store.get("k")).toBe("v");
await store.close();
});
});
describe("createSharedStore — adapter passthrough", () => {
test("incr, expire, del, sorted-set ops apply the namespace prefix", async () => {
const adapter = new MemoryAdapter();
const store = createSharedStore({ namespace: "demo", adapter });
expect(await store.incr("c")).toBe(1);
expect(await store.expire("c", 60)).toBe(true);
expect(await store.zAdd("z", 1, "a")).toBe(1);
expect(await store.zCard("z")).toBe(1);
expect(await store.zRemRangeByScore("z", 0, 1)).toBe(1);
expect(await store.del("c")).toBe(1);
expect(await store.mget(["c"])).toEqual([null]);
await store.close();
});
});