@microsoft/teamsfx-core 3.0.13 → 3.0.14-alpha.1ba1d62e58.0

package/build/v4/distribution/templateSource.js

@@ -0,0 +1,220 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeDigest = computeDigest;
+exports.resolveTemplateSource = resolveTemplateSource;
+const tslib_1 = require("tslib");
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const neverthrow_1 = require("neverthrow");
+const crypto = tslib_1.__importStar(require("crypto"));
+const semver_1 = tslib_1.__importDefault(require("semver"));
+/**
+ * The v4 template-distribution resolution operation.
+ *
+ * Spec: docs/03-specs/operations/scaffolding/resolve-template-source.md
+ * Decision: docs/02-architecture/adr/ADR-0006-template-distribution-channel.md
+ *
+ * This module is part of the v4 world. It imports no v3 symbol; v3 code may
+ * call `resolveTemplateSource`, but nothing here is tailored for v3.
+ */
+const SOURCE = "Scaffold";
+/** sha256 content hash of a package's bytes, prefixed `sha256:`. */
+function computeDigest(bytes) {
+    return "sha256:" + crypto.createHash("sha256").update(bytes).digest("hex");
+}
+/**
+ * Resolve `(range, bundled, port)` to exactly one `TemplateSource` before any
+ * template is read or rendered. Pure with respect to its inputs and the
+ * current tag-list state (INV-6). Returns `Result` rather than throwing,
+ * consistent with the toolkit-wide neverthrow rule.
+ */
+async function resolveTemplateSource(input) {
+    const { range, bundled, port } = input;
+    const templateVersion = port.env("TEMPLATE_VERSION");
+    if (templateVersion === "local") {
+        return (0, neverthrow_1.ok)(floorSource(port.floor)); // AC-02 (override beats bundled=false)
+    }
+    if (templateVersion) {
+        return pinnedOnline(templateVersion, port); // AC-03
+    }
+    if (bundled) {
+        return (0, neverthrow_1.ok)(floorSource(port.floor)); // AC-01, AC-12 (never sniff package.json#version)
+    }
+    return resolveOnline(range, port);
+}
+function floorSource(floor) {
+    return {
+        origin: "bundled",
+        version: floor.version,
+        digest: floor.digest,
+        location: floor.location,
+    };
+}
+async function pinnedOnline(version, port) {
+    let tags;
+    try {
+        tags = await port.tagList();
+    }
+    catch (e) {
+        // A pin never falls back (AC-16 intent): surface the channel failure as a
+        // Result instead of letting the rejection escape (neverthrow contract).
+        return (0, neverthrow_1.err)(asTagListError(e));
+    }
+    const entry = tags.find((t) => t.version === version);
+    if (!entry) {
+        return (0, neverthrow_1.err)(new teamsfx_api_1.UserError({
+            source: SOURCE,
+            name: "TemplatePinnedVersionNotFound",
+            message: `Pinned template version "${version}" is not published on the release channel.`,
+        }));
+    }
+    return fetchVerify(entry, port, "online");
+}
+async function resolveOnline(range, port) {
+    let tags;
+    try {
+        tags = await port.tagList();
+    }
+    catch (e) {
+        // A malformed channel document is a hard error (spec decision #7 / AC-17),
+        // distinct from an unreachable channel: it must never be masked as an
+        // offline fallback. Only a genuine reachability failure falls back.
+        if (isMalformedTagList(e)) {
+            return (0, neverthrow_1.err)(e);
+        }
+        return (0, neverthrow_1.ok)(offlineFallback(range, port)); // AC-07, AC-08 (unreachable only)
+    }
+    const picked = semver_1.default.maxSatisfying(tags.map((t) => t.version), range); // AC-09 (stable excludes -beta), AC-10 (range names -beta)
+    if (!picked) {
+        // Channel reachable but no version satisfies range (AC-14 / AC-15).
+        if (semver_1.default.satisfies(port.floor.version, range)) {
+            return (0, neverthrow_1.ok)(floorFallback(port.floor)); // AC-14
+        }
+        return (0, neverthrow_1.err)(new teamsfx_api_1.UserError({
+            source: SOURCE,
+            name: "TemplateVersionMismatch",
+            message: `No published template version satisfies range "${range}", and the bundled floor "${port.floor.version}" does not satisfy it either. The engine and template versions are incompatible.`,
+        })); // AC-15
+    }
+    if (picked === port.floor.version) {
+        return (0, neverthrow_1.ok)(floorSource(port.floor)); // AC-05 (floor is highest satisfier; no download)
+    }
+    const entry = tags.find((t) => t.version === picked);
+    /* istanbul ignore if -- defensive: `picked` is drawn from `tags`, so a miss
+       means the tag list mutated mid-resolution; not reproducible in a unit. */
+    if (!entry) {
+        return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({
+            source: SOURCE,
+            name: "TemplateTagListInconsistent",
+            message: `Resolved version "${picked}" is no longer present in the tag list.`,
+        }));
+    }
+    return fetchVerify(entry, port, "online"); // AC-04, AC-06, AC-11
+}
+/** A malformed channel tag-list (decision #7) is a hard error, distinct from an unreachable channel. */
+function isMalformedTagList(e) {
+    return e instanceof teamsfx_api_1.SystemError && e.name === "TemplateTagListMalformed";
+}
+/** Preserve an existing FxError; wrap any other tag-list failure as a SystemError (neverthrow contract). */
+function asTagListError(e) {
+    if (e instanceof teamsfx_api_1.UserError || e instanceof teamsfx_api_1.SystemError) {
+        return e;
+    }
+    /* istanbul ignore next -- the port rejects with an Error; the String(e)
+       fallback is defensive for non-Error rejections, not reproducible in a unit. */
+    const message = e instanceof Error ? e.message : String(e);
+    return new teamsfx_api_1.SystemError({
+        source: SOURCE,
+        name: "TemplateTagListUnavailable",
+        message: `Failed to read the template release channel: ${message}.`,
+    });
+}
+/** Preserve an existing FxError; wrap any other download failure as a SystemError (neverthrow contract). */
+function asDownloadError(e, version) {
+    if (e instanceof teamsfx_api_1.UserError || e instanceof teamsfx_api_1.SystemError) {
+        return e;
+    }
+    /* istanbul ignore next -- the port rejects with an Error; the String(e)
+       fallback is defensive for non-Error rejections, not reproducible in a unit. */
+    const message = e instanceof Error ? e.message : String(e);
+    return new teamsfx_api_1.SystemError({
+        source: SOURCE,
+        name: "TemplateDownloadFailed",
+        message: `Failed to download template "${version}" from the release channel: ${message}.`,
+    });
+}
+async function fetchVerify(entry, port, origin) {
+    const cached = port.cache.get(entry.version);
+    if (cached && cached.digest === entry.digest) {
+        return (0, neverthrow_1.ok)({
+            origin: "cache",
+            version: entry.version,
+            digest: entry.digest,
+            location: cacheLocation(entry.version),
+        }); // AC-06 (zero download)
+    }
+    let bytes;
+    try {
+        bytes = await port.packages(entry.version, entry.digest);
+    }
+    catch (e) {
+        // The download (sendRequestWithRetry) can reject; surface it as a Result
+        // rather than letting it escape resolveTemplateSource (neverthrow contract).
+        return (0, neverthrow_1.err)(asDownloadError(e, entry.version));
+    }
+    const computed = computeDigest(bytes);
+    if (computed !== entry.digest) {
+        return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({
+            source: SOURCE,
+            name: "TemplateDigestMismatch",
+            message: `Downloaded template "${entry.version}" failed integrity check: expected ${entry.digest}, got ${computed}.`,
+        })); // AC-11 (cache not written, corrupt bytes never returned)
+    }
+    port.cache.put(entry.version, entry.digest, bytes);
+    return (0, neverthrow_1.ok)({
+        origin,
+        version: entry.version,
+        digest: entry.digest,
+        location: cacheLocation(entry.version),
+    }); // AC-04
+}
+/** Reached when the channel is unreachable: max(highest cached satisfying range, floor). */
+function offlineFallback(range, port) {
+    const cachedSatisfying = port.cache.keys().filter((v) => semver_1.default.satisfies(v, range));
+    const highestCached = semver_1.default.maxSatisfying(cachedSatisfying, range);
+    const floorSatisfies = semver_1.default.satisfies(port.floor.version, range);
+    // Cache wins only when strictly higher than the floor; a tie goes to the floor (decision #2).
+    if (highestCached && (!floorSatisfies || semver_1.default.gt(highestCached, port.floor.version))) {
+        const cached = port.cache.get(highestCached);
+        /* istanbul ignore else -- highestCached is drawn from cache.keys(); a miss
+           means the cache mutated mid-resolution, so we degrade to the floor. */
+        if (cached) {
+            return {
+                origin: "cache",
+                version: highestCached,
+                digest: cached.digest,
+                location: cacheLocation(highestCached),
+                warning: offlineWarning(range),
+            }; // AC-07
+        }
+    }
+    return { ...floorFallback(port.floor), warning: offlineWarning(range) }; // AC-08
+}
+function floorFallback(floor) {
+    return {
+        origin: "bundled-fallback",
+        version: floor.version,
+        digest: floor.digest,
+        location: floor.location,
+        warning: `Falling back to the bundled template floor "${floor.version}".`,
+    };
+}
+function offlineWarning(range) {
+    return `The template release channel was unreachable; resolved offline within range "${range}".`;
+}
+function cacheLocation(version) {
+    // eslint-disable-next-line no-secrets/no-secrets
+    return `templates-v4@${version}`;
+}
+//# sourceMappingURL=templateSource.js.map

