@verdocs/web-sdk 2.3.23 → 2.3.24

package/dist/collection/components/templates/verdocs-template-roles/verdocs-template-roles.js

@@ -4,6 +4,7 @@ import { getRGBA } from '@verdocs/js-sdk/Utils/Colors';
 import { createRole, updateRole } from '@verdocs/js-sdk/Templates/Roles';
 import { TemplateSenderTypes } from '@verdocs/js-sdk/Templates/Types';
 import { h, Fragment, Host } from '@stencil/core';
+import { getTemplateRoleStore } from '../../../utils/TemplateRoleStore';
 import { getTemplateStore } from '../../../utils/TemplateStore';
 import { getRoleIndex } from '../../../utils/utils';
 import { SDKError } from '../../../utils/errors';
@@ -27,8 +28,8 @@ const iconCC = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill
  */
 export class VerdocsTemplateRoles {
   constructor() {
-    this.sequences = [];
-    this.store = null;
+    this.templateStore = null;
+    this.roleStore = null;
     this.endpoint = VerdocsEndpoint.getDefault();
     this.templateId = '';
     this.showingRoleDialog = null;
@@ -47,18 +48,14 @@ export class VerdocsTemplateRoles {
         console.log('[ROLES] Unable to start builder session, must be authenticated');
         return;
       }
-      await this.reloadStore();
+      this.templateStore = await getTemplateStore(this.endpoint, this.templateId, false);
+      this.roleStore = getTemplateRoleStore(this.templateId);
     }
     catch (e) {
       console.log('[FIELDS] Error with preview session', e);
       (_a = this.sdkError) === null || _a === void 0 ? void 0 : _a.emit(new SDKError(e.message, (_b = e.response) === null || _b === void 0 ? void 0 : _b.status, (_c = e.response) === null || _c === void 0 ? void 0 : _c.data));
     }
   }
