@microsoft/m365-spec-parser 0.2.6-beta.2025022507.0 → 0.2.6-rc.0

package/dist/index.esm2017.mjs

@@ -47,6 +47,7 @@ var ErrorType;
     ErrorType["UrlPathNotExist"] = "url-path-not-exist";
     ErrorType["Cancelled"] = "cancelled";
     ErrorType["Unknown"] = "unknown";
+    ErrorType["AddAuthFailed"] = "add-auth-failed";
 })(ErrorType || (ErrorType = {}));
 /**
  * An enum that represents the types of warnings that can occur during validation.
@@ -77,7 +78,12 @@ var ProjectType;
     ProjectType[ProjectType["Copilot"] = 0] = "Copilot";
     ProjectType[ProjectType["SME"] = 1] = "SME";
     ProjectType[ProjectType["TeamsAi"] = 2] = "TeamsAi";
-})(ProjectType || (ProjectType = {}));
+})(ProjectType || (ProjectType = {}));
+var AdaptiveCardUpdateStrategy;
+(function (AdaptiveCardUpdateStrategy) {
+    AdaptiveCardUpdateStrategy[AdaptiveCardUpdateStrategy["CreateNew"] = 0] = "CreateNew";
+    AdaptiveCardUpdateStrategy[AdaptiveCardUpdateStrategy["KeepExisting"] = 1] = "KeepExisting";
+})(AdaptiveCardUpdateStrategy || (AdaptiveCardUpdateStrategy = {}));
 
 // Copyright (c) Microsoft Corporation.
 class ConstantString {
@@ -578,6 +584,35 @@ class Utils {
         const serverUrl = operationServer || methodServer || rootServer;
         return serverUrl;
     }
+    static getAuthSchemaObject(authType, authParameters) {
+        switch (authType) {
+            case "oauth":
+            case "microsoft-entra":
+                return {
+                    type: "oauth2",
+                    flows: {
+                        authorizationCode: {
+                            authorizationUrl: authParameters.authorizationUrl,
+                            tokenUrl: authParameters.tokenUrl,
+                            refreshUrl: authParameters.refreshUrl,
+                            scopes: authParameters.scopes,
+                        },
+                    },
+                };
+            case "api-key":
+                return {
+                    type: "apiKey",
+                    in: authParameters.in,
+                    name: authParameters.name,
+                };
+            case "bearer-token":
+            default:
+                return {
+                    type: "http",
+                    scheme: "bearer",
+                };
+        }
+    }
 }
 
 // Copyright (c) Microsoft Corporation.
@@ -2198,6 +2233,39 @@ class SpecParser {
     async listSupportedAPIInfo() {
         throw new Error("Method not implemented.");
     }
+    async addAuthScheme(authName, authType, authParameters, signal) {
+        try {
+            await this.loadSpec();
+            const spec = this.spec;
+            if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
+                throw new SpecParserError(ConstantString.CancelledMessage, ErrorType.Cancelled);
+            }
+            if (!spec.components) {
+                spec.components = {};
+            }
+            if (!spec.components.securitySchemes) {
+                spec.components.securitySchemes = {};
+            }
+            spec.components.securitySchemes[authName] = Utils.getAuthSchemaObject(authType, authParameters);
+            const paths = spec.paths;
+            for (const path in paths) {
+                const methods = paths[path];
+                for (const method in methods) {
+                    const operationId = methods[method].operationId;
+                    if (authParameters.apis.includes(operationId)) {
+                        methods[method].security = [{ [authName]: [] }];
+                    }
+                }
+            }
+            await this.saveFilterSpec(this.pathOrSpec, this.spec);
+        }
+        catch (err) {
+            if (err instanceof SpecParserError) {
+                throw err;
+            }
+            throw new SpecParserError(err.toString(), ErrorType.AddAuthFailed);
+        }
+    }
     /**
      * Lists all the OpenAPI operations in the specification file.
      * @returns A string array that represents the HTTP method and path of each operation, such as ['GET /pets/{petId}', 'GET /user/{userId}']
@@ -2309,7 +2377,7 @@ class SpecParser {
      * @param outputSpecPath File path of the new OpenAPI specification file to generate. If not specified or empty, no spec file will be generated.
      * @param pluginFilePath File path of the api plugin file to generate.
      */
