@marvalt/digivalt-core 0.2.13 → 0.2.16

package/CHANGELOG.md

@@ -5,6 +5,25 @@ 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.16] - 2026-05-29
+
+### Changed
+- Google Reviews static generation is now **opt-in** via **`google_reviews`** in **`VITE_ENABLED_POST_TYPES`**. When absent, `generateGoogleReviewsData()` skips (build continues). When present, fetch still hard-fails on error. Explicit `GOOGLE_REVIEWS_API_URL` / `VITE_GOOGLE_REVIEWS_API_URL` does not enable fetch without `google_reviews` in post types.
+- **`google_reviews`** is filtered from WordPress CPT fetch list (pseudo-type, not passed to `@marvalt/wadapter`).
+
+### Added
+- **`enabled-post-types.ts`:** shared helpers `parseEnabledPostTypes`, `isGoogleReviewsEnabled`, `getWordPressPostTypes` (exported from `@marvalt/digivalt-core/generators`).
+- Smoke test **`scripts/test-google-reviews-gate.cjs`**.
+
+## [0.2.14] - 2026-04-23
+
+### Added
+- **`docs/ENVIRONMENT.md`:** handover doc for developers and DevOps (two-file model, `digivalt-init` managed block, `deploy-secrets` allowlist/excludes, wrangler, variable groups). Linked from the package README.
+- **Reference templates:** [`.env.example`](.env.example) and [`.env.local.example`](.env.local.example) at the package root (same shape as `npx digivalt-init`); keep in sync with [`bin/env-example-fragments.cjs`](bin/env-example-fragments.cjs) when changing managed lines.
+
+### Changed
+- **`bin/env-example-fragments.cjs`:** optional commented lines for `VITE_THEME` and `VITE_SUITECRM_TOKEN_URL` to match `loadTheme` in `config/themes` and SuiteCRM direct-mode token URL support.
+
 ## [0.2.13] - 2026-04-20
 
 ### Added

package/README.md

