@cogenta/schema 0.1.0

package/dist/routing/redirects.js

@@ -0,0 +1,237 @@
+import { CogentaError, identifier, limit, sql, } from '@cogenta/core';
+import { newId } from '../id.js';
+import { normalisePath } from './router.js';
+/**
+ * The redirect table.
+ *
+ * L1 calls unresolved redirects "a daily nuisance that WordPress and Drupal do
+ * not solve" and asks that this work without anyone thinking about it. Two
+ * things make that true, and both are enforced here rather than left to callers:
+ *
+ * - **Chains are flattened.** When A already points at B and B starts pointing
+ *   at C, the row for A is rewritten to C. Otherwise every rename adds a hop,
+ *   and a page renamed five times costs a visitor five round trips.
+ * - **Loops are refused.** A→B→A serves nothing but an infinite redirect, so it
+ *   is rejected at write time, where there is still a human to tell.
+ */
+export const REDIRECTS_TABLE = 'cogenta_redirects';
+/**
+ * Longest path stored, checked before insert.
+ *
+ * It must stay in step with the `varchar(512)` of the DDL below — a width
+ * cannot be a bound parameter, so the number is written twice on purpose rather
+ * than concatenated into the statement.
+ */
+const MAX_PATH_LENGTH = 512;
+/**
+ * Hops `resolve` will follow before giving up.
+ *
+ * Flattening means one hop is normally enough. The cap exists for a table
+ * edited by hand or migrated in from another CMS, where a cycle can exist that
+ * this code never wrote.
+ */
+const MAX_HOPS = 10;
+export const REDIRECT_REASONS = ['slug-change', 'manual', 'import'];
+export function createRedirectStore(options) {
+    const { db } = options;
+    const now = options.now ?? Date.now;
+    const nextId = options.newId ?? newId;
+    const table = identifier(options.table ?? REDIRECTS_TABLE, db.dialect);
+    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,
+        from_path varchar(512) not null,
+        to_path varchar(512) not null,
+        status integer not null,
+        collection varchar(255),
+        entry_id varchar(64),
+        locale varchar(35),
+        reason varchar(32) not null,
+        created_at bigint not null
+      )`);
+        // Unique, not merely indexed: one source path has one destination, and the
+        // database is the only place that stays true under two concurrent renames.
+        await db
+            .query(sql `create unique index ${identifier(`${options.table ?? REDIRECTS_TABLE}_from`, db.dialect)}
+            on ${table} (from_path)`)
+            .catch(() => undefined); // already there — no dialect spells "if not exists" the same way
+        ready = true;
+    }
+    function checkPath(path, field) {
+        const normalised = normalisePath(path);
+        if (normalised === '/' && field === 'from') {
+            throw new CogentaError({
+                code: 'CONTENT_ROUTE_INVALID',
+                message: 'The site root cannot redirect.',
+                hint: 'Change the home page instead of redirecting away from "/".',
+            });
+        }
+        if (normalised.length > MAX_PATH_LENGTH) {
+            throw new CogentaError({
+                code: 'CONTENT_ROUTE_INVALID',
+                message: `A redirect path may be ${MAX_PATH_LENGTH} characters at most.`,
+                hint: 'Shorten the slug, or the pattern the collection is routed on.',
+                details: { field, length: normalised.length },
+            });
+        }
+        return normalised;
+    }
+    async function targetOf(tx, path) {
+        const found = await tx.query(sql `
+      select to_path from ${table} where from_path = ${path} limit ${limit(1)}`);
+        return found.rows[0]?.to_path;
+    }
+    /**
+     * Where `to` really leads, and proof that it does not lead back to `from`.
+     *
+     * Both jobs at once on purpose: they are the same walk, and doing them
+     * separately would walk the chain twice and let it change in between.
+     */
+    async function flattenTarget(tx, from, to) {
+        const seen = new Set([from]);
+        let target = to;
+        for (let hop = 0; hop <= MAX_HOPS; hop += 1) {
+            if (seen.has(target)) {
+                throw new CogentaError({
+                    code: 'CONTENT_REDIRECT_LOOP',
+                    message: `Redirecting ${from} to ${to} would send visitors round in a circle.`,
+                    hint: `${target} already leads back to ${from}. Remove that redirect first, or point this one elsewhere.`,
+                    details: { from, to, at: target },
+                });
+            }
+            seen.add(target);
+            const next = await targetOf(tx, target);
+            if (next === undefined)
+                return target;
+            target = next;
+        }
+        throw new CogentaError({
+            code: 'CONTENT_REDIRECT_LOOP',
+            message: `The redirect chain starting at ${to} is more than ${MAX_HOPS} hops long.`,
+            hint: 'The table holds a cycle it did not get from Cogenta. Inspect and prune it.',
+            details: { from, to },
+        });
+    }
+    async function deleteFrom(path) {
+        await ensureTable();
+        const result = await db.query(sql `
+      delete from ${table} where from_path = ${normalisePath(path)}`);
+        return result.rowsAffected > 0;
+    }
+    return {
+        ensureTable,
+        add: async (input) => {
+            await ensureTable();
+            const from = checkPath(input.from, 'from');
+            const to = checkPath(input.to, 'to');
+            const status = input.status ?? 301;
+            const reason = input.reason ?? 'manual';
+            const createdAt = now();
+            if (from === to) {
+                throw new CogentaError({
+                    code: 'CONTENT_REDIRECT_LOOP',
+                    message: `${from} cannot redirect to itself.`,
+                    hint: 'Nothing needs a redirect here: the path did not change.',
+                    details: { from },
+                });
+            }
+            // One transaction: the chain is read, rewritten and extended together, so
+            // a second rename running at the same time cannot slot a hop in between.
+            return db.transaction(async (tx) => {
+                const target = await flattenTarget(tx, from, to);
+                // Everything that pointed at the old path now points at the new one.
+                // This is what keeps the table one hop deep however often an entry is
+                // renamed.
+                await tx.query(sql `
+            update ${table} set to_path = ${target} where to_path = ${from}`);
+                // Delete-then-insert rather than an upsert: `ON CONFLICT`, `ON
+                // DUPLICATE KEY` and `INSERT OR REPLACE` are three different
+                // statements, and this layer owes callers one behaviour.
+                await tx.query(sql `delete from ${table} where from_path = ${from}`);
+                const record = {
+                    id: nextId(),
+                    from,
+                    to: target,
+                    status,
+                    collection: input.collection ?? null,
+                    entryId: input.entryId ?? null,
+                    locale: input.locale ?? null,
+                    reason,
+                    createdAt,
+                };
+                await tx.query(sql `
+            insert into ${table}
+              (id, from_path, to_path, status, collection, entry_id, locale, reason, created_at)
+            values (${record.id}, ${record.from}, ${record.to}, ${record.status},
+                    ${record.collection}, ${record.entryId}, ${record.locale},
+                    ${record.reason}, ${record.createdAt})`);
+                return record;
+            }, { immediate: true });
+        },
+        resolve: async (path) => {
+            await ensureTable();
+            const start = normalisePath(path);
+            const seen = new Set([start]);
+            let current = start;
+            let status = 301;
+            for (let hop = 0; hop < MAX_HOPS; hop += 1) {
+                const found = await db.query(sql `
+          select to_path, status from ${table} where from_path = ${current} limit ${limit(1)}`);
+                const row = found.rows[0];
+                if (row === undefined)
+                    break;
+                // A 302 anywhere in the chain wins: a temporary hop must not be cached
+                // as permanent by a browser that never sees the rest of the chain.
+                if (Number(row.status) === 302)
+                    status = 302;
+                current = row.to_path;
+                // A cycle in imported data resolves to the last path before the loop
+                // closes rather than throwing: serving one redirect is better than
+                // serving a 500 on a URL a visitor actually asked for.
+                if (seen.has(current))
+                    return { to: current, status };
+                seen.add(current);
+            }
+            return current === start ? null : { to: current, status };
+        },
+        list: async (listOptions = {}) => {
+            await ensureTable();
+            const byCollection = listOptions.collection === undefined
+                ? sql ``
+                : sql ` and collection = ${listOptions.collection}`;
+            const byLocale = listOptions.locale === undefined ? sql `` : sql ` and locale = ${listOptions.locale}`;
+            const found = await db.query(sql `
+        select id, from_path, to_path, status, collection, entry_id, locale, reason, created_at
+        from ${table}
+        where 1 = 1${byCollection}${byLocale}
+        order by created_at desc, from_path asc
+        limit ${limit(listOptions.limit ?? 1000)}`);
+            return found.rows.map(toRecord);
+        },
+        remove: deleteFrom,
+        // Same statement, different intent: `remove` is an editor deleting a rule,
+        // `release` is the engine noticing a path is served again. Kept as two
+        // names because the call sites read as two different decisions.
+        release: deleteFrom,
+    };
+}
+function toRecord(row) {
+    return {
+        id: row.id,
+        from: row.from_path,
+        to: row.to_path,
+        status: Number(row.status) === 302 ? 302 : 301,
+        collection: row.collection,
+        entryId: row.entry_id,
+        locale: row.locale,
+        reason: REDIRECT_REASONS.includes(row.reason)
+            ? row.reason
+            : 'manual',
+        createdAt: Number(row.created_at),
+    };
+}
+//# sourceMappingURL=redirects.js.map

