@microsoft/apps-cli 0.0.1 → 0.4.0

package/dist/Verbs/ShowMaafApp.js

@@ -0,0 +1,216 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { infoAsync } from '@microsoft/apps-actions';
+import { AppConfigFileName } from '@microsoft/apps-common/config';
+import { getCliLogger, getSettings } from '../CliSettings.js';
+import { resolveEnvironmentId } from '../CliUtils.js';
+import { CLI_BINARY_NAME } from '../Constants/CliConstants.js';
+import { HelpStrings } from '../Constants/HelpStrings.js';
+import { UsageError } from '../Errors/CliError.js';
+import { printInfo, printJsonSuccess } from '../Utils/ConsoleOutput.js';
+/** Length used to abbreviate sourceControl.commitHash for the human view (matches `git log --oneline`). */
+const SHORT_COMMIT_LENGTH = 7;
+/**
+ * Implements `ms app show` — prints the current app's configuration and bound
+ * resources for the project rooted at the cwd.
+ *
+ * Pipeline:
+ * 1. Register description/examples and run the verb (so `--help` works even
+ *    outside an initialised project).
+ * 2. Require a loaded `ms.config.json` with an `appId`.
+ * 3. Resolve `environmentId` (`--environment-id` flag wins; otherwise from config) and tenantId.
+ * 4. Fetch the live `MaafAppDefinition` payload via `infoAsync` (server is the
+ *    source of truth for displayName, commitHash, and connection references).
+ * 5. Fold local config (build path) + server response into an `AppShowView`.
+ * 6. Emit JSON when `--json` is set, otherwise the human view.
+ */
+export async function showMaafAppAsync(argumentProvider) {
+    argumentProvider.setDescription(HelpStrings.app.show.description);
+    argumentProvider.addExamples(HelpStrings.app.show.examples);
+    await argumentProvider.runVerb();
+    const cliSettings = getSettings();
+    if (!cliSettings.appConfig) {
+        throw new UsageError(`No ${AppConfigFileName} found in the current directory. Run "npx ${CLI_BINARY_NAME} app init" first.`);
+    }
+    const appId = cliSettings.appConfig.appId;
+    if (!appId) {
+        throw new UsageError(`${AppConfigFileName} has no appId. Run "npx ${CLI_BINARY_NAME} app create" or set appId manually.`);
+    }
+    // `resolveEnvironmentId` enforces flag-wins precedence and pushes the resolved
+    // id into player services so the URL builder targets the override.
+    const environmentId = await resolveEnvironmentId(argumentProvider);
+    const tenantId = await argumentProvider.getTenantIdAsync();
+    if (!tenantId) {
+        throw new UsageError('Unable to determine tenant ID. Ensure you are logged in.');
+    }
+    const app = await infoAsync({
+        tenantId,
+        environmentId,
+        logger: getCliLogger(),
+        actionsParams: { appName: appId },
+    });
+    const view = buildAppShowView(app, cliSettings.appConfig, environmentId);
+    if (argumentProvider.isJsonMode()) {
+        printJsonSuccess(view);
+    }
+    else {
+        printAppShowHuman(view);
+    }
+}
+/**
+ * Folds the live `App` payload and the local `ms.config.json` into a single
+ * `AppShowView`. Pure function — no I/O, no console — so unit tests can exercise
+ * shape decisions without mocking the API client or stdout.
+ *
+ * @param app - The server-side app payload from `infoAsync`.
+ * @param appConfig - The parsed `ms.config.json` contents (build paths only here).
+ * @param fallbackEnvironmentId - Used when the server response omits `environmentId`
+ *   (defensive — the new MAAF wire contract makes this required, but we keep the
+ *   fallback so this function stays robust to sparse payloads).
+ */
+export function buildAppShowView(app, appConfig, fallbackEnvironmentId) {
+    const refs = app.connectionReferences ?? {};
+    const connectors = Object.entries(refs).map(([key, ref]) => buildConnectorView(key, ref));
+    const commit = app.commitHash;
+    return {
+        name: app.displayName,
+        environmentId: app.environmentId ?? fallbackEnvironmentId,
+        appId: app.id,
+        commit: commit ? commit.slice(0, SHORT_COMMIT_LENGTH) : undefined,
+        build: buildBuildView(appConfig),
+        connectors,
+    };
+}
+/**
+ * Returns a `BuildView` containing only the keys that are set, so the runtime
+ * shape lines up with the type and with what `JSON.stringify` actually emits.
+ */
+function buildBuildView(appConfig) {
+    const { buildPath, buildEntryPoint } = appConfig;
+    if (buildPath && buildEntryPoint)
+        return { path: buildPath, entryPoint: buildEntryPoint };
+    if (buildPath)
+        return { path: buildPath };
+    if (buildEntryPoint)
+        return { entryPoint: buildEntryPoint };
+    return undefined;
+}
+/**
+ * Projects a single `connectionReferences` entry into the `ConnectorView` shape.
+ *
+ * Tabular `dataSets[dataset].dataSources[name]` entries split by their `tableName`:
+ *   - present → table   (`{dataset, table: tableName}`)
+ *   - absent  → procedure (`{dataset, procedure: name}`)
+ *
+ * Top-level `dataSources[]` entries that aren't covered by any `dataSets` entry
+ * are dataverse-style logical names — emitted as `tables` with no dataset.
+ */
+function buildConnectorView(key, ref) {
+    const view = { connector: key };
+    if (ref.displayName)
+        view.displayName = ref.displayName;
+    if (ref.actions?.length)
+        view.actions = ref.actions;
+    const dataSets = (ref.dataSets ?? {});
+    const tables = [];
+    const procedures = [];
+    const claimedNames = new Set();
+    for (const [dataset, dataSet] of Object.entries(dataSets)) {
+        // `ApiConnectionReference.dataSets` is typed as `object` upstream, so a
+        // `null` entry is structurally valid even though no observed server
+        // payload emits one. Skip rather than crash on `dataSet.dataSources`.
+        if (!dataSet || typeof dataSet !== 'object')
+            continue;
+        for (const [name, source] of Object.entries(dataSet.dataSources ?? {})) {
+            claimedNames.add(name);
+            if (source.tableName) {
+                tables.push({ dataset, table: source.tableName });
+            }
+            else {
+                procedures.push({ dataset, procedure: name });
+            }
+        }
+    }
+    for (const name of ref.dataSources ?? []) {
+        if (!claimedNames.has(name))
+            tables.push({ table: name });
+    }
+    if (tables.length)
+        view.tables = tables;
+    if (procedures.length)
+        view.procedures = procedures;
+    return view;
+}
+/**
+ * Renders an `AppShowView` to stdout. Uses uniform `printInfo` for the whole
+ * key:value header block so the colouring stays consistent across lines.
+ */
+function printAppShowHuman(view) {
+    printInfo(`Name:        ${view.name}`);
+    printInfo(`Environment: ${view.environmentId}`);
+    printInfo(`App ID:      ${view.appId}`);
+    if (view.commit)
+        printInfo(`Commit:      ${view.commit}`);
+    const buildLine = formatBuildLine(view.build);
+    if (buildLine)
+        printInfo(`Build:       ${buildLine}`);
+    if (view.connectors.length === 0) {
+        printInfo('');
+        printInfo('(no connectors bound)');
+        return;
+    }
+    for (const connector of view.connectors) {
+        // Blank line separator between header and each connector group, matching the
+        // example layout in the verb's spec doc.
+        printInfo('');
+        // Strip the `shared_` prefix on display only — the JSON `connector` key keeps
+        // the full logical name so it stays joinable with server-side data.
+        const label = connector.connector.replace(/^shared_/, '');
+        printInfo(connector.displayName ? `${label} (${connector.displayName})` : label);
+        if (connector.actions?.length) {
+            printInfo(`  actions:    ${connector.actions.join(', ')}`);
+        }
+        if (connector.tables?.length) {
+            printInfo(`  tables:     ${connector.tables.map(formatTable).join(', ')}`);
+        }
+        if (connector.procedures?.length) {
+            printInfo(`  procedures: ${connector.procedures.map(formatProcedure).join(', ')}`);
+        }
+    }
+}
+/** `[dbo].[Orders] (server.db.windows.net,mydb)` for tabular; bare name for dataverse-style. */
+function formatTable(entry) {
+    return entry.dataset ? `${entry.table} (${entry.dataset})` : entry.table;
+}
+function formatProcedure(entry) {
+    return `${entry.procedure} (${entry.dataset})`;
+}
+/**
+ * Renders the build target as a single line. Joins `path` + `entryPoint` when
+ * both are present; otherwise returns whichever side is set, or `undefined`
+ * when neither is — letting the caller skip the `Build:` line entirely.
+ *
+ * The separator follows the dominant style in `path` so Windows configs like
+ * `.\dist\` render as `.\dist\index.html`, not the mixed `.\dist\/index.html`.
+ *
+ * `entryPoint` must be a path relative to `path`. When both sides are present,
+ * any leading separator on `entryPoint` is stripped before joining, so an
+ * absolute path like `/abs/index.html` would be rendered as `<path>/abs/index.html`.
+ * The build target is a display string only (never used for I/O), so this is a
+ * cosmetic constraint.
+ */
+function formatBuildLine(build) {
+    if (!build)
+        return undefined;
+    const path = 'path' in build ? build.path : undefined;
+    const entryPoint = 'entryPoint' in build ? build.entryPoint : undefined;
+    if (path && entryPoint) {
+        const sep = path.includes('\\') && !path.includes('/') ? '\\' : '/';
+        const trimmedPath = path.replace(/[/\\]+$/, '');
+        const trimmedEntry = entryPoint.replace(/^[/\\]+/, '');
+        return `${trimmedPath}${sep}${trimmedEntry}`;
+    }
+    return path ?? entryPoint;
+}
+//# sourceMappingURL=ShowMaafApp.js.map

