@microsoft/teamsfx-core 3.1.0 → 3.1.1

package/build/v4/surface/uiPromptUI.js

@@ -0,0 +1,220 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUiPromptUI = createUiPromptUI;
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const neverthrow_1 = require("neverthrow");
+const localizePrompt_1 = require("./localizePrompt");
+/** Create-Q2 prompt bridge from v4 `PromptUI` to host `UserInteraction`. */
+const SOURCE = "Scaffold";
+function labelWithIcon(label, iconPath) {
+    return iconPath === undefined ? label : `$(${iconPath}) ${label}`;
+}
+/** Map a v4 identity-only option to the surface option shape (label defaults to its id). */
+function toSurfaceOption(option) {
+    const label = (0, localizePrompt_1.localizePrefixedText)(option.keyPrefix, "label", option.label) ?? option.id;
+    return {
+        id: option.id,
+        label: labelWithIcon(label, option.iconPath),
+        description: (0, localizePrompt_1.localizePrefixedText)(option.keyPrefix, "description", option.description),
+        detail: (0, localizePrompt_1.localizePrefixedText)(option.keyPrefix, "detail", option.detail),
+        groupName: (0, localizePrompt_1.localizePrefixedText)(option.keyPrefix, "groupName", option.groupName),
+    };
+}
+function toSurfaceOptions(options) {
+    return options.map((option) => toSurfaceOption(option));
+}
+function toSurfaceOptionsSource(options) {
+    if (Array.isArray(options)) {
+        return toSurfaceOptions(options);
+    }
+    return async () => toSurfaceOptions((await options()).options);
+}
+/** Project a single-select surface result back to the selected `id` string. */
+function selectedId(result) {
+    if (typeof result === "string") {
+        return result;
+    }
+    if (result === undefined) {
+        return "";
+    }
+    return result.id;
+}
+/** Project a multi-select surface result back to the selected `id` strings. */
+function selectedIds(result) {
+    if (result === undefined) {
+        return [];
+    }
+    return result.map((item) => (typeof item === "string" ? item : item.id));
+}
+function unsupportedKind(question) {
+    return new teamsfx_api_1.SystemError({
+        source: SOURCE,
+        name: "UnsupportedQuestionKind",
+        message: `Question '${question.name}' has kind '${question.type}', which the create surface does not render.`,
+    });
+}
+/** Build a `PromptUI` over the host `UserInteraction`. */
+function createUiPromptUI(ui) {
+    return {
+        async ask(question, options, step, validation, inputBoxValidation) {
+            if (question.type === "singleSelect") {
+                if (options === undefined) {
+                    return (0, neverthrow_1.err)(unsupportedKind(question));
+                }
+                const config = {
+                    name: question.name,
+                    title: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "title", question.title) ?? question.name,
+                    placeholder: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "placeholder", question.placeholder),
+                    prompt: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "prompt", question.prompt),
+                    default: typeof question.default === "string" ? question.default : undefined,
+                    options: toSurfaceOptionsSource(options),
+                    returnObject: false,
+                    skipSingleOption: question.skipSingleOption,
+                    step,
+                    validation,
+                };
+                const result = await ui.selectOption(config);
+                if (result.isErr()) {
+                    return (0, neverthrow_1.err)(result.error);
+                }
+                if (result.value.type === "back") {
+                    return (0, neverthrow_1.ok)({ kind: "back" });
+                }
+                if (result.value.type === "skip") {
+                    return (0, neverthrow_1.ok)({ kind: "skip", value: selectedId(result.value.result) });
+                }
+                return (0, neverthrow_1.ok)({ kind: "value", value: selectedId(result.value.result) });
+            }
+            if (question.type === "text") {
+                const config = {
+                    name: question.name,
+                    title: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "title", question.title) ?? question.name,
+                    placeholder: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "placeholder", question.placeholder),
+                    prompt: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "prompt", question.prompt),
+                    default: typeof question.default === "string" ? question.default : undefined,
+                    password: question.password,
+                    step,
+                    validation,
+                };
+                const result = await ui.inputText(config);
+                if (result.isErr()) {
+                    return (0, neverthrow_1.err)(result.error);
+                }
+                if (result.value.type === "back") {
+                    return (0, neverthrow_1.ok)({ kind: "back" });
+                }
+                return (0, neverthrow_1.ok)({ kind: "value", value: result.value.result ?? "" });
+            }
+            if (question.type === "singleFile") {
+                const config = {
+                    name: question.name,
+                    title: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "title", question.title) ?? question.name,
+                    placeholder: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "placeholder", question.placeholder),
+                    prompt: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "prompt", question.prompt),
+                    default: typeof question.default === "string" ? question.default : undefined,
+                    filters: question.filters,
+                    step,
+                    validation,
+                };
+                const result = await ui.selectFile(config);
+                if (result.isErr()) {
+                    return (0, neverthrow_1.err)(result.error);
+                }
+                if (result.value.type === "back") {
+                    return (0, neverthrow_1.ok)({ kind: "back" });
+                }
+                return (0, neverthrow_1.ok)({ kind: "value", value: result.value.result ?? "" });
+            }
+            if (question.type === "singleFileOrText") {
+                if (ui.selectFileOrInput === undefined ||
+                    question.inputOptionItem === undefined ||
+                    question.inputBoxConfig === undefined) {
+                    return (0, neverthrow_1.err)(unsupportedKind(question));
+                }
+                const inputBoxConfig = question.inputBoxConfig;
+                const config = {
+                    name: question.name,
+                    title: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "title", question.title) ?? question.name,
+                    placeholder: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "placeholder", question.placeholder),
+                    prompt: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "prompt", question.prompt),
+                    inputOptionItem: toSurfaceOption(question.inputOptionItem),
+                    inputBoxConfig: {
+                        name: inputBoxConfig.name,
+                        title: (0, localizePrompt_1.localizePrefixedText)(inputBoxConfig.keyPrefix, "title", inputBoxConfig.title) ??
+                            inputBoxConfig.name,
+                        placeholder: (0, localizePrompt_1.localizePrefixedText)(inputBoxConfig.keyPrefix, "placeholder", inputBoxConfig.placeholder),
+                        prompt: (0, localizePrompt_1.localizePrefixedText)(inputBoxConfig.keyPrefix, "prompt", inputBoxConfig.prompt),
+                        default: inputBoxConfig.default,
+                        step: inputBoxConfig.step ?? step,
+                        validation: inputBoxValidation,
+                    },
+                    filters: question.filters,
+                    step,
+                    validation,
+                };
+                const result = await ui.selectFileOrInput(config);
+                if (result.isErr()) {
+                    return (0, neverthrow_1.err)(result.error);
+                }
+                if (result.value.type === "back") {
+                    return (0, neverthrow_1.ok)({ kind: "back" });
+                }
+                return (0, neverthrow_1.ok)({ kind: "value", value: result.value.result ?? "" });
+            }
+            if (question.type === "folder") {
+                const config = {
+                    name: question.name,
+                    title: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "title", question.title) ?? question.name,
+                    placeholder: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "placeholder", question.placeholder),
+                    prompt: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "prompt", question.prompt),
+                    default: typeof question.default === "string" ? question.default : undefined,
+                    step,
+                    validation,
+                };
+                const result = await ui.selectFolder(config);
+                if (result.isErr()) {
+                    return (0, neverthrow_1.err)(result.error);
+                }
+                if (result.value.type === "back") {
+                    return (0, neverthrow_1.ok)({ kind: "back" });
+                }
+                return (0, neverthrow_1.ok)({ kind: "value", value: result.value.result ?? "" });
+            }
+            return (0, neverthrow_1.err)(unsupportedKind(question));
+        },
+        async askMulti(question, options, step) {
+            if (question.type !== "multiSelect" || options === undefined) {
+                return (0, neverthrow_1.err)(unsupportedKind(question));
+            }
+            const config = {
+                name: question.name,
+                title: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "title", question.title) ?? question.name,
+                placeholder: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "placeholder", question.placeholder),
+                prompt: (0, localizePrompt_1.localizePrefixedText)(question.keyPrefix, "prompt", question.prompt),
+                default: Array.isArray(question.default)
+                    ? question.default
+                    : question.default === undefined
+                        ? undefined
+                        : [question.default],
+                options: toSurfaceOptionsSource(options),
+                returnObject: false,
+                skipSingleOption: question.skipSingleOption,
+                step,
+            };
+            const result = await ui.selectOptions(config);
+            if (result.isErr()) {
+                return (0, neverthrow_1.err)(result.error);
+            }
+            if (result.value.type === "back") {
+                return (0, neverthrow_1.ok)({ kind: "back" });
+            }
+            if (result.value.type === "skip") {
+                return (0, neverthrow_1.ok)({ kind: "skip", value: selectedIds(result.value.result) });
+            }
+            return (0, neverthrow_1.ok)({ kind: "value", value: selectedIds(result.value.result) });
+        },
+    };
+}
+//# sourceMappingURL=uiPromptUI.js.map

