@cogenta/schema 0.1.0

package/dist/routing/slug.d.ts

@@ -0,0 +1,82 @@
+import { type DatabaseHandle, type SqlExecutor } from '@cogenta/core';
+import type { CollectionDefinition, FieldDefinition } from '../types.js';
+import { type SlugifyOptions } from './slugify.js';
+/**
+ * A slug is unique **per collection and per locale**, never globally.
+ *
+ * That falls straight out of ADR-0014: one entry per language means the French
+ * and the English article are two rows, and both are legitimately `/mon-article`
+ * under their own locale prefix. Scoping uniqueness globally would force the
+ * translation to invent a slug nobody asked for.
+ */
+export interface SlugScope {
+    readonly collection: string;
+    readonly locale: string;
+    /** The entry being saved, so its own slug does not count as a collision. */
+    readonly excludeId?: string;
+}
+/** Answers "is this slug already used inside the scope?". */
+export type SlugTakenCheck = (candidate: string) => boolean | Promise<boolean>;
+export interface UniqueSlugOptions extends SlugifyOptions {
+    /**
+     * How many suffixes to try before giving up. A bound exists so a broken
+     * `isTaken` cannot spin forever; it is high enough that no real editorial
+     * workload reaches it.
+     */
+    readonly maxAttempts?: number;
+}
+/**
+ * The first free slug in the `base`, `base-2`, `base-3`… series.
+ *
+ * The suffix starts at 2 rather than 1 because the unsuffixed slug *is* the
+ * first one: "article", "article-2" reads as a numbered pair, "article",
+ * "article-1" reads as an off-by-one.
+ */
+export declare function uniqueSlug(base: string, isTaken: SlugTakenCheck, options?: UniqueSlugOptions): Promise<string>;
+export interface SqlSlugScope extends SlugScope {
+    readonly db: DatabaseHandle | SqlExecutor;
+    /** The table holding the entries of this collection. */
+    readonly table: string;
+    readonly slugColumn?: string;
+    readonly localeColumn?: string;
+    readonly idColumn?: string;
+    /**
+     * Set when one table holds several collections. Left unset when the schema
+     * gives every collection its own table, where the table already is the scope.
+     */
+    readonly collectionColumn?: string;
+}
+/**
+ * A `SlugTakenCheck` backed by the database.
+ *
+ * Kept behind the same callback the pure helpers take, so slug generation can
+ * be unit-tested without a database and the storage layer stays free to change
+ * its table layout without touching this file.
+ */
+export declare function sqlSlugTaken(scope: SqlSlugScope): SlugTakenCheck;
+/**
+ * The source text a `f.slug({ from: 'title' })` field derives from.
+ *
+ * Returns null when the field declares no source: such a slug is typed by the
+ * editor, and inventing one would overwrite their choice.
+ */
+export declare function slugSourceField(field: FieldDefinition): string | null;
+export interface DeriveSlugInput {
+    readonly collection: CollectionDefinition;
+    /** Name of the `slug` field inside the collection. */
+    readonly field: string;
+    /** The entry being saved, before slug resolution. */
+    readonly values: Readonly<Record<string, unknown>>;
+    /** Scoped by the caller: it already knows the collection, the locale and the entry. */
+    readonly isTaken: SlugTakenCheck;
+    readonly options?: UniqueSlugOptions;
+}
+/**
+ * The slug an entry should be saved with: derived, transliterated, made unique.
+ *
+ * An explicit slug already present on the entry wins over the source field —
+ * the editor overrode it on purpose — but is still normalised and still made
+ * unique, because "already typed" is not "already free".
+ */
+export declare function deriveSlug(input: DeriveSlugInput): Promise<string>;
+//# sourceMappingURL=slug.d.ts.map

