@crowi/api 2.0.0-alpha.1 → 2.0.0-alpha.3

package/dist/migration/migrations/wikilink-format.js

@@ -1,12 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.wikilinkFormat = exports.WIKILINK_DETECTION_REGEX = exports.KNOWN_HTML_ELEMENTS = void 0;
+exports.wikilinkFormat = exports.WIKILINK_DETECTION_REGEX = void 0;
 exports.bodyHasRewritableWikilink = bodyHasRewritableWikilink;
 exports.shouldRewriteWikilink = shouldRewriteWikilink;
 exports.rewriteAndDetect = rewriteAndDetect;
 exports.rewriteWikilinks = rewriteWikilinks;
+const api_contract_1 = require("@crowi/api-contract");
 const page_1 = require("../../models/page");
+const helpers_1 = require("../helpers");
 const types_1 = require("../types");
+const code_mask_1 = require("./code-mask");
 /**
  * RFC-0008 §10.2 step 4 / §4.3.1 — `wikilink-format` (preflight layer).
  *
@@ -29,129 +32,6 @@ const types_1 = require("../types");
  * The textual conversion logic below is moved verbatim from the old command so
  * the rewrite output is byte-identical to the legacy migrator.
  */
-/**
- * HTML5 element name set used to reject `</foo>` matches whose first path
- * segment is actually a closing HTML tag. Source:
- * https://developer.mozilla.org/en-US/docs/Web/HTML/Element — the full
- * standard element list as of the HTML Living Standard.
- *
- * Kept as a top-level `Set<string>` so detection runs O(1) per match.
- * `h1`..`h6` are listed explicitly because the regex captures `foo` for
- * `</foo>` and we want both `</h1>` and `</h6>` to be rejected.
- */
-exports.KNOWN_HTML_ELEMENTS = new Set([
-    'a',
-    'abbr',
-    'address',
-    'area',
-    'article',
-    'aside',
-    'audio',
-    'b',
-    'base',
-    'bdi',
-    'bdo',
-    'blockquote',
-    'body',
-    'br',
-    'button',
-    'canvas',
-    'caption',
-    'cite',
-    'code',
-    'col',
-    'colgroup',
-    'data',
-    'datalist',
-    'dd',
-    'del',
-    'details',
-    'dfn',
-    'dialog',
-    'div',
-    'dl',
-    'dt',
-    'em',
-    'embed',
-    'fieldset',
-    'figcaption',
-    'figure',
-    'footer',
-    'form',
-    'h1',
-    'h2',
-    'h3',
-    'h4',
-    'h5',
-    'h6',
-    'head',
-    'header',
-    'hgroup',
-    'hr',
-    'html',
-    'i',
-    'iframe',
-    'img',
-    'input',
-    'ins',
-    'kbd',
-    'label',
-    'legend',
-    'li',
-    'link',
-    'main',
-    'map',
-    'mark',
-    'menu',
-    'meta',
-    'meter',
-    'nav',
-    'noscript',
-    'object',
-    'ol',
-    'optgroup',
-    'option',
-    'output',
-    'p',
-    'picture',
-    'pre',
-    'progress',
-    'q',
-    'rp',
-    'rt',
-    'ruby',
-    's',
-    'samp',
-    'script',
-    'section',
-    'select',
-    'slot',
-    'small',
-    'source',
-    'span',
-    'strong',
-    'style',
-    'sub',
-    'summary',
-    'sup',
-    'table',
-    'tbody',
-    'td',
-    'template',
-    'textarea',
-    'tfoot',
-    'th',
-    'thead',
-    'time',
-    'title',
-    'tr',
-    'track',
-    'u',
-    'ul',
-    'var',
-    'video',
-    'wbr',
-]);
 /**
  * v1 angle-bracket internal link form. The capture group grabs the path-style
  * payload (starts with `/`, no whitespace, no `<` / `>` / `|` other than the
@@ -215,17 +95,24 @@ function shouldRewriteWikilink(innerPath) {
     // Only reject lowercase-ASCII first segments that are real HTML elements.
     if (!/^[a-z][a-z0-9]*$/.test(firstSegment))
         return true;
-    return !exports.KNOWN_HTML_ELEMENTS.has(firstSegment);
+    return !api_contract_1.KNOWN_HTML_ELEMENTS.has(firstSegment);
 }
 /**
  * Single-pass detect-and-rewrite. Returns the rewritten body together with the
  * occurrence list so callers don't walk the regex twice. `body` is returned by
  * reference when nothing changed, letting callers cheap-skip via
  * `result.body === body`. Pure function — no side effects, no I/O.
+ *
+ * Code regions (fenced blocks + inline spans) are excluded: `</…>` written as a
+ * code example is left byte-identical, so it is never misdetected as a v1
+ * wikilink. We run the detection regex only on the non-`code` segments via the
+ * shared `rewriteOutsideCode` primitive, re-joining in original order
+ * (segment-and-rewrite — see `code-mask.ts` for why this beats a fill/restore
+ * scheme). Indented code blocks are an accepted divergence (still rewritten).
  */
 function rewriteAndDetect(body) {
     const occurrences = [];
-    const rewritten = body.replace(exports.WIKILINK_DETECTION_REGEX, (whole, innerPath, aliasWithPipe) => {
+    const rewriteSegment = (text) => text.replace(exports.WIKILINK_DETECTION_REGEX, (whole, innerPath, aliasWithPipe) => {
         if (!shouldRewriteWikilink(innerPath))
             return whole;
         occurrences.push({
@@ -236,6 +123,10 @@ function rewriteAndDetect(body) {
         const aliasSegment = aliasWithPipe ?? '';
         return `[[${innerPath}${aliasSegment}]]`;
     });
+    const rewritten = (0, code_mask_1.rewriteOutsideCode)(body, rewriteSegment);
+    // `rewriteOutsideCode` already returns `body` by reference when nothing
+    // changed; the `occurrences.length === 0` guard keeps that explicit so the
+    // detect / isPending cheap-skip (`result.body === body`) is unmistakable.
     return { body: occurrences.length === 0 ? body : rewritten, occurrences };
 }
 /**
@@ -246,36 +137,6 @@ function rewriteAndDetect(body) {
 function rewriteWikilinks(body) {
     return rewriteAndDetect(body).body;
 }
-/**
- * Resolve which user is recorded as the author of every rewritten revision.
- * The `updatePage`-equivalent path (`rewritePageBody`) ultimately calls
- * `Revision.prepareRevision`, which **throws** when handed a falsy user, so a
- * preflight rewrite MUST resolve a real acting user up front rather than rely
- * on per-page `lastUpdateUser`/`creator` (those can dangle to a deleted user).
- *
- * Order, mirroring the legacy `migrate-wikilink` command:
- *   1. `process.env.CROWI_MIGRATE_USER` — interpreted as an email; the named
- *      user must exist.
- *   2. otherwise the oldest admin user (`{ admin: true }` sorted by createdAt),
- *      deterministic across re-runs.
- *
- * Throws when neither yields a user so the operator gets a clear error instead
- * of a per-page `user should have _id` failure deep inside the rewrite.
- */
-async function resolveActingUserId(ctx) {
-    const User = ctx.crowi.model('User');
-    const explicit = process.env.CROWI_MIGRATE_USER;
-    if (explicit) {
-        const named = await User.findOne({ email: explicit }).select('_id').lean().exec();
-        if (named)
-            return String(named._id);
-        throw new Error(`CROWI_MIGRATE_USER='${explicit}' but no user with that email exists.`);
-    }
-    const admin = await User.findOne({ admin: true }).sort({ createdAt: 1 }).select('_id').lean().exec();
-    if (admin)
-        return String(admin._id);
-    throw new Error('wikilink-format: no admin user found; set CROWI_MIGRATE_USER=<email> or create an admin user first.');
-}
 /**
  * Walk every published page, keep those whose current revision body holds a
  * genuine legacy wikilink (`bodyHasRewritableWikilink` — the same full
@@ -319,6 +180,11 @@ exports.wikilinkFormat = (0, types_1.defineMigration)({
     fromVersion: '1.x',
     toVersion: '2.1',
     layer: 'preflight',
+    // Body display syntax only; no index / integrity impact. `isPending` scans
+    // the live corpus, so new v1-syntax content re-triggers it forever — the
+    // BUG 2 deadlock. Cosmetic so a pending verdict only warns, never refuses
+    // boot.
+    severity: 'cosmetic',
     description: 'Migrate wikilink syntax',
     /**
      * Pending verdict = at least one published page whose **current** revision
@@ -394,7 +260,7 @@ exports.wikilinkFormat = (0, types_1.defineMigration)({
                     const pages = await collectRewritablePages(ctx);
                     return { name: 'rewrite-wikilink', transformed: 0, stats: { wouldRewrite: pages.length } };
                 }
-                const actingUserId = await resolveActingUserId(ctx);
+                const actingUserId = await (0, helpers_1.resolveActingUserId)(ctx, 'wikilink-format');
                 const pages = await collectRewritablePages(ctx);
                 ctx.progress.setTotal(pages.length);
                 let rewritten = 0;

package/dist/migration/migrations/wikilink-format.js.map

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

package/dist/migration/migrations/wikilink-html-recover.d.ts

@@ -0,0 +1,191 @@
+import type { MigrationContext } from '../types';
+/**
+ * `wikilink-html-recover` (preflight layer) — undo the `wikilink-format`
+ * close-tag misfire.
+ *
+ * Before `font` / `center` / `marquee` / `blink` / `applet` were added to
+ * `KNOWN_HTML_ELEMENTS`, `wikilink-format` mistook the deprecated HTML close
+ * tags `</font>` etc. for v1 angle-bracket wikilinks and rewrote them to
+ * `[[/font]]` (§A). `wikilink-format` is recorded as applied and never
+ * re-runs, and the corrupted `[[/font]]` form no longer matches its detection
+ * regex, so it does not self-heal. This migration walks every published page
+ * and reverts the corrupted form `[[/<x>]]` back to the close tag `</x>` when:
+ *
+ *   - `x` is a single path segment (no `/` inside), AND
+ *   - `x` has no `|alias` segment, AND
+ *   - `x` is one of the FIVE deprecated tags the misfire could have produced.
+ *
+ * Scope is the 5 tags, NOT every known HTML element: those 5 were the ONLY
+ * names absent from `KNOWN_HTML_ELEMENTS` when `wikilink-format` ran, so they
+ * are the only `</x>` that could ever have been mis-rewritten to `[[/x]]`.
+ * `section` / `div` / `br` / `img` / etc. were always known and never rewritten,
+ * so a `[[/section]]` in real data is a GENUINE wikilink and must be preserved.
+ *
+ * Genuine wikilinks are otherwise preserved too: `[[/foo/bar]]` (multi-segment),
+ * `[[/font|alias]]` (aliased), `[[/Font]]` (uppercase → case-sensitive page
+ * name), and `[[/wiki-page]]` (non-recoverable name) are all left untouched.
+ *
+ * ── Inherent ambiguity ───────────────────────────────────────────────
+ * `[[/font]]` could be a corrupted `</font>` OR a genuine wikilink to a real
+ * page literally at `/font`. They are indistinguishable from the text alone.
+ * We resolve this conservatively: a `[[/<x>]]` whose `/<x>` matches a **live
+ * content page** (published, not a redirect stub) is NOT reverted — it is
+ * reported by `detect` so an operator can decide manually. The revert therefore
+ * only touches occurrences that have no same-named live page to be mistaken for.
+ * Pages literally named after a deprecated tag (`/font`, `/center`, …) are very
+ * rare, but an absent-page `[[/font]]` is still reverted — see the docs Caution.
+ * ─────────────────────────────────────────────────────────────────────
+ *
+ * Like `wikilink-format`, every body rewrite routes through
+ * `ctx.rewritePageBody` (the `updatePage`-equivalent path) so `yjsState` /
+ * `yjsCheckpointAt` are nulled and an active editor's stale `Y.Doc` cannot
+ * silently revert the recovery (RFC-0008 §4.3.1).
+ *
+ * Idempotent: once reverted, `</x>` no longer matches this migration's
+ * detection regex (it scans for `[[/...]]`, not `</...>`), and a re-run of
+ * `wikilink-format` leaves `</x>` alone because `x` is now in
+ * `KNOWN_HTML_ELEMENTS`.
+ */
+/**
+ * The five deprecated/obsolete presentational tags absent from
+ * `KNOWN_HTML_ELEMENTS` when `wikilink-format` first ran — the ONLY close tags
+ * the misfire could have rewritten to `[[/x]]`. Recovery is scoped to exactly
+ * these so a genuine single-segment wikilink to any other element-named page
+ * (`[[/section]]`, `[[/div]]`, `[[/br]]`) is never destroyed.
+ */
+export declare const RECOVERABLE_DEPRECATED_TAGS: ReadonlySet<string>;
+/**
+ * Matches a corrupted-wikilink candidate `[[/<segment>]]` with a single
+ * path segment and no alias. The capture group grabs the bare segment
+ * (`font` in `[[/font]]`). The `[^[\]|/]+` class excludes `[`, `]`, `|`, and
+ * `/`, so multi-segment (`[[/foo/bar]]`) and aliased (`[[/font|x]]`) forms
+ * never match here — only `shouldRecoverSegment` then filters by tag name.
+ */
+export declare const WIKILINK_HTML_CANDIDATE_REGEX: RegExp;
+/**
+ * True iff `[[/<segment>]]` should be reverted to `</segment>`: the segment is
+ * a lowercase-ASCII identifier that is one of the FIVE deprecated tags the
+ * misfire could have produced. Uppercase (`/Font`), non-deprecated element
+ * names (`/section`, `/div`), and non-HTML names (`/wiki`) are genuine
+ * wikilinks and are left alone.
+ */
+export declare function shouldRecoverSegment(segment: string): boolean;
+/** A single corrupted occurrence located in a body. */
+export interface RecoverableOccurrence {
+    /** The full raw match, e.g. `[[/font]]`. */
+    raw: string;
+    /** The deprecated HTML tag name, e.g. `font`. */
+    element: string;
+}
+/**
+ * Single-pass scan: locate every recoverable `[[/<deprecated-tag>]]` occurrence
+ * in `body`. Pure — no rewrite is applied here (the rewrite happens in
+ * `rewriteBody` after same-name page collisions have been resolved
+ * per-occurrence).
+ */
+export declare function detectRecoverable(body: string): RecoverableOccurrence[];
+/**
+ * `detectRecoverable` restricted to the non-code segments of `body`: a
+ * `[[/font]]` written as a code example (inside a fence or inline span) is NOT
+ * reported, so it never reaches the collision probe / pending verdict and is
+ * never reverted to `</font>`. This is the detect-side counterpart of routing
+ * the rewrite through `rewriteOutsideCode`; `rewrite` and `detect` are
+ * asymmetric (an async per-element collision probe sits between them), so they
+ * cannot share one `fn` — `detect` materialises occurrences here instead.
+ *
+ * `detectRecoverable` resets `lastIndex` at entry, so calling it once per
+ * non-code segment is safe (no cross-segment state). AD-1 (a stray backtick
+ * straddling `[[/font]]` so the token is absorbed into an inline-code span) is
+ * documented in the spec — an accepted false-negative.
+ */
+export declare function detectRecoverableOutsideCode(body: string): RecoverableOccurrence[];
+/**
+ * Rewrite `body`, reverting `[[/<x>]]` → `</x>` for every recoverable element.
+ * Elements in `skip` (those that collide with a live same-named page) are left
+ * untouched. Returns the input by reference when nothing changed so callers can
+ * cheap-skip.
+ *
+ * Code regions (fenced blocks + inline spans) are excluded via the shared
+ * `rewriteOutsideCode` primitive: a `[[/font]]` written as a code example is
+ * left byte-identical (never reverted) so a migration-doc example cannot be
+ * corrupted. The detect side mirrors this via `detectRecoverableOutsideCode`.
+ */
+export declare function rewriteBody(body: string, skip: ReadonlySet<string>): string;
+/**
+ * A skipped (collision) occurrence: the deprecated tag that was left as
+ * `[[/<element>]]` because a live same-named page exists, plus the page that
+ * holds the corrupted markup so an operator can open it from the report.
+ */
+export interface CollisionRecord {
+    /** The deprecated tag name left untouched, e.g. `font`. */
+    element: string;
+    /** `_id` of the page whose body still carries `[[/<element>]]`. */
+    pageId: string;
+    /** Path of that holding page (from the current revision), if available. */
+    pagePath?: string;
+}
+/**
+ * Render collision records into an operator-actionable string that names the
+ * holding page(s) per element, e.g.
+ * `/font (in /docs/setup, /guide); /center (in /notes)`. The element→pages
+ * mapping is preserved so the operator knows exactly which pages to open from
+ * the `migrate plan` output / boot warn log. Elements are sorted; per-element
+ * pages prefer the page path, falling back to the page id when the revision
+ * carried no path.
+ */
+export declare function formatCollisions(collisions: readonly CollisionRecord[]): string;
+export declare const wikilinkHtmlRecover: {
+    id: string;
+    fromVersion: string;
+    toVersion: string;
+    layer: "preflight";
+    severity: "cosmetic";
+    order: number;
+    description: string;
+    /**
+     * Pending iff at least one published page's current revision body still
+     * carries a revertible `[[/<deprecated-tag>]]` whose element has no live
+     * same-named page. There is no index on `revision.body`, so this walks
+     * published pages (projecting `body`) and short-circuits at the first
+     * revertible occurrence.
+     *
+     * Colliding occurrences (`[[/font]]` with a live `/font` page) do NOT count
+     * as pending: this migration will never revert them, so reporting pending
+     * for them would block boot forever under preflight + `block`.
+     */
+    isPending: (ctx: MigrationContext) => Promise<false>;
+    /**
+     * Full scan for `plan`: report how many pages / occurrences would be
+     * reverted plus, separately, the deprecated-tag names that were left alone
+     * because a live same-named page exists (the operator must resolve those
+     * by hand). Not called at boot.
+     */
+    detect: (ctx: MigrationContext) => Promise<{
+        summary: string;
+        counts: {
+            pages: number;
+            occurrences: number;
+            collisions: number;
+        };
+    }>;
+    stages: {
+        name: string;
+        fn: (ctx: MigrationContext) => Promise<{
+            name: string;
+            transformed: number;
+            stats: {
+                wouldRevert: number;
+                occurrences: number;
+                collisions: number;
+            };
+        } | {
+            name: string;
+            transformed: number;
+            stats: {
+                collisions: number;
+                wouldRevert?: undefined;
+                occurrences?: undefined;
+            };
+        }>;
+    }[];
+};