chore: initialize from frontend template 4dc033c

tests/unit/conditional-validator-store.test.ts

@@ -0,0 +1,66 @@
+import { describe, expect, it } from "vitest";
+
+import { createConditionalValidatorStore } from "../../src/adapters/query-cache/conditional-validator-store.ts";
+import { createRuntimeIdentityRegistry } from "../../src/contracts/query-keys.ts";
+
+function scope() {
+  let current = true;
+  const lifetime = new AbortController();
+  return {
+    snapshot: {
+      generation: 3,
+      fingerprint: "scope-token-00000003",
+      identities: createRuntimeIdentityRegistry({
+        tokenFactory: () => crypto.randomUUID(),
+      }),
+      signal: lifetime.signal,
+      isCurrent: () => current,
+    },
+    expire: () => {
+      current = false;
+      lifetime.abort();
+    },
+  };
+}
+
+describe("conditional validator CAS sidecar", () => {
+  it("accepts 304 only for the exact scope, representation and cache revision", () => {
+    const selectedScope = scope();
+    const binding = {
+      definitionId: "resource-detail-v1",
+      identityToken: "identity-token-00000001",
+      representationVersion: 1,
+      scope: selectedScope.snapshot,
+    };
+    const store = createConditionalValidatorStore();
+    expect(store.install(binding, '"etag-a"', 7)).toBe(true);
+    expect(store.prepare(binding, 7)).toBe('"etag-a"');
+    expect(store.acceptNotModified(binding, 7, true)).toBe(true);
+    expect(store.acceptNotModified(binding, 8, true)).toBe(false);
+    expect(store.acceptNotModified(binding, 7, false)).toBe(false);
+
+    selectedScope.expire();
+    expect(store.prepare(binding, 7)).toBeNull();
+    expect(store.acceptNotModified(binding, 7, true)).toBe(false);
+  });
+
+  it("rejects malformed validators and bounded-capacity overflow", () => {
+    const firstScope = scope();
+    const store = createConditionalValidatorStore(1);
+    const first = {
+      definitionId: "resource-detail-v1",
+      identityToken: "identity-token-00000001",
+      representationVersion: 1,
+      scope: firstScope.snapshot,
+    };
+    expect(store.install(first, "raw-etag", 1)).toBe(false);
+    expect(store.install(first, 'W/"etag-a"', 1)).toBe(true);
+    expect(
+      store.install(
+        { ...first, identityToken: "identity-token-00000002" },
+        '"etag-b"',
+        1,
+      ),
+    ).toBe(false);
+  });
+});