package/dist/routing/slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/routing/slug.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAGnB,KAAK,WAAW,EAEjB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AACxE,OAAO,EAAmC,KAAK,cAAc,EAAW,MAAM,cAAc,CAAA;AAE5F;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,6DAA6D;AAC7D,MAAM,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAE9E,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAID;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAED,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,QAAQ,CAAC,EAAE,EAAE,cAAc,GAAG,WAAW,CAAA;IACzC,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CAwBhE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAGrE;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAA;IACzC,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAClD,uFAAuF;IACvF,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAA;CACrC;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA2CxE"}

package/dist/routing/slug.js

@@ -0,0 +1,124 @@
+import { CogentaError, identifier, limit, sql, } from '@cogenta/core';
+import { DEFAULT_SLUG_MAX_LENGTH, isSlug, slugify } from './slugify.js';
+const DEFAULT_MAX_ATTEMPTS = 1000;
+/**
+ * The first free slug in the `base`, `base-2`, `base-3`… series.
+ *
+ * The suffix starts at 2 rather than 1 because the unsuffixed slug *is* the
+ * first one: "article", "article-2" reads as a numbered pair, "article",
+ * "article-1" reads as an off-by-one.
+ */
+export async function uniqueSlug(base, isTaken, options = {}) {
+    const separator = options.separator ?? '-';
+    const maxLength = options.maxLength ?? DEFAULT_SLUG_MAX_LENGTH;
+    const maxAttempts = options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+    if (base.length === 0) {
+        throw new CogentaError({
+            code: 'CONTENT_SLUG_INVALID',
+            message: 'An empty slug cannot be made unique.',
+            hint: 'Derive the slug from a non-empty source field, or supply one by hand.',
+        });
+    }
+    if (!(await isTaken(base)))
+        return base;
+    for (let suffix = 2; suffix <= maxAttempts; suffix += 1) {
+        // The suffix is part of the budget, not an extension of it: a slug that
+        // grew past `maxLength` would be silently truncated by the column and two
+        // "unique" slugs would collide in storage.
+        const tail = `${separator}${suffix}`;
+        const candidate = `${base.slice(0, maxLength - tail.length)}${tail}`;
+        if (!(await isTaken(candidate)))
+            return candidate;
+    }
+    throw new CogentaError({
+        code: 'CONTENT_SLUG_TAKEN',
+        message: `No slug was free in the "${base}" series after ${maxAttempts} attempts.`,
+        hint: 'Choose a more specific title, or set the slug by hand.',
+        details: { base, maxAttempts },
+    });
+}
+/**
+ * A `SlugTakenCheck` backed by the database.
+ *
+ * Kept behind the same callback the pure helpers take, so slug generation can
+ * be unit-tested without a database and the storage layer stays free to change
+ * its table layout without touching this file.
+ */
+export function sqlSlugTaken(scope) {
+    const { db } = scope;
+    const table = identifier(scope.table, db.dialect);
+    const slugColumn = identifier(scope.slugColumn ?? 'slug', db.dialect);
+    const localeColumn = identifier(scope.localeColumn ?? 'locale', db.dialect);
+    const idColumn = identifier(scope.idColumn ?? 'id', db.dialect);
+    return async (candidate) => {
+        const collectionFilter = scope.collectionColumn === undefined
+            ? sql ``
+            : sql ` and ${identifier(scope.collectionColumn, db.dialect)} = ${scope.collection}`;
+        const exclusion = scope.excludeId === undefined ? sql `` : sql ` and ${idColumn} <> ${scope.excludeId}`;
+        const found = await db.query(sql `
+      select ${idColumn} from ${table}
+      where ${slugColumn} = ${candidate}
+        and ${localeColumn} = ${scope.locale}${collectionFilter}${exclusion}
+      limit ${limit(1)}`);
+        return found.rows.length > 0;
+    };
+}
+/**
+ * The source text a `f.slug({ from: 'title' })` field derives from.
+ *
+ * Returns null when the field declares no source: such a slug is typed by the
+ * editor, and inventing one would overwrite their choice.
+ */
+export function slugSourceField(field) {
+    const from = field.options.from;
+    return typeof from === 'string' && from.length > 0 ? from : null;
+}
+/**
+ * The slug an entry should be saved with: derived, transliterated, made unique.
+ *
+ * An explicit slug already present on the entry wins over the source field —
+ * the editor overrode it on purpose — but is still normalised and still made
+ * unique, because "already typed" is not "already free".
+ */
+export async function deriveSlug(input) {
+    const field = input.collection.fields[input.field];
+    if (field === undefined || field.kind !== 'slug') {
+        throw new CogentaError({
+            code: 'CONTENT_SLUG_INVALID',
+            message: `Collection "${input.collection.name}" has no slug field named "${input.field}".`,
+            hint: 'Declare it with f.slug({ from: … }), or name an existing slug field.',
+            details: { collection: input.collection.name, field: input.field },
+        });
+    }
+    const explicit = input.values[input.field];
+    const source = slugSourceField(field);
+    const raw = typeof explicit === 'string' && explicit.length > 0
+        ? explicit
+        : source === null
+            ? ''
+            : stringOf(input.values[source]);
+    if (raw.length === 0) {
+        throw new CogentaError({
+            code: 'CONTENT_SLUG_INVALID',
+            message: `Nothing to build the "${input.field}" slug of "${input.collection.name}" from.`,
+            hint: source === null
+                ? `Fill in "${input.field}".`
+                : `Fill in "${source}", or type "${input.field}" by hand.`,
+            details: { collection: input.collection.name, field: input.field, from: source },
+        });
+    }
+    const base = isSlug(raw, input.options) ? raw : slugify(raw, input.options);
+    if (base.length === 0) {
+        throw new CogentaError({
+            code: 'CONTENT_SLUG_INVALID',
+            message: `"${raw}" contains no character usable in a URL.`,
+            hint: `Type "${input.field}" by hand. A non-Latin script cannot be transliterated automatically.`,
+            details: { collection: input.collection.name, field: input.field },
+        });
+    }
+    return uniqueSlug(base, input.isTaken, input.options ?? {});
+}
+function stringOf(value) {
+    return typeof value === 'string' ? value : typeof value === 'number' ? String(value) : '';
+}
+//# sourceMappingURL=slug.js.map

