@microsoft/teamsfx-core 3.0.15 → 3.0.16-beta.2026073102.0

package/build/v4/validation/templateArchiveValidation.js

@@ -0,0 +1,297 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateDeclarativePackageArchive = validateDeclarativePackageArchive;
+exports.validateDeclarativeTemplateArchive = validateDeclarativeTemplateArchive;
+const tslib_1 = require("tslib");
+const adm_zip_1 = tslib_1.__importDefault(require("adm-zip"));
+const ajv_1 = tslib_1.__importDefault(require("ajv"));
+const neverthrow_1 = require("neverthrow");
+const validateTemplatePackage_1 = require("./validateTemplatePackage");
+const capabilityCatalog_1 = require("./capabilityCatalog");
+const CALLER_FLOOR = ["appName", "language"];
+const VALUE_TOKEN = /\{\{\s*[#^\/]?\s*([A-Za-z_][A-Za-z0-9_.]*)\s*\}\}/g;
+function archiveError(errors, name, message) {
+    return errors.system(name, message);
+}
+function packageError(errors, name, message) {
+    return errors.user(name, message);
+}
+function packageIdFromEntry(kind, name) {
+    const prefix = `v4/${kind}/`;
+    if (!name.startsWith(prefix)) {
+        return undefined;
+    }
+    const relative = name.slice(prefix.length);
+    for (const suffix of ["/descriptor.json", "/questions.json", "/pipeline.json"]) {
+        if (relative.endsWith(suffix)) {
+            const id = relative.slice(0, -suffix.length);
+            return id.length > 0 ? id : undefined;
+        }
+    }
+    const contentIndex = relative.indexOf("/content/");
+    return contentIndex > 0 ? relative.slice(0, contentIndex) : undefined;
+}
+function openArchive(bytes, errors) {
+    let zip;
+    try {
+        zip = new adm_zip_1.default(bytes);
+    }
+    catch {
+        return (0, neverthrow_1.err)(archiveError(errors, "TemplatePackageCorrupt", "The template package is not a valid archive."));
+    }
+    const entries = new Map();
+    const packageIds = {
+        create: new Set(),
+        modify: new Set(),
+    };
+    const presentIds = { create: [], modify: [] };
+    try {
+        for (const entry of zip.getEntries()) {
+            if (entry.isDirectory) {
+                continue;
+            }
+            const name = entry.entryName.replace(/\\/g, "/");
+            entries.set(name, entry.getData());
+            for (const kind of ["create", "modify"]) {
+                const id = packageIdFromEntry(kind, name);
+                if (id !== undefined) {
+                    packageIds[kind].add(id);
+                    if (name === `v4/${kind}/${id}/descriptor.json`) {
+                        presentIds[kind].push(id);
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        return (0, neverthrow_1.err)(archiveError(errors, "TemplatePackageCorrupt", "The template package could not be read."));
+    }
+    presentIds.create.sort();
+    presentIds.modify.sort();
+    return (0, neverthrow_1.ok)({
+        zip,
+        entries,
+        packageIds: {
+            create: [...packageIds.create].sort(),
+            modify: [...packageIds.modify].sort(),
+        },
+        presentIds,
+    });
+}
+function parseJson(data, file, errors) {
+    try {
+        const parsed = JSON.parse(data.toString("utf8"));
+        return (0, neverthrow_1.ok)(parsed);
+    }
+    catch {
+        return (0, neverthrow_1.err)(archiveError(errors, "PackageFileInvalid", `The template package file "${file}" is not valid JSON.`));
+    }
+}
+function parseOptionalJson(archive, file, errors) {
+    const data = archive.entries.get(file);
+    return data === undefined ? (0, neverthrow_1.ok)(undefined) : parseJson(data, file, errors);
+}
+function isAnySchema(value) {
+    return (typeof value === "boolean" ||
+        (typeof value === "object" && value !== null && !Array.isArray(value)));
+}
+function schemaValidator(ajv, validate) {
+    return (data) => validate(data) ? undefined : ajv.errorsText(validate.errors, { separator: "; " });
+}
+function compileSchemas(archive, errors) {
+    const schemaFiles = [
+        ["descriptor", "v4/schema/descriptor.schema.json"],
+        ["question", "v4/schema/questions.schema.json"],
+        ["pipeline", "v4/schema/pipeline.schema.json"],
+        ["selector", "v4/schema/selector.schema.json"],
+    ];
+    const schemas = {};
+    for (const [name, file] of schemaFiles) {
+        const data = archive.entries.get(file);
+        if (data === undefined) {
+            return (0, neverthrow_1.err)(archiveError(errors, "PackageFileMissing", `The template package is missing "${file}".`));
+        }
+        const parsed = parseJson(data, file, errors);
+        if (parsed.isErr()) {
+            return (0, neverthrow_1.err)(parsed.error);
+        }
+        if (!isAnySchema(parsed.value)) {
+            return (0, neverthrow_1.err)(archiveError(errors, "TemplateSchemaInvalid", `The template schema "${file}" is invalid.`));
+        }
+        schemas[name] = parsed.value;
+    }
+    const descriptor = schemas.descriptor;
+    const question = schemas.question;
+    const pipeline = schemas.pipeline;
+    const selector = schemas.selector;
+    if (descriptor === undefined ||
+        question === undefined ||
+        pipeline === undefined ||
+        selector === undefined) {
+        return (0, neverthrow_1.err)(archiveError(errors, "TemplateSchemaInvalid", "The template package schema set is incomplete."));
+    }
+    try {
+        const ajv = new ajv_1.default({ allErrors: true, strict: false });
+        ajv.addSchema(question);
+        return (0, neverthrow_1.ok)({
+            descriptor: schemaValidator(ajv, ajv.compile(descriptor)),
+            question: schemaValidator(ajv, ajv.getSchema("https://aka.ms/m365atk/v4/questions.schema.json") ?? ajv.compile(question)),
+            pipeline: schemaValidator(ajv, ajv.compile(pipeline)),
+            selector: schemaValidator(ajv, ajv.compile(selector)),
+        });
+    }
+    catch {
+        return (0, neverthrow_1.err)(archiveError(errors, "TemplateSchemaInvalid", "The template package schemas could not be compiled."));
+    }
+}
+function isSafeRelativePath(relativePath) {
+    if (relativePath.startsWith("/") ||
+        relativePath.startsWith("\\") ||
+        /^[A-Za-z]:/.test(relativePath)) {
+        return false;
+    }
+    return relativePath
+        .replace(/\\/g, "/")
+        .split("/")
+        .every((segment) => segment.length > 0 && segment !== "." && segment !== "..");
+}
+function validateSelectors(archive, schemas, errors) {
+    for (const kind of ["create", "modify"]) {
+        const file = `v4/${kind}/selector.json`;
+        const selector = parseOptionalJson(archive, file, errors);
+        if (selector.isErr()) {
+            return (0, neverthrow_1.err)(selector.error);
+        }
+        const schemaError = schemas.selector(selector.value);
+        if (schemaError !== undefined) {
+            return (0, neverthrow_1.err)(packageError(errors, validateTemplatePackage_1.VALIDATE_SCHEMA, `${file}: selector.json failed schema validation: ${schemaError}`));
+        }
+    }
+    return (0, neverthrow_1.ok)(undefined);
+}
+function extractPlaceholders(value, output) {
+    for (const match of value.matchAll(VALUE_TOKEN)) {
+        if (match.index !== undefined && match.index > 0 && value[match.index - 1] === "$") {
+            continue;
+        }
+        output.add(match[1]);
+    }
+}
+function loadContent(archive, locator, errors) {
+    const prefix = `v4/${locator.kind}/${locator.templateId}/content/`;
+    const raw = [];
+    const validation = [];
+    for (const [name, data] of archive.entries) {
+        if (!name.startsWith(prefix)) {
+            continue;
+        }
+        const relativePath = name.slice(prefix.length);
+        if (!isSafeRelativePath(relativePath)) {
+            return (0, neverthrow_1.err)(archiveError(errors, "TemplatePackageUnsafePath", `The resolved template package contains an unsafe entry path: "${name}".`));
+        }
+        const placeholders = new Set();
+        if (relativePath.endsWith(".tpl")) {
+            extractPlaceholders(relativePath, placeholders);
+            extractPlaceholders(data.toString("utf8"), placeholders);
+        }
+        raw.push({ path: relativePath, data });
+        validation.push({ path: relativePath, placeholders: [...placeholders].sort() });
+    }
+    raw.sort((left, right) => left.path.localeCompare(right.path));
+    validation.sort((left, right) => left.path.localeCompare(right.path));
+    return (0, neverthrow_1.ok)({ raw, validation: validation.length === 0 ? undefined : validation });
+}
+function validateOpenedPackage(archive, schemas, locator, mode, engineVersion, errors) {
+    const root = `v4/${locator.kind}/${locator.templateId}/`;
+    const descriptor = parseOptionalJson(archive, `${root}descriptor.json`, errors);
+    if (descriptor.isErr()) {
+        return (0, neverthrow_1.err)(descriptor.error);
+    }
+    const questions = parseOptionalJson(archive, `${root}questions.json`, errors);
+    if (questions.isErr()) {
+        return (0, neverthrow_1.err)(questions.error);
+    }
+    const pipeline = parseOptionalJson(archive, `${root}pipeline.json`, errors);
+    if (pipeline.isErr()) {
+        return (0, neverthrow_1.err)(pipeline.error);
+    }
+    const createSelector = parseOptionalJson(archive, "v4/create/selector.json", errors);
+    if (createSelector.isErr()) {
+        return (0, neverthrow_1.err)(createSelector.error);
+    }
+    const modifySelector = parseOptionalJson(archive, "v4/modify/selector.json", errors);
+    if (modifySelector.isErr()) {
+        return (0, neverthrow_1.err)(modifySelector.error);
+    }
+    const content = loadContent(archive, locator, errors);
+    if (content.isErr()) {
+        return (0, neverthrow_1.err)(content.error);
+    }
+    const validation = (0, validateTemplatePackage_1.validateTemplatePackage)(locator.kind, locator.templateId, mode, {
+        userError: (name, message) => errors.user(name, message),
+        descriptor: () => descriptor.value,
+        questions: () => questions.value,
+        pipeline: () => pipeline.value,
+        content: () => content.value.validation,
+        selector: (kind) => (kind === "create" ? createSelector.value : modifySelector.value),
+        schemas,
+        capabilityFloor: capabilityCatalog_1.templateCapabilityFloor,
+        capabilityOutputs: capabilityCatalog_1.templateCapabilityOutputs,
+        engineVersion: () => engineVersion,
+        callerFloor: () => CALLER_FLOOR,
+        presentTemplateIds: (kind) => archive.presentIds[kind],
+    });
+    if (validation.isErr()) {
+        return (0, neverthrow_1.err)(validation.error);
+    }
+    return (0, neverthrow_1.ok)({
+        descriptor: validation.value.descriptor,
+        pipeline: pipeline.value,
+        content: content.value.raw,
+    });
+}
+/** Validate and open one declarative package from final channel archive bytes. */
+function validateDeclarativePackageArchive(bytes, locator, mode, engineVersion, errors) {
+    const archive = openArchive(bytes, errors);
+    if (archive.isErr()) {
+        return (0, neverthrow_1.err)(archive.error);
+    }
+    const schemas = compileSchemas(archive.value, errors);
+    if (schemas.isErr()) {
+        return (0, neverthrow_1.err)(schemas.error);
+    }
+    const selectors = validateSelectors(archive.value, schemas.value, errors);
+    if (selectors.isErr()) {
+        return (0, neverthrow_1.err)(selectors.error);
+    }
+    return validateOpenedPackage(archive.value, schemas.value, locator, mode, engineVersion, errors);
+}
+/** Validate every authored create/modify package in final channel archive bytes. */
+function validateDeclarativeTemplateArchive(bytes, mode, engineVersion, errors) {
+    const archive = openArchive(bytes, errors);
+    if (archive.isErr()) {
+        return (0, neverthrow_1.err)(archive.error);
+    }
+    const schemas = compileSchemas(archive.value, errors);
+    if (schemas.isErr()) {
+        return (0, neverthrow_1.err)(schemas.error);
+    }
+    const selectors = validateSelectors(archive.value, schemas.value, errors);
+    if (selectors.isErr()) {
+        return (0, neverthrow_1.err)(selectors.error);
+    }
+    const validated = [];
+    for (const kind of ["create", "modify"]) {
+        for (const templateId of archive.value.packageIds[kind]) {
+            const result = validateOpenedPackage(archive.value, schemas.value, { kind, templateId }, mode, engineVersion, errors);
+            if (result.isErr()) {
+                return (0, neverthrow_1.err)(result.error);
+            }
+            validated.push(`${kind}/${templateId}`);
+        }
+    }
+    return (0, neverthrow_1.ok)(validated);
+}
+//# sourceMappingURL=templateArchiveValidation.js.map

package/build/v4/validation/templateArchiveValidation.js.map

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

package/build/v4/validation/validateTemplatePackage.d.ts

@@ -1,5 +1,7 @@
-import { FxError } from "@microsoft/teamsfx-api";
-import { Result } from "neverthrow";
+import type { FxError } from "@microsoft/teamsfx-api";
+import type { Result } from "neverthrow";
+/** Create one caller-owned, author-fixable validation failure. */
+export type TemplatePackageErrorFactory = (name: string, message: string) => FxError;
 /** Package namespace. */
 export type PackageKind = "create" | "modify";
 /** Validation mode; only `load` compares this engine against `minEngineVersion`. */
@@ -11,8 +13,12 @@ export interface ContentFile {
 }
 /** JSON-schema validator face; `undefined` means valid. */
 export type SchemaValidator = (data: unknown) => string | undefined;
+/** Template-visible extension-point categories with source-owned introduction versions. */
+export type CapabilityKind = "step" | "provider" | "validator";
 /** Narrow validation port; schema, package, and engine-context data stay injected. */
 export interface TemplatePackagePort {
+    /** Adapt an author-fixable diagnosis to the caller's concrete error type. */
+    userError: TemplatePackageErrorFactory;
     /** The package's parsed `descriptor.json`, or `undefined` when absent. */
     descriptor(): unknown | undefined;
     /** The package's parsed `questions.json`, or `undefined` when absent. */
@@ -27,8 +33,13 @@ export interface TemplatePackagePort {
     schemas: {
         descriptor: SchemaValidator;
         question: SchemaValidator;
+        pipeline: SchemaValidator;
         selector: SchemaValidator;
     };
+    /** The engine introduction version for a named capability; `undefined` means unknown. */
+    capabilityFloor(kind: CapabilityKind, id: string): string | undefined;
+    /** Output names a capability may add to the render context. */
+    capabilityOutputs(kind: CapabilityKind, id: string): string[];
     /** The consuming engine's SemVer (the `load`-mode reverse gate). */
     engineVersion(): string;
     /** The closed caller-injected identifier names (`appName`, the `language` axis, …). */
@@ -59,6 +70,14 @@ export declare const VALIDATE_KIND_OVERLAP = "TemplatePackageKindOverlap";
 export declare const VALIDATE_MIN_ENGINE_MISSING = "TemplatePackageMinEngineVersionMissing";
 /** `UserError` name: `engineVersion < minEngineVersion` — the engine is too old. */
 export declare const VALIDATE_ENGINE_TOO_OLD = "TemplatePackageEngineTooOld";
+/** `UserError` name: a package or consuming engine version is not valid SemVer. */
+export declare const VALIDATE_ENGINE_VERSION_INVALID = "TemplatePackageEngineVersionInvalid";
+/** `UserError` name: package data references a capability absent from the engine catalogue. */
+export declare const VALIDATE_UNKNOWN_CAPABILITY = "TemplatePackageUnknownCapability";
+/** `UserError` name: `minEngineVersion` predates a referenced capability. */
+export declare const VALIDATE_CAPABILITY_FLOOR = "TemplatePackageCapabilityFloor";
+/** Apply the package's reverse engine-version gate before any content is rendered. */
+export declare function validateMinEngineVersion(kind: PackageKind, id: string, descriptor: unknown, engineVersion: string, userError: TemplatePackageErrorFactory): Result<string, FxError>;
 /** Validate one `<kind>/<id>` package before any content is rendered. */
 export declare function validateTemplatePackage(kind: PackageKind, id: string, mode: ValidateMode, port: TemplatePackagePort): Result<ValidatedPackage, FxError>;
 //# sourceMappingURL=validateTemplatePackage.d.ts.map

package/build/v4/validation/validateTemplatePackage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validateTemplatePackage.d.ts","sourceRoot":"","sources":["../../../src/v4/validation/validateTemplatePackage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAa,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAW,MAAM,YAAY,CAAC;AAM7C,yBAAyB;AACzB,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9C,oFAAoF;AACpF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5C,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;AAEpE,sFAAsF;AACtF,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,UAAU,IAAI,OAAO,GAAG,SAAS,CAAC;IAClC,yEAAyE;IACzE,SAAS,IAAI,OAAO,GAAG,SAAS,CAAC;IACjC,wEAAwE;IACxE,QAAQ,IAAI,OAAO,GAAG,SAAS,CAAC;IAChC,4FAA4F;IAC5F,OAAO,IAAI,WAAW,EAAE,GAAG,SAAS,CAAC;IACrC,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;IACrC,+DAA+D;IAC/D,OAAO,EAAE;QAAE,UAAU,EAAE,eAAe,CAAC;QAAC,QAAQ,EAAE,eAAe,CAAC;QAAC,QAAQ,EAAE,eAAe,CAAA;KAAE,CAAC;IAC/F,oEAAoE;IACpE,aAAa,IAAI,MAAM,CAAC;IACxB,uFAAuF;IACvF,WAAW,IAAI,MAAM,EAAE,CAAC;IACxB,sFAAsF;IACtF,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,EAAE,CAAC;CACjD;AAED,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,gCAAgC,CAAC;AACpE,+DAA+D;AAC/D,eAAO,MAAM,eAAe,0BAA0B,CAAC;AACvD,4FAA4F;AAC5F,eAAO,MAAM,0BAA0B,oCAAoC,CAAC;AAC5E,6FAA6F;AAC7F,eAAO,MAAM,uBAAuB,iCAAiC,CAAC;AACtE,iGAAiG;AACjG,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAClE,oFAAoF;AACpF,eAAO,MAAM,2BAA2B,2CAA2C,CAAC;AACpF,oFAAoF;AACpF,eAAO,MAAM,uBAAuB,gCAAgC,CAAC;AAkErE,yEAAyE;AACzE,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,mBAAmB,GACxB,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAwJnC"}
+{"version":3,"file":"validateTemplatePackage.d.ts","sourceRoot":"","sources":["../../../src/v4/validation/validateTemplatePackage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAOzC,kEAAkE;AAClE,MAAM,MAAM,2BAA2B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;AAErF,yBAAyB;AACzB,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9C,oFAAoF;AACpF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5C,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;AAEpE,2FAA2F;AAC3F,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;AAE/D,sFAAsF;AACtF,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,SAAS,EAAE,2BAA2B,CAAC;IACvC,0EAA0E;IAC1E,UAAU,IAAI,OAAO,GAAG,SAAS,CAAC;IAClC,yEAAyE;IACzE,SAAS,IAAI,OAAO,GAAG,SAAS,CAAC;IACjC,wEAAwE;IACxE,QAAQ,IAAI,OAAO,GAAG,SAAS,CAAC;IAChC,4FAA4F;IAC5F,OAAO,IAAI,WAAW,EAAE,GAAG,SAAS,CAAC;IACrC,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;IACrC,+DAA+D;IAC/D,OAAO,EAAE;QACP,UAAU,EAAE,eAAe,CAAC;QAC5B,QAAQ,EAAE,eAAe,CAAC;QAC1B,QAAQ,EAAE,eAAe,CAAC;QAC1B,QAAQ,EAAE,eAAe,CAAC;KAC3B,CAAC;IACF,yFAAyF;IACzF,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACtE,+DAA+D;IAC/D,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9D,oEAAoE;IACpE,aAAa,IAAI,MAAM,CAAC;IACxB,uFAAuF;IACvF,WAAW,IAAI,MAAM,EAAE,CAAC;IACxB,sFAAsF;IACtF,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,EAAE,CAAC;CACjD;AAED,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,gCAAgC,CAAC;AACpE,+DAA+D;AAC/D,eAAO,MAAM,eAAe,0BAA0B,CAAC;AACvD,4FAA4F;AAC5F,eAAO,MAAM,0BAA0B,oCAAoC,CAAC;AAC5E,6FAA6F;AAC7F,eAAO,MAAM,uBAAuB,iCAAiC,CAAC;AACtE,iGAAiG;AACjG,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAClE,oFAAoF;AACpF,eAAO,MAAM,2BAA2B,2CAA2C,CAAC;AACpF,oFAAoF;AACpF,eAAO,MAAM,uBAAuB,gCAAgC,CAAC;AACrE,mFAAmF;AACnF,eAAO,MAAM,+BAA+B,wCAAwC,CAAC;AACrF,+FAA+F;AAC/F,eAAO,MAAM,2BAA2B,qCAAqC,CAAC;AAC9E,6EAA6E;AAC7E,eAAO,MAAM,yBAAyB,mCAAmC,CAAC;AA4I1E,sFAAsF;AACtF,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,OAAO,EACnB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,2BAA2B,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+BzB;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,mBAAmB,GACxB,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC,CA0MnC"}

package/build/v4/validation/validateTemplatePackage.js

@@ -2,12 +2,14 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VALIDATE_ENGINE_TOO_OLD = exports.VALIDATE_MIN_ENGINE_MISSING = exports.VALIDATE_KIND_OVERLAP = exports.VALIDATE_DANGLING_ROUTE = exports.VALIDATE_PLACEHOLDER_DRIFT = exports.VALIDATE_SCHEMA = exports.VALIDATE_REQUIRED_FILE = void 0;
+exports.VALIDATE_CAPABILITY_FLOOR = exports.VALIDATE_UNKNOWN_CAPABILITY = exports.VALIDATE_ENGINE_VERSION_INVALID = exports.VALIDATE_ENGINE_TOO_OLD = exports.VALIDATE_MIN_ENGINE_MISSING = exports.VALIDATE_KIND_OVERLAP = exports.VALIDATE_DANGLING_ROUTE = exports.VALIDATE_PLACEHOLDER_DRIFT = exports.VALIDATE_SCHEMA = exports.VALIDATE_REQUIRED_FILE = void 0;
+exports.validateMinEngineVersion = validateMinEngineVersion;
 exports.validateTemplatePackage = validateTemplatePackage;
-const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const tslib_1 = require("tslib");
 const neverthrow_1 = require("neverthrow");
+const semver_1 = tslib_1.__importDefault(require("semver"));
 /** Pure v4 template-package validation gate. See validate-template-package spec and ADR-0015. */
-const SOURCE = "Scaffold";
+const MUSTACHE_VALUE = /\{\{\s*([A-Za-z_][A-Za-z0-9_.]*)\s*\}\}/g;
 /** `UserError` name: a required package file (`descriptor`/`questions`/`pipeline`) is absent. */
 exports.VALIDATE_REQUIRED_FILE = "TemplatePackageRequiredFile";
 /** `UserError` name: a package file failed its JSON schema. */
@@ -22,9 +24,12 @@ exports.VALIDATE_KIND_OVERLAP = "TemplatePackageKindOverlap";
 exports.VALIDATE_MIN_ENGINE_MISSING = "TemplatePackageMinEngineVersionMissing";
 /** `UserError` name: `engineVersion < minEngineVersion` — the engine is too old. */
 exports.VALIDATE_ENGINE_TOO_OLD = "TemplatePackageEngineTooOld";
-function userError(name, message) {
-    return new teamsfx_api_1.UserError({ source: SOURCE, name, message });
-}
+/** `UserError` name: a package or consuming engine version is not valid SemVer. */
+exports.VALIDATE_ENGINE_VERSION_INVALID = "TemplatePackageEngineVersionInvalid";
+/** `UserError` name: package data references a capability absent from the engine catalogue. */
+exports.VALIDATE_UNKNOWN_CAPABILITY = "TemplatePackageUnknownCapability";
+/** `UserError` name: `minEngineVersion` predates a referenced capability. */
+exports.VALIDATE_CAPABILITY_FLOOR = "TemplatePackageCapabilityFloor";
 function isRecord(v) {
     return typeof v === "object" && v !== null && !Array.isArray(v);
 }
@@ -58,29 +63,111 @@ function v4RouteIds(selectorData) {
     }
     return ids;
 }
-/** Compare `major.minor.patch` numerically: <0 / 0 / >0. */
-function compareSemver(a, b) {
-    const pa = parseSemver(a);
-    const pb = parseSemver(b);
-    for (let i = 0; i < 3; i++) {
-        if (pa[i] !== pb[i]) {
-            return pa[i] < pb[i] ? -1 : 1;
+function validateEngineVersion(pkg, field, version, userError) {
+    if (semver_1.default.valid(version) !== version) {
+        return (0, neverthrow_1.err)(userError(exports.VALIDATE_ENGINE_VERSION_INVALID, `${pkg}: ${field} '${version}' is not valid SemVer`));
+    }
+    return (0, neverthrow_1.ok)(version);
+}
+function validatorReference(validation) {
+    const id = typeof validation === "string"
+        ? validation
+        : isRecord(validation)
+            ? getString(validation, "use")
+            : undefined;
+    return id === undefined ? undefined : { kind: "validator", id };
+}
+function capabilityReferences(questions, pipeline) {
+    const references = [];
+    if (isRecord(questions)) {
+        for (const question of getArray(questions, "questions") ?? []) {
+            if (!isRecord(question)) {
+                continue;
+            }
+            const provider = getString(question, "optionsFrom");
+            if (provider !== undefined) {
+                references.push({ kind: "provider", id: provider });
+            }
+            const validator = validatorReference(question.validation);
+            if (validator !== undefined) {
+                references.push(validator);
+            }
+            const inputBoxValidator = validatorReference(getRecord(question, "inputBoxConfig")?.validation);
+            if (inputBoxValidator !== undefined) {
+                references.push(inputBoxValidator);
+            }
+        }
+    }
+    if (isRecord(pipeline)) {
+        for (const step of getArray(pipeline, "steps") ?? []) {
+            if (!isRecord(step)) {
+                continue;
+            }
+            const id = getString(step, "step");
+            if (id !== undefined) {
+                references.push({ kind: "step", id });
+            }
+        }
+    }
+    return references;
+}
+function pipelinePlaceholderReferences(pipeline) {
+    const references = new Set();
+    if (!isRecord(pipeline)) {
+        return [];
+    }
+    for (const step of getArray(pipeline, "steps") ?? []) {
+        if (!isRecord(step)) {
+            continue;
+        }
+        const withParams = getRecord(step, "with");
+        if (withParams === undefined) {
+            continue;
+        }
+        for (const value of Object.values(withParams)) {
+            const strings = typeof value === "string" ? [value] : Array.isArray(value) ? value : [];
+            for (const item of strings) {
+                if (typeof item !== "string") {
+                    continue;
+                }
+                for (const match of item.matchAll(MUSTACHE_VALUE)) {
+                    if (match.index !== undefined && match.index > 0 && item[match.index - 1] === "$") {
+                        continue;
+                    }
+                    references.add(match[1]);
+                }
+            }
         }
     }
-    return 0;
+    return [...references];
 }
-function parseSemver(v) {
-    const parts = v.split(".");
-    const nums = [];
-    for (let i = 0; i < 3; i++) {
-        const n = Number.parseInt(parts[i] ?? "0", 10);
-        nums.push(Number.isNaN(n) ? 0 : n);
-    }
-    return nums;
+/** Apply the package's reverse engine-version gate before any content is rendered. */
+function validateMinEngineVersion(kind, id, descriptor, engineVersion, userError) {
+    const pkg = `${kind}/${id}`;
+    if (!isRecord(descriptor)) {
+        return (0, neverthrow_1.err)(userError(exports.VALIDATE_SCHEMA, `${pkg}: descriptor.json must be a JSON object`));
+    }
+    const minEngineVersion = getString(descriptor, "minEngineVersion");
+    if (minEngineVersion === undefined) {
+        return (0, neverthrow_1.err)(userError(exports.VALIDATE_MIN_ENGINE_MISSING, `${pkg}: descriptor.json must declare minEngineVersion (the reverse compatibility signal)`));
+    }
+    const validMinimum = validateEngineVersion(pkg, "minEngineVersion", minEngineVersion, userError);
+    if (validMinimum.isErr()) {
+        return (0, neverthrow_1.err)(validMinimum.error);
+    }
+    const validEngine = validateEngineVersion(pkg, "engineVersion", engineVersion, userError);
+    if (validEngine.isErr()) {
+        return (0, neverthrow_1.err)(validEngine.error);
+    }
+    if (semver_1.default.lt(engineVersion, minEngineVersion)) {
+        return (0, neverthrow_1.err)(userError(exports.VALIDATE_ENGINE_TOO_OLD, `${pkg}: requires engine ${minEngineVersion}, but this engine is ${engineVersion}; upgrade the engine (no silent fallback)`));
+    }
+    return (0, neverthrow_1.ok)(minEngineVersion);
 }
 /** Validate one `<kind>/<id>` package before any content is rendered. */
 function validateTemplatePackage(kind, id, mode, port) {
     const pkg = `${kind}/${id}`;
+    const userError = (name, message) => port.userError(name, message);
     // descriptor / questions / pipeline are required; `content/` is optional.
     const descriptor = port.descriptor();
     const questions = port.questions();
@@ -107,10 +194,37 @@ function validateTemplatePackage(kind, id, mode, port) {
     if (qSchemaErr !== undefined) {
         return (0, neverthrow_1.err)(userError(exports.VALIDATE_SCHEMA, `${pkg}: questions.json failed schema validation: ${qSchemaErr}`));
     }
+    const pSchemaErr = port.schemas.pipeline(pipeline);
+    if (pSchemaErr !== undefined) {
+        return (0, neverthrow_1.err)(userError(exports.VALIDATE_SCHEMA, `${pkg}: pipeline.json failed schema validation: ${pSchemaErr}`));
+    }
     const sSchemaErr = port.schemas.selector(selectorData);
     if (sSchemaErr !== undefined) {
         return (0, neverthrow_1.err)(userError(exports.VALIDATE_SCHEMA, `${pkg}: selector.json failed schema validation: ${sSchemaErr}`));
     }
+    const minEngineVersion = getString(descriptor, "minEngineVersion");
+    if (minEngineVersion === undefined) {
+        return (0, neverthrow_1.err)(userError(exports.VALIDATE_MIN_ENGINE_MISSING, `${pkg}: descriptor.json must declare minEngineVersion (the reverse compatibility signal)`));
+    }
+    const validMinimum = validateEngineVersion(pkg, "minEngineVersion", minEngineVersion, userError);
+    if (validMinimum.isErr()) {
+        return (0, neverthrow_1.err)(validMinimum.error);
+    }
+    const derivedVars = [];
+    for (const reference of capabilityReferences(questions, pipeline)) {
+        const floor = port.capabilityFloor(reference.kind, reference.id);
+        if (floor === undefined) {
+            return (0, neverthrow_1.err)(userError(exports.VALIDATE_UNKNOWN_CAPABILITY, `${pkg}: ${reference.kind} '${reference.id}' is not a registered template capability`));
+        }
+        if (semver_1.default.lt(minEngineVersion, floor)) {
+            return (0, neverthrow_1.err)(userError(exports.VALIDATE_CAPABILITY_FLOOR, `${pkg}: ${reference.kind} '${reference.id}' requires minEngineVersion ${floor}, but descriptor.json declares ${minEngineVersion}`));
+        }
+        if (reference.kind === "provider") {
+            for (const output of port.capabilityOutputs(reference.kind, reference.id)) {
+                derivedVars.push(`derived.${reference.id}.${output}`);
+            }
+        }
+    }
     // Placeholder closure: every token has a producer, and every required var is consumed.
     const replaceMapVars = [];
     const requiredVars = [];
@@ -145,9 +259,20 @@ function validateTemplatePackage(kind, id, mode, port) {
             }
         }
     }
-    const mayReference = new Set([...replaceMapVars, ...answerVars, ...port.callerFloor()]);
+    const mayReference = new Set([
+        ...replaceMapVars,
+        ...answerVars,
+        ...derivedVars,
+        ...port.callerFloor(),
+    ]);
     const contentFiles = port.content() ?? [];
     const contentTokens = new Set();
+    for (const token of pipelinePlaceholderReferences(pipeline)) {
+        contentTokens.add(token);
+        if (!mayReference.has(token)) {
+            return (0, neverthrow_1.err)(userError(exports.VALIDATE_PLACEHOLDER_DRIFT, `${pkg}: pipeline.json references '{{${token}}}', which no replaceMap entry, question, or caller-injected identifier produces`));
+        }
+    }
     for (const file of contentFiles) {
         for (const token of file.placeholders) {
             contentTokens.add(token);
@@ -158,7 +283,7 @@ function validateTemplatePackage(kind, id, mode, port) {
     }
     for (const v of requiredVars) {
         if (!contentTokens.has(v)) {
-            return (0, neverthrow_1.err)(userError(exports.VALIDATE_PLACEHOLDER_DRIFT, `${pkg}: emits required render var '${v}' that no content file consumes`));
+            return (0, neverthrow_1.err)(userError(exports.VALIDATE_PLACEHOLDER_DRIFT, `${pkg}: emits required render var '${v}' that no render surface consumes`));
         }
     }
     // Every v4 route must resolve to a present descriptor; kinds stay disjoint.
@@ -177,13 +302,12 @@ function validateTemplatePackage(kind, id, mode, port) {
         }
     }
     // The reverse gate is explicit.
-    const minEngineVersion = getString(descriptor, "minEngineVersion");
-    if (minEngineVersion === undefined) {
-        return (0, neverthrow_1.err)(userError(exports.VALIDATE_MIN_ENGINE_MISSING, `${pkg}: descriptor.json must declare minEngineVersion (the reverse compatibility signal)`));
-    }
-    if (mode === "load" && compareSemver(port.engineVersion(), minEngineVersion) < 0) {
-        return (0, neverthrow_1.err)(userError(exports.VALIDATE_ENGINE_TOO_OLD, `${pkg}: requires engine ${minEngineVersion}, but this engine is ${port.engineVersion()}; upgrade the engine (no silent fallback)`));
+    const minEngineResult = mode === "load"
+        ? validateMinEngineVersion(kind, id, descriptor, port.engineVersion(), userError)
+        : (0, neverthrow_1.ok)(minEngineVersion);
+    if (minEngineResult.isErr()) {
+        return (0, neverthrow_1.err)(minEngineResult.error);
     }
-    return (0, neverthrow_1.ok)({ descriptor, minEngineVersion, contentFiles });
+    return (0, neverthrow_1.ok)({ descriptor, minEngineVersion: minEngineResult.value, contentFiles });
 }
 //# sourceMappingURL=validateTemplatePackage.js.map