package/build/v4/distribution/templateSource.js.map

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

package/build/v4/distribution/templateSourcePort.d.ts

@@ -0,0 +1,50 @@
+import { FxError } from "@microsoft/teamsfx-api";
+import { Result } from "neverthrow";
+import { BundledFloor, TagEntry, TemplateSource, TemplateSourcePort } from "./templateSource";
+/** v4 channel prefix and naming (ADR-0006 channel isolation). */
+export declare const V4_TAG_PREFIX = "templates-v4@";
+export declare const ZIP_EXT = ".zip";
+export interface TemplateChannelConfig {
+    /** NDJSON tag-list URL for the v4 channel (separate from the frozen v3 `tagListURL`). */
+    templatesV4TagListURL: string;
+    /** Base URL release assets are downloaded from. */
+    templateDownloadBaseURL: string;
+    /** Network retry budget. */
+    tryLimits: number;
+}
+/**
+ * Parse the model-A NDJSON tag list: one `{ version, digest }` object per
+ * line. Blank lines and trailing `\r` are ignored; a malformed line is a hard
+ * error (no silent skip) — spec decision #7.
+ */
+export declare function parseTagList(ndjson: string): TagEntry[];
+/** The download URL for a v4 template package version. */
+export declare function templateZipUrl(baseURL: string, version: string): string;
+/** The on-disk cache directory for the v4 template packages. */
+export declare function cacheDir(): string;
+/** The cache file path for one version. */
+export declare function cacheFile(version: string): string;
+/**
+ * Build the production port. `floor` is injected (it comes from the engine's
+ * baked bundled package); this factory does not fabricate it.
+ */
+export declare function createTemplateSourcePort(config: TemplateChannelConfig, floor: BundledFloor): TemplateSourcePort;
+/**
+ * Load the bytes for an already-resolved {@link TemplateSource}.
+ *
+ * `resolveTemplateSource` decides *which* package a scaffold run uses but
+ * returns only the descriptor; this is the companion IO step that produces the
+ * bytes, the boundary the v3 chokepoint calls before `openTemplatePackage`.
+ *
+ * It never reaches the network: an `online`/`cache` source was already
+ * downloaded, verified, and cached during resolution, so re-downloading here
+ * would defeat the digest-keyed cache and reintroduce the v3 re-fetch churn. A
+ * cache miss is therefore an invariant violation (hard error), not a silent
+ * re-fetch. Every path re-checks the bytes against `source.digest` so
+ * `computeDigest` stays the single integrity authority and a corrupt package is
+ * never handed back.
+ *
+ * Spec: docs/03-specs/operations/scaffolding/resolve-template-source.md
+ */
+export declare function loadResolvedPackage(source: TemplateSource, port: TemplateSourcePort): Result<Buffer, FxError>;
+//# sourceMappingURL=templateSourcePort.d.ts.map

