strapi-plugin-hubspot 0.15.0 → 0.16.1

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

@@ -0,0 +1,37 @@
+/**
+ * Policy helpers for HubSpot form field sync and leftover CRM writes.
+ *
+ * Two independent user wills, neither assumed:
+ *  - Strapi-first: mapped contact fields missing on the HubSpot form can be
+ *    PATCHed onto it at publish time (opt-in).
+ *  - HubSpot-first: extras must not 400 the Forms API submit, but they can
+ *    still land on the contact via a CRM upsert of the leftovers.
+ *
+ * CRM properties are never created here — the picker only maps to ones that
+ * already exist on the portal.
+ */
+import type { FormDefinition } from "./conditions";
+export interface MappedFormField {
+    name: string;
+    label?: string;
+    type: string;
+    required?: boolean;
+    object?: string;
+    property: string;
+    options?: {
+        value?: string;
+        label?: string;
+    }[];
+}
+export declare function leftoverContactProps(contact: Record<string, string>, sentFieldNames: Iterable<string>): Record<string, string>;
+export declare function mappedContactFields(definition: FormDefinition): MappedFormField[];
+export declare function missingMappedFields(definition: FormDefinition, existingNames: Iterable<string>): MappedFormField[];
+export declare function hsFieldType(type: string, options?: unknown[]): string;
+export declare function toHsFormField(field: MappedFormField): Record<string, unknown>;
+export interface RawFieldGroupLike {
+    groupType?: string;
+    richTextType?: string;
+    richText?: string;
+    fields?: unknown[];
+}
+export declare function appendFieldGroups(existing: RawFieldGroupLike[], extra: MappedFormField[]): Record<string, unknown>[];

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

@@ -2,14 +2,12 @@
  * The form-builder server side: shaping a published form for the public API,
  * and turning a submission into a HubSpot marketing-form conversion.
  *
- * The pipeline: post the answers to HubSpot's Forms API (native conversion,
- * workflows, original source, lead-center notifications) with the visitor's
- * `hutk`; look the contact back up by email; when the email is on a corporate
- * domain the company is found-or-created by `domain` and associated. A CRM
- * contact upsert is the fallback when no form GUID is configured — it does
- * not count as a form conversion. Timeline notes are opt-in and only used
- * on that fallback. Company sync is best-effort; the form submission is
- * the lead.
+ * The pipeline is a policy the install picks in Settings: native Forms API
+ * conversion (with leftover CRM writes for mapped fields the HubSpot form
+ * dropped), CRM upsert only, or automatic (Forms API when a GUID is linked).
+ * Company find-or-create still runs after a successful submit. Timeline notes
+ * are opt-in and only used on the CRM-upsert path. The form submission is
+ * the lead — a CRM outage never loses it.
  */
 import type { Core } from "@strapi/strapi";
 import { type FormDefinition, type Primitive } from "./conditions";

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

@@ -10,6 +10,7 @@
  * Portal id, region and form GUIDs are configuration — a test portal today,
  * production tomorrow, no code change.
  */
+import type { FormDefinition } from "./conditions";
 export declare function isFormGuid(value: string): boolean;
 export declare function sanitizeHutk(value: unknown): string | undefined;
 export declare function sanitizePortalId(value: unknown): string | undefined;
@@ -58,6 +59,7 @@ export interface FormSubmitInput {
     };
     formHasLegalConsent?: boolean;
 }
