@woodsportal/hubspot-kit 1.0.41-dev.4 → 1.0.41-dev.6

package/examples/greenfield/module-hybrid-cdn-auth-starter/src/utils/resolve-api-base-url.ts

@@ -0,0 +1,44 @@
+import { env } from '@/env'
+
+type HubSpotRuntimeData = {
+  developerOption?: boolean
+  developerOptionTempUrl?: string
+}
+
+type HubSpotRuntimeWindow = Window & {
+  hubSpotData?: HubSpotRuntimeData
+  /** Module-config live exports in `wp dev` / `yarn local` (see wphs.adapter.ts). */
+  __WPHS_DATA__?: HubSpotRuntimeData
+}
+
+function readHubSpotRuntimeData(): HubSpotRuntimeData | undefined {
+  if (typeof window === 'undefined') {
+    return undefined
+  }
+  const win = window as HubSpotRuntimeWindow
+  return win.hubSpotData ?? win.__WPHS_DATA__
+}
+
+/**
+ * API host for woodsportal-client-sdk.
+ * Priority: developer temp URL (HubSpot embed) → `VITE_PUBLIC_REST_API_ENDPOINT`.
+ * WoodsCLI dev (`__WPHS_DATA__` without HubL `hubSpotData`) always uses the Vite env URL.
+ */
+export function resolveWoodsPortalApiBaseUrl(
+  hubSpotData: HubSpotRuntimeData | undefined = readHubSpotRuntimeData(),
+): string {
+  const envApi = env.VITE_PUBLIC_REST_API_ENDPOINT
+
+  if (import.meta.env.DEV && typeof window !== 'undefined') {
+    const win = window as HubSpotRuntimeWindow
+    if (win.__WPHS_DATA__ != null && win.hubSpotData == null) {
+      return envApi
+    }
+  }
+
+  if (hubSpotData?.developerOption === true && hubSpotData.developerOptionTempUrl) {
+    return hubSpotData.developerOptionTempUrl
+  }
+
+  return envApi
+}

package/examples/greenfield/module-hybrid-cdn-auth-starter/src/utils/safe-router-navigation.ts

@@ -0,0 +1,82 @@
+export type SafeAuthRouter = {
+  navigate: (opts: { to: string; replace?: boolean }) => void | Promise<void>
+  history?: { replace: (path: string) => unknown }
+  state?: { location?: { pathname?: string; href?: string } }
+}
+
+export const NAVIGATION_WAIT_MS = 2500
+
+const PATHNAME_VERIFY_DELAY_MS = 100
+
+export function hashPath(path: string): string {
+  const trimmed = (path ?? '').trim()
+  if (!trimmed) {
+    return '#/'
+  }
+  if (trimmed.startsWith('#')) {
+    return trimmed
+  }
+  return trimmed.startsWith('/') ? `#${trimmed}` : `#/${trimmed}`
+}
+
+export function syncHashToPath(path: string): void {
+  if (typeof window === 'undefined') {
+    return
+  }
+  const expectedHash = hashPath(path)
+  if (window.location.hash !== expectedHash) {
+    window.location.hash = expectedHash
+  }
+}
+
+export async function raceNavigation(
+  router: SafeAuthRouter,
+  target: string,
+  timeoutMs: number = NAVIGATION_WAIT_MS,
+): Promise<void> {
+  await Promise.race([
+    Promise.resolve(router.navigate({ to: target, replace: true })).catch(() => undefined),
+    new Promise<void>((resolve) => window.setTimeout(resolve, timeoutMs)),
+  ])
+}
+
+export async function historyReplaceFirstNavigate(
+  router: SafeAuthRouter,
+  target: string,
+): Promise<void> {
+  const normalized = target.trim()
+  if (!normalized) {
+    return
+  }
+  try {
+    router.history?.replace(normalized)
+  } catch {
+    // fall through
+  }
+  await raceNavigation(router, normalized, NAVIGATION_WAIT_MS)
+  syncHashToPath(normalized)
+}
+
+export function hardReplaceToHashPath(target: string): void {
+  if (typeof window === 'undefined') {
+    return
+  }
+  const hash = hashPath(target)
+  window.location.replace(`${window.location.pathname}${hash}`)
+}
+
+export function readRouterPathname(router: SafeAuthRouter): string {
+  return router.state?.location?.pathname ?? ''
+}
+
+export function readHashPathname(): string {
+  if (typeof window === 'undefined') {
+    return ''
+  }
+  const raw = window.location.hash.replace(/^#/, '').split('?')[0]
+  return raw || '/'
+}
+
+export function safeRouterReplace(router: SafeAuthRouter, path: string): void {
+  void historyReplaceFirstNavigate(router, path.trim())
+}

package/examples/greenfield/module-hybrid-cdn-auth-starter/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "jsx": "react-jsx",
+    "module": "ESNext",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "types": ["vite/client"],
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src/**/*.ts", "src/**/*.tsx", "wphs.adapter.ts"]
+}

