@cogenta/schema 0.1.0

package/dist/rich-text.d.ts

@@ -0,0 +1,164 @@
+import { z } from 'zod';
+/**
+ * The rich text document, contract A § "Texte riche" and ADR-0013.
+ *
+ * A restricted Portable Text model: a list of typed blocks carrying text,
+ * semantic marks and annotations that reference site entities. No HTML, no
+ * Markdown, no editor-internal format — a stored `<div class="…">` would tie an
+ * article to one theme for good, and would have to be sanitised on every read.
+ *
+ * `h1` is deliberately absent: the page title is the only `h1`, and leaving it
+ * available in the body breaks the heading outline and accessibility with it.
+ */
+export declare const RICH_TEXT_STYLES: readonly ['normal', 'h2', 'h3', 'h4', 'blockquote'];
+export type RichTextStyle = (typeof RICH_TEXT_STYLES)[number];
+export declare const RICH_TEXT_LIST_ITEMS: readonly ['bullet', 'number'];
+export type RichTextListItem = (typeof RICH_TEXT_LIST_ITEMS)[number];
+/** Marks that need no definition. Anything else in `marks` is a `markDefs._key`. */
+export declare const RICH_TEXT_DECORATORS: readonly ['strong', 'em', 'code'];
+export type RichTextDecorator = (typeof RICH_TEXT_DECORATORS)[number];
+declare const spanSchema: z.ZodObject<{
+    _key: z.ZodString;
+    _type: z.ZodLiteral<"span">;
+    text: z.ZodString;
+    marks: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+/**
+ * An internal link references an *entity*, not a URL. Moving or renaming the
+ * target does not break the link, and deleting the target is detectable —
+ * neither is true of a stored href.
+ */
+declare const markDefinitionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    _key: z.ZodString;
+    _type: z.ZodLiteral<"link">;
+    href: z.ZodString;
+    rel: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    _key: z.ZodString;
+    _type: z.ZodLiteral<"internalLink">;
+    collection: z.ZodString;
+    id: z.ZodString;
+}, z.core.$strict>], "_type">;
+declare const textBlockSchema: z.ZodObject<{
+    _key: z.ZodString;
+    _type: z.ZodLiteral<"block">;
+    style: z.ZodEnum<{
+        blockquote: "blockquote";
+        h2: "h2";
+        h3: "h3";
+        h4: "h4";
+        normal: "normal";
+    }>;
+    listItem: z.ZodOptional<z.ZodEnum<{
+        bullet: "bullet";
+        number: "number";
+    }>>;
+    level: z.ZodOptional<z.ZodNumber>;
+    children: z.ZodArray<z.ZodObject<{
+        _key: z.ZodString;
+        _type: z.ZodLiteral<"span">;
+        text: z.ZodString;
+        marks: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    markDefs: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        _key: z.ZodString;
+        _type: z.ZodLiteral<"link">;
+        href: z.ZodString;
+        rel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        _key: z.ZodString;
+        _type: z.ZodLiteral<"internalLink">;
+        collection: z.ZodString;
+        id: z.ZodString;
+    }, z.core.$strict>], "_type">>>;
+}, z.core.$strict>;
+declare const mediaNodeSchema: z.ZodObject<{
+    _key: z.ZodString;
+    _type: z.ZodLiteral<"media">;
+    id: z.ZodString;
+    caption: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const richTextNodeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    _key: z.ZodString;
+    _type: z.ZodLiteral<"block">;
+    style: z.ZodEnum<{
+        blockquote: "blockquote";
+        h2: "h2";
+        h3: "h3";
+        h4: "h4";
+        normal: "normal";
+    }>;
+    listItem: z.ZodOptional<z.ZodEnum<{
+        bullet: "bullet";
+        number: "number";
+    }>>;
+    level: z.ZodOptional<z.ZodNumber>;
+    children: z.ZodArray<z.ZodObject<{
+        _key: z.ZodString;
+        _type: z.ZodLiteral<"span">;
+        text: z.ZodString;
+        marks: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    markDefs: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        _key: z.ZodString;
+        _type: z.ZodLiteral<"link">;
+        href: z.ZodString;
+        rel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        _key: z.ZodString;
+        _type: z.ZodLiteral<"internalLink">;
+        collection: z.ZodString;
+        id: z.ZodString;
+    }, z.core.$strict>], "_type">>>;
+}, z.core.$strict>, z.ZodObject<{
+    _key: z.ZodString;
+    _type: z.ZodLiteral<"media">;
+    id: z.ZodString;
+    caption: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "_type">;
+export declare const richTextDocumentSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    _key: z.ZodString;
+    _type: z.ZodLiteral<"block">;
+    style: z.ZodEnum<{
+        blockquote: "blockquote";
+        h2: "h2";
+        h3: "h3";
+        h4: "h4";
+        normal: "normal";
+    }>;
+    listItem: z.ZodOptional<z.ZodEnum<{
+        bullet: "bullet";
+        number: "number";
+    }>>;
+    level: z.ZodOptional<z.ZodNumber>;
+    children: z.ZodArray<z.ZodObject<{
+        _key: z.ZodString;
+        _type: z.ZodLiteral<"span">;
+        text: z.ZodString;
+        marks: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    markDefs: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        _key: z.ZodString;
+        _type: z.ZodLiteral<"link">;
+        href: z.ZodString;
+        rel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        _key: z.ZodString;
+        _type: z.ZodLiteral<"internalLink">;
+        collection: z.ZodString;
+        id: z.ZodString;
+    }, z.core.$strict>], "_type">>>;
+}, z.core.$strict>, z.ZodObject<{
+    _key: z.ZodString;
+    _type: z.ZodLiteral<"media">;
+    id: z.ZodString;
+    caption: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "_type">>;
+export type RichTextSpan = z.infer<typeof spanSchema>;
+export type RichTextMarkDefinition = z.infer<typeof markDefinitionSchema>;
+export type RichTextBlock = z.infer<typeof textBlockSchema>;
+export type RichTextMediaNode = z.infer<typeof mediaNodeSchema>;
+export type RichTextNode = z.infer<typeof richTextNodeSchema>;
+export type RichTextDocument = z.infer<typeof richTextDocumentSchema>;
+export {};
+//# sourceMappingURL=rich-text.d.ts.map

package/dist/rich-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rich-text.d.ts","sourceRoot":"","sources":["../src/rich-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,gBAAgB,YAAI,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,CAAU,CAAA;AAEnF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7D,eAAO,MAAM,oBAAoB,YAAI,QAAQ,EAAE,QAAQ,CAAU,CAAA;AAEjE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpE,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,YAAI,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAU,CAAA;AAErE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAQrE,QAAA,MAAM,UAAU;;;;;kBAKd,CAAA;AAEF;;;;GAIG;AACH,QAAA,MAAM,oBAAoB;;;;;;;;;;6BAaxB,CAAA;AAEF,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBASnB,CAAA;AAEF,QAAA,MAAM,eAAe;;;;;kBAKnB,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAoE,CAAA;AAEnG,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAgCjC,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAA;AACrD,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACzE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAC3D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAC/D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAC7D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA"}

package/dist/rich-text.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+/**
+ * The rich text document, contract A § "Texte riche" and ADR-0013.
+ *
+ * A restricted Portable Text model: a list of typed blocks carrying text,
+ * semantic marks and annotations that reference site entities. No HTML, no
+ * Markdown, no editor-internal format — a stored `<div class="…">` would tie an
+ * article to one theme for good, and would have to be sanitised on every read.
+ *
+ * `h1` is deliberately absent: the page title is the only `h1`, and leaving it
+ * available in the body breaks the heading outline and accessibility with it.
+ */
+export const RICH_TEXT_STYLES = ['normal', 'h2', 'h3', 'h4', 'blockquote'];
+export const RICH_TEXT_LIST_ITEMS = ['bullet', 'number'];
+/** Marks that need no definition. Anything else in `marks` is a `markDefs._key`. */
+export const RICH_TEXT_DECORATORS = ['strong', 'em', 'code'];
+/**
+ * Stable across edits: diffs, comments and anchors are all keyed by it. A key
+ * that changes on every save makes a per-block comment thread impossible.
+ */
+const keySchema = z.string().min(1);
+const spanSchema = z.strictObject({
+    _key: keySchema,
+    _type: z.literal('span'),
+    text: z.string(),
+    marks: z.array(z.string().min(1)).default([]),
+});
+/**
+ * An internal link references an *entity*, not a URL. Moving or renaming the
+ * target does not break the link, and deleting the target is detectable —
+ * neither is true of a stored href.
+ */
+const markDefinitionSchema = z.discriminatedUnion('_type', [
+    z.strictObject({
+        _key: keySchema,
+        _type: z.literal('link'),
+        href: z.string().min(1),
+        rel: z.string().optional(),
+    }),
+    z.strictObject({
+        _key: keySchema,
+        _type: z.literal('internalLink'),
+        collection: z.string().min(1),
+        id: z.string().min(1),
+    }),
+]);
+const textBlockSchema = z.strictObject({
+    _key: keySchema,
+    _type: z.literal('block'),
+    style: z.enum(RICH_TEXT_STYLES),
+    listItem: z.enum(RICH_TEXT_LIST_ITEMS).optional(),
+    /** List nesting, from 1. Only meaningful together with `listItem`. */
+    level: z.number().int().min(1).optional(),
+    children: z.array(spanSchema),
+    markDefs: z.array(markDefinitionSchema).default([]),
+});
+const mediaNodeSchema = z.strictObject({
+    _key: keySchema,
+    _type: z.literal('media'),
+    id: z.string().min(1),
+    caption: z.string().optional(),
+});
+export const richTextNodeSchema = z.discriminatedUnion('_type', [textBlockSchema, mediaNodeSchema]);
+export const richTextDocumentSchema = z.array(richTextNodeSchema).superRefine((nodes, context) => {
+    // Two nodes sharing a key silently break every consumer that addresses a
+    // node by key: comments land on the wrong paragraph, diffs pair the wrong
+    // blocks. Cheaper to reject on write than to untangle later.
+    const seen = new Set();
+    for (const [index, node] of nodes.entries()) {
+        if (seen.has(node._key)) {
+            context.addIssue({
+                code: 'custom',
+                message: `duplicate _key "${node._key}"`,
+                path: [index, '_key'],
+            });
+        }
+        seen.add(node._key);
+    }
+    for (const [index, node] of nodes.entries()) {
+        if (node._type !== 'block')
+            continue;
+        const defined = new Set(node.markDefs.map((definition) => definition._key));
+        for (const [childIndex, child] of node.children.entries()) {
+            for (const mark of child.marks) {
+                const isDecorator = RICH_TEXT_DECORATORS.includes(mark);
+                if (!isDecorator && !defined.has(mark)) {
+                    context.addIssue({
+                        code: 'custom',
+                        message: `mark "${mark}" is neither a decorator nor a markDefs key`,
+                        path: [index, 'children', childIndex, 'marks'],
+                    });
+                }
+            }
+        }
+    }
+});
+//# sourceMappingURL=rich-text.js.map

package/dist/rich-text.js.map

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

package/dist/routing/ids.d.ts

@@ -0,0 +1,18 @@
+/**
+ * UUIDv7, generated by the application (ADR-0015).
+ *
+ * `node:crypto` ships `randomUUID` for v4 only, and v4 is exactly what ADR-0015
+ * rules out: random keys fragment a B-tree on insert, which degrades writes as
+ * the table grows. v7 puts a 48-bit millisecond timestamp first, so new rows
+ * land at the end of the index.
+ *
+ * Layout, per RFC 9562 §5.7:
+ *
+ *     0                   1                   2                   3
+ *     |     unix_ts_ms (48 bits)      | ver |  rand_a  | var |  rand_b  |
+ *
+ * Same-millisecond ordering is not guaranteed and is not needed: nothing here
+ * sorts by identifier for correctness, only for index locality.
+ */
+export declare function uuidv7(): string;
+//# sourceMappingURL=ids.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/routing/ids.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,MAAM,IAAI,MAAM,CA0B/B"}

package/dist/routing/ids.js

@@ -0,0 +1,41 @@
+import { randomFillSync } from 'node:crypto';
+/**
+ * UUIDv7, generated by the application (ADR-0015).
+ *
+ * `node:crypto` ships `randomUUID` for v4 only, and v4 is exactly what ADR-0015
+ * rules out: random keys fragment a B-tree on insert, which degrades writes as
+ * the table grows. v7 puts a 48-bit millisecond timestamp first, so new rows
+ * land at the end of the index.
+ *
+ * Layout, per RFC 9562 §5.7:
+ *
+ *     0                   1                   2                   3
+ *     |     unix_ts_ms (48 bits)      | ver |  rand_a  | var |  rand_b  |
+ *
+ * Same-millisecond ordering is not guaranteed and is not needed: nothing here
+ * sorts by identifier for correctness, only for index locality.
+ */
+export function uuidv7() {
+    const bytes = new Uint8Array(16);
+    randomFillSync(bytes);
+    const milliseconds = Date.now();
+    // Big-endian 48-bit timestamp. `Math.floor(ms / 2 ** 32)` rather than a shift:
+    // bitwise operators in JavaScript truncate to 32 bits and would drop the top.
+    bytes[0] = Math.floor(milliseconds / 2 ** 40) & 0xff;
+    bytes[1] = Math.floor(milliseconds / 2 ** 32) & 0xff;
+    bytes[2] = Math.floor(milliseconds / 2 ** 24) & 0xff;
+    bytes[3] = Math.floor(milliseconds / 2 ** 16) & 0xff;
+    bytes[4] = Math.floor(milliseconds / 2 ** 8) & 0xff;
+    bytes[5] = milliseconds & 0xff;
+    bytes[6] = ((bytes[6] ?? 0) & 0x0f) | 0x70; // version 7
+    bytes[8] = ((bytes[8] ?? 0) & 0x3f) | 0x80; // variant 10
+    const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('');
+    return [
+        hex.slice(0, 8),
+        hex.slice(8, 12),
+        hex.slice(12, 16),
+        hex.slice(16, 20),
+        hex.slice(20, 32),
+    ].join('-');
+}
+//# sourceMappingURL=ids.js.map

package/dist/routing/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/routing/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,MAAM;IACpB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;IAChC,cAAc,CAAC,KAAK,CAAC,CAAA;IAErB,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAC/B,+EAA+E;IAC/E,8EAA8E;IAC9E,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACpD,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACpD,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACpD,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACpD,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAA;IACnD,KAAK,CAAC,CAAC,CAAC,GAAG,YAAY,GAAG,IAAI,CAAA;IAE9B,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA,CAAC,YAAY;IACvD,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA,CAAC,aAAa;IAExD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAEpF,OAAO;QACL,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAChB,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;QACjB,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;QACjB,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;KAClB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACb,CAAC"}

package/dist/routing/index.d.ts

@@ -0,0 +1,13 @@
+export type { AddRedirectInput, ListRedirectsOptions, RedirectReason, RedirectRecord, RedirectResolution, RedirectStatus, RedirectStore, RedirectStoreOptions, } from './redirects.js';
+export { createRedirectStore, REDIRECT_REASONS, REDIRECTS_TABLE } from './redirects.js';
+export type { EntryLookup, ResolveUrlOptions, UrlResolution } from './resolve.js';
+export { resolveUrl } from './resolve.js';
+export type { RouteMatch, RouteOptions } from './router.js';
+export { buildPath, matchPath, normalisePath } from './router.js';
+export type { DeriveSlugInput, SlugScope, SlugTakenCheck, SqlSlugScope, UniqueSlugOptions, } from './slug.js';
+export { deriveSlug, slugSourceField, sqlSlugTaken, uniqueSlug } from './slug.js';
+export type { SlugChange } from './slug-change.js';
+export { recordSlugChange } from './slug-change.js';
+export type { SlugifyOptions } from './slugify.js';
+export { DEFAULT_SLUG_MAX_LENGTH, isSlug, slugify, slugifyOrThrow } from './slugify.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACvF,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACjE,YAAY,EACV,eAAe,EACf,SAAS,EACT,cAAc,EACd,YAAY,EACZ,iBAAiB,GAClB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACjF,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA"}

package/dist/routing/index.js

@@ -0,0 +1,7 @@
+export { createRedirectStore, REDIRECT_REASONS, REDIRECTS_TABLE } from './redirects.js';
+export { resolveUrl } from './resolve.js';
+export { buildPath, matchPath, normalisePath } from './router.js';
+export { deriveSlug, slugSourceField, sqlSlugTaken, uniqueSlug } from './slug.js';
+export { recordSlugChange } from './slug-change.js';
+export { DEFAULT_SLUG_MAX_LENGTH, isSlug, slugify, slugifyOrThrow } from './slugify.js';
+//# sourceMappingURL=index.js.map

package/dist/routing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEvF,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAQjE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA"}

package/dist/routing/redirects.d.ts

@@ -0,0 +1,76 @@
+import { type DatabaseHandle } from '@cogenta/core';
+/**
+ * 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 declare const REDIRECTS_TABLE = "cogenta_redirects";
+export declare const REDIRECT_REASONS: readonly ['slug-change', 'manual', 'import'];
+export type RedirectReason = (typeof REDIRECT_REASONS)[number];
+/** 308 and 307 are deliberately absent: a moved page is a GET, and 301 is what search engines act on. */
+export type RedirectStatus = 301 | 302;
+export interface RedirectRecord {
+    readonly id: string;
+    readonly from: string;
+    readonly to: string;
+    readonly status: RedirectStatus;
+    readonly collection: string | null;
+    readonly entryId: string | null;
+    readonly locale: string | null;
+    readonly reason: RedirectReason;
+    /** Epoch milliseconds. */
+    readonly createdAt: number;
+}
+export interface AddRedirectInput {
+    readonly from: string;
+    readonly to: string;
+    readonly status?: RedirectStatus;
+    readonly collection?: string;
+    readonly entryId?: string;
+    readonly locale?: string;
+    readonly reason?: RedirectReason;
+}
+export interface ListRedirectsOptions {
+    readonly limit?: number;
+    readonly collection?: string;
+    readonly locale?: string;
+}
+export interface RedirectResolution {
+    readonly to: string;
+    readonly status: RedirectStatus;
+}
+export interface RedirectStore {
+    /** Creates the table if it is missing. Called for you by every other method. */
+    ensureTable(): Promise<void>;
+    add(input: AddRedirectInput): Promise<RedirectRecord>;
+    /** The final destination of a path, following any chain left by an import. */
+    resolve(path: string): Promise<RedirectResolution | null>;
+    list(options?: ListRedirectsOptions): Promise<RedirectRecord[]>;
+    remove(from: string): Promise<boolean>;
+    /**
+     * Drops any redirect leaving `path`, because real content serves it again.
+     *
+     * The counterpart of `add`'s loop refusal: moving a page back to its old URL
+     * is legitimate, and it is this call — not a silently repaired cycle — that
+     * expresses it.
+     */
+    release(path: string): Promise<boolean>;
+}
+export interface RedirectStoreOptions {
+    readonly db: DatabaseHandle;
+    /** Injected so the tests do not have to wait for a clock. */
+    readonly now?: () => number;
+    /** Injected so a test can assert on identifiers. Defaults to UUIDv7 (ADR-0015). */
+    readonly newId?: () => string;
+    readonly table?: string;
+}
+export declare function createRedirectStore(options: RedirectStoreOptions): RedirectStore;
+//# sourceMappingURL=redirects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redirects.d.ts","sourceRoot":"","sources":["../../src/routing/redirects.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAKpB,MAAM,eAAe,CAAA;AAItB;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,eAAe,sBAAsB,CAAA;AAoBlD,eAAO,MAAM,gBAAgB,YAAI,aAAa,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAA;AAE5E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9D,yGAAyG;AACzG,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,GAAG,CAAA;AAEtC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAA;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,GAAG,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IACrD,8EAA8E;IAC9E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAA;IACzD,IAAI,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IAC/D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACtC;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACxC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAA;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAC3B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAcD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAgOhF"}