package/dist/routing/slug.js.map

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

package/dist/routing/slugify.d.ts

@@ -0,0 +1,29 @@
+export declare const DEFAULT_SLUG_MAX_LENGTH = 96;
+export interface SlugifyOptions {
+    /**
+     * Longest slug produced, in characters. A long title is truncated on a word
+     * boundary rather than mid-word, so the result still reads.
+     */
+    readonly maxLength?: number;
+    /** The character between words. Anything but `-` is unusual; it is here for completeness. */
+    readonly separator?: string;
+}
+/**
+ * A URL-safe, lowercase segment derived from arbitrary text.
+ *
+ * Returns an empty string when the input carries nothing transliterable — a
+ * title written entirely in Chinese, Arabic or Cyrillic. That is a real case,
+ * not an error: the caller decides whether to fall back to a manual slug or to
+ * refuse. `slugifyOrThrow` is the variant for callers that need a value.
+ */
+export declare function slugify(input: string, options?: SlugifyOptions): string;
+/** `slugify`, for callers that cannot proceed without a value. */
+export declare function slugifyOrThrow(input: string, options?: SlugifyOptions): string;
+/**
+ * Whether a string is already a well-formed slug.
+ *
+ * Used to accept an editor-provided slug as it stands rather than mangling it:
+ * a human who typed "faq-2026" meant it.
+ */
+export declare function isSlug(value: string, options?: SlugifyOptions): boolean;
+//# sourceMappingURL=slugify.d.ts.map

package/dist/routing/slugify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../../src/routing/slugify.ts"],"names":[],"mappings":"AA6CA,eAAO,MAAM,uBAAuB,KAAK,CAAA;AAEzC,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,6FAA6F;IAC7F,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CAgB3E;AAgBD,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CAUlF;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAK3E"}

