emdash 0.39.0 → 0.40.0

package/dist/object-cache-DlSVbn5Y.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"object-cache-DlSVbn5Y.mjs","names":[],"sources":["../src/object-cache/codec.ts","../src/object-cache/index.ts"],"sourcesContent":["/**\n * Object-cache serialization codec.\n *\n * Cached values are JSON, with one extension: `Date` instances are preserved\n * across the round-trip. EmDash content entries carry `Date` objects for the\n * system timestamp columns (`createdAt`, `updatedAt`, `publishedAt`,\n * `scheduledAt`) and on `cacheHint.lastModified`; plain `JSON.stringify` would\n * silently flatten those to ISO strings, so a value read from cache would no\n * longer be `=== instanceof Date` and downstream `value instanceof Date`\n * branches (cursor encoding, scheduled-visibility checks) would diverge from a\n * fresh database read.\n *\n * Functions and symbol-keyed properties are NOT preserved — callers that cache\n * values carrying either (e.g. content entries with their `.edit` proxy and\n * the non-enumerable `CURSOR_RAW_VALUES` symbol) must reduce to a serializable\n * snapshot before caching and rebuild the non-serializable parts on read. See\n * `query.ts` content snapshot helpers.\n */\n\n/** Tag used to mark a serialized `Date`. Deliberately unlikely to collide. */\nconst DATE_TAG = \"$$emdashDate\";\n\ninterface TaggedDate {\n\t[DATE_TAG]: string;\n}\n\nfunction isTaggedDate(value: unknown): value is TaggedDate {\n\tif (typeof value !== \"object\" || value === null) return false;\n\t// encode() always emits the tag as the object's *only* key, so requiring\n\t// exactly one key keeps a user object that merely happens to carry a\n\t// `$$emdashDate` string alongside other fields from being collapsed to a\n\t// Date (which would silently drop those other fields).\n\tconst keys = Object.keys(value);\n\t// eslint-disable-next-line typescript/no-unsafe-type-assertion -- narrowing a JSON-parsed value to read the date tag\n\treturn keys.length === 1 && typeof (value as Record<string, unknown>)[DATE_TAG] === \"string\";\n}\n\n/**\n * Serialize a value to a cache string, preserving `Date` instances.\n *\n * Uses the JSON replacer's `this` binding to inspect the *original* property\n * value: `JSON.stringify` invokes `Date.prototype.toJSON` before the replacer\n * sees it, so by the time `value` arrives it is already an ISO string. Reading\n * `this[key]` recovers the live `Date` so we can tag it.\n */\nexport function encode(value: unknown): string {\n\treturn JSON.stringify(value, function (this: Record<string, unknown>, key, val) {\n\t\tconst original = this[key];\n\t\tif (original instanceof Date) {\n\t\t\treturn { [DATE_TAG]: original.toISOString() } satisfies TaggedDate;\n\t\t}\n\t\treturn val;\n\t});\n}\n\n/**\n * Parse a cache string produced by {@link encode}, rehydrating tagged `Date`s.\n *\n * Returns `undefined` if the input is not valid JSON (treated as a cache miss\n * by the read-through layer rather than throwing).\n */\nexport function decode(raw: string): unknown {\n\ttry {\n\t\treturn JSON.parse(raw, (_key, value) => {\n\t\t\tif (isTaggedDate(value)) {\n\t\t\t\treturn new Date(value[DATE_TAG]);\n\t\t\t}\n\t\t\treturn value;\n\t\t});\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n","/**\n * Object cache — distributed read-through query cache.\n *\n * Layering (per query):\n *\n *   requestCached   → in-request dedupe (per render, WeakMap on ALS context)\n *   cachedQuery     → THIS layer: distributed L2 (KV / memory), epoch-keyed\n *   database        → source of truth\n *\n * Optional and off by default: when no `objectCache` descriptor is configured,\n * `virtual:emdash/object-cache` exports `createObjectCache = undefined`,\n * {@link getBackend} resolves to `null`, and {@link cachedQuery} is a\n * transparent passthrough to its `load` function. Configure with\n * `memoryCache()` (Node) or `kvCache()` from `@emdash-cms/cloudflare`.\n *\n * Invalidation is epoch-based: each cache key embeds a per-namespace epoch\n * (\"last changed\" marker) read from the backend. A write calls\n * {@link invalidateObjectCache}, which stamps the namespace epoch to\n * `Date.now()`; every previously-stored key for that namespace is instantly\n * orphaned and reclaimed by its TTL. This is O(1) and needs no key\n * enumeration (KV has no prefix delete).\n *\n * The singleton backend/config and the per-isolate epoch cache live on\n * `globalThis` behind `Symbol.for` keys so Vite SSR chunk duplication can't\n * fork them (same pattern as `request-context.ts`).\n */\n\nimport { after } from \"../after.js\";\nimport { getRequestContext } from \"../request-context.js\";\nimport { decode, encode } from \"./codec.js\";\nimport type {\n\tCreateObjectCacheBackendFn,\n\tObjectCacheBackend,\n\tObjectCacheRuntimeConfig,\n} from \"./types.js\";\n\nconst DEFAULT_KEY_PREFIX = \"em\";\nconst DEFAULT_TTL_SECONDS = 3600;\nconst DEFAULT_REVALIDATE_MS = 1000;\nconst DEFAULT_TIMEOUT_MS = 2000;\n\ninterface BackendHolder {\n\t/** Whether the virtual module has been loaded and the backend resolved. */\n\tinitialized: boolean;\n\t/** Resolved backend, or `null` when no object cache is configured. */\n\tbackend: ObjectCacheBackend | null;\n\t/** In-flight initialization promise (dedupes concurrent first calls). */\n\tinitPromise: Promise<ObjectCacheBackend | null> | null;\n\t/** `Date.now()` when the in-flight initialization started. */\n\tinitPromiseAt?: number;\n\tconfig: Required<Pick<ObjectCacheRuntimeConfig, \"keyPrefix\">> & {\n\t\tdefaultTtl: number;\n\t\trevalidate: number;\n\t\ttimeout: number;\n\t};\n}\n\n/**\n * Race a backend operation against a timeout so a stalled call (e.g. a KV read\n * that never resolves *and* never rejects — a cold cross-region read, or one\n * queued behind the Workers simultaneous-connection limit) degrades to a\n * rejection instead of hanging the isolate. A rejection is benign: callers\n * already treat a failed read as a cache miss / last-known epoch.\n */\nfunction withTimeout<T>(promise: Promise<T>, ms: number, label: string): Promise<T> {\n\tif (!(ms > 0)) return promise;\n\tlet timer: ReturnType<typeof setTimeout>;\n\tconst timeout = new Promise<never>((_resolve, reject) => {\n\t\ttimer = setTimeout(() => {\n\t\t\treject(new Error(`object-cache ${label} timed out after ${ms}ms`));\n\t\t}, ms);\n\t});\n\treturn Promise.race([promise, timeout]).finally(() => clearTimeout(timer));\n}\n\ninterface EpochEntry {\n\tvalue: number;\n\t/** `Date.now()` at which this epoch was read from the backend. */\n\tat: number;\n\t/** In-flight read, so concurrent callers share one backend round-trip. */\n\tpromise?: Promise<number>;\n\t/**\n\t * `Date.now()` at which the in-flight read started. Callers use it to\n\t * decide whether the read's owner can still be alive (see\n\t * {@link epochReadDeadline}) — past the deadline the promise is presumed\n\t * dead and the next caller reclaims by starting a fresh read.\n\t */\n\tpromiseAt?: number;\n}\n\n/**\n * Extra time past the configured read timeout before an in-flight epoch read\n * is presumed dead. A live owner's read settles within `timeout` (enforced by\n * {@link withTimeout}), so the grace only needs to absorb scheduling jitter.\n */\nconst EPOCH_READ_GRACE_MS = 1_000;\n\n/**\n * How long an in-flight epoch read may be trusted. A read older than this can\n * only exist because its owning request was cancelled mid-await — on workerd\n * a cancelled request's continuations never run, *including the timeout's own\n * `setTimeout` callback*, so the shared promise never settles and is never\n * replaced. With the timeout disabled (`timeout: 0`) the default is used as\n * the deadline; the worst case of guessing too short is one duplicate\n * backend read.\n */\nfunction epochReadDeadline(): number {\n\tconst timeout = holder.config.timeout > 0 ? holder.config.timeout : DEFAULT_TIMEOUT_MS;\n\treturn timeout + EPOCH_READ_GRACE_MS;\n}\n\n/**\n * Await another request's in-flight epoch read, bounded by the waiter's own\n * timer. The bare promise must never be awaited across requests: if the\n * owning request is cancelled, the promise never settles (see\n * {@link epochReadDeadline}) and an unguarded waiter hangs until the isolate\n * is evicted. The race timer below belongs to the *waiter's* request context\n * and therefore always fires; on timeout the waiter degrades to `fallback`\n * (the last known epoch), the same contract as a failed backend read.\n */\nfunction raceInFlightEpochRead(\n\tpromise: Promise<number>,\n\tms: number,\n\tfallback: number,\n): Promise<number> {\n\tlet timer: ReturnType<typeof setTimeout>;\n\tconst timeout = new Promise<number>((resolve) => {\n\t\ttimer = setTimeout(resolve, Math.max(ms, 1), fallback);\n\t});\n\treturn Promise.race([promise, timeout]).finally(() => clearTimeout(timer));\n}\n\n/** Bound a waiter on another request's backend initialization. */\nfunction raceInFlightBackendInit(\n\tpromise: Promise<ObjectCacheBackend | null>,\n\tms: number,\n): Promise<ObjectCacheBackend | null> {\n\tlet timer: ReturnType<typeof setTimeout>;\n\tconst timeout = new Promise<ObjectCacheBackend | null>((resolve) => {\n\t\ttimer = setTimeout(resolve, Math.max(ms, 1), null);\n\t});\n\treturn Promise.race([promise, timeout]).finally(() => clearTimeout(timer));\n}\n\nconst BACKEND_KEY = Symbol.for(\"emdash:object-cache:backend\");\nconst EPOCH_KEY = Symbol.for(\"emdash:object-cache:epochs\");\nconst PENDING_KEY = Symbol.for(\"emdash:object-cache:pending-bumps\");\nconst LAST_CONTENT_WRITE_KEY = Symbol.for(\"emdash:object-cache:last-content-write\");\nconst PENDING_CONTENT_WRITE_KEY = Symbol.for(\"emdash:object-cache:pending-content-write\");\nconst g = globalThis as Record<symbol, unknown>;\n\nconst holder: BackendHolder =\n\t// eslint-disable-next-line typescript/no-unsafe-type-assertion -- globalThis singleton pattern (see request-context.ts)\n\t(g[BACKEND_KEY] as BackendHolder | undefined) ??\n\t(() => {\n\t\tconst h: BackendHolder = {\n\t\t\tinitialized: false,\n\t\t\tbackend: null,\n\t\t\tinitPromise: null,\n\t\t\tconfig: {\n\t\t\t\tkeyPrefix: DEFAULT_KEY_PREFIX,\n\t\t\t\tdefaultTtl: DEFAULT_TTL_SECONDS,\n\t\t\t\trevalidate: DEFAULT_REVALIDATE_MS,\n\t\t\t\ttimeout: DEFAULT_TIMEOUT_MS,\n\t\t\t},\n\t\t};\n\t\tg[BACKEND_KEY] = h;\n\t\treturn h;\n\t})();\n\nconst epochCache: Map<string, EpochEntry> =\n\t// eslint-disable-next-line typescript/no-unsafe-type-assertion -- globalThis singleton pattern (see request-context.ts)\n\t(g[EPOCH_KEY] as Map<string, EpochEntry> | undefined) ??\n\t(() => {\n\t\tconst m = new Map<string, EpochEntry>();\n\t\tg[EPOCH_KEY] = m;\n\t\treturn m;\n\t})();\n\n/** Namespaces with a backend epoch write already scheduled this tick. */\nconst pendingBumps: Set<string> =\n\t// eslint-disable-next-line typescript/no-unsafe-type-assertion -- globalThis singleton pattern (see request-context.ts)\n\t(g[PENDING_KEY] as Set<string> | undefined) ??\n\t(() => {\n\t\tconst s = new Set<string>();\n\t\tg[PENDING_KEY] = s;\n\t\treturn s;\n\t})();\n\n/**\n * Isolate-local ms-epoch of the last content-namespace invalidation, plus a\n * cached backend read (same revalidate window as epochs). Adapters that need\n * to prefer fresh SQL after a publish (e.g. Hyperdrive `cachedBinding`) read\n * this via {@link getLastContentWriteAt}.\n */\ninterface LastContentWriteState {\n\t/** Local / merged stamp; 0 if never set in this isolate. */\n\tvalue: number;\n\t/** `Date.now()` when `value` was last confirmed from the backend (or local stamp). */\n\tat: number;\n\tpromise?: Promise<number>;\n\tpromiseAt?: number;\n}\n\nconst lastContentWrite: LastContentWriteState =\n\t// eslint-disable-next-line typescript/no-unsafe-type-assertion -- globalThis singleton pattern (see request-context.ts)\n\t(g[LAST_CONTENT_WRITE_KEY] as LastContentWriteState | undefined) ??\n\t(() => {\n\t\tconst s: LastContentWriteState = { value: 0, at: 0 };\n\t\tg[LAST_CONTENT_WRITE_KEY] = s;\n\t\treturn s;\n\t})();\n\n/** Whether a backend persist of the content-write stamp is already scheduled. */\nconst contentWritePersist: { pending: boolean } =\n\t// eslint-disable-next-line typescript/no-unsafe-type-assertion -- globalThis singleton pattern (see request-context.ts)\n\t(g[PENDING_CONTENT_WRITE_KEY] as { pending: boolean } | undefined) ??\n\t(() => {\n\t\tconst s = { pending: false };\n\t\tg[PENDING_CONTENT_WRITE_KEY] = s;\n\t\treturn s;\n\t})();\n/**\n * Resolve (once per isolate) the configured object-cache backend.\n *\n * Loads `virtual:emdash/object-cache`, which exports `createObjectCache`\n * (`undefined` when no cache is configured) and the serialized\n * `objectCacheConfig`. Returns `null` when the cache is disabled.\n */\nasync function getBackend(): Promise<ObjectCacheBackend | null> {\n\tif (holder.initialized) return holder.backend;\n\tif (holder.initPromise) {\n\t\tconst age = Date.now() - (holder.initPromiseAt ?? 0);\n\t\tconst deadline = epochReadDeadline();\n\t\tif (age < deadline) {\n\t\t\treturn raceInFlightBackendInit(holder.initPromise, deadline - age);\n\t\t}\n\t}\n\n\tholder.initPromiseAt = Date.now();\n\tholder.initPromise = (async () => {\n\t\ttry {\n\t\t\tconst mod: {\n\t\t\t\tcreateObjectCache?: CreateObjectCacheBackendFn;\n\t\t\t\tobjectCacheConfig?: ObjectCacheRuntimeConfig;\n\t\t\t\t// eslint-disable-next-line @typescript-eslint/ban-ts-comment\n\t\t\t\t// @ts-ignore - virtual module\n\t\t\t} = await import(\"virtual:emdash/object-cache\");\n\n\t\t\tconst config = mod.objectCacheConfig ?? {};\n\t\t\tholder.config = {\n\t\t\t\tkeyPrefix:\n\t\t\t\t\ttypeof config.keyPrefix === \"string\" && config.keyPrefix.length > 0\n\t\t\t\t\t\t? config.keyPrefix\n\t\t\t\t\t\t: DEFAULT_KEY_PREFIX,\n\t\t\t\tdefaultTtl:\n\t\t\t\t\ttypeof config.defaultTtl === \"number\" && config.defaultTtl > 0\n\t\t\t\t\t\t? config.defaultTtl\n\t\t\t\t\t\t: DEFAULT_TTL_SECONDS,\n\t\t\t\trevalidate:\n\t\t\t\t\ttypeof config.revalidate === \"number\" && config.revalidate >= 0\n\t\t\t\t\t\t? config.revalidate\n\t\t\t\t\t\t: DEFAULT_REVALIDATE_MS,\n\t\t\t\ttimeout:\n\t\t\t\t\ttypeof config.timeout === \"number\" && config.timeout >= 0\n\t\t\t\t\t\t? config.timeout\n\t\t\t\t\t\t: DEFAULT_TIMEOUT_MS,\n\t\t\t};\n\n\t\t\tholder.backend =\n\t\t\t\ttypeof mod.createObjectCache === \"function\" ? mod.createObjectCache(config) : null;\n\t\t} catch (error) {\n\t\t\t// Importing the virtual module fails outside an Astro/Vite context\n\t\t\t// (e.g. unit tests, CLI). Treat as \"no cache configured\".\n\t\t\tif (import.meta.env?.DEV) {\n\t\t\t\tconsole.warn(\"[object-cache] backend unavailable:\", error);\n\t\t\t}\n\t\t\tholder.backend = null;\n\t\t}\n\t\tholder.initialized = true;\n\t\tholder.initPromise = null;\n\t\tholder.initPromiseAt = undefined;\n\t\treturn holder.backend;\n\t})();\n\n\tconst started = holder.initPromise;\n\tafter(() =>\n\t\tstarted.then(\n\t\t\t() => undefined,\n\t\t\t() => undefined,\n\t\t),\n\t);\n\n\treturn started;\n}\n\n/**\n * Test-only override of the backend, bypassing the virtual module.\n *\n * Lets unit tests inject an in-memory backend (and optional config) without a\n * full Astro/Vite build. Pass `null` to simulate \"no cache configured\".\n *\n * @internal\n */\nexport function __setObjectCacheBackendForTests(\n\tbackend: ObjectCacheBackend | null,\n\tconfig?: Partial<BackendHolder[\"config\"]>,\n): void {\n\tholder.initialized = true;\n\tholder.initPromise = null;\n\tholder.initPromiseAt = undefined;\n\tholder.backend = backend;\n\tholder.config = { ...holder.config, ...config };\n\tepochCache.clear();\n\tlastContentWrite.value = 0;\n\tlastContentWrite.at = 0;\n\tlastContentWrite.promise = undefined;\n\tlastContentWrite.promiseAt = undefined;\n\tcontentWritePersist.pending = false;\n}\n\n/** @internal */\nexport function __setObjectCacheBackendInitForTests(\n\tpromise: Promise<ObjectCacheBackend | null>,\n\tstartedAt: number,\n): void {\n\tholder.initialized = false;\n\tholder.backend = null;\n\tholder.initPromise = promise;\n\tholder.initPromiseAt = startedAt;\n}\n\n/** Build the backend key for a namespace's epoch anchor. */\nfunction epochKey(namespace: string): string {\n\treturn `${holder.config.keyPrefix}:epoch:${namespace}`;\n}\n\n/** Backend key for the shared \"last content write\" stamp (no short TTL). */\nfunction lastContentWriteKey(): string {\n\treturn `${holder.config.keyPrefix}:last-content-write-at`;\n}\n\nfunction isContentNamespace(namespace: string): boolean {\n\treturn namespace.startsWith(\"content:\");\n}\n/**\n * Build the (epoch-independent) backend key for a cached value.\n *\n * The key is stable across invalidations — the namespace epochs are stored\n * *inside* the value envelope and validated on read, not baked into the key.\n * This lets the value and the epochs be fetched in one parallel round-trip\n * (instead of \"read epoch, then read value\"), and means an invalidated value\n * is overwritten in place rather than orphaned under a dead epoch-keyed name.\n */\nfunction valueKey(namespaces: readonly string[], key: string): string {\n\treturn `${holder.config.keyPrefix}:${namespaces.join(\",\")}:${key}`;\n}\n\n/**\n * Stored cache envelope: the namespace epochs captured at write time alongside\n * the cached value. A read is a HIT only when every stored epoch still matches\n * the current epoch for its namespace.\n */\ninterface CacheEnvelope<T> {\n\t/** Epoch per namespace, in the query's namespace order. */\n\te: number[];\n\t/** The cached value. */\n\tv: T;\n}\n\nfunction epochsMatch(stored: readonly number[], current: readonly number[]): boolean {\n\tif (stored.length !== current.length) return false;\n\tfor (let i = 0; i < stored.length; i++) {\n\t\tif (stored[i] !== current[i]) return false;\n\t}\n\treturn true;\n}\n\n/**\n * Requests that must always read live data and never populate the cache:\n * visual edit mode, preview tokens, and isolated databases (playground / DO\n * preview, whose schema and content diverge from the configured site).\n */\nfunction shouldBypass(): boolean {\n\tconst ctx = getRequestContext();\n\tif (!ctx) return false;\n\treturn ctx.editMode === true || ctx.preview !== undefined || ctx.dbIsIsolated === true;\n}\n\n/**\n * Read the current epoch for `namespace`, reusing an isolate-cached value for\n * up to `revalidate` ms. A missing epoch (never bumped) is treated as `0`.\n *\n * Backend errors and stalls are non-fatal: the read is bounded by a timeout,\n * and on failure we fall back to the last known epoch (or `0`), so a flaky or\n * hung cache degrades to \"serve whatever's keyed\" rather than throwing or\n * hanging.\n */\nasync function getEpoch(namespace: string, backend: ObjectCacheBackend): Promise<number> {\n\tconst now = Date.now();\n\tconst cached = epochCache.get(namespace);\n\tif (cached && now - cached.at < holder.config.revalidate) {\n\t\treturn cached.value;\n\t}\n\tif (cached?.promise) {\n\t\t// Share the in-flight read only while its owner can still be alive,\n\t\t// and never await it bare (a cancelled owner's promise never settles;\n\t\t// see epochReadDeadline). Past the deadline, fall through and reclaim\n\t\t// with a fresh read — the dead entry is overwritten below.\n\t\tconst age = now - (cached.promiseAt ?? 0);\n\t\tconst deadline = epochReadDeadline();\n\t\tif (age < deadline) {\n\t\t\treturn raceInFlightEpochRead(cached.promise, deadline - age, cached.value);\n\t\t}\n\t}\n\n\tconst promise = (async () => {\n\t\tlet value: number;\n\t\ttry {\n\t\t\tconst raw = await withTimeout(\n\t\t\t\tbackend.get(epochKey(namespace)),\n\t\t\t\tholder.config.timeout,\n\t\t\t\t\"epoch read\",\n\t\t\t);\n\t\t\tconst parsed = raw === null ? 0 : Number(raw);\n\t\t\tvalue = Number.isFinite(parsed) ? parsed : 0;\n\t\t} catch {\n\t\t\tvalue = cached?.value ?? 0;\n\t\t}\n\t\t// A concurrent invalidateObjectCache may have bumped the epoch while this\n\t\t// read was in flight. Epochs are monotonic, so never let a stale backend\n\t\t// read lower a freshly-bumped local epoch — that would resurrect the very\n\t\t// values the bump just invalidated.\n\t\tconst merged = Math.max(value, epochCache.get(namespace)?.value ?? 0);\n\t\tepochCache.set(namespace, { value: merged, at: Date.now() });\n\t\treturn merged;\n\t})();\n\n\t// Anchor the read on the host's lifetime extender: if the owning request\n\t// is cancelled mid-await, the anchored copy keeps the read alive so it\n\t// still settles and its handler replaces this entry with a fresh,\n\t// promise-free one. Where no extender exists, the deadline reclaim above\n\t// recovers instead.\n\tafter(() =>\n\t\tpromise.then(\n\t\t\t() => undefined,\n\t\t\t() => undefined,\n\t\t),\n\t);\n\n\t// Concurrent callers share this in-flight read (dedup) — bounded by their\n\t// own timers via raceInFlightEpochRead, never awaited bare. The timeout\n\t// above makes a live owner's read settle; `promiseAt` lets callers detect\n\t// a dead one (cancelled owner) and reclaim.\n\tepochCache.set(namespace, {\n\t\tvalue: cached?.value ?? 0,\n\t\tat: cached?.at ?? 0,\n\t\tpromise,\n\t\tpromiseAt: now,\n\t});\n\treturn promise;\n}\n\n/** Options for {@link cachedQuery}. */\nexport interface CachedQueryOptions<T> {\n\t/**\n\t * Invalidation namespace(s). A single string for self-contained data\n\t * (`settings`, `menus`), or several when the cached value depends on data\n\t * owned by other namespaces — e.g. a content entry hydrates bylines and\n\t * taxonomy terms, so it caches under\n\t * `[content:posts, \"bylines\", \"taxonomies\"]` and is invalidated when *any*\n\t * of them is bumped. Every namespace's epoch is folded into the key.\n\t */\n\tnamespace: string | readonly string[];\n\t/** Stable, fully-qualifying cache key *within* the namespace. */\n\tkey: string;\n\t/** Loader run on a miss (or when caching is disabled/bypassed). */\n\tload: () => Promise<T>;\n\t/** TTL override in seconds. Falls back to the configured `defaultTtl`. */\n\tttl?: number;\n\t/**\n\t * Predicate gating whether a freshly-loaded value is stored. Defaults to\n\t * always-cache. Use it to skip caching error/empty sentinels.\n\t */\n\tcacheable?: (value: T) => boolean;\n}\n\n/**\n * Distributed read-through cache around `load`.\n *\n * `T` must be the value as it should be *stored* — i.e. JSON-serializable with\n * the codec's `Date` support, carrying no functions or symbol-keyed props.\n * Callers caching richer objects (content entries) reduce to a serializable\n * snapshot here and rebuild on the way out; see `query.ts`.\n *\n * On a miss or when the cache is disabled/bypassed, this is equivalent to\n * `await load()`. Backend errors never propagate: a failing `get` is a miss, a\n * failing `set` is dropped.\n */\nexport async function cachedQuery<T>(options: CachedQueryOptions<T>): Promise<T> {\n\tconst backend = await getBackend();\n\tif (!backend || shouldBypass()) {\n\t\treturn options.load();\n\t}\n\n\tconst namespaces =\n\t\ttypeof options.namespace === \"string\" ? [options.namespace] : options.namespace;\n\tconst fullKey = valueKey(namespaces, options.key);\n\n\t// Kick off the value read and every namespace epoch read concurrently — one\n\t// round-trip instead of \"read epochs, then read value\". getEpoch never\n\t// rejects, so awaiting the epochs separately from the value read guarantees\n\t// we hold the pre-load epochs even when the value read errors or times out.\n\t// Storing a value under an epoch read *after* load() would mask a write that\n\t// landed during load(): the stale value would match and be served as a HIT.\n\tconst epochsPromise = Promise.all(namespaces.map((ns) => getEpoch(ns, backend)));\n\tconst rawPromise = withTimeout(backend.get(fullKey), holder.config.timeout, \"read\").catch(\n\t\t() => null,\n\t);\n\tconst currentEpochs = await epochsPromise;\n\tconst raw = await rawPromise;\n\tif (raw !== null) {\n\t\tconst decoded = decode(raw);\n\t\tif (decoded !== undefined) {\n\t\t\t// eslint-disable-next-line typescript/no-unsafe-type-assertion -- value envelope written by this function\n\t\t\tconst envelope = decoded as CacheEnvelope<T>;\n\t\t\tif (epochsMatch(envelope.e, currentEpochs)) {\n\t\t\t\treturn envelope.v;\n\t\t\t}\n\t\t}\n\t}\n\n\tconst value = await options.load();\n\n\tconst cacheable = options.cacheable ? options.cacheable(value) : true;\n\tif (cacheable) {\n\t\tconst ttl = options.ttl ?? holder.config.defaultTtl;\n\t\t// Defer the write so it never adds to TTFB. The epochs were captured\n\t\t// before load() ran, so a write that invalidated this namespace mid-load\n\t\t// correctly orphans the value stored here.\n\t\tafter(async () => {\n\t\t\ttry {\n\t\t\t\tconst encoded = encode({ e: currentEpochs, v: value } satisfies CacheEnvelope<T>);\n\t\t\t\tawait backend.set(fullKey, encoded, ttl);\n\t\t\t} catch (error) {\n\t\t\t\tif (import.meta.env?.DEV) {\n\t\t\t\t\tconsole.warn(\"[object-cache] set failed:\", error);\n\t\t\t\t}\n\t\t\t}\n\t\t});\n\t}\n\n\treturn value;\n}\n\n/** Whether object-cache reads are active for the current request. */\nexport async function isObjectCacheActive(): Promise<boolean> {\n\tconst backend = await getBackend();\n\treturn backend !== null && !shouldBypass();\n}\n\n/**\n * Stamp the isolate-local + backend \"last content write\" marker when a\n * content collection namespace is invalidated. Used by DB adapters (Hyperdrive)\n * to briefly prefer uncached SQL after a publish so edge/object caches are not\n * reseeded from a stale query-cache hit.\n */\nfunction stampLastContentWrite(): void {\n\tconst stamp = Math.max(lastContentWrite.value + 1, Date.now());\n\tlastContentWrite.value = stamp;\n\tlastContentWrite.at = stamp;\n\t// Drop any in-flight backend read so it cannot lower a fresher local stamp.\n\tlastContentWrite.promise = undefined;\n\tlastContentWrite.promiseAt = undefined;\n\n\tif (contentWritePersist.pending) return;\n\tcontentWritePersist.pending = true;\n\tafter(async () => {\n\t\tcontentWritePersist.pending = false;\n\t\ttry {\n\t\t\tconst backend = await getBackend();\n\t\t\tif (!backend) return;\n\t\t\tconst latest = lastContentWrite.value;\n\t\t\t// Persistent (no TTL) — same contract as epoch anchors.\n\t\t\tawait backend.set(lastContentWriteKey(), String(latest));\n\t\t} catch (error) {\n\t\t\tconsole.error(\"[object-cache] last-content-write stamp failed:\", error);\n\t\t}\n\t});\n}\n\n/**\n * ms-epoch of the last content-namespace invalidation (`content:*`), or `0`\n * if unknown. Returns `max(local, backend)` so a warm isolate that just\n * published is immediately correct, and cold isolates learn within their\n * `revalidate` window after another isolate stamped the backend.\n */\nexport async function getLastContentWriteAt(): Promise<number> {\n\tconst local = lastContentWrite.value;\n\tconst now = Date.now();\n\t// Cache a confirmed miss (`0`) the same way as a positive stamp — otherwise\n\t// every logged-out request re-reads the backend until the first content write.\n\tif (now - lastContentWrite.at < holder.config.revalidate) {\n\t\treturn local;\n\t}\n\n\tconst backend = await getBackend();\n\tif (!backend) return local;\n\n\tif (lastContentWrite.promise) {\n\t\tconst age = now - (lastContentWrite.promiseAt ?? 0);\n\t\tconst deadline = epochReadDeadline();\n\t\tif (age < deadline) {\n\t\t\treturn raceInFlightEpochRead(lastContentWrite.promise, deadline - age, local);\n\t\t}\n\t}\n\n\tconst promise = (async () => {\n\t\tlet value: number;\n\t\ttry {\n\t\t\tconst raw = await withTimeout(\n\t\t\t\tbackend.get(lastContentWriteKey()),\n\t\t\t\tholder.config.timeout,\n\t\t\t\t\"last-content-write read\",\n\t\t\t);\n\t\t\tconst parsed = raw === null ? 0 : Number(raw);\n\t\t\tvalue = Number.isFinite(parsed) ? parsed : 0;\n\t\t} catch {\n\t\t\tvalue = lastContentWrite.value;\n\t\t}\n\t\tconst merged = Math.max(value, lastContentWrite.value);\n\t\tlastContentWrite.value = merged;\n\t\tlastContentWrite.at = Date.now();\n\t\tlastContentWrite.promise = undefined;\n\t\tlastContentWrite.promiseAt = undefined;\n\t\treturn merged;\n\t})();\n\n\tafter(() =>\n\t\tpromise.then(\n\t\t\t() => undefined,\n\t\t\t() => undefined,\n\t\t),\n\t);\n\n\tlastContentWrite.promise = promise;\n\tlastContentWrite.promiseAt = now;\n\treturn promise;\n}\n\n/**\n * Invalidate every cached value in `namespace` by bumping its epoch.\n *\n * Sync and non-blocking: the local epoch is stamped immediately (so the\n * writing isolate is instantly consistent) and the backend write is deferred\n * via `after`. Other isolates pick up the new epoch within their `revalidate`\n * window. No-ops when the cache is disabled.\n *\n * Content namespaces (`content:*`) also stamp {@link getLastContentWriteAt}.\n */\nexport function invalidateObjectCache(namespace: string): void {\n\t// Monotonic so two writes in the same millisecond still produce distinct\n\t// epochs — otherwise the second write reuses the first's stamp and its\n\t// stale entries survive.\n\tconst prev = epochCache.get(namespace)?.value ?? 0;\n\tconst stamp = Math.max(prev + 1, Date.now());\n\t// Optimistic local bump: keep this isolate consistent without a round-trip.\n\tepochCache.set(namespace, { value: stamp, at: stamp });\n\n\tif (isContentNamespace(namespace)) {\n\t\tstampLastContentWrite();\n\t}\n\n\t// Coalesce repeated bumps of the same namespace within a tick (e.g. a bulk\n\t// publish loop) into a single backend write that persists the latest epoch.\n\tif (pendingBumps.has(namespace)) return;\n\tpendingBumps.add(namespace);\n\tafter(async () => {\n\t\tpendingBumps.delete(namespace);\n\t\ttry {\n\t\t\tconst backend = await getBackend();\n\t\t\tif (!backend) return;\n\t\t\tconst latest = epochCache.get(namespace)?.value ?? stamp;\n\t\t\t// Epoch anchors are persistent (no TTL) — they must outlive the\n\t\t\t// value keys they invalidate.\n\t\t\tawait backend.set(epochKey(namespace), String(latest));\n\t\t} catch (error) {\n\t\t\tconsole.error(\"[object-cache] epoch bump failed for\", namespace, error);\n\t\t}\n\t});\n}\n/**\n * Fixed namespaces for data shared across collections. Content reads fold the\n * `BYLINES` and `TAXONOMIES` epochs into their keys (via {@link cachedQuery})\n * because entries hydrate byline and taxonomy-term data — so renaming an\n * author or a category correctly invalidates every cached entry that displays\n * it, without tracking which collections reference it.\n */\nexport const CacheNamespace = {\n\tSETTINGS: \"settings\",\n\tMENUS: \"menus\",\n\tTAXONOMIES: \"taxonomies\",\n\tBYLINES: \"bylines\",\n\t/** Collection schema/metadata (label, supports, commentsEnabled, fields). */\n\tSCHEMA: \"schema\",\n\t/** Public (approved) comments. */\n\tCOMMENTS: \"comments\",\n} as const;\n\n/** Namespace for a content collection's cached queries. */\nexport function contentNamespace(collection: string): string {\n\treturn `content:v2:${collection}`;\n}\n\nfunction legacyContentNamespace(collection: string): string {\n\treturn `content:${collection}`;\n}\n\n/**\n * Content epochs carried by current cache entries. The legacy epoch keeps\n * invalidation compatible with publishers from the previous release during a\n * rolling deployment; the versioned epoch makes old cached values unreachable.\n */\nexport function contentCacheNamespaces(collection: string): readonly string[] {\n\treturn [contentNamespace(collection), legacyContentNamespace(collection)];\n}\n\n/**\n * Namespaces a content read depends on: the collection itself plus the shared\n * byline/taxonomy data folded into each entry.\n */\nexport function contentNamespaces(collection: string): readonly string[] {\n\treturn [...contentCacheNamespaces(collection), CacheNamespace.BYLINES, CacheNamespace.TAXONOMIES];\n}\n\n/**\n * Invalidate all cached reads (list + entry) for a content collection.\n * Call from every write path that mutates rows in `ec_<collection>`.\n */\nexport function invalidateCollectionCache(collection: string): void {\n\tfor (const namespace of contentCacheNamespaces(collection)) {\n\t\tinvalidateObjectCache(namespace);\n\t}\n}\n\n/** Invalidate cached taxonomy definitions/terms and all content that hydrates them. */\nexport function invalidateTaxonomyObjectCache(): void {\n\tinvalidateObjectCache(CacheNamespace.TAXONOMIES);\n}\n\n/** Invalidate cached bylines and all content that hydrates them. */\nexport function invalidateBylineObjectCache(): void {\n\tinvalidateObjectCache(CacheNamespace.BYLINES);\n}\n\n/** Invalidate cached navigation menus. */\nexport function invalidateMenuObjectCache(): void {\n\tinvalidateObjectCache(CacheNamespace.MENUS);\n}\n\n/** Invalidate cached collection schema/metadata reads (e.g. getCollectionInfo). */\nexport function invalidateSchemaObjectCache(): void {\n\tinvalidateObjectCache(CacheNamespace.SCHEMA);\n}\n\n/** Invalidate cached public comment reads. */\nexport function invalidateCommentObjectCache(): void {\n\tinvalidateObjectCache(CacheNamespace.COMMENTS);\n}\n\nexport type {\n\tObjectCacheBackend,\n\tObjectCacheDescriptor,\n\tObjectCacheRuntimeConfig,\n} from \"./types.js\";\n"],"mappings":"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"}

