@microsoft/teamsfx-core 3.0.13 → 3.0.14-alpha.0890e15c35.0

package/build/v4/distribution/templateConfig.js

@@ -0,0 +1,81 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeBundled = computeBundled;
+exports.computeV4PublishVersion = computeV4PublishVersion;
+exports.computeRange = computeRange;
+exports.computeV4TemplateConfig = computeV4TemplateConfig;
+const tslib_1 = require("tslib");
+const semver = tslib_1.__importStar(require("semver"));
+/**
+ * `bundled` decides whether a build resolves from the bundled floor
+ * (offline-by-default) or the online release channel: it is simply the negation
+ * of `goproduct`. A build that is NOT shipping to users (internal / daily test
+ * builds) resolves from the bundled floor; a shipping build resolves online.
+ *
+ * A prerelease-SUFFIXED minted version does NOT force bundling: a shipping
+ * prerelease (odd-minor preview, `goproduct=true`) is published online under a
+ * clean, suffix-free version computed by `computeV4PublishVersion` so a
+ * `~major.minor` range can resolve it.
+ */
+function computeBundled(goproduct) {
+    return !goproduct;
+}
+/**
+ * The clean, suffix-free version published to the v4 channel for a minted
+ * version, derived purely from the minted version's odd/even minor:
+ *
+ *   - ODD minor  (prerelease line, e.g. `6.11.x`): the build date stamped into
+ *     the patch (`6.11.<YYYYMMDDHH>`). The date is read from the `-beta.<date>`
+ *     preid the preview lane mints, so every preview build gets a unique,
+ *     suffix-free version that satisfies `~major.minor`. Falls back to the raw
+ *     patch when no date stamp is present.
+ *   - EVEN minor (stable line, e.g. `6.10.x`): `major.minor.patch` as-is; the
+ *     stable lane already mints a clean version.
+ *
+ * This is the v4-channel counterpart of the clean `templates@<major>.<minor>.<date>`
+ * pattern the v3 channel uses for prereleases. Refusing to publish an
+ * even-minor SUFFIXED version (a preview lane minted on a stable branch) is
+ * enforced at publish time, not here, so non-shipping test builds keep working.
+ */
+function computeV4PublishVersion(version) {
+    const parsed = semver.parse(version);
+    if (parsed === null) {
+        throw new Error(`Cannot compute v4 publish version: "${version}" is not valid SemVer.`);
+    }
+    if (parsed.minor % 2 === 1) {
+        const dateStamp = parsed.prerelease.find((segment) => typeof segment === "number" && segment >= 1_000_000_000);
+        if (dateStamp !== undefined) {
+            return `${parsed.major}.${parsed.minor}.${dateStamp}`;
+        }
+    }
+    return `${parsed.major}.${parsed.minor}.${parsed.patch}`;
+}
+/**
+ * The range a build may resolve within: `~major.minor` of the minted version.
+ * v4 templates use an odd/even-minor split — odd-minor prereleases (`6.11.x`)
+ * and even-minor stables (`6.10.x`) live on different minors, so their ranges
+ * are naturally isolated. The range is only widened when the minted version no
+ * longer intersects the previous range; otherwise it is kept stable for
+ * reproducibility.
+ */
+function computeRange(version, previousRange) {
+    const parsed = semver.parse(version);
+    if (parsed === null) {
+        throw new Error(`Cannot compute v4 template range: "${version}" is not valid SemVer.`);
+    }
+    if (semver.intersects(previousRange, `${parsed.major}.${parsed.minor}.0`)) {
+        return previousRange;
+    }
+    return `~${parsed.major}.${parsed.minor}`;
+}
+/** Compute the full v4 distribution config block for `templates-config.json`. */
+function computeV4TemplateConfig(input) {
+    return {
+        range: computeRange(input.version, input.previousRange),
+        bundled: computeBundled(input.goproduct),
+        localVersion: computeV4PublishVersion(input.version),
+    };
+}
+//# sourceMappingURL=templateConfig.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templateConfig.js","sourceRoot":"","sources":["../../../src/v4/distribution/templateConfig.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;AAuDlC,wCAEC;AAmBD,0DAcC;AAUD,oCASC;AAGD,0DAMC;;AApHD,uDAAiC;AA0CjC;;;;;;;;;;GAUG;AACH,SAAgB,cAAc,CAAC,SAAkB;IAC/C,OAAO,CAAC,SAAS,CAAC;AACpB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,uBAAuB,CAAC,OAAe;IACrD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,uCAAuC,OAAO,wBAAwB,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CACtC,CAAC,OAAO,EAAqB,EAAE,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,IAAI,aAAa,CACxF,CAAC;QACF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;QACxD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,YAAY,CAAC,OAAe,EAAE,aAAqB;IACjE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,wBAAwB,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,CAAC,aAAa,EAAE,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1E,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,iFAAiF;AACjF,SAAgB,uBAAuB,CAAC,KAA4B;IAClE,OAAO;QACL,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC;QACvD,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC;QACxC,YAAY,EAAE,uBAAuB,CAAC,KAAK,CAAC,OAAO,CAAC;KACrD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,29 @@
+import { FxError } from "@microsoft/teamsfx-api";
+import { Result } from "neverthrow";
+/**
+ * Names which template inside the package to open. The boundary
+ * (open → locate → hand back entries) is permanent; this locator shape is
+ * transitional — `{ language, scenario }` matches the package's current
+ * `<language>/<scenario>/` layout and becomes `{ templateId }` when the
+ * proposal §3 authoring layout ships. Only the resolved prefix changes; the
+ * open/entry contract and every AC hold (INV-1).
+ */
+export interface TemplateLocator {
+    language: string;
+    scenario: string;
+}
+/** One file from the located template, rooted at the template's content. */
+export interface TemplateFileEntry {
+    /** Path relative to the located template's content root, forward-slash normalized. */
+    path: string;
+    /** The file's raw bytes, verbatim — unrendered, `.tpl` suffix intact. */
+    data: Buffer;
+}
+/**
+ * Open the resolved template package and return the located template's file
+ * entries, the locator prefix stripped. Pure function of `(bytes, locator)`:
+ * no fs, no network, no render. Returns `Result` per the toolkit-wide
+ * neverthrow rule rather than throwing.
+ */
+export declare function openTemplatePackage(bytes: Buffer, locator: TemplateLocator): Result<TemplateFileEntry[], FxError>;
+//# sourceMappingURL=templatePackage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templatePackage.d.ts","sourceRoot":"","sources":["../../../src/v4/distribution/templatePackage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAe,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,MAAM,EAAW,MAAM,YAAY,CAAC;AAe7C;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;CACd;AAiBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,GACvB,MAAM,CAAC,iBAAiB,EAAE,EAAE,OAAO,CAAC,CAiDtC"}

