@guuey/state 0.1.0

package/dist/errors.js

@@ -0,0 +1,144 @@
+/**
+ * Typed error hierarchy for `@guuey/state`. Every operation that
+ * can fail throws a subclass of `GuueyStateError`, so call sites
+ * can `instanceof`-discriminate without parsing message strings.
+ */
+export class GuueyStateError extends Error {
+    /** Stable, machine-readable error code. */
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = "GuueyStateError";
+        this.code = code;
+    }
+}
+/**
+ * The scope is at or above its byte limit. Thrown by `set` and
+ * `increment` when the write would push usage past the cap.
+ * Includes the live `usedBytes` + `limitBytes` so the caller can
+ * surface a meaningful error to the user.
+ */
+export class QuotaExceededError extends GuueyStateError {
+    usedBytes;
+    limitBytes;
+    constructor(usedBytes, limitBytes) {
+        super("QUOTA_EXCEEDED", `Scope used ${usedBytes}B of ${limitBytes}B limit. ` +
+            `Delete keys or move long-lived data to user-owned storage ` +
+            `(mcp-proxy + their Notion/Drive/S3) — see guuey MCP Hosting Policy.`);
+        this.name = "QuotaExceededError";
+        this.usedBytes = usedBytes;
+        this.limitBytes = limitBytes;
+    }
+}
+/**
+ * A single value exceeds the per-value cap. Today: 64 KiB.
+ * Large blobs belong in `@guuey/files` (planned), not in KV.
+ */
+export class ValueTooLargeError extends GuueyStateError {
+    valueBytes;
+    limitBytes;
+    constructor(valueBytes, limitBytes) {
+        super("VALUE_TOO_LARGE", `Value is ${valueBytes}B; max is ${limitBytes}B per key. ` +
+            `Split the value, or use @guuey/files when it ships.`);
+        this.name = "ValueTooLargeError";
+        this.valueBytes = valueBytes;
+        this.limitBytes = limitBytes;
+    }
+}
+/**
+ * Key string is too long or contains a forbidden character. Today:
+ * 1 KiB max length; ASCII letters, digits, and `_.:-/` only
+ * (the standard "URL-safe-ish" set). Keeps keys cheap to log + index.
+ */
+export class InvalidKeyError extends GuueyStateError {
+    key;
+    constructor(key, reason) {
+        const shown = key.length > 64 ? `${JSON.stringify(key.slice(0, 64))}…` : JSON.stringify(key);
+        super("INVALID_KEY", `Invalid key ${shown}: ${reason}`);
+        this.name = "InvalidKeyError";
+        this.key = key;
+    }
+}
+/**
+ * TTL is missing, zero, negative, or above the 90-day cap.
+ */
+export class InvalidTtlError extends GuueyStateError {
+    ttl;
+    constructor(ttl, reason) {
+        super("INVALID_TTL", `Invalid TTL ${JSON.stringify(ttl)}: ${reason}`);
+        this.name = "InvalidTtlError";
+        this.ttl = ttl;
+    }
+}
+/**
+ * The library was called without a `ScopeContext` — either no
+ * `createGuueyState({ context })` AND no surrounding
+ * `withGuueyContext(...)` block. Common in unit tests that import
+ * `kv` from the barrel without setting up context.
+ */
+export class MissingContextError extends GuueyStateError {
+    constructor() {
+        super("MISSING_CONTEXT", `@guuey/state was called without a scope context. ` +
+            `Either pass { context } to createGuueyState, or wrap the call ` +
+            `in withGuueyContext({ userId, mcpId }, async () => { ... }).`);
+        this.name = "MissingContextError";
+    }
+}
+/**
+ * `increment`/`decrement` was called on a key whose stored value is
+ * not a number. Counter ops require number-typed keys; mixing a
+ * counter and a JSON value under one key is a calling-code bug.
+ */
+export class TypeMismatchError extends GuueyStateError {
+    key;
+    actualType;
+    constructor(key, actualType) {
+        super("TYPE_MISMATCH", `Key ${JSON.stringify(key)} holds a ${actualType} value; ` +
+            `increment/decrement require number-typed keys.`);
+        this.name = "TypeMismatchError";
+        this.key = key;
+        this.actualType = actualType;
+    }
+}
+/**
+ * A per-call argument is unusable — a `keys()` limit outside
+ * 1..1000, an `mget` batch over 100 keys, a non-integer counter
+ * step, or a value that isn't JSON-serializable (top-level
+ * `undefined`/function/symbol, `BigInt`, circular structure).
+ * Distinct from `InvalidKeyError`/`InvalidTtlError`, which cover the
+ * key and TTL contracts specifically.
+ */
+export class InvalidArgumentError extends GuueyStateError {
+    constructor(reason) {
+        super("INVALID_ARGUMENT", `Invalid argument: ${reason}`);
+        this.name = "InvalidArgumentError";
+    }
+}
+/**
+ * A `ScopeContext` field is unusable — an id that is empty or contains
+ * whitespace/control characters, or a missing `token` when the hosted
+ * binding was explicitly requested. Scope ids are platform-issued
+ * opaque identifiers (Cognito subs, app ids); anything with
+ * whitespace in it is a wiring bug at the call site, and the
+ * storage layer refuses it rather than risking scope ambiguity.
+ */
+export class InvalidContextError extends GuueyStateError {
+    field;
+    constructor(field, reason) {
+        super("INVALID_CONTEXT", `Invalid ScopeContext.${field}: ${reason}`);
+        this.name = "InvalidContextError";
+        this.field = field;
+    }
+}
+/**
+ * The KV binding's transport call failed (HTTP 5xx, network blip,
+ * timeout). Includes the underlying cause for diagnostics. The
+ * caller may safely retry idempotent reads.
+ */
+export class TransportError extends GuueyStateError {
+    constructor(message, cause) {
+        super("TRANSPORT", message, cause !== undefined ? { cause } : undefined);
+        this.name = "TransportError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,30 @@
+import type { IncrementOptions, KeysPage, Kv, ScopeContext, ScopeInfo, SetOptions } from "./types.js";
+export declare class HttpKv implements Kv {
+    private readonly baseUrl;
+    private readonly context;
+    private readonly authToken;
+    private readonly fetchImpl;
+    constructor(baseUrl: string, context: ScopeContext, authToken: string, fetchImpl?: typeof fetch);
+    get<T = unknown>(key: string): Promise<T | undefined>;
+    set<T = unknown>(key: string, value: T, opts: SetOptions): Promise<void>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+    keys(opts?: {
+        prefix?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<KeysPage>;
+    increment(key: string, opts: IncrementOptions): Promise<number>;
+    decrement(key: string, opts: IncrementOptions): Promise<number>;
+    mget<T = unknown>(keys: string[]): Promise<Record<string, T | undefined>>;
+    scope(): Promise<ScopeInfo>;
+    /**
+     * One shared retry budget (`retried`) covers BOTH retry triggers —
+     * a network failure and a 5xx response — so a retryable op makes
+     * at most 2 total requests, never 3. (A network failure on attempt
+     * 1 followed by a 5xx on attempt 2 must throw immediately, not
+     * spend a third attempt the budget doesn't have.)
+     */
+    private call;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EACV,gBAAgB,EAChB,QAAQ,EACR,EAAE,EACF,YAAY,EACZ,SAAS,EACT,UAAU,EACX,MAAM,YAAY,CAAC;AAiEpB,qBAAa,MAAO,YAAW,EAAE;IAE7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAHT,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,OAAO,KAAa;IAG5C,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAKrD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlC,IAAI,CAAC,IAAI,CAAC,EAAE;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQf,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAM/D,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAM/D,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC;IAKzE,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC;IAMjC;;;;;;OAMG;YACW,IAAI;CAsCnB"}

package/dist/http.js

@@ -0,0 +1,161 @@
+/**
+ * Hosted HTTP binding — talks to the guuey KV API over
+ * `POST <base>/v1/state/<op>`.
+ *
+ * Wire protocol (server side lands in a later slice):
+ * - Request: JSON body `{ context: { userId, mcpId }, args: {...} }`,
+ *   header `Authorization: Bearer <token>`.
+ * - Success: `200 { result }`.
+ * - Failure: `4xx/5xx { code, message, ...fields }` — `code` maps
+ *   1:1 onto this package's typed error classes (see `toTypedError`).
+ *
+ * Retry policy: reads (`get`/`has`/`keys`/`mget`/`scope`) are
+ * idempotent and retried once — on a network failure, or on a 5xx
+ * response. Writes (`set`/`delete`/`increment`/`decrement`) are
+ * NEVER retried automatically: a network failure after the server
+ * applied the write would make a blind retry double-apply it (worst
+ * case for `increment`/`decrement`, which are not naturally
+ * idempotent).
+ */
+import { InvalidArgumentError, InvalidContextError, InvalidKeyError, InvalidTtlError, MissingContextError, QuotaExceededError, TransportError, TypeMismatchError, ValueTooLargeError, } from "./errors.js";
+import { VALUE_LIMIT_BYTES, encodeValue, validateKey, validateTtl } from "./validate.js";
+/**
+ * Map a non-ok `Response` to the exact typed error the caller should
+ * see. `401`/`403` (auth-layer rejection, not a KV-level error) and
+ * any code this client doesn't recognize both fall back to
+ * `TransportError` — better an honest "the transport failed" than a
+ * misleading typed error built from fields that may not exist.
+ */
+async function toTypedError(res) {
+    let body;
+    try {
+        body = (await res.json());
+    }
+    catch {
+        body = {};
+    }
+    const message = body.message ?? `guuey state API error (HTTP ${res.status})`;
+    if (res.status === 401 || res.status === 403) {
+        return new TransportError(`${message} (HTTP ${res.status})`);
+    }
+    switch (body.code) {
+        case "QUOTA_EXCEEDED":
+            return new QuotaExceededError(body.usedBytes ?? 0, body.limitBytes ?? 0);
+        case "VALUE_TOO_LARGE":
+            return new ValueTooLargeError(body.valueBytes ?? 0, body.limitBytes ?? 0);
+        case "INVALID_KEY":
+            return new InvalidKeyError(body.key ?? "", body.reason ?? message);
+        case "INVALID_TTL":
+            return new InvalidTtlError(body.ttl, body.reason ?? message);
+        case "TYPE_MISMATCH":
+            return new TypeMismatchError(body.key ?? "", body.actualType ?? "unknown");
+        case "INVALID_ARGUMENT":
+            return new InvalidArgumentError(body.reason ?? message);
+        case "INVALID_CONTEXT":
+            return new InvalidContextError(body.field === "mcpId" ? "mcpId" : "userId", body.reason ?? message);
+        case "MISSING_CONTEXT":
+            return new MissingContextError();
+        default:
+            return new TransportError(`${message} (HTTP ${res.status})`);
+    }
+}
+export class HttpKv {
+    baseUrl;
+    context;
+    authToken;
+    fetchImpl;
+    constructor(baseUrl, context, authToken, fetchImpl = fetch) {
+        this.baseUrl = baseUrl;
+        this.context = context;
+        this.authToken = authToken;
+        this.fetchImpl = fetchImpl;
+    }
+    async get(key) {
+        validateKey(key);
+        return this.call("get", { key }, true);
+    }
+    async set(key, value, opts) {
+        validateKey(key);
+        validateTtl(opts.ttl);
+        const json = encodeValue(key, value);
+        const valueBytes = Buffer.byteLength(json, "utf8");
+        if (valueBytes > VALUE_LIMIT_BYTES) {
+            throw new ValueTooLargeError(valueBytes, VALUE_LIMIT_BYTES);
+        }
+        await this.call("set", { key, value, ttl: opts.ttl }, false);
+    }
+    async delete(key) {
+        validateKey(key);
+        await this.call("delete", { key }, false);
+    }
+    async has(key) {
+        validateKey(key);
+        return this.call("has", { key }, true);
+    }
+    async keys(opts) {
+        return this.call("keys", { prefix: opts?.prefix, limit: opts?.limit, cursor: opts?.cursor }, true);
+    }
+    async increment(key, opts) {
+        validateKey(key);
+        validateTtl(opts.ttl);
+        return this.call("increment", { key, by: opts.by, ttl: opts.ttl }, false);
+    }
+    async decrement(key, opts) {
+        validateKey(key);
+        validateTtl(opts.ttl);
+        return this.call("decrement", { key, by: opts.by, ttl: opts.ttl }, false);
+    }
+    async mget(keys) {
+        for (const key of keys)
+            validateKey(key);
+        return this.call("mget", { keys }, true);
+    }
+    async scope() {
+        return this.call("scope", {}, true);
+    }
+    // ── internals ──────────────────────────────────────────────────────
+    /**
+     * One shared retry budget (`retried`) covers BOTH retry triggers —
+     * a network failure and a 5xx response — so a retryable op makes
+     * at most 2 total requests, never 3. (A network failure on attempt
+     * 1 followed by a 5xx on attempt 2 must throw immediately, not
+     * spend a third attempt the budget doesn't have.)
+     */
+    async call(op, args, retryable) {
+        const doOnce = async () => this.fetchImpl(`${this.baseUrl.replace(/\/+$/, "")}/v1/state/${op}`, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                authorization: `Bearer ${this.authToken}`,
+            },
+            body: JSON.stringify({
+                context: { userId: this.context.userId, mcpId: this.context.mcpId },
+                args,
+            }),
+        });
+        let res;
+        let retried = false;
+        for (;;) {
+            try {
+                res = await doOnce();
+            }
+            catch (err) {
+                if (!retryable || retried) {
+                    throw new TransportError(`network failure calling guuey state API${retried ? " (after retry)" : ""}`, err);
+                }
+                retried = true;
+                continue;
+            }
+            if (res.status >= 500 && retryable && !retried) {
+                retried = true;
+                continue;
+            }
+            break;
+        }
+        if (!res.ok)
+            throw await toTypedError(res);
+        const body = (await res.json());
+        return body.result;
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/in-memory.d.ts

@@ -0,0 +1,28 @@
+import type { IncrementOptions, KeysPage, Kv, ScopeContext, ScopeInfo, SetOptions } from "./types.js";
+/**
+ * Test-only helper: wipe the process-wide store. NOT exported from
+ * the package barrel — consumers should never touch this. Tests
+ * import it directly from `./in-memory.js`.
+ */
+export declare function __resetInMemoryStoreForTests(): void;
+export declare class InMemoryKv implements Kv {
+    private readonly context;
+    constructor(context: ScopeContext);
+    get<T = unknown>(key: string): Promise<T | undefined>;
+    set<T = unknown>(key: string, value: T, opts: SetOptions): Promise<void>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+    keys(opts?: {
+        prefix?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<KeysPage>;
+    increment(key: string, opts: IncrementOptions): Promise<number>;
+    decrement(key: string, opts: IncrementOptions): Promise<number>;
+    mget<T = unknown>(keys: string[]): Promise<Record<string, T | undefined>>;
+    scope(): Promise<ScopeInfo>;
+    private scopeKey;
+    private scopeMap;
+    private usedBytes;
+}
+//# sourceMappingURL=in-memory.d.ts.map

package/dist/in-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../src/in-memory.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EACV,gBAAgB,EAChB,QAAQ,EACR,EAAE,EACF,YAAY,EACZ,SAAS,EACT,UAAU,EACX,MAAM,YAAY,CAAC;AAkCpB;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD;AAeD,qBAAa,UAAW,YAAW,EAAE;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAE3B,OAAO,EAAE,YAAY;IAK3B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAWrD,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,IAAI,CAAC;IAsBV,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWlC,IAAI,CAAC,IAAI,CAAC,EAAE;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgCf,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAkD/D,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/D,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC;IAsBnC,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC;IAYjC,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,SAAS;CAiBlB"}

package/dist/in-memory.js

@@ -0,0 +1,239 @@
+/**
+ * In-memory KV binding for local development + unit tests.
+ *
+ * Used automatically when `GUUEY_KV_URL` is unset (typical for
+ * `pnpm test` and `guuey dev` runs without the bridge). Logs a
+ * one-time `console.warn` so a forgotten in-memory binding in
+ * production doesn't silently swallow data.
+ *
+ * Behavior mirrors what the real HTTP binding will do:
+ * - Bytes counted as UTF-8 bytes of `JSON.stringify(value)` — the
+ *   same accounting any real storage backend uses. (NOT string
+ *   `.length`, which counts UTF-16 code units and under-counts
+ *   non-ASCII values up to ~3×.)
+ * - TTL enforced on read (expired keys return `undefined` and
+ *   are evicted lazily)
+ * - Per-scope quota enforcement
+ * - Same error shapes
+ */
+import { InvalidArgumentError, QuotaExceededError, TypeMismatchError, ValueTooLargeError, } from "./errors.js";
+import { MGET_LIMIT, SCOPE_LIMIT_BYTES, VALUE_LIMIT_BYTES, encodeValue, validateKey, validateTtl, } from "./validate.js";
+/**
+ * Process-wide store shared across every `InMemoryKv` instance.
+ * Scope isolation lives in the key (`userId`, NUL, `mcpId`), not in
+ * the instance — two `createGuueyState` calls with the same context
+ * read each other's data, which matches the production HTTP binding's
+ * behavior + matches the implicit-via-AsyncLocalStorage `kv` barrel
+ * that constructs a fresh binding per call.
+ */
+const sharedStore = new Map();
+/**
+ * Test-only helper: wipe the process-wide store. NOT exported from
+ * the package barrel — consumers should never touch this. Tests
+ * import it directly from `./in-memory.js`.
+ */
+export function __resetInMemoryStoreForTests() {
+    sharedStore.clear();
+}
+let warnedOnce = false;
+function emitOneTimeWarning() {
+    if (warnedOnce)
+        return;
+    warnedOnce = true;
+    console.warn("[@guuey/state] Using the in-memory KV binding. Data is " +
+        "per-process and non-durable (lost on restart, not shared " +
+        "across pods). Set GUUEY_KV_URL (guuey-hosted pods get this " +
+        "injected automatically) to use the durable hosted binding.");
+}
+export class InMemoryKv {
+    context;
+    constructor(context) {
+        this.context = context;
+        emitOneTimeWarning();
+    }
+    async get(key) {
+        validateKey(key);
+        const entry = this.scopeMap().get(key);
+        if (!entry)
+            return undefined;
+        if (entry.expiresAt <= Date.now()) {
+            this.scopeMap().delete(key);
+            return undefined;
+        }
+        return JSON.parse(entry.jsonValue);
+    }
+    async set(key, value, opts) {
+        validateKey(key);
+        validateTtl(opts.ttl);
+        const json = encodeValue(key, value);
+        const valueBytes = Buffer.byteLength(json, "utf8");
+        if (valueBytes > VALUE_LIMIT_BYTES) {
+            throw new ValueTooLargeError(valueBytes, VALUE_LIMIT_BYTES);
+        }
+        const bytes = Buffer.byteLength(key, "utf8") + valueBytes;
+        const scope = this.scopeMap();
+        const existing = scope.get(key);
+        const projectedBytes = this.usedBytes() - (existing?.bytes ?? 0) + bytes;
+        if (projectedBytes > SCOPE_LIMIT_BYTES) {
+            throw new QuotaExceededError(projectedBytes, SCOPE_LIMIT_BYTES);
+        }
+        scope.set(key, {
+            jsonValue: json,
+            bytes,
+            expiresAt: Date.now() + opts.ttl * 1000,
+        });
+    }
+    async delete(key) {
+        validateKey(key);
+        this.scopeMap().delete(key);
+    }
+    async has(key) {
+        validateKey(key);
+        const entry = this.scopeMap().get(key);
+        if (!entry)
+            return false;
+        if (entry.expiresAt <= Date.now()) {
+            this.scopeMap().delete(key);
+            return false;
+        }
+        return true;
+    }
+    async keys(opts) {
+        const prefix = opts?.prefix ?? "";
+        const limit = opts?.limit ?? 1000;
+        if (!Number.isInteger(limit) || limit < 1 || limit > 1000) {
+            throw new InvalidArgumentError(`keys() limit must be an integer in 1..1000 (got ${limit})`);
+        }
+        // Lexicographic pagination: sort matching live keys, resume
+        // strictly after the cursor. Deterministic and binding-portable
+        // (any sorted-key store paginates the same way); O(n log n) per
+        // page is fine for a dev binding capped at 1 MiB per scope.
+        const now = Date.now();
+        const live = [];
+        for (const [k, entry] of this.scopeMap()) {
+            if (entry.expiresAt <= now) {
+                this.scopeMap().delete(k);
+                continue;
+            }
+            if (!k.startsWith(prefix))
+                continue;
+            if (opts?.cursor !== undefined && k <= opts.cursor)
+                continue;
+            live.push(k);
+        }
+        live.sort();
+        const page = live.slice(0, limit);
+        const last = page[page.length - 1];
+        if (live.length > limit && last !== undefined) {
+            return { keys: page, cursor: last };
+        }
+        return { keys: page };
+    }
+    async increment(key, opts) {
+        validateKey(key);
+        validateTtl(opts.ttl);
+        const by = opts.by ?? 1;
+        if (!Number.isSafeInteger(by)) {
+            throw new InvalidArgumentError(`increment/decrement 'by' must be a safe integer (got ${by}) — ` +
+                `counters are integer-only`);
+        }
+        // The whole read-modify-write is SYNCHRONOUS — no `await` between
+        // the read and the write. Routing through get()/set() (async) let
+        // two concurrent increments interleave at the await points and
+        // both read the same base value (lost update). JS's single thread
+        // makes an uninterrupted sync block genuinely atomic, which is the
+        // contract the real counter op must honor (conditional-update on
+        // the backend).
+        const scope = this.scopeMap();
+        const entry = scope.get(key);
+        let current = 0;
+        let liveEntryBytes = 0;
+        if (entry && entry.expiresAt > Date.now()) {
+            const parsed = JSON.parse(entry.jsonValue);
+            if (typeof parsed !== "number") {
+                throw new TypeMismatchError(key, typeof parsed);
+            }
+            current = parsed;
+            liveEntryBytes = entry.bytes;
+        }
+        const next = current + by;
+        if (!Number.isSafeInteger(next)) {
+            throw new InvalidArgumentError(`counter ${JSON.stringify(key)} would leave the safe-integer ` +
+                `range (${current} + ${by})`);
+        }
+        const json = JSON.stringify(next);
+        const bytes = Buffer.byteLength(key, "utf8") + Buffer.byteLength(json, "utf8");
+        const projectedBytes = this.usedBytes() - liveEntryBytes + bytes;
+        if (projectedBytes > SCOPE_LIMIT_BYTES) {
+            throw new QuotaExceededError(projectedBytes, SCOPE_LIMIT_BYTES);
+        }
+        scope.set(key, {
+            jsonValue: json,
+            bytes,
+            expiresAt: Date.now() + opts.ttl * 1000,
+        });
+        return next;
+    }
+    async decrement(key, opts) {
+        return this.increment(key, { ...opts, by: -(opts.by ?? 1) });
+    }
+    async mget(keys) {
+        if (keys.length > MGET_LIMIT) {
+            throw new InvalidArgumentError(`mget() accepts at most ${MGET_LIMIT} keys per call (got ` +
+                `${keys.length}) — split into batches`);
+        }
+        // Null-prototype accumulator: a plain `{}` inherits the
+        // `Object.prototype.__proto__` accessor, so a key literally named
+        // "__proto__" (legal under VALID_KEY) would either vanish from the
+        // result (primitive value) or REPLACE the result's prototype
+        // (object value). `Object.create(null)` has no such accessor.
+        const out = Object.create(null);
+        for (const k of keys) {
+            out[k] = await this.get(k);
+        }
+        return out;
+    }
+    async scope() {
+        return {
+            userId: this.context.userId,
+            mcpId: this.context.mcpId,
+            usedBytes: this.usedBytes(),
+            limitBytes: SCOPE_LIMIT_BYTES,
+            keyCount: this.scopeMap().size,
+        };
+    }
+    // ── internals ──────────────────────────────────────────────────────
+    scopeKey() {
+        // NUL delimiter: unlike a printable separator it cannot collide
+        // with id content (`validateContext` rejects control characters,
+        // so no context field can ever contain U+0000).
+        return `${this.context.userId}\u0000${this.context.mcpId}`;
+    }
+    scopeMap() {
+        const key = this.scopeKey();
+        let map = sharedStore.get(key);
+        if (!map) {
+            map = new Map();
+            sharedStore.set(key, map);
+        }
+        return map;
+    }
+    usedBytes() {
+        // Expired entries don't count toward the quota (and are evicted on
+        // the way) — otherwise a scope full of dead keys rejects fresh
+        // writes with QuotaExceededError until each corpse is individually
+        // read. Mirrors what any real TTL store's accounting does.
+        const scope = this.scopeMap();
+        const now = Date.now();
+        let total = 0;
+        for (const [k, entry] of scope) {
+            if (entry.expiresAt <= now) {
+                scope.delete(k);
+                continue;
+            }
+            total += entry.bytes;
+        }
+        return total;
+    }
+}
+//# sourceMappingURL=in-memory.js.map

package/dist/in-memory.js.map

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