package/dist/options-D5WcorD5.mjs

@@ -1,200 +0,0 @@
-import { sql } from "kysely";
-
-//#region src/plugins/conditional-storage.ts
-const MAX_KEY_LENGTH = 1024;
-const MAX_REVISION_LENGTH = 128;
-const MAX_VALUE_BYTES = 1024 * 1024;
-function assertStorageKey(key, maxLength = MAX_KEY_LENGTH) {
-	if (typeof key !== "string" || key.length === 0 || key.length > maxLength) throw new TypeError(`Storage key must be a nonempty string of at most ${maxLength} characters`);
-}
-function assertStorageRevision(revision) {
-	if (typeof revision !== "string" || revision.length === 0 || revision.length > MAX_REVISION_LENGTH) throw new TypeError("Storage revision must be a nonempty string of at most 128 characters");
-}
-function serializeConditionalValue(value) {
-	const serialized = JSON.stringify(value);
-	if (serialized === void 0) throw new TypeError("Storage value must be JSON serializable");
-	if (new TextEncoder().encode(serialized).byteLength > MAX_VALUE_BYTES) throw new TypeError("Conditional storage value must not exceed 1 MiB of JSON");
-	return serialized;
-}
-
-//#endregion
-//#region src/database/repositories/options.ts
-function escapeLike(value) {
-	return value.replaceAll("\\", "\\\\").replaceAll("%", "\\%").replaceAll("_", "\\_");
-}
-/**
-* Options repository for key-value settings storage
-*
-* Used for site settings, plugin configuration, and other arbitrary key-value data.
-* Values are stored as JSON for flexibility.
-*/
-var OptionsRepository = class {
-	constructor(db) {
-		this.db = db;
-	}
-	/**
-	* Get an option value
-	*/
-	async get(name) {
-		const row = await this.db.selectFrom("options").select("value").where("name", "=", name).executeTakeFirst();
-		if (!row) return null;
-		return JSON.parse(row.value);
-	}
-	/**
-	* Get an option value with a default
-	*/
-	async getOrDefault(name, defaultValue) {
-		return await this.get(name) ?? defaultValue;
-	}
-	/**
-	* Set an option value (creates or updates)
-	*/
-	async set(name, value) {
-		await this.setVersioned(name, value);
-	}
-	async setVersioned(name, value) {
-		const revision = crypto.randomUUID();
-		const row = {
-			name,
-			value: JSON.stringify(value),
-			revision
-		};
-		await this.db.insertInto("options").values(row).onConflict((oc) => oc.column("name").doUpdateSet({
-			value: row.value,
-			revision: row.revision
-		})).execute();
-		return revision;
-	}
-	/**
-	* Set an option value only if no row with that name exists. Atomic at the
-	* database level via INSERT ... ON CONFLICT DO NOTHING, so concurrent
-	* callers can't race past the check.
-	*
-	* Returns true when the row was inserted, false when a row already
-	* existed (regardless of its value — even an empty string or null).
-	*/
-	async setIfAbsent(name, value) {
-		const row = {
-			name,
-			value: JSON.stringify(value),
-			revision: crypto.randomUUID()
-		};
-		return ((await this.db.insertInto("options").values(row).onConflict((oc) => oc.column("name").doNothing()).executeTakeFirst()).numInsertedOrUpdatedRows ?? 0n) > 0n;
-	}
-	async getVersioned(name) {
-		assertStorageKey(name, 2048);
-		const row = await this.db.selectFrom("options").select(["value", "revision"]).where("name", "=", name).executeTakeFirst();
-		if (!row) return null;
-		return {
-			value: JSON.parse(row.value),
-			revision: row.revision
-		};
-	}
-	async compareAndSet(name, expectedRevision, value) {
-		assertStorageKey(name, 2048);
-		if (expectedRevision !== null) assertStorageRevision(expectedRevision);
-		const serialized = serializeConditionalValue(value);
-		const revision = crypto.randomUUID();
-		const row = expectedRevision === null ? await this.db.insertInto("options").values({
-			name,
-			value: serialized,
-			revision
-		}).onConflict((oc) => oc.column("name").doNothing()).returning("revision").executeTakeFirst() : await this.db.updateTable("options").set({
-			value: serialized,
-			revision
-		}).where("name", "=", name).where("revision", "=", expectedRevision).returning("revision").executeTakeFirst();
-		return row ? {
-			applied: true,
-			revision: row.revision
-		} : { applied: false };
-	}
-	async compareAndDelete(name, expectedRevision) {
-		assertStorageKey(name, 2048);
-		assertStorageRevision(expectedRevision);
-		return { applied: await this.db.deleteFrom("options").where("name", "=", name).where("revision", "=", expectedRevision).returning("name").executeTakeFirst() !== void 0 };
-	}
-	/**
-	* Delete an option
-	*/
-	async delete(name) {
-		return ((await this.db.deleteFrom("options").where("name", "=", name).executeTakeFirst()).numDeletedRows ?? 0) > 0;
-	}
-	/**
-	* Check if an option exists
-	*/
-	async exists(name) {
-		return !!await this.db.selectFrom("options").select("name").where("name", "=", name).executeTakeFirst();
-	}
-	/**
-	* Get multiple options at once
-	*/
-	async getMany(names) {
-		if (names.length === 0) return /* @__PURE__ */ new Map();
-		const rows = await this.db.selectFrom("options").select(["name", "value"]).where("name", "in", names).execute();
-		const result = /* @__PURE__ */ new Map();
-		for (const row of rows) result.set(row.name, JSON.parse(row.value));
-		return result;
-	}
-	/**
-	* Set multiple options at once
-	*/
-	async setMany(options) {
-		const entries = Object.entries(options);
-		if (entries.length === 0) return;
-		for (const [name, value] of entries) await this.set(name, value);
-	}
-	/**
-	* Get all options (use sparingly)
-	*/
-	async getAll() {
-		const rows = await this.db.selectFrom("options").select(["name", "value"]).execute();
-		const result = /* @__PURE__ */ new Map();
-		for (const row of rows) result.set(row.name, JSON.parse(row.value));
-		return result;
-	}
-	/**
-	* Get all options matching a prefix
-	*/
-	async getByPrefix(prefix, options = {}) {
-		const pattern = `${escapeLike(prefix)}%`;
-		let query = this.db.selectFrom("options").select(["name", "value"]).where(sql`name LIKE ${pattern} ESCAPE '\\'`).orderBy("name", "asc");
-		if (options.limit !== void 0) query = query.limit(Math.max(0, options.limit));
-		const rows = await query.execute();
-		const result = /* @__PURE__ */ new Map();
-		for (const row of rows) result.set(row.name, JSON.parse(row.value));
-		return result;
-	}
-	async getVersionedByPrefix(prefix, options = {}) {
-		const pattern = `${escapeLike(prefix)}%`;
-		let query = this.db.selectFrom("options").select([
-			"name",
-			"value",
-			"revision"
-		]).where(sql`name LIKE ${pattern} ESCAPE '\\'`).orderBy("name", "asc");
-		if (options.limit !== void 0) query = query.limit(Math.max(0, options.limit));
-		const rows = await query.execute();
-		const result = /* @__PURE__ */ new Map();
-		for (const row of rows) result.set(row.name, {
-			value: JSON.parse(row.value),
-			revision: row.revision
-		});
-		return result;
-	}
-	async countByPrefix(prefix) {
-		const pattern = `${escapeLike(prefix)}%`;
-		const row = await this.db.selectFrom("options").select((eb) => eb.fn.countAll().as("count")).where(sql`name LIKE ${pattern} ESCAPE '\\'`).executeTakeFirst();
-		return Number(row?.count ?? 0);
-	}
-	/**
-	* Delete all options matching a prefix
-	*/
-	async deleteByPrefix(prefix) {
-		const pattern = `${escapeLike(prefix)}%`;
-		const result = await this.db.deleteFrom("options").where(sql`name LIKE ${pattern} ESCAPE '\\'`).executeTakeFirst();
-		return Number(result.numDeletedRows ?? 0);
-	}
-};
-
-//#endregion
-export { serializeConditionalValue as i, assertStorageKey as n, assertStorageRevision as r, OptionsRepository as t };
-//# sourceMappingURL=options-D5WcorD5.mjs.map

