@woodsportal/hubspot-kit 1.0.41-dev.0 → 1.0.41-dev.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@woodsportal/hubspot-kit",
-  "version": "1.0.41-dev.0",
+  "version": "1.0.41-dev.2",
   "description": "WoodsCLI — HubSpot CMS dev kit by WoodsPortal. wp CLI, Vite presets, module-config overlay, and theme/module build pipelines.",
   "type": "module",
   "main": "./dist/index.js",

package/scripts/audit-tdz-split.mjs

@@ -3,19 +3,25 @@
  * Usage: node scripts/audit-tdz-split.mjs
  */
 import { defineConfig, build } from 'vite'
-import viteReact from '@vitejs/plugin-react'
-import { TanStackRouterVite } from '@tanstack/router-plugin/vite'
 import { resolve, dirname } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { execSync } from 'node:child_process'
 import { readFileSync, readdirSync, existsSync } from 'node:fs'
-import tailwindcss from '@tailwindcss/vite'
 import tailwindPrefixPlugin from './tailwind/prefix-plugin.js'
 import TailwindContentPlugin from './tailwind/tailwind-content-plugin.js'
 import isPrefix from './tailwind/prefix.env.js'
+import { findProjectRoot } from './project-root.mjs'
+import { importConsumerDep } from './resolve-consumer-dep.mjs'
+
+const [{ default: viteReact }, { TanStackRouterVite }, { default: tailwindcss }] =
+  await Promise.all([
+    importConsumerDep('@vitejs/plugin-react'),
+    importConsumerDep('@tanstack/router-plugin/vite'),
+    importConsumerDep('@tailwindcss/vite'),
+  ])
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
-const root = resolve(__dirname, '..')
+const root = findProjectRoot()
 const outDir = resolve(root, 'dist/TdzAudit')
 const mode = 'production'
 