package/dist/routing/slugify.js

@@ -0,0 +1,104 @@
+import { CogentaError } from '@cogenta/core';
+/**
+ * Turning a title into a URL segment.
+ *
+ * Deliberately dependency-free (rule R9). Unicode already ships the hard part:
+ * `normalize('NFD')` splits "é" into "e" plus a combining acute, so dropping the
+ * combining range transliterates every accented Latin letter at once. What is
+ * left is the handful of letters Unicode does *not* decompose, because they are
+ * atomic characters rather than a base plus a mark — "ß", "æ", "ø" and friends.
+ */
+/**
+ * The combining diacritical marks block, U+0300 to U+036F.
+ *
+ * NFD of Latin text produces marks from this block and no other, so the range
+ * is exact for what this function claims to handle. Written as code points
+ * rather than as a character class because the characters themselves are
+ * invisible in an editor, and an invisible character in a regex is a bug
+ * waiting to be introduced by the next person who touches the line.
+ */
+const COMBINING_FIRST = 0x0300;
+const COMBINING_LAST = 0x036f;
+/**
+ * Latin letters with no decomposition. Their transliteration is a convention,
+ * not an algorithm, so it has to be written down.
+ */
+const ATOMIC_LETTERS = {
+    ß: 'ss',
+    æ: 'ae',
+    œ: 'oe',
+    ø: 'o',
+    đ: 'd',
+    ð: 'd',
+    þ: 'th',
+    ł: 'l',
+    ı: 'i',
+    ħ: 'h',
+    ŧ: 't',
+    ŋ: 'n',
+    ĸ: 'k',
+    ſ: 's',
+};
+export const DEFAULT_SLUG_MAX_LENGTH = 96;
+/**
+ * A URL-safe, lowercase segment derived from arbitrary text.
+ *
+ * Returns an empty string when the input carries nothing transliterable — a
+ * title written entirely in Chinese, Arabic or Cyrillic. That is a real case,
+ * not an error: the caller decides whether to fall back to a manual slug or to
+ * refuse. `slugifyOrThrow` is the variant for callers that need a value.
+ */
+export function slugify(input, options = {}) {
+    const separator = options.separator ?? '-';
+    const maxLength = options.maxLength ?? DEFAULT_SLUG_MAX_LENGTH;
+    let text = '';
+    for (const character of input.toLowerCase().normalize('NFD')) {
+        const code = character.codePointAt(0) ?? 0;
+        if (code >= COMBINING_FIRST && code <= COMBINING_LAST)
+            continue;
+        // Looked up after NFD, so a decomposed character is never taken for an atom.
+        text += ATOMIC_LETTERS[character] ?? character;
+    }
+    const words = text.split(/[^a-z0-9]+/u).filter((word) => word.length > 0);
+    if (words.length === 0)
+        return '';
+    return truncate(words, separator, maxLength);
+}
+/** Keeps whole words, so a truncated slug never ends on half a word. */
+function truncate(words, separator, maxLength) {
+    let slug = '';
+    for (const word of words) {
+        const next = slug.length === 0 ? word : `${slug}${separator}${word}`;
+        if (next.length > maxLength)
+            break;
+        slug = next;
+    }
+    // A single first word longer than the budget still has to yield something.
+    return slug.length === 0 ? (words[0] ?? '').slice(0, maxLength) : slug;
+}
+/** `slugify`, for callers that cannot proceed without a value. */
+export function slugifyOrThrow(input, options = {}) {
+    const slug = slugify(input, options);
+    if (slug.length > 0)
+        return slug;
+    throw new CogentaError({
+        code: 'CONTENT_SLUG_INVALID',
+        message: `"${input}" contains no character usable in a URL.`,
+        hint: 'Enter the slug by hand. A title written in a non-Latin script cannot be transliterated automatically.',
+        details: { input },
+    });
+}
+/**
+ * Whether a string is already a well-formed slug.
+ *
+ * Used to accept an editor-provided slug as it stands rather than mangling it:
+ * a human who typed "faq-2026" meant it.
+ */
+export function isSlug(value, options = {}) {
+    if (value.length === 0)
+        return false;
+    if (value.length > (options.maxLength ?? DEFAULT_SLUG_MAX_LENGTH))
+        return false;
+    return value === slugify(value, options);
+}
+//# sourceMappingURL=slugify.js.map

