strapi-plugin-hubspot 0.13.1 → 0.14.0

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

@@ -0,0 +1 @@
+export {};

package/dist/server/src/content-types.d.ts

@@ -88,6 +88,14 @@ declare const _default: {
                 class: {
                     type: string;
                 };
+                hubspotFormId: {
+                    type: string;
+                    pluginOptions: {
+                        i18n: {
+                            localized: boolean;
+                        };
+                    };
+                };
                 definition: {
                     type: string;
                     required: boolean;

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

@@ -1,12 +1,15 @@
 /**
  * The form-builder server side: shaping a published form for the public API,
- * and turning a submission into HubSpot upserts.
+ * and turning a submission into a HubSpot marketing-form conversion.
  *
- * The pipeline mirrors what a B2B lead capture needs: the person is upserted
- * as a Contact (email is the dedup key); when the email is on a corporate
- * domain the company is found-or-created by `domain` and associated to the
- * contact; a timeline note recaps the whole submission for whoever picks the
- * lead up. Company and note are best-effort — the contact is the lead.
+ * 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.
  */
 import type { Core } from "@strapi/strapi";
 import { type FormDefinition, type Primitive } from "./conditions";
@@ -21,6 +24,7 @@ export interface FormEntry {
     submitLabel?: string | null;
     successMessage?: string | null;
     class?: string | null;
+    hubspotFormId?: string | null;
     locale?: string | null;
     definition: FormDefinition;
     [key: string]: unknown;

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

@@ -0,0 +1,75 @@
+/**
+ * HubSpot marketing Forms API — native form submissions.
+ *
+ * CRM upserts never count as form conversions: Original Source stays
+ * "Offline / Integration", workflows that listen to a form don't fire, and
+ * the lead-center notification attached to the form never runs. Posting to
+ * `/submissions/v3/integration/secure/submit/{portalId}/{formGuid}` with the
+ * visitor's `hutk` is what HubSpot treats as a real conversion.
+ *
+ * Portal id, region and form GUIDs are configuration — a test portal today,
+ * production tomorrow, no code change.
+ */
+export declare function isFormGuid(value: string): boolean;
+export declare function sanitizeHutk(value: unknown): string | undefined;
+export declare function sanitizePortalId(value: unknown): string | undefined;
+export declare function sanitizeIp(value: unknown): string | undefined;
+/** Forms submit host. CRM stays on api.hubapi.com; this endpoint is regional. */
+export declare function formsHost(region: string): string;
+export declare function formsSubmitUrl(portalId: string, formGuid: string, region?: string): string;
+export declare function trackingScriptUrl(portalId: string, region?: string): string;
+export declare function toHsFields(props: Record<string, string>): {
+    name: string;
+    value: string;
+}[];
+export declare function filterToFormFields(fields: {
+    name: string;
+    value: string;
+}[], allowed: Set<string> | null): {
+    name: string;
+    value: string;
+}[];
+export declare function formFieldNames(raw: {
+    fieldGroups?: {
+        fields?: {
+            name?: string;
+        }[];
+    }[];
+}): string[];
+export interface FormSubmitContext {
+    hutk?: string;
+    pageUri?: string;
+    pageName?: string;
+    ipAddress?: string;
+}
+export interface FormSubmitInput {
+    apiKey: string;
+    portalId: string;
+    formGuid: string;
+    region?: string;
+    fields: {
+        name: string;
+        value: string;
+    }[];
+    context?: FormSubmitContext;
+    consent?: {
+        given: boolean;
+        text?: string;
+    };
+    formHasLegalConsent?: boolean;
+}
+export declare function loadFormShape(apiKey: string, formGuid: string): Promise<{
+    names: Set<string>;
+    hasLegalConsent: boolean;
+} | null>;
+export declare function findContactIdByEmail(apiKey: string, email: string): Promise<string | undefined>;
+/**
+ * Submit a marketing form. Extra fields HubSpot doesn't know on that form
+ * 400 the whole request, so callers should filter first; we still retry
+ * without legal-consent and then email-only if HubSpot refuses the payload.
+ */
+export declare function submitMarketingForm(input: FormSubmitInput): Promise<{
+    ok: boolean;
+    status: number;
+    error?: string;
+}>;

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

@@ -31,6 +31,7 @@ export interface ConvertedHubspotForm {
     name: string;
     submitLabel?: string | null;
     successMessage?: string | null;
+    hubspotFormId?: string | null;
     definition: FormDefinition;
     skipped: SkippedItem[];
 }

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

@@ -5,11 +5,14 @@ declare const _default: {
     config: {
         default: {
             apiKey: string;
+            portalId: string;
+            region: string;
             objects: unknown[];
             validate: ValidateTarget[];
             forms: {
                 companyFromDomain: boolean;
                 timelineNote: boolean;
+                defaultFormId: string;
                 rateLimit: {
                     submitPerMinute: number;
                     searchPerMinute: number;
@@ -39,7 +42,7 @@ declare const _default: {
                         visible: boolean;
                     };
                     "content-type-builder": {
-                        visible: boolean; /** RBAC action gating the form builder and its routes. */
+                        visible: boolean;
                     };
                     i18n: {
                         localized: boolean;
@@ -103,6 +106,14 @@ declare const _default: {
                     class: {
                         type: string;
                     };
+                    hubspotFormId: {
+                        type: string;
+                        pluginOptions: {
+                            i18n: {
+                                localized: boolean;
+                            };
+                        };
+                    };
                     definition: {
                         type: string;
                         required: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strapi-plugin-hubspot",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "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",