@azure/app-configuration-importer 1.0.0-preview → 1.0.1-preview

package/dist-esm/src/appConfigurationImporter.js

@@ -0,0 +1,157 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+import { ImportMode } from "./enums";
+import { OperationTimeoutError, ArgumentError } from "./errors";
+import { AdaptiveTaskManager } from "./internal/adaptiveTaskManager";
+import { isConfigSettingEqual } from "./internal/utils";
+import { v4 as uuidv4 } from "uuid";
+import { Constants } from "./internal/constants";
+/**
+ * Entrypoint class for sync configuration
+ */
+export class AppConfigurationImporter {
+    /**
+     * Initializes a new instance of the AppConfigurationSync class.
+     * @param configurationClient - App configuration client for manipulate the target App Configuration.
+     */
+    constructor(configurationClient) {
+        this.configurationClient = configurationClient;
+    }
+    /**
+     * Import source settings into the Azure App Configuration service
+     *
+     * Example usage:
+     * ```ts
+     * const fileData = fs.readFileSync("mylocalPath").toString();
+     * const result = await asyncClient.Import(new StringConfigurationSettingsSource({data:fileData, format: ConfigurationFormat.Json}));
+     * ```
+     * @param configSettingsSource - A ConfigurationSettingsSource instance.
+     * @param strict - Use strict mode or not.
+     * @param timeout - Seconds of entire import progress timeout
+     * @param progressCallback - Callback for report the progress of import
+     * @param importMode - Determines the behavior when importing key-values. The default value, 'All' will import all key-values in the input file to App Configuration. 'Ignore-Match' will only import settings that have no matching key-value in App Configuration.
+     * @param dryRun - When dry run is enabled, no updates  will be performed to App Configuration. Instead, any updates that would have been performed in a normal run will be printed to the console for review
+     */
+    async Import(configSettingsSource, timeout, strict = false, progressCallback, importMode, dryRun) {
+        var _a, e_1, _b, _c;
+        if (importMode == undefined) {
+            importMode = ImportMode.IgnoreMatch;
+        }
+        if (dryRun == undefined) {
+            dryRun = false;
+        }
+        this.validateImportMode(importMode);
+        const configSettings = await configSettingsSource.GetConfigurationSettings();
+        const configurationSettingToDelete = [];
+        const srcKeyLabelLookUp = {};
+        configSettings.forEach((config) => {
+            if (!srcKeyLabelLookUp[config.key]) {
+                srcKeyLabelLookUp[config.key] = {};
+            }
+            srcKeyLabelLookUp[config.key][config.label || ""] = true;
+        });
+        // generate correlationRequestId for operations in the same activity
+        const customCorrelationRequestId = uuidv4();
+        const customHeadersOption = {
+            requestOptions: {
+                customHeaders: {
+                    [Constants.CorrelationRequestIdHeader]: customCorrelationRequestId
+                }
+            }
+        };
+        if (strict || importMode == ImportMode.IgnoreMatch) {
+            try {
+                for (var _d = true, _e = __asyncValues(this.configurationClient.listConfigurationSettings(Object.assign(Object.assign({}, configSettingsSource.FilterOptions), customHeadersOption))), _f; _f = await _e.next(), _a = _f.done, !_a;) {
+                    _c = _f.value;
+                    _d = false;
+                    try {
+                        const existing = _c;
+                        const isKeyLabelPresent = srcKeyLabelLookUp[existing.key] && srcKeyLabelLookUp[existing.key][existing.label || ""];
+                        if (strict && !isKeyLabelPresent) {
+                            configurationSettingToDelete.push(existing);
+                        }
+                        if (importMode == ImportMode.IgnoreMatch) {
+                            const incoming = configSettings.find(configSetting => configSetting.key == existing.key &&
+                                configSetting.label == existing.label);
+                            if (incoming && isConfigSettingEqual(incoming, existing)) {
+                                configSettings.splice(configSettings.indexOf(incoming), 1);
+                            }
+                        }
+                    }
+                    finally {
+                        _d = true;
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = _e.return)) await _b.call(_e);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        }
+        if (dryRun) {
+            this.printUpdatesToConsole(configSettings, configurationSettingToDelete);
+        }
+        else {
+            await this.applyUpdatesToServer(configSettings, configurationSettingToDelete, timeout, customHeadersOption, progressCallback);
+        }
+    }
+    printUpdatesToConsole(settingsToAdd, settingsToDelete) {
+        console.log("The following settings will be removed from App Configuration:");
+        for (const setting of settingsToDelete) {
+            console.log(JSON.stringify({ key: setting.key, label: setting.label, contentType: setting.contentType, tags: setting.tags }));
+        }
+        console.log("\nThe following settings will be written to App Configuration:");
+        for (const setting of settingsToAdd) {
+            console.log(JSON.stringify({ key: setting.key, label: setting.label, contentType: setting.contentType, tags: setting.tags }));
+        }
+    }
+    async applyUpdatesToServer(settingsToAdd, settingsToDelete, timeout, options, progressCallback) {
+        const deleteTaskManager = this.newAdaptiveTaskManager((setting) => this.configurationClient.deleteConfigurationSetting(setting, options), settingsToDelete);
+        const startTime = Date.now();
+        await this.executeTasksWithTimeout(deleteTaskManager, timeout);
+        const endTime = Date.now();
+        const deleteTimeConsumed = (endTime - startTime) / 1000;
+        timeout -= deleteTimeConsumed;
+        const importTaskManager = this.newAdaptiveTaskManager((setting) => this.configurationClient.setConfigurationSetting(setting, options), settingsToAdd);
+        await this.executeTasksWithTimeout(importTaskManager, timeout, progressCallback);
+    }
+    newAdaptiveTaskManager(task, configurationSettings) {
+        let index = 0;
+        return new AdaptiveTaskManager(() => {
+            if (index == configurationSettings.length) {
+                return undefined;
+            }
+            const configSet = configurationSettings[index++];
+            return async () => {
+                return task(configSet);
+            };
+        }, configurationSettings.length);
+    }
+    async executeTasksWithTimeout(taskManager, timeInSeconds, callback) {
+        let timer;
+        const taskPromise = taskManager.Start(callback);
+        const timeoutPromise = new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new OperationTimeoutError()), timeInSeconds * 1000);
+        });
+        await Promise.race([taskPromise, timeoutPromise]).finally(() => {
+            clearTimeout(timer); // clear timeout when importPromise successfully resolve or faultily reject.
+        });
+    }
+    validateImportMode(importMode) {
+        if (importMode && !(importMode == ImportMode.IgnoreMatch ||
+            importMode == ImportMode.All)) {
+            throw new ArgumentError("Only options supported for Import Mode are 'All' and 'Ignore-Match'.");
+        }
+    }
+}
+//# sourceMappingURL=appConfigurationImporter.js.map

