@omg-dev/server 0.4.28 → 0.4.30

package/dist/index.mjs

@@ -1363,6 +1363,18 @@ function buildAutoCrudRoutes(schema) {
 	return routes;
 }
 //#endregion
+//#region src/agent-url.ts
+const DEFAULT_AGENT_URL = "http://localhost:8080";
+/**
+* Base URL for the in-VM agent.
+*
+* Read lazily so local runtimes can inject the emulator URL before loading
+* user code without coupling the SDK to a particular process bootstrap.
+*/
+function agentBase() {
+	return process.env.OMG_AGENT_URL || process.env.VIBES_AGENT_URL || DEFAULT_AGENT_URL;
+}
+//#endregion
 //#region src/triggers.ts
 /**
 * Schedule a function to run on a cron expression (UTC, 5-field syntax).
@@ -1496,9 +1508,10 @@ async function registerTriggers(entries) {
 			storageHookHandlers.get(e.kind).add(e.handler);
 		}
 	}
-	const inProcessCron = vibesMode$1() === "dev" || cronDriver() === "in-process";
+	const inBuild = inBuildMode();
+	const inProcessCron = !inBuild && (vibesMode$1() === "dev" || cronDriver() === "in-process");
 	if (inProcessCron) scheduleAllCronInProcess();
-	console.log(`[vibes:triggers] registered ${entries.length} trigger(s) — mode=${vibesMode$1()}, cron=${inProcessCron ? "in-process" : "orchestrator"}`);
+	console.log(`[vibes:triggers] registered ${entries.length} trigger(s) — mode=${vibesMode$1()}, cron=${inBuild ? "unarmed (build)" : inProcessCron ? "in-process" : "orchestrator"}`);
 }
 /** Snapshot of the registry — used by the in-dev Inspect endpoints. */
 function listTriggers() {
@@ -1660,7 +1673,8 @@ function emitInProcess(topic, payload) {
 async function emitToOrchestrator(topic, payload) {
 	const payloadStr = JSON.stringify(payload ?? null);
 	if (payloadStr.length > MAX_EMIT_BYTES) throw new Error(`emit("${topic}"): payload exceeds ${MAX_EMIT_BYTES} bytes`);
-	const res = await fetch("http://localhost:8080/_emit", {
+	const url = `${agentBase()}/_emit`;
+	const res = await fetch(url, {
 		method: "POST",
 		headers: { "Content-Type": "application/json" },
 		body: JSON.stringify({
@@ -1772,7 +1786,8 @@ function updateDevDelivery(id, patch) {
 async function scheduleToOrchestrator(atMs, topic, payload) {
 	const payloadStr = JSON.stringify(payload ?? null);
 	if (payloadStr.length > MAX_EMIT_BYTES) throw new Error(`schedule("${topic}"): payload exceeds ${MAX_EMIT_BYTES} bytes`);
-	const res = await fetch("http://localhost:8080/_schedule", {
+	const url = `${agentBase()}/_schedule`;
+	const res = await fetch(url, {
 		method: "POST",
 		headers: { "Content-Type": "application/json" },
 		body: JSON.stringify({
@@ -1793,7 +1808,7 @@ async function scheduleToOrchestrator(atMs, topic, payload) {
 	};
 }
 async function cancelOnOrchestrator(eventId) {
-	const url = `http://localhost:8080/_schedule/${encodeURIComponent(eventId)}`;
+	const url = `${agentBase()}/_schedule/${encodeURIComponent(eventId)}`;
 	const res = await fetch(url, { method: "DELETE" });
 	if (!res.ok) {
 		const text = await res.text().catch(() => "");
@@ -1907,6 +1922,9 @@ function vibesMode$1() {
 	_vibesMode$1 = ((typeof process !== "undefined" ? process.env?.VIBES_MODE : void 0) ?? "") === "dev" ? "dev" : "prod";
 	return _vibesMode$1;
 }
+function inBuildMode() {
+	return (typeof process !== "undefined" ? process.env?.VIBES_BUILD : void 0) === "1";
+}
 function devInspectTriggers() {
 	return Array.from(triggerRegistry.values()).map(({ entry }, i) => ({
 		id: `trg_dev_${i}_${entry.handler}`,
@@ -2146,7 +2164,7 @@ function handleWorkflowRequest(req) {
 	return restateFetchHandler(req);
 }
 async function startViaAgent(name, payloadStr, opts) {
-	const res = await fetch("http://localhost:8080/_workflow/start", {
+	const res = await fetch(`${agentBase()}/_workflow/start`, {
 		method: "POST",
 		headers: { "Content-Type": "application/json" },
 		body: JSON.stringify({
@@ -2233,9 +2251,8 @@ const storage = {
 	onUpload,
 	onDelete
 };
-const AGENT_BASE$1 = "http://localhost:8080";
 async function prodPresign(action, key, scope, userId, contentType) {
-	const res = await fetch(`${AGENT_BASE$1}/_storage/presign`, {
+	const res = await fetch(`${agentBase()}/_storage/presign`, {
 		method: "POST",
 		headers: { "Content-Type": "application/json" },
 		body: JSON.stringify({
@@ -2260,7 +2277,7 @@ async function prodPresign(action, key, scope, userId, contentType) {
 	};
 }
 async function prodList(scope, userId, prefix, limit) {
-	const res = await fetch(`${AGENT_BASE$1}/_storage/list`, {
+	const res = await fetch(`${agentBase()}/_storage/list`, {
 		method: "POST",
 		headers: { "Content-Type": "application/json" },
 		body: JSON.stringify({
@@ -2283,7 +2300,7 @@ async function prodList(scope, userId, prefix, limit) {
 	}));
 }
 async function prodDelete(key, scope, userId) {
-	const res = await fetch(`${AGENT_BASE$1}/_storage/delete`, {
+	const res = await fetch(`${agentBase()}/_storage/delete`, {
 		method: "POST",
 		headers: { "Content-Type": "application/json" },
 		body: JSON.stringify({
@@ -2875,7 +2892,6 @@ self.addEventListener("notificationclick", (event) => {
 }
 //#endregion
 //#region src/billing.ts
-const AGENT_BASE = "http://localhost:8080";
 const MICROS_PER_UNIT = 1e6;
 /**
 * Dollars (or whole credit units) → integer micro-units, for the amount
@@ -2886,7 +2902,7 @@ function usd(amount) {
 	return Math.round(amount * MICROS_PER_UNIT);
 }
 async function agentPost(path, body, label) {
-	const res = await fetch(`${AGENT_BASE}${path}`, {
+	const res = await fetch(`${agentBase()}${path}`, {
 		method: "POST",
 		headers: { "Content-Type": "application/json" },
 		body: JSON.stringify(body)
@@ -2898,7 +2914,7 @@ async function agentPost(path, body, label) {
 	return await res.json();
 }
 async function agentGet(path, label) {
-	const res = await fetch(`${AGENT_BASE}${path}`, {
+	const res = await fetch(`${agentBase()}${path}`, {
 		method: "GET",
 		headers: { Accept: "application/json" }
 	});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omg-dev/server",
-  "version": "0.4.28",
+  "version": "0.4.30",
   "type": "module",
   "exports": {
     ".": {
@@ -14,14 +14,19 @@
   },
   "dependencies": {
     "@restatedev/restate-sdk": "1.14.5",
-    "@omg-dev/auth": "0.4.28",
-    "@omg-dev/schema": "0.4.28",
-    "@omg-dev/stream": "0.4.28",
+    "@omg-dev/auth": "0.4.30",
+    "@omg-dev/schema": "0.4.30",
+    "@omg-dev/stream": "0.4.30",
     "web-push": "^3.6.7"
   },
   "scripts": {
     "build": "vp pack src/index.ts src/trigger-scan.ts --no-dts",
-    "test": "vp test run"
+    "test": "vp test run",
+    "typecheck": "tsc6 --noEmit --allowImportingTsExtensions --types bun"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.0.0",
+    "typescript": "npm:@typescript/typescript6@6.0.2"
   },
   "license": "MIT",
   "repository": {

package/src/agent-url.test.ts

@@ -0,0 +1,36 @@
+import { afterEach, describe, expect, it } from "vitest"
+import { agentBase } from "./agent-url.ts"
+
+const originalOmgAgentUrl = process.env.OMG_AGENT_URL
+const originalVibesAgentUrl = process.env.VIBES_AGENT_URL
+
+afterEach(() => {
+  if (originalOmgAgentUrl === undefined) delete process.env.OMG_AGENT_URL
+  else process.env.OMG_AGENT_URL = originalOmgAgentUrl
+
+  if (originalVibesAgentUrl === undefined) delete process.env.VIBES_AGENT_URL
+  else process.env.VIBES_AGENT_URL = originalVibesAgentUrl
+})
+
+describe("agentBase", () => {
+  it("preserves the in-VM default when no override is set", () => {
+    delete process.env.OMG_AGENT_URL
+    delete process.env.VIBES_AGENT_URL
+
+    expect(agentBase()).toBe("http://localhost:8080")
+  })
+
+  it("uses VIBES_AGENT_URL as the compatibility override", () => {
+    delete process.env.OMG_AGENT_URL
+    process.env.VIBES_AGENT_URL = "http://127.0.0.1:4100"
+
+    expect(agentBase()).toBe("http://127.0.0.1:4100")
+  })
+
+  it("prefers OMG_AGENT_URL when both overrides are set", () => {
+    process.env.OMG_AGENT_URL = "http://127.0.0.1:4200"
+    process.env.VIBES_AGENT_URL = "http://127.0.0.1:4100"
+
+    expect(agentBase()).toBe("http://127.0.0.1:4200")
+  })
+})

package/src/agent-url.ts

@@ -0,0 +1,11 @@
+const DEFAULT_AGENT_URL = "http://localhost:8080"
+
+/**
+ * Base URL for the in-VM agent.
+ *
+ * Read lazily so local runtimes can inject the emulator URL before loading
+ * user code without coupling the SDK to a particular process bootstrap.
+ */
+export function agentBase(): string {
+  return process.env.OMG_AGENT_URL || process.env.VIBES_AGENT_URL || DEFAULT_AGENT_URL
+}

package/src/billing.ts

@@ -34,7 +34,8 @@
 //     return Response.json(result)
 //   }
 
-const AGENT_BASE = "http://localhost:8080"
+import { agentBase } from "./agent-url.ts"
+
 const MICROS_PER_UNIT = 1_000_000
 
 /**
@@ -140,7 +141,7 @@ export interface GrantOptions {
 // out, throw on non-2xx with a truncated body for diagnosability.
 
 async function agentPost<T>(path: string, body: unknown, label: string): Promise<T> {
-  const res = await fetch(`${AGENT_BASE}${path}`, {
+  const res = await fetch(`${agentBase()}${path}`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify(body),
@@ -153,7 +154,7 @@ async function agentPost<T>(path: string, body: unknown, label: string): Promise
 }
 
 async function agentGet<T>(path: string, label: string): Promise<T> {
-  const res = await fetch(`${AGENT_BASE}${path}`, {
+  const res = await fetch(`${agentBase()}${path}`, {
     method: "GET",
     headers: { Accept: "application/json" },
   })

package/src/storage.ts

@@ -31,6 +31,7 @@ import path from "node:path"
 import fs from "node:fs"
 import crypto from "node:crypto"
 import { ctxStore, ctx } from "./ctx.ts"
+import { agentBase } from "./agent-url.ts"
 
 // ── Types ────────────────────────────────────────────────────────────────────
 
@@ -192,8 +193,6 @@ export const storage = {
 
 // ── prod-mode: HTTP to the agent ─────────────────────────────────────────────
 
-const AGENT_BASE = "http://localhost:8080"
-
 async function prodPresign(
   action: "put" | "get",
   key: string,
@@ -201,7 +200,7 @@ async function prodPresign(
   userId: string,
   contentType?: string,
 ): Promise<PresignedUploadResult> {
-  const res = await fetch(`${AGENT_BASE}/_storage/presign`, {
+  const res = await fetch(`${agentBase()}/_storage/presign`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({ action, key, scope, userId, contentType }),
@@ -221,7 +220,7 @@ async function prodPresign(
 }
 
 async function prodList(scope: StorageScope, userId: string, prefix: string, limit: number): Promise<StorageItem[]> {
-  const res = await fetch(`${AGENT_BASE}/_storage/list`, {
+  const res = await fetch(`${agentBase()}/_storage/list`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({ scope, userId, prefix, limit }),
@@ -247,7 +246,7 @@ async function prodList(scope: StorageScope, userId: string, prefix: string, lim
 }
 
 async function prodDelete(key: string, scope: StorageScope, userId: string): Promise<void> {
-  const res = await fetch(`${AGENT_BASE}/_storage/delete`, {
+  const res = await fetch(`${agentBase()}/_storage/delete`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({ key, scope, userId }),

package/src/test/build-mode-cron.test.ts

@@ -0,0 +1,80 @@
+// Regression test for the vibes-build hang (confirmed: `[vibes-build] done.`
+// prints, process never exits when the project declares cron()/on()).
+//
+// Root cause: registerTriggers() arms an in-process setTimeout chain for
+// every cron() handler whenever vibesMode()==="dev" or cronDriver()===
+// "in-process" — including when createVibesServer() is constructed by the
+// vibes vite-plugin's configureServer hook, which prerenderApp() (part of
+// `vibes-build`) triggers indirectly via a nested Vite dev server. Those
+// timers keep the event loop alive forever with no caller left to clear
+// them, since a build process has no request loop to eventually close it.
+//
+// This can only be observed as a live-process behavior (does the process
+// exit on its own?), not through a return-value assertion on
+// registerTriggers() — so this test spawns a real Bun subprocess and checks
+// whether it terminates within a bounded window.
+
+import { describe, expect, test } from "bun:test"
+import fs from "node:fs"
+import os from "node:os"
+import path from "node:path"
+
+const triggersModulePath = path.join(import.meta.dir, "..", "triggers.ts")
+
+function writeRegisterScript(): string {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), "vibes-build-mode-cron-"))
+  const file = path.join(dir, "register.ts")
+  fs.writeFileSync(
+    file,
+    [
+      `import { registerTriggers } from ${JSON.stringify(triggersModulePath)}`,
+      "await registerTriggers([",
+      '  { handler: "trg.tick", kind: "cron", key: "* * * * *", module: "/dev/null", exportName: "tick", mod: { tick: async () => {} } },',
+      '  { handler: "trg.onEvt", kind: "on", key: "some.topic", module: "/dev/null", exportName: "onEvt", mod: { onEvt: async () => {} } },',
+      "])",
+      'console.log("REGISTERED")',
+      "",
+    ].join("\n"),
+  )
+  return file
+}
+
+// Runs `script` in a fresh Bun subprocess with `env` merged over the current
+// process env. Resolves `{ exited: true }` if the process exits within
+// `timeoutMs` on its own, or `{ exited: false }` (after force-killing it) if
+// it's still alive at the deadline — the exact symptom of the original bug.
+async function runAndWaitForExit(
+  script: string,
+  env: Record<string, string>,
+  timeoutMs: number,
+): Promise<{ exited: boolean }> {
+  const proc = Bun.spawn(["bun", "run", script], {
+    env: { ...process.env, ...env },
+    stdout: "pipe",
+    stderr: "pipe",
+  })
+  let timedOut = false
+  const timer = setTimeout(() => {
+    timedOut = true
+    proc.kill()
+  }, timeoutMs)
+  await proc.exited
+  clearTimeout(timer)
+  return { exited: !timedOut }
+}
+
+describe("registerTriggers build-mode cron gating", () => {
+  test("VIBES_BUILD=1: a cron()+on() project terminates on its own", async () => {
+    const script = writeRegisterScript()
+    const { exited } = await runAndWaitForExit(script, { VIBES_BUILD: "1", VIBES_MODE: "dev" }, 8000)
+    expect(exited).toBe(true)
+  }, 15000)
+
+  test("sanity: without VIBES_BUILD, dev-mode cron is still armed (stays alive)", async () => {
+    // Mirrors the fixed case above to prove the guard is scoped to build
+    // mode only — normal `bun dev` cron scheduling must be unaffected.
+    const script = writeRegisterScript()
+    const { exited } = await runAndWaitForExit(script, { VIBES_MODE: "dev" }, 2000)
+    expect(exited).toBe(false)
+  }, 15000)
+})

package/src/triggers.ts

@@ -25,6 +25,7 @@
 import path from "node:path"
 import fs from "node:fs"
 import { ctxStore, type VibesCtx } from "./ctx.ts"
+import { agentBase } from "./agent-url.ts"
 
 // ── Public API ───────────────────────────────────────────────────────────────
 
@@ -242,12 +243,20 @@ export async function registerTriggers(entries: TriggerEntry[]): Promise<void> {
     }
   }
   void registeredFirstTime // suppress unused — kept for future HMR diff
-  const inProcessCron = vibesMode() === "dev" || cronDriver() === "in-process"
+  // vibes-build sets VIBES_BUILD=1 for its whole process, including the
+  // nested Vite dev server it spins up for prerender SSG. A build is not a
+  // runtime — nothing should ever arm a live setTimeout chain there, or the
+  // process hangs forever after writing its artifacts (confirmed hang: cron
+  // schedulers keep the event loop open with no caller left to clear them).
+  const inBuild = inBuildMode()
+  const inProcessCron = !inBuild && (vibesMode() === "dev" || cronDriver() === "in-process")
   if (inProcessCron) {
     scheduleAllCronInProcess()
   }
   console.log(
-    `[vibes:triggers] registered ${entries.length} trigger(s) — mode=${vibesMode()}, cron=${inProcessCron ? "in-process" : "orchestrator"}`,
+    `[vibes:triggers] registered ${entries.length} trigger(s) — mode=${vibesMode()}, cron=${
+      inBuild ? "unarmed (build)" : inProcessCron ? "in-process" : "orchestrator"
+    }`,
   )
 }
 
@@ -472,7 +481,7 @@ async function emitToOrchestrator(topic: string, payload: unknown): Promise<{ su
   if (payloadStr.length > MAX_EMIT_BYTES) {
     throw new Error(`emit("${topic}"): payload exceeds ${MAX_EMIT_BYTES} bytes`)
   }
-  const url = "http://localhost:8080/_emit"
+  const url = `${agentBase()}/_emit`
   const res = await fetch(url, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
@@ -629,7 +638,7 @@ async function scheduleToOrchestrator(
   if (payloadStr.length > MAX_EMIT_BYTES) {
     throw new Error(`schedule("${topic}"): payload exceeds ${MAX_EMIT_BYTES} bytes`)
   }
-  const url = "http://localhost:8080/_schedule"
+  const url = `${agentBase()}/_schedule`
   const res = await fetch(url, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
@@ -656,7 +665,7 @@ async function scheduleToOrchestrator(
 }
 
 async function cancelOnOrchestrator(eventId: string): Promise<{ cancelled: number }> {
-  const url = `http://localhost:8080/_schedule/${encodeURIComponent(eventId)}`
+  const url = `${agentBase()}/_schedule/${encodeURIComponent(eventId)}`
   const res = await fetch(url, { method: "DELETE" })
   if (!res.ok) {
     const text = await res.text().catch(() => "")
@@ -810,6 +819,15 @@ function vibesMode(): "dev" | "prod" {
   return _vibesMode
 }
 
+// Set for the whole lifetime of `vibes-build` (packages/vite-plugin/src/build.ts).
+// A build process has no caller left to clear timers once it "finishes" —
+// so cron must never be armed in-process while this is set, however
+// createVibesServer() got invoked (directly, or via prerender's nested dev
+// server).
+function inBuildMode(): boolean {
+  return (typeof process !== "undefined" ? process.env?.VIBES_BUILD : undefined) === "1"
+}
+
 // ── Dev Inspect data accessors ───────────────────────────────────────────────
 //
 // In dev mode, the dashboard's Inspect tabs read the in-memory rings

package/src/workflows.ts

@@ -38,6 +38,7 @@
 import path from "node:path"
 import fs from "node:fs"
 import { ctxStore, type VibesCtx } from "./ctx.ts"
+import { agentBase } from "./agent-url.ts"
 
 // ── Public API ───────────────────────────────────────────────────────────────
 
@@ -417,7 +418,7 @@ async function startViaAgent(
   payloadStr: string,
   opts: StartWorkflowOptions,
 ): Promise<{ runId: string }> {
-  const res = await fetch("http://localhost:8080/_workflow/start", {
+  const res = await fetch(`${agentBase()}/_workflow/start`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({