@growth-labs/seo 0.4.0 → 0.4.2

package/dist/utils/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,qBAAqB;IACrC,cAAc,EAAE,MAAM,CAAA;IACtB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAqEhF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,gBAAgB,CAqF3F;AAID,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,MAAM,WAAW,wBAAwB;IACxC,GAAG,EAAE,MAAM,CAAA;IACX,iBAAiB,EAAE;QAClB,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,qBAAqB,EAAE,MAAM,CAAA;KAC7B,CAAA;CACD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,wBAAwB,EAAE,CAkC5F;AAID,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,SAAS,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAAC,EAC9C,eAAe,EACf,KAAK,GACL,EAAE;IACF,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC5B,KAAK,EAAE,WAAW,EAAE,CAAA;CACpB,GAAG,mBAAmB,EAAE,CAmBxB"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,qBAAqB;IACrC,cAAc,EAAE,MAAM,CAAA;IACtB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAqEhF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,gBAAgB,CAyF3F;AA4BD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,MAAM,WAAW,wBAAwB;IACxC,GAAG,EAAE,MAAM,CAAA;IACX,iBAAiB,EAAE;QAClB,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,qBAAqB,EAAE,MAAM,CAAA;KAC7B,CAAA;CACD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,wBAAwB,EAAE,CAkC5F;AAID,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,SAAS,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAAC,EAC9C,eAAe,EACf,KAAK,GACL,EAAE;IACF,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC5B,KAAK,EAAE,WAAW,EAAE,CAAA;CACpB,GAAG,mBAAmB,EAAE,CAmBxB"}

package/dist/utils/validation.js

