@azure-tools/typespec-ts 0.53.3 → 0.54.0

package/dist/src/rlc-common/metadata/buildReadmeFile.js

@@ -0,0 +1,426 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore: to fix the handlebars issue
+import hbs from "handlebars";
+import { NameType, normalizeName } from "../helpers/nameUtils.js";
+import { isAzurePackage } from "../helpers/packageUtil.js";
+import { getClientName } from "../helpers/nameConstructors.js";
+import { readFileSync } from "fs";
+const azureReadmeRLCTemplate = `# {{ clientDescriptiveName }} library for JavaScript
+
+{{ description }}
+
+{{#if azureArm}}
+**If you are not familiar with our REST client, please spend 5 minutes to take a look at {{#if serviceDocURL}}[the service's documentation]({{ serviceDocURL }}) and {{/if}}our [REST client docs](https://github.com/Azure/azure-sdk-for-js/blob/main/documentation/rest-clients.md) to use this library, the REST client provides a light-weighted & developer friendly way to call azure rest api
+{{else}}
+**Please rely heavily on {{#if serviceDocURL}}[the service's documentation]({{ serviceDocURL }}) and {{/if}}our [REST client docs](https://github.com/Azure/azure-sdk-for-js/blob/main/documentation/rest-clients.md) to use this library**
+{{/if}}
+
+Key links:
+
+{{#if packageSourceURL}}
+- [Source code]({{ packageSourceURL }})
+{{/if}}
+{{#if packageNPMURL}}
+- [Package (NPM)]({{ packageNPMURL }})
+{{/if}}
+{{#if apiRefURL}}
+- [API reference documentation]({{ apiRefURL }})
+{{/if}}
+{{#if serviceDocURL}}
+- [Product documentation]({{ serviceDocURL }})
+{{/if}}
+{{#if samplesURL}}
+- [Samples]({{ samplesURL }})
+{{/if}}
+
+## Getting started
+
+### Currently supported environments
+
+- LTS versions of Node.js
+
+### Prerequisites
+
+- You must have an [Azure subscription](https://azure.microsoft.com/free/){{#if dependencyLink}} and follow [these]({{ dependencyLink }}) instructions{{/if}} to use this package.
+
+### Install the \`{{ clientPackageName }}\` package
+
+Install the {{ clientDescriptiveName }} REST client library for JavaScript with \`npm\`:
+
+\`\`\`bash
+npm install {{ clientPackageName }}
+\`\`\`
+
+### Create and authenticate a \`{{ clientClassName }}\`
+
+To use an [Azure Active Directory (AAD) token credential](https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/identity/identity/samples/AzureIdentityExamples.md#authenticating-with-a-pre-fetched-access-token),
+provide an instance of the desired credential type obtained from the
+[@azure/identity](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity#credentials) library.
+
+To authenticate with AAD, you must first \`npm\` install [\`@azure/identity\`](https://www.npmjs.com/package/@azure/identity) {{#if dependencyLink}}and
+[{{dependencyDescription }}]({{ dependencyLink }}){{/if}}
+
+After setup, you can choose which type of [credential](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity#credentials) from \`@azure/identity\` to use.
+As an example, [DefaultAzureCredential](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity#defaultazurecredential)
+can be used to authenticate the client.
+
+## Troubleshooting
+
+### Logging
+
+Enabling logging may help uncover useful information about failures. In order to see a log of HTTP requests and responses, set the \`AZURE_LOG_LEVEL\` environment variable to \`info\`. Alternatively, logging can be enabled at runtime by calling \`setLogLevel\` in the \`@azure/logger\`:
+
+\`\`\`ts {{#if azureSdkForJs}}{{#if generateTest}}snippet:SetLogLevel{{/if}}{{/if}}
+import { setLogLevel } from "@azure/logger";
+
+setLogLevel("info");
+\`\`\`
+
+For more detailed instructions on how to enable logs, you can look at the [@azure/logger package docs](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/core/logger).
+`;
+const azureReadmeModularTemplate = `# {{ clientDescriptiveName }} library for JavaScript
+
+This package contains an isomorphic SDK (runs both in Node.js and in browsers) for {{ clientDescriptiveName }}.
+
+{{ description }}
+
+Key links:
+
+{{#if packageSourceURL}}
+- [Source code]({{ packageSourceURL }})
+{{/if}}
+{{#if packageNPMURL}}
+- [Package (NPM)]({{ packageNPMURL }})
+{{/if}}
+{{#if apiRefURL}}
+- [API reference documentation]({{ apiRefURL }})
+{{/if}}
+{{#if samplesURL}}
+- [Samples]({{samplesURL}})
+{{/if}}
+
+## Getting started
+
+### Currently supported environments
+
+- [LTS versions of Node.js](https://github.com/nodejs/release#release-schedule)
+- Latest versions of Safari, Chrome, Edge and Firefox.
+
+See our [support policy](https://github.com/Azure/azure-sdk-for-js/blob/main/SUPPORT.md) for more details.
+
+{{#if azure}}
+### Prerequisites
+
+- An [Azure subscription][azure_sub].
+{{/if}}
+
+{{#if isReleasablePackage}}
+### Install the \`{{ clientPackageName }}\` package
+
+Install the {{ clientDescriptiveName }} library for JavaScript with \`npm\`:
+
+\`\`\`bash
+npm install {{ clientPackageName }}
+\`\`\`
+{{/if}}
+
+{{#if azure}}
+{{#if addCredentials}}
+### Create and authenticate a \`{{ clientClassName}}\`
+
+To create a client object to access the {{ serviceName }} API, you will need the \`endpoint\` of your {{ serviceName }} resource and a \`credential\`. The {{ clientDescriptiveName }} can use Azure Active Directory credentials to authenticate.
+You can find the endpoint for your {{ serviceName }} resource in the [Azure Portal][azure_portal].
+
+You can authenticate with Azure Active Directory using a credential from the [@azure/identity][azure_identity] library or [an existing AAD Token](https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/identity/identity/samples/AzureIdentityExamples.md#authenticating-with-a-pre-fetched-access-token).
+
+To use the [DefaultAzureCredential][defaultazurecredential] provider shown below, or other credential providers provided with the Azure SDK, please install the \`@azure/identity\` package:
+
+\`\`\`bash
+npm install @azure/identity
+\`\`\`
+
+You will also need to **register a new AAD application and grant access to {{ serviceName}}** by assigning the suitable role to your service principal (note: roles such as \`"Owner"\` will not grant the necessary permissions).
+
+For more information about how to create an Azure AD Application check out [this guide](https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal).
+
+{{#if azureArm}}
+Using Node.js and Node-like environments, you can use the \`DefaultAzureCredential\` class to authenticate the client.
+
+\`\`\`ts {{#if azureSdkForJs}}{{#if generateTest}}snippet:ReadmeSampleCreateClient_Node{{/if}}{{/if}}
+import { {{ clientClassName }} } from "{{ clientPackageName }}";
+import { DefaultAzureCredential } from "@azure/identity";
+
+{{#if hasSubscriptionId}}
+const subscriptionId = "00000000-0000-0000-0000-000000000000";
+const client = new {{ clientClassName }}(new DefaultAzureCredential(), subscriptionId);
+{{else}}
+const client = new {{ clientClassName }}(new DefaultAzureCredential());
+{{/if}}
+\`\`\`
+
+For browser environments, use the \`InteractiveBrowserCredential\` from the \`@azure/identity\` package to authenticate.
+
+\`\`\`ts {{#if azureSdkForJs}}{{#if generateTest}}snippet:ReadmeSampleCreateClient_Browser{{/if}}{{/if}}
+import { InteractiveBrowserCredential } from "@azure/identity";
+import { {{ clientClassName }} } from "{{ clientPackageName }}";
+
+const credential = new InteractiveBrowserCredential({
+  tenantId: "<YOUR_TENANT_ID>",
+  clientId: "<YOUR_CLIENT_ID>",
+ });
+
+{{#if hasSubscriptionId}}
+const subscriptionId = "00000000-0000-0000-0000-000000000000";
+const client = new {{ clientClassName }}(credential, subscriptionId);
+{{else}}
+const client = new {{ clientClassName }}(credential);
+{{/if}}
+\`\`\`
+{{else}}
+Using Node.js and Node-like environments, you can use the \`DefaultAzureCredential\` class to authenticate the client.
+
+\`\`\`ts {{#if azureSdkForJs}}{{#if generateTest}}snippet:ReadmeSampleCreateClient_Node{{/if}}{{/if}}
+import { {{ clientClassName }} } from "{{ clientPackageName }}";
+import { DefaultAzureCredential } from "@azure/identity";
+
+const client = new {{ clientClassName }}("<endpoint>", new DefaultAzureCredential());
+\`\`\`
+
+For browser environments, use the \`InteractiveBrowserCredential\` from the \`@azure/identity\` package to authenticate.
+
+\`\`\`ts {{#if azureSdkForJs}}{{#if generateTest}}snippet:ReadmeSampleCreateClient_Browser{{/if}}{{/if}}
+import { InteractiveBrowserCredential } from "@azure/identity";
+import { {{ clientClassName }} } from "{{ clientPackageName }}";
+
+const credential = new InteractiveBrowserCredential({
+  tenantId: "<YOUR_TENANT_ID>",
+  clientId: "<YOUR_CLIENT_ID>"
+ });
+const client = new {{ clientClassName }}("<endpoint>", credential);
+\`\`\`
+{{/if}}
+{{/if}}{{/if}}
+
+### JavaScript Bundle
+To use this client library in the browser, first you need to use a bundler. For details on how to do this, please refer to our [bundling documentation](https://aka.ms/AzureSDKBundling).
+
+## Key concepts
+
+### {{ clientClassName }}
+
+\`{{ clientClassName }}\` is the primary interface for developers using the {{ clientDescriptiveName }} library. Explore the methods on this client object to understand the different features of the {{ serviceName }} service that you can access.
+
+{{#if azure}}
+## Troubleshooting
+
+### Logging
+
+Enabling logging may help uncover useful information about failures. In order to see a log of HTTP requests and responses, set the \`AZURE_LOG_LEVEL\` environment variable to \`info\`. Alternatively, logging can be enabled at runtime by calling \`setLogLevel\` in the \`@azure/logger\`:
+
+\`\`\`ts {{#if azureSdkForJs}}{{#if generateTest}}snippet:SetLogLevel{{/if}}{{/if}}
+import { setLogLevel } from "@azure/logger";
+
+setLogLevel("info");
+\`\`\`
+
+For more detailed instructions on how to enable logs, you can look at the [@azure/logger package docs]({{ repoURL }}/tree/main/sdk/core/logger).
+
+{{#if samplesURL}}
+## Next steps
+
+Please take a look at the [samples]({{ samplesURL }}) directory for detailed examples on how to use this library.
+{{/if}}
+
+## Contributing
+
+If you'd like to contribute to this library, please read the [contributing guide]({{ contributingGuideURL }}) to learn more about how to build and test the code.
+
+## Related projects
+
+- [{{ projectName }}]({{ repoURL }})
+
+[azure_sub]: https://azure.microsoft.com/free/
+[azure_portal]: https://portal.azure.com
+{{#if identityPackageURL}}[azure_identity]: {{ identityPackageURL }}
+{{/if}}[defaultazurecredential]: {{ identityPackageURL }}#defaultazurecredential
+{{/if}}
+`;
+const nonBrandedReadmeTemplate = `# {{ clientDescriptiveName }} library for JavaScript
+
+{{ description }}
+
+Key links:
+
+{{#if packageSourceURL}}
+- [Source code]({{ packageSourceURL }})
+{{/if}}
+{{#if packageNPMURL}}
+- [Package (NPM)]({{ packageNPMURL }})
+{{/if}}
+{{#if apiRefURL}}
+- [API reference documentation]({{ apiRefURL }})
+{{/if}}
+{{#if serviceDocURL}}
+- [Product documentation]({{ serviceDocURL }})
+{{/if}}
+{{#if samplesURL}}
+- [Samples]({{ samplesURL }})
+{{/if}}
+
+## Getting started
+
+### Currently supported environments
+
+- LTS versions of Node.js
+
+### Install the \`{{ clientPackageName }}\` package
+
+Install the {{ clientDescriptiveName }} library for JavaScript with \`npm\`:
+
+\`\`\`bash
+npm install {{ clientPackageName }}
+\`\`\`
+`;
+const apiReferenceTemplate = `{{#if apiRefURL}}
+- [API reference documentation]({{ apiRefURL }})
+{{/if}}
+`;
+export function buildReadmeFile(model) {
+    var _a;
+    const metadata = (_a = createMetadata(model)) !== null && _a !== void 0 ? _a : {};
+    const readmeFileContents = hbs.compile(model.options && isAzurePackage(model)
+        ? model.options.isModularLibrary
+            ? azureReadmeModularTemplate
+            : azureReadmeRLCTemplate
+        : nonBrandedReadmeTemplate, { noEscape: true });
+    return {
+        path: "README.md",
+        content: readmeFileContents(metadata)
+    };
+}
+export function hasClientNameChanged(model, existingReadmeFilePath) {
+    try {
+        const existingContent = readFileSync(existingReadmeFilePath, "utf8");
+        const importMatch = existingContent.match(/import\s*\{\s*([A-Za-z0-9_]+)\s*\}\s*from\s*["'][^"']*["']/);
+        const existingClientName = importMatch === null || importMatch === void 0 ? void 0 : importMatch[1];
+        const newClientName = getClientName(model);
+        return !!existingClientName && existingClientName !== newClientName;
+    }
+    catch {
+        return false;
+    }
+}
+export function updateReadmeFile(model, existingReadmeFilePath) {
+    var _a;
+    try {
+        const existingContent = readFileSync(existingReadmeFilePath, "utf8");
+        const metadata = (_a = createMetadata(model)) !== null && _a !== void 0 ? _a : {};
+        const newApiRefLink = hbs
+            .compile(apiReferenceTemplate, { noEscape: true })(metadata)
+            .trim();
+        if (!newApiRefLink) {
+            return { path: "README.md", content: existingContent };
+        }
+        const apiRefRegex = /^- \[API reference documentation\]\(https:\/\/learn\.microsoft\.com\/javascript\/api\/[^)]+\)$/m;
+        const updatedContent = existingContent.replace(apiRefRegex, (match) => match ? newApiRefLink : match);
+        return { path: "README.md", content: updatedContent };
+    }
+    catch {
+        return;
+    }
+}
+/**
+ * Returns meta data information about the service, the package, and the client.
+ * @param codeModel - include the client details
+ * @returns inferred metadata about the service, the package, and the client
+ */
+function createMetadata(model) {
+    var _a, _b, _c, _d, _e;
+    if (!model.options || !model.options.packageDetails) {
+        return;
+    }
+    // const packageDetails = model.options.packageDetails;
+    const { packageDetails, azureOutputDirectory, productDocLink, dependencyInfo, multiClient, batch, serviceInfo, isTypeSpecTest } = model.options;
+    const azureHuh = (packageDetails === null || packageDetails === void 0 ? void 0 : packageDetails.scopeName) === "azure" ||
+        (packageDetails === null || packageDetails === void 0 ? void 0 : packageDetails.scopeName) === "azure-rest";
+    const repoURL = "https://github.com/Azure/azure-sdk-for-js";
+    const relativePackageSourcePath = azureOutputDirectory;
+    const packageSourceURL = relativePackageSourcePath &&
+        repoURL &&
+        `${repoURL}/tree/main/${relativePackageSourcePath}`;
+    const clientPackageName = packageDetails === null || packageDetails === void 0 ? void 0 : packageDetails.name;
+    const clientClassName = getClientName(model);
+    const serviceName = getServiceName(model);
+    let apiRefUrlQueryParameter = "";
+    if (!(packageDetails === null || packageDetails === void 0 ? void 0 : packageDetails.isVersionUserProvided) &&
+        ((_a = model.apiVersionInfo) === null || _a === void 0 ? void 0 : _a.defaultValue)) {
+        if ((_c = (_b = model.apiVersionInfo) === null || _b === void 0 ? void 0 : _b.defaultValue) === null || _c === void 0 ? void 0 : _c.toLowerCase().includes("preview")) {
+            apiRefUrlQueryParameter = "?view=azure-node-preview";
+        }
+    }
+    else {
+        packageDetails.version = (_d = packageDetails.version) !== null && _d !== void 0 ? _d : "1.0.0-beta.1";
+        if (packageDetails === null || packageDetails === void 0 ? void 0 : packageDetails.version.includes("beta")) {
+            apiRefUrlQueryParameter = "?view=azure-node-preview";
+        }
+    }
+    return {
+        serviceName,
+        clientClassName,
+        clientPackageName: clientPackageName,
+        clientDescriptiveName: model.options.isModularLibrary
+            ? `${serviceName} client`
+            : `${serviceName} REST client`,
+        description: (_e = serviceInfo === null || serviceInfo === void 0 ? void 0 : serviceInfo.description) !== null && _e !== void 0 ? _e : packageDetails.description,
+        serviceDocURL: productDocLink,
+        packageSourceURL: packageSourceURL,
+        packageNPMURL: `https://www.npmjs.com/package/${clientPackageName}`,
+        samplesURL: model.options.generateSample && packageSourceURL
+            ? `${packageSourceURL}/samples`
+            : undefined,
+        apiRefURL: azureHuh
+            ? `https://learn.microsoft.com/javascript/api/${clientPackageName}${apiRefUrlQueryParameter}`
+            : undefined,
+        dependencyDescription: dependencyInfo === null || dependencyInfo === void 0 ? void 0 : dependencyInfo.description,
+        dependencyLink: dependencyInfo === null || dependencyInfo === void 0 ? void 0 : dependencyInfo.link,
+        hasMultiClients: multiClient && batch && batch.length > 1,
+        azureArm: Boolean(model.options.azureArm),
+        azure: azureHuh,
+        isReleasablePackage: !isTypeSpecTest,
+        repoURL: repoURL,
+        projectName: azureHuh ? "Microsoft Azure SDK for JavaScript" : undefined,
+        identityPackageURL: repoURL && `${repoURL}/tree/main/sdk/identity/identity`,
+        addCredentials: model.options.addCredentials,
+        contributingGuideURL: repoURL && `${repoURL}/blob/main/CONTRIBUTING.md`,
+        azureSdkForJs: model.options.azureSdkForJs,
+        generateTest: model.options.generateTest,
+        hasSubscriptionId: model.options.hasSubscriptionId
+    };
+}
+function getServiceName(model) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v;
+    const azureHuh = ((_b = (_a = model === null || model === void 0 ? void 0 : model.options) === null || _a === void 0 ? void 0 : _a.packageDetails) === null || _b === void 0 ? void 0 : _b.scopeName) === "azure" ||
+        ((_d = (_c = model === null || model === void 0 ? void 0 : model.options) === null || _c === void 0 ? void 0 : _c.packageDetails) === null || _d === void 0 ? void 0 : _d.scopeName) === "azure-rest";
+    const libraryName = model.libraryName;
+    const serviceTitle = ((_e = model.options) === null || _e === void 0 ? void 0 : _e.isModularLibrary)
+        ? model.libraryName
+        : ((_h = (_g = (_f = model.options) === null || _f === void 0 ? void 0 : _f.serviceInfo) === null || _g === void 0 ? void 0 : _g.title) !== null && _h !== void 0 ? _h : model.libraryName);
+    const batch = (_j = model === null || model === void 0 ? void 0 : model.options) === null || _j === void 0 ? void 0 : _j.batch, packageDetails = (_k = model === null || model === void 0 ? void 0 : model.options) === null || _k === void 0 ? void 0 : _k.packageDetails;
+    let simpleServiceName = batch && batch.length > 1
+        ? normalizeName((_m = (_l = packageDetails.nameWithoutScope) !== null && _l !== void 0 ? _l : packageDetails === null || packageDetails === void 0 ? void 0 : packageDetails.name) !== null && _m !== void 0 ? _m : "", NameType.Class)
+        : normalizeName(serviceTitle, NameType.Class);
+    simpleServiceName =
+        /**
+         * It is a required convention in Azure swaggers for their titles to end with
+         * "Client".
+         */
+        (_v = (_t = (_r = (_p = (_o = serviceTitle.match(/(.*) Client/)) === null || _o === void 0 ? void 0 : _o[1]) !== null && _p !== void 0 ? _p : (_q = serviceTitle.match(/(.*)Client/)) === null || _q === void 0 ? void 0 : _q[1]) !== null && _r !== void 0 ? _r : (_s = libraryName.match(/(.*)Client/)) === null || _s === void 0 ? void 0 : _s[1]) !== null && _t !== void 0 ? _t : (_u = serviceTitle.match(/(.*) Service/)) === null || _u === void 0 ? void 0 : _u[1]) !== null && _v !== void 0 ? _v : simpleServiceName;
+    return azureHuh
+        ? simpleServiceName.startsWith("Azure")
+            ? simpleServiceName
+            : `Azure ${simpleServiceName}`
+        : simpleServiceName;
+}
+//# sourceMappingURL=buildReadmeFile.js.map