package/dist/routing/slugify.js.map

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

package/dist/scheduling/index.d.ts

@@ -0,0 +1,3 @@
+export type { PublishHandler, ScheduledPublication, ScheduledPublishingOptions, SchedulePublicationInput, } from './publish.js';
+export { cancelPublication, parsePayload, registerScheduledPublishing, reschedulePublication, SCHEDULED_PUBLISH_JOB, schedulePublication, } from './publish.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scheduling/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,2BAA2B,EAC3B,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,cAAc,CAAA"}

package/dist/scheduling/index.js

@@ -0,0 +1,2 @@
+export { cancelPublication, parsePayload, registerScheduledPublishing, reschedulePublication, SCHEDULED_PUBLISH_JOB, schedulePublication, } from './publish.js';
+//# sourceMappingURL=index.js.map

package/dist/scheduling/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scheduling/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,2BAA2B,EAC3B,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,cAAc,CAAA"}

package/dist/scheduling/publish.d.ts

@@ -0,0 +1,71 @@
+import { type JobId, type Logger, type QueueDriver } from '@cogenta/core';
+/**
+ * Scheduled publication.
+ *
+ * An entry in `status: 'scheduled'` with a future `publishedAt` becomes a job in
+ * the L0 queue. The acceptance criterion of L1 is that this works **with the
+ * `database` queue too** — the degraded driver that has no worker of its own and
+ * is drained by a cron calling `tick()`.
+ *
+ * Everything here is therefore written against `QueueDriver` and nothing else.
+ * No timer, no `setTimeout`, no assumption that a process is still alive at the
+ * publication time: the job carries its own due date, and whichever tick happens
+ * next after it runs it. On a cron every five minutes, a page scheduled for
+ * 09:00 is published between 09:00 and 09:05 — which is the honest promise of a
+ * host with no persistent worker, and it is the one to document.
+ */
+/** The job name. Public because a caller may need to inspect or cancel by name. */
+export declare const SCHEDULED_PUBLISH_JOB = "cogenta.content.publish";
+export interface ScheduledPublication {
+    readonly collection: string;
+    readonly entryId: string;
+    readonly locale: string;
+    /** Epoch milliseconds: when the entry becomes public. */
+    readonly publishAt: number;
+}
+/** Does the actual state change. Owned by the persistence layer (task 5), not by this file. */
+export type PublishHandler = (publication: ScheduledPublication) => Promise<void>;
+export interface SchedulePublicationInput {
+    readonly collection: string;
+    readonly entryId: string;
+    readonly locale: string;
+    /** A `Date`, an ISO 8601 string, or epoch milliseconds. */
+    readonly publishAt: Date | string | number;
+    readonly maxAttempts?: number;
+    readonly priority?: number;
+}
+/**
+ * Queues the publication of one entry and returns the job to keep alongside it.
+ *
+ * The identifier has to be stored on the entry: it is the only handle on the
+ * job, and rescheduling without it leaves two jobs racing to publish the same
+ * entry at two different times.
+ */
+export declare function schedulePublication(queue: QueueDriver, input: SchedulePublicationInput): Promise<JobId>;
+/** Cancels a pending publication. Safe to call on a job that already ran. */
+export declare function cancelPublication(queue: QueueDriver, jobId: JobId): Promise<void>;
+/**
+ * Moves a publication to a new date.
+ *
+ * Cancel then enqueue, rather than an in-place update: the queue interface has
+ * no "reschedule", and adding one for this would push a content concern into
+ * every driver, Redis included.
+ */
+export declare function reschedulePublication(queue: QueueDriver, jobId: JobId, input: SchedulePublicationInput): Promise<JobId>;
+export interface ScheduledPublishingOptions {
+    readonly logger?: Logger;
+}
+/**
+ * Registers the handler that publishes due entries.
+ *
+ * Called once at boot by whatever owns the queue — the worker process, or the
+ * cron entry point on a host that has none.
+ */
+export declare function registerScheduledPublishing(queue: QueueDriver, publish: PublishHandler, options?: ScheduledPublishingOptions): void;
+/**
+ * A payload comes back from the queue as JSON, so it is `unknown` and is
+ * validated rather than cast. A job row can be edited by hand, restored from a
+ * backup, or left over from an older release.
+ */
+export declare function parsePayload(payload: unknown): ScheduledPublication;
+//# sourceMappingURL=publish.d.ts.map

