@woodsportal/hubspot-kit 1.0.39-dev.1 → 1.0.40-dev.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@woodsportal/hubspot-kit",
-  "version": "1.0.39-dev.1",
+  "version": "1.0.40-dev.0",
   "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/portal-env-mode.mjs

@@ -1,24 +1,27 @@
 /**
- * Portal Vite modes — align with `.env.dev` | `.env.stg` | `.env.prod`.
+ * Portal Vite modes — align with `.env.local` | `.env.dev` | `.env.stg` | `.env.prod`.
  */
 
-/** @typedef {'dev' | 'stg' | 'prod'} PortalViteMode */
+/** @typedef {'local' | 'dev' | 'stg' | 'prod'} PortalViteMode */
 
 /** @param {string[]} [argv] */
 export function resolvePortalViteMode(argv = process.argv) {
+  if (argv.includes('--local')) return /** @type {PortalViteMode} */ ('local')
   if (argv.includes('--stg') || argv.includes('--staging')) return /** @type {PortalViteMode} */ ('stg')
-  if (argv.includes('--dev') || argv.includes('--development')) return /** @type {PortalViteMode} */ ('dev')
+  if (argv.includes('--dev')) return /** @type {PortalViteMode} */ ('dev')
+  if (argv.includes('--development')) return /** @type {PortalViteMode} */ ('local')
+  if (argv.includes('--prod') || argv.includes('--production')) return /** @type {PortalViteMode} */ ('prod')
   return /** @type {PortalViteMode} */ ('prod')
 }
 
 /** React / bundler NODE_ENV (not the same as portal tier). */
 /** @param {PortalViteMode | string} mode */
 export function nodeEnvForPortalMode(mode) {
-  return mode === 'dev' ? 'development' : 'production'
+  return mode === 'local' ? 'development' : 'production'
 }
 
 /** Tailwind class prefix applies on CDN / HubSpot builds, not local dev. */
 /** @param {PortalViteMode | string} mode */
 export function isPrefixBuildMode(mode) {
-  return mode === 'stg' || mode === 'prod' || mode === 'staging' || mode === 'production'
+  return mode === 'dev' || mode === 'stg' || mode === 'prod' || mode === 'staging' || mode === 'production'
 }

package/scripts/portal-vite-env.mjs

@@ -6,7 +6,7 @@ import { envWithPortalBuildId } from './resolve-portal-build-id.mjs'
 import { envWithPortalCdnConfig } from './load-portal-cdn-config.mjs'
 
 /**
- * @param {'stg' | 'prod' | 'dev'} mode
+ * @param {'local' | 'dev' | 'stg' | 'prod'} mode
  * @param {string} root
  * @param {NodeJS.ProcessEnv} [extra]
  */
