strapi-plugin-hubspot 0.1.0 → 0.2.0

package/README.md

@@ -35,8 +35,7 @@ This plugin makes all three impossible to save.
 ### A property picker instead of a text field
 
 Replace your property field's type with the `hubspot.property` custom field.
-Editors then search the real, writable properties of your portal, each labelled
-with the object it belongs to:
+Editors then search the real, writable properties of your portal:
 
 ```
 Contact · Rôle (hs_role)
@@ -44,9 +43,24 @@ Contact · Prénom (firstname)
 Société · Nombre d'employés (numberofemployees)
 ```
 
+**The list narrows to the object you picked.** Point the field at the sibling
+that holds the object and choosing *Contact* leaves only contact properties —
+the prefix disappears, since it is no longer telling you anything:
+
+```json
+{
+  "hsProperty": {
+    "type": "customField",
+    "customField": "plugin::hubspot.property",
+    "options": { "objectField": "hsObject" }
+  }
+}
+```
+
 Read-only properties — the ones HubSpot computes and always refuses to
 accept — are filtered out, so the list only ever offers things that will
-actually work.
+actually work. When the portal id is readable, each selected property gets a
+**Voir dans HubSpot** link straight to its settings page.
 
 ### Validation on save
 
@@ -64,6 +78,11 @@ never returned to the browser: the UI only receives whether a key exists, where
 it comes from, and its last four characters. A "Test connection" button
 round-trips to HubSpot and reports how many properties it can read.
 
+> **On storage:** the key is kept in Strapi's core store, which is **not
+> encrypted at rest** — it is readable by anyone with database access. It never
+> reaches the browser, but treat it like any other secret in your database. Use
+> `HUBSPOT_API_KEY` if your deployment already manages secrets properly.
+
 ## Install
 
 ```bash
@@ -80,6 +99,12 @@ export default ({ env }) => ({
       // Optional — the key can also be set from Settings → HubSpot.
       apiKey: env("HUBSPOT_API_KEY", ""),
 
+      // Optional — objects whose properties are offered.
+      // Defaults to ["contact", "company"]. Standard names: contact, company,
+      // deal, ticket, product, line_item, quote. A custom object is either its
+      // type id, or { name, path } when the two differ.
+      objects: ["contact", "company", "deal"],
+
       // Optional — entries whose mappings are validated on save.
       validate: [
         {
@@ -94,13 +119,15 @@ export default ({ env }) => ({
 ```
 
 Then point your property field at the custom field, in the component or content
-type that holds it:
+type that holds it. `options.objectField` names the sibling holding the object —
+omit it and the picker simply lists every object's properties:
 
 ```json
 {
   "hsProperty": {
     "type": "customField",
-    "customField": "plugin::hubspot.property"
+    "customField": "plugin::hubspot.property",
+    "options": { "objectField": "hsObject" }
   }
 }
 ```
@@ -109,10 +136,16 @@ Restart Strapi and hard-refresh the admin.
 
 ### The token
 
-Create a **private app** in HubSpot with these scopes:
+Create a **private app** in HubSpot with a read scope per object you list:
 
 - `crm.schemas.contacts.read`
 - `crm.schemas.companies.read`
+- `crm.schemas.deals.read`, `crm.schemas.custom.read`… as needed
+
+An object the token can't read is **skipped, not fatal**: the picker keeps
+working for the others and explains which one is missing a scope. `oauth` is
+worth adding too — it exposes the portal id, which turns on the *view in HubSpot*
+links.
 
 The key is resolved in this order, first match wins:
 
@@ -140,6 +173,8 @@ This one never blocks work:
 | No API key configured | The field falls back to a plain text input, with a note explaining why |
 | HubSpot unreachable | Saving proceeds; validation is skipped and a warning is logged |
 | Property staged in HubSpot but not created yet | The picker accepts a typed value (`creatable`) |
+| An object's scope is missing | That object is skipped; the others still work |
+| Portal id unreadable | Deep links are omitted; everything else is unaffected |
 | Plugin uninstalled | Values remain as strings — nothing to undo |
 
 The property schema is cached for 10 minutes and de-duplicated across concurrent
@@ -152,7 +187,7 @@ All routes require an authenticated admin.
 
 | Method | Path | Purpose |
 |---|---|---|
-| `GET` | `/hubspot/properties` | Writable properties of both objects. `?refresh=1` bypasses the cache |
+| `GET` | `/hubspot/properties` | Writable properties, readable objects, unreachable ones and the portal id. `?refresh=1` bypasses the cache |
 | `GET` | `/hubspot/settings` | Whether a key exists, its source and hint — never the key |
 | `PUT` | `/hubspot/settings` | Save a key (`{ apiKey }`) |
 | `DELETE` | `/hubspot/settings` | Remove the stored key |

package/dist/_chunks/{HubspotPropertyInput-B0HpXoqz.js → HubspotPropertyInput-BcdqfAfv.js}

@@ -4,7 +4,7 @@ const jsxRuntime = require("react/jsx-runtime");
 const React = require("react");
 const designSystem = require("@strapi/design-system");
 const admin = require("@strapi/strapi/admin");