@@ -69,6 +69,9 @@ export function validateJsonLd(jsonLd) {
 export function validatePage(html, options) {
     const errors = [];
     const warnings = [];
+    if (isNoindexMetaRefreshRedirect(html)) {
+        return { errors, warnings };
+    }
     const { titleMaxLength, descriptionMaxLength } = options;
     // Title checks
     const titleMatch = html.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
@@ -138,6 +141,25 @@ export function validatePage(html, options) {
     }
     return { errors, warnings };
 }
+function isNoindexMetaRefreshRedirect(html) {
+    const metaTags = html.match(/<meta\s+[^>]*>/gi) ?? [];
+    const hasRefresh = metaTags.some((tag) => getHtmlAttr(tag, 'http-equiv')?.toLowerCase() === 'refresh');
+    const hasNoindex = metaTags.some((tag) => {
+        if (getHtmlAttr(tag, 'name')?.toLowerCase() !== 'robots')
+            return false;
+        const content = getHtmlAttr(tag, 'content')?.toLowerCase() ?? '';
+        return content
+            .split(',')
+            .map((part) => part.trim())
+            .includes('noindex');
+    });
+    return hasRefresh && hasNoindex;
+}
+function getHtmlAttr(tag, name) {
+    const escapedName = name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const match = tag.match(new RegExp(`\\b${escapedName}\\s*=\\s*(?:"([^"]*)"|'([^']*)'|([^\\s>]+))`, 'i'));
+    return match?.[1] ?? match?.[2] ?? match?.[3];
+}
 /**
  * Verify that every `alternateLocales` entry has a reciprocal entry on the
  * target side. For search engines, missing reciprocals are a hard error — Google

package/dist/utils/validation.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growth-labs/seo",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "type": "module",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -51,7 +51,11 @@
   },
   "files": [
     "dist",
-    "src/components",
+    "src/**/*.ts",
+    "src/**/*.astro",
+    "src/**/*.css",
+    "src/**/*.md",
+    "src/**/*.sql",
     "README.md"
   ],
   "publishConfig": {
@@ -59,16 +63,16 @@
     "registry": "https://registry.npmjs.org/"
   },
   "peerDependencies": {
-    "astro": "^6.0.0"
+    "astro": "^6.1.10"
   },
   "dependencies": {
     "zod": "^3.23.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
-    "astro": "^6.0.0",
+    "astro": "^6.1.10",
     "typescript": "^5.7.0",
-    "vite": "^7.0.0",
+    "vite": "^7.3.2",
     "vitest": "^3.0.0"
   },
   "scripts": {

package/src/_internal/state.ts

@@ -0,0 +1,26 @@
+import type { ResolvedSeoOptions } from '../options.js'
+import type { ContentProvider } from '../types.js'
+
+let _config: ResolvedSeoOptions | null = null
+let _contentProvider: ContentProvider | undefined
+
+export function _setConfig(config: ResolvedSeoOptions): void {
+	_config = config
+}
+
+export function _setContentProvider(provider: ContentProvider): void {
+	_contentProvider = provider
+}
+
+export function getConfig(): ResolvedSeoOptions {
+	if (!_config) {
+		throw new Error(
+			'@growth-labs/seo: integration not initialized. Ensure seo() is added to your Astro config.',
+		)
+	}
+	return _config
+}
+
+export function getContentProvider(): ContentProvider | undefined {
+	return _contentProvider
+}

package/src/bindings.ts

@@ -0,0 +1,146 @@
+// Cloudflare binding declarations used by the SEO integration at request and build time.
+//
+// These types are not Astro-specific. They describe the subset of `env` the package
+// touches when running inside a Cloudflare Worker. Consumers provide the actual bindings
+// in wrangler.toml; this file gives us a narrow structural type so utility and middleware
+// code can be type-checked without a hard dependency on `@cloudflare/workers-types`.
+//
+// If `@cloudflare/workers-types` is in the consumer's project, their stricter types will
+// widen-compatibly overlap these interfaces.
+
+/**
+ * R2 bucket binding for the fresh-twin layer.
+ * Subset of the R2Bucket API we actually use.
+ */
+export interface R2BucketLike {
+	get(key: string): Promise<R2ObjectLike | null>
+	put(
+		key: string,
+		value: ReadableStream | ArrayBuffer | string,
+		options?: R2PutOptions,
+	): Promise<unknown>
+	delete(keys: string | string[]): Promise<void>
+	list(options?: { prefix?: string; cursor?: string; limit?: number }): Promise<R2ListResult>
+}
+
+export interface R2ObjectLike {
+	readonly key: string
+	readonly size: number
+	readonly uploaded: Date
+	readonly httpMetadata?: R2HTTPMetadata
+	readonly customMetadata?: Record<string, string>
+	text(): Promise<string>
+	arrayBuffer(): Promise<ArrayBuffer>
+	body: ReadableStream | null
+	bodyUsed: boolean
+}
+
+export interface R2PutOptions {
+	httpMetadata?: R2HTTPMetadata
+	customMetadata?: Record<string, string>
+}
+
+export interface R2HTTPMetadata {
+	contentType?: string
+	contentLanguage?: string
+	contentDisposition?: string
+	contentEncoding?: string
+	cacheControl?: string
+	cacheExpiry?: Date
+}
+
+export interface R2ListResult {
+	objects: R2ObjectLike[]
+	truncated: boolean
+	cursor?: string
+}
+
+/**
+ * KV namespace binding — acceptable alternative to R2 for the fresh-twin layer.
+ * Subset of the KVNamespace API we actually use.
+ */
+export interface KVNamespaceLike {
+	get(key: string): Promise<string | null>
+	get(key: string, options: { type: 'text' }): Promise<string | null>
+	get(key: string, options: { type: 'arrayBuffer' }): Promise<ArrayBuffer | null>
+	put(
+		key: string,
+		value: string | ArrayBuffer,
+		options?: { expiration?: number; expirationTtl?: number; metadata?: unknown },
+	): Promise<void>
+	delete(key: string): Promise<void>
+	list(options?: {
+		prefix?: string
+		cursor?: string
+		limit?: number
+	}): Promise<{ keys: Array<{ name: string }>; list_complete: boolean; cursor?: string }>
+}
+
+/**
+ * Assets binding — reads static files from the Worker's deployment bundle without
+ * re-entering the Worker's request routing. Use:
+ *   env.ASSETS.fetch(new Request('https://assets.local/path/to/file.md'))
+ * The hostname is ignored by the assets runtime; only pathname matters.
+ * Set `assets.not_found_handling = "none"` in wrangler.toml to prevent SPA fallback
+ * from serving index.html when the requested path is missing.
+ */
+export interface AssetsBinding {
+	fetch(request: Request): Promise<Response>
+}
+
+/**
+ * Durable Object namespace binding for the Revalidation Coordinator. The actual DO
+ * class is exported from `@growth-labs/seo/durable-objects` and wired by the consumer
+ * in their Worker entrypoint.
+ */
+export interface DurableObjectNamespaceLike {
+	idFromName(name: string): DurableObjectIdLike
+	get(id: DurableObjectIdLike): DurableObjectStubLike
+}
+
+export interface DurableObjectIdLike {
+	toString(): string
+	equals(other: DurableObjectIdLike): boolean
+}
+
+export interface DurableObjectStubLike {
+	fetch(request: Request): Promise<Response>
+}
+
+/**
+ * Version metadata binding. Injected into `env` as `CF_VERSION_METADATA`.
+ * Used for rollback-safe R2 key prefixing (`twin/<id>/<slug>.md`).
+ * `id` is an opaque version UUID that rotates on every new deployment.
+ * `tag` is an optional user-supplied annotation via `workers/tag`.
+ * `timestamp` is the version's creation time (ISO 8601 string).
+ * Ref: https://developers.cloudflare.com/workers/runtime-apis/bindings/version-metadata/
+ */
+export interface VersionMetadata {
+	readonly id: string
+	readonly tag?: string
+	readonly timestamp: string
+}
+
+/**
+ * The minimal Worker env shape the SEO package depends on. Consumers will have many
+ * more bindings than this; we only declare what we read.
+ *
+ * All fields are optional because the package's `mode: 'static'` code path runs without
+ * any Worker bindings. Runtime binding resolvers throw structured errors when required
+ * bindings are missing.
+ */
+export interface SeoEnv {
+	// Fresh-twin layer — one of R2 or KV. The package's resolver picks by binding shape;
+	// the `type` hint in `aeoTwins.freshLayer` avoids ambiguity.
+	AEO_TWINS?: R2BucketLike | KVNamespaceLike
+
+	// Revalidation Coordinator DO namespace.
+	AEO_REVALIDATION_COORD?: DurableObjectNamespaceLike
+
+	// Static assets bundled with the Worker deployment. Provided by Astro's Cloudflare
+	// adapter for SSR routes and by Workers' [assets] binding for static serving.
+	ASSETS?: AssetsBinding
+
+	// Version metadata. Required when `mode !== 'static'` or `onDemandRevalidation: true`.
+	CF_VERSION_METADATA?: VersionMetadata
+}

package/src/cron/prune-aeo-r2.ts

@@ -0,0 +1,140 @@
+import type { SeoEnv } from '../bindings.js'
+import { deleteFreshTwin, listDeploymentIds, listKeysByDeployment } from '../utils/fresh-layer.js'
+
+// Scheduled cron handler that deletes R2/KV entries from old deployments past
+// the configured retention. Consumer binds a cron trigger in wrangler.toml
+// (typically daily at 03:00 UTC) and re-exports this function from their
+// Worker's `scheduled` handler.
+//
+// R2 does not have native prefix-based TTL. Without this cron, old deployment
+// prefixes accumulate — storage cost is low but unbounded.
+
+export interface PruneAeoR2Options {
+	env: SeoEnv
+	/** Binding name to read from env. Matches aeoTwins.freshLayer.bindingName. */
+	bindingName?: string
+	/** 'r2' (default) or 'kv'. Matches aeoTwins.freshLayer.type. */
+	type?: 'r2' | 'kv'
+	/** Retention in days. Matches aeoTwins.freshLayer.retentionDays. */
+	retentionDays?: number
+	/** Optional structured-log sink. */
+	log?: (event: Record<string, unknown>) => void
+}
+
+export interface PruneResult {
+	deploymentsScanned: number
+	deploymentsPruned: string[]
+	keysDeleted: number
+	errors: string[]
+}
+
+const DEFAULT_RETENTION_DAYS = 7
+
+/**
+ * Sweep the fresh layer for entries belonging to deployments that are no longer
+ * current AND older than `retentionDays`. Keys from the current deployment are
+ * untouched regardless of age.
+ *
+ * Algorithm:
+ *   1. Determine the current versionId from env.CF_VERSION_METADATA.id.
+ *   2. List all deployment IDs present in the fresh layer.
+ *   3. For each non-current deployment, list its keys; if the oldest matches
+ *      the retention cutoff, delete all keys under that prefix.
+ *
+ * "Oldest matches retention cutoff" is approximated by R2's `uploaded` timestamp
+ * (R2-only). For KV there's no per-key mtime, so the retention check degrades
+ * to "delete everything not matching the current deployment" — adjust the
+ * binding to R2 if you need retentionDays fidelity.
+ */
+export async function pruneAeoR2(options: PruneAeoR2Options): Promise<PruneResult> {
+	const {
+		env,
+		bindingName = 'AEO_TWINS',
+		type = 'r2',
+		retentionDays = DEFAULT_RETENTION_DAYS,
+		log,
+	} = options
+
+	const currentVersion = env.CF_VERSION_METADATA?.id
+	const errors: string[] = []
+	const deploymentsPruned: string[] = []
+	let keysDeleted = 0
+
+	if (!currentVersion) {
+		errors.push('missing_CF_VERSION_METADATA_id')
+		log?.({ event: 'prune_skipped', reason: 'missing_CF_VERSION_METADATA_id' })
+		return { deploymentsScanned: 0, deploymentsPruned, keysDeleted, errors }
+	}
+
+	const binding = (env as Record<string, unknown>)[bindingName]
+	if (!binding) {
+		errors.push(`missing_binding_${bindingName}`)
+		log?.({ event: 'prune_skipped', reason: 'missing_binding', bindingName })
+		return { deploymentsScanned: 0, deploymentsPruned, keysDeleted, errors }
+	}
+
+	const impl = binding as
+		| import('../bindings.js').R2BucketLike
+		| import('../bindings.js').KVNamespaceLike
+	const freshLayer = { type, impl, deploymentId: currentVersion }
+	const cutoffMs = Date.now() - retentionDays * 24 * 60 * 60 * 1000
+
+	const allDeployments = await listDeploymentIds(freshLayer)
+	const deploymentsScanned = allDeployments.size
+
+	for (const deploymentId of allDeployments) {
+		if (deploymentId === currentVersion) continue
+
+		let deletedForThisDeployment = 0
+		let shouldDelete = true
+
+		// R2-only: peek the first object's uploaded time to gate on retentionDays.
+		// KV falls through to "delete everything non-current" since no mtime is available.
+		if (type === 'r2') {
+			const r2 = impl as import('../bindings.js').R2BucketLike
+			const peek = await r2.list({ prefix: `twin/${deploymentId}/`, limit: 1 })
+			const oldest = peek.objects[0]
+			if (oldest && oldest.uploaded.getTime() > cutoffMs) {
+				// Inside retention window — skip.
+				shouldDelete = false
+				log?.({
+					event: 'prune_skipped_within_retention',
+					deploymentId,
+					oldestUploaded: oldest.uploaded.toISOString(),
+					retentionDays,
+				})
+			}
+		}
+
+		if (!shouldDelete) continue
+
+		try {
+			for await (const key of listKeysByDeployment(freshLayer, deploymentId)) {
+				await deleteFreshTwin({ ...freshLayer, deploymentId }, keyToPath(deploymentId, key))
+				deletedForThisDeployment++
+			}
+			keysDeleted += deletedForThisDeployment
+			deploymentsPruned.push(deploymentId)
+			log?.({
+				event: 'prune_deployment',
+				deploymentId,
+				keysDeleted: deletedForThisDeployment,
+			})
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err)
+			errors.push(`deployment_${deploymentId}: ${msg}`)
+			log?.({ event: 'prune_error', deploymentId, message: msg })
+		}
+	}
+
+	return { deploymentsScanned, deploymentsPruned, keysDeleted, errors }
+}
+
+/**
+ * Convert a full R2/KV key back to the URL-path form used by deleteFreshTwin.
+ * Inverse of fresh-layer buildKey.
+ */
+function keyToPath(deploymentId: string, key: string): string {
+	const prefix = `twin/${deploymentId}/`
+	return key.startsWith(prefix) ? `/${key.slice(prefix.length)}` : `/${key}`
+}

