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

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+### Portal auth scaffold
+- **`wp init --auth`** — tiered portal login scaffold: `none` \| `starter` (email/password) \| `sso` \| `full` (SSO + MFA)
+- **Interactive `wp init` wizard** — sequential prompts: type → name → router → auth → CDN → confirm
+- **`templates/scaffold/auth/`** — layered `_shared`, `_sso`, `_full` files merged at init; `woodscli.json` records `scaffold.auth`
+- **Greenfield examples** — `examples/greenfield/module-hybrid-cdn-auth-{starter,sso,full}`
+- **Docs** — [AUTH-SCAFFOLD.md](./docs/AUTH-SCAFFOLD.md); README scaffold matrix and two-auth concepts
+
 ### CI / CodeBuild
 - **`woodsportal-<env>-cb-hubspot-kit-publish`** — `hubspot-kit-npm.yml` runs `npm run verify` then publishes `@woodsportal/hubspot-kit` (`next` on `dev`, `latest` on `main`). Client-frontend node-push installs kit from npm via `HUBSPOT_KIT_NPM_TAG` override.
 

package/README.md

@@ -1,207 +1,250 @@
 # WoodsCLI
 
-**HubSpot CMS dev kit by WoodsPortal** — local preview, module field editing, Vite build pipelines, and HubSpot upload/watch for **custom modules** and **themes**.
+**HubSpot CMS dev kit by WoodsPortal** — scaffold modules and themes, local preview, module field editing, Vite builds, and HubSpot upload/watch.
 
 ```bash
-npm i -D @woodsportal/hubspot-kit@^1.0.29
+npm i -D @woodsportal/hubspot-kit
 npx wp --version
 ```
 