package/dist-esm/src/appConfigurationImporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appConfigurationImporter.js","sourceRoot":"","sources":["../../src/appConfigurationImporter.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport { \n  AppConfigurationClient, \n  ConfigurationSetting, \n  SetConfigurationSettingParam, \n  FeatureFlagValue, \n  SecretReferenceValue } from \"@azure/app-configuration\";\nimport { ConfigurationSettingsSource } from \"./settingsImport/configurationSettingsSource\";\nimport { ImportMode } from \"./enums\";\nimport { OperationTimeoutError, ArgumentError } from \"./errors\";\nimport { AdaptiveTaskManager } from \"./internal/adaptiveTaskManager\";\nimport { ImportProgress, KeyLabelLookup } from \"./models\";\nimport { isConfigSettingEqual } from \"./internal/utils\";\nimport { v4 as uuidv4 } from \"uuid\";\nimport { Constants } from \"./internal/constants\";\nimport { OperationOptions } from \"@azure/core-client\";\n\n/**\n * Entrypoint class for sync configuration\n */\nexport class AppConfigurationImporter {\n  private configurationClient: AppConfigurationClient;\n  /**\n   * Initializes a new instance of the AppConfigurationSync class.\n   * @param configurationClient - App configuration client for manipulate the target App Configuration.\n   */\n  constructor(configurationClient: AppConfigurationClient) {\n    this.configurationClient = configurationClient;\n  }\n\n  /**\n   * Import source settings into the Azure App Configuration service\n   *\n   * Example usage:\n   * ```ts\n   * const fileData = fs.readFileSync(\"mylocalPath\").toString();\n   * const result = await asyncClient.Import(new StringConfigurationSettingsSource({data:fileData, format: ConfigurationFormat.Json}));\n   * ```\n   * @param configSettingsSource - A ConfigurationSettingsSource instance.\n   * @param strict - Use strict mode or not.\n   * @param timeout - Seconds of entire import progress timeout\n   * @param progressCallback - Callback for report the progress of import\n   * @param importMode - Determines the behavior when importing key-values. The default value, 'All' will import all key-values in the input file to App Configuration. 'Ignore-Match' will only import settings that have no matching key-value in App Configuration.\n   * @param dryRun - When dry run is enabled, no updates  will be performed to App Configuration. Instead, any updates that would have been performed in a normal run will be printed to the console for review\n   */\n  public async Import(\n    configSettingsSource: ConfigurationSettingsSource,\n    timeout: number,\n    strict = false,\n    progressCallback?: (progress: ImportProgress) => unknown,\n    importMode?: ImportMode,\n    dryRun?: boolean\n  ) {\n    if (importMode == undefined) {\n      importMode = ImportMode.IgnoreMatch;\n    }\n    if (dryRun == undefined) {\n      dryRun = false;\n    }\n    this.validateImportMode(importMode);\n\n    const configSettings = await configSettingsSource.GetConfigurationSettings();\n\n    const configurationSettingToDelete: ConfigurationSetting<string>[] = [];\n    const srcKeyLabelLookUp: KeyLabelLookup = {};\n    \n    configSettings.forEach((config: SetConfigurationSettingParam<string | FeatureFlagValue | SecretReferenceValue>) => {\n      if (!srcKeyLabelLookUp[config.key]) {\n        srcKeyLabelLookUp[config.key] = {};\n      }\n      srcKeyLabelLookUp[config.key][config.label || \"\"] = true;\n    });\n\n    // generate correlationRequestId for operations in the same activity\n    const customCorrelationRequestId: string = uuidv4();\n    const customHeadersOption: OperationOptions = {\n      requestOptions: {\n        customHeaders: {\n          [Constants.CorrelationRequestIdHeader]: customCorrelationRequestId\n        }\n      }\n    };\n\n    if (strict || importMode == ImportMode.IgnoreMatch) {\n      for await (const existing of this.configurationClient.listConfigurationSettings({...configSettingsSource.FilterOptions, ...customHeadersOption})) {\n\n        const isKeyLabelPresent: boolean = srcKeyLabelLookUp[existing.key] && srcKeyLabelLookUp[existing.key][existing.label || \"\"];\n        \n        if (strict && !isKeyLabelPresent) {\n          configurationSettingToDelete.push(existing);\n        }\n       \n        if (importMode == ImportMode.IgnoreMatch) {\n          const incoming = configSettings.find(configSetting => configSetting.key == existing.key && \n            configSetting.label == existing.label);\n           \n          if (incoming && isConfigSettingEqual(incoming, existing)) {\n            configSettings.splice(configSettings.indexOf(incoming), 1);\n          }\n        }\n      }\n    }\n   \n    if (dryRun) {\n      this.printUpdatesToConsole(configSettings, configurationSettingToDelete);\n    }\n    else {\n      await this.applyUpdatesToServer(configSettings, configurationSettingToDelete, timeout, customHeadersOption, progressCallback);\n    }\n  }\n\n  private printUpdatesToConsole(\n    settingsToAdd: SetConfigurationSettingParam<string | FeatureFlagValue | SecretReferenceValue>[], \n    settingsToDelete: ConfigurationSetting<string>[]\n  ): void {\n    console.log(\"The following settings will be removed from App Configuration:\");\n    for (const setting of settingsToDelete) {\n\n      console.log(JSON.stringify({key: setting.key, label: setting.label, contentType: setting.contentType, tags: setting.tags}));\n    } \n\n    console.log(\"\\nThe following settings will be written to App Configuration:\");\n    for (const setting of settingsToAdd) {\n\n      console.log(JSON.stringify({key: setting.key, label: setting.label, contentType: setting.contentType, tags: setting.tags}));\n    }\n  }\n\n  private async applyUpdatesToServer(\n    settingsToAdd: SetConfigurationSettingParam<string | FeatureFlagValue | SecretReferenceValue>[], \n    settingsToDelete: ConfigurationSetting<string>[],\n    timeout: number,\n    options: OperationOptions,\n    progressCallback?: (progress: ImportProgress) => unknown | undefined\n  ): Promise<void> {\n    const deleteTaskManager = this.newAdaptiveTaskManager((setting) => this.configurationClient.deleteConfigurationSetting(setting, options), settingsToDelete);\n    const startTime = Date.now();\n    await this.executeTasksWithTimeout(deleteTaskManager, timeout);\n    const endTime = Date.now();\n    const deleteTimeConsumed = (endTime - startTime) / 1000;\n    timeout -= deleteTimeConsumed;\n\n    const importTaskManager = this.newAdaptiveTaskManager((setting) => this.configurationClient.setConfigurationSetting(setting, options), settingsToAdd);\n    await this.executeTasksWithTimeout(importTaskManager, timeout, progressCallback);\n  }\n\n  private newAdaptiveTaskManager<T>(task: (setting: T) => Promise<any>, configurationSettings: Array<T>) {\n    let index = 0;\n    return new AdaptiveTaskManager(() => {\n      if (index == configurationSettings.length) {\n        return undefined;\n      }\n      const configSet = configurationSettings[index++];\n\n      return async () => {\n        return task(configSet);\n      };\n    }, configurationSettings.length);\n  }\n\n  private async executeTasksWithTimeout<T>(taskManager: AdaptiveTaskManager<T>, timeInSeconds: number, callback?: (progress: ImportProgress) => unknown) {\n    let timer: NodeJS.Timeout;\n    const taskPromise = taskManager.Start(callback);\n    const timeoutPromise = new Promise((_, reject) => {\n      timer = setTimeout(() => reject(new OperationTimeoutError()), timeInSeconds * 1000);\n    });\n    await Promise.race([taskPromise, timeoutPromise]).finally(() => {\n      clearTimeout(timer); // clear timeout when importPromise successfully resolve or faultily reject.\n    });\n  }\n\n  private validateImportMode(importMode: ImportMode): void {\n    if (importMode && !(importMode == ImportMode.IgnoreMatch || \n      importMode == ImportMode.All)) {\n      throw new ArgumentError(\"Only options supported for Import Mode are 'All' and 'Ignore-Match'.\");\n    }\n  }\n}\n"]}

