@microsoft/power-apps-cli 0.6.0 → 0.6.4

package/lib/__tests__/E2eTests/basicSetup/loggingConfiguration.test.js

@@ -0,0 +1,246 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * E2E Tests: Basic Setup - Logging Configuration
+ *
+ * Tests that the CLI logging and telemetry configuration works correctly.
+ * Test Cases:
+ * - TC 35840167: Logging Configuration Baseline
+ * - TC 35840168: Telemetry Event Emission on Command Execution
+ */
+import { afterAll, beforeAll, beforeEach, describe, expect, it } from '@jest/globals';
+import * as fs from 'fs';
+import * as path from 'path';
+import { describeE2E } from '../../helpers/e2eTestHelpers';
+import { setupE2eTest } from '../../helpers/testHelpers';
+import { E2E_CONFIG } from '../e2eConfig';
+const TEST_FOLDER_NAME = 'loggingConfigTests';
+describeE2E('Basic Setup - Logging Configuration (TC: 35840167, 35840168)', () => {
+    let testSetup;
+    beforeAll(() => {
+        testSetup = setupE2eTest({
+            testFolderName: TEST_FOLDER_NAME,
+            tempBaseDir: E2E_CONFIG.tempBaseDir,
+        });
+        // Create power.config.json
+        const configPath = path.join(testSetup.projectRoot, 'power.config.json');
+        fs.writeFileSync(configPath, JSON.stringify({
+            version: '1.0',
+            appId: null,
+            appDisplayName: 'Logging Config Test App',
+            region: E2E_CONFIG.region,
+            environmentId: E2E_CONFIG.environmentId,
+            connectionReferences: {},
+            databaseReferences: {},
+        }));
+    });
+    afterAll(() => {
+        testSetup.cleanup();
+    });
+    describe('default logging behavior (TC: 35840167)', () => {
+        beforeEach(() => {
+            // Remove user settings to test defaults
+            if (fs.existsSync(testSetup.userSettingsPath)) {
+                fs.unlinkSync(testSetup.userSettingsPath);
+            }
+        });
+        it('CLI runs without user settings file', () => {
+            expect(fs.existsSync(testSetup.userSettingsPath)).toBe(false);
+            const result = testSetup.execute('logout', []);
+            // Should succeed even without settings
+            expect(result.stderr).toBe('');
+            expect(result.stdout.includes('Successfully logged out') || result.stdout.includes('No user found')).toBe(true);
+        });
+        it('--help works without any configuration', () => {
+            const result = testSetup.execute('', ['--help']);
+            expect(result.exitCode).toBe(0);
+            expect(result.stderr).toBe('');
+            expect(result.stdout).toContain('Usage:');
+        });
+        it('default output is user-friendly (not verbose telemetry)', () => {
+            const result = testSetup.execute('logout', []);
+            // Default output should be clean, not full of telemetry
+            expect(result.stdout).not.toContain('[scenario:start]');
+            expect(result.stdout).not.toContain('[scenario:complete]');
+            expect(result.stdout).not.toContain('scenarioGuid');
+        });
+        it('errors are displayed in user-friendly format', () => {
+            const result = testSetup.execute('add-data-source', []);
+            // Error output should be readable
+            expect(result.stderr.length + result.stdout.length).toBeGreaterThan(0);
+            // Should not be a raw stack trace by default
+            const combinedOutput = `${result.stdout} ${result.stderr}`;
+            // Check it's not just a stack trace
+            if (result.exitCode !== 0) {
+                expect(combinedOutput.toLowerCase().includes('required') ||
+                    combinedOutput.toLowerCase().includes('missing') ||
+                    combinedOutput.toLowerCase().includes('usage') ||
+                    combinedOutput.toLowerCase().includes('error') ||
+                    combinedOutput.includes('--')).toBe(true);
+            }
+        });
+    });
+    describe('telemetry settings persistence', () => {
+        it('settings persist across command executions', () => {
+            // Write settings
+            fs.writeFileSync(testSetup.userSettingsPath, JSON.stringify({
+                enabled: true,
+                consoleOnly: true,
+                outputToConsole: true,
+            }));
+            // Run multiple commands
+            const result1 = testSetup.execute('logout', []);
+            const result2 = testSetup.execute('logout', []);
+            // Settings should still exist
+            expect(fs.existsSync(testSetup.userSettingsPath)).toBe(true);
+            // Both should have similar behavior
+            expect(result1.exitCode).toBe(result2.exitCode);
+        });
+        it('invalid settings file is handled gracefully', () => {
+            // Write invalid JSON
+            fs.writeFileSync(testSetup.userSettingsPath, '{ invalid json }');
+            const result = testSetup.execute('logout', []);
+            // Should either recover gracefully or report clear error
+            // Should not crash with unhandled exception
+            expect(result.stdout.length + result.stderr.length).toBeGreaterThan(0);
+        });
+        it('empty settings file is handled gracefully', () => {
+            fs.writeFileSync(testSetup.userSettingsPath, '');
+            const result = testSetup.execute('logout', []);
+            // Should handle gracefully
+            expect(result.stdout.length + result.stderr.length).toBeGreaterThan(0);
+        });
+    });
+    describe('telemetry event emission (TC: 35840168)', () => {
+        beforeEach(() => {
+            // Enable console telemetry
+            fs.writeFileSync(testSetup.userSettingsPath, JSON.stringify({
+                enabled: true,
+                consoleOnly: true,
+                outputToConsole: true,
+            }));
+        });
+        it('emits telemetry for logout command', () => {
+            const result = testSetup.execute('logout', []);
+            const output = `${result.stdout} ${result.stderr}`;
+            // With telemetry enabled, should see events
+            const hasEvents = output.includes('[scenario:') || output.includes('scenarioGuid') || output.includes('elapsedTime');
+            // If events are emitted, they should be properly formatted
+            if (hasEvents) {
+                expect(output).not.toContain('undefined');
+                expect(output).not.toContain('[object Object]');
+            }
+        });
+        it('emits telemetry for init --help command', () => {
+            const result = testSetup.execute('init', ['--help']);
+            const output = `${result.stdout} ${result.stderr}`;
+            // Help commands should also emit telemetry if enabled
+            const hasEvents = output.includes('[scenario:') || output.includes('scenarioGuid') || output.includes('elapsedTime');
+            if (hasEvents) {
+                expect(output).not.toContain('NaN');
+            }
+        });
+        it('emits telemetry for list-codeapps command', () => {
+            const result = testSetup.execute('list-codeapps', []);
+            const output = `${result.stdout} ${result.stderr}`;
+            // Should have some telemetry output
+            const hasEvents = output.includes('[scenario:') || output.includes('scenarioGuid') || output.includes('elapsedTime');
+            if (hasEvents) {
+                // Verify no malformed output
+                expect(output).not.toContain('undefined');
+            }
+        });
+        it('emits telemetry for failing commands', () => {
+            const result = testSetup.execute('add-data-source', []);
+            const output = `${result.stdout} ${result.stderr}`;
+            // Failed commands should also emit telemetry
+            expect(result.exitCode).not.toBe(0);
+            // Should have some output
+            expect(output.length).toBeGreaterThan(0);
+        });
+        it('telemetry events have timestamps', () => {
+            const result = testSetup.execute('logout', []);
+            const output = `${result.stdout} ${result.stderr}`;
+            // If telemetry is present, check for timestamps
+            if (output.includes('[scenario:')) {
+                // Should have time-based information
+                const hasTimestamp = /\d{2}:\d{2}:\d{2}/.test(output) || // HH:MM:SS format
+                    /scenarioStartTime/.test(output) ||
+                    /elapsedTime/.test(output);
+                expect(hasTimestamp).toBe(true);
+            }
+        });
+    });
+    describe('telemetry disable functionality', () => {
+        it('telemetry is suppressed when disabled', () => {
+            fs.writeFileSync(testSetup.userSettingsPath, JSON.stringify({
+                enabled: false,
+                consoleOnly: false,
+                outputToConsole: false,
+            }));
+            const result = testSetup.execute('logout', []);
+            const output = `${result.stdout} ${result.stderr}`;
+            // Should not have verbose telemetry
+            expect(output).not.toContain('[scenario:start]');
+            expect(output).not.toContain('[scenario:complete]');
+            expect(output).not.toContain('scenarioGuid');
+        });
+        it('command output is cleaner when telemetry disabled', () => {
+            // With telemetry enabled
+            fs.writeFileSync(testSetup.userSettingsPath, JSON.stringify({
+                enabled: true,
+                consoleOnly: true,
+                outputToConsole: true,
+            }));
+            const enabledResult = testSetup.execute('logout', []);
+            const enabledOutput = `${enabledResult.stdout} ${enabledResult.stderr}`;
+            // With telemetry disabled
+            fs.writeFileSync(testSetup.userSettingsPath, JSON.stringify({
+                enabled: false,
+                consoleOnly: false,
+                outputToConsole: false,
+            }));
+            const disabledResult = testSetup.execute('logout', []);
+            const disabledOutput = `${disabledResult.stdout} ${disabledResult.stderr}`;
+            // Disabled output should be shorter or equal (less verbose)
+            if (enabledOutput.includes('[scenario:')) {
+                expect(disabledOutput.length).toBeLessThanOrEqual(enabledOutput.length);
+            }
+        });
+    });
+    describe('CLI config directory behavior', () => {
+        it('uses POWERAPPS_CLI_CONFIG_DIR environment variable', () => {
+            // Our test setup already uses this, verify it works
+            fs.writeFileSync(testSetup.userSettingsPath, JSON.stringify({
+                testMarker: 'isolated-config-test',
+            }));
+            // Verify file is in the isolated directory
+            expect(testSetup.userSettingsPath).toContain(TEST_FOLDER_NAME);
+            expect(fs.existsSync(testSetup.userSettingsPath)).toBe(true);
+            const settings = JSON.parse(fs.readFileSync(testSetup.userSettingsPath, 'utf-8'));
+            expect(settings.testMarker).toBe('isolated-config-test');
+        });
+        it('different test suites have isolated configs', () => {
+            // Create another isolated config using setupE2eTest
+            const otherSetup = setupE2eTest({
+                testFolderName: 'otherTestIsolation',
+                tempBaseDir: E2E_CONFIG.tempBaseDir,
+            });
+            try {
+                fs.writeFileSync(testSetup.userSettingsPath, JSON.stringify({ source: 'main-test' }));
+                fs.writeFileSync(otherSetup.userSettingsPath, JSON.stringify({ source: 'other-test' }));
+                // Verify they're different
+                const mainSettings = JSON.parse(fs.readFileSync(testSetup.userSettingsPath, 'utf-8'));
+                const otherSettings = JSON.parse(fs.readFileSync(otherSetup.userSettingsPath, 'utf-8'));
+                expect(mainSettings.source).toBe('main-test');
+                expect(otherSettings.source).toBe('other-test');
+                expect(testSetup.userSettingsPath).not.toBe(otherSetup.userSettingsPath);
+            }
+            finally {
+                otherSetup.cleanup();
+            }
+        });
+    });
+});
+//# sourceMappingURL=loggingConfiguration.test.js.map