package/build/v4/distribution/templateSourcePort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateSourcePort.d.ts","sourceRoot":"","sources":["../../../src/v4/distribution/templateSourcePort.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAe,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,MAAM,EAAW,MAAM,YAAY,CAAC;AAK7C,OAAO,EACL,YAAY,EAEZ,QAAQ,EACR,cAAc,EACd,kBAAkB,EAEnB,MAAM,kBAAkB,CAAC;AAc1B,iEAAiE;AAEjE,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAC7C,eAAO,MAAM,OAAO,SAAS,CAAC;AAE9B,MAAM,WAAW,qBAAqB;IACpC,yFAAyF;IACzF,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,uBAAuB,EAAE,MAAM,CAAC;IAChC,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,CA4BvD;AAUD,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,gEAAgE;AAChE,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED,2CAA2C;AAC3C,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,YAAY,GAClB,kBAAkB,CAwEpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,kBAAkB,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuCzB"}

package/build/v4/distribution/templateSourcePort.js

@@ -0,0 +1,207 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZIP_EXT = exports.V4_TAG_PREFIX = void 0;
+exports.parseTagList = parseTagList;
+exports.templateZipUrl = templateZipUrl;
+exports.cacheDir = cacheDir;
+exports.cacheFile = cacheFile;
+exports.createTemplateSourcePort = createTemplateSourcePort;
+exports.loadResolvedPackage = loadResolvedPackage;
+const tslib_1 = require("tslib");
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const axios_1 = tslib_1.__importDefault(require("axios"));
+const neverthrow_1 = require("neverthrow");
+const fs = tslib_1.__importStar(require("fs-extra"));
+const path = tslib_1.__importStar(require("path"));
+const os_1 = tslib_1.__importDefault(require("os"));
+const requestUtils_1 = require("../../common/requestUtils");
+const templateSource_1 = require("./templateSource");
+/**
+ * Production wiring of the narrow {@link TemplateSourcePort} over real
+ * environment / network / filesystem. The pure helpers (`parseTagList`,
+ * `templateZipUrl`, `cacheDir`) are exported and unit-tested; the IO faces
+ * are thin wrappers around them.
+ *
+ * Spec: docs/03-specs/operations/scaffolding/resolve-template-source.md
+ * (decisions #6 digest = sha256 of zip bytes, #7 NDJSON tag list).
+ */
+const SOURCE = "Scaffold";
+/** v4 channel prefix and naming (ADR-0006 channel isolation). */
+// eslint-disable-next-line no-secrets/no-secrets
+exports.V4_TAG_PREFIX = "templates-v4@";
+exports.ZIP_EXT = ".zip";
+/**
+ * Parse the model-A NDJSON tag list: one `{ version, digest }` object per
+ * line. Blank lines and trailing `\r` are ignored; a malformed line is a hard
+ * error (no silent skip) — spec decision #7.
+ */
+function parseTagList(ndjson) {
+    const entries = [];
+    const lines = ndjson.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].replace(/\r$/, "").trim();
+        if (line.length === 0) {
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            throw new teamsfx_api_1.SystemError({
+                source: SOURCE,
+                name: "TemplateTagListMalformed",
+                message: `Malformed v4 tag-list entry on line ${i + 1}: not valid JSON.`,
+            });
+        }
+        if (!isTagEntry(parsed)) {
+            throw new teamsfx_api_1.SystemError({
+                source: SOURCE,
+                name: "TemplateTagListMalformed",
+                message: `Malformed v4 tag-list entry on line ${i + 1}: missing "version" or "digest".`,
+            });
+        }
+        entries.push({ version: parsed.version, digest: parsed.digest });
+    }
+    return entries;
+}
+function isTagEntry(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const v = value;
+    return typeof v.version === "string" && typeof v.digest === "string";
+}
+/** The download URL for a v4 template package version. */
+function templateZipUrl(baseURL, version) {
+    return `${baseURL}/${exports.V4_TAG_PREFIX}${version}/templates${exports.ZIP_EXT}`;
+}
+/** The on-disk cache directory for the v4 template packages. */
+function cacheDir() {
+    return path.join(os_1.default.homedir(), ".fx", "templates-cache");
+}
+/** The cache file path for one version. */
+function cacheFile(version) {
+    return path.join(cacheDir(), `${exports.V4_TAG_PREFIX}${version}${exports.ZIP_EXT}`);
+}
+/**
+ * Build the production port. `floor` is injected (it comes from the engine's
+ * baked bundled package); this factory does not fabricate it.
+ */
+function createTemplateSourcePort(config, floor) {
+    const memo = new Map();
+    // Warm the in-memory index from disk so `keys()` reflects prior downloads
+    // for the offline `max(cache, floor)` fallback.
+    let warmed = false;
+    const warm = () => {
+        if (warmed) {
+            return;
+        }
+        warmed = true;
+        let names = [];
+        try {
+            names = fs.readdirSync(cacheDir());
+        }
+        catch {
+            return; // EAFP: no cache dir yet → empty index
+        }
+        for (const name of names) {
+            if (!name.startsWith(exports.V4_TAG_PREFIX) || !name.endsWith(exports.ZIP_EXT)) {
+                continue;
+            }
+            const version = name.slice(exports.V4_TAG_PREFIX.length, name.length - exports.ZIP_EXT.length);
+            try {
+                const bytes = fs.readFileSync(path.join(cacheDir(), name));
+                memo.set(version, { digest: (0, templateSource_1.computeDigest)(bytes), bytes });
+            }
+            catch {
+                /* istanbul ignore next -- defensive: a listed cache file vanishing/locked between readdir and read is not reproducible */
+                continue; // a vanished/locked file is simply not indexed
+            }
+        }
+    };
+    return {
+        env: (name) => process.env[name],
+        tagList: async () => {
+            const res = await (0, requestUtils_1.sendRequestWithRetry)(() => axios_1.default.get(config.templatesV4TagListURL, { responseType: "text" }), config.tryLimits);
+            return parseTagList(res.data);
+        },
+        packages: async (version) => {
+            const res = await (0, requestUtils_1.sendRequestWithRetry)(() => axios_1.default.get(templateZipUrl(config.templateDownloadBaseURL, version), {
+                responseType: "arraybuffer",
+            }), config.tryLimits);
+            return Buffer.from(res.data);
+        },
+        cache: {
+            get: (version) => {
+                warm();
+                return memo.get(version);
+            },
+            put: (version, digest, bytes) => {
+                fs.ensureDirSync(cacheDir());
+                fs.writeFileSync(cacheFile(version), bytes);
+                memo.set(version, { digest, bytes });
+            },
+            keys: () => {
+                warm();
+                return [...memo.keys()];
+            },
+        },
+        floor,
+    };
+}
+/**
+ * Load the bytes for an already-resolved {@link TemplateSource}.
+ *
+ * `resolveTemplateSource` decides *which* package a scaffold run uses but
+ * returns only the descriptor; this is the companion IO step that produces the
+ * bytes, the boundary the v3 chokepoint calls before `openTemplatePackage`.
+ *
+ * It never reaches the network: an `online`/`cache` source was already
+ * downloaded, verified, and cached during resolution, so re-downloading here
+ * would defeat the digest-keyed cache and reintroduce the v3 re-fetch churn. A
+ * cache miss is therefore an invariant violation (hard error), not a silent
+ * re-fetch. Every path re-checks the bytes against `source.digest` so
+ * `computeDigest` stays the single integrity authority and a corrupt package is
+ * never handed back.
+ *
+ * Spec: docs/03-specs/operations/scaffolding/resolve-template-source.md
+ */
+function loadResolvedPackage(source, port) {
+    let bytes;
+    if (source.origin === "bundled" || source.origin === "bundled-fallback") {
+        try {
+            bytes = fs.readFileSync(source.location);
+        }
+        catch {
+            return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({
+                source: SOURCE,
+                name: "TemplatePackageUnreadable",
+                message: `The resolved bundled template package at "${source.location}" is missing or unreadable.`,
+            }));
+        }
+    }
+    else {
+        const cached = port.cache.get(source.version);
+        if (cached === undefined) {
+            return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({
+                source: SOURCE,
+                name: "TemplatePackageNotCached",
+                message: `The resolved template package "${source.version}" is not present in the local cache.`,
+            }));
+        }
+        bytes = cached.bytes;
+    }
+    const digest = (0, templateSource_1.computeDigest)(bytes);
+    if (digest !== source.digest) {
+        return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({
+            source: SOURCE,
+            name: "TemplateDigestMismatch",
+            message: `The resolved template package "${source.version}" failed its integrity check: expected ${source.digest}, got ${digest}.`,
+        }));
+    }
+    return (0, neverthrow_1.ok)(bytes);
+}
+//# sourceMappingURL=templateSourcePort.js.map

