@prenta/core 0.118.0

package/dist/redirects/auto.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Auto-301 planning for slug/path changes.
+ *
+ * When a *published* document's resolved URL changes, the old URL was already
+ * crawled/linked/indexed and must not 404. This module computes — as a pure,
+ * fully testable function — the redirect mutations needed to keep the old URL
+ * alive without building chains or loops:
+ *
+ *   1. Drop any rule whose source is the new (now-live) path, which would
+ *      otherwise redirect the page away from itself.
+ *   2. Repoint any rule that pointed at the old path so it points at the new
+ *      path directly (chain flattening — never old→mid→new).
+ *   3. Add old→new, but only if the simulated post-mutation rule set stays
+ *      loop-free (e.g. a pre-existing new→old rule we are not removing).
+ *
+ * The caller (actions.ts) applies the returned plan in a single transaction.
+ */
+import { type RedirectRecord } from './graph.js';
+export interface SlugRedirectPlan {
+    /** Redirect to create or upsert (source already normalized), or null to skip. */
+    upsert: {
+        source: string;
+        destination: string;
+    } | null;
+    /** Existing redirect ids to delete (their source is the now-live new path). */
+    deleteIds: string[];
+    /** Existing redirects to repoint at the new path (chain flattening). */
+    repoint: Array<{
+        id: string;
+        destination: string;
+    }>;
+}
+/** True when the plan would make no database changes. */
+export declare function isEmptyPlan(plan: SlugRedirectPlan): boolean;
+/**
+ * Compute the redirect mutations for a slug/path change. Both paths are
+ * site-relative (e.g. `/old-about`); normalization (leading slash, no trailing
+ * slash, lowercase) is applied internally and matches request-time matching.
+ */
+export declare function planSlugChangeRedirects(params: {
+    oldPath: string;
+    newPath: string;
+    existing: RedirectRecord[];
+}): SlugRedirectPlan;
+//# sourceMappingURL=auto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auto.d.ts","sourceRoot":"","sources":["../../src/redirects/auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACtD,+EAA+E;IAC/E,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,wEAAwE;IACxE,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACpD;AAID,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,cAAc,EAAE,CAAA;CAC3B,GAAG,gBAAgB,CAsCnB"}

package/dist/redirects/auto.js

@@ -0,0 +1,60 @@
+/**
+ * Auto-301 planning for slug/path changes.
+ *
+ * When a *published* document's resolved URL changes, the old URL was already
+ * crawled/linked/indexed and must not 404. This module computes — as a pure,
+ * fully testable function — the redirect mutations needed to keep the old URL
+ * alive without building chains or loops:
+ *
+ *   1. Drop any rule whose source is the new (now-live) path, which would
+ *      otherwise redirect the page away from itself.
+ *   2. Repoint any rule that pointed at the old path so it points at the new
+ *      path directly (chain flattening — never old→mid→new).
+ *   3. Add old→new, but only if the simulated post-mutation rule set stays
+ *      loop-free (e.g. a pre-existing new→old rule we are not removing).
+ *
+ * The caller (actions.ts) applies the returned plan in a single transaction.
+ */
+import { normalizeRedirectPath, normalizeRedirectTarget, wouldCreateLoop, } from './graph.js';
+const EMPTY_PLAN = { upsert: null, deleteIds: [], repoint: [] };
+/** True when the plan would make no database changes. */
+export function isEmptyPlan(plan) {
+    return !plan.upsert && plan.deleteIds.length === 0 && plan.repoint.length === 0;
+}
+/**
+ * Compute the redirect mutations for a slug/path change. Both paths are
+ * site-relative (e.g. `/old-about`); normalization (leading slash, no trailing
+ * slash, lowercase) is applied internally and matches request-time matching.
+ */
+export function planSlugChangeRedirects(params) {
+    const oldN = normalizeRedirectPath(params.oldPath);
+    const newN = normalizeRedirectPath(params.newPath);
+    // Matching (source) is case-insensitive, but the stored *destination* must
+    // keep its original case — Next.js route paths are case-sensitive, so a
+    // lowercased `/Case-Studies/acme` → `/case-studies/acme` target would 301
+    // straight to a 404. Use the case-preserving target for everything written.
+    const newDest = normalizeRedirectTarget(params.newPath);
+    // Nothing to do when the URL did not actually change. Never redirect the
+    // site root onto itself or onto a child — a homepage "move" is almost always
+    // an unrelated path edit and a `/` → /x rule would break the whole site.
+    if (!oldN || !newN || oldN === newN || oldN === '/')
+        return EMPTY_PLAN;
+    const deleteIds = params.existing
+        .filter((r) => normalizeRedirectPath(r.from) === newN)
+        .map((r) => r.id);
+    const repoint = params.existing
+        .filter((r) => !deleteIds.includes(r.id) &&
+        normalizeRedirectPath(r.to) === oldN &&
+        normalizeRedirectPath(r.from) !== newN)
+        .map((r) => ({ id: r.id, destination: newDest }));
+    // Simulate the post-mutation rule set (deletes applied, repoints applied)
+    // and only add the new edge if it stays loop-free.
+    const remaining = params.existing
+        .filter((r) => !deleteIds.includes(r.id))
+        .map((r) => (repoint.some((p) => p.id === r.id) ? { ...r, to: newN } : r));
+    if (wouldCreateLoop(remaining, oldN, newN)) {
+        return { upsert: null, deleteIds, repoint };
+    }
+    return { upsert: { source: oldN, destination: newDest }, deleteIds, repoint };
+}
+//# sourceMappingURL=auto.js.map