-const index = require("./index-DVRLoCa1.js");
+const index = require("./index-sOi9wC_y.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
@@ -23,54 +23,75 @@ function _interopNamespace(e) {
   return Object.freeze(n);
 }
 const React__namespace = /* @__PURE__ */ _interopNamespace(React);
-const OBJECT_LABEL = {
+const LABELS = {
   contact: "Contact",
-  company: "Société"
+  company: "Société",
+  deal: "Transaction",
+  ticket: "Ticket",
+  product: "Produit",
+  line_item: "Ligne de commande",
+  quote: "Devis"
 };
+function objectLabel(object) {
+  return LABELS[object] ?? object;
+}
 const HubspotPropertyInput = React__namespace.forwardRef(
-  ({ name, value, onChange, disabled, error, required, label, hint, labelAction }, ref) => {
+  ({ name, value, onChange, attribute, disabled, error, required, label, hint, labelAction }, ref) => {
     const { get } = admin.useFetchClient();
-    const [properties, setProperties] = React__namespace.useState([]);
-    const [configured, setConfigured] = React__namespace.useState(null);
+    const [schema, setSchema] = React__namespace.useState(null);
     const [loadError, setLoadError] = React__namespace.useState("");
+    const objectFieldName = attribute?.options?.objectField || "hsObject";
+    const siblingPath = React__namespace.useMemo(
+      () => name.replace(/[^.]+$/, objectFieldName),
+      [name, objectFieldName]
+    );
+    const siblingField = admin.useField(siblingPath);
+    const selectedObject = siblingField?.value;
     React__namespace.useEffect(() => {
       let cancelled = false;
       get(`/${index.PLUGIN_ID}/properties`).then(({ data }) => {
-        if (cancelled) return;
-        setConfigured(data.configured);
-        setProperties(data.properties ?? []);
+        if (!cancelled) setSchema(data);
       }).catch((err) => {
         if (cancelled) return;
-        setConfigured(false);
-        setLoadError(
-          err?.response?.data?.error?.message ?? "Propriétés HubSpot indisponibles"
-        );
+        setSchema({ configured: false, properties: [], objects: [], unavailable: [] });
+        setLoadError(err?.response?.data?.error?.message ?? "Propriétés HubSpot indisponibles");
       });
       return () => {
         cancelled = true;
       };
     }, [get]);
     const emit = (next) => onChange({ target: { name, value: next ?? "", type: "string" } });
+    const options = React__namespace.useMemo(() => {
+      const all = schema?.properties ?? [];
+      const scoped = selectedObject ? all.filter((p) => p.object === selectedObject) : all;
+      const shown = scoped.map((p) => ({
+        value: p.name,
+        // The object prefix is redundant once filtered, and noisy.
+        label: selectedObject ? `${p.label} (${p.name})` : `${objectLabel(p.object)} · ${p.label} (${p.name})`
+      }));
+      if (value && !scoped.some((p) => p.name === value)) {
+        const elsewhere = all.find((p) => p.name === value);
+        shown.unshift({
+          value,
+          label: elsewhere ? `${value} — appartient à ${objectLabel(elsewhere.object)}` : `${value} — inconnue du portail`
+        });
+      }
+      return shown;
+    }, [schema, selectedObject, value]);
     const describe = () => {
       if (loadError) return loadError;
-      if (configured === false) {
+      if (schema && !schema.configured) {
         return "Aucune clé API HubSpot — saisie libre. Renseignez-la dans Réglages → HubSpot.";
       }
+      if (selectedObject && schema?.unavailable.some((u) => u.object === selectedObject)) {
+        return `Propriétés de « ${objectLabel(selectedObject)} » illisibles — portée manquante sur le jeton.`;
+      }
       return hint;
     };
-    const options = React__namespace.useMemo(() => {
-      const known = properties.map((p) => ({
-        value: p.name,
-        label: `${OBJECT_LABEL[p.object]} · ${p.label} (${p.name})`
-      }));
-      if (value && !properties.some((p) => p.name === value)) {
-        known.unshift({ value, label: `${value} — inconnue du portail` });
-      }
-      return known;
-    }, [properties, value]);
+    const crmLink = schema?.portalId && value && schema.properties.some((p) => p.name === value) ? `https://app.hubspot.com/property-settings/${schema.portalId}/properties?search=${encodeURIComponent(value)}` : null;
     return /* @__PURE__ */ jsxRuntime.jsxs(designSystem.Field.Root, { name, error, hint: describe(), required, children: [
       /* @__PURE__ */ jsxRuntime.jsx(designSystem.Field.Label, { action: labelAction, children: label }),
-      configured === null ? /* @__PURE__ */ jsxRuntime.jsx(designSystem.Flex, { paddingTop: 2, paddingBottom: 2, children: /* @__PURE__ */ jsxRuntime.jsx(designSystem.Loader, { small: true, children: "Chargement des propriétés HubSpot…" }) }) : configured ? /* @__PURE__ */ jsxRuntime.jsx(
+      !schema ? /* @__PURE__ */ jsxRuntime.jsx(designSystem.Flex, { paddingTop: 2, paddingBottom: 2, children: /* @__PURE__ */ jsxRuntime.jsx(designSystem.Loader, { small: true, children: "Chargement des propriétés HubSpot…" }) }) : schema.configured ? /* @__PURE__ */ jsxRuntime.jsx(
         designSystem.Combobox,
         {
           ref,
@@ -93,6 +114,7 @@ const HubspotPropertyInput = React__namespace.forwardRef(
           placeholder: "ex. hs_role, numberofemployees"
         }
       ),
+      crmLink ? /* @__PURE__ */ jsxRuntime.jsx(designSystem.Flex, { paddingTop: 1, children: /* @__PURE__ */ jsxRuntime.jsx(designSystem.Link, { href: crmLink, isExternal: true, children: "Voir dans HubSpot" }) }) : null,
       /* @__PURE__ */ jsxRuntime.jsx(designSystem.Field.Hint, {}),
       /* @__PURE__ */ jsxRuntime.jsx(designSystem.Field.Error, {})
     ] });

package/dist/_chunks/HubspotPropertyInput-D0gijgli.mjs

@@ -0,0 +1,106 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import * as React from "react";
+import { Field, Flex, Loader, Combobox, ComboboxOption, Link } from "@strapi/design-system";
+import { useFetchClient, useField } from "@strapi/strapi/admin";
+import { P as PLUGIN_ID } from "./index-DIwNOVQ0.mjs";
+const LABELS = {
+  contact: "Contact",
+  company: "Société",
+  deal: "Transaction",
+  ticket: "Ticket",
+  product: "Produit",
+  line_item: "Ligne de commande",
+  quote: "Devis"
+};
+function objectLabel(object) {
+  return LABELS[object] ?? object;
+}
+const HubspotPropertyInput = React.forwardRef(
+  ({ name, value, onChange, attribute, disabled, error, required, label, hint, labelAction }, ref) => {
+    const { get } = useFetchClient();
+    const [schema, setSchema] = React.useState(null);
+    const [loadError, setLoadError] = React.useState("");
+    const objectFieldName = attribute?.options?.objectField || "hsObject";
+    const siblingPath = React.useMemo(
+      () => name.replace(/[^.]+$/, objectFieldName),
+      [name, objectFieldName]
+    );
+    const siblingField = useField(siblingPath);
+    const selectedObject = siblingField?.value;
+    React.useEffect(() => {
+      let cancelled = false;
+      get(`/${PLUGIN_ID}/properties`).then(({ data }) => {
+        if (!cancelled) setSchema(data);
+      }).catch((err) => {
+        if (cancelled) return;
+        setSchema({ configured: false, properties: [], objects: [], unavailable: [] });
+        setLoadError(err?.response?.data?.error?.message ?? "Propriétés HubSpot indisponibles");
+      });
+      return () => {
+        cancelled = true;
+      };
+    }, [get]);
+    const emit = (next) => onChange({ target: { name, value: next ?? "", type: "string" } });
+    const options = React.useMemo(() => {
+      const all = schema?.properties ?? [];
+      const scoped = selectedObject ? all.filter((p) => p.object === selectedObject) : all;
+      const shown = scoped.map((p) => ({
+        value: p.name,
+        // The object prefix is redundant once filtered, and noisy.
+        label: selectedObject ? `${p.label} (${p.name})` : `${objectLabel(p.object)} · ${p.label} (${p.name})`
+      }));
+      if (value && !scoped.some((p) => p.name === value)) {
+        const elsewhere = all.find((p) => p.name === value);
+        shown.unshift({
+          value,
+          label: elsewhere ? `${value} — appartient à ${objectLabel(elsewhere.object)}` : `${value} — inconnue du portail`
+        });
+      }
+      return shown;
+    }, [schema, selectedObject, value]);
+    const describe = () => {
+      if (loadError) return loadError;
+      if (schema && !schema.configured) {
+        return "Aucune clé API HubSpot — saisie libre. Renseignez-la dans Réglages → HubSpot.";
+      }
+      if (selectedObject && schema?.unavailable.some((u) => u.object === selectedObject)) {
+        return `Propriétés de « ${objectLabel(selectedObject)} » illisibles — portée manquante sur le jeton.`;
+      }
+      return hint;
+    };
+    const crmLink = schema?.portalId && value && schema.properties.some((p) => p.name === value) ? `https://app.hubspot.com/property-settings/${schema.portalId}/properties?search=${encodeURIComponent(value)}` : null;
+    return /* @__PURE__ */ jsxs(Field.Root, { name, error, hint: describe(), required, children: [
+      /* @__PURE__ */ jsx(Field.Label, { action: labelAction, children: label }),
+      !schema ? /* @__PURE__ */ jsx(Flex, { paddingTop: 2, paddingBottom: 2, children: /* @__PURE__ */ jsx(Loader, { small: true, children: "Chargement des propriétés HubSpot…" }) }) : schema.configured ? /* @__PURE__ */ jsx(
+        Combobox,
+        {
+          ref,
+          value: value || "",
+          onChange: emit,
+          onClear: () => emit(""),
+          disabled,
+          placeholder: "Rechercher une propriété…",
+          creatable: true,
+          onCreateOption: emit,
+          children: options.map((o) => /* @__PURE__ */ jsx(ComboboxOption, { value: o.value, children: o.label }, o.value))
+        }
+      ) : /* @__PURE__ */ jsx(
+        Field.Input,
+        {
+          ref,
+          value: value || "",
+          onChange: (e) => emit(e.target.value),
+          disabled,
+          placeholder: "ex. hs_role, numberofemployees"
+        }
+      ),
+      crmLink ? /* @__PURE__ */ jsx(Flex, { paddingTop: 1, children: /* @__PURE__ */ jsx(Link, { href: crmLink, isExternal: true, children: "Voir dans HubSpot" }) }) : null,
+      /* @__PURE__ */ jsx(Field.Hint, {}),
+      /* @__PURE__ */ jsx(Field.Error, {})
+    ] });
+  }
+);
+HubspotPropertyInput.displayName = "HubspotPropertyInput";
+export {
+  HubspotPropertyInput as default
+};

package/dist/_chunks/{Settings-BgRpG_a6.js → Settings-DedA0z6w.js}

@@ -4,7 +4,7 @@ const jsxRuntime = require("react/jsx-runtime");
 const React = require("react");
 const designSystem = require("@strapi/design-system");
 const admin = require("@strapi/strapi/admin");
-const index = require("./index-DVRLoCa1.js");
+const index = require("./index-sOi9wC_y.js");
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });

package/dist/_chunks/{Settings-Byupubny.mjs → Settings-DuYUpD8L.mjs}

@@ -2,7 +2,7 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
 import { Box, Loader, Flex, Typography, Badge, Field, Button } from "@strapi/design-system";
 import { useFetchClient } from "@strapi/strapi/admin";
-import { P as PLUGIN_ID } from "./index-CER4BKjS.mjs";
+import { P as PLUGIN_ID } from "./index-DIwNOVQ0.mjs";
 const SOURCE_LABEL = {
   settings: "saisie ici",
   config: "config/plugins.ts",

package/dist/_chunks/{index-CER4BKjS.mjs → index-DIwNOVQ0.mjs}

@@ -14,7 +14,7 @@ const index = {
         defaultMessage: "Choisie dans les propriétés réelles du portail"
       },
       components: {
-        Input: async () => import("./HubspotPropertyInput-CTZYZS_7.mjs")
+        Input: async () => import("./HubspotPropertyInput-D0gijgli.mjs")
       },
       options: {}
     });
@@ -29,7 +29,7 @@ const index = {
           id: `${PLUGIN_ID}-settings`,
           to: `/settings/${PLUGIN_ID}`,
           permissions: [],
-          Component: async () => (await import("./Settings-Byupubny.mjs")).default
+          Component: async () => (await import("./Settings-DuYUpD8L.mjs")).default
         }
       ]
     );

package/dist/_chunks/{index-DVRLoCa1.js → index-sOi9wC_y.js}

@@ -15,7 +15,7 @@ const index = {
         defaultMessage: "Choisie dans les propriétés réelles du portail"
       },
       components: {
-        Input: async () => Promise.resolve().then(() => require("./HubspotPropertyInput-B0HpXoqz.js"))
+        Input: async () => Promise.resolve().then(() => require("./HubspotPropertyInput-BcdqfAfv.js"))
       },
       options: {}
     });
@@ -30,7 +30,7 @@ const index = {
           id: `${PLUGIN_ID}-settings`,
           to: `/settings/${PLUGIN_ID}`,
           permissions: [],
-          Component: async () => (await Promise.resolve().then(() => require("./Settings-BgRpG_a6.js"))).default
+          Component: async () => (await Promise.resolve().then(() => require("./Settings-DedA0z6w.js"))).default
         }
       ]
     );

