@marvalt/digivalt-core 0.2.15 → 0.2.17

package/docs/ENVIRONMENT.md

@@ -18,6 +18,18 @@ The command **creates or updates** `.env.example` and `.env.local.example`. The
 
 **`VITE_IS_LOVABLE` (generators only):** Used in hosted Lovable/CI “fixture” flows to skip live API fetches. **Do not set this in local full-data development.** See [SEO-PERFORMANCE.md](./SEO-PERFORMANCE.md) and your app’s `DIGIVALT_SETUP.md`. It is **not** part of the managed example block; it is listed in `deploy-secrets` excluded keys (below).
 
+## React 19 install (consumer apps)
+
+`@marvalt/digivalt-core` peers **`react-helmet-async`** for SEO (`@marvalt/digivalt-core/seo`). That package currently declares peer support for React 16–18 only. If your app uses **React 19**, npm may fail with `ERESOLVE`:
+
+**Fix:** add a project **`.npmrc`** file:
+
+```ini
+legacy-peer-deps=true
+```
+
+Or install once with `npm install --legacy-peer-deps`. Runtime behavior with React 19 is fine; this is an npm peer-range mismatch until upstream updates.
+
 ## Handover to DevOps (Cloudflare and secrets)
 
 ### `node scripts/deploy-secrets.js`
@@ -37,7 +49,7 @@ Align **`name`** in `wrangler.toml` with your **Cloudflare Pages** project. Loca
 
 | Area | Notes |
 |------|--------|
-| **WordPress / static gen** | `VITE_WORDPRESS_API_URL`, `VITE_AUTH_MODE`, `VITE_CLOUDFLARE_WORKER_URL`, `VITE_LOCAL_DEVELOPMENT`, `VITE_ENABLED_POST_TYPES`, `VITE_DEFAULT_MAX_ITEMS`, `VITE_USE_DSTYLER`, `VITE_FRONTEND_ID` / `VITE_FRONTEND_NAME` — used by hooks, generators, and `getIntegrationConfig` / `getAppEnvironmentConfig`. |
+| **WordPress / static gen** | `VITE_WORDPRESS_API_URL`, `VITE_AUTH_MODE`, `VITE_CLOUDFLARE_WORKER_URL`, `VITE_LOCAL_DEVELOPMENT`, `VITE_ENABLED_POST_TYPES`, `VITE_DEFAULT_MAX_ITEMS`, `VITE_USE_DSTYLER`, `VITE_FRONTEND_ID` / `VITE_FRONTEND_NAME` — used by hooks, generators, and `getIntegrationConfig` / `getAppEnvironmentConfig`. **`google_reviews`** in `VITE_ENABLED_POST_TYPES` is a pseudo-type (not a WordPress CPT): it opt-in enables build-time fetch of `public/google-reviews-data.json` via the `vibune-google-reviews` plugin. |
 | **Theme** | `VITE_THEME` — optional; see `loadTheme` in `config/themes`. |
 | **Integrations (URLs often public; secrets in `.env.local`)** | Mautic, SuiteCRM, Supabase, Chatwoot, Gravity Forms — see `getIntegrationConfig` in `src/config/integrations.ts`. `VITE_SUITECRM_TOKEN_URL` is optional for non-default OAuth token endpoints (`environment.ts`). |
 | **SEO** | `VITE_SEO_*` — see [SEO-PERFORMANCE.md](./SEO-PERFORMANCE.md) and `getSEOConfig`. |

package/docs/README.md

@@ -0,0 +1,25 @@
+# @marvalt/digivalt-core documentation
+
+Read these in order for DigiValt app setup, deploy, and SEO.
+
+| Doc | Audience | Purpose |
+|-----|----------|---------|
+| [ENVIRONMENT.md](./ENVIRONMENT.md) | Devs + DevOps | Env vars, `.env` model, Cloudflare secrets, React 19 install |
+| [AI-LOCAL-WORDPRESS-BOOTSTRAP.md](./AI-LOCAL-WORDPRESS-BOOTSTRAP.md) | Humans | Local WordPress handover runbook |
+| [LOVABLE-MASTER-PROMPT.md](./LOVABLE-MASTER-PROMPT.md) | AI tools | Tool-agnostic scaffold prompt |
+| [SEO-PERFORMANCE.md](./SEO-PERFORMANCE.md) | Devs | `DigiValtSeoHead`, sitemap, `VITE_SEO_*`, performance |
+
+Package root [README.md](../README.md) covers `digivalt-init`, generators, and entry points.
+
+## Adapter packages (installed as dependencies)
+
+Each ships its own `docs/README.md` under `node_modules/@marvalt/<package>/docs/`:
+
+- `@marvalt/wadapter` — WordPress + Gravity Forms
+- `@marvalt/madapter` — Mautic
+- `@marvalt/wparser` — Gutenberg block rendering
+- `@marvalt/dstyler` — Theme / section styling
+- `@marvalt/shcoder` — CPT shortcode components
+- `@marvalt/tadapter` — Testimonial submission
+- `@marvalt/sadapter` — SuiteCRM
+- `@marvalt/cadapter` — Calendly embeds

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marvalt/digivalt-core",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "description": "Core glue logic and shared context for DigiVAlt frontend applications",
   "license": "GPL-3.0-or-later",
   "main": "dist/index.cjs",
@@ -66,8 +66,9 @@
     "smoke:imports": "node ./scripts/smoke-imports.mjs",
     "smoke:init": "node ./scripts/smoke-init.cjs",
     "smoke:sitemap": "node ./scripts/test-sitemap-paths.cjs",
-    "smoke": "npm run smoke:imports && npm run smoke:init && npm run smoke:sitemap",
-    "prepublishOnly": "npm run clean && npm run build && npm run smoke"
+    "smoke:google-reviews-gate": "node ./scripts/test-google-reviews-gate.cjs",
+    "smoke": "npm run smoke:imports && npm run smoke:init && npm run smoke:sitemap && npm run smoke:google-reviews-gate",
+    "prepublishOnly": "npm run clean && npm run build && npm run smoke && node ../scripts/verify-pack.cjs"
   },
   "devDependencies": {
     "react": "^18.3.1",