package/dist/redirects/auto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto.js","sourceRoot":"","sources":["../../src/redirects/auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,GAEhB,MAAM,YAAY,CAAA;AAWnB,MAAM,UAAU,GAAqB,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;AAEjF,yDAAyD;AACzD,MAAM,UAAU,WAAW,CAAC,IAAsB;IAChD,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAA;AACjF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAIvC;IACC,MAAM,IAAI,GAAG,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAClD,MAAM,IAAI,GAAG,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAClD,2EAA2E;IAC3E,wEAAwE;IACxE,0EAA0E;IAC1E,4EAA4E;IAC5E,MAAM,OAAO,GAAG,uBAAuB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAEvD,yEAAyE;IACzE,6EAA6E;IAC7E,yEAAyE;IACzE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,UAAU,CAAA;IAEtE,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ;SAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;SACrD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAEnB,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ;SAC5B,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACzB,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI;QACpC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CACzC;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;IAEnD,0EAA0E;IAC1E,mDAAmD;IACnD,MAAM,SAAS,GAAqB,MAAM,CAAC,QAAQ;SAChD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACxC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAE5E,IAAI,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QAC3C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;IAC7C,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;AAC/E,CAAC"}

package/dist/redirects/fix-link.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Replace broken hrefs inside document JSON (sections, rich text, etc.).
+ */
+export declare function replaceHrefInValue(value: unknown, fromHref: string, toHref: string): {
+    value: unknown;
+    changed: boolean;
+};
+/** Apply href replacements to document.data; returns partial patch of changed keys. */
+export declare function buildLinkFixPatch(data: Record<string, unknown>, fromHref: string, toHref: string): {
+    patch: Record<string, unknown>;
+    changed: boolean;
+};
+/** Convert a live path to the same href shape as the broken link (relative vs absolute). */
+export declare function targetHrefForBroken(brokenHref: string, toPath: string, siteUrl?: string): string;
+//# sourceMappingURL=fix-link.d.ts.map

package/dist/redirects/fix-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-link.d.ts","sourceRoot":"","sources":["../../src/redirects/fix-link.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAyBtC;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAWtD;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAOhG"}

package/dist/redirects/fix-link.js

