strapi-plugin-hubspot 0.2.0 → 0.3.0

package/README.md

@@ -44,8 +44,10 @@ Société · Nombre d'employés (numberofemployees)
 ```
 
 **The list narrows to the object you picked.** Point the field at the sibling
-that holds the object and choosing *Contact* leaves only contact properties —
-the prefix disappears, since it is no longer telling you anything:
+that holds the object — from the Content-Type Builder, under *HubSpot → Object
+field* — and choosing *Contact* leaves only contact properties. The prefix
+disappears, since it is no longer telling you anything. In `schema.json` that
+setting reads:
 
 ```json
 {
@@ -69,7 +71,25 @@ entry before it is written, at any depth — steps, repeatable components, dynam
 zones. An invalid mapping is refused with a message that says which property and
 why:
 
-> Mapping HubSpot invalide — « name » existe sur l'objet Société, pas sur Contact
+> Invalid HubSpot mapping — "name" exists on company, not on contact
+
+It catches four things:
+
+| Code | Case |
+|---|---|
+| `unknown` | The property doesn't exist in the portal |
+| `wrong-object` | It exists, but on another object |
+| `whitespace` | It exists, but the stored value has surrounding spaces |
+| `bad-option` | The field offers a choice the enumeration doesn't accept |
+
+That last one closes a real hole: HubSpot refuses a value outside an
+enumeration exactly as hard as it refuses an unknown property, so a select whose
+choices drifted from the CRM fails at send time with nothing to show for it.
+Point `optionsField` at the repeatable holding the choices (default `options`,
+each `{ value?, label? }`) and they are checked too.
+
+Each problem is also carried as a structured code in the error's `details`, so a
+host app can localize the message instead of parsing the sentence.
 
 ### A settings screen
 
@@ -111,6 +131,7 @@ export default ({ env }) => ({
           uid: "api::form.form",
           objectField: "hsObject",     // holds "contact" | "company"
           propertyField: "hsProperty", // holds the property name
+          optionsField: "options",     // optional — the field's choices
         },
       ],
     },
@@ -144,8 +165,16 @@ Create a **private app** in HubSpot with a read scope per object you list:
 
 An object the token can't read is **skipped, not fatal**: the picker keeps
 working for the others and explains which one is missing a scope. `oauth` is
-worth adding too — it exposes the portal id, which turns on the *view in HubSpot*
-links.
+worth adding too — it exposes the portal id *and the portal's UI host*, which
+turn on the *view in HubSpot* links.
+
+### Regions
+
+The REST API is global: `api.hubapi.com` routes by token, whatever the portal's
+hosting region. The **web app is not** — an EU-hosted portal lives on
+`app-eu1.hubspot.com`. Deep links are built from the `uiDomain` HubSpot reports
+for your portal rather than a hardcoded host, so they point at the right region
+without any configuration.
 
 The key is resolved in this order, first match wins:
 

package/dist/_chunks/{HubspotPropertyInput-D0gijgli.mjs → HubspotPropertyInput-C3KbDHYP.mjs}

@@ -2,7 +2,7 @@ import { jsxs, jsx } from "react/jsx-runtime";
 import * as React from "react";
 import { Field, Flex, Loader, Combobox, ComboboxOption, Link } from "@strapi/design-system";
 import { useFetchClient, useField } from "@strapi/strapi/admin";
-import { P as PLUGIN_ID } from "./index-DIwNOVQ0.mjs";
+import { P as PLUGIN_ID } from "./index-lx7um1Yx.mjs";
 const LABELS = {
   contact: "Contact",
   company: "Société",
@@ -68,7 +68,7 @@ const HubspotPropertyInput = React.forwardRef(
       }
       return hint;
     };
