@valbuild/tanstack 0.130.0 → 0.131.0

package/CHANGELOG.md

@@ -1,5 +1,83 @@
 # @valbuild/tanstack
 
+## 0.131.0
+
+### Minor Changes
+
+- [#686](https://github.com/valbuild/val/pull/686) [`0d5857b`](https://github.com/valbuild/val/commit/0d5857b731e11f7e6a011f79297df6485908c31f) Thanks [@freekh](https://github.com/freekh)! - Say `VAL_MODE=memory` where there is no disk, and get a sentence instead of an `EPERM`
+
+  Memory mode — the one for a host that holds the project's source itself — is
+  selected by passing `sourceFiles`, and it has to be: nothing in an environment
+  can supply a project's source, so a mode that an env var could switch on would
+  be a server with no content in it.
+
+  The cost was the failure when a host forgot. Val inferred `fs` mode, `fs` mode
+  went looking for a working tree, and in a Worker isolate the first thing to
+  touch the disk failed:
+
+  ```
+  patch-error /bundle/.val/patches.lock: EPERM
+  ```
+
+  That names a path two layers below the decision that caused it, and nobody
+  reading it would guess "your server was configured for the wrong mode".
+
+  So an environment can now DECLARE that it has no disk:
+
+  ```
+  VAL_MODE=memory
+  ```
+
+  It does not turn memory mode on. It says the host is supposed to be supplying
+  `sourceFiles`, so if none arrive, Val refuses at configuration time and says
+  where to pass them. `VAL_MODE=` counts as unset, the way a shell means it; any
+  other value is refused rather than ignored, since leaving you in `fs` mode is
+  the exact failure this is meant to catch.
+
+  **`initValContent` takes the same options, and this is the release that
+  noticed.** It builds a Val server of its own — these readers resolve content by
+  asking it, not by calling the API over HTTP — so configuring `initValServer`
+  alone left them inferring `fs` mode. On a host with no filesystem that is a
+  reader looking for a working tree that is not there; it went unnoticed because
+  published reads still worked.
+
+  ```ts
+  const patchStore = new InMemoryPatchStore(); // now exported from this package
+
+  const { valApiHandler, draftMode } = initValServer(valModules, config, {
+    sourceFiles: FILES,
+    patchStore,
+    unsafelyAllowUnauthenticated: true,
+  });
+
+  const { fetchValStega } = initValContent(config, valModules, {
+    draftMode,
+    // The same three. Two patch stores are two sets of pending edits, and a
+    // reader that checks a session the host never issues answers itself 401 and
+    // falls back to published content — a draft render showing the live site.
+    sourceFiles: FILES,
+    patchStore,
+    unsafelyAllowUnauthenticated: true,
+  });
+  ```
+
+  All three are optional. Left out, this reader gets its own store and its own
+  answer about authentication, which is right for published content.
+
+  `@valbuild/next` has no memory mode: its `initValServer` takes neither option,
+  so for a Next app `VAL_MODE=memory` names an environment Val cannot serve from,
+  and the error says so.
+
+  Nothing changes for an app that sets none of this: `http` when `VAL_API_KEY`
+  and `VAL_SECRET` are both present, `fs` otherwise, as before.
+
+### Patch Changes
+
+- Updated dependencies [[`0d5857b`](https://github.com/valbuild/val/commit/0d5857b731e11f7e6a011f79297df6485908c31f)]:
+  - @valbuild/server@0.131.0
+  - @valbuild/language-server@0.131.0
+  - @valbuild/mcp@0.131.0
+
 ## 0.130.0
 
 ### Minor Changes

package/dist/declarations/src/server/index.d.ts

@@ -1,4 +1,5 @@
 export { initValServer } from "./initValServer.js";
+export { InMemoryPatchStore, type ValPatchStore } from "@valbuild/server";
 export type { ValHttpMode } from "./initValServer.js";
 export { initValContent } from "./initValContent.js";
 export { valDraftMode, hasValEnableCookieOnServer, VAL_DRAFT_MODE_COOKIE, type ValDraftMode, } from "./valDraftMode.js";

package/dist/declarations/src/server/initValContent.d.ts

@@ -1,6 +1,6 @@
 import { type StegaOfSource } from "@valbuild/react/stega";
 import { SelectorSource, SelectorOf, GenericSelector, ValConfig, ValModules, ValModule, SourceObject, JsonSource } from "@valbuild/core";
-import { ValServer } from "@valbuild/server";
+import { ValServer, type ValPatchStore } from "@valbuild/server";
 import { type ValDraftMode } from "./valDraftMode.js";
 declare const initFetchValStega: (config: ValConfig, valApiEndpoints: string, valServerPromise: Promise<ValServer>, isEnabled: () => Promise<boolean>, getHeaders: () => Promise<{
     get(name: string): string | null;
@@ -113,6 +113,38 @@ export declare function initValContent(config: ValConfig, valModules: ValModules
      * the API turns preview on and these readers are what has to notice.
      */
     draftMode?: ValDraftMode;
+    /**
+     * The project's source, for a host that holds it rather than having it on
+     * a disk. Pass the SAME record `initValServer` got.
+     *
+     * These readers have a Val server of their own -- they resolve content by
+     * asking it, not by calling the API over HTTP -- so the mode question is
+     * put to them separately, and answering it only for `initValServer` left
+     * the readers inferring `fs` mode. On a host with no filesystem that is
+     * a reader looking for a working tree that is not there.
+     */
+    sourceFiles?: Record<string, string>;
+    /**
+     * Where pending patches live, with {@link sourceFiles}. Pass the SAME
+     * store `initValServer` got.
+     *
+     * Two stores are two sets of pending edits: the API would write a patch
+     * into one and a draft render would read the other and show none of it.
+     * Left out, this reader gets its own, which is correct for published
+     * content and empty for drafts.
+     */
+    patchStore?: ValPatchStore;
+    /**
+     * Serve memory mode without authenticating. Pass the SAME value
+     * `initValServer` got.
+     *
+     * This reader's server checks a session like the API's does, so a host
+     * that authenticates outside Val -- and therefore sends no Val session
+     * cookie -- gets 401 from its own reader and silently falls back to
+     * PUBLISHED content. A draft render that shows the live site is the
+     * hardest kind of wrong to notice.
+     */
+    unsafelyAllowUnauthenticated?: boolean;
 }): {
     fetchValStega: ReturnType<typeof initFetchValStega>;
     fetchValKeyStega: ReturnType<typeof initFetchValKeyStega>;

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = require('./version-f2ffc76f.cjs.dev.js');
+var version = require('./version-4c4e9ed0.cjs.dev.js');
 var createForOfIteratorHelper = require('./createForOfIteratorHelper-e75681d7.cjs.dev.js');
 var core = require('@valbuild/core');
 var stega = require('@valbuild/react/stega');

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = require('./version-68d92818.cjs.prod.js');
+var version = require('./version-022ed31c.cjs.prod.js');
 var createForOfIteratorHelper = require('./createForOfIteratorHelper-0324e063.cjs.prod.js');
 var core = require('@valbuild/core');
 var stega = require('@valbuild/react/stega');

package/dist/valbuild-tanstack.esm.js

@@ -1,4 +1,4 @@
-import { _ as _asyncToGenerator, a as _regenerator, r as readValEnableCookie, V as VERSION$1 } from './version-d388ee0d.esm.js';
+import { _ as _asyncToGenerator, a as _regenerator, r as readValEnableCookie, V as VERSION$1 } from './version-b5c8e13d.esm.js';
 import { _ as _objectSpread2, a as _slicedToArray, b as _createForOfIteratorHelper } from './createForOfIteratorHelper-485c2ce1.esm.js';
 import { Internal as Internal$1, initVal as initVal$1, DEFAULT_CONTENT_HOST } from '@valbuild/core';
 import * as core from '@valbuild/core';

package/dist/{version-68d92818.cjs.prod.js → version-022ed31c.cjs.prod.js}

@@ -212,7 +212,7 @@ var packageJson = {
 		"tanstack-router",
 		"react"
 	],
-	version: "0.130.0",
+	version: "0.131.0",
 	scripts: {
 		typecheck: "tsc --noEmit",
 		test: "jest"

package/dist/{version-f2ffc76f.cjs.dev.js → version-4c4e9ed0.cjs.dev.js}

@@ -212,7 +212,7 @@ var packageJson = {
 		"tanstack-router",
 		"react"
 	],
-	version: "0.130.0",
+	version: "0.131.0",
 	scripts: {
 		typecheck: "tsc --noEmit",
 		test: "jest"

package/dist/{version-d388ee0d.esm.js → version-b5c8e13d.esm.js}

@@ -210,7 +210,7 @@ var packageJson = {
 		"tanstack-router",
 		"react"
 	],
-	version: "0.130.0",
+	version: "0.131.0",
 	scripts: {
 		typecheck: "tsc --noEmit",
 		test: "jest"

package/package.json

@@ -14,7 +14,7 @@
     "tanstack-router",
     "react"
   ],
-  "version": "0.130.0",
+  "version": "0.131.0",
   "main": "dist/valbuild-tanstack.cjs.js",
   "module": "dist/valbuild-tanstack.esm.js",
   "exports": {
@@ -43,10 +43,10 @@
   },
   "dependencies": {
     "@valbuild/core": "0.130.0",
-    "@valbuild/language-server": "0.130.0",
-    "@valbuild/mcp": "0.130.0",
     "@valbuild/react": "0.130.0",
-    "@valbuild/server": "0.130.0",
+    "@valbuild/server": "0.131.0",
+    "@valbuild/mcp": "0.131.0",
+    "@valbuild/language-server": "0.131.0",
     "@valbuild/shared": "0.130.0",
     "@valbuild/ui": "0.130.0"
   },

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = require('../../dist/version-f2ffc76f.cjs.dev.js');
+var version = require('../../dist/version-4c4e9ed0.cjs.dev.js');
 var core = require('@valbuild/core');
 var createForOfIteratorHelper = require('../../dist/createForOfIteratorHelper-e75681d7.cjs.dev.js');
 var server = require('@valbuild/server');
@@ -993,13 +993,19 @@ function initValContent(config, valModules, opts) {
   var isEnabled = function isEnabled() {
     return draftMode.isEnabled();
   };
-  var valServerPromise = server.createValServer(valModules, valApiEndpoints, createForOfIteratorHelper._objectSpread2({
+  var valServerPromise = server.createValServer(valModules, valApiEndpoints, createForOfIteratorHelper._objectSpread2(createForOfIteratorHelper._objectSpread2(createForOfIteratorHelper._objectSpread2(createForOfIteratorHelper._objectSpread2({
     versions: {
       // `next` is the field name in the wire contract; see initValServer.
       next: tanstackVersion,
       core: coreVersion
     }
-  }, config), config, {
+  }, config), (opts === null || opts === void 0 ? void 0 : opts.sourceFiles) !== undefined ? {
+    sourceFiles: opts.sourceFiles
+  } : {}), (opts === null || opts === void 0 ? void 0 : opts.patchStore) !== undefined ? {
+    patchStore: opts.patchStore
+  } : {}), (opts === null || opts === void 0 ? void 0 : opts.unsafelyAllowUnauthenticated) !== undefined ? {
+    unsafelyAllowUnauthenticated: opts.unsafelyAllowUnauthenticated
+  } : {}), config, {
     isEnabled: isEnabled,
     onEnable: function onEnable() {
       return draftMode.enable();
@@ -1049,6 +1055,10 @@ version.setValEnableCookieReader(hasValEnableCookieOnServer);
 // Re-exported so an app that mounts the MCP endpoint through this package does
 // not also have to depend on `@valbuild/mcp` for the types it hands back.
 
+Object.defineProperty(exports, 'InMemoryPatchStore', {
+  enumerable: true,
+  get: function () { return server.InMemoryPatchStore; }
+});
 exports.VAL_DRAFT_MODE_COOKIE = VAL_DRAFT_MODE_COOKIE;
 exports.hasValEnableCookieOnServer = hasValEnableCookieOnServer;
 exports.initValContent = initValContent;

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = require('../../dist/version-68d92818.cjs.prod.js');
+var version = require('../../dist/version-022ed31c.cjs.prod.js');
 var core = require('@valbuild/core');
 var createForOfIteratorHelper = require('../../dist/createForOfIteratorHelper-0324e063.cjs.prod.js');
 var server = require('@valbuild/server');
@@ -993,13 +993,19 @@ function initValContent(config, valModules, opts) {
   var isEnabled = function isEnabled() {
     return draftMode.isEnabled();
   };
-  var valServerPromise = server.createValServer(valModules, valApiEndpoints, createForOfIteratorHelper._objectSpread2({
+  var valServerPromise = server.createValServer(valModules, valApiEndpoints, createForOfIteratorHelper._objectSpread2(createForOfIteratorHelper._objectSpread2(createForOfIteratorHelper._objectSpread2(createForOfIteratorHelper._objectSpread2({
     versions: {
       // `next` is the field name in the wire contract; see initValServer.
       next: tanstackVersion,
       core: coreVersion
     }
-  }, config), config, {
+  }, config), (opts === null || opts === void 0 ? void 0 : opts.sourceFiles) !== undefined ? {
+    sourceFiles: opts.sourceFiles
+  } : {}), (opts === null || opts === void 0 ? void 0 : opts.patchStore) !== undefined ? {
+    patchStore: opts.patchStore
+  } : {}), (opts === null || opts === void 0 ? void 0 : opts.unsafelyAllowUnauthenticated) !== undefined ? {
+    unsafelyAllowUnauthenticated: opts.unsafelyAllowUnauthenticated
+  } : {}), config, {
     isEnabled: isEnabled,
     onEnable: function onEnable() {
       return draftMode.enable();
@@ -1049,6 +1055,10 @@ version.setValEnableCookieReader(hasValEnableCookieOnServer);
 // Re-exported so an app that mounts the MCP endpoint through this package does
 // not also have to depend on `@valbuild/mcp` for the types it hands back.
 
+Object.defineProperty(exports, 'InMemoryPatchStore', {
+  enumerable: true,
+  get: function () { return server.InMemoryPatchStore; }
+});
 exports.VAL_DRAFT_MODE_COOKIE = VAL_DRAFT_MODE_COOKIE;
 exports.hasValEnableCookieOnServer = hasValEnableCookieOnServer;
 exports.initValContent = initValContent;

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

@@ -1,7 +1,8 @@
-import { _ as _asyncToGenerator, a as _regenerator, V as VERSION, s as setValEnableCookieReader } from '../../dist/version-d388ee0d.esm.js';
+import { _ as _asyncToGenerator, a as _regenerator, V as VERSION, s as setValEnableCookieReader } from '../../dist/version-b5c8e13d.esm.js';
 import { Internal } from '@valbuild/core';
 import { _ as _objectSpread2, a as _slicedToArray, d as _defineProperty } from '../../dist/createForOfIteratorHelper-485c2ce1.esm.js';
 import { createValApiRouter, createValServer } from '@valbuild/server';
+export { InMemoryPatchStore } from '@valbuild/server';
 import { b as initValRouteFromVal, g as getJsonEntryStegaRoot, i as isJsonValuesRecordSchema, a as getValRouteUrlFromVal, _ as _typeof } from '../../dist/routeFromVal-728295a0.esm.js';
 import { stegaEncode, SET_AUTO_TAG_JSX_ENABLED } from '@valbuild/react/stega';
 import { VAL_SESSION_COOKIE } from '@valbuild/shared/internal';
@@ -971,13 +972,19 @@ function initValContent(config, valModules, opts) {
   var isEnabled = function isEnabled() {
     return draftMode.isEnabled();
   };
-  var valServerPromise = createValServer(valModules, valApiEndpoints, _objectSpread2({
+  var valServerPromise = createValServer(valModules, valApiEndpoints, _objectSpread2(_objectSpread2(_objectSpread2(_objectSpread2({
     versions: {
       // `next` is the field name in the wire contract; see initValServer.
       next: tanstackVersion,
       core: coreVersion
     }
-  }, config), config, {
+  }, config), (opts === null || opts === void 0 ? void 0 : opts.sourceFiles) !== undefined ? {
+    sourceFiles: opts.sourceFiles
+  } : {}), (opts === null || opts === void 0 ? void 0 : opts.patchStore) !== undefined ? {
+    patchStore: opts.patchStore
+  } : {}), (opts === null || opts === void 0 ? void 0 : opts.unsafelyAllowUnauthenticated) !== undefined ? {
+    unsafelyAllowUnauthenticated: opts.unsafelyAllowUnauthenticated
+  } : {}), config, {
     isEnabled: isEnabled,
     onEnable: function onEnable() {
       return draftMode.enable();