@@ -0,0 +1,66 @@
+/**
+ * Replace broken hrefs inside document JSON (sections, rich text, etc.).
+ */
+function replaceHrefInString(text, fromHref, toHref) {
+    if (!text.includes(fromHref))
+        return { text, changed: false };
+    const escaped = fromHref.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const re = new RegExp(`(href\\s*=\\s*["'])${escaped}(["'])`, 'gi');
+    if (!re.test(text))
+        return { text, changed: false };
+    return {
+        text: text.replace(new RegExp(`(href\\s*=\\s*["'])${escaped}(["'])`, 'gi'), `$1${toHref}$2`),
+        changed: true,
+    };
+}
+export function replaceHrefInValue(value, fromHref, toHref) {
+    if (typeof value === 'string') {
+        const r = replaceHrefInString(value, fromHref, toHref);
+        return { value: r.text, changed: r.changed };
+    }
+    if (Array.isArray(value)) {
+        let changed = false;
+        const next = value.map((item) => {
+            const r = replaceHrefInValue(item, fromHref, toHref);
+            if (r.changed)
+                changed = true;
+            return r.value;
+        });
+        return { value: next, changed };
+    }
+    if (value && typeof value === 'object') {
+        let changed = false;
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            const r = replaceHrefInValue(v, fromHref, toHref);
+            out[k] = r.value;
+            if (r.changed)
+                changed = true;
+        }
+        return { value: out, changed };
+    }
+    return { value, changed: false };
+}
+/** Apply href replacements to document.data; returns partial patch of changed keys. */
+export function buildLinkFixPatch(data, fromHref, toHref) {
+    const patch = {};
+    let changed = false;
+    for (const [key, val] of Object.entries(data)) {
+        const r = replaceHrefInValue(val, fromHref, toHref);
+        if (r.changed) {
+            patch[key] = r.value;
+            changed = true;
+        }
+    }
+    return { patch, changed };
+}
+/** Convert a live path to the same href shape as the broken link (relative vs absolute). */
+export function targetHrefForBroken(brokenHref, toPath, siteUrl) {
+    const trimmed = brokenHref.trim();
+    if (/^https?:\/\//i.test(trimmed) && siteUrl) {
+        const base = siteUrl.replace(/\/+$/, '');
+        return `${base}${toPath.startsWith('/') ? toPath : `/${toPath}`}`;
+    }
+    return toPath.startsWith('/') ? toPath : `/${toPath}`;
+}
+//# sourceMappingURL=fix-link.js.map

package/dist/redirects/fix-link.js.map

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

