chore: upgrading node-auth0 from v4 to v5

.circleci/config.yml

@@ -6,7 +6,7 @@ orbs:
 jobs:
   e2e_test_as_node_module:
     docker:
-      - image: cimg/node:22.4.1
+      - image: cimg/node:22.12.0
     working_directory: ~/repo
     steps:
       - checkout
@@ -15,7 +15,7 @@ jobs:
 
   e2e_test_as_cli:
     docker:
-      - image: cimg/node:22.4.1
+      - image: cimg/node:22.12.0
     working_directory: ~/repo
     steps:
       - checkout
@@ -66,15 +66,42 @@ jobs:
           name: Publish package
           command: npm publish
 
+  deploy_beta:
+    parameters:
+      v:
+        type: string
+        default: "lts"
+    docker:
+      - image: cimg/node:<< parameters.v >>
+    working_directory: ~/repo
+    steps:
+      - attach_workspace:
+          at: ~/repo
+      - run:
+          name: Authenticate with registry
+          command: echo "//registry.npmjs.org/:_authToken=$NPM_TOKEN" > ~/repo/.npmrc
+      - run:
+          name: Publish beta package
+          command: npm publish --tag beta
+
   does_typescript_compile:
     docker:
-      - image: cimg/node:22.4.1
+      - image: cimg/node:22.12.0
     working_directory: ~/repo
     steps:
       - checkout
       - run: npm ci
       - run: npx tsc --noEmit
 
+  does_lint_pass:
+    docker:
+      - image: cimg/node:22.12.0
+    working_directory: ~/repo
+    steps:
+      - checkout
+      - run: npm ci
+      - run: npm run lint
+
 workflows:
   version: 2
 
@@ -92,12 +119,14 @@ workflows:
     jobs:
       - does_typescript_compile:
           name: Does Typescript compile?
+      - does_lint_pass:
+          name: Does lint pass?
       - unit_test:
           name: Unit tests with Node LTS
           v: "lts"
       - unit_test:
           name: Unit tests with Node current
-          v: "22.4.1"
+          v: "22.12.0"
 
   test_and_deploy:
     jobs:
@@ -118,6 +147,29 @@ workflows:
             branches:
               ignore: /.*/
             tags:
-              only: /^v.*/
+              only: /^v[0-9]+\.[0-9]+\.[0-9]+$/
+          context:
+            - publish-npm
+
+  test_and_deploy_beta:
+    jobs:
+      - unit_test:
+          name: Unit tests with Node LTS (Beta)
+          v: "lts"
+          filters:
+            branches:
+              only: beta
+            tags:
+              only: /^v[0-9]+\.[0-9]+\.[0-9]+-beta\.[0-9]+$/
+      - deploy_beta:
+          name: Publish Beta to NPM
+          v: "lts"
+          requires:
+            - Unit tests with Node LTS (Beta)
+          filters:
+            branches:
+              ignore: /.*/
+            tags:
+              only: /^v[0-9]+\.[0-9]+\.[0-9]+-beta\.[0-9]+$/
           context:
             - publish-npm

.gitignore