package/dist-esm/src/enums.js

@@ -0,0 +1,28 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+/**
+ * Enums of configuration Format.
+ */
+export var ConfigurationFormat;
+(function (ConfigurationFormat) {
+    ConfigurationFormat[ConfigurationFormat["Json"] = 0] = "Json";
+    ConfigurationFormat[ConfigurationFormat["Properties"] = 1] = "Properties";
+    ConfigurationFormat[ConfigurationFormat["Yaml"] = 2] = "Yaml";
+})(ConfigurationFormat || (ConfigurationFormat = {}));
+/**
+ * Enums of configuration Profile.
+ */
+export var ConfigurationProfile;
+(function (ConfigurationProfile) {
+    ConfigurationProfile[ConfigurationProfile["Default"] = 0] = "Default";
+    ConfigurationProfile[ConfigurationProfile["KvSet"] = 1] = "KvSet";
+})(ConfigurationProfile || (ConfigurationProfile = {}));
+/**
+ * Enums of import mode.
+ */
+export var ImportMode;
+(function (ImportMode) {
+    ImportMode[ImportMode["All"] = 0] = "All";
+    ImportMode[ImportMode["IgnoreMatch"] = 1] = "IgnoreMatch";
+})(ImportMode || (ImportMode = {}));
+//# sourceMappingURL=enums.js.map