package/dist/options-D5WcorD5.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"options-D5WcorD5.mjs","names":[],"sources":["../src/plugins/conditional-storage.ts","../src/database/repositories/options.ts"],"sourcesContent":["const MAX_KEY_LENGTH = 1024;\nconst MAX_REVISION_LENGTH = 128;\nconst MAX_VALUE_BYTES = 1024 * 1024;\n\nexport function assertStorageKey(key: unknown, maxLength = MAX_KEY_LENGTH): asserts key is string {\n\tif (typeof key !== \"string\" || key.length === 0 || key.length > maxLength) {\n\t\tthrow new TypeError(`Storage key must be a nonempty string of at most ${maxLength} characters`);\n\t}\n}\n\nexport function assertStorageRevision(revision: unknown): asserts revision is string {\n\tif (\n\t\ttypeof revision !== \"string\" ||\n\t\trevision.length === 0 ||\n\t\trevision.length > MAX_REVISION_LENGTH\n\t) {\n\t\tthrow new TypeError(\"Storage revision must be a nonempty string of at most 128 characters\");\n\t}\n}\n\nexport function serializeConditionalValue(value: unknown): string {\n\tconst serialized = JSON.stringify(value);\n\tif (serialized === undefined) {\n\t\tthrow new TypeError(\"Storage value must be JSON serializable\");\n\t}\n\tif (new TextEncoder().encode(serialized).byteLength > MAX_VALUE_BYTES) {\n\t\tthrow new TypeError(\"Conditional storage value must not exceed 1 MiB of JSON\");\n\t}\n\treturn serialized;\n}\n","import { sql, type Insertable, type Kysely, type SqlBool } from \"kysely\";\n\nimport {\n\tassertStorageKey,\n\tassertStorageRevision,\n\tserializeConditionalValue,\n} from \"../../plugins/conditional-storage.js\";\nimport type {\n\tVersionedValue,\n\tConditionalWriteResult,\n\tConditionalDeleteResult,\n} from \"../../plugins/types.js\";\nimport type { Database, OptionTable } from \"../types.js\";\n\nfunction escapeLike(value: string): string {\n\treturn value.replaceAll(\"\\\\\", \"\\\\\\\\\").replaceAll(\"%\", \"\\\\%\").replaceAll(\"_\", \"\\\\_\");\n}\n\n/**\n * Options repository for key-value settings storage\n *\n * Used for site settings, plugin configuration, and other arbitrary key-value data.\n * Values are stored as JSON for flexibility.\n */\nexport class OptionsRepository {\n\tconstructor(private db: Kysely<Database>) {}\n\n\t/**\n\t * Get an option value\n\t */\n\tasync get<T = unknown>(name: string): Promise<T | null> {\n\t\tconst row = await this.db\n\t\t\t.selectFrom(\"options\")\n\t\t\t.select(\"value\")\n\t\t\t.where(\"name\", \"=\", name)\n\t\t\t.executeTakeFirst();\n\n\t\tif (!row) return null;\n\t\t// eslint-disable-next-line typescript/no-unsafe-type-assertion -- JSON.parse returns any; generic callers provide T\n\t\treturn JSON.parse(row.value) as T;\n\t}\n\n\t/**\n\t * Get an option value with a default\n\t */\n\tasync getOrDefault<T>(name: string, defaultValue: T): Promise<T> {\n\t\tconst value = await this.get<T>(name);\n\t\treturn value ?? defaultValue;\n\t}\n\n\t/**\n\t * Set an option value (creates or updates)\n\t */\n\tasync set<T = unknown>(name: string, value: T): Promise<void> {\n\t\tawait this.setVersioned(name, value);\n\t}\n\n\tasync setVersioned<T = unknown>(name: string, value: T): Promise<string> {\n\t\tconst revision = crypto.randomUUID();\n\t\tconst row: Insertable<OptionTable> = {\n\t\t\tname,\n\t\t\tvalue: JSON.stringify(value),\n\t\t\trevision,\n\t\t};\n\n\t\t// Upsert: insert or replace\n\t\tawait this.db\n\t\t\t.insertInto(\"options\")\n\t\t\t.values(row)\n\t\t\t.onConflict((oc) =>\n\t\t\t\toc.column(\"name\").doUpdateSet({ value: row.value, revision: row.revision }),\n\t\t\t)\n\t\t\t.execute();\n\t\treturn revision;\n\t}\n\n\t/**\n\t * Set an option value only if no row with that name exists. Atomic at the\n\t * database level via INSERT ... ON CONFLICT DO NOTHING, so concurrent\n\t * callers can't race past the check.\n\t *\n\t * Returns true when the row was inserted, false when a row already\n\t * existed (regardless of its value — even an empty string or null).\n\t */\n\tasync setIfAbsent<T = unknown>(name: string, value: T): Promise<boolean> {\n\t\tconst row: Insertable<OptionTable> = {\n\t\t\tname,\n\t\t\tvalue: JSON.stringify(value),\n\t\t\trevision: crypto.randomUUID(),\n\t\t};\n\n\t\tconst result = await this.db\n\t\t\t.insertInto(\"options\")\n\t\t\t.values(row)\n\t\t\t.onConflict((oc) => oc.column(\"name\").doNothing())\n\t\t\t.executeTakeFirst();\n\n\t\t// SQLite reports numInsertedOrUpdatedRows; Postgres reports the same.\n\t\t// When the ON CONFLICT branch fires and does nothing, the count is 0.\n\t\treturn (result.numInsertedOrUpdatedRows ?? 0n) > 0n;\n\t}\n\n\tasync getVersioned<T = unknown>(name: string): Promise<VersionedValue<T> | null> {\n\t\tassertStorageKey(name, 2048);\n\t\tconst row = await this.db\n\t\t\t.selectFrom(\"options\")\n\t\t\t.select([\"value\", \"revision\"])\n\t\t\t.where(\"name\", \"=\", name)\n\t\t\t.executeTakeFirst();\n\t\tif (!row) return null;\n\t\treturn { value: JSON.parse(row.value), revision: row.revision };\n\t}\n\n\tasync compareAndSet(\n\t\tname: string,\n\t\texpectedRevision: string | null,\n\t\tvalue: unknown,\n\t): Promise<ConditionalWriteResult> {\n\t\tassertStorageKey(name, 2048);\n\t\tif (expectedRevision !== null) assertStorageRevision(expectedRevision);\n\t\tconst serialized = serializeConditionalValue(value);\n\t\tconst revision = crypto.randomUUID();\n\t\tconst row =\n\t\t\texpectedRevision === null\n\t\t\t\t? await this.db\n\t\t\t\t\t\t.insertInto(\"options\")\n\t\t\t\t\t\t.values({ name, value: serialized, revision })\n\t\t\t\t\t\t.onConflict((oc) => oc.column(\"name\").doNothing())\n\t\t\t\t\t\t.returning(\"revision\")\n\t\t\t\t\t\t.executeTakeFirst()\n\t\t\t\t: await this.db\n\t\t\t\t\t\t.updateTable(\"options\")\n\t\t\t\t\t\t.set({ value: serialized, revision })\n\t\t\t\t\t\t.where(\"name\", \"=\", name)\n\t\t\t\t\t\t.where(\"revision\", \"=\", expectedRevision)\n\t\t\t\t\t\t.returning(\"revision\")\n\t\t\t\t\t\t.executeTakeFirst();\n\t\treturn row ? { applied: true, revision: row.revision } : { applied: false };\n\t}\n\n\tasync compareAndDelete(name: string, expectedRevision: string): Promise<ConditionalDeleteResult> {\n\t\tassertStorageKey(name, 2048);\n\t\tassertStorageRevision(expectedRevision);\n\t\tconst row = await this.db\n\t\t\t.deleteFrom(\"options\")\n\t\t\t.where(\"name\", \"=\", name)\n\t\t\t.where(\"revision\", \"=\", expectedRevision)\n\t\t\t.returning(\"name\")\n\t\t\t.executeTakeFirst();\n\t\treturn { applied: row !== undefined };\n\t}\n\n\t/**\n\t * Delete an option\n\t */\n\tasync delete(name: string): Promise<boolean> {\n\t\tconst result = await this.db.deleteFrom(\"options\").where(\"name\", \"=\", name).executeTakeFirst();\n\n\t\treturn (result.numDeletedRows ?? 0) > 0;\n\t}\n\n\t/**\n\t * Check if an option exists\n\t */\n\tasync exists(name: string): Promise<boolean> {\n\t\tconst row = await this.db\n\t\t\t.selectFrom(\"options\")\n\t\t\t.select(\"name\")\n\t\t\t.where(\"name\", \"=\", name)\n\t\t\t.executeTakeFirst();\n\n\t\treturn !!row;\n\t}\n\n\t/**\n\t * Get multiple options at once\n\t */\n\tasync getMany<T = unknown>(names: string[]): Promise<Map<string, T>> {\n\t\tif (names.length === 0) return new Map();\n\n\t\tconst rows = await this.db\n\t\t\t.selectFrom(\"options\")\n\t\t\t.select([\"name\", \"value\"])\n\t\t\t.where(\"name\", \"in\", names)\n\t\t\t.execute();\n\n\t\tconst result = new Map<string, T>();\n\t\tfor (const row of rows) {\n\t\t\t// eslint-disable-next-line typescript/no-unsafe-type-assertion -- JSON.parse returns any; generic callers provide T\n\t\t\tresult.set(row.name, JSON.parse(row.value) as T);\n\t\t}\n\t\treturn result;\n\t}\n\n\t/**\n\t * Set multiple options at once\n\t */\n\tasync setMany<T = unknown>(options: Record<string, T>): Promise<void> {\n\t\tconst entries = Object.entries(options);\n\t\tif (entries.length === 0) return;\n\n\t\tfor (const [name, value] of entries) {\n\t\t\tawait this.set(name, value);\n\t\t}\n\t}\n\n\t/**\n\t * Get all options (use sparingly)\n\t */\n\tasync getAll(): Promise<Map<string, unknown>> {\n\t\tconst rows = await this.db.selectFrom(\"options\").select([\"name\", \"value\"]).execute();\n\n\t\tconst result = new Map<string, unknown>();\n\t\tfor (const row of rows) {\n\t\t\tresult.set(row.name, JSON.parse(row.value));\n\t\t}\n\t\treturn result;\n\t}\n\n\t/**\n\t * Get all options matching a prefix\n\t */\n\tasync getByPrefix<T = unknown>(\n\t\tprefix: string,\n\t\toptions: { limit?: number } = {},\n\t): Promise<Map<string, T>> {\n\t\tconst pattern = `${escapeLike(prefix)}%`;\n\t\tlet query = this.db\n\t\t\t.selectFrom(\"options\")\n\t\t\t.select([\"name\", \"value\"])\n\t\t\t.where(sql<SqlBool>`name LIKE ${pattern} ESCAPE '\\\\'`)\n\t\t\t.orderBy(\"name\", \"asc\");\n\t\tif (options.limit !== undefined) query = query.limit(Math.max(0, options.limit));\n\t\tconst rows = await query.execute();\n\n\t\tconst result = new Map<string, T>();\n\t\tfor (const row of rows) {\n\t\t\t// eslint-disable-next-line typescript/no-unsafe-type-assertion -- JSON.parse returns any; generic callers provide T\n\t\t\tresult.set(row.name, JSON.parse(row.value) as T);\n\t\t}\n\t\treturn result;\n\t}\n\n\tasync getVersionedByPrefix<T = unknown>(\n\t\tprefix: string,\n\t\toptions: { limit?: number } = {},\n\t): Promise<Map<string, VersionedValue<T>>> {\n\t\tconst pattern = `${escapeLike(prefix)}%`;\n\t\tlet query = this.db\n\t\t\t.selectFrom(\"options\")\n\t\t\t.select([\"name\", \"value\", \"revision\"])\n\t\t\t.where(sql<SqlBool>`name LIKE ${pattern} ESCAPE '\\\\'`)\n\t\t\t.orderBy(\"name\", \"asc\");\n\t\tif (options.limit !== undefined) query = query.limit(Math.max(0, options.limit));\n\t\tconst rows = await query.execute();\n\n\t\tconst result = new Map<string, VersionedValue<T>>();\n\t\tfor (const row of rows) {\n\t\t\t// eslint-disable-next-line typescript/no-unsafe-type-assertion -- JSON.parse returns any; generic callers provide T\n\t\t\tresult.set(row.name, { value: JSON.parse(row.value) as T, revision: row.revision });\n\t\t}\n\t\treturn result;\n\t}\n\n\tasync countByPrefix(prefix: string): Promise<number> {\n\t\tconst pattern = `${escapeLike(prefix)}%`;\n\t\tconst row = await this.db\n\t\t\t.selectFrom(\"options\")\n\t\t\t.select((eb) => eb.fn.countAll<number>().as(\"count\"))\n\t\t\t.where(sql<SqlBool>`name LIKE ${pattern} ESCAPE '\\\\'`)\n\t\t\t.executeTakeFirst();\n\t\treturn Number(row?.count ?? 0);\n\t}\n\n\t/**\n\t * Delete all options matching a prefix\n\t */\n\tasync deleteByPrefix(prefix: string): Promise<number> {\n\t\tconst pattern = `${escapeLike(prefix)}%`;\n\t\tconst result = await this.db\n\t\t\t.deleteFrom(\"options\")\n\t\t\t.where(sql<SqlBool>`name LIKE ${pattern} ESCAPE '\\\\'`)\n\t\t\t.executeTakeFirst();\n\n\t\treturn Number(result.numDeletedRows ?? 0);\n\t}\n}\n"],"mappings":"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"}

