@guuey/state 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * `@guuey/state` — open-source KV client for MCP servers
+ * hosted on guuey.com.
+ *
+ * Scope: every operation runs inside one `(userId, mcpId)` namespace.
+ * The MCP server holds no data of its own; data ownership stays
+ * with the user (export + delete in the guuey console).
+ *
+ * Two import shapes:
+ *
+ * **Explicit** (test-friendly, no AsyncLocalStorage):
+ * ```ts
+ * import { createGuueyState } from '@guuey/state';
+ *
+ * const kv = createGuueyState({
+ *   context: { userId: 'u_abc', mcpId: 'mcp_xyz' },
+ * });
+ * await kv.set('hello', 'world', { ttl: 60 });
+ * ```
+ *
+ * **Implicit via middleware** (production MCP servers):
+ * ```ts
+ * import { withGuueyContext } from '@guuey/state/context';
+ * import { kv } from '@guuey/state';
+ *
+ * // Inside your tool handler, the surrounding middleware has set
+ * // the AsyncLocalStorage context from the request headers.
+ * await kv.set('hello', 'world', { ttl: 60 });
+ * ```
+ *
+ * The hard caps + design rationale live in
+ * `docs/principles/mcp-hosting-policy.md`.
+ */
+import type { CreateGuueyStateOptions, Kv } from "./types.js";
+export type { CreateGuueyStateOptions, IncrementOptions, KeysPage, Kv, ScopeContext, ScopeInfo, SetOptions, } from "./types.js";
+export { GuueyStateError, InvalidArgumentError, InvalidContextError, InvalidKeyError, InvalidTtlError, MissingContextError, QuotaExceededError, TransportError, TypeMismatchError, ValueTooLargeError, } from "./errors.js";
+export { withGuueyContext, getCurrentContext, mcpIdFromResourceUrl, scopeFromAuthorization, validateContext, } from "./context.js";
+export { HttpKv } from "./http.js";
+/**
+ * Create a KV instance bound to the given scope context.
+ *
+ * Binding selection:
+ *
+ *   1. `options.bindingUrl` or `GUUEY_KV_URL` env → the hosted HTTP
+ *      binding (`HttpKv`). Requires a token — `options.authToken`,
+ *      `GUUEY_KV_TOKEN` env, or `context.token` (from
+ *      `scopeFromAuthorization`), checked in that order — or this
+ *      throws `InvalidContextError` rather than silently handing back
+ *      a non-durable in-memory store to a caller who explicitly asked
+ *      for the hosted one (data would vanish on pod restart with zero
+ *      signal).
+ *   2. Otherwise → in-memory binding with a one-time warning.
+ *      Suitable for tests and `guuey dev` runs.
+ */
+export declare function createGuueyState(opts: CreateGuueyStateOptions): Kv;
+/**
+ * Convenience: the barrel-exported `kv` reads the current scope
+ * context from AsyncLocalStorage on every call. Use this when
+ * your MCP server framework has installed `withGuueyContext` as
+ * middleware.
+ *
+ * Throws `MissingContextError` if called outside a context.
+ */
+export declare const kv: Kv;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAMH,OAAO,KAAK,EACV,uBAAuB,EACvB,EAAE,EAEH,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,uBAAuB,EACvB,gBAAgB,EAChB,QAAQ,EACR,EAAE,EACF,YAAY,EACZ,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,EAAE,CAclE;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,EAAE,EAAE,EAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,106 @@
+/**
+ * `@guuey/state` — open-source KV client for MCP servers
+ * hosted on guuey.com.
+ *
+ * Scope: every operation runs inside one `(userId, mcpId)` namespace.
+ * The MCP server holds no data of its own; data ownership stays
+ * with the user (export + delete in the guuey console).
+ *
+ * Two import shapes:
+ *
+ * **Explicit** (test-friendly, no AsyncLocalStorage):
+ * ```ts
+ * import { createGuueyState } from '@guuey/state';
+ *
+ * const kv = createGuueyState({
+ *   context: { userId: 'u_abc', mcpId: 'mcp_xyz' },
+ * });
+ * await kv.set('hello', 'world', { ttl: 60 });
+ * ```
+ *
+ * **Implicit via middleware** (production MCP servers):
+ * ```ts
+ * import { withGuueyContext } from '@guuey/state/context';
+ * import { kv } from '@guuey/state';
+ *
+ * // Inside your tool handler, the surrounding middleware has set
+ * // the AsyncLocalStorage context from the request headers.
+ * await kv.set('hello', 'world', { ttl: 60 });
+ * ```
+ *
+ * The hard caps + design rationale live in
+ * `docs/principles/mcp-hosting-policy.md`.
+ */
+import { getCurrentContext, validateContext } from "./context.js";
+import { InvalidContextError, MissingContextError } from "./errors.js";
+import { HttpKv } from "./http.js";
+import { InMemoryKv } from "./in-memory.js";
+export { GuueyStateError, InvalidArgumentError, InvalidContextError, InvalidKeyError, InvalidTtlError, MissingContextError, QuotaExceededError, TransportError, TypeMismatchError, ValueTooLargeError, } from "./errors.js";
+export { withGuueyContext, getCurrentContext, mcpIdFromResourceUrl, scopeFromAuthorization, validateContext, } from "./context.js";
+export { HttpKv } from "./http.js";
+/**
+ * Create a KV instance bound to the given scope context.
+ *
+ * Binding selection:
+ *
+ *   1. `options.bindingUrl` or `GUUEY_KV_URL` env → the hosted HTTP
+ *      binding (`HttpKv`). Requires a token — `options.authToken`,
+ *      `GUUEY_KV_TOKEN` env, or `context.token` (from
+ *      `scopeFromAuthorization`), checked in that order — or this
+ *      throws `InvalidContextError` rather than silently handing back
+ *      a non-durable in-memory store to a caller who explicitly asked
+ *      for the hosted one (data would vanish on pod restart with zero
+ *      signal).
+ *   2. Otherwise → in-memory binding with a one-time warning.
+ *      Suitable for tests and `guuey dev` runs.
+ */
+export function createGuueyState(opts) {
+    validateContext(opts.context);
+    const bindingUrl = opts.bindingUrl ?? process.env.GUUEY_KV_URL;
+    if (bindingUrl) {
+        const token = opts.authToken ?? process.env.GUUEY_KV_TOKEN ?? opts.context.token;
+        if (!token) {
+            throw new InvalidContextError("token", "hosted binding requires a token: pass context from scopeFromAuthorization(header), or set authToken/GUUEY_KV_TOKEN");
+        }
+        return new HttpKv(bindingUrl, opts.context, token);
+    }
+    return new InMemoryKv(opts.context);
+}
+/**
+ * Convenience: the barrel-exported `kv` reads the current scope
+ * context from AsyncLocalStorage on every call. Use this when
+ * your MCP server framework has installed `withGuueyContext` as
+ * middleware.
+ *
+ * Throws `MissingContextError` if called outside a context.
+ */
+export const kv = makeAlsKv();
+function makeAlsKv() {
+    // Each method wraps `bind()` in an async IIFE so a missing-context
+    // throw surfaces as a rejected Promise (matching the async return
+    // type) instead of a synchronous throw at the call site. The
+    // in-memory binding's underlying store is module-level shared, so
+    // a fresh binding per call still sees the same data.
+    const withBinding = async (fn) => {
+        const ctx = currentContextOrThrow();
+        return fn(createGuueyState({ context: ctx }));
+    };
+    return {
+        get: (key) => withBinding((kv) => kv.get(key)),
+        set: (key, value, opts) => withBinding((kv) => kv.set(key, value, opts)),
+        delete: (key) => withBinding((kv) => kv.delete(key)),
+        has: (key) => withBinding((kv) => kv.has(key)),
+        keys: (opts) => withBinding((kv) => kv.keys(opts)),
+        increment: (key, opts) => withBinding((kv) => kv.increment(key, opts)),
+        decrement: (key, opts) => withBinding((kv) => kv.decrement(key, opts)),
+        mget: (keys) => withBinding((kv) => kv.mget(keys)),
+        scope: () => withBinding((kv) => kv.scope()),
+    };
+}
+function currentContextOrThrow() {
+    const ctx = getCurrentContext();
+    if (!ctx)
+        throw new MissingContextError();
+    return ctx;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/testing/contract-suite.d.ts

@@ -0,0 +1,11 @@
+import type { Kv, ScopeContext } from "../types.js";
+export interface KvHarness {
+    kv: Kv;
+    /** Advance logical time by ms (in-memory: vi timers; stub-DDB: clock var). */
+    advance?: (ms: number) => void | Promise<void>;
+    /** A second (or third) `Kv` bound to an alternate scope context — for isolation tests. */
+    makeScoped: (ctx: ScopeContext) => Promise<Kv>;
+    cleanup?: () => void | Promise<void>;
+}
+export declare function runKvContractSuite(name: string, makeKv: () => Promise<KvHarness>): void;
+//# sourceMappingURL=contract-suite.d.ts.map

package/dist/testing/contract-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-suite.d.ts","sourceRoot":"","sources":["../../src/testing/contract-suite.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,EAAE,EAAE,YAAY,EAAc,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,EAAE,CAAC;IACP,8EAA8E;IAC9E,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,0FAA0F;IAC1F,UAAU,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AA6BD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,GAC/B,IAAI,CAkWN"}

package/dist/testing/contract-suite.js

@@ -0,0 +1,315 @@
+/**
+ * Binding-agnostic behavioral contract for `Kv`. Every binding
+ * (in-memory today, the hosted HTTP/DDB binding later) runs this
+ * SAME suite so "works on in-memory" and "works on the real thing"
+ * mean the same set of guarantees.
+ *
+ * Time control: the suite must not assume `vi.useFakeTimers` works
+ * against a remote store, so TTL-expiry cases take an optional
+ * `advance` hook off the harness. Bindings that can't warp time
+ * (live DDB) omit it and the suite SKIPS those cases rather than
+ * faking a pass.
+ */
+import { describe, expect, it } from "vitest";
+import { InvalidArgumentError, InvalidKeyError, InvalidTtlError, QuotaExceededError, TypeMismatchError, ValueTooLargeError, } from "../errors.js";
+/** Scope context used by tests that assert exact `scope()` field values. */
+const CTX = { userId: "u_test", mcpId: "mcp_test" };
+async function withHarness(makeKv, fn) {
+    const harness = await makeKv();
+    try {
+        return await fn(harness);
+    }
+    finally {
+        await harness.cleanup?.();
+    }
+}
+export function runKvContractSuite(name, makeKv) {
+    describe(`Kv contract — ${name}`, () => {
+        describe("basic operations", () => {
+            it("set + get round-trips a JSON-serializable value", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    await kv.set("hello", { value: 1 }, { ttl: 60 });
+                    expect(await kv.get("hello")).toEqual({
+                        value: 1,
+                    });
+                });
+            });
+            it("get returns undefined for absent keys", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    expect(await kv.get("nope")).toBeUndefined();
+                });
+            });
+            it("delete is a no-op for absent keys", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    await expect(kv.delete("nope")).resolves.toBeUndefined();
+                });
+            });
+            it("has reports existence correctly", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    expect(await kv.has("a")).toBe(false);
+                    await kv.set("a", 1, { ttl: 60 });
+                    expect(await kv.has("a")).toBe(true);
+                    await kv.delete("a");
+                    expect(await kv.has("a")).toBe(false);
+                });
+            });
+            it("keys returns the scope's keys, optionally prefix-filtered", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    await kv.set("user:1", "a", { ttl: 60 });
+                    await kv.set("user:2", "b", { ttl: 60 });
+                    await kv.set("post:1", "c", { ttl: 60 });
+                    const all = await kv.keys();
+                    expect(all.keys).toEqual(expect.arrayContaining(["user:1", "user:2", "post:1"]));
+                    expect(all.cursor).toBeUndefined();
+                    expect((await kv.keys({ prefix: "user:" })).keys).toEqual([
+                        "user:1",
+                        "user:2",
+                    ]);
+                });
+            });
+            it("keys paginates lexicographically via cursor", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    for (const k of ["e", "c", "a", "d", "b"]) {
+                        await kv.set(`p:${k}`, 1, { ttl: 60 });
+                    }
+                    const page1 = await kv.keys({ prefix: "p:", limit: 2 });
+                    expect(page1.keys).toEqual(["p:a", "p:b"]);
+                    expect(page1.cursor).toBe("p:b");
+                    const page2 = await kv.keys({
+                        prefix: "p:",
+                        limit: 2,
+                        ...(page1.cursor !== undefined ? { cursor: page1.cursor } : {}),
+                    });
+                    expect(page2.keys).toEqual(["p:c", "p:d"]);
+                    const page3 = await kv.keys({
+                        prefix: "p:",
+                        limit: 2,
+                        ...(page2.cursor !== undefined ? { cursor: page2.cursor } : {}),
+                    });
+                    expect(page3.keys).toEqual(["p:e"]);
+                    expect(page3.cursor).toBeUndefined();
+                });
+            });
+            it("increment + decrement are atomic on number-typed keys", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    expect(await kv.increment("counter", { ttl: 60 })).toBe(1);
+                    expect(await kv.increment("counter", { by: 5, ttl: 60 })).toBe(6);
+                    expect(await kv.decrement("counter", { ttl: 60 })).toBe(5);
+                });
+            });
+            it("scope() returns live usage", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = await harness.makeScoped(CTX);
+                    const before = await kv.scope();
+                    expect(before.usedBytes).toBe(0);
+                    await kv.set("x", "hello", { ttl: 60 });
+                    const after = await kv.scope();
+                    expect(after.usedBytes).toBeGreaterThan(before.usedBytes);
+                    expect(after.keyCount).toBe(1);
+                    expect(after.userId).toBe(CTX.userId);
+                    expect(after.mcpId).toBe(CTX.mcpId);
+                });
+            });
+            it("scopes data per (userId, mcpId) — separate scopes don't see each other", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const a = await harness.makeScoped({
+                        userId: "u_a",
+                        mcpId: "mcp_test",
+                    });
+                    const b = await harness.makeScoped({
+                        userId: "u_b",
+                        mcpId: "mcp_test",
+                    });
+                    await a.set("shared", "from-a", { ttl: 60 });
+                    expect(await b.get("shared")).toBeUndefined();
+                });
+            });
+            it("scope keys cannot collide across (userId, mcpId) splits", async () => {
+                // With a printable delimiter, {"a b","c"} and {"a","b c"} could
+                // alias. Verify adjacent-looking ids stay isolated regardless
+                // of how the binding forms its internal scope key.
+                await withHarness(makeKv, async (harness) => {
+                    const a = await harness.makeScoped({ userId: "a", mcpId: "b_c" });
+                    const b = await harness.makeScoped({ userId: "a_b", mcpId: "c" });
+                    await a.set("k", "from-a", { ttl: 60 });
+                    expect(await b.get("k")).toBeUndefined();
+                });
+            });
+        });
+        describe("validation", () => {
+            it("rejects an invalid key (empty)", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    await expect(kv.set("", 1, { ttl: 60 })).rejects.toBeInstanceOf(InvalidKeyError);
+                });
+            });
+            it("rejects an invalid key (illegal char)", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    await expect(kv.set("key with space", 1, { ttl: 60 })).rejects.toBeInstanceOf(InvalidKeyError);
+                });
+            });
+            it("rejects a missing TTL", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    // Untyped-caller simulation — see KvWithLooseSetOptions.
+                    const kv = harness.kv;
+                    await expect(kv.set("a", 1, {})).rejects.toBeInstanceOf(InvalidTtlError);
+                });
+            });
+            it("rejects a TTL over 90 days", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    const ninetyOneDays = 60 * 60 * 24 * 91;
+                    await expect(kv.set("a", 1, { ttl: ninetyOneDays })).rejects.toBeInstanceOf(InvalidTtlError);
+                });
+            });
+            it("rejects a value over 64 KiB", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    const huge = "x".repeat(65 * 1024);
+                    await expect(kv.set("a", huge, { ttl: 60 })).rejects.toBeInstanceOf(ValueTooLargeError);
+                });
+            });
+        });
+        describe("TTL expiry", () => {
+            it("returns undefined after the TTL elapses", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    if (!harness.advance)
+                        return;
+                    const kv = harness.kv;
+                    await kv.set("ephemeral", "hi", { ttl: 30 });
+                    expect(await kv.get("ephemeral")).toBe("hi");
+                    await harness.advance(31_000);
+                    expect(await kv.get("ephemeral")).toBeUndefined();
+                });
+            });
+        });
+        describe("error envelope", () => {
+            it("EVERY failable operation throws a GuueyStateError subclass — no bare TypeError/RangeError", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    // increment on a non-number key
+                    await kv.set("json-key", { a: 1 }, { ttl: 60 });
+                    await expect(kv.increment("json-key", { ttl: 60 })).rejects.toBeInstanceOf(TypeMismatchError);
+                    // keys() limit out of range / non-integer
+                    await expect(kv.keys({ limit: 0 })).rejects.toBeInstanceOf(InvalidArgumentError);
+                    await expect(kv.keys({ limit: 1001 })).rejects.toBeInstanceOf(InvalidArgumentError);
+                    await expect(kv.keys({ limit: 2.5 })).rejects.toBeInstanceOf(InvalidArgumentError);
+                    // mget over the batch cap
+                    const tooMany = Array.from({ length: 101 }, (_, i) => `k:${i}`);
+                    await expect(kv.mget(tooMany)).rejects.toBeInstanceOf(InvalidArgumentError);
+                    // non-integer counter step
+                    await expect(kv.increment("counter", { ttl: 60, by: 0.5 })).rejects.toBeInstanceOf(InvalidArgumentError);
+                    // non-JSON-serializable values (stringify returns undefined)
+                    await expect(kv.set("u", undefined, { ttl: 60 })).rejects.toBeInstanceOf(InvalidArgumentError);
+                    await expect(kv.set("f", () => "nope", { ttl: 60 })).rejects.toBeInstanceOf(InvalidArgumentError);
+                    const circular = {};
+                    circular.self = circular;
+                    await expect(kv.set("c", circular, { ttl: 60 })).rejects.toBeInstanceOf(InvalidArgumentError);
+                    await expect(kv.set("b", 10n, { ttl: 60 })).rejects.toBeInstanceOf(InvalidArgumentError);
+                });
+            });
+        });
+        describe("mget prototype safety", () => {
+            it('a key literally named "__proto__" round-trips through mget', async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    await kv.set("__proto__", { isAdmin: true }, { ttl: 60 });
+                    await kv.set("normal", "ok", { ttl: 60 });
+                    const out = await kv.mget(["__proto__", "normal"]);
+                    // The entry must exist as an OWN property with the stored value…
+                    expect(Object.prototype.hasOwnProperty.call(out, "__proto__")).toBe(true);
+                    expect(out["__proto__"]).toEqual({ isAdmin: true });
+                    expect(out["normal"]).toBe("ok");
+                    // …and must NOT have replaced the result object's prototype.
+                    expect(out.isAdmin).toBeUndefined();
+                });
+            });
+        });
+        describe("byte accounting", () => {
+            it("counts UTF-8 bytes of key + value, not UTF-16 code units", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    // "🎉" is 2 UTF-16 units but 4 UTF-8 bytes.
+                    const emoji = "🎉".repeat(1000);
+                    await kv.set("emoji", emoji, { ttl: 60 });
+                    const info = await kv.scope();
+                    // 5 key bytes + 2 JSON quote bytes + 4000 emoji bytes.
+                    expect(info.usedBytes).toBe(5 + 2 + 4000);
+                });
+            });
+            it("key bytes count toward the scope quota (long keys can't dodge the cap)", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    // 1023-byte keys with 1-byte values: value bytes alone would say
+                    // "nearly empty"; key-inclusive accounting fills the 1 MiB cap
+                    // after ~1024 keys.
+                    const longKey = (i) => `k${String(i).padStart(4, "0")}`.padEnd(1023, "x");
+                    let threw;
+                    for (let i = 0; i < 1100; i++) {
+                        try {
+                            await kv.set(longKey(i), 1, { ttl: 60 });
+                        }
+                        catch (err) {
+                            threw = err;
+                            break;
+                        }
+                    }
+                    expect(threw).toBeInstanceOf(QuotaExceededError);
+                    const info = await kv.scope();
+                    expect(info.usedBytes).toBeLessThanOrEqual(1024 * 1024);
+                    expect(info.usedBytes).toBeGreaterThan(1024 * 1000);
+                });
+            });
+            it("rejects a value whose UTF-8 size exceeds the cap even when .length does not", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    // 17k emoji = 34k UTF-16 units (under 64 KiB as .length) but
+                    // 68 KB UTF-8 (over the cap).
+                    const sneaky = "🎉".repeat(17 * 1024);
+                    await expect(kv.set("sneaky", sneaky, { ttl: 60 })).rejects.toBeInstanceOf(ValueTooLargeError);
+                });
+            });
+        });
+        describe("audit regressions (2026-07-20)", () => {
+            it("concurrent increments never lose updates (sync read-modify-write)", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    const kv = harness.kv;
+                    // Pre-fix, get-then-set across await points let all of these read
+                    // the same base and collapse to 1.
+                    const results = await Promise.all(Array.from({ length: 25 }, () => kv.increment("counter", { ttl: 60 })));
+                    expect(await kv.get("counter")).toBe(25);
+                    // Every intermediate value observed exactly once.
+                    expect([...results].sort((a, b) => a - b)).toEqual(Array.from({ length: 25 }, (_, i) => i + 1));
+                });
+            });
+            it("expired keys stop counting toward the scope quota", async () => {
+                await withHarness(makeKv, async (harness) => {
+                    if (!harness.advance)
+                        return;
+                    const kv = harness.kv;
+                    // ~896 KiB of payload under a 1 MiB scope cap, with a 1s TTL.
+                    const big = "x".repeat(63 * 1024);
+                    for (let i = 0; i < 14; i++) {
+                        await kv.set(`dead:${i}`, big, { ttl: 1 });
+                    }
+                    await harness.advance(2_000); // everything above is now expired
+                    // Pre-fix this threw QuotaExceededError: expired corpses still
+                    // summed into usedBytes.
+                    await kv.set("fresh", big, { ttl: 60 });
+                    expect(await kv.get("fresh")).toBe(big);
+                    const info = await kv.scope();
+                    expect(info.usedBytes).toBeLessThan(70 * 1024);
+                });
+            });
+        });
+    });
+}
+//# sourceMappingURL=contract-suite.js.map

package/dist/testing/contract-suite.js.map

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