@marvalt/digivalt-core 0.2.11 → 0.2.13

package/CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.13] - 2026-04-20
+
+### Added
+- Build-time Google Reviews export via `generateAllData()` now writes `public/google-reviews-data.json` from the `vibune-google-reviews` endpoint, with optional override env vars `GOOGLE_REVIEWS_API_URL` / `VITE_GOOGLE_REVIEWS_API_URL`.
+
+### Changed
+- Full static generation now fails when Google Reviews fetch fails (same hard-fail behavior as other required generation tasks).
+- Gravity Forms static field normalization now accepts both snake_case and camelCase field keys (`is_required`/`isRequired`, `default_value`/`defaultValue`, etc.) so form schema remains consistent across endpoint variants.
+- Static Gravity Form renderer now supports Gravity Forms `html` fields by rendering field `content` blocks.
+
+## [0.2.12] - 2026-04-13
+
+### Added
+- `GLOBAL-SHORTCODES.md`: consolidated shortcode reference covering DigiValt core form/popup shortcodes (`gf_embed`, `popupbtn_gf`, `popupbtn_mautic`, aliases) plus `@marvalt/shcoder` member/testimonial/event shortcodes and legacy event aliases.
+- `docs/LOVABLE-MASTER-PROMPT.md`: promoted to a tool-agnostic AI master prompt (Cursor / Claude Code / Antigravity / Lovable) for full local WordPress-control scaffolds with explicit AI-vs-human responsibilities and first-run `build` + `dev` expectations.
+- `docs/AI-LOCAL-WORDPRESS-BOOTSTRAP.md`: new local-first runbook with minimum env matrix, first-run commands, artifact checks, and common recovery steps.
+- Template starter fixtures for Lovable-first app bootstraps:
+  - `template/public/wordpress-data.json`
+  - `template/public/gravity-forms-data.json`
+  - `template/src/data/mautic-data.json`
+  These placeholder files are safe defaults that prevent first-run runtime failures before real generated exports are available.
+- Cross-links added from package README and `digivalt-landing/DIGIVALT_SETUP.md` to the new unified AI docs.
+
 ## [0.2.11] - 2026-04-03
 
 ### Added

package/README.md

@@ -57,6 +57,12 @@ When to rerun it:
 
 **Sitemap:** Each build regenerates **`public/sitemap-paths.json`** from **`public/sitemap-static-paths.json`** (paths you add for SPA-only routes) plus WordPress menu and CPT links in **`wordpress-data.json`**. See **[docs/SEO-PERFORMANCE.md](./docs/SEO-PERFORMANCE.md)**.
 
+**Google Reviews static data:** `generateAllData()` also fetches `vibune-google-reviews` and writes **`public/google-reviews-data.json`**. By default it derives the endpoint from `WORDPRESS_API_URL` / `VITE_WORDPRESS_API_URL` and calls `/wp-json/vibune-google-reviews/v1/reviews`. Override with `GOOGLE_REVIEWS_API_URL` / `VITE_GOOGLE_REVIEWS_API_URL` when needed.
+
+**AI builders (Cursor / Claude Code / Antigravity / Lovable):**
+- Tool-agnostic master prompt: **[docs/LOVABLE-MASTER-PROMPT.md](./docs/LOVABLE-MASTER-PROMPT.md)**
+- Local-first human runbook: **[docs/AI-LOCAL-WORDPRESS-BOOTSTRAP.md](./docs/AI-LOCAL-WORDPRESS-BOOTSTRAP.md)**
+
 ## Developing this package
 
 This repo uses **`.npmrc`** with `legacy-peer-deps=true` so `react-helmet-async` installs cleanly alongside **React 19**-compatible transitive deps during local builds. Consumers of the published package only need to satisfy peers (`react`, `react-dom`, `react-helmet-async`).

package/bin/env-example-fragments.cjs

@@ -9,6 +9,9 @@ VITE_WORDPRESS_API_URL=https://cms.example.com/wp-json
 VITE_AUTH_MODE=direct
 VITE_CLOUDFLARE_WORKER_URL=
 VITE_LOCAL_DEVELOPMENT=false
+# Optional explicit endpoint for vibune-google-reviews static generation.
+# Defaults to <WORDPRESS_API_URL>/vibune-google-reviews/v1/reviews.
+# VITE_GOOGLE_REVIEWS_API_URL=https://cms.example.com/wp-json/vibune-google-reviews/v1/reviews
 
 # Multi-frontend (digivalt-multi-frontends)
 VITE_FRONTEND_ID=my-app

package/dist/data/gravityFormsDataStore.d.ts

