@valbuild/server 0.148.2 → 0.148.4

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @valbuild/server
 
+## 0.148.4
+
+### Patch Changes
+
+- Updated dependencies [[`7c432b3`](https://github.com/valbuild/val/commit/7c432b3f05af414bd6cbc37cd58a71a783056caa)]:
+  - @valbuild/ui@0.148.4
+
+## 0.148.3
+
+### Patch Changes
+
+- [#881](https://github.com/valbuild/val/pull/881) [`0139436`](https://github.com/valbuild/val/commit/0139436426142d91cbb29ec6c696dfb86f34ab9d) Thanks [@freekh](https://github.com/freekh)! - The content analytics script. With analytics on (it is off by default, and turned on in a hosted project's settings), a TanStack site counts which content each visitor's page **rendered** and which they actually **viewed** (at least half on screen for a second), and sends it to `/api/val/analytics`.
+
+  - No cookies, no storage, no visitor IDs. Each page view also says where it came from (the referring site's host and any `utm_source` / `utm_medium` / `utm_campaign`) and whether it was a phone, tablet or desktop.
+  - A page is sent as its route's pattern (`/posts/$postId`), never its address, so a path that holds something about one visitor (an order number, a token) is never stored. `startValAnalytics` takes this as `routeFor`; `ValProvider` passes TanStack's matched route.
+  - Editors are never counted: nothing is sent in draft mode, in the Studio, with Val enabled, or at a proposal's address, and nothing from automated browsers. A page the browser prerenders counts nothing until it is shown.
+  - The script is the new `@valbuild/react/analytics` entry, loaded only for visitors of a site with analytics on, after the page has hydrated. It imports nothing else from Val.
+  - Storing the counts and showing them is part of Val's hosting, which takes these beacons before they reach the site. Anywhere else, `/api/val/analytics` checks each beacon and stores nothing; in local development, with `VAL_DEBUG=1`, it logs a line per beacon, so you can see it working.
+  - `ValProvider`'s Studio check now matches `/val` and what is below it only, not every route starting with those letters (`/values`). The same fix is in `@valbuild/next`.
+
+- Updated dependencies [[`0139436`](https://github.com/valbuild/val/commit/0139436426142d91cbb29ec6c696dfb86f34ab9d), [`5eff8a0`](https://github.com/valbuild/val/commit/5eff8a055a4ef50d476797c28f9c3e50deb73c89)]:
+  - @valbuild/shared@0.148.3
+  - @valbuild/ui@0.148.3
+
 ## 0.148.2
 
 ### Patch Changes

package/browser/dist/valbuild-server-browser.cjs.dev.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@valbuild/core');
-var ValRouterCore = require('../../dist/ValRouterCore-72594062.cjs.dev.js');
+var ValRouterCore = require('../../dist/ValRouterCore-fec2cbca.cjs.dev.js');
 require('@valbuild/shared/internal');
 require('zod');
 require('zod-validation-error');

package/browser/dist/valbuild-server-browser.cjs.prod.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var core = require('@valbuild/core');
-var ValRouterCore = require('../../dist/ValRouterCore-dd465930.cjs.prod.js');
+var ValRouterCore = require('../../dist/ValRouterCore-dfb7b578.cjs.prod.js');
 require('@valbuild/shared/internal');
 require('zod');
 require('zod-validation-error');

package/browser/dist/valbuild-server-browser.esm.js

@@ -1,5 +1,5 @@
 import { DEFAULT_CONTENT_HOST } from '@valbuild/core';
-import { j as ValOpsMemory, E as bytesToBase64, y as ValServer, z as createValRequestHandler } from '../../dist/ValRouterCore-ad10b6cf.esm.js';
+import { j as ValOpsMemory, E as bytesToBase64, y as ValServer, z as createValRequestHandler } from '../../dist/ValRouterCore-2579e663.esm.js';
 import '@valbuild/shared/internal';
 import 'zod';
 import 'zod-validation-error';

package/dist/{ValRouterCore-ad10b6cf.esm.js → ValRouterCore-2579e663.esm.js}

@@ -1,5 +1,5 @@
 import { Internal, VAL_EXTENSION, extractValModules, computeValModuleShas, ImageSchema, DEFAULT_CONTENT_HOST, hasRemoteFileSchema } from '@valbuild/core';
-import { isSchemaSourceFixError, resolveSchemaSourceFixForError, SerializedSchema, VAL_ENABLE_COOKIE_NAME, VAL_STATE_COOKIE, VAL_SESSION_COOKIE, newestCommitSha, parseJob, VAL_STUDIO_HEADER, getErrorMessageFromUnknownJson, Api } from '@valbuild/shared/internal';
+import { isSchemaSourceFixError, resolveSchemaSourceFixForError, SerializedSchema, AnalyticsBeacon, VAL_ENABLE_COOKIE_NAME, VAL_STATE_COOKIE, VAL_SESSION_COOKIE, newestCommitSha, parseJob, VAL_STUDIO_HEADER, getErrorMessageFromUnknownJson, Api } from '@valbuild/shared/internal';
 import { z } from 'zod';
 import { fromError } from 'zod-validation-error';
 import { result, array } from '@valbuild/core/fp';
@@ -6005,6 +6005,50 @@ const ValServer = (valModules, options, callbacks, platform) => {
         };
       }
     },
+    /**
+     * Content analytics beacons, outside the hosted platform.
+     *
+     * On a site Val hosts, the platform's loader answers this route before a
+     * request reaches the app, and counts. Everywhere else nothing counts yet:
+     * this checks the beacon and answers, so a site with analytics on does not
+     * fill its visitors' consoles with 404s. In local dev it also logs a line
+     * per beacon, which is how the showcase shows analytics working.
+     */
+    "/analytics": {
+      POST: async req => {
+        const parsed = AnalyticsBeacon.safeParse(req.body);
+        if (!parsed.success) {
+          const body = req.body;
+          const version = typeof body === "object" && body !== null && "v" in body ? body.v : undefined;
+          if (typeof version === "number" && version !== 1) {
+            // A newer format than this server knows: not an error.
+            return {
+              status: 200,
+              json: {
+                counted: false
+              }
+            };
+          }
+          return {
+            status: 400,
+            json: {
+              message: "Not a valid Val analytics beacon"
+            }
+          };
+        }
+        if (options.mode === "fs") {
+          const beacon = parsed.data;
+          const count = paths => Object.values(paths).reduce((n, list) => n + list.length, 0);
+          Internal.log.debug(`analytics: ${beacon.route}${beacon.view ? " (page view)" : ""}: ${count(beacon.rendered)} rendered, ${count(beacon.viewed)} viewed`);
+        }
+        return {
+          status: 200,
+          json: {
+            counted: false
+          }
+        };
+      }
+    },
     "/draft/stat": {
       GET: async req => {
         const cookies = req.cookies;
@@ -9052,7 +9096,7 @@ const ValServer = (valModules, options, callbacks, platform) => {
         // TypeScript compiler. See `patch/ts/publishKit.ts`.
         const {
           getJsonEntryAtCommit
-        } = await import('./getJsonEntryAtCommit-e32a470b.esm.js');
+        } = await import('./getJsonEntryAtCommit-66544899.esm.js');
         const res = await getJsonEntryAtCommit(serverOps, req.query.commit_sha, req.query.path, req.query.key);
         if (result.isErr(res)) {
           return historyErrorResponse(res.error);

package/dist/{ValRouterCore-dd465930.cjs.prod.js → ValRouterCore-dfb7b578.cjs.prod.js}

@@ -6011,6 +6011,50 @@ const ValServer = (valModules, options, callbacks, platform) => {
         };
       }
     },
+    /**
+     * Content analytics beacons, outside the hosted platform.
+     *
+     * On a site Val hosts, the platform's loader answers this route before a
+     * request reaches the app, and counts. Everywhere else nothing counts yet:
+     * this checks the beacon and answers, so a site with analytics on does not
+     * fill its visitors' consoles with 404s. In local dev it also logs a line
+     * per beacon, which is how the showcase shows analytics working.
+     */
+    "/analytics": {
+      POST: async req => {
+        const parsed = internal.AnalyticsBeacon.safeParse(req.body);
+        if (!parsed.success) {
+          const body = req.body;
+          const version = typeof body === "object" && body !== null && "v" in body ? body.v : undefined;
+          if (typeof version === "number" && version !== 1) {
+            // A newer format than this server knows: not an error.
+            return {
+              status: 200,
+              json: {
+                counted: false
+              }
+            };
+          }
+          return {
+            status: 400,
+            json: {
+              message: "Not a valid Val analytics beacon"
+            }
+          };
+        }
+        if (options.mode === "fs") {
+          const beacon = parsed.data;
+          const count = paths => Object.values(paths).reduce((n, list) => n + list.length, 0);
+          core.Internal.log.debug(`analytics: ${beacon.route}${beacon.view ? " (page view)" : ""}: ${count(beacon.rendered)} rendered, ${count(beacon.viewed)} viewed`);
+        }
+        return {
+          status: 200,
+          json: {
+            counted: false
+          }
+        };
+      }
+    },
     "/draft/stat": {
       GET: async req => {
         const cookies = req.cookies;
@@ -9058,7 +9102,7 @@ const ValServer = (valModules, options, callbacks, platform) => {
         // TypeScript compiler. See `patch/ts/publishKit.ts`.
         const {
           getJsonEntryAtCommit
-        } = await Promise.resolve().then(function () { return require('./getJsonEntryAtCommit-2a0e9eaf.cjs.prod.js'); });
+        } = await Promise.resolve().then(function () { return require('./getJsonEntryAtCommit-6bbe1c9d.cjs.prod.js'); });
         const res = await getJsonEntryAtCommit(serverOps, req.query.commit_sha, req.query.path, req.query.key);
         if (fp.result.isErr(res)) {
           return historyErrorResponse(res.error);

package/dist/{ValRouterCore-72594062.cjs.dev.js → ValRouterCore-fec2cbca.cjs.dev.js}

@@ -6011,6 +6011,50 @@ const ValServer = (valModules, options, callbacks, platform) => {
         };
       }
     },
+    /**
+     * Content analytics beacons, outside the hosted platform.
+     *
+     * On a site Val hosts, the platform's loader answers this route before a
+     * request reaches the app, and counts. Everywhere else nothing counts yet:
+     * this checks the beacon and answers, so a site with analytics on does not
+     * fill its visitors' consoles with 404s. In local dev it also logs a line
+     * per beacon, which is how the showcase shows analytics working.
+     */
+    "/analytics": {
+      POST: async req => {
+        const parsed = internal.AnalyticsBeacon.safeParse(req.body);
+        if (!parsed.success) {
+          const body = req.body;
+          const version = typeof body === "object" && body !== null && "v" in body ? body.v : undefined;
+          if (typeof version === "number" && version !== 1) {
+            // A newer format than this server knows: not an error.
+            return {
+              status: 200,
+              json: {
+                counted: false
+              }
+            };
+          }
+          return {
+            status: 400,
+            json: {
+              message: "Not a valid Val analytics beacon"
+            }
+          };
+        }
+        if (options.mode === "fs") {
+          const beacon = parsed.data;
+          const count = paths => Object.values(paths).reduce((n, list) => n + list.length, 0);
+          core.Internal.log.debug(`analytics: ${beacon.route}${beacon.view ? " (page view)" : ""}: ${count(beacon.rendered)} rendered, ${count(beacon.viewed)} viewed`);
+        }
+        return {
+          status: 200,
+          json: {
+            counted: false
+          }
+        };
+      }
+    },
     "/draft/stat": {
       GET: async req => {
         const cookies = req.cookies;
@@ -9058,7 +9102,7 @@ const ValServer = (valModules, options, callbacks, platform) => {
         // TypeScript compiler. See `patch/ts/publishKit.ts`.
         const {
           getJsonEntryAtCommit
-        } = await Promise.resolve().then(function () { return require('./getJsonEntryAtCommit-85159574.cjs.dev.js'); });
+        } = await Promise.resolve().then(function () { return require('./getJsonEntryAtCommit-80bf8f02.cjs.dev.js'); });
         const res = await getJsonEntryAtCommit(serverOps, req.query.commit_sha, req.query.path, req.query.key);
         if (fp.result.isErr(res)) {
           return historyErrorResponse(res.error);

package/dist/{getJsonEntryAtCommit-e32a470b.esm.js → getJsonEntryAtCommit-66544899.esm.js}

@@ -1,5 +1,5 @@
 import ts from 'typescript';
-import { F as bytesToUtf8, G as posixPath } from './ValRouterCore-ad10b6cf.esm.js';
+import { F as bytesToUtf8, G as posixPath } from './ValRouterCore-2579e663.esm.js';
 import { result } from '@valbuild/core/fp';
 import { a as analyzeValModule, c as analyzeJsonValuesEntries } from './jsonValuesModule-427d68c8.esm.js';
 import '@valbuild/core';

package/dist/{getJsonEntryAtCommit-2a0e9eaf.cjs.prod.js → getJsonEntryAtCommit-6bbe1c9d.cjs.prod.js}

@@ -1,7 +1,7 @@
 'use strict';
 
 var ts = require('typescript');
-var ValRouterCore = require('./ValRouterCore-dd465930.cjs.prod.js');
+var ValRouterCore = require('./ValRouterCore-dfb7b578.cjs.prod.js');
 var fp = require('@valbuild/core/fp');
 var jsonValuesModule = require('./jsonValuesModule-d1bb8d8f.cjs.prod.js');
 require('@valbuild/core');

package/dist/{getJsonEntryAtCommit-85159574.cjs.dev.js → getJsonEntryAtCommit-80bf8f02.cjs.dev.js}

@@ -1,7 +1,7 @@
 'use strict';
 
 var ts = require('typescript');
-var ValRouterCore = require('./ValRouterCore-72594062.cjs.dev.js');
+var ValRouterCore = require('./ValRouterCore-fec2cbca.cjs.dev.js');
 var fp = require('@valbuild/core/fp');
 var jsonValuesModule = require('./jsonValuesModule-8ae503a8.cjs.dev.js');
 require('@valbuild/core');

package/dist/valbuild-server.cjs.dev.js

@@ -12,7 +12,7 @@ var path = require('path');
 var fs = require('fs');
 var vm = require('node:vm');
 var node_module = require('node:module');
-var ValRouterCore = require('./ValRouterCore-72594062.cjs.dev.js');
+var ValRouterCore = require('./ValRouterCore-fec2cbca.cjs.dev.js');
 var server = require('@valbuild/ui/server');
 var z = require('zod');
 var zodValidationError = require('zod-validation-error');

package/dist/valbuild-server.cjs.prod.js

@@ -12,7 +12,7 @@ var path = require('path');
 var fs = require('fs');
 var vm = require('node:vm');
 var node_module = require('node:module');
-var ValRouterCore = require('./ValRouterCore-dd465930.cjs.prod.js');
+var ValRouterCore = require('./ValRouterCore-dfb7b578.cjs.prod.js');
 var server = require('@valbuild/ui/server');
 var z = require('zod');
 var zodValidationError = require('zod-validation-error');

package/dist/valbuild-server.esm.js

@@ -10,8 +10,8 @@ import path from 'path';
 import fs from 'fs';
 import vm from 'node:vm';
 import { Module } from 'node:module';
-import { r as resolveExistingJsonPath, f as findNestedJsonValuesRecords, v as validateJsonValuesEntries, i as isJsonValuesRootOp, a as rebaseContentOp, c as classifyJsonValuesOp, V as ValOps, b as bufferFromDataUrl, g as getFieldsForType, u as uploadRemoteFile, d as getFileExt, e as guessMimeTypeFromPath, h as createMetadataFromBuffer, j as ValOpsMemory, k as isHlsMasterPlaylist, s as sumHlsSegmentDurations, p as parseHlsMasterVariants, l as largestHlsVariant, m as fallbackRefOf, n as mapHlsUris, o as movedRemoteHost, q as needsHostCheck, t as rewriteRefHost, w as fallbackRemoteHost, x as checkRemoteFiles, y as ValServer, z as createValRequestHandler, A as getNewJsonEntryPaths, B as formatPatchSourceError } from './ValRouterCore-ad10b6cf.esm.js';
-export { I as InMemoryPatchStore, j as ValOpsMemory, C as askOncePerHost, c as classifyJsonValuesOp, B as formatPatchSourceError, d as getFileExt, D as getSettings, a as rebaseContentOp, u as uploadRemoteFile } from './ValRouterCore-ad10b6cf.esm.js';
+import { r as resolveExistingJsonPath, f as findNestedJsonValuesRecords, v as validateJsonValuesEntries, i as isJsonValuesRootOp, a as rebaseContentOp, c as classifyJsonValuesOp, V as ValOps, b as bufferFromDataUrl, g as getFieldsForType, u as uploadRemoteFile, d as getFileExt, e as guessMimeTypeFromPath, h as createMetadataFromBuffer, j as ValOpsMemory, k as isHlsMasterPlaylist, s as sumHlsSegmentDurations, p as parseHlsMasterVariants, l as largestHlsVariant, m as fallbackRefOf, n as mapHlsUris, o as movedRemoteHost, q as needsHostCheck, t as rewriteRefHost, w as fallbackRemoteHost, x as checkRemoteFiles, y as ValServer, z as createValRequestHandler, A as getNewJsonEntryPaths, B as formatPatchSourceError } from './ValRouterCore-2579e663.esm.js';
+export { I as InMemoryPatchStore, j as ValOpsMemory, C as askOncePerHost, c as classifyJsonValuesOp, B as formatPatchSourceError, d as getFileExt, D as getSettings, a as rebaseContentOp, u as uploadRemoteFile } from './ValRouterCore-2579e663.esm.js';
 import { createUIRequestHandler } from '@valbuild/ui/server';
 import z$1, { z } from 'zod';
 import { fromError } from 'zod-validation-error';

package/package.json

@@ -27,7 +27,7 @@
     ],
     "exports": true
   },
-  "version": "0.148.2",
+  "version": "0.148.4",
   "devDependencies": {
     "@prettier/sync": "^0.6.1",
     "@types/jest": "^30.0.0",
@@ -42,8 +42,8 @@
     "zod": "^4.4.3",
     "zod-validation-error": "^5.0.0",
     "@valbuild/core": "0.148.2",
-    "@valbuild/shared": "0.148.2",
-    "@valbuild/ui": "0.148.2"
+    "@valbuild/shared": "0.148.3",
+    "@valbuild/ui": "0.148.4"
   },
   "engines": {
     "node": "^20.19.0 || >=22"