package/dist-esm/src/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../src/enums.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC;;GAEG;AACH,MAAM,CAAN,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,6DAAI,CAAA;IACJ,yEAAU,CAAA;IACV,6DAAI,CAAA;AACN,CAAC,EAJW,mBAAmB,KAAnB,mBAAmB,QAI9B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,oBAGX;AAHD,WAAY,oBAAoB;IAC9B,qEAAO,CAAA;IACP,iEAAK,CAAA;AACP,CAAC,EAHW,oBAAoB,KAApB,oBAAoB,QAG/B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,yCAAG,CAAA;IACH,yDAAW,CAAA;AACb,CAAC,EAHW,UAAU,KAAV,UAAU,QAGrB","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\n/**\n * Enums of configuration Format.\n */\nexport enum ConfigurationFormat {\n  Json,\n  Properties,\n  Yaml,\n}\n\n/**\n * Enums of configuration Profile.\n */\nexport enum ConfigurationProfile {\n  Default,\n  KvSet,\n}\n\n/**\n * Enums of import mode.\n */\nexport enum ImportMode {\n  All,\n  IgnoreMatch\n}"]}

package/dist-esm/src/errors.js

@@ -0,0 +1,35 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+/**
+ * Custom error type used during input validation
+ */
+export class ArgumentError extends Error {
+    constructor(message) {
+        super();
+        this.message = message;
+    }
+}
+/**
+ * Custom error type used during configuration file parsing
+ */
+export class ParseError extends Error {
+    constructor(message) {
+        super();
+        this.message = message;
+    }
+}
+/**
+ * Custom error type used for set configuration timeout error
+ */
+export class OperationTimeoutError extends Error {
+    constructor() {
+        super();
+        this.message = "The operation failed to complete within the specified time limit.";
+    }
+}
+/**
+ * Custom error type used when null arguments are passed
+ */
+export class ArgumentNullError extends Error {
+}
+//# sourceMappingURL=errors.js.map

package/dist-esm/src/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGnC,YAAY,OAAe;QACzB,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,mEAAmE,CAAC;IACrF,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;CAAG","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\n/**\n * Custom error type used during input validation\n */\nexport class ArgumentError extends Error {\n  constructor(message: string) {\n    super();\n\n    this.message = message;\n  }\n}\n\n/**\n * Custom error type used during configuration file parsing\n */\nexport class ParseError extends Error {\n  public message: string;\n\n  constructor(message: string) {\n    super();\n\n    this.message = message;\n  }\n}\n\n/**\n * Custom error type used for set configuration timeout error\n */\nexport class OperationTimeoutError extends Error {\n  constructor() {\n    super();\n    this.message = \"The operation failed to complete within the specified time limit.\";\n  }\n}\n\n/**\n * Custom error type used when null arguments are passed\n */\nexport class ArgumentNullError extends Error {}\n"]}

package/dist-esm/src/importOptions.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export {};
+//# sourceMappingURL=importOptions.js.map

package/dist-esm/src/importOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"importOptions.js","sourceRoot":"","sources":["../../src/importOptions.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { PagedAsyncIterableIterator, PageSettings } from \"@azure/core-paging\";\nimport { ConfigurationFormat, ConfigurationProfile } from \"./enums\";\nimport { Tags } from \"./models\";\nimport { ConfigurationSetting, ListConfigurationSettingPage } from \"@azure/app-configuration\";\n\ntype Options = {\n  label?: string;\n  skipFeatureFlags?: boolean;\n  prefix?: string;\n  contentType?: string;\n  tags?: Tags;\n}\n\n/**\n * Base options for configuration import\n *\n * @internal\n */\nexport type SourceOptions = {\n  format: ConfigurationFormat;\n  separator?: string;\n  depth?: number;\n  profile?: ConfigurationProfile;\n} & Options;\n\n/**\n * Provides options for importing from string data source\n *\n */\nexport type StringSourceOptions = SourceOptions & {data: string; };\nexport type IterableSourceOptions = Options & { data: PagedAsyncIterableIterator<ConfigurationSetting<string>, ListConfigurationSettingPage, PageSettings>;  trimPrefix?: string; };\nexport type ReadableStreamSourceOptions = SourceOptions & { data: ReadableStream<Uint8Array> | NodeJS.ReadableStream };"]}

package/dist-esm/src/index.js

