@microsoft/managed-apps-cli 0.20.0 → 0.21.0

package/dist/Constants/HelpStrings.js

@@ -1,623 +0,0 @@
-/*!
- * Copyright (C) Microsoft Corporation. All rights reserved.
- */
-import { AppConfigFileName } from '@microsoft/managed-apps-common/config';
-import { CLI_BINARY_NAME } from './CliConstants.js';
-export const HelpStrings = {
-    global: {
-        programDescription: `CLI for Microsoft managed apps.`,
-        cloud: 'Cloud environment to target. Valid values include: public, usgov, usgovhigh, usgovdod, china. Defaults to public.',
-    },
-    auth: {
-        login: {
-            description: 'Sign in to Microsoft Entra ID.',
-            examples: [
-                `${CLI_BINARY_NAME} auth login`,
-                `${CLI_BINARY_NAME} auth login --account user@contoso.com`,
-                `${CLI_BINARY_NAME} auth login --device-code`,
-            ],
-            options: {
-                account: 'Username (email) to pre-fill in the browser sign-in prompt. This is a hint passed to the identity provider, not validated against cached accounts — use `auth switch --account` to choose between cached accounts.',
-                deviceCode: 'Sign in using the device code flow instead of opening a browser. Prints a URL and a code to enter on another device — use this on headless machines or over SSH where no browser is available.',
-            },
-        },
-        logout: {
-            description: 'Clear all cached credentials. Removes every cached account and the active-account ' +
-                'pointer. Use `auth switch` to change which cached account is active without logging out.',
-            examples: [`${CLI_BINARY_NAME} auth logout`],
-        },
-        status: {
-            description: 'Show cached accounts. The active account (used by other CLI commands) is marked.',
-            examples: [`${CLI_BINARY_NAME} auth status`, `${CLI_BINARY_NAME} auth status --json`],
-        },
-        switch: {
-            description: 'Choose which cached account other CLI commands run as. When more than one account is cached and --account is omitted, prompts interactively; in non-interactive mode --account is required.',
-            examples: [
-                `${CLI_BINARY_NAME} auth switch`,
-                `${CLI_BINARY_NAME} auth switch --account user@contoso.com`,
-            ],
-            options: {
-                account: 'Username (email) or home account ID of the account to make active.',
-            },
-        },
-    },
-    app: {
-        create: {
-            description: `Create a new managed app and scaffold the app template into an empty target directory. Provisions a platform-managed git repo by default; see --repo to bind an external GitHub repo or skip git scaffolding. To bind an existing project instead, use '${CLI_BINARY_NAME} app init'.`,
-            options: {
-                environmentId: 'Target environment ID for the new managed app (optional).',
-                displayName: 'Display name for the managed app.',
-                description: 'Optional description for the managed app.',
-                repositoryId: 'Repository ID to associate with the managed app for source control.',
-                template: 'GitHub repository or subpath to scaffold the managed app from (e.g. github:owner/repo/subdir). Defaults to github:microsoft/Managed-Apps/templates/vite8. Applies to all --repo modes (native, --repo <url>, and --repo none).',
-                buildPath: 'Path to the build output directory. Defaults to ./dist.',
-                buildCommand: 'Full shell command used to build the app. Defaults to "npm run build".',
-                buildEntryPoint: 'Entry point HTML file for the app. Defaults to index.html.',
-                repo: "Source-control binding for the new app. Omit to use the default platform-managed flow. Pass a repository URL — for example a GitHub Enterprise Cloud tenant URL (e.g. https://myorg.ghe.com/contoso/expense-tracker) or github.com (e.g. https://github.com/contoso/expense-tracker) — to bind to an external repo; the repo must already exist and must be empty, and the CLI clones it into [directory] and overlays the template. The server is the authority on which hosts/schemes are accepted. Pass '--repo none' to skip all git binding: the CLI scaffolds the template and writes ms.config.json into [directory] but does not init a local git repo or bind to a remote. The target directory must be empty in every mode — to bind an existing project to a new app, use 'ms app init' instead. Cannot be combined with --repository-id.",
-                openBrowser: 'Launch the browser to complete the GitHub device code flow during inline GitHub authentication. Default: do not launch. Has no effect when `--json` is set (JSON mode never launches a browser).',
-                forceReauth: 'Bypass the stored GitHub authentication mapping and force re-authentication via device code flow, as if the mapping had expired. Has no effect on apps not bound to an external GitHub repository.',
-            },
-            examples: [
-                `${CLI_BINARY_NAME} app create --display-name "My App" --repository-id <id>`,
-                `${CLI_BINARY_NAME} app create ./my-app --display-name "My App" --repository-id <id>`,
-                `${CLI_BINARY_NAME} app create ./my-app --display-name "My App" --repository-id <id> --description "A description"`,
-                `${CLI_BINARY_NAME} app create ./my-app --display-name "My App" --repo https://myorg.ghe.com/contoso/expense-tracker`,
-                `${CLI_BINARY_NAME} app create ./my-app --display-name "My App" --repo none`,
-            ],
-        },
-        init: {
-            description: `Convert an existing project into a managed app.`,
-            options: {
-                environmentId: 'Target environment ID for the new managed app (optional).',
-                cloud: 'Cloud environment to target. Valid values include: public, usgov, usgovhigh, usgovdod, china. Defaults to public.',
-                displayName: 'Display name for the managed app.',
-                description: 'Optional description for the managed app.',
-                buildPath: 'Path to the build output directory. Defaults to ./dist.',
-                buildCommand: 'Full shell command used to build the app. Defaults to "npm run build".',
-                fileEntryPoint: 'Entry point HTML file for the app. Defaults to index.html.',
-                appUrl: 'Local development URL for the app. Defaults to http://localhost:3000.',
-                buildEntryPoint: 'Entry point HTML file for the app. Defaults to index.html.',
-                repo: "Repository behavior for init. Pass '--repo native' to force a platform-managed repo without inspecting the current git setup. Pass '--repo none' to use BYO build flow (no platform-managed repo). Pass '--repo <repo-url>' to bind to an existing GitHub repo (current directory must already contain the cloned repo). Omit to auto-detect current git setup and prompt in interactive mode.",
-                iconPath: 'Optional path to a .png or .jpg app icon, written to ms.config.json as iconPath.',
-                localAppUrl: 'Optional local development URL for the app, written to ms.config.json as localAppUrl.',
-                openBrowser: 'Launch the browser to complete the GitHub device code flow during inline GitHub authentication. Default: do not launch. Has no effect when `--json` is set (JSON mode never launches a browser).',
-                forceReauth: 'Bypass the stored GitHub authentication mapping and force re-authentication via device code flow, as if the mapping had expired. Has no effect on apps not bound to an external GitHub repository.',
-            },
-            examples: [
-                `${CLI_BINARY_NAME} app init --display-name "My App" --environment-id <id>`,
-                `${CLI_BINARY_NAME} app init --display-name "My App" --environment-id <id> --description "A description"`,
-                `${CLI_BINARY_NAME} app init --display-name "My App" --environment-id <id> --build-path ./out`,
-                `${CLI_BINARY_NAME} app init --display-name "My App" --repo none`,
-                `${CLI_BINARY_NAME} app init --display-name "My App" --repo https://myorg.ghe.com/contoso/expense-tracker`,
-            ],
-        },
-        list: {
-            description: 'List all apps you have access to with play URLs. Interactive text output shows edit access; non-interactive and JSON output include clone URL details when available for edit access. By default returns both edit and play access apps across the tenant; pass --environment-id to filter to a single environment.',
-            options: {
-                environmentId: 'Optional environment ID to scope the listing to. When omitted, all apps the user can access across the tenant are returned.',
-                permission: 'Optional permission filter. Use `edit` for apps the user can contribute to, or `play` for apps the user can play/view. Omit to return both. Case-insensitive.',
-            },
-            examples: [
-                `${CLI_BINARY_NAME} app list`,
-                `${CLI_BINARY_NAME} app list --json`,
-                `${CLI_BINARY_NAME} app list --environment-id <id>`,
-                `${CLI_BINARY_NAME} app list --permission play`,
-            ],
-        },
-        info: {
-            description: `Get details for an app.`,
-            options: {
-                app: 'The app identifier to retrieve (logical name or app ID GUID).',
-                environmentId: `Override the environment ID. Defaults to environmentId in ${AppConfigFileName}; when neither is set, the environment is resolved automatically from the app identifier.`,
-            },
-            examples: [
-                `${CLI_BINARY_NAME} app info --app my-app`,
-                `${CLI_BINARY_NAME} app info --app <guid>`,
-                `${CLI_BINARY_NAME} app info --app my-app --json`,
-            ],
-        },
-        show: {
-            description: `Show an app's configuration and bound resources.`,
-            examples: [`${CLI_BINARY_NAME} app show`, `${CLI_BINARY_NAME} app show --json`],
-        },
-        delete: {
-            description: 'Delete an app. Soft-deletes the app and cleans up related metadata.',
-            options: {
-                app: `The app name to delete. Defaults to the current app in ${AppConfigFileName}.`,
-                environmentId: 'Override the environment ID. When omitted, the environment is resolved automatically from the app. Useful for deleting an app from outside its scaffolded directory.',
-                force: 'Skip the confirmation prompt.',
-            },
-            examples: [
-                `${CLI_BINARY_NAME} app delete`,
-                `${CLI_BINARY_NAME} app delete --app my-app`,
-                `${CLI_BINARY_NAME} app delete --app my-app --environment-id <id> --force`,
-                `${CLI_BINARY_NAME} app delete --json --force`,
-            ],
-        },
-        share: {
-            description: 'Share an app with users or groups. Provide one or more users or groups as a comma-separated list of email addresses or Entra (AAD) object IDs. Use --access play (default) to grant play access to the app, or --access edit to grant edit access to the underlying repository. To distribute access via a tenant-wide link instead of named users or groups, use `ms app share link create` (run `ms app share link --help` for the full link surface).',
-            options: {
-                app: `The app name to share. Defaults to the current app in ${AppConfigFileName}.`,
-                access: 'Access level to grant: "play" (default — run the app) or "edit" (modify the app).',
-            },
-            examples: [
-                `${CLI_BINARY_NAME} app share alice@contoso.com,bob@contoso.com`,
-                `${CLI_BINARY_NAME} app share --app my-app <aad-id>`,
-                `${CLI_BINARY_NAME} app share alice@contoso.com --access edit`,
-                `${CLI_BINARY_NAME} app share alice@contoso.com --json`,
-                `${CLI_BINARY_NAME} app share link create`,
-            ],
-            list: {
-                description: 'List the users and groups an app is shared with at a given access level.',
-                options: {
-                    app: `The app name. Defaults to the current app in ${AppConfigFileName}.`,
-                    environmentId: `Override the environment ID. Defaults to environmentId in ${AppConfigFileName}.`,
-                    access: 'Access level to list (required): "play" (run the app) or "edit" (modify the app).',
-                },
-                examples: [
-                    `${CLI_BINARY_NAME} app share list --access play`,
-                    `${CLI_BINARY_NAME} app share list --access edit`,
-                    `${CLI_BINARY_NAME} app share list --access edit --app my-app`,
-                    `${CLI_BINARY_NAME} app share list --access play --json`,
-                ],
-            },
-        },
-        unshare: {
-            description: 'Unshare an app from users or groups. Provide one or more users or groups as a comma-separated list of email addresses or Entra (AAD) object IDs. Use --access play (default) to revoke play access on the app, or --access edit to revoke edit access on the underlying repository. Each invocation only touches the requested access level.',
-            options: {
-                app: `The app name to unshare. Defaults to the current app in ${AppConfigFileName}.`,
-                access: 'Access level to revoke: "play" (default — app access) or "edit" (repository access).',
-            },
-            examples: [
-                `${CLI_BINARY_NAME} app unshare alice@contoso.com,bob@contoso.com`,
-                `${CLI_BINARY_NAME} app unshare --app my-app <aad-id>`,
-                `${CLI_BINARY_NAME} app unshare alice@contoso.com --access edit`,
-                `${CLI_BINARY_NAME} app unshare alice@contoso.com --json`,
-            ],
-        },
-        shareLink: {
-            description: 'Manage tenant-wide share links for a managed app. A share link is a JIT-redemption URL: the first time a recipient opens it, they are granted the configured role at the app scope. Links can be listed and revoked at any time.',
-            create: {
-                description: `Create a share link for a managed app. The link grants the "Microsoft App Reader" role at the app scope on redemption. Only this role is supported today; the enum is open server-side for future expansion.`,
-                options: {
-                    app: `The app name to share. Defaults to the current app in ${AppConfigFileName}.`,
-                    environmentId: `Override the environment ID. Defaults to environmentId in ${AppConfigFileName}.`,
-                },
-                examples: [
-                    `${CLI_BINARY_NAME} app share link create`,
-                    `${CLI_BINARY_NAME} app share link create --app my-app`,
-                    `${CLI_BINARY_NAME} app share link create --json`,
-                ],
-            },
-            list: {
-                description: 'List all share links currently issued for a managed app.',
-                options: {
-                    app: `The app name. Defaults to the current app in ${AppConfigFileName}.`,
-                    environmentId: `Override the environment ID. Defaults to environmentId in ${AppConfigFileName}.`,
-                },
-                examples: [
-                    `${CLI_BINARY_NAME} app share link list`,
-                    `${CLI_BINARY_NAME} app share link list --app my-app`,
-                    `${CLI_BINARY_NAME} app share link list --json`,
-                ],
-            },
-            revoke: {
-                description: 'Revoke a share link by ID. The server attempts to remove the role assignment for every prior redeemer before tearing down the link record; new recipients can no longer redeem the link.',
-                options: {
-                    app: `The app name. Defaults to the current app in ${AppConfigFileName}.`,
-                    environmentId: `Override the environment ID. Defaults to environmentId in ${AppConfigFileName}.`,
-                    linkId: 'The share link ID (4-char lowercase hex) returned at creation time.',
-                    force: 'Skip the confirmation prompt.',
-                },
-                examples: [
-                    `${CLI_BINARY_NAME} app share link revoke --link-id a3f1`,
-                    `${CLI_BINARY_NAME} app share link revoke --link-id a3f1 --force`,
-                    `${CLI_BINARY_NAME} app share link revoke --link-id a3f1 --app my-app --json`,
-                ],
-            },
-        },
-        build: {
-            description: 'Initiate a build for an app. By default the CLI waits for build-status to reach a terminal state; pass --no-wait to return immediately after submission.',
-            options: {
-                appName: 'The app name to build.',
-                commitSha: 'The commit ID to build from.',
-                openBrowser: 'Launch the browser to complete the GitHub device code flow during inline GitHub authentication. Default: do not launch. Has no effect when `--json` is set (JSON mode never launches a browser). Only relevant for apps bound to an external GitHub repository.',
-                noWait: 'Return immediately after submitting the build and print a build-status hint.',
-                forceReauth: 'Bypass the stored GitHub authentication mapping and force re-authentication via device code flow, as if the mapping had expired. Has no effect on apps not bound to an external GitHub repository.',
-            },
-            examples: [
-                `${CLI_BINARY_NAME} app build --app my-app --commit abc1234`,
-                `${CLI_BINARY_NAME} app build --app my-app --commit abc1234 --no-wait`,
-                `${CLI_BINARY_NAME} app build --app my-app --commit abc1234 --json`,
-            ],
-        },
-        buildStatus: {
-            description: 'Check the status of a build.',
-            options: {
-                appName: 'The app name.',
-                commitSha: 'The commit ID for which a build was initiated by app build.',
-                showLog: 'Fetch and print the build log when available.',
-            },
-            examples: [
-                `${CLI_BINARY_NAME} app build-status --app my-app --commit <sha>`,
-                `${CLI_BINARY_NAME} app build-status --app my-app --commit <sha> --show-log`,
-                `${CLI_BINARY_NAME} app build-status --app my-app --commit <sha> --json`,
-            ],
-        },
-        deploy: {
-            description: `Build and deploy an app to live. Behavior depends on the app's repoType in ${AppConfigFileName}: git-backed apps (native/github) deploy a commit (default HEAD; override with --commit). External-artifact apps (repoType: 'none') pack and upload locally, or upload a pre-built .zip when --artifact is supplied.`,
-            options: {
-                app: `The app name to deploy. Defaults to the current app in ${AppConfigFileName}.`,
-                commit: 'The commit ID to deploy (git-backed apps only). Defaults to the commit at HEAD.',
-                artifact: "Path to a local .zip build artifact to upload and deploy. Only valid for apps created with repoType: 'none'; rejected on git-backed apps. Mutually exclusive with --commit.",
-                force: 'Deploy even when the working tree has uncommitted changes or local main is ahead of origin/main. Skips the confirmation prompt in interactive mode and the validation error in non-interactive mode.',
-                openBrowser: 'Launch the browser to complete the GitHub device code flow during inline GitHub authentication. Default: do not launch. Has no effect when `--json` is set (JSON mode never launches a browser). Only relevant for apps bound to an external GitHub repository.',
-                forceReauth: 'Bypass the stored GitHub authentication mapping and force re-authentication via device code flow, as if the mapping had expired. Has no effect on apps not bound to an external GitHub repository.',
-            },
-            examples: [
-                `${CLI_BINARY_NAME} app deploy`,
-                `${CLI_BINARY_NAME} app deploy --app my-app --commit abc1234`,
-                `${CLI_BINARY_NAME} app deploy --force`,
-                `${CLI_BINARY_NAME} app deploy --artifact ./build.zip`,
-                `${CLI_BINARY_NAME} app deploy --app my-app --commit abc1234 --json`,
-            ],
-        },
-        pack: {
-            description: `Build the app and copy the output to .ms/packed/apps/<appId>/client/ for local inspection.`,
-            examples: [`${CLI_BINARY_NAME} app pack`],
-        },
-        play: {
-            description: `Open a managed app in the browser. Use --mode live (default) to launch the deployed version, or --mode preview to preview the app on the main branch, or the provided commit ID.`,
-            options: {
-                app: `The app name to play. Defaults to the current app in ${AppConfigFileName}.`,
-                mode: `Which app to open: 'live' (default — the deployed version) or 'preview'.`,
-                commit: `Preview mode only. The commit ID to open. When omitted, defaults to HEAD on main.`,
-                noBrowser: `Print the URL but do not open a browser window.`,
-            },
-            examples: [
-                `${CLI_BINARY_NAME} app play`,
-                `${CLI_BINARY_NAME} app play --mode preview`,
-                `${CLI_BINARY_NAME} app play --mode preview --commit abc1234`,
-                `${CLI_BINARY_NAME} app play --app my-app --no-browser`,
-                `${CLI_BINARY_NAME} app play --json`,
-            ],
-        },
-        dev: {
-            description: `Start local development.`,
-            options: {
-                port: 'Port number for the local config server.',
-                localAppUrl: 'Local URL where the app is running.',
-                configOnly: 'Start only the config server without running the dev script. Use this if you want to manage your dev server separately.',
-            },
-            examples: [
-                `${CLI_BINARY_NAME} app dev`,
-                `${CLI_BINARY_NAME} app dev --port 8080 --local-app-url http://localhost:3000`,
-                `${CLI_BINARY_NAME} app dev --local-app-url http://localhost:3000 --config-only`,
-            ],
-        },
-        refresh: {
-            description: `Refresh data sources in an app.`,
-            dataSource: {
-                description: `Re-fetch data source metadata from the service and regenerate TypeScript.`,
-                options: {
-                    offline: "Regenerate TypeScript from the local schemas in '.ms/schemas' without contacting the service (no network or authentication). Omit to re-fetch metadata from the service and regenerate.",
-                    name: 'Name of a specific data source to refresh. Omit to refresh all.',
-                },
-                examples: [
-                    `${CLI_BINARY_NAME} app refresh data-source`,
-                    `${CLI_BINARY_NAME} app refresh data-source --name teams`,
-                    `${CLI_BINARY_NAME} app refresh data-source --offline`,
-                ],
-            },
-        },
-        add: {
-            description: `Add a data source to the current app.`,
-            options: {
-                connector: 'Connector identifier.',
-                connectionId: 'Connection identifier.',
-                connectionRef: 'Connection reference name.',
-                resourceName: 'Table or resource name.',
-                dataset: 'Dataset identifier.',
-                sqlStoredProcedure: 'SQL stored procedure name.',
-                solutionId: 'Solution identifier.',
-                skipCodegen: 'Skip TypeScript code generation after adding the data source.',
-            },
-            examples: [
-                `${CLI_BINARY_NAME} app add data-source --connector shared_office365`,
-                `${CLI_BINARY_NAME} app add table --connector shared_sql --connection-id <id> --dataset <db> --table <tbl>`,
-                `${CLI_BINARY_NAME} app add procedure --connector shared_sql --connection-id <id> --dataset <db>`,
-            ],
-            action: {
-                description: 'Add a connector to the app as an action data source.',
-                options: {
-                    connector: 'Connector identifier (e.g. shared_office365).',
-                    connectionId: 'Connection identifier. Required for multi-auth connectors; prompted interactively when omitted.',
-                    skipCodegen: 'Skip TypeScript code generation after adding the connector.',
-                },
-                examples: [
-                    `${CLI_BINARY_NAME} app add action --connector shared_office365`,
-                    `${CLI_BINARY_NAME} app add action --connector shared_sql --connection-id <id>`,
-                    `${CLI_BINARY_NAME} app add action --connector shared_office365 --skip-codegen`,
-                ],
-            },
-            table: {
-                description: 'Add a connector table to the app as a tabular data source.',
-                options: {
-                    connector: 'Connector identifier (e.g. shared_sql, shared_sharepointonline).',
-                    connectionId: 'Connection ID to use. If omitted, you will be prompted to select one.',
-                    dataset: 'Dataset name (e.g. a SQL server/database or SharePoint site URL). If omitted, you will be prompted.',
-                    table: 'Table name. If omitted, you will be prompted to select one.',
-                    skipCodegen: 'Skip TypeScript model service generation after adding the table.',
-                },
-                examples: [
-                    `${CLI_BINARY_NAME} app add table --connector shared_sql`,
-                    `${CLI_BINARY_NAME} app add table --connector shared_sql --connection-id <id> --dataset <db> --table <tbl>`,
-                    `${CLI_BINARY_NAME} app add table --connector shared_sharepointonline --skip-codegen`,
-                ],
-            },
-            connector: {
-                description: 'Add a data source (a connector table or action) to the app.',
-                options: {
-                    connector: 'Connector ID (e.g. shared_office365, shared_sql) or display name (e.g. "Office 365 Users"). Run `ms connector list` to browse connectors.',
-                    connectionId: 'Connection ID to use. If omitted: interactive mode prompts you to pick or create one; ' +
-                        'non-interactive mode reuses your only connection, silently creates one for connectors ' +
-                        'whose sole authentication type is single sign-on when none exist, or errors when the ' +
-                        'choice is ambiguous. Pass --use-sso to reuse an existing SSO connection (or silently ' +
-                        'create one) for any SSO-capable connector, not just SSO-only ones.',
-                    dataset: 'Dataset name (only used when adding as a table). If omitted in table mode, you will be prompted.',
-                    table: 'Table name. In table mode this is the table name within the dataset. With --connector shared_commondataserviceforapps it is the Dataverse table logical name (e.g. account). If omitted, you will be prompted.',
-                    as: 'Force the dispatch to "table" or "action". Required in non-interactive mode when the connector supports tables.',
-                    dataverseEnvironmentId: 'Dataverse environment ID (GUID). Only used with --connector shared_commondataserviceforapps to bind to a specific table.',
-                    useSso: 'Prefer a single sign-on (Entra ID) connection: reuse the first existing SSO connection ' +
-                        'when one exists, otherwise silently create one. Works even when the connector offers other ' +
-                        'authentication types. Errors if the connector is not SSO-capable. Ignored when ' +
-                        '--connection-id is supplied.',
-                    skipCodegen: 'Skip TypeScript code generation after adding the data source.',
-                },
-                examples: [
-                    `${CLI_BINARY_NAME} app add data-source --connector shared_office365`,
-                    `${CLI_BINARY_NAME} app add data-source --connector "Office 365 Users"`,
-                    `${CLI_BINARY_NAME} app add data-source --connector shared_sql --as table --connection-id <id> --dataset <db> --table <tbl>`,
-                    `${CLI_BINARY_NAME} app add data-source --connector "SQL Server" --as table --connection-id <id> --dataset <db> --table <tbl>`,
-                    `${CLI_BINARY_NAME} app add data-source --connector shared_sharepointonline --as action`,
-                    `${CLI_BINARY_NAME} app add data-source --connector "SharePoint" --as action`,
-                    `${CLI_BINARY_NAME} app add data-source --connector shared_office365 --as action --use-sso`,
-                    `${CLI_BINARY_NAME} app add data-source --connector shared_sql --as table --skip-codegen`,
-                    `${CLI_BINARY_NAME} app add data-source --connector shared_commondataserviceforapps --as action --connection-id <id> --dataverse-environment-id <env-guid> --table account`,
-                ],
-                deprecation: `(deprecated) '${CLI_BINARY_NAME} app add connector' is deprecated. Use '${CLI_BINARY_NAME} app add data-source' instead.`,
-                deprecatedExamples: [
-                    `${CLI_BINARY_NAME} app add connector --connector shared_office365`,
-                    `${CLI_BINARY_NAME} app add connector --connector shared_sql --as table --connection-id <id> --dataset <db> --table <tbl>`,
-                    `${CLI_BINARY_NAME} app add connector --connector shared_sharepointonline --as action`,
-                    `${CLI_BINARY_NAME} app add connector --connector shared_sql --as table --skip-codegen`,
-                    `${CLI_BINARY_NAME} app add connector --connector shared_commondataserviceforapps --as action --connection-id <id> --dataverse-environment-id <env-guid> --table account`,
-                ],
-            },
-        },
-        remove: {
-            description: `Remove a data source (table or action) from the app.`,
-            options: {
-                dataSourceName: 'Name of the data source to remove.',
-                force: 'Skip confirmation prompt.',
-            },
-            examples: [
-                `${CLI_BINARY_NAME} app remove data-source`,
-                `${CLI_BINARY_NAME} app remove data-source --name documents`,
-                `${CLI_BINARY_NAME} app remove data-source --name orders --force`,
-            ],
-            deprecation: `(deprecated) '${CLI_BINARY_NAME} app remove connector' is deprecated. Use '${CLI_BINARY_NAME} app remove data-source' instead.`,
-            deprecatedExamples: [
-                `${CLI_BINARY_NAME} app remove connector`,
-                `${CLI_BINARY_NAME} app remove connector --name documents`,
-                `${CLI_BINARY_NAME} app remove connector --name orders --force`,
-            ],
-        },
-        'get-settings': {
-            description: 'View all app settings.',
-            examples: [
-                `${CLI_BINARY_NAME} app get-settings`,
-                `${CLI_BINARY_NAME} app get-settings --json`,
-            ],
-        },
-        'set-setting': {
-            description: `Update app settings. Changes are written to ${AppConfigFileName} and take effect the next time you run '${CLI_BINARY_NAME} app dev' or '${CLI_BINARY_NAME} app deploy'.`,
-            options: {
-                'show-header': 'Show or hide the app header bar (true or false).',
-            },
-            examples: [`${CLI_BINARY_NAME} app set-setting --show-header false`],
-        },
-    },
-    connector: {
-        list: {
-            description: 'List connectors available in the environment. By default all connectors are shown, including those blocked by tenant policy; pass --only-allowed to list only connectors allowed by tenant policy.',
-            hint: 'Use the value in the "Connector" column as the ID (e.g. shared_office365), or pass the display name directly (e.g. "Office 365 Users") to add commands.',
-            options: {
-                environmentId: 'Environment ID (optional).',
-                search: 'Filter connectors by display name or connector ID (case-insensitive).',
-                onlyAllowed: 'List only connectors allowed by tenant policy. By default all connectors are listed, including blocked ones.',
-            },
-            examples: [
-                `${CLI_BINARY_NAME} connector list`,
-                `${CLI_BINARY_NAME} connector list --search "sql"`,
-                `${CLI_BINARY_NAME} connector list --only-allowed`,
-                `${CLI_BINARY_NAME} connector list --environment-id <env-id>`,
-                `${CLI_BINARY_NAME} connector list --json`,
-            ],
-        },
-        'list-actions': {
-            description: 'List actions available on a connector with their policy behavior.',
-            options: {
-                connector: 'Connector identifier (e.g. shared_office365).',
-                environmentId: 'Environment ID (optional).',
-                search: 'Filter actions by summary or action ID (case-insensitive).',
-            },
-            examples: [
-                `${CLI_BINARY_NAME} connector list-actions --connector shared_office365`,
-                `${CLI_BINARY_NAME} connector list-actions --connector shared_sql --search "execute"`,
-                `${CLI_BINARY_NAME} connector list-actions --connector shared_office365 --environment-id <env-id>`,
-                `${CLI_BINARY_NAME} connector list-actions --connector shared_office365 --json`,
-            ],
-        },
-    },
-    telemetry: {
-        enable: {
-            description: 'Enable telemetry collection. Defaults to --remote if no target is specified.',
-            options: {
-                remote: 'Enable sending telemetry to the cloud service (default).',
-                console: 'Enable outputting telemetry to the local console.',
-            },
-            examples: [
-                `${CLI_BINARY_NAME} telemetry enable`,
-                `${CLI_BINARY_NAME} telemetry enable --console`,
-                `${CLI_BINARY_NAME} telemetry enable --remote --console`,
-            ],
-        },
-        disable: {
-            description: 'Disable telemetry collection. Defaults to --remote if no target is specified.',
-            options: {
-                remote: 'Disable sending telemetry to the cloud service (default).',
-                console: 'Disable outputting telemetry to the local console.',
-            },
-            examples: [
-                `${CLI_BINARY_NAME} telemetry disable`,
-                `${CLI_BINARY_NAME} telemetry disable --console`,
-                `${CLI_BINARY_NAME} telemetry disable --remote --console`,
-            ],
-        },
-        status: {
-            description: 'Show the current telemetry settings.',
-            examples: [
-                `${CLI_BINARY_NAME} telemetry status`,
-                `${CLI_BINARY_NAME} telemetry status --json`,
-            ],
-        },
-    },
-    /**
-     * @deprecated Strings referenced only by verb files that are no longer wired to the
-     * command tree (AddFlow, BuildMaafApp, GetMaafBuildStatus, ListConnectionReferences,
-     * ListDatasets, ListEnvironmentVariables, ListFlows, ListSqlStoredProcedures, ListTables,
-     * RemoveFlow). Delete this entire block when those files are removed.
-     */
-    deprecated: {
-        Verbs: {
-            'Add-flow': {
-                Description: `Add a cloud flow to the current app by flow ID.`,
-                Options: {
-                    FlowId: 'The unique identifier (GUID) of the flow to add.',
-                },
-            },
-            'Build-app': {
-                Description: 'Initiate a build for the app. By default waits for the build to reach a terminal state; pass --no-wait to return immediately after submission.',
-                Options: {
-                    AppName: 'The app name to build.',
-                    CommitSha: 'The commit ID to build. Defaults to the commit at HEAD.',
-                    NoWait: 'Return immediately after submitting the build.',
-                },
-                Examples: [
-                    `${CLI_BINARY_NAME} app build --app my-app --commit abc1234`,
-                    `${CLI_BINARY_NAME} app build --app my-app --commit abc1234 --no-wait`,
-                    `${CLI_BINARY_NAME} app build --app my-app --commit abc1234 --json`,
-                ],
-            },
-            'Get-build-status': {
-                Description: 'Get the status of an app build operation.',
-                Options: {
-                    AppName: 'The app name.',
-                    CommitSha: 'The commit ID for which a build was initiated by app build.',
-                },
-                Examples: [
-                    `${CLI_BINARY_NAME} app build-status --app my-app --commit <sha>`,
-                    `${CLI_BINARY_NAME} app build-status --app my-app --commit <sha> --json`,
-                ],
-            },
-            'List-connection-references': {
-                Description: 'List all connection references in the environment.',
-                Options: {
-                    SolutionId: 'Solution identifier to filter by.',
-                },
-                Examples: [
-                    `${CLI_BINARY_NAME} connection list-references`,
-                    `${CLI_BINARY_NAME} connection list-references --json`,
-                ],
-            },
-            'List-datasets': {
-                Description: 'List all datasets for a connection.',
-                Options: {
-                    Connector: 'Connector identifier.',
-                    Connection: 'Connection identifier.',
-                },
-                Examples: [
-                    `${CLI_BINARY_NAME} connection list-datasets --connector shared_sql --connection <id>`,
-                    `${CLI_BINARY_NAME} connection list-datasets --connector shared_sql --connection <id> --json`,
-                ],
-            },
-            'List-environment-variables': {
-                Description: 'List all environment variables in the environment.',
-                Examples: [
-                    `${CLI_BINARY_NAME} environment list-variables`,
-                    `${CLI_BINARY_NAME} environment list-variables --json`,
-                ],
-            },
-            'List-flows': {
-                Description: 'List all solution cloud flows that are invokable from the app.',
-                Options: {
-                    Search: 'Filter flows by name (case-insensitive substring match)',
-                },
-                Examples: [
-                    `${CLI_BINARY_NAME} app list-flows`,
-                    `${CLI_BINARY_NAME} app list-flows --search "approval" --json`,
-                ],
-            },
-            'List-sqlStoredProcedures': {
-                Description: 'List all SQL stored procedures for a dataset.',
-                Options: {
-                    Connection: 'Connection identifier.',
-                    Dataset: 'Dataset name.',
-                },
-                Examples: [
-                    `${CLI_BINARY_NAME} connection list-procedures --connection <id> --dataset <db>`,
-                    `${CLI_BINARY_NAME} connection list-procedures --connection <id> --dataset <db> --json`,
-                ],
-            },
-            'List-tables': {
-                Description: 'List all tables for a dataset.',
-                Options: {
-                    Connector: 'Connector identifier.',
-                    Connection: 'Connection identifier.',
-                    Dataset: 'Dataset name.',
-                },
-                Examples: [
-                    `${CLI_BINARY_NAME} connection list-tables --connector shared_sql --connection <id> --dataset <db>`,
-                    `${CLI_BINARY_NAME} connection list-tables --connector shared_sql --connection <id> --dataset <db> --json`,
-                ],
-            },
-            'Remove-flow': {
-                Description: `Remove a cloud flow from the current app.`,
-                Options: {
-                    FlowDataSourceName: 'The flow data source name to remove (as it appears in ms.config). Provide either this or --flow-id.',
-                    FlowId: 'The flow resource ID (GUID) to remove — same ID used with app add flow. Provide either this or --flow-name.',
-                },
-            },
-        },
-    },
-    git: {
-        auth: {
-            refresh: {
-                description: 'Authenticate against a GitHub repository so subsequent app create / deploy / preview / build ' +
-                    'commands targeting that repo know your GitHub identity. Runs the GitHub device code flow via ' +
-                    'the Managed Apps GitHub App; no GitHub token is stored locally.',
-                options: {
-                    repo: 'GitHub repository URL (e.g. https://contoso.ghe.com/contoso/my-app or https://github.com/contoso/my-app). The Managed Apps GitHub App is the only supported provider; the server enforces which hosts/tenants are accepted.',
-                    openBrowser: 'Launch the browser to complete the GitHub device code flow. Default: do not launch.',
-                },
-                examples: [
-                    `${CLI_BINARY_NAME} git auth refresh --repo https://contoso.ghe.com/contoso/my-app`,
-                    `${CLI_BINARY_NAME} git auth refresh -r https://contoso.ghe.com/contoso/my-app --open-browser`,
-                    `${CLI_BINARY_NAME} git auth refresh --repo https://contoso.ghe.com/contoso/my-app --json`,
-                ],
-            },
-        },
-    },
-};
-//# sourceMappingURL=HelpStrings.js.map