@volter/world-runtime 3.0.36 → 3.0.38

package/dist/src/browsers.d.ts

@@ -8,7 +8,7 @@ export type WorldBrowser = {
 export declare const browsersDir: (data: string) => string;
 export declare function worldBrowser(data: string, name: string): WorldBrowser | null;
 export declare function worldBrowsers(data: string): WorldBrowser[];
-export declare function putWorldBrowser(data: string, name: string, state: BrowserState): WorldBrowser;
+export declare function putWorldBrowser(data: string, name: string, state: unknown): WorldBrowser;
 export declare function deleteWorldBrowser(data: string, name: string): void;
 export declare function inheritWorldBrowsers(fromData: string, toData: string): void;
 /** Derived files under the World state directory, written only by its current branch. */

package/dist/src/browsers.js

@@ -26,7 +26,7 @@ export function worldBrowser(data, name) {
         held.text = text;
         return held.record;
     }
-    validateBrowserState(record.state);
+    record.state = validateBrowserState(record.state);
     const freeze = (value) => {
         if (!value || typeof value !== 'object')
             return;

package/dist/src/init.js

@@ -1159,15 +1159,15 @@ export async function seed(): Promise<void> {
         if (!door || !token) throw new Error('browser defaults run in a World seed with its browsers door and credential');
         const held = await fetch(\`\${door}/\${encodeURIComponent(call.browser)}\`, { headers: { 'x-volter-token': token } });
         if (!held.ok && held.status !== 404) throw new Error(\`browser \${call.browser}: \${held.status} \${await held.text()}\`);
-        snapshots.set(call.browser, held.ok ? await held.json() as Awaited<ReturnType<SeedBrowser['state']>> : { cookies: [], origins: [] });
+        snapshots.set(call.browser, held.ok ? await held.json() as Awaited<ReturnType<SeedBrowser['state']>> : { storageState: { cookies: [], origins: [] }, context: {} });
       }
       browserHelper ??= await import('@volter/world-core/browser').catch(error => {
-        throw new Error('Install @volter/world-core 3.0.31 or later in this project to seed browsers.', { cause: error });
+        throw new Error('Install @volter/world-core 3.0.37 or later in this project to seed browsers.', { cause: error });
       });
       const initial = snapshots.get(call.browser)!;
       const hostname = new URL(call.path).hostname;
-      if (initial.cookies.some(cookie => browserHelper!.cookieMatchesHost(cookie, hostname))
-        || initial.origins.some(origin => new URL(origin.origin).hostname === hostname)) continue;
+      if (initial.storageState.cookies.some(cookie => browserHelper!.cookieMatchesHost(cookie, hostname))
+        || initial.storageState.origins.some(origin => new URL(origin.origin).hostname === hostname)) continue;
     }
     const headers = { ...(call.body !== undefined ? { 'content-type': 'application/json' } : {}), ...(call.headers ?? {}) };
     const form = /^application\\/x-www-form-urlencoded\\b/i.test(new Headers(headers).get('content-type') ?? '');

package/dist/src/served-world.js

@@ -32,7 +32,7 @@ import { boardFrameKey, getActiveWorldStore, withHistoryLocks, captureHistory, h
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from 'node:fs';
 import { CALLER_HEADER, callerForHeader, newTraceparent, parseTraceparent, traceparentForDelivery, readTwinRequestJournalFrom, assertSafeChangesetName, blobDigest, destinationOf, getActiveBlobStore, journalTwinRequest, loadCheck, twinRequestJournalFailures, openSealedAt, readTwinRequestJournal, serveHttp, twinRequestCredentials, TWIN_PREFIX_HEADER, TWIN_SITES_HEADER, TWIN_SITE_HEADER, siteUrlOf, ORIGINAL_PATH_HEADER, validateRemoteOrigin } from '@volter/world-core/runtime';
 import { resolveTwinHost } from '@volter/world-core/host-routing';
-import { assertBrowserName, validateBrowserState, cookieMatchesHost } from '@volter/world-core';
+import { assertBrowserName, validateBrowserState, browserAcceptLanguage, cookieMatchesHost } from '@volter/world-core';
 import { worldBrowser, worldBrowsers, putWorldBrowser, deleteWorldBrowser, materializeBrowserFiles, browserLoad, putBrowserLoad, browserLoadId } from "./browsers.js";
 import { APP_READ_ENDPOINT_ENV } from "./init.js";
 import { packFacts, packHostRules } from "./pack-facts.js";
@@ -1129,8 +1129,8 @@ export class WorldDoors {
             return null;
         if (request.method !== 'GET' || !['document', 'iframe'].includes(request.headers.get('sec-fetch-dest') ?? ''))
             return null;
-        const cookies = browser.state.cookies.filter(c => cookieMatchesHost(c, site));
-        const storage = browser.state.origins.find(o => new URL(o.origin).hostname === site)?.localStorage ?? [];
+        const cookies = browser.state.storageState.cookies.filter(c => cookieMatchesHost(c, site));
+        const storage = browser.state.storageState.origins.find(o => new URL(o.origin).hostname === site)?.localStorage ?? [];
         const headers = new Headers({ 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-store', 'referrer-policy': 'no-referrer' });
         const protectedCookie = (key) => /^(?:__Host-)?volter_(?:world|pages|browser)$/.test(key);
         const expired = new Map();
@@ -1240,6 +1240,10 @@ export class WorldDoors {
                     headers.set(name, v);
             }
             if (browser) {
+                const profile = worldBrowser(this.up().dirs.data, browser)?.state;
+                const language = profile ? browserAcceptLanguage(profile.context) : undefined;
+                if (language !== undefined)
+                    headers.set('accept-language', language);
                 const cookies = (request.headers.get('cookie') ?? '').split(/;\s*/).filter(c => !/^(?:__Host-)?volter_(?:world|pages|browser)=/.test(c));
                 if (cookies.length)
                     headers.set('cookie', cookies.join('; '));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/world-runtime",
-  "version": "3.0.36",
+  "version": "3.0.38",
   "description": "World configs for twins: boot named local runtimes, allocate ports, generate world.env/instance.json, and run apps against fake-key twin worlds.",
   "keywords": [
     "twin",
@@ -68,14 +68,14 @@
     "node": ">=22.3"
   },
   "peerDependencies": {
-    "@volter/world-core": "3.0.36",
-    "@volter/world-console": "3.0.31"
+    "@volter/world-core": "3.0.38",
+    "@volter/world-console": "3.0.33"
   },
   "dependencies": {
     "@electric-sql/pglite": "0.5.8",
     "@electric-sql/pglite-pgvector": "0.0.9",
     "@volter/world-access": "3.0.1",
-    "@volter/world-core": "3.0.36",
+    "@volter/world-core": "3.0.38",
     "pg-gateway": "0.3.0-beta.4",
     "smol-toml": "^1.8.0",
     "yaml": "2.9.0"

package/src/browsers.ts

@@ -20,7 +20,7 @@ export function worldBrowser(data: string, name: string): WorldBrowser | null {
   const record = JSON.parse(text) as WorldBrowser;
   if (record.name !== name || typeof record.version !== 'string') throw new Error(`invalid browser record: ${name}`);
   if (held?.version === record.version) { held.text = text; return held.record; }
-  validateBrowserState(record.state);
+  record.state = validateBrowserState(record.state);
   const freeze = (value: unknown): void => {
     if (!value || typeof value !== 'object') return;
     for (const item of Object.values(value)) freeze(item);
@@ -33,7 +33,7 @@ export function worldBrowser(data: string, name: string): WorldBrowser | null {
 export function worldBrowsers(data: string): WorldBrowser[] {
   return getActiveWorldStore().list(browsersDir(data)).filter(f => f.endsWith('.json')).sort().map(f => worldBrowser(data, f.slice(0, -5))!);
 }
-export function putWorldBrowser(data: string, name: string, state: BrowserState): WorldBrowser {
+export function putWorldBrowser(data: string, name: string, state: unknown): WorldBrowser {
   const record = { name, state: validateBrowserState(state), version: randomUUID() };
   getActiveWorldStore().writeAtomic(path(data, name), `${JSON.stringify(record)}\n`, { secret: true });
   retireBrowserLoads(data, name, record);

package/src/init.ts

@@ -1346,15 +1346,15 @@ export async function seed(): Promise<void> {
         if (!door || !token) throw new Error('browser defaults run in a World seed with its browsers door and credential');
         const held = await fetch(\`\${door}/\${encodeURIComponent(call.browser)}\`, { headers: { 'x-volter-token': token } });
         if (!held.ok && held.status !== 404) throw new Error(\`browser \${call.browser}: \${held.status} \${await held.text()}\`);
-        snapshots.set(call.browser, held.ok ? await held.json() as Awaited<ReturnType<SeedBrowser['state']>> : { cookies: [], origins: [] });
+        snapshots.set(call.browser, held.ok ? await held.json() as Awaited<ReturnType<SeedBrowser['state']>> : { storageState: { cookies: [], origins: [] }, context: {} });
       }
       browserHelper ??= await import('@volter/world-core/browser').catch(error => {
-        throw new Error('Install @volter/world-core 3.0.31 or later in this project to seed browsers.', { cause: error });
+        throw new Error('Install @volter/world-core 3.0.37 or later in this project to seed browsers.', { cause: error });
       });
       const initial = snapshots.get(call.browser)!;
       const hostname = new URL(call.path).hostname;
-      if (initial.cookies.some(cookie => browserHelper!.cookieMatchesHost(cookie, hostname))
-        || initial.origins.some(origin => new URL(origin.origin).hostname === hostname)) continue;
+      if (initial.storageState.cookies.some(cookie => browserHelper!.cookieMatchesHost(cookie, hostname))
+        || initial.storageState.origins.some(origin => new URL(origin.origin).hostname === hostname)) continue;
     }
     const headers = { ...(call.body !== undefined ? { 'content-type': 'application/json' } : {}), ...(call.headers ?? {}) };
     const form = /^application\\/x-www-form-urlencoded\\b/i.test(new Headers(headers).get('content-type') ?? '');

package/src/served-world.ts

@@ -32,7 +32,7 @@ import { boardFrameKey, getActiveWorldStore, withHistoryLocks, captureHistory, h
 import { chmodSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync , rmSync} from 'node:fs';
 import { CALLER_HEADER, callerForHeader, newTraceparent, parseTraceparent, traceparentForDelivery, readTwinRequestJournalFrom, type TwinRequestJournalCursor, assertSafeChangesetName, blobDigest, destinationOf, getActiveBlobStore, journalTwinRequest, loadCheck, twinRequestJournalFailures, openSealedAt, readTwinRequestJournal, serveHttp, twinRequestCredentials, TWIN_PREFIX_HEADER, TWIN_SITES_HEADER, TWIN_SITE_HEADER, siteLabel, siteUrlOf, ORIGINAL_PATH_HEADER, validateRemoteOrigin, type SealedCredential, type TwinStreamConnection, type TwinStreamSink, type BoardFrame } from '@volter/world-core/runtime';
 import { resolveTwinHost, type HostPredicate } from '@volter/world-core/host-routing';
-import { assertBrowserName, validateBrowserState, cookieMatchesHost } from '@volter/world-core';
+import { assertBrowserName, validateBrowserState, browserAcceptLanguage, cookieMatchesHost } from '@volter/world-core';
 import { worldBrowser, worldBrowsers, putWorldBrowser, deleteWorldBrowser, materializeBrowserFiles, browserLoad, putBrowserLoad, browserLoadId } from './browsers.ts';
 import { APP_READ_ENDPOINT_ENV } from './init.ts';
 import { packFacts, packHostRules } from './pack-facts.ts';
@@ -1024,8 +1024,8 @@ export class WorldDoors {
     const carried = [current, previous].filter(load => load?.name === name && load.site === site);
     if (id === loadId && current?.name === name && current.site === site && current.version === browser.version) return null;
     if (request.method !== 'GET' || !['document', 'iframe'].includes(request.headers.get('sec-fetch-dest') ?? '')) return null;
-    const cookies = browser.state.cookies.filter(c => cookieMatchesHost(c, site));
-    const storage = browser.state.origins.find(o => new URL(o.origin).hostname === site)?.localStorage ?? [];
+    const cookies = browser.state.storageState.cookies.filter(c => cookieMatchesHost(c, site));
+    const storage = browser.state.storageState.origins.find(o => new URL(o.origin).hostname === site)?.localStorage ?? [];
     const headers = new Headers({ 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-store', 'referrer-policy': 'no-referrer' });
     const protectedCookie = (key: string): boolean => /^(?:__Host-)?volter_(?:world|pages|browser)$/.test(key);
     const expired = new Map<string, { name: string; path: string }>();
@@ -1111,6 +1111,9 @@ export class WorldDoors {
       for (const key of [TOKEN_HEADER, TWINS_KEY_HEADER, CALLER_HEADER, ORIGINAL_PATH_HEADER, READ_ONLY_HEADER, 'host', TWIN_PREFIX_HEADER, TWIN_SITES_HEADER, TWIN_SITE_HEADER]) headers.delete(key);
       for (const name of ['accept', 'accept-language', 'if-none-match', 'range', 'user-agent']) { const v = request.headers.get(name); if (v !== null) headers.set(name, v); }
       if (browser) {
+        const profile = worldBrowser(this.up().dirs.data, browser)?.state;
+        const language = profile ? browserAcceptLanguage(profile.context) : undefined;
+        if (language !== undefined) headers.set('accept-language', language);
         const cookies = (request.headers.get('cookie') ?? '').split(/;\s*/).filter(c => !/^(?:__Host-)?volter_(?:world|pages|browser)=/.test(c));
         if (cookies.length) headers.set('cookie', cookies.join('; '));
         headers.set('x-volter-world-browser', browser);