@microsoft/teamsfx-core 3.1.0 → 3.1.1

package/build/v4/distribution/packageDir.js

@@ -0,0 +1,101 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadPackageDir = loadPackageDir;
+const tslib_1 = require("tslib");
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const fs = tslib_1.__importStar(require("fs-extra"));
+const path = tslib_1.__importStar(require("path"));
+const neverthrow_1 = require("neverthrow");
+/** Load a declarative package from an authored directory. See open-template-package spec. */
+const SOURCE = "Scaffold";
+/** Read + parse one top-level package JSON file (EAFP: read, don't stat first). */
+function readPackageJson(dir, file) {
+    let raw;
+    try {
+        raw = fs.readFileSync(path.join(dir, file), "utf8");
+    }
+    catch {
+        return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({
+            source: SOURCE,
+            name: "PackageFileMissing",
+            message: `The template package is missing "${file}".`,
+        }));
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        return (0, neverthrow_1.ok)(parsed);
+    }
+    catch {
+        return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({
+            source: SOURCE,
+            name: "PackageFileInvalid",
+            message: `The template package file "${file}" is not valid JSON.`,
+        }));
+    }
+}
+/** Recurse `content/**` into raw, forward-slash-pathed entries rooted at `root`. */
+function walkContent(root, dir, out) {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            walkContent(root, full, out);
+        }
+        else {
+            out.push({
+                path: path.relative(root, full).replace(/\\/g, "/"),
+                data: fs.readFileSync(full),
+            });
+        }
+    }
+}
+/** Load optional `content/**` as deterministically ordered raw entries. */
+function loadContent(contentRoot) {
+    const entries = [];
+    try {
+        walkContent(contentRoot, contentRoot, entries);
+    }
+    catch (error) {
+        if (isMissingContentRoot(error, contentRoot)) {
+            return (0, neverthrow_1.ok)([]);
+        }
+        return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({
+            source: SOURCE,
+            name: "PackageContentReadFailed",
+            message: `The template package's "content" directory could not be read.`,
+        }));
+    }
+    entries.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+    return (0, neverthrow_1.ok)(entries);
+}
+function hasCodeAndPath(error) {
+    return typeof error === "object" && error !== null && "code" in error;
+}
+function isMissingContentRoot(error, contentRoot) {
+    if (!hasCodeAndPath(error) || error.code !== "ENOENT" || typeof error.path !== "string") {
+        return false;
+    }
+    return path.resolve(error.path) === path.resolve(contentRoot);
+}
+/** Load a declarative template package from its authored directory. */
+function loadPackageDir(dir) {
+    const descriptor = readPackageJson(dir, "descriptor.json");
+    if (descriptor.isErr()) {
+        return (0, neverthrow_1.err)(descriptor.error);
+    }
+    const pipeline = readPackageJson(dir, "pipeline.json");
+    if (pipeline.isErr()) {
+        return (0, neverthrow_1.err)(pipeline.error);
+    }
+    const content = loadContent(path.join(dir, "content"));
+    if (content.isErr()) {
+        return (0, neverthrow_1.err)(content.error);
+    }
+    return (0, neverthrow_1.ok)({
+        descriptor: descriptor.value,
+        pipeline: pipeline.value,
+        content: content.value,
+    });
+}
+//# sourceMappingURL=packageDir.js.map

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

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

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

@@ -0,0 +1,11 @@
+import { FxError } from "@microsoft/teamsfx-api";
+import AdmZip from "adm-zip";
+import { Result } from "neverthrow";
+import { QuestionSpec } from "../collectInputs/collectInputs";
+/** Read one fragment's raw JSON by name; the reader owns the source (zip / disk). */
+export type FragmentReader = (name: string) => Result<unknown, FxError>;
+/** Resolve a `{ questions: [...] }` object into a flat `QuestionSpec[]`, expanding fragments. */
+export declare function resolveQuestions(raw: unknown, file: string, read: FragmentReader): Result<QuestionSpec[], FxError>;
+/** A `FragmentReader` over an open channel zip. */
+export declare function zipFragmentReader(zip: AdmZip): FragmentReader;
+//# sourceMappingURL=questionFragments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"questionFragments.d.ts","sourceRoot":"","sources":["../../../src/v4/distribution/questionFragments.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAe,MAAM,wBAAwB,CAAC;AAC9D,OAAO,MAAM,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAW,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAgD9D,qFAAqF;AACrF,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AA6DxE,iGAAiG;AACjG,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,GACnB,MAAM,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,CAKjC;AAED,mDAAmD;AACnD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CA6B7D"}

