@microsoft/apps-cli 0.0.1 → 0.4.0

package/dist/Logger/Scrubber/ScrubCustomDimensionsConfig.js

@@ -0,0 +1,168 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { containsEmail, containsGoogleApiKey, containsSasKeySig, containsSymmKey256, } from './ScrubUtils.js';
+const EmailScrubConfig = {
+    scrubberName: 'email',
+    shouldScrubValue: containsEmail,
+};
+const GoogleApiKeyScrubConfig = {
+    scrubberName: 'googleApiKey',
+    shouldScrubValue: containsGoogleApiKey,
+};
+const SasKeySigScrubConfig = {
+    scrubberName: 'sasKeySig',
+    shouldScrubValue: containsSasKeySig,
+};
+const SymmKey256ScrubConfig = {
+    scrubberName: 'symmKey256',
+    shouldScrubValue: containsSymmKey256,
+};
+/** A scrub config list for handling events with sas keys. Currently this just scrubs the sig */
+const SasKeyScrubConfigList = [SasKeySigScrubConfig];
+/**
+ * This configuration is a mapping of Record<event_Name, EventConfig>
+ */
+export const EventsToScrubConfig = {
+    'AppHostClientSDK.getCanvasAppMetadataAsync': {
+        '*': SasKeyScrubConfigList,
+    },
+    'AppModuleMetadataProvider.getCanvasAppMetadataAsync.Failure': {
+        '*': SasKeyScrubConfigList,
+    },
+    'AppModuleMetadataProvider.getRootAppMetadataAsync.Failure': {
+        '*': SasKeyScrubConfigList,
+    },
+    CustomPageInlineRendering: {
+        '*': SasKeyScrubConfigList,
+    },
+    'DefaultCanvasAppContainer.renderAsync': {
+        '*': SasKeyScrubConfigList,
+    },
+    'FilePluginService.GetFileOrDirectory': {
+        '*': SasKeyScrubConfigList,
+    },
+    'Player.CanvasAppGlue.openErrorDialog': {
+        '*': SasKeyScrubConfigList,
+    },
+    'PlayerCordovaPlugin.onPluginRequestFailure': {
+        '*': SasKeyScrubConfigList,
+    },
+    'PowerAppsClient.Activity': {
+        operations: {
+            'App.disposeAsync': SasKeyScrubConfigList,
+            'GlobalControlProperty.setModelValueInternal': SasKeyScrubConfigList,
+            'IDataRuntime.reportRuntimeError': SasKeyScrubConfigList,
+            'IDataRuntime.tryCreateGatedReportRuntimeError': [
+                GoogleApiKeyScrubConfig,
+                SasKeySigScrubConfig,
+            ],
+            'PassThroughWebUriResolver.getAsBinaryAsync': SasKeyScrubConfigList,
+            'PerEndpointRetryPipeline._xhrWithRetryAsync': SasKeyScrubConfigList,
+            'Player.AppCatalog.GetAppDetailByIDSuccess': SasKeyScrubConfigList,
+            'Player.CanvasAppGlue.exitAppHost': SasKeyScrubConfigList,
+            'Player.CustomBranding.RPResponse': SasKeyScrubConfigList,
+            'Player.CustomBranding.Save': SasKeyScrubConfigList,
+            'Player.PublishedApp.Open.AppInfo': SasKeyScrubConfigList,
+            'Player.PublishedApp.WebServer.Start': SasKeyScrubConfigList,
+            'PlayerLifecycle.WebPlayer.Play.ErrorPage': SasKeyScrubConfigList,
+            'PowerAppsClient.PcfComponent.Failure': SasKeyScrubConfigList,
+            'PowerAppsClient.Performance.PerformanceObserver': SasKeyScrubConfigList,
+            'PowerAppsEmbedding.Automation.Player': SasKeyScrubConfigList,
+            'CachedQueryDataProvider._onDataDownloaded': [EmailScrubConfig],
+            'CachedQueryDataProvider._getDataForExpiredCacheAsync': [EmailScrubConfig],
+        },
+    },
+    'PowerAppsClient.AllApps.App.DismissedWithError': {
+        '*': SasKeyScrubConfigList,
+    },
+    'PowerAppsClient.App.GalleryPagingManagerError': {
+        '*': SasKeyScrubConfigList,
+    },
+    'PowerAppsClient.ControlsActivity': {
+        operations: {
+            'Attachments.OnView': SasKeyScrubConfigList,
+        },
+    },
+    'PowerAppsClient.EndScenario': {
+        scenarios: {
+            'PowerAppsClient.Scenario.ContextLoadApp': SasKeyScrubConfigList,
+            'PowerAppsClient.Scenario.DocumentVmInitialize': SasKeyScrubConfigList,
+            'PowerAppsClient.Scenario.ScreenCreation': SasKeyScrubConfigList,
+            'PlayerLifecycle.PlayerSDK.PlayApp.LoadApp.CreateAppFrame': SasKeyScrubConfigList,
+            'PlayerLifecycle.PlayerSDK.PlayApp.LoadApp': SasKeyScrubConfigList,
+            'PlayerLifecycle.PlayerSDK.PlayApp.LoadMetadata.FetchAppPackageMetadata': SasKeyScrubConfigList,
+            'PlayerLifecycle.PlayerSDK.PlayApp': SasKeyScrubConfigList,
+            'PlayerLifecycle.WebPlayer.Play.PlayApp': SasKeyScrubConfigList,
+            'PlayerLifecycle.WebPlayer.Play': SasKeyScrubConfigList,
+            'PowerAppsClient.Scenario.CachedQueryDataProviderNotify': [EmailScrubConfig],
+        },
+    },
+    'PowerAppsClient.Error': {
+        operations: {
+            'AppInfoParser.parseAppInfo': SasKeyScrubConfigList,
+            'AppLifecyclePlugin.notifyAppFailed': SasKeyScrubConfigList,
+            'AttachmentsView._viewItem': SasKeyScrubConfigList,
+            'BaseWebPlayerHost._onAppFailure': SasKeyScrubConfigList,
+            'Context.loadAppAsync': SasKeyScrubConfigList,
+            'DocumentViewModel.initializeAsync': SasKeyScrubConfigList,
+            'GeneratedCode.ReportAndContinue': SasKeyScrubConfigList,
+            'MediaRuntime.getMediaAsBinaryAsync': SasKeyScrubConfigList,
+            'NestedAppModuleMetadataProvider.getCanvasAppMetadataAsync.Failure': SasKeyScrubConfigList,
+            'Player.SessionSummary.Failure': SasKeyScrubConfigList,
+            'PlayerLaunchService.playerLaunchAppAsync': SasKeyScrubConfigList,
+            'PlayerPublishedApp._onInitializationError': SasKeyScrubConfigList,
+            'PowerAppsClient.PublishedApp.ErrorLoadingScript': SasKeyScrubConfigList,
+            'PublishedAppHostActions.handleErrorDuringInstall': SasKeyScrubConfigList,
+            'PublishedAppInstance.runAllScreensInitFnsAsync': SasKeyScrubConfigList,
+            'RNSendHttpPipeline._performXhrRequestAsync': [SymmKey256ScrubConfig],
+            'RequirementsManager.loadRequirement': SasKeyScrubConfigList,
+            'runtimebase._onCallFailed': SasKeyScrubConfigList,
+            'Text._validateTextWithCharacters': SasKeyScrubConfigList,
+            'Url.constructor': SasKeyScrubConfigList,
+        },
+    },
+    'PowerAppsClient.Functions.InternalError': {
+        '*': SasKeyScrubConfigList,
+    },
+    'PowerAppsClient.MessageDialog.Dismissed': {
+        operations: {
+            'Studio.Reducers.STUDIO_UPDATE_CONNECTION_TABLES_LOADING_ERROR_INFO': SasKeyScrubConfigList,
+        },
+    },
+    'PowerAppsClient.MessageDialog.ShowAsync': {
+        operations: {
+            'Studio.Reducers.STUDIO_UPDATE_CONNECTION_TABLES_LOADING_ERROR_INFO': SasKeyScrubConfigList,
+        },
+    },
+    'PowerAppsClient.StartScenario': {
+        scenarios: {
+            'PowerAppsClient.Scenario.CachedQueryDataProviderNotify': [EmailScrubConfig],
+        },
+    },
+    'PowerAppsClient.Verbose': {
+        operations: {
+            'ReactRedux.HandleActionsWithReset': SasKeyScrubConfigList,
+        },
+    },
+    'PowerAppsClient.WebPlayer.Load': {
+        operations: {
+            'PowerAppsClient._notifyAppFailed': SasKeyScrubConfigList,
+            'PowerAppsClient.AppDetailsRetriever._getAppDetailsInternal.Failure': SasKeyScrubConfigList,
+            'PowerAppsClient.ResourcePathResolution': SasKeyScrubConfigList,
+        },
+    },
+    'PublishedAppLoader.ScriptError': {
+        operations: {
+            'GlobalErrorHandler:UnhandledError': SasKeyScrubConfigList,
+            'PowerAppsClient.AppDetailsRetriever._getAppDetailsInternal.Failure': SasKeyScrubConfigList,
+        },
+    },
+    'RuntimeTelemetry.logException': {
+        '*': SasKeyScrubConfigList,
+    },
+    'TestOrchestrator.setupTestsAsync': {
+        '*': SasKeyScrubConfigList,
+    },
+};
+//# sourceMappingURL=ScrubCustomDimensionsConfig.js.map

