@wp-typia/project-tools 0.23.1 → 0.24.0

package/dist/runtime/cli-add-workspace-rest-anchors.js

@@ -1,469 +1,9 @@
-import path from "node:path";
-import { getWorkspaceBootstrapPath, patchFile, } from "./cli-add-shared.js";
-import { appendPhpSnippetBeforeClosingTag, insertPhpSnippetBeforeWorkspaceAnchors, } from "./cli-add-workspace-mutation.js";
-import { hasPhpFunctionDefinition } from "./php-utils.js";
-const REST_RESOURCE_SERVER_GLOB = "/inc/rest/*.php";
-const REST_SCHEMA_HELPER_PATH = "/inc/rest-schema.php";
 /**
- * Ensure the workspace bootstrap loads the shared REST schema helper file.
+ * Compatibility facade for REST workspace anchor patchers.
  *
- * @param workspace Resolved workspace project metadata and PHP prefix.
- * @returns A promise that resolves after the bootstrap is patched.
- * @throws When an existing loader does not reference `inc/rest-schema.php`.
+ * Keep the public runtime import path stable while bootstrap, contract sync,
+ * and REST resource sync patchers live in focused implementation modules.
  */
-export async function ensureRestSchemaHelperBootstrapAnchors(workspace) {
-    const bootstrapPath = getWorkspaceBootstrapPath(workspace);
-    await patchFile(bootstrapPath, (source) => {
-        let nextSource = source;
-        const loadFunctionName = `${workspace.workspace.phpPrefix}_load_rest_schema_helpers`;
-        const loadCall = `${loadFunctionName}();`;
-        const helperFunction = `
-
-function ${loadFunctionName}() {
-\t$helper_path = __DIR__ . '${REST_SCHEMA_HELPER_PATH}';
-\tif ( is_readable( $helper_path ) ) {
-\t\trequire_once $helper_path;
-\t}
-}
-
-${loadCall}
-`;
-        if (!hasPhpFunctionDefinition(nextSource, loadFunctionName)) {
-            nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, helperFunction);
-        }
-        else if (!nextSource.includes(REST_SCHEMA_HELPER_PATH)) {
-            throw new Error([
-                `Unable to patch ${path.basename(bootstrapPath)} in ensureRestSchemaHelperBootstrapAnchors.`,
-                `The existing ${loadFunctionName}() definition does not include ${REST_SCHEMA_HELPER_PATH}.`,
-                "Restore the generated bootstrap shape or load inc/rest-schema.php manually before retrying.",
-            ].join(" "));
-        }
-        else if (!nextSource.includes(loadCall)) {
-            nextSource = appendPhpSnippetBeforeClosingTag(nextSource, loadCall);
-        }
-        return nextSource;
-    });
-}
-export async function ensureRestResourceBootstrapAnchors(workspace) {
-    const bootstrapPath = getWorkspaceBootstrapPath(workspace);
-    await patchFile(bootstrapPath, (source) => {
-        let nextSource = source;
-        const registerFunctionName = `${workspace.workspace.phpPrefix}_register_rest_resources`;
-        const registerHook = `add_action( 'init', '${registerFunctionName}', 20 );`;
-        const registerFunction = `
-
-function ${registerFunctionName}() {
-\tforeach ( glob( __DIR__ . '${REST_RESOURCE_SERVER_GLOB}' ) ?: array() as $rest_resource_module ) {
-\t\trequire_once $rest_resource_module;
-\t}
-}
-`;
-        if (!hasPhpFunctionDefinition(nextSource, registerFunctionName)) {
-            nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, registerFunction);
-        }
-        else if (!nextSource.includes(REST_RESOURCE_SERVER_GLOB)) {
-            throw new Error([
-                `Unable to patch ${path.basename(bootstrapPath)} in ensureRestResourceBootstrapAnchors.`,
-                `The existing ${registerFunctionName}() definition does not include ${REST_RESOURCE_SERVER_GLOB}.`,
-                "Restore the generated bootstrap shape or wire the REST resource loader manually before retrying.",
-            ].join(" "));
-        }
-        if (!nextSource.includes(registerHook)) {
-            nextSource = appendPhpSnippetBeforeClosingTag(nextSource, registerHook);
-        }
-        return nextSource;
-    });
-}
-function assertSyncRestAnchor(nextSource, target, anchorDescription, hasAnchor, syncRestScriptPath) {
-    if (!nextSource.includes(target) && !hasAnchor) {
-        throw new Error([
-            `ensureRestResourceSyncScriptAnchors could not patch ${path.basename(syncRestScriptPath)}.`,
-            `Missing expected ${anchorDescription} anchor in scripts/sync-rest-contracts.ts.`,
-            "Restore the generated template or add the REST_RESOURCES wiring manually before retrying.",
-        ].join(" "));
-    }
-}
-function replaceRequiredSyncRestSource(nextSource, target, anchor, replacement, anchorDescription, syncRestScriptPath) {
-    if (nextSource.includes(target)) {
-        return nextSource;
-    }
-    const hasAnchor = typeof anchor === "string" ? nextSource.includes(anchor) : anchor.test(nextSource);
-    assertSyncRestAnchor(nextSource, target, anchorDescription, hasAnchor, syncRestScriptPath);
-    return nextSource.replace(anchor, replacement);
-}
-function getSyncRestPatchErrorMessage(functionName, syncRestScriptPath, anchorDescription, subject) {
-    return [
-        `${functionName} could not patch ${path.basename(syncRestScriptPath)}.`,
-        `Missing expected ${anchorDescription} anchor in scripts/sync-rest-contracts.ts.`,
-        `Restore the generated template or add the ${subject} wiring manually before retrying.`,
-    ].join(" ");
-}
-function replaceBlockConfigImportForContracts(nextSource, syncRestScriptPath) {
-    const importPatterns = [
-        /^import\s*\{\n(?:\t[^\n]*\n)+\} from ["']\.\/block-config["'];?$/mu,
-        /^import\s*\{[^\n]*\}\s*from\s*["']\.\/block-config["'];?$/mu,
-    ];
-    const importMatch = importPatterns.map((pattern) => pattern.exec(nextSource)).find(Boolean) ??
-        null;
-    if (!importMatch) {
-        throw new Error(getSyncRestPatchErrorMessage("ensureContractSyncScriptAnchors", syncRestScriptPath, "block-config import", "CONTRACTS"));
-    }
-    const importSource = importMatch[0];
-    if (importSource.includes("CONTRACTS") &&
-        importSource.includes("WorkspaceContractConfig")) {
-        return nextSource;
-    }
-    if (!importSource.includes("BLOCKS") ||
-        !importSource.includes("WorkspaceBlockConfig")) {
-        throw new Error(getSyncRestPatchErrorMessage("ensureContractSyncScriptAnchors", syncRestScriptPath, "BLOCKS import", "CONTRACTS"));
-    }
-    const hasAiFeatures = importSource.includes("AI_FEATURES");
-    const hasAiFeatureConfig = importSource.includes("WorkspaceAiFeatureConfig");
-    const hasRestResources = importSource.includes("REST_RESOURCES");
-    const hasRestResourceConfig = importSource.includes("WorkspaceRestResourceConfig");
-    const hasPostMeta = importSource.includes("POST_META");
-    const hasPostMetaConfig = importSource.includes("WorkspacePostMetaConfig");
-    const replacement = [
-        "import {",
-        ...(hasAiFeatures ? ["\tAI_FEATURES,"] : []),
-        "\tBLOCKS,",
-        "\tCONTRACTS,",
-        ...(hasPostMeta ? ["\tPOST_META,"] : []),
-        ...(hasRestResources ? ["\tREST_RESOURCES,"] : []),
-        ...(hasAiFeatureConfig ? ["\ttype WorkspaceAiFeatureConfig,"] : []),
-        "\ttype WorkspaceBlockConfig,",
-        "\ttype WorkspaceContractConfig,",
-        ...(hasPostMetaConfig ? ["\ttype WorkspacePostMetaConfig,"] : []),
-        ...(hasRestResourceConfig ? ["\ttype WorkspaceRestResourceConfig,"] : []),
-        "} from './block-config';",
-    ].join("\n");
-    return nextSource.replace(importSource, replacement);
-}
-function replaceBlockConfigImportForRestResources(nextSource, syncRestScriptPath) {
-    const importPatterns = [
-        /^import\s*\{\n(?:\t[^\n]*\n)+\} from ["']\.\/block-config["'];?$/mu,
-        /^import\s*\{[^\n]*\}\s*from\s*["']\.\/block-config["'];?$/mu,
-    ];
-    const importMatch = importPatterns.map((pattern) => pattern.exec(nextSource)).find(Boolean) ??
-        null;
-    if (!importMatch) {
-        throw new Error(getSyncRestPatchErrorMessage("ensureRestResourceSyncScriptAnchors", syncRestScriptPath, "block-config import", "REST_RESOURCES"));
-    }
-    const importSource = importMatch[0];
-    if (importSource.includes("REST_RESOURCES") &&
-        importSource.includes("WorkspaceRestResourceConfig")) {
-        return nextSource;
-    }
-    if (!importSource.includes("BLOCKS") ||
-        !importSource.includes("WorkspaceBlockConfig")) {
-        throw new Error(getSyncRestPatchErrorMessage("ensureRestResourceSyncScriptAnchors", syncRestScriptPath, "BLOCKS import", "REST_RESOURCES"));
-    }
-    const hasAiFeatures = importSource.includes("AI_FEATURES");
-    const hasAiFeatureConfig = importSource.includes("WorkspaceAiFeatureConfig");
-    const hasContracts = importSource.includes("CONTRACTS");
-    const hasContractConfig = importSource.includes("WorkspaceContractConfig");
-    const hasPostMeta = importSource.includes("POST_META");
-    const hasPostMetaConfig = importSource.includes("WorkspacePostMetaConfig");
-    const replacement = [
-        "import {",
-        ...(hasAiFeatures ? ["\tAI_FEATURES,"] : []),
-        "\tBLOCKS,",
-        ...(hasContracts ? ["\tCONTRACTS,"] : []),
-        ...(hasPostMeta ? ["\tPOST_META,"] : []),
-        "\tREST_RESOURCES,",
-        ...(hasAiFeatureConfig ? ["\ttype WorkspaceAiFeatureConfig,"] : []),
-        "\ttype WorkspaceBlockConfig,",
-        ...(hasContractConfig ? ["\ttype WorkspaceContractConfig,"] : []),
-        ...(hasPostMetaConfig ? ["\ttype WorkspacePostMetaConfig,"] : []),
-        "\ttype WorkspaceRestResourceConfig,",
-        "} from './block-config';",
-    ].join("\n");
-    return nextSource.replace(importSource, replacement);
-}
-function replaceRequiredContractSyncRestSource(nextSource, target, anchor, replacement, anchorDescription, syncRestScriptPath) {
-    if (nextSource.includes(target)) {
-        return nextSource;
-    }
-    const hasAnchor = typeof anchor === "string" ? nextSource.includes(anchor) : anchor.test(nextSource);
-    if (!hasAnchor) {
-        throw new Error(getSyncRestPatchErrorMessage("ensureContractSyncScriptAnchors", syncRestScriptPath, anchorDescription, "CONTRACTS"));
-    }
-    return nextSource.replace(anchor, replacement);
-}
-function formatNoResourcesSubject(subjects) {
-    if (subjects.length <= 2) {
-        return subjects.join(" or ");
-    }
-    const lastSubject = subjects[subjects.length - 1];
-    return `${subjects.slice(0, -1).join(", ")}, or ${lastSubject}`;
-}
-function buildContractNoResourcesGuard({ hasAiFeatures, hasPostMeta, hasRestResources, }) {
-    const condition = ["restBlocks.length === 0 &&", "standaloneContracts.length === 0"];
-    if (hasPostMeta) {
-        condition[condition.length - 1] = `${condition[condition.length - 1]} &&`;
-        condition.push("postMetaContracts.length === 0");
-    }
-    if (hasRestResources) {
-        condition[condition.length - 1] = `${condition[condition.length - 1]} &&`;
-        condition.push("restResources.length === 0");
-    }
-    if (hasAiFeatures) {
-        condition[condition.length - 1] = `${condition[condition.length - 1]} &&`;
-        condition.push("aiFeatures.length === 0");
-    }
-    const noResourcesSubject = formatNoResourcesSubject([
-        "REST-enabled workspace blocks",
-        "standalone contracts",
-        ...(hasPostMeta ? ["post meta contracts"] : []),
-        ...(hasRestResources ? ["plugin-level REST resources"] : []),
-        ...(hasAiFeatures ? ["AI features"] : []),
-    ]);
-    return [
-        "if (",
-        ...condition.map((line) => `\t\t${line}`),
-        "\t) {",
-        "\t\tconsole.log(",
-        "\t\t\toptions.check",
-        `\t\t\t\t? 'ℹ️ No ${noResourcesSubject} are registered yet. \`sync-rest --check\` is already clean.'`,
-        `\t\t\t\t: 'ℹ️ No ${noResourcesSubject} are registered yet.'`,
-        "\t\t);",
-        "\t\treturn;",
-        "\t}",
-    ].join("\n");
-}
-const NO_RESOURCES_GUARD_PATTERN = /if \(\s*restBlocks\.length === 0(?:\s*&&\s*standaloneContracts\.length === 0)?(?:\s*&&\s*postMetaContracts\.length === 0)?(?:\s*&&\s*restResources\.length === 0)?(?:\s*&&\s*aiFeatures\.length === 0)?\s*\) \{[\s\S]*?\n\t\treturn;\n\t\}/u;
-function replaceNoResourcesGuard(nextSource, replacement, functionName, syncRestScriptPath, subject) {
-    if (!NO_RESOURCES_GUARD_PATTERN.test(nextSource)) {
-        throw new Error(getSyncRestPatchErrorMessage(functionName, syncRestScriptPath, "no-resources guard", subject));
-    }
-    return nextSource.replace(NO_RESOURCES_GUARD_PATTERN, replacement);
-}
-function insertStandaloneContractFilter(nextSource, syncRestScriptPath) {
-    if (nextSource.includes("const standaloneContracts = CONTRACTS.filter")) {
-        return nextSource;
-    }
-    const restResourcesFilter = "const restResources = REST_RESOURCES.filter( isWorkspaceRestResource );";
-    if (nextSource.includes(restResourcesFilter)) {
-        return nextSource.replace(restResourcesFilter, [
-            "const standaloneContracts = CONTRACTS.filter( isWorkspaceStandaloneContract );",
-            restResourcesFilter,
-        ].join("\n\t"));
-    }
-    const restBlocksFilter = "const restBlocks = BLOCKS.filter( isRestEnabledBlock );";
-    return replaceRequiredContractSyncRestSource(nextSource, "const standaloneContracts = CONTRACTS.filter", restBlocksFilter, [
-        restBlocksFilter,
-        "const standaloneContracts = CONTRACTS.filter( isWorkspaceStandaloneContract );",
-    ].join("\n\t"), "restBlocks filter", syncRestScriptPath);
-}
-function insertStandaloneContractNoResourcesGuard(nextSource, syncRestScriptPath) {
-    const hasRestResources = nextSource.includes("const restResources = REST_RESOURCES.filter( isWorkspaceRestResource );");
-    const hasAiFeatures = nextSource.includes("const aiFeatures = AI_FEATURES.filter( isWorkspaceAiFeature );");
-    const hasPostMeta = nextSource.includes("const postMetaContracts = POST_META.filter( isWorkspacePostMetaContract );");
-    return replaceNoResourcesGuard(nextSource, buildContractNoResourcesGuard({
-        hasAiFeatures,
-        hasPostMeta,
-        hasRestResources,
-    }), "ensureContractSyncScriptAnchors", syncRestScriptPath, "CONTRACTS");
-}
-function buildRestResourceNoResourcesGuard({ hasAiFeatures, hasPostMeta, hasStandaloneContracts, }) {
-    const condition = ["restBlocks.length === 0"];
-    if (hasStandaloneContracts) {
-        condition[condition.length - 1] = `${condition[condition.length - 1]} &&`;
-        condition.push("standaloneContracts.length === 0");
-    }
-    if (hasPostMeta) {
-        condition[condition.length - 1] = `${condition[condition.length - 1]} &&`;
-        condition.push("postMetaContracts.length === 0");
-    }
-    condition[condition.length - 1] = `${condition[condition.length - 1]} &&`;
-    condition.push("restResources.length === 0");
-    if (hasAiFeatures) {
-        condition[condition.length - 1] = `${condition[condition.length - 1]} &&`;
-        condition.push("aiFeatures.length === 0");
-    }
-    const noResourcesSubject = formatNoResourcesSubject([
-        "REST-enabled workspace blocks",
-        ...(hasStandaloneContracts ? ["standalone contracts"] : []),
-        ...(hasPostMeta ? ["post meta contracts"] : []),
-        "plugin-level REST resources",
-        ...(hasAiFeatures ? ["AI features"] : []),
-    ]);
-    return [
-        "if (",
-        ...condition.map((line) => `\t\t${line}`),
-        "\t) {",
-        "\t\tconsole.log(",
-        "\t\t\toptions.check",
-        `\t\t\t\t? 'ℹ️ No ${noResourcesSubject} are registered yet. \`sync-rest --check\` is already clean.'`,
-        `\t\t\t\t: 'ℹ️ No ${noResourcesSubject} are registered yet.'`,
-        "\t\t);",
-        "\t\treturn;",
-        "\t}",
-    ].join("\n");
-}
-function insertRestResourceNoResourcesGuard(nextSource, syncRestScriptPath) {
-    const hasStandaloneContracts = nextSource.includes("const standaloneContracts = CONTRACTS.filter( isWorkspaceStandaloneContract );");
-    const hasAiFeatures = nextSource.includes("const aiFeatures = AI_FEATURES.filter( isWorkspaceAiFeature );");
-    const hasPostMeta = nextSource.includes("const postMetaContracts = POST_META.filter( isWorkspacePostMetaContract );");
-    return replaceNoResourcesGuard(nextSource, buildRestResourceNoResourcesGuard({
-        hasAiFeatures,
-        hasPostMeta,
-        hasStandaloneContracts,
-    }), "ensureRestResourceSyncScriptAnchors", syncRestScriptPath, "REST_RESOURCES");
-}
-function insertStandaloneContractSyncLoop(nextSource, syncRestScriptPath) {
-    if (nextSource.includes("for ( const contract of standaloneContracts )")) {
-        return nextSource;
-    }
-    const loopSource = [
-        "\tfor ( const contract of standaloneContracts ) {",
-        "\t\tawait syncTypeSchemas(",
-        "\t\t\t{",
-        "\t\t\t\tjsonSchemaFile: contract.schemaFile,",
-        "\t\t\t\tsourceTypeName: contract.sourceTypeName,",
-        "\t\t\t\ttypesFile: contract.typesFile,",
-        "\t\t\t},",
-        "\t\t\t{",
-        "\t\t\t\tcheck: options.check,",
-        "\t\t\t}",
-        "\t\t);",
-        "\t}",
-    ].join("\n");
-    const resourceLoopAnchor = "\n\tfor ( const resource of restResources ) {";
-    if (nextSource.includes(resourceLoopAnchor)) {
-        return nextSource.replace(resourceLoopAnchor, `\n${loopSource}\n${resourceLoopAnchor}`);
-    }
-    const consoleLogPattern = /\n\tconsole\.log\(\n\t\toptions\.check/u;
-    return replaceRequiredContractSyncRestSource(nextSource, "for ( const contract of standaloneContracts )", consoleLogPattern, [
-        "",
-        loopSource,
-        "",
-        "\tconsole.log(",
-        "\t\toptions.check",
-    ].join("\n"), "success log insertion point", syncRestScriptPath);
-}
-export async function ensureContractSyncScriptAnchors(workspace) {
-    const syncRestScriptPath = path.join(workspace.projectDir, "scripts", "sync-rest-contracts.ts");
-    await patchFile(syncRestScriptPath, (source) => {
-        let nextSource = replaceBlockConfigImportForContracts(source, syncRestScriptPath);
-        const helperInsertionAnchor = "async function assertTypeArtifactsCurrent";
-        nextSource = replaceRequiredContractSyncRestSource(nextSource, "function isWorkspaceStandaloneContract(", helperInsertionAnchor, [
-            "function isWorkspaceStandaloneContract(",
-            "\tcontract: WorkspaceContractConfig",
-            "): contract is WorkspaceContractConfig & {",
-            "\tschemaFile: string;",
-            "\tsourceTypeName: string;",
-            "\ttypesFile: string;",
-            "} {",
-            "\treturn (",
-            "\t\ttypeof contract.schemaFile === 'string' &&",
-            "\t\ttypeof contract.sourceTypeName === 'string' &&",
-            "\t\ttypeof contract.typesFile === 'string'",
-            "\t);",
-            "}",
-            "",
-            "async function assertTypeArtifactsCurrent",
-        ].join("\n"), "type artifact assertion helper", syncRestScriptPath);
-        nextSource = insertStandaloneContractFilter(nextSource, syncRestScriptPath);
-        nextSource = insertStandaloneContractNoResourcesGuard(nextSource, syncRestScriptPath);
-        nextSource = insertStandaloneContractSyncLoop(nextSource, syncRestScriptPath);
-        nextSource = nextSource.replace("✅ REST contract schemas, portable API clients, and endpoint-aware OpenAPI documents are already up to date for workspace blocks and plugin-level resources!", "✅ REST contract schemas, standalone schemas, portable API clients, and endpoint-aware OpenAPI documents are already up to date for workspace blocks, standalone contracts, and plugin-level resources!");
-        nextSource = nextSource.replace("✅ REST contract schemas, portable API clients, and endpoint-aware OpenAPI documents generated for workspace blocks and plugin-level resources!", "✅ REST contract schemas, standalone schemas, portable API clients, and endpoint-aware OpenAPI documents generated for workspace blocks, standalone contracts, and plugin-level resources!");
-        nextSource = nextSource.replace("✅ REST contract schemas, portable API clients, and endpoint-aware OpenAPI documents are already up to date with the TypeScript types!", "✅ REST contract schemas, standalone schemas, portable API clients, and endpoint-aware OpenAPI documents are already up to date with the TypeScript types!");
-        nextSource = nextSource.replace("✅ REST contract schemas, portable API clients, and endpoint-aware OpenAPI documents generated from TypeScript types!", "✅ REST contract schemas, standalone schemas, portable API clients, and endpoint-aware OpenAPI documents generated from TypeScript types!");
-        return nextSource;
-    });
-}
-export async function ensureRestResourceSyncScriptAnchors(workspace) {
-    const syncRestScriptPath = path.join(workspace.projectDir, "scripts", "sync-rest-contracts.ts");
-    await patchFile(syncRestScriptPath, (source) => {
-        let nextSource = replaceBlockConfigImportForRestResources(source, syncRestScriptPath);
-        const helperInsertionAnchor = "async function assertTypeArtifactsCurrent";
-        const restBlocksAnchor = "const restBlocks = BLOCKS.filter( isRestEnabledBlock );";
-        const consoleLogPattern = /\n\tconsole\.log\(\n\t\toptions\.check/u;
-        nextSource = replaceRequiredSyncRestSource(nextSource, "function isWorkspaceRestResource(", helperInsertionAnchor, [
-            "function isWorkspaceRestResource(",
-            "\tresource: WorkspaceRestResourceConfig",
-            "): resource is WorkspaceRestResourceConfig & {",
-            "\tclientFile: string;",
-            "\topenApiFile: string;",
-            "\trestManifest: NonNullable< WorkspaceRestResourceConfig[ 'restManifest' ] >;",
-            "\ttypesFile: string;",
-            "\tvalidatorsFile: string;",
-            "} {",
-            "\treturn (",
-            "\t\ttypeof resource.clientFile === 'string' &&",
-            "\t\ttypeof resource.openApiFile === 'string' &&",
-            "\t\ttypeof resource.typesFile === 'string' &&",
-            "\t\ttypeof resource.validatorsFile === 'string' &&",
-            "\t\ttypeof resource.restManifest === 'object' &&",
-            "\t\tresource.restManifest !== null",
-            "\t);",
-            "}",
-            "",
-            "async function assertTypeArtifactsCurrent",
-        ].join("\n"), "type artifact assertion helper", syncRestScriptPath);
-        nextSource = replaceRequiredSyncRestSource(nextSource, "const restResources = REST_RESOURCES.filter( isWorkspaceRestResource );", restBlocksAnchor, [
-            "const restBlocks = BLOCKS.filter( isRestEnabledBlock );",
-            "const restResources = REST_RESOURCES.filter( isWorkspaceRestResource );",
-        ].join("\n"), "restBlocks filter", syncRestScriptPath);
-        nextSource = insertRestResourceNoResourcesGuard(nextSource, syncRestScriptPath);
-        nextSource = replaceRequiredSyncRestSource(nextSource, "for ( const resource of restResources ) {", consoleLogPattern, [
-            "",
-            "\tfor ( const resource of restResources ) {",
-            "\t\tconst contracts = resource.restManifest.contracts;",
-            "",
-            "\t\tfor ( const [ baseName, contract ] of Object.entries( contracts ) ) {",
-            "\t\t\tawait syncTypeSchemas(",
-            "\t\t\t\t{",
-            "\t\t\t\t\tjsonSchemaFile: path.join(",
-            "\t\t\t\t\t\tpath.dirname( resource.typesFile ),",
-            "\t\t\t\t\t\t'api-schemas',",
-            "\t\t\t\t\t\t`${ baseName }.schema.json`",
-            "\t\t\t\t\t),",
-            "\t\t\t\t\topenApiFile: path.join(",
-            "\t\t\t\t\t\tpath.dirname( resource.typesFile ),",
-            "\t\t\t\t\t\t'api-schemas',",
-            "\t\t\t\t\t\t`${ baseName }.openapi.json`",
-            "\t\t\t\t\t),",
-            "\t\t\t\t\tsourceTypeName: contract.sourceTypeName,",
-            "\t\t\t\t\ttypesFile: resource.typesFile,",
-            "\t\t\t\t},",
-            "\t\t\t\t{",
-            "\t\t\t\t\tcheck: options.check,",
-            "\t\t\t\t}",
-            "\t\t\t);",
-            "\t\t}",
-            "",
-            "\t\tawait syncRestOpenApi(",
-            "\t\t\t{",
-            "\t\t\t\tmanifest: resource.restManifest,",
-            "\t\t\t\topenApiFile: resource.openApiFile,",
-            "\t\t\t\ttypesFile: resource.typesFile,",
-            "\t\t\t},",
-            "\t\t\t{",
-            "\t\t\t\tcheck: options.check,",
-            "\t\t\t}",
-            "\t\t);",
-            "",
-            "\t\tawait syncEndpointClient(",
-            "\t\t\t{",
-            "\t\t\t\tclientFile: resource.clientFile,",
-            "\t\t\t\tmanifest: resource.restManifest,",
-            "\t\t\t\ttypesFile: resource.typesFile,",
-            "\t\t\t\tvalidatorsFile: resource.validatorsFile,",
-            "\t\t\t},",
-            "\t\t\t{",
-            "\t\t\t\tcheck: options.check,",
-            "\t\t\t}",
-            "\t\t);",
-            "\t}",
-            "",
-            "\tconsole.log(",
-            "\t\toptions.check",
-        ].join("\n"), "success log insertion point", syncRestScriptPath);
-        nextSource = nextSource.replace("✅ REST contract schemas, portable API clients, and endpoint-aware OpenAPI documents are already up to date with the TypeScript types!", "✅ REST contract schemas, portable API clients, and endpoint-aware OpenAPI documents are already up to date for workspace blocks and plugin-level resources!");
-        nextSource = nextSource.replace("✅ REST contract schemas, portable API clients, and endpoint-aware OpenAPI documents generated from TypeScript types!", "✅ REST contract schemas, portable API clients, and endpoint-aware OpenAPI documents generated for workspace blocks and plugin-level resources!");
-        return nextSource;
-    });
-}
+export { ensureRestResourceBootstrapAnchors, ensureRestSchemaHelperBootstrapAnchors, } from "./cli-add-workspace-rest-bootstrap-anchors.js";
+export { ensureContractSyncScriptAnchors, } from "./cli-add-workspace-rest-contract-sync-anchors.js";
+export { ensureRestResourceSyncScriptAnchors, } from "./cli-add-workspace-rest-resource-sync-anchors.js";

package/dist/runtime/cli-add-workspace-rest-bootstrap-anchors.d.ts

@@ -0,0 +1,17 @@
+import type { WorkspaceProject } from "./workspace-project.js";
+/**
+ * Ensure the workspace bootstrap loads the shared REST schema helper file.
+ *
+ * @param workspace Resolved workspace project metadata and PHP prefix.
+ * @returns A promise that resolves after the bootstrap is patched.
+ * @throws When an existing loader does not reference `inc/rest-schema.php`.
+ */
+export declare function ensureRestSchemaHelperBootstrapAnchors(workspace: WorkspaceProject): Promise<void>;
+/**
+ * Ensure the workspace bootstrap loads generated REST resource PHP modules.
+ *
+ * @param workspace Resolved workspace project metadata and PHP prefix.
+ * @returns A promise that resolves after the bootstrap is patched.
+ * @throws When an existing loader does not reference generated REST modules.
+ */
+export declare function ensureRestResourceBootstrapAnchors(workspace: WorkspaceProject): Promise<void>;

package/dist/runtime/cli-add-workspace-rest-bootstrap-anchors.js

@@ -0,0 +1,108 @@
+import path from "node:path";
+import { getWorkspaceBootstrapPath, patchFile, } from "./cli-add-shared.js";
+import { appendPhpSnippetBeforeClosingTag, insertPhpSnippetBeforeWorkspaceAnchors, } from "./cli-add-workspace-mutation.js";
+import { hasPhpFunctionDefinition } from "./php-utils.js";
+const REST_RESOURCE_SERVER_GLOB = "/inc/rest/*.php";
+const REST_SCHEMA_HELPER_PATH = "/inc/rest-schema.php";
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+}
+/**
+ * Check that an expected generated path appears inside the named PHP function.
+ *
+ * @param source Complete PHP bootstrap source.
+ * @param functionName PHP function name to inspect.
+ * @param needle Source fragment that must be present inside the function block.
+ * @returns True when the named function block contains the expected fragment.
+ */
+function phpFunctionBlockIncludes(source, functionName, needle) {
+    const functionMatch = new RegExp(`function\\s+${escapeRegex(functionName)}\\s*\\(`, "u").exec(source);
+    if (functionMatch === null) {
+        return false;
+    }
+    const start = functionMatch.index;
+    const remainder = source.slice(start + 1);
+    const nextFunctionMatch = /\nfunction\s+/u.exec(remainder);
+    const nextFunction = nextFunctionMatch === null ? -1 : start + 1 + nextFunctionMatch.index;
+    const closingTag = source.indexOf("\n?>", start + 1);
+    const endCandidates = [nextFunction, closingTag].filter((index) => index !== -1);
+    const end = endCandidates.length > 0 ? Math.min(...endCandidates) : source.length;
+    return source.slice(start, end).includes(needle);
+}
+/**
+ * Ensure the workspace bootstrap loads the shared REST schema helper file.
+ *
+ * @param workspace Resolved workspace project metadata and PHP prefix.
+ * @returns A promise that resolves after the bootstrap is patched.
+ * @throws When an existing loader does not reference `inc/rest-schema.php`.
+ */
+export async function ensureRestSchemaHelperBootstrapAnchors(workspace) {
+    const bootstrapPath = getWorkspaceBootstrapPath(workspace);
+    await patchFile(bootstrapPath, (source) => {
+        let nextSource = source;
+        const loadFunctionName = `${workspace.workspace.phpPrefix}_load_rest_schema_helpers`;
+        const loadCall = `${loadFunctionName}();`;
+        const helperFunction = `
+
+function ${loadFunctionName}() {
+\t$helper_path = __DIR__ . '${REST_SCHEMA_HELPER_PATH}';
+\tif ( is_readable( $helper_path ) ) {
+\t\trequire_once $helper_path;
+\t}
+}
+
+${loadCall}
+`;
+        if (!hasPhpFunctionDefinition(nextSource, loadFunctionName)) {
+            nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, helperFunction);
+        }
+        else if (!phpFunctionBlockIncludes(nextSource, loadFunctionName, REST_SCHEMA_HELPER_PATH)) {
+            throw new Error([
+                `Unable to patch ${path.basename(bootstrapPath)} in ensureRestSchemaHelperBootstrapAnchors.`,
+                `The existing ${loadFunctionName}() definition does not include ${REST_SCHEMA_HELPER_PATH}.`,
+                "Restore the generated bootstrap shape or load inc/rest-schema.php manually before retrying.",
+            ].join(" "));
+        }
+        else if (!nextSource.includes(loadCall)) {
+            nextSource = appendPhpSnippetBeforeClosingTag(nextSource, loadCall);
+        }
+        return nextSource;
+    });
+}
+/**
+ * Ensure the workspace bootstrap loads generated REST resource PHP modules.
+ *
+ * @param workspace Resolved workspace project metadata and PHP prefix.
+ * @returns A promise that resolves after the bootstrap is patched.
+ * @throws When an existing loader does not reference generated REST modules.
+ */
+export async function ensureRestResourceBootstrapAnchors(workspace) {
+    const bootstrapPath = getWorkspaceBootstrapPath(workspace);
+    await patchFile(bootstrapPath, (source) => {
+        let nextSource = source;
+        const registerFunctionName = `${workspace.workspace.phpPrefix}_register_rest_resources`;
+        const registerHook = `add_action( 'init', '${registerFunctionName}', 20 );`;
+        const registerFunction = `
+
+function ${registerFunctionName}() {
+\tforeach ( glob( __DIR__ . '${REST_RESOURCE_SERVER_GLOB}' ) ?: array() as $rest_resource_module ) {
+\t\trequire_once $rest_resource_module;
+\t}
+}
+`;
+        if (!hasPhpFunctionDefinition(nextSource, registerFunctionName)) {
+            nextSource = insertPhpSnippetBeforeWorkspaceAnchors(nextSource, registerFunction);
+        }
+        else if (!phpFunctionBlockIncludes(nextSource, registerFunctionName, REST_RESOURCE_SERVER_GLOB)) {
+            throw new Error([
+                `Unable to patch ${path.basename(bootstrapPath)} in ensureRestResourceBootstrapAnchors.`,
+                `The existing ${registerFunctionName}() definition does not include ${REST_RESOURCE_SERVER_GLOB}.`,
+                "Restore the generated bootstrap shape or wire the REST resource loader manually before retrying.",
+            ].join(" "));
+        }
+        if (!nextSource.includes(registerHook)) {
+            nextSource = appendPhpSnippetBeforeClosingTag(nextSource, registerHook);
+        }
+        return nextSource;
+    });
+}

package/dist/runtime/cli-add-workspace-rest-contract-sync-anchors.d.ts

@@ -0,0 +1,9 @@
+import type { WorkspaceProject } from "./workspace-project.js";
+/**
+ * Ensure sync-rest can repair and validate standalone workspace contracts.
+ *
+ * @param workspace Workspace project whose sync-rest script should be patched.
+ * @returns A promise that resolves after the sync-rest script is updated.
+ * @throws When the generated sync-rest anchors cannot be found.
+ */
+export declare function ensureContractSyncScriptAnchors(workspace: WorkspaceProject): Promise<void>;