@mindful-web/marko-web-identity-x 1.57.0 → 1.59.0

package/api/mutations/set-boolean-field-answers.js

@@ -0,0 +1,7 @@
+const gql = require('graphql-tag');
+
+module.exports = gql`
+  mutation SetThirdPartyBooleanFieldAnswers($input: UpdateAppUserCustomBooleanAnswersMutationInput!) {
+    updateAppUserCustomBooleanAnswers(input: $input) { id }
+  }
+`;

package/api/mutations/set-select-field-answers.js

@@ -0,0 +1,7 @@
+const gql = require('graphql-tag');
+
+module.exports = gql`
+  mutation SetThirdPartySelectFieldAnswers($input: UpdateAppUserCustomSelectAnswersMutationInput!) {
+    updateAppUserCustomSelectAnswers(input: $input) { id }
+  }
+`;

package/api/mutations/set-unverified-data.js

@@ -0,0 +1,7 @@
+const gql = require('graphql-tag');
+
+module.exports = gql`
+  mutation SetUnverifiedThirdPartyData($input: SetAppUserUnverifiedDataMutationInput!) {
+    setAppUserUnverifiedData(input: $input) { id }
+  }
+`;

package/api/queries/get-locale-regions.js

@@ -0,0 +1,14 @@
+const gql = require('graphql-tag');
+
+module.exports = gql`
+  query localeRegions {
+    localeRegions {
+      id
+      code
+      name
+      country {
+        id
+      }
+    }
+  }
+`;

package/components/access.marko.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var marko_template = module.exports = require("marko/dist/html").t(__filename),
-    marko_componentType = "/@mindful-web/marko-web-identity-x$1.57.0/components/access.marko",
+    marko_componentType = "/@mindful-web/marko-web-identity-x$1.59.0/components/access.marko",
     marko_component = require("./access.marko"),
     marko_renderer = require("marko/dist/runtime/components/renderer"),
     module_objectPath_module = require("@mindful-web/object-path"),
