strapi-plugin-hubspot 0.15.0 → 0.16.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## Unreleased
 
+## 0.16.0 — 2026-09-22
+
+### Added — submission policies
+The plugin no longer assumes one HubSpot workflow. **Settings → HubSpot**
+(and `forms.*` in `config/plugins.ts`) now expose three independent choices:
+
+- **`submissionMode`** (`auto` / `forms` / `crm`): native marketing-form
+  conversions when a GUID is linked, CRM upsert only, or automatic.
+- **`writeExtraProperties`** (default `true`): after a Forms API conversion,
+  leftover mapped contact fields still land on the contact via CRM upsert.
+- **`syncFieldsOnPublish`** (default `false`): on publish, PATCH missing
+  mapped contact fields onto the linked HubSpot form. Off so HubSpot-first
+  installs aren't mutated. CRM properties are never created.
+
 ## 0.15.0 — 2026-09-21
 
 ### Added — account settings in the admin

package/README.md

@@ -44,14 +44,25 @@ Permissions**):
 | `GET` | `/api/hubspot/forms/:slug?locale=` | The published form — meta, steps, fields, conditions. The CRM mapping is stripped: the browser never learns your property names |
 | `POST` | `/api/hubspot/forms/:slug/submit` | Validates (bounds, conditions, required), maps server-side, syncs HubSpot, stores the submission |
 
-The submit pipeline, in order: HubSpot **Forms API** (native conversion —
-Original Source, workflows, lead-center notifications) when a marketing form
-GUID is set on the builder form or via `forms.defaultFormId`; the visitor's
-`hutk` is forwarded so attribution sticks. Then the contact is looked up by
-email and, when the address is on a corporate domain, the company is
-found-or-created and associated. A CRM contact upsert is the **fallback**
-when no GUID is configured — it does not count as a form conversion.
-Timeline notes are opt-in and only used on that fallback.
+The submit pipeline is a **policy**, not a single path. Settings → HubSpot
+(or `forms.*` in `config/plugins.ts`) pick how this install talks to HubSpot —
+so a portal that wants native conversions and a portal that only wants CRM
+upserts can share the same plugin:
+
+| Setting | Default | What it does |
+|---|---|---|
+| `forms.submissionMode` | `auto` | `auto`: Forms API when a marketing GUID is linked, else CRM upsert. `forms`: always try the Forms API. `crm`: never count as a conversion |
+| `forms.writeExtraProperties` | `true` | After a conversion, CRM-write mapped contact fields the HubSpot form dropped (they 400 the Forms API) |
+| `forms.syncFieldsOnPublish` | `false` | On publish, PATCH missing mapped **contact** fields onto the HubSpot form. Off by default so HubSpot-first installs aren't mutated |
+
+The visitor's `hutk` is forwarded so attribution sticks. Then the contact is
+looked up by email and, when the address is on a corporate domain, the company
+is found-or-created and associated. Timeline notes are opt-in and only used
+on the CRM-upsert path.
+
+CRM properties are **never created**. Map to properties that already exist in
+the portal; opting into field sync only adds form fields that point at those
+properties.
 
 Portal id, region and form GUIDs are configuration. A test portal today,
 production tomorrow: swap `portalId` / `region` / the GUID, no code change.
@@ -66,6 +77,9 @@ hubspot: {
       companyFromDomain: true, // Company by corporate domain + association
       timelineNote: false,     // recap note on the CRM-upsert fallback only
       defaultFormId: env("HUBSPOT_DEFAULT_FORM_ID", ""),
+      submissionMode: "auto",  // auto | forms | crm
+      writeExtraProperties: true,
+      syncFieldsOnPublish: false,
     },
   },
 }
@@ -365,11 +379,12 @@ its equivalent per object you send to).
 
 ### A settings screen
 
-**Settings → HubSpot** holds the private app token **and** the HubSpot account
-that receives conversions: portal id, region (`eu1` / `na1`), and the default
-marketing form (picked from the connected portal). Values saved here override
-`config/plugins.ts` and env — switching test → production is an admin change,
-not a deploy.
+**Settings → HubSpot** holds the private app token, the HubSpot account that
+receives conversions (portal id, region, default marketing form), **and** the
+submission policy: conversion vs CRM upsert, leftover contact writes, form
+field sync on publish. Values saved here override `config/plugins.ts` and env
+— switching test → production, or switching HubSpot-first ↔ Strapi-first, is
+an admin change, not a deploy.
 
 The token is stored server-side and never returned to the browser: the UI only
 receives whether a key exists, where it comes from, and its last four

package/dist/_chunks/{Forms-B7eIm0Fi.mjs → Forms-6EoEYzAc.mjs}