@@ -0,0 +1,9 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+export { AppConfigurationImporter } from "./appConfigurationImporter";
+export * from "./enums";
+export * from "./errors";
+export { StringConfigurationSettingsSource } from "./settingsImport/stringConfigurationSettingsSource";
+export { IterableConfigurationSettingsSource } from "./settingsImport/iterableConfigurationSettingsSource";
+export { ReadableStreamConfigurationSettingsSource } from "./settingsImport/readableStreamConfigurationSettingsSource";
+//# sourceMappingURL=index.js.map

package/dist-esm/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAMtE,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AAEzB,OAAO,EAAE,iCAAiC,EAAE,MAAM,oDAAoD,CAAC;AAEvG,OAAO,EAAE,mCAAmC,EAAE,MAAM,sDAAsD,CAAC;AAC3G,OAAO,EAAE,yCAAyC,EAAE,MAAM,4DAA4D,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nexport { AppConfigurationImporter } from \"./appConfigurationImporter\";\nexport {\n  StringSourceOptions,\n  IterableSourceOptions,\n  ReadableStreamSourceOptions\n} from \"./importOptions\";\nexport * from \"./enums\";\nexport * from \"./errors\";\nexport { ImportProgress as ImportResult } from \"./models\";\nexport { StringConfigurationSettingsSource } from \"./settingsImport/stringConfigurationSettingsSource\";\nexport { ConfigurationSettingsSource } from \"./settingsImport/configurationSettingsSource\";\nexport { IterableConfigurationSettingsSource } from \"./settingsImport/iterableConfigurationSettingsSource\";\nexport { ReadableStreamConfigurationSettingsSource } from \"./settingsImport/readableStreamConfigurationSettingsSource\";"]}

package/dist-esm/src/internal/adaptiveTaskManager.js

@@ -0,0 +1,69 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { BehaviorSubject } from "rxjs";
+/** @internal */
+export class AdaptiveTaskManager {
+    constructor(fn, size) {
+        this.end = false;
+        this.currentMax = 1;
+        this.limitation = 50;
+        this.finishedCount = 0;
+        this.throttledTasks = [];
+        this.runningTasks = new Map();
+        this.taskWrapper = fn;
+        this.observable = new BehaviorSubject(0);
+        this.importProgress = {
+            importCount: size,
+            successCount: 0
+        };
+    }
+    async Start(callback) {
+        return new Promise((resolve, reject) => {
+            this.observable.subscribe((value) => {
+                if (this.end && this.throttledTasks.length == 0) {
+                    if (this.runningTasks.size == 0)
+                        resolve(this.finishedCount);
+                    return;
+                }
+                while (this.runningTasks.size < this.currentMax) {
+                    const task = this.throttledTasks.length > 0 ? this.throttledTasks.pop() : this.taskWrapper();
+                    if (!task) {
+                        this.end = true;
+                        this.observable.next(++value);
+                        return;
+                    }
+                    const runningPromise = task();
+                    runningPromise.then((value) => {
+                        if (value) {
+                            this.importProgress.successCount = ++this.finishedCount;
+                            // If import can complete successfully and it didn't hit the limitation, increase currentMax.
+                            if (this.currentMax < this.limitation && this.runningTasks.size <= this.currentMax)
+                                this.currentMax++;
+                        }
+                    })
+                        .catch((reason) => {
+                        if (reason.statusCode === 429) {
+                            // Once have any request be throttled, relegate the queue max size to 1, and push it into throttled collection.
+                            this.currentMax = 1;
+                            this.throttledTasks.push(this.runningTasks.get(runningPromise));
+                        }
+                        else {
+                            reject(reason);
+                        }
+                    })
+                        .finally(() => {
+                        // remove the promise from the running collection, no matter it's success or not
+                        if (this.runningTasks.has(runningPromise)) {
+                            this.runningTasks.delete(runningPromise);
+                        }
+                        if (callback)
+                            callback(this.importProgress);
+                        this.observable.next(++value); // trigger next round
+                    });
+                    this.runningTasks.set(runningPromise, task);
+                }
+            });
+        });
+    }
+}
+//# sourceMappingURL=adaptiveTaskManager.js.map

