Add readme & examples, update unit tests and parse the rendering_mode…

… while updating to advanced
auth0 · Dec 16, 2024 · 2c0bc3f · 2c0bc3f
1 parent d9b23b6
commit 2c0bc3f
Show file tree

Hide file tree

Showing 10 changed files with 366 additions and 4 deletions.
diff --git a/docs/resource-specific-documentation.md b/docs/resource-specific-documentation.md
@@ -11,6 +11,7 @@ The Deploy CLI's own client grant is intentionally not exported nor configurable
 ## Prompts
 
 Multilingual custom text prompts follow a particular hierarchy. Under the root-level `prompts` resource property is a proprietary `customText` property that is used to bundle custom text translations with other prompts settings. Underneath `customText` is the two-character language code. Thirdly is the prompt ID, followed by the screen ID, followed by text ID.
+RenderSettings of a prompt-screen follow a particular hierarchy. Under the root-level `prompts` we store `screenRenderers` property that is used to configure the rendering settings of a given prompt & screen. Thirdly is the prompt Name, followed by the screen Name mapped to the respective renderer configs file. Refer (docs)[]
 
 **Hierarchy**
 
@@ -21,11 +22,29 @@ prompts:
       <PROMPT_ID>: # prompt ID
         <SCREEN_ID>: # prompt screen ID
           <TEXT_ID>: 'Some text'
+    screenRenderers:
+      - <PROMPT-NAME>:
+          <SCREEN-NAME>: ./prompts/screenRenderSettings/promptName_screenName.json #Add the renderer configs for a given prompt & a given screen
 ```
 
-**Example**
+**YAML Example**
+
+```
+Folder structure when in YAML mode.
+
+./prompts/
+    /screenRenderSettings
+        /signup-id_signup-id.json
+        /login-id_login-id.json
+        /login-passwordless_login-passwordless-email-code.json
+        /login-passwordless_login-passwordless-sms-otp.json
+        /login-password_login-password.json
+        /signup-password_signup-password.json
+./tenant.yaml
+```
 
 ```yaml
+# Contents of ./tenant.yaml
 prompts:
   identifier_first: true
   universal_login_experience: classic
@@ -43,7 +62,60 @@ prompts:
         mfa-login-options:
           pageTitle: 'Log in to ${clientName}'
           authenticatorNamesSMS: 'SMS'
+  screenRenderers:
+    - signup-id:
+        signup-id: ./prompts/screenRenderSettings/signup-id_signup-id.json
+    - login-passwordless:
+        login-passwordless-email-code: ./prompts/screenRenderSettings/login-passwordless_login-passwordless-email-code.json
+        login-passwordless-sms-otp: ./prompts/screenRenderSettings/login-passwordless_login-passwordless-sms-otp.json
+```
+
+**Directory Example**
+
 ```