@@ -16,3 +16,4 @@ Makefile
 .github/copilot-instructions.md
 .github/chatmodes/*
 .github/prompts/*
+.github/agents/*

CHANGELOG.md

@@ -7,28 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [8.22.0] - 2025-12-10
+## [8.20.4-beta.0] - 2025-12-02
 
-### Added
-
-- Add `AUTH0_EXCLUDE_THIRD_PARTY_CLIENTS` config property to exclude third-party `clients`. [#1212]
-
-### Fixed
-
-- Fix managing `Auth0 My Account API` in `resourceServers`. [#1229]
-- Fix `cross_origin_auth` is deprecated and migrated to `cross_origin_authentication` in `clients`. [#1223]
-
-## [8.21.0] - 2025-11-21
-
-### Added
-
-- Add support for Connection Profiles and Express Configuration on Clients. [#1204]
-- Add support for ACUL GA. [#1209]
-- Add support for `session_transfer` schema in `clients`. [#1211]
-
-### Fixed
+### Changed
 
-- Fix handle responses when paginating custom domains. [#1214]
+- Upgrading node-auth0 from v4 to v5 [beta]. [#1207]
 
 ## [8.20.3] - 2025-11-14
 
@@ -1534,16 +1517,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [#1196]: https://github.com/auth0/auth0-deploy-cli/issues/1196
 [#1200]: https://github.com/auth0/auth0-deploy-cli/issues/1200
 [#1203]: https://github.com/auth0/auth0-deploy-cli/issues/1203
-[#1204]: https://github.com/auth0/auth0-deploy-cli/issues/1204
-[#1209]: https://github.com/auth0/auth0-deploy-cli/issues/1209
-[#1211]: https://github.com/auth0/auth0-deploy-cli/issues/1211
-[#1212]: https://github.com/auth0/auth0-deploy-cli/issues/1212
-[#1214]: https://github.com/auth0/auth0-deploy-cli/issues/1214
-[#1223]: https://github.com/auth0/auth0-deploy-cli/issues/1223
-[#1229]: https://github.com/auth0/auth0-deploy-cli/issues/1229
-[Unreleased]: https://github.com/auth0/auth0-deploy-cli/compare/v8.22.0...HEAD
-[8.22.0]: https://github.com/auth0/auth0-deploy-cli/compare/v8.21.0...v8.22.0
-[8.21.0]: https://github.com/auth0/auth0-deploy-cli/compare/v8.20.3...v8.21.0
+[#1207]: https://github.com/auth0/auth0-deploy-cli/issues/1207
+[Unreleased]: https://github.com/auth0/auth0-deploy-cli/compare/v8.20.4-beta.0...HEAD
+[8.20.4-beta.0]: https://github.com/auth0/auth0-deploy-cli/compare/v8.20.3...v8.20.4-beta.0
 [8.20.3]: https://github.com/auth0/auth0-deploy-cli/compare/v8.20.2...v8.20.3
 [8.20.2]: https://github.com/auth0/auth0-deploy-cli/compare/v8.20.1...v8.20.2
 [8.20.1]: https://github.com/auth0/auth0-deploy-cli/compare/v8.20.0...v8.20.1

README.md

@@ -48,7 +48,7 @@ This guide will help you to a working implementation of the Deploy CLI tool used
 
 ### Prerequisites
 
-- [Node](https://nodejs.dev/) version 20(v20.18.1) or greater
+- [Node](https://nodejs.dev/) version 20(v20.19.0) or greater
 - [Auth0 Tenant](https://auth0.com/)
 
 ### Install the Deploy CLI

docs/resource-specific-documentation.md

@@ -576,6 +576,59 @@ phoneProviders:
 ]
 ```
 
+## PhoneTemplates
+
+Phone templates allow you to customize the SMS and voice messages sent to users for phone-based authentication.
+Refer to the [Management API](https://auth0.com/docs/api/management/v2/branding/get-phone-templates) for more details.
+
+### YAML Example
+
+```yaml
+# Contents of ./tenant.yaml
+phoneTemplates:
+  - type: otp_verify
+    disabled: false
+    content:
+      from: '+12341234567'
+      body:
+        text: 'Your verification code is {{ code }}'
+        voice: 'Your verification code is {{ code }}'
+  - type: otp_enroll
+    disabled: false
+    content:
+      from: '+12341234567'
+      body:
+        text: 'Your enrollment code is {{ code }}'
+```
+
+### Directory Example
+
+Create individual JSON files for each template in the `phone-templates` directory:
+
+```text
+phone-templates/
+├── otp_verify.json
+├── otp_enroll.json
+├── change_password.json
+└── ...
+```
+
+Example `phone-templates/otp_verify.json`:
+
+```json
+{
+  "type": "otp_verify",
+  "disabled": false,
+  "content": {
+    "from": "+12341234567",
+    "body": {
+      "text": "Your verification code is {{ code }}",
+      "voice": "Your verification code is {{ code }}"
+    }
+  }
+}
+```
+
 ## Connection Profiles
 
 Application specific configuration for use with the OIN Express Configuration feature