package/dist/options-DAknChnw.d.mts

@@ -1,77 +0,0 @@
-import { t as Database } from "./types-CbwqGOXm.mjs";
-import { In as VersionedValue, _ as ConditionalDeleteResult, v as ConditionalWriteResult } from "./types-DEHidMEk.mjs";
-import { Kysely } from "kysely";
-
-//#region src/database/repositories/options.d.ts
-/**
- * Options repository for key-value settings storage
- *
- * Used for site settings, plugin configuration, and other arbitrary key-value data.
- * Values are stored as JSON for flexibility.
- */
-declare class OptionsRepository {
-  private db;
-  constructor(db: Kysely<Database>);
-  /**
-   * Get an option value
-   */
-  get<T = unknown>(name: string): Promise<T | null>;
-  /**
-   * Get an option value with a default
-   */
-  getOrDefault<T>(name: string, defaultValue: T): Promise<T>;
-  /**
-   * Set an option value (creates or updates)
-   */
-  set<T = unknown>(name: string, value: T): Promise<void>;
-  setVersioned<T = unknown>(name: string, value: T): Promise<string>;
-  /**
-   * Set an option value only if no row with that name exists. Atomic at the
-   * database level via INSERT ... ON CONFLICT DO NOTHING, so concurrent
-   * callers can't race past the check.
-   *
-   * Returns true when the row was inserted, false when a row already
-   * existed (regardless of its value — even an empty string or null).
-   */
-  setIfAbsent<T = unknown>(name: string, value: T): Promise<boolean>;
-  getVersioned<T = unknown>(name: string): Promise<VersionedValue<T> | null>;
-  compareAndSet(name: string, expectedRevision: string | null, value: unknown): Promise<ConditionalWriteResult>;
-  compareAndDelete(name: string, expectedRevision: string): Promise<ConditionalDeleteResult>;
-  /**
-   * Delete an option
-   */
-  delete(name: string): Promise<boolean>;
-  /**
-   * Check if an option exists
-   */
-  exists(name: string): Promise<boolean>;
-  /**
-   * Get multiple options at once
-   */
-  getMany<T = unknown>(names: string[]): Promise<Map<string, T>>;
-  /**
-   * Set multiple options at once
-   */
-  setMany<T = unknown>(options: Record<string, T>): Promise<void>;
-  /**
-   * Get all options (use sparingly)
-   */
-  getAll(): Promise<Map<string, unknown>>;
-  /**
-   * Get all options matching a prefix
-   */
-  getByPrefix<T = unknown>(prefix: string, options?: {
-    limit?: number;
-  }): Promise<Map<string, T>>;
-  getVersionedByPrefix<T = unknown>(prefix: string, options?: {
-    limit?: number;
-  }): Promise<Map<string, VersionedValue<T>>>;
-  countByPrefix(prefix: string): Promise<number>;
-  /**
-   * Delete all options matching a prefix
-   */
-  deleteByPrefix(prefix: string): Promise<number>;
-}
-//#endregion
-export { OptionsRepository as t };
-//# sourceMappingURL=options-DAknChnw.d.mts.map