package/build/v4/distribution/questionFragments.js

@@ -0,0 +1,130 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveQuestions = resolveQuestions;
+exports.zipFragmentReader = zipFragmentReader;
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const neverthrow_1 = require("neverthrow");
+/**
+ * Resolve shared question fragments. A `questions` array may contain
+ * `{ "use": "<name>" }` entries that reference a reusable fragment under
+ * `v4/_shared/questions/<name>.json`; the loader splices the fragment's own
+ * `questions` in place (recursively) so `collect-inputs` always sees one flat
+ * `QuestionSpec[]`. See open-template-package + collect-create-inputs specs.
+ */
+const SOURCE = "Scaffold";
+/** Channel path prefix under which shared question fragments live. */
+const FRAGMENT_DIR = "v4/_shared/questions/";
+/** A fragment name is a bare identifier — no path separators (Zip-Slip guard). */
+const FRAGMENT_NAME = /^[A-Za-z][A-Za-z0-9-]*$/;
+/** The native question kinds a `questions.json` (or fragment) may declare. */
+const QUESTION_TYPES = new Set([
+    "singleSelect",
+    "multiSelect",
+    "text",
+    "confirm",
+    "singleFile",
+    "folder",
+    "singleFileOrText",
+]);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** A single native question, narrowed without an unchecked cast. */
+function isQuestionSpec(value) {
+    return (isRecord(value) &&
+        typeof value.name === "string" &&
+        typeof value.type === "string" &&
+        QUESTION_TYPES.has(value.type));
+}
+/** A `{ "use": "<name>" }` fragment reference (no `name`, which marks a question). */
+function isUseRef(value) {
+    return isRecord(value) && typeof value.use === "string" && !("name" in value);
+}
+function invalidQuestionsFile(file) {
+    return new teamsfx_api_1.SystemError({
+        source: SOURCE,
+        name: "PackageFileInvalid",
+        message: `The template package file "${file}" must be an object with a "questions" array.`,
+    });
+}
+/** Resolve one questions array, splicing any `{ "use" }` fragments in place. */
+function resolveArray(items, read, file, seen) {
+    const out = [];
+    for (const item of items) {
+        if (isUseRef(item)) {
+            const name = item.use;
+            if (!FRAGMENT_NAME.test(name)) {
+                return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({
+                    source: SOURCE,
+                    name: "QuestionFragmentInvalidName",
+                    message: `Question fragment reference "${name}" in "${file}" is not a bare name.`,
+                }));
+            }
+            if (seen.has(name)) {
+                return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({
+                    source: SOURCE,
+                    name: "QuestionFragmentCycle",
+                    message: `Question fragment "${name}" forms a cycle (referenced from "${file}").`,
+                }));
+            }
+            const raw = read(name);
+            if (raw.isErr()) {
+                return (0, neverthrow_1.err)(raw.error);
+            }
+            const fragFile = `${FRAGMENT_DIR}${name}.json`;
+            if (!isRecord(raw.value) || !Array.isArray(raw.value.questions)) {
+                return (0, neverthrow_1.err)(invalidQuestionsFile(fragFile));
+            }
+            const nested = resolveArray(raw.value.questions, read, fragFile, new Set([...seen, name]));
+            if (nested.isErr()) {
+                return (0, neverthrow_1.err)(nested.error);
+            }
+            out.push(...nested.value);
+        }
+        else if (isQuestionSpec(item)) {
+            out.push(item);
+        }
+        else {
+            return (0, neverthrow_1.err)(invalidQuestionsFile(file));
+        }
+    }
+    return (0, neverthrow_1.ok)(out);
+}
+/** Resolve a `{ questions: [...] }` object into a flat `QuestionSpec[]`, expanding fragments. */
+function resolveQuestions(raw, file, read) {
+    if (!isRecord(raw) || !Array.isArray(raw.questions)) {
+        return (0, neverthrow_1.err)(invalidQuestionsFile(file));
+    }
+    return resolveArray(raw.questions, read, file, new Set());
+}
+/** A `FragmentReader` over an open channel zip. */
+function zipFragmentReader(zip) {
+    return (name) => {
+        const target = `${FRAGMENT_DIR}${name}.json`;
+        for (const entry of zip.getEntries()) {
+            if (entry.isDirectory) {
+                continue;
+            }
+            if (entry.entryName.replace(/\\/g, "/") === target) {
+                try {
+                    return (0, neverthrow_1.ok)(JSON.parse(entry.getData().toString("utf8")));
+                }
+                catch {
+                    return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({
+                        source: SOURCE,
+                        name: "PackageFileInvalid",
+                        message: `The template package file "${target}" is not valid JSON.`,
+                    }));
+                }
+            }
+        }
+        return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({
+            source: SOURCE,
+            name: "PackageFileMissing",
+            message: `The template package is missing question fragment "${target}".`,
+        }));
+    };
+}
+//# sourceMappingURL=questionFragments.js.map

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

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

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