-The `wp` CLI wraps [`@hubspot/cli`](https://developers.hubspot.com/docs/cms/developer-reference/local-development-cli) for CMS operations and adds WoodsPortal-specific tooling: hybrid CDN or monolith module builds, the **module-config overlay** (**Ctrl+Shift+Z** / **Cmd+Shift+Z**), and a `.wphs/` local workspace.
+The `wp` CLI wraps [`@hubspot/cli`](https://developers.hubspot.com/docs/cms/developer-reference/local-development-cli) and adds WoodsPortal tooling: hybrid CDN or monolith builds, the **module-config overlay** (**Ctrl+Shift+Z**), optional **portal auth scaffold** (`woodsportal-client-sdk`), and a `.wphs/` workspace.
+
+**Not for HubSpot UI extensions** — see [woods-portal-ui-card](https://github.com/Digital-Woods/digitalwoods.io-woods-portal-ui-card).
 
 ---
 
-## What you get
+## Choose your path
 
-| Capability | Command / artifact |
-|------------|-------------------|
-| Scaffold module or theme | `wp init` |
-| Local SPA + field editor | `wp dev` (`wp local`) |
-| HubSpot file sync | `wp watch`, `wp upload` |
-| Full ship pipeline | `wp deploy` (build → CDN publish → upload) |
-| Project health check | `wp doctor` |
-| Portal switching | `wp portal use` |
-| CI / regression gates | `wp examples smoke`, `wp regression smoke`, `wp audit *` |
-
-**Reference implementation:** [woodsportal-client-frontend](https://github.com/Digital-Woods/digitalwoods.io-woodsportal-client-frontend) — advanced hybrid CDN module with a full app adapter.
+| You are… | Start here |
+|----------|------------|
+| New HubSpot CMS **module** (React portal) | [Quick start](#quick-start-greenfield) below |
+| New **theme** | `wp init -t theme-starter` → [THEMES.md](./docs/THEMES.md) |
+| Existing module / artifact folder | [Existing repository](#existing-repository) |
+| Full production portal (reference) | [woodsportal-client-frontend](https://github.com/Digital-Woods/digitalwoods.io-woodsportal-client-frontend) |
 
 ---
 
-## Prerequisites
+## Scaffold matrix (`wp init`)
 
-| Requirement | Notes |
-|-------------|--------|
-| **Node.js 20+** | Enforced by `wp doctor` |
-| **HubSpot CLI** | `npm i -g @hubspot/cli` — required for upload/watch/deploy |
-| **HubSpot CMS portal** | Design Manager access; PAT or OAuth via `wp auth` |
-| **Project config** | `woodscli.json` at repo root (created by `wp init`) |
+| Template | Router | Auth tier | You get |
+|----------|--------|-----------|---------|
+| `module-hybrid-cdn` | `hash` (default) | `none` | React SPA + TanStack routes + starter pages |
+| `module-hybrid-cdn` | `hash` | `starter` | + email/password login + protected `/portal` sample |
+| `module-hybrid-cdn` | `hash` | `sso` | + SSO OAuth callback |
+| `module-hybrid-cdn` | `hash` | `full` | + MFA (production portals) |
+| `module-monolith` | … | … | Same auth tiers, single `module.js` bundle |
+| `theme-starter` | — | — | HubL theme only (no portal auth) |
 
-Local preview (`wp dev`) runs **without** HubSpot credentials. Upload, watch, and deploy need a valid project `hubspot.config.yml`.
+Bare **`wp init`** runs an interactive wizard: project type → name → router → portal auth → CDN mirror (hybrid) → confirm.
 
----
+### Auth tier examples (full commands)
 
-## Install
+Use **`module-hybrid-cdn`** + **`--router hash`** for all portal auth tiers. HubSpot upload auth (`wp auth`) is separate from portal login — run it when you need Design Manager upload/watch.
 
-**New project** (scaffold includes the kit):
+**No portal auth** (`scaffold.auth: none`) — routes and starter pages only; no `woodsportal-client-sdk` login UI:
 
 ```bash
-npx wp init -t module-hybrid-cdn -n my-portal-module
-cd my-portal-module && npm install
+npx wp init -t module-hybrid-cdn -n my-module-no-auth --router hash --auth none -y
+cd my-module-no-auth
+npm install          # or: touch yarn.lock && yarn install
+wp setup
+wp doctor
+wp dev               # http://localhost:3000/#/guide
 ```
 
-**Existing consumer** (add dev dependency):
+**Starter auth** (`scaffold.auth: starter`) — email + password login, protected `/portal` sample:
 
 ```bash
-npm i -D @woodsportal/hubspot-kit@^1.0.29
-# or: yarn add -D @woodsportal/hubspot-kit@^1.0.26
+npx wp init -t module-hybrid-cdn -n my-portal-starter --router hash --auth starter -y
+cd my-portal-starter
+npm install
+wp setup
+# Edit .env.local — API base URL (required); optional dev portal context:
+#   VITE_PUBLIC_REST_API_ENDPOINT=https://api.dev.woodsportal.com
+#   VITE_DEV_PORTAL_ID=<portal-id>
+wp doctor
+wp dev
+# Sign in: http://localhost:3000/#/login  →  redirects to /portal
 ```
 
-Use scripts that call `wp` directly, or rely on `node_modules/.bin/wp` after install.
+**SSO auth** (`scaffold.auth: sso`) — starter login + `/login/sso` OAuth callback:
 
----
+```bash
+npx wp init -t module-hybrid-cdn -n my-portal-sso --router hash --auth sso -y
+cd my-portal-sso
+npm install
+wp setup
+# Same .env.local as starter (API URL + optional VITE_DEV_PORTAL_ID)
+wp doctor
+wp dev
+# Password login: /#/login  |  SSO return path: /#/login/sso
+```
 
-## Project types
+**Full auth** (`scaffold.auth: full`) — SSO + MFA (`/two-fa`); recommended for production-shaped portals:
 
-| Track | `projectType` | Build output | Typical ship flow |
-|-------|---------------|--------------|-------------------|
-| **Module (hybrid CDN)** | `module-hybrid-cdn` | `dist/cdn/*` + `module.outDir` | `wp deploy` |
-| **Module (monolith)** | `module-monolith` | Single bundle in `module.outDir` | `wp build` → `wp upload` |
-| **Theme** | `theme-starter` | Theme folder under `theme.srcDir` | `wp upload` |
+```bash
+npx wp init -t module-hybrid-cdn -n my-portal-full --router hash --auth full -y
+cd my-portal-full
+npm install
+wp setup
+# Same .env.local as starter
+wp doctor
+wp dev
+# Login + MFA: /#/login  →  /#/two-fa when hub requires MFA
+```
 
-Init templates live under `templates/` in this package. Hybrid CDN splits vendor/app chunks for jsDelivr; monolith sets `cdn.mode: none` and skips CDN publish on deploy.
+| Tier | `woodscli.json` | Routes added (beyond `none`) |
+|------|-----------------|------------------------------|
+| `none` | `"auth": "none"` | `/guide` only (no `/login`) |
+| `starter` | `"auth": "starter"` | `/login`, protected `/portal` |
+| `sso` | `"auth": "sso"` | + `/login/sso` |
+| `full` | `"auth": "full"` | + `/two-fa`, MFA storage |
 
----
+Monolith template: swap `-t module-hybrid-cdn` for `-t module-monolith` (same `--auth` flags). Details: [AUTH-SCAFFOLD.md](./docs/AUTH-SCAFFOLD.md).
 
-## Quick start (greenfield)
+**Sidebar navigation** (`scaffold.nav: sidebar`) — collapsible left menu instead of top header links (requires auth ≠ `none`):
 
 ```bash
-npx wp init -t module-hybrid-cdn -n my-portal-module
-cd my-portal-module && npm install
+npx wp init -t module-hybrid-cdn -n my-portal-sidebar --router hash --auth starter --nav sidebar -y
+```
 
-wp setup          # hubspot.config.yml, .env.*, CDN files, vite shims (never overwrites)
-wp doctor         # Node, config, .wphs/, HubSpot CLI
-wp auth           # HubSpot login — updates hubspot.config.yml
-wp portal use     # interactive default portal (or: wp portal use <name>)
+Default nav shell is **top** (`scaffold.nav: top`). Edit `src/config/portal-nav.ts` to add menu items — both layouts read the same file.
 
-wp dev            # http://localhost:3000 — alias: wp local
-```
+### Navigation by auth tier
 
-**Module overlay:** open the dev server, press **Ctrl+Shift+Z** (Windows/Linux) or **Cmd+Shift+Z** (macOS) to edit Content/Styles fields against `fields.json`.
+| Auth | Nav file | Shell |
+|------|----------|-------|
+| `none` | `src/config/starter-nav.ts` | `StarterNav` in root layout |
+| `starter`+ | `src/config/portal-nav.ts` | `MainLayout` (top or sidebar) |
 
----
+`wp init --nav` chooses the **layout shell** (auth only). `wp page add --nav` adds a **menu link** to the nav file for your tier.
 
-## Existing repository
+**Add pages after init:**
 
 ```bash
-wp setup            # hubspot.config.yml, .env.*, vite shims (after woodscli.json exists)
-wp migrate --yes    # if you still have legacy .dev/ or woodsportal.hs.json
-wp doctor
+wp page add settings --protected --nav
+wp page add about --public
+wp page list
+wp page remove about
 ```
 
-For legacy **`<name>.module/`** artifact folders (plain JS, no `src/`), add `woodscli.json` manually (see [docs/MODULES.md](./docs/MODULES.md)) then `wp setup` and `wp upload`.
+**Upgrade scaffold on existing projects:**
 
-Legacy filename `woodsportal.hs.json` is **not** read — migrate to `woodscli.json` with `wp migrate --yes`.
+```bash
+wp scaffold auth upgrade --tier sso
+wp scaffold nav --mode sidebar
+```
 
 ---
 
-## Day-to-day workflows
+## Two auth concepts
 
-### Local development
+| | HubSpot CLI auth | Portal user auth |
+|--|------------------|------------------|
+| **Commands** | `wp auth`, `wp portal use` | `wp init --auth starter\|sso\|full` |
+| **Config** | `hubspot.config.yml` | `woodscli.json` → `scaffold.auth`, `scaffold.nav`, `.env.*` API URL |
+| **Purpose** | Upload/watch to Design Manager | End users log in via **woodsportal-api** + SDK |
 
-```bash
-wp dev                    # Vite HMR + module-config overlay
-wp dev -p 3001            # custom port
-```
+See [HUBSPOT-CLI-SETUP.md](./docs/HUBSPOT-CLI-SETUP.md) and [AUTH-SCAFFOLD.md](./docs/AUTH-SCAFFOLD.md).
 
-### Watch HubSpot folder (CMS sync)
+---
 
-```bash
-wp watch                  # hs cms watch on module.outDir (builds if output missing)
-wp watch --rebuild        # rebuild on src/ + public/ changes, then watch
-```
+## What you get
 
-`wp watch` does not use progress spinners so **Ctrl+C** and HubSpot TTY output stay reliable.
+| Capability | Command / artifact |
+|------------|-------------------|
+| Scaffold module or theme | `wp init` (`--template`, `--router`, `--auth`) |
+| Local SPA + field editor | `wp dev` (`wp local`) |
+| HubSpot file sync | `wp watch`, `wp upload` |
+| Full ship pipeline | `wp deploy` (build → CDN publish → upload) |
+| Project health check | `wp doctor` |
+| CI / regression gates | `wp examples smoke`, `wp regression smoke` |
 
-### Build and ship
+---
 
-```bash
-wp build                  # default --tier dev
-wp build --cdn-only       # hybrid CDN chunks only
-wp build --hubspot-only   # module bundle only (monolith-friendly)
+## Prerequisites
 
-wp publish --tier dev     # push CDN mirror (hybrid only)
-wp upload --tier dev      # hs cms upload
-wp deploy --tier dev      # build + publish + upload (skips CDN when cdn.mode: none)
-```
+| Requirement | Notes |
+|-------------|--------|
+| **Node.js 20+** | Enforced by `wp doctor` |
+| **HubSpot CLI** | `npm i -g @hubspot/cli` — upload/watch/deploy |
+| **HubSpot CMS portal** | Design Manager; `wp auth` for upload |
+| **woodscli.json** | Created by `wp init` |
 
-Tiers: `dev` | `stg` | `prod`. Production upload requires confirmation (`--yes` or `WP_HS_CONFIRM_PROD=1`). See [docs/BUILD-MODES.md](./docs/BUILD-MODES.md).
+Local preview runs without HubSpot credentials. Portal auth tiers need `VITE_PUBLIC_REST_API_ENDPOINT` after `wp setup`.
 
 ---
 
-## HubSpot authentication
+## Quick start (greenfield)
 
-1. `wp setup` copies `hubspot.config.yml.example` → `hubspot.config.yml` (gitignored).
-2. `wp auth` runs `hs auth` (browser / PAT flow).
-3. `wp portal list` shows configured portals; `wp portal use <name>` sets `defaultPortal`.
+```bash
+npx wp init -t module-hybrid-cdn -n my-portal --router hash --auth full -y
+cd my-portal && npm install
+
+wp setup          # hubspot.config.yml, .env.*, vite shims
+wp doctor
+wp auth           # HubSpot CMS (upload) — not portal login
+wp dev            # http://localhost:3000
+```
 
-Run auth and portal commands from the **project root** so HubSpot CLI reads `./hubspot.config.yml`.
+**Module overlay:** **Ctrl+Shift+Z** / **Cmd+Shift+Z** — edit Content/Styles fields.
 
-Full guide: [docs/HUBSPOT-CLI-SETUP.md](./docs/HUBSPOT-CLI-SETUP.md)
+Password-only portal: `--auth starter`. Details: [AUTH-SCAFFOLD.md](./docs/AUTH-SCAFFOLD.md).
 
 ---
 
-## Command reference
+## Existing repository
+
+```bash
+wp setup
+wp migrate --yes    # legacy .dev/ or woodsportal.hs.json
+wp doctor
+```
 
-Global flags (all commands): `--project <path>`, `--ci`, `--json`, `--verbose`, `--quiet`, `--dry-run`, `-y/--yes`.
+Legacy **`<name>.module/`** folders: add `woodscli.json` manually → [MODULES.md](./docs/MODULES.md).
 
-### Project lifecycle
+---
 
-| Command | Description |
-|---------|-------------|
-| `wp init [-t template] [-n name] [--router hash\|browser\|none]` | Scaffold `module-hybrid-cdn`, `module-monolith`, or `theme-starter` |
-| `wp migrate` | Move legacy `.dev/` / `woodsportal.hs.json` → `.wphs/` + `woodscli.json` |
-| `wp setup [--tier dev\|stg\|prod]` | Copy missing config, env, CDN, and vite shim files |
-| `wp doctor` | Prerequisite checks (interactive progress on TTY) |
-| `wp config validate` | Validate `woodscli.json` (zod) |
+## Day-to-day workflows
 
-### HubSpot account
+### Local development
 
-| Command | Description |
-|---------|-------------|
-| `wp auth` | `hs auth` — add or refresh portal credentials |
-| `wp portal list` / `wp portal ls` | List `portals[]` and current `defaultPortal` |
-| `wp portal use [name]` | `hs accounts use` — name or portalId; interactive if name omitted |
+```bash
+wp dev
+wp dev -p 3001
+```
 
-### Develop and sync
+### Build and ship
 
-| Command | Description |
-|---------|-------------|
-| `wp dev` / `wp local` | Local Vite dev server + module-config UI |
-| `wp watch [--rebuild] [--tier dev\|stg\|prod]` | `hs cms watch` on built module/theme output |
-| `wp fields sync [--direction pull\|push]` | Sync `fields.json` with local cache |
+```bash
+wp build --tier dev
+wp deploy --tier dev      # hybrid: build + CDN publish + upload
+wp upload --tier prod     # module/theme only
+```
 
-### Build and deploy
+Tiers: `dev` | `stg` | `prod`. See [BUILD-MODES.md](./docs/BUILD-MODES.md).
 
-| Command | Description |
-|---------|-------------|
-| `wp build [--tier] [--cdn-only] [--hubspot-only] [--cdn-esm]` | CDN + module (or theme no-op) |
-| `wp publish [--tier] [--dry-run]` | Verify CDN endpoint and push jsDelivr mirror |
-| `wp upload [--tier]` | `hs cms upload` using paths from `woodscli.json` |
-| `wp deploy [--tier] [--skip-publish]` | Full pipeline: build → publish → upload |
+---
 
-### Quality and CI
+## Command reference (init)
 
 | Command | Description |
 |---------|-------------|
-| `wp regression smoke [--skip-doctor]` | Config validate + consumer boundary checks |
-| `wp examples list` | List scenarios from `examples/manifest.json` |
-| `wp examples smoke [--scenario id] [--tier static\|live]` | Examples matrix (used in kit CI) |
-| `wp audit ship-bundle` | Fail if dev-only strings appear in `dist/` |
-| `wp audit parity [--baseline dir]` | Compare `dist/` to baseline snapshot |
-| `wp audit baseline [--baseline dir]` | Capture parity baseline under `.wphs/` |
-| `wp audit secrets` | Scan for hardcoded PATs / credentials |
-
-Detailed flags and exit codes: [docs/CLI-REFERENCE.md](./docs/CLI-REFERENCE.md)
+| `wp init` | Interactive scaffold wizard |
+| `wp init -t module-hybrid-cdn -n slug` | Hybrid CDN module |
+| `wp init --router hash \| browser \| none` | Client routing (modules) |
+| `wp init --auth none \| starter \| sso \| full` | Portal auth tier (modules, router ≠ none) |
+| `wp init --nav top \| sidebar` | Authenticated nav shell (requires auth ≠ none) |
+| `wp page add [slug]` | Scaffold route + page (`--public` / `--protected`, `--nav` / `--no-nav`) |
+| `wp page list` | List scaffolded pages under `src/features/pages/` |
+| `wp page remove <slug>` | Remove scaffolded page, route, and nav entry |
+| `wp scaffold auth upgrade --tier …` | Upgrade portal auth on existing module (`starter` \| `sso` \| `full`) |
+| `wp scaffold nav --mode …` | Re-apply top or sidebar `MainLayout` shell |
+| `wp init --cdn-github org/repo` | Hybrid CDN GitHub mirror (non-interactive) |
+
+Global flags: `--project`, `--ci`, `--json`, `--dry-run`, `-y/--yes`.
+
+Full list: [CLI-REFERENCE.md](./docs/CLI-REFERENCE.md)
 
 ---
 
@@ -209,43 +252,34 @@ Detailed flags and exit codes: [docs/CLI-REFERENCE.md](./docs/CLI-REFERENCE.md)
 
 ```
 my-project/
-├── woodscli.json           # WoodsCLI project config (required)
-├── hubspot.config.yml      # HubSpot CLI portals (gitignored; from wp setup)
-├── wphs.adapter.ts         # Consumer adapter hook (modules)
-├── vite.config.dev.mjs     # Re-exports kit dev preset
-├── vite.config.hubspot.mjs # or vite.config.monolith.mjs
-├── .wphs/                  # Local workspace (module-config, cache, audit)
-├── src/                     # App source
-├── public/                  # fields.json, module.html (modules)
-└── dist/                    # Build output (cdn + module.outDir)
+├── woodscli.json           # projectType, scaffold.router, scaffold.auth, scaffold.nav
+├── hubspot.config.yml      # HubSpot CLI (gitignored)
+├── wphs.adapter.ts
+├── .wphs/                  # module-config overlay state
+├── src/
+│   ├── routes/             # TanStack file routes (when router ≠ none)
+│   ├── features/auth/      # when scaffold.auth ≠ none
+│   └── portal/mount-portal.tsx
+└── dist/
 ```
 
-| File / dir | Purpose |
-|------------|---------|
-| `woodscli.json` | `projectType`, module/theme paths, CDN mode, env tiers |
-| `.wphs/` | Module-config overlay state, fixtures, audit baseline |
-| `wphs.adapter.ts` | Bridge to your app (routing, API, HubSpot context) |
-| `hubspot.config.yml` | Portal names, PATs, `defaultPortal` |
-
-Config field reference: [docs/CONFIG-REFERENCE.md](./docs/CONFIG-REFERENCE.md)
-
 ---
 
 ## Documentation
 
-| Doc | Topic |
-|-----|--------|
-| [GETTING-STARTED.md](./docs/GETTING-STARTED.md) | First-run walkthrough |
-| [CLI-REFERENCE.md](./docs/CLI-REFERENCE.md) | All commands, flags, exit codes |
-| [HUBSPOT-CLI-SETUP.md](./docs/HUBSPOT-CLI-SETUP.md) | PAT, auth, portals |
-| [MODULES.md](./docs/MODULES.md) | Module build paths and overlay |
-| [THEMES.md](./docs/THEMES.md) | Theme starter workflow |
-| [BUILD-MODES.md](./docs/BUILD-MODES.md) | CDN vs monolith, tiers, prod guards |
-| [ADAPTER.md](./docs/ADAPTER.md) | `wphs.adapter.ts` contract |
-| [EXAMPLES.md](./docs/EXAMPLES.md) | Examples smoke matrix |
+| Doc | Read when… |
+|-----|------------|
+| [GETTING-STARTED.md](./docs/GETTING-STARTED.md) | First run walkthrough |
+| [AUTH-SCAFFOLD.md](./docs/AUTH-SCAFFOLD.md) | Portal login tiers, env, boot order |
+| [CLI-REFERENCE.md](./docs/CLI-REFERENCE.md) | All commands and exit codes |
+| [MODULES.md](./docs/MODULES.md) | Hybrid CDN, monolith, overlay |
+| [THEMES.md](./docs/THEMES.md) | Theme starter |
+| [HUBSPOT-CLI-SETUP.md](./docs/HUBSPOT-CLI-SETUP.md) | PAT, `wp auth`, portals |
+| [CONFIG-REFERENCE.md](./docs/CONFIG-REFERENCE.md) | `woodscli.json` fields |
+| [BUILD-MODES.md](./docs/BUILD-MODES.md) | CDN vs monolith, tiers |
 | [TROUBLESHOOTING.md](./docs/TROUBLESHOOTING.md) | Common failures |
-| [RUNBOOK.md](./docs/RUNBOOK.md) | Ops and release notes |
-| [CONTRIBUTING.md](./CONTRIBUTING.md) | PR and verify workflow |
+| [RUNBOOK.md](./docs/RUNBOOK.md) | Ops and release |
+| [CONTRIBUTING.md](./CONTRIBUTING.md) | PR verify workflow |
 
 ---
 
@@ -255,10 +289,10 @@ Config field reference: [docs/CONFIG-REFERENCE.md](./docs/CONFIG-REFERENCE.md)
 git clone https://github.com/Digital-Woods/digitalwoods.io-woodsportal-hubspot-kit.git
 cd digitalwoods.io-woodsportal-hubspot-kit
 npm ci
-npm run verify    # typecheck + test + examples smoke + build
+npm run verify
 ```
 
-Link locally in a consumer:
+Link in a consumer:
 
 ```bash
 npm i -D @woodsportal/hubspot-kit@file:../digitalwoods.io-woodsportal-hubspot-kit

package/dist/{chunk-S2YJDWZU.js → chunk-NWBK3XBZ.js}

@@ -133,4 +133,4 @@ export {
   getViteConfigPath,
   createViteConfig
 };
-//# sourceMappingURL=chunk-S2YJDWZU.js.map
+//# sourceMappingURL=chunk-NWBK3XBZ.js.map

package/dist/chunk-NWBK3XBZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/paths.ts","../src/lib/config-files.ts","../src/lib/errors.ts","../src/vite/paths.ts","../src/vite/create-vite-config.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs'\nimport { dirname, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nimport { findProjectRoot as findConfigProjectRoot } from './config-files.js'\nimport { WpHsError, ExitCode } from './errors.js'\n\nconst KIT_PACKAGE_NAME = '@woodsportal/hubspot-kit'\n\nexport { KIT_PACKAGE_NAME }\n\nfunction resolveKitRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url))\n  while (true) {\n    const pkgPath = resolve(dir, 'package.json')\n    if (existsSync(pkgPath)) {\n      try {\n        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8')) as { name?: string }\n        if (pkg.name === KIT_PACKAGE_NAME) {\n          return dir\n        }\n      } catch {\n        // keep walking\n      }\n    }\n    const parent = dirname(dir)\n    if (parent === dir) {\n      break\n    }\n    dir = parent\n  }\n\n  throw new WpHsError('Could not resolve @woodsportal/hubspot-kit package root.', {\n    exitCode: ExitCode.INTERNAL,\n  })\n}\n\nconst kitRoot = resolveKitRoot()\n\nexport function getKitRoot(): string {\n  return kitRoot\n}\n\nexport function findProjectRoot(from = process.cwd()): string {\n  const resolved = findConfigProjectRoot(from)\n\n  if (!resolved) {\n    throw new WpHsError('Could not find woodscli.json in this directory or any parent.', {\n      exitCode: ExitCode.USER_ERROR,\n      remediation: 'Run wp init, or pass --project <path>. Legacy config: wp migrate --yes.',\n    })\n  }\n  return resolved\n}\n\nexport function kitPath(...segments: string[]): string {\n  return resolve(kitRoot, ...segments)\n}\n\nexport { resolveProjectConfig, WOODSCLI_CONFIG_FILE, LEGACY_WOODSPORTAL_HS_FILE } from './config-files.js'\n","import { existsSync } from 'node:fs'\nimport { resolve } from 'node:path'\n\n/** Canonical WoodsCLI project config — the only supported filename. */\nexport const WOODSCLI_CONFIG_FILE = 'woodscli.json'\n\n/** Removed in v1.0.2+ — detected only for migrate/doctor messaging. */\nexport const LEGACY_WOODSPORTAL_HS_FILE = 'woodsportal.hs.json'\n\nexport type ResolvedProjectConfig = {\n  path: string\n  fileName: typeof WOODSCLI_CONFIG_FILE\n}\n\nfunction envConfigPath(projectRoot: string): string | null {\n  const fromEnv = process.env.WOODSCLI_CONFIG?.trim() || process.env.WP_HS_CONFIG?.trim() || null\n  if (!fromEnv) return null\n  return resolve(projectRoot, fromEnv)\n}\n\nexport function legacyConfigPath(projectRoot: string): string {\n  return resolve(projectRoot, LEGACY_WOODSPORTAL_HS_FILE)\n}\n\nexport function woodscliConfigPath(projectRoot: string): string {\n  return resolve(projectRoot, WOODSCLI_CONFIG_FILE)\n}\n\n/** @returns null | 'legacy-only' | 'duplicate' */\nexport function legacyConfigConflict(projectRoot: string): 'legacy-only' | 'duplicate' | null {\n  const hasWoodscli = existsSync(woodscliConfigPath(projectRoot))\n  const hasLegacy = existsSync(legacyConfigPath(projectRoot))\n  if (hasLegacy && hasWoodscli) return 'duplicate'\n  if (hasLegacy && !hasWoodscli) return 'legacy-only'\n  return null\n}\n\n/**\n * Resolve the active project config file (`woodscli.json` only).\n */\nexport function resolveProjectConfig(projectRoot: string): ResolvedProjectConfig | null {\n  const envPath = envConfigPath(projectRoot)\n  if (envPath) {\n    if (!existsSync(envPath)) return null\n    return { path: envPath, fileName: WOODSCLI_CONFIG_FILE }\n  }\n\n  const path = woodscliConfigPath(projectRoot)\n  if (existsSync(path)) {\n    return { path, fileName: WOODSCLI_CONFIG_FILE }\n  }\n\n  return null\n}\n\nexport function findProjectRoot(from = process.cwd()): string | null {\n  if (process.env.WP_HS_PROJECT_ROOT?.trim()) {\n    return resolve(process.env.WP_HS_PROJECT_ROOT.trim())\n  }\n\n  let dir = resolve(from)\n  while (true) {\n    if (resolveProjectConfig(dir)) {\n      return dir\n    }\n    const parent = resolve(dir, '..')\n    if (parent === dir) {\n      return null\n    }\n    dir = parent\n  }\n}\n","export const ExitCode = {\n  SUCCESS: 0,\n  USER_ERROR: 1,\n  PREREQUISITE: 2,\n  BUILD_FAILED: 3,\n  PUBLISH_FAILED: 4,\n  AUDIT_FAILED: 5,\n  INTERNAL: 10,\n} as const\n\nexport type ExitCodeValue = (typeof ExitCode)[keyof typeof ExitCode]\n\nexport class WpHsError extends Error {\n  readonly exitCode: ExitCodeValue\n  readonly remediation?: string\n\n  constructor(\n    message: string,\n    options: { exitCode?: ExitCodeValue; remediation?: string; cause?: unknown } = {},\n  ) {\n    super(message, { cause: options.cause })\n    this.name = 'WpHsError'\n    this.exitCode = options.exitCode ?? ExitCode.USER_ERROR\n    this.remediation = options.remediation\n  }\n}\n\nexport function isWpHsError(error: unknown): error is WpHsError {\n  return error instanceof WpHsError\n}\n","import { kitPath } from '../lib/paths.js'\n\nexport type VitePreset = 'dev' | 'hubspot' | 'cdn-vendor' | 'cdn-app' | 'cdn-esm'\n\nexport function getViteConfigPath(preset: VitePreset): string {\n  return kitPath('vite', `vite.config.${preset}.mjs`)\n}\n","import { getViteConfigPath, type VitePreset } from './paths.js'\n\nexport type CreateViteConfigOptions = {\n  /** Vite preset shipped with @woodsportal/hubspot-kit */\n  preset: VitePreset\n  /** Consumer project root (sets WP_HS_PROJECT_ROOT for kit scripts) */\n  projectRoot?: string\n}\n\n/**\n * Returns the absolute path to a kit Vite config preset.\n * Consumer repos typically re-export: `export { default } from '@woodsportal/hubspot-kit/vite/vite.config.hubspot.mjs'`\n * or use this helper in a thin wrapper config.\n */\nexport function createViteConfig(\n  presetOrOptions: VitePreset | CreateViteConfigOptions,\n): string {\n  const options: CreateViteConfigOptions =\n    typeof presetOrOptions === 'string' ? { preset: presetOrOptions } : presetOrOptions\n\n  if (options.projectRoot?.trim()) {\n    process.env.WP_HS_PROJECT_ROOT = options.projectRoot.trim()\n  }\n\n  return getViteConfigPath(options.preset)\n}\n"],"mappings":"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","names":["existsSync","resolve","resolve","existsSync","findProjectRoot"]}