+Folder structure when in directory mode.
+
+./prompts/
+    /screenRenderSettings
+        /signup-id_signup-id.json
+        /login-id_login-id.json
+        /login-passwordless_login-passwordless-email-code.json
+        /login-passwordless_login-passwordless-sms-otp.json
+        /login-password_login-password.json
+        /signup-password_signup-password.json
+    /custom-text.json
+    /prompts.json
+```
+
+Contents of `promptName_screenName.json`
+
+```json
+{
+  "prompt": "signup-id",
+  "screen": "signup-id",
+  "rendering_mode": "advanced",
+  "context_configuration": [
+    "branding.settings",
+    "branding.themes.default"
+  ],
+  "default_head_tags_disabled": false,
+  "head_tags": [
+    {
+      "tag": "script",
+      "attributes": {
+        "src": "URL_TO_YOUR_ASSET",
+        "async": true,
+        "defer": true,
+        "integrity": [
+          "ASSET_SHA"
+        ]
+      }
+    }
+  ]
+}
+```
+
+
 
 ## Databases
 

diff --git a/examples/directory/prompts/custom-text.json b/examples/directory/prompts/custom-text.json
@@ -0,0 +1,9 @@
+{
+  "en": {
+    "login-id": {
+      "login-id": {
+        "invalid-email-format": "Email is not valid."
+      }
+    }
+  }
+}
diff --git a/examples/directory/prompts/prompts.json b/examples/directory/prompts/prompts.json
@@ -0,0 +1,6 @@
+{
+  "universal_login_experience": "new",
+  "identifier_first": false,
+  "webauthn_platform_first_factor": true,
+  "enable_ulp_wcag_compliance": false
+}
diff --git a/examples/directory/prompts/screenRenderSettings/login-id_login-id.json b/examples/directory/prompts/screenRenderSettings/login-id_login-id.json
@@ -0,0 +1,33 @@
+{
+  "prompt": "login-id",
+  "screen": "login-id",
+  "rendering_mode": "advanced",
+  "context_configuration": [
+    "branding.settings",
+    "branding.themes.default"
+  ],
+  "default_head_tags_disabled": true,
+  "head_tags": [
+    {
+      "tag": "script",
+      "attributes": {
+        "src": "http://127.0.0.1:8090/index.js",
+        "defer": true
+      }
+    },
+    {
+      "tag": "link",
+      "attributes": {
+        "rel": "stylesheet",
+        "href": "http://127.0.0.1:8090/index.css"
+      }
+    },
+    {
+      "tag": "meta",
+      "attributes": {
+        "name": "viewport",
+        "content": "width=device-width, initial-scale=1"
+      }
+    }
+  ]
+}
diff --git a/examples/directory/prompts/screenRenderSettings/signup-id_signup-id.json b/examples/directory/prompts/screenRenderSettings/signup-id_signup-id.json
@@ -0,0 +1,20 @@
+{
+  "prompt": "signup-id",
+  "screen": "signup-id",
+  "rendering_mode": "advanced",
+  "context_configuration": [],
+  "default_head_tags_disabled": false,
+  "head_tags": [
+    {
+      "tag": "script",
+      "attributes": {
+        "src": "URL_TO_YOUR_ASSET",
+        "async": true,
+        "defer": true,
+        "integrity": [
+          "ASSET_SHA"
+        ]
+      }
+    }
+  ]
+}
diff --git a/examples/yaml/prompts/screenRenderSettings/login-id_login-id.json b/examples/yaml/prompts/screenRenderSettings/login-id_login-id.json
@@ -0,0 +1,33 @@
+{
+  "prompt": "login-id",
+  "screen": "login-id",
+  "rendering_mode": "advanced",
+  "context_configuration": [
+    "branding.settings",
+    "branding.themes.default"
+  ],
+  "default_head_tags_disabled": true,
+  "head_tags": [
+    {
+      "tag": "script",
+      "attributes": {
+        "src": "http://127.0.0.1:8090/index.js",
+        "defer": true
+      }
+    },
+    {
+      "tag": "link",
+      "attributes": {
+        "rel": "stylesheet",
+        "href": "http://127.0.0.1:8090/index.css"
+      }
+    },
+    {
+      "tag": "meta",
+      "attributes": {
+        "name": "viewport",
+        "content": "width=device-width, initial-scale=1"
+      }
+    }
+  ]
+}
diff --git a/examples/yaml/prompts/screenRenderSettings/signup-id_signup-id.json b/examples/yaml/prompts/screenRenderSettings/signup-id_signup-id.json
@@ -0,0 +1,20 @@
+{
+  "prompt": "signup-id",
+  "screen": "signup-id",
+  "rendering_mode": "advanced",
+  "context_configuration": [],
+  "default_head_tags_disabled": false,
+  "head_tags": [
+    {
+      "tag": "script",
+      "attributes": {
+        "src": "URL_TO_YOUR_ASSET",
+        "async": true,
+        "defer": true,
+        "integrity": [
+          "ASSET_SHA"
+        ]
+      }
+    }
+  ]
+}
diff --git a/src/tools/auth0/handlers/prompts.ts b/src/tools/auth0/handlers/prompts.ts
@@ -608,6 +608,7 @@ export default class PromptsHandler extends DefaultHandler {
     } else {
       updatePayload = {
         ...updatePrams,
+        rendering_mode
       };
     }