auth0-deploy-cli 8.35.0 → 8.36.0

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [8.36.0] - 2026-06-05
+
+### Added
+
+- Add optional flag to skip secret masking during export. [#1396]
+
+### Fixed
+
+- Remove stale connection files from directory export when connections are deleted. [#1389]
+
 ## [8.35.0] - 2026-05-22
 
 ### Added
@@ -1797,9 +1807,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [#1385]: https://github.com/auth0/auth0-deploy-cli/issues/1385
 [#1386]: https://github.com/auth0/auth0-deploy-cli/issues/1386
 [#1387]: https://github.com/auth0/auth0-deploy-cli/issues/1387
+[#1389]: https://github.com/auth0/auth0-deploy-cli/issues/1389
 [#1391]: https://github.com/auth0/auth0-deploy-cli/issues/1391
 [#1392]: https://github.com/auth0/auth0-deploy-cli/issues/1392
-[Unreleased]: https://github.com/auth0/auth0-deploy-cli/compare/v8.35.0...HEAD
+[#1396]: https://github.com/auth0/auth0-deploy-cli/issues/1396
+[Unreleased]: https://github.com/auth0/auth0-deploy-cli/compare/v8.36.0...HEAD
+[8.36.0]: https://github.com/auth0/auth0-deploy-cli/compare/v8.35.0...v8.36.0
 [8.35.0]: https://github.com/auth0/auth0-deploy-cli/compare/v8.34.0...v8.35.0
 [8.34.0]: https://github.com/auth0/auth0-deploy-cli/compare/v8.33.0...v8.34.0
 [8.33.0]: https://github.com/auth0/auth0-deploy-cli/compare/v8.32.0...v8.33.0

package/lib/args.d.ts

@@ -21,6 +21,7 @@ type ExportSpecificParams = {
     output_folder: string;
     export_ids?: boolean;
     export_ordered?: boolean;
+    export_secrets?: boolean;
 };
 export type ExportParams = ExportSpecificParams & SharedParams;
 export type ImportParams = ImportSpecificParams & SharedParams;

package/lib/args.js

@@ -103,6 +103,11 @@ function getParams() {
             describe: 'Order keys in exported JSON files for consistent diffs.',
             type: 'boolean',
         },
+        export_secrets: {
+            describe: 'Export actual secret values instead of placeholder markers.',
+            type: 'boolean',
+            default: false,
+        },
     })
         .example('$0 export -c config.json -f yaml -o path/to/export', 'Dump Auth0 config to folder in YAML format')
         .example('$0 export -c config.json -f directory -o path/to/export', 'Dump Auth0 config to folder in directory format')

package/lib/commands/export.js

@@ -11,7 +11,7 @@ const logger_1 = __importDefault(require("../logger"));
 const utils_1 = require("../utils");
 const index_1 = require("../context/index");
 async function exportCMD(params) {
-    const { output_folder: outputFolder, base_path: basePath, config_file: configFile, config: configObj, export_ids: exportIds, export_ordered: exportOrdered, secret: clientSecret, env: shouldInheritEnv = false, experimental_ea: experimentalEA, } = params;
+    const { output_folder: outputFolder, base_path: basePath, config_file: configFile, config: configObj, export_ids: exportIds, export_ordered: exportOrdered, export_secrets: exportSecrets, secret: clientSecret, env: shouldInheritEnv = false, experimental_ea: experimentalEA, } = params;
     if (shouldInheritEnv) {
         nconf_1.default.env().use('memory');
     }
@@ -36,6 +36,10 @@ async function exportCMD(params) {
     if (exportOrdered) {
         overrides.AUTH0_EXPORT_ORDERED = exportOrdered;
     }
+    // Allow passed in export_secrets to override the configured one
+    if (exportSecrets) {
+        overrides.AUTH0_EXPORT_SECRETS = exportSecrets;
+    }
     // Overrides AUTH0_INCLUDE_EXPERIMENTAL_EA is experimental_ea passed in command line
     if (experimentalEA) {
         overrides.AUTH0_EXPERIMENTAL_EA = experimentalEA;

package/lib/context/defaults.d.ts

@@ -1,7 +1,8 @@
 import { AttackProtection } from '../tools/auth0/handlers/attackProtection';
-export declare function emailProviderDefaults(emailProvider: any): any;
+import { Config } from '../types';
+export declare function emailProviderDefaults(emailProvider: any, config?: Pick<Config, 'AUTH0_EXPORT_SECRETS'>): any;
 export declare function phoneProviderDefaults(phoneProvider: any): any;
 export declare function phoneTemplatesDefaults(phoneTemplate: any): any;
-export declare function connectionDefaults(connection: any): any;
-export declare function logStreamDefaults(logStreams: any): any;
-export declare function attackProtectionDefaults(attackProtection: AttackProtection): AttackProtection;
+export declare function connectionDefaults(connection: any, config?: Pick<Config, 'AUTH0_EXPORT_SECRETS'>): any;
+export declare function logStreamDefaults(logStreams: any, config?: Pick<Config, 'AUTH0_EXPORT_SECRETS'>): any;
+export declare function attackProtectionDefaults(attackProtection: AttackProtection, config?: Pick<Config, 'AUTH0_EXPORT_SECRETS'>): AttackProtection;

package/lib/context/defaults.js

@@ -7,9 +7,15 @@ exports.connectionDefaults = connectionDefaults;
 exports.logStreamDefaults = logStreamDefaults;
 exports.attackProtectionDefaults = attackProtectionDefaults;
 const utils_1 = require("../tools/utils");
+// env vars arrive as strings, so check both forms
+function isExportSecrets(config) {
+    return (config?.AUTH0_EXPORT_SECRETS === true || config?.AUTH0_EXPORT_SECRETS === 'true');
+}
 // eslint-disable-next-line import/prefer-default-export
-function emailProviderDefaults(emailProvider) {
+function emailProviderDefaults(emailProvider, config) {
     // eslint-disable-line
+    if (isExportSecrets(config))
+        return emailProvider;
     const updated = { ...emailProvider };
     const apiKeyProviders = ['mailgun', 'mandrill', 'sendgrid', 'sparkpost'];
     // Add placeholder for credentials as they cannot be exported
@@ -100,8 +106,8 @@ function phoneTemplatesDefaults(phoneTemplate) {
     });
     return updated;
 }
-function connectionDefaults(connection) {
-    if (connection.options) {
+function connectionDefaults(connection, config) {
+    if (!isExportSecrets(config) && connection.options) {
         // Mask secret for key: connection.options.client_secret
         (0, utils_1.maskSecretAtPath)({
             resourceTypeName: 'connections',
@@ -112,7 +118,9 @@ function connectionDefaults(connection) {
     }
     return connection;
 }
-function logStreamDefaults(logStreams) {
+function logStreamDefaults(logStreams, config) {
+    if (isExportSecrets(config))
+        return logStreams;
     // masked sensitive fields
     const sensitiveKeys = [
         'httpAuthorization',
@@ -138,7 +146,9 @@ function logStreamDefaults(logStreams) {
     });
     return maskedLogStreams;
 }
-function attackProtectionDefaults(attackProtection) {
+function attackProtectionDefaults(attackProtection, config) {
+    if (isExportSecrets(config))
+        return attackProtection;
     const { captcha } = attackProtection;
     if (captcha) {
         const providersWithSecrets = ['arkose', 'hcaptcha', 'friendly_captcha', 'recaptcha_v2'];

package/lib/context/directory/handlers/attackProtection.js

@@ -65,7 +65,7 @@ async function dump(context) {
         return;
     const files = attackProtectionFiles(context.filePath);
     fs_extra_1.default.ensureDirSync(files.directory);
-    const maskedAttackProtection = (0, defaults_1.attackProtectionDefaults)(attackProtection);
+    const maskedAttackProtection = (0, defaults_1.attackProtectionDefaults)(attackProtection, context.config);
     if (maskedAttackProtection.botDetection) {
         (0, utils_1.dumpJSON)(files.botDetection, maskedAttackProtection.botDetection);
     }

package/lib/context/directory/handlers/connections.js

@@ -51,6 +51,14 @@ async function dump(context) {
     }
     const connectionsFolder = path_1.default.join(context.filePath, tools_1.constants.CONNECTIONS_DIRECTORY);
     fs_extra_1.default.ensureDirSync(connectionsFolder);
+    // Track files that should remain after dump (written + excluded).
+    // Seed from exclude names directly so excluded connections' files are preserved
+    // regardless of whether the connection still exists on the tenant.
+    const expectedFiles = new Set();
+    for (const name of excludedConnections) {
+        expectedFiles.add(`${(0, utils_1.sanitize)(name)}.json`);
+        expectedFiles.add(`${(0, utils_1.sanitize)(name)}.html`);
+    }
     // Convert enabled_clients from id to name
     connections.forEach((connection) => {
         let dumpedConnection = {
@@ -62,7 +70,7 @@ async function dump(context) {
         };
         const connectionName = (0, utils_1.sanitize)(dumpedConnection.name);
         // Mask secrets
-        dumpedConnection = (0, defaults_1.connectionDefaults)(dumpedConnection);
+        dumpedConnection = (0, defaults_1.connectionDefaults)(dumpedConnection, context.config);
         if (dumpedConnection.strategy === 'email') {
             (0, utils_1.ensureProp)(dumpedConnection, 'options.email.body');
             const html = dumpedConnection.options.email.body;
@@ -81,7 +89,19 @@ async function dump(context) {
         }
         const connectionFile = path_1.default.join(connectionsFolder, `${connectionName}.json`);
         (0, utils_1.dumpJSON)(connectionFile, dumpedConnection);
+        expectedFiles.add(`${connectionName}.json`);
+        if (dumpedConnection.strategy === 'email')
+            expectedFiles.add(`${connectionName}.html`);
     });
+    // Remove files that belong to connections no longer present (and not excluded)
+    if (fs_extra_1.default.existsSync(connectionsFolder)) {
+        for (const existing of fs_extra_1.default.readdirSync(connectionsFolder)) {
+            const fullPath = path_1.default.join(connectionsFolder, existing);
+            if (fs_extra_1.default.statSync(fullPath).isFile() && !expectedFiles.has(existing)) {
+                fs_extra_1.default.removeSync(fullPath);
+            }
+        }
+    }
 }
 const connectionsHandler = {
     parse,

package/lib/context/directory/handlers/emailProvider.js

@@ -31,7 +31,7 @@ async function dump(context) {
         const excludedDefaults = context.assets.exclude?.defaults || [];
         if (!excludedDefaults.includes('emailProvider')) {
             // Add placeholder for credentials as they cannot be exported
-            return (0, defaults_1.emailProviderDefaults)(context.assets.emailProvider);
+            return (0, defaults_1.emailProviderDefaults)(context.assets.emailProvider, context.config);
         }
         return context.assets.emailProvider;
     })();

package/lib/context/directory/handlers/logStreams.js

@@ -31,7 +31,7 @@ async function dump(context) {
     const logStreamsDirectory = path_1.default.join(context.filePath, tools_1.constants.LOG_STREAMS_DIRECTORY);
     fs_extra_1.default.ensureDirSync(logStreamsDirectory);
     // masked sensitive fields
-    const maskedLogStreams = (0, defaults_1.logStreamDefaults)(logStreams);
+    const maskedLogStreams = (0, defaults_1.logStreamDefaults)(logStreams, context.config);
     maskedLogStreams.forEach((logStream) => {
         const ruleFile = path_1.default.join(logStreamsDirectory, `${(0, utils_1.sanitize)(logStream.name)}.json`);
         (0, utils_1.dumpJSON)(ruleFile, logStream);

package/lib/context/directory/index.js

@@ -126,6 +126,18 @@ class DirectoryContext {
         else {
             this.assets = auth0.assets;
         }
+        // Re-attach exclude/include config lost when assets was overwritten above
+        this.assets.exclude = {
+            rules: this.config.AUTH0_EXCLUDED_RULES || [],
+            clients: this.config.AUTH0_EXCLUDED_CLIENTS || [],
+            databases: this.config.AUTH0_EXCLUDED_DATABASES || [],
+            connections: this.config.AUTH0_EXCLUDED_CONNECTIONS || [],
+            resourceServers: this.config.AUTH0_EXCLUDED_RESOURCE_SERVERS || [],
+            defaults: this.config.AUTH0_EXCLUDED_DEFAULTS || [],
+        };
+        this.assets.include = {
+            connections: this.config.AUTH0_INCLUDED_CONNECTIONS || [],
+        };
         // Clean known read only fields
         this.assets = (0, readonly_1.default)(this.assets, this.config);
         // Copy clients to be used by handlers which require converting client_id to the name

package/lib/context/yaml/handlers/attackProtection.js

@@ -25,7 +25,7 @@ async function dump(context) {
     if (captcha) {
         attackProtectionConfig.captcha = captcha;
     }
-    const maskedAttackProtection = (0, defaults_1.attackProtectionDefaults)(attackProtectionConfig);
+    const maskedAttackProtection = (0, defaults_1.attackProtectionDefaults)(attackProtectionConfig, context.config);
     return {
         attackProtection: maskedAttackProtection,
     };

package/lib/context/yaml/handlers/connections.js

@@ -53,7 +53,7 @@ async function dump(context) {
                 }),
             };
             // Mask secrets
-            dumpedConnection = (0, defaults_1.connectionDefaults)(dumpedConnection);
+            dumpedConnection = (0, defaults_1.connectionDefaults)(dumpedConnection, context.config);
             if (dumpedConnection.strategy === 'email') {
                 (0, utils_1.ensureProp)(connection, 'options.email.body');
                 const connectionsFolder = path_1.default.join(context.basePath, tools_1.constants.CONNECTIONS_DIRECTORY);

package/lib/context/yaml/handlers/emailProvider.js

@@ -17,7 +17,7 @@ async function dump(context) {
         const excludedDefaults = context.assets.exclude?.defaults || [];
         if (emailProvider && !excludedDefaults.includes('emailProvider')) {
             // Add placeholder for credentials as they cannot be exported
-            return (0, defaults_1.emailProviderDefaults)(emailProvider);
+            return (0, defaults_1.emailProviderDefaults)(emailProvider, context.config);
         }
         return emailProvider;
     })();

package/lib/context/yaml/handlers/logStreams.js

@@ -14,7 +14,7 @@ async function dump(context) {
     if (!logStreams)
         return { logStreams: null };
     // masked sensitive fields
-    const maskedLogStreams = (0, defaults_1.logStreamDefaults)(logStreams);
+    const maskedLogStreams = (0, defaults_1.logStreamDefaults)(logStreams, context.config);
     return {
         logStreams: maskedLogStreams,
     };

package/lib/types.d.ts

@@ -72,6 +72,7 @@ export type Config = {
     AUTH0_KEYWORD_REPLACE_MAPPINGS?: KeywordMappings;
     AUTH0_EXPORT_IDENTIFIERS?: boolean;
     AUTH0_EXPORT_ORDERED?: boolean;
+    AUTH0_EXPORT_SECRETS?: boolean;
     AUTH0_CONNECTIONS_DIRECTORY?: string;
     AUTH0_DRY_RUN?: boolean | 'preview';
     AUTH0_DRY_RUN_INTERACTIVE?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auth0-deploy-cli",
-  "version": "8.35.0",
+  "version": "8.36.0",
   "description": "A command line tool for deploying updates to your Auth0 tenant",
   "main": "lib/index.js",
   "bin": {