package/dist-esm/src/internal/adaptiveTaskManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptiveTaskManager.js","sourceRoot":"","sources":["../../../src/internal/adaptiveTaskManager.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAIvC,gBAAgB;AAChB,MAAM,OAAO,mBAAmB;IAc9B,YAAY,EAAgD,EAAE,IAAY;QAblE,QAAG,GAAG,KAAK,CAAC;QACZ,eAAU,GAAG,CAAC,CAAC;QACf,eAAU,GAAG,EAAE,CAAC;QAChB,kBAAa,GAAG,CAAC,CAAC;QAClB,mBAAc,GAA4B,EAAE,CAAC;QAC7C,iBAAY,GAA2C,IAAI,GAAG,EAGnE,CAAC;QAMF,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,CAAC,cAAc,GAAG;YACpB,WAAW,EAAE,IAAI;YACjB,YAAY,EAAE,CAAC;SAChB,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,QAA2C;QAC5D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,KAAU,EAAE,EAAE;gBACvC,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,IAAI,CAAC,EAAE;oBAC/C,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC;wBAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;oBAC7D,OAAO;iBACR;gBACD,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE;oBAC/C,MAAM,IAAI,GAAsC,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;oBAEhI,IAAI,CAAC,IAAI,EAAE;wBACT,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;wBAChB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;wBAC9B,OAAO;qBACR;oBACD,MAAM,cAAc,GAAG,IAAI,EAAE,CAAC;oBAC9B,cAAc,CAAC,IAAI,CAAC,CAAC,KAAU,EAAQ,EAAE;wBACvC,IAAI,KAAK,EAAE;4BACT,IAAI,CAAC,cAAc,CAAC,YAAY,GAAG,EAAE,IAAI,CAAC,aAAa,CAAC;4BACxD,6FAA6F;4BAC7F,IAAI,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU;gCAAE,IAAI,CAAC,UAAU,EAAE,CAAC;yBACvG;oBACH,CAAC,CAAC;yBACC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE;wBAChB,IAAK,MAAoB,CAAC,UAAU,KAAK,GAAG,EAAE;4BAC5C,+GAA+G;4BAC/G,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;4BACpB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAA0B,CAAC,CAAC;yBAC1F;6BACI;4BACH,MAAM,CAAC,MAAM,CAAC,CAAC;yBAChB;oBACH,CAAC,CAAC;yBACD,OAAO,CAAC,GAAS,EAAE;wBAClB,gFAAgF;wBAChF,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE;4BACzC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;yBAC1C;wBACD,IAAI,QAAQ;4BAAE,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;wBAC5C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,qBAAqB;oBACtD,CAAC,CAAC,CAAC;oBACL,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;iBAC7C;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { BehaviorSubject } from \"rxjs\";\nimport { ImportProgress } from \"../models\";\nimport { RestError } from \"@azure/core-rest-pipeline\";\n\n/** @internal */\nexport class AdaptiveTaskManager<T> {\n  private end = false;\n  private currentMax = 1;\n  private limitation = 50;\n  private finishedCount = 0;\n  private throttledTasks: IFunction<Promise<T>>[] = [];\n  private runningTasks: Map<Promise<T>, IFunction<Promise<T>>> = new Map<\n    Promise<T>,\n    IFunction<Promise<T>>\n  >();\n  private taskWrapper: IFunction<IFunction<Promise<T>> | undefined>;\n  private observable: BehaviorSubject<number>;\n  private importProgress: ImportProgress;\n\n  constructor(fn: IFunction<IFunction<Promise<T>> | undefined>, size: number) {\n    this.taskWrapper = fn;\n    this.observable = new BehaviorSubject(0);\n    this.importProgress = {\n      importCount: size,\n      successCount: 0\n    };\n  }\n\n  public async Start(callback?: (result: ImportProgress) => void) {\n    return new Promise((resolve, reject) => {\n      this.observable.subscribe((value: any) => {\n        if (this.end && this.throttledTasks.length == 0) {\n          if (this.runningTasks.size == 0) resolve(this.finishedCount);\n          return;\n        }\n        while (this.runningTasks.size < this.currentMax) {\n          const task: IFunction<Promise<T>> | undefined = this.throttledTasks.length > 0 ? this.throttledTasks.pop() : this.taskWrapper();\n\n          if (!task) {\n            this.end = true;\n            this.observable.next(++value);\n            return;\n          }\n          const runningPromise = task();\n          runningPromise.then((value: any): void => {\n            if (value) {\n              this.importProgress.successCount = ++this.finishedCount;\n              // If import can complete successfully and it didn't hit the limitation, increase currentMax.\n              if (this.currentMax < this.limitation && this.runningTasks.size <= this.currentMax) this.currentMax++;\n            }\n          })\n            .catch((reason) => {\n              if ((reason as RestError).statusCode === 429) {\n                // Once have any request be throttled, relegate the queue max size to 1, and push it into throttled collection.\n                this.currentMax = 1;\n                this.throttledTasks.push(this.runningTasks.get(runningPromise) as IFunction<Promise<T>>);\n              }\n              else {\n                reject(reason);\n              }\n            })\n            .finally((): void => {\n              // remove the promise from the running collection, no matter it's success or not\n              if (this.runningTasks.has(runningPromise)) {\n                this.runningTasks.delete(runningPromise);\n              }\n              if (callback) callback(this.importProgress);\n              this.observable.next(++value); // trigger next round\n            });\n          this.runningTasks.set(runningPromise, task);\n        }\n      });\n    });\n  }\n}\n\n/** @internal */\nexport interface IFunction<T> {\n  (): T;\n}\n"]}

package/dist-esm/src/internal/constants.js

@@ -0,0 +1,29 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+/** @internal*/
+export const Constants = {
+    FeatureManagementKeyWords: [
+        "FeatureManagement",
+        "featureManagement",
+        "feature_management",
+        "feature-management"
+    ],
+    EnabledForKeyWords: [
+        "EnabledFor",
+        "enabledFor",
+        "enabled_for",
+        "enabled-for"
+    ],
+    Separators: [
+        ".",
+        ",",
+        ";",
+        "-",
+        "_",
+        "__",
+        "/",
+        ":"
+    ],
+    CorrelationRequestIdHeader: "x-ms-correlation-request-id"
+};
+//# sourceMappingURL=constants.js.map

