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

package/dist/index.node.cjs.js

@@ -89,6 +89,7 @@ exports.ErrorType = void 0;
     ErrorType["UrlPathNotExist"] = "url-path-not-exist";
     ErrorType["Cancelled"] = "cancelled";
     ErrorType["Unknown"] = "unknown";
+    ErrorType["AddAuthFailed"] = "add-auth-failed";
 })(exports.ErrorType || (exports.ErrorType = {}));
 /**
  * An enum that represents the types of warnings that can occur during validation.
@@ -119,7 +120,12 @@ exports.ProjectType = void 0;
     ProjectType[ProjectType["Copilot"] = 0] = "Copilot";
     ProjectType[ProjectType["SME"] = 1] = "SME";
     ProjectType[ProjectType["TeamsAi"] = 2] = "TeamsAi";
-})(exports.ProjectType || (exports.ProjectType = {}));
+})(exports.ProjectType || (exports.ProjectType = {}));
+exports.AdaptiveCardUpdateStrategy = void 0;
+(function (AdaptiveCardUpdateStrategy) {
+    AdaptiveCardUpdateStrategy[AdaptiveCardUpdateStrategy["CreateNew"] = 0] = "CreateNew";
+    AdaptiveCardUpdateStrategy[AdaptiveCardUpdateStrategy["KeepExisting"] = 1] = "KeepExisting";
+})(exports.AdaptiveCardUpdateStrategy || (exports.AdaptiveCardUpdateStrategy = {}));
 
 // Copyright (c) Microsoft Corporation.
 class ConstantString {
@@ -620,6 +626,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.
@@ -2252,6 +2287,41 @@ class SpecParser {
             throw new Error("Method not implemented.");
         });
     }
+    addAuthScheme(authName, authType, authParameters, signal) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield this.loadSpec();
+                const spec = this.spec;
+                if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
+                    throw new SpecParserError(ConstantString.CancelledMessage, exports.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]: [] }];
+                        }
+                    }
+                }
+                yield this.saveFilterSpec(this.pathOrSpec, this.spec);
+            }
+            catch (err) {
+                if (err instanceof SpecParserError) {
+                    throw err;
+                }
+                throw new SpecParserError(err.toString(), exports.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}']
@@ -2369,7 +2439,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.
      */
-    generateForCopilot(manifestPath, filter, outputSpecPath, pluginFilePath, existingPluginFilePath, signal) {
+    generateForCopilot(manifestPath, filter, outputSpecPath, pluginFilePath, existingPluginFilePath, signal, adaptiveCardUpdateStrategy) {
         return __awaiter(this, void 0, void 0, function* () {
             const result = {
                 allSuccess: true,
@@ -2416,7 +2486,7 @@ class SpecParser {
                     : undefined;
                 const authMap = Utils.getAuthMap(newSpec);
                 const [updatedManifest, apiPlugin, warnings, jsonDataSet] = yield ManifestUpdater.updateManifestWithAiPlugin(manifestPath, outputSpecPath, pluginFilePath, newSpec, this.options, authMap, existingPluginManifestInfo);
-                yield this.separateAdaptiveCards(apiPlugin, pluginFilePath, jsonDataSet);
+                yield this.separateAdaptiveCards(apiPlugin, pluginFilePath, jsonDataSet, adaptiveCardUpdateStrategy);
                 result.warnings.push(...warnings);
                 yield fs__default['default'].outputJSON(manifestPath, updatedManifest, { spaces: 4 });
                 yield fs__default['default'].outputJSON(pluginFilePath, apiPlugin, { spaces: 4 });
@@ -2552,10 +2622,13 @@ class SpecParser {
             yield fs__default['default'].outputJSON(pluginFilePath, apiPlugin, { spaces: 4 });
         });
     }
-    separateAdaptiveCards(apiPlugin, pluginFilePath, jsonDataSet = {}) {
+    separateAdaptiveCards(apiPlugin, pluginFilePath, jsonDataSet = {}, adaptiveCardUpdateStrategy) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
             const functions = apiPlugin.functions;
+            if (!adaptiveCardUpdateStrategy) {
+                adaptiveCardUpdateStrategy = exports.AdaptiveCardUpdateStrategy.CreateNew;
+            }
             if (functions) {
                 const adaptiveCardFolder = path__default['default'].join(path__default['default'].dirname(pluginFilePath), "adaptiveCards");
                 for (const func of functions) {
@@ -2563,12 +2636,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 === exports.AdaptiveCardUpdateStrategy.CreateNew) {
+                                cardName = this.findUniqueCardName(func.name, adaptiveCardFolder);
+                            }
+                            else {
+                                if (adaptiveCardUpdateStrategy === exports.AdaptiveCardUpdateStrategy.KeepExisting &&
+                                    fs__default['default'].existsSync(path__default['default'].join(adaptiveCardFolder, `${cardName}.json`))) {
+                                    responseSemantic.static_template = { file: `adaptiveCards/${cardName}.json` };
+                                    continue;
+                                }
+                            }
                             const cardPath = path__default['default'].join(adaptiveCardFolder, `${cardName}.json`);
                             const dataPath = path__default['default'].join(adaptiveCardFolder, `${cardName}.data.json`);
-                            responseSemantic.static_template = {
-                                file: `adaptiveCards/${cardName}.json`,
-                            };
+                            responseSemantic.static_template = { file: `adaptiveCards/${cardName}.json` };
                             yield fs__default['default'].outputJSON(cardPath, card, { spaces: 4 });
                             const data = (_b = jsonDataSet[cardName]) !== null && _b !== void 0 ? _b : {};
                             yield fs__default['default'].outputJSON(dataPath, data, { spaces: 4 });