package/dist/redirects/graph.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Redirect graph utilities — pure functions for chain/loop detection,
+ * loop-prevention on write, path normalization, and stale detection.
+ *
+ * Lives in cms-core (not plugin-redirects) because the API layer needs it and
+ * the dependency direction forbids core importing a plugin. The plugin's
+ * request-time middleware can stay independent.
+ */
+export interface RedirectRecord {
+    id: string;
+    from: string;
+    to: string;
+    enabled?: boolean;
+    statusCode?: number;
+}
+/**
+ * Normalize a path for matching: drop query/hash, ensure a single leading
+ * slash, strip a trailing slash (except root), and lowercase. External
+ * absolute URLs are returned lowercased without a forced leading slash.
+ */
+export declare function normalizeRedirectPath(input: string): string;
+/**
+ * Normalize a redirect *destination* (the target we send the browser to).
+ *
+ * Same shape as {@link normalizeRedirectPath} — single leading slash, no
+ * trailing slash, query/hash dropped — but **NOT lowercased**. Next.js route
+ * paths are case-sensitive, so a destination like `/Case-Studies/acme` must
+ * keep its casing or the 301 lands on a 404. External absolute URLs are
+ * returned trimmed (never rewritten). Use this for the `to`/`destination` of a
+ * rule; use {@link normalizeRedirectPath} for the `from`/source (matching is
+ * intentionally case-insensitive).
+ */
+export declare function normalizeRedirectTarget(input: string): string;
+/** True when a redirect points to an external (absolute) destination. */
+export declare function isExternal(to: string): boolean;
+interface Edge {
+    to: string;
+    toNorm: string;
+    id: string;
+}
+/** Build a normalized from -> edge map of enabled rules. */
+export declare function buildEdgeMap(rules: RedirectRecord[]): Map<string, Edge>;
+export interface ChainResolution {
+    /** Normalized path sequence, starting at `start`. */
+    hops: string[];
+    /** Final destination (normalized) the chain settles on, or the loop entry. */
+    terminal: string;
+    /** True when a cycle was detected. */
+    loop: boolean;
+}
+/**
+ * Follow the redirect map from `start` until a path with no further mapping
+ * (terminal) or a cycle is reached.
+ *
+ * A cycle is detected by set membership (the `seen` set) regardless of how many
+ * hops in it occurs, so a loop that closes only after a long chain is still
+ * caught. `maxHops` is purely a runaway guard set well above any realistic
+ * chain length; if it is ever exhausted without hitting a terminal we report
+ * `loop: true` (conservative) rather than falsely claiming the chain is
+ * loop-free — the latter would let a deep cycle slip past `wouldCreateLoop`.
+ */
+export declare function resolveChain(map: Map<string, Edge>, start: string, maxHops?: number): ChainResolution;
+export interface DetectedChain {
+    id: string;
+    kind: 'chain' | 'loop';
+    /** Full hop sequence (normalized paths). */
+    hops: string[];
+    /** Suggested single-hop source. */
+    suggestedFrom: string;
+    /** Suggested single-hop destination (final terminal, or loop break). */
+    suggestedTo: string;
+}
+/**
+ * Detect multi-hop chains (3+ nodes => 2+ redirects) and loops across the
+ * rule set. Returns one entry per chain/loop keyed by a stable id derived from
+ * the starting source.
+ */
+export declare function detectChainsAndLoops(rules: RedirectRecord[]): DetectedChain[];
+/**
+ * Would adding (or updating to) `from -> to` create a loop or self-redirect?
+ * Simulates the new edge over the existing rule set.
+ */
+export declare function wouldCreateLoop(rules: RedirectRecord[], from: string, to: string, ignoreId?: string): boolean;
+/** True when a redirect has never recorded a hit (`lastHitAt` null/invalid). */
+export declare function isRedirectNeverHit(lastHitAt: Date | string | null | undefined): boolean;
+/**
+ * A redirect is stale when it **has** been hit before, but not in 60+ days.
+ * Never-hit rules are not stale — use {@link isRedirectNeverHit} for those.
+ */
+export declare function isRedirectStale(lastHitAt: Date | string | null | undefined, now?: Date): boolean;
+export {};
+//# sourceMappingURL=graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/redirects/graph.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ7D;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,UAAU,IAAI;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;CACX;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CASvE;AAED,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAA;IAChB,sCAAsC;IACtC,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,SAAO,GACb,eAAe,CAqBjB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,OAAO,GAAG,MAAM,CAAA;IACtB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,aAAa,EAAE,CAgC7E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EAAE,EACvB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAWT;AAID,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAIvF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAC3C,GAAG,OAAa,GACf,OAAO,CAKT"}

package/dist/redirects/graph.js

@@ -0,0 +1,176 @@
+/**
+ * Redirect graph utilities — pure functions for chain/loop detection,
+ * loop-prevention on write, path normalization, and stale detection.
+ *
+ * Lives in cms-core (not plugin-redirects) because the API layer needs it and
+ * the dependency direction forbids core importing a plugin. The plugin's
+ * request-time middleware can stay independent.
+ */
+/**
+ * Normalize a path for matching: drop query/hash, ensure a single leading
+ * slash, strip a trailing slash (except root), and lowercase. External
+ * absolute URLs are returned lowercased without a forced leading slash.
+ */
+export function normalizeRedirectPath(input) {
+    if (!input)
+        return '/';
+    let p = String(input).trim();
+    if (/^https?:\/\//i.test(p))
+        return p.toLowerCase();
+    // Strip query + hash.
+    p = p.split('#')[0].split('?')[0];
+    if (!p.startsWith('/'))
+        p = `/${p}`;
+    if (p.length > 1 && p.endsWith('/'))
+        p = p.slice(0, -1);
+    return p.toLowerCase();
+}
+/**
+ * Normalize a redirect *destination* (the target we send the browser to).
+ *
+ * Same shape as {@link normalizeRedirectPath} — single leading slash, no
+ * trailing slash, query/hash dropped — but **NOT lowercased**. Next.js route
+ * paths are case-sensitive, so a destination like `/Case-Studies/acme` must
+ * keep its casing or the 301 lands on a 404. External absolute URLs are
+ * returned trimmed (never rewritten). Use this for the `to`/`destination` of a
+ * rule; use {@link normalizeRedirectPath} for the `from`/source (matching is
+ * intentionally case-insensitive).
+ */
+export function normalizeRedirectTarget(input) {
+    if (!input)
+        return '/';
+    let p = String(input).trim();
+    if (/^https?:\/\//i.test(p))
+        return p;
+    p = p.split('#')[0].split('?')[0];
+    if (!p.startsWith('/'))
+        p = `/${p}`;
+    if (p.length > 1 && p.endsWith('/'))
+        p = p.slice(0, -1);
+    return p;
+}
+/** True when a redirect points to an external (absolute) destination. */
+export function isExternal(to) {
+    return /^https?:\/\//i.test(to.trim());
+}
+/** Build a normalized from -> edge map of enabled rules. */
+export function buildEdgeMap(rules) {
+    const map = new Map();
+    for (const r of rules) {
+        if (r.enabled === false)
+            continue;
+        const fromNorm = normalizeRedirectPath(r.from);
+        if (map.has(fromNorm))
+            continue; // first rule wins (priority handled upstream)
+        map.set(fromNorm, { to: r.to, toNorm: normalizeRedirectPath(r.to), id: r.id });
+    }
+    return map;
+}
+/**
+ * Follow the redirect map from `start` until a path with no further mapping
+ * (terminal) or a cycle is reached.
+ *
+ * A cycle is detected by set membership (the `seen` set) regardless of how many
+ * hops in it occurs, so a loop that closes only after a long chain is still
+ * caught. `maxHops` is purely a runaway guard set well above any realistic
+ * chain length; if it is ever exhausted without hitting a terminal we report
+ * `loop: true` (conservative) rather than falsely claiming the chain is
+ * loop-free — the latter would let a deep cycle slip past `wouldCreateLoop`.
+ */
+export function resolveChain(map, start, maxHops = 1000) {
+    const startNorm = normalizeRedirectPath(start);
+    const hops = [startNorm];
+    const seen = new Set([startNorm]);
+    let current = startNorm;
+    for (let i = 0; i < maxHops; i++) {
+        const edge = map.get(current);
+        if (!edge) {
+            return { hops, terminal: current, loop: false };
+        }
+        const next = edge.toNorm;
+        hops.push(next);
+        if (seen.has(next)) {
+            return { hops, terminal: next, loop: true };
+        }
+        seen.add(next);
+        current = next;
+    }
+    // Bound exhausted without reaching a terminal: treat as a potential loop.
+    return { hops, terminal: current, loop: true };
+}
+/**
+ * Detect multi-hop chains (3+ nodes => 2+ redirects) and loops across the
+ * rule set. Returns one entry per chain/loop keyed by a stable id derived from
+ * the starting source.
+ */
+export function detectChainsAndLoops(rules) {
+    const map = buildEdgeMap(rules);
+    const results = [];
+    const reported = new Set();
+    for (const [from] of map) {
+        if (reported.has(from))
+            continue;
+        const res = resolveChain(map, from);
+        if (res.loop) {
+            // Only report loops once per cycle (mark all hops reported).
+            res.hops.forEach((h) => reported.add(h));
+            const breakTo = res.hops.find((h) => h !== from && h !== res.terminal) ?? res.terminal;
+            results.push({
+                id: `loop:${from}`,
+                kind: 'loop',
+                hops: res.hops,
+                suggestedFrom: from,
+                suggestedTo: breakTo,
+            });
+        }
+        else if (res.hops.length >= 3) {
+            // Mark intermediate sources reported so we don't emit sub-chains.
+            res.hops.slice(0, -1).forEach((h) => reported.add(h));
+            results.push({
+                id: `chain:${from}`,
+                kind: 'chain',
+                hops: res.hops,
+                suggestedFrom: from,
+                suggestedTo: res.terminal,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Would adding (or updating to) `from -> to` create a loop or self-redirect?
+ * Simulates the new edge over the existing rule set.
+ */
+export function wouldCreateLoop(rules, from, to, ignoreId) {
+    const fromNorm = normalizeRedirectPath(from);
+    const toNorm = normalizeRedirectPath(to);
+    if (fromNorm === toNorm)
+        return true;
+    if (isExternal(to))
+        return false; // external targets can't loop internally
+    const others = rules.filter((r) => r.id !== ignoreId);
+    const map = buildEdgeMap(others);
+    map.set(fromNorm, { to, toNorm, id: ignoreId ?? '__new__' });
+    const res = resolveChain(map, fromNorm);
+    return res.loop;
+}
+const STALE_DAYS = 60;
+/** True when a redirect has never recorded a hit (`lastHitAt` null/invalid). */
+export function isRedirectNeverHit(lastHitAt) {
+    if (!lastHitAt)
+        return true;
+    const last = typeof lastHitAt === 'string' ? new Date(lastHitAt) : lastHitAt;
+    return Number.isNaN(last.getTime());
+}
+/**
+ * A redirect is stale when it **has** been hit before, but not in 60+ days.
+ * Never-hit rules are not stale — use {@link isRedirectNeverHit} for those.
+ */
+export function isRedirectStale(lastHitAt, now = new Date()) {
+    if (isRedirectNeverHit(lastHitAt))
+        return false;
+    const last = typeof lastHitAt === 'string' ? new Date(lastHitAt) : lastHitAt;
+    const ageMs = now.getTime() - last.getTime();
+    return ageMs > STALE_DAYS * 24 * 60 * 60 * 1000;
+}
+//# sourceMappingURL=graph.js.map

package/dist/redirects/graph.js.map

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

package/dist/redirects/index.d.ts

@@ -0,0 +1,17 @@
+export { normalizeRedirectPath, isExternal, buildEdgeMap, resolveChain, detectChainsAndLoops, wouldCreateLoop, isRedirectStale, isRedirectNeverHit, } from './graph.js';
+export type { RedirectRecord, ChainResolution, DetectedChain } from './graph.js';
+export { suggestRedirectTarget } from './suggest.js';
+export type { SuggestCandidate, RedirectSuggestionResult } from './suggest.js';
+export { scorePathLegitimacy } from './legitimacy.js';
+export type { LegitimacySignals, LegitimacyResult } from './legitimacy.js';
+export { collectRecoveryPaths, planRecoveryRedirect, planRecoveryRedirects, upsertRedirectSuggestions, generateRecoverySuggestions, createRecoveryRedirect, } from './recovery.js';
+export type { BrokenLinkRef, RecoveryPathSignals, RecoveryPlan, RecoveryPlanOptions, } from './recovery.js';
+export { rankRedirectCandidates } from './suggest.js';
+export { validateRedirectDestination } from './validate-destination.js';
+export type { RedirectDestinationValidationOptions } from './validate-destination.js';
+export type { RedirectMatchResult, RedirectMatchSource, SemanticRerankFn } from './rerank.js';
+export { isLikelyEditorTypo } from './typo.js';
+export { buildLinkFixPatch, replaceHrefInValue, targetHrefForBroken } from './fix-link.js';
+export { planSlugChangeRedirects, isEmptyPlan } from './auto.js';
+export type { SlugRedirectPlan } from './auto.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/redirects/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAA;AAEnB,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEhF,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAEpD,YAAY,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AAE9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAE1E,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,eAAe,CAAA;AAEtB,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,GACpB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAErD,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAA;AAEvE,YAAY,EAAE,oCAAoC,EAAE,MAAM,2BAA2B,CAAA;AAErF,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAE9C,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAE1F,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEhE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA"}

package/dist/redirects/index.js

@@ -0,0 +1,10 @@
+export { normalizeRedirectPath, isExternal, buildEdgeMap, resolveChain, detectChainsAndLoops, wouldCreateLoop, isRedirectStale, isRedirectNeverHit, } from './graph.js';
+export { suggestRedirectTarget } from './suggest.js';
+export { scorePathLegitimacy } from './legitimacy.js';
+export { collectRecoveryPaths, planRecoveryRedirect, planRecoveryRedirects, upsertRedirectSuggestions, generateRecoverySuggestions, createRecoveryRedirect, } from './recovery.js';
+export { rankRedirectCandidates } from './suggest.js';
+export { validateRedirectDestination } from './validate-destination.js';
+export { isLikelyEditorTypo } from './typo.js';
+export { buildLinkFixPatch, replaceHrefInValue, targetHrefForBroken } from './fix-link.js';
+export { planSlugChangeRedirects, isEmptyPlan } from './auto.js';
+//# sourceMappingURL=index.js.map

package/dist/redirects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/redirects/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAA;AAInB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAIpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAIrD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,eAAe,CAAA;AAStB,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAErD,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAA;AAMvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAE9C,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAE1F,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA"}

package/dist/redirects/legitimacy.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Legitimacy scoring for broken URLs — gates redirect recovery so probe/scanner
+ * paths are not promoted to 301 suggestions.
+ */
+export interface LegitimacySignals {
+    /** Linked from CMS content (strong signal — editor intended this URL). */
+    hasInternalLink?: boolean;
+    /** Aggregated 404 hit count from live traffic. */
+    hitCount?: number;
+    /** Known collection URL prefixes, e.g. `/blog`, `/services`. */
+    pathPrefixes?: string[];
+}
+export interface LegitimacyResult {
+    score: number;
+    legitimate: boolean;
+    reasons: string[];
+}
+/**
+ * Score how likely a broken path was a real page (0–100). Internal CMS links
+ * always pass — someone deliberately linked to this URL.
+ */
+export declare function scorePathLegitimacy(path: string, signals?: LegitimacySignals): LegitimacyResult;
+//# sourceMappingURL=legitimacy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"legitimacy.d.ts","sourceRoot":"","sources":["../../src/redirects/legitimacy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,OAAO,CAAA;IACnB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAgBD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAwClB"}

package/dist/redirects/legitimacy.js

@@ -0,0 +1,64 @@
+/**
+ * Legitimacy scoring for broken URLs — gates redirect recovery so probe/scanner
+ * paths are not promoted to 301 suggestions.
+ */
+/** Common scanner / exploit probe patterns — never redirect these alone. */
+const PROBE_PATTERNS = [
+    /^\/wp-(admin|content|includes|login)/i,
+    /\.(php|asp|aspx|cgi|env|git|sql|bak|old|swp)$/i,
+    /^\/xmlrpc/i,
+    /^\/\.env/i,
+    /^\/administrator/i,
+    /^\/phpmyadmin/i,
+    /\/\.\./,
+    /^\/cgi-bin/i,
+];
+function pathSegments(path) {
+    return path.split('/').filter(Boolean);
+}
+function looksLikeContentSlug(path) {
+    const segments = pathSegments(path);
+    if (segments.length === 0 || segments.length > 6)
+        return false;
+    return segments.every((s) => /^[a-z0-9][a-z0-9-]*$/i.test(s) && s.length <= 80);
+}
+function matchesProbePattern(path) {
+    return PROBE_PATTERNS.some((re) => re.test(path));
+}
+/**
+ * Score how likely a broken path was a real page (0–100). Internal CMS links
+ * always pass — someone deliberately linked to this URL.
+ */
+export function scorePathLegitimacy(path, signals = {}) {
+    const reasons = [];
+    let score = 0;
+    if (signals.hasInternalLink) {
+        score += 45;
+        reasons.push('Linked from CMS content');
+    }
+    const hits = signals.hitCount ?? 0;
+    if (hits > 0) {
+        const hitPts = hits >= 5 ? 35 : hits >= 2 ? 25 : 12;
+        score += hitPts;
+        reasons.push(`${hits} real 404 hit${hits === 1 ? '' : 's'}`);
+    }
+    if (looksLikeContentSlug(path)) {
+        score += 15;
+        reasons.push('URL matches site slug pattern');
+    }
+    if (signals.pathPrefixes?.some((p) => path === p || path.startsWith(`${p}/`))) {
+        score += 10;
+        reasons.push('URL matches a known collection prefix');
+    }
+    if (matchesProbePattern(path)) {
+        score -= 60;
+        reasons.push('Matches common probe/scanner pattern');
+    }
+    score = Math.max(0, Math.min(100, score));
+    // Internal links are always legitimate; probes without CMS links are not.
+    const legitimate = signals.hasInternalLink === true ||
+        (score >= 30 && !matchesProbePattern(path)) ||
+        (hits >= 5 && !matchesProbePattern(path));
+    return { score, legitimate, reasons };
+}
+//# sourceMappingURL=legitimacy.js.map

package/dist/redirects/legitimacy.js.map

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