@@ -0,0 +1,61 @@
+import { FxError } from "@microsoft/teamsfx-api";
+import { Result } from "neverthrow";
+import { TemplateSource, computeDigest } from "./templateSource";
+export type TemplateArtifactKind = "create-selector" | "modify-selector" | "metadata" | "templates";
+export type TemplateArtifactOrigin = "bundled" | "online" | "cache" | "bundled-fallback";
+export interface TemplateArtifactRef {
+    kind: TemplateArtifactKind;
+    file: string;
+    digest: string;
+}
+export interface V4TemplateTagEntry {
+    version: string;
+    artifacts: Record<TemplateArtifactKind, TemplateArtifactRef>;
+}
+export interface CachedTemplateArtifact {
+    digest: string;
+    bytes: Buffer;
+}
+export interface BundledTemplateArtifacts {
+    version: string;
+    artifacts: Record<TemplateArtifactKind, TemplateArtifactRef>;
+    locations: Record<TemplateArtifactKind, string>;
+}
+export interface TemplateArtifactPort {
+    env(name: string): string | undefined;
+    tagList(): Promise<V4TemplateTagEntry[]>;
+    download(version: string, ref: TemplateArtifactRef): Promise<Buffer>;
+    cache: {
+        get(version: string, kind: TemplateArtifactKind): CachedTemplateArtifact | undefined;
+        put(version: string, kind: TemplateArtifactKind, digest: string, bytes: Buffer): void;
+        keys(kind: TemplateArtifactKind): string[];
+        delete(version: string, kind: TemplateArtifactKind): void;
+    };
+    bundled: BundledTemplateArtifacts;
+}
+export interface TemplateArtifactSnapshot {
+    version: string;
+    origin: TemplateArtifactOrigin;
+    artifacts: Record<TemplateArtifactKind, TemplateArtifactRef>;
+    bytes(kind: TemplateArtifactKind): Promise<Result<Buffer, FxError>>;
+}
+export interface ResolveTemplateArtifactSnapshotInput {
+    range: string;
+    bundled: boolean;
+    requiredKind: TemplateArtifactKind;
+    port: TemplateArtifactPort;
+}
+export interface TemplateArtifactChannelConfig {
+    templatesV4TagListURL: string;
+    templateDownloadBaseURL: string;
+    tryLimits: number;
+}
+export declare const computeArtifactDigest: typeof computeDigest;
+export declare function templateSourceFromArtifactSnapshot(snapshot: TemplateArtifactSnapshot): TemplateSource;
+export declare function artifactUrl(baseURL: string, version: string, ref: TemplateArtifactRef): string;
+export declare function artifactCacheFile(version: string, kind: TemplateArtifactKind): string;
+export declare function parseArtifactTagList(ndjson: string): V4TemplateTagEntry[];
+export declare function resolveTemplateArtifactSnapshot(input: ResolveTemplateArtifactSnapshotInput): Promise<Result<TemplateArtifactSnapshot, FxError>>;
+export declare function artifactFileName(kind: TemplateArtifactKind): string;
+export declare function createTemplateArtifactPort(config: TemplateArtifactChannelConfig, bundled: BundledTemplateArtifacts): TemplateArtifactPort;
+//# sourceMappingURL=templateArtifacts.d.ts.map

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

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