package/build/v4/distribution/templateSourcePort.js.map

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

package/build/v4/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Public surface of the v4 scaffolding world.
+ *
+ * v4 lives isolated from v3 (see scaffolding.create.proposal.md §5.1). It
+ * imports no v3 symbol; v3 may call into this barrel, but nothing here is
+ * tailored for v3.
+ */
+export * from "./distribution/templateSource";
+export * from "./distribution/templateSourcePort";
+export * from "./distribution/bundledFloor";
+export * from "./distribution/templateConfig";
+export * from "./distribution/templatePackage";
+//# sourceMappingURL=index.d.ts.map

package/build/v4/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v4/index.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC"}

package/build/v4/index.js

@@ -0,0 +1,18 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/**
+ * Public surface of the v4 scaffolding world.
+ *
+ * v4 lives isolated from v3 (see scaffolding.create.proposal.md §5.1). It
+ * imports no v3 symbol; v3 may call into this barrel, but nothing here is
+ * tailored for v3.
+ */
+tslib_1.__exportStar(require("./distribution/templateSource"), exports);
+tslib_1.__exportStar(require("./distribution/templateSourcePort"), exports);
+tslib_1.__exportStar(require("./distribution/bundledFloor"), exports);
+tslib_1.__exportStar(require("./distribution/templateConfig"), exports);
+tslib_1.__exportStar(require("./distribution/templatePackage"), exports);
+//# sourceMappingURL=index.js.map

