@woodsportal/hubspot-kit 1.0.41 → 1.0.42-dev.1

package/scripts/regenerate-route-tree.mjs

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+/**
+ * Regenerate src/routeTree.gen.ts using the consumer project's @tanstack/router-generator.
+ */
+import { fileURLToPath } from 'node:url'
+import { existsSync } from 'node:fs'
+import { resolve } from 'node:path'
+
+import { findProjectRoot } from './project-root.mjs'
+import { importConsumerDep } from './resolve-consumer-dep.mjs'
+
+/**
+ * @param {string} [projectRoot]
+ * @returns {Promise<{ ok: boolean; warning?: string }>}
+ */
+export async function regenerateRouteTree(projectRoot = findProjectRoot()) {
+  const routesDir = resolve(projectRoot, 'src/routes')
+  const generatedRouteTree = resolve(projectRoot, 'src/routeTree.gen.ts')
+
+  if (!existsSync(routesDir)) {
+    return { ok: false, warning: 'No src/routes directory — skipping route tree regeneration.' }
+  }
+
+  try {
+    const mod = await importConsumerDep('@tanstack/router-generator', projectRoot)
+    const Generator = mod.Generator ?? mod.default?.Generator
+    if (!Generator) {
+      throw new Error('@tanstack/router-generator does not export Generator')
+    }
+
+    const generator = new Generator({
+      routesDirectory: routesDir,
+      generatedRouteTree,
+      target: 'react',
+    })
+
+    if (typeof generator.build === 'function') {
+      await generator.build()
+    } else if (typeof generator.run === 'function') {
+      await generator.run()
+    } else if (typeof generator.generate === 'function') {
+      await generator.generate()
+    } else {
+      throw new Error('Unsupported @tanstack/router-generator API')
+    }
+
+    if (!existsSync(generatedRouteTree)) {
+      throw new Error('Generator finished but routeTree.gen.ts was not written')
+    }
+
+    return { ok: true }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error)
+    return {
+      ok: false,
+      warning: `Could not regenerate routeTree.gen.ts (${message}). Restart wp dev to refresh the route tree.`,
+    }
+  }
+}
+
+if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+  const root = process.argv[2] ?? findProjectRoot()
+  regenerateRouteTree(root).then((result) => {
+    if (result.ok) {
+      process.stdout.write('routeTree.gen.ts regenerated\n')
+      process.exit(0)
+    }
+    process.stderr.write(`${result.warning ?? 'Route tree regeneration failed'}\n`)
+    process.exit(1)
+  })
+}

package/scripts/resolve-hubspot-cli.mjs

@@ -0,0 +1,51 @@
+import { existsSync } from 'node:fs'
+import { platform } from 'node:os'
+import { resolve } from 'node:path'
+
+/**
+ * @param {string} [projectRoot]
+ * @returns {{ command: string, prefixArgs: string[], shell?: boolean }}
+ */
+export function resolveHubSpotCliSpawn(projectRoot) {
+  const roots = []
+  if (projectRoot) roots.push(projectRoot)
+  if (!roots.includes(process.cwd())) roots.push(process.cwd())
+
+  for (const root of roots) {
+    const binDir = resolve(root, 'node_modules', '.bin')
+    if (platform() === 'win32') {
+      const cmd = resolve(binDir, 'hs.cmd')
+      if (existsSync(cmd)) return { command: cmd, prefixArgs: [], shell: false }
+    }
+    const shim = resolve(binDir, 'hs')
+    if (existsSync(shim)) return { command: shim, prefixArgs: [], shell: false }
+  }
+
+  if (platform() === 'win32') {
+    return { command: 'hs', prefixArgs: [], shell: true }
+  }
+  return { command: 'hs', prefixArgs: [], shell: false }
+}
+
+/**
+ * @param {string} projectRoot
+ * @param {string | undefined} kitCliPath
+ */
+export function resolveWpBinSpawn(projectRoot, kitCliPath) {
+  if (kitCliPath && existsSync(kitCliPath)) {
+    return { command: process.execPath, prefixArgs: [kitCliPath], shell: false }
+  }
+
+  const binDir = resolve(projectRoot, 'node_modules', '.bin')
+  if (platform() === 'win32') {
+    const cmd = resolve(binDir, 'wp.cmd')
+    if (existsSync(cmd)) return { command: cmd, prefixArgs: [], shell: false }
+  }
+  const shim = resolve(binDir, 'wp')
+  if (existsSync(shim)) return { command: shim, prefixArgs: [], shell: false }
+
+  if (platform() === 'win32') {
+    return { command: 'wp', prefixArgs: [], shell: true }
+  }
+  return { command: 'wp', prefixArgs: [], shell: false }
+}

