strapi-plugin-hubspot 0.7.0 → 0.9.0

package/dist/server/index.mjs

@@ -1,5 +1,5 @@
 import { errors } from "@strapi/utils";
-const HS_BASE$2 = "https://api.hubapi.com";
+const HS_BASE$3 = "https://api.hubapi.com";
 const TTL_MS = 10 * 60 * 1e3;
 const STANDARD_OBJECTS = [
   { name: "contact", path: "contacts" },
@@ -12,8 +12,8 @@ const STANDARD_OBJECTS = [
 ];
 let cache = null;
 let inFlight = null;
-async function hsGet(apiKey, path) {
-  const res = await fetch(`${HS_BASE$2}${path}`, {
+async function hsGet$1(apiKey, path) {
+  const res = await fetch(`${HS_BASE$3}${path}`, {
     headers: { Authorization: `Bearer ${apiKey}` }
   });
   if (!res.ok) {
@@ -26,7 +26,7 @@ async function hsGet(apiKey, path) {
 }
 async function fetchGroups(apiKey, path) {
   try {
-    const res = await hsGet(
+    const res = await hsGet$1(
       apiKey,
       `/crm/v3/properties/${path}/groups`
     );
@@ -37,7 +37,7 @@ async function fetchGroups(apiKey, path) {
 }
 async function fetchObject(apiKey, object) {
   const [res, groups] = await Promise.all([
-    hsGet(apiKey, `/crm/v3/properties/${object.path}`),
+    hsGet$1(apiKey, `/crm/v3/properties/${object.path}`),
     fetchGroups(apiKey, object.path)
   ]);
   return (res.results ?? []).filter((p) => !p.modificationMetadata?.readOnlyValue).map((p) => ({
@@ -51,7 +51,7 @@ async function fetchObject(apiKey, object) {
 }
 async function fetchAccount(apiKey) {
   try {
-    return await hsGet(
+    return await hsGet$1(
       apiKey,
       "/account-info/v3/details"
     );
@@ -396,6 +396,7 @@ const contentTypes = {
         nextLabel: localizedString(),
         submitLabel: localizedString(),
         successMessage: localizedString("text"),
+        class: { type: "string" },
         definition: {
           type: "json",
           required: true,
@@ -572,6 +573,7 @@ function publicForm(entry) {
     nextLabel: entry.nextLabel ?? null,
     submitLabel: entry.submitLabel ?? null,
     successMessage: entry.successMessage ?? null,
+    class: entry.class ?? null,
     locale: entry.locale ?? null,
     steps: (entry.definition?.steps ?? []).map((step) => ({
       ...step,
@@ -661,9 +663,9 @@ function sanitizeRawValues(raw) {
   }
   return values;
 }
-const HS_BASE$1 = "https://api.hubapi.com";
-const HS_COMPANIES = `${HS_BASE$1}/crm/v3/objects/companies`;
-const HS_NOTES = `${HS_BASE$1}/crm/v3/objects/notes`;
+const HS_BASE$2 = "https://api.hubapi.com";
+const HS_COMPANIES = `${HS_BASE$2}/crm/v3/objects/companies`;
+const HS_NOTES = `${HS_BASE$2}/crm/v3/objects/notes`;
 const ASSOC_NOTE_TO_CONTACT = 202;
 const ASSOC_NOTE_TO_COMPANY = 190;
 const escapeHtml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
@@ -825,7 +827,7 @@ function createFormsService(strapi, _opts = {}) {
           if (companyId) {
             await hsJson(
               apiKey,
-              `${HS_BASE$1}/crm/v4/objects/contacts/${contactId}/associations/default/companies/${companyId}`,
+              `${HS_BASE$2}/crm/v4/objects/contacts/${contactId}/associations/default/companies/${companyId}`,
               { method: "PUT" }
             );
           }
@@ -866,6 +868,168 @@ function createFormsService(strapi, _opts = {}) {
   }
   return { submit };
 }
+const HS_BASE$1 = "https://api.hubapi.com";
+const OBJECT_BY_TYPE_ID = {
+  "0-1": "contact",
+  "0-2": "company"
+};
+const TYPE_MAP = {
+  single_line_text: "text",
+  multi_line_text: "textarea",
+  email: "email",
+  phone: "tel",
+  mobile_phone: "tel",
+  number: "number",
+  dropdown: "select",
+  select: "select",
+  radio: "radio",
+  multiple_checkboxes: "checkbox",
+  single_checkbox: "checkbox",
+  booleancheckbox: "checkbox"
+};
+let counter$1 = 0;
+const makeId$1 = (prefix) => `${prefix}_${Date.now().toString(36)}${(counter$1 += 1).toString(36)}`;
+function convertCondition(parentFieldId, raw) {
+  const operator = (raw.operator ?? "").toUpperCase();
+  const values = (raw.values ?? []).map((v) => String(v)).filter((v) => v !== "");
+  const spread = (op, logic) => values.length ? { logic, rules: values.map((value) => ({ field: parentFieldId, operator: op, value })) } : null;
+  switch (operator) {
+    case "EQ":
+    case "SET_ANY":
+      return spread("eq", "or");
+    case "NEQ":
+    case "NOT_SET_ANY":
+      return spread("neq", "and");
+    case "CONTAINS":
+      return spread("contains", "or");
+    case "GT":
+      return spread("gt", "or");
+    case "LT":
+      return spread("lt", "or");
+    case "SET":
+    case "NOT_EMPTY":
+      return { logic: "and", rules: [{ field: parentFieldId, operator: "notEmpty" }] };
+    case "NOT_SET":
+    case "EMPTY":
+      return { logic: "and", rules: [{ field: parentFieldId, operator: "empty" }] };
+    default:
+      return null;
+  }
+}
+function convertField(raw, ctx) {
+  const label = raw.label || raw.name || "";
+  const name = raw.name ?? "";
+  if (raw.hidden) {
+    ctx.skipped.push({ code: "hidden-field", label });
+    return [];
+  }
+  const object = OBJECT_BY_TYPE_ID[raw.objectTypeId ?? "0-1"];
+  if (!object) {
+    ctx.skipped.push({ code: "object", label, detail: raw.objectTypeId });
+    return [];
+  }
+  const type = TYPE_MAP[raw.fieldType ?? ""];
+  if (!type || !name) {
+    ctx.skipped.push({ code: "field-type", label, detail: raw.fieldType });
+    return [];
+  }
+  if (ctx.usedNames.has(name)) {
+    ctx.skipped.push({ code: "duplicate", label, detail: name });
+    return [];
+  }
+  ctx.usedNames.add(name);
+  const options = (raw.options ?? []).map((o) => ({ value: String(o.value ?? ""), label: o.label || void 0 })).filter((o) => o.value !== "");
+  const field = {
+    id: makeId$1("fld"),
+    name,
+    label,
+    type,
+    required: Boolean(raw.required),
+    placeholder: raw.placeholder || void 0,
+    helpText: raw.description || void 0,
+    ...options.length ? { options } : {},
+    hubspot: { object, property: name },
+    ...ctx.parentCondition ? { visibleIf: ctx.parentCondition } : {}
+  };
+  const out = [field];
+  for (const dependent of raw.dependentFields ?? []) {
+    if (!dependent.field) continue;
+    const childLabel = dependent.field.label || dependent.field.name || "";
+    const condition = dependent.dependentCondition ? convertCondition(field.id, dependent.dependentCondition) : null;
+    if (!condition) {
+      ctx.skipped.push({
+        code: "condition",
+        label: childLabel,
+        detail: dependent.dependentCondition?.operator
+      });
+    }
+    out.push(...convertField(dependent.field, { ...ctx, parentCondition: condition }));
+  }
+  return out;
+}
+function convertHubspotForm(raw) {
+  const skipped = [];
+  const usedNames = /* @__PURE__ */ new Set();
+  const fields = [];
+  for (const group of raw.fieldGroups ?? []) {
+    if (group.richText && !(group.fields ?? []).length) {
+      skipped.push({ code: "rich-text", detail: group.richText.slice(0, 80) });
+      continue;
+    }
+    const groupFields = (group.fields ?? []).flatMap(
+      (f) => convertField(f, { usedNames, skipped })
+    );
+    const topLevel = (group.fields ?? []).length;
+    if (topLevel === 2 && groupFields.length >= 2) {
+      groupFields[0].width = "half";
+      groupFields[1].width = "half";
+    }
+    fields.push(...groupFields);
+  }
+  if (raw.legalConsentOptions && Object.keys(raw.legalConsentOptions).length) {
+    skipped.push({ code: "legal-consent" });
+  }
+  const postSubmit = raw.configuration?.postSubmitAction;
+  return {
+    name: raw.name ?? "",
+    submitLabel: raw.displayOptions?.submitButtonText || null,
+    successMessage: postSubmit?.type === "thank_you" && postSubmit.value ? postSubmit.value : null,
+    // HubSpot forms are single-page: one step, reorganizable in the builder.
+    definition: { version: 1, steps: [{ id: makeId$1("stp"), fields }] },
+    skipped
+  };
+}
+async function hsGet(apiKey, path) {
+  const res = await fetch(`${HS_BASE$1}${path}`, {
+    headers: { Authorization: `Bearer ${apiKey}` }
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw Object.assign(new Error(body.message || `HubSpot ${res.status}`), {
+      status: res.status
+    });
+  }
+  return await res.json();
+}
+async function listHubspotForms(apiKey) {
+  const out = [];
+  let after;
+  for (let page = 0; page < 10; page += 1) {
+    const query = after ? `&after=${encodeURIComponent(after)}` : "";
+    const res = await hsGet(apiKey, `/marketing/v3/forms/?limit=100&formTypes=hubspot${query}`);
+    for (const form of res.results ?? []) {
+      if (form.id && !form.archived) {
+        out.push({ id: form.id, name: form.name || form.id, updatedAt: form.updatedAt });
+      }
+    }
+    after = res.paging?.next?.after;
+    if (!after) break;
+  }
+  return out.sort((a, b) => a.name.localeCompare(b.name));
+}
+async function fetchHubspotForm(apiKey, formId) {
+  return hsGet(apiKey, `/marketing/v3/forms/${encodeURIComponent(formId)}`);
+}
 let counter = 0;
 const makeId = (prefix) => `${prefix}_${Date.now().toString(36)}${(counter += 1).toString(36)}`;
 const slugifyName = (label) => label.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
@@ -931,6 +1095,7 @@ function convertLegacyForm(entry, map = {}) {
     nextLabel: entry.nextLabel ?? null,
     submitLabel: entry.submitLabel ?? null,
     successMessage: entry.successMessage ?? null,
+    class: entry.class ?? null,
     definition: { version: 1, steps }
   };
 }
@@ -942,7 +1107,8 @@ const WRITABLE = [
   "subtitle",
   "nextLabel",
   "submitLabel",
-  "successMessage"
+  "successMessage",
+  "class"
 ];
 const slugify = (value) => value.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "form";
 function createFormsAdminController(strapi) {
@@ -961,6 +1127,15 @@ function createFormsAdminController(strapi) {
       return null;
     }
   }
+  async function uniqueSlug(name) {
+    const base = slugify(name);
+    let slug = base;
+    for (let i = 2; ; i += 1) {
+      const clash = await documents().findFirst({ filters: { slug } });
+      if (!clash) return slug;
+      slug = `${base}-${i}`;
+    }
+  }
   function pickWritable(body) {
     const data = {};
     for (const key of WRITABLE) {
@@ -993,8 +1168,15 @@ function createFormsAdminController(strapi) {
         fields: ["slug"]
       });
       const publishedIds = new Set(published.map((e) => e.documentId));
+      const submissionCounts = await Promise.all(
+        drafts.map(
+          (entry) => strapi.documents(SUBMISSION_UID).count({
+            filters: { form: entry.slug }
+          })
+        )
+      );
       ctx.body = {
-        forms: drafts.map((entry) => ({
+        forms: drafts.map((entry, i) => ({
           documentId: entry.documentId,
           name: entry.name,
           slug: entry.slug,
@@ -1004,7 +1186,8 @@ function createFormsAdminController(strapi) {
           fields: (entry.definition?.steps ?? []).reduce(
             (n, step) => n + (step.fields?.length ?? 0),
             0
-          )
+          ),
+          submissions: submissionCounts[i] ?? 0
         }))
       };
     },
@@ -1026,13 +1209,7 @@ function createFormsAdminController(strapi) {
       const body = ctx.request.body ?? {};
       const name = typeof body.name === "string" ? body.name.trim() : "";
       if (!name) ctx.throw(400, "A form needs a name");
-      const base = slugify(name);
-      let slug = base;
-      for (let i = 2; ; i += 1) {
-        const clash = await documents().findFirst({ filters: { slug } });
-        if (!clash) break;
-        slug = `${base}-${i}`;
-      }
+      const slug = await uniqueSlug(name);
       let definition;
       try {
         definition = requireValidDefinition(ctx, body.definition);
@@ -1201,6 +1378,117 @@ function createFormsAdminController(strapi) {
       if (!targetId) ctx.throw(404, "Source entry not found");
       ctx.body = { documentId: targetId, locales: imported };
     },
+    /**
+     * Forms of the connected HubSpot portal, offered for import. Needs the
+     * `forms` read scope on the private app token — a token without it gets
+     * a clear message rather than an empty list.
+     */
+    async listHubspotSources(ctx) {
+      const { apiKey } = await resolveApiKey(strapi);
+      if (!apiKey) {
+        ctx.body = { configured: false, forms: [] };
+        return;
+      }
+      try {
+        ctx.body = { configured: true, forms: await listHubspotForms(apiKey) };
+      } catch (err) {
+        strapi.log.warn(`[hubspot] portal forms unavailable — ${err.message}`);
+        ctx.throw(502, err.message || "Cannot reach HubSpot");
+      }
+    },
+    /**
+     * Converts one portal form into a plugin form draft, in the current
+     * locale. Slug derived from the HubSpot name: re-importing the same form
+     * overwrites the draft — never the published version, never the portal.
+     * What the builder can't express is skipped and returned in `skipped`.
+     */
+    async runHubspotImport(ctx) {
+      const formId = ctx.request.body?.formId;
+      if (typeof formId !== "string" || !formId) ctx.throw(400, "formId is required");
+      const { apiKey } = await resolveApiKey(strapi);
+      if (!apiKey) ctx.throw(400, "No HubSpot API key configured");
+      let converted;
+      try {
+        converted = convertHubspotForm(await fetchHubspotForm(apiKey, formId));
+      } catch (err) {
+        strapi.log.warn(`[hubspot] form import failed — ${err.message}`);
+        ctx.throw(502, err.message || "Cannot reach HubSpot");
+        return;
+      }
+      const name = converted.name || "HubSpot form";
+      const { skipped, definition, ...meta } = converted;
+      const slug = slugify(name);
+      const existing = await documents().findFirst({
+        filters: { slug }
+      });
+      let documentId;
+      if (existing) {
+        await documents().update({
+          documentId: existing.documentId,
+          locale: ctx.query.locale,
+          data: { ...meta, name, definition }
+        });
+        documentId = existing.documentId;
+      } else {
+        const created = await documents().create({
+          locale: ctx.query.locale,
+          data: { ...meta, name, slug, definition }
+        });
+        documentId = created.documentId;
+      }
+      ctx.body = { documentId, skipped };
+    },
+    /**
+     * Copies a form (every locale of its draft) into a new draft document —
+     * the quickest way to A/B a variant or to start from an existing form.
+     * Internal step/field ids are kept: they only need uniqueness per form.
+     */
+    async duplicate(ctx) {
+      const sourceId = ctx.params.documentId;
+      let locales = [void 0];
+      try {
+        const found = await strapi.plugin("i18n").service("locales").find();
+        if (Array.isArray(found) && found.length) {
+          locales = [...found].sort((a, b) => Number(b.isDefault ?? false) - Number(a.isDefault ?? false)).map((l) => l.code);
+        }
+      } catch {
+      }
+      let targetId = null;
+      let slug = null;
+      for (const locale of locales) {
+        const source = await documents().findOne({
+          documentId: sourceId,
+          locale,
+          status: "draft"
+        });
+        if (!source) continue;
+        const name = `${source.name} (2)`;
+        slug ??= await uniqueSlug(name);
+        const data = {
+          name,
+          slug,
+          title: source.title,
+          subtitle: source.subtitle,
+          nextLabel: source.nextLabel,
+          submitLabel: source.submitLabel,
+          successMessage: source.successMessage,
+          class: source.class,
+          definition: source.definition
+        };
+        if (targetId) {
+          const { slug: _slug, name: _name, ...localized } = data;
+          await documents().update({ documentId: targetId, locale, data: localized });
+        } else {
+          const created = await documents().create({
+            locale,
+            data
+          });
+          targetId = created.documentId;
+        }
+      }
+      if (!targetId) ctx.throw(404, "Form not found");
+      ctx.body = { documentId: targetId };
+    },
     async remove(ctx) {
       await documents().delete({
         documentId: ctx.params.documentId
@@ -1210,6 +1498,45 @@ function createFormsAdminController(strapi) {
     }
   };
 }
+function fieldOrder(definition) {
+  if (!definition) return [];
+  return definition.steps.flatMap((step) => step.fields.map((field) => field.name));
+}
+const escapeCell = (value) => {
+  if (value === null || value === void 0) return "";
+  const text = String(value);
+  return /[",\n\r]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text;
+};
+function submissionsCsv(rows, knownFields) {
+  const extra = /* @__PURE__ */ new Set();
+  for (const row of rows) {
+    for (const key of Object.keys(row.values ?? {})) {
+      if (!knownFields.includes(key)) extra.add(key);
+    }
+  }
+  const valueColumns = [...knownFields, ...[...extra].sort()];
+  const header = [
+    "submittedAt",
+    ...valueColumns,
+    "hubspotSynced",
+    "locale",
+    "pagePath",
+    "source"
+  ];
+  const lines = [header.map(escapeCell).join(",")];
+  for (const row of rows) {
+    const cells = [
+      row.createdAt ?? "",
+      ...valueColumns.map((key) => row.values?.[key]),
+      row.hubspotSynced ? "true" : "false",
+      row.locale ?? "",
+      row.meta?.pagePath ?? "",
+      row.meta?.source ?? ""
+    ];
+    lines.push(cells.map(escapeCell).join(","));
+  }
+  return lines.join("\r\n");
+}
 const HS_BASE = "https://api.hubapi.com";
 const FAILURE_UID = "plugin::hubspot.failure";
 const RETRY_DELAYS_MS = [500, 2e3];
@@ -1420,6 +1747,49 @@ const controllers = {
     }
   }),
   formsAdmin: ({ strapi }) => createFormsAdminController(strapi),
+  submissions: ({ strapi }) => ({
+    /** Paged submissions, newest first, optionally narrowed to one form. */
+    async list(ctx) {
+      const filters = ctx.query.form ? { form: ctx.query.form } : void 0;
+      const page = Math.max(1, Number(ctx.query.page) || 1);
+      const pageSize = Math.min(100, Math.max(1, Number(ctx.query.pageSize) || 20));
+      const [rows, total] = await Promise.all([
+        strapi.documents(SUBMISSION_UID).findMany({
+          filters,
+          sort: "createdAt:desc",
+          limit: pageSize,
+          start: (page - 1) * pageSize
+        }),
+        strapi.documents(SUBMISSION_UID).count({ filters })
+      ]);
+      ctx.body = { submissions: rows, total, page, pageSize };
+    },
+    /**
+     * Whole history of one form as CSV, definition columns first. Returned as
+     * JSON (`{ csv, filename }`): the admin fetch client speaks JSON, and the
+     * page turns it into a download — no auth-header gymnastics.
+     */
+    async export(ctx) {
+      const slug = ctx.query.form;
+      if (!slug) ctx.throw(400, "form is required");
+      const [rows, entry] = await Promise.all([
+        strapi.documents(SUBMISSION_UID).findMany({
+          filters: { form: slug },
+          sort: "createdAt:desc",
+          limit: 1e4
+        }),
+        strapi.documents(FORM_UID).findFirst({
+          filters: { slug },
+          status: "draft"
+        })
+      ]);
+      ctx.body = {
+        csv: submissionsCsv(rows, fieldOrder(entry?.definition)),
+        filename: `${slug}-submissions-${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}.csv`,
+        total: rows.length
+      };
+    }
+  }),
   forms: ({ strapi }) => ({
     /** Published form for the host frontend — CRM mapping stripped. */
     async findOne(ctx) {
@@ -1501,11 +1871,16 @@ const routes = {
       adminRoute("POST", "/builder/forms/:documentId/publish", "formsAdmin.publish", [FORMS_ACTION]),
       adminRoute("POST", "/builder/forms/:documentId/unpublish", "formsAdmin.unpublish", [FORMS_ACTION]),
       adminRoute("DELETE", "/builder/forms/:documentId", "formsAdmin.remove", [FORMS_ACTION]),
+      adminRoute("POST", "/builder/forms/:documentId/duplicate", "formsAdmin.duplicate", [FORMS_ACTION]),
       // No FORMS_ACTION: editors pick forms from the Content Manager, like
       // they pick properties — the builder itself stays gated.
       adminRoute("GET", "/forms-options", "formsAdmin.options"),
       adminRoute("GET", "/builder/import/sources", "formsAdmin.listSources", [FORMS_ACTION]),
-      adminRoute("POST", "/builder/import", "formsAdmin.runImport", [FORMS_ACTION])
+      adminRoute("POST", "/builder/import", "formsAdmin.runImport", [FORMS_ACTION]),
+      adminRoute("GET", "/builder/import/hubspot", "formsAdmin.listHubspotSources", [FORMS_ACTION]),
+      adminRoute("POST", "/builder/import/hubspot", "formsAdmin.runHubspotImport", [FORMS_ACTION]),
+      adminRoute("GET", "/builder/submissions", "submissions.list", [FORMS_ACTION]),
+      adminRoute("GET", "/builder/submissions/export", "submissions.export", [FORMS_ACTION])
     ]
   },
   // Public form delivery + submission, under /api/hubspot/…. Like any

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

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

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

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

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

@@ -85,6 +85,9 @@ declare const _default: {
                         };
                     };
                 };
+                class: {
+                    type: string;
+                };
                 definition: {
                     type: string;
                     required: boolean;

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

@@ -19,6 +19,7 @@ export interface FormEntry {
     nextLabel?: string | null;
     submitLabel?: string | null;
     successMessage?: string | null;
+    class?: string | null;
     locale?: string | null;
     definition: FormDefinition;
     [key: string]: unknown;
@@ -30,6 +31,7 @@ export interface PublicForm {
     nextLabel?: string | null;
     submitLabel?: string | null;
     successMessage?: string | null;
+    class?: string | null;
     locale?: string | null;
     steps: FormDefinition["steps"];
 }

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

@@ -42,5 +42,24 @@ export declare function createFormsAdminController(strapi: Core.Strapi): {
      * published version, and never modifies the source.
      */
     runImport(ctx: Ctx): Promise<void>;
+    /**
+     * Forms of the connected HubSpot portal, offered for import. Needs the
+     * `forms` read scope on the private app token — a token without it gets
+     * a clear message rather than an empty list.
+     */
+    listHubspotSources(ctx: Ctx): Promise<void>;
+    /**
+     * Converts one portal form into a plugin form draft, in the current
+     * locale. Slug derived from the HubSpot name: re-importing the same form
+     * overwrites the draft — never the published version, never the portal.
+     * What the builder can't express is skipped and returned in `skipped`.
+     */
+    runHubspotImport(ctx: Ctx): Promise<void>;
+    /**
+     * Copies a form (every locale of its draft) into a new draft document —
+     * the quickest way to A/B a variant or to start from an existing form.
+     * Internal step/field ids are kept: they only need uniqueness per form.
+     */
+    duplicate(ctx: Ctx): Promise<void>;
     remove(ctx: Ctx): Promise<void>;
 };

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

@@ -0,0 +1,85 @@
+/**
+ * Conversion of a HubSpot-hosted form (marketing v3 Forms API) into the
+ * plugin's definition model — the second import path of the builder, next to
+ * the legacy content-type one (importLegacy.ts).
+ *
+ * The translation is deliberately lossy-but-honest: everything the builder
+ * can express is carried over (fields, options, required, two-per-row
+ * layouts, dependent-field conditions), and everything it can't is *skipped
+ * and reported* rather than half-imported — the caller shows the report so
+ * the editor knows exactly what to rebuild by hand.
+ *
+ * A HubSpot form field IS a CRM property (`name` + `objectTypeId`), so an
+ * imported form arrives with a mapping that is already valid for the portal.
+ */
+import type { FormDefinition } from "./conditions";
+/** One row of the portal's form list, as offered for import. */
+export interface HubspotFormSummary {
+    id: string;
+    name: string;
+    updatedAt?: string;
+}
+/** Something the converter could not express in the builder's model. */
+export interface SkippedItem {
+    code: "field-type" | "hidden-field" | "object" | "duplicate" | "condition" | "rich-text" | "legal-consent";
+    /** Field label or name, when the item is a field. */
+    label?: string;
+    /** Raw detail (the fieldType, the operator…) for the report. */
+    detail?: string;
+}
+export interface ConvertedHubspotForm {
+    name: string;
+    submitLabel?: string | null;
+    successMessage?: string | null;
+    definition: FormDefinition;
+    skipped: SkippedItem[];
+}
+interface RawDependent {
+    dependentCondition?: {
+        operator?: string;
+        values?: unknown[];
+    };
+    field?: RawField;
+}
+interface RawField {
+    objectTypeId?: string;
+    name?: string;
+    label?: string;
+    fieldType?: string;
+    required?: boolean;
+    hidden?: boolean;
+    placeholder?: string;
+    description?: string;
+    options?: {
+        value?: unknown;
+        label?: string;
+    }[];
+    dependentFields?: RawDependent[];
+}
+interface RawFieldGroup {
+    richText?: string;
+    fields?: RawField[];
+}
+export interface RawHubspotForm {
+    id?: string;
+    name?: string;
+    fieldGroups?: RawFieldGroup[];
+    displayOptions?: {
+        submitButtonText?: string;
+    };
+    configuration?: {
+        postSubmitAction?: {
+            type?: string;
+            value?: string;
+        };
+    };
+    legalConsentOptions?: {
+        type?: string;
+    } | null;
+}
+export declare function convertHubspotForm(raw: RawHubspotForm): ConvertedHubspotForm;
+/** Every regular form of the portal, name-sorted. Needs the `forms` scope. */
+export declare function listHubspotForms(apiKey: string): Promise<HubspotFormSummary[]>;
+/** One form, full definition. */
+export declare function fetchHubspotForm(apiKey: string, formId: string): Promise<RawHubspotForm>;
+export {};