package/dist-esm/src/internal/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/internal/constants.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,eAAe;AACf,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,yBAAyB,EAAE;QACzB,mBAAmB;QACnB,mBAAmB;QACnB,oBAAoB;QACpB,oBAAoB;KACrB;IACD,kBAAkB,EAAE;QAClB,YAAY;QACZ,YAAY;QACZ,aAAa;QACb,aAAa;KACd;IACD,UAAU,EAAE;QACV,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,IAAI;QACJ,GAAG;QACH,GAAG;KACJ;IACD,0BAA0B,EAAE,6BAA6B;CAC1D,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\n/** @internal*/\nexport const Constants = {\n  FeatureManagementKeyWords: [\n    \"FeatureManagement\",\n    \"featureManagement\",\n    \"feature_management\",\n    \"feature-management\"\n  ],\n  EnabledForKeyWords: [\n    \"EnabledFor\",\n    \"enabledFor\",\n    \"enabled_for\",\n    \"enabled-for\"\n  ],\n  Separators: [\n    \".\",\n    \",\",\n    \";\",\n    \"-\",\n    \"_\",\n    \"__\",\n    \"/\",\n    \":\"\n  ],\n  CorrelationRequestIdHeader: \"x-ms-correlation-request-id\"\n};\n"]}

package/dist-esm/src/internal/parsers/configurationSettingsConverter.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+export {};
+//# sourceMappingURL=configurationSettingsConverter.js.map

package/dist-esm/src/internal/parsers/configurationSettingsConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configurationSettingsConverter.js","sourceRoot":"","sources":["../../../../src/internal/parsers/configurationSettingsConverter.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nimport {\n  SetConfigurationSettingParam,\n  FeatureFlagValue,\n  SecretReferenceValue\n} from \"@azure/app-configuration\";\nimport { SourceOptions } from \"../../importOptions\";\n\n/**\n * ConfigurationSettings converter for different configuration content.\n *\n * @internal\n * */\nexport interface ConfigurationSettingsConverter {\n  Convert(\n    rawConfig: object,\n    options?: SourceOptions\n  ): Array<SetConfigurationSettingParam<string | FeatureFlagValue | SecretReferenceValue>>;\n}\n"]}

package/dist-esm/src/internal/parsers/defaultConfigurationSettingsConverter.js