package/src/durable-objects/aeo-revalidation-coord.ts

@@ -0,0 +1,246 @@
+// Revalidation Coordinator — a single Durable Object class that manages three
+// concerns for the revalidation endpoint and middleware fallthrough path:
+//
+//   rl:<token>          — token-bucket rate-limit state (10 RPM per token)
+//   lock:<slug>         — per-slug advisory lock (30s max hold)
+//   idempotency:<key>   — response dedup cache (10-minute TTL)
+//
+// One DO instance per request-hostname (derived from url.host at request time,
+// NOT build-time options.site). Multi-tenant Workers serving multiple domains
+// from one deployment get per-tenant isolation.
+//
+// Uses the async KV API (ctx.storage.get/put/delete/list) on the SQLite-backed
+// DO runtime — no raw SQL. TTL eviction runs via a self-scheduled 5-minute
+// alarm; if an alarm misses (Worker restart), the next write re-arms it.
+//
+// Export the class from `@growth-labs/seo/durable-objects`; consumers re-export
+// from their Worker entrypoint per Cloudflare DO conventions.
+
+// ─── Structural types ───
+
+export interface DurableObjectStorageLike {
+	get<T = unknown>(key: string): Promise<T | undefined>
+	put<T = unknown>(key: string, value: T): Promise<void>
+	delete(key: string): Promise<boolean>
+	list<T = unknown>(options: { prefix: string }): Promise<Map<string, T>>
+	setAlarm(scheduledTime: number): Promise<void>
+	getAlarm(): Promise<number | null>
+}
+
+export interface DurableObjectStateLike {
+	storage: DurableObjectStorageLike
+}
+
+// ─── Wire protocol ───
+
+export type CoordRequest =
+	| { action: 'rate-check'; token: string; limitRpm: number }
+	| { action: 'acquire-lock'; slug: string; leaseMs?: number }
+	| { action: 'release-lock'; slug: string; leaseId: string }
+	| { action: 'idempotency-check'; key: string }
+	| { action: 'idempotency-set'; key: string; result: Record<string, unknown>; ttlMs?: number }
+
+export type CoordResponse =
+	| { ok: true; [k: string]: unknown }
+	| { ok: false; error: string; [k: string]: unknown }
+
+interface RateLimitEntry {
+	tokens: number
+	lastRefill: number // epoch ms
+	capacity: number // RPM
+}
+
+interface LockEntry {
+	leaseId: string
+	expiresAt: number
+}
+
+interface IdempotencyEntry {
+	result: Record<string, unknown>
+	expiresAt: number
+}
+
+const LOCK_DEFAULT_LEASE_MS = 30_000
+const IDEMPOTENCY_DEFAULT_TTL_MS = 10 * 60 * 1000
+const ALARM_INTERVAL_MS = 5 * 60 * 1000
+const RATE_LIMIT_MAX_IDLE_MS = 10 * 60 * 1000
+
+// ─── DO class ───
+
+export class AeoRevalidationCoordinator {
+	constructor(readonly ctx: DurableObjectStateLike) {}
+
+	/**
+	 * Dispatch a JSON-encoded CoordRequest. Returns a JSON response. Not a
+	 * public HTTP API — called from the consumer's Worker via the namespace
+	 * binding: `await stub.fetch(new Request('https://internal/', { method: 'POST', body: JSON.stringify(req) }))`.
+	 */
+	async fetch(request: Request): Promise<Response> {
+		if (request.method !== 'POST') {
+			return json({ ok: false, error: 'method_not_allowed' }, 405)
+		}
+		let body: CoordRequest
+		try {
+			body = (await request.json()) as CoordRequest
+		} catch {
+			return json({ ok: false, error: 'bad_json' }, 400)
+		}
+
+		await this.ensureAlarm()
+
+		switch (body.action) {
+			case 'rate-check':
+				return json(await this.rateCheck(body.token, body.limitRpm))
+			case 'acquire-lock':
+				return json(await this.acquireLock(body.slug, body.leaseMs ?? LOCK_DEFAULT_LEASE_MS))
+			case 'release-lock':
+				return json(await this.releaseLock(body.slug, body.leaseId))
+			case 'idempotency-check':
+				return json(await this.idempotencyCheck(body.key))
+			case 'idempotency-set':
+				return json(
+					await this.idempotencySet(
+						body.key,
+						body.result,
+						body.ttlMs ?? IDEMPOTENCY_DEFAULT_TTL_MS,
+					),
+				)
+			default:
+				return json({ ok: false, error: 'unknown_action' }, 400)
+		}
+	}
+
+	/**
+	 * Alarm handler: runs every 5 minutes, sweeps expired entries across all
+	 * three namespaces. Self-re-arming.
+	 */
+	async alarm(): Promise<void> {
+		const now = Date.now()
+
+		// rate-limit: delete token buckets that haven't been refilled in >10 min.
+		const rlEntries = await this.ctx.storage.list<RateLimitEntry>({ prefix: 'rl:' })
+		for (const [key, entry] of rlEntries) {
+			if (now - entry.lastRefill > RATE_LIMIT_MAX_IDLE_MS) {
+				await this.ctx.storage.delete(key)
+			}
+		}
+
+		// lock: delete expired leases.
+		const lockEntries = await this.ctx.storage.list<LockEntry>({ prefix: 'lock:' })
+		for (const [key, entry] of lockEntries) {
+			if (now >= entry.expiresAt) await this.ctx.storage.delete(key)
+		}
+
+		// idempotency: delete expired entries.
+		const idemEntries = await this.ctx.storage.list<IdempotencyEntry>({ prefix: 'idempotency:' })
+		for (const [key, entry] of idemEntries) {
+			if (now >= entry.expiresAt) await this.ctx.storage.delete(key)
+		}
+
+		// Re-arm the alarm.
+		await this.ctx.storage.setAlarm(now + ALARM_INTERVAL_MS)
+	}
+
+	// ─── Rate limit ───
+
+	private async rateCheck(token: string, limitRpm: number): Promise<CoordResponse> {
+		const key = `rl:${token}`
+		const now = Date.now()
+		const existing = await this.ctx.storage.get<RateLimitEntry>(key)
+		const refillRate = limitRpm / 60_000 // tokens per ms
+		let tokens: number
+		if (existing) {
+			const elapsed = now - existing.lastRefill
+			tokens = Math.min(limitRpm, existing.tokens + elapsed * refillRate)
+		} else {
+			tokens = limitRpm
+		}
+		if (tokens < 1) {
+			const retryAfterMs = Math.ceil((1 - tokens) / refillRate)
+			return { ok: false, error: 'rate_limited', retryAfterMs }
+		}
+		const next: RateLimitEntry = { tokens: tokens - 1, lastRefill: now, capacity: limitRpm }
+		await this.ctx.storage.put(key, next)
+		return { ok: true, remaining: Math.floor(next.tokens) }
+	}
+
+	// ─── Per-slug lock ───
+
+	private async acquireLock(slug: string, leaseMs: number): Promise<CoordResponse> {
+		const key = `lock:${slug}`
+		const now = Date.now()
+		const existing = await this.ctx.storage.get<LockEntry>(key)
+		if (existing && now < existing.expiresAt) {
+			return { ok: false, error: 'locked', expiresAt: existing.expiresAt }
+		}
+		const leaseId = newLeaseId()
+		const entry: LockEntry = { leaseId, expiresAt: now + leaseMs }
+		await this.ctx.storage.put(key, entry)
+		return { ok: true, leaseId, expiresAt: entry.expiresAt }
+	}
+
+	private async releaseLock(slug: string, leaseId: string): Promise<CoordResponse> {
+		const key = `lock:${slug}`
+		const existing = await this.ctx.storage.get<LockEntry>(key)
+		if (!existing) return { ok: true, note: 'not_held' }
+		if (existing.leaseId !== leaseId) {
+			return { ok: false, error: 'lease_mismatch' }
+		}
+		await this.ctx.storage.delete(key)
+		return { ok: true }
+	}
+
+	// ─── Idempotency ───
+
+	private async idempotencyCheck(key: string): Promise<CoordResponse> {
+		const storageKey = `idempotency:${key}`
+		const entry = await this.ctx.storage.get<IdempotencyEntry>(storageKey)
+		if (!entry || Date.now() >= entry.expiresAt) {
+			return { ok: true, hit: false }
+		}
+		return { ok: true, hit: true, result: entry.result }
+	}
+
+	private async idempotencySet(
+		key: string,
+		result: Record<string, unknown>,
+		ttlMs: number,
+	): Promise<CoordResponse> {
+		const storageKey = `idempotency:${key}`
+		const entry: IdempotencyEntry = { result, expiresAt: Date.now() + ttlMs }
+		await this.ctx.storage.put(storageKey, entry)
+		return { ok: true }
+	}
+
+	// ─── Alarm management ───
+
+	private async ensureAlarm(): Promise<void> {
+		const current = await this.ctx.storage.getAlarm()
+		if (current === null) {
+			await this.ctx.storage.setAlarm(Date.now() + ALARM_INTERVAL_MS)
+		}
+	}
+}
+
+// ─── Helpers ───
+
+function json(body: CoordResponse, status = 200): Response {
+	return new Response(JSON.stringify(body), {
+		status,
+		headers: { 'content-type': 'application/json' },
+	})
+}
+
+function newLeaseId(): string {
+	const bytes = new Uint8Array(16)
+	crypto.getRandomValues(bytes)
+	let hex = ''
+	for (const b of bytes) hex += b.toString(16).padStart(2, '0')
+	return hex
+}
+
+export const _internals = {
+	LOCK_DEFAULT_LEASE_MS,
+	IDEMPOTENCY_DEFAULT_TTL_MS,
+	ALARM_INTERVAL_MS,
+}