@microsoft/apps-cli 0.0.1 → 0.4.0

package/dist/Verbs/ConnectorHelpers.d.ts

@@ -0,0 +1,37 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { Api } from '@microsoft/apps-actions';
+import type { ArgumentProvider } from '../ArgumentProvider.js';
+/**
+ * Preflight step shared by `app add action` and `app add table`. Fetches the
+ * connector and effective DLP policy in parallel, then enforces the policy.
+ *
+ * Failure modes:
+ *  - tenantId missing: surfaces a `DlpSkippedNoTenantId` telemetry event and a
+ *    user-visible warning, then degrades to "allow all" so the verb can still
+ *    proceed (the alternative — failing — would block users in auth states
+ *    where tenant resolution legitimately can't happen).
+ *  - DLP fetch error: relies on `getEffectiveConnectorDataPolicyAsync`'s own
+ *    `scenario.failure` telemetry; we only print a user warning and degrade
+ *    to "allow all" rather than re-emitting a duplicate error event.
+ *
+ * Throws `NotFoundError` when the connector itself cannot be found, and
+ * `UsageError` when the connector is blocked by DLP.
+ */
+export declare function runConnectorDlpPreflightAsync(argumentProvider: ArgumentProvider, apiId: string): Promise<{
+    connector: Api;
+    tenantId: string | undefined;
+}>;
+/**
+ * Resolves a connection for a connector. In interactive mode, lists the
+ * existing connections and prompts the user to pick one (or create a new one).
+ * In non-interactive mode, prints the connection table and throws a
+ * `UsageError` pointing the user at `--connection-id`.
+ */
+export declare function resolveConnectionInteractivelyAsync(options: {
+    argumentProvider: ArgumentProvider;
+    apiId: string;
+    connector: Api;
+}): Promise<string>;
+//# sourceMappingURL=ConnectorHelpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectorHelpers.d.ts","sourceRoot":"","sources":["../../src/Verbs/ConnectorHelpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAgC,MAAM,yBAAyB,CAAC;AASjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAc5D;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,6BAA6B,CACjD,gBAAgB,EAAE,gBAAgB,EAClC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,SAAS,EAAE,GAAG,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,CA6C3D;AAED;;;;;GAKG;AACH,wBAAsB,mCAAmC,CAAC,OAAO,EAAE;IACjE,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,GAAG,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsDlB"}

package/dist/Verbs/ConnectorHelpers.js