package/examples/greenfield/module-hybrid-cdn-auth-starter/vite.config.cdn-app.mjs

@@ -0,0 +1 @@
+export { default } from '@woodsportal/hubspot-kit/vite/vite.config.cdn-app.mjs'

package/examples/greenfield/module-hybrid-cdn-auth-starter/vite.config.cdn-esm.mjs

@@ -0,0 +1 @@
+export { default } from '@woodsportal/hubspot-kit/vite/vite.config.cdn-esm.mjs'

package/examples/greenfield/module-hybrid-cdn-auth-starter/vite.config.cdn-vendor.mjs

@@ -0,0 +1 @@
+export { default } from '@woodsportal/hubspot-kit/vite/vite.config.cdn-vendor.mjs'

package/examples/greenfield/module-hybrid-cdn-auth-starter/vite.config.dev.mjs

@@ -0,0 +1 @@
+export { default } from '@woodsportal/hubspot-kit/vite/vite.config.dev.mjs'

package/examples/greenfield/module-hybrid-cdn-auth-starter/vite.config.hubspot.mjs

@@ -0,0 +1 @@
+export { default } from '@woodsportal/hubspot-kit/vite/vite.config.hubspot.mjs'

package/examples/greenfield/module-hybrid-cdn-auth-starter/vite.config.monolith.mjs

@@ -0,0 +1,8 @@
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+if (!process.env.WP_HS_PROJECT_ROOT?.trim()) {
+  process.env.WP_HS_PROJECT_ROOT = resolve(dirname(fileURLToPath(import.meta.url)))
+}
+
+export { default } from '@woodsportal/hubspot-kit/vite/vite.config.monolith.mjs'

package/examples/greenfield/module-hybrid-cdn-auth-starter/woodscli.json

@@ -0,0 +1,38 @@
+{
+  "configVersion": 1,
+  "projectType": "module-hybrid-cdn",
+  "module": {
+    "name": "module-hybrid-cdn-auth-starter",
+    "uploadPath": "dw-modules/module-hybrid-cdn-auth-starter.module",
+    "outDir": "dist/ModuleHybridCdnAuthStarter.Module"
+  },
+  "cdn": {
+    "mode": "jsdelivr",
+    "buildIdFile": ".module-build-id",
+    "mirror": "portal.cdn.json"
+  },
+  "entries": {
+    "app": "src/cdn/app-entry.ts",
+    "vendor": "src/cdn/vendor-entry.ts",
+    "hubspotBootstrap": "src/hubspot/bootstrap.ts",
+    "module": "src/hubspot/module-entry.tsx",
+    "localDev": "src/main.tsx"
+  },
+  "env": {
+    "tiers": [
+      "dev",
+      "stg",
+      "prod"
+    ]
+  },
+  "dev": {
+    "moduleConfigDir": ".wphs",
+    "adapter": "./wphs.adapter.ts",
+    "fieldsJson": "public/fields.json"
+  },
+  "scaffold": {
+    "router": "hash",
+    "auth": "starter",
+    "nav": "top"
+  }
+}

package/examples/greenfield/module-hybrid-cdn-auth-starter/wphs.adapter.ts

@@ -0,0 +1,7 @@
+import type { HubSpotKitAdapter } from '@woodsportal/hubspot-kit'
+const adapter: HubSpotKitAdapter = {
+  syncLiveData(built) {
+    ;(window as Window & { __WPHS_DATA__?: Record<string, unknown> }).__WPHS_DATA__ = built
+  },
+}
+export default adapter

package/examples/greenfield/module-hybrid-cdn-auth-starter-sidebar/.env.dev.example