package/build/v4/surface/uiPromptUI.js.map

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

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

@@ -0,0 +1,8 @@
+import type { CapabilityKind } from "./validateTemplatePackage";
+/** Return when a template-visible capability first became available in the engine. */
+export declare function templateCapabilityFloor(kind: CapabilityKind, id: string): string | undefined;
+/** Enumerate a capability kind for registry/catalogue parity tests. */
+export declare function templateCapabilities(kind: CapabilityKind): string[];
+/** Return the render-context keys a capability may derive. */
+export declare function templateCapabilityOutputs(kind: CapabilityKind, id: string): string[];
+//# sourceMappingURL=capabilityCatalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilityCatalog.d.ts","sourceRoot":"","sources":["../../../src/v4/validation/capabilityCatalog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AA8ChE,sFAAsF;AACtF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE5F;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CAEnE;AAED,8DAA8D;AAC9D,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAEpF"}

package/build/v4/validation/capabilityCatalog.js

@@ -0,0 +1,62 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.templateCapabilityFloor = templateCapabilityFloor;
+exports.templateCapabilities = templateCapabilities;
+exports.templateCapabilityOutputs = templateCapabilityOutputs;
+/** Source-owned introduction versions for every template-visible engine capability. */
+const CAPABILITY_FLOORS = {
+    step: new Map([
+        ["require-empty-target", "5.20.0"],
+        ["da-action/register-plugin-manifest", "5.20.0"],
+        ["da/set-sensitivity-label", "6.11.0"],
+        ["mcp-auth/inject-yml-action", "5.20.0"],
+        ["mcp-auth/persist-credential-env", "5.20.0"],
+        ["mcp-local/materialize-servers", "5.20.0"],
+        ["mcp-static/materialize-tools", "5.20.0"],
+        ["metaos/unify-project-id", "5.20.0"],
+        ["metaos/upgrade-existing-project", "5.20.0"],
+        ["officeaddin/import-existing-project", "5.20.0"],
+        ["openapi/generate-plugin-files", "5.20.0"],
+        ["openapi/generate-teams-ai-custom-api-files", "5.20.0"],
+    ]),
+    provider: new Map([
+        ["mcp.serverTypes", "5.20.0"],
+        ["mcp.localServers", "5.20.0"],
+        ["mcp.tools", "5.20.0"],
+        ["openapi.search", "5.20.0"],
+        ["openapi.operations", "5.20.0"],
+    ]),
+    validator: new Map([
+        ["uri", "5.20.0"],
+        ["openapiUrl", "5.20.0"],
+        ["graphConnectorName", "5.20.0"],
+        ["graphConnectorConnectionId", "5.20.0"],
+        ["mcp.oauthClientIdRequired", "6.11.0"],
+        ["mcp.oauthClientSecretRequired", "6.11.0"],
+        ["mcp.entraClientIdRequired", "6.11.0"],
+        ["mcp.serverUrl", "6.11.0"],
+    ]),
+};
+const CAPABILITY_OUTPUTS = {
+    step: new Map(),
+    provider: new Map([
+        ["mcp.serverTypes", ["catalog"]],
+        ["mcp.tools", ["toolsJson"]],
+    ]),
+    validator: new Map(),
+};
+/** Return when a template-visible capability first became available in the engine. */
+function templateCapabilityFloor(kind, id) {
+    return CAPABILITY_FLOORS[kind].get(id);
+}
+/** Enumerate a capability kind for registry/catalogue parity tests. */
+function templateCapabilities(kind) {
+    return [...CAPABILITY_FLOORS[kind].keys()];
+}
+/** Return the render-context keys a capability may derive. */
+function templateCapabilityOutputs(kind, id) {
+    return [...(CAPABILITY_OUTPUTS[kind].get(id) ?? [])];
+}
+//# sourceMappingURL=capabilityCatalog.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capabilityCatalog.js","sourceRoot":"","sources":["../../../src/v4/validation/capabilityCatalog.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;AAiDlC,0DAEC;AAGD,oDAEC;AAGD,8DAEC;AAzDD,uFAAuF;AACvF,MAAM,iBAAiB,GAAwD;IAC7E,IAAI,EAAE,IAAI,GAAG,CAAC;QACZ,CAAC,sBAAsB,EAAE,QAAQ,CAAC;QAClC,CAAC,oCAAoC,EAAE,QAAQ,CAAC;QAChD,CAAC,0BAA0B,EAAE,QAAQ,CAAC;QACtC,CAAC,4BAA4B,EAAE,QAAQ,CAAC;QACxC,CAAC,iCAAiC,EAAE,QAAQ,CAAC;QAC7C,CAAC,+BAA+B,EAAE,QAAQ,CAAC;QAC3C,CAAC,8BAA8B,EAAE,QAAQ,CAAC;QAC1C,CAAC,yBAAyB,EAAE,QAAQ,CAAC;QACrC,CAAC,iCAAiC,EAAE,QAAQ,CAAC;QAC7C,CAAC,qCAAqC,EAAE,QAAQ,CAAC;QACjD,CAAC,+BAA+B,EAAE,QAAQ,CAAC;QAC3C,CAAC,4CAA4C,EAAE,QAAQ,CAAC;KACzD,CAAC;IACF,QAAQ,EAAE,IAAI,GAAG,CAAC;QAChB,CAAC,iBAAiB,EAAE,QAAQ,CAAC;QAC7B,CAAC,kBAAkB,EAAE,QAAQ,CAAC;QAC9B,CAAC,WAAW,EAAE,QAAQ,CAAC;QACvB,CAAC,gBAAgB,EAAE,QAAQ,CAAC;QAC5B,CAAC,oBAAoB,EAAE,QAAQ,CAAC;KACjC,CAAC;IACF,SAAS,EAAE,IAAI,GAAG,CAAC;QACjB,CAAC,KAAK,EAAE,QAAQ,CAAC;QACjB,CAAC,YAAY,EAAE,QAAQ,CAAC;QACxB,CAAC,oBAAoB,EAAE,QAAQ,CAAC;QAChC,CAAC,4BAA4B,EAAE,QAAQ,CAAC;QACxC,CAAC,2BAA2B,EAAE,QAAQ,CAAC;QACvC,CAAC,+BAA+B,EAAE,QAAQ,CAAC;QAC3C,CAAC,2BAA2B,EAAE,QAAQ,CAAC;QACvC,CAAC,eAAe,EAAE,QAAQ,CAAC;KAC5B,CAAC;CACH,CAAC;AAEF,MAAM,kBAAkB,GAAmE;IACzF,IAAI,EAAE,IAAI,GAAG,EAAE;IACf,QAAQ,EAAE,IAAI,GAAG,CAAC;QAChB,CAAC,iBAAiB,EAAE,CAAC,SAAS,CAAC,CAAC;QAChC,CAAC,WAAW,EAAE,CAAC,WAAW,CAAC,CAAC;KAC7B,CAAC;IACF,SAAS,EAAE,IAAI,GAAG,EAAE;CACrB,CAAC;AAEF,sFAAsF;AACtF,SAAgB,uBAAuB,CAAC,IAAoB,EAAE,EAAU;IACtE,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,uEAAuE;AACvE,SAAgB,oBAAoB,CAAC,IAAoB;IACvD,OAAO,CAAC,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,8DAA8D;AAC9D,SAAgB,yBAAyB,CAAC,IAAoB,EAAE,EAAU;IACxE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { FxError } from "@microsoft/teamsfx-api";
+import type { Result } from "neverthrow";
+import type { LoadedPackage } from "../distribution/packageDir";
+import type { DeclarativeLocator } from "../model/dataModel";
+import type { ValidateMode } from "./validateTemplatePackage";
+/** Adapt validation diagnoses to the concrete errors owned by the caller. */
+export interface TemplateArchiveErrorFactory {
+    user(name: string, message: string): FxError;
+    system(name: string, message: string): FxError;
+}
+/** Validate and open one declarative package from final channel archive bytes. */
+export declare function validateDeclarativePackageArchive(bytes: Buffer, locator: DeclarativeLocator, mode: ValidateMode, engineVersion: string, errors: TemplateArchiveErrorFactory): Result<LoadedPackage, FxError>;
+/** Validate every authored create/modify package in final channel archive bytes. */
+export declare function validateDeclarativeTemplateArchive(bytes: Buffer, mode: ValidateMode, engineVersion: string, errors: TemplateArchiveErrorFactory): Result<string[], FxError>;
+//# sourceMappingURL=templateArchiveValidation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templateArchiveValidation.d.ts","sourceRoot":"","sources":["../../../src/v4/validation/templateArchiveValidation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAKtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAqB,MAAM,oBAAoB,CAAC;AAEhF,OAAO,KAAK,EAIV,YAAY,EACb,MAAM,2BAA2B,CAAC;AAMnC,6EAA6E;AAC7E,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CAChD;AA4VD,kFAAkF;AAClF,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,YAAY,EAClB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,2BAA2B,GAClC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAchC;AAED,oFAAoF;AACpF,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,YAAY,EAClB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,2BAA2B,GAClC,MAAM,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC,CA+B3B"}

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