package/dist/src/rlc-common/metadata/buildReadmeFile.js.map

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

package/dist/src/rlc-common/metadata/buildRollupConfig.d.ts

@@ -0,0 +1,6 @@
+import { RLCModel } from "../interfaces.js";
+export declare function buildRollupConfig(model: RLCModel): {
+    path: string;
+    content: string;
+} | undefined;
+//# sourceMappingURL=buildRollupConfig.d.ts.map

package/dist/src/rlc-common/metadata/buildRollupConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildRollupConfig.d.ts","sourceRoot":"","sources":["../../../../src/rlc-common/metadata/buildRollupConfig.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ;;;cA8IhD"}

package/dist/src/rlc-common/metadata/buildRollupConfig.js

@@ -0,0 +1,142 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { Project } from "ts-morph";
+import { isAzurePackage } from "../helpers/packageUtil.js";
+export function buildRollupConfig(model) {
+    var _a;
+    const azureSdkForJs = Boolean((_a = model.options) === null || _a === void 0 ? void 0 : _a.azureSdkForJs);
+    // Only generate the file when it is not in sdk repo
+    if (isAzurePackage(model) &&
+        (azureSdkForJs === true || azureSdkForJs === undefined)) {
+        return;
+    }
+    const project = new Project();
+    const filePath = "rollup.config.js";
+    const rollupFile = project.createSourceFile(filePath, undefined, {
+        overwrite: true
+    });
+    rollupFile.addStatements(`import nodeResolve from "@rollup/plugin-node-resolve";
+    import cjs from "@rollup/plugin-commonjs";
+    import sourcemaps from "rollup-plugin-sourcemaps";
+    import multiEntry from "@rollup/plugin-multi-entry";
+    import json from "@rollup/plugin-json";
+    
+    import nodeBuiltins from "builtin-modules";
+    
+    // #region Warning Handler
+    
+    /**
+     * A function that can determine whether a rollup warning should be ignored. If
+     * the function returns \`true\`, then the warning will not be displayed.
+     */
+    
+    function ignoreNiseSinonEval(warning) {
+      return (
+        warning.code === "EVAL" &&
+        (warning.id && ((warning.id.includes("node_modules/nise")) ||
+          warning.id.includes("node_modules/sinon")) === true)
+      );
+    }
+    
+    function ignoreChaiCircularDependency(warning) {
+      return (
+        warning.code === "CIRCULAR_DEPENDENCY" &&
+        (warning.importer && warning.importer.includes("node_modules/chai") === true)
+      );
+    }
+    
+    const warningInhibitors = [
+      ignoreChaiCircularDependency,
+      ignoreNiseSinonEval
+    ];
+    
+    /**
+     * Construct a warning handler for the shared rollup configuration
+     * that ignores certain warnings that are not relevant to testing.
+     */
+    function makeOnWarnForTesting() {
+      return (warning, warn) => {
+        // If every inhibitor returns false (i.e. no inhibitors), then show the warning
+        if (warningInhibitors.every(inhib => !inhib(warning))) {
+          warn(warning);
+        }
+      };
+    }
+    
+    // #endregion
+    
+    function makeBrowserTestConfig() {
+      const config = {
+        input: {
+          include: ["dist-esm/test/**/*.spec.js"],
+          exclude: ["dist-esm/test/**/node/**"]
+        },
+        output: {
+          file: \`dist-test/index.browser.js\`,
+          format: "umd",
+          sourcemap: true
+        },
+        preserveSymlinks: false,
+        plugins: [
+          multiEntry({ exports: false }),
+          nodeResolve({
+            mainFields: ["module", "browser"]
+          }),
+          cjs(),
+          json(),
+          sourcemaps()
+          //viz({ filename: "dist-test/browser-stats.html", sourcemap: true })
+        ],
+        onwarn: makeOnWarnForTesting(),
+        // Disable tree-shaking of test code.  In rollup-plugin-node-resolve@5.0.0,
+        // rollup started respecting the "sideEffects" field in package.json.  Since
+        // our package.json sets "sideEffects=false", this also applies to test
+        // code, which causes all tests to be removed by tree-shaking.
+        treeshake: false
+      };
+    
+      return config;
+    }
+    
+    const defaultConfigurationOptions = {
+      disableBrowserBundle: false
+    };
+    
+    export function makeConfig(
+      pkg,
+      options
+    ) {
+      options = {
+        ...defaultConfigurationOptions,
+        ...(options || {})
+      };
+    
+      const baseConfig = {
+        // Use the package's module field if it has one
+        input: pkg["module"] || "dist-esm/src/index.js",
+        external: [
+          ...nodeBuiltins,
+          ...Object.keys(pkg.dependencies),
+          ...Object.keys(pkg.devDependencies)
+        ],
+        output: { file: "dist/index.js", format: "cjs", sourcemap: true },
+        preserveSymlinks: false,
+        plugins: [sourcemaps(), nodeResolve()]
+      };
+    
+      const config = [baseConfig];
+    
+      if (!options.disableBrowserBundle) {
+        config.push(makeBrowserTestConfig());
+      }
+    
+      return config;
+    }
+    
+    export default makeConfig(require("./package.json"));`);
+    return {
+        path: filePath,
+        content: rollupFile.getFullText()
+    };
+}
+//# sourceMappingURL=buildRollupConfig.js.map

