@microsoft/cmr-cli 0.0.0-stage → 0.32.3

package/dist/chunk-HOIFXUTG.js

@@ -0,0 +1,11 @@
+import { createRequire as __createRequire } from 'node:module';
+import { fileURLToPath as __fileURLToPath } from 'node:url';
+import { dirname as __pathDirname } from 'node:path';
+const require = __createRequire(import.meta.url);
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import{a as t}from"./chunk-KKC5ZK4D.js";var n={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:[`${"ms"} auth login`,`${"ms"} auth login --account user@contoso.com`,`${"ms"} 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 \u2014 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 \u2014 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:[`${"ms"} auth logout`]},status:{description:"Show cached accounts. The active account (used by other CLI commands) is marked.",examples:[`${"ms"} auth status`,`${"ms"} 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:[`${"ms"} auth switch`,`${"ms"} auth switch --account user@contoso.com`],options:{account:"Username (email) or home account ID of the account to make active."}}},app:{clone:{description:"Clone an existing app with a platform-managed repository into an empty target directory, which defaults to the app display name, and configure Git Credential Manager. To use the current directory, specify a single period. Apps bound to external repositories or without source control are not supported.",options:{app:"App ID (GUID) of the app to clone.",environmentId:"Environment ID containing the app (optional)."},examples:[`${"ms"} app clone --app <app-id>`,`${"ms"} app clone ./my-app --app <app-id>`,`${"ms"} app clone --app <app-id> .`]},create:{description:`Create a new managed app and scaffold the app template into a target directory, which defaults to the app display name. Native and no-repo targets ignore common OS metadata, and the default native flow supports the current managed-project root. External-repository targets must be empty. Provisions a platform-managed git repo by default; see --repo to bind an external GitHub repo or skip git scaffolding. To use the current directory, specify '.'. To bind any other existing project instead, use '${"ms"} 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.",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.",buildType:"Build behavior for the generated app config: build runs the build command; none packages prebuilt files from the build path without running a build command. Values are case-insensitive.",repo:"Source-control binding for the new app. Omit to use the default platform-managed flow, which supports the current managed-project root. Pass a repository URL \u2014 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) \u2014 to bind to an external repo; the repo must already exist and the local target must be strictly empty because the CLI clones into it before overlaying the template. The server is the authority on which hosts/schemes are accepted. Pass '--repo none' to skip all git binding: the CLI writes ms.config.json and scaffolds the template into [directory]. Native and no-repo targets ignore common OS metadata. To bind any other 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:[`${"ms"} app create --display-name "My App" --repository-id <id>`,`${"ms"} app create ./my-app --display-name "My App" --repository-id <id>`,`${"ms"} app create ./my-app --display-name "My App" --repository-id <id> --description "A description"`,`${"ms"} app create ./my-app --display-name "My App" --repo https://myorg.ghe.com/contoso/expense-tracker`,`${"ms"} 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.",buildType:"Build behavior for the generated app config: build runs the build command; none packages prebuilt files from the build path without running a build command. Values are case-insensitive.",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:[`${"ms"} app init --display-name "My App" --environment-id <id>`,`${"ms"} app init --display-name "My App" --environment-id <id> --description "A description"`,`${"ms"} app init --display-name "My App" --environment-id <id> --build-path ./out`,`${"ms"} app init --display-name "My App" --repo none`,`${"ms"} 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:[`${"ms"} app list`,`${"ms"} app list --json`,`${"ms"} app list --environment-id <id>`,`${"ms"} app list --permission play`]},info:{description:"Show an app's configuration and bound resources.",options:{app:`The app identifier to retrieve (logical name or app ID GUID). Defaults to the current app in ${t}.`,environmentId:`Override the environment ID. Defaults to environmentId in ${t}; when neither is set, the environment is resolved automatically from the app identifier.`},examples:[`${"ms"} app info --app my-app`,`${"ms"} app info --app <guid>`,`${"ms"} app info --app my-app --json`]},show:{deprecation:`(deprecated) '${"ms"} app show' is deprecated. Use '${"ms"} app info' instead.`,examples:[`${"ms"} app show`,`${"ms"} 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 ${t}.`,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:[`${"ms"} app delete`,`${"ms"} app delete --app my-app`,`${"ms"} app delete --app my-app --environment-id <id> --force`,`${"ms"} app delete --json --force`]},share:{description:"Share an app with users, groups, or service principals. Provide a comma-separated list of user or group email addresses or object IDs. Service principals must be specified by object ID, not application (client) ID. Use --access play (default) to grant play access, --access edit to grant edit access, or --access test to grant test operator access. To distribute access via a tenant-wide link instead of named principals, 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 ${t}.`,access:'Access level to grant: "play" (default), "edit", or "test" (test operator access).'},examples:[`${"ms"} app share alice@contoso.com,bob@contoso.com`,`${"ms"} app share --app my-app <object-id>`,`${"ms"} app share <service-principal-object-id>`,`${"ms"} app share alice@contoso.com --access edit`,`${"ms"} app share alice@contoso.com --json`,`${"ms"} app share link create`],list:{description:"List the users, groups, and service principals an app is shared with at a given access level.",options:{app:`The app name. Defaults to the current app in ${t}.`,environmentId:`Override the environment ID. Defaults to environmentId in ${t}.`,access:'Access level to list (required): "play", "edit", or "test" (test operator access).'},examples:[`${"ms"} app share list --access play`,`${"ms"} app share list --access edit`,`${"ms"} app share list --access edit --app my-app`,`${"ms"} app share list --access play --json`]}},unshare:{description:"Unshare an app from users, groups, or service principals. Provide a comma-separated list of user or group email addresses or object IDs. Service principals must be specified by object ID, not application (client) ID. Use --access play (default) to revoke play access, --access edit to revoke edit access, or --access test to revoke test operator access. Each invocation only touches the requested access level.",options:{app:`The app name to unshare. Defaults to the current app in ${t}.`,access:'Access level to revoke: "play" (default), "edit", or "test" (test operator access).'},examples:[`${"ms"} app unshare alice@contoso.com,bob@contoso.com`,`${"ms"} app unshare --app my-app <object-id>`,`${"ms"} app unshare alice@contoso.com --access edit`,`${"ms"} 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 ${t}.`,environmentId:`Override the environment ID. Defaults to environmentId in ${t}.`},examples:[`${"ms"} app share link create`,`${"ms"} app share link create --app my-app`,`${"ms"} 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 ${t}.`,environmentId:`Override the environment ID. Defaults to environmentId in ${t}.`},examples:[`${"ms"} app share link list`,`${"ms"} app share link list --app my-app`,`${"ms"} 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 ${t}.`,environmentId:`Override the environment ID. Defaults to environmentId in ${t}.`,linkId:"The share link ID (4-char lowercase hex) returned at creation time.",force:"Skip the confirmation prompt."},examples:[`${"ms"} app share link revoke --link-id a3f1`,`${"ms"} app share link revoke --link-id a3f1 --force`,`${"ms"} 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. Abbreviated hexadecimal Git commit IDs are expanded locally.",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:[`${"ms"} app build --app my-app --commit abc1234`,`${"ms"} app build --app my-app --commit abc1234 --no-wait`,`${"ms"} 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. Abbreviated hexadecimal Git commit IDs are expanded locally.",showLog:"Fetch and print the build log when available."},examples:[`${"ms"} app build-status --app my-app --commit <sha>`,`${"ms"} app build-status --app my-app --commit <sha> --show-log`,`${"ms"} 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 ${t}: 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. By default the CLI waits until deployment completes. With Managed DevOps, it instead returns a deployment ID when human approval is required; enable the projects feature and pass --no-wait to return immediately after submission.`,options:{app:`The app name to deploy. Defaults to the current app in ${t}.`,commit:"The commit ID to deploy (git-backed apps only). Abbreviated hexadecimal Git commit IDs are expanded locally. 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.",target:"Target to deploy to: 'prod' or 'test'. The 'test' target must already be registered with `ms app add config --target test`. Defaults to 'prod'.",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.",noWait:"With the projects feature enabled, return immediately after deployment submission and print the deployment ID without polling for completion or approval.",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:[`${"ms"} app deploy`,`${"ms"} app deploy --app my-app --commit abc1234`,`${"ms"} app deploy --force`,`${"ms"} app deploy --no-wait`,`${"ms"} app deploy --artifact ./build.zip`,`${"ms"} app deploy --target test`,`${"ms"} 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:[`${"ms"} 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, a provided branch, or a provided commit ID.",options:{app:`The app name to play. Defaults to the current app in ${t}.`,mode:"Which app to open: 'live' (default \u2014 the deployed version) or 'preview'.",target:"The deployment target to open: 'prod' or 'test'. Cannot be combined with --mode, --commit, or --branch.",commit:"Preview mode only. The commit ID to open. Cannot be combined with --branch.",branch:"Preview mode only. The branch to open. Defaults to main and cannot be combined with --commit.",noBrowser:"Print the URL but do not open a browser window."},examples:[`${"ms"} app play`,`${"ms"} app play --mode preview`,`${"ms"} app play --target test`,`${"ms"} app play --mode preview --branch feature/my-change`,`${"ms"} app play --mode preview --commit abc1234`,`${"ms"} app play --app my-app --no-browser`,`${"ms"} 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:[`${"ms"} app dev`,`${"ms"} app dev --port 8080 --local-app-url http://localhost:3000`,`${"ms"} 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:[`${"ms"} app refresh data-source`,`${"ms"} app refresh data-source --name teams`,`${"ms"} app refresh data-source --offline`]}},override:{dataSource:{description:"Override an existing data source for a deployment target using an existing connection. Other targets keep their current bindings.",options:{target:"Deployment target: 'prod' or 'test'. Prompts when omitted.",connectionId:"Existing connection ID to use. Prompts when omitted; never creates a connection.",dataset:"Dataset name or site URL. Required for connectors that use datasets; prompts when omitted.",table:"Target-specific table name or list ID. Required when changing the dataset; otherwise omit to keep the effective table. Prompts when omitted."},examples:[`${"ms"} app override data-source orders --target prod --connection-id <id> --dataset <site> --table <list-id>`,`${"ms"} app override data-source orders`]}},add:{config:{description:"Register a deployment target with the current app project and create its local target configuration overlay.",options:{target:"Target to configure: 'prod' or 'test'. Omit to configure both targets."},examples:[`${"ms"} app add config`,`${"ms"} app add config --target prod`,`${"ms"} app add config --target test`]},backend:{description:"Scaffold a local backend for this app (in development, feature-gated). Currently the only supported provider is 'rayfin', which adds a Rayfin backend folder and the Rayfin client SDK dependency. Requires backend support to be enabled in the selected environment; checks availability before creating files.",options:{environmentId:"Environment to check for backend support (defaults to the app config).",provider:"Backend provider to scaffold. Only 'rayfin' is currently supported."},examples:[`${"ms"} app add backend --provider rayfin`,`${"ms"} app add backend --provider rayfin --environment-id <environment-id>`]},connector:{description:"Add a data source (a connector table or action) to the app.",options:{connector:'Connector ID (e.g. office365, 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. Repeat --table to add multiple tables from the same dataset. With --connector commondataserviceforapps, only one Dataverse table logical name is currently supported. 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:[`${"ms"} app add data-source --connector office365`,`${"ms"} app add data-source --connector "Office 365 Users"`,`${"ms"} app add data-source --connector sql --as table --connection-id <id> --dataset <db> --table <tbl>`,`${"ms"} app add data-source --connector sql --as table --connection-id <id> --dataset <db> --table Customers --table Orders`,`${"ms"} app add data-source --connector "SQL Server" --as table --connection-id <id> --dataset <db> --table <tbl>`,`${"ms"} app add data-source --connector sharepointonline --as action`,`${"ms"} app add data-source --connector "SharePoint" --as action`,`${"ms"} app add data-source --connector office365 --as action --use-sso`,`${"ms"} app add data-source --connector sql --as table --skip-codegen`,`${"ms"} app add data-source --connector commondataserviceforapps --as action --connection-id <id> --dataverse-environment-id <env-guid> --table account`],deprecation:`(deprecated) '${"ms"} app add connector' is deprecated. Use '${"ms"} app add data-source' instead.`,deprecatedExamples:[`${"ms"} app add connector --connector office365`,`${"ms"} app add connector --connector sql --as table --connection-id <id> --dataset <db> --table <tbl>`,`${"ms"} app add connector --connector sharepointonline --as action`,`${"ms"} app add connector --connector sql --as table --skip-codegen`,`${"ms"} app add connector --connector 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:[`${"ms"} app remove data-source`,`${"ms"} app remove data-source --name documents`,`${"ms"} app remove data-source --name orders --force`],deprecation:`(deprecated) '${"ms"} app remove connector' is deprecated. Use '${"ms"} app remove data-source' instead.`,deprecatedExamples:[`${"ms"} app remove connector`,`${"ms"} app remove connector --name documents`,`${"ms"} app remove connector --name orders --force`]},"get-settings":{description:"View all app settings.",examples:[`${"ms"} app get-settings`,`${"ms"} app get-settings --json`]},"set-setting":{description:`Update app settings. Changes are written to ${t} and take effect the next time you run '${"ms"} app dev' or '${"ms"} app deploy'.`,options:{"show-header":"Show or hide the app header bar (true or false)."},examples:[`${"ms"} app set-setting --show-header false`]}},project:{unassign:{description:"Unassign a contributor, owner, or reader role from principals on a managed project. Provide email addresses or Microsoft Entra object IDs, separated by commas or spaces (at most 100 unique principals; emails at most 320 characters). Only the specified role is removed; other roles are preserved. At most 100 matching assignments can be removed per request. Missing assignments are reported as no-ops. Email matching uses the listed principal email; use an object ID when email enrichment is unavailable.",options:{role:"Project role to unassign (required): contributor, owner, or reader.",projectId:"Project ID. Defaults to the current ms.project.config.json.",environmentId:"Environment hosting the project. Defaults to the matching project configuration."},examples:[`${"ms"} project unassign alice@contoso.com --role contributor`,`${"ms"} project unassign <object-id> --role owner`,`${"ms"} project unassign alice@contoso.com --role reader`,`${"ms"} project unassign alice@contoso.com,bob@contoso.com --role contributor --project <project-id> --environment-id <environment-id> --json`]},assign:{description:"Assign a contributor, owner, or reader role to users, groups, or service principals on a managed project. Provide email addresses or Microsoft Entra object IDs, separated by commas or spaces (at most 100 unique principals; emails at most 320 characters). Service principals require their object ID, not application (client) ID. Roles apply to the project, not an individual app.",options:{role:"Project role to assign (required): contributor, owner, or reader.",projectId:"Project ID. Defaults to the current ms.project.config.json.",environmentId:"Environment hosting the project. Defaults to the matching project configuration."},examples:[`${"ms"} project assign alice@contoso.com --role contributor`,`${"ms"} project assign <object-id> --role owner`,`${"ms"} project assign alice@contoso.com --role reader`,`${"ms"} project assign alice@contoso.com,bob@contoso.com --role contributor --project <project-id> --environment-id <environment-id> --json`]},add:{deployment:{description:"Register a deployment with the current managed project.",options:{name:"Deployment name to register: 'prod' or 'test'. The 'prod' deployment already exists."},examples:[`${"ms"} project add deployment-target --name test`,`${"ms"} project add deployment-target --name test --json`]},approval:{description:"Add one or more approvers to a project's Prod target. Provide a comma-separated list of user or group email addresses, or object IDs (GUIDs), all of which the service resolves. Adding an approver that is already configured is a no-op. If the service rejects any entry, no approver is added. Approvals apply to Prod only; other targets do not support approvers.",options:{projectId:"ID of the managed project. Defaults to the project in ms.project.config.json.",environmentId:"Environment ID hosting the project. Required unless it can be read from ms.project.config.json.",target:"Hidden. Target whose approvers to manage. Defaults to Prod."},examples:[`${"ms"} project add approval alice@contoso.com,bob@contoso.com`,`${"ms"} project add approval --project <projectId> <object-id>`,`${"ms"} project add approval alice@contoso.com --json`]}},create:{description:"Creates a managed project in an empty target directory, which defaults to the project display name, and provisions or binds its repository. To use the current directory, specify '.'.",options:{displayName:"Display name for the managed project.",environmentId:"Target environment ID for the new managed project (optional).",repo:"External GitHub or GitHub Enterprise repository URL. Omit for a platform-managed repository.",openBrowser:"Open a browser during GitHub authentication when repository access must be refreshed.",forceReauth:"Force GitHub reauthentication before binding an external repository."},examples:[`${"ms"} project create --display-name "Field Service"`,`${"ms"} project create --display-name "Field Service" --repo https://github.com/contoso/field-service`,`${"ms"} project create --display-name "Field Service" --repo https://contoso.ghe.com/contoso/field-service --open-browser`,`${"ms"} project create . --display-name "Field Service"`,`${"ms"} project create ./custom-directory --display-name "Field Service" --environment-id <id> --json`]},info:{description:"Shows a managed project and its associated apps.",options:{project:"ID of the managed project to show. Defaults to the current project or app context.",environmentId:"Environment ID containing the project (optional)."},examples:[`${"ms"} project info --project <id>`,`${"ms"} project info --project <id> --environment-id <id>`,`${"ms"} project info --project <id> --json`]},list:{description:"Lists managed projects across the tenant, or within one environment when --environment-id is supplied.",options:{environmentId:"Environment ID to filter managed projects by (optional)."},examples:[`${"ms"} project list`,`${"ms"} project list --environment-id <id>`,`${"ms"} project list --json`],approval:{description:"Lists the approvers currently configured on a project's Prod target, with the name and email the service reports for each.",options:{projectId:"ID of the managed project. Defaults to the project in ms.project.config.json.",environmentId:"Environment ID hosting the project. Required unless it can be read from ms.project.config.json.",target:"Hidden. Target whose approvers to manage. Defaults to Prod."},examples:[`${"ms"} project list approval`,`${"ms"} project list approval --project <projectId>`,`${"ms"} project list approval --json`]}},remove:{deployment:{description:"Start removing a deployment target from the current project. Removal continues in the background. The production deployment target cannot be removed.",options:{target:"Deployment target to remove. Only 'test' is supported.",force:"Skip confirmation. Required in JSON or non-interactive mode."},examples:[`${"ms"} project remove deployment-target --target test`,`${"ms"} project remove deployment-target --target test --force --json`,`${"ms"} project remove deployment-target --target test --cloud public --force`]},approval:{description:"Remove one or more approvers from a project's Prod target. Provide a comma-separated list of user or group email addresses, matched against the emails shown by 'project list approval' (an address shared by more than one approver is skipped; use the object ID), or object IDs (GUIDs), or pass --all to remove every approver. Approvals apply to Prod only; other targets do not support approvers.",options:{projectId:"ID of the managed project. Defaults to the project in ms.project.config.json.",environmentId:"Environment ID hosting the project. Required unless it can be read from ms.project.config.json.",all:"Remove every approver configured on the project. Cannot be combined with an explicit list.",target:"Hidden. Target whose approvers to manage. Defaults to Prod."},examples:[`${"ms"} project remove approval alice@contoso.com`,`${"ms"} project remove approval --project <projectId> <object-id>`,`${"ms"} project remove approval --all`]}},build:{description:"Initiate a build for the current managed project. By default, the CLI waits for the build to reach a terminal state; pass --no-wait to return immediately after submission.",options:{commitSha:"The commit ID to build from.",noWait:"Return immediately after submitting the build and print a build-status hint."},examples:[`${"ms"} project build`,`${"ms"} project build --commit abc1234`,`${"ms"} project build --no-wait`,`${"ms"} project build --json`]},buildStatus:{description:"Check the build status for the current managed project.",options:{commitSha:"The commit ID for which a build was initiated by project build.",showLog:"Fetch and print the build log when available."},examples:[`${"ms"} project build-status --commit <sha>`,`${"ms"} project build-status --commit <sha> --show-log`,`${"ms"} project build-status --commit <sha> --json`]},deploy:{description:"Deploy the single app associated with a managed project through Managed DevOps. This temporary command uses the app deployment pipeline until multi-app project deployment is available.",options:{projectId:"ID of the managed project to deploy. Without this option, the current app association is preferred before ms.project.config.json.",environmentId:"Environment containing the managed project. When provided, this takes precedence over app config, project config, and developer-environment routing.",noWait:"Return after deployment submission and print the deployment ID instead of polling to completion."},examples:[`${"ms"} project deploy`,`${"ms"} project deploy --project <id>`,`${"ms"} project deploy --project <id> --environment-id <id>`,`${"ms"} project deploy --commit abc1234`,`${"ms"} project deploy --target test`,`${"ms"} project deploy --force --json`]},deployStatus:{description:"Show the latest deployment status for a managed project, including who decided its approval, when, and their comment.",options:{projectId:"ID of the managed project. Without this option, the current app association is preferred before ms.project.config.json.",environmentId:"Environment containing the managed project selected with --project. When omitted, the default environment is used.",deploymentId:"ID of a specific deployment to inspect. When omitted, shows the latest deployment."},examples:[`${"ms"} project deployment-status`,`${"ms"} project deployment-status --project <id>`,`${"ms"} project deployment-status --project <id> --environment-id <id>`,`${"ms"} project deployment-status --deployment-id <id>`,`${"ms"} project deployment-status --json`]},pack:{description:"Validate and pack the discovered project apps, staging the project artifact in .ms/packed/.",examples:[`${"ms"} project pack`,`${"ms"} project pack --json`]},state:{description:"Manage project state and its schema.",clear:{description:"Discard the app's Preview state for all users and all item types. Live data, the app, and source code are unchanged. Requires Update permission. Background deletion may continue after the request returns; request success is not confirmed purge completion.",options:{app:`Real app ID (non-zero GUID), without a -dev suffix. Defaults to appId in ${t}; an explicit ID works outside an app checkout.`,environmentId:"Override the environment ID. When omitted, locate the app before confirmation; never use the current directory's config environment for another app.",force:"Acknowledge the Preview-only destructive action and skip LOCAL confirmation only. Required in JSON/non-interactive mode; never bypasses authorization or data locks."},examples:[`${"ms"} project state clear`,`${"ms"} project state clear --app <app-id> --environment-id <id>`,`${"ms"} project state clear --app <app-id> --force --json --non-interactive`]},"generate-code":{description:"Generate TypeScript models, validators, and data services from the configured state schema.",examples:[`${"ms"} project state generate-code`,`${"ms"} project state generate-code --json`]},"list-schema":{description:"Show the collections and properties defined in the state schema configured by state.schemaPath.",hint:"Edit the schema file directly for anything these commands cannot express, such as nested objects or arrays.",examples:[`${"ms"} project state list-schema`,`${"ms"} project state list-schema --json`]},"list-settings":{description:"Show the state schema settings \u2014 the JSON Schema dialect, locale, and validation state \u2014 followed by each collection and the number of indices it claims.",examples:[`${"ms"} project state list-settings`,`${"ms"} project state list-settings --json`]},"set-setting":{description:"Update one state schema setting: locale or write validation.",options:{locale:"IETF BCP-47 language tag, such as en-US or fr-FR. Defaults to en-US.",validation:"Whether schema validation is enabled: 'true' validates writes; 'false' keeps indexes without validating writes."},examples:[`${"ms"} project state set-setting --locale en-US`,`${"ms"} project state set-setting --locale fr-FR`,`${"ms"} project state set-setting --validation false`]},add:{description:"Add a collection to the state schema, or add a property to an existing collection. Pass --collection on its own to add a collection, or with --property to add a property.",options:{collection:"Name of the collection to add, or the collection the new property belongs to.",property:"Name of the property to add. Omit to add a collection instead.",type:"Property type: string, number, integer, boolean, datetime, guid, or binary.",required:"Whether the property must be present on every item: 'true' or 'false'.",index:"Whether to index the property: 'true' or 'false'. A collection may define at most 4.","index-ignore-case":"Whether the index ignores case: 'true' or 'false'. String, guid, and binary properties only; defaults to true for guid.","index-ignore-accents":"Whether the index ignores accents: 'true' or 'false'. String, guid, and binary properties only.","max-length":"Longest permitted string. String properties only.","min-length":"Shortest permitted string. String properties only.","max-value":"Largest permitted value. A number for number and integer properties, an ISO 8601 instant for datetime.","min-value":"Smallest permitted value. A number for number and integer properties, an ISO 8601 instant for datetime.",format:"String format: date-time, uri, or uuid. String properties only.",kind:"How to treat the referenced resource: image or binary. Binary properties only."},examples:[`${"ms"} project state add --collection orders`,`${"ms"} project state add --collection orders --property customerName --type string --required true`,`${"ms"} project state add --collection orders --property total --type number --min-value 0`,`${"ms"} project state add --collection orders --property sku --type string --index true --index-ignore-case true`]},alter:{description:"Change an existing property in the state schema. Only the switches you pass are rewritten; the rest are left alone.",hint:"Adding an index to a previously deployed property may be rejected because its index plan is frozen. Test the change with a different Preview commit and Preview state store before deploying.",options:{collection:"Collection holding the property.",property:"Property to change.",type:"New property type. Omit to keep the existing one.",required:"Whether the property must be present on every item: 'true' or 'false'.",index:"Whether to index the property: 'true' or 'false'.","index-ignore-case":"Whether the index ignores case: 'true' or 'false'.","index-ignore-accents":"Whether the index ignores accents: 'true' or 'false'.","max-length":"Longest permitted string. String properties only.","min-length":"Shortest permitted string. String properties only.","max-value":"Largest permitted value. Number, integer, and datetime properties only.","min-value":"Smallest permitted value. Number, integer, and datetime properties only.",format:"String format: date-time, uri, or uuid. String properties only.",kind:"How to treat the referenced resource: image or binary. Binary properties only."},examples:[`${"ms"} project state alter --collection orders --property customerName --max-length 200`,`${"ms"} project state alter --collection orders --property customerName --required false`]},remove:{description:"Remove a property from the state schema. Declared collections cannot be removed after deployment.",hint:"Stored values are not deleted when a property definition is removed.",options:{collection:"Collection holding the property.",property:"Property to remove. Omitting it reports that declared collections cannot be removed.",force:"Remove the schema definition without prompting for confirmation."},examples:[`${"ms"} project state remove --collection orders --property customerName --force`]}}},deployment:{status:{description:"Show the latest deployment status for a managed project, including who decided its approval, when, and their comment.",examples:[`${"ms"} deployment status`,`${"ms"} deployment status --project <id>`,`${"ms"} deployment status --project <id> --environment-id <id>`,`${"ms"} deployment status --deployment-id <id>`,`${"ms"} deployment status --json`]},approve:{description:"Approves a pending deployment to a project. Targets Prod unless --target names another target.",options:{projectId:"ID of the managed project. Defaults to the project in ms.project.config.json.",environmentId:"Environment ID hosting the project. Required unless it can be read from ms.project.config.json.",target:"Name of the target to approve the pending deployment for. Defaults to Prod.",comment:"Optional comment to record with the approval.",deploymentId:"Directly identifies the deployment to approve by ID, bypassing --target resolution."},examples:[`${"ms"} deployment approve`,`${"ms"} deployment approve --target Prod`,`${"ms"} deployment approve --project <projectId> --target Prod --comment "LGTM"`,`${"ms"} deployment approve --target Prod --json`]},reject:{description:"Rejects a pending deployment to a project. Targets Prod unless --target names another target.",options:{projectId:"ID of the managed project. Defaults to the project in ms.project.config.json.",environmentId:"Environment ID hosting the project. Required unless it can be read from ms.project.config.json.",target:"Name of the target to reject the pending deployment for. Defaults to Prod.",comment:"Optional comment to record with the rejection.",deploymentId:"Directly identifies the deployment to reject by ID, bypassing --target resolution."},examples:[`${"ms"} deployment reject`,`${"ms"} deployment reject --target Prod`,`${"ms"} deployment reject --project <projectId> --target Prod --comment "Needs another look"`]},cancel:{description:"Cancels a pending deployment to a project. Targets Prod unless --target names another target.",options:{projectId:"ID of the managed project. Defaults to the project in ms.project.config.json.",environmentId:"Environment ID hosting the project. Required unless it can be read from ms.project.config.json.",target:"Name of the target to cancel the pending deployment for. Defaults to Prod.",deploymentId:"Directly identifies the deployment to cancel by ID, bypassing --target resolution."},examples:[`${"ms"} deployment cancel`,`${"ms"} deployment cancel --target Prod`,`${"ms"} deployment cancel --project <projectId> --target Prod`]},list:{description:"List deployment history for a managed project, or for the selected environment when no project context is available.",options:{project:"Managed project ID. Defaults to the current managed project context.",environmentId:"Environment to query when listing environment-wide history. When used with --project, the project must belong to this environment.",target:"Filter by deployment target. Use prod for production or a named target such as uat.",status:"Filter by deployment status: Pending, ValidatingAssets, AwaitingApproval, Running, RollingBack, Succeeded, Failed, RolledBack, PartiallyRolledBack, ValidationCompleted, Rejected, or Cancelled.",top:"Maximum number of the most recent deployments to return. Defaults to 50 and must be between 1 and 200.",continuationToken:"Resume deployment history from an opaque continuation token returned by an earlier request."},examples:[`${"ms"} deployment list`,`${"ms"} deployment list --project <project-id> --top 5`,`${"ms"} deployment list --project <project-id> --continuation-token <token>`,`${"ms"} deployment list --project <project-id> --target prod`,`${"ms"} deployment list --project <project-id> --target uat`,`${"ms"} deployment list --project <project-id> --status Running`]}},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. 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:[`${"ms"} connector list`,`${"ms"} connector list --search "sql"`,`${"ms"} connector list --only-allowed`,`${"ms"} connector list --environment-id <env-id>`,`${"ms"} connector list --json`]},"list-actions":{description:"List actions available on a connector with their policy behavior.",options:{connector:"Connector identifier (e.g. office365).",environmentId:"Environment ID (optional).",search:"Filter actions by summary or action ID (case-insensitive)."},examples:[`${"ms"} connector list-actions --connector office365`,`${"ms"} connector list-actions --connector sql --search "execute"`,`${"ms"} connector list-actions --connector office365 --environment-id <env-id>`,`${"ms"} connector list-actions --connector 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:[`${"ms"} telemetry enable`,`${"ms"} telemetry enable --console`,`${"ms"} 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:[`${"ms"} telemetry disable`,`${"ms"} telemetry disable --console`,`${"ms"} telemetry disable --remote --console`]},status:{description:"Show the current telemetry settings.",examples:[`${"ms"} telemetry status`,`${"ms"} telemetry status --json`]}},feature:{list:{description:"List experimental and preview CLI features and whether each is enabled. Features in development are listed only while enabled.",examples:[`${"ms"} feature list`,`${"ms"} feature list --json`]},status:{description:"Show whether a CLI feature is enabled, and which setting decides it.",options:{name:`Feature name, as shown by '${"ms"} feature list'.`},examples:[`${"ms"} feature status --name state`,`${"ms"} feature status --name state --json`]},enable:{description:"Enable a CLI feature for all future runs by saving it to your user settings. An MS_CLI_FEATURE_<NAME> environment variable still takes precedence.",options:{name:`Feature name to enable, as shown by '${"ms"} feature list'.`},examples:[`${"ms"} feature enable --name state`]},disable:{description:"Disable a CLI feature for all future runs by saving it to your user settings. An MS_CLI_FEATURE_<NAME> environment variable still takes precedence, and an app or project that already uses the feature keeps it on.",options:{name:`Feature name to disable, as shown by '${"ms"} feature list'.`},examples:[`${"ms"} feature disable --name state`]},reset:{description:"Remove the saved setting for a CLI feature, returning it to its default unless an MS_CLI_FEATURE_<NAME> environment variable is set.",options:{name:`Feature name to reset, as shown by '${"ms"} feature list'.`},examples:[`${"ms"} feature reset --name state`]}},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:[`${"ms"} git auth refresh --repo https://contoso.ghe.com/contoso/my-app`,`${"ms"} git auth refresh -r https://contoso.ghe.com/contoso/my-app --open-browser`,`${"ms"} git auth refresh --repo https://contoso.ghe.com/contoso/my-app --json`]}}}};export{n as a};
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+//# sourceMappingURL=chunk-HOIFXUTG.js.map

package/dist/chunk-HSNRWBA6.js

@@ -0,0 +1,11 @@
+import { createRequire as __createRequire } from 'node:module';
+import { fileURLToPath as __fileURLToPath } from 'node:url';
+import { dirname as __pathDirname } from 'node:path';
+const require = __createRequire(import.meta.url);
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import{Ma as r,Nb as p,x as o}from"./chunk-4XKA5APP.js";import{a as n}from"./chunk-KKC5ZK4D.js";var u="This app is not backed by a platform managed repo. Repository access must be configured in the external repository.",a="00000000-0000-0000-0000-000000000000";function i(e){return!!e&&e!==a}function g(e){let t=(e??"play").trim().toLowerCase();if(t==="play"||t==="edit"||t==="test")return t;throw new o(`Unknown --access value '${e}'. Use 'play' (default \u2014 app access), 'edit', or 'test'.`)}function A(e){if(e.repoType)return e.repoType;if(i(e.repositoryId))throw new o(`${n} is missing the 'repoType' field but has a 'repositoryId' set. This usually means the file was written by an older CLI. Re-run "${"ms"} app init" to migrate the config, then retry.`);return"none"}async function m(e){return r({tenantId:e.tenantId,environmentId:e.environmentId,logger:p(),actionsParams:{appName:e.appName}})}async function I(e){let t=await m(e);if(!i(t.repositoryId))throw new o(`App '${e.appName}' has no associated repository.`);return t}export{u as a,i as b,g as c,A as d,m as e,I as f};
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+//# sourceMappingURL=chunk-HSNRWBA6.js.map