package/dist/options-DAknChnw.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"options-DAknChnw.d.mts","names":[],"sources":["../src/database/repositories/options.ts"],"mappings":";;;;;;;AAwBA;;;;cAAa,iBAAA;EAAA,QACQ,EAAA;cAAA,EAAA,EAAI,MAAA,CAAO,QAAA;EAoBmB;;;EAf5C,GAAA,aAAA,CAAiB,IAAA,WAAe,OAAA,CAAQ,CAAA;EAuBE;;;EAR1C,YAAA,GAAA,CAAgB,IAAA,UAAc,YAAA,EAAc,CAAA,GAAI,OAAA,CAAQ,CAAA;EAuCN;;;EA/BlD,GAAA,aAAA,CAAiB,IAAA,UAAc,KAAA,EAAO,CAAA,GAAI,OAAA;EAI1C,YAAA,aAAA,CAA0B,IAAA,UAAc,KAAA,EAAO,CAAA,GAAI,OAAA;EA4DtD;;;;;;;;EAjCG,WAAA,aAAA,CAAyB,IAAA,UAAc,KAAA,EAAO,CAAA,GAAI,OAAA;EAkBlD,YAAA,aAAA,CAA0B,IAAA,WAAe,OAAA,CAAQ,cAAA,CAAe,CAAA;EAWhE,aAAA,CACL,IAAA,UACA,gBAAA,iBACA,KAAA,YACE,OAAA,CAAQ,sBAAA;EAuBL,gBAAA,CAAiB,IAAA,UAAc,gBAAA,WAA2B,OAAA,CAAQ,uBAAA;EAqExD;;;EAtDV,MAAA,CAAO,IAAA,WAAe,OAAA;EA2FU;;;EAlFhC,MAAA,CAAO,IAAA,WAAe,OAAA;EAoGS;;;EAvF/B,OAAA,aAAA,CAAqB,KAAA,aAAkB,OAAA,CAAQ,GAAA,SAAY,CAAA;EAxJ7C;;;EA4Kd,OAAA,aAAA,CAAqB,OAAA,EAAS,MAAA,SAAe,CAAA,IAAK,OAAA;EA5KpC;;;EAwLd,MAAA,CAAA,GAAU,OAAA,CAAQ,GAAA;EAnLc;;;EAgMhC,WAAA,aAAA,CACL,MAAA,UACA,OAAA;IAAW,KAAA;EAAA,IACT,OAAA,CAAQ,GAAA,SAAY,CAAA;EAkBjB,oBAAA,aAAA,CACL,MAAA,UACA,OAAA;IAAW,KAAA;EAAA,IACT,OAAA,CAAQ,GAAA,SAAY,cAAA,CAAe,CAAA;EAkBhC,aAAA,CAAc,MAAA,WAAiB,OAAA;EAnN3B;;;EAgOJ,cAAA,CAAe,MAAA,WAAiB,OAAA;AAAA"}