package/dist/src/rlc-common/metadata/buildRollupConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildRollupConfig.js","sourceRoot":"","sources":["../../../../src/rlc-common/metadata/buildRollupConfig.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,MAAM,UAAU,iBAAiB,CAAC,KAAe;;IAC/C,MAAM,aAAa,GAAG,OAAO,CAAC,MAAA,KAAK,CAAC,OAAO,0CAAE,aAAa,CAAC,CAAC;IAC5D,oDAAoD;IACpD,IACE,cAAc,CAAC,KAAK,CAAC;QACrB,CAAC,aAAa,KAAK,IAAI,IAAI,aAAa,KAAK,SAAS,CAAC,EACvD,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,kBAAkB,CAAC;IACpC,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE;QAC/D,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,UAAU,CAAC,aAAa,CACtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0DAsHsD,CACvD,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,UAAU,CAAC,WAAW,EAAE;KAClC,CAAC;AACJ,CAAC"}

package/dist/src/rlc-common/metadata/buildSampleEnvFile.d.ts

@@ -0,0 +1,6 @@
+import { RLCModel } from "../interfaces.js";
+export declare function buildSampleEnvFile(model: RLCModel): {
+    path: string;
+    content: string;
+} | undefined;
+//# sourceMappingURL=buildSampleEnvFile.d.ts.map