package/dist/scheduling/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/scheduling/publish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AAEvF;;;;;;;;;;;;;;GAcG;AAEH,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,4BAA4B,CAAA;AAE9D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,+FAA+F;AAC/F,MAAM,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAEjF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,KAAK,CAAC,CAiBhB;AAED,6EAA6E;AAC7E,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvF;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,KAAK,CAAC,CAGhB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,0BAA+B,GACvC,IAAI,CAiBN;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,oBAAoB,CAsBnE"}

package/dist/scheduling/publish.js

@@ -0,0 +1,122 @@
+import { CogentaError } from '@cogenta/core';
+/**
+ * Scheduled publication.
+ *
+ * An entry in `status: 'scheduled'` with a future `publishedAt` becomes a job in
+ * the L0 queue. The acceptance criterion of L1 is that this works **with the
+ * `database` queue too** — the degraded driver that has no worker of its own and
+ * is drained by a cron calling `tick()`.
+ *
+ * Everything here is therefore written against `QueueDriver` and nothing else.
+ * No timer, no `setTimeout`, no assumption that a process is still alive at the
+ * publication time: the job carries its own due date, and whichever tick happens
+ * next after it runs it. On a cron every five minutes, a page scheduled for
+ * 09:00 is published between 09:00 and 09:05 — which is the honest promise of a
+ * host with no persistent worker, and it is the one to document.
+ */
+/** The job name. Public because a caller may need to inspect or cancel by name. */
+export const SCHEDULED_PUBLISH_JOB = 'cogenta.content.publish';
+/**
+ * Queues the publication of one entry and returns the job to keep alongside it.
+ *
+ * The identifier has to be stored on the entry: it is the only handle on the
+ * job, and rescheduling without it leaves two jobs racing to publish the same
+ * entry at two different times.
+ */
+export async function schedulePublication(queue, input) {
+    const publishAt = toEpochMs(input.publishAt, input);
+    const payload = {
+        collection: input.collection,
+        entryId: input.entryId,
+        locale: input.locale,
+        publishAt,
+    };
+    return queue.enqueue({
+        name: SCHEDULED_PUBLISH_JOB,
+        payload,
+        runAt: publishAt,
+        maxAttempts: input.maxAttempts ?? 3,
+        ...(input.priority === undefined ? {} : { priority: input.priority }),
+    });
+}
+/** Cancels a pending publication. Safe to call on a job that already ran. */
+export async function cancelPublication(queue, jobId) {
+    await queue.cancel(jobId);
+}
+/**
+ * Moves a publication to a new date.
+ *
+ * Cancel then enqueue, rather than an in-place update: the queue interface has
+ * no "reschedule", and adding one for this would push a content concern into
+ * every driver, Redis included.
+ */
+export async function reschedulePublication(queue, jobId, input) {
+    await queue.cancel(jobId);
+    return schedulePublication(queue, input);
+}
+/**
+ * Registers the handler that publishes due entries.
+ *
+ * Called once at boot by whatever owns the queue — the worker process, or the
+ * cron entry point on a host that has none.
+ */
+export function registerScheduledPublishing(queue, publish, options = {}) {
+    const logger = options.logger?.child({ component: 'scheduling' });
+    queue.process(SCHEDULED_PUBLISH_JOB, async (job) => {
+        const publication = parsePayload(job.payload);
+        await publish(publication);
+        logger?.info('scheduled entry published', {
+            collection: publication.collection,
+            entryId: publication.entryId,
+            locale: publication.locale,
+            // How late the tick was. On the database queue this is the cron interval,
+            // and it is the number to look at when someone asks why a page went live
+            // four minutes after the hour.
+            latenessMs: Date.now() - publication.publishAt,
+        });
+    });
+}
+/**
+ * A payload comes back from the queue as JSON, so it is `unknown` and is
+ * validated rather than cast. A job row can be edited by hand, restored from a
+ * backup, or left over from an older release.
+ */
+export function parsePayload(payload) {
+    if (typeof payload !== 'object' || payload === null) {
+        throw invalidPayload(payload);
+    }
+    const record = payload;
+    const { collection, entryId, locale, publishAt } = record;
+    if (typeof collection !== 'string' ||
+        collection.length === 0 ||
+        typeof entryId !== 'string' ||
+        entryId.length === 0 ||
+        typeof locale !== 'string' ||
+        locale.length === 0 ||
+        typeof publishAt !== 'number' ||
+        !Number.isFinite(publishAt)) {
+        throw invalidPayload(payload);
+    }
+    return { collection, entryId, locale, publishAt };
+}
+function invalidPayload(payload) {
+    return new CogentaError({
+        code: 'CONTENT_SCHEDULE_INVALID',
+        message: `A "${SCHEDULED_PUBLISH_JOB}" job carries a payload it cannot be run from.`,
+        hint: 'Cancel the job and schedule the entry again. Its payload names the collection, the entry, the locale and the date.',
+        details: { received: typeof payload },
+    });
+}
+function toEpochMs(value, context) {
+    const milliseconds = value instanceof Date ? value.getTime() : typeof value === 'number' ? value : Date.parse(value);
+    if (!Number.isFinite(milliseconds)) {
+        throw new CogentaError({
+            code: 'CONTENT_SCHEDULE_INVALID',
+            message: `"${String(value)}" is not a date to publish "${context.entryId}" on.`,
+            hint: 'Pass a Date, an ISO 8601 timestamp such as 2026-09-01T09:00:00Z, or epoch milliseconds.',
+            details: { collection: context.collection, entryId: context.entryId },
+        });
+    }
+    return milliseconds;
+}
+//# sourceMappingURL=publish.js.map

package/dist/scheduling/publish.js.map

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

package/dist/search/extract.d.ts

@@ -0,0 +1,25 @@
+import type { ContentBlock, ContentEntry } from '../store/types.js';
+import type { CollectionDefinition } from '../types.js';
+import type { SearchDocument } from './types.js';
+/**
+ * The prose of a rich text document: the `text` of every span, plus the
+ * captions of the media nodes.
+ *
+ * Deliberately not `JSON.stringify`: the raw document is roughly half syntax,
+ * and indexing it would let a search for `span` return every article on the
+ * site while a search for a genuinely rare word would be diluted by it.
+ */
+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;
+/**
+ * The indexable document for an entry.
+ *
+ * The title is repeated inside the body on purpose: none of the three engines
+ * offers per-column weighting in a form the other two can match — Postgres has
+ * `setweight`, MySQL has nothing, FTS5 has a per-column BM25 weight vector — so
+ * the one portable way to make a title term count for more is to let it appear
+ * twice in the text every engine ranks.
+ */
+export declare function searchDocumentFor(collection: CollectionDefinition, entry: ContentEntry): SearchDocument;
+//# sourceMappingURL=extract.d.ts.map

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

@@ -0,0 +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"}