@@ -4,8 +4,10 @@ export interface GravityFormField {
     label: string;
     description?: string;
     isRequired: boolean;
+    cssClass?: string;
     placeholder?: string;
     defaultValue?: string;
+    content?: string;
     choices?: Array<{
         text: string;
         value: string;

package/dist/generators/google-reviews.d.ts

@@ -0,0 +1,5 @@
+interface GenerateGoogleReviewsOptions {
+    outputPath?: string;
+}
+export declare function generateGoogleReviewsData(options?: GenerateGoogleReviewsOptions): Promise<boolean>;
+export {};

package/dist/generators/index.d.ts

@@ -2,5 +2,6 @@ export * from './wp';
 export * from './gf';
 export * from './mautic';
 export * from './suitecrm';
+export * from './google-reviews';
 export * from './sitemap-paths';
 export declare function generateAllData(): Promise<void>;

package/dist/generators.cjs

@@ -4,6 +4,7 @@ var dotenv = require('dotenv');
 var path = require('path');
 var fs = require('fs');
 var sadapter = require('@marvalt/sadapter');
+var promises = require('fs/promises');
 
 /**
  * @license GPL-3.0-or-later
@@ -2453,6 +2454,92 @@ async function generateSuiteCRMData(options) {
     }
 }
 
+function trimTrailingSlash(value) {
+    return value.replace(/\/+$/, '');
+}
+function resolveEndpointUrl() {
+    const explicit = process.env.GOOGLE_REVIEWS_API_URL ||
+        process.env.VITE_GOOGLE_REVIEWS_API_URL ||
+        '';
+    if (explicit) {
+        return explicit;
+    }
+    const wpApiBase = process.env.WORDPRESS_API_URL ||
+        process.env.VITE_WORDPRESS_API_URL ||
+        '';
+    if (!wpApiBase) {
+        return '';
+    }
+    const normalizedBase = trimTrailingSlash(wpApiBase);
+    if (normalizedBase.endsWith('/wp-json')) {
+        return `${normalizedBase}/vibune-google-reviews/v1/reviews`;
+    }
+    return `${normalizedBase}/wp-json/vibune-google-reviews/v1/reviews`;
+}
+function buildHeaders() {
+    const headers = {
+        Accept: 'application/json',
+    };
+    const username = process.env.WP_API_USERNAME || process.env.VITE_WP_API_USERNAME || '';
+    const password = process.env.WP_APP_PASSWORD || process.env.VITE_WP_APP_PASSWORD || '';
+    if (username && password) {
+        headers.Authorization = `Basic ${Buffer.from(`${username}:${password}`).toString('base64')}`;
+    }
+    const cfAccessClientId = process.env.CF_ACCESS_CLIENT_ID || process.env.VITE_CF_ACCESS_CLIENT_ID || '';
+    const cfAccessClientSecret = process.env.CF_ACCESS_CLIENT_SECRET || process.env.VITE_CF_ACCESS_CLIENT_SECRET || '';
+    if (cfAccessClientId && cfAccessClientSecret) {
+        headers['CF-Access-Client-Id'] = cfAccessClientId;
+        headers['CF-Access-Client-Secret'] = cfAccessClientSecret;
+    }
+    return headers;
+}
+function hasExpectedShape(payload) {
+    if (!payload || typeof payload !== 'object') {
+        return false;
+    }
+    const obj = payload;
+    return Array.isArray(obj.reviews) && typeof obj.business === 'object' && obj.business !== null;
+}
+function truncateBody(body, max = 1200) {
+    if (body.length <= max) {
+        return body;
+    }
+    return `${body.slice(0, max)}...`;
+}
+async function generateGoogleReviewsData(options) {
+    const outputPath = options?.outputPath || './public/google-reviews-data.json';
+    const endpointUrl = resolveEndpointUrl();
+    if (!endpointUrl) {
+        console.error('❌ Missing Google Reviews endpoint. Set GOOGLE_REVIEWS_API_URL or VITE_GOOGLE_REVIEWS_API_URL, or configure WORDPRESS_API_URL/VITE_WORDPRESS_API_URL.');
+        return false;
+    }
+    try {
+        const response = await fetch(endpointUrl, {
+            method: 'GET',
+            headers: buildHeaders(),
+        });
+        if (!response.ok) {
+            const body = truncateBody(await response.text());
+            console.error(`❌ Google Reviews generation failed (HTTP ${response.status}): ${body}`);
+            return false;
+        }
+        const payload = (await response.json());
+        if (!hasExpectedShape(payload)) {
+            console.error('❌ Google Reviews generation failed: endpoint returned unexpected payload shape.');
+            return false;
+        }
+        const outputFilePath = path.join(process.cwd(), outputPath);
+        await promises.mkdir(path.dirname(outputFilePath), { recursive: true });
+        await promises.writeFile(outputFilePath, `${JSON.stringify(payload, null, 2)}\n`, 'utf-8');
+        console.log(`📁 Google Reviews data written to: ${outputFilePath}`);
+        return true;
+    }
+    catch (e) {
+        console.error('❌ Google Reviews generation failed:', e.message);
+        return false;
+    }
+}
+
 const SITEMAP_SKIP_TOP_LEVEL_KEYS = new Set([
     'config',
     'site_settings',
@@ -2676,7 +2763,8 @@ async function generateAllData() {
     const gfSuccess = await generateGravityFormsData();
     const mauticSuccess = await generateMauticData();
     const suitecrmSuccess = await generateSuiteCRMData();
-    if (!wpSuccess || !gfSuccess || !mauticSuccess || !suitecrmSuccess) {
+    const googleReviewsSuccess = await generateGoogleReviewsData();
+    if (!wpSuccess || !gfSuccess || !mauticSuccess || !suitecrmSuccess || !googleReviewsSuccess) {
         console.error('❌ Some generation tasks failed. See above for details.');
         process.exit(1);
     }
@@ -2685,6 +2773,7 @@ async function generateAllData() {
 }
 
 exports.generateAllData = generateAllData;
+exports.generateGoogleReviewsData = generateGoogleReviewsData;
 exports.generateGravityFormsData = generateGravityFormsData;
 exports.generateMauticData = generateMauticData;
 exports.generateSitemapPaths = generateSitemapPaths;