strapi-plugin-hubspot 0.13.1 → 0.15.0

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

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

package/dist/server/src/__tests__/settings.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;
@@ -47,6 +50,7 @@ declare const _default: {
                 };
                 attributes: {
                     name: {
+                        /** RBAC action gating the settings screen and its routes. */
                         type: string;
                         required: boolean;
                         pluginOptions: {
@@ -103,6 +107,14 @@ declare const _default: {
                     class: {
                         type: string;
                     };
+                    hubspotFormId: {
+                        type: string;
+                        pluginOptions: {
+                            i18n: {
+                                localized: boolean;
+                            };
+                        };
+                    };
                     definition: {
                         type: string;
                         required: boolean;
@@ -347,8 +359,11 @@ declare const _default: {
             }): Promise<void>;
             update(ctx: {
                 request: {
-                    body: {
+                    body?: {
                         apiKey?: string;
+                        portalId?: string;
+                        region?: string;
+                        defaultFormId?: string;
                     };
                 };
                 body: unknown;

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

@@ -1,28 +1,59 @@
 import type { Core } from "@strapi/strapi";
 /**
- * API key resolution, in order of precedence:
+ * API key + portal resolution, in order of precedence:
  *  1. saved from the admin UI (plugin core store)
  *  2. plugin config (config/plugins of the host app)
- *  3. environment variable (HUBSPOT_API_KEY)
+ *  3. environment variable
  *
  * The key is only ever read server-side; `publicSettings` is what the admin UI
- * receives, and it deliberately never carries the key itself.
+ * receives, and it deliberately never carries the key itself. Portal id, region
+ * and the default form GUID are not secrets — they round-trip so they can be
+ * edited in Settings → HubSpot.
  */
 export declare const ENV_VAR = "HUBSPOT_API_KEY";
+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 interface StoredSettings {
     apiKey?: string;
+    portalId?: string;
+    region?: string;
+    defaultFormId?: string;
 }
 export interface PublicSettings {
     configured: boolean;
     /** Where the key comes from, so the UI can explain why it can't be edited. */
-    keySource: "settings" | "config" | "env" | null;
+    keySource: SettingSource;
     /** Last four characters, enough to recognise a key without exposing it. */
     hint: string;
+    portalId: string;
+    region: string;
+    defaultFormId: string;
+    portalSource: SettingSource;
+    regionSource: SettingSource;
+    formSource: SettingSource;
+}
+export interface HubspotAccount {
+    portalId: string;
+    region: string;
+    defaultFormId: string;
 }
 export declare function getStoredSettings(strapi: Core.Strapi): Promise<StoredSettings>;
 export declare function setStoredSettings(strapi: Core.Strapi, value: StoredSettings | null): Promise<void>;
 export declare function resolveApiKey(strapi: Core.Strapi): Promise<{
     apiKey: string;
-    source: PublicSettings["keySource"];
+    source: SettingSource;
 }>;
+/** 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: {
+    apiKey?: string;
+    portalId?: unknown;
+    region?: unknown;
+    defaultFormId?: unknown;
+}): Promise<void>;
+/** Drop only the stored token; portal / form settings stay. */
+export declare function clearStoredApiKey(strapi: Core.Strapi): Promise<void>;

package/package.json

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