package/dist/Verbs/ShowMaafApp.js.map

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

package/dist/Verbs/TelemetrySettings.d.ts

@@ -0,0 +1,8 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { ArgumentProvider } from '../ArgumentProvider.js';
+export declare function telemetryEnableAsync(argumentProvider: ArgumentProvider): Promise<void>;
+export declare function telemetryDisableAsync(argumentProvider: ArgumentProvider): Promise<void>;
+export declare function telemetryStatusAsync(argumentProvider: ArgumentProvider): Promise<void>;
+//# sourceMappingURL=TelemetrySettings.d.ts.map

package/dist/Verbs/TelemetrySettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetrySettings.d.ts","sourceRoot":"","sources":["../../src/Verbs/TelemetrySettings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAS5D,wBAAsB,oBAAoB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAY5F;AAED,wBAAsB,qBAAqB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAY7F;AAED,wBAAsB,oBAAoB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5F"}

package/dist/Verbs/TelemetrySettings.js

@@ -0,0 +1,104 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { CLI_CONFIG_DIRECTORY, USER_SETTINGS_FILE } from '../Constants.js';
+import { HelpStrings } from '../Constants/HelpStrings.js';
+import { ConfigurationError } from '../Errors/CliError.js';
+import { printJsonSuccess, printKeyValueList, printWarning } from '../Utils/ConsoleOutput.js';
+const DEFAULTS = { remote: true, console: false };
+export async function telemetryEnableAsync(argumentProvider) {
+    _addTargetSwitches(argumentProvider, HelpStrings.telemetry.enable.options);
+    argumentProvider.setDescription(HelpStrings.telemetry.enable.description);
+    argumentProvider.addExamples(HelpStrings.telemetry.enable.examples);
+    await argumentProvider.runVerb();
+    const update = _resolveTargetUpdate(await argumentProvider.getOption('remote', true), await argumentProvider.getOption('console', true), true);
+    _updateUserTelemetrySettings(update);
+}
+export async function telemetryDisableAsync(argumentProvider) {
+    _addTargetSwitches(argumentProvider, HelpStrings.telemetry.disable.options);
+    argumentProvider.setDescription(HelpStrings.telemetry.disable.description);
+    argumentProvider.addExamples(HelpStrings.telemetry.disable.examples);
+    await argumentProvider.runVerb();
+    const update = _resolveTargetUpdate(await argumentProvider.getOption('remote', true), await argumentProvider.getOption('console', true), false);
+    _updateUserTelemetrySettings(update);
+}
+export async function telemetryStatusAsync(argumentProvider) {
+    argumentProvider.setDescription(HelpStrings.telemetry.status.description);
+    argumentProvider.addExamples(HelpStrings.telemetry.status.examples);
+    await argumentProvider.runVerb();
+    _displayUserTelemetrySettings(argumentProvider.isJsonMode());
+}
+/**
+ * Registers --remote and --console switches on the argument provider.
+ */
+function _addTargetSwitches(argumentProvider, options) {
+    argumentProvider.addSwitches([
+        { flags: { key: 'remote' }, description: options.remote },
+        { flags: { key: 'console' }, description: options.console },
+    ]);
+}
+/**
+ * Resolves which fields to update based on the provided switches.
+ * Defaults to remote when neither switch is given.
+ */
+function _resolveTargetUpdate(remote, consoleFlag, value) {
+    const neitherGiven = !remote && !consoleFlag;
+    const update = {};
+    if (remote || neitherGiven)
+        update.remote = value;
+    if (consoleFlag)
+        update.console = value;
+    return update;
+}
+function _displayUserTelemetrySettings(jsonMode) {
+    try {
+        const userSettingsPath = path.join(CLI_CONFIG_DIRECTORY, USER_SETTINGS_FILE);
+        if (fs.existsSync(userSettingsPath)) {
+            const fileContent = fs.readFileSync(userSettingsPath, 'utf-8');
+            const existingSettings = JSON.parse(fileContent);
+            if (jsonMode) {
+                printJsonSuccess({ settings: existingSettings });
+                return;
+            }
+            printKeyValueList({
+                title: 'Telemetry Settings:',
+                items: [existingSettings],
+                fields: [
+                    { label: 'Remote', value: (s) => String(s.remote) },
+                    { label: 'Console', value: (s) => String(s.console) },
+                ],
+            });
+        }
+        else {
+            if (jsonMode) {
+                printJsonSuccess({ settings: null });
+                return;
+            }
+            printWarning('No telemetry settings found. Using default settings.');
+        }
+    }
+    catch (error) {
+        throw new ConfigurationError(`Failed to read telemetry settings: ${error.message}`);
+    }
+}
+function _updateUserTelemetrySettings(update) {
+    try {
+        if (!fs.existsSync(CLI_CONFIG_DIRECTORY)) {
+            fs.mkdirSync(CLI_CONFIG_DIRECTORY, { recursive: true });
+        }
+        const userSettingsPath = path.join(CLI_CONFIG_DIRECTORY, USER_SETTINGS_FILE);
+        let existing = { ...DEFAULTS };
+        if (fs.existsSync(userSettingsPath)) {
+            const fileContent = fs.readFileSync(userSettingsPath, 'utf-8');
+            const parsed = JSON.parse(fileContent);
+            existing = { ...DEFAULTS, ...parsed };
+        }
+        fs.writeFileSync(userSettingsPath, JSON.stringify({ ...existing, ...update }, null, 2), 'utf-8');
+    }
+    catch (error) {
+        throw new ConfigurationError(`Failed to update telemetry settings: ${error.message}`);
+    }
+}
+//# sourceMappingURL=TelemetrySettings.js.map