package/lib/__tests__/E2eTests/basicSetup/loggingConfiguration.test.js.map

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

package/lib/__tests__/E2eTests/cliUsability/cliHelp.test.d.ts

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

package/lib/__tests__/E2eTests/cliUsability/cliHelp.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliHelp.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/E2eTests/cliUsability/cliHelp.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/lib/__tests__/E2eTests/cliUsability/cliHelp.test.js

@@ -0,0 +1,162 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * The goal of these tests is to verify that the CLI help output is shown correctly
+ * in various scenarios, including when no verb is provided, when the help verb
+ * is explicitly requested, and when help for a specific verb is requested.
+ */
+import { afterAll, beforeAll, beforeEach, describe, expect, it } from '@jest/globals';
+import { HelpStrings } from '../../../Constants/HelpStrings';
+import { VERB_HELP_REGISTRY } from '../../../Constants/VerbRegistry';
+import { normalizeWhitespace, setupE2eTest } from '../../helpers/testHelpers';
+import { describeE2E } from '../../helpers/e2eTestHelpers';
+import { E2E_CONFIG } from '../e2eConfig';
+const TEST_FOLDER_NAME = 'cliHelpTests';
+// Central list of verbs whose --help we want to validate.
+// '' represents "no verb" (top-level/global help).
+const VERBS_UNDER_TEST = [
+    {
+        verb: '',
+        usage: 'Usage: power-apps [option] [command] [<args>]',
+        expectedText: HelpStrings.Global.ProgramDescription,
+    },
+    {
+        verb: 'init',
+        usage: 'Usage: power-apps init',
+        expectedText: HelpStrings.Verbs.Init.Description,
+        options: HelpStrings.Verbs.Init.Options,
+    },
+    {
+        verb: 'add-data-source',
+        usage: 'Usage: power-apps add-data-source',
+        expectedText: HelpStrings.Verbs['Add-data-source'].Description,
+        options: HelpStrings.Verbs['Add-data-source'].Options,
+    },
+    {
+        verb: 'delete-data-source',
+        usage: 'Usage: power-apps delete-data-source',
+        expectedText: HelpStrings.Verbs['Delete-data-source'].Description,
+        options: HelpStrings.Verbs['Delete-data-source'].Options,
+    },
+    {
+        verb: 'list-codeapps',
+        usage: 'Usage: power-apps list-codeapps',
+        expectedText: HelpStrings.Verbs['List-codeapps'].Description,
+    },
+    {
+        verb: 'list-sqlStoredProcedures',
+        usage: 'Usage: power-apps list-sqlStoredProcedures',
+        expectedText: HelpStrings.Verbs['List-sqlStoredProcedures'].Description,
+        options: HelpStrings.Verbs['List-sqlStoredProcedures'].Options,
+    },
+    {
+        verb: 'list-datasets',
+        usage: 'Usage: power-apps list-datasets',
+        expectedText: HelpStrings.Verbs['List-datasets'].Description,
+        options: HelpStrings.Verbs['List-datasets'].Options,
+    },
+    {
+        verb: 'list-tables',
+        usage: 'Usage: power-apps list-tables',
+        expectedText: HelpStrings.Verbs['List-tables'].Description,
+        options: HelpStrings.Verbs['List-tables'].Options,
+    },
+    {
+        verb: 'list-environment-variables',
+        usage: 'Usage: power-apps list-environment-variables',
+        expectedText: HelpStrings.Verbs['List-environment-variables'].Description,
+        options: HelpStrings.Verbs['List-environment-variables'].Options,
+    },
+    {
+        verb: 'list-connection-references',
+        usage: 'Usage: power-apps list-connection-references',
+        expectedText: HelpStrings.Verbs['List-connection-references'].Description,
+        options: HelpStrings.Verbs['List-connection-references'].Options,
+    },
+    {
+        verb: 'logout',
+        usage: 'Usage: power-apps logout',
+        expectedText: HelpStrings.Verbs.Logout.Description,
+    },
+    {
+        verb: 'push',
+        usage: 'Usage: power-apps push',
+        expectedText: HelpStrings.Verbs.Push.Description,
+        options: HelpStrings.Verbs.Push.Options,
+    },
+    {
+        verb: 'run',
+        usage: 'Usage: power-apps run',
+        expectedText: HelpStrings.Verbs.Run.Description,
+        options: HelpStrings.Verbs.Run.Options,
+    },
+];
+describeE2E('power-apps help output', () => {
+    let testSetup;
+    const originalEnv = { ...process.env };
+    beforeEach(() => {
+        process.env = { ...originalEnv };
+    });
+    beforeAll(() => {
+        testSetup = setupE2eTest({
+            tempBaseDir: E2E_CONFIG.tempBaseDir,
+            testFolderName: TEST_FOLDER_NAME,
+        });
+    });
+    afterAll(() => {
+        process.env = originalEnv;
+        testSetup.cleanup();
+    });
+    it('shows help when no verb is passed', () => {
+        const { stdout, stderr } = testSetup.execute('', []);
+        expect(stderr).toBe('');
+        expect(stdout.length).toBeGreaterThan(0);
+        expect(normalizeWhitespace(stdout)).toContain(normalizeWhitespace(HelpStrings.Global.ProgramDescription));
+    });
+    it('global help includes global option descriptions', () => {
+        const { stdout } = testSetup.execute('', ['--help']);
+        const normalizedOutput = normalizeWhitespace(stdout);
+        expect(normalizedOutput).toContain(`Usage: power-apps [option] [command] [<args>]
+
+Power Apps CLI for managing Power Apps code apps.
+
+Options:
+  -v, --version  output the current version
+  -h, --help     display help for command`);
+    });
+    it('global help includes verb table with all verbs', () => {
+        const { stdout } = testSetup.execute('', ['--help']);
+        // Verify the "Available Commands:" header appears
+        expect(stdout).toContain('Available Commands:');
+        expect(stdout).toContain('Command');
+        expect(stdout).toContain('Description');
+        // Verify each verb from the registry appears in the help output
+        // Note: VERB_REGISTRY is guaranteed to be complete via compile-time type checks
+        Object.entries(VERB_HELP_REGISTRY).forEach(([verb, verbMetadata]) => {
+            expect(stdout).toContain(verb);
+            expect(stdout).toContain(verbMetadata.description);
+        });
+    });
+    describe('--help for each verb', () => {
+        it.each(VERBS_UNDER_TEST)('prints help for %s', ({ verb, usage, expectedText, options }) => {
+            const { stdout, stderr } = verb === '' ? testSetup.execute('', ['--help']) : testSetup.execute(verb, ['--help']);
+            expect(stderr).toBe('');
+            expect(stdout.length).toBeGreaterThan(0);
+            // Verify the expected usage line appears in help output.
+            expect(stdout).toContain(usage);
+            const normalizedOutput = normalizeWhitespace(stdout);
+            // Verify the expected description text appears in help output.
+            if (expectedText) {
+                expect(normalizedOutput).toContain(normalizeWhitespace(expectedText));
+            }
+            // Verify all option descriptions appear in help output.
+            if (options) {
+                Object.values(options).forEach((optionDesc) => {
+                    expect(normalizedOutput).toContain(normalizeWhitespace(optionDesc));
+                });
+            }
+        });
+    });
+});
+//# sourceMappingURL=cliHelp.test.js.map

package/lib/__tests__/E2eTests/cliUsability/cliHelp.test.js.map

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

package/lib/__tests__/E2eTests/cliUsability/logoutReauth.test.d.ts

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

package/lib/__tests__/E2eTests/cliUsability/logoutReauth.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logoutReauth.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/E2eTests/cliUsability/logoutReauth.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/lib/__tests__/E2eTests/cliUsability/logoutReauth.test.js

@@ -0,0 +1,115 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * E2E Tests: CLI Usability - Logout and Reauthentication
+ *
+ * Tests that the CLI properly handles logout and subsequent commands that require auth.
+ * Test Case: TC 35840928 - Logout Requires Reauthentication
+ */
+import { afterAll, beforeAll, describe, expect, it } from '@jest/globals';
+import * as fs from 'fs';
+import * as path from 'path';
+import { describeE2E } from '../../helpers/e2eTestHelpers';
+import { getAuthCachePath, setupE2eTest, writeMinimalConfig } from '../../helpers/testHelpers';
+import { E2E_CONFIG } from '../e2eConfig';
+const TEST_FOLDER_NAME = 'logoutReauthTests';
+describeE2E('CLI Usability - Logout and Reauthentication (TC: 35840928)', () => {
+    let testSetup;
+    beforeAll(() => {
+        testSetup = setupE2eTest({
+            testFolderName: TEST_FOLDER_NAME,
+            tempBaseDir: E2E_CONFIG.tempBaseDir,
+        });
+    });
+    afterAll(() => {
+        testSetup.cleanup();
+    });
+    describe('logout command behavior', () => {
+        it('logout reports success or no user found', () => {
+            const result = testSetup.execute('logout', []);
+            // Logout should succeed with one of two messages
+            expect(result.stdout.includes('Successfully logged out') || result.stdout.includes('No user found')).toBe(true);
+            expect(result.stderr).toBe('');
+        });
+        it('logout is idempotent - running twice does not error', () => {
+            // First logout
+            const result1 = testSetup.execute('logout', []);
+            expect(result1.stderr).toBe('');
+            expect(result1.exitCode).toBe(0);
+            // Second logout should also succeed
+            const result2 = testSetup.execute('logout', []);
+            expect(result2.stderr).toBe('');
+            expect(result2.exitCode).toBe(0);
+        });
+    });
+    describe('commands after logout require reauthentication', () => {
+        // with the CI setup using service principal auth, these commands should succeed automatically
+        beforeAll(() => {
+            // Ensure we're logged out
+            testSetup.execute('logout', []);
+            // Verify no user is cached by checking auth cache directory doesn't exist
+            const authCacheDir = getAuthCachePath(testSetup);
+            if (fs.existsSync(authCacheDir)) {
+                throw new Error(`Auth cache directory still exists after logout: ${authCacheDir}`);
+            }
+            // Create a power.config.json for commands that need it
+            writeMinimalConfig(testSetup, {
+                region: E2E_CONFIG.region,
+                environmentId: E2E_CONFIG.environmentId,
+            });
+        });
+        it('list-codeapps after logout succeeds with service principal', () => {
+            // After logout, list-codeapps should succeed if using service principal auth (E2E test mode)
+            const result = testSetup.execute('list-codeapps', []);
+            expect(result.exitCode).toBe(0);
+            expect(result.stderr).toBe('');
+            expect(result.stdout).toBe('');
+        });
+        it('add-data-source after logout succeeds with service principal', () => {
+            // After logout, add-data-source should succeed if using service principal auth (E2E test mode)
+            const result = testSetup.execute('add-data-source', [
+                '--apiId',
+                'dataverse',
+                '--resourceName',
+                'contact',
+            ]);
+            expect(result.exitCode).toBe(0);
+            expect(result.stderr).toBe('');
+            expect(result.stdout).toBe('');
+        });
+    });
+    describe('logout clears cached credentials', () => {
+        it('auth cache directory is cleared after logout', () => {
+            // This test verifies the implementation detail from Logout.ts
+            // AUTH_CACHE_DIRECTORY is CLI_CONFIG_DIRECTORY/cache/auth
+            const authCacheDir = getAuthCachePath(testSetup);
+            // Create the auth cache directory to simulate a logged-in user
+            fs.mkdirSync(authCacheDir, { recursive: true });
+            // Add a dummy cache file
+            fs.writeFileSync(path.join(authCacheDir, 'token-cache.json'), '{}');
+            expect(fs.existsSync(authCacheDir)).toBe(true);
+            // Run logout - should clear the directory
+            const logoutResult = testSetup.execute('logout', []);
+            expect(logoutResult.stderr).toBe('');
+            expect(logoutResult.stdout.includes('Successfully logged out')).toBe(true);
+            // Verify the auth cache directory is removed
+            expect(fs.existsSync(authCacheDir)).toBe(false);
+        });
+        it('logout reports no user when auth cache does not exist', () => {
+            const authCacheDir = getAuthCachePath(testSetup);
+            // Ensure auth cache doesn't exist
+            if (fs.existsSync(authCacheDir)) {
+                fs.rmSync(authCacheDir, { recursive: true, force: true });
+            }
+            expect(fs.existsSync(authCacheDir)).toBe(false);
+            // Run logout - should report no user
+            const logoutResult = testSetup.execute('logout', []);
+            expect(logoutResult.stderr).toBe('');
+            expect(logoutResult.stdout.includes('No user found')).toBe(true);
+            // Directory should still not exist
+            expect(fs.existsSync(authCacheDir)).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=logoutReauth.test.js.map

package/lib/__tests__/E2eTests/cliUsability/logoutReauth.test.js.map

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

package/lib/__tests__/E2eTests/cliUsability/missingParameters.test.d.ts

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

package/lib/__tests__/E2eTests/cliUsability/missingParameters.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missingParameters.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/E2eTests/cliUsability/missingParameters.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}