@@ -29,7 +29,7 @@ export function envForPortalBuild(mode, root, extra = {}) {
 }
 
 /**
- * @param {'stg' | 'prod' | 'dev'} mode
+ * @param {'local' | 'dev' | 'stg' | 'prod'} mode
  */
 export function defaultDatadogFlag(mode) {
   if (process.env.VITE_DATADOG_RUM_ENABLED != null) {

package/scripts/run-dev.mjs

@@ -16,14 +16,14 @@ process.env.WP_HS_PROJECT_ROOT = projectRoot
 const userConfig = await createDevServerViteConfig({ projectRoot, kitRoot, port })
 const resolved =
   typeof userConfig === 'function'
-    ? await userConfig({ mode: 'dev', command: 'serve' })
+    ? await userConfig({ mode: 'local', command: 'serve' })
     : await userConfig
 
 const { createServer } = await importConsumerDep('vite')
 const server = await createServer({
   ...resolved,
   configFile: false,
-  mode: 'dev',
+  mode: 'local',
 })
 
 await server.listen()

package/scripts/run-vite-build.mjs

@@ -2,7 +2,7 @@
 /**
  * Run `vite build` with portal env — `.env.stg` / `.env.prod` take precedence over shell.
  *
- * Usage: node scripts/run-vite-build.mjs <vite-config.mjs> [--stg]
+ * Usage: node scripts/run-vite-build.mjs <vite-config.mjs> [--local | --dev | --stg | --prod]
  */
 import { spawnSync } from 'node:child_process'
 
@@ -21,7 +21,7 @@ const configArg = process.argv[2]
 const mode = resolvePortalViteMode()
 
 if (!configArg) {
-  console.error('Usage: node scripts/run-vite-build.mjs <vite-config.mjs> [--stg]')
+  console.error('Usage: node scripts/run-vite-build.mjs <vite-config.mjs> [--local | --dev | --stg | --prod]')
   process.exit(1)
 }
 

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

@@ -1,33 +1,35 @@
 #!/usr/bin/env node
 /**
- * Fail if dist/cdn/app.*.js does not bake the API URL from .env.stg / .env.prod.
+ * Fail if dist/cdn/app.*.js does not bake the API URL from .env.dev / .env.stg / .env.prod.
  *
  * Usage:
+ *   node scripts/verify-cdn-api-endpoint.mjs --dev
  *   node scripts/verify-cdn-api-endpoint.mjs --stg
  *   node scripts/verify-cdn-api-endpoint.mjs --prod
  */
 import { existsSync, readFileSync, readdirSync } from 'node:fs'
-import { dirname, resolve } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { findProjectRoot } from './project-root.mjs'
-import { loadEnv } from 'vite'
+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'
 
 const root = findProjectRoot()
 
+const dev = process.argv.includes('--dev')
 const stg = process.argv.includes('--stg') || process.argv.includes('--staging')
 const prod = process.argv.includes('--prod') || process.argv.includes('--production')
+const tierFlags = [dev, stg, prod].filter(Boolean)
 
-if (stg === prod) {
+if (tierFlags.length !== 1) {
   console.error(
-    'Usage: node scripts/verify-cdn-api-endpoint.mjs --stg | --prod',
+    'Usage: node scripts/verify-cdn-api-endpoint.mjs --dev | --stg | --prod',
   )
   process.exit(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
@@ -51,7 +53,7 @@ const appFile = readdirSync(cdnDir).find((f) => f === `app.${buildId}.js`)
 
 if (!appFile) {
   console.error(
-    `[verify-cdn-api] app.${buildId}.js not found in dist/cdn — rebuild with matching .portal-build-id`,
+    `[verify-cdn-api] app.${buildId}.js not found in dist/cdn — rebuild with matching .module-build-id`,
   )
   process.exit(1)
 }

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

@@ -60,7 +60,7 @@ export async function createDevServerViteConfig(options = {}) {
       plugins: [
         bootstrapShimResolver({ bootstrapShim, bootstrapGreenfieldShim, kitRoot }),
         resolveFromProjectRoot(projectRoot, kitRoot),
-        ...(command === 'serve' && mode === 'dev'
+        ...(command === 'serve' && mode === 'local'
           ? [sdkLogBridge(), moduleConfigStore(projectRoot)]
           : []),
         ...(hasTanStackRoutes ? [TanStackRouterVite({ autoCodeSplitting: false })] : []),
@@ -100,7 +100,7 @@ export async function createDevServerViteConfig(options = {}) {
         'import.meta.env.VITE_WPHS_MODULE_NAME': JSON.stringify(
           config?.module?.name ?? config?.theme?.name ?? 'module',
         ),
-        'process.env.NODE_ENV': JSON.stringify(mode === 'dev' ? 'development' : 'production'),
+        'process.env.NODE_ENV': JSON.stringify(mode === 'local' ? 'development' : 'production'),
         'process.env': {},
         process: JSON.stringify({ env: {} }),
       },

package/scripts/watch-hubspot.mjs

@@ -44,6 +44,7 @@ function parseTier(args) {
   }
   if (args.includes('--prod')) return 'prod'
   if (args.includes('--stg')) return 'stg'
+  if (args.includes('--dev')) return 'dev'
   return 'dev'
 }
 

package/templates/shared/.env.dev.example

@@ -1,5 +1,3 @@
-# Local dev — copy to .env.dev (or run wp setup)
-VITE_DEV_MODE=live
+# 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
-# VITE_DEV_PORTAL_ID=1
-# VITE_DEV_HUB_ID=12345678

package/templates/shared/.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/templates/shared/.env.stg.example

@@ -1,3 +1,3 @@
-# Staging CDN build — copy to .env.stg (or run wp setup)
+# 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.dev.woodsportal.com
+# VITE_PUBLIC_REST_API_ENDPOINT=https://api.stg.woodsportal.com