@volter/world-runtime 3.0.47 → 3.0.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/world-runtime",
-  "version": "3.0.47",
+  "version": "3.0.49",
   "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",
@@ -69,14 +69,14 @@
     "node": ">=22.3"
   },
   "peerDependencies": {
-    "@volter/world-core": "3.0.47",
-    "@volter/world-console": "3.0.42"
+    "@volter/world-core": "3.0.49",
+    "@volter/world-console": "3.0.44"
   },
   "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.47",
+    "@volter/world-core": "3.0.49",
     "mongodb": "~6.20.0",
     "pg-gateway": "0.3.0-beta.4",
     "smol-toml": "^1.8.0",

package/src/pglite-backing.ts

@@ -23,7 +23,7 @@ import { fileURLToPath } from 'node:url';
 import { parse } from 'yaml';
 import { mongodbArgv, mongodbListening, mongodbReady } from './mongodb-backing.ts';
 
-export interface InfraService { kind: string; hostPort: number; replicaSet?: string }
+export interface InfraService { kind: string; hostPort: number; replicaSet?: string; postgres?: { user: string; database: string; password?: string } }
 
 /** Read the generated definition's loopback port mappings. MongoDB may explicitly request
  *  one replica-set member through its Compose-compatible command; other mongod options are refused. */
@@ -31,7 +31,7 @@ export function parseInfraDefinition(text: string): InfraService[] {
   const definition = parse(text);
   const services: InfraService[] = [];
   for (const [kind, value] of Object.entries(definition?.services ?? {})) {
-    const declared = value as { ports?: unknown[]; command?: unknown };
+    const declared = value as { ports?: unknown[]; command?: unknown; environment?: Record<string, unknown> };
     let replicaSet: string | undefined;
     if (kind === 'mongodb' && declared.command !== undefined) {
       const command = declared.command;
@@ -46,7 +46,19 @@ export function parseInfraDefinition(text: string): InfraService[] {
       return match ? [Number(match[1])] : [];
     });
     if (ports.length !== 1) throw new Error(`managed infrastructure ${kind} needs exactly one declared loopback port`);
-    services.push({ kind, hostPort: ports[0]!, ...(replicaSet ? { replicaSet } : {}) });
+    let postgres: InfraService['postgres'];
+    if (kind === 'postgres') {
+      const environment = declared.environment ?? {};
+      const user = environment.POSTGRES_USER ?? 'postgres';
+      const database = environment.POSTGRES_DB ?? user;
+      const password = environment.POSTGRES_PASSWORD;
+      if ([user, database, password].some(value => value !== undefined && (typeof value !== 'string' || !value || /[\r\n\0]|\$\{/.test(value)))) {
+        throw new Error('World-managed PGlite requires literal POSTGRES_USER, POSTGRES_DB and POSTGRES_PASSWORD');
+      }
+      if ([user, database].some(value => Buffer.byteLength(value as string, 'utf8') > 63)) throw new Error('World-managed PGlite identifiers must fit PostgreSQL\'s 63-byte name limit');
+      postgres = { user: user as string, database: database as string, ...(password !== undefined ? { password: password as string } : {}) };
+    }
+    services.push({ kind, hostPort: ports[0]!, ...(replicaSet ? { replicaSet } : {}), ...(postgres ? { postgres } : {}) });
   }
   return services;
 }
@@ -167,6 +179,7 @@ export async function pgliteUp(services: InfraService[], dataDir: string, launch
     }
     const name = CONTAINERLESS[service.kind] ?? `pglite-${service.kind}`;
     const serviceData = join(dataDir, containerlessDataDirectory(service.kind) ?? `${name}-data`);
+    if (service.kind === 'postgres' && !service.postgres?.password) throw new Error('World-managed PGlite requires a literal POSTGRES_PASSWORD; declare a throwaway World credential');
     const log = join(dataDir, `${name}.log`);
     if (await listening(service.hostPort)) {
       throw new Error(`${name} cannot serve port ${service.hostPort}: another process is already listening on it`);
@@ -184,7 +197,8 @@ export async function pgliteUp(services: InfraService[], dataDir: string, launch
       const logFd = openSync(log, 'a');
       const child = spawn(command!, args, {
         windowsHide: true,
-        env,
+        env: service.postgres ? { ...env, VOLTER_WORLD_PGLITE_USER: service.postgres.user,
+          VOLTER_WORLD_PGLITE_DATABASE: service.postgres.database, VOLTER_WORLD_PGLITE_PASSWORD: service.postgres.password } : env,
         detached: true,
         stdio: ['ignore', logFd, logFd],
       });