@cogenta/schema 0.2.0 → 0.4.1

package/dist/scheduling/registry.js

@@ -0,0 +1,318 @@
+import { CogentaError, identifier, limit, newId, sql, } from '@cogenta/core';
+/**
+ * The scheduled-task registry (fiche 28 task 1).
+ *
+ * Before this, `cogenta serve` registered four unrelated pieces of recurring
+ * work — scheduled publication, the 404 log purge, the audit-integrity
+ * check, the trash sweep — each on its own bare `setInterval`, with no shared
+ * bookkeeping. Nothing recorded whether a run had happened, how long it took,
+ * or whether it had failed; the only way to know a scheduled publication had
+ * stopped working was a reader noticing a page never went live.
+ *
+ * A registered task declares a name, a description, an interval and a
+ * function. This module owns everything else: running due tasks, recording
+ * every run, and answering "what is scheduled, and did it work" for the
+ * admin screen fiche 28 task 2 builds over it.
+ *
+ * **Persistence is the point of task 3.** A task's "last run" is a row in
+ * this table, not a variable in the process — a `setInterval` handle dies
+ * with the process, and a site restarted after being down all night must be
+ * able to say, immediately, "the trash sweep has not run in fourteen hours"
+ * rather than resetting the clock the moment it comes back up. `tick()`
+ * itself is equally indifferent to *why* it is being called: `cogenta
+ * serve`'s own loop and the one-shot `cogenta cron` command both just call
+ * it, which is what makes the second a real alternative to the first rather
+ * than a separate reimplementation (fiche 28 task 5).
+ */
+export const SCHEDULED_TASK_RUNS_TABLE = 'cogenta_scheduled_task_runs';
+/**
+ * One row per task: the compare-and-set lock `tick()` claims before running a
+ * task (L22 task 6). Kept separate from the run-history table above —
+ * history answers "what happened", this answers "is anyone already doing
+ * this right now", and conflating the two would make every read of the
+ * admin history screen reason about lock state.
+ *
+ * Before this table existed, `tick()` read the last run from the history
+ * table, decided a task was due, and only recorded the new run *after* it
+ * finished — nothing made that read-then-act atomic. With more than one
+ * `cogenta serve` replica (or a replica racing a `cogenta cron` invocation)
+ * against the same database, two processes could both read "due" and both
+ * start executing the same task, including the destructive trash-purge
+ * sweep. The fix is the same shape as `takeOne`'s guarded stock `UPDATE` in
+ * `@cogenta/commerce` and `claimOnce`'s guarded job `UPDATE` in
+ * `@cogenta/core`'s database queue: read `last_claim`, then issue a single
+ * `UPDATE ... WHERE last_claim = <the value just read>`. Only one of two
+ * racing `UPDATE`s can match that `WHERE` — the loser sees
+ * `rowsAffected === 0` and skips the task entirely. No dialect-specific
+ * locking primitive is needed: a single `UPDATE` with an equality `WHERE` is
+ * atomic per row on SQLite, Postgres and MySQL/MariaDB alike, so the exact
+ * same query runs unmodified on all three.
+ */
+export const SCHEDULED_TASK_CLAIMS_TABLE = 'cogenta_scheduled_task_claims';
+/** Runs kept per task. Enough to see a pattern across a week of daily tasks, never unbounded. */
+const DEFAULT_KEEP_RUNS = 50;
+function toRun(row) {
+    return {
+        id: row.id,
+        taskName: row.task_name,
+        startedAt: Number(row.started_at),
+        finishedAt: Number(row.finished_at),
+        durationMs: Number(row.duration_ms),
+        outcome: row.outcome,
+        summary: row.summary,
+        error: row.error,
+        triggeredBy: row.triggered_by,
+        actor: row.actor,
+    };
+}
+function unknownTask(name) {
+    return new CogentaError({
+        code: 'SCHEDULER_TASK_UNKNOWN',
+        message: `No scheduled task named "${name}" is registered.`,
+        hint: 'Check the task name against GET /api/scheduled-tasks — a task only appears there once something has called register() for it.',
+        details: { name },
+    });
+}
+export function createScheduledTaskRegistry(options) {
+    const { db } = options;
+    const now = options.now ?? Date.now;
+    const keepRuns = options.keepRuns ?? DEFAULT_KEEP_RUNS;
+    const logger = options.logger?.child({ component: 'scheduler' });
+    const table = identifier(options.table ?? SCHEDULED_TASK_RUNS_TABLE, db.dialect);
+    const claimsTable = identifier(options.claimsTable ?? SCHEDULED_TASK_CLAIMS_TABLE, db.dialect);
+    const definitions = new Map();
+    let ready = false;
+    async function ensureTable() {
+        if (ready)
+            return;
+        await db.query(sql `
+      create table if not exists ${table} (
+        id varchar(64) not null primary key,
+        task_name varchar(255) not null,
+        started_at bigint not null,
+        finished_at bigint not null,
+        duration_ms bigint not null,
+        outcome varchar(16) not null,
+        summary text,
+        error text,
+        triggered_by varchar(16) not null,
+        actor varchar(255)
+      )`);
+        await db
+            .query(sql `create index ${identifier('cogenta_scheduled_task_runs_task', db.dialect)}
+            on ${table} (task_name, started_at)`)
+            .catch(() => undefined); // already there
+        // The compare-and-set lock table (L22 task 6). `last_claim` starts out
+        // `null` — "never claimed" — for a brand-new row, matching the meaning
+        // `lastRunFor` gives a task that has never run.
+        await db.query(sql `
+      create table if not exists ${claimsTable} (
+        task_name varchar(255) not null primary key,
+        last_claim bigint
+      )`);
+        ready = true;
+    }
+    async function lastRunFor(name) {
+        await ensureTable();
+        const found = await db.query(sql `
+      select id, task_name, started_at, finished_at, duration_ms, outcome, summary, error, triggered_by, actor
+      from ${table}
+      where task_name = ${name}
+      order by started_at desc
+      limit ${limit(1)}`);
+        const row = found.rows[0];
+        return row === undefined ? null : toRun(row);
+    }
+    async function recentRunsFor(name) {
+        await ensureTable();
+        const found = await db.query(sql `
+      select id, task_name, started_at, finished_at, duration_ms, outcome, summary, error, triggered_by, actor
+      from ${table}
+      where task_name = ${name}
+      order by started_at desc
+      limit ${limit(keepRuns)}`);
+        return found.rows.map(toRun);
+    }
+    async function pruneOldRuns(name) {
+        // Keep the newest `keepRuns`, drop the rest — bounded history without a
+        // separate cleanup task of its own.
+        const kept = await db.query(sql `
+      select id from ${table}
+      where task_name = ${name}
+      order by started_at desc
+      limit ${limit(keepRuns)}`);
+        if (kept.rows.length < keepRuns)
+            return;
+        const keptIds = kept.rows.map((row) => row.id);
+        const inList = keptIds.map((id) => sql `${id}`).reduce((left, right) => sql `${left}, ${right}`);
+        await db.query(sql `delete from ${table} where task_name = ${name} and id not in (${inList})`);
+    }
+    /**
+     * Makes sure a claim row exists for a task, seeded from the run history so
+     * an upgrade from a database that already has runs (but no claims table
+     * yet) does not make every existing task look newly-never-run and fire
+     * immediately. A race between two processes both seeding the same row for
+     * the first time is harmless: the loser's `insert` hits the primary key
+     * and is swallowed, exactly like the "already there" index-creation guard
+     * above — the row itself, not who created it, is what matters.
+     */
+    async function ensureClaimRow(name) {
+        await ensureTable();
+        const existing = await db.query(sql `select task_name from ${claimsTable} where task_name = ${name}`);
+        if (existing.rows.length > 0)
+            return;
+        const priorRun = await lastRunFor(name);
+        const seed = priorRun === null ? null : priorRun.startedAt;
+        await db
+            .query(sql `insert into ${claimsTable} (task_name, last_claim) values (${name}, ${seed})`)
+            .catch(() => undefined); // another process seeded it first — fine, the row exists either way
+    }
+    /**
+     * The compare-and-set claim `tick()` takes before running a due task.
+     *
+     * Reads the task's current `last_claim`, decides whether that makes it
+     * due, and — only if so — tries to move `last_claim` forward with a single
+     * guarded `UPDATE` whose `WHERE` re-checks the exact value just read. If
+     * another process already claimed this task between the read and the
+     * write, `last_claim` no longer matches, `rowsAffected` comes back `0`,
+     * and this returns `false` — the caller must not run the task. Only one of
+     * two racing callers can ever see `true` for the same task and instant,
+     * because a single-row `UPDATE` with an equality `WHERE` is atomic on
+     * SQLite, Postgres and MySQL/MariaDB alike; nothing dialect-specific is
+     * needed here.
+     */
+    async function tryClaim(definition, at) {
+        await ensureClaimRow(definition.name);
+        const found = await db.query(sql `select task_name, last_claim from ${claimsTable} where task_name = ${definition.name}`);
+        // Normalised the same way `toRun` normalises the run-history table's
+        // bigint columns: drivers disagree on whether a bigint column comes back
+        // as a JS number, a string or a `bigint`, and comparing/subtracting the
+        // wrong one silently produces `NaN` or a string mismatch rather than an
+        // error.
+        const raw = found.rows[0]?.last_claim;
+        const lastClaim = raw === null || raw === undefined ? null : Number(raw);
+        const due = lastClaim === null || at - lastClaim >= definition.intervalMs;
+        if (!due)
+            return false;
+        const result = lastClaim === null
+            ? await db.query(sql `
+            update ${claimsTable} set last_claim = ${at}
+            where task_name = ${definition.name} and last_claim is null`)
+            : await db.query(sql `
+            update ${claimsTable} set last_claim = ${at}
+            where task_name = ${definition.name} and last_claim = ${lastClaim}`);
+        return result.rowsAffected > 0;
+    }
+    /**
+     * Keeps the claim row in step with the run it just recorded, whether the
+     * run was scheduled or manual (`runNow`) — a manual run must push the next
+     * scheduled run out exactly as it always has, since `tick()` used to base
+     * "is it due" on the run-history table, which every trigger writes to.
+     */
+    async function upsertClaim(name, startedAt) {
+        await ensureClaimRow(name);
+        await db.query(sql `update ${claimsTable} set last_claim = ${startedAt} where task_name = ${name}`);
+    }
+    async function stateFor(definition) {
+        const lastRun = await lastRunFor(definition.name);
+        const at = now();
+        const nextRunAt = lastRun === null ? at : lastRun.startedAt + definition.intervalMs;
+        const overdue = lastRun === null ? true : at - lastRun.startedAt > definition.intervalMs * 2;
+        return {
+            name: definition.name,
+            description: definition.description,
+            intervalMs: definition.intervalMs,
+            destructive: definition.destructive ?? false,
+            lastRun,
+            nextRunAt,
+            overdue,
+            recentRuns: await recentRunsFor(definition.name),
+        };
+    }
+    async function execute(definition, triggeredBy, actor) {
+        await ensureTable();
+        const startedAt = now();
+        let outcome = 'success';
+        let summary = null;
+        let error = null;
+        try {
+            const result = await definition.run();
+            summary = result?.summary ?? null;
+        }
+        catch (caught) {
+            outcome = 'error';
+            error = caught instanceof Error ? caught.message : String(caught);
+            logger?.error('scheduled task failed', { task: definition.name, error });
+        }
+        const finishedAt = now();
+        const run = {
+            id: newId(now),
+            taskName: definition.name,
+            startedAt,
+            finishedAt,
+            durationMs: Math.max(0, finishedAt - startedAt),
+            outcome,
+            summary,
+            error,
+            triggeredBy,
+            actor,
+        };
+        await db.query(sql `
+      insert into ${table}
+        (id, task_name, started_at, finished_at, duration_ms, outcome, summary, error, triggered_by, actor)
+      values
+        (${run.id}, ${run.taskName}, ${run.startedAt}, ${run.finishedAt}, ${run.durationMs},
+         ${run.outcome}, ${run.summary}, ${run.error}, ${run.triggeredBy}, ${run.actor})`);
+        await pruneOldRuns(definition.name);
+        await upsertClaim(definition.name, run.startedAt);
+        return run;
+    }
+    return {
+        register: (definition) => {
+            if (definitions.has(definition.name)) {
+                throw new CogentaError({
+                    code: 'SCHEDULER_TASK_DUPLICATE',
+                    message: `A scheduled task named "${definition.name}" is already registered.`,
+                    hint: 'Task names must be unique. Pick a different name, or remove the duplicate registration.',
+                    details: { name: definition.name },
+                });
+            }
+            definitions.set(definition.name, definition);
+        },
+        list: async () => {
+            const states = [];
+            for (const definition of definitions.values()) {
+                states.push(await stateFor(definition));
+            }
+            return states;
+        },
+        get: async (name) => {
+            const definition = definitions.get(name);
+            return definition === undefined ? null : stateFor(definition);
+        },
+        runNow: async (name, runOptions = {}) => {
+            const definition = definitions.get(name);
+            if (definition === undefined)
+                throw unknownTask(name);
+            return execute(definition, 'manual', runOptions.actor ?? null);
+        },
+        tick: async (at = now()) => {
+            const ran = [];
+            // Sequenced, not concurrent within this process: this may share one
+            // SQLite connection with whatever else calls `db.transaction`, which
+            // cannot have two writers open at the same instant. Across processes,
+            // `tryClaim` is what actually prevents two replicas from both running
+            // the same task — this loop alone would not (L22 task 6).
+            for (const definition of definitions.values()) {
+                const claimed = await tryClaim(definition, at);
+                if (!claimed)
+                    continue;
+                await execute(definition, 'schedule', null);
+                ran.push(definition.name);
+            }
+            return { ran };
+        },
+        ensureTable,
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/scheduling/registry.js.map

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

package/dist/search/extract.d.ts

@@ -12,6 +12,7 @@ import type { SearchDocument } from './types.js';
 export declare function extractRichText(value: unknown): string;
 /** The prose of one block. Its `data` is contract B, so its shape is open. */
 export declare function extractBlockText(block: ContentBlock): string;
+export declare function titleOf(collection: CollectionDefinition, entry: ContentEntry): string;
 /**
  * The indexable document for an entry.
  *
@@ -22,4 +23,27 @@ export declare function extractBlockText(block: ContentBlock): string;
  * twice in the text every engine ranks.
  */
 export declare function searchDocumentFor(collection: CollectionDefinition, entry: ContentEntry): SearchDocument;
+/** One run of characters inside an excerpt that matched a query term. */
+export interface ExcerptMatch {
+    readonly start: number;
+    readonly end: number;
+}
+export interface Excerpt {
+    readonly text: string;
+    readonly matches: readonly ExcerptMatch[];
+}
+/**
+ * A window of prose around the first query term found in `text`, with the
+ * offsets of every match **inside that window** — never inside the full text,
+ * which the caller has already thrown away by the time it renders anything.
+ *
+ * `text` is expected to be the *display* text — `SearchDocument.body`, which
+ * `searchDocumentFor` builds with `condense` but never `foldText` (only the
+ * three drivers fold it, at the point they hand it to their own engine, for
+ * matching). That is what lets an excerpt keep real casing and accents while
+ * still being found by a folded, prefix-matching query: each candidate word is
+ * folded here, once, only to decide whether it counts as a match — never to
+ * change what is shown (fiche 36, task 3).
+ */
+export declare function buildExcerpt(text: string, tokens: readonly string[]): Excerpt;
 //# sourceMappingURL=extract.d.ts.map

package/dist/search/extract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/search/extract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC/E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AA0EhD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA6BtD;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAI5D;AAoCD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,oBAAoB,EAChC,KAAK,EAAE,YAAY,GAClB,cAAc,CA8BhB"}
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/search/extract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC/E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AA0EhD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA6BtD;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAI5D;AAyBD,wBAAgB,OAAO,CAAC,UAAU,EAAE,oBAAoB,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAerF;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,oBAAoB,EAChC,KAAK,EAAE,YAAY,GAClB,cAAc,CA8BhB;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;CAC1C;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAmC7E"}

package/dist/search/extract.js

@@ -1,4 +1,4 @@
-import { condense } from './text.js';
+import { condense, foldText } from './text.js';
 /**
  * Turning an entry into the text that gets indexed.
  *
@@ -126,14 +126,20 @@ function extractZones(zones) {
 /**
  * The field whose value labels a result.
  *
- * `title` by name when the collection has one — contract A's own example uses
- * it — and the first declared `text` field otherwise, which is what an editor
- * sees at the top of the form.
+ * Fiche 01 ("Liste de contenu"), task 1: the same priority order
+ * `packages/admin/src/lib/entry-title.ts` uses for every other screen that
+ * names an entry, so a title reads the same in the collection list, the
+ * trash and here. A declared `text` field named `title`, `name` or `label`
+ * — in that priority order — and the first declared `text` field
+ * otherwise, which is what an editor sees at the top of the form.
  */
-function titleOf(collection, entry) {
-    const named = collection.fields['title'];
-    if (named?.kind === 'text') {
-        const value = entry.values['title'];
+const TITLE_FIELD_PRIORITY = ['title', 'name', 'label'];
+export function titleOf(collection, entry) {
+    for (const name of TITLE_FIELD_PRIORITY) {
+        const field = collection.fields[name];
+        if (field?.kind !== 'text')
+            continue;
+        const value = entry.values[name];
         if (typeof value === 'string' && value.length > 0)
             return condense(value);
     }
@@ -185,4 +191,53 @@ export function searchDocumentFor(collection, entry) {
         body: condense(parts.join(' ')),
     };
 }
+/** Letters and digits, the same boundary `tokenize` (`text.ts`) uses. */
+const WORD_PATTERN = /[\p{L}\p{N}]+/gu;
+/** Characters kept on each side of the first match — enough prose to show why a
+ * result matched without turning the result list into a wall of text. */
+const EXCERPT_RADIUS = 80;
+/** No match found: the caller still gets a real opening, not a raw cutoff of `body`. */
+const EXCERPT_FALLBACK_LENGTH = 200;
+/**
+ * A window of prose around the first query term found in `text`, with the
+ * offsets of every match **inside that window** — never inside the full text,
+ * which the caller has already thrown away by the time it renders anything.
+ *
+ * `text` is expected to be the *display* text — `SearchDocument.body`, which
+ * `searchDocumentFor` builds with `condense` but never `foldText` (only the
+ * three drivers fold it, at the point they hand it to their own engine, for
+ * matching). That is what lets an excerpt keep real casing and accents while
+ * still being found by a folded, prefix-matching query: each candidate word is
+ * folded here, once, only to decide whether it counts as a match — never to
+ * change what is shown (fiche 36, task 3).
+ */
+export function buildExcerpt(text, tokens) {
+    if (tokens.length === 0 || text.length === 0) {
+        return { text: text.slice(0, EXCERPT_FALLBACK_LENGTH), matches: [] };
+    }
+    const words = [];
+    for (const match of text.matchAll(WORD_PATTERN)) {
+        words.push({ start: match.index, end: match.index + match[0].length });
+    }
+    // The same rule the FTS5/tsquery/boolean-mode drivers all express: a term
+    // matches a word that starts with it, not only a word equal to it.
+    function isHit(word) {
+        const folded = foldText(text.slice(word.start, word.end));
+        return tokens.some((token) => folded.startsWith(token));
+    }
+    const hits = words.filter(isHit);
+    if (hits.length === 0) {
+        return { text: text.slice(0, EXCERPT_FALLBACK_LENGTH), matches: [] };
+    }
+    const anchor = hits[0];
+    const windowStart = Math.max(0, anchor.start - EXCERPT_RADIUS);
+    const windowEnd = Math.min(text.length, anchor.end + EXCERPT_RADIUS);
+    const prefix = windowStart > 0 ? '… ' : '';
+    const suffix = windowEnd < text.length ? ' …' : '';
+    const shift = prefix.length - windowStart;
+    const matches = hits
+        .filter((word) => word.start >= windowStart && word.end <= windowEnd)
+        .map((word) => ({ start: word.start + shift, end: word.end + shift }));
+    return { text: `${prefix}${text.slice(windowStart, windowEnd)}${suffix}`, matches };
+}
 //# sourceMappingURL=extract.js.map

package/dist/search/extract.js.map

@@ -1 +1 @@
-{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/search/extract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/search/extract.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAG9C;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,MAAM;IACN,OAAO;IACP,KAAK;IACL,MAAM;IACN,IAAI;IACJ,YAAY;IACZ,OAAO;IACP,UAAU;IACV,OAAO;IACP,OAAO;IACP,UAAU;IACV,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,UAAU;IACV,OAAO;IACP,SAAS;IACT,OAAO;IACP,MAAM;CACP,CAAC,CAAA;AAEF,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,KAAc,EAAE,IAAc,EAAE,KAAK,GAAG,CAAC;IAC/D,IAAI,KAAK,GAAG,CAAC;QAAE,OAAM;IAErB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACtC,OAAM;IACR,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAA;QAC/D,OAAM;IACR,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAM;IAE5B,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAQ;QACtC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAA;IACzC,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACpC,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAQ;QAE7B,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,OAAO,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,CAAA;YACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;gBAAE,SAAQ;YACtC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;gBAC7B,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ;oBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;YACrF,CAAC;YACD,SAAQ;QACV,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,OAAO,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAA;YAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACpD,SAAQ;QACV,CAAC;QAED,2EAA2E;QAC3E,qEAAqE;QACrE,iEAAiE;QACjE,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC7B,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAClC,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,KAAmB;IAClD,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACjC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAClC,CAAC;AAED,SAAS,YAAY,CAAC,KAAiB;IACrC,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;YACpC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvC,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAClC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAU,CAAA;AAEhE,MAAM,UAAU,OAAO,CAAC,UAAgC,EAAE,KAAmB;IAC3E,KAAK,MAAM,IAAI,IAAI,oBAAoB,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACrC,IAAI,KAAK,EAAE,IAAI,KAAK,MAAM;YAAE,SAAQ;QACpC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC3E,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9D,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,SAAQ;QACnC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC3E,CAAC;IAED,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAgC,EAChC,KAAmB;IAEnB,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;IACxC,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAEvC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAEhC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;YAC9E,SAAQ;QACV,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;YACnC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvC,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACzC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAEzC,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,UAAU,EAAE,UAAU,CAAC,IAAI;QAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK;QACL,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;KAChC,CAAA;AACH,CAAC;AAaD,yEAAyE;AACzE,MAAM,YAAY,GAAG,iBAAiB,CAAA;AAEtC;yEACyE;AACzE,MAAM,cAAc,GAAG,EAAE,CAAA;AAEzB,wFAAwF;AACxF,MAAM,uBAAuB,GAAG,GAAG,CAAA;AAEnC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,MAAyB;IAClE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;IACtE,CAAC;IAED,MAAM,KAAK,GAAmB,EAAE,CAAA;IAChC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAA;IACxE,CAAC;IAED,0EAA0E;IAC1E,mEAAmE;IACnE,SAAS,KAAK,CAAC,IAAkB;QAC/B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QACzD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;IACzD,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAChC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;IACtE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAiB,CAAA;IACtC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC,CAAA;IAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,GAAG,cAAc,CAAC,CAAA;IAEpE,MAAM,MAAM,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1C,MAAM,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,WAAW,CAAA;IAEzC,MAAM,OAAO,GAAG,IAAI;SACjB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,WAAW,IAAI,IAAI,CAAC,GAAG,IAAI,SAAS,CAAC;SACpE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAA;IAExE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,SAAS,CAAC,GAAG,MAAM,EAAE,EAAE,OAAO,EAAE,CAAA;AACrF,CAAC"}

package/dist/search/index.d.ts

@@ -8,7 +8,8 @@ import type { SearchDriver } from './types.js';
  * not ranked at all. What every caller does know is that the locale and the
  * state it asks for are the only ones it can be given.
  */
-export { extractBlockText, extractRichText, searchDocumentFor } from './extract.js';
+export type { Excerpt, ExcerptMatch } from './extract.js';
+export { buildExcerpt, extractBlockText, extractRichText, searchDocumentFor, titleOf, } from './extract.js';
 export type { MysqlSearchOptions } from './mysql.js';
 export { createMysqlSearch } from './mysql.js';
 export type { PostgresSearchOptions } from './postgres.js';

package/dist/search/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AAIjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACnF,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACtE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC3E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACvF,YAAY,EACV,cAAc,EACd,YAAY,EACZ,SAAS,EACT,WAAW,EACX,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAA;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAe1F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AAIjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;;;;;GAOG;AAEH,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,OAAO,GACR,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACtE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC3E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACvF,YAAY,EACV,cAAc,EACd,YAAY,EACZ,SAAS,EACT,WAAW,EACX,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAA;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAe1F"}

package/dist/search/index.js

@@ -2,15 +2,7 @@ import { CogentaError } from '@cogenta/core';
 import { createMysqlSearch } from './mysql.js';
 import { createPostgresSearch } from './postgres.js';
 import { createSqliteSearch } from './sqlite.js';
-/**
- * Full-text search, one interface over three engines (L1, task 16).
- *
- * Nothing outside this folder knows whether the site is ranked by `ts_rank`,
- * by an InnoDB fulltext score or by BM25 — or, on a SQLite build without FTS5,
- * not ranked at all. What every caller does know is that the locale and the
- * state it asks for are the only ones it can be given.
- */
-export { extractBlockText, extractRichText, searchDocumentFor } from './extract.js';
+export { buildExcerpt, extractBlockText, extractRichText, searchDocumentFor, titleOf, } from './extract.js';
 export { createMysqlSearch } from './mysql.js';
 export { configurationFor, createPostgresSearch } from './postgres.js';
 export { createSqliteSearch } from './sqlite.js';

package/dist/search/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,eAAe,CAAA;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGhD;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAEnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAE9C,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC3E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAgBvF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA2B;IACjE,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAA;IAEtB,IAAI,EAAE,CAAC,OAAO,KAAK,UAAU;QAAE,OAAO,oBAAoB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;IAClE,IAAI,EAAE,CAAC,OAAO,KAAK,OAAO;QAAE,OAAO,iBAAiB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;IAC5D,IAAI,EAAE,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,kBAAkB,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IAC7F,CAAC;IAED,MAAM,IAAI,YAAY,CAAC;QACrB,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,+CAA+C,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,YAAY;QACtF,IAAI,EAAE,gEAAgE;QACtE,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE;KACjC,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,eAAe,CAAA;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAahD,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,OAAO,GACR,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAE9C,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC3E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAgBvF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA2B;IACjE,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAA;IAEtB,IAAI,EAAE,CAAC,OAAO,KAAK,UAAU;QAAE,OAAO,oBAAoB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;IAClE,IAAI,EAAE,CAAC,OAAO,KAAK,OAAO;QAAE,OAAO,iBAAiB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;IAC5D,IAAI,EAAE,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,kBAAkB,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IAC7F,CAAC;IAED,MAAM,IAAI,YAAY,CAAC;QACrB,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,+CAA+C,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,YAAY;QACtF,IAAI,EAAE,gEAAgE;QACtE,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE;KACjC,CAAC,CAAA;AACJ,CAAC"}

package/dist/store/admin-theme-store.d.ts

@@ -0,0 +1,26 @@
+import { type DatabaseHandle } from '@cogenta/core';
+import { type AdminThemeOverrides, type AdminThemeTemplateId, DEFAULT_ADMIN_THEME_TEMPLATE_ID } from './admin-theme-templates.js';
+export interface AdminThemeRecord {
+    readonly templateId: AdminThemeTemplateId;
+    readonly overrides: AdminThemeOverrides;
+    readonly updatedAt: string;
+    readonly updatedBy: string | null;
+}
+export interface AdminThemeStoreOptions {
+    readonly db: DatabaseHandle;
+    readonly now?: () => Date;
+}
+export interface AdminThemeStore {
+    /** `null` when nobody has ever written a choice — the caller applies `DEFAULT_ADMIN_THEME_TEMPLATE_ID` with no overrides. */
+    get(): Promise<AdminThemeRecord | null>;
+    /**
+     * Refuses a `templateId` outside `ADMIN_THEME_TEMPLATES`
+     * (`ADMIN_THEME_TEMPLATE_UNKNOWN`) or an override object that fails
+     * `adminThemeOverridesSchema` (`ADMIN_THEME_INVALID`) — never a loose,
+     * unvalidated blob written straight through.
+     */
+    set(templateId: string, overrides: unknown, updatedBy: string | null): Promise<AdminThemeRecord>;
+}
+export declare function createAdminThemeStore(options: AdminThemeStoreOptions): AdminThemeStore;
+export { DEFAULT_ADMIN_THEME_TEMPLATE_ID };
+//# sourceMappingURL=admin-theme-store.d.ts.map

package/dist/store/admin-theme-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-theme-store.d.ts","sourceRoot":"","sources":["../../src/store/admin-theme-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,cAAc,EAAmB,MAAM,eAAe,CAAA;AAElF,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAGzB,+BAA+B,EAChC,MAAM,4BAA4B,CAAA;AAEnC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAA;IACzC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAA;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAA;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,6HAA6H;IAC7H,GAAG,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IACvC;;;;;OAKG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;CACjG;AA8BD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAqEtF;AAED,OAAO,EAAE,+BAA+B,EAAE,CAAA"}