package/dist/admin/index.js

@@ -1,3 +1,3 @@
 "use strict";
-const index = require("../_chunks/index-DVRLoCa1.js");
+const index = require("../_chunks/index-sOi9wC_y.js");
 module.exports = index.index;

package/dist/admin/index.mjs

@@ -1,4 +1,4 @@
-import { i } from "../_chunks/index-CER4BKjS.mjs";
+import { i } from "../_chunks/index-DIwNOVQ0.mjs";
 export {
   i as default
 };

package/dist/admin/src/components/HubspotPropertyInput.d.ts

@@ -9,26 +9,30 @@ interface InputProps {
             type: string;
         };
     }) => void;
-    attribute?: unknown;
+    attribute?: {
+        options?: {
+            objectField?: string;
+        };
+    };
     disabled?: boolean;
     error?: string;
     required?: boolean;
     labelAction?: React.ReactNode;
     hint?: React.ReactNode;
     label?: string;
-    placeholder?: string;
 }
 /**
- * Picker over the portal's writable properties.
+ * Picker over the portal's writable properties, narrowed to the object the
+ * sibling field selects.
  *
- * Contact and company properties share one list, each prefixed by its object,
- * rather than being filtered by a sibling `hsObject` field: reading a sibling
- * value from inside a repeatable component nested in a dynamic zone is brittle,
- * and showing the object inline is arguably clearer anyway — the editor sees at
- * a glance which record the answer lands on.
+ * The sibling is found by path arithmetic on our own `name`: inside a repeatable
+ * component in a dynamic zone it looks like
+ * `blocks.3.form.steps.0.fields.2.hsProperty`, so swapping the last segment
+ * yields the neighbour. Which segment to swap is configurable per attribute
+ * (`options.objectField`) so the plugin isn't tied to a field called `hsObject`.
  *
- * Falls back to a plain text input when no API key is configured, so the field
- * never blocks authoring on a fresh install.
+ * Before an object is chosen the full list shows, each entry prefixed by its
+ * object — an empty picker would read as broken.
  */
 declare const HubspotPropertyInput: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
 export default HubspotPropertyInput;

