@wp-typia/project-tools 0.24.3 → 0.24.5

package/dist/runtime/migration/migration-project-config-source.js

@@ -0,0 +1,424 @@
+import path from "node:path";
+import { compareMigrationVersionLabels, formatLegacyMigrationWorkspaceResetGuidance, isLegacySemverMigrationVersion, isMigrationVersionLabel, } from "./migration-utils.js";
+export function normalizeRelativePath(value) {
+    return value.replace(/\\/g, "/");
+}
+export function ensureRelativePath(projectDir, filePath) {
+    return normalizeRelativePath(path.relative(projectDir, filePath));
+}
+function stripCommentsAndStrings(source) {
+    let result = "";
+    let index = 0;
+    let mode = "code";
+    while (index < source.length) {
+        const current = source[index];
+        const next = source[index + 1];
+        if (mode === "code") {
+            if (current === "/" && next === "/") {
+                result += "  ";
+                index += 2;
+                mode = "line-comment";
+                continue;
+            }
+            if (current === "/" && next === "*") {
+                result += "  ";
+                index += 2;
+                mode = "block-comment";
+                continue;
+            }
+            if (current === "'") {
+                result += current;
+                index += 1;
+                mode = "single-quote";
+                continue;
+            }
+            if (current === "\"") {
+                result += current;
+                index += 1;
+                mode = "double-quote";
+                continue;
+            }
+            if (current === "`") {
+                result += current;
+                index += 1;
+                mode = "template";
+                continue;
+            }
+            result += current;
+            index += 1;
+            continue;
+        }
+        if (mode === "line-comment") {
+            result += current === "\n" ? "\n" : " ";
+            index += 1;
+            if (current === "\n") {
+                mode = "code";
+            }
+            continue;
+        }
+        if (mode === "block-comment") {
+            if (current === "*" && next === "/") {
+                result += "  ";
+                index += 2;
+                mode = "code";
+                continue;
+            }
+            result += current === "\n" ? "\n" : " ";
+            index += 1;
+            continue;
+        }
+        if (current === "\\") {
+            result += index + 1 < source.length ? "  " : " ";
+            index += Math.min(2, source.length - index);
+            continue;
+        }
+        const closingQuote = mode === "single-quote"
+            ? "'"
+            : mode === "double-quote"
+                ? "\""
+                : "`";
+        if (current === closingQuote) {
+            result += current;
+            index += 1;
+            mode = "code";
+            continue;
+        }
+        result += current === "\n" ? "\n" : " ";
+        index += 1;
+    }
+    return result;
+}
+function findMigrationConfigBodyRange(source) {
+    const sanitizedSource = stripCommentsAndStrings(source);
+    const configAssignment = /\bmigrationConfig\s*=\s*\{/u.exec(sanitizedSource);
+    if (!configAssignment) {
+        return null;
+    }
+    const braceStart = configAssignment.index + configAssignment[0].length - 1;
+    let braceDepth = 0;
+    for (let index = braceStart; index < sanitizedSource.length; index += 1) {
+        const current = sanitizedSource[index];
+        if (current === "{") {
+            braceDepth += 1;
+            continue;
+        }
+        if (current === "}") {
+            braceDepth -= 1;
+            if (braceDepth === 0) {
+                return {
+                    end: index,
+                    start: braceStart + 1,
+                };
+            }
+        }
+    }
+    return null;
+}
+function createTopLevelConfigView(source) {
+    const range = findMigrationConfigBodyRange(source);
+    if (!range) {
+        return null;
+    }
+    const bodySource = source.slice(range.start, range.end);
+    const sanitizedBody = stripCommentsAndStrings(bodySource);
+    let view = "";
+    let braceDepth = 0;
+    let bracketDepth = 0;
+    let parenDepth = 0;
+    for (let index = 0; index < sanitizedBody.length; index += 1) {
+        const current = sanitizedBody[index];
+        if (current === "{") {
+            braceDepth += 1;
+        }
+        else if (current === "}") {
+            braceDepth = Math.max(0, braceDepth - 1);
+        }
+        else if (current === "[") {
+            bracketDepth += 1;
+        }
+        else if (current === "]") {
+            bracketDepth = Math.max(0, bracketDepth - 1);
+        }
+        else if (current === "(") {
+            parenDepth += 1;
+        }
+        else if (current === ")") {
+            parenDepth = Math.max(0, parenDepth - 1);
+        }
+        const nested = braceDepth > 0 || bracketDepth > 0 || parenDepth > 0;
+        view += nested && current !== "{" && current !== "}" && current !== "[" && current !== "]" && current !== "(" && current !== ")"
+            ? current === "\n"
+                ? "\n"
+                : " "
+            : current;
+    }
+    return view;
+}
+function findTopLevelConfigPropertyValueStart(source, key) {
+    const range = findMigrationConfigBodyRange(source);
+    if (!range) {
+        return null;
+    }
+    const bodySource = source.slice(range.start, range.end);
+    const topLevelView = createTopLevelConfigView(source);
+    if (!topLevelView) {
+        return null;
+    }
+    const pattern = new RegExp(`\\b${key}\\s*:\\s*`, "u");
+    const match = pattern.exec(topLevelView);
+    if (!match) {
+        return null;
+    }
+    let start = match.index + match[0].length;
+    while (start < bodySource.length && /\s/u.test(bodySource[start])) {
+        start += 1;
+    }
+    return { bodySource, start };
+}
+export function hasLegacyConfigKeys(source) {
+    const topLevelView = createTopLevelConfigView(source);
+    if (!topLevelView) {
+        return false;
+    }
+    return /\bcurrentVersion\s*:/u.test(topLevelView) || /\bsupportedVersions\s*:/u.test(topLevelView);
+}
+function readQuotedString(source, startIndex) {
+    const quote = source[startIndex];
+    if (quote !== "\"" && quote !== "'") {
+        return null;
+    }
+    let value = "";
+    let index = startIndex + 1;
+    while (index < source.length) {
+        const current = source[index];
+        if (current === "\\") {
+            if (index + 1 < source.length) {
+                value += source.slice(index, index + 2);
+                index += 2;
+                continue;
+            }
+            value += current;
+            index += 1;
+            continue;
+        }
+        if (current === quote) {
+            return value;
+        }
+        value += current;
+        index += 1;
+    }
+    return null;
+}
+function readStringArrayLiteral(source, startIndex) {
+    if (source[startIndex] !== "[") {
+        return null;
+    }
+    let bracketDepth = 0;
+    let index = startIndex;
+    let quote = null;
+    while (index < source.length) {
+        const current = source[index];
+        if (quote) {
+            if (current === "\\") {
+                index += 2;
+                continue;
+            }
+            if (current === quote) {
+                quote = null;
+            }
+            index += 1;
+            continue;
+        }
+        if (current === "\"" || current === "'") {
+            quote = current;
+            index += 1;
+            continue;
+        }
+        if (current === "[") {
+            bracketDepth += 1;
+        }
+        else if (current === "]") {
+            bracketDepth -= 1;
+            if (bracketDepth === 0) {
+                const body = source.slice(startIndex + 1, index);
+                return [...body.matchAll(/["']([^"']+)["']/gu)].map((match) => match[1]);
+            }
+        }
+        index += 1;
+    }
+    return null;
+}
+function readArrayLiteralBody(source, startIndex) {
+    if (source[startIndex] !== "[") {
+        return null;
+    }
+    let bracketDepth = 0;
+    let index = startIndex;
+    let quote = null;
+    while (index < source.length) {
+        const current = source[index];
+        if (quote) {
+            if (current === "\\") {
+                index += 2;
+                continue;
+            }
+            if (current === quote) {
+                quote = null;
+            }
+            index += 1;
+            continue;
+        }
+        if (current === "\"" || current === "'") {
+            quote = current;
+            index += 1;
+            continue;
+        }
+        if (current === "[") {
+            bracketDepth += 1;
+        }
+        else if (current === "]") {
+            bracketDepth -= 1;
+            if (bracketDepth === 0) {
+                return source.slice(startIndex + 1, index);
+            }
+        }
+        index += 1;
+    }
+    return null;
+}
+function extractObjectLiteralBodies(source) {
+    const results = [];
+    let braceDepth = 0;
+    let objectStart = -1;
+    let quote = null;
+    for (let index = 0; index < source.length; index += 1) {
+        const current = source[index];
+        if (quote) {
+            if (current === "\\") {
+                index += 1;
+                continue;
+            }
+            if (current === quote) {
+                quote = null;
+            }
+            continue;
+        }
+        if (current === "\"" || current === "'") {
+            quote = current;
+            continue;
+        }
+        if (current === "{") {
+            if (braceDepth === 0) {
+                objectStart = index + 1;
+            }
+            braceDepth += 1;
+            continue;
+        }
+        if (current === "}") {
+            braceDepth -= 1;
+            if (braceDepth === 0 && objectStart >= 0) {
+                results.push(source.slice(objectStart, index));
+                objectStart = -1;
+            }
+        }
+    }
+    return results;
+}
+export function createLegacyMigrationWorkspaceResetError(reason) {
+    return new Error(`Detected a legacy semver-based migration workspace. ${formatLegacyMigrationWorkspaceResetGuidance(reason)}`);
+}
+function parseMigrationBlocks(source) {
+    const blocksArrayBody = matchRootConfigArrayBody(source, "blocks");
+    if (!blocksArrayBody) {
+        return [];
+    }
+    const blockLiterals = extractObjectLiteralBodies(blocksArrayBody);
+    return blockLiterals
+        .map((body) => {
+        const key = matchConfigValue(body, "key");
+        const blockName = matchConfigValue(body, "blockName");
+        const blockJsonFile = matchConfigValue(body, "blockJsonFile");
+        const manifestFile = matchConfigValue(body, "manifestFile");
+        const saveFile = matchConfigValue(body, "saveFile");
+        const typesFile = matchConfigValue(body, "typesFile");
+        if (!key || !blockName || !blockJsonFile || !manifestFile || !saveFile || !typesFile) {
+            return null;
+        }
+        return {
+            blockJsonFile,
+            blockName,
+            key,
+            manifestFile,
+            saveFile,
+            typesFile,
+        };
+    })
+        .filter((block) => block !== null);
+}
+function matchConfigValue(source, key) {
+    const pattern = new RegExp(`${key}:\\s*["']([^"']+)["']`, "u");
+    return source.match(pattern)?.[1] ?? null;
+}
+function matchRootConfigValue(source, key) {
+    const match = findTopLevelConfigPropertyValueStart(source, key);
+    if (!match) {
+        return null;
+    }
+    return readQuotedString(match.bodySource, match.start);
+}
+function matchRootConfigStringArrayValue(source, key) {
+    const match = findTopLevelConfigPropertyValueStart(source, key);
+    if (!match) {
+        return null;
+    }
+    return readStringArrayLiteral(match.bodySource, match.start);
+}
+function matchRootConfigArrayBody(source, key) {
+    const match = findTopLevelConfigPropertyValueStart(source, key);
+    if (!match) {
+        return null;
+    }
+    return readArrayLiteralBody(match.bodySource, match.start);
+}
+export function parseMigrationConfig(source) {
+    if (hasLegacyConfigKeys(source)) {
+        throw createLegacyMigrationWorkspaceResetError("Detected legacy config keys `currentVersion` / `supportedVersions` in `src/migrations/config.ts`.");
+    }
+    const blockName = matchRootConfigValue(source, "blockName");
+    const currentMigrationVersion = matchRootConfigValue(source, "currentMigrationVersion");
+    const snapshotDir = matchRootConfigValue(source, "snapshotDir");
+    const supportedMigrationVersions = matchRootConfigStringArrayValue(source, "supportedMigrationVersions");
+    const blocksArrayBody = matchRootConfigArrayBody(source, "blocks");
+    const blocks = blocksArrayBody === null ? [] : parseMigrationBlocks(source);
+    if (!currentMigrationVersion || !snapshotDir || !supportedMigrationVersions) {
+        throw new Error("Unable to parse migration config. Regenerate with `wp-typia migrate init --current-migration-version v1`.");
+    }
+    if (blocksArrayBody !== null && blocks.length === 0 && blocksArrayBody.trim().length > 0) {
+        throw new Error("Migration config defines `blocks`, but the array entries could not be parsed. Regenerate the config or fix the malformed block targets in `src/migrations/config.ts`.");
+    }
+    if (!blockName && blocks.length === 0 && blocksArrayBody === null) {
+        throw new Error("Migration config must define `blockName` or `blocks`.");
+    }
+    if (!isMigrationVersionLabel(currentMigrationVersion)) {
+        if (isLegacySemverMigrationVersion(currentMigrationVersion)) {
+            throw createLegacyMigrationWorkspaceResetError(`Detected legacy semver migration version label \`${currentMigrationVersion}\` in \`src/migrations/config.ts\`.`);
+        }
+        throw new Error(`Invalid current migration version: ${currentMigrationVersion}. Expected vN with N >= 1.`);
+    }
+    for (const version of supportedMigrationVersions) {
+        if (!isMigrationVersionLabel(version)) {
+            if (isLegacySemverMigrationVersion(version)) {
+                throw createLegacyMigrationWorkspaceResetError(`Detected legacy semver migration version label \`${version}\` in \`src/migrations/config.ts\`.`);
+            }
+            throw new Error(`Invalid supported migration version: ${version}. Expected vN with N >= 1.`);
+        }
+    }
+    supportedMigrationVersions.sort(compareMigrationVersionLabels);
+    return {
+        blockName: blockName ?? undefined,
+        blocks: blocksArrayBody === null ? undefined : blocks,
+        currentMigrationVersion,
+        snapshotDir,
+        supportedMigrationVersions,
+    };
+}

package/dist/runtime/migration/migration-project-layout-discovery.d.ts

@@ -0,0 +1,61 @@
+import type { MigrationBlockConfig, MigrationConfig, ResolvedMigrationBlockTarget } from "./migration-types.js";
+/**
+ * Describes the migration retrofit layout discovered in a project directory.
+ *
+ * Multi-block discovery wins when block targets are discovered under
+ * `src/blocks/<slug>/block.json`.
+ * Otherwise the runtime falls back to a supported single-block layout.
+ */
+export type DiscoveredMigrationLayout = {
+    block: MigrationBlockConfig;
+    mode: "single";
+} | {
+    blocks: MigrationBlockConfig[];
+    mode: "multi";
+};
+/**
+ * Synthesizes the implicit legacy migration block target for single-block projects.
+ *
+ * @param projectDir Project directory that may contain a legacy root migration layout.
+ * @param blockName Optional configured block name used to prefer a matching legacy root target.
+ * @returns The discovered single-block migration target keyed as `default`.
+ */
+export declare function createImplicitLegacyBlock(projectDir: string, blockName?: string): MigrationBlockConfig;
+/**
+ * Verifies that a project directory contains the files required for migration tooling.
+ *
+ * @param projectDir Project directory to validate.
+ * @param blocks Optional block targets to validate directly instead of auto-discovering them.
+ * @returns Nothing.
+ * @throws Error When any required project file is missing.
+ */
+export declare function ensureAdvancedMigrationProject(projectDir: string, blocks?: MigrationBlockConfig[]): void;
+/**
+ * Detects the supported migration retrofit layout for `migrate init`.
+ *
+ * Multi-block targets under `src/blocks/<slug>` take precedence over
+ * single-block layouts.
+ * Returns the detected layout on success and throws an actionable error when no
+ * supported first-party layout can be inferred.
+ *
+ * @param projectDir Project directory to inspect.
+ * @returns The discovered migration layout.
+ * @throws Error When no supported layout can be inferred.
+ */
+export declare function discoverMigrationInitLayout(projectDir: string): DiscoveredMigrationLayout;
+/**
+ * Resolves the configured migration block targets and their current artifacts.
+ *
+ * @param projectDir Project directory containing the migration workspace.
+ * @param config Parsed migration configuration.
+ * @returns The resolved block targets, including current block.json and manifest documents.
+ */
+export declare function resolveMigrationBlocks(projectDir: string, config: MigrationConfig): ResolvedMigrationBlockTarget[];
+/**
+ * Returns the discovered block name for a supported single-block project.
+ *
+ * Uses `discoverSingleBlockTarget(projectDir)` internally and throws when the
+ * project directory does not resolve to a supported single-block migration
+ * layout.
+ */
+export declare function readProjectBlockName(projectDir: string): string;