@microsoft/teamsfx-core 3.1.0 → 3.1.1

package/build/v4/distribution/templatePackage.js

@@ -0,0 +1,63 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openTemplatePackage = openTemplatePackage;
+const tslib_1 = require("tslib");
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const adm_zip_1 = tslib_1.__importDefault(require("adm-zip"));
+const neverthrow_1 = require("neverthrow");
+/** Open resolved package bytes for one template. See open-template-package spec. */
+const SOURCE = "Scaffold";
+/** The `<language>/<scenario>/` prefix this locator resolves to (trailing slash = boundary). */
+function locatorPrefix(locator) {
+    return `${locator.language}/${locator.scenario}/`;
+}
+/** Zip-Slip guard for stripped entry paths. */
+function isSafeRelativePath(rel) {
+    return rel.split("/").every((seg) => seg.length > 0 && seg !== "." && seg !== "..");
+}
+/** Open the resolved package and return located file entries. */
+function openTemplatePackage(bytes, locator) {
+    let zip;
+    try {
+        zip = new adm_zip_1.default(bytes);
+    }
+    catch {
+        return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({
+            source: SOURCE,
+            name: "TemplatePackageCorrupt",
+            message: "The resolved template package is not a valid archive.",
+        }));
+    }
+    const prefix = locatorPrefix(locator);
+    const entries = [];
+    for (const entry of zip.getEntries()) {
+        if (entry.isDirectory) {
+            continue;
+        }
+        const name = entry.entryName.replace(/\\/g, "/");
+        if (!name.startsWith(prefix)) {
+            continue;
+        }
+        const rel = name.slice(prefix.length);
+        if (!isSafeRelativePath(rel)) {
+            return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({
+                source: SOURCE,
+                name: "TemplatePackageUnsafePath",
+                message: `The resolved template package contains an unsafe entry path: "${entry.entryName}".`,
+            }));
+        }
+        entries.push({ path: rel, data: entry.getData() });
+    }
+    if (entries.length === 0) {
+        return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({
+            source: SOURCE,
+            name: "TemplateNotFoundInPackage",
+            message: `Template "${prefix}" was not found in the resolved package.`,
+        }));
+    }
+    entries.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+    return (0, neverthrow_1.ok)(entries);
+}
+//# sourceMappingURL=templatePackage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templatePackage.js","sourceRoot":"","sources":["../../../src/v4/distribution/templatePackage.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;AAsBlC,kDAoDC;;AAxED,wDAA8D;AAC9D,8DAA6B;AAC7B,2CAA6C;AAG7C,oFAAoF;AAEpF,MAAM,MAAM,GAAG,UAAU,CAAC;AAE1B,gGAAgG;AAChG,SAAS,aAAa,CAAC,OAAwB;IAC7C,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC;AACpD,CAAC;AAED,+CAA+C;AAC/C,SAAS,kBAAkB,CAAC,GAAW;IACrC,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC;AACtF,CAAC;AAED,iEAAiE;AACjE,SAAgB,mBAAmB,CACjC,KAAa,EACb,OAAwB;IAExB,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,iBAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAA,gBAAG,EACR,IAAI,yBAAW,CAAC;YACd,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,wBAAwB;YAC9B,OAAO,EAAE,uDAAuD;SACjE,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,OAAO,GAAwB,EAAE,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAA,gBAAG,EACR,IAAI,yBAAW,CAAC;gBACd,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,2BAA2B;gBACjC,OAAO,EAAE,iEAAiE,KAAK,CAAC,SAAS,IAAI;aAC9F,CAAC,CACH,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAA,gBAAG,EACR,IAAI,yBAAW,CAAC;YACd,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,2BAA2B;YACjC,OAAO,EAAE,aAAa,MAAM,0CAA0C;SACvE,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,OAAO,IAAA,eAAE,EAAC,OAAO,CAAC,CAAC;AACrB,CAAC"}

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

@@ -0,0 +1,66 @@
+import { FxError } from "@microsoft/teamsfx-api";
+import { Result } from "neverthrow";
+/** Where the resolved template-package bytes come from. */
+export type TemplateOrigin = "bundled" | "online" | "cache" | "bundled-fallback";
+/** A channel-published version paired with its expected content digest. */
+export interface TagEntry {
+    version: string;
+    digest: string;
+}
+/** A cached template package: its content digest and the bytes themselves. */
+export interface CachedPackage {
+    digest: string;
+    bytes: Buffer;
+}
+/** The bundled floor baked into the engine binary. */
+export interface BundledFloor {
+    version: string;
+    digest: string;
+    location: string;
+}
+/** Narrow template-source port. */
+export interface TemplateSourcePort {
+    /** Read an environment variable (e.g. `TEMPLATE_VERSION`). */
+    env(name: string): string | undefined;
+    /** The channel's published `{ version, digest }` entries. */
+    tagList(): Promise<TagEntry[]>;
+    /** Download a package's bytes for a version. */
+    packages(version: string, expectedDigest: string): Promise<Buffer>;
+    /** The local digest-keyed package cache. */
+    cache: {
+        get(version: string): CachedPackage | undefined;
+        put(version: string, digest: string, bytes: Buffer): void;
+        keys(): string[];
+    };
+    /** The bundled floor baked into the engine. */
+    floor: BundledFloor;
+}
+/** The single resolved source a scaffold run will use. */
+export interface TemplateSource {
+    origin: TemplateOrigin;
+    version: string;
+    digest: string;
+    location: string;
+    /** Set when the resolved source diverged from the intended online source. */
+    warning?: string;
+}
+export interface ResolveTemplateSourceInput {
+    /** SemVer range the build is permitted to resolve within. */
+    range: string;
+    /** `true` for bundled floor resolution; `false` for release-channel resolution. */
+    bundled: boolean;
+    port: TemplateSourcePort;
+}
+/** Inputs for the no-network local-first resolver. */
+export interface ResolveLocalTemplateSourceInput {
+    /** SemVer range the build is permitted to resolve within. */
+    range: string;
+    port: TemplateSourcePort;
+}
+/** sha256 content hash of a package's bytes, prefixed `sha256:`. */
+export declare function computeDigest(bytes: Buffer): string;
+/** Resolve to exactly one `TemplateSource` before any template is read. */
+export declare function resolveTemplateSource(input: ResolveTemplateSourceInput): Promise<Result<TemplateSource, FxError>>;
+/** Resolve a local source without touching the network. */
+export declare function resolveLocalTemplateSource(input: ResolveLocalTemplateSourceInput): TemplateSource;
+//# sourceMappingURL=templateSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templateSource.d.ts","sourceRoot":"","sources":["../../../src/v4/distribution/templateSource.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAA0B,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,MAAM,EAAW,MAAM,YAAY,CAAC;AAQ7C,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,kBAAkB,CAAC;AAEjF,2EAA2E;AAC3E,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACtC,6DAA6D;IAC7D,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnE,4CAA4C;IAC5C,KAAK,EAAE;QACL,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;QAChD,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1D,IAAI,IAAI,MAAM,EAAE,CAAC;KAClB,CAAC;IACF,+CAA+C;IAC/C,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,sDAAsD;AACtD,MAAM,WAAW,+BAA+B;IAC9C,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,2EAA2E;AAC3E,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAc1C;AAED,2DAA2D;AAC3D,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,+BAA+B,GAAG,cAAc,CAoBjG"}

package/build/v4/distribution/templateSource.js

@@ -0,0 +1,233 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeDigest = computeDigest;
+exports.resolveTemplateSource = resolveTemplateSource;
+exports.resolveLocalTemplateSource = resolveLocalTemplateSource;
+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"));
+/** v4 template-distribution resolution. See resolve-template-source spec and ADR-0006. */
+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 to exactly one `TemplateSource` before any template is read. */
+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));
+    }
+    if (templateVersion) {
+        return pinnedOnline(templateVersion, port);
+    }
+    if (bundled) {
+        return (0, neverthrow_1.ok)(floorSource(port.floor));
+    }
+    return resolveOnline(range, port);
+}
+/** Resolve a local source without touching the network. */
+function resolveLocalTemplateSource(input) {
+    const { range, port } = input;
+    if (port.env("TEMPLATE_VERSION") === "local") {
+        return floorSource(port.floor);
+    }
+    const highestCached = highestCachedAboveFloor(range, port);
+    if (highestCached) {
+        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),
+            };
+        }
+    }
+    return floorSource(port.floor);
+}
+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; keep channel failures inside the Result 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) {
+        // Malformed channel data is a hard error; only reachability failures fall back.
+        if (isMalformedTagList(e)) {
+            return (0, neverthrow_1.err)(e);
+        }
+        return (0, neverthrow_1.ok)(offlineFallback(range, port));
+    }
+    const picked = semver_1.default.maxSatisfying(tags.map((t) => t.version), range);
+    if (!picked) {
+        // Reachable channel with no satisfying version is a compatibility problem.
+        if (semver_1.default.satisfies(port.floor.version, range)) {
+            return (0, neverthrow_1.ok)(floorFallback(port.floor));
+        }
+        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.`,
+        }));
+    }
+    if (picked === port.floor.version) {
+        return (0, neverthrow_1.ok)(floorSource(port.floor));
+    }
+    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");
+}
+/** Malformed channel tag-lists are hard errors, distinct from unreachable channels. */
+function isMalformedTagList(e) {
+    return e instanceof teamsfx_api_1.SystemError && e.name === "TemplateTagListMalformed";
+}
+/** Preserve an existing FxError; wrap other tag-list failures as SystemError. */
+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 other download failures as SystemError. */
+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),
+        });
+    }
+    let bytes;
+    try {
+        bytes = await port.packages(entry.version, entry.digest);
+    }
+    catch (e) {
+        // Keep download rejections inside the Result 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}.`,
+        }));
+    }
+    port.cache.put(entry.version, entry.digest, bytes);
+    return (0, neverthrow_1.ok)({
+        origin,
+        version: entry.version,
+        digest: entry.digest,
+        location: cacheLocation(entry.version),
+    });
+}
+/** Highest cached version satisfying `range` that strictly beats the floor. */
+function highestCachedAboveFloor(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);
+    if (highestCached && (!floorSatisfies || semver_1.default.gt(highestCached, port.floor.version))) {
+        return highestCached;
+    }
+    return undefined;
+}
+/** Reached when the channel is unreachable. */
+function offlineFallback(range, port) {
+    const highestCached = highestCachedAboveFloor(range, port);
+    if (highestCached) {
+        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),
+            };
+        }
+    }
+    return { ...floorFallback(port.floor), warning: offlineWarning(range) };
+}
+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,27 @@
+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 NDJSON tag list; malformed nonblank lines are hard errors. */
+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; the bundled floor is injected. */
+export declare function createTemplateSourcePort(config: TemplateChannelConfig, floor: BundledFloor): TemplateSourcePort;
+/** Load bytes for an already-resolved source; never re-download here. */
+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;AAM1B,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,2EAA2E;AAC3E,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,gEAAgE;AAChE,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,YAAY,GAClB,kBAAkB,CAuEpB;AAED,yEAAyE;AACzE,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,175 @@
+"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 {@link TemplateSourcePort}. See resolve-template-source spec. */
+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 NDJSON tag list; malformed nonblank lines are hard errors. */
+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; the bundled floor is injected. */
+function createTemplateSourcePort(config, floor) {
+    const memo = new Map();
+    // Warm disk cache once so offline resolution sees prior downloads.
+    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 bytes for an already-resolved source; never re-download here. */
+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/engineVersion.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Version of the v4 engine capability set implemented by this source tree.
+ * It is independent of template artifact versions, which may advance without an engine release.
+ * Raise it when a new named step, provider, validator, or other template-visible capability ships.
+ */
+export declare const CURRENT_V4_ENGINE_VERSION = "6.11.0";
+//# sourceMappingURL=engineVersion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engineVersion.d.ts","sourceRoot":"","sources":["../../src/v4/engineVersion.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,WAAW,CAAC"}

package/build/v4/engineVersion.js

@@ -0,0 +1,12 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CURRENT_V4_ENGINE_VERSION = void 0;
+/**
+ * Version of the v4 engine capability set implemented by this source tree.
+ * It is independent of template artifact versions, which may advance without an engine release.
+ * Raise it when a new named step, provider, validator, or other template-visible capability ships.
+ */
+exports.CURRENT_V4_ENGINE_VERSION = "6.11.0";
+//# sourceMappingURL=engineVersion.js.map

package/build/v4/engineVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engineVersion.js","sourceRoot":"","sources":["../../src/v4/engineVersion.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAElC;;;;GAIG;AACU,QAAA,yBAAyB,GAAG,QAAQ,CAAC"}