@se-studio/hubspot 0.0.0-next16-20260822103555

package/dist/tracking/createHubSpotBootstrapScript.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Inline script for beforeInteractive: initialises _hsq and sets the path
+ * before the HubSpot tracking script loads (SPA Mode B).
+ *
+ * Call with no args in root layouts (SSG-safe): uses `window.location.pathname`
+ * at script execution time. Pass an explicit pathname only for tests or rare cases.
+ */
+export declare function createHubSpotBootstrapScript(pathname?: string): string;
+//# sourceMappingURL=createHubSpotBootstrapScript.d.ts.map

package/dist/tracking/createHubSpotBootstrapScript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createHubSpotBootstrapScript.d.ts","sourceRoot":"","sources":["../../src/tracking/createHubSpotBootstrapScript.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAStE"}

package/dist/tracking/createHubSpotBootstrapScript.js

@@ -0,0 +1,17 @@
+/**
+ * Inline script for beforeInteractive: initialises _hsq and sets the path
+ * before the HubSpot tracking script loads (SPA Mode B).
+ *
+ * Call with no args in root layouts (SSG-safe): uses `window.location.pathname`
+ * at script execution time. Pass an explicit pathname only for tests or rare cases.
+ */
+export function createHubSpotBootstrapScript(pathname) {
+    if (pathname === undefined) {
+        return `var _hsq = window._hsq = window._hsq || [];
+_hsq.push(['setPath', window.location.pathname]);`;
+    }
+    const safePath = pathname.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+    return `var _hsq = window._hsq = window._hsq || [];
+_hsq.push(['setPath', '${safePath}']);`;
+}
+//# sourceMappingURL=createHubSpotBootstrapScript.js.map

package/dist/tracking/createHubSpotBootstrapScript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createHubSpotBootstrapScript.js","sourceRoot":"","sources":["../../src/tracking/createHubSpotBootstrapScript.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAAC,QAAiB;IAC5D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO;kDACuC,CAAC;IACjD,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtE,OAAO;yBACgB,QAAQ,MAAM,CAAC;AACxC,CAAC"}

package/docs/llms.md

@@ -0,0 +1,46 @@
+# @se-studio/hubspot — LLM reference
+
+## Exports
+
+| Import | Contents |
+|--------|----------|
+| `@se-studio/hubspot` | `HubSpotAnalyticsAdapter`, `createHubSpotBootstrapScript`, `HubspotDynamicForm`, `buildDefaultValues`, `captureMarketingParams`, `getMarketingParams`, `applyMarketingParamsToHiddenFields`, `useHubspotSubmit`, `navigateAfterSubmit`, types |
+| `@se-studio/hubspot/server` | `getHubspotFormDefinition`, `submitHubspotForm`, `hubspotFormTag` |
+| `@se-studio/hubspot/external` | `createHubspotFormExternalRenderer` |
+
+## CMS external component
+
+- `externalComponentType`: `"Hubspot form"`
+- `data.formId` (required): HubSpot form GUID
+- `data.portalId` (optional): defaults to `HUBSPOT_PORTAL_ID`
+- Hidden UTM fields: `HubspotDynamicForm` auto-fills empty hidden fields from URL query + first-touch `sessionStorage` (`utm_source`, etc.). CMS `hiddenFields` override. Forks should import `buildDefaultValues` / `applyMarketingParamsToHiddenFields` rather than reimplementing.
+
+## Post-submit
+
+Not native HubSpot embed — client must handle redirect/thank-you.
+
+Priority: `redirectUrlOverride` → submit `redirectUri` → form `postSubmitAction.redirect_url` → thank-you / inline message.
+
+- External URLs → `window.location.assign` (via `navigateAfterSubmit`)
+- Same-origin → `router.push`
+- `onSuccess` is a **side-effect only** — does not suppress redirect/thank-you
+- Preserve full `redirectUri` from HubSpot (do not strip host)
+
+```tsx
+useHubspotSubmit({ portalId, formDefinition, onSuccess, redirectUrlOverride })
+// or
+<HubspotDynamicForm redirectUrlOverride={url} onSuccess={fn} ... />
+```
+
+After HubSpot form editor changes, revalidate: `revalidateTag(hubspotFormTag(formId), { expire: 0 })` (definitions cached ~1h). Do not use `'max'` — that is stale-while-revalidate.
+
+## Analytics
+
+Use with `CompositeAnalyticsAdapter` + `AnalyticsPageTracker` from `@se-studio/core-ui`. HubSpot SPA Mode B: bootstrap `setPath` before script load; `AnalyticsPageTracker` skips first mount.
+
+**SSG layouts:** call `createHubSpotBootstrapScript()` with **no args** in root layout. Do **not** use `headers()` or middleware to pass pathname — that breaks on-demand SSG routes in `next start`.
+
+## Env
+
+- `HUBSPOT_PORTAL_ID` — tracking + submit URL
+- `HUBSPOT_PAT` — Marketing Forms API (server only)

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@se-studio/hubspot",
+  "version": "0.0.0-next16-20260822103555",
+  "description": "HubSpot tracking and API-driven form rendering for Next.js marketing sites",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Something-Else-Studio/se-core-product",
+    "directory": "packages/hubspot"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./external": {
+      "types": "./dist/external/createHubspotFormExternalRenderer.d.ts",
+      "import": "./dist/external/createHubspotFormExternalRenderer.js"
+    }
+  },
+  "files": [
+    "dist",
+    "*.md",
+    "docs"
+  ],
+  "keywords": [
+    "hubspot",
+    "forms",
+    "analytics",
+    "nextjs",
+    "contentful",
+    "typescript",
+    "react"
+  ],
+  "peerDependencies": {
+    "next": ">=15.5.0 <17",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@se-studio/core-data-types": "1.12.0",
+    "@se-studio/core-ui": "0.0.0-next16-20260822103555"
+  },
+  "dependencies": {
+    "@hubspot/api-client": "^14.0.1",
+    "html-entities": "^2.6.0",
+    "server-only": "0.0.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.5",
+    "@types/node": "^24.13.3",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "jsdom": "^29.1.1",
+    "next": "^16.3.1",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10",
+    "@se-studio/core-data-types": "1.12.0",
+    "@se-studio/core-ui": "0.0.0-next16-20260822103555"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "dev": "tsc --project tsconfig.build.json --watch",
+    "type-check": "tsc --noEmit",
+    "lint": "biome lint .",
+    "test": "vitest run",
+    "clean": "rm -rf dist .turbo *.tsbuildinfo"
+  }
+}