package/build/v4/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v4/index.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAElC;;;;;;GAMG;AAEH,wEAA8C;AAC9C,4EAAkD;AAClD,sEAA4C;AAC5C,wEAA8C;AAC9C,yEAA+C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microsoft/teamsfx-core",
-  "version": "3.0.13",
+  "version": "3.0.14-alpha.1ba1d62e58.0",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "license": "MIT",
@@ -108,8 +108,8 @@
     "@microsoft/dev-tunnels-contracts": "1.1.9",
     "@microsoft/dev-tunnels-management": "1.1.9",
     "@microsoft/kiota": "1.31.1",
-    "@microsoft/m365-spec-parser": "^0.2.13",
-    "@microsoft/teamsfx-api": "0.23.14",
+    "@microsoft/m365-spec-parser": "^0.2.14-alpha.1ba1d62e58.0",
+    "@microsoft/teamsfx-api": "0.23.15-alpha.1ba1d62e58.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "adm-zip": "^0.5.10",
     "ajv": "^8.18.0",
@@ -233,7 +233,7 @@
     "resource/**/*",
     "templates/**/*"
   ],
-  "gitHead": "9cbd35562278472ec1688d93afa5b87544467468",
+  "gitHead": "c76b6d1ecadc3c30f4e874d78f08befa405c6a97",
   "publishConfig": {
     "access": "public"
   },

