@microsoft/power-apps-cli 0.6.0 → 0.6.4

package/lib/__tests__/UnitTests/ServicePrincipalAuthenticationProvider.spec.js

@@ -42,7 +42,7 @@ describe('ServicePrincipalAuthenticationProvider', () => {
         });
         it('initializes MSAL with the expected authority and credentials', async () => {
             const provider = new ServicePrincipalAuthenticationProvider();
-            await provider.initAsync();
+            await provider.initAsync('prod');
             expect(MockedConfidentialClientApplication).toHaveBeenCalledWith({
                 auth: {
                     clientId: 'client-id',
@@ -54,7 +54,7 @@ describe('ServicePrincipalAuthenticationProvider', () => {
         it('acquires and returns an access token for the requested resource', async () => {
             acquireTokenByClientCredentialMock.mockResolvedValueOnce({ accessToken: 'token-value' });
             const provider = new ServicePrincipalAuthenticationProvider();
-            await provider.initAsync();
+            await provider.initAsync('prod');
             const token = await provider.getAccessTokenForResource('https://resource');
             expect(acquireTokenByClientCredentialMock).toHaveBeenCalledWith({
                 scopes: ['https://resource/.default'],
@@ -64,7 +64,7 @@ describe('ServicePrincipalAuthenticationProvider', () => {
         it('throws when MSAL returns no access token', async () => {
             acquireTokenByClientCredentialMock.mockResolvedValueOnce(undefined);
             const provider = new ServicePrincipalAuthenticationProvider();
-            await provider.initAsync();
+            await provider.initAsync('prod');
             await expect(provider.getAccessTokenForResource('https://resource')).rejects.toThrow('Failed to acquire token using service principal');
         });
         it('throws if getAccessTokenForResource is called before initAsync', async () => {

package/lib/__tests__/UnitTests/ServicePrincipalAuthenticationProvider.spec.js.map

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

package/lib/__tests__/UnitTests/enhanceNetworkError.test.d.ts

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

package/lib/__tests__/UnitTests/enhanceNetworkError.test.d.ts.map

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

package/lib/__tests__/UnitTests/enhanceNetworkError.test.js

@@ -0,0 +1,177 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { describe, expect, it } from '@jest/globals';
+import { enhanceNetworkError } from '../../Utils/EnhanceNetworkError';
+/* eslint-disable @typescript-eslint/no-explicit-any */
+describe('enhanceNetworkError', () => {
+    const testMethod = 'GET';
+    const testUrl = 'https://example.com/api/test';
+    describe('non-fetch errors', () => {
+        it('returns Error objects unchanged', () => {
+            const originalError = new Error('Some other error');
+            const result = enhanceNetworkError(originalError, testMethod, testUrl);
+            expect(result).toBe(originalError);
+            expect(result.message).toBe('Some other error');
+        });
+        it('wraps non-Error values in Error objects', () => {
+            const result = enhanceNetworkError('string error', testMethod, testUrl);
+            expect(result).toBeInstanceOf(Error);
+            expect(result.message).toBe('string error');
+        });
+        it('returns TypeError without "fetch failed" message unchanged', () => {
+            const originalError = new TypeError('Invalid URL');
+            const result = enhanceNetworkError(originalError, testMethod, testUrl);
+            expect(result).toBe(originalError);
+            expect(result.message).toBe('Invalid URL');
+        });
+    });
+    describe('fetch failures with specific error codes', () => {
+        it('enhances ENOTFOUND error (DNS lookup failure)', () => {
+            const fetchError = new TypeError('fetch failed');
+            fetchError.cause = {
+                code: 'ENOTFOUND',
+                message: 'getaddrinfo ENOTFOUND example.com',
+            };
+            const result = enhanceNetworkError(fetchError, testMethod, testUrl);
+            expect(result).toBeInstanceOf(Error);
+            expect(result.message).toContain('Network request failed for GET https://example.com/api/test');
+            expect(result.message).toContain('DNS lookup failed - unable to resolve hostname');
+            expect(result.message).toContain('Details: getaddrinfo ENOTFOUND example.com');
+            expect(result.cause).toBe(fetchError);
+        });
+        it('enhances ECONNREFUSED error (connection refused)', () => {
+            const fetchError = new TypeError('fetch failed');
+            fetchError.cause = {
+                code: 'ECONNREFUSED',
+                message: 'connect ECONNREFUSED 127.0.0.1:443',
+            };
+            const result = enhanceNetworkError(fetchError, testMethod, testUrl);
+            expect(result.message).toContain('Connection refused - server is not accepting connections');
+            expect(result.message).toContain('Details: connect ECONNREFUSED 127.0.0.1:443');
+        });
+        it('enhances ETIMEDOUT error (connection timeout)', () => {
+            const fetchError = new TypeError('fetch failed');
+            fetchError.cause = {
+                code: 'ETIMEDOUT',
+                message: 'connect ETIMEDOUT',
+            };
+            const result = enhanceNetworkError(fetchError, testMethod, testUrl);
+            expect(result.message).toContain('Connection timed out - server did not respond in time');
+        });
+        it('enhances ECONNRESET error (connection reset)', () => {
+            const fetchError = new TypeError('fetch failed');
+            fetchError.cause = {
+                code: 'ECONNRESET',
+                message: 'socket hang up',
+            };
+            const result = enhanceNetworkError(fetchError, testMethod, testUrl);
+            expect(result.message).toContain('Connection reset - server closed the connection unexpectedly');
+        });
+    });
+    describe('certificate validation errors', () => {
+        it('enhances UNABLE_TO_VERIFY_LEAF_SIGNATURE error', () => {
+            const fetchError = new TypeError('fetch failed');
+            fetchError.cause = {
+                code: 'UNABLE_TO_VERIFY_LEAF_SIGNATURE',
+                message: 'unable to verify the first certificate',
+            };
+            const result = enhanceNetworkError(fetchError, testMethod, testUrl);
+            expect(result.message).toContain('Certificate validation failed (UNABLE_TO_VERIFY_LEAF_SIGNATURE)');
+        });
+        it('enhances CERT_HAS_EXPIRED error', () => {
+            const fetchError = new TypeError('fetch failed');
+            fetchError.cause = {
+                code: 'CERT_HAS_EXPIRED',
+                message: 'certificate has expired',
+            };
+            const result = enhanceNetworkError(fetchError, testMethod, testUrl);
+            expect(result.message).toContain('Certificate validation failed (CERT_HAS_EXPIRED)');
+        });
+        it('enhances any CERT_* prefixed error', () => {
+            const fetchError = new TypeError('fetch failed');
+            fetchError.cause = {
+                code: 'CERT_REVOKED',
+                message: 'certificate revoked',
+            };
+            const result = enhanceNetworkError(fetchError, testMethod, testUrl);
+            expect(result.message).toContain('Certificate validation failed (CERT_REVOKED)');
+        });
+    });
+    describe('generic system errors', () => {
+        it('enhances unknown error codes', () => {
+            const fetchError = new TypeError('fetch failed');
+            fetchError.cause = {
+                code: 'UNKNOWN_ERROR',
+                message: 'Something went wrong',
+            };
+            const result = enhanceNetworkError(fetchError, testMethod, testUrl);
+            expect(result.message).toContain('System error: UNKNOWN_ERROR');
+            expect(result.message).toContain('Details: Something went wrong');
+        });
+        it('uses errno if code is not present', () => {
+            const fetchError = new TypeError('fetch failed');
+            fetchError.cause = {
+                errno: -3008,
+                message: 'Network error',
+            };
+            const result = enhanceNetworkError(fetchError, testMethod, testUrl);
+            expect(result.message).toContain('System error: -3008');
+        });
+    });
+    describe('fetch failures without specific error codes', () => {
+        it('provides general suggestions when no error code is available', () => {
+            const fetchError = new TypeError('fetch failed');
+            fetchError.cause = {
+                message: 'Generic network failure',
+            };
+            const result = enhanceNetworkError(fetchError, testMethod, testUrl);
+            expect(result.message).toContain('Network request failed for GET https://example.com/api/test');
+            expect(result.message).toContain('Possible causes: network connectivity issues');
+            expect(result.message).toContain('DNS resolution failure');
+            expect(result.message).toContain('VPN/proxy configuration');
+            expect(result.message).toContain('firewall/certificate issues');
+        });
+        it('provides general suggestions when cause is missing entirely', () => {
+            const fetchError = new TypeError('fetch failed');
+            const result = enhanceNetworkError(fetchError, testMethod, testUrl);
+            expect(result.message).toContain('Network request failed for GET https://example.com/api/test');
+            expect(result.message).toContain('Possible causes: network connectivity issues');
+        });
+    });
+    describe('cause chain preservation', () => {
+        it('preserves the original error as cause', () => {
+            const originalCause = {
+                code: 'ENOTFOUND',
+                message: 'DNS error',
+            };
+            const fetchError = new TypeError('fetch failed');
+            fetchError.cause = originalCause;
+            const result = enhanceNetworkError(fetchError, testMethod, testUrl);
+            expect(result.cause).toBe(fetchError);
+            expect(fetchError.cause).toBe(originalCause);
+        });
+    });
+    describe('message formatting', () => {
+        it('includes HTTP method and URL in message', () => {
+            const fetchError = new TypeError('fetch failed');
+            fetchError.cause = { code: 'ENOTFOUND' };
+            const result = enhanceNetworkError(fetchError, 'POST', 'https://api.example.com/v1/users');
+            expect(result.message).toContain('POST');
+            expect(result.message).toContain('https://api.example.com/v1/users');
+        });
+        it('does not duplicate cause message if it matches error message', () => {
+            const fetchError = new TypeError('fetch failed');
+            fetchError.cause = {
+                code: 'ENOTFOUND',
+                message: 'fetch failed', // Same as error message
+            };
+            const result = enhanceNetworkError(fetchError, testMethod, testUrl);
+            // Should only appear once in the message
+            const matches = result.message.match(/fetch failed/g);
+            expect(matches).toBeNull(); // Neither should appear since we don't include them
+        });
+    });
+});
+/* eslint-enable @typescript-eslint/no-explicit-any */
+//# sourceMappingURL=enhanceNetworkError.test.js.map

package/lib/__tests__/UnitTests/enhanceNetworkError.test.js.map

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

package/lib/__tests__/helpers/e2eTestHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"e2eTestHelpers.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/e2eTestHelpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB,SAI9B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,OAAO,QAE7B,CAAC"}
+{"version":3,"file":"e2eTestHelpers.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/e2eTestHelpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB,SAI9B,CAAC;AAsBF,eAAO,MAAM,WAAW,EAAE,OAAO,QAE7B,CAAC"}

package/lib/__tests__/helpers/e2eTestHelpers.js

@@ -22,6 +22,22 @@ import { describe } from '@jest/globals';
 export const hasRequiredEnvVars = !!(process.env.SP_CLIENT_ID &&
     process.env.SP_CLIENT_SECRET &&
     process.env.SP_TENANT_ID);
+// Report missing environment variables
+if (!hasRequiredEnvVars) {
+    const missingVars = [];
+    if (!process.env.SP_CLIENT_ID) {
+        missingVars.push('SP_CLIENT_ID');
+    }
+    if (!process.env.SP_CLIENT_SECRET) {
+        missingVars.push('SP_CLIENT_SECRET');
+    }
+    if (!process.env.SP_TENANT_ID) {
+        missingVars.push('SP_TENANT_ID');
+    }
+    console.warn('\n E2E tests are being skipped due to missing environment variables:\n' +
+        `   Missing: ${missingVars.join(', ')}\n` +
+        '   Please set these variables to run E2E tests.\n');
+}
 export const describeE2E = (() => {
     return (hasRequiredEnvVars ? describe : describe.skip);
 })();

package/lib/__tests__/helpers/e2eTestHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"e2eTestHelpers.js","sourceRoot":"","sources":["../../../src/__tests__/helpers/e2eTestHelpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,CAClC,OAAO,CAAC,GAAG,CAAC,YAAY;IACxB,OAAO,CAAC,GAAG,CAAC,gBAAgB;IAC5B,OAAO,CAAC,GAAG,CAAC,YAAY,CACzB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAoB,CAAC,GAAG,EAAE;IAChD,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAoB,CAAC;AAC5E,CAAC,CAAC,EAAE,CAAC"}
+{"version":3,"file":"e2eTestHelpers.js","sourceRoot":"","sources":["../../../src/__tests__/helpers/e2eTestHelpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,CAClC,OAAO,CAAC,GAAG,CAAC,YAAY;IACxB,OAAO,CAAC,GAAG,CAAC,gBAAgB;IAC5B,OAAO,CAAC,GAAG,CAAC,YAAY,CACzB,CAAC;AAEF,uCAAuC;AACvC,IAAI,CAAC,kBAAkB,EAAE;IACvB,MAAM,WAAW,GAAG,EAAE,CAAC;IACvB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE;QAC7B,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;KAClC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE;QACjC,WAAW,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;KACtC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE;QAC7B,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;KAClC;IAED,OAAO,CAAC,IAAI,CACV,wEAAwE;QACtE,eAAe,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QACzC,mDAAmD,CACtD,CAAC;CACH;AAED,MAAM,CAAC,MAAM,WAAW,GAAoB,CAAC,GAAG,EAAE;IAChD,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAoB,CAAC;AAC5E,CAAC,CAAC,EAAE,CAAC"}

package/lib/__tests__/helpers/testHelpers.d.ts

@@ -1,5 +1,36 @@
 /// <reference types="node" />
 import { PowerAppsRepoConfig } from '@microsoft/powerapps-player-actions/lib/Config/Config.types';
+/**
+ * Gets the path to power.config.json for a project.
+ *
+ * @param {string | E2eTestSetup} projectRootOrSetup - Project root path or E2eTestSetup object
+ * @returns {string} Path to power.config.json
+ */
+export declare function getConfigPath(projectRootOrSetup: string | E2eTestSetup): string;
+/**
+ * Gets the auth cache directory path for a test setup.
+ *
+ * @param {E2eTestSetup} testSetup - The test setup object
+ * @returns {string} Path to auth cache directory
+ */
+export declare function getAuthCachePath(testSetup: E2eTestSetup): string;
+/**
+ * Combines stdout and stderr to lowercase for test assertions.
+ *
+ * @param {object} result - Command result with stdout and stderr
+ * @returns {string} Combined lowercase output
+ */
+export declare function getCombinedOutput(result: {
+    stdout: string;
+    stderr: string;
+}): string;
+/**
+ * Normalizes whitespace for help text comparison.
+ *
+ * @param {string} text - Text to normalize
+ * @returns {string} Text with whitespace normalized
+ */
+export declare function normalizeWhitespace(text: string): string;
 /**
  * Creates a test folder relative to the current working directory.
  *
@@ -13,21 +44,7 @@ export declare function createTestFolder(folderName: string): string;
  * @param {string} folderName
  */
 export declare function cleanupTestFolder(folderName: string): void;
-/**
- * Copies a host template app from source to destination directory.
- *
- * @param {string} source - Source directory path
- * @param {string} destination - Destination directory path
- */
-export declare function copyHostTemplateApp(source: string, destination: string): void;
 export declare function readJson(filePath: string): Record<string, unknown>;
-/**
- * Recursively copies a directory and its contents from source to destination.
- *
- * @param {string} src - Source directory path
- * @param {string} dest - Destination directory path
- */
-export declare function copyDirRecursive(src: string, dest: string): void;
 /**
  * Validates that generated model and service files exist for a given data source.
  * Generated files follow the pattern: {DataSourceName}Model.ts and {DataSourceName}Service.ts
@@ -68,21 +85,7 @@ export declare function extractZip(source: string, destination: string): void;
  */
 export declare function cleanupE2eTestProject(projectRoot: string): void;
 /**
- * Creates a function that executes CLI commands with predefined configuration.
- * Isolates the stdout and stderr for each executor instance.
- *
- * @param {string} [options.cliPath] - Path to the CLI entry point (defaults to dist/nomodule/powerapps-player-cli.js)
- * @param {string} options.workingDirectory - Working directory for command execution
- * @param {NodeJS.ProcessEnv} [options.envOverrides] - Environment variable overrides
- * @returns {(verb: string, args?: string[]) => CliCommandResult} Command executor function
- */
-export declare function createExecuteCodeCommand(options: {
-    cliPath?: string;
-    workingDirectory: string;
-    envOverrides?: NodeJS.ProcessEnv;
-}): (verb: string, args?: string[]) => import("./commandLineUtils").CliCommandResult;
-/**
- * Creates a command executor that allows CLI command failures without throwing.
+ * Creates a command executor that allows CLI command failures.
  * Useful for testing error scenarios and validating error handling.
  *
  * @param {object} options - Configuration object
@@ -91,10 +94,123 @@ export declare function createExecuteCodeCommand(options: {
  * @param {NodeJS.ProcessEnv} [options.envOverrides] - Environment variable overrides
  * @returns {(verb: string, args?: string[]) => CliCommandResultWithExitCode} executor function
  */
-export declare function createExecuteCodeCommandAllowFailure(options: {
+export declare function createExecuteCodeCommand(options: {
     cliPath?: string;
     workingDirectory: string;
     envOverrides?: NodeJS.ProcessEnv;
 }): (verb: string, args?: string[]) => import("./commandLineUtils").CliCommandResultWithExitCode;
 export declare function readConfig(projectRoot: string): PowerAppsRepoConfig;
+/**
+ * Creates a minimal power.config.json for testing.
+ * Use this instead of manually creating config objects in individual test files.
+ *
+ * @param overrides - Partial config to override defaults
+ * @returns A complete minimal config object
+ */
+export declare function createMinimalConfig(overrides?: Partial<PowerAppsRepoConfig>): PowerAppsRepoConfig;
+/**
+ * Writes a minimal config file to the test project root.
+ * Convenience wrapper around createMinimalConfig + fs.writeFileSync.
+ *
+ * @param testSetup - The E2eTestSetup object
+ * @param overrides - Partial config to override defaults
+ */
+export declare function writeMinimalConfig(testSetup: E2eTestSetup, overrides?: Partial<PowerAppsRepoConfig>): void;
+/**
+ * Result of setupE2eTest containing all test infrastructure.
+ */
+export interface E2eTestSetup {
+    /** Root directory of the test project */
+    projectRoot: string;
+    /** Isolated CLI config directory for this test */
+    cliConfigDir: string;
+    /** Path to userSettings.json in the isolated config dir */
+    userSettingsPath: string;
+    /** Environment variable overrides including isolated config */
+    envOverrides: Record<string, string>;
+    /** Command executor */
+    execute: ReturnType<typeof createExecuteCodeCommand>;
+    /** Cleanup function to call in afterAll */
+    cleanup: () => void;
+}
+/**
+ * Sets up a complete E2E test environment with isolated configuration.
+ * This is the recommended way to set up E2E tests as it:
+ * - Creates a unique project directory
+ * - Creates an isolated CLI config directory to prevent test interference
+ * - Pre-configures command executors with proper environment overrides
+ * - Provides a cleanup function for afterAll
+ *
+ * @example
+ * ```typescript
+ * let testSetup: E2eTestSetup;
+ *
+ * beforeAll(() => {
+ *   testSetup = setupE2eTest({ testFolderName: 'myTests' });
+ * });
+ *
+ * afterAll(() => {
+ *   testSetup.cleanup();
+ * });
+ *
+ * it('runs a command', () => {
+ *   const result = testSetup.execute('logout', []);
+ *   expect(result.stderr).toBe('');
+ * });
+ * ```
+ *
+ * @param config - Configuration options
+ * @param config.testFolderName - Unique name for the test folder
+ * @param config.tempBaseDir - Optional base directory for temp folders
+ * @param config.hostTemplateFolder - Optional host template to copy
+ * @param config.cliPath - Optional path to CLI entry point
+ * @returns E2eTestSetup object with all test infrastructure
+ */
+export declare function setupE2eTest(config: {
+    testFolderName: string;
+    tempBaseDir?: string;
+    hostTemplateFolder?: string;
+    cliPath?: string;
+}): E2eTestSetup;
+/**
+ * Executes a callback with the power.config.json temporarily removed.
+ * Useful for testing error scenarios when config is missing.
+ * The config file is automatically restored after the callback completes (or throws).
+ *
+ * @example
+ * ```typescript
+ * it('errors when config is missing', () => {
+ *   withoutConfig(testSetup, () => {
+ *     const result = testSetup.executeAllowFailure('list-codeapps', []);
+ *     expect(result.exitCode).not.toBe(0);
+ *   });
+ * });
+ * ```
+ *
+ * @param testSetup - The E2eTestSetup object containing the project root
+ * @param callback - Function to execute while config is absent
+ * @returns The return value of the callback
+ */
+export declare function withoutConfig<T>(testSetup: E2eTestSetup, callback: () => T): T;
+/**
+ * Executes a callback with a custom power.config.json temporarily in place.
+ * Useful for testing error scenarios with corrupted or incomplete configs.
+ * The original config file is automatically restored after the callback completes (or throws).
+ *
+ * @example
+ * ```typescript
+ * it('errors when config is invalid', () => {
+ *   withTemporaryConfig(testSetup, '{ invalid json }', () => {
+ *     const result = testSetup.executeAllowFailure('list-codeapps', []);
+ *     expect(result.exitCode).not.toBe(0);
+ *   });
+ * });
+ * ```
+ *
+ * @param testSetup - The E2eTestSetup object containing the project root
+ * @param temporaryContent - Content to write as power.config.json during the callback
+ * @param callback - Function to execute with the temporary config
+ * @returns The return value of the callback
+ */
+export declare function withTemporaryConfig<T>(testSetup: E2eTestSetup, temporaryContent: string | object, callback: () => T): T;
 //# sourceMappingURL=testHelpers.d.ts.map

package/lib/__tests__/helpers/testHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testHelpers.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/testHelpers.ts"],"names":[],"mappings":";AAgBA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAGlG;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAU3D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAO1D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAI7E;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAiBhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CA2BxF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,MAAM,CAmCT;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAQpE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAI/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,UAkBe,MAAM,SAAQ,MAAM,EAAE,mDAIrC;AAED;;;;;;;;;GASG;AACH,wBAAgB,oCAAoC,CAAC,OAAO,EAAE;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,UAkBe,MAAM,SAAQ,MAAM,EAAE,+DAIrC;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,CAEnE"}
+{"version":3,"file":"testHelpers.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/testHelpers.ts"],"names":[],"mappings":"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"}