@marvalt/digivalt-core 0.2.26 → 0.2.28

package/dist/utils/basePath.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Prefix a root-absolute path with Vite's `import.meta.env.BASE_URL`.
+ * Used so Pages Function URLs (`/api/...`) work when the app is built with a non-root `base`
+ * (e.g. path mounts via digivalt-uworker).
+ *
+ * - Absolute http(s) URLs and protocol-relative URLs are returned unchanged.
+ * - Empty / unset BASE_URL (`/` or `./`) leaves root-absolute paths as-is.
+ */
+export declare function withBasePath(path: string): string;

package/dist/utils/index.d.ts

@@ -1 +1,2 @@
 export * from './passwordUtils';
+export * from './basePath';

package/docs/CLOUDFLARE-STREAM.md

@@ -1,54 +1,54 @@
-# Cloudflare Stream (DigiValt)
-
-Consume videos offloaded by **vibune-cloudflare-videos** via the WordPress REST field `cloudflare_stream` on media attachments.
-
-## Import
-
-```ts
-import {
-  CloudflareStreamPlayer,
-  resolveCloudflareStream,
-  isCloudflareStreamReady,
-  recommendedStreamPreconnectHosts,
-} from '@marvalt/digivalt-core/media';
-```
-
-## Static / generated media
-
-Media JSON from `@marvalt/wadapter` keeps the full REST object. Once the WP plugin is active:
-
-```ts
-const media = /* item from wordpress media list */;
-const stream = resolveCloudflareStream(media);
-
-if (isCloudflareStreamReady(stream)) {
-  // stream.iframe, stream.playback.hls, stream.thumbnail, …
-}
-```
-
-## Player
-
-```tsx
-<CloudflareStreamPlayer
-  stream={resolveCloudflareStream(media)}
-  title={media.title?.rendered ?? 'Video'}
-  autoplay={false}
-  muted={false}
-/>
-```
-
-- Loads the Stream **iframe** only when `ready` is true.
-- Otherwise shows `thumbnail` (or `posterFallback`).
-
-## Preconnect
-
-```ts
-recommendedStreamPreconnectHosts(stream?.iframe);
-// also: recommendedPreconnectHosts from @marvalt/digivalt-core/seo accepts Stream hosts
-```
-
-## Requirements
-
-- WordPress plugin **vibune-cloudflare-videos** active and configured
-- `@marvalt/wadapter` ≥ **2.3.60** (typed `cloudflare_stream`)
-- `@marvalt/digivalt-core` ≥ **0.2.26**
+# Cloudflare Stream (DigiValt)
+
+Consume videos offloaded by **vibune-cloudflare-videos** via the WordPress REST field `cloudflare_stream` on media attachments.
+
+## Import
+
+```ts
+import {
+  CloudflareStreamPlayer,
+  resolveCloudflareStream,
+  isCloudflareStreamReady,
+  recommendedStreamPreconnectHosts,
+} from '@marvalt/digivalt-core/media';
+```
+
+## Static / generated media
+
+Media JSON from `@marvalt/wadapter` keeps the full REST object. Once the WP plugin is active:
+
+```ts
+const media = /* item from wordpress media list */;
+const stream = resolveCloudflareStream(media);
+
+if (isCloudflareStreamReady(stream)) {
+  // stream.iframe, stream.playback.hls, stream.thumbnail, …
+}
+```
+
+## Player
+
+```tsx
+<CloudflareStreamPlayer
+  stream={resolveCloudflareStream(media)}
+  title={media.title?.rendered ?? 'Video'}
+  autoplay={false}
+  muted={false}
+/>
+```
+
+- Loads the Stream **iframe** only when `ready` is true.
+- Otherwise shows `thumbnail` (or `posterFallback`).
+
+## Preconnect
+
+```ts
+recommendedStreamPreconnectHosts(stream?.iframe);
+// also: recommendedPreconnectHosts from @marvalt/digivalt-core/seo accepts Stream hosts
+```
+
+## Requirements
+
+- WordPress plugin **vibune-cloudflare-videos** active and configured
+- `@marvalt/wadapter` ≥ **2.3.60** (typed `cloudflare_stream`)
+- `@marvalt/digivalt-core` ≥ **0.2.26**

package/docs/ENVIRONMENT.md

@@ -49,7 +49,8 @@ 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`. **`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. |
+| **Path mounts (digivalt-uworker)** | Consumer apps only: set Vite `base` (e.g. `/landing-page/`) and React Router `basename` to match the Worker `BASE_PATH`. Form/API helpers in this package use `withBasePath()` so `/api/*` follows `import.meta.env.BASE_URL`. See [PATH-MOUNT.md](./PATH-MOUNT.md). `digivalt-landing` stays root-hosted. |
+| **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`. **`VITE_FRONTEND_ID`** also selects DigiValt menu locations `{id}-header` / `{id}-footer` (fallback `default-*`). **`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/LOVABLE-MASTER-PROMPT.md

