strapi-plugin-hubspot 0.16.8 → 0.16.9

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## Unreleased
 
+## 0.16.9 — 2026-10-01
+
+### Fixed
+- **Brand-new leads silently lost their timeline note and company
+  association** after a Forms API conversion: the contact id was resolved
+  through the Search API, whose index lags by seconds to minutes on freshly
+  created records — so the contact the conversion itself just created was
+  invisible, and the note/association steps were skipped without a warning.
+  The lookup now uses the direct object endpoint
+  (`GET /crm/v3/objects/contacts/{email}?idProperty=email`), which reads the
+  object store (no index lag), with a short 404 retry (~1.6 s budget) since
+  the conversion is processed asynchronously. Existing contacts are
+  unaffected; any non-404 error still gives up immediately.
+
 ## 0.16.8 — 2026-09-24
 
 ### Added

package/dist/server/index.js

@@ -2167,24 +2167,20 @@ async function loadFormShape(apiKey, formGuid) {
     return null;
   }
 }
-async function findContactIdByEmail(apiKey, email) {
-  const res = await fetch("https://api.hubapi.com/crm/v3/objects/contacts/search", {
-    method: "POST",
-    headers: {
-      Authorization: `Bearer ${apiKey}`,
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify({
-      filterGroups: [
-        { filters: [{ propertyName: "email", operator: "EQ", value: email }] }
-      ],
-      properties: ["email"],
-      limit: 1
-    })
-  });
-  const body = await res.json().catch(() => ({}));
-  if (!res.ok) return void 0;
-  return body.results?.[0]?.id;
+async function findContactIdByEmail(apiKey, email, retryDelaysMs = [400, 1200]) {
+  for (const delay of [0, ...retryDelaysMs]) {
+    if (delay > 0) await new Promise((resolve) => setTimeout(resolve, delay));
+    const res = await fetch(
+      `https://api.hubapi.com/crm/v3/objects/contacts/${encodeURIComponent(email)}?idProperty=email`,
+      { headers: { Authorization: `Bearer ${apiKey}` } }
+    );
+    if (res.ok) {
+      const body = await res.json().catch(() => ({}));
+      return body.id || void 0;
+    }
+    if (res.status !== 404) return void 0;
+  }
+  return void 0;
 }
 function contextPayload(ctx) {
   const out = {};

package/dist/server/index.mjs

@@ -2166,24 +2166,20 @@ async function loadFormShape(apiKey, formGuid) {
     return null;
   }
 }
-async function findContactIdByEmail(apiKey, email) {
-  const res = await fetch("https://api.hubapi.com/crm/v3/objects/contacts/search", {
-    method: "POST",
-    headers: {
-      Authorization: `Bearer ${apiKey}`,
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify({
-      filterGroups: [
-        { filters: [{ propertyName: "email", operator: "EQ", value: email }] }
-      ],
-      properties: ["email"],
-      limit: 1
-    })
-  });
-  const body = await res.json().catch(() => ({}));
-  if (!res.ok) return void 0;
-  return body.results?.[0]?.id;
+async function findContactIdByEmail(apiKey, email, retryDelaysMs = [400, 1200]) {
+  for (const delay of [0, ...retryDelaysMs]) {
+    if (delay > 0) await new Promise((resolve) => setTimeout(resolve, delay));
+    const res = await fetch(
+      `https://api.hubapi.com/crm/v3/objects/contacts/${encodeURIComponent(email)}?idProperty=email`,
+      { headers: { Authorization: `Bearer ${apiKey}` } }
+    );
+    if (res.ok) {
+      const body = await res.json().catch(() => ({}));
+      return body.id || void 0;
+    }
+    if (res.status !== 404) return void 0;
+  }
+  return void 0;
 }
 function contextPayload(ctx) {
   const out = {};

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

@@ -133,7 +133,18 @@ export interface FormSubmitInput {
 }
 export declare function clearFormShapeCache(formGuid?: string): void;
 export declare function loadFormShape(apiKey: string, formGuid: string): Promise<FormShape | null>;
-export declare function findContactIdByEmail(apiKey: string, email: string): Promise<string | undefined>;
+/**
+ * The contact's id right after a Forms API conversion, via the DIRECT object
+ * lookup (`idProperty=email`) — never the Search API: the search index lags by
+ * seconds to minutes on freshly created records, so a contact the conversion
+ * itself just created was invisible, silently costing brand-new leads their
+ * timeline note and company association. The object store has no such lag.
+ *
+ * The conversion is processed asynchronously on HubSpot's side, so a 404 is
+ * retried briefly (the delays are injectable for tests). Any other error
+ * (auth, 5xx) gives up immediately — retrying wouldn't change it.
+ */
+export declare function findContactIdByEmail(apiKey: string, email: string, retryDelaysMs?: readonly number[]): 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. A GDPR block on the

package/package.json

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