package/dist/Logger/Scrubber/ScrubCustomDimensionsConfig.js.map

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

package/dist/Logger/Scrubber/ScrubUtils.d.ts

@@ -0,0 +1,8 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+export declare function containsEmail(value: string): boolean;
+export declare function containsGoogleApiKey(value: string): boolean;
+export declare function containsSasKeySig(value: string): boolean;
+export declare function containsSymmKey256(value: string): boolean;
+//# sourceMappingURL=ScrubUtils.d.ts.map

package/dist/Logger/Scrubber/ScrubUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrubUtils.d.ts","sourceRoot":"","sources":["../../../src/Logger/Scrubber/ScrubUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyBH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/dist/Logger/Scrubber/ScrubUtils.js

@@ -0,0 +1,34 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+// These values should align with cred scan: https://msazure.visualstudio.com/One/_git/SecEng-CredScan-Core?path=/KnowledgeBase/Prefilter/CredScan-Kusto-UDF.kql
+const GoogleApiKeyRegex = /AIza[a-z0-9_\\-]{35}/i;
+const SymmKey256Regex = /[a-z0-9\/+]{43}=/i; // eslint-disable-line no-useless-escape
+// Regex adapted from CredScan:
+// https://dev.azure.com/msazure/One/_git/SecEng-CredScan-Core?path=/KnowledgeBase/samples/CredScanClientHelloWorld/Security.SharedStrings.Internal.txt&version=GC0612bfb7be3c3f60b1896992118f1a110013320d&line=225&lineEnd=226&lineStartColumn=1&lineEndColumn=1&lineStyle=plain&_a=contents
+// Modifications from original:
+// 1. Converted from PCRE to JS regex
+// 2. Replaced named captures with non-capturing groups
+// 3. Remove the URL and just leave the sig=
+// 4. Add _ and & to the negated char (handles sig=_scrubbedSensitiveData_)
+// 5. Require 8 characters after the sig= (handles things like sig=43chars)
+const SasKeyRegex = /(?:dsas_secret|sig)=[^#\)\(<>\r\n\s'",\\_&]{8}/i; // eslint-disable-line no-useless-escape
+// RFC 6530 spec  https://tools.ietf.org/html/rfc6530
+// A nice set of test cases: http://isemail.info/_system/is_email/test/?all
+// How to compile ranges of Unicode characters that are likely to be used in email addresses: http://apps.timwhitlock.info/js/regex
+/* eslint-disable no-misleading-character-class, no-useless-escape */
+const emailRegExp = new RegExp(/[a-zA-Z0-9\u0080-\u00FF\u0100-\u017F\u0180-\u024F\u0250-\u02AF\u0300-\u036F\u0370-\u03FF\u0400-\u04FF\u0500-\u052F\u0530-\u058F\u0590-\u05FF\u0600-\u06FF\u0700-\u074F\u0750-\u077F\u0780-\u07BF\u07C0-\u07FF\u0900-\u097F\u0980-\u09FF\u0A00-\u0A7F\u0A80-\u0AFF\u0B00-\u0B7F\u0B80-\u0BFF\u0C00-\u0C7F\u0C80-\u0CFF\u0D00-\u0D7F\u0D80-\u0DFF\u0E00-\u0E7F\u0E80-\u0EFF\u0F00-\u0FFF\u1000-\u109F\u10A0-\u10FF\u1100-\u11FF\u1200-\u137F\u1380-\u139F\u13A0-\u13FF\u1400-\u167F\u1680-\u169F\u16A0-\u16FF\u1700-\u171F\u1720-\u173F\u1740-\u175F\u1760-\u177F\u1780-\u17FF\u1800-\u18AF\u1900-\u194F\u1950-\u197F\u1980-\u19DF\u19E0-\u19FF\u1A00-\u1A1F\u1B00-\u1B7F\u1D00-\u1D7F\u1D80-\u1DBF\u1DC0-\u1DFF\u1E00-\u1EFF\u1F00-\u1FFF\u20D0-\u20FF\u2100-\u214F\u2C00-\u2C5F\u2C60-\u2C7F\u2C80-\u2CFF\u2D00-\u2D2F\u2D30-\u2D7F\u2D80-\u2DDF\u2F00-\u2FDF\u2FF0-\u2FFF\u3040-\u309F\u30A0-\u30FF\u3100-\u312F\u3130-\u318F\u3190-\u319F\u31C0-\u31EF\u31F0-\u31FF\u3200-\u32FF\u3300-\u33FF\u3400-\u4DBF\u4DC0-\u4DFF\u4E00-\u9FFF\uA000-\uA48F\uA490-\uA4CF\uA700-\uA71F\uA800-\uA82F\uA840-\uA87F\uAC00-\uD7AF\uF900-\uFAFF\.!#$%&'*+?^_{|}~\-\d]+(@|%40)[a-zA-Z0-9\u0080-\u00FF\u0100-\u017F\u0180-\u024F\u0250-\u02AF\u0300-\u036F\u0370-\u03FF\u0400-\u04FF\u0500-\u052F\u0530-\u058F\u0590-\u05FF\u0600-\u06FF\u0700-\u074F\u0750-\u077F\u0780-\u07BF\u07C0-\u07FF\u0900-\u097F\u0980-\u09FF\u0A00-\u0A7F\u0A80-\u0AFF\u0B00-\u0B7F\u0B80-\u0BFF\u0C00-\u0C7F\u0C80-\u0CFF\u0D00-\u0D7F\u0D80-\u0DFF\u0E00-\u0E7F\u0E80-\u0EFF\u0F00-\u0FFF\u1000-\u109F\u10A0-\u10FF\u1100-\u11FF\u1200-\u137F\u1380-\u139F\u13A0-\u13FF\u1400-\u167F\u1680-\u169F\u16A0-\u16FF\u1700-\u171F\u1720-\u173F\u1740-\u175F\u1760-\u177F\u1780-\u17FF\u1800-\u18AF\u1900-\u194F\u1950-\u197F\u1980-\u19DF\u19E0-\u19FF\u1A00-\u1A1F\u1B00-\u1B7F\u1D00-\u1D7F\u1D80-\u1DBF\u1DC0-\u1DFF\u1E00-\u1EFF\u1F00-\u1FFF\u20D0-\u20FF\u2100-\u214F\u2C00-\u2C5F\u2C60-\u2C7F\u2C80-\u2CFF\u2D00-\u2D2F\u2D30-\u2D7F\u2D80-\u2DDF\u2F00-\u2FDF\u2FF0-\u2FFF\u3040-\u309F\u30A0-\u30FF\u3100-\u312F\u3130-\u318F\u3190-\u319F\u31C0-\u31EF\u31F0-\u31FF\u3200-\u32FF\u3300-\u33FF\u3400-\u4DBF\u4DC0-\u4DFF\u4E00-\u9FFF\uA000-\uA48F\uA490-\uA4CF\uA700-\uA71F\uA800-\uA82F\uA840-\uA87F\uAC00-\uD7AF\uF900-\uFAFF\-\.\d]+\.[a-zA-Z\u0080-\u00FF\u0100-\u017F\u0180-\u024F\u0250-\u02AF\u0300-\u036F\u0370-\u03FF\u0400-\u04FF\u0500-\u052F\u0530-\u058F\u0590-\u05FF\u0600-\u06FF\u0700-\u074F\u0750-\u077F\u0780-\u07BF\u07C0-\u07FF\u0900-\u097F\u0980-\u09FF\u0A00-\u0A7F\u0A80-\u0AFF\u0B00-\u0B7F\u0B80-\u0BFF\u0C00-\u0C7F\u0C80-\u0CFF\u0D00-\u0D7F\u0D80-\u0DFF\u0E00-\u0E7F\u0E80-\u0EFF\u0F00-\u0FFF\u1000-\u109F\u10A0-\u10FF\u1100-\u11FF\u1200-\u137F\u1380-\u139F\u13A0-\u13FF\u1400-\u167F\u1680-\u169F\u16A0-\u16FF\u1700-\u171F\u1720-\u173F\u1740-\u175F\u1760-\u177F\u1780-\u17FF\u1800-\u18AF\u1900-\u194F\u1950-\u197F\u1980-\u19DF\u19E0-\u19FF\u1A00-\u1A1F\u1B00-\u1B7F\u1D00-\u1D7F\u1D80-\u1DBF\u1DC0-\u1DFF\u1E00-\u1EFF\u1F00-\u1FFF\u20D0-\u20FF\u2100-\u214F\u2C00-\u2C5F\u2C60-\u2C7F\u2C80-\u2CFF\u2D00-\u2D2F\u2D30-\u2D7F\u2D80-\u2DDF\u2F00-\u2FDF\u2FF0-\u2FFF\u3040-\u309F\u30A0-\u30FF\u3100-\u312F\u3130-\u318F\u3190-\u319F\u31C0-\u31EF\u31F0-\u31FF\u3200-\u32FF\u3300-\u33FF\u3400-\u4DBF\u4DC0-\u4DFF\u4E00-\u9FFF\uA000-\uA48F\uA490-\uA4CF\uA700-\uA71F\uA800-\uA82F\uA840-\uA87F\uAC00-\uD7AF\uF900-\uFAFF]{2,63}/);
+/* eslint-enable no-misleading-character-class, no-useless-escape */
+export function containsEmail(value) {
+    return emailRegExp.test(value);
+}
+export function containsGoogleApiKey(value) {
+    return GoogleApiKeyRegex.test(value);
+}
+export function containsSasKeySig(value) {
+    return SasKeyRegex.test(value);
+}
+export function containsSymmKey256(value) {
+    return SymmKey256Regex.test(value);
+}
+//# sourceMappingURL=ScrubUtils.js.map

package/dist/Logger/Scrubber/ScrubUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrubUtils.js","sourceRoot":"","sources":["../../../src/Logger/Scrubber/ScrubUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gKAAgK;AAChK,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AAClD,MAAM,eAAe,GAAG,mBAAmB,CAAC,CAAC,wCAAwC;AAErF,+BAA+B;AAC/B,6RAA6R;AAC7R,+BAA+B;AAC/B,qCAAqC;AACrC,uDAAuD;AACvD,4CAA4C;AAC5C,2EAA2E;AAC3E,2EAA2E;AAC3E,MAAM,WAAW,GAAG,iDAAiD,CAAC,CAAC,wCAAwC;AAE/G,qDAAqD;AACrD,2EAA2E;AAC3E,mIAAmI;AACnI,qEAAqE;AACrE,MAAM,WAAW,GAAG,IAAI,MAAM,CAC5B,ivGAAivG,CAClvG,CAAC;AACF,oEAAoE;AAEpE,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC"}

package/dist/Types/Argument.types.d.ts

@@ -0,0 +1,27 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { CliEnvVarName } from '../Utils/EnvVars.js';
+export type DefaultStringOption = CliOption & {
+    message: string;
+    initialValue?: string;
+};
+export type Flags = {
+    key: string;
+    alias?: string;
+};
+export interface CliOption<T = unknown> {
+    flags: Flags;
+    /**
+     * Optional env-var fallback. When set, ArgumentProvider.getOption() reads `process.env[env]`
+     * if no flag value was supplied. Omit for flags that intentionally have no env-var override
+     * (e.g. flags with their own dedicated debug env var resolved out-of-band).
+     */
+    env?: CliEnvVarName;
+    description?: string;
+    default?: T;
+    customPrompt?: () => Promise<T>;
+    optionalInNonInteractive?: boolean;
+    hidden?: boolean;
+}
+//# sourceMappingURL=Argument.types.d.ts.map

package/dist/Types/Argument.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Argument.types.d.ts","sourceRoot":"","sources":["../../src/Types/Argument.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,KAAK,EAAE,KAAK,CAAC;IACb;;;;OAIG;IACH,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IAGhC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAEnC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/Types/Argument.types.js

@@ -0,0 +1,5 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+export {};
+//# sourceMappingURL=Argument.types.js.map

package/dist/Types/Argument.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Argument.types.js","sourceRoot":"","sources":["../../src/Types/Argument.types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/Types/Cli.types.d.ts

@@ -0,0 +1,32 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { AppConfig } from '@microsoft/apps-common/config';
+import type { Region } from '@microsoft/apps-common/services';
+import type { CliFS } from '../FS/CliFs.js';
+export interface IAuthenticationProvider {
+    initAsync(region: Region): Promise<void>;
+    getAccessTokenForResource(resource: string, loginHint?: string): Promise<string>;
+    getUserTenantId(): string | undefined;
+    /** Returns the cached account email without triggering interactive login. */
+    getCachedAccountAsync(): Promise<string | undefined>;
+}
+export type CliSettings = {
+    source: 'pac-cli' | 'standalone';
+    interactive: boolean;
+    fileConfig: LocalFilePaths;
+    cliFs: CliFS;
+    appConfig?: AppConfig;
+};
+export type LocalFilePaths = {
+    appConfigPath: string;
+    schemaPath: string;
+    codeGenPath: string;
+};
+export type UserTelemetrySettings = {
+    /** Whether to send telemetry to the remote cloud service. */
+    remote: boolean;
+    /** Whether to output telemetry locally to the console. */
+    console: boolean;
+};
+//# sourceMappingURL=Cli.types.d.ts.map

package/dist/Types/Cli.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cli.types.d.ts","sourceRoot":"","sources":["../../src/Types/Cli.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAE9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjF,eAAe,IAAI,MAAM,GAAG,SAAS,CAAC;IACtC,6EAA6E;IAC7E,qBAAqB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACtD;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,SAAS,GAAG,YAAY,CAAC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,cAAc,CAAC;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,6DAA6D;IAC7D,MAAM,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC"}

package/dist/Types/Cli.types.js

@@ -0,0 +1,5 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+export {};
+//# sourceMappingURL=Cli.types.js.map

package/dist/Types/Cli.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cli.types.js","sourceRoot":"","sources":["../../src/Types/Cli.types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/Types/Command.types.d.ts

@@ -0,0 +1,52 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { ArgumentProvider } from '../ArgumentProvider.js';
+/** Handler function signature — matches existing verb async functions */
+export type CommandHandler = (argumentProvider: ArgumentProvider) => Promise<void>;
+/** A command path, e.g., ['app', 'init'] or ['app', 'add', 'table'] */
+export type CommandPath = readonly string[];
+/** A leaf command with handler and help text. */
+export interface LeafCommandDef {
+    '@helpText': string;
+    handler: CommandHandler;
+}
+/**
+ * A typed verb group where the third token selects the subcommand type.
+ * e.g. `app add table` — 'add' is the verb, 'table' is the type.
+ */
+export interface TypedVerbDef {
+    typed: true;
+    commands: Record<string, LeafCommandDef>;
+}
+/** Type guard — narrows a verb entry to TypedVerbDef. */
+export declare function isTypedVerbDef(entry: LeafCommandDef | TypedVerbDef): entry is TypedVerbDef;
+/** A noun group with its description and command map. */
+export interface NounDef {
+    '@description': string;
+    commands: Record<string, LeafCommandDef | TypedVerbDef>;
+}
+/**
+ * The set of valid top-level noun keys.
+ * Keeping this as a string literal union ensures that:
+ * - `CommandTree` requires all nouns to be defined (exhaustive)
+ * - Index access with an unvalidated string is a compile-time error
+ * Update this union whenever a noun is added to or removed from COMMAND_TREE.
+ */
+export type NounKey = 'auth' | 'app' | 'connector' | 'telemetry';
+/**
+ * The full command tree (noun → verb → [type →] command).
+ *
+ * All commands live under a noun — there are no top-level global commands.
+ */
+export type CommandTree = Record<NounKey, NounDef>;
+/** Result of resolving argv tokens against the command tree */
+export interface ResolvedCommand {
+    /** The matched command path, e.g. ['app', 'init'] or ['app', 'add', 'table'] */
+    path: CommandPath;
+    /** The handler function to invoke */
+    handler: CommandHandler;
+    /** Number of argv tokens consumed by the command path (2 or 3) */
+    tokensConsumed: number;
+}
+//# sourceMappingURL=Command.types.d.ts.map

package/dist/Types/Command.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Command.types.d.ts","sourceRoot":"","sources":["../../src/Types/Command.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,yEAAyE;AACzE,MAAM,MAAM,cAAc,GAAG,CAAC,gBAAgB,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnF,uEAAuE;AACvE,MAAM,MAAM,WAAW,GAAG,SAAS,MAAM,EAAE,CAAC;AAI5C,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,IAAI,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC1C;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,GAAG,KAAK,IAAI,YAAY,CAE1F;AAED,yDAAyD;AACzD,MAAM,WAAW,OAAO;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC;CACzD;AAED;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC;AAEjE;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAEnD,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,IAAI,EAAE,WAAW,CAAC;IAClB,qCAAqC;IACrC,OAAO,EAAE,cAAc,CAAC;IACxB,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/dist/Types/Command.types.js

@@ -0,0 +1,8 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/** Type guard — narrows a verb entry to TypedVerbDef. */
+export function isTypedVerbDef(entry) {
+    return entry.typed === true;
+}
+//# sourceMappingURL=Command.types.js.map

package/dist/Types/Command.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Command.types.js","sourceRoot":"","sources":["../../src/Types/Command.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2BH,yDAAyD;AACzD,MAAM,UAAU,cAAc,CAAC,KAAoC;IACjE,OAAQ,KAAsB,CAAC,KAAK,KAAK,IAAI,CAAC;AAChD,CAAC"}

package/dist/Types/Datasource.types.d.ts

@@ -0,0 +1,43 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+interface DataverseDataSource {
+    entitySetName: string;
+    logicalName: string;
+    isHidden: boolean;
+}
+interface DataSet {
+    dataSources: Record<string, {
+        tableName?: string;
+    }>;
+    datasetOverride?: {
+        environmentVariableName: string;
+    };
+}
+interface ConnectionReference {
+    id: string;
+    displayName: string;
+    dataSources: string[];
+    authenticationType?: string;
+    sharedConnectionId?: string;
+    dataSets?: Record<string, DataSet>;
+    xrmConnectionReferenceLogicalName?: string | undefined;
+}
+interface TabularMetadata {
+    dataset: string;
+    resourceName: string;
+    isProcedure: boolean;
+    friendlyName?: string;
+    datasetOverride?: string;
+    resourceNameOverride?: string;
+}
+interface DatabaseReference {
+    state: string;
+    instanceUrl: string;
+    webApiVersion: string;
+    dataSources: Record<string, DataverseDataSource>;
+    version: string;
+    environmentVariableName: string;
+}
+export type { ConnectionReference, DatabaseReference, DataSet, DataverseDataSource, TabularMetadata, };
+//# sourceMappingURL=Datasource.types.d.ts.map

package/dist/Types/Datasource.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Datasource.types.d.ts","sourceRoot":"","sources":["../../src/Types/Datasource.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,UAAU,mBAAmB;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,OAAO;IACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,eAAe,CAAC,EAAE;QAAE,uBAAuB,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAED,UAAU,mBAAmB;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,iCAAiC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxD;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,UAAU,iBAAiB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,OAAO,EACP,mBAAmB,EACnB,eAAe,GAChB,CAAC"}

package/dist/Types/Datasource.types.js

@@ -0,0 +1,5 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+export {};
+//# sourceMappingURL=Datasource.types.js.map

package/dist/Types/Datasource.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Datasource.types.js","sourceRoot":"","sources":["../../src/Types/Datasource.types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/Types/LoggerTypes.types.d.ts

@@ -0,0 +1,17 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * Interface for writers used by the logger to write telemetry data
+ */
+export interface ITelemetryWriter {
+    trackActivityEvent(eventName: string, eventData?: object): void;
+    trackErrorEvent(eventName: string, eventData?: object): void;
+    startScenario(scenarioName: string, startData?: object): void;
+    completeScenario(scenarioName: string, completeData?: object): void;
+    scenarioFailed(scenarioName: string, failureData?: object): void;
+    scenarioCompletedWithError(scenarioName: string, completeWithErrorData?: object): void;
+    flush(): Promise<void>;
+    setCustomDimension(_key: string, _value: string): void;
+}
+//# sourceMappingURL=LoggerTypes.types.d.ts.map

package/dist/Types/LoggerTypes.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoggerTypes.types.d.ts","sourceRoot":"","sources":["../../src/Types/LoggerTypes.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChE,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7D,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpE,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjE,0BAA0B,CAAC,YAAY,EAAE,MAAM,EAAE,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACxD"}

package/dist/Types/LoggerTypes.types.js

@@ -0,0 +1,5 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+export {};
+//# sourceMappingURL=LoggerTypes.types.js.map

package/dist/Types/LoggerTypes.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoggerTypes.types.js","sourceRoot":"","sources":["../../src/Types/LoggerTypes.types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/Utils/BuildVerbDescriptionTable.d.ts

@@ -0,0 +1,19 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * Builds the global help table showing all noun groups.
+ * Used when `--help` is invoked without a subcommand.
+ */
+export declare function buildVerbDescriptionTable(): string;
+/**
+ * Builds help text for a specific noun group.
+ * Shows all commands under that noun (direct and typed-subcommand).
+ */
+export declare function buildNounHelpText(noun: string): string;
+/**
+ * Builds help text for a typed subcommand verb (e.g., `app add`).
+ * Lists the available types.
+ */
+export declare function buildTypedSubcommandHelpText(noun: string, verb: string): string;
+//# sourceMappingURL=BuildVerbDescriptionTable.d.ts.map

package/dist/Utils/BuildVerbDescriptionTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuildVerbDescriptionTable.d.ts","sourceRoot":"","sources":["../../src/Utils/BuildVerbDescriptionTable.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAkBlD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA4CtD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAmB/E"}

package/dist/Utils/BuildVerbDescriptionTable.js

@@ -0,0 +1,87 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { CLI_BINARY_NAME } from '../Constants/CliConstants.js';
+import { COMMAND_TREE } from '../Constants/CommandRegistry.js';
+import { isTypedVerbDef } from '../Types/Command.types.js';
+import { isKnownNoun } from './ResolveCommand.js';
+/** Renders a two-column label/helpText table under a title heading. */
+function appendTable(lines, title, entries) {
+    const maxLen = Math.max(...entries.map(([label]) => label.length));
+    const colWidth = Math.max(maxLen + 2, 10);
+    lines.push(title);
+    for (const [label, helpText] of entries) {
+        lines.push(`  ${label.padEnd(colWidth)}  ${helpText}`);
+    }
+}
+/**
+ * Builds the global help table showing all noun groups.
+ * Used when `--help` is invoked without a subcommand.
+ */
+export function buildVerbDescriptionTable() {
+    const lines = [];
+    const nouns = Object.entries(COMMAND_TREE);
+    if (nouns.length > 0) {
+        const maxNounLen = Math.max(...nouns.map(([name]) => name.length));
+        const nounColWidth = Math.max(maxNounLen + 2, 10);
+        lines.push('Command Groups:');
+        lines.push('');
+        for (const [name, nounDef] of nouns) {
+            lines.push(`  ${name.padEnd(nounColWidth)}  ${nounDef['@description']}`);
+        }
+        lines.push('');
+        lines.push(`Run '${CLI_BINARY_NAME} <group> --help' for commands within a group.`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Builds help text for a specific noun group.
+ * Shows all commands under that noun (direct and typed-subcommand).
+ */
+export function buildNounHelpText(noun) {
+    if (!isKnownNoun(noun, COMMAND_TREE))
+        return '';
+    const nounDef = COMMAND_TREE[noun];
+    const lines = [];
+    lines.push(`Usage: ${CLI_BINARY_NAME} ${noun} <command> [flags]`);
+    lines.push('');
+    lines.push(nounDef['@description']);
+    lines.push('');
+    const directEntries = Object.entries(nounDef.commands).filter(([, entry]) => !isTypedVerbDef(entry));
+    const typedEntries = Object.entries(nounDef.commands).filter(([, entry]) => isTypedVerbDef(entry));
+    if (directEntries.length > 0) {
+        appendTable(lines, 'Commands:', directEntries.map(([name, leafDef]) => [name, leafDef['@helpText']]));
+    }
+    if (typedEntries.length > 0) {
+        lines.push('');
+        for (const [verb, typedVerbDef] of typedEntries) {
+            appendTable(lines, `${verb} <type>:`, Object.entries(typedVerbDef.commands).map(([type, leafDef]) => [
+                `${verb} ${type}`,
+                leafDef['@helpText'],
+            ]));
+        }
+    }
+    lines.push('');
+    lines.push(`Run '${CLI_BINARY_NAME} ${noun} <command> --help' for command-specific flags.`);
+    return lines.join('\n');
+}
+/**
+ * Builds help text for a typed subcommand verb (e.g., `app add`).
+ * Lists the available types.
+ */
+export function buildTypedSubcommandHelpText(noun, verb) {
+    if (!isKnownNoun(noun, COMMAND_TREE))
+        return '';
+    const nounDef = COMMAND_TREE[noun];
+    const verbEntry = nounDef.commands[verb];
+    if (!verbEntry || !isTypedVerbDef(verbEntry))
+        return '';
+    const lines = [];
+    lines.push(`Usage: ${CLI_BINARY_NAME} ${noun} ${verb} <type> [flags]`);
+    lines.push('');
+    appendTable(lines, 'Types:', Object.entries(verbEntry.commands).map(([type, leafDef]) => [type, leafDef['@helpText']]));
+    lines.push('');
+    lines.push(`Run '${CLI_BINARY_NAME} ${noun} ${verb} <type> --help' for type-specific flags.`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=BuildVerbDescriptionTable.js.map

package/dist/Utils/BuildVerbDescriptionTable.js.map

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