package/resource/package.nls.cs.json

@@ -198,6 +198,7 @@
   "error.appstudio.teamsAppUpdateFailed": "Nepovedlo se aktualizovat aplikaci s ID %s na Portálu pro vývojáře. Důvod: %s",
   "error.appstudio.apiFailed": "Nepovedlo se zavolat rozhraní API na vývojářský portál. Podrobnosti najdete v [Output panel](command:fx-extension.showOutputChannel).",
   "error.appstudio.apiFailed.telemetry": "Nejde volat rozhraní API na vývojářský portál: %s, %s, název rozhraní API: %s, X-Correlation-ID: %s.",
+  "error.teamsGraph.apiFailed": "Nepovedlo se provést volání rozhraní API do Teams Graphu. Podrobnosti najdete na [panelu Výstup](command:fx-extension.showOutputChannel).",
   "error.appstudio.apiFailed.reason.common": "Příčinou může být dočasná chyba služby. Zkuste to znovu za několik minut.",
   "error.appstudio.apiFailed.name.common": "Rozhraní API selhalo.",
   "error.appstudio.authServiceApiFailed": "Nepovedlo se zavolat rozhraní API na vývojářský portál: %s, %s, cesta požadavku: %s",
@@ -268,6 +269,7 @@
   "core.generator.officeAddin.importProject.convertProject": "Probíhá převod projektu...",
   "core.generator.officeAddin.importProject.updateManifest": "Upravuje se manifest...",
   "core.generator.officeAddin.importOfficeProject.title": "Import existujícího projektu doplňku pro Office",