package/dist/parse-Cr379Av9.mjs

@@ -1,81 +0,0 @@
-import { t as apiError } from "./error-CCTCskie.mjs";
-import { z } from "zod";
-
-//#region src/api/parse.ts
-/** Maximum allowed JSON request body size (10 MB). */
-const MAX_BODY_SIZE = 10 * 1024 * 1024;
-/**
-* Parse and validate a JSON request body against a Zod schema.
-*
-* Returns the validated data on success, or a 400 Response on failure.
-* Replaces all `(await request.json()) as T` casts.
-*/
-async function parseBody(request, schema) {
-	const contentLength = request.headers.get("Content-Length");
-	if (contentLength && parseInt(contentLength, 10) > MAX_BODY_SIZE) return apiError("PAYLOAD_TOO_LARGE", "Request body too large", 413);
-	let raw;
-	try {
-		raw = await request.json();
-	} catch {
-		return apiError("INVALID_JSON", "Request body must be valid JSON", 400);
-	}
-	return validate(schema, raw);
-}
-/**
-* Parse and validate an optional JSON request body.
-*
-* Returns `defaultValue` if the body is empty, or the validated data if present.
-* For endpoints where the body is optional (e.g., preview-url, confirm).
-*/
-async function parseOptionalBody(request, schema, defaultValue) {
-	const contentLength = request.headers.get("Content-Length");
-	if (contentLength && parseInt(contentLength, 10) > MAX_BODY_SIZE) return apiError("PAYLOAD_TOO_LARGE", "Request body too large", 413);
-	let text;
-	try {
-		text = await request.text();
-	} catch {
-		return defaultValue;
-	}
-	if (!text.trim()) return defaultValue;
-	let raw;
-	try {
-		raw = JSON.parse(text);
-	} catch {
-		return apiError("INVALID_JSON", "Request body must be valid JSON", 400);
-	}
-	return validate(schema, raw);
-}
-/**
-* Parse and validate URL search params against a Zod schema.
-*
-* Converts searchParams to a plain object before validation.
-* Zod coercion handles string -> number/boolean conversion.
-* Replaces manual `url.searchParams.get()` + `parseInt()` patterns.
-*/
-function parseQuery(url, schema) {
-	const raw = {};
-	for (const [key, value] of url.searchParams) raw[key] = value;
-	return validate(schema, raw);
-}
-/**
-* Validate raw data against a schema. Returns data or error Response.
-*/
-function validate(schema, data) {
-	const result = schema.safeParse(data);
-	if (result.success) return result.data;
-	return apiError("VALIDATION_ERROR", "Invalid request data", 400, { issues: result.error.issues.map((issue) => ({
-		path: issue.path.join("."),
-		message: issue.message
-	})) });
-}
-/**
-* Type guard to check if a ParseResult is an error Response.
-* Usage: `if (isParseError(result)) return result;`
-*/
-function isParseError(result) {
-	return result instanceof Response;
-}
-
-//#endregion
-export { parseQuery as i, parseBody as n, parseOptionalBody as r, isParseError as t };
-//# sourceMappingURL=parse-Cr379Av9.mjs.map

