update docs

docs/embedding/form-builder-angular.md

@@ -132,7 +132,27 @@ const token = jwt.sign({
   "fieldTypes": {
     "type": "array",
     "required": false,
-    "description": "Field type names to be used in the form builder. All field types are used by default."
+    "description": "Field type names to be used in the form builder. All field types are used by default.",
+    "enum": [
+      "heading",
+      "text",
+      "signature",
+      "initials",
+      "date",
+      "datenow",
+      "number",
+      "image",
+      "checkbox",
+      "multiple",
+      "file",
+      "radio",
+      "select",
+      "cells",
+      "stamp",
+      "payment",
+      "phone",
+      "verification"
+    ]
   },
   "drawFieldType": {
     "type": "string",

docs/embedding/form-builder-javascript.md

@@ -317,7 +317,27 @@
     "type": "string",
     "required": false,
     "description": "Comma separated field type names to be used in the form builder. All field types are used by default.",
-    "example": "text,date"
+    "example": "text,date",
+    "enum": [
+      "heading",
+      "text",
+      "signature",
+      "initials",
+      "date",
+      "datenow",
+      "number",
+      "image",
+      "checkbox",
+      "multiple",
+      "file",
+      "radio",
+      "select",
+      "cells",
+      "stamp",
+      "payment",
+      "phone",
+      "verification"
+    ]
   },
   "data-draw-field-type": {
     "type": "string",

docs/embedding/form-builder-react.md

@@ -123,7 +123,27 @@ const token = jwt.sign({
   "fieldTypes": {
     "type": "array",
     "required": false,
-    "description": "Field type names to be used in the form builder. All field types are used by default."
+    "description": "Field type names to be used in the form builder. All field types are used by default.",
+    "enum": [
+      "heading",
+      "text",
+      "signature",
+      "initials",
+      "date",
+      "datenow",
+      "number",
+      "image",
+      "checkbox",
+      "multiple",
+      "file",
+      "radio",
+      "select",
+      "cells",
+      "stamp",
+      "payment",
+      "phone",
+      "verification"
+    ]
   },
   "drawFieldType": {
     "type": "string",

docs/embedding/form-builder-vue.md

@@ -144,7 +144,27 @@ const token = jwt.sign({
   "field-types": {
     "type": "array",
     "required": false,
-    "description": "Field type names to be used in the form builder. All field types are used by default."
+    "description": "Field type names to be used in the form builder. All field types are used by default.",
+    "enum": [
+      "heading",
+      "text",
+      "signature",
+      "initials",
+      "date",
+      "datenow",
+      "number",
+      "image",
+      "checkbox",
+      "multiple",
+      "file",
+      "radio",
+      "select",
+      "cells",
+      "stamp",
+      "payment",
+      "phone",
+      "verification"
+    ]
   },
   "draw-field-type": {
     "type": "string",

docs/embedding/signing-form-angular.md

@@ -48,6 +48,41 @@ export class AppComponent {}
     "description": "The role name or title of the signer.",
     "example": "First Party"
   },
+  "token": {
+    "type": "string",
+    "doc_type": "object",
+    "description": "JSON Web Token (JWT HS256) with a payload signed using the API key. <b>JWT can be generated only on the backend.</b>.",
+    "required": false,
+    "properties": {
+      "slug": {
+        "type": "string",
+        "required": true,
+        "description": "Template or Submitter slug. When Submitter slug is used no need to pass additional email param."
+      },
+      "email": {
+        "type": "string",
+        "required": false,
+        "description": "Email address of the signer. Additional email form step will be displayed if the email attribute is not specified with Template slug."
+      },
+      "external_id": {
+        "type": "string",
+        "required": false,
+        "description": "Your application-specific unique string key to identify signer within your app."
+      },
+      "preview": {
+        "type": "boolean",
+        "required": false,
+        "default": false,
+        "description": "Show form in preview mode without ability to submit it."
+      }
+    }
+  },
+  "preview": {
+    "type": "boolean",
+    "required": false,
+    "default": false,
+    "description": "Show form in preview mode without ability to submit it. Completed documents embedded in preview mode require `data-token` authentication."
+  },
   "expand": {
     "type": "boolean",
     "required": false,
@@ -66,11 +101,6 @@ export class AppComponent {}
     "default": false,
     "description": "Order form fields based on their position on the pages."
   },
-  "externalId": {
-    "type": "string",
-    "required": false,
-    "description": "Your application-specific unique string key to identify signer within your app."
-  },
   "logo": {
     "type": "string",
     "required": false,
@@ -87,12 +117,6 @@ export class AppComponent {}
     "default": "{}",
     "description": "Object that contains i18n keys to replace the default UI text with custom values. See <a href=\"https://github.com/docusealco/docuseal/blob/master/app/javascript/submission_form/i18n.js\" class=\"link\" target=\"_blank\" rel=\"nofollow\">submission_form/i18n.js</a> for available i18n keys."
   },
-  "preview": {
-    "type": "boolean",
-    "required": false,
-    "default": false,
-    "description": "Show form in preview mode without ability to submit it."
-  },
   "goToLast": {
     "type": "boolean",
     "required": false,
@@ -242,6 +266,11 @@ export class AppComponent {}
     "description": "Pre-assigned values for form fields.",
     "example": "{ 'First Name': 'Jon', 'Last Name': 'Doe' }"
   },
+  "externalId": {
+    "type": "string",
+    "required": false,
+    "description": "Your application-specific unique string key to identify signer within your app."
+  },
   "metadata": {
     "type": "object",
     "required": false,

docs/embedding/signing-form-javascript.md

@@ -42,6 +42,41 @@
     "description": "The role name or title of the signer.",
     "example": "First Party"
   },
+  "data-token": {
+    "type": "string",
+    "doc_type": "object",
+    "description": "JSON Web Token (JWT HS256) with a payload signed using the API key. <b>JWT can be generated only on the backend.</b>.",
+    "required": false,
+    "properties": {
+      "slug": {
+        "type": "string",
+        "required": true,
+        "description": "Template or Submitter slug. When Submitter slug is used no need to pass additional email param."
+      },
+      "email": {
+        "type": "string",
+        "required": false,
+        "description": "Email address of the signer. Additional email form step will be displayed if the email attribute is not specified with Template slug."
+      },
+      "external_id": {
+        "type": "string",
+        "required": false,
+        "description": "Your application-specific unique string key to identify signer within your app."
+      },
+      "preview": {
+        "type": "boolean",
+        "required": false,
+        "default": false,
+        "description": "Show form in preview mode without ability to submit it."
+      }
+    }
+  },
+  "data-preview": {
+    "type": "boolean",
+    "required": false,
+    "default": false,
+    "description": "Show form in preview mode without ability to submit it. Completed documents embedded in preview mode require `data-token` authentication."
+  },
   "data-expand": {
     "type": "boolean",
     "required": false,
@@ -60,12 +95,6 @@
     "default": false,
     "description": "Order form fields based on their position on the pages."
   },
-  "data-preview": {
-    "type": "boolean",
-    "required": false,
-    "default": false,
-    "description": "Show form in preview mode without ability to submit it."
-  },
   "data-logo": {
     "type": "string",
     "required": false,

docs/embedding/signing-form-react.md

@@ -45,6 +45,41 @@ export function App() {
     "description": "The role name or title of the signer.",
     "example": "First Party"
   },
+  "token": {
+    "type": "string",
+    "doc_type": "object",
+    "description": "JSON Web Token (JWT HS256) with a payload signed using the API key. <b>JWT can be generated only on the backend.</b>.",
+    "required": false,
+    "properties": {
+      "slug": {
+        "type": "string",
+        "required": true,
+        "description": "Template or Submitter slug. When Submitter slug is used no need to pass additional email param."
+      },
+      "email": {
+        "type": "string",
+        "required": false,
+        "description": "Email address of the signer. Additional email form step will be displayed if the email attribute is not specified with Template slug."
+      },
+      "external_id": {
+        "type": "string",
+        "required": false,
+        "description": "Your application-specific unique string key to identify signer within your app."
+      },
+      "preview": {
+        "type": "boolean",
+        "required": false,
+        "default": false,
+        "description": "Show form in preview mode without ability to submit it."
+      }
+    }
+  },
+  "preview": {
+    "type": "boolean",
+    "required": false,
+    "default": false,
+    "description": "Show form in preview mode without ability to submit it. Completed documents embedded in preview mode require `token` authentication."
+  },
   "expand": {
     "type": "boolean",
     "required": false,
@@ -63,11 +98,6 @@ export function App() {
     "default": false,
     "description": "Order form fields based on their position on the pages."
   },
-  "externalId": {
-    "type": "string",
-    "required": false,
-    "description": "Your application-specific unique string key to identify signer within your app."
-  },
   "logo": {
     "type": "string",
     "required": false,
@@ -84,12 +114,6 @@ export function App() {
     "default": "{}",
     "description": "Object that contains i18n keys to replace the default UI text with custom values. See <a href=\"https://github.com/docusealco/docuseal/blob/master/app/javascript/submission_form/i18n.js\" class=\"link\" target=\"_blank\" rel=\"nofollow\">submission_form/i18n.js</a> for available i18n keys."
   },
-  "preview": {
-    "type": "boolean",
-    "required": false,
-    "default": false,
-    "description": "Show form in preview mode without ability to submit it."
-  },
   "goToLast": {
     "type": "boolean",
     "required": false,
@@ -239,6 +263,11 @@ export function App() {
     "description": "Pre-assigned values for form fields.",
     "example": "{ 'First Name': 'Jon', 'Last Name': 'Doe' }"
   },
+  "externalId": {
+    "type": "string",
+    "required": false,
+    "description": "Your application-specific unique string key to identify signer within your app."
+  },
   "metadata": {
     "type": "object",
     "required": false,

docs/embedding/signing-form-vue.md

@@ -54,10 +54,40 @@ export default {
     "description": "The role name or title of the signer.",
     "example": "First Party"
   },
-  "external-id": {
+  "token": {
     "type": "string",
+    "doc_type": "object",
+    "description": "JSON Web Token (JWT HS256) with a payload signed using the API key. <b>JWT can be generated only on the backend.</b>.",
     "required": false,
-    "description": "Your application-specific unique string key to identify signer within your app."
+    "properties": {
+      "slug": {
+        "type": "string",
+        "required": true,
+        "description": "Template or Submitter slug. When Submitter slug is used no need to pass additional email param."
+      },
+      "email": {
+        "type": "string",
+        "required": false,
+        "description": "Email address of the signer. Additional email form step will be displayed if the email attribute is not specified with Template slug."
+      },
+      "external_id": {
+        "type": "string",
+        "required": false,
+        "description": "Your application-specific unique string key to identify signer within your app."
+      },
+      "preview": {
+        "type": "boolean",
+        "required": false,
+        "default": false,
+        "description": "Show form in preview mode without ability to submit it."
+      }
+    }
+  },
+  "preview": {
+    "type": "boolean",
+    "required": false,
+    "default": false,
+    "description": "Show form in preview mode without ability to submit it. Completed documents embedded in preview mode require `data-token` authentication."
   },
   "expand": {
     "type": "boolean",
@@ -93,12 +123,6 @@ export default {
     "default": "{}",
     "description": "Object that contains i18n keys to replace the default UI text with custom values. See <a href=\"https://github.com/docusealco/docuseal/blob/master/app/javascript/submission_form/i18n.js\" class=\"link\" target=\"_blank\" rel=\"nofollow\">submission_form/i18n.js</a> for available i18n keys."
   },
-  "preview": {
-    "type": "boolean",
-    "required": false,
-    "default": false,
-    "description": "Show form in preview mode without ability to submit it."
-  },
   "go-to-last": {
     "type": "boolean",
     "required": false,
@@ -249,6 +273,11 @@ export default {
     "description": "Pre-assigned values for form fields.",
     "example": "{ 'First Name': 'Jon', 'Last Name': 'Doe' }"
   },
+  "external-id": {
+    "type": "string",
+    "required": false,
+    "description": "Your application-specific unique string key to identify signer within your app."
+  },
   "metadata": {
     "type": "object",
     "required": false,