package/dist/admin/src/objectLabels.d.ts

@@ -0,0 +1 @@
+export declare function objectLabel(object: string): string;

package/dist/server/index.js

@@ -2,42 +2,91 @@
 const utils = require("@strapi/utils");
 const HS_BASE = "https://api.hubapi.com";
 const TTL_MS = 10 * 60 * 1e3;
-const PLURAL = {
-  contact: "contacts",
-  company: "companies"
-};
+const STANDARD_OBJECTS = [
+  { name: "contact", path: "contacts" },
+  { name: "company", path: "companies" },
+  { name: "deal", path: "deals" },
+  { name: "ticket", path: "tickets" },
+  { name: "product", path: "products" },
+  { name: "line_item", path: "line_items" },
+  { name: "quote", path: "quotes" }
+];
 let cache = null;
 let inFlight = null;
-async function fetchObject(apiKey, object) {
-  const res = await fetch(`${HS_BASE}/crm/v3/properties/${PLURAL[object]}`, {
+async function hsGet(apiKey, path) {
+  const res = await fetch(`${HS_BASE}${path}`, {
     headers: { Authorization: `Bearer ${apiKey}` }
-  }).then(async (r) => {
-    if (!r.ok) throw new Error(`HubSpot ${r.status} sur ${PLURAL[object]}`);
-    return r.json();
   });
+  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 fetchObject(apiKey, object) {
+  const res = await hsGet(
+    apiKey,
+    `/crm/v3/properties/${object.path}`
+  );
   return (res.results ?? []).filter((p) => !p.modificationMetadata?.readOnlyValue).map((p) => ({
     name: p.name,
     label: p.label || p.name,
-    object,
+    object: object.name,
     type: p.type,
     options: (p.options ?? []).map((o) => o.value),
     group: p.groupName
   }));
 }
-async function listProperties(strapi, apiKey, { force = false } = {}) {
-  if (!force && cache && Date.now() - cache.at < TTL_MS) return cache.properties;
+async function fetchPortalId(apiKey) {
+  try {
+    const { portalId } = await hsGet(apiKey, "/account-info/v3/details");
+    return portalId;
+  } catch {
+    return void 0;
+  }
+}
+async function loadSchema(strapi, apiKey, objects, { force = false } = {}) {
+  if (!force && cache && Date.now() - cache.at < TTL_MS) return cache.schema;
   if (!force && inFlight) return inFlight;
   inFlight = (async () => {
     try {
-      const [contact, company] = await Promise.all([
-        fetchObject(apiKey, "contact"),
-        fetchObject(apiKey, "company")
-      ]);
-      const properties = [...contact, ...company].sort(
+      const settled = await Promise.all(
+        objects.map(async (object) => {
+          try {
+            return { object, properties: await fetchObject(apiKey, object) };
+          } catch (err) {
+            return { object, error: err.message };
+          }
+        })
+      );
+      const properties = [];
+      const available = [];
+      const unavailable = [];
+      for (const entry of settled) {
+        if ("error" in entry && entry.error) {
+          unavailable.push({ object: entry.object.name, reason: entry.error });
+          strapi.log.warn(`[hubspot] ${entry.object.name} illisible — ${entry.error}`);
+          continue;
+        }
+        available.push(entry.object.name);
+        properties.push(...entry.properties ?? []);
+      }
+      if (!available.length) {
+        throw new Error(unavailable[0]?.reason ?? "Aucun objet lisible");
+      }
+      properties.sort(
         (a, b) => a.object.localeCompare(b.object) || a.label.localeCompare(b.label)
       );
-      cache = { at: Date.now(), properties };
-      return properties;
+      const schema = {
+        properties,
+        objects: available,
+        unavailable,
+        portalId: await fetchPortalId(apiKey)
+      };
+      cache = { at: Date.now(), schema };
+      return schema;
     } finally {
       inFlight = null;
     }
@@ -52,12 +101,28 @@ function checkProperty(properties, object, name) {
   if (!trimmed) return null;
   const match = properties.find((p) => p.object === object && p.name === trimmed);
   if (match) return trimmed === name ? null : `« ${name} » contient un espace superflu`;
-  const onOther = properties.find((p) => p.object !== object && p.name === trimmed);
+  const onOther = properties.find((p) => p.name === trimmed);
   if (onOther) {
-    return `« ${trimmed} » existe sur l'objet ${onOther.object === "contact" ? "Contact" : "Société"}, pas sur ${object === "contact" ? "Contact" : "Société"}`;
+    return `« ${trimmed} » existe sur l'objet ${onOther.object}, pas sur ${object}`;
   }
   return `« ${trimmed} » n'existe pas dans ce portail HubSpot`;
 }
+function resolveObjects(configured) {
+  if (!Array.isArray(configured) || !configured.length) {
+    return STANDARD_OBJECTS.filter((o) => o.name === "contact" || o.name === "company");
+  }
+  const out = [];
+  for (const entry of configured) {
+    if (typeof entry === "string") {
+      const known = STANDARD_OBJECTS.find((o) => o.name === entry || o.path === entry);
+      out.push(known ?? { name: entry, path: entry });
+    } else if (entry && typeof entry === "object" && "name" in entry) {
+      const e = entry;
+      out.push({ name: e.name, path: e.path || e.name });
+    }
+  }
+  return out;
+}
 const ENV_VAR = "HUBSPOT_API_KEY";
 const store = (strapi) => strapi.store({ type: "plugin", name: "hubspot" });
 async function getStoredSettings(strapi) {
@@ -87,6 +152,9 @@ async function publicSettings(strapi) {
 const config = {
   default: {
     apiKey: "",
+    // Objects whose properties are offered. Names from the standard set, or
+    // `{ name, path }` for a custom object type.
+    objects: ["contact", "company"],
     validate: []
   },
   validator(cfg) {
@@ -100,14 +168,17 @@ const controllers = {
     async list(ctx) {
       const { apiKey } = await resolveApiKey(strapi);
       if (!apiKey) {
-        ctx.body = { configured: false, properties: [] };
+        ctx.body = { configured: false, properties: [], objects: [], unavailable: [] };
         return;
       }
       try {
-        const properties = await listProperties(strapi, apiKey, {
-          force: ctx.query.refresh === "1"
-        });
-        ctx.body = { configured: true, properties };
+        const schema = await loadSchema(
+          strapi,
+          apiKey,
+          resolveObjects(strapi.plugin("hubspot").config("objects", [])),
+          { force: ctx.query.refresh === "1" }
+        );
+        ctx.body = { configured: true, ...schema };
       } catch (err) {
         strapi.log.error(`[hubspot] ${err.message}`);
         ctx.throw(502, "Impossible de joindre HubSpot — vérifiez la clé API.");
@@ -155,8 +226,9 @@ function collectMappings(node, target, found = []) {
   const obj = node;
   const property = obj[target.propertyField];
   if (typeof property === "string" && property.trim()) {
+    const object = obj[target.objectField];
     found.push({
-      object: obj[target.objectField] === "company" ? "company" : "contact",
+      object: typeof object === "string" && object ? object : "contact",
       property
     });
   }
@@ -185,14 +257,18 @@ const index = {
         if (!mappings.length) return next();
         const { apiKey } = await resolveApiKey(strapi);
         if (!apiKey) return next();
-        let properties;
+        let schema;
         try {
-          properties = await listProperties(strapi, apiKey);
+          schema = await loadSchema(
+            strapi,
+            apiKey,
+            resolveObjects(strapi.plugin("hubspot").config("objects", []))
+          );
         } catch {
           strapi.log.warn("[hubspot] schéma indisponible — validation ignorée");
           return next();
         }
-        const problems = mappings.map((m) => checkProperty(properties, m.object, m.property)).filter((reason) => Boolean(reason));
+        const problems = mappings.map((m) => checkProperty(schema.properties, m.object, m.property)).filter((reason) => Boolean(reason));
         if (problems.length) {
           throw new utils.errors.ValidationError(
             `Mapping HubSpot invalide — ${[...new Set(problems)].join(" ; ")}`

package/dist/server/index.mjs

@@ -1,42 +1,91 @@
 import { errors } from "@strapi/utils";
 const HS_BASE = "https://api.hubapi.com";
 const TTL_MS = 10 * 60 * 1e3;
-const PLURAL = {
-  contact: "contacts",
-  company: "companies"
-};
+const STANDARD_OBJECTS = [
+  { name: "contact", path: "contacts" },
+  { name: "company", path: "companies" },
+  { name: "deal", path: "deals" },
+  { name: "ticket", path: "tickets" },
+  { name: "product", path: "products" },
+  { name: "line_item", path: "line_items" },
+  { name: "quote", path: "quotes" }
+];
 let cache = null;
 let inFlight = null;
-async function fetchObject(apiKey, object) {
-  const res = await fetch(`${HS_BASE}/crm/v3/properties/${PLURAL[object]}`, {
+async function hsGet(apiKey, path) {
+  const res = await fetch(`${HS_BASE}${path}`, {
     headers: { Authorization: `Bearer ${apiKey}` }
-  }).then(async (r) => {
-    if (!r.ok) throw new Error(`HubSpot ${r.status} sur ${PLURAL[object]}`);
-    return r.json();
   });
+  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 fetchObject(apiKey, object) {
+  const res = await hsGet(
+    apiKey,
+    `/crm/v3/properties/${object.path}`
+  );
   return (res.results ?? []).filter((p) => !p.modificationMetadata?.readOnlyValue).map((p) => ({
     name: p.name,
     label: p.label || p.name,
-    object,
+    object: object.name,
     type: p.type,
     options: (p.options ?? []).map((o) => o.value),
     group: p.groupName
   }));
 }
-async function listProperties(strapi, apiKey, { force = false } = {}) {
-  if (!force && cache && Date.now() - cache.at < TTL_MS) return cache.properties;
+async function fetchPortalId(apiKey) {
+  try {
+    const { portalId } = await hsGet(apiKey, "/account-info/v3/details");
+    return portalId;
+  } catch {
+    return void 0;
+  }
+}
+async function loadSchema(strapi, apiKey, objects, { force = false } = {}) {
+  if (!force && cache && Date.now() - cache.at < TTL_MS) return cache.schema;
   if (!force && inFlight) return inFlight;
   inFlight = (async () => {
     try {
-      const [contact, company] = await Promise.all([
-        fetchObject(apiKey, "contact"),
-        fetchObject(apiKey, "company")
-      ]);
-      const properties = [...contact, ...company].sort(
+      const settled = await Promise.all(
+        objects.map(async (object) => {
+          try {
+            return { object, properties: await fetchObject(apiKey, object) };
+          } catch (err) {
+            return { object, error: err.message };
+          }
+        })
+      );
+      const properties = [];
+      const available = [];
+      const unavailable = [];
+      for (const entry of settled) {
+        if ("error" in entry && entry.error) {
+          unavailable.push({ object: entry.object.name, reason: entry.error });
+          strapi.log.warn(`[hubspot] ${entry.object.name} illisible — ${entry.error}`);
+          continue;
+        }
+        available.push(entry.object.name);
+        properties.push(...entry.properties ?? []);
+      }
+      if (!available.length) {
+        throw new Error(unavailable[0]?.reason ?? "Aucun objet lisible");
+      }
+      properties.sort(
         (a, b) => a.object.localeCompare(b.object) || a.label.localeCompare(b.label)
       );
-      cache = { at: Date.now(), properties };
-      return properties;
+      const schema = {
+        properties,
+        objects: available,
+        unavailable,
+        portalId: await fetchPortalId(apiKey)
+      };
+      cache = { at: Date.now(), schema };
+      return schema;
     } finally {
       inFlight = null;
     }
@@ -51,12 +100,28 @@ function checkProperty(properties, object, name) {
   if (!trimmed) return null;
   const match = properties.find((p) => p.object === object && p.name === trimmed);
   if (match) return trimmed === name ? null : `« ${name} » contient un espace superflu`;
-  const onOther = properties.find((p) => p.object !== object && p.name === trimmed);
+  const onOther = properties.find((p) => p.name === trimmed);
   if (onOther) {
-    return `« ${trimmed} » existe sur l'objet ${onOther.object === "contact" ? "Contact" : "Société"}, pas sur ${object === "contact" ? "Contact" : "Société"}`;
+    return `« ${trimmed} » existe sur l'objet ${onOther.object}, pas sur ${object}`;
   }
   return `« ${trimmed} » n'existe pas dans ce portail HubSpot`;
 }
+function resolveObjects(configured) {
+  if (!Array.isArray(configured) || !configured.length) {
+    return STANDARD_OBJECTS.filter((o) => o.name === "contact" || o.name === "company");
+  }
+  const out = [];
+  for (const entry of configured) {
+    if (typeof entry === "string") {
+      const known = STANDARD_OBJECTS.find((o) => o.name === entry || o.path === entry);
+      out.push(known ?? { name: entry, path: entry });
+    } else if (entry && typeof entry === "object" && "name" in entry) {
+      const e = entry;
+      out.push({ name: e.name, path: e.path || e.name });
+    }
+  }
+  return out;
+}
 const ENV_VAR = "HUBSPOT_API_KEY";
 const store = (strapi) => strapi.store({ type: "plugin", name: "hubspot" });
 async function getStoredSettings(strapi) {
@@ -86,6 +151,9 @@ async function publicSettings(strapi) {
 const config = {
   default: {
     apiKey: "",
+    // Objects whose properties are offered. Names from the standard set, or
+    // `{ name, path }` for a custom object type.
+    objects: ["contact", "company"],
     validate: []
   },
   validator(cfg) {
@@ -99,14 +167,17 @@ const controllers = {
     async list(ctx) {
       const { apiKey } = await resolveApiKey(strapi);
       if (!apiKey) {
-        ctx.body = { configured: false, properties: [] };
+        ctx.body = { configured: false, properties: [], objects: [], unavailable: [] };
         return;
       }
       try {
-        const properties = await listProperties(strapi, apiKey, {
-          force: ctx.query.refresh === "1"
-        });
-        ctx.body = { configured: true, properties };
+        const schema = await loadSchema(
+          strapi,
+          apiKey,
+          resolveObjects(strapi.plugin("hubspot").config("objects", [])),
+          { force: ctx.query.refresh === "1" }
+        );
+        ctx.body = { configured: true, ...schema };
       } catch (err) {
         strapi.log.error(`[hubspot] ${err.message}`);
         ctx.throw(502, "Impossible de joindre HubSpot — vérifiez la clé API.");
@@ -154,8 +225,9 @@ function collectMappings(node, target, found = []) {
   const obj = node;
   const property = obj[target.propertyField];
   if (typeof property === "string" && property.trim()) {
+    const object = obj[target.objectField];
     found.push({
-      object: obj[target.objectField] === "company" ? "company" : "contact",
+      object: typeof object === "string" && object ? object : "contact",
       property
     });
   }
@@ -184,14 +256,18 @@ const index = {
         if (!mappings.length) return next();
         const { apiKey } = await resolveApiKey(strapi);
         if (!apiKey) return next();
-        let properties;
+        let schema;
         try {
-          properties = await listProperties(strapi, apiKey);
+          schema = await loadSchema(
+            strapi,
+            apiKey,
+            resolveObjects(strapi.plugin("hubspot").config("objects", []))
+          );
         } catch {
           strapi.log.warn("[hubspot] schéma indisponible — validation ignorée");
           return next();
         }
-        const problems = mappings.map((m) => checkProperty(properties, m.object, m.property)).filter((reason) => Boolean(reason));
+        const problems = mappings.map((m) => checkProperty(schema.properties, m.object, m.property)).filter((reason) => Boolean(reason));
         if (problems.length) {
           throw new errors.ValidationError(
             `Mapping HubSpot invalide — ${[...new Set(problems)].join(" ; ")}`

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

@@ -23,6 +23,7 @@ declare const _default: {
     config: {
         default: {
             apiKey: string;
+            objects: unknown[];
             validate: ValidateTarget[];
         };
         validator(cfg: {

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

@@ -1,23 +1,52 @@
 import type { Core } from "@strapi/strapi";
-export type HsObject = "contact" | "company";
+export interface HsObjectDef {
+    /** Value stored in the entry's object field, e.g. `contact`. */
+    name: string;
+    /** HubSpot's URL segment for that object, e.g. `contacts`. */
+    path: string;
+}
+/** Objects HubSpot ships with; anything else is declared in the plugin config. */
+export declare const STANDARD_OBJECTS: HsObjectDef[];
 export interface HsProperty {
     name: string;
     label: string;
-    object: HsObject;
+    /** Object this property belongs to (`HsObjectDef.name`). */
+    object: string;
     type?: string;
     /** Allowed values, for enumeration properties. */
     options: string[];
     /** HubSpot's own grouping, shown to help editors locate a property. */
     group?: string;
 }
-/** Writable properties of both objects, cached and de-duplicated across calls. */
-export declare function listProperties(strapi: Core.Strapi, apiKey: string, { force }?: {
+export interface Schema {
+    properties: HsProperty[];
+    /** Objects actually readable with the current token. */
+    objects: string[];
+    /** Objects that were configured but refused — almost always a missing scope. */
+    unavailable: {
+        object: string;
+        reason: string;
+    }[];
+    /** Enables deep links into the CRM; derived from the token, never configured. */
+    portalId?: number;
+}
+/**
+ * Writable properties of every configured object, cached and de-duplicated
+ * across concurrent calls.
+ *
+ * An object the token can't read (missing scope) is reported in `unavailable`
+ * instead of failing the whole call: a portal that only granted contact scopes
+ * must still get a working contact picker.
+ */
+export declare function loadSchema(strapi: Core.Strapi, apiKey: string, objects: HsObjectDef[], { force }?: {
     force?: boolean;
-}): Promise<HsProperty[]>;
-/** Drop the cache — used after the API key changes. */
+}): Promise<Schema>;
+/** Drop the cache — used after the API key or the object list changes. */
 export declare function clearCache(): void;
 /**
  * Why a property can't be written, or `null` when it's fine. Returning a reason
  * rather than a boolean lets the caller tell an editor what to fix.
  */
-export declare function checkProperty(properties: HsProperty[], object: HsObject, name: string): string | null;
+export declare function checkProperty(properties: HsProperty[], object: string, name: string): string | null;
+/** Resolve the configured object list, accepting names or full definitions. */
+export declare function resolveObjects(configured: unknown): HsObjectDef[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "strapi-plugin-hubspot",
-  "version": "0.1.0",
-  "description": "HubSpot integration for Strapi — pick CRM properties from a searchable list instead of typing them, and catch bad mappings before they reach the API.",
+  "version": "0.2.0",
+  "description": "HubSpot integration for Strapi — pick CRM properties from a searchable list filtered by object, and catch bad mappings before they reach the API.",
   "keywords": [
     "strapi",
     "plugin",

package/dist/_chunks/HubspotPropertyInput-CTZYZS_7.mjs

@@ -1,84 +0,0 @@
-import { jsxs, jsx } from "react/jsx-runtime";
-import * as React from "react";
-import { Field, Flex, Loader, Combobox, ComboboxOption } from "@strapi/design-system";
-import { useFetchClient } from "@strapi/strapi/admin";
-import { P as PLUGIN_ID } from "./index-CER4BKjS.mjs";
-const OBJECT_LABEL = {
-  contact: "Contact",
-  company: "Société"
-};
-const HubspotPropertyInput = React.forwardRef(
-  ({ name, value, onChange, disabled, error, required, label, hint, labelAction }, ref) => {
-    const { get } = useFetchClient();
-    const [properties, setProperties] = React.useState([]);
-    const [configured, setConfigured] = React.useState(null);
-    const [loadError, setLoadError] = React.useState("");
-    React.useEffect(() => {
-      let cancelled = false;
-      get(`/${PLUGIN_ID}/properties`).then(({ data }) => {
-        if (cancelled) return;
-        setConfigured(data.configured);
-        setProperties(data.properties ?? []);
-      }).catch((err) => {
-        if (cancelled) return;
-        setConfigured(false);
-        setLoadError(
-          err?.response?.data?.error?.message ?? "Propriétés HubSpot indisponibles"
-        );
-      });
-      return () => {
-        cancelled = true;
-      };
-    }, [get]);
-    const emit = (next) => onChange({ target: { name, value: next ?? "", type: "string" } });
-    const describe = () => {
-      if (loadError) return loadError;
-      if (configured === false) {
-        return "Aucune clé API HubSpot — saisie libre. Renseignez-la dans Réglages → HubSpot.";
-      }
-      return hint;
-    };
-    const options = React.useMemo(() => {
-      const known = properties.map((p) => ({
-        value: p.name,
-        label: `${OBJECT_LABEL[p.object]} · ${p.label} (${p.name})`
-      }));
-      if (value && !properties.some((p) => p.name === value)) {
-        known.unshift({ value, label: `${value} — inconnue du portail` });
-      }
-      return known;
-    }, [properties, value]);
-    return /* @__PURE__ */ jsxs(Field.Root, { name, error, hint: describe(), required, children: [
-      /* @__PURE__ */ jsx(Field.Label, { action: labelAction, children: label }),
-      configured === null ? /* @__PURE__ */ jsx(Flex, { paddingTop: 2, paddingBottom: 2, children: /* @__PURE__ */ jsx(Loader, { small: true, children: "Chargement des propriétés HubSpot…" }) }) : configured ? /* @__PURE__ */ jsx(
-        Combobox,
-        {
-          ref,
-          value: value || "",
-          onChange: emit,
-          onClear: () => emit(""),
-          disabled,
-          placeholder: "Rechercher une propriété…",
-          creatable: true,
-          onCreateOption: emit,
-          children: options.map((o) => /* @__PURE__ */ jsx(ComboboxOption, { value: o.value, children: o.label }, o.value))
-        }
-      ) : /* @__PURE__ */ jsx(
-        Field.Input,
-        {
-          ref,
-          value: value || "",
-          onChange: (e) => emit(e.target.value),
-          disabled,
-          placeholder: "ex. hs_role, numberofemployees"
-        }
-      ),
-      /* @__PURE__ */ jsx(Field.Hint, {}),
-      /* @__PURE__ */ jsx(Field.Error, {})
-    ] });
-  }
-);
-HubspotPropertyInput.displayName = "HubspotPropertyInput";
-export {
-  HubspotPropertyInput as default
-};