package/dist/Verbs/TelemetrySettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetrySettings.js","sourceRoot":"","sources":["../../src/Verbs/TelemetrySettings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3F,MAAM,QAAQ,GAA0B,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAEzE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,gBAAkC;IAC3E,kBAAkB,CAAC,gBAAgB,EAAE,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3E,gBAAgB,CAAC,cAAc,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC1E,gBAAgB,CAAC,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpE,MAAM,gBAAgB,CAAC,OAAO,EAAE,CAAC;IAEjC,MAAM,MAAM,GAAG,oBAAoB,CACjC,MAAM,gBAAgB,CAAC,SAAS,CAAU,QAAQ,EAAE,IAAI,CAAC,EACzD,MAAM,gBAAgB,CAAC,SAAS,CAAU,SAAS,EAAE,IAAI,CAAC,EAC1D,IAAI,CACL,CAAC;IACF,4BAA4B,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,gBAAkC;IAC5E,kBAAkB,CAAC,gBAAgB,EAAE,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,gBAAgB,CAAC,cAAc,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3E,gBAAgB,CAAC,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrE,MAAM,gBAAgB,CAAC,OAAO,EAAE,CAAC;IAEjC,MAAM,MAAM,GAAG,oBAAoB,CACjC,MAAM,gBAAgB,CAAC,SAAS,CAAU,QAAQ,EAAE,IAAI,CAAC,EACzD,MAAM,gBAAgB,CAAC,SAAS,CAAU,SAAS,EAAE,IAAI,CAAC,EAC1D,KAAK,CACN,CAAC;IACF,4BAA4B,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,gBAAkC;IAC3E,gBAAgB,CAAC,cAAc,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC1E,gBAAgB,CAAC,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpE,MAAM,gBAAgB,CAAC,OAAO,EAAE,CAAC;IAEjC,6BAA6B,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CACzB,gBAAkC,EAClC,OAA4C;IAE5C,gBAAgB,CAAC,WAAW,CAAC;QAC3B,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE;QACzD,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,OAAO,EAAE;KAC5D,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAC3B,MAA2B,EAC3B,WAAgC,EAChC,KAAc;IAEd,MAAM,YAAY,GAAG,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC;IAC7C,MAAM,MAAM,GAAmC,EAAE,CAAC;IAClD,IAAI,MAAM,IAAI,YAAY;QAAE,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;IAClD,IAAI,WAAW;QAAE,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;IACxC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,6BAA6B,CAAC,QAAiB;IACtD,IAAI,CAAC;QACH,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;QAC7E,IAAI,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACpC,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;YAC/D,MAAM,gBAAgB,GAA0B,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAExE,IAAI,QAAQ,EAAE,CAAC;gBACb,gBAAgB,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;gBACjD,OAAO;YACT,CAAC;YAED,iBAAiB,CAAC;gBAChB,KAAK,EAAE,qBAAqB;gBAC5B,KAAK,EAAE,CAAC,gBAAgB,CAAC;gBACzB,MAAM,EAAE;oBACN,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;oBACnD,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE;iBACtD;aACF,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,QAAQ,EAAE,CAAC;gBACb,gBAAgB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACrC,OAAO;YACT,CAAC;YACD,YAAY,CAAC,sDAAsD,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAAC,sCAAuC,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IACjG,CAAC;AACH,CAAC;AAED,SAAS,4BAA4B,CAAC,MAAsC;IAC1E,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;YACzC,EAAE,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;QAC7E,IAAI,QAAQ,GAA0B,EAAE,GAAG,QAAQ,EAAE,CAAC;QACtD,IAAI,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACpC,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAmC,CAAC;YACzE,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;QACxC,CAAC;QACD,EAAE,CAAC,aAAa,CACd,gBAAgB,EAChB,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EACnD,OAAO,CACR,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAC1B,wCAAyC,KAAe,CAAC,OAAO,EAAE,CACnE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/Verbs/UnshareMaafApp.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { ArgumentProvider } from '../ArgumentProvider.js';
+/**
+ * Implements `ms app unshare` — removes all role assignments at the app scope
+ * for the comma-separated list of AAD principals supplied as the positional
+ * argument. See `MaafAppPermissions.ts` for the shared resolution and execution
+ * pipeline.
+ */
+export declare function unshareMaafAppAsync(argumentProvider: ArgumentProvider): Promise<void>;
+//# sourceMappingURL=UnshareMaafApp.d.ts.map

package/dist/Verbs/UnshareMaafApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnshareMaafApp.d.ts","sourceRoot":"","sources":["../../src/Verbs/UnshareMaafApp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3F"}

package/dist/Verbs/UnshareMaafApp.js

@@ -0,0 +1,14 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { executeMaafAppPermissionsAsync } from './MaafAppPermissions.js';
+/**
+ * Implements `ms app unshare` — removes all role assignments at the app scope
+ * for the comma-separated list of AAD principals supplied as the positional
+ * argument. See `MaafAppPermissions.ts` for the shared resolution and execution
+ * pipeline.
+ */
+export async function unshareMaafAppAsync(argumentProvider) {
+    await executeMaafAppPermissionsAsync(argumentProvider, 'unshare');
+}
+//# sourceMappingURL=UnshareMaafApp.js.map

package/dist/Verbs/UnshareMaafApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnshareMaafApp.js","sourceRoot":"","sources":["../../src/Verbs/UnshareMaafApp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,gBAAkC;IAC1E,MAAM,8BAA8B,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;AACpE,CAAC"}