@@ -0,0 +1,116 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { createConnectionAsync, getConnectorAsync, getEffectiveConnectorDataPolicyAsync, getPlayerServiceConfig, listConnectionsForConnectorAsync, } from '@microsoft/apps-actions';
+import { getCliLogger, getSettings } from '../CliSettings.js';
+import { promptSelect } from '../CliUtils.js';
+import { CLI_BINARY_NAME } from '../Constants/CliConstants.js';
+import { NotFoundError, UsageError } from '../Errors/CliError.js';
+import { printTable, printWarning } from '../Utils/ConsoleOutput.js';
+const ALLOW_ALL_POLICY = {
+    defaultBehavior: 'Allow',
+    allowedConnectors: [],
+};
+const CREATE_NEW_CONNECTION = '__create__';
+/**
+ * Preflight step shared by `app add action` and `app add table`. Fetches the
+ * connector and effective DLP policy in parallel, then enforces the policy.
+ *
+ * Failure modes:
+ *  - tenantId missing: surfaces a `DlpSkippedNoTenantId` telemetry event and a
+ *    user-visible warning, then degrades to "allow all" so the verb can still
+ *    proceed (the alternative — failing — would block users in auth states
+ *    where tenant resolution legitimately can't happen).
+ *  - DLP fetch error: relies on `getEffectiveConnectorDataPolicyAsync`'s own
+ *    `scenario.failure` telemetry; we only print a user warning and degrade
+ *    to "allow all" rather than re-emitting a duplicate error event.
+ *
+ * Throws `NotFoundError` when the connector itself cannot be found, and
+ * `UsageError` when the connector is blocked by DLP.
+ */
+export async function runConnectorDlpPreflightAsync(argumentProvider, apiId) {
+    const logger = getCliLogger();
+    const tenantId = await argumentProvider.getTenantIdAsync();
+    if (!tenantId) {
+        logger.trackErrorEvent('DlpSkippedNoTenantId', { apiId });
+        printWarning(`Could not resolve tenant ID; skipping DLP policy check. Sign in with '${CLI_BINARY_NAME} auth login' for full enforcement.`);
+    }
+    const [connector, policy] = await Promise.all([
+        getConnectorAsync(apiId, logger),
+        tenantId
+            ? getEffectiveConnectorDataPolicyAsync(logger, tenantId).catch(() => {
+                // GovernanceService already records `scenario.failure` internally,
+                // so we don't re-emit telemetry here — just surface the warning
+                // and degrade to allow-all.
+                printWarning('Could not verify DLP policy; proceeding without enforcement.');
+                return ALLOW_ALL_POLICY;
+            })
+            : Promise.resolve(ALLOW_ALL_POLICY),
+    ]);
+    if (!connector) {
+        throw new NotFoundError(`Connector '${apiId}' not found. Run '${CLI_BINARY_NAME} connector list' to see available connector IDs.`);
+    }
+    const shortName = (connector.name ?? apiId).toLowerCase();
+    const allowedMap = new Map(policy.allowedConnectors.map((e) => [e.connectorId.toLowerCase(), e]));
+    const blockedSet = new Set((policy.blockedConnectors ?? []).map((e) => e.connectorId.toLowerCase()));
+    const isBlocked = policy.defaultBehavior === 'Block' ? !allowedMap.has(shortName) : blockedSet.has(shortName);
+    if (isBlocked) {
+        throw new UsageError(`Connector '${connector.properties.displayName ?? apiId}' is blocked by your organization's DLP policy.`);
+    }
+    return { connector, tenantId };
+}
+/**
+ * Resolves a connection for a connector. In interactive mode, lists the
+ * existing connections and prompts the user to pick one (or create a new one).
+ * In non-interactive mode, prints the connection table and throws a
+ * `UsageError` pointing the user at `--connection-id`.
+ */
+export async function resolveConnectionInteractivelyAsync(options) {
+    const { argumentProvider, apiId, connector } = options;
+    const settings = getSettings();
+    const { fileConfig, cliFs } = settings;
+    const logger = getCliLogger();
+    const playerServiceConfig = getPlayerServiceConfig();
+    const authProvider = argumentProvider.getAuthenticationProvider();
+    const connections = await listConnectionsForConnectorAsync(apiId, logger);
+    if (!settings.interactive) {
+        printTable({
+            title: `Available connections for ${connector.properties.displayName ?? apiId}`,
+            columns: [{ header: 'Display Name', maxWidth: 40 }, { header: 'Connection ID' }],
+            rows: connections.map((c) => [c.properties.displayName, c.name]),
+            emptyMessage: 'No connections found in this environment.',
+            totalLabel: 'connection(s) found',
+        });
+        throw new UsageError(`This connector requires a connection. Re-run with --connection-id <id> or -c <id>. Run '${CLI_BINARY_NAME} connector list' to browse available connectors.`);
+    }
+    const choices = [
+        ...connections.map((c) => ({
+            value: c.name,
+            label: c.properties.displayName,
+            hint: c.name,
+        })),
+        { value: CREATE_NEW_CONNECTION, label: '(Create a new connection)' },
+    ];
+    const selected = await promptSelect({
+        message: 'Select a connection:',
+        options: choices,
+    });
+    if (selected === CREATE_NEW_CONNECTION) {
+        const newConnection = await createConnectionAsync({
+            vfs: cliFs,
+            authProvider,
+            region: playerServiceConfig.region,
+            environmentName: playerServiceConfig.environmentName,
+            actionsParams: { connectorId: apiId },
+            localFilePaths: {
+                appConfigPath: fileConfig.appConfigPath,
+                schemaPath: fileConfig.schemaPath,
+                codeGenPath: fileConfig.codeGenPath,
+            },
+            logger,
+        });
+        return newConnection.name;
+    }
+    return selected;
+}
+//# sourceMappingURL=ConnectorHelpers.js.map

package/dist/Verbs/ConnectorHelpers.js.map

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

package/dist/Verbs/CreateMaafApp.d.ts

@@ -0,0 +1,25 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { ArgumentProvider } from '../ArgumentProvider.js';
+export declare function createMaafAppAsync(argumentProvider: ArgumentProvider): Promise<void>;
+interface InitLocalRepoOptions {
+    directory: string;
+    gitUrl: string;
+    loginAuthority: string;
+    authResource: string;
+    /**
+     * Suppresses the human-readable authentication notice that prints before the
+     * first `git fetch`. Callers emitting a `--json` envelope set this to keep
+     * stdout free of prose ahead of the envelope. Defaults to false.
+     */
+    jsonMode?: boolean;
+}
+export declare function initLocalRepo({ directory, gitUrl, loginAuthority, authResource, jsonMode, }: InitLocalRepoOptions): void;
+export declare function buildOrphanedAppRecoveryHint(serverAppId: string, environmentId: string): string;
+export declare function ensureGitInstalled(): void;
+export declare function ensureTemplateSourceValid(source: string): void;
+export declare function ensureTargetDirectoryEmpty(appDir: string, force: boolean): void;
+export declare function ensureTargetDirectoryWritable(appDir: string): void;
+export {};
+//# sourceMappingURL=CreateMaafApp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CreateMaafApp.d.ts","sourceRoot":"","sources":["../../src/Verbs/CreateMaafApp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuBH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAa5D,wBAAsB,kBAAkB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyP1F;AAsDD,UAAU,oBAAoB;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,MAAM,EACN,cAAc,EACd,YAAY,EACZ,QAAgB,GACjB,EAAE,oBAAoB,GAAG,IAAI,CA4E7B;AASD,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAM/F;AAQD,wBAAgB,kBAAkB,IAAI,IAAI,CAQzC;AA2DD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CA2B9D;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAc/E;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CA8BlE"}