@@ -8,7 +8,9 @@ Core DigiVAlt package for static data generation, runtime service wiring, and Cl
 npm install @marvalt/digivalt-core
 ```
 
-In the **DigiValt monorepo**, **`digivalt-landing`** is the reference Vite app used to test this package with WordPress plugins and Cloudflare Pages.
+Full handover reference for env vars (developers and DevOps): **[docs/ENVIRONMENT.md](./docs/ENVIRONMENT.md)**.
+
+In the **DigiVAlt monorepo**, **`digivalt-landing`** is the reference Vite app used to test this package with WordPress plugins and Cloudflare Pages.
 
 ## Entry Points
 
@@ -57,7 +59,7 @@ 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.
+**Google Reviews static data:** Opt in by adding **`google_reviews`** to **`VITE_ENABLED_POST_TYPES`** (requires the `vibune-google-reviews` WordPress plugin). When enabled, `generateAllData()` fetches the plugin REST route and writes **`public/google-reviews-data.json`**. By default the endpoint is derived from `WORDPRESS_API_URL` / `VITE_WORDPRESS_API_URL` (`/wp-json/vibune-google-reviews/v1/reviews`). Override with `GOOGLE_REVIEWS_API_URL` / `VITE_GOOGLE_REVIEWS_API_URL` when needed. When `google_reviews` is not listed, generation is skipped (same optional pattern as Mautic/SuiteCRM).
 
 **AI builders (Cursor / Claude Code / Antigravity / Lovable):**
 - Tool-agnostic master prompt: **[docs/LOVABLE-MASTER-PROMPT.md](./docs/LOVABLE-MASTER-PROMPT.md)**

package/bin/env-example-fragments.cjs

@@ -9,7 +9,7 @@ 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.
+# Optional explicit endpoint for vibune-google-reviews static generation (only when google_reviews is in VITE_ENABLED_POST_TYPES).
 # 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
 
@@ -17,9 +17,12 @@ VITE_LOCAL_DEVELOPMENT=false
 VITE_FRONTEND_ID=my-app
 VITE_FRONTEND_NAME=My App
 
+# Comma-separated WordPress CPT slugs plus optional pseudo-types (e.g. google_reviews for vibune-google-reviews static fetch).
 VITE_ENABLED_POST_TYPES=posts,pages
 VITE_DEFAULT_MAX_ITEMS=200
 VITE_USE_DSTYLER=true
+# Optional theme name (default digivalt_core; see loadTheme in config/themes)
+# VITE_THEME=
 
 # Optional: Gravity Forms API base if not derived from WordPress URL
 # VITE_GRAVITY_FORMS_API_URL=
@@ -29,6 +32,8 @@ VITE_MAUTIC_URL=
 VITE_MAUTIC_PROXY_URL=
 VITE_SUITECRM_URL=
 VITE_SUITECRM_PROXY_URL=
+# Optional; OAuth token endpoint if not the default for your SuiteCRM
+# VITE_SUITECRM_TOKEN_URL=
 VITE_SUPABASE_URL=
 VITE_SUPABASE_ANON_KEY=
 

package/dist/generators/enabled-post-types.d.ts

@@ -0,0 +1,5 @@
+/** Integration tokens in VITE_ENABLED_POST_TYPES that are not WordPress CPTs. */
+export declare const PSEUDO_POST_TYPES: Set<string>;
+export declare function parseEnabledPostTypes(): string[];
+export declare function isGoogleReviewsEnabled(): boolean;
+export declare function getWordPressPostTypes(): string[];

package/dist/generators/index.d.ts

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

package/dist/generators.cjs

@@ -1826,6 +1826,30 @@ async function generateGravityFormsData$1(config) {
     return generator.generateStaticData();
 }
 
+const DEFAULT_ENABLED_POST_TYPES = 'posts,pages';
+/** Integration tokens in VITE_ENABLED_POST_TYPES that are not WordPress CPTs. */
+const PSEUDO_POST_TYPES = new Set(['google_reviews']);
+const POST_TYPE_ALIASES = {
+    members: 'member',
+    testimonials: 'testimonial',
+    faqs: 'faq',
+    eventbrite_events: 'eventbrite_event',
+};
+function parseEnabledPostTypes() {
+    const raw = process.env.VITE_ENABLED_POST_TYPES ||
+        process.env.ENABLED_POST_TYPES ||
+        DEFAULT_ENABLED_POST_TYPES;
+    return raw.split(',').map((pt) => pt.trim()).filter(Boolean);
+}
+function isGoogleReviewsEnabled() {
+    return parseEnabledPostTypes().includes('google_reviews');
+}
+function getWordPressPostTypes() {
+    return parseEnabledPostTypes()
+        .filter((pt) => !PSEUDO_POST_TYPES.has(pt))
+        .map((pt) => POST_TYPE_ALIASES[pt] || pt);
+}
+
 async function generateWordPressData(options) {
     const outputPath = options?.outputPath || './public/wordpress-data.json';
     const apiUrl = process.env.WORDPRESS_API_URL || process.env.VITE_WORDPRESS_API_URL;
@@ -1851,15 +1875,7 @@ async function generateWordPressData(options) {
         cfAccessClientId,
         cfAccessClientSecret,
     };
-    const enabledPostTypes = process.env.VITE_ENABLED_POST_TYPES || process.env.ENABLED_POST_TYPES || 'posts,pages';
-    const rawPostTypes = enabledPostTypes.split(',').map(pt => pt.trim()).filter(Boolean);
-    const postTypeMapping = {
-        'members': 'member',
-        'testimonials': 'testimonial',
-        'faqs': 'faq',
-        'eventbrite_events': 'eventbrite_event',
-    };
-    const postTypes = rawPostTypes.map(pt => postTypeMapping[pt] || pt);
+    const postTypes = getWordPressPostTypes();
     const frontendId = process.env.VITE_FRONTEND_ID || process.env.FRONTEND_ID || undefined;
     const frontendName = process.env.VITE_FRONTEND_NAME || process.env.FRONTEND_NAME || 'Default Frontend';
     try {
@@ -2507,6 +2523,10 @@ function truncateBody(body, max = 1200) {
     return `${body.slice(0, max)}...`;
 }
 async function generateGoogleReviewsData(options) {
+    if (!isGoogleReviewsEnabled()) {
+        console.log('⚠️  Skipping Google Reviews data generation (google_reviews not in VITE_ENABLED_POST_TYPES).');
+        return true;
+    }
     const outputPath = options?.outputPath || './public/google-reviews-data.json';
     const endpointUrl = resolveEndpointUrl();
     if (!endpointUrl) {
@@ -2772,6 +2792,7 @@ async function generateAllData() {
     console.log('✅ Generation complete!');
 }
 
+exports.PSEUDO_POST_TYPES = PSEUDO_POST_TYPES;
 exports.generateAllData = generateAllData;
 exports.generateGoogleReviewsData = generateGoogleReviewsData;
 exports.generateGravityFormsData = generateGravityFormsData;
@@ -2780,4 +2801,7 @@ exports.generateSitemapPaths = generateSitemapPaths;
 exports.generateSitemapPathsSafe = generateSitemapPathsSafe;
 exports.generateSuiteCRMData = generateSuiteCRMData;
 exports.generateWordPressData = generateWordPressData;
+exports.getWordPressPostTypes = getWordPressPostTypes;
+exports.isGoogleReviewsEnabled = isGoogleReviewsEnabled;
+exports.parseEnabledPostTypes = parseEnabledPostTypes;
 //# sourceMappingURL=generators.cjs.map