+export declare function clearFormShapeCache(formGuid?: string): void;
 export declare function loadFormShape(apiKey: string, formGuid: string): Promise<{
     names: Set<string>;
     hasLegalConsent: boolean;
@@ -73,3 +75,9 @@ export declare function submitMarketingForm(input: FormSubmitInput): Promise<{
     status: number;
     error?: string;
 }>;
+/**
+ * Opt-in: add mapped contact fields that the HubSpot form doesn't already
+ * declare. Never creates CRM properties — only form fields pointing at ones
+ * that already exist. Returns the property names that were added.
+ */
+export declare function syncFieldsToHubspotForm(apiKey: string, formGuid: string, definition: FormDefinition): Promise<string[]>;

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

@@ -83,4 +83,8 @@ export declare function convertHubspotForm(raw: RawHubspotForm): ConvertedHubspo
 export declare function listHubspotForms(apiKey: string): Promise<HubspotFormSummary[]>;
 /** One form, full definition. */
 export declare function fetchHubspotForm(apiKey: string, formId: string): Promise<RawHubspotForm>;
+/** Replace `fieldGroups` (HubSpot PATCH is a full replacement of that array). */
+export declare function patchHubspotForm(apiKey: string, formId: string, body: {
+    fieldGroups: unknown[];
+}): Promise<RawHubspotForm>;
 export {};

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

@@ -13,6 +13,9 @@ declare const _default: {
                 companyFromDomain: boolean;
                 timelineNote: boolean;
                 defaultFormId: string;
+                submissionMode: "auto" | "crm" | "forms";
+                writeExtraProperties: boolean;
+                syncFieldsOnPublish: boolean;
                 rateLimit: {
                     submitPerMinute: number;
                     searchPerMinute: number;
@@ -364,6 +367,9 @@ declare const _default: {
                         portalId?: string;
                         region?: string;
                         defaultFormId?: string;
+                        submissionMode?: string;
+                        writeExtraProperties?: boolean;
+                        syncFieldsOnPublish?: boolean;
                     };
                 };
                 body: unknown;

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

@@ -15,11 +15,23 @@ export declare const ENV_PORTAL = "HUBSPOT_PORTAL_ID";
 export declare const ENV_REGION = "HUBSPOT_REGION";
 export declare const ENV_DEFAULT_FORM = "HUBSPOT_DEFAULT_FORM_ID";
 export type SettingSource = "settings" | "config" | "env" | null;
+export type SubmissionMode = "auto" | "crm" | "forms";
 export interface StoredSettings {
     apiKey?: string;
     portalId?: string;
     region?: string;
     defaultFormId?: string;
+    submissionMode?: SubmissionMode;
+    writeExtraProperties?: boolean;
+    syncFieldsOnPublish?: boolean;
+}
+export interface HubspotPolicy {
+    /** How submissions reach HubSpot. `auto` uses Forms API when a GUID is set. */
+    submissionMode: SubmissionMode;
+    /** After a Forms API conversion, CRM-write mapped contact props the form dropped. */
+    writeExtraProperties: boolean;
+    /** On publish, PATCH missing mapped contact fields onto the HubSpot form. */
+    syncFieldsOnPublish: boolean;
 }
 export interface PublicSettings {
     configured: boolean;
@@ -33,6 +45,9 @@ export interface PublicSettings {
     portalSource: SettingSource;
     regionSource: SettingSource;
     formSource: SettingSource;
+    submissionMode: SubmissionMode;
+    writeExtraProperties: boolean;
+    syncFieldsOnPublish: boolean;
 }
 export interface HubspotAccount {
     portalId: string;
@@ -41,6 +56,15 @@ export interface HubspotAccount {
 }
 export declare function getStoredSettings(strapi: Core.Strapi): Promise<StoredSettings>;
 export declare function setStoredSettings(strapi: Core.Strapi, value: StoredSettings | null): Promise<void>;
+export declare function asSubmissionMode(value: unknown): SubmissionMode | undefined;
+interface FormsCfg {
+    defaultFormId?: string;
+    submissionMode?: unknown;
+    writeExtraProperties?: unknown;
+    syncFieldsOnPublish?: unknown;
+}
+export declare function policyFrom(stored: StoredSettings, forms: FormsCfg): HubspotPolicy;
+export declare function resolvePolicy(strapi: Core.Strapi): Promise<HubspotPolicy>;
 export declare function resolveApiKey(strapi: Core.Strapi): Promise<{
     apiKey: string;
     source: SettingSource;
@@ -48,12 +72,17 @@ export declare function resolveApiKey(strapi: Core.Strapi): Promise<{
 /** Portal / region / default marketing form — settings UI overrides env. */
 export declare function resolveAccount(strapi: Core.Strapi): Promise<HubspotAccount>;
 export declare function publicSettings(strapi: Core.Strapi): Promise<PublicSettings>;
-/** Merge a PATCH-like body into the store without dropping the saved key. */
-export declare function patchStoredSettings(strapi: Core.Strapi, body: {
+export interface SettingsPatch {
     apiKey?: string;
     portalId?: unknown;
     region?: unknown;
     defaultFormId?: unknown;
-}): Promise<void>;
+    submissionMode?: unknown;
+    writeExtraProperties?: unknown;
+    syncFieldsOnPublish?: unknown;
+}
+/** Merge a PATCH-like body into the store without dropping the saved key. */
+export declare function patchStoredSettings(strapi: Core.Strapi, body: SettingsPatch): Promise<void>;
 /** Drop only the stored token; portal / form settings stay. */
 export declare function clearStoredApiKey(strapi: Core.Strapi): Promise<void>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strapi-plugin-hubspot",
-  "version": "0.15.0",
+  "version": "0.16.1",
   "description": "The form builder for HubSpot in Strapi — multi-step forms with conditional fields mapped to real CRM properties, a public submit pipeline with retries, and save-time mapping validation.",
   "keywords": [
     "strapi",