@@ -0,0 +1,200 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+import { featureFlagPrefix, featureFlagContentType } from "@azure/app-configuration";
+import { Constants } from "../constants";
+import { ArgumentError } from "../../errors";
+import * as flat from "flat";
+import { ConfigurationFormat } from "../../enums";
+import { isJsonContentType } from "../utils";
+/**
+ * Format Parser for common key-value configuration.
+ *
+ * @internal
+ * */
+export class DefaultConfigurationSettingsConverter {
+    /**
+     * Parse the raw configuration object to collection of ConfigurationSettings
+     *
+     * @param config Raw configuration object
+     * @param options Configuration options to dictate how the configuration be parsed.
+     * */
+    Convert(config, options) {
+        let configurationSettings = new Array();
+        let featureFlagsConfigSettings = new Array();
+        let foundFeatureManagement = false;
+        let featureFlags = {};
+        let featureManagementKeyWord = "";
+        let enabledForKeyWord = "";
+        if (options.format == ConfigurationFormat.Properties && !options.skipFeatureFlags) {
+            this.checkFeatureManagementExist(config);
+        }
+        for (let i = 0; i < Constants.FeatureManagementKeyWords.length; i++) {
+            if (Constants.FeatureManagementKeyWords[i] in config) {
+                if (foundFeatureManagement) {
+                    throw new ArgumentError("Unable to proceed because data contains multiple sections corresponding to Feature Management.");
+                }
+                featureManagementKeyWord = Constants.FeatureManagementKeyWords[i];
+                enabledForKeyWord = Constants.EnabledForKeyWords[i];
+                const featureManagementKey = featureManagementKeyWord;
+                featureFlags = config[featureManagementKey];
+                delete config[featureManagementKey];
+                foundFeatureManagement = true;
+            }
+        }
+        if (foundFeatureManagement && !options.skipFeatureFlags) {
+            const featureFlagConverter = new FeatureFlagConfigurationSettingsConverter(featureManagementKeyWord, enabledForKeyWord);
+            featureFlagsConfigSettings = featureFlagConverter.Convert(featureFlags, options);
+        }
+        const flattenedConfigurationSettings = flat.flatten(config, {
+            delimiter: options.separator,
+            maxDepth: options.depth,
+            safe: isJsonContentType(options.contentType) // preserve array for json content type
+        });
+        configurationSettings = this.toConfigurationSettings(flattenedConfigurationSettings, options);
+        configurationSettings = configurationSettings.concat(featureFlagsConfigSettings);
+        return configurationSettings;
+    }
+    checkFeatureManagementExist(configurations) {
+        const keys = Object.keys(configurations);
+        for (const featureFlagKeyWord of Constants.FeatureManagementKeyWords) {
+            if (keys.find(key => key.startsWith(featureFlagKeyWord))) {
+                throw new ArgumentError("Importing feature flag in Properties format is not supported. Anything in the Properties format being imported will be treated as key value.");
+            }
+        }
+    }
+    toConfigurationSettings(flatted, options) {
+        const result = new Array();
+        const isJsonType = isJsonContentType(options.contentType);
+        for (const element in flatted) {
+            let generateKey = element;
+            if (options.prefix) {
+                generateKey = options.prefix + element;
+            }
+            if (generateKey === "." || generateKey === ".." || generateKey.indexOf("%") > -1) {
+                throw new ArgumentError("Key cannot be a '.' or '..', or contain the '%' character.");
+            }
+            if (generateKey.startsWith(featureFlagPrefix)) {
+                throw new ArgumentError("Key cannot start with the reserved prefix for feature flags.");
+            }
+            // Ignore key-value with empty array/object value when content-type is not json, instead of pushing a kv with an empty array/obj
+            // For null value it will be treated as "null" string.
+            if (!isJsonType && flatted[element] && typeof flatted[element] === "object" && Object.keys(flatted[element]).length == 0) {
+                continue;
+            }
+            const setting = {
+                label: options.label,
+                tags: options.tags,
+                key: generateKey,
+                contentType: options.contentType,
+                value: typeof flatted[element] === "object" || isJsonType
+                    ? JSON.stringify(flatted[element])
+                    : flatted[element].toString()
+            };
+            result.push(setting);
+        }
+        return result;
+    }
+}
+/**
+ * ConfigurationSettings converter for feature flag.
+ *
+ * @internal
+ * */
+class FeatureFlagConfigurationSettingsConverter {
+    constructor(featureManagementKeyWord, enabledForKeyWord) {
+        this.featureManagementKeyWord = featureManagementKeyWord;
+        this.enabledForKeyWord = enabledForKeyWord;
+        if (!this.featureManagementKeyWord || !this.enabledForKeyWord) {
+            throw new ArgumentError("No feature management was found");
+        }
+    }
+    /**
+     * @inheritdoc
+     * */
+    Convert(config, options) {
+        var _a;
+        const settings = new Array();
+        for (const featureFlag in config) {
+            if (!this.validateFeatureName(featureFlag)) {
+                throw new ArgumentError(`Feature flag ${featureFlag} contains invalid character,'%' and ':' are not allowed in feature name. Please provide valid feature name.`);
+            }
+            const prefix = (_a = options.prefix) !== null && _a !== void 0 ? _a : "";
+            settings.push({
+                key: featureFlagPrefix + prefix + featureFlag,
+                label: options.label,
+                value: this.getFeatureFlagValue(featureFlag, config, this.enabledForKeyWord),
+                contentType: featureFlagContentType,
+                tags: options.tags
+            });
+        }
+        return settings;
+    }
+    validateFeatureName(featureName) {
+        if (featureName) {
+            const valid = /^[^:%]*$/;
+            return valid.test(featureName);
+        }
+        else {
+            return false;
+        }
+    }
+    getFeatureFlagValue(featureFlagName, featureData, enabledForKeyWord) {
+        const defaultFeatureConditions = { clientFilters: [] };
+        const featureFlagValue = {
+            id: featureFlagName,
+            description: "",
+            enabled: false,
+            conditions: {
+                clientFilters: []
+            }
+        };
+        if (typeof featureData[featureFlagName] == "object") {
+            const filters = featureData[featureFlagName][enabledForKeyWord];
+            if (!filters) {
+                throw new ArgumentError(`Data contains feature flags in invalid format. Feature flag '${featureFlagName}' must contain '${enabledForKeyWord}' definition or have a true/false value.`);
+            }
+            if (filters.length != 0) {
+                featureFlagValue.enabled = true;
+                featureFlagValue.conditions.clientFilters = filters;
+                for (let i = 0; i < featureFlagValue.conditions.clientFilters.length; i++) {
+                    const parameters = {};
+                    //
+                    // Converting client_filter keys to lower case
+                    const lowerCaseFilters = this.getLowerCaseFilters(featureFlagValue.conditions.clientFilters[i]);
+                    const filtersName = lowerCaseFilters["name"];
+                    const filtersParameters = lowerCaseFilters["parameters"];
+                    if (filtersName) {
+                        if (filtersName.toLowerCase() == "alwayson") {
+                            featureFlagValue.conditions = defaultFeatureConditions;
+                            break;
+                        }
+                        parameters.name = filtersName;
+                        if (filtersParameters) {
+                            parameters.parameters = filtersParameters;
+                        }
+                        featureFlagValue.conditions.clientFilters[i] = parameters;
+                    }
+                    else {
+                        throw new ArgumentError(`This feature flag '${featureFlagName}' has a filter without the required 'name' property.`);
+                    }
+                }
+            }
+        }
+        else if (typeof featureData[featureFlagName] == "boolean") {
+            featureFlagValue.enabled = featureData[featureFlagName];
+        }
+        else {
+            throw new ArgumentError(`Data contains feature flags in invalid format. The type of ${featureFlagName} should be either boolean or dictionary.`);
+        }
+        return featureFlagValue;
+    }
+    getLowerCaseFilters(clientFilter) {
+        const keys = Object.keys(clientFilter);
+        const lowerCaseFilters = {};
+        for (let i = 0; i < keys.length; i++) {
+            lowerCaseFilters[keys[i].toLowerCase()] = clientFilter[keys[i]];
+        }
+        return lowerCaseFilters;
+    }
+}
+//# sourceMappingURL=defaultConfigurationSettingsConverter.js.map