@substrat-run/contracts 0.137.0 → 0.138.0

package/dist/rate-limit.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Request rate limiting on the request path (#130).
+ *
+ * A tenant must be protected from another tenant, and from its own AI-built frontend with
+ * a polling bug. The limit is enforced where a request first meets the platform: the router
+ * on the hosted path, `@substrat-run/vertical-host`'s `rateLimit()` middleware on a node
+ * host with no router in front. Never in a scope host and never in the kernel: a limiter in
+ * a scope DO serialises behind that scope's write queue, and cannot see one token's
+ * traffic across scopes.
+ *
+ * ## Why the policy lives here
+ *
+ * Both of those choke points derive the same keys, speak the same headers and refuse with
+ * the same problem — through one call, {@link evaluateRateLimits}. This file is that grammar
+ * and nothing else: which counter remembers a key is the caller's ({@link RateLimiter}), so
+ * the router binds Cloudflare's native rate-limit binding and a node host binds
+ * vertical-host's `memoryRateLimiter`, and the two cannot disagree about what a key or a 429
+ * looks like.
+ *
+ * ## The keys
+ *
+ * Every key begins `<tenant>:<scope>:<bucket>:`, so one tenant's traffic can never spend
+ * another tenant's budget. That is a property of the key, not of a configuration.
+ *
+ * - **credential**: one budget per caller. A bearer token when the request carries one, else
+ *   the session cookie a signed-in browser carries, else the client address. A credential is
+ *   only ever represented by a truncated SHA-256 digest: the raw token or cookie is never
+ *   part of a key, so it reaches no counter and no log line.
+ * - **ip**: one budget per client address, set well above the credential budget. The router
+ *   cannot verify a bearer, so without it a caller minting a fresh fake token per request
+ *   would get a fresh credential budget per request too.
+ *
+ * ## The fail mode
+ *
+ * Open. A limiter that throws lets the request through, and the caller logs it. The limiter
+ * protects capacity; it is not an authorization boundary — every request still meets the
+ * vertical's authentication and permission checks — and failing closed would turn an outage
+ * of the counter into an outage of every tenant behind it.
+ */
+import { type Problem } from './errors.js';
+/** RFC 9110 §10.2.3: seconds a client should wait before trying again. */
+export declare const RETRY_AFTER_HEADER = "Retry-After";
+/** The policies a response was judged against (draft-ietf-httpapi-ratelimit-headers). */
+export declare const RATE_LIMIT_POLICY_HEADER = "RateLimit-Policy";
+/** The state of the policy that refused (same draft): nothing remaining, and when it resets. */
+export declare const RATE_LIMIT_HEADER = "RateLimit";
+/**
+ * Exposed to a cross-origin browser client — the same trap `IDEMPOTENCY_EXPOSED_HEADERS`
+ * documents. An unexposed `Retry-After` is the one that matters: a frontend that cannot
+ * read it cannot back off by it.
+ */
+export declare const RATE_LIMIT_EXPOSED_HEADERS: readonly ["Retry-After", "RateLimit", "RateLimit-Policy"];
+/**
+ * The counter seam. Exactly the shape of Cloudflare's rate-limit binding, so the binding IS
+ * a `RateLimiter` and needs no wrapper. `success: false` means the key is over its limit.
+ */
+export interface RateLimiter {
+    limit(options: {
+        key: string;
+    }): Promise<{
+        success: boolean;
+    }>;
+}
+/** The two buckets every request is counted in. */
+export declare const RATE_LIMIT_BUCKETS: readonly ['credential', 'ip'];
+export type RateLimitBucket = (typeof RATE_LIMIT_BUCKETS)[number];
+/** One bucket's budget: `limit` requests per `period` seconds. */
+export interface RateLimitPolicy {
+    readonly limit: number;
+    readonly period: number;
+}
+/**
+ * The defaults: conservative, so a normal client never meets them. 1200 a minute per
+ * credential is twenty requests a second sustained; the address budget is five times that,
+ * so an office behind one NAT, every person on their own session, stays well clear of it.
+ * A deployment sets its own (the router's `wrangler.jsonc`, a node host's options).
+ */
+export declare const DEFAULT_RATE_LIMITS: Readonly<Record<RateLimitBucket, RateLimitPolicy>>;
+/**
+ * Read a deployment's configured limits, or `undefined` when they are not a complete,
+ * well-formed set. Strict on purpose: a typo in a limit must be loud (the caller logs and
+ * fails open), never a silently different budget.
+ */
+export declare function parseRateLimits(value: unknown): Record<RateLimitBucket, RateLimitPolicy> | undefined;
+/**
+ * The cookies that ARE a signed-in browser's credential: the platform session (oidc-rp's
+ * `sb_session`), a capability session (`sb_capability`, one cookie per link since #1686), and
+ * Better Auth's session token on an instance using that provider. Any other cookie — a
+ * preference, an analytics id — says nothing about who is calling and is ignored.
+ */
+export declare function isSessionCookie(name: string): boolean;
+/** What a request offers to be counted by. Header values are read, never kept. */
+export interface RateLimitSubject {
+    readonly tenantId: string;
+    readonly scopeId: string;
+    readonly headers: Headers;
+    /** The client address, when the host knows one. Absent ⇒ one shared anonymous budget. */
+    readonly clientIp?: string | null | undefined;
+    /** The request method. An `OPTIONS` preflight is never counted (see {@link evaluateRateLimits}). */
+    readonly method?: string;
+}
+/**
+ * The key one request is counted under in one bucket. Async because a credential is hashed
+ * (Web Crypto) before it goes anywhere — and only when the credential bucket is counted.
+ */
+export declare function rateLimitKey(bucket: RateLimitBucket, subject: RateLimitSubject): Promise<string>;
+/** A 429, as the parts a host's own `Response` is built from. */
+export interface RateLimitedRefusal {
+    readonly status: 429;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body: Problem;
+}
+/** What one request's count decided, for the host to answer and log. */
+export interface RateLimitEvaluation {
+    /** The 429 to answer instead of serving the request, when a bucket refused it. */
+    readonly refusal?: RateLimitedRefusal;
+    /** `RateLimit-Policy` for the response the request goes on to get; null when nothing counted it. */
+    readonly policyHeader: string | null;
+    /**
+     * Set when a counter threw and the request was let through anyway (fail open): the fields of
+     * the host's `rate-limit-unavailable` log line. Never a key — even a digest has no business
+     * in a log line.
+     */
+    readonly unavailable?: {
+        readonly reason: string;
+        readonly buckets: RateLimitBucket[];
+        readonly error: string[];
+    };
+}
+/**
+ * Count one request in the buckets that have a counter — the whole decision both hosts make.
+ *
+ * The ADDRESS is counted first, and a request it refuses is never counted against a
+ * credential. A credential key is minted from whatever the request sends, so a caller
+ * rotating made-up tokens from one address would otherwise create a fresh credential counter
+ * with every request it was already refused for — unbounded state in a counter that keeps
+ * its keys (the node host's), and spent budget on keys nobody holds. Once the address is
+ * over, the credential bucket is not asked.
+ */
+export declare function evaluateRateLimits(input: {
+    readonly subject: RateLimitSubject;
+    readonly policies: Readonly<Record<RateLimitBucket, RateLimitPolicy>>;
+    readonly limiters: Readonly<Partial<Record<RateLimitBucket, RateLimiter>>>;
+    /** The request path, for the problem's `instance`. */
+    readonly instance?: string;
+}): Promise<RateLimitEvaluation>;
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/rate-limit.d.ts.map

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

package/dist/rate-limit.js

@@ -0,0 +1,248 @@
+/**
+ * Request rate limiting on the request path (#130).
+ *
+ * A tenant must be protected from another tenant, and from its own AI-built frontend with
+ * a polling bug. The limit is enforced where a request first meets the platform: the router
+ * on the hosted path, `@substrat-run/vertical-host`'s `rateLimit()` middleware on a node
+ * host with no router in front. Never in a scope host and never in the kernel: a limiter in
+ * a scope DO serialises behind that scope's write queue, and cannot see one token's
+ * traffic across scopes.
+ *
+ * ## Why the policy lives here
+ *
+ * Both of those choke points derive the same keys, speak the same headers and refuse with
+ * the same problem — through one call, {@link evaluateRateLimits}. This file is that grammar
+ * and nothing else: which counter remembers a key is the caller's ({@link RateLimiter}), so
+ * the router binds Cloudflare's native rate-limit binding and a node host binds
+ * vertical-host's `memoryRateLimiter`, and the two cannot disagree about what a key or a 429
+ * looks like.
+ *
+ * ## The keys
+ *
+ * Every key begins `<tenant>:<scope>:<bucket>:`, so one tenant's traffic can never spend
+ * another tenant's budget. That is a property of the key, not of a configuration.
+ *
+ * - **credential**: one budget per caller. A bearer token when the request carries one, else
+ *   the session cookie a signed-in browser carries, else the client address. A credential is
+ *   only ever represented by a truncated SHA-256 digest: the raw token or cookie is never
+ *   part of a key, so it reaches no counter and no log line.
+ * - **ip**: one budget per client address, set well above the credential budget. The router
+ *   cannot verify a bearer, so without it a caller minting a fresh fake token per request
+ *   would get a fresh credential budget per request too.
+ *
+ * ## The fail mode
+ *
+ * Open. A limiter that throws lets the request through, and the caller logs it. The limiter
+ * protects capacity; it is not an authorization boundary — every request still meets the
+ * vertical's authentication and permission checks — and failing closed would turn an outage
+ * of the counter into an outage of every tenant behind it.
+ */
+import { substratError, toProblem, PROBLEM_CONTENT_TYPE } from './errors.js';
+/** RFC 9110 §10.2.3: seconds a client should wait before trying again. */
+export const RETRY_AFTER_HEADER = 'Retry-After';
+/** The policies a response was judged against (draft-ietf-httpapi-ratelimit-headers). */
+export const RATE_LIMIT_POLICY_HEADER = 'RateLimit-Policy';
+/** The state of the policy that refused (same draft): nothing remaining, and when it resets. */
+export const RATE_LIMIT_HEADER = 'RateLimit';
+/**
+ * Exposed to a cross-origin browser client — the same trap `IDEMPOTENCY_EXPOSED_HEADERS`
+ * documents. An unexposed `Retry-After` is the one that matters: a frontend that cannot
+ * read it cannot back off by it.
+ */
+export const RATE_LIMIT_EXPOSED_HEADERS = [RETRY_AFTER_HEADER, RATE_LIMIT_HEADER, RATE_LIMIT_POLICY_HEADER];
+/** The two buckets every request is counted in. */
+export const RATE_LIMIT_BUCKETS = ['credential', 'ip'];
+/**
+ * The defaults: conservative, so a normal client never meets them. 1200 a minute per
+ * credential is twenty requests a second sustained; the address budget is five times that,
+ * so an office behind one NAT, every person on their own session, stays well clear of it.
+ * A deployment sets its own (the router's `wrangler.jsonc`, a node host's options).
+ */
+export const DEFAULT_RATE_LIMITS = {
+    credential: { limit: 1200, period: 60 },
+    ip: { limit: 6000, period: 60 },
+};
+/**
+ * Read a deployment's configured limits, or `undefined` when they are not a complete,
+ * well-formed set. Strict on purpose: a typo in a limit must be loud (the caller logs and
+ * fails open), never a silently different budget.
+ */
+export function parseRateLimits(value) {
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    const out = {};
+    for (const bucket of RATE_LIMIT_BUCKETS) {
+        const policy = value[bucket];
+        if (!isPositiveInt(policy?.limit) || !isPositiveInt(policy?.period))
+            return undefined;
+        out[bucket] = { limit: policy.limit, period: policy.period };
+    }
+    return out;
+}
+const isPositiveInt = (n) => Number.isInteger(n) && n > 0;
+/**
+ * The cookies that ARE a signed-in browser's credential: the platform session (oidc-rp's
+ * `sb_session`), a capability session (`sb_capability`, one cookie per link since #1686), and
+ * Better Auth's session token on an instance using that provider. Any other cookie — a
+ * preference, an analytics id — says nothing about who is calling and is ignored.
+ */
+export function isSessionCookie(name) {
+    return (name === 'sb_session' ||
+        name.startsWith('sb_capability') ||
+        name === 'better-auth.session_token' ||
+        name === '__Secure-better-auth.session_token');
+}
+/**
+ * The key one request is counted under in one bucket. Async because a credential is hashed
+ * (Web Crypto) before it goes anywhere — and only when the credential bucket is counted.
+ */
+export async function rateLimitKey(bucket, subject) {
+    const address = subject.clientIp ? `ip:${subject.clientIp}` : 'anon';
+    const caller = bucket === 'credential' ? ((await credentialOf(subject.headers)) ?? address) : address;
+    return `${subject.tenantId}:${subject.scopeId}:${bucket}:${caller}`;
+}
+/**
+ * The caller's credential as a digest: `b:` for a bearer, `s:` for a session cookie set.
+ * Every session cookie the request carries is hashed together, sorted, so a browser holding
+ * a stale host-only `sb_session` beside its domain one is still one caller.
+ */
+async function credentialOf(headers) {
+    const authorization = headers.get('authorization');
+    if (authorization)
+        return `b:${await digest(authorization)}`;
+    const session = sessionCookiesOf(headers.get('cookie'));
+    if (session.length > 0)
+        return `s:${await digest(session.join('\n'))}`;
+    return undefined;
+}
+function sessionCookiesOf(header) {
+    if (!header)
+        return [];
+    const out = [];
+    for (const part of header.split(';')) {
+        const eq = part.indexOf('=');
+        if (eq === -1)
+            continue;
+        const name = part.slice(0, eq).trim();
+        if (isSessionCookie(name))
+            out.push(`${name}=${part.slice(eq + 1).trim()}`);
+    }
+    return out.sort();
+}
+/** 128 bits of SHA-256, hex: unguessable, and short enough to be a counter key. */
+async function digest(text) {
+    const bytes = new Uint8Array(await globalThis.crypto.subtle.digest('SHA-256', new TextEncoder().encode(text)));
+    let hex = '';
+    for (const b of bytes.subarray(0, 16))
+        hex += b.toString(16).padStart(2, '0');
+    return hex;
+}
+/** The order buckets are counted in: the address first (see {@link evaluateRateLimits}). */
+const COUNTING_ORDER = ['ip', 'credential'];
+/**
+ * Count one request in the buckets that have a counter — the whole decision both hosts make.
+ *
+ * The ADDRESS is counted first, and a request it refuses is never counted against a
+ * credential. A credential key is minted from whatever the request sends, so a caller
+ * rotating made-up tokens from one address would otherwise create a fresh credential counter
+ * with every request it was already refused for — unbounded state in a counter that keeps
+ * its keys (the node host's), and spent budget on keys nobody holds. Once the address is
+ * over, the credential bucket is not asked.
+ */
+export async function evaluateRateLimits(input) {
+    // A CORS preflight is never counted, so never refused: a refused preflight is opaque to the
+    // page whatever headers it carries, so the page could not read the 429 its real request
+    // would have met. It reaches the vertical's own preflight handler instead.
+    if (input.subject.method === 'OPTIONS')
+        return { policyHeader: null };
+    const buckets = RATE_LIMIT_BUCKETS.filter((bucket) => input.limiters[bucket]);
+    if (buckets.length === 0)
+        return { policyHeader: null };
+    const results = [];
+    for (const bucket of COUNTING_ORDER) {
+        const limiter = input.limiters[bucket];
+        if (!limiter)
+            continue;
+        try {
+            const key = await rateLimitKey(bucket, input.subject);
+            results.push({ bucket, success: (await limiter.limit({ key })).success });
+        }
+        catch (error) {
+            results.push({ bucket, success: true, error: error instanceof Error ? error.message : String(error) });
+        }
+        if (!results.at(-1).success)
+            break;
+    }
+    const policyHeader = buckets
+        .map((bucket) => `"${bucket}";q=${input.policies[bucket].limit};w=${input.policies[bucket].period}`)
+        .join(', ');
+    const failed = results.filter((r) => r.error !== undefined);
+    const unavailable = failed.length > 0
+        ? {
+            reason: 'the rate limiter threw; the request was let through',
+            buckets: failed.map((r) => r.bucket),
+            error: failed.map((r) => r.error),
+        }
+        : undefined;
+    const refused = results.find((r) => !r.success)?.bucket;
+    return {
+        policyHeader,
+        ...(unavailable ? { unavailable } : {}),
+        ...(refused
+            ? {
+                refusal: refusalFor(refused, input.policies[refused], policyHeader, {
+                    instance: input.instance,
+                    origin: input.subject.headers.get('origin'),
+                }),
+            }
+            : {}),
+    };
+}
+/**
+ * The refusal: 429 `application/problem+json` with code `rate_limited`, and the headers a
+ * client backs off by. Parts rather than a `Response`, as the rest of this package hands out
+ * data: each host builds its own.
+ *
+ * `Retry-After` is the bucket's whole period. A counter that cannot say where in its window
+ * a key sits (Cloudflare's binding cannot) makes the period the only bound that is never
+ * too short, and a retry that is too early is just another 429.
+ */
+function refusalFor(bucket, policy, policyHeader, { instance, origin }) {
+    const retryAfter = policy.period;
+    const body = toProblem(substratError('rate_limited', `Too many requests for this ${bucket === 'ip' ? 'client address' : 'credential'}: ` +
+        `at most ${policy.limit} every ${policy.period} seconds. Retry after ${retryAfter} seconds.`, { retryAfter }), instance);
+    return {
+        status: 429,
+        headers: {
+            'content-type': PROBLEM_CONTENT_TYPE,
+            [RETRY_AFTER_HEADER]: String(retryAfter),
+            [RATE_LIMIT_POLICY_HEADER]: policyHeader,
+            [RATE_LIMIT_HEADER]: `"${bucket}";r=0;t=${retryAfter}`,
+            ...(origin ? refusalCors(origin) : {}),
+        },
+        body,
+    };
+}
+/**
+ * CORS for the refusal, and only for it.
+ *
+ * A refusal is answered before the vertical runs, so the vertical's own CORS policy never
+ * sees it. Without these headers a cross-origin page reads a network error rather than a
+ * 429, and cannot back off by `Retry-After` — the polling loop this exists to stop keeps
+ * polling. The route names no origin allowlist to follow, so the refusal reflects whichever
+ * origin asked, credentials included.
+ *
+ * That is safe for THIS response and would not be for any other: the body and headers are
+ * the requester's own rate state — the budget that refused and when to retry — and no vertical
+ * data, which is why the policy is built here and never applied to a response the vertical
+ * gave.
+ */
+function refusalCors(origin) {
+    return {
+        'access-control-allow-origin': origin,
+        'access-control-allow-credentials': 'true',
+        'access-control-expose-headers': RATE_LIMIT_EXPOSED_HEADERS.join(', '),
+        vary: 'Origin',
+    };
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/rate-limit.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@substrat-run/contracts",
-  "version": "0.137.0",
+  "version": "0.138.0",
   "description": "Substrat kernel contract schemas — Zod is the source of truth (master plan D-22); OAS/JSON Schema are emitted artifacts",
   "license": "Apache-2.0",
   "repository": {