package/scripts/resolve-vite-config.mjs

@@ -2,7 +2,7 @@
  * Resolve a Vite config path: prefer project root, fall back to kit vite presets.
  */
 import { existsSync } from 'node:fs'
-import { basename, resolve } from 'node:path'
+import { basename, resolve, isAbsolute } from 'node:path'
 
 import { findProjectRoot, getKitRoot } from './project-root.mjs'
 
@@ -11,8 +11,7 @@ import { findProjectRoot, getKitRoot } from './project-root.mjs'
  * @param {string} [projectRoot]
  */
 export function resolveViteConfig(configArg, projectRoot = findProjectRoot()) {
-  const isAbsolute = configArg.startsWith('/')
-  const localPath = isAbsolute ? configArg : resolve(projectRoot, configArg)
+  const localPath = isAbsolute(configArg) ? configArg : resolve(projectRoot, configArg)
   if (existsSync(localPath)) {
     return localPath
   }

package/scripts/resolve-vite-spawn.mjs

@@ -0,0 +1,48 @@
+import { spawnSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { platform } from 'node:os'
+import { resolve } from 'node:path'
+
+const VITE_JS_SEGMENTS = ['node_modules', 'vite', 'bin', 'vite.js']
+
+/**
+ * @param {string} projectRoot
+ * @returns {{ command: string, prefixArgs: string[], shell?: boolean } | null}
+ */
+export function resolveViteSpawn(projectRoot) {
+  const viteJs = resolve(projectRoot, ...VITE_JS_SEGMENTS)
+  if (existsSync(viteJs)) {
+    return { command: process.execPath, prefixArgs: [viteJs], shell: false }
+  }
+
+  const binDir = resolve(projectRoot, 'node_modules', '.bin')
+  if (platform() === 'win32') {
+    const winCmd = resolve(binDir, 'vite.cmd')
+    if (existsSync(winCmd)) {
+      return { command: winCmd, prefixArgs: [], shell: false }
+    }
+  }
+
+  const posixShim = resolve(binDir, 'vite')
+  if (existsSync(posixShim)) {
+    return { command: posixShim, prefixArgs: [], shell: false }
+  }
+
+  return null
+}
+
+/**
+ * @param {string} projectRoot
+ * @param {string[]} viteArgs
+ * @param {import('node:child_process').SpawnSyncOptions} options
+ */
+export function spawnViteSync(projectRoot, viteArgs, options) {
+  const spawn = resolveViteSpawn(projectRoot)
+  if (!spawn) {
+    throw new Error('vite not installed — run npm install or yarn install in the project root')
+  }
+  return spawnSync(spawn.command, [...spawn.prefixArgs, ...viteArgs], {
+    ...options,
+    shell: spawn.shell ?? false,
+  })
+}

package/scripts/run-vite-build.mjs

@@ -4,8 +4,6 @@
  *
  * Usage: node scripts/run-vite-build.mjs <vite-config.mjs> [--local | --dev | --stg | --prod]
  */
-import { spawnSync } from 'node:child_process'
-
 import { defaultDatadogFlag, envForPortalBuild } from './portal-vite-env.mjs'
 import { resolvePortalViteMode } from './portal-env-mode.mjs'
 import { findProjectRoot } from './project-root.mjs'
@@ -15,6 +13,7 @@ import {
   portalSubprocessStdio,
   portalViteLogArgs,
 } from './portal-subprocess-stdio.mjs'
+import { spawnViteSync } from './resolve-vite-spawn.mjs'
 
 const root = findProjectRoot()
 const configArg = process.argv[2]
@@ -32,10 +31,10 @@ const env = envForPortalBuild(mode, root, {
   WP_HS_PROJECT_ROOT: root,
 })
 
-const result = spawnSync(
-  'npx',
-  ['vite', 'build', '--config', config, '--mode', mode, ...portalViteLogArgs()],
-  { cwd: root, stdio: portalSubprocessStdio(), env, shell: true, encoding: 'utf8' },
+const result = spawnViteSync(
+  root,
+  ['build', '--config', config, '--mode', mode, ...portalViteLogArgs()],
+  { cwd: root, stdio: portalSubprocessStdio(), env, encoding: 'utf8' },
 )
 
 exitOnSpawnFailure(result)

package/scripts/sync-auth-scaffold-from-client.mjs

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+/**
+ * Copy curated auth files from woodsportal-client-frontend into templates/scaffold/auth/.
+ * Usage: node scripts/sync-auth-scaffold-from-client.mjs [--dry-run]
+ */
+import { copyFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const kitRoot = resolve(__dirname, '..')
+const manifestPath = resolve(kitRoot, 'templates/scaffold/auth/sync-manifest.json')
+const dryRun = process.argv.includes('--dry-run')
+
+const manifest = JSON.parse(readFileSync(manifestPath, 'utf8')) as {
+  clientFrontendRoot: string
+  mappings: Array<{ from: string; to: string }>
+}
+
+const clientRoot = resolve(kitRoot, manifest.clientFrontendRoot)
+
+let copied = 0
+for (const { from, to } of manifest.mappings) {
+  const source = resolve(clientRoot, from)
+  const target = resolve(kitRoot, 'templates/scaffold/auth', to)
+  if (!existsSync(source)) {
+    console.warn(`skip missing source: ${from}`)
+    continue
+  }
+  if (dryRun) {
+    console.log(`[dry-run] ${from} -> templates/scaffold/auth/${to}`)
+    copied += 1
+    continue
+  }
+  mkdirSync(dirname(target), { recursive: true })
+  copyFileSync(source, target)
+  console.log(`copied ${to}`)
+  copied += 1
+}
+
+console.log(`${dryRun ? 'would copy' : 'copied'} ${copied} file(s)`)

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/scripts/watch-hubspot.mjs

@@ -8,6 +8,7 @@ import { dirname, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
 import { moduleOutDir, moduleUploadPath, readWoodsportalConfig, themeUploadPath } from './read-woodsportal-config.mjs'
+import { resolveHubSpotCliSpawn, resolveWpBinSpawn } from './resolve-hubspot-cli.mjs'
 
 const kitScriptsDir = dirname(fileURLToPath(import.meta.url))
 const kitRoot = resolve(kitScriptsDir, '..')
@@ -87,23 +88,15 @@ process.on('SIGTERM', () => shutdown('SIGTERM'))
 function runWpBuild() {
   const env = { ...process.env, WP_HS_PROJECT_ROOT: root }
 
-  let command = process.execPath
-  let args = []
-
-  if (existsSync(kitCli)) {
-    args = [kitCli, 'build', '--tier', tier, '--quiet']
-  } else {
-    const localWp = resolve(root, 'node_modules', '.bin', 'wp')
-    command = existsSync(localWp) ? localWp : 'wp'
-    args = ['build', '--tier', tier, '--quiet']
-  }
+  const wpSpawn = resolveWpBinSpawn(root, existsSync(kitCli) ? kitCli : undefined)
+  const args = [...wpSpawn.prefixArgs, 'build', '--tier', tier, '--quiet']
 
   log(`Running wp build --tier ${tier} …`)
-  const result = spawnSync(command, args, {
+  const result = spawnSync(wpSpawn.command, args, {
     cwd: root,
     stdio: 'inherit',
     env,
-    shell: command === 'wp',
+    shell: wpSpawn.shell ?? false,
   })
   if (result.status !== 0) {
     process.exit(result.status ?? 1)
@@ -122,7 +115,12 @@ function startCmsWatch() {
   const src = isTheme ? theme.srcDir : hubspotModulePath
   const target = isTheme ? theme.uploadPath : hubspotUploadTarget
   log(`Starting hs cms watch ${src} → ${target}`)
-  cmsChild = spawn('hs', ['cms', 'watch', src, target], { cwd: root, stdio: 'inherit' })
+  const hsSpawn = resolveHubSpotCliSpawn(root)
+  cmsChild = spawn(hsSpawn.command, [...hsSpawn.prefixArgs, 'cms', 'watch', src, target], {
+    cwd: root,
+    stdio: 'inherit',
+    shell: hsSpawn.shell ?? false,
+  })
   cmsChild.on('exit', (code) => {
     if (shuttingDown) return
     process.exit(code ?? 0)