@@ -42,7 +48,7 @@ const config = defineConfig({
     copyPublicDir: false,
     cssCodeSplit: true,
     lib: {
-      entry: resolve(root, 'src/main.tsx'),
+      entry: resolve(root, 'src/cdn/app-entry.ts'),
       name: 'TdzAuditModule',
       fileName: () => 'module.js',
       formats: ['iife'],

package/scripts/check-cdn-size-regression.mjs

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+/**
+ * Fail when dist/cdn/app.*.js raw size grows more than PORTAL_CDN_APP_SIZE_REGRESSION_PCT vs baseline.
+ * Baseline: docs/audit/cdn-app-size-baseline.json (committed after intentional size changes).
+ */
+import { existsSync, readFileSync, readdirSync, writeFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { findProjectRoot } from './project-root.mjs'
+
+const root = findProjectRoot()
+const cdnDir = resolve(root, 'dist/cdn')
+const baselinePath = resolve(root, 'docs/audit/cdn-app-size-baseline.json')
+const pctLimit = Number(process.env.PORTAL_CDN_APP_SIZE_REGRESSION_PCT ?? 5)
+
+function findAppJs() {
+  if (!existsSync(cdnDir)) return null
+  return readdirSync(cdnDir).find((f) => /^app\..*\.js$/.test(f)) ?? null
+}
+
+const appFile = findAppJs()
+if (!appFile) {
+  console.error('[cdn-regression] dist/cdn/app.*.js missing — run yarn build:cdn first')
+  process.exit(1)
+}
+
+const rawBytes = readFileSync(resolve(cdnDir, appFile)).length
+
+if (!existsSync(baselinePath)) {
+  const baseline = { file: appFile, rawBytes, updatedAt: new Date().toISOString() }
+  writeFileSync(baselinePath, JSON.stringify(baseline, null, 2))
+  console.log(`[cdn-regression] Wrote baseline ${(rawBytes / 1024).toFixed(1)} KiB → ${baselinePath}`)
+  process.exit(0)
+}
+
+const baseline = JSON.parse(readFileSync(baselinePath, 'utf8'))
+const growthPct = ((rawBytes - baseline.rawBytes) / baseline.rawBytes) * 100
+
+console.log(
+  `[cdn-regression] app shell ${(rawBytes / 1024).toFixed(1)} KiB raw (baseline ${(baseline.rawBytes / 1024).toFixed(1)} KiB, ${growthPct >= 0 ? '+' : ''}${growthPct.toFixed(1)}%)`,
+)
+
+if (growthPct > pctLimit) {
+  console.error(
+    `[cdn-regression] FAIL: grew ${growthPct.toFixed(1)}% > ${pctLimit}% limit. Update baseline intentionally or reduce bundle.`,
+  )
+  process.exit(1)
+}
+
+console.log('[cdn-regression] OK')

package/scripts/check-hubspot-bundle-size.mjs

@@ -17,9 +17,9 @@ const embedMode = isMonolith ? 'monolith' : (process.env.VITE_PORTAL_EMBED_MODE
 const HUBSPOT_FILE_LIMIT = Number(process.env.HUBSPOT_MODULE_RAW_LIMIT_BYTES ?? 1.5 * 1024 * 1024)
 const BOOTSTRAP_RAW_LIMIT = Number(process.env.HUBSPOT_BOOTSTRAP_RAW_LIMIT_BYTES ?? 200 * 1024)
 const CDN_CHUNK_RAW_LIMIT = Number(process.env.PORTAL_CDN_CHUNK_RAW_LIMIT_BYTES ?? 1.5 * 1024 * 1024)
-/** Phase 1 app chunk may exceed 1.5 MiB until ESM route splitting (Phase 2). */
+/** App entry chunk — stepped down as multi-chunk splits land (target 1.5 MiB). */
 const CDN_APP_RAW_LIMIT = Number(
-  process.env.PORTAL_CDN_APP_RAW_LIMIT_BYTES ?? 2.3 * 1024 * 1024,
+  process.env.PORTAL_CDN_APP_RAW_LIMIT_BYTES ?? 2.0 * 1024 * 1024,
 )
 
 function checkFile(label, path, rawLimit) {
@@ -52,8 +52,22 @@ if (embedMode === 'monolith') {
     console.error('FAIL: dist/cdn missing — run yarn build:cdn')
     process.exit(1)
   }
-  for (const file of readdirSync(cdnDir).filter((f) => f.endsWith('.js'))) {
-    const limit = file.startsWith('app.') ? CDN_APP_RAW_LIMIT : CDN_CHUNK_RAW_LIMIT
+  function walkJsFiles(dir, prefix = '') {
+    const paths = []
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      const rel = prefix ? `${prefix}/${entry.name}` : entry.name
+      if (entry.isDirectory()) {
+        paths.push(...walkJsFiles(resolve(dir, entry.name), rel))
+      } else if (entry.name.endsWith('.js')) {
+        paths.push(rel)
+      }
+    }
+    return paths
+  }
+
+  for (const file of walkJsFiles(cdnDir)) {
+    const base = file.split('/').pop() ?? file
+    const limit = base.startsWith('app.') ? CDN_APP_RAW_LIMIT : CDN_CHUNK_RAW_LIMIT
     checkFile(`cdn/${file}`, resolve(cdnDir, file), limit)
   }
 }

package/scripts/generate-cdn-bundle-breakdown.mjs

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+/**
+ * Write docs/audit/CDN-BUNDLE-BREAKDOWN.md from cdn-bundle-visualizer.json (rollup-plugin-visualizer v2).
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { findProjectRoot } from './project-root.mjs'
+
+const root = findProjectRoot()
+const jsonPath = resolve(root, 'docs/audit/cdn-bundle-visualizer.json')
+const outPath = resolve(root, 'docs/audit/CDN-BUNDLE-BREAKDOWN.md')
+
+if (!existsSync(jsonPath)) {
+  console.error(
+    `[cdn-breakdown] Missing ${jsonPath} — run: yarn audit:cdn-bundle`,
+  )
+  process.exit(1)
+}
+
+const data = JSON.parse(readFileSync(jsonPath, 'utf8'))
+const { nodeParts = {}, nodeMetas = {} } = data
+
+const leaves = Object.entries(nodeParts)
+  .map(([uid, part]) => {
+    const meta = nodeMetas[uid] ?? {}
+    return {
+      name: meta.id ?? uid,
+      gzipSize: part.gzipSize ?? 0,
+      renderedLength: part.renderedLength ?? 0,
+    }
+  })
+  .filter((n) => n.renderedLength > 0)
+  .sort((a, b) => b.gzipSize - a.gzipSize)
+
+const top = leaves.slice(0, 15)
+const generatedAt = new Date().toISOString()
+
+const lines = [
+  '# CDN app bundle breakdown',
+  '',
+  `Generated: ${generatedAt}`,
+  '',
+  'Source: `yarn audit:cdn-bundle` → `docs/audit/cdn-bundle-visualizer.json`',
+  '',
+  'Top 15 modules by gzip size (CDN app graph):',
+  '',
+  '| Rank | Module | Gzip (KiB) | Raw (KiB) |',
+  '|------|--------|------------|-----------|',
+]
+
+top.forEach((node, i) => {
+  const gzip = node.gzipSize / 1024
+  const raw = node.renderedLength / 1024
+  const name = String(node.name).replace(/\|/g, '\\|')
+  lines.push(`| ${i + 1} | \`${name}\` | ${gzip.toFixed(1)} | ${raw.toFixed(1)} |`)
+})
+
+lines.push('', 'See also: [BUNDLE-STRATEGY.md](../BUNDLE-STRATEGY.md), [artifact-sizes.json](./artifact-sizes.json).')
+
+writeFileSync(outPath, `${lines.join('\n')}\n`)
+console.log(`[cdn-breakdown] wrote ${outPath}`)

package/scripts/generate-cdn-manifest.mjs

@@ -15,7 +15,7 @@ const cdnDir = resolve(root, 'dist/cdn')
 const buildId = portalBuildId()
 
 function fileMetrics(file) {
-  const path = resolve(cdnDir, file)
+  const path = resolve(cdnDir, file.replace(/^\//, ''))
   const raw = readFileSync(path)
   return {
     file,
@@ -24,17 +24,31 @@ function fileMetrics(file) {
   }
 }
 
-const jsFiles = readdirSync(cdnDir)
-  .filter((f) => f.endsWith('.js'))
-  .map((file) => {
+function scriptEntry(file) {
+  if (file.startsWith('vendor.')) {
+    return { name: 'vendor', order: 1, preload: true }
+  }
+  if (file.startsWith('app.') && !file.includes('/')) {
+    return { name: 'app', order: 2, preload: true }
+  }
+  if (file.startsWith('chunks/')) {
+    return { name: file.replace(/^chunks\//, ''), order: 99, preload: false }
+  }
+  return { name: file, order: 99, preload: false }
+}
+
+const jsFiles = readdirSync(cdnDir, { recursive: true })
+  .filter((f) => String(f).endsWith('.js'))
+  .map((rel) => {
+    const file = String(rel)
     const metrics = fileMetrics(file)
+    const entry = scriptEntry(file)
     return {
       ...metrics,
-      name: file.startsWith('vendor.') ? 'vendor' : file.startsWith('app.') ? 'app' : file,
-      order: file.startsWith('vendor.') ? 1 : file.startsWith('app.') ? 2 : 99,
+      ...entry,
     }
   })
-  .sort((a, b) => a.order - b.order)
+  .sort((a, b) => a.order - b.order || a.file.localeCompare(b.file))
 
 const cssFiles = readdirSync(cdnDir)
   .filter((f) => f.endsWith('.css'))
@@ -64,10 +78,11 @@ const manifest = {
   buildId,
   baseUrl: resolveCdnBaseUrl(),
   publishMode: process.env.VITE_PORTAL_CDN_PUBLISH_MODE ?? 'jsdelivr',
-  scripts: jsFiles.map(({ name, file, order, rawBytes, gzipBytes }) => ({
+  scripts: jsFiles.map(({ name, file, order, preload, rawBytes, gzipBytes }) => ({
     name,
     file,
     order,
+    preload,
     rawBytes,
     gzipBytes,
     url: `${resolveCdnBaseUrl()}/${file}`,

package/scripts/portal-vite-env.mjs

@@ -1,17 +1,91 @@
 /**
- * Vite env for HubSpot/CDN builds — .env.[mode] wins over stale shell VITE_* vars.
+ * Vite env for HubSpot/CDN builds — .env.[mode] wins over stale shell / .env.local VITE_* vars.
  */
+import { existsSync, readFileSync } from 'node:fs'
+import { resolve } from 'node:path'
 import { loadEnv } from 'vite'
 import { envWithPortalBuildId } from './resolve-portal-build-id.mjs'
 import { envWithPortalCdnConfig } from './load-portal-cdn-config.mjs'
 
+/** @param {string} content */
+export function parseEnvFile(content) {
+  const result = {}
+  for (const line of content.split('\n')) {
+    const trimmed = line.trim()
+    if (!trimmed || trimmed.startsWith('#')) continue
+    const eq = trimmed.indexOf('=')
+    if (eq <= 0) continue
+    const key = trimmed.slice(0, eq).trim()
+    let value = trimmed.slice(eq + 1).trim()
+    if (
+      (value.startsWith('"') && value.endsWith('"')) ||
+      (value.startsWith("'") && value.endsWith("'"))
+    ) {
+      value = value.slice(1, -1)
+    }
+    result[key] = value
+  }
+  return result
+}
+
+/** @param {'local' | 'dev' | 'stg' | 'prod'} mode @param {string} root */
+export function readPortalTierEnvFile(mode, root) {
+  const path = resolve(root, `.env.${mode}`)
+  if (!existsSync(path)) return {}
+  return parseEnvFile(readFileSync(path, 'utf8'))
+}
+
+function stashViteProcessEnv() {
+  const stashed = {}
+  for (const key of Object.keys(process.env)) {
+    if (key.startsWith('VITE_')) {
+      stashed[key] = process.env[key]
+      delete process.env[key]
+    }
+  }
+  return stashed
+}
+
+/** @param {Record<string, string | undefined>} stashed */
+function restoreViteProcessEnv(stashed) {
+  for (const [key, value] of Object.entries(stashed)) {
+    if (value != null) process.env[key] = value
+  }
+}
+
+/** loadEnv without shell / .env.local VITE_* polluting tier resolution */
+/** @param {'local' | 'dev' | 'stg' | 'prod'} mode @param {string} root */
+export function loadPortalFileEnv(mode, root) {
+  const stashed = stashViteProcessEnv()
+  try {
+    return loadEnv(mode, root, '')
+  } finally {
+    restoreViteProcessEnv(stashed)
+  }
+}
+
+/**
+ * API URL baked into CDN bundles for a deploy tier — reads `.env.[mode]` only.
+ * @param {'local' | 'dev' | 'stg' | 'prod'} mode
+ * @param {string} root
+ */
+export function resolveTierApiEndpoint(mode, root) {
+  const tier = readPortalTierEnvFile(mode, root)
+  const fromTier = tier.VITE_PUBLIC_REST_API_ENDPOINT
+  if (fromTier) return fromTier.replace(/\/$/, '')
+  const fromFile = loadPortalFileEnv(mode, root).VITE_PUBLIC_REST_API_ENDPOINT
+  const fromCi =
+    process.env.WOODPORTAL_API_BASE_URL || process.env.VITE_PUBLIC_REST_API_ENDPOINT
+  return (fromFile || fromCi)?.replace(/\/$/, '')
+}
+
 /**
  * @param {'local' | 'dev' | 'stg' | 'prod'} mode
  * @param {string} root
  * @param {NodeJS.ProcessEnv} [extra]
  */
 export function envForPortalBuild(mode, root, extra = {}) {
-  const fileEnv = loadEnv(mode, root, '')
+  const fileEnv = loadPortalFileEnv(mode, root)
   const base = { ...process.env }
 
   for (const key of Object.keys(base)) {

package/scripts/publish-cdn-github.mjs

@@ -98,6 +98,9 @@ function authRemote(remote, token) {
 function copyCdnArtifacts(sourceDir, targetDir) {
   mkdirSync(targetDir, { recursive: true })
   for (const entry of readdirSync(sourceDir)) {
+    if (entry.endsWith('.map')) {
+      fail(`Refusing to publish source map: ${entry}`)
+    }
     const src = join(sourceDir, entry)
     const dest = join(targetDir, entry)
     rmSync(dest, { recursive: true, force: true })

package/scripts/refresh-artifact-sizes.mjs

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+/**
+ * Refresh docs/audit/artifact-sizes.json from dist/cdn + HubSpot module output.
+ */
+import { existsSync, readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs'
+import { resolve, join } from 'node:path'
+import { gzipSync } from 'node:zlib'
+import { findProjectRoot } from './project-root.mjs'
+import { moduleOutDir, readWoodsportalConfig } from './read-woodsportal-config.mjs'
+
+const root = findProjectRoot()
+const { config } = readWoodsportalConfig(root)
+
+function metrics(path) {
+  const raw = readFileSync(path)
+  const gzip = gzipSync(raw)
+  return {
+    rawBytes: raw.length,
+    gzipBytes: gzip.length,
+    rawMiB: Number((raw.length / (1024 * 1024)).toFixed(3)),
+    gzipKiB: Number((gzip.length / 1024).toFixed(1)),
+    overValidationLimit: raw.length > 1.5 * 1024 * 1024,
+  }
+}
+
+function walkJs(dir, prefix = '') {
+  const out = []
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const rel = prefix ? `${prefix}/${entry.name}` : entry.name
+    const full = join(dir, entry.name)
+    if (entry.isDirectory()) {
+      out.push(...walkJs(full, rel))
+    } else if (entry.name.endsWith('.js')) {
+      out.push(rel)
+    }
+  }
+  return out
+}
+
+const moduleDir = moduleOutDir(root)
+const cdnDir = resolve(root, 'dist/cdn')
+const artifacts = {}
+
+for (const name of ['module.js', 'module.css', 'module.html', 'fields.json']) {
+  const p = resolve(moduleDir, name)
+  if (existsSync(p)) {
+    artifacts[name] = metrics(p)
+  }
+}
+
+const cdn = {}
+if (existsSync(cdnDir)) {
+  let manifest = null
+  const manifestPath = resolve(cdnDir, 'manifest.json')
+  if (existsSync(manifestPath)) {
+    manifest = JSON.parse(readFileSync(manifestPath, 'utf8'))
+    cdn['manifest.json'] = { generatedAt: manifest.generatedAt, buildId: manifest.buildId }
+  }
+  for (const file of walkJs(cdnDir)) {
+    cdn[file] = metrics(resolve(cdnDir, file))
+  }
+  for (const file of readdirSync(cdnDir).filter((f) => f.endsWith('.css'))) {
+    cdn[file] = metrics(resolve(cdnDir, file))
+  }
+}
+
+const doc = {
+  generatedAt: new Date().toISOString(),
+  embedMode: 'cdn',
+  hubspotLimits: { validationMiB: 1.5, bufferMiB: 2 },
+  artifacts,
+  cdn,
+}
+
+const outPath = resolve(root, 'docs/audit/artifact-sizes.json')
+writeFileSync(outPath, JSON.stringify(doc, null, 2))
+console.log(`[artifact-sizes] wrote ${outPath}`)

package/scripts/verify-cdn-api-endpoint.mjs

@@ -13,6 +13,7 @@ import { resolve } from 'node:path'
 import { findProjectRoot } from './project-root.mjs'
 import { resolvePortalBuildId } from './resolve-portal-build-id.mjs'
 import { resolvePortalViteMode } from './portal-env-mode.mjs'
+import { resolveTierApiEndpoint } from './portal-vite-env.mjs'
 
 const root = findProjectRoot()
 
@@ -29,15 +30,11 @@ if (tierFlags.length !== 1) {
 }
 
 const mode = resolvePortalViteMode()
-const { loadEnv } = await import('vite')
-const fromFile = loadEnv(mode, root, '').VITE_PUBLIC_REST_API_ENDPOINT
-const fromEnv =
-  process.env.VITE_PUBLIC_REST_API_ENDPOINT || process.env.WOODPORTAL_API_BASE_URL
-const expected = (fromFile || fromEnv)?.replace(/\/$/, '')
+const expected = resolveTierApiEndpoint(mode, root)
 
 if (!expected) {
   console.error(
-    `[verify-cdn-api] Missing VITE_PUBLIC_REST_API_ENDPOINT in .env.${mode} (or VITE_PUBLIC_REST_API_ENDPOINT / WOODPORTAL_API_BASE_URL env)`,
+    `[verify-cdn-api] Missing VITE_PUBLIC_REST_API_ENDPOINT in .env.${mode} (or WOODPORTAL_API_BASE_URL for CI)`,
   )
   process.exit(1)
 }
@@ -59,13 +56,23 @@ if (!appFile) {
 }
 
 const source = readFileSync(resolve(cdnDir, appFile), 'utf8')
-const found = [...source.matchAll(/https:\/\/api(?:\.dev)?\.woodsportal\.com/g)].map((m) => m[0])
-const unique = [...new Set(found)]
+const bakedUrls = [
+  ...source.matchAll(/https:\/\/api(?:\.dev)?\.woodsportal\.com/g),
+  ...source.matchAll(/http:\/\/localhost:\d+/g),
+].map((m) => m[0])
+const unique = [...new Set(bakedUrls)]
 
-if (!unique.includes(expected)) {
+if (!source.includes(expected)) {
   console.error('[verify-cdn-api] API URL mismatch in dist/cdn — refusing to publish.')
-  console.error(`  expected (${mode}): ${expected}`)
+  console.error(`  expected from .env.${mode}: ${expected}`)
   console.error(`  found in ${appFile}: ${unique.join(', ') || '(none)'}`)
+  const shellApi = process.env.VITE_PUBLIC_REST_API_ENDPOINT
+  if (shellApi && shellApi.replace(/\/$/, '') !== expected) {
+    console.error('')
+    console.error(
+      `  Note: shell/.env.local has VITE_PUBLIC_REST_API_ENDPOINT=${shellApi} — ignored for deploy; CDN uses .env.${mode} only.`,
+    )
+  }
   console.error('')
   console.error('  Dev API on HubSpot:  yarn deploy:dev')
   console.error('  Prod API on HubSpot: yarn deploy:prod')

package/scripts/vite/create-dev-server-config.mjs

@@ -67,7 +67,13 @@ export async function createDevServerViteConfig(options = {}) {
         ...prefixPlugins,
       ],
       resolve: {
-        dedupe: ['react', 'react-dom'],
+        dedupe: [
+          'react',
+          'react-dom',
+          'woodsportal-client-sdk',
+          'woodsportal-client-sdk/auth',
+          'woodsportal-client-sdk/crm',
+        ],
         alias: {
           ...consumerReactAliases(projectRoot),
           '@/dev/module-config': moduleConfigRoot,

package/scripts/vite/portal-build-shared.js

@@ -38,7 +38,7 @@ function prodDevModuleConfigRouteStub(mode) {
   if (!isPrefix(mode)) {
     return null
   }
-  const stub = resolve(root, 'src/routes/dev.module-config.prod-stub.tsx')
+  const stub = resolve(root, 'src/stubs/dev.module-config.cdn-route-stub.tsx')
   return {
     name: 'woodsportal-prod-dev-route-stub',
     enforce: 'pre',
@@ -55,6 +55,62 @@ function prodDevModuleConfigRouteStub(mode) {
   }
 }
 
+function prodResolveIdStub(mode, { name, matchers, stub }) {
+  if (!isPrefix(mode)) {
+    return null
+  }
+  return {
+    name,
+    enforce: 'pre',
+    resolveId(source) {
+      for (const match of matchers) {
+        if (typeof match === 'string' ? source === match || source.endsWith(match) : match.test(source)) {
+          return stub
+        }
+      }
+      return null
+    },
+  }
+}
+
+function prodDevHubSpotLiveStub(mode) {
+  if (!isPrefix(mode)) {
+    return null
+  }
+  const liveStub = resolve(root, 'src/integrations/dev-hubspot-live-provider.prod-stub.tsx')
+  const syncStub = resolve(root, 'src/data/dev-hubspot-sync.prod-stub.ts')
+  return {
+    name: 'woodsportal-prod-dev-hubspot-live-stub',
+    enforce: 'pre',
+    resolveId(source) {
+      if (
+        source === '@/integrations/dev-hubspot-live-provider' ||
+        /\/integrations\/dev-hubspot-live-provider(\.tsx)?$/.test(source)
+      ) {
+        return liveStub
+      }
+      if (
+        source === '@/data/dev-hubspot-sync' ||
+        /\/data\/dev-hubspot-sync(\.ts)?$/.test(source)
+      ) {
+        return syncStub
+      }
+      return null
+    },
+  }
+}
+
+function prodSdkTerminalLogSinksStub(mode) {
+  return prodResolveIdStub(mode, {
+    name: 'woodsportal-prod-sdk-log-sinks-stub',
+    matchers: [
+      '@/integrations/sdk-terminal-log-sinks',
+      /\/integrations\/sdk-terminal-log-sinks(\.ts)?$/,
+    ],
+    stub: resolve(root, 'src/integrations/sdk-terminal-log-sinks.prod-stub.ts'),
+  })
+}
+
 /** Ship CDN builds must not bundle localhost fixture menus from src/fixtures/demo-menu.ts */
 function prodDefaultDataStub(mode) {
   if (!isPrefix(mode)) {
@@ -81,6 +137,8 @@ export function portalPlugins(mode, { codeSplitting = false, routeFileIgnorePatt
   const routeIgnore = routeFileIgnorePattern ?? (isPrefix(mode) ? 'dev\\.' : undefined)
   return [
     prodDevModuleConfigRouteStub(mode),
+    prodDevHubSpotLiveStub(mode),
+    prodSdkTerminalLogSinksStub(mode),
     prodDefaultDataStub(mode),
     TanStackRouterVite({
       autoCodeSplitting: codeSplitting,
@@ -129,7 +187,9 @@ export function portalResolve(mode) {
     })
   }
 
-  return { alias }
+  const dedupe = ['axios', 'pako', 'js-cookie']
+
+  return { alias, dedupe }
 }
 
 export { root, __dirname }

package/src/dev-module-config/ui/module-config-overlay-side.ts

@@ -1,12 +1,22 @@
 export type ModuleConfigOverlaySide = 'left' | 'right'
 
-const STORAGE_KEY = 'woodsportal:module-config-overlay-side'
+const STORAGE_KEY = 'wp.d.cfg.side'
+const LEGACY_STORAGE_KEY = 'woodsportal:module-config-overlay-side'
 
 export function loadModuleConfigOverlaySide(): ModuleConfigOverlaySide {
   if (typeof window === 'undefined') return 'right'
   try {
-    const value = window.localStorage.getItem(STORAGE_KEY)
-    return value === 'left' ? 'left' : 'right'
+    const value =
+      window.localStorage.getItem(STORAGE_KEY) ??
+      window.localStorage.getItem(LEGACY_STORAGE_KEY)
+    if (value === 'left' || value === 'right') {
+      if (!window.localStorage.getItem(STORAGE_KEY)) {
+        window.localStorage.setItem(STORAGE_KEY, value)
+        window.localStorage.removeItem(LEGACY_STORAGE_KEY)
+      }
+      return value
+    }
+    return 'right'
   } catch {
     return 'right'
   }

package/src/dev-module-config/ui/module-config-toolbar-theme.ts

@@ -1,6 +1,7 @@
 export type ModuleConfigToolbarTheme = 'light' | 'dark'
 
-const STORAGE_KEY = 'woodsportal:module-config-toolbar-theme'
+const STORAGE_KEY = 'wp.d.cfg.theme'
+const LEGACY_STORAGE_KEY = 'woodsportal:module-config-toolbar-theme'
 
 export function detectPortalTheme(): ModuleConfigToolbarTheme {
   if (typeof document === 'undefined') return 'light'
@@ -10,8 +11,16 @@ export function detectPortalTheme(): ModuleConfigToolbarTheme {
 export function loadModuleConfigToolbarTheme(): ModuleConfigToolbarTheme {
   if (typeof window === 'undefined') return 'light'
   try {
-    const stored = window.localStorage.getItem(STORAGE_KEY)
-    if (stored === 'dark' || stored === 'light') return stored
+    const stored =
+      window.localStorage.getItem(STORAGE_KEY) ??
+      window.localStorage.getItem(LEGACY_STORAGE_KEY)
+    if (stored === 'dark' || stored === 'light') {
+      if (!window.localStorage.getItem(STORAGE_KEY)) {
+        window.localStorage.setItem(STORAGE_KEY, stored)
+        window.localStorage.removeItem(LEGACY_STORAGE_KEY)
+      }
+      return stored
+    }
   } catch {
     // ignore
   }