auth0-deploy-cli 8.34.0 → 8.35.0

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [8.35.0] - 2026-05-22
+
+### Added
+
+- Add `AUTH0_IGNORE_DRY_RUN_FIELDS` config option to exclude specified fields from `--dry-run` diff output per handler type. [#1385]
+- Add hostnames and CIDR fields to network ACL match schema. [#1386]
+- Add `ES384` and `ES512` as valid `dpop_signing_alg` values for OIDC and Okta enterprise connections (GA). [#1391]
+
+### Deprecated
+
+- Deprecate absolute and external file path references in config handlers; a warning is emitted when detected. Support will be removed in a future major version. [#1392]
+
+### Fixed
+
+- Fix keyword markers in themes not being preserved during default export configuration. [#1387]
+
 ## [8.34.0] - 2026-05-11
 
 ### Added
@@ -1778,7 +1794,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [#1379]: https://github.com/auth0/auth0-deploy-cli/issues/1379
 [#1380]: https://github.com/auth0/auth0-deploy-cli/issues/1380
 [#1381]: https://github.com/auth0/auth0-deploy-cli/issues/1381
-[Unreleased]: https://github.com/auth0/auth0-deploy-cli/compare/v8.34.0...HEAD
+[#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
+[#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
+[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
 [8.32.0]: https://github.com/auth0/auth0-deploy-cli/compare/v8.31.0...v8.32.0

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

@@ -26,6 +26,9 @@ function parse(context) {
             // It can be a relative path, so we need to handle both cases.
             const unixPath = module.code.replace(/[\\/]+/g, '/').replace(/^([a-zA-Z]+:|\.\/)/, '');
             if (fs_extra_1.default.existsSync(unixPath)) {
+                logger_1.default.warn(`Support for absolute paths and paths outside the config root will be deprecated in a future version to improve the security of the tool. ` +
+                    `Please update your configuration to use paths relative to the config directory. ` +
+                    `Current absolute path used: ["${module.code}"]`);
                 module.code = context.loadFile(unixPath, moduleFolder);
             }
             else {

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

@@ -28,6 +28,9 @@ function parse(context) {
             const unixPath = action.code.replace(/[\\/]+/g, '/').replace(/^([a-zA-Z]+:|\.\/)/, '');
             if (fs_extra_1.default.existsSync(unixPath)) {
                 // If the Unix-style path exists, load the file from that path
+                logger_1.default.warn(`Support for absolute paths and paths outside the config root will be deprecated in a future version to improve the security of the tool. ` +
+                    `Please update your configuration to use paths relative to the config directory. ` +
+                    `Current absolute path used: ["${action.code}"]`);
                 action.code = context.loadFile(unixPath, actionFolder);
             }
             else {

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

@@ -8,7 +8,7 @@ const fs_extra_1 = __importDefault(require("fs-extra"));
 const tools_1 = require("../../../tools");
 const logger_1 = __importDefault(require("../../../logger"));
 const utils_1 = require("../../../utils");
-function getDatabase(folder, mappingOpts) {
+function getDatabase(folder, configRoot, mappingOpts) {
     const metaFile = path_1.default.join(folder, 'database.json');
     const metaData = (() => {
         try {
@@ -40,7 +40,14 @@ function getDatabase(folder, mappingOpts) {
                 logger_1.default.warn('Skipping invalid database configuration: ' + name);
             }
             else {
-                database.options.customScripts[name] = (0, tools_1.loadFileAndReplaceKeywords)(path_1.default.join(folder, script), mappingOpts);
+                const resolvedBase = path_1.default.resolve(configRoot);
+                const toLoad = path_1.default.resolve(folder, script);
+                if (!toLoad.startsWith(resolvedBase + path_1.default.sep)) {
+                    logger_1.default.warn(`Support for absolute paths and paths outside the config root will be deprecated in a future version to improve the security of the tool. ` +
+                        `Please update your configuration to use paths relative to the config directory. ` +
+                        `Current absolute path used: ["${script}"]`);
+                }
+                database.options.customScripts[name] = (0, tools_1.loadFileAndReplaceKeywords)(toLoad, mappingOpts);
             }
         });
     }
@@ -55,7 +62,7 @@ function parse(context) {
         .map((f) => path_1.default.join(databaseFolder, f))
         .filter((f) => (0, utils_1.isDirectory)(f));
     const databases = folders
-        .map((f) => getDatabase(f, {
+        .map((f) => getDatabase(f, context.filePath, {
         mappings: context.mappings,
         disableKeywordReplacement: context.disableKeywordReplacement,
     }))

package/lib/context/directory/index.js

@@ -73,6 +73,9 @@ class DirectoryContext {
         if (!(0, utils_1.isFile)(toLoad)) {
             // try load not relative to yaml file
             toLoad = f;
+            logger_1.default.warn(`Support for absolute paths and paths outside the config root will be deprecated in a future version to improve the security of the tool. ` +
+                `Please update your configuration to use paths relative to the config directory. ` +
+                `Current absolute path used: ["${f}"]`);
         }
         return (0, tools_1.loadFileAndReplaceKeywords)(toLoad, {
             mappings: this.mappings,

package/lib/context/yaml/index.js

@@ -47,6 +47,9 @@ class YAMLContext {
         if (!(0, utils_1.isFile)(toLoad)) {
             // try load not relative to yaml file
             toLoad = f;
+            logger_1.default.warn(`Support for absolute paths and paths outside the config root will be deprecated in a future version to improve the security of the tool. ` +
+                `Please update your configuration to use paths relative to the config directory. ` +
+                `Current absolute path used: ["${f}"]`);
         }
         return (0, tools_1.loadFileAndReplaceKeywords)(path_1.default.resolve(toLoad), {
             mappings: this.mappings,

package/lib/keywordPreservation.js

@@ -48,17 +48,22 @@ const getPreservableFieldsFromAssets = (asset, keywordMappings, resourceSpecific
             const specificAddress = resourceIdentifiers.reduce((aggregateAddress, resourceIdentifier) => {
                 resourceSpecificIdentifiers[address];
                 if (resourceIdentifier === undefined)
-                    return ''; // See if this specific resource type has an identifier
+                    return aggregateAddress; // See if this specific resource type has an identifier
                 const identifierFieldValue = arrayItem[resourceIdentifier];
                 if (identifierFieldValue === undefined)
-                    return ''; // See if this specific array item possess the resource-specific identifier
+                    return aggregateAddress; // See if this specific array item possess the resource-specific identifier
                 if (aggregateAddress === '') {
                     return `${resourceIdentifier}=${identifierFieldValue}`;
                 }
                 return `${aggregateAddress}||${resourceIdentifier}=${identifierFieldValue}`;
             }, '');
             if (specificAddress.length === 0) {
-                return [];
+                // No identifiers registered: skip. Identifiers registered but absent from item: fall back to positional index.
+                if (resourceIdentifiers.length === 0) {
+                    return [];
+                }
+                const arrayIndex = asset.indexOf(arrayItem);
+                return (0, exports.getPreservableFieldsFromAssets)(arrayItem, keywordMappings, resourceSpecificIdentifiers, `${address}${shouldRenderDot ? '.' : ''}${arrayIndex}`);
             }
             return (0, exports.getPreservableFieldsFromAssets)(arrayItem, keywordMappings, resourceSpecificIdentifiers, `${address}${shouldRenderDot ? '.' : ''}[${specificAddress}]`);
         })

package/lib/tools/auth0/handlers/connections.d.ts

@@ -23,6 +23,7 @@ export declare const schema: {
                     };
                     dpop_signing_alg: {
                         type: string;
+                        enum: string[];
                     };
                     token_endpoint_auth_signing_alg: {
                         type: string;

package/lib/tools/auth0/handlers/connections.js

@@ -61,6 +61,7 @@ const connectionOptionsSchema = {
         },
         dpop_signing_alg: {
             type: 'string',
+            enum: ['ES256', 'ES384', 'ES512', 'Ed25519'],
         },
         token_endpoint_auth_signing_alg: {
             type: 'string',

package/lib/tools/auth0/handlers/default.d.ts

@@ -42,6 +42,13 @@ export default class APIHandler {
         };
         ignoreDryRunFields: APIHandler['ignoreDryRunFields'];
     });
+    /**
+     * Returns the effective `ignoreDryRunFields` for this handler, merging the
+     * handler's hardcoded defaults with any user-supplied entries from the
+     * `AUTH0_IGNORE_DRY_RUN_FIELDS[<type>]` config key. Read lazily so that the
+     * constructor remains free of config-provider invocations.
+     */
+    getEffectiveIgnoreDryRunFields(): string[];
     getClientFN(fn: ApiMethodOverride): Function;
     didDelete(item: Asset): void;
     didCreate(item: Asset): void;

package/lib/tools/auth0/handlers/default.js

@@ -88,6 +88,25 @@ class APIHandler {
         this.created = 0;
         this.deleted = 0;
     }
+    /**
+     * Returns the effective `ignoreDryRunFields` for this handler, merging the
+     * handler's hardcoded defaults with any user-supplied entries from the
+     * `AUTH0_IGNORE_DRY_RUN_FIELDS[<type>]` config key. Read lazily so that the
+     * constructor remains free of config-provider invocations.
+     */
+    getEffectiveIgnoreDryRunFields() {
+        let configured = [];
+        try {
+            const map = this.config('AUTH0_IGNORE_DRY_RUN_FIELDS');
+            if (map && Array.isArray(map[this.type])) {
+                configured = map[this.type];
+            }
+        }
+        catch {
+            configured = [];
+        }
+        return [...this.ignoreDryRunFields, ...configured].filter((field, index, allFields) => allFields.indexOf(field) === index);
+    }
     getClientFN(fn) {
         if (typeof fn === 'string') {
             const client = this.client[this.type];
@@ -194,7 +213,7 @@ class APIHandler {
                 // @ts-ignore TODO: investigate what happens when `existing` is null
                 existing,
                 identifiers: this.identifiers,
-                ignoreDryRunFields: this.ignoreDryRunFields,
+                ignoreDryRunFields: this.getEffectiveIgnoreDryRunFields(),
             });
         }
         // if we are not in dry run mode, calculate the changes
@@ -227,7 +246,7 @@ class APIHandler {
             // @ts-ignore TODO: investigate what happens when `existing` is null
             existing,
             identifiers: this.identifiers,
-            ignoreDryRunFields: this.ignoreDryRunFields,
+            ignoreDryRunFields: this.getEffectiveIgnoreDryRunFields(),
         });
     }
     async validate(assets) {

package/lib/tools/auth0/handlers/networkACLs.d.ts

@@ -150,6 +150,27 @@ export declare const schema: {
                                     minItems: number;
                                     maxItems: number;
                                 };
+                                hostnames: {
+                                    type: string;
+                                    items: {
+                                        type: string;
+                                    };
+                                    uniqueItems: boolean;
+                                };
+                                connecting_ipv4_cidrs: {
+                                    type: string;
+                                    items: {
+                                        type: string;
+                                    };
+                                    uniqueItems: boolean;
+                                };
+                                connecting_ipv6_cidrs: {
+                                    type: string;
+                                    items: {
+                                        type: string;
+                                    };
+                                    uniqueItems: boolean;
+                                };
                             };
                             additionalProperties: boolean;
                         };
@@ -228,6 +249,27 @@ export declare const schema: {
                                     minItems: number;
                                     maxItems: number;
                                 };
+                                hostnames: {
+                                    type: string;
+                                    items: {
+                                        type: string;
+                                    };
+                                    uniqueItems: boolean;
+                                };
+                                connecting_ipv4_cidrs: {
+                                    type: string;
+                                    items: {
+                                        type: string;
+                                    };
+                                    uniqueItems: boolean;
+                                };
+                                connecting_ipv6_cidrs: {
+                                    type: string;
+                                    items: {
+                                        type: string;
+                                    };
+                                    uniqueItems: boolean;
+                                };
                             };
                             additionalProperties: boolean;
                         };

package/lib/tools/auth0/handlers/networkACLs.js

@@ -133,6 +133,27 @@ const MatchSchema = {
             minItems: 1,
             maxItems: 10,
         },
+        hostnames: {
+            type: 'array',
+            items: {
+                type: 'string',
+            },
+            uniqueItems: true,
+        },
+        connecting_ipv4_cidrs: {
+            type: 'array',
+            items: {
+                type: 'string',
+            },
+            uniqueItems: true,
+        },
+        connecting_ipv6_cidrs: {
+            type: 'array',
+            items: {
+                type: 'string',
+            },
+            uniqueItems: true,
+        },
     },
     additionalProperties: false,
 };

package/lib/types.d.ts

@@ -76,6 +76,9 @@ export type Config = {
     AUTH0_DRY_RUN?: boolean | 'preview';
     AUTH0_DRY_RUN_INTERACTIVE?: boolean;
     AUTH0_DRY_RUN_APPLY?: boolean;
+    AUTH0_IGNORE_DRY_RUN_FIELDS?: {
+        [handlerType: string]: string[];
+    };
     EXCLUDED_PROPS?: {
         [key: string]: string[];
     };

package/package.json

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