package/build/v4/distribution/templatePackage.js

@@ -0,0 +1,82 @@
+"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");
+/**
+ * The v4 template-package consume operation: open resolved package bytes and
+ * return one template's file entries, the locator prefix stripped, unrendered.
+ *
+ * Spec: docs/03-specs/operations/scaffolding/open-template-package.md
+ * Upstream: docs/03-specs/operations/scaffolding/resolve-template-source.md
+ *
+ * This module is part of the v4 world. It imports no v3 symbol; v3 code may
+ * call `openTemplatePackage`, but nothing here is tailored for v3.
+ */
+const SOURCE = "Scaffold";
+/** The `<language>/<scenario>/` prefix this locator resolves to (trailing slash = boundary). */
+function locatorPrefix(locator) {
+    return `${locator.language}/${locator.scenario}/`;
+}
+/**
+ * Reject a stripped entry path whose segments are empty / `.` / `..` (Zip-Slip
+ * guard, INV-8). A digest check proves the bytes equal what was published, not
+ * that the published archive is free of traversal entries; the renderer writes
+ * these paths to disk, so containment is enforced here.
+ */
+function isSafeRelativePath(rel) {
+    return rel.split("/").every((seg) => seg.length > 0 && seg !== "." && seg !== "..");
+}
+/**
+ * Open the resolved template package and return the located template's file
+ * entries, the locator prefix stripped. Pure function of `(bytes, locator)`:
+ * no fs, no network, no render. Returns `Result` per the toolkit-wide
+ * neverthrow rule rather than throwing.
+ */
+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; // INV-6 — directory entries excluded
+        }
+        const name = entry.entryName.replace(/\\/g, "/");
+        if (!name.startsWith(prefix)) {
+            continue; // INV-1 — trailing-slash prefix boundary; "da/" never matches "da-basic/"
+        }
+        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}".`,
+            })); // INV-8 — Zip-Slip guard: reject empty / "." / ".." path segments
+        }
+        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)); // INV-5 — deterministic order
+    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;;AA6DlC,kDAoDC;;AA/GD,wDAA8D;AAC9D,8DAA6B;AAC7B,2CAA6C;AAE7C;;;;;;;;;GASG;AAEH,MAAM,MAAM,GAAG,UAAU,CAAC;AAuB1B,gGAAgG;AAChG,SAAS,aAAa,CAAC,OAAwB;IAC7C,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,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;;;;;GAKG;AACH,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,CAAC,qCAAqC;QACjD,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,CAAC,0EAA0E;QACtF,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,CAAC,kEAAkE;QACvE,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,CAAC,8BAA8B;IACxG,OAAO,IAAA,eAAE,EAAC,OAAO,CAAC,CAAC;AACrB,CAAC"}

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

@@ -0,0 +1,67 @@
+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 single channel-published version paired with its expected content digest (model A). */
+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;
+}
+/**
+ * The narrow port `resolveTemplateSource` depends on (interface-segregation).
+ * The full `ScaffoldRuntime` composes this later; this operation never reaches
+ * for faces it does not use.
+ */
+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 (verified against `expectedDigest` by the caller). */
+    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 (observable, never silent). */
+    warning?: string;
+}
+export interface ResolveTemplateSourceInput {
+    /** SemVer range the build is permitted to resolve within. */
+    range: string;
+    /** `true` for test/offline/daily builds (bundled floor); `false` for shipped builds (release channel). */
+    bundled: boolean;
+    port: TemplateSourcePort;
+}
+/** sha256 content hash of a package's bytes, prefixed `sha256:`. */
+export declare function computeDigest(bytes: Buffer): string;
+/**
+ * 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.
+ */
+export declare function resolveTemplateSource(input: ResolveTemplateSourceInput): Promise<Result<TemplateSource, FxError>>;
+//# 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;AAgB7C,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,kBAAkB,CAAC;AAEjF,4FAA4F;AAC5F,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;;;;GAIG;AACH,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,kGAAkG;IAClG,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,wGAAwG;IACxG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,0GAA0G;IAC1G,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAc1C"}

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"}