@@ -5,12 +5,12 @@ import { u as useIntl } from "./index-CEh8vkxY.mjs";
 import { Typography, Flex, Box, SingleSelect, SingleSelectOption, MultiSelect, MultiSelectOption, TextInput, IconButton, Button, Combobox, ComboboxOption, Field, Textarea, Checkbox, Divider, Loader, Badge, Table, Thead, Tr, Th, Tbody, Td, Modal } from "@strapi/design-system";
 import { Trash, Plus, ArrowClockwise, ArrowLeft, Drag, ArrowUp, ArrowDown, List, Duplicate, Download } from "@strapi/icons";
 import { useFetchClient } from "@strapi/strapi/admin";
-import { g as getTranslation, P as PLUGIN_ID } from "./index-BSJAhj8r.mjs";
+import { g as getTranslation, P as PLUGIN_ID } from "./index-7cL9PRh1.mjs";
 import { useSensors, useSensor, PointerSensor, KeyboardSensor, DndContext, closestCenter } from "@dnd-kit/core";
 import { sortableKeyboardCoordinates, SortableContext, verticalListSortingStrategy, useSortable, arrayMove } from "@dnd-kit/sortable";
 import { CSS } from "@dnd-kit/utilities";
-import { o as objectLabel } from "./objectLabels-CrYRzsqe.mjs";
-import { u as useHubspotSchema } from "./useHubspotSchema-CBF4GkmK.mjs";
+import { o as objectLabel } from "./objectLabels-Dnj14fsp.mjs";
+import { u as useHubspotSchema } from "./useHubspotSchema-BsmQgJgx.mjs";
 const OPERATORS = [
   "eq",
   "neq",
@@ -774,11 +774,32 @@ const FormEditor = () => {
     setBusy(true);
     setFeedback(null);
     try {
-      await post(`/${PLUGIN_ID}/builder/forms/${documentId}/publish${query}`);
+      const { data } = await post(`/${PLUGIN_ID}/builder/forms/${documentId}/publish${query}`);
       setPublished(true);
       setErrors([]);
       setProblems([]);
-      setFeedback({ tone: "success", text: t("editor.published", "Form published.") });
+      const added = Array.isArray(data?.addedFields) ? data.addedFields.length : 0;
+      if (data?.syncWarning) {
+        setFeedback({
+          tone: "success",
+          text: t(
+            "editor.published-sync-warn",
+            "Form published. HubSpot field sync failed: {error}",
+            { error: data.syncWarning }
+          )
+        });
+      } else if (added) {
+        setFeedback({
+          tone: "success",
+          text: t(
+            "editor.published-synced",
+            "Form published. {count, plural, one {# field added} other {# fields added}} to the HubSpot form.",
+            { count: added }
+          )
+        });
+      } else {
+        setFeedback({ tone: "success", text: t("editor.published", "Form published.") });
+      }
     } catch (err) {
       const data = err.response?.data;
       setErrors(data?.errors ?? []);

package/dist/_chunks/{Forms-ClyI4MJ1.js → Forms-BW_zGc1P.js}

@@ -7,12 +7,12 @@ const index = require("./index-DkTxsEqL.js");
 const designSystem = require("@strapi/design-system");
 const icons = require("@strapi/icons");
 const admin = require("@strapi/strapi/admin");
-const index$1 = require("./index-BpcilDy1.js");
+const index$1 = require("./index-CodpLKZx.js");
 const core = require("@dnd-kit/core");
 const sortable = require("@dnd-kit/sortable");
 const utilities = require("@dnd-kit/utilities");
-const objectLabels = require("./objectLabels-CYXXFpNB.js");
-const useHubspotSchema = require("./useHubspotSchema-Ba6xZUCL.js");
+const objectLabels = require("./objectLabels-CSWGIgNb.js");
+const useHubspotSchema = require("./useHubspotSchema-DiRN3HrN.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
@@ -794,11 +794,32 @@ const FormEditor = () => {
     setBusy(true);
     setFeedback(null);
     try {
-      await post(`/${index$1.PLUGIN_ID}/builder/forms/${documentId}/publish${query}`);
+      const { data } = await post(`/${index$1.PLUGIN_ID}/builder/forms/${documentId}/publish${query}`);
       setPublished(true);
       setErrors([]);
       setProblems([]);
-      setFeedback({ tone: "success", text: t("editor.published", "Form published.") });
+      const added = Array.isArray(data?.addedFields) ? data.addedFields.length : 0;
+      if (data?.syncWarning) {
+        setFeedback({
+          tone: "success",
+          text: t(
+            "editor.published-sync-warn",
+            "Form published. HubSpot field sync failed: {error}",
+            { error: data.syncWarning }
+          )
+        });
+      } else if (added) {
+        setFeedback({
+          tone: "success",
+          text: t(
+            "editor.published-synced",
+            "Form published. {count, plural, one {# field added} other {# fields added}} to the HubSpot form.",
+            { count: added }
+          )
+        });
+      } else {
+        setFeedback({ tone: "success", text: t("editor.published", "Form published.") });
+      }
     } catch (err) {
       const data = err.response?.data;
       setErrors(data?.errors ?? []);

package/dist/_chunks/{HubspotFormInput-cZAiaAaq.mjs → HubspotFormInput-V5w4y1fb.mjs}

@@ -3,7 +3,7 @@ import * as React from "react";
 import { u as useIntl } from "./index-CEh8vkxY.mjs";
 import { Field, Flex, Loader, Combobox, ComboboxOption } from "@strapi/design-system";
 import { useFetchClient } from "@strapi/strapi/admin";
-import { P as PLUGIN_ID, g as getTranslation } from "./index-BSJAhj8r.mjs";
+import { P as PLUGIN_ID, g as getTranslation } from "./index-7cL9PRh1.mjs";
 const HubspotFormInput = React.forwardRef(
   ({ name, value, onChange, disabled, error, required, label, hint, labelAction }, ref) => {
     const { formatMessage } = useIntl();

package/dist/_chunks/{HubspotFormInput-Do7F83V6.js → HubspotFormInput-oMhm1UJm.js}

@@ -5,7 +5,7 @@ const React = require("react");
 const index = require("./index-DkTxsEqL.js");
 const designSystem = require("@strapi/design-system");
 const admin = require("@strapi/strapi/admin");
-const index$1 = require("./index-BpcilDy1.js");
+const index$1 = require("./index-CodpLKZx.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });

package/dist/_chunks/{HubspotObjectInput-DWqk2C26.js → HubspotObjectInput-Bmo6YQgs.js}

@@ -4,9 +4,9 @@ const jsxRuntime = require("react/jsx-runtime");
 const React = require("react");
 const index = require("./index-DkTxsEqL.js");
 const designSystem = require("@strapi/design-system");
-const index$1 = require("./index-BpcilDy1.js");
-const objectLabels = require("./objectLabels-CYXXFpNB.js");
-const useHubspotSchema = require("./useHubspotSchema-Ba6xZUCL.js");
+const index$1 = require("./index-CodpLKZx.js");
+const objectLabels = require("./objectLabels-CSWGIgNb.js");
+const useHubspotSchema = require("./useHubspotSchema-DiRN3HrN.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });

package/dist/_chunks/{HubspotObjectInput-ZZk_7hWq.mjs → HubspotObjectInput-DhsnSguG.mjs}

@@ -2,9 +2,9 @@ import { jsxs, jsx } from "react/jsx-runtime";
 import * as React from "react";
 import { u as useIntl } from "./index-CEh8vkxY.mjs";
 import { Field, Flex, Loader, SingleSelect, SingleSelectOption } from "@strapi/design-system";
-import { g as getTranslation } from "./index-BSJAhj8r.mjs";
-import { o as objectLabel } from "./objectLabels-CrYRzsqe.mjs";
-import { u as useHubspotSchema } from "./useHubspotSchema-CBF4GkmK.mjs";
+import { g as getTranslation } from "./index-7cL9PRh1.mjs";
+import { o as objectLabel } from "./objectLabels-Dnj14fsp.mjs";
+import { u as useHubspotSchema } from "./useHubspotSchema-BsmQgJgx.mjs";
 const HubspotObjectInput = React.forwardRef(
   ({ name, value, onChange, disabled, error, required, label, hint, labelAction }, ref) => {
     const intl = useIntl();

package/dist/_chunks/{HubspotPropertyInput-5bkDGmGo.mjs → HubspotPropertyInput-CrYP4pc0.mjs}

@@ -4,9 +4,9 @@ import { u as useIntl } from "./index-CEh8vkxY.mjs";
 import { Field, Flex, Loader, Combobox, ComboboxOption, IconButton, Button, Typography, Link } from "@strapi/design-system";
 import { ArrowClockwise } from "@strapi/icons";
 import { useField } from "@strapi/strapi/admin";
-import { g as getTranslation } from "./index-BSJAhj8r.mjs";
-import { o as objectLabel } from "./objectLabels-CrYRzsqe.mjs";
-import { u as useHubspotSchema } from "./useHubspotSchema-CBF4GkmK.mjs";
+import { g as getTranslation } from "./index-7cL9PRh1.mjs";
+import { o as objectLabel } from "./objectLabels-Dnj14fsp.mjs";
+import { u as useHubspotSchema } from "./useHubspotSchema-BsmQgJgx.mjs";
 const oneLine = {
   display: "block",
   whiteSpace: "nowrap",

package/dist/_chunks/{HubspotPropertyInput-v9B3wb1a.js → HubspotPropertyInput-luFfnxqy.js}

@@ -6,9 +6,9 @@ const index = require("./index-DkTxsEqL.js");
 const designSystem = require("@strapi/design-system");
 const icons = require("@strapi/icons");
 const admin = require("@strapi/strapi/admin");
-const index$1 = require("./index-BpcilDy1.js");
-const objectLabels = require("./objectLabels-CYXXFpNB.js");
-const useHubspotSchema = require("./useHubspotSchema-Ba6xZUCL.js");
+const index$1 = require("./index-CodpLKZx.js");
+const objectLabels = require("./objectLabels-CSWGIgNb.js");
+const useHubspotSchema = require("./useHubspotSchema-DiRN3HrN.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });

package/dist/_chunks/{Settings-X3EHnTaO.js → Settings-B3A22i7Z.js}

@@ -5,9 +5,9 @@ const React = require("react");
 const index = require("./index-DkTxsEqL.js");
 const designSystem = require("@strapi/design-system");
 const admin = require("@strapi/strapi/admin");
-const index$1 = require("./index-BpcilDy1.js");
+const index$1 = require("./index-CodpLKZx.js");
 const reactRouterDom = require("react-router-dom");
-const objectLabels = require("./objectLabels-CYXXFpNB.js");
+const objectLabels = require("./objectLabels-CSWGIgNb.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
@@ -201,6 +201,9 @@ const HubspotSettings = () => {
   const [portalId, setPortalId] = React__namespace.useState("");
   const [region, setRegion] = React__namespace.useState("eu1");
   const [defaultFormId, setDefaultFormId] = React__namespace.useState("");
+  const [submissionMode, setSubmissionMode] = React__namespace.useState("auto");
+  const [writeExtraProperties, setWriteExtraProperties] = React__namespace.useState(true);
+  const [syncFieldsOnPublish, setSyncFieldsOnPublish] = React__namespace.useState(false);
   const [forms, setForms] = React__namespace.useState([]);
   const [busy, setBusy] = React__namespace.useState(false);
   const [feedback, setFeedback] = React__namespace.useState(
@@ -212,6 +215,9 @@ const HubspotSettings = () => {
     setPortalId(data.portalId ?? "");
     setRegion(data.region || "eu1");
     setDefaultFormId(data.defaultFormId ?? "");
+    setSubmissionMode(data.submissionMode === "crm" || data.submissionMode === "forms" ? data.submissionMode : "auto");
+    setWriteExtraProperties(data.writeExtraProperties !== false);
+    setSyncFieldsOnPublish(data.syncFieldsOnPublish === true);
     setForms(Array.isArray(data.forms) ? data.forms : []);
   };
   const load = React__namespace.useCallback(async () => {
@@ -231,7 +237,10 @@ const HubspotSettings = () => {
         ...apiKey.trim() ? { apiKey: apiKey.trim() } : {},
         portalId,
         region,
-        defaultFormId
+        defaultFormId,
+        submissionMode,
+        writeExtraProperties,
+        syncFieldsOnPublish
       });
       setApiKey("");
       await load();
@@ -401,7 +410,71 @@ const HubspotSettings = () => {
             sourceHint(settings.formSource)
           ]
         }
-      )
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "delta", children: t("settings.policy.title", "How submissions reach HubSpot") }),
+      /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "pi", textColor: "neutral600", children: t(
+        "settings.policy.hint",
+        "Pick the policy that matches this portal. Defaults stay safe for every install: conversions when a form is linked, leftover answers still written on the contact, HubSpot forms never mutated unless you ask."
+      ) }),
+      /* @__PURE__ */ jsxRuntime.jsxs(
+        designSystem.Field.Root,
+        {
+          name: "submissionMode",
+          hint: t(
+            "settings.mode.hint",
+            "Automatic uses the marketing form when one is linked, otherwise a CRM upsert. CRM-only never counts as a conversion. Forms-only prefers the Forms API and falls back to the CRM if HubSpot refuses the submit."
+          ),
+          children: [
+            /* @__PURE__ */ jsxRuntime.jsx(designSystem.Field.Label, { children: t("settings.mode.label", "Submission path") }),
+            /* @__PURE__ */ jsxRuntime.jsxs(
+              designSystem.SingleSelect,
+              {
+                value: submissionMode,
+                onChange: (value) => {
+                  const next = String(value);
+                  if (next === "crm" || next === "forms" || next === "auto") setSubmissionMode(next);
+                },
+                children: [
+                  /* @__PURE__ */ jsxRuntime.jsx(designSystem.SingleSelectOption, { value: "auto", children: t("settings.mode.auto", "Automatic — form conversion if linked, else CRM") }),
+                  /* @__PURE__ */ jsxRuntime.jsx(designSystem.SingleSelectOption, { value: "forms", children: t("settings.mode.forms", "Marketing form — native HubSpot conversions") }),
+                  /* @__PURE__ */ jsxRuntime.jsx(designSystem.SingleSelectOption, { value: "crm", children: t("settings.mode.crm", "CRM only — upsert the contact, no form conversion") })
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsxRuntime.jsx(designSystem.Field.Hint, {})
+          ]
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        designSystem.Checkbox,
+        {
+          checked: writeExtraProperties,
+          onCheckedChange: (checked) => setWriteExtraProperties(checked === true),
+          children: t(
+            "settings.extra.label",
+            "After a conversion, also write mapped contact fields that the HubSpot form doesn't have"
+          )
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "pi", textColor: "neutral600", children: t(
+        "settings.extra.hint",
+        "The Forms API drops unknown fields (they 400 the submit). With this on, leftovers still land on the contact. Turn it off if HubSpot must only receive what the marketing form declares."
+      ) }),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        designSystem.Checkbox,
+        {
+          checked: syncFieldsOnPublish,
+          onCheckedChange: (checked) => setSyncFieldsOnPublish(checked === true),
+          children: t(
+            "settings.sync.label",
+            "On publish, add mapped contact fields that are missing on the HubSpot form"
+          )
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx(designSystem.Typography, { variant: "pi", textColor: "neutral600", children: t(
+        "settings.sync.hint",
+        "Strapi-first installs: a field added here appears on the HubSpot form next publish. HubSpot-first installs should leave this off — importing a form already carries its fields. Properties themselves are never created; map to ones that exist in the portal."
+      ) })
     ] }) }),
     /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Flex, { gap: 2, children: [
       /* @__PURE__ */ jsxRuntime.jsx(designSystem.Button, { onClick: save, loading: busy, children: t("settings.save", "Save") }),

package/dist/_chunks/{Settings-QcFbm3s5.mjs → Settings-CjcWj9I6.mjs}

@@ -1,11 +1,11 @@
 import { jsxs, jsx } from "react/jsx-runtime";
 import * as React from "react";
 import { u as useIntl } from "./index-CEh8vkxY.mjs";
-import { Flex, Divider, Typography, Button, Box, Link, Badge, Loader, Field, SingleSelect, SingleSelectOption } from "@strapi/design-system";
+import { Flex, Divider, Typography, Button, Box, Link, Badge, Loader, Field, SingleSelect, SingleSelectOption, Checkbox } from "@strapi/design-system";
 import { useFetchClient } from "@strapi/strapi/admin";
-import { g as getTranslation, P as PLUGIN_ID } from "./index-BSJAhj8r.mjs";
+import { g as getTranslation, P as PLUGIN_ID } from "./index-7cL9PRh1.mjs";
 import { Link as Link$1 } from "react-router-dom";
-import { o as objectLabel } from "./objectLabels-CrYRzsqe.mjs";
+import { o as objectLabel } from "./objectLabels-Dnj14fsp.mjs";
 const AuditSection = ({ configured }) => {
   const intl = useIntl();
   const { formatMessage } = intl;
@@ -181,6 +181,9 @@ const HubspotSettings = () => {
   const [portalId, setPortalId] = React.useState("");
   const [region, setRegion] = React.useState("eu1");
   const [defaultFormId, setDefaultFormId] = React.useState("");
+  const [submissionMode, setSubmissionMode] = React.useState("auto");
+  const [writeExtraProperties, setWriteExtraProperties] = React.useState(true);
+  const [syncFieldsOnPublish, setSyncFieldsOnPublish] = React.useState(false);
   const [forms, setForms] = React.useState([]);
   const [busy, setBusy] = React.useState(false);
   const [feedback, setFeedback] = React.useState(
@@ -192,6 +195,9 @@ const HubspotSettings = () => {
     setPortalId(data.portalId ?? "");
     setRegion(data.region || "eu1");
     setDefaultFormId(data.defaultFormId ?? "");
+    setSubmissionMode(data.submissionMode === "crm" || data.submissionMode === "forms" ? data.submissionMode : "auto");
+    setWriteExtraProperties(data.writeExtraProperties !== false);
+    setSyncFieldsOnPublish(data.syncFieldsOnPublish === true);
     setForms(Array.isArray(data.forms) ? data.forms : []);
   };
   const load = React.useCallback(async () => {
@@ -211,7 +217,10 @@ const HubspotSettings = () => {
         ...apiKey.trim() ? { apiKey: apiKey.trim() } : {},
         portalId,
         region,
-        defaultFormId
+        defaultFormId,
+        submissionMode,
+        writeExtraProperties,
+        syncFieldsOnPublish
       });
       setApiKey("");
       await load();
@@ -381,7 +390,71 @@ const HubspotSettings = () => {
             sourceHint(settings.formSource)
           ]
         }
-      )
+      ),
+      /* @__PURE__ */ jsx(Typography, { variant: "delta", children: t("settings.policy.title", "How submissions reach HubSpot") }),
+      /* @__PURE__ */ jsx(Typography, { variant: "pi", textColor: "neutral600", children: t(
+        "settings.policy.hint",
+        "Pick the policy that matches this portal. Defaults stay safe for every install: conversions when a form is linked, leftover answers still written on the contact, HubSpot forms never mutated unless you ask."
+      ) }),
+      /* @__PURE__ */ jsxs(
+        Field.Root,
+        {
+          name: "submissionMode",
+          hint: t(
+            "settings.mode.hint",
+            "Automatic uses the marketing form when one is linked, otherwise a CRM upsert. CRM-only never counts as a conversion. Forms-only prefers the Forms API and falls back to the CRM if HubSpot refuses the submit."
+          ),
+          children: [
+            /* @__PURE__ */ jsx(Field.Label, { children: t("settings.mode.label", "Submission path") }),
+            /* @__PURE__ */ jsxs(
+              SingleSelect,
+              {
+                value: submissionMode,
+                onChange: (value) => {
+                  const next = String(value);
+                  if (next === "crm" || next === "forms" || next === "auto") setSubmissionMode(next);
+                },
+                children: [
+                  /* @__PURE__ */ jsx(SingleSelectOption, { value: "auto", children: t("settings.mode.auto", "Automatic — form conversion if linked, else CRM") }),
+                  /* @__PURE__ */ jsx(SingleSelectOption, { value: "forms", children: t("settings.mode.forms", "Marketing form — native HubSpot conversions") }),
+                  /* @__PURE__ */ jsx(SingleSelectOption, { value: "crm", children: t("settings.mode.crm", "CRM only — upsert the contact, no form conversion") })
+                ]
+              }
+            ),
+            /* @__PURE__ */ jsx(Field.Hint, {})
+          ]
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        Checkbox,
+        {
+          checked: writeExtraProperties,
+          onCheckedChange: (checked) => setWriteExtraProperties(checked === true),
+          children: t(
+            "settings.extra.label",
+            "After a conversion, also write mapped contact fields that the HubSpot form doesn't have"
+          )
+        }
+      ),
+      /* @__PURE__ */ jsx(Typography, { variant: "pi", textColor: "neutral600", children: t(
+        "settings.extra.hint",
+        "The Forms API drops unknown fields (they 400 the submit). With this on, leftovers still land on the contact. Turn it off if HubSpot must only receive what the marketing form declares."
+      ) }),
+      /* @__PURE__ */ jsx(
+        Checkbox,
+        {
+          checked: syncFieldsOnPublish,
+          onCheckedChange: (checked) => setSyncFieldsOnPublish(checked === true),
+          children: t(
+            "settings.sync.label",
+            "On publish, add mapped contact fields that are missing on the HubSpot form"
+          )
+        }
+      ),
+      /* @__PURE__ */ jsx(Typography, { variant: "pi", textColor: "neutral600", children: t(
+        "settings.sync.hint",
+        "Strapi-first installs: a field added here appears on the HubSpot form next publish. HubSpot-first installs should leave this off — importing a form already carries its fields. Properties themselves are never created; map to ones that exist in the portal."
+      ) })
     ] }) }),
     /* @__PURE__ */ jsxs(Flex, { gap: 2, children: [
       /* @__PURE__ */ jsx(Button, { onClick: save, loading: busy, children: t("settings.save", "Save") }),

package/dist/_chunks/{en-ZHvaZLi7.js → en-C7ls2EUl.js}

@@ -30,7 +30,18 @@ const en = {
   "picker.refresh": "Refresh the properties from HubSpot",
   "picker.import": "Import the {count} options from HubSpot",
   "picker.imported": "Options imported — save to keep them.",
-  "settings.subtitle": "Private app token and the HubSpot account that receives form conversions. Switch test → production here — nothing is hardcoded.",
+  "settings.subtitle": "Private app token, HubSpot account, and how submissions reach the CRM. Switch test → production here — nothing is hardcoded.",
+  "settings.policy.title": "How submissions reach HubSpot",
+  "settings.policy.hint": "Pick the policy that matches this portal. Defaults stay safe for every install: conversions when a form is linked, leftover answers still written on the contact, HubSpot forms never mutated unless you ask.",
+  "settings.mode.label": "Submission path",
+  "settings.mode.hint": "Automatic uses the marketing form when one is linked, otherwise a CRM upsert. CRM-only never counts as a conversion. Forms-only prefers the Forms API and falls back to the CRM if HubSpot refuses the submit.",
+  "settings.mode.auto": "Automatic — form conversion if linked, else CRM",
+  "settings.mode.forms": "Marketing form — native HubSpot conversions",
+  "settings.mode.crm": "CRM only — upsert the contact, no form conversion",
+  "settings.extra.label": "After a conversion, also write mapped contact fields that the HubSpot form doesn't have",
+  "settings.extra.hint": "The Forms API drops unknown fields (they 400 the submit). With this on, leftovers still land on the contact. Turn it off if HubSpot must only receive what the marketing form declares.",
+  "settings.sync.label": "On publish, add mapped contact fields that are missing on the HubSpot form",
+  "settings.sync.hint": "Strapi-first installs: a field added here appears on the HubSpot form next publish. HubSpot-first installs should leave this off — importing a form already carries its fields. Properties themselves are never created; map to ones that exist in the portal.",
   "settings.configured": "Configured {hint}",
   "settings.not-configured": "Not configured",
   "settings.source": "source: {source}",
@@ -62,7 +73,7 @@ const en = {
   "settings.test-ok": "Connection established — {count} readable properties.",
   "settings.test-no-key": "No key configured.",
   "settings.test-error": "HubSpot unreachable — invalid or revoked key?",
-  "settings.scopes": "The token needs crm.schemas.contacts.read, crm.schemas.companies.read and forms (to list and submit marketing forms). The token is never returned to the browser.",
+  "settings.scopes": "The token needs crm.schemas.contacts.read, crm.schemas.companies.read and forms (to list, submit, and optionally update marketing forms). The token is never returned to the browser.",
   "audit.title": "Mapping audit",
   "audit.subtitle": "Scans every entry of the validated content types and lists the mappings the portal would reject today — including properties deleted in HubSpot since they were saved.",
   "audit.run": "Run the audit",
@@ -122,6 +133,8 @@ const en = {
   "editor.invalid": "The structure has problems — see the flagged cards.",
   "editor.publish": "Publish",
   "editor.published": "Form published.",
+  "editor.published-synced": "Form published. {count, plural, one {# field added} other {# fields added}} to the HubSpot form.",
+  "editor.published-sync-warn": "Form published. HubSpot field sync failed: {error}",
   "editor.publish-blocked": "Publishing is blocked — fix the flagged mappings first.",
   "editor.unpublish": "Unpublish",
   "editor.unpublished": "Form unpublished.",

package/dist/_chunks/{en-DMJeF7EN.mjs → en-D6GHgMOt.mjs}

@@ -28,7 +28,18 @@ const en = {
   "picker.refresh": "Refresh the properties from HubSpot",
   "picker.import": "Import the {count} options from HubSpot",
   "picker.imported": "Options imported — save to keep them.",
-  "settings.subtitle": "Private app token and the HubSpot account that receives form conversions. Switch test → production here — nothing is hardcoded.",
+  "settings.subtitle": "Private app token, HubSpot account, and how submissions reach the CRM. Switch test → production here — nothing is hardcoded.",
+  "settings.policy.title": "How submissions reach HubSpot",
+  "settings.policy.hint": "Pick the policy that matches this portal. Defaults stay safe for every install: conversions when a form is linked, leftover answers still written on the contact, HubSpot forms never mutated unless you ask.",
+  "settings.mode.label": "Submission path",
+  "settings.mode.hint": "Automatic uses the marketing form when one is linked, otherwise a CRM upsert. CRM-only never counts as a conversion. Forms-only prefers the Forms API and falls back to the CRM if HubSpot refuses the submit.",
+  "settings.mode.auto": "Automatic — form conversion if linked, else CRM",
+  "settings.mode.forms": "Marketing form — native HubSpot conversions",
+  "settings.mode.crm": "CRM only — upsert the contact, no form conversion",
+  "settings.extra.label": "After a conversion, also write mapped contact fields that the HubSpot form doesn't have",
+  "settings.extra.hint": "The Forms API drops unknown fields (they 400 the submit). With this on, leftovers still land on the contact. Turn it off if HubSpot must only receive what the marketing form declares.",
+  "settings.sync.label": "On publish, add mapped contact fields that are missing on the HubSpot form",
+  "settings.sync.hint": "Strapi-first installs: a field added here appears on the HubSpot form next publish. HubSpot-first installs should leave this off — importing a form already carries its fields. Properties themselves are never created; map to ones that exist in the portal.",
   "settings.configured": "Configured {hint}",
   "settings.not-configured": "Not configured",
   "settings.source": "source: {source}",
@@ -60,7 +71,7 @@ const en = {
   "settings.test-ok": "Connection established — {count} readable properties.",
   "settings.test-no-key": "No key configured.",
   "settings.test-error": "HubSpot unreachable — invalid or revoked key?",
-  "settings.scopes": "The token needs crm.schemas.contacts.read, crm.schemas.companies.read and forms (to list and submit marketing forms). The token is never returned to the browser.",
+  "settings.scopes": "The token needs crm.schemas.contacts.read, crm.schemas.companies.read and forms (to list, submit, and optionally update marketing forms). The token is never returned to the browser.",
   "audit.title": "Mapping audit",
   "audit.subtitle": "Scans every entry of the validated content types and lists the mappings the portal would reject today — including properties deleted in HubSpot since they were saved.",
   "audit.run": "Run the audit",
@@ -120,6 +131,8 @@ const en = {
   "editor.invalid": "The structure has problems — see the flagged cards.",
   "editor.publish": "Publish",
   "editor.published": "Form published.",
+  "editor.published-synced": "Form published. {count, plural, one {# field added} other {# fields added}} to the HubSpot form.",
+  "editor.published-sync-warn": "Form published. HubSpot field sync failed: {error}",
   "editor.publish-blocked": "Publishing is blocked — fix the flagged mappings first.",
   "editor.unpublish": "Unpublish",
   "editor.unpublished": "Form unpublished.",

package/dist/_chunks/{fr-CVAntLmc.mjs → fr-CfohMY8n.mjs}

@@ -28,7 +28,18 @@ const fr = {
   "picker.refresh": "Rafraîchir les propriétés depuis HubSpot",
   "picker.import": "Importer les {count} options depuis HubSpot",
   "picker.imported": "Options importées — enregistrez pour les conserver.",
-  "settings.subtitle": "Jeton d'application privée et compte HubSpot qui reçoit les conversions. Passez du test à la prod ici — rien n'est figé dans le code.",
+  "settings.subtitle": "Jeton d'application privée, compte HubSpot, et la façon dont les envois atteignent le CRM. Passez du test à la prod ici — rien n'est figé dans le code.",
+  "settings.policy.title": "Comment les envois atteignent HubSpot",
+  "settings.policy.hint": "Choisissez la politique de ce portail. Les défauts restent sûrs pour toute install : conversion si un formulaire est lié, réponses en trop écrites sur le contact, formulaires HubSpot jamais mutés sauf si vous le demandez.",
+  "settings.mode.label": "Chemin d'envoi",
+  "settings.mode.hint": "Automatique utilise le formulaire marketing s'il est lié, sinon un upsert CRM. CRM seul ne compte jamais comme conversion. Formulaire marketing privilégie l'API Forms et retombe sur le CRM si HubSpot refuse l'envoi.",
+  "settings.mode.auto": "Automatique — conversion si un formulaire est lié, sinon CRM",
+  "settings.mode.forms": "Formulaire marketing — conversions HubSpot natives",
+  "settings.mode.crm": "CRM uniquement — upsert du contact, pas de conversion",
+  "settings.extra.label": "Après une conversion, écrire aussi sur le contact les champs mappés absents du formulaire HubSpot",
+  "settings.extra.hint": "L'API Forms écarte les champs inconnus (ils font échouer tout l'envoi). Activé, les champs restants atterrissent quand même sur le contact. Désactivez si HubSpot ne doit recevoir que ce que le formulaire marketing déclare.",
+  "settings.sync.label": "À la publication, ajouter au formulaire HubSpot les champs mappés manquants",
+  "settings.sync.hint": "Install Strapi-first : un champ ajouté ici apparaît sur le formulaire HubSpot à la publication suivante. Install HubSpot-first : laissez désactivé — l'import porte déjà les champs. Les propriétés CRM ne sont jamais créées ; mappez vers des propriétés déjà présentes dans le portail.",
   "settings.configured": "Configurée {hint}",
   "settings.not-configured": "Non configurée",
   "settings.source": "source : {source}",
@@ -60,7 +71,7 @@ const fr = {
   "settings.test-ok": "Connexion établie — {count} propriétés lisibles.",
   "settings.test-no-key": "Aucune clé configurée.",
   "settings.test-error": "HubSpot injoignable — clé invalide ou révoquée ?",
-  "settings.scopes": "Le jeton a besoin de crm.schemas.contacts.read, crm.schemas.companies.read et forms (lister et soumettre les formulaires marketing). Il n'est jamais renvoyé au navigateur.",
+  "settings.scopes": "Le jeton a besoin de crm.schemas.contacts.read, crm.schemas.companies.read et forms (lister, soumettre et éventuellement mettre à jour les formulaires marketing). Il n'est jamais renvoyé au navigateur.",
   "audit.title": "Audit des mappings",
   "audit.subtitle": "Parcourt toutes les entrées des content-types validés et liste les mappings que le portail refuserait aujourd'hui — y compris les propriétés supprimées dans HubSpot depuis leur enregistrement.",
   "audit.run": "Lancer l'audit",
@@ -120,6 +131,8 @@ const fr = {
   "editor.invalid": "La structure a des problèmes — voir les cartes signalées.",
   "editor.publish": "Publier",
   "editor.published": "Formulaire publié.",
+  "editor.published-synced": "Formulaire publié. {count, plural, one {# champ ajouté} other {# champs ajoutés}} au formulaire HubSpot.",
+  "editor.published-sync-warn": "Formulaire publié. La sync des champs HubSpot a échoué : {error}",
   "editor.publish-blocked": "Publication bloquée — corrigez d'abord les mappings signalés.",
   "editor.unpublish": "Dépublier",
   "editor.unpublished": "Formulaire dépublié.",