@@ -53,7 +53,7 @@ marko_template._ = marko_renderer(render, {
   }, marko_component);
 
 marko_template.meta = {
-    id: "/@mindful-web/marko-web-identity-x$1.57.0/components/access.marko",
+    id: "/@mindful-web/marko-web-identity-x$1.59.0/components/access.marko",
     component: "./access.marko",
     tags: [
       "@mindful-web/marko-core/components/resolve.marko"

package/components/comment-stream.marko.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var marko_template = module.exports = require("marko/dist/html").t(__filename),
-    marko_componentType = "/@mindful-web/marko-web-identity-x$1.57.0/components/comment-stream.marko",
+    marko_componentType = "/@mindful-web/marko-web-identity-x$1.59.0/components/comment-stream.marko",
     marko_component = require("./comment-stream.marko"),
     marko_renderer = require("marko/dist/runtime/components/renderer"),
     module_objectPath_module = require("@mindful-web/object-path"),
@@ -85,7 +85,7 @@ marko_template._ = marko_renderer(render, {
   }, marko_component);
 
 marko_template.meta = {
-    id: "/@mindful-web/marko-web-identity-x$1.57.0/components/comment-stream.marko",
+    id: "/@mindful-web/marko-web-identity-x$1.59.0/components/comment-stream.marko",
     component: "./comment-stream.marko",
     tags: [
       "@mindful-web/marko-web/components/browser-component.marko",

package/components/context.marko.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var marko_template = module.exports = require("marko/dist/html").t(__filename),
-    marko_componentType = "/@mindful-web/marko-web-identity-x$1.57.0/components/context.marko",
+    marko_componentType = "/@mindful-web/marko-web-identity-x$1.59.0/components/context.marko",
     marko_component = require("./context.marko"),
     marko_renderer = require("marko/dist/runtime/components/renderer"),
     marko_dynamicTag = require("marko/dist/runtime/helpers/dynamic-tag"),
@@ -49,7 +49,7 @@ marko_template._ = marko_renderer(render, {
   }, marko_component);
 
 marko_template.meta = {
-    id: "/@mindful-web/marko-web-identity-x$1.57.0/components/context.marko",
+    id: "/@mindful-web/marko-web-identity-x$1.59.0/components/context.marko",
     component: "./context.marko",
     tags: [
       "@mindful-web/marko-core/components/resolve.marko"

package/components/form-access.marko.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var marko_template = module.exports = require("marko/dist/html").t(__filename),
-    marko_componentType = "/@mindful-web/marko-web-identity-x$1.57.0/components/form-access.marko",
+    marko_componentType = "/@mindful-web/marko-web-identity-x$1.59.0/components/form-access.marko",
     marko_component = require("./form-access.marko"),
     marko_renderer = require("marko/dist/runtime/components/renderer"),
     module_defaultValue = require("@mindful-web/marko-core/utils/default-value"),
@@ -146,7 +146,7 @@ marko_template._ = marko_renderer(render, {
   }, marko_component);
 
 marko_template.meta = {
-    id: "/@mindful-web/marko-web-identity-x$1.57.0/components/form-access.marko",
+    id: "/@mindful-web/marko-web-identity-x$1.59.0/components/form-access.marko",
     component: "./form-access.marko",
     tags: [
       "@mindful-web/marko-web/components/browser-component.marko",

package/components/form-authenticate.marko.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var marko_template = module.exports = require("marko/dist/html").t(__filename),
-    marko_componentType = "/@mindful-web/marko-web-identity-x$1.57.0/components/form-authenticate.marko",
+    marko_componentType = "/@mindful-web/marko-web-identity-x$1.59.0/components/form-authenticate.marko",
     marko_component = require("./form-authenticate.marko"),
     marko_renderer = require("marko/dist/runtime/components/renderer"),
     module_objectPath_module = require("@mindful-web/object-path"),
@@ -68,7 +68,7 @@ marko_template._ = marko_renderer(render, {
   }, marko_component);
 
 marko_template.meta = {
-    id: "/@mindful-web/marko-web-identity-x$1.57.0/components/form-authenticate.marko",
+    id: "/@mindful-web/marko-web-identity-x$1.59.0/components/form-authenticate.marko",
     component: "./form-authenticate.marko",
     tags: [
       "@mindful-web/marko-web/components/browser-component.marko",

package/components/form-change-email.marko.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var marko_template = module.exports = require("marko/dist/html").t(__filename),
-    marko_componentType = "/@mindful-web/marko-web-identity-x$1.57.0/components/form-change-email.marko",
+    marko_componentType = "/@mindful-web/marko-web-identity-x$1.59.0/components/form-change-email.marko",
     marko_component = require("./form-change-email.marko"),
     marko_renderer = require("marko/dist/runtime/components/renderer"),
     module_objectPath_module = require("@mindful-web/object-path"),
@@ -59,7 +59,7 @@ marko_template._ = marko_renderer(render, {
   }, marko_component);
 
 marko_template.meta = {
-    id: "/@mindful-web/marko-web-identity-x$1.57.0/components/form-change-email.marko",
+    id: "/@mindful-web/marko-web-identity-x$1.59.0/components/form-change-email.marko",
     component: "./form-change-email.marko",
     tags: [
       "@mindful-web/marko-web/components/browser-component.marko",

package/components/form-login.marko.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var marko_template = module.exports = require("marko/dist/html").t(__filename),
-    marko_componentType = "/@mindful-web/marko-web-identity-x$1.57.0/components/form-login.marko",
+    marko_componentType = "/@mindful-web/marko-web-identity-x$1.59.0/components/form-login.marko",
     marko_component = require("./form-login.marko"),
     marko_renderer = require("marko/dist/runtime/components/renderer"),
     module_objectPath_module = require("@mindful-web/object-path"),
@@ -79,7 +79,7 @@ marko_template._ = marko_renderer(render, {
   }, marko_component);
 
 marko_template.meta = {
-    id: "/@mindful-web/marko-web-identity-x$1.57.0/components/form-login.marko",
+    id: "/@mindful-web/marko-web-identity-x$1.59.0/components/form-login.marko",
     component: "./form-login.marko",
     tags: [
       "@mindful-web/marko-web/components/browser-component.marko",

package/components/form-logout.marko.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var marko_template = module.exports = require("marko/dist/html").t(__filename),
-    marko_componentType = "/@mindful-web/marko-web-identity-x$1.57.0/components/form-logout.marko",
+    marko_componentType = "/@mindful-web/marko-web-identity-x$1.59.0/components/form-logout.marko",
     marko_renderer = require("marko/dist/runtime/components/renderer"),
     module_defaultValue = require("@mindful-web/marko-core/utils/default-value"),
     defaultValue = module_defaultValue.default || module_defaultValue,
@@ -29,7 +29,7 @@ marko_template._ = marko_renderer(render, {
   });
 
 marko_template.meta = {
-    id: "/@mindful-web/marko-web-identity-x$1.57.0/components/form-logout.marko",
+    id: "/@mindful-web/marko-web-identity-x$1.59.0/components/form-logout.marko",
     tags: [
       "@mindful-web/marko-web/components/browser-component.marko"
     ]

package/components/form-profile.marko.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var marko_template = module.exports = require("marko/dist/html").t(__filename),
-    marko_componentType = "/@mindful-web/marko-web-identity-x$1.57.0/components/form-profile.marko",
+    marko_componentType = "/@mindful-web/marko-web-identity-x$1.59.0/components/form-profile.marko",
     marko_component = require("./form-profile.marko"),
     marko_renderer = require("marko/dist/runtime/components/renderer"),
     module_objectPath_module = require("@mindful-web/object-path"),
@@ -81,7 +81,7 @@ marko_template._ = marko_renderer(render, {
   }, marko_component);
 
 marko_template.meta = {
-    id: "/@mindful-web/marko-web-identity-x$1.57.0/components/form-profile.marko",
+    id: "/@mindful-web/marko-web-identity-x$1.59.0/components/form-profile.marko",
     component: "./form-profile.marko",
     tags: [
       "@mindful-web/marko-web/components/browser-component.marko",

package/components/form-register.marko.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var marko_template = module.exports = require("marko/dist/html").t(__filename),
-    marko_componentType = "/@mindful-web/marko-web-identity-x$1.57.0/components/form-register.marko",
+    marko_componentType = "/@mindful-web/marko-web-identity-x$1.59.0/components/form-register.marko",
     marko_renderer = require("marko/dist/runtime/components/renderer"),
     marko_assign = require("marko/dist/runtime/helpers/assign"),
     marko_web_identity_x_form_login_template = require("./form-login.marko"),
@@ -25,7 +25,7 @@ marko_template._ = marko_renderer(render, {
   });
 
 marko_template.meta = {
-    id: "/@mindful-web/marko-web-identity-x$1.57.0/components/form-register.marko",
+    id: "/@mindful-web/marko-web-identity-x$1.59.0/components/form-register.marko",
     tags: [
       "./form-login.marko"
     ]

package/components/identify.marko.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var marko_template = module.exports = require("marko/dist/html").t(__filename),
-    marko_componentType = "/@mindful-web/marko-web-identity-x$1.57.0/components/identify.marko",
+    marko_componentType = "/@mindful-web/marko-web-identity-x$1.59.0/components/identify.marko",
     marko_component = require("./identify.marko"),
     marko_renderer = require("marko/dist/runtime/components/renderer"),
     module_objectPath_module = require("@mindful-web/object-path"),
@@ -50,7 +50,7 @@ marko_template._ = marko_renderer(render, {
   }, marko_component);
 
 marko_template.meta = {
-    id: "/@mindful-web/marko-web-identity-x$1.57.0/components/identify.marko",
+    id: "/@mindful-web/marko-web-identity-x$1.59.0/components/identify.marko",
     component: "./identify.marko",
     tags: [
       "@mindful-web/marko-web-gtm/components/push.marko",

package/components/non-auth-identify.marko.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var marko_template = module.exports = require("marko/dist/html").t(__filename),
-    marko_componentType = "/@mindful-web/marko-web-identity-x$1.57.0/components/non-auth-identify.marko",
+    marko_componentType = "/@mindful-web/marko-web-identity-x$1.59.0/components/non-auth-identify.marko",
     marko_component = require("./non-auth-identify.marko"),
     marko_renderer = require("marko/dist/runtime/components/renderer"),
     marko_dynamicTag = require("marko/dist/runtime/helpers/dynamic-tag"),
@@ -45,7 +45,7 @@ marko_template._ = marko_renderer(render, {
   }, marko_component);
 
 marko_template.meta = {
-    id: "/@mindful-web/marko-web-identity-x$1.57.0/components/non-auth-identify.marko",
+    id: "/@mindful-web/marko-web-identity-x$1.59.0/components/non-auth-identify.marko",
     component: "./non-auth-identify.marko",
     tags: [
       "@mindful-web/marko-core/components/resolve.marko"

package/components/subscribe.marko.js

@@ -2,7 +2,7 @@
 "use strict";
 
 var marko_template = module.exports = require("marko/dist/html").t(__filename),
-    marko_componentType = "/@mindful-web/marko-web-identity-x$1.57.0/components/subscribe.marko",
+    marko_componentType = "/@mindful-web/marko-web-identity-x$1.59.0/components/subscribe.marko",
     marko_component = require("./subscribe.marko"),
     marko_renderer = require("marko/dist/runtime/components/renderer"),
     module_objectPath_module = require("@mindful-web/object-path"),
@@ -73,7 +73,7 @@ marko_template._ = marko_renderer(render, {
   }, marko_component);
 
 marko_template.meta = {
-    id: "/@mindful-web/marko-web-identity-x$1.57.0/components/subscribe.marko",
+    id: "/@mindful-web/marko-web-identity-x$1.59.0/components/subscribe.marko",
     component: "./subscribe.marko",
     tags: [
       "@mindful-web/marko-web/components/browser-component.marko",

package/index.js

@@ -4,7 +4,7 @@ const middleware = require('./middleware');
 /**
  *
  * @param {object} app The express app instance
- * @param {IdentityXConfiguration} config The IdentityX config
+ * @param {import('./config')} config The IdentityX config
  */
 module.exports = (app, config, {
   templates = {},
@@ -38,3 +38,126 @@ module.exports = (app, config, {
  * @prop {boolean} [required] If the field should be required
  * @prop {number} [width] Column width (percentage specified as decimal)
  */
+/**
+ * Built-in IdentityX field keys
+ * @typedef {(
+ * |"addressExtra"
+ * |"city"
+ * |"countryCode"
+ * |"displayName"
+ * |"email"
+ * |"familyName"
+ * |"givenName"
+ * |"mobileNumber"
+ * |"organization"
+ * |"organizationTitle"
+ * |"phoneNumber"
+ * |"postalCode"
+ * |"regionCode"
+ * |"street"
+ * )} IdXField
+ */
+
+/**
+ * @typedef IdentityXContext
+ * @prop {IdentityXApp} application
+ * @prop {IdentityXAppUser|null} user
+ * @prop {Object[]} mergedTeams
+ * @prop {Object[]} mergedAccessLevels
+ * @prop {Boolean} hasTeams
+ * @prop {Boolean} hasUser
+ * @prop {Boolean} isEnabled
+ *
+ * @typedef IdentityXApp
+ * @prop {String} id
+ * @prop {String} name
+ * @prop {String} consentPolicy
+ * @prop {String} emailConsentRequest
+ * @prop {Object[]} regionalConsentPolicies
+ *
+ * @typedef IdentityXAppUser
+ * @prop {String} id
+ * @prop {String} email
+ * @prop {boolean} verified
+ * @prop {string} givenName
+ * @prop {string} familyName
+ * @prop {string} displayName
+ * @prop {string} organization
+ * @prop {string} organizationTitle
+ * @prop {string} countryCode
+ * @prop {string} regionCode
+ * @prop {string} postalCode
+ * @prop {string} city
+ * @prop {string} street
+ * @prop {string} addressExtra
+ * @prop {string} mobileNumber
+ * @prop {string} phoneNumber
+ * @prop {boolean} receiveEmail
+ * @prop {ExternalId[]} externalIds
+ * @prop {object} customAttributes
+ * @prop {CustomBooleanFieldAnswer[]} customBooleanFieldAnswers
+ * @prop {CustomSelectFieldAnswer[]} customSelectFieldAnswers
+ * @prop {CustomTextFieldAnswer[]} customTextFieldAnswers
+ *
+ * @typedef ExternalId
+ * @prop {string} id
+ * @prop {object} identifier
+ * @prop {string} identifier.value
+ * @prop {string?} identifier.type
+ * @prop {object} namespace
+ * @prop {string} namespace.provider
+ * @prop {string} namespace.tenant
+ * @prop {string} namespace.type
+ *
+ * @typedef CustomBooleanFieldAnswer
+ * @prop {string} id
+ * @todo
+ *
+ * @typedef CustomSelectFieldAnswer
+ * @prop {string} id
+ * @prop {boolean} hasAnswered
+ * @prop {CustomSelectFieldAnswerValue[]} answers
+ * @prop {CustomSelectField} field
+ *
+ * @typedef CustomSelectFieldAnswerValue
+ * @prop {string} id
+ * @prop {string} label
+ * @prop {string?} externalIdentifier
+ * @prop {string?} writeInValue
+ *
+ * @typedef CustomSelectField
+ * @prop {string} id
+ * @prop {string} label
+ * @prop {boolean} active
+ * @prop {boolean} multiple
+ * @prop {boolean} required
+ * @prop {ExternalId?} externalId
+ * @prop {CustomSelectFieldOption[]} options
+ *
+ * @typedef CustomSelectFieldOption
+ * @prop {string} id
+ * @prop {string} label
+ * @prop {boolean} canWriteIn
+ * @prop {boolean} canSelect
+ *
+ * @typedef CustomTextFieldAnswer
+ * @prop {string} id
+ * @todo
+ *
+ * @typedef IdxCustomField
+ * @prop {boolean} active
+ * @prop {ExternalId} externalId
+ * @prop {(|"BooleanField"|"SelectField"|"TextField")} __typename
+ * @prop {string} id
+ * @prop {mixed} value
+ * @prop {object} [whenTrue]
+ * @prop {mixed} whenTrue.value
+ */
+/**
+ * @typedef Region
+ * @prop {string} id ISO 3166-2 code, e.g; US-AL or CA-AB
+ * @prop {string} code ISO 3166-2:XX subdivision code, e.g AL or AB
+ * @prop {string} name The full name of the country subdivision, e.g; Alabama or Alberta
+ * @prop {object} country
+ * @prop {string} country.id ISO 3166-1 alpha-2 code of the region/subdivision's country
+ */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindful-web/marko-web-identity-x",
-  "version": "1.57.0",
+  "version": "1.59.0",
   "description": "Marko Wrapper for IdentityX",
   "repository": "https://github.com/parameter1/mindful-web/tree/main/packages/marko-web-identity-x",
   "author": "Josh Worden <josh@parameter1.com>",
@@ -37,5 +37,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "9c22257ffa98b3558deb5f6b8cb5088a89fc78f1"
+  "gitHead": "fa6805fe999892992166818fcf98d5e5714ccbc3"
 }

package/service.js

@@ -1,21 +1,25 @@
 const { get, getAsArray, getAsObject } = require('@mindful-web/object-path');
 const { getResponseCookies } = require('@mindful-web/utils');
+const ADD_EXTERNAL_USER_ID = require('./api/mutations/add-external-user-id');
+const APP_USER_BY_EXTERNAL_ID = require('./api/queries/load-user-by-external-id');
+const APP_USER_BY_ID = require('./api/queries/load-user-by-id');
+const callHooksFor = require('./utils/call-hooks-for');
+const CHECK_CONTENT_ACCESS = require('./api/queries/check-content-access');
+const CREATE_APP_USER = require('./api/mutations/create-app-user');
 const createClient = require('./utils/create-client');
-const getActiveContext = require('./api/queries/get-active-context');
-const checkContentAccess = require('./api/queries/check-content-access');
-const loadUser = require('./api/queries/load-user');
-const appUserByExternalIdQuery = require('./api/queries/load-user-by-external-id');
-const appUserByIdQuery = require('./api/queries/load-user-by-id');
-const addExternalUserId = require('./api/mutations/add-external-user-id');
-const setCustomAttributes = require('./api/mutations/set-custom-attributes');
-const impersonateAppUser = require('./api/mutations/impersonate-app-user');
-const sendChangeEmailLinkMutation = require('./api/mutations/send-change-email-link');
-const sendLoginLinkMutation = require('./api/mutations/send-login-link');
-const createAppUser = require('./api/mutations/create-app-user');
-const logoutAppUser = require('./api/mutations/logout-app-user');
-const deleteAppUserForCurrentApplicationMutation = require('./api/mutations/delete-app-user-for-current-application');
+const DELETE_APP_USER = require('./api/mutations/delete-app-user-for-current-application');
+const GET_ACTIVE_CONTEXT = require('./api/queries/get-active-context');
+const GET_LOCALE_REGIONS = require('./api/queries/get-locale-regions');
+const IMPERSONATE_APP_USER = require('./api/mutations/impersonate-app-user');
+const LOAD_USER = require('./api/queries/load-user');
+const LOG_OUT_APP_USER = require('./api/mutations/logout-app-user');
+const SEND_CHANGE_EMAIL_LINK = require('./api/mutations/send-change-email-link');
+const SEND_LOGIN_LINK = require('./api/mutations/send-login-link');
+const SET_BOOLEAN_FIELD_ANSWERS = require('./api/mutations/set-boolean-field-answers');
+const SET_CUSTOM_ATTRIBUTES = require('./api/mutations/set-custom-attributes');
+const SET_SELECT_FIELD_ANSWERS = require('./api/mutations/set-select-field-answers');
+const SET_UNVERIFIED_DATA = require('./api/mutations/set-unverified-data');
 const tokenCookie = require('./utils/token-cookie');
-const callHooksFor = require('./utils/call-hooks-for');
 
 const isEmpty = (v) => v == null || v === '';
 const isFn = (v) => typeof v === 'function';
@@ -154,7 +158,7 @@ class IdentityX {
   async loadActiveContext({ forceQuery = false, withFields = false } = {}) {
     // Only run the active context query once
     if (!this.activeContextQuery || forceQuery || withFields) {
-      this.activeContextQuery = this.client.query({ query: getActiveContext({ withFields }) });
+      this.activeContextQuery = this.client.query({ query: GET_ACTIVE_CONTEXT({ withFields }) });
     }
     const { data = {} } = await this.activeContextQuery;
     const activeContext = data.activeAppContext || {};
@@ -172,7 +176,7 @@ class IdentityX {
    */
   async loadAppUserByEmail(email) {
     const { data } = await this.client.query({
-      query: loadUser,
+      query: LOAD_USER,
       variables: { email },
       fetchPolicy: 'no-cache',
       context: { apiToken: this.getOrgUserApiToken() },
@@ -180,6 +184,22 @@ class IdentityX {
     return data.appUser;
   }
 
+  /**
+   * Returns available region data
+   *
+   * @returns {Promise<Region[]>}
+   */
+  async loadRegions() {
+    if (!this.regions) {
+      const { data } = await this.client.query({
+        context: { apiToken: this.getOrgUserApiToken() },
+        query: GET_LOCALE_REGIONS,
+      });
+      this.regions = data.localeRegions;
+    }
+    return this.regions;
+  }
+
   /**
    * Checks whether the current user can access the given content.
    *
@@ -188,7 +208,7 @@ class IdentityX {
    */
   async checkContentAccess(input) {
     const variables = { input };
-    const { data = {} } = await this.client.query({ query: checkContentAccess, variables });
+    const { data = {} } = await this.client.query({ query: CHECK_CONTENT_ACCESS, variables });
     const access = data.checkContentAccess || {};
     access.requiresUserInput = false;
 
@@ -282,14 +302,15 @@ class IdentityX {
    * @param {Object} o
    * @param {String} o.identifier
    * @param {ExternalIdNamespace} o.namespace
+   * @param {String} [o.type]
    *
    * @returns {Promise<User|null>}
    */
-  async findUserByExternalId({ identifier, namespace }) {
+  async findUserByExternalId({ identifier, namespace, type }) {
     const { data } = await this.client.query({
-      query: appUserByExternalIdQuery,
+      query: APP_USER_BY_EXTERNAL_ID,
       variables: {
-        identifier: { value: identifier },
+        identifier: { value: identifier, ...(type && { type }) },
         namespace,
       },
       context: { apiToken: this.getOrgUserApiToken() },
@@ -304,7 +325,7 @@ class IdentityX {
    */
   async findUserById(id) {
     const { data } = await this.client.query({
-      query: appUserByIdQuery,
+      query: APP_USER_BY_ID,
       variables: { id },
       context: { apiToken: this.getOrgUserApiToken() },
     });
@@ -324,7 +345,7 @@ class IdentityX {
     const input = { userId, identifier, namespace };
     const variables = { input };
     const { data } = await this.client.mutate({
-      mutation: addExternalUserId,
+      mutation: ADD_EXTERNAL_USER_ID,
       variables,
       context: { apiToken: this.getOrgUserApiToken() },
     });
@@ -350,7 +371,7 @@ class IdentityX {
   async impersonateAppUser({ userId }) {
     const variables = { input: { id: userId, verify: true } };
     const { data } = await this.client.mutate({
-      mutation: impersonateAppUser,
+      mutation: IMPERSONATE_APP_USER,
       variables,
       context: { apiToken: this.getOrgUserApiToken() },
     });
@@ -364,7 +385,7 @@ class IdentityX {
     const input = { token };
     const variables = { input };
     const user = getAsObject({
-      ...(token && await this.client.mutate({ mutation: logoutAppUser, variables })),
+      ...(token && await this.client.mutate({ mutation: LOG_OUT_APP_USER, variables })),
     }, 'data.logoutAppUserWithData');
     tokenCookie.removeFrom(this.res);
     await callHooksFor(this, 'onLogout', {
@@ -382,7 +403,7 @@ class IdentityX {
     const [valid, msg] = await this.validateEmail(email);
     if (!valid) throw new Error(msg || 'The supplied email address cannot be used.');
     const { data } = await this.client.mutate({
-      mutation: createAppUser,
+      mutation: CREATE_APP_USER,
       variables: { email },
       context: { apiToken: this.getOrgUserApiToken() },
     });
@@ -394,20 +415,75 @@ class IdentityX {
    */
   async setAppUserCustomAttributes({ userId, attributes = {}, dispatch = true } = {}) {
     const { data: { updateOwnAppUserCustomAttributes: user } } = await this.client.mutate({
-      mutation: setCustomAttributes,
+      mutation: SET_CUSTOM_ATTRIBUTES,
       variables: { input: { id: userId, attributes } },
     });
     if (dispatch) await callHooksFor(this, 'onUserProfileUpdate', { req: this.req, user });
     return user;
   }
 
+  /**
+   * Uses the `setUnverifiedAppUserData` mutation to push data to an app user. If the user is
+   * verified, this mutation does nothing. At minimum, the email address must be supplied.
+   *
+   * @param {object} input
+   * @param {string} input.email
+   */
+  async setUnverifiedAppUserData(input) {
+    if (!input.email) throw new Error('No "email" was specified for this operation.');
+    await this.client.mutate({
+      context: { apiToken: this.getOrgUserApiToken() },
+      mutation: SET_UNVERIFIED_DATA,
+      variables: { input },
+    });
+    return true;
+  }
+
+  /**
+   * Sets custom boolean answers if the user is not yet verified. If the user is verified, this does
+   * nothing.
+   *
+   * @param {string} email The IdentityX AppUser email
+   * @param {CustomBooleanFieldAnswer[]} answers
+   */
+  async setUnverifiedBooleanFieldAnswers(email, answers) {
+    if (answers || !answers.length) return false;
+    const appUser = this.loadAppUserByEmail(email);
+    if (!appUser || appUser.verified) return false;
+    await this.client.mutate({
+      context: { apiToken: this.getOrgUserApiToken() },
+      mutation: SET_BOOLEAN_FIELD_ANSWERS,
+      variables: { input: { id: appUser.id, answers } },
+    });
+    return true;
+  }
+
+  /**
+   * Sets custom select answers if the user is not yet verified. If the user is verified, this does
+   * nothing.
+   *
+   * @param {string} email The IdentityX AppUser email
+   * @param {CustomSelectFieldAnswer[]} answers
+   */
+  async setUnverifiedSelectFieldAnswers(email, answers) {
+    if (answers || !answers.length) return false;
+    const appUser = this.loadAppUserByEmail(email);
+    if (!appUser || appUser.verified) return false;
+    await this.client.mutate({
+      context: { apiToken: this.getOrgUserApiToken() },
+      mutation: SET_SELECT_FIELD_ANSWERS,
+      variables: { input: { id: appUser.id, answers } },
+    });
+    return true;
+  }
+
   /**
    * Sends a change email link to an existing user
    */
   async sendChangeEmailLink({ email }) {
     const authUrl = `${this.req.protocol}://${this.req.get('host')}${this.config.getEndpointFor('changeEmail')}`;
     await this.client.mutate({
-      mutation: sendChangeEmailLinkMutation,
+      mutation: SEND_CHANGE_EMAIL_LINK,
       variables: { input: { email, authUrl, appContextId: this.config.get('appContextId') } },
     });
     await callHooksFor(this, 'onChangeEmailLinkSent', { email });
@@ -441,7 +517,7 @@ class IdentityX {
     additionalEventData,
   }) {
     await this.client.mutate({
-      mutation: sendLoginLinkMutation,
+      mutation: SEND_LOGIN_LINK,
       variables: {
         input: {
           additionalContext: additionalEventData || {},
@@ -471,7 +547,7 @@ class IdentityX {
     userId,
   }) {
     const { data } = await this.client.mutate({
-      mutation: deleteAppUserForCurrentApplicationMutation,
+      mutation: DELETE_APP_USER,
       variables: {
         input: {
           ...(email && { email }),

package/utils/create-identity-builder.js

@@ -1,25 +1,5 @@
 /**
- * @typedef IdentityXContext
- * @prop {IdentityXApp} application
- * @prop {IdentityXAppUser|null} user
- * @prop {Object[]} mergedTeams
- * @prop {Object[]} mergedAccessLevels
- * @prop {Boolean} hasTeams
- * @prop {Boolean} hasUser
- * @prop {Boolean} isEnabled
- *
- * @typedef IdentityXApp
- * @prop {String} id
- * @prop {String} name
- * @prop {String} consentPolicy
- * @prop {String} emailConsentRequest
- * @prop {Object[]} regionalConsentPolicies
- *
- * @typedef IdentityXAppUser
- * @prop {String} id
- * @prop {String} email
- *
- * @param {IdentityXContext} context
+ * @param {import("..").IdentityXContext} context
  * @param {String|null} identity
  */
 module.exports = (context = {}, identity = null) => {