@@ -76,8 +76,8 @@ Import from `@marvalt/digivalt-core/generators` only:
 
 After `loadWordPressData()` from `@marvalt/digivalt-core/static`, wire the app shell and routes using WordPress static data:
 
-1. Menus from `getNavigationMenu()` / `getMenuById()` (+ `getParsedHeader()` / `getHeaderMenuId()`).
-2. Header/footer template blocks from `getHeader()` / `getFooter()`.
+1. Menus from `getNavigationMenu()` / `getFooterNavigationMenu()` / `getMenuById()` (+ `getParsedHeader()` / `getHeaderMenuId()` / `getFooterMenuId()`). Assign classic menus in WP under **Appearance → Menus → Manage Locations** (`{frontendId}-header|footer`, then `default-*`).
+2. Optional header/footer template blocks from `getHeader()` / `getFooter()` (legacy). Prefer app-owned chrome + location menus for multi-frontend.
 3. Site identity from `getSiteSettings()` / `getLogoUrl()` / `getSiteIconUrl()`.
 4. Theme styles from `getWordPressData().theme_styles` mapped into app styling/tokens.
 5. Pages/posts/CPT routes from `getWordPressPages()`, `getWordPressPageBySlug()`, `getWordPressPosts()`, and `front_page`.

package/docs/PATH-MOUNT.md

@@ -0,0 +1,43 @@
+# Path mounts (digivalt-uworker)
+
+Serve a DigiValt Cloudflare Pages app under a path on another hostname (e.g. WordPress at `https://domain.tld`, DigiValt at `https://domain.tld/landing-page`) using the **digivalt-uworker** Worker.
+
+## Responsibilities
+
+| Layer | Job |
+|-------|-----|
+| **digivalt-uworker** | Env `ORIGIN` + `BASE_PATH`; strip/prefix paths; rewrite `Location` + light HTML `href`/`src`/`action` |
+| **Consumer DigiValt app** | Vite `base`, React Router `basename`, `VITE_SEO_SITE_URL` |
+| **@marvalt/digivalt-core** | `withBasePath()` so browser `/api/*` (Gravity Forms, Mautic, etc.) follow `import.meta.env.BASE_URL` |
+
+`digivalt-landing` is **not** path-mounted; keep it root-hosted. Use a separate DigiValt project for path mounts.
+
+## Consumer app setup
+
+1. Vite (`vite.config.ts`):
+
+```ts
+base: process.env.VITE_BASE_PATH
+  ? `${process.env.VITE_BASE_PATH.replace(/\/$/, '')}/`
+  : '/',
+```
+
+2. React Router: `BrowserRouter basename={import.meta.env.BASE_URL.replace(/\/$/, '') || undefined}`
+
+3. Env: `VITE_SEO_SITE_URL=https://domain.tld/landing-page` (public URL, including path)
+
+4. Depend on `@marvalt/digivalt-core` **≥ 0.2.27**
+
+5. Deploy Pages, then point digivalt-uworker `ORIGIN` at that Pages URL and `BASE_PATH` at `/landing-page`
+
+## Import helper
+
+```ts
+import { withBasePath } from '@marvalt/digivalt-core/services';
+// e.g. fetch(withBasePath('/api/custom'))
+```
+
+## Caveats
+
+- One Pages build = one base path. Pages apex (`*.pages.dev/`) looks broken; `*.pages.dev/landing-page/` usually works.
+- Absolute URLs inside generated WordPress HTML are not rewritten by the Worker.

package/docs/README.md

@@ -8,6 +8,7 @@ Read these in order for DigiValt app setup, deploy, and SEO.
 | [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 |
+| [PATH-MOUNT.md](./PATH-MOUNT.md) | Devs | Path mounts via digivalt-uworker + Vite `base` + `withBasePath` |
 | [CLOUDFLARE-STREAM.md](./CLOUDFLARE-STREAM.md) | Devs | Stream helpers + `CloudflareStreamPlayer` (`/media`) |
 
 Package root [README.md](../README.md) covers `digivalt-init`, generators, and entry points.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marvalt/digivalt-core",
-  "version": "0.2.26",
+  "version": "0.2.28",
   "description": "Core glue logic and shared context for DigiVAlt frontend applications",
   "license": "GPL-3.0-or-later",
   "main": "dist/index.cjs",
@@ -116,7 +116,7 @@
     "@marvalt/sadapter": "^0.1.5",
     "@marvalt/shcoder": "^0.1.35",
     "@marvalt/tadapter": "^1.0.12",
-    "@marvalt/wadapter": "^2.3.60",
+    "@marvalt/wadapter": "^2.3.61",
     "@marvalt/wparser": "^0.1.79",
     "@radix-ui/react-toast": "^1.2.15",
     "class-variance-authority": "^0.7.1",