@@ -0,0 +1,3 @@
+# Deployed dev CDN build (deploy:dev, ci:release-module:dev) — copy to .env.dev
+VITE_NODE_ENV=dev
+VITE_PUBLIC_REST_API_ENDPOINT=https://api.dev.woodsportal.com

package/examples/greenfield/module-hybrid-cdn-auth-starter-sidebar/.env.local.example

@@ -0,0 +1,6 @@
+# Localhost SPA (yarn local / wp local) — copy to .env.local
+VITE_NODE_ENV=local
+VITE_DEV_MODE=live
+VITE_PUBLIC_REST_API_ENDPOINT=https://api.dev.woodsportal.com
+# VITE_DEV_PORTAL_ID=1
+# VITE_LOCAL_HUB_ID=12345678

package/examples/greenfield/module-hybrid-cdn-auth-starter-sidebar/.env.prod.example

@@ -0,0 +1,5 @@
+# Production CDN build — copy to .env.prod (or run wp setup)
+VITE_NODE_ENV=prod
+VITE_PORTAL_EMBED_MODE=cdn
+VITE_PUBLIC_REST_API_ENDPOINT=https://api.woodsportal.com
+# PORTAL_CDN_PUBLISH_TOKEN is written to .env.local by wp init / wp setup (hybrid CDN) — gitignored

package/examples/greenfield/module-hybrid-cdn-auth-starter-sidebar/.env.stg.example

@@ -0,0 +1,3 @@
+# Reserved — future staging CDN (wp build --tier stg). Copy to .env.stg when a staging API exists.
+VITE_NODE_ENV=stg
+# VITE_PUBLIC_REST_API_ENDPOINT=https://api.stg.woodsportal.com

package/examples/greenfield/module-hybrid-cdn-auth-starter-sidebar/.wphs/README.md

@@ -0,0 +1,17 @@
+# WoodsCLI workspace (.wphs/)
+
+Local state for **WoodsCLI** (`@woodsportal/hubspot-kit`). Not shipped to HubSpot.
+
+| Path | Purpose |
+|------|---------|
+| `config/module-config.local.json` | Live Content/Styles values (gitignored) |
+| `config/module-config.example.json` | Example generated from `fields.json` |
+| `assets/branding/` | Dev-tool uploaded images (gitignored) |
+| `fixtures/` | Optional preview / hubspot-data overrides |
+| `cache/` | CLI caches (gitignored) |
+| `audit/baseline/` | Build parity snapshots (gitignored) |
+| `.kit-module-config` | Symlink to kit dev-module-config |
+| `.kit-bootstrap.tsx` | Symlink to kit dev bootstrap (full portal) |
+| `.kit-bootstrap-greenfield.tsx` | Symlink to kit greenfield dev bootstrap |
+
+Run `wp doctor` to recreate missing folders.

package/examples/greenfield/module-hybrid-cdn-auth-starter-sidebar/README.md

@@ -0,0 +1,59 @@
+# Getting started
+
+This project was scaffolded with **WoodsCLI** (`@woodsportal/hubspot-kit`).
+
+## Daily dev
+
+```bash
+yarn install
+wp doctor
+wp dev
+```
+
+Open the local URL, then **Ctrl+Shift+Z** (Mac **⌃⇧Z**) to edit module fields. Click **Apply changes** to refresh the starter preview.
+
+## Routing (`wp init`)
+
+Default is **hash history** — same as `woodsportal-client-frontend` (`#/guide` URLs work in HubSpot CMS).
+
+| `wp init --router` | Behavior |
+|--------------------|----------|
+| `hash` (default) | `createHashHistory()` — production-safe in HubSpot embeds |
+| `browser` | Clean `/guide` URLs for local dev only |
+| `none` | Single-page starter, no TanStack Router |
+
+Recorded in `woodscli.json` → `scaffold.router`.
+
+## `src/` layout
+
+| Path | Purpose |
+|------|---------|
+| `main.tsx` | Dev entry — loads styles and `mountDevPreview()` |
+| `app.tsx` | `RouterProvider` shell (client-frontend pattern) |
+| `config/router.ts` | Hash vs browser history |
+| `portal/` | Dev vs production mount (`mount-dev-preview`, `mount-portal`) |
+| `routes/` | TanStack file routes — keep thin; import from `features/` |
+| `features/starter/` | Demo home + developer guide (replace with your app) |
+| `components/` | Shared layout and UI |
+| `integrations/` | Router and third-party wiring |
+| `hubspot/` | HubSpot types and dev fixtures |
+| `config/` | Route constants and app config |
+| `assets/css/` | Tailwind entry for local dev |
+
+Kit runtime expects `src/defaultData.ts` (re-exports `hubspot/default-data.ts`).
+
+## Docs (in the kit package)
+
+After `npm install`, see:
+
+- `node_modules/@woodsportal/hubspot-kit/docs/CLI-REFERENCE.md`
+- `node_modules/@woodsportal/hubspot-kit/docs/MODULES.md`
+- `node_modules/@woodsportal/hubspot-kit/docs/HUBSPOT-CLI-SETUP.md`
+
+## HubSpot upload
+
+```bash
+cp hubspot.config.yml.example hubspot.config.yml
+# add portal + personal access key
+wp upload
+```