package/dist/src/rlc-common/metadata/buildSampleEnvFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSampleEnvFile.d.ts","sourceRoot":"","sources":["../../../../src/rlc-common/metadata/buildSampleEnvFile.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAM5C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ;;;cAajD"}

package/dist/src/rlc-common/metadata/buildSampleEnvFile.js

@@ -0,0 +1,17 @@
+const sampleEnvText = `
+# Feel free to add your own environment variables.
+`;
+export function buildSampleEnvFile(model) {
+    var _a, _b, _c;
+    if ((((_a = model.options) === null || _a === void 0 ? void 0 : _a.generateMetadata) === true ||
+        ((_b = model.options) === null || _b === void 0 ? void 0 : _b.generateSample) === true) &&
+        ((_c = model.options) === null || _c === void 0 ? void 0 : _c.flavor) === "azure") {
+        const filePath = "sample.env";
+        return {
+            path: filePath,
+            content: sampleEnvText.trim()
+        };
+    }
+    return undefined;
+}
+//# sourceMappingURL=buildSampleEnvFile.js.map

package/dist/src/rlc-common/metadata/buildSampleEnvFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSampleEnvFile.js","sourceRoot":"","sources":["../../../../src/rlc-common/metadata/buildSampleEnvFile.ts"],"names":[],"mappings":"AAIA,MAAM,aAAa,GAAG;;CAErB,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,KAAe;;IAChD,IACE,CAAC,CAAA,MAAA,KAAK,CAAC,OAAO,0CAAE,gBAAgB,MAAK,IAAI;QACvC,CAAA,MAAA,KAAK,CAAC,OAAO,0CAAE,cAAc,MAAK,IAAI,CAAC;QACzC,CAAA,MAAA,KAAK,CAAC,OAAO,0CAAE,MAAM,MAAK,OAAO,EACjC,CAAC;QACD,MAAM,QAAQ,GAAG,YAAY,CAAC;QAC9B,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,aAAa,CAAC,IAAI,EAAE;SAC9B,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/rlc-common/metadata/buildTestConfig.d.ts

@@ -0,0 +1,16 @@
+import { RLCModel } from "../interfaces.js";
+/**
+ * Builds config/tsconfig.test.browser.json — extends eng/tsconfigs/test.browser.json
+ */
+export declare function buildTestBrowserTsConfig(model: RLCModel): {
+    path: string;
+    content: string;
+} | undefined;
+/**
+ * Builds config/tsconfig.test.node.json — extends eng/tsconfigs/test.node.json
+ */
+export declare function buildTestNodeTsConfig(model: RLCModel): {
+    path: string;
+    content: string;
+} | undefined;
+//# sourceMappingURL=buildTestConfig.d.ts.map

package/dist/src/rlc-common/metadata/buildTestConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTestConfig.d.ts","sourceRoot":"","sources":["../../../../src/rlc-common/metadata/buildTestConfig.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAY5C;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,QAAQ;;;cAwBvD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,QAAQ;;;cAwBpD"}