-  async reloadStore() {
-    this.store = await getTemplateStore(this.endpoint, this.templateId, false);
-    this.sortTemplateRoles();
-    this.renumberTemplateRoles();
-  }
   componentDidRender() {
     interact.dynamicDrop(true);
     interact('.recipient').draggable({
@@ -68,64 +65,45 @@ export class VerdocsTemplateRoles {
           this.el.classList.add('dragging');
         }.bind(this),
         move: function handleMove(e) {
-          const oldX = +(e.target.getAttribute('posX') || 0);
-          const oldY = +(e.target.getAttribute('posY') || 0);
+          const oldX = +(e.target.getAttribute('dX') || 0);
+          const oldY = +(e.target.getAttribute('dY') || 0);
+          const sequence = +(e.target.dataset['sequence'] || 0);
           const newX = e.dx + oldX;
           const newY = e.dy + oldY;
-          e.target.setAttribute('posX', newX);
-          e.target.setAttribute('posy', newY);
-          e.target.style.transform = `translate(${newX + 100}px, ${newY - 40}px)`;
+          e.target.setAttribute('dX', newX);
+          e.target.setAttribute('dY', newY);
+          const rect = e.target.getBoundingClientRect();
+          // Note: I never did figure out exactly why this is, but if we don't offset the transform
+          // the dragged item is offset from the mouse cursor quite a bit.
+          e.target.style.transform = `translate(${newX + 80}px, ${newY - rect.height * sequence}px)`;
         }.bind(this),
         end: function handleEnd(e) {
           e.target.classList.remove('dragging');
           this.el.classList.remove('dragging');
           // console.log('end', event);
-          e.target.setAttribute('posX', 0);
-          e.target.setAttribute('posy', 0);
-          e.target.style.transform = `translate(0px, 0px)`;
+          e.target.removeAttribute('dX');
+          e.target.removeAttribute('dY');
+          e.target.style.transform = null;
         }.bind(this),
       },
     });
     interact('.dropzone').dropzone({
       overlap: 0.05,
-      ondrop: function handleDrop(event) {
-        var _a, _b, _c, _d, _e;
+      ondrop: async function handleDrop(event) {
+        var _a;
         event.target.classList.remove('active');
-        // target will be the recipient e.g. <div class="recipient" data-rolename="Buyer" />
-        // relatedTarget will be the drop zone, e.g. <div class="dropzone" data-order="2" data-sequence="1" />
-        // console.log(event.relatedTarget, ' was dropped into ', event.target);
-        // We don't use the role's own order, we rely on the fact that we sorted earlier on the order field. Many legacy
-        // records don't have order fields yet - they're all 1. That doesn't hurt the sort but it would hurt us here if it
-        // went 1..1..1 instead of 1..2..3. By using half values here it's easier to handle the drop event later. We don't
-        // need to do a fancy find/arraymove dance. We just set the dropped element to the half value, sort the result,
-        // then do a final renumber. It's not expensive to do because most flows are typically a small handful (e.g. 1-4)
-        // recipients. They never have hundreds.
         const roleName = event.relatedTarget.dataset.rolename;
         const targetSequence = +event.target.dataset.sequence;
         const targetOrder = +event.target.dataset.order;
-        const changingRole = (_c = (_b = (_a = this.store) === null || _a === void 0 ? void 0 : _a.state) === null || _b === void 0 ? void 0 : _b.roles) === null || _c === void 0 ? void 0 : _c.find(role => role.name === roleName);
+        const changingRole = this.roleStore.get(roleName);
         if (changingRole) {
           // To handle the renumbering, we update the role being moved to the new values, which will be some half-interval e.g.
-          // sequence 1.5 order 1. Then we
-          changingRole.sequence = targetSequence;
-          changingRole.order = targetOrder;
-          this.sortTemplateRoles();
-          this.renumberTemplateRoles();
-          this.forceRerender++;
-          // We have to update ALL the roles to be sure each gets new proper sequence/order numbers assigned.
-          // TODO: We could optimize this by tracking "dirty" states and only update the roles that have changed. But it's a LOT more
-          //  code to do right, and since most workflows will typically only have 2-4 recipients max, it may not be worth it.
-          Promise.all((_e = (_d = this.store) === null || _d === void 0 ? void 0 : _d.state) === null || _e === void 0 ? void 0 : _e.roles.map(role => updateRole(this.endpoint, this.templateId, role.name, {
-            sequence: role.sequence,
-            order: role.order,
-          })))
-            .then(() => {
-            var _a, _b;
-            console.log('[ROLES] Updated roles');
-            (_a = this.templateUpdated) === null || _a === void 0 ? void 0 : _a.emit({ event: 'updated-role', endpoint: this.endpoint, template: (_b = this.store) === null || _b === void 0 ? void 0 : _b.state });
-            this.reloadStore().catch(e => console.log('Unknown error', e));
-          })
-            .catch(e => console.log('[ROLES] Role updates failed', e));
+          // sequence 1.5 order 1. Then we sort/renumber the roles at each level to determine their final ordering values.
+          const newRole = { ...changingRole, sequence: targetSequence, order: targetOrder };
+          this.roleStore.set(changingRole.name, newRole);
+          await this.renumberTemplateRoles();
+          (_a = this.rolesUpdated) === null || _a === void 0 ? void 0 : _a.emit({ event: 'updated', endpoint: this.endpoint, templateId: this.templateId, roles: this.getSortedRoles() });
+          console.log('[ROLES] Updated roles', this.getSortedRoles());
         }
       }.bind(this),
       ondropactivate: e => {
@@ -150,50 +128,60 @@ export class VerdocsTemplateRoles {
     var _a;
     (_a = this.next) === null || _a === void 0 ? void 0 : _a.emit();
   }
-  sortTemplateRoles() {
-    var _a, _b;
-    (_b = (_a = this.store) === null || _a === void 0 ? void 0 : _a.state) === null || _b === void 0 ? void 0 : _b.roles.sort((a, b) => {
+  getSortedRoles() {
+    return Object.values(this.roleStore.state)
+      .filter(role => role !== undefined)
+      .sort((a, b) => {
       return a.sequence === b.sequence ? a.order - b.order : a.sequence - b.sequence;
     });
   }
-  extractSequenceNumbers() {
-    var _a, _b;
-    this.sequences = [];
-    (_b = (_a = this.store) === null || _a === void 0 ? void 0 : _a.state) === null || _b === void 0 ? void 0 : _b.roles.forEach(role => {
-      if (!this.sequences.includes(role.sequence)) {
-        this.sequences.push(role.sequence);
+  getSequenceNumbers() {
+    const sequences = [];
+    this.getSortedRoles().forEach(role => {
+      if (!sequences.includes(role.sequence)) {
+        sequences.push(role.sequence);
       }
     });
+    return sequences.sort((a, b) => a - b);
+  }
+  getRoleNames() {
+    const roles = this.getSortedRoles();
+    return roles.map(role => role.name);
+  }
+  getRolesAtSequence(sequence) {
+    // Entries can be undefined when deleted because Stencil has no remove() operator yet for stores.
+    // See https://github.com/ionic-team/stencil-store/issues/23
+    return Object.values(this.roleStore.state).filter(role => role && role.sequence === sequence);
   }
+  // When the user drags a role around, we handle placement "between" items by assigning it a half-order number
+  // e.g. 1.5 to place it between items 1 and 2, 0.5 to place it at the beginning, or last+0.5 to place it at the end.
+  // Then we re-sort the list of roles and renumber them.
   renumberTemplateRoles() {
-    // Extract the sequence numbers because they may now be something like [2.5, 1, 2]
-    this.extractSequenceNumbers();
-    // We need to renumber each role only ONE TIME
+    // Avoid dupe renumber attempts
     const renumbered = [];
     // If the user dragged an entry from below a row to above it, we end up here like [1,0]. Make sure it's [0,1] for the next operation.
-    this.sequences.sort((a, b) => a - b);
-    this.sequences.forEach((originalSequence, newSequenceIndex) => {
-      var _a, _b;
-      (_b = (_a = this.store) === null || _a === void 0 ? void 0 : _a.state) === null || _b === void 0 ? void 0 : _b.roles.filter(role => role.sequence === originalSequence).forEach((role, newOrderIndex) => {
+    const renumberRequests = [];
+    this.getSequenceNumbers().forEach((originalSequence, newSequenceIndex) => {
+      this.getRolesAtSequence(originalSequence).forEach((role, newOrderIndex) => {
         if (!renumbered.includes(role.name)) {
           role.sequence = newSequenceIndex + 1;
           role.order = newOrderIndex + 1;
           renumbered.push(role.name);
+          renumberRequests.push(updateRole(this.endpoint, this.templateId, role.name, { sequence: role.sequence, order: role.order }));
         }
       });
     });
-    // Now re-extract them to get our final result e.g. [1, 2, 3]
-    this.extractSequenceNumbers();
+    return Promise.all(renumberRequests);
   }
   // Look for name conflicts, because they're UGC and can be anything, regardless of order.
   getNextRoleName() {
-    var _a, _b, _c, _d;
+    var _a;
     let name = '';
-    let nextNumber = (_b = (_a = this.store) === null || _a === void 0 ? void 0 : _a.state) === null || _b === void 0 ? void 0 : _b.roles.length;
+    let nextNumber = Object.keys(this.roleStore).length;
     do {
       nextNumber++;
       name = `Recipient ${nextNumber}`;
-    } while (!name || ((_d = (_c = this.store) === null || _c === void 0 ? void 0 : _c.state) === null || _d === void 0 ? void 0 : _d.roles.some(role => role.name === name)));
+    } while (!name || Object.values((_a = this.roleStore) === null || _a === void 0 ? void 0 : _a.state).some(role => role && role.name === name));
     return name;
   }
   callCreateRole(name, sequence, order) {
@@ -210,25 +198,19 @@ export class VerdocsTemplateRoles {
       delegator: false,
     })
       .then(async (r) => {
-      var _a, _b;
+      var _a;
       console.log('[ROLES] Created role', r);
-      this.store = await getTemplateStore(this.endpoint, this.templateId, false);
-      this.sortTemplateRoles();
-      this.renumberTemplateRoles();
-      // this.store.state.roles = [...this.store?.state.roles, r];
-      // this.renumberTemplateRoles();
-      (_a = this.templateUpdated) === null || _a === void 0 ? void 0 : _a.emit({ event: 'created-role', endpoint: this.endpoint, template: (_b = this.store) === null || _b === void 0 ? void 0 : _b.state });
-      this.reloadStore().catch(e => console.log('Unknown error', e));
+      this.roleStore.set(r.name, r);
+      await this.renumberTemplateRoles();
+      (_a = this.rolesUpdated) === null || _a === void 0 ? void 0 : _a.emit({ event: 'added', endpoint: this.endpoint, templateId: this.templateId, roles: this.getSortedRoles() });
     })
       .catch(e => {
       console.log('[ROLES] Error creating role', e);
     });
   }
   handleAddRole(e, sequence) {
-    var _a;
     e.stopPropagation();
-    // We don't need to look for a unique order number because we're already working with a sorted/renumbered set by now.
-    const order = ((_a = this.store) === null || _a === void 0 ? void 0 : _a.state.roles.filter(role => role.sequence === sequence).length) + 1;
+    const order = this.getRolesAtSequence(sequence).length + 1;
     const name = this.getNextRoleName();
     this.callCreateRole(name, sequence, order);
   }
@@ -239,33 +221,25 @@ export class VerdocsTemplateRoles {
     this.callCreateRole(name, sequence, order);
   }
   render() {
-    var _a, _b, _c, _d, _e, _f;
-    console.log('[ROLES] Rendering');
+    var _a, _b, _c;
     if (!this.endpoint.session) {
       return (h(Host, null, h("verdocs-component-error", { message: "You must be authenticated to use this module." })));
     }
-    if (!((_a = this.store) === null || _a === void 0 ? void 0 : _a.state.isLoaded)) {
+    if (!((_a = this.templateStore) === null || _a === void 0 ? void 0 : _a.state.isLoaded)) {
       return (h(Host, { class: "loading" }, h("verdocs-loader", null)));
     }
-    const roleNames = (((_c = (_b = this.store) === null || _b === void 0 ? void 0 : _b.state) === null || _c === void 0 ? void 0 : _c.roles) || []).map(role => role.name);
-    return (h(Host, null, h("form", { onSubmit: e => e.preventDefault(), onClick: e => e.stopPropagation(), autocomplete: "off", "data-r": (_d = this.store.state) === null || _d === void 0 ? void 0 : _d.updateCount }, h("h5", null, "Roles and Workflow"), h("div", { class: "participants" }, h("div", { class: "left-line" }), h("div", { class: "row" }, h("div", { class: "icon", innerHTML: startIcon }), h("div", { class: "row-roles" }, h("div", { class: "sender" }, h("span", { class: "label" }, "Sender:"), " ", senderLabels[(_f = (_e = this.store) === null || _e === void 0 ? void 0 : _e.state) === null || _f === void 0 ? void 0 : _f.sender], ' ', h("div", { class: "settings-button", innerHTML: settingsIcon, onClick: () => (this.showingSenderDialog = true), "aria-role": "button" })))), h("div", { class: "row add-sequence", "data-sequence": 0 }, h("div", { class: "icon", innerHTML: plusIcon }), h("div", { class: "row-roles" }, h("div", { class: "dropzone", "data-sequence": 0, "data-order": 1 }, "Add Step"))), this.sequences.map(sequence => {
-      var _a, _b;
-      return (h(Fragment, null, h("div", { class: "row" }, h("div", { class: "icon", innerHTML: stepIcon }), h("div", { class: "row-roles" }, h("div", { class: "dropzone", "data-order": 0.5, "data-sequence": sequence }), (_b = (_a = this.store) === null || _a === void 0 ? void 0 : _a.state) === null || _b === void 0 ? void 0 :
-        _b.roles.filter(role => role.sequence === sequence).map(role => {
-          const unknown = !role.email;
-          return unknown ? (h(Fragment, null, h("div", { class: "recipient", style: { backgroundColor: getRGBA(getRoleIndex(roleNames, role.name)) }, "data-rolename": role.name }, h("span", { class: "type-icon", innerHTML: role.type === 'signer' ? iconSigner : role.type === 'cc' ? iconCC : iconApprover }), role.name, " ", h("div", { class: "settings-button", innerHTML: settingsIcon, onClick: () => (this.showingRoleDialog = role.name), "aria-role": "button" })), h("div", { class: "dropzone", "data-order": role.order + 0.5, "data-sequence": sequence }))) : (h(Fragment, null, h("div", { class: "recipient", style: { borderColor: getRGBA(getRoleIndex(roleNames, role.name)) }, "data-rolename": role.name }, h("span", { class: "type-icon", innerHTML: role.type === 'signer' ? iconSigner : role.type === 'cc' ? iconCC : iconApprover }), role.full_name, " ", h("div", { class: "settings-button", innerHTML: settingsIcon, onClick: () => (this.showingRoleDialog = role.name), "aria-role": "button" })), h("div", { class: "dropzone", "data-order": role.order + 0.5, "data-sequence": sequence })));
-        }), h("button", { class: "add-role", innerHTML: plusIcon, onClick: e => this.handleAddRole(e, sequence) }))), this.sequences.length > 0 && (h("div", { class: "row add-sequence", "data-sequence": sequence }, h("div", { class: "row-roles" }, h("div", { class: "icon", innerHTML: plusIcon }), h("div", { class: "dropzone", "data-sequence": sequence + 1, "data-order": 1 }, "Add Step"))))));
-    }), h("div", { class: "row", "data-sequence": this.sequences.length + 1 }, h("div", { class: "row-roles" }, h("div", { class: "icon", innerHTML: plusIcon }), h("button", { class: "add-step", innerHTML: plusIcon, onClick: e => this.handleAddStep(e, this.sequences.length + 1) }))), h("div", { class: "row" }, h("div", { class: "icon", innerHTML: doneIcon }), h("div", { class: "row-roles" }, h("div", { class: "complete" }, "Document Complete")))), roleNames.length < 1 && (h("div", { class: "empty" }, "You must add at least one Role before proceeding.", h("br", null), " Click the ", h("span", { innerHTML: plusIcon }), " Add button above to get started.")), h("div", { class: "buttons" }, h("div", { class: "flex-fill" }), h("verdocs-button", { variant: "outline", label: "Cancel", size: "small", onClick: () => this.handleCancel() }), h("verdocs-button", { label: "OK", size: "small", onClick: () => this.handleSubmit(), disabled: roleNames.length < 1 }))), this.showingRoleDialog && (h("verdocs-template-role-properties", { endpoint: this.endpoint, templateId: this.templateId, roleName: this.showingRoleDialog, onClose: () => {
+    const roleNames = this.getRoleNames();
+    const sequences = this.getSequenceNumbers();
+    return (h(Host, null, h("form", { onSubmit: e => e.preventDefault(), onClick: e => e.stopPropagation(), autocomplete: "off" }, h("h5", null, "Roles and Workflow"), h("div", { class: "participants" }, h("div", { class: "left-line" }), h("div", { class: "row" }, h("div", { class: "icon", innerHTML: startIcon }), h("div", { class: "row-roles" }, h("div", { class: "sender" }, h("span", { class: "label" }, "Sender:"), " ", senderLabels[(_c = (_b = this.templateStore) === null || _b === void 0 ? void 0 : _b.state) === null || _c === void 0 ? void 0 : _c.sender], ' ', h("div", { class: "settings-button", innerHTML: settingsIcon, onClick: () => (this.showingSenderDialog = true), "aria-role": "button" })))), h("div", { class: "row add-sequence", "data-sequence": 0 }, h("div", { class: "icon", innerHTML: plusIcon }), h("div", { class: "row-roles" }, h("div", { class: "dropzone", "data-sequence": 0, "data-order": 1 }, "Add Step"))), sequences.map(sequence => (h(Fragment, null, h("div", { class: "row" }, h("div", { class: "icon", innerHTML: stepIcon }), h("div", { class: "row-roles" }, h("div", { class: "dropzone", "data-order": 0.5, "data-sequence": sequence }), this.getRolesAtSequence(sequence).map(role => {
+      const unknown = !role.email;
+      return unknown ? (h(Fragment, null, h("div", { class: "recipient", style: { backgroundColor: getRGBA(getRoleIndex(roleNames, role.name)) }, "data-rolename": role.name, "data-sequence": sequence }, h("span", { class: "type-icon", innerHTML: role.type === 'signer' ? iconSigner : role.type === 'cc' ? iconCC : iconApprover }), role.name, " ", h("div", { class: "settings-button", innerHTML: settingsIcon, onClick: () => (this.showingRoleDialog = role.name), "aria-role": "button" })), h("div", { class: "dropzone", "data-order": role.order + 0.5, "data-sequence": sequence }))) : (h(Fragment, null, h("div", { class: "recipient", style: { borderColor: getRGBA(getRoleIndex(roleNames, role.name)) }, "data-rolename": role.name, "data-sequence": sequence }, h("span", { class: "type-icon", innerHTML: role.type === 'signer' ? iconSigner : role.type === 'cc' ? iconCC : iconApprover }), role.full_name, " ", h("div", { class: "settings-button", innerHTML: settingsIcon, onClick: () => (this.showingRoleDialog = role.name), "aria-role": "button" })), h("div", { class: "dropzone", "data-order": role.order + 0.5, "data-sequence": sequence })));
+    }), h("button", { class: "add-role", innerHTML: plusIcon, onClick: e => this.handleAddRole(e, sequence) }))), sequences.length > 0 && (h("div", { class: "row add-sequence", "data-sequence": sequence }, h("div", { class: "row-roles" }, h("div", { class: "icon", innerHTML: plusIcon }), h("div", { class: "dropzone", "data-sequence": sequence + 1, "data-order": 1 }, "Add Step"))))))), h("div", { class: "row", "data-sequence": sequences.length + 1 }, h("div", { class: "row-roles" }, h("div", { class: "icon", innerHTML: plusIcon }), h("button", { class: "add-step", innerHTML: plusIcon, onClick: e => this.handleAddStep(e, sequences.length + 1) }))), h("div", { class: "row" }, h("div", { class: "icon", innerHTML: doneIcon }), h("div", { class: "row-roles" }, h("div", { class: "complete" }, "Document Complete")))), roleNames.length < 1 && (h("div", { class: "empty" }, "You must add at least one Role before proceeding.", h("br", null), " Click the ", h("span", { innerHTML: plusIcon }), " Add button above to get started.")), h("div", { class: "buttons" }, h("div", { class: "flex-fill" }), h("verdocs-button", { variant: "outline", label: "Cancel", size: "small", onClick: () => this.handleCancel() }), h("verdocs-button", { label: "OK", size: "small", onClick: () => this.handleSubmit(), disabled: roleNames.length < 1 }))), this.showingRoleDialog && (h("verdocs-template-role-properties", { endpoint: this.endpoint, templateId: this.templateId, roleName: this.showingRoleDialog, onClose: () => {
         this.showingRoleDialog = null;
-        // this.forceRerender++;
       }, onDelete: async () => {
-        var _a, _b;
-        await getTemplateStore(this.endpoint, this.templateId, false);
-        this.renumberTemplateRoles();
+        var _a;
         this.showingRoleDialog = null;
-        // this.forceRerender++;
-        (_a = this.templateUpdated) === null || _a === void 0 ? void 0 : _a.emit({ event: 'deleted-role', endpoint: this.endpoint, template: (_b = this.store) === null || _b === void 0 ? void 0 : _b.state });
-        this.reloadStore().catch(e => console.log('Unknown error', e));
+        await this.renumberTemplateRoles();
+        (_a = this.rolesUpdated) === null || _a === void 0 ? void 0 : _a.emit({ event: 'deleted', endpoint: this.endpoint, templateId: this.templateId, roles: this.getSortedRoles() });
       } })), this.showingSenderDialog && h("verdocs-template-sender", { endpoint: this.endpoint, templateId: this.templateId, onClose: () => (this.showingSenderDialog = false) })));
   }
   static get is() { return "verdocs-template-roles"; }
@@ -381,8 +355,8 @@ export class VerdocsTemplateRoles {
           }
         }
       }, {
-        "method": "templateUpdated",
-        "name": "templateUpdated",
+        "method": "rolesUpdated",
+        "name": "rolesUpdated",
         "bubbles": true,
         "cancelable": true,
         "composed": true,
@@ -391,14 +365,14 @@ export class VerdocsTemplateRoles {
           "text": "Event fired when the template is updated in any way. May be used for tasks such as cache invalidation or reporting to other systems."
         },
         "complexType": {
-          "original": "{endpoint: VerdocsEndpoint; template: ITemplate; event: string}",
-          "resolved": "{ endpoint: VerdocsEndpoint; template: ITemplate; event: string; }",
+          "original": "{endpoint: VerdocsEndpoint; templateId: string; event: 'added' | 'deleted' | 'updated'; roles: IRole[]}",
+          "resolved": "{ endpoint: VerdocsEndpoint; templateId: string; event: \"added\" | \"deleted\" | \"updated\"; roles: IRole[]; }",
           "references": {
             "VerdocsEndpoint": {
               "location": "import",
               "path": "@verdocs/js-sdk"
             },
-            "ITemplate": {
+            "IRole": {
               "location": "import",
               "path": "@verdocs/js-sdk/Templates/Types"
             }

package/dist/collection/utils/TemplateRoleStore.js

@@ -0,0 +1,19 @@
+import { createStore } from '@stencil/store';
+const templateRoleStores = {};
+export const getTemplateRoleStore = (templateId) => templateRoleStores[templateId];
+export const createTemplateRoleStore = (template) => {
+  let store = getTemplateRoleStore(template.id);
+  if (!store) {
+    console.log('Creating template role store for template', template.id);
+    store = createStore({});
+    templateRoleStores[template.id] = store;
+  }
+  else {
+    console.log('Resetting template role store for template', template.id);
+    store.reset();
+  }
+  template.roles.forEach(role => {
+    store.set(role.name, role);
+  });
+  return store;
+};

package/dist/collection/utils/TemplateStore.js

@@ -2,6 +2,7 @@ import { createStore } from '@stencil/store';
 import { getTemplate } from '@verdocs/js-sdk/Templates/Templates';
 import { TemplateSenderTypes } from '@verdocs/js-sdk/Templates/Types';
 import { createTemplateFieldStore, getTemplateFieldStore } from './TemplateFieldStore';
+import { createTemplateRoleStore, getTemplateRoleStore } from './TemplateRoleStore';
 const createTemplateStore = (templateId) => {
   const now = new Date().toISOString();
   return createStore({
@@ -69,6 +70,7 @@ export const getTemplateStore = async (endpoint, templateId, forceReload = false
       store.state.isLoaded = true;
       store.state.isError = false;
       store.state.error = undefined;
+      createTemplateRoleStore(template);
       createTemplateFieldStore(template);
     }
     catch (e) {
@@ -82,7 +84,8 @@ export const getTemplateStore = async (endpoint, templateId, forceReload = false
     store.state.updateCount++;
   }
   else {
-    // Just make sure it exists
+    // Just make sure they exist
+    getTemplateRoleStore(templateId);
     getTemplateFieldStore(templateId);
   }
   return store;

package/dist/components/TemplateStore.js

@@ -2,6 +2,25 @@ import { c as createStore } from './index4.js';
 import { g as getTemplate, b as TemplateSenderTypes } from './VerdocsEndpoint.js';
 import { a as createTemplateFieldStore } from './TemplateFieldStore.js';
 
+const templateRoleStores = {};
+const getTemplateRoleStore = (templateId) => templateRoleStores[templateId];
+const createTemplateRoleStore = (template) => {
+  let store = getTemplateRoleStore(template.id);
+  if (!store) {
+    console.log('Creating template role store for template', template.id);
+    store = createStore({});
+    templateRoleStores[template.id] = store;
+  }
+  else {
+    console.log('Resetting template role store for template', template.id);
+    store.reset();
+  }
+  template.roles.forEach(role => {
+    store.set(role.name, role);
+  });
+  return store;
+};
+
 const createTemplateStore = (templateId) => {
   const now = new Date().toISOString();
   return createStore({
@@ -69,6 +88,7 @@ const getTemplateStore = async (endpoint, templateId, forceReload = false) => {
       store.state.isLoaded = true;
       store.state.isError = false;
       store.state.error = undefined;
+      createTemplateRoleStore(template);
       createTemplateFieldStore(template);
     }
     catch (e) {
@@ -85,4 +105,4 @@ const getTemplateStore = async (endpoint, templateId, forceReload = false) => {
 };
 const getRoleNames = (store) => { var _a; return (((_a = store === null || store === void 0 ? void 0 : store.state) === null || _a === void 0 ? void 0 : _a.roles) || []).map(role => role.name); };
 
-export { getRoleNames as a, getTemplateStore as g };
+export { getRoleNames as a, getTemplateRoleStore as b, createTemplateRoleStore as c, getTemplateStore as g };

package/dist/components/verdocs-build.js

@@ -45,6 +45,7 @@ const VerdocsBuild$1 = /*@__PURE__*/ proxyCustomElement(class extends HTMLElemen
     this.send = createEvent(this, "send", 7);
     this.templateUpdated = createEvent(this, "templateUpdated", 7);
     this.templateCreated = createEvent(this, "templateCreated", 7);
+    this.rolesUpdated = createEvent(this, "rolesUpdated", 7);
     this.endpoint = VerdocsEndpoint.getDefault();
     this.templateId = null;
     this.step = 'preview';
@@ -96,9 +97,12 @@ const VerdocsBuild$1 = /*@__PURE__*/ proxyCustomElement(class extends HTMLElemen
     this.step = 'roles';
     (_a = this.stepChanged) === null || _a === void 0 ? void 0 : _a.emit('roles');
   }
+  async handleRolesUpdated(e) {
+    var _a;
+    (_a = this.templateUpdated) === null || _a === void 0 ? void 0 : _a.emit(e.detail);
+  }
   async handleTemplateUpdated(e) {
     var _a;
-    console.log('tup');
     (_a = this.templateUpdated) === null || _a === void 0 ? void 0 : _a.emit(e.detail);
   }
   handleAttachmentsNext() {
@@ -126,7 +130,7 @@ const VerdocsBuild$1 = /*@__PURE__*/ proxyCustomElement(class extends HTMLElemen
       return (h(Host, null, h("div", { class: "content" }, h("verdocs-template-build-tabs", { endpoint: this.endpoint, templateId: this.templateId, step: "attachments", onSdkError: e => { var _a; return (_a = this.sdkError) === null || _a === void 0 ? void 0 : _a.emit(e.detail); }, onStepChanged: e => this.handleStepChanged(e.detail) }), h("verdocs-template-create", { endpoint: this.endpoint, onExit: e => this.handleCancel(e), onNext: () => this.handleAttachmentsNext(), onTemplateCreated: e => this.handleTemplateCreated(e.detail.templateId) }))));
     }
     console.log('[BUILD] Rendering build view', this.templateId, this.step, ['attachments', 'roles', 'settings', 'fields', 'preview'].indexOf(this.step));
-    return (h(Host, null, h("div", { class: "content" }, h("verdocs-template-build-tabs", { endpoint: this.endpoint, templateId: this.templateId, step: this.step, onSdkError: e => { var _a; return (_a = this.sdkError) === null || _a === void 0 ? void 0 : _a.emit(e.detail); }, onStepChanged: e => this.handleStepChanged(e.detail) }), this.step === 'attachments' && (h("verdocs-template-attachments", { templateId: this.templateId, endpoint: this.endpoint, onExit: e => this.handleCancel(e), onNext: () => this.handleAttachmentsNext(), onTemplateUpdated: e => this.handleTemplateUpdated(e) })), this.step === 'roles' && (h("verdocs-template-roles", { templateId: this.templateId, endpoint: this.endpoint, onExit: e => this.handleCancel(e), onNext: () => this.handleRolesNext(), onTemplateUpdated: e => this.handleTemplateUpdated(e) })), this.step === 'settings' && (h("div", { style: { flexDirection: 'column', gap: '20px', display: 'flex', maxWidth: '400px', margin: '20px' } }, h("verdocs-template-name", { templateId: this.templateId, endpoint: this.endpoint, style: { backgroundColor: '#ffffff', padding: '20px' }, onTemplateUpdated: e => this.handleTemplateUpdated(e) }), h("verdocs-template-reminders", { templateId: this.templateId, endpoint: this.endpoint, style: { backgroundColor: '#ffffff', padding: '20px' }, onTemplateUpdated: e => this.handleTemplateUpdated(e) }), h("verdocs-template-visibility", { templateId: this.templateId, endpoint: this.endpoint, style: { backgroundColor: '#ffffff', padding: '20px' }, onTemplateUpdated: e => this.handleTemplateUpdated(e) }))), this.step === 'fields' && h("verdocs-template-fields", { templateId: this.templateId, endpoint: this.endpoint, onTemplateUpdated: e => this.handleTemplateUpdated(e) }), this.step === 'preview' && (h("div", { class: "preview-container" }, h("div", { class: "preview-send-wrapper" }, h("verdocs-send", { templateId: this.templateId, endpoint: this.endpoint, onSend: e => { var _a; return (_a = this.send) === null || _a === void 0 ? void 0 : _a.emit(e.detail); }, style: { width: '100%' } })), h("div", { class: "preview-preview-wrapper" }, h("verdocs-preview", { templateId: this.templateId, endpoint: this.endpoint, style: { display: 'flex', flex: '1', maxWidth: '1000px' } })))))));
+    return (h(Host, null, h("div", { class: "content" }, h("verdocs-template-build-tabs", { endpoint: this.endpoint, templateId: this.templateId, step: this.step, onSdkError: e => { var _a; return (_a = this.sdkError) === null || _a === void 0 ? void 0 : _a.emit(e.detail); }, onStepChanged: e => this.handleStepChanged(e.detail) }), this.step === 'attachments' && (h("verdocs-template-attachments", { templateId: this.templateId, endpoint: this.endpoint, onExit: e => this.handleCancel(e), onNext: () => this.handleAttachmentsNext(), onTemplateUpdated: e => this.handleTemplateUpdated(e) })), this.step === 'roles' && (h("verdocs-template-roles", { templateId: this.templateId, endpoint: this.endpoint, onExit: e => this.handleCancel(e), onNext: () => this.handleRolesNext(), onRolesUpdated: e => this.handleRolesUpdated(e) })), this.step === 'settings' && (h("div", { style: { flexDirection: 'column', gap: '20px', display: 'flex', maxWidth: '400px', margin: '20px' } }, h("verdocs-template-name", { templateId: this.templateId, endpoint: this.endpoint, style: { backgroundColor: '#ffffff', padding: '20px' }, onTemplateUpdated: e => this.handleTemplateUpdated(e) }), h("verdocs-template-reminders", { templateId: this.templateId, endpoint: this.endpoint, style: { backgroundColor: '#ffffff', padding: '20px' }, onTemplateUpdated: e => this.handleTemplateUpdated(e) }), h("verdocs-template-visibility", { templateId: this.templateId, endpoint: this.endpoint, style: { backgroundColor: '#ffffff', padding: '20px' }, onTemplateUpdated: e => this.handleTemplateUpdated(e) }))), this.step === 'fields' && h("verdocs-template-fields", { templateId: this.templateId, endpoint: this.endpoint, onTemplateUpdated: e => this.handleTemplateUpdated(e) }), this.step === 'preview' && (h("div", { class: "preview-container" }, h("div", { class: "preview-send-wrapper" }, h("verdocs-send", { templateId: this.templateId, endpoint: this.endpoint, onSend: e => { var _a; return (_a = this.send) === null || _a === void 0 ? void 0 : _a.emit(e.detail); }, style: { width: '100%' } })), h("div", { class: "preview-preview-wrapper" }, h("verdocs-preview", { templateId: this.templateId, endpoint: this.endpoint, style: { display: 'flex', flex: '1', maxWidth: '1000px' } })))))));
   }
   get el() { return this; }
   static get watchers() { return {

package/dist/components/verdocs-template-fields2.js

@@ -5,8 +5,8 @@ import { V as VerdocsEndpoint } from './VerdocsEndpoint.js';
 import { u as updateField, c as createField } from './Fields.js';
 import { i as integerSequence } from './Primitives.js';
 import { b as getRoleIndex, r as renderDocumentField, f as updateCssTransform, h as defaultWidth, i as defaultHeight } from './utils.js';
-import { a as createTemplateFieldStore } from './TemplateFieldStore.js';
-import { g as getTemplateStore, a as getRoleNames } from './TemplateStore.js';
+import { g as getTemplateStore, b as getTemplateRoleStore, a as getRoleNames } from './TemplateStore.js';
+import { g as getTemplateFieldStore } from './TemplateFieldStore.js';
 import { S as SDKError } from './errors.js';
 import { d as defineCustomElement$7 } from './verdocs-button2.js';
 import { d as defineCustomElement$6 } from './verdocs-component-error2.js';
@@ -53,6 +53,7 @@ const VerdocsTemplateFields = /*@__PURE__*/ proxyCustomElement(class extends HTM
     this.pageHeights = {};
     this.templateStore = null;
     this.fieldStore = null;
+    this.roleStore = null;
     this.cachedPageInfo = {};
     this.endpoint = VerdocsEndpoint.getDefault();
     this.templateId = null;
@@ -74,7 +75,8 @@ const VerdocsTemplateFields = /*@__PURE__*/ proxyCustomElement(class extends HTM
         return;
       }
       this.templateStore = await getTemplateStore(this.endpoint, this.templateId, false);
-      this.fieldStore = createTemplateFieldStore(this.templateStore.state);
+      this.fieldStore = getTemplateFieldStore(this.templateId);
+      this.roleStore = getTemplateRoleStore(this.templateId);
       this.selectedRoleName = ((_d = (_c = (_b = (_a = this.templateStore) === null || _a === void 0 ? void 0 : _a.state) === null || _b === void 0 ? void 0 : _b.roles) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.name) || '';
     }
     catch (e) {
@@ -93,10 +95,10 @@ const VerdocsTemplateFields = /*@__PURE__*/ proxyCustomElement(class extends HTM
     }
   }
   componentWillUpdate() {
-    var _a, _b, _c, _d, _e, _f;
+    var _a, _b, _c, _d;
     // If a new role was added and there were none yet so far, or the "selected" role was deleted, reset our selection
-    if (!this.selectedRoleName || !(((_b = (_a = this.templateStore) === null || _a === void 0 ? void 0 : _a.state) === null || _b === void 0 ? void 0 : _b.roles) || []).find(role => role.name === this.selectedRoleName)) {
-      this.selectedRoleName = ((_f = (_e = (_d = (_c = this.templateStore) === null || _c === void 0 ? void 0 : _c.state) === null || _d === void 0 ? void 0 : _d.roles) === null || _e === void 0 ? void 0 : _e[0]) === null || _f === void 0 ? void 0 : _f.name) || '';
+    if (!this.selectedRoleName || !Object.values(this.roleStore).find(role => role && role.name === this.selectedRoleName)) {
+      this.selectedRoleName = ((_d = (_c = (_b = (_a = this.templateStore) === null || _a === void 0 ? void 0 : _a.state) === null || _b === void 0 ? void 0 : _b.roles) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.name) || '';
       console.log('[FIELDS] Selected new role', this.selectedRoleName);
     }
   }
@@ -155,7 +157,9 @@ const VerdocsTemplateFields = /*@__PURE__*/ proxyCustomElement(class extends HTM
     // console.log('[FIELDS] Page rendered', pageInfo.pageNumber, pageInfo);
     this.cachedPageInfo[pageInfo.pageNumber] = pageInfo;
     this.pageHeights[pageInfo.pageNumber] = pageInfo.naturalHeight;
-    const fields = Object.values(this.fieldStore.state).filter((field) => field.page_sequence === pageInfo.pageNumber);
+    // Entries can be undefined when deleted because Stencil has no remove() operator yet for stores.
+    // See https://github.com/ionic-team/stencil-store/issues/23
+    const fields = Object.values(this.fieldStore.state).filter((field) => field && field.page_sequence === pageInfo.pageNumber);
     console.log('[FIELDS] Page rendered', pageInfo, fields);
     fields.forEach((field) => this.reRenderField(field, pageInfo.pageNumber));
   }
@@ -253,7 +257,7 @@ const VerdocsTemplateFields = /*@__PURE__*/ proxyCustomElement(class extends HTM
     do {
       fieldName = `${type}P${pageNumber}-${i}`;
       i++;
-    } while (Object.values(this.fieldStore.state).some(field => field.name === fieldName));
+    } while (Object.values(this.fieldStore.state).some(field => field && field.name === fieldName));
     return fieldName;
   }
   // Scale the X,Y clicks to the virtual page dimensions. Also ensure the field doesn't go off the page.
@@ -365,7 +369,7 @@ const VerdocsTemplateFields = /*@__PURE__*/ proxyCustomElement(class extends HTM
     }
   }
   render() {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var _a, _b, _c;
     if (!this.endpoint.session) {
       return (h(Host, null, h("verdocs-component-error", { message: "You must be authenticated to use this module." })));
     }
@@ -373,7 +377,9 @@ const VerdocsTemplateFields = /*@__PURE__*/ proxyCustomElement(class extends HTM
     if (!((_a = this.templateStore) === null || _a === void 0 ? void 0 : _a.state.isLoaded)) {
       return (h(Host, null, h("verdocs-loader", null)));
     }
-    const selectableRoles = (_c = (_b = this.templateStore) === null || _b === void 0 ? void 0 : _b.state) === null || _c === void 0 ? void 0 : _c.roles.map(role => ({ value: role.name, label: role.name }));
+    const selectableRoles = Object.values(this.roleStore)
+      .filter(role => role !== undefined)
+      .map(role => ({ value: role.name, label: role.name }));
     return (h(Host, { class: this.placing ? { [`placing-${this.placing}`]: true } : {}, onSubmit: () => { } }, h("div", { id: "verdocs-template-fields-toolbar" }, h("div", { class: "add-for" }, "Add field:"), h("verdocs-select-input", { value: this.selectedRoleName, options: selectableRoles, onInput: (e) => (this.selectedRoleName = e.target.value) }), menuOptions.map(option => (h("verdocs-toolbar-icon", { text: option.tooltip, icon: option.icon, onClick: () => {
         // We ignore empty-tooltip entries because they're separators
         if (option.tooltip) {
@@ -385,13 +391,13 @@ const VerdocsTemplateFields = /*@__PURE__*/ proxyCustomElement(class extends HTM
             this.showMustSelectRole = true;
           }
         }
-      } })))), h("div", { class: "pages" }, (((_e = (_d = this.templateStore) === null || _d === void 0 ? void 0 : _d.state) === null || _e === void 0 ? void 0 : _e.template_documents) || []).map(document => {
+      } })))), h("div", { class: "pages" }, (((_c = (_b = this.templateStore) === null || _b === void 0 ? void 0 : _b.state) === null || _c === void 0 ? void 0 : _c.template_documents) || []).map(document => {
       const pageNumbers = integerSequence(1, document.page_numbers);
       return pageNumbers.map(page => (h("verdocs-template-document-page", { templateId: this.templateId, documentId: document.id, pageNumber: page, virtualWidth: 612, virtualHeight: 792, onClick: (e) => this.handleClickPage(e, page), onPageRendered: e => this.handlePageRendered(e), layers: [
           { name: 'page', type: 'canvas' },
           { name: 'controls', type: 'div' },
         ] })));
-    })), this.showMustSelectRole && (h("verdocs-ok-dialog", { heading: "Unable to add field", message: ((_h = (_g = (_f = this.templateStore) === null || _f === void 0 ? void 0 : _f.state) === null || _g === void 0 ? void 0 : _g.roles) === null || _h === void 0 ? void 0 : _h.length) > 0 ? 'Please select a role before adding fields.' : 'Please add at least one role before adding fields.', onNext: () => (this.showMustSelectRole = false) }))));
+    })), this.showMustSelectRole && (h("verdocs-ok-dialog", { heading: "Unable to add field", message: Object.keys(this.roleStore).length > 0 ? 'Please select a role before adding fields.' : 'Please add at least one role before adding fields.', onNext: () => (this.showMustSelectRole = false) }))));
   }
   static get style() { return verdocsTemplateFieldsCss; }
 }, [0, "verdocs-template-fields", {