package/examples/greenfield/module-hybrid-cdn-auth-starter-sidebar/hubspot.config.yml.example

@@ -0,0 +1,10 @@
+# HubSpot CLI personal access key — copy to hubspot.config.yml (gitignored).
+# Generate at: https://app.hubspot.com/l/personal-access-key
+# Docs: https://developers.hubspot.com/docs/cms/developer-reference/local-development-cli
+
+defaultPortal: your-portal-id
+portals:
+  - name: staging
+    portalId: 12345678
+    authType: personalaccesskey
+    personalAccessKey: YOUR_PAT_HERE

package/examples/greenfield/module-hybrid-cdn-auth-starter-sidebar/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>WoodsCLI dev</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/examples/greenfield/module-hybrid-cdn-auth-starter-sidebar/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "module-hybrid-cdn-auth-starter",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "local": "wp dev",
+    "doctor": "wp doctor",
+    "build:prod": "wp build --tier prod",
+    "deploy:prod": "wp deploy --tier prod --yes",
+    "dev": "wp dev",
+    "build:dev": "wp build --tier dev",
+    "deploy:dev": "wp deploy --tier dev --yes"
+  },
+  "devDependencies": {
+    "@woodsportal/hubspot-kit": "^1.0.30",
+    "@dnd-kit/core": "^6.3.1",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
+    "@tailwindcss/vite": "^4.0.6",
+    "@tanstack/react-router": "^1.121.2",
+    "@tanstack/router-plugin": "^1.121.2",
+    "@vitejs/plugin-react": "^4.3.4",
+    "babel-plugin-react-compiler": "^1.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tailwindcss": "^4.0.6",
+    "vite": "^6.1.0",
+    "woodsportal-client-sdk": "^4.0.7-dev.11",
+    "@tanstack/react-query": "^5.66.9",
+    "@t3-oss/env-core": "^0.12.0",
+    "zod": "^3.24.2",
+    "sonner": "^2.0.1"
+  }
+}

package/examples/greenfield/module-hybrid-cdn-auth-starter-sidebar/portal.cdn.json.example

@@ -0,0 +1,8 @@
+{
+  "publishMode": "jsdelivr",
+  "github": "your-org/your-portal-cdn-mirror",
+  "gitRemote": "https://github.com/your-org/your-portal-cdn-mirror.git",
+  "cdnPathInRepo": "dist/cdn",
+  "defaultBranch": "main",
+  "_note": "Forks: point github/gitRemote at your jsDelivr mirror repo, or set cdn.mode custom in woodscli.json."
+}

package/examples/greenfield/module-hybrid-cdn-auth-starter-sidebar/public/fields.json