-    async generateForCopilot(manifestPath, filter, outputSpecPath, pluginFilePath, existingPluginFilePath, signal) {
+    async generateForCopilot(manifestPath, filter, outputSpecPath, pluginFilePath, existingPluginFilePath, signal, adaptiveCardUpdateStrategy) {
         const result = {
             allSuccess: true,
             warnings: [],
@@ -2355,7 +2423,7 @@ class SpecParser {
                 : undefined;
             const authMap = Utils.getAuthMap(newSpec);
             const [updatedManifest, apiPlugin, warnings, jsonDataSet] = await ManifestUpdater.updateManifestWithAiPlugin(manifestPath, outputSpecPath, pluginFilePath, newSpec, this.options, authMap, existingPluginManifestInfo);
-            await this.separateAdaptiveCards(apiPlugin, pluginFilePath, jsonDataSet);
+            await this.separateAdaptiveCards(apiPlugin, pluginFilePath, jsonDataSet, adaptiveCardUpdateStrategy);
             result.warnings.push(...warnings);
             await fs.outputJSON(manifestPath, updatedManifest, { spaces: 4 });
             await fs.outputJSON(pluginFilePath, apiPlugin, { spaces: 4 });
@@ -2486,9 +2554,12 @@ class SpecParser {
         await this.separateAdaptiveCards(apiPlugin, pluginFilePath, jsonDataSet);
         await fs.outputJSON(pluginFilePath, apiPlugin, { spaces: 4 });
     }
-    async separateAdaptiveCards(apiPlugin, pluginFilePath, jsonDataSet = {}) {
+    async separateAdaptiveCards(apiPlugin, pluginFilePath, jsonDataSet = {}, adaptiveCardUpdateStrategy) {
         var _a, _b;
         const functions = apiPlugin.functions;
+        if (!adaptiveCardUpdateStrategy) {
+            adaptiveCardUpdateStrategy = AdaptiveCardUpdateStrategy.CreateNew;
+        }
         if (functions) {
             const adaptiveCardFolder = path.join(path.dirname(pluginFilePath), "adaptiveCards");
             for (const func of functions) {
@@ -2496,12 +2567,20 @@ class SpecParser {
                     const responseSemantic = func.capabilities.response_semantics;
                     const card = responseSemantic.static_template;
                     if (card && Object.keys(card).length !== 0) {
-                        const cardName = this.findUniqueCardName(func.name, adaptiveCardFolder);
+                        let cardName = func.name;
+                        if (adaptiveCardUpdateStrategy === AdaptiveCardUpdateStrategy.CreateNew) {
+                            cardName = this.findUniqueCardName(func.name, adaptiveCardFolder);
+                        }
+                        else {
+                            if (adaptiveCardUpdateStrategy === AdaptiveCardUpdateStrategy.KeepExisting &&
+                                fs.existsSync(path.join(adaptiveCardFolder, `${cardName}.json`))) {
+                                responseSemantic.static_template = { file: `adaptiveCards/${cardName}.json` };
+                                continue;
+                            }
+                        }
                         const cardPath = path.join(adaptiveCardFolder, `${cardName}.json`);
                         const dataPath = path.join(adaptiveCardFolder, `${cardName}.data.json`);
-                        responseSemantic.static_template = {
-                            file: `adaptiveCards/${cardName}.json`,
-                        };
+                        responseSemantic.static_template = { file: `adaptiveCards/${cardName}.json` };
                         await fs.outputJSON(cardPath, card, { spaces: 4 });
                         const data = (_b = jsonDataSet[cardName]) !== null && _b !== void 0 ? _b : {};
                         await fs.outputJSON(dataPath, data, { spaces: 4 });
@@ -2566,5 +2645,5 @@ class SpecParser {
     }
 }
 
-export { AdaptiveCardGenerator, ConstantString, ErrorType, ProjectType, SpecParser, SpecParserError, Utils, ValidationStatus, WarningType };
+export { AdaptiveCardGenerator, AdaptiveCardUpdateStrategy, ConstantString, ErrorType, ProjectType, SpecParser, SpecParserError, Utils, ValidationStatus, WarningType };
 //# sourceMappingURL=index.esm2017.mjs.map