package/dist/routing/redirects.js.map

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

package/dist/routing/resolve.d.ts

@@ -0,0 +1,38 @@
+import type { CollectionDefinition } from '../types.js';
+import type { RedirectStatus, RedirectStore } from './redirects.js';
+import { type RouteMatch, type RouteOptions } from './router.js';
+/**
+ * What a request for a URL resolves to.
+ *
+ * A discriminated union rather than a nullable entry, because "no entry" splits
+ * into two answers a site must treat differently: redirect, or 404. Collapsing
+ * them is how a rename ends up serving a 404 to a link that used to work.
+ */
+export type UrlResolution = {
+    readonly kind: 'entry';
+    readonly match: RouteMatch;
+    readonly entry: unknown;
+} | {
+    readonly kind: 'redirect';
+    readonly to: string;
+    readonly status: RedirectStatus;
+} | {
+    readonly kind: 'notFound';
+};
+/** Looks the matched route up in storage. Owned by the persistence layer, not by routing. */
+export type EntryLookup = (match: RouteMatch) => Promise<unknown | null>;
+export interface ResolveUrlOptions extends RouteOptions {
+    readonly collections: readonly CollectionDefinition[];
+    readonly redirects: RedirectStore;
+    readonly lookup: EntryLookup;
+}
+/**
+ * The order matters: content first, redirects second.
+ *
+ * A path that a live entry answers must never be redirected, however stale the
+ * table is. Checking redirects first would let a leftover row shadow a page
+ * that has come back — and that failure is invisible in the admin, because the
+ * entry is right there, published.
+ */
+export declare function resolveUrl(path: string, options: ResolveUrlOptions): Promise<UrlResolution>;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/routing/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EAA4B,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1F;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC/E;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GACnF;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAA;AAEjC,6FAA6F;AAC7F,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;AAExE,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAA;IACrD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CAajG"}

package/dist/routing/resolve.js

@@ -0,0 +1,23 @@
+import { matchPath, normalisePath } from './router.js';
+/**
+ * The order matters: content first, redirects second.
+ *
+ * A path that a live entry answers must never be redirected, however stale the
+ * table is. Checking redirects first would let a leftover row shadow a page
+ * that has come back — and that failure is invisible in the admin, because the
+ * entry is right there, published.
+ */
+export async function resolveUrl(path, options) {
+    const normalised = normalisePath(path);
+    const match = matchPath(options.collections, normalised, options);
+    if (match !== null) {
+        const entry = await options.lookup(match);
+        if (entry !== null && entry !== undefined)
+            return { kind: 'entry', match, entry };
+    }
+    const redirect = await options.redirects.resolve(normalised);
+    if (redirect !== null)
+        return { kind: 'redirect', to: redirect.to, status: redirect.status };
+    return { kind: 'notFound' };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/routing/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/routing/resolve.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAsC,MAAM,aAAa,CAAA;AAuB1F;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,OAA0B;IACvE,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IACtC,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;IAEjE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACzC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;IACnF,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IAC5D,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAA;IAE5F,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;AAC7B,CAAC"}

package/dist/routing/router.d.ts

@@ -0,0 +1,51 @@
+import type { CollectionDefinition } from '../types.js';
+/**
+ * Turning a URL into "which collection, which locale, which entry" and back.
+ *
+ * The pattern comes from `routing.pattern` in the collection (contract A):
+ * `/blog/:slug`, with the locale prefixed when `routing.locale` is true. Nothing
+ * here touches the database — a route match is a statement about the *shape* of
+ * a URL, and the lookup that follows belongs to the persistence layer.
+ */
+export interface RouteMatch {
+    readonly collection: string;
+    /** Null when the collection is not localised. */
+    readonly locale: string | null;
+    readonly params: Readonly<Record<string, string>>;
+}
+export interface RouteOptions {
+    /**
+     * The locales the site serves.
+     *
+     * Without it, `/blog/fr` and `/fr/blog` are indistinguishable guesses. The
+     * list makes the answer a fact, so pass it whenever the site has one.
+     */
+    readonly locales?: readonly string[];
+    /**
+     * The locale a URL carries when it has no prefix.
+     *
+     * Sites usually serve the source language unprefixed — `/blog/hello` next to
+     * `/fr/blog/bonjour`. Leave it unset to require the prefix on every localised
+     * route.
+     */
+    readonly defaultLocale?: string;
+}
+/** `/Blog/Été/` and `/blog/été` are the same route. Case is left alone: paths are case-sensitive. */
+export declare function normalisePath(path: string): string;
+/**
+ * The path an entry is served at.
+ *
+ * Values are percent-encoded here rather than by the caller: a slug is normally
+ * URL-safe already, but a pattern can carry any field, and a category named
+ * "R&D" must not produce a broken link.
+ */
+export declare function buildPath(collection: CollectionDefinition, params: Readonly<Record<string, string>>, locale?: string): string;
+/**
+ * The collection and parameters a path resolves to, or null.
+ *
+ * Collections are tried in the order given. A more specific pattern must be
+ * declared before a more general one, exactly as in a router table — guessing
+ * specificity is how routers acquire behaviour nobody can predict.
+ */
+export declare function matchPath(collections: readonly CollectionDefinition[], path: string, options?: RouteOptions): RouteMatch | null;
+//# sourceMappingURL=router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/routing/router.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEvD;;;;;;;GAOG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAClD;AAED,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAChC;AAKD,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKlD;AAQD;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACxC,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAwCR;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,WAAW,EAAE,SAAS,oBAAoB,EAAE,EAC5C,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,YAAiB,GACzB,UAAU,GAAG,IAAI,CASnB"}

package/dist/routing/router.js

@@ -0,0 +1,132 @@
+import { CogentaError } from '@cogenta/core';
+/** A BCP 47 language tag, loose enough for `fr`, `fr-FR` and `zh-Hant-TW`. */
+const LANGUAGE_TAG = /^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/;
+/** `/Blog/Été/` and `/blog/été` are the same route. Case is left alone: paths are case-sensitive. */
+export function normalisePath(path) {
+    const withoutQuery = path.split(/[?#]/u)[0] ?? '';
+    const trimmed = withoutQuery.replace(/\/+$/u, '');
+    if (trimmed.length === 0)
+        return '/';
+    return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+}
+function segmentsOf(path) {
+    return normalisePath(path)
+        .split('/')
+        .filter((segment) => segment.length > 0);
+}
+/**
+ * The path an entry is served at.
+ *
+ * Values are percent-encoded here rather than by the caller: a slug is normally
+ * URL-safe already, but a pattern can carry any field, and a category named
+ * "R&D" must not produce a broken link.
+ */
+export function buildPath(collection, params, locale) {
+    const routing = collection.routing;
+    if (routing === undefined) {
+        throw new CogentaError({
+            code: 'CONTENT_ROUTE_INVALID',
+            message: `Collection "${collection.name}" has no route.`,
+            hint: 'Give it routing: { pattern: "/…/:slug" } before asking for a URL.',
+            details: { collection: collection.name },
+        });
+    }
+    const rendered = segmentsOf(routing.pattern).map((segment) => {
+        if (!segment.startsWith(':'))
+            return segment;
+        const name = segment.slice(1);
+        const value = params[name];
+        if (value === undefined || value.length === 0) {
+            throw new CogentaError({
+                code: 'CONTENT_ROUTE_INVALID',
+                message: `The route of "${collection.name}" needs a value for ":${name}".`,
+                hint: `Pass "${name}" in the parameters. It matches the field of the same name.`,
+                details: { collection: collection.name, pattern: routing.pattern, missing: name },
+            });
+        }
+        return encodeURIComponent(value);
+    });
+    if (routing.locale === true) {
+        if (locale === undefined || locale.length === 0) {
+            throw new CogentaError({
+                code: 'CONTENT_ROUTE_INVALID',
+                message: `The route of "${collection.name}" is localised and needs a locale.`,
+                hint: 'Pass the locale of the entry. It is a system field, so every entry has one.',
+                details: { collection: collection.name, pattern: routing.pattern },
+            });
+        }
+        rendered.unshift(encodeURIComponent(locale));
+    }
+    return `/${rendered.join('/')}`;
+}
+/**
+ * The collection and parameters a path resolves to, or null.
+ *
+ * Collections are tried in the order given. A more specific pattern must be
+ * declared before a more general one, exactly as in a router table — guessing
+ * specificity is how routers acquire behaviour nobody can predict.
+ */
+export function matchPath(collections, path, options = {}) {
+    const segments = segmentsOf(path).map(decodeSegment);
+    for (const collection of collections) {
+        const match = matchCollection(collection, segments, options);
+        if (match !== null)
+            return match;
+    }
+    return null;
+}
+function matchCollection(collection, segments, options) {
+    const routing = collection.routing;
+    if (routing === undefined)
+        return null;
+    const pattern = segmentsOf(routing.pattern);
+    if (routing.locale !== true) {
+        const params = matchSegments(pattern, segments);
+        return params === null ? null : { collection: collection.name, locale: null, params };
+    }
+    const prefix = segments[0];
+    if (prefix !== undefined && isLocale(prefix, options)) {
+        const params = matchSegments(pattern, segments.slice(1));
+        if (params !== null)
+            return { collection: collection.name, locale: prefix, params };
+    }
+    // No prefix: only a site that serves a default locale unprefixed can answer.
+    if (options.defaultLocale === undefined)
+        return null;
+    const params = matchSegments(pattern, segments);
+    return params === null
+        ? null
+        : { collection: collection.name, locale: options.defaultLocale, params };
+}
+function matchSegments(pattern, segments) {
+    if (pattern.length !== segments.length)
+        return null;
+    const params = {};
+    for (const [index, expected] of pattern.entries()) {
+        const actual = segments[index];
+        if (actual === undefined || actual.length === 0)
+            return null;
+        if (expected.startsWith(':')) {
+            params[expected.slice(1)] = actual;
+            continue;
+        }
+        if (expected !== actual)
+            return null;
+    }
+    return params;
+}
+function isLocale(segment, options) {
+    if (options.locales !== undefined)
+        return options.locales.includes(segment);
+    return LANGUAGE_TAG.test(segment);
+}
+/** A malformed escape is not a route; it must not take the process down. */
+function decodeSegment(segment) {
+    try {
+        return decodeURIComponent(segment);
+    }
+    catch {
+        return segment;
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/routing/router.js.map

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

package/dist/routing/slug-change.d.ts

@@ -0,0 +1,39 @@
+import type { CollectionDefinition, ContentStatus } from '../types.js';
+import type { RedirectRecord, RedirectStore } from './redirects.js';
+/**
+ * The acceptance criterion of L1, in one function: *changing the slug of a
+ * published entry creates a 301 with no intervention.*
+ *
+ * It is a free function taking a store rather than a method on the store so the
+ * persistence layer can call it inside the same transaction as the save. A
+ * redirect written after the fact is a redirect that a crash can lose.
+ */
+export interface SlugChange {
+    readonly collection: CollectionDefinition;
+    readonly entryId: string;
+    readonly locale?: string;
+    /** The status the entry has **after** the save. */
+    readonly status: ContentStatus;
+    readonly previousSlug: string;
+    readonly nextSlug: string;
+    /**
+     * Values for the other parameters of the pattern, when it has any —
+     * `/blog/:year/:slug`. The slug parameter is filled in from the two above.
+     */
+    readonly params?: Readonly<Record<string, string>>;
+    /** The pattern parameter carrying the slug. Rarely anything but `slug`. */
+    readonly slugParam?: string;
+}
+/**
+ * Records the redirect a slug change owes, or explains why it owes none.
+ *
+ * Returns null in the cases where a redirect would be noise rather than help:
+ *
+ * - the slug did not change;
+ * - the collection has no route, so there is no URL to redirect;
+ * - the entry is not published. A draft was never served under the old URL,
+ *   and a redirect from a URL nobody could reach is a row that will only ever
+ *   confuse whoever reads the table later.
+ */
+export declare function recordSlugChange(store: RedirectStore, change: SlugChange): Promise<RedirectRecord | null>;
+//# sourceMappingURL=slug-change.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slug-change.d.ts","sourceRoot":"","sources":["../../src/routing/slug-change.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAGnE;;;;;;;GAOG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAA;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAClD,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA+BhC"}

package/dist/routing/slug-change.js

@@ -0,0 +1,44 @@
+import { buildPath } from './router.js';
+/**
+ * Records the redirect a slug change owes, or explains why it owes none.
+ *
+ * Returns null in the cases where a redirect would be noise rather than help:
+ *
+ * - the slug did not change;
+ * - the collection has no route, so there is no URL to redirect;
+ * - the entry is not published. A draft was never served under the old URL,
+ *   and a redirect from a URL nobody could reach is a row that will only ever
+ *   confuse whoever reads the table later.
+ */
+export async function recordSlugChange(store, change) {
+    if (change.previousSlug === change.nextSlug)
+        return null;
+    if (change.collection.routing === undefined)
+        return null;
+    if (!isServed(change.status))
+        return null;
+    const slugParam = change.slugParam ?? 'slug';
+    const base = change.params ?? {};
+    const from = buildPath(change.collection, { ...base, [slugParam]: change.previousSlug }, change.locale);
+    const to = buildPath(change.collection, { ...base, [slugParam]: change.nextSlug }, change.locale);
+    if (from === to)
+        return null;
+    // The new URL is served by this entry from now on, so any redirect leaving it
+    // is stale. This is what lets an editor undo a rename: without it, moving a
+    // page back to its old slug would be refused as a loop.
+    await store.release(to);
+    return store.add({
+        from,
+        to,
+        status: 301,
+        reason: 'slug-change',
+        collection: change.collection.name,
+        entryId: change.entryId,
+        ...(change.locale === undefined ? {} : { locale: change.locale }),
+    });
+}
+/** Only a published entry has ever been reachable by a visitor. */
+function isServed(status) {
+    return status === 'published';
+}
+//# sourceMappingURL=slug-change.js.map

package/dist/routing/slug-change.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug-change.js","sourceRoot":"","sources":["../../src/routing/slug-change.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AA4BvC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAoB,EACpB,MAAkB;IAElB,IAAI,MAAM,CAAC,YAAY,KAAK,MAAM,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAA;IACxD,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACxD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAA;IAEzC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAA;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAA;IAEhC,MAAM,IAAI,GAAG,SAAS,CACpB,MAAM,CAAC,UAAU,EACjB,EAAE,GAAG,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,YAAY,EAAE,EAC7C,MAAM,CAAC,MAAM,CACd,CAAA;IACD,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IAEjG,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IAE5B,8EAA8E;IAC9E,4EAA4E;IAC5E,wDAAwD;IACxD,MAAM,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAEvB,OAAO,KAAK,CAAC,GAAG,CAAC;QACf,IAAI;QACJ,EAAE;QACF,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,aAAa;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI;QAClC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;KAClE,CAAC,CAAA;AACJ,CAAC;AAED,mEAAmE;AACnE,SAAS,QAAQ,CAAC,MAAqB;IACrC,OAAO,MAAM,KAAK,WAAW,CAAA;AAC/B,CAAC"}