@@ -0,0 +1,100 @@
+[
+  {
+    "type": "group",
+    "name": "content",
+    "label": "Content",
+    "tab": "CONTENT",
+    "children": [
+      {
+        "name": "title",
+        "label": "Portal title",
+        "type": "text",
+        "default": "My HubSpot Portal"
+      },
+      {
+        "name": "tagline",
+        "label": "Tagline",
+        "type": "text",
+        "display": "textarea",
+        "help_text": "Subtitle shown under the hero title.",
+        "default": "Customize this preview with Ctrl+Shift+Z, then replace StarterPage with your portal app."
+      },
+      {
+        "name": "show_feature_cards",
+        "label": "Show feature cards",
+        "type": "boolean",
+        "display": "toggle",
+        "default": true
+      }
+    ]
+  },
+  {
+    "type": "group",
+    "name": "style",
+    "label": "Style",
+    "tab": "STYLE",
+    "children": [
+      {
+        "type": "group",
+        "name": "module_global_colors",
+        "label": "Module Global Colors",
+        "tab": "STYLE",
+        "children": [
+          {
+            "name": "primary_color",
+            "label": "Primary Color",
+            "type": "color",
+            "default": {
+              "color": "#FF7A59",
+              "opacity": 100
+            }
+          },
+          {
+            "name": "secondary_color",
+            "label": "Secondary Color",
+            "type": "color",
+            "default": {
+              "color": "#2797AF",
+              "opacity": 100
+            }
+          },
+          {
+            "name": "button_text_color",
+            "label": "Button Text Color",
+            "type": "color",
+            "default": {
+              "color": "#FFFFFF",
+              "opacity": 100
+            }
+          }
+        ],
+        "default": {
+          "primary_color": {
+            "color": "#FF7A59",
+            "opacity": 100
+          },
+          "secondary_color": {
+            "color": "#2797AF",
+            "opacity": 100
+          },
+          "button_text_color": {
+            "color": "#FFFFFF",
+            "opacity": 100
+          }
+        }
+      },
+      {
+        "name": "hero_style",
+        "label": "Hero style",
+        "type": "choice",
+        "display": "select",
+        "choices": [
+          ["gradient", "Gradient"],
+          ["minimal", "Minimal"],
+          ["bold", "Bold"]
+        ],
+        "default": "gradient"
+      }
+    ]
+  }
+]

package/examples/greenfield/module-hybrid-cdn-auth-starter-sidebar/public/meta.json

@@ -0,0 +1,9 @@
+{
+  "label": "WoodsPortal hybrid module",
+  "css_assets": [],
+  "external_js": [],
+  "global": false,
+  "host_template_types": ["PAGE", "BLOG_POST", "BLOG_LISTING"],
+  "content_types": ["SITE_PAGE", "LANDING_PAGE", "BLOG_POST", "BLOG_LISTING"],
+  "is_available_for_new_content": true
+}

package/examples/greenfield/module-hybrid-cdn-auth-starter-sidebar/public/module.html

@@ -0,0 +1,38 @@
+{# Hybrid CDN — React app loads from jsDelivr; module.js is a thin bootstrap only. #}
+{% set in_cms_editor = is_in_editor or is_in_page_editor or is_in_previewer %}
+{% require_css %}
+<style>
+{% scope_css %}
+:root {
+  --primary-color: {{ module.style.module_global_colors.primary_color.color|default('#FF7A59') }};
+  --secondary-color: {{ module.style.module_global_colors.secondary_color.color|default('#2797AF') }};
+  --button-text-color: {{ module.style.module_global_colors.button_text_color.color|default('#FFFFFF') }};
+}
+p:not([class]) {
+  margin: 0;
+}
+ul, ol {
+  margin: 0;
+}
+{% end_scope_css %}
+</style>
+{% end_require_css %}
+<script>
+  window.hsInEditor = {{ in_cms_editor|lower }};
+  window.hubSpotData = {
+    title: {{ module.content.title|default(module.title)|tojson }},
+    tagline: {{ module.content.tagline|default(module.tagline)|tojson }},
+    show_feature_cards: {{ module.content.show_feature_cards|default(module.show_feature_cards)|lower }},
+    hero_style: {{ module.style.hero_style|tojson }},
+    assetBaseUrl: "__PORTAL_CDN_BASE__",
+    buildId: "__PORTAL_BUILD_ID__",
+    isInEditor: {{ in_cms_editor|lower }}
+  };
+</script>
+{% set portal_cdn_base = "__PORTAL_CDN_BASE__" %}
+{% set portal_vendor_script = "__PORTAL_VENDOR_FILE__" %}
+{% set portal_app_script = "__PORTAL_APP_FILE__" %}
+{# App styles ship in module.css (HubSpot editor cannot rely on external CDN CSS). #}
+{{ require_js(portal_cdn_base ~ '/' ~ portal_vendor_script, { position: 'footer', defer: true }) }}
+{{ require_js(portal_cdn_base ~ '/' ~ portal_app_script, { position: 'footer', defer: true }) }}
+<div id="app"></div>