+  "core.generator.officeAddin.importProject.manifestOnlyNotSupported": "The selected Office Add-in project at '%s' appears to be a manifest-only project (no 'package.json' was found). Manifest-only projects cannot be imported. Please select a complete Office Add-in project that includes 'package.json' and 'webpack.config.js'.",
   "core.TabOption.description": "Aplikace založená na uživatelském rozhraní",
   "core.TabOption.detail": "Webové stránky s podporou Teams vložené do Microsoft Teams",
   "core.DashboardOption.label": "Řídicí panel",
@@ -849,7 +851,7 @@
   "driver.teamsApp.progressBar.publishTeamsAppStep2.2": "Publikuje se aplikace...",
   "driver.teamsApp.warning.unsupportedCloud": "Přeskakuje se %s, protože požadované rozhraní API Portálu pro vývojáře ještě není v GCC H a DoD k dispozici.",
   "driver.teamsApp.warning.publishUnsupportedCloud": "Přeskakuje se %s, protože požadované rozhraní API Portálu pro vývojáře ještě není v GCC H a DoD k dispozici. Nahrajte ho prosím do Centra pro správu Teams ručně.",
-  "driver.teamsApp.warning.createUnsupportedCloud": "Přeskakuje se %s, protože požadované rozhraní API Portálu pro vývojáře ještě není v GCC H a DoD k dispozici. ID aplikace se vygeneruje místně později.",
+  "driver.teamsApp.warning.createUnsupportedCloud": "Přeskakuje se %s, protože požadované rozhraní API Portálu pro vývojáře ještě není v GCC H a DoD k dispozici. ID aplikace se vygeneruje místně.",
   "driver.teamsApp.progressBar.validateWithTestCases": "Odesílá se žádost o ověření...",
   "driver.teamsApp.progressBar.validateWithTestCases.step": "Žádost o ověření byla odeslána. Stav: %s. Až bude výsledek připraven, budete o tom informováni, případně můžete zkontrolovat všechny záznamy o ověření na [Portálu pro vývojáře](%s).",
   "driver.teamsApp.progressBar.validateWithTestCases.conflict": "Právě probíhá ověřování. Opakujte prosím pokus o ověření později. Toto existující ověření najdete na [Portálu pro vývojáře](%s).",
@@ -1044,6 +1046,12 @@
   "core.oauthScopeQuestion.validation.scope": "Neplatný formát oboru. Zadejte prosím platný obor. Příklad: obor1: popis pro obor1; obor2: popis pro obor2",
   "core.authNameQuestion.validation.empty": "Název ověřování nemůže být prázdný.",
   "driver.oauth.microsoftEntraWarning": "Pokud používáte vlastní aplikaci Microsoft Entra, prosím: 1. Aktualizujte identifikátor URI ID aplikace Microsoft Entra na %s, 2. Pokud chcete přesměrovat identifikátor URI aplikace Microsoft Entra, přidejte %s.",
+  "driver.dcr.description.create": "Vytvořte konfiguraci dynamické registrace klienta (DCR) na vývojářském portálu pro ověřování serveru MCP.",
+  "driver.dcr.title.create": "Vytváří se konfigurace DCR...",
+  "driver.dcr.log.skipCreateDcr": "Proměnná prostředí %s existuje. Umožňuje přeskočit vytváření konfigurace DCR.",
+  "driver.dcr.log.successCreateDcr": "Konfigurace DCR byla úspěšně vytvořena s ID %s.",
+  "driver.dcr.error.nameTooLong": "Název konfigurace DCR je příliš dlouhý. Maximální délka je 128 znaků.",
+  "driver.dcr.error.wellKnownInvalid": "Adresa URL wellKnownAuthorizationServer je neplatná. Zadejte platnou adresu URL protokolu HTTPS pro dokument metadat RFC 8414 autorizačního serveru.",
   "core.addKnowledgeQuestion.webContent.title": "Webový obsah",
   "core.addKnowledgeQuestion.webContent.placeholder": "Zadejte absolutní adresu URL webu, na kterém se má vyhledávat obsah.",
   "core.addKnowledgeQuestion.invalidWebContent.message": "Neplatný webový obsah. Zadejte prosím platnou adresu URL.",