package/dist/parse-Cr379Av9.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"parse-Cr379Av9.mjs","names":[],"sources":["../src/api/parse.ts"],"sourcesContent":["/**\n * Request body and query parameter parsing with Zod validation.\n *\n * All API routes should use these utilities instead of `request.json() as T`\n * or raw `url.searchParams.get()` with manual coercion.\n */\n\nimport { z } from \"zod\";\n\nimport { apiError } from \"./error.js\";\n\n/** Maximum allowed JSON request body size (10 MB). */\nconst MAX_BODY_SIZE = 10 * 1024 * 1024;\n\n/**\n * Result of parsing: either the validated data or an error Response.\n * Routes should check `if (result instanceof Response) return result;`\n */\nexport type ParseResult<T> = T | Response;\n\n/**\n * Parse and validate a JSON request body against a Zod schema.\n *\n * Returns the validated data on success, or a 400 Response on failure.\n * Replaces all `(await request.json()) as T` casts.\n */\nexport async function parseBody<T extends z.ZodType>(\n\trequest: Request,\n\tschema: T,\n): Promise<ParseResult<z.infer<T>>> {\n\t// Best-effort size check via Content-Length (can be absent with chunked encoding)\n\tconst contentLength = request.headers.get(\"Content-Length\");\n\tif (contentLength && parseInt(contentLength, 10) > MAX_BODY_SIZE) {\n\t\treturn apiError(\"PAYLOAD_TOO_LARGE\", \"Request body too large\", 413);\n\t}\n\n\tlet raw: unknown;\n\ttry {\n\t\traw = await request.json();\n\t} catch {\n\t\treturn apiError(\"INVALID_JSON\", \"Request body must be valid JSON\", 400);\n\t}\n\n\treturn validate(schema, raw);\n}\n\n/**\n * Parse and validate an optional JSON request body.\n *\n * Returns `defaultValue` if the body is empty, or the validated data if present.\n * For endpoints where the body is optional (e.g., preview-url, confirm).\n */\nexport async function parseOptionalBody<T extends z.ZodType>(\n\trequest: Request,\n\tschema: T,\n\tdefaultValue: z.infer<T>,\n): Promise<ParseResult<z.infer<T>>> {\n\t// Best-effort size check via Content-Length (can be absent with chunked encoding)\n\tconst contentLength = request.headers.get(\"Content-Length\");\n\tif (contentLength && parseInt(contentLength, 10) > MAX_BODY_SIZE) {\n\t\treturn apiError(\"PAYLOAD_TOO_LARGE\", \"Request body too large\", 413);\n\t}\n\n\tlet text: string;\n\ttry {\n\t\ttext = await request.text();\n\t} catch {\n\t\treturn defaultValue;\n\t}\n\n\tif (!text.trim()) {\n\t\treturn defaultValue;\n\t}\n\n\tlet raw: unknown;\n\ttry {\n\t\traw = JSON.parse(text);\n\t} catch {\n\t\treturn apiError(\"INVALID_JSON\", \"Request body must be valid JSON\", 400);\n\t}\n\n\treturn validate(schema, raw);\n}\n\n/**\n * Parse and validate URL search params against a Zod schema.\n *\n * Converts searchParams to a plain object before validation.\n * Zod coercion handles string -> number/boolean conversion.\n * Replaces manual `url.searchParams.get()` + `parseInt()` patterns.\n */\nexport function parseQuery<T extends z.ZodType>(url: URL, schema: T): ParseResult<z.infer<T>> {\n\tconst raw: Record<string, string> = {};\n\tfor (const [key, value] of url.searchParams) {\n\t\traw[key] = value;\n\t}\n\treturn validate(schema, raw);\n}\n\n/**\n * Validate raw data against a schema. Returns data or error Response.\n */\nfunction validate<T extends z.ZodType>(schema: T, data: unknown): ParseResult<z.infer<T>> {\n\tconst result = schema.safeParse(data);\n\n\tif (result.success) {\n\t\treturn result.data;\n\t}\n\n\t// Format Zod errors into a readable structure\n\tconst issues = result.error.issues.map((issue: z.core.$ZodIssue) => ({\n\t\tpath: issue.path.join(\".\"),\n\t\tmessage: issue.message,\n\t}));\n\n\treturn apiError(\"VALIDATION_ERROR\", \"Invalid request data\", 400, { issues });\n}\n\n/**\n * Type guard to check if a ParseResult is an error Response.\n * Usage: `if (isParseError(result)) return result;`\n */\nexport function isParseError<T>(result: ParseResult<T>): result is Response {\n\treturn result instanceof Response;\n}\n"],"mappings":";;;;;AAYA,MAAM,gBAAgB,KAAK,OAAO;;;;;;;AAclC,eAAsB,UACrB,SACA,QACmC;CAEnC,MAAM,gBAAgB,QAAQ,QAAQ,IAAI,iBAAiB;AAC3D,KAAI,iBAAiB,SAAS,eAAe,GAAG,GAAG,cAClD,QAAO,SAAS,qBAAqB,0BAA0B,IAAI;CAGpE,IAAI;AACJ,KAAI;AACH,QAAM,MAAM,QAAQ,MAAM;SACnB;AACP,SAAO,SAAS,gBAAgB,mCAAmC,IAAI;;AAGxE,QAAO,SAAS,QAAQ,IAAI;;;;;;;;AAS7B,eAAsB,kBACrB,SACA,QACA,cACmC;CAEnC,MAAM,gBAAgB,QAAQ,QAAQ,IAAI,iBAAiB;AAC3D,KAAI,iBAAiB,SAAS,eAAe,GAAG,GAAG,cAClD,QAAO,SAAS,qBAAqB,0BAA0B,IAAI;CAGpE,IAAI;AACJ,KAAI;AACH,SAAO,MAAM,QAAQ,MAAM;SACpB;AACP,SAAO;;AAGR,KAAI,CAAC,KAAK,MAAM,CACf,QAAO;CAGR,IAAI;AACJ,KAAI;AACH,QAAM,KAAK,MAAM,KAAK;SACf;AACP,SAAO,SAAS,gBAAgB,mCAAmC,IAAI;;AAGxE,QAAO,SAAS,QAAQ,IAAI;;;;;;;;;AAU7B,SAAgB,WAAgC,KAAU,QAAoC;CAC7F,MAAM,MAA8B,EAAE;AACtC,MAAK,MAAM,CAAC,KAAK,UAAU,IAAI,aAC9B,KAAI,OAAO;AAEZ,QAAO,SAAS,QAAQ,IAAI;;;;;AAM7B,SAAS,SAA8B,QAAW,MAAwC;CACzF,MAAM,SAAS,OAAO,UAAU,KAAK;AAErC,KAAI,OAAO,QACV,QAAO,OAAO;AASf,QAAO,SAAS,oBAAoB,wBAAwB,KAAK,EAAE,QALpD,OAAO,MAAM,OAAO,KAAK,WAA6B;EACpE,MAAM,MAAM,KAAK,KAAK,IAAI;EAC1B,SAAS,MAAM;EACf,EAAE,EAEwE,CAAC;;;;;;AAO7E,SAAgB,aAAgB,QAA4C;AAC3E,QAAO,kBAAkB"}