-    const crmLink = schema?.portalId && value && schema.properties.some((p) => p.name === value) ? `https://app.hubspot.com/property-settings/${schema.portalId}/properties?search=${encodeURIComponent(value)}` : null;
+    const crmLink = schema?.portalId && value && schema.properties.some((p) => p.name === value) ? `https://${schema.uiDomain || "app.hubspot.com"}/property-settings/${schema.portalId}/properties?search=${encodeURIComponent(value)}` : null;
     return /* @__PURE__ */ jsxs(Field.Root, { name, error, hint: describe(), required, children: [
       /* @__PURE__ */ jsx(Field.Label, { action: labelAction, children: label }),
       !schema ? /* @__PURE__ */ jsx(Flex, { paddingTop: 2, paddingBottom: 2, children: /* @__PURE__ */ jsx(Loader, { small: true, children: "Chargement des propriétés HubSpot…" }) }) : schema.configured ? /* @__PURE__ */ jsx(

package/dist/_chunks/{HubspotPropertyInput-BcdqfAfv.js → HubspotPropertyInput-C9PpYYgj.js}

@@ -4,7 +4,7 @@ const jsxRuntime = require("react/jsx-runtime");
 const React = require("react");
 const designSystem = require("@strapi/design-system");
 const admin = require("@strapi/strapi/admin");
-const index = require("./index-sOi9wC_y.js");
+const index = require("./index-Bq1tS5h6.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
@@ -88,7 +88,7 @@ const HubspotPropertyInput = React__namespace.forwardRef(
       }
       return hint;
     };
-    const crmLink = schema?.portalId && value && schema.properties.some((p) => p.name === value) ? `https://app.hubspot.com/property-settings/${schema.portalId}/properties?search=${encodeURIComponent(value)}` : null;
+    const crmLink = schema?.portalId && value && schema.properties.some((p) => p.name === value) ? `https://${schema.uiDomain || "app.hubspot.com"}/property-settings/${schema.portalId}/properties?search=${encodeURIComponent(value)}` : null;
     return /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Field.Root, { name, error, hint: describe(), required, children: [
       /* @__PURE__ */ jsxRuntime.jsx(designSystem.Field.Label, { action: labelAction, children: label }),
       !schema ? /* @__PURE__ */ jsxRuntime.jsx(designSystem.Flex, { paddingTop: 2, paddingBottom: 2, children: /* @__PURE__ */ jsxRuntime.jsx(designSystem.Loader, { small: true, children: "Chargement des propriétés HubSpot…" }) }) : schema.configured ? /* @__PURE__ */ jsxRuntime.jsx(

package/dist/_chunks/{Settings-DuYUpD8L.mjs → Settings-DGJ_mmlw.mjs}

@@ -2,7 +2,7 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
 import { Box, Loader, Flex, Typography, Badge, Field, Button } from "@strapi/design-system";
 import { useFetchClient } from "@strapi/strapi/admin";
-import { P as PLUGIN_ID } from "./index-DIwNOVQ0.mjs";
+import { P as PLUGIN_ID } from "./index-lx7um1Yx.mjs";
 const SOURCE_LABEL = {
   settings: "saisie ici",
   config: "config/plugins.ts",

package/dist/_chunks/{Settings-DedA0z6w.js → Settings-Lj49S5fO.js}

@@ -4,7 +4,7 @@ const jsxRuntime = require("react/jsx-runtime");
 const React = require("react");
 const designSystem = require("@strapi/design-system");
 const admin = require("@strapi/strapi/admin");
-const index = require("./index-sOi9wC_y.js");
+const index = require("./index-Bq1tS5h6.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });

package/dist/_chunks/index-Bq1tS5h6.js

@@ -0,0 +1,71 @@
+"use strict";
+const PLUGIN_ID = "hubspot";
+const index = {
+  register(app) {
+    app.customFields.register({
+      name: "property",
+      pluginId: PLUGIN_ID,
+      type: "string",
+      intlLabel: {
+        id: `${PLUGIN_ID}.property.label`,
+        defaultMessage: "Propriété HubSpot"
+      },
+      intlDescription: {
+        id: `${PLUGIN_ID}.property.description`,
+        defaultMessage: "Choisie dans les propriétés réelles du portail"
+      },
+      components: {
+        Input: async () => Promise.resolve().then(() => require("./HubspotPropertyInput-C9PpYYgj.js"))
+      },
+      // Exposed in the Content-Type Builder. Without this, `objectField` could
+      // only be set by hand-editing schema.json — which is not how anyone
+      // installing from npm adds a field, so the filtering would be unreachable.
+      options: {
+        base: [
+          {
+            sectionTitle: {
+              id: `${PLUGIN_ID}.options.section`,
+              defaultMessage: "HubSpot"
+            },
+            items: [
+              {
+                name: "options.objectField",
+                type: "text",
+                intlLabel: {
+                  id: `${PLUGIN_ID}.options.objectField.label`,
+                  defaultMessage: "Object field"
+                },
+                description: {
+                  id: `${PLUGIN_ID}.options.objectField.description`,
+                  defaultMessage: "Name of the sibling field holding the HubSpot object (e.g. hsObject). Leave empty to list every object's properties."
+                },
+                placeholder: {
+                  id: `${PLUGIN_ID}.options.objectField.placeholder`,
+                  defaultMessage: "hsObject"
+                }
+              }
+            ]
+          }
+        ]
+      }
+    });
+    app.createSettingSection(
+      {
+        id: PLUGIN_ID,
+        intlLabel: { id: `${PLUGIN_ID}.settings.section`, defaultMessage: "HubSpot" }
+      },
+      [
+        {
+          intlLabel: { id: `${PLUGIN_ID}.settings.link`, defaultMessage: "Configuration" },
+          id: `${PLUGIN_ID}-settings`,
+          to: `/settings/${PLUGIN_ID}`,
+          permissions: [],
+          Component: async () => (await Promise.resolve().then(() => require("./Settings-Lj49S5fO.js"))).default
+        }
+      ]
+    );
+    app.registerPlugin({ id: PLUGIN_ID, name: PLUGIN_ID });
+  }
+};
+exports.PLUGIN_ID = PLUGIN_ID;
+exports.index = index;

package/dist/_chunks/index-lx7um1Yx.mjs

@@ -0,0 +1,72 @@
+const PLUGIN_ID = "hubspot";
+const index = {
+  register(app) {
+    app.customFields.register({
+      name: "property",
+      pluginId: PLUGIN_ID,
+      type: "string",
+      intlLabel: {
+        id: `${PLUGIN_ID}.property.label`,
+        defaultMessage: "Propriété HubSpot"
+      },
+      intlDescription: {
+        id: `${PLUGIN_ID}.property.description`,
+        defaultMessage: "Choisie dans les propriétés réelles du portail"
+      },
+      components: {
+        Input: async () => import("./HubspotPropertyInput-C3KbDHYP.mjs")
+      },
+      // Exposed in the Content-Type Builder. Without this, `objectField` could
+      // only be set by hand-editing schema.json — which is not how anyone
+      // installing from npm adds a field, so the filtering would be unreachable.
+      options: {
+        base: [
+          {
+            sectionTitle: {
+              id: `${PLUGIN_ID}.options.section`,
+              defaultMessage: "HubSpot"
+            },
+            items: [
+              {
+                name: "options.objectField",
+                type: "text",
+                intlLabel: {
+                  id: `${PLUGIN_ID}.options.objectField.label`,
+                  defaultMessage: "Object field"
+                },
+                description: {
+                  id: `${PLUGIN_ID}.options.objectField.description`,
+                  defaultMessage: "Name of the sibling field holding the HubSpot object (e.g. hsObject). Leave empty to list every object's properties."
+                },
+                placeholder: {
+                  id: `${PLUGIN_ID}.options.objectField.placeholder`,
+                  defaultMessage: "hsObject"
+                }
+              }
+            ]
+          }
+        ]
+      }
+    });
+    app.createSettingSection(
+      {
+        id: PLUGIN_ID,
+        intlLabel: { id: `${PLUGIN_ID}.settings.section`, defaultMessage: "HubSpot" }
+      },
+      [
+        {
+          intlLabel: { id: `${PLUGIN_ID}.settings.link`, defaultMessage: "Configuration" },
+          id: `${PLUGIN_ID}-settings`,
+          to: `/settings/${PLUGIN_ID}`,
+          permissions: [],
+          Component: async () => (await import("./Settings-DGJ_mmlw.mjs")).default
+        }
+      ]
+    );
+    app.registerPlugin({ id: PLUGIN_ID, name: PLUGIN_ID });
+  }
+};
+export {
+  PLUGIN_ID as P,
+  index as i
+};

package/dist/admin/index.js

@@ -1,3 +1,3 @@
 "use strict";
-const index = require("../_chunks/index-sOi9wC_y.js");
+const index = require("../_chunks/index-Bq1tS5h6.js");
 module.exports = index.index;

package/dist/admin/index.mjs

@@ -1,4 +1,4 @@
-import { i } from "../_chunks/index-DIwNOVQ0.mjs";
+import { i } from "../_chunks/index-lx7um1Yx.mjs";
 export {
   i as default
 };

package/dist/server/index.js

@@ -39,12 +39,14 @@ async function fetchObject(apiKey, object) {
     group: p.groupName
   }));
 }
-async function fetchPortalId(apiKey) {
+async function fetchAccount(apiKey) {
   try {
-    const { portalId } = await hsGet(apiKey, "/account-info/v3/details");
-    return portalId;
+    return await hsGet(
+      apiKey,
+      "/account-info/v3/details"
+    );
   } catch {
-    return void 0;
+    return {};
   }
 }
 async function loadSchema(strapi, apiKey, objects, { force = false } = {}) {
@@ -67,23 +69,25 @@ async function loadSchema(strapi, apiKey, objects, { force = false } = {}) {
       for (const entry of settled) {
         if ("error" in entry && entry.error) {
           unavailable.push({ object: entry.object.name, reason: entry.error });
-          strapi.log.warn(`[hubspot] ${entry.object.name} illisible — ${entry.error}`);
+          strapi.log.warn(`[hubspot] ${entry.object.name} unreadable — ${entry.error}`);
           continue;
         }
         available.push(entry.object.name);
         properties.push(...entry.properties ?? []);
       }
       if (!available.length) {
-        throw new Error(unavailable[0]?.reason ?? "Aucun objet lisible");
+        throw new Error(unavailable[0]?.reason ?? "No readable object");
       }
       properties.sort(
         (a, b) => a.object.localeCompare(b.object) || a.label.localeCompare(b.label)
       );
+      const account = await fetchAccount(apiKey);
       const schema = {
         properties,
         objects: available,
         unavailable,
-        portalId: await fetchPortalId(apiKey)
+        portalId: account.portalId,
+        uiDomain: account.uiDomain
       };
       cache = { at: Date.now(), schema };
       return schema;
@@ -96,16 +100,35 @@ async function loadSchema(strapi, apiKey, objects, { force = false } = {}) {
 function clearCache() {
   cache = null;
 }
-function checkProperty(properties, object, name) {
-  const trimmed = name.trim();
+function checkMapping(properties, mapping) {
+  const { object, property } = mapping;
+  const trimmed = property.trim();
   if (!trimmed) return null;
   const match = properties.find((p) => p.object === object && p.name === trimmed);
-  if (match) return trimmed === name ? null : `« ${name} » contient un espace superflu`;
-  const onOther = properties.find((p) => p.name === trimmed);
-  if (onOther) {
-    return `« ${trimmed} » existe sur l'objet ${onOther.object}, pas sur ${object}`;
+  if (!match) {
+    const elsewhere = properties.find((p) => p.name === trimmed);
+    return elsewhere ? { code: "wrong-object", property: trimmed, object, actualObject: elsewhere.object } : { code: "unknown", property: trimmed, object };
+  }
+  if (trimmed !== property) return { code: "whitespace", property, object };
+  if (match.type === "enumeration" && match.options.length && mapping.values?.length) {
+    const stray = mapping.values.filter((v) => v && !match.options.includes(v));
+    if (stray.length) {
+      return { code: "bad-option", property: trimmed, object, values: stray };
+    }
+  }
+  return null;
+}
+function describeProblem(problem) {
+  switch (problem.code) {
+    case "unknown":
+      return `"${problem.property}" does not exist on ${problem.object} in this HubSpot portal`;
+    case "wrong-object":
+      return `"${problem.property}" exists on ${problem.actualObject}, not on ${problem.object}`;
+    case "whitespace":
+      return `"${problem.property}" has surrounding whitespace`;
+    case "bad-option":
+      return `"${problem.property}" does not accept ${problem.values.map((v) => `"${v}"`).join(", ")}`;
   }
-  return `« ${trimmed} » n'existe pas dans ce portail HubSpot`;
 }
 function resolveObjects(configured) {
   if (!Array.isArray(configured) || !configured.length) {
@@ -181,7 +204,7 @@ const controllers = {
         ctx.body = { configured: true, ...schema };
       } catch (err) {
         strapi.log.error(`[hubspot] ${err.message}`);
-        ctx.throw(502, "Impossible de joindre HubSpot — vérifiez la clé API.");
+        ctx.throw(502, "Cannot reach HubSpot — check the API key.");
       }
     }
   }),
@@ -227,9 +250,16 @@ function collectMappings(node, target, found = []) {
   const property = obj[target.propertyField];
   if (typeof property === "string" && property.trim()) {
     const object = obj[target.objectField];
+    const rawOptions = obj[target.optionsField || "options"];
+    const values = Array.isArray(rawOptions) ? rawOptions.map((o) => {
+      const opt = o ?? {};
+      const v = typeof opt.value === "string" && opt.value.trim() ? opt.value : opt.label;
+      return typeof v === "string" ? v.trim() : "";
+    }).filter(Boolean) : void 0;
     found.push({
       object: typeof object === "string" && object ? object : "contact",
-      property
+      property,
+      values
     });
   }
   for (const value of Object.values(obj)) collectMappings(value, target, found);
@@ -265,13 +295,15 @@ const index = {
             resolveObjects(strapi.plugin("hubspot").config("objects", []))
           );
         } catch {
-          strapi.log.warn("[hubspot] schéma indisponible — validation ignorée");
+          strapi.log.warn("[hubspot] schema unavailable — validation skipped");
           return next();
         }
-        const problems = mappings.map((m) => checkProperty(schema.properties, m.object, m.property)).filter((reason) => Boolean(reason));
+        const problems = mappings.map((m) => checkMapping(schema.properties, m)).filter((p) => Boolean(p));
         if (problems.length) {
+          const sentences = [...new Set(problems.map(describeProblem))];
           throw new utils.errors.ValidationError(
-            `Mapping HubSpot invalide — ${[...new Set(problems)].join(" ; ")}`
+            `Invalid HubSpot mapping — ${sentences.join("; ")}`,
+            { problems }
           );
         }
         return next();

package/dist/server/index.mjs

@@ -38,12 +38,14 @@ async function fetchObject(apiKey, object) {
     group: p.groupName
   }));
 }
-async function fetchPortalId(apiKey) {
+async function fetchAccount(apiKey) {
   try {
-    const { portalId } = await hsGet(apiKey, "/account-info/v3/details");
-    return portalId;
+    return await hsGet(
+      apiKey,
+      "/account-info/v3/details"
+    );
   } catch {
-    return void 0;
+    return {};
   }
 }
 async function loadSchema(strapi, apiKey, objects, { force = false } = {}) {
@@ -66,23 +68,25 @@ async function loadSchema(strapi, apiKey, objects, { force = false } = {}) {
       for (const entry of settled) {
         if ("error" in entry && entry.error) {
           unavailable.push({ object: entry.object.name, reason: entry.error });
-          strapi.log.warn(`[hubspot] ${entry.object.name} illisible — ${entry.error}`);
+          strapi.log.warn(`[hubspot] ${entry.object.name} unreadable — ${entry.error}`);
           continue;
         }
         available.push(entry.object.name);
         properties.push(...entry.properties ?? []);
       }
       if (!available.length) {
-        throw new Error(unavailable[0]?.reason ?? "Aucun objet lisible");
+        throw new Error(unavailable[0]?.reason ?? "No readable object");
       }
       properties.sort(
         (a, b) => a.object.localeCompare(b.object) || a.label.localeCompare(b.label)
       );
+      const account = await fetchAccount(apiKey);
       const schema = {
         properties,
         objects: available,
         unavailable,
-        portalId: await fetchPortalId(apiKey)
+        portalId: account.portalId,
+        uiDomain: account.uiDomain
       };
       cache = { at: Date.now(), schema };
       return schema;
@@ -95,16 +99,35 @@ async function loadSchema(strapi, apiKey, objects, { force = false } = {}) {
 function clearCache() {
   cache = null;
 }
-function checkProperty(properties, object, name) {
-  const trimmed = name.trim();
+function checkMapping(properties, mapping) {
+  const { object, property } = mapping;
+  const trimmed = property.trim();
   if (!trimmed) return null;
   const match = properties.find((p) => p.object === object && p.name === trimmed);
-  if (match) return trimmed === name ? null : `« ${name} » contient un espace superflu`;
-  const onOther = properties.find((p) => p.name === trimmed);
-  if (onOther) {
-    return `« ${trimmed} » existe sur l'objet ${onOther.object}, pas sur ${object}`;
+  if (!match) {
+    const elsewhere = properties.find((p) => p.name === trimmed);
+    return elsewhere ? { code: "wrong-object", property: trimmed, object, actualObject: elsewhere.object } : { code: "unknown", property: trimmed, object };
+  }
+  if (trimmed !== property) return { code: "whitespace", property, object };
+  if (match.type === "enumeration" && match.options.length && mapping.values?.length) {
+    const stray = mapping.values.filter((v) => v && !match.options.includes(v));
+    if (stray.length) {
+      return { code: "bad-option", property: trimmed, object, values: stray };
+    }
+  }
+  return null;
+}
+function describeProblem(problem) {
+  switch (problem.code) {
+    case "unknown":
+      return `"${problem.property}" does not exist on ${problem.object} in this HubSpot portal`;
+    case "wrong-object":
+      return `"${problem.property}" exists on ${problem.actualObject}, not on ${problem.object}`;
+    case "whitespace":
+      return `"${problem.property}" has surrounding whitespace`;
+    case "bad-option":
+      return `"${problem.property}" does not accept ${problem.values.map((v) => `"${v}"`).join(", ")}`;
   }
-  return `« ${trimmed} » n'existe pas dans ce portail HubSpot`;
 }
 function resolveObjects(configured) {
   if (!Array.isArray(configured) || !configured.length) {
@@ -180,7 +203,7 @@ const controllers = {
         ctx.body = { configured: true, ...schema };
       } catch (err) {
         strapi.log.error(`[hubspot] ${err.message}`);
-        ctx.throw(502, "Impossible de joindre HubSpot — vérifiez la clé API.");
+        ctx.throw(502, "Cannot reach HubSpot — check the API key.");
       }
     }
   }),
@@ -226,9 +249,16 @@ function collectMappings(node, target, found = []) {
   const property = obj[target.propertyField];
   if (typeof property === "string" && property.trim()) {
     const object = obj[target.objectField];
+    const rawOptions = obj[target.optionsField || "options"];
+    const values = Array.isArray(rawOptions) ? rawOptions.map((o) => {
+      const opt = o ?? {};
+      const v = typeof opt.value === "string" && opt.value.trim() ? opt.value : opt.label;
+      return typeof v === "string" ? v.trim() : "";
+    }).filter(Boolean) : void 0;
     found.push({
       object: typeof object === "string" && object ? object : "contact",
-      property
+      property,
+      values
     });
   }
   for (const value of Object.values(obj)) collectMappings(value, target, found);
@@ -264,13 +294,15 @@ const index = {
             resolveObjects(strapi.plugin("hubspot").config("objects", []))
           );
         } catch {
-          strapi.log.warn("[hubspot] schéma indisponible — validation ignorée");
+          strapi.log.warn("[hubspot] schema unavailable — validation skipped");
           return next();
         }
-        const problems = mappings.map((m) => checkProperty(schema.properties, m.object, m.property)).filter((reason) => Boolean(reason));
+        const problems = mappings.map((m) => checkMapping(schema.properties, m)).filter((p) => Boolean(p));
         if (problems.length) {
+          const sentences = [...new Set(problems.map(describeProblem))];
           throw new errors.ValidationError(
-            `Mapping HubSpot invalide — ${[...new Set(problems)].join(" ; ")}`
+            `Invalid HubSpot mapping — ${sentences.join("; ")}`,
+            { problems }
           );
         }
         return next();

package/dist/server/src/index.d.ts

@@ -18,6 +18,12 @@ interface ValidateTarget {
     uid: string;
     objectField: string;
     propertyField: string;
+    /**
+     * Repeatable holding the values a field can submit (default `options`), each
+     * `{ value?, label? }`. Checked against enumeration properties: a select whose
+     * choices drifted from HubSpot fails exactly like an unknown property.
+     */
+    optionsField?: string;
 }
 declare const _default: {
     config: {

package/dist/server/src/properties.d.ts

@@ -29,6 +29,13 @@ export interface Schema {
     }[];
     /** Enables deep links into the CRM; derived from the token, never configured. */
     portalId?: number;
+    /**
+     * Region-specific UI host for this portal (`app-eu1.hubspot.com`…). The REST
+     * API is global — `api.hubapi.com` routes by token — but the web app is not,
+     * so a link built on `app.hubspot.com` lands on the wrong host for any portal
+     * hosted outside NA.
+     */
+    uiDomain?: string;
 }
 /**
  * Writable properties of every configured object, cached and de-duplicated
@@ -43,10 +50,41 @@ export declare function loadSchema(strapi: Core.Strapi, apiKey: string, objects:
 }): Promise<Schema>;
 /** Drop the cache — used after the API key or the object list changes. */
 export declare function clearCache(): void;
+/** A mapping the portal would reject, and why. */
+export type Problem = {
+    code: "unknown";
+    property: string;
+    object: string;
+} | {
+    code: "wrong-object";
+    property: string;
+    object: string;
+    actualObject: string;
+} | {
+    code: "whitespace";
+    property: string;
+    object: string;
+} | {
+    code: "bad-option";
+    property: string;
+    object: string;
+    values: string[];
+};
+export interface Mapping {
+    object: string;
+    property: string;
+    /** Values the field can submit — checked against enumeration properties. */
+    values?: string[];
+}
 /**
- * Why a property can't be written, or `null` when it's fine. Returning a reason
- * rather than a boolean lets the caller tell an editor what to fix.
+ * Why a mapping can't be written, or `null` when it's fine.
+ *
+ * Returns a structured code rather than a sentence: the message is rendered by
+ * the caller, so the wording stays in one place and stays translatable. The
+ * codes are also carried in the ValidationError details, for anyone localizing.
  */
-export declare function checkProperty(properties: HsProperty[], object: string, name: string): string | null;
+export declare function checkMapping(properties: HsProperty[], mapping: Mapping): Problem | null;
+/** English rendering of a problem — the package's language. */
+export declare function describeProblem(problem: Problem): string;
 /** Resolve the configured object list, accepting names or full definitions. */
 export declare function resolveObjects(configured: unknown): HsObjectDef[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strapi-plugin-hubspot",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "HubSpot integration for Strapi — pick CRM properties from a searchable list filtered by object, and catch bad mappings before they reach the API.",
   "keywords": [
     "strapi",

package/dist/_chunks/index-DIwNOVQ0.mjs

@@ -1,42 +0,0 @@
-const PLUGIN_ID = "hubspot";
-const index = {
-  register(app) {
-    app.customFields.register({
-      name: "property",
-      pluginId: PLUGIN_ID,
-      type: "string",
-      intlLabel: {
-        id: `${PLUGIN_ID}.property.label`,
-        defaultMessage: "Propriété HubSpot"
-      },
-      intlDescription: {
-        id: `${PLUGIN_ID}.property.description`,
-        defaultMessage: "Choisie dans les propriétés réelles du portail"
-      },
-      components: {
-        Input: async () => import("./HubspotPropertyInput-D0gijgli.mjs")
-      },
-      options: {}
-    });
-    app.createSettingSection(
-      {
-        id: PLUGIN_ID,
-        intlLabel: { id: `${PLUGIN_ID}.settings.section`, defaultMessage: "HubSpot" }
-      },
-      [
-        {
-          intlLabel: { id: `${PLUGIN_ID}.settings.link`, defaultMessage: "Configuration" },
-          id: `${PLUGIN_ID}-settings`,
-          to: `/settings/${PLUGIN_ID}`,
-          permissions: [],
-          Component: async () => (await import("./Settings-DuYUpD8L.mjs")).default
-        }
-      ]
-    );
-    app.registerPlugin({ id: PLUGIN_ID, name: PLUGIN_ID });
-  }
-};
-export {
-  PLUGIN_ID as P,
-  index as i
-};

package/dist/_chunks/index-sOi9wC_y.js

@@ -1,41 +0,0 @@
-"use strict";
-const PLUGIN_ID = "hubspot";
-const index = {
-  register(app) {
-    app.customFields.register({
-      name: "property",
-      pluginId: PLUGIN_ID,
-      type: "string",
-      intlLabel: {
-        id: `${PLUGIN_ID}.property.label`,
-        defaultMessage: "Propriété HubSpot"
-      },
-      intlDescription: {
-        id: `${PLUGIN_ID}.property.description`,
-        defaultMessage: "Choisie dans les propriétés réelles du portail"
-      },
-      components: {
-        Input: async () => Promise.resolve().then(() => require("./HubspotPropertyInput-BcdqfAfv.js"))
-      },
-      options: {}
-    });
-    app.createSettingSection(
-      {
-        id: PLUGIN_ID,
-        intlLabel: { id: `${PLUGIN_ID}.settings.section`, defaultMessage: "HubSpot" }
-      },
-      [
-        {
-          intlLabel: { id: `${PLUGIN_ID}.settings.link`, defaultMessage: "Configuration" },
-          id: `${PLUGIN_ID}-settings`,
-          to: `/settings/${PLUGIN_ID}`,
-          permissions: [],
-          Component: async () => (await Promise.resolve().then(() => require("./Settings-DedA0z6w.js"))).default
-        }
-      ]
-    );
-    app.registerPlugin({ id: PLUGIN_ID, name: PLUGIN_ID });
-  }
-};
-exports.PLUGIN_ID = PLUGIN_ID;
-exports.index = index;