strapi-plugin-hubspot 0.9.0 → 0.11.0

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

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

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

@@ -0,0 +1,79 @@
+/**
+ * The company field's data source: the French government's open
+ * "Recherche d'entreprises" API (recherche-entreprises.api.gouv.fr — INSEE
+ * SIRENE data, no key, ~7 req/s per IP). Two uses:
+ *
+ *  - autocomplete: `searchCompanies(q)` behind the public route, TTL-cached;
+ *  - authority at submission: `resolveSiret(siret)` re-reads the SIRENE
+ *    record server-side — the browser only ever nominates a SIRET, never the
+ *    data that reaches the CRM.
+ */
+import type { Primitive } from "./conditions";
+export type CompanyDatum = "name" | "siret" | "siren" | "address" | "zip" | "city" | "headquarters" | "naf" | "nafLabel" | "headcount";
+export type CompanyMap = Partial<Record<CompanyDatum, {
+    object?: string;
+    property?: string;
+}>>;
+export interface CompanyHit {
+    siret: string;
+    siren: string;
+    name: string;
+    address?: string;
+    zip?: string;
+    city?: string;
+    headquarters: boolean;
+    naf?: string;
+    nafLabel?: string;
+    headcount?: string;
+    closed?: boolean;
+}
+/** The slice of the API answer this module reads — everything else ignored. */
+interface ApiEtablissement {
+    siret?: string;
+    adresse?: string;
+    code_postal?: string;
+    libelle_commune?: string;
+    est_siege?: boolean;
+    etat_administratif?: string;
+    activite_principale?: string;
+    tranche_effectif_salarie?: string;
+}
+interface ApiResult {
+    nom_complet?: string;
+    nom_raison_sociale?: string;
+    siren?: string;
+    etat_administratif?: string;
+    activite_principale?: string;
+    tranche_effectif_salarie?: string;
+    siege?: ApiEtablissement;
+    matching_etablissements?: ApiEtablissement[];
+}
+export interface SearchPayload {
+    results?: ApiResult[];
+}
+export declare function nafLabelOf(code?: string): string | undefined;
+export declare function headcountLabelOf(code?: string): string | undefined;
+/**
+ * One entreprise → one hit per relevant établissement: the siège first, then
+ * the établissements the query matched — deduped (the siège often appears in
+ * both lists) and, for search results, stripped of closed ones.
+ */
+export declare function normalizeCompanyHits(payload: SearchPayload): CompanyHit[];
+/**
+ * The exact établissement a SIRET designates in a payload — closed ones
+ * included: at resolution time the visitor already chose it, and hiding the
+ * data would only make the lead poorer.
+ */
+export declare function pickSiret(payload: SearchPayload, siret: string): CompanyHit | null;
+/**
+ * The resolved record → one property bag per CRM object, honoring the field's
+ * `companyMap`. Only complete mappings with an actual value produce a write.
+ */
+export declare function companyProperties(map: CompanyMap, hit: CompanyHit): Record<string, Record<string, Primitive>>;
+/** Autocomplete search. Bounded, cached; empty on any failure. */
+export declare function searchCompanies(q: string): Promise<CompanyHit[]>;
+/** Authoritative re-resolution of a selected SIRET; null when unreachable. */
+export declare function resolveSiret(siret: string): Promise<CompanyHit | null>;
+/** Test hook. */
+export declare function clearCompanyCache(): void;
+export {};

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

@@ -2,12 +2,14 @@
  * The condition engine — pure functions, no Strapi.
  */
 export type Primitive = string | number | boolean;
-export type Operator = "eq" | "neq" | "contains" | "empty" | "notEmpty" | "gt" | "lt";
+export type Operator = "eq" | "neq" | "contains" | "notContains" | "startsWith" | "endsWith" | "empty" | "notEmpty" | "gt" | "lt" | "in" | "notIn";
 export interface Rule {
     /** Stable id (`fld_…`) of the field the rule reads — never its name. */
     field: string;
     operator: Operator;
     value?: string;
+    /** For `in` / `notIn`: the values any one of which satisfies the rule. */
+    values?: string[];
 }
 export interface Condition {
     logic: "and" | "or";
@@ -55,6 +57,10 @@ export type DefinitionError = {
     code: "missing-name";
     fieldId: string;
     name: string;
+} | {
+    code: "companion-collision";
+    fieldId: string;
+    name: string;
 } | {
     code: "unknown-field";
     fieldId?: string;

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

@@ -160,6 +160,9 @@ declare const _default: {
                 rejected: {
                     type: string;
                 };
+                companies: {
+                    type: string;
+                };
             };
         };
     };

package/dist/server/src/data/naf.d.ts

@@ -0,0 +1 @@
+export declare const NAF_LABELS: Record<string, string>;

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

@@ -10,6 +10,7 @@
  */
 import type { Core } from "@strapi/strapi";
 import { type FormDefinition, type Primitive } from "./conditions";
+import { type CompanyHit } from "./company";
 import { checkMapping, type Problem } from "./properties";
 export interface FormEntry {
     name: string;
@@ -76,6 +77,21 @@ export interface SubmitOutcome {
         label: string;
     }[];
 }
+/** What a company field contributed to a submission — persisted with it. */
+export interface CompanyRecord {
+    field: string;
+    siret?: string;
+    name?: string;
+    /** True when the SIRET was re-resolved against SIRENE server-side. */
+    resolved: boolean;
+    closed?: boolean;
+}
+/**
+ * The browser's snapshot of the selected hit (`<name>__company`), used ONLY
+ * when the live re-resolution failed: parsed defensively, whitelisted keys,
+ * clipped strings — never trusted further than a display fallback.
+ */
+export declare function parseCompanySnapshot(raw: unknown): CompanyHit | null;
 export declare function createFormsService(strapi: Core.Strapi, _opts?: {
     sleep?: (ms: number) => Promise<void>;
 }): {

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

@@ -27,6 +27,7 @@ declare const _default: {
                     displayName: string;
                     description: string;
                 };
+                /** RBAC action gating the settings screen and its routes. */
                 options: {
                     draftAndPublish: boolean;
                 };
@@ -166,6 +167,9 @@ declare const _default: {
                     rejected: {
                         type: string;
                     };
+                    companies: {
+                        type: string;
+                    };
                 };
             };
         };
@@ -261,6 +265,15 @@ declare const _default: {
             duplicate(ctx: import("./formsAdmin").Ctx): Promise<void>;
             remove(ctx: import("./formsAdmin").Ctx): Promise<void>;
         };
+        company: () => {
+            /** SIRENE autocomplete for the company field — bounded, cached upstream. */
+            search(ctx: {
+                query: {
+                    q?: string;
+                };
+                body: unknown;
+            }): Promise<void>;
+        };
         submissions: ({ strapi }: {
             strapi: Core.Strapi;
         }) => {

package/dist/shared/types.d.ts

@@ -8,13 +8,27 @@
  *   POST /api/hubspot/forms/:slug/submit  → SubmitResponse (SubmitRequest in)
  */
 
-export type Operator = "eq" | "neq" | "contains" | "empty" | "notEmpty" | "gt" | "lt";
+export type Operator =
+  | "eq"
+  | "neq"
+  | "contains"
+  | "notContains"
+  | "startsWith"
+  | "endsWith"
+  | "empty"
+  | "notEmpty"
+  | "gt"
+  | "lt"
+  | "in"
+  | "notIn";
 
 export interface Rule {
   /** Stable id (`fld_…`) of the field the rule reads — never its name. */
   field: string;
   operator: Operator;
   value?: string;
+  /** For `in` / `notIn`: the values any one of which satisfies the rule. */
+  values?: string[];
 }
 
 export interface Condition {
@@ -31,13 +45,46 @@ export type FieldType =
   | "textarea"
   | "select"
   | "checkbox"
-  | "radio";
+  | "radio"
+  | "company";
 
 export interface FieldOption {
   value: string;
   label?: string;
 }
 
+/** One datum a company field can resolve from SIRENE and map to the CRM. */
+export type CompanyDatum =
+  | "name"
+  | "siret"
+  | "siren"
+  | "address"
+  | "zip"
+  | "city"
+  | "headquarters"
+  | "naf"
+  | "nafLabel"
+  | "headcount";
+
+/** One SIRENE hit, as GET /api/hubspot/company-search serves it. */
+export interface CompanyHit {
+  siret: string;
+  siren: string;
+  name: string;
+  address?: string;
+  zip?: string;
+  city?: string;
+  headquarters: boolean;
+  naf?: string;
+  nafLabel?: string;
+  headcount?: string;
+}
+
+/** GET /api/hubspot/company-search?q= */
+export interface CompanySearchResponse {
+  companies: CompanyHit[];
+}
+
 /** A field as the public endpoint serves it — the CRM mapping is stripped. */
 export interface PublicFormField {
   id: string;
@@ -52,6 +99,8 @@ export interface PublicFormField {
   required?: boolean;
   persist?: "session" | "days30";
   options?: FieldOption[];
+  /** Company fields: rotating placeholder examples, in display order. */
+  placeholderExamples?: string[];
   visibleIf?: Condition | null;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strapi-plugin-hubspot",
-  "version": "0.9.0",
+  "version": "0.11.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",
@@ -100,4 +100,4 @@
   "engines": {
     "node": ">=18.0.0"
   }
-}
+}