veryfront 0.1.1168 → 0.1.1169

package/esm/cli/commands/serve/command.d.ts

@@ -1,3 +1,27 @@
+type StartupErrorReporter = {
+    captureApplicationError: (error: unknown, context: {
+        boundary: string;
+    }) => string | undefined;
+    flushApplicationErrors: (timeoutMs?: number) => Promise<boolean>;
+    onReportingError?: (operation: "capture" | "flush", error: unknown) => void;
+};
+type StartupErrorReportingOptions = {
+    flushTimeoutMs?: number;
+};
+type ProductionServerDependencies = {
+    ensureBundlerContracts?: () => Promise<void>;
+    initializeErrorReporting?: () => Promise<unknown>;
+    loadSentryModule?: () => Promise<ProductionSentryModule>;
+    reporter?: StartupErrorReporter;
+};
+type ServeCommandDependencies = {
+    runProductionServer?: (options: ServeOptions) => Promise<void>;
+};
+type ProductionSentryModule = {
+    captureApplicationError: StartupErrorReporter["captureApplicationError"];
+    flushApplicationErrors: StartupErrorReporter["flushApplicationErrors"];
+    initializeSentryFromEnv: () => Promise<unknown>;
+};
 export interface ServeOptions {
     mode: "combined" | "proxy" | "production";
     port: number;
@@ -7,5 +31,9 @@ export interface ServeOptions {
     binaryPath: string;
     debug: boolean;
 }
-export declare function serveCommand(options: ServeOptions): Promise<void>;
+export declare function runWithStartupErrorReporting<T>(startup: () => Promise<T>, reporter: StartupErrorReporter, options?: StartupErrorReportingOptions): Promise<T>;
+export declare function runProductionStartupWithErrorReporting<T>(startup: () => Promise<T>, reporter: StartupErrorReporter, ensureBundlerContracts?: () => Promise<void>, initializeObservability?: () => Promise<unknown>): Promise<T>;
+export declare function runProductionServer(options: ServeOptions, dependencies?: ProductionServerDependencies): Promise<void>;
+export declare function serveCommand(options: ServeOptions, dependencies?: ServeCommandDependencies): Promise<void>;
+export {};
 //# sourceMappingURL=command.d.ts.map

package/esm/cli/commands/serve/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/serve/command.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAwGD,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAcvE"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/serve/command.ts"],"names":[],"mappings":"AAUA,KAAK,oBAAoB,GAAG;IAC1B,uBAAuB,EAAE,CACvB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAC1B,MAAM,GAAG,SAAS,CAAC;IACxB,sBAAsB,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,gBAAgB,CAAC,EAAE,CACjB,SAAS,EAAE,SAAS,GAAG,OAAO,EAC9B,KAAK,EAAE,OAAO,KACX,IAAI,CAAC;CACX,CAAC;AAEF,KAAK,4BAA4B,GAAG;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,4BAA4B,GAAG;IAClC,sBAAsB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzD,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CACjC,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,uBAAuB,EAAE,oBAAoB,CAAC,yBAAyB,CAAC,CAAC;IACzE,sBAAsB,EAAE,oBAAoB,CAAC,wBAAwB,CAAC,CAAC;IACvE,uBAAuB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,4BAA4B,CAAC,CAAC,EAClD,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,CAAC,CAAC,CAqBZ;AAoCD,wBAAsB,sCAAsC,CAAC,CAAC,EAC5D,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,QAAQ,EAAE,oBAAoB,EAC9B,sBAAsB,GAAE,MAAM,OAAO,CAAC,IAAI,CAA6B,EACvE,uBAAuB,GAAE,MAAM,OAAO,CAAC,OAAO,CAA2B,GACxE,OAAO,CAAC,CAAC,CAAC,CAMZ;AAoED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,YAAY,EACrB,YAAY,GAAE,4BAAiC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAgFf;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,EACrB,YAAY,GAAE,wBAA6B,GAC1C,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/esm/cli/commands/serve/command.js

@@ -4,6 +4,64 @@ import { cliLogger } from "../../utils/index.js";
 import { exitProcess, registerTerminationSignals, showLogo } from "../../utils/index.js";
 import { generateDefaultProjectId } from "../../utils/project.js";
 import { startCliProductionServer } from "../../shared/server-startup.js";
+import { ensureCliBundlerContracts } from "../../shared/default-contracts.js";
+const STARTUP_ERROR_FLUSH_TIMEOUT_MS = 2_000;
+export async function runWithStartupErrorReporting(startup, reporter, options = {}) {
+    const flushTimeoutMs = options.flushTimeoutMs ?? STARTUP_ERROR_FLUSH_TIMEOUT_MS;
+    try {
+        return await startup();
+    }
+    catch (error) {
+        const reportingDeadline = Date.now() + flushTimeoutMs;
+        try {
+            reporter.captureApplicationError(error, { boundary: "process.startup" });
+        }
+        catch (reportingError) {
+            notifyReportingError(reporter, "capture", reportingError);
+        }
+        try {
+            await flushReporterWithDeadline(reporter, Math.max(0, reportingDeadline - Date.now()));
+        }
+        catch (reportingError) {
+            notifyReportingError(reporter, "flush", reportingError);
+        }
+        throw error;
+    }
+}
+function notifyReportingError(reporter, operation, error) {
+    try {
+        reporter.onReportingError?.(operation, error);
+    }
+    catch {
+        // Diagnostics must never replace the startup failure being reported.
+    }
+}
+async function flushReporterWithDeadline(reporter, timeoutMs) {
+    let timeoutId;
+    const flush = Promise.resolve()
+        .then(() => reporter.flushApplicationErrors(timeoutMs))
+        .catch((error) => {
+        notifyReportingError(reporter, "flush", error);
+        return false;
+    });
+    const deadline = new Promise((resolve) => {
+        timeoutId = setTimeout(() => resolve(false), timeoutMs);
+    });
+    try {
+        return await Promise.race([flush, deadline]);
+    }
+    finally {
+        if (timeoutId !== undefined)
+            clearTimeout(timeoutId);
+    }
+}
+export async function runProductionStartupWithErrorReporting(startup, reporter, ensureBundlerContracts = ensureCliBundlerContracts, initializeObservability = () => Promise.resolve()) {
+    return await runWithStartupErrorReporting(async () => {
+        await initializeObservability();
+        await ensureBundlerContracts();
+        return await startup();
+    }, reporter);
+}
 async function runSplit(options) {
     showLogo();
     const { runSplitMode } = await import("./split-mode.js");
@@ -28,32 +86,63 @@ async function runProxy(options) {
     // Keep the process alive (Deno.serve returns immediately in compiled binaries)
     await new Promise(() => { });
 }
-async function runProductionServer(options) {
+function createDeferredProductionStartupErrorReporter() {
+    let sentryModule;
+    return {
+        reporter: {
+            // If Sentry module acquisition fails, no remote transport exists yet.
+            // Preserve the acquisition failure and bound flush instead of adding a
+            // fallback reporter inside the startup path.
+            captureApplicationError: (error, context) => sentryModule?.captureApplicationError(error, context),
+            flushApplicationErrors: (timeoutMs) => sentryModule?.flushApplicationErrors(timeoutMs) ?? Promise.resolve(true),
+            onReportingError: (operation, error) => {
+                cliLogger.warn(`Error reporter failed to ${operation} production startup failure.`);
+                cliLogger.debug(`Error reporter ${operation} failure details:`, error);
+            },
+        },
+        setSentryModule: (loadedSentryModule) => {
+            sentryModule = loadedSentryModule;
+        },
+    };
+}
+function loadProductionSentryModule() {
+    return import("../../../src/observability/sentry.js");
+}
+export async function runProductionServer(options, dependencies = {}) {
     showLogo();
-    const { captureApplicationError, flushApplicationErrors, initializeSentryFromEnv, } = await import("../../../src/observability/sentry.js");
-    await initializeSentryFromEnv();
-    const { clearAllLocalCaches } = await import("../../../src/transforms/mdx/esm-module-loader/cache/index.js");
-    await clearAllLocalCaches();
-    const { initializeOTLPWithApis } = await import("../../../src/observability/tracing/otlp-setup.js");
-    const { initializeDistributedCaches } = await import("../../../src/cache/index.js");
-    const { defaultDistributedCacheInitializers } = await import("../../../src/server/index.js");
-    await Promise.allSettled([
-        initializeOTLPWithApis(),
-        initializeDistributedCaches(defaultDistributedCacheInitializers),
-    ]);
-    const projectDir = cwd();
-    const shutdownController = new AbortController();
-    const defaultProjectId = generateDefaultProjectId(projectDir);
-    const server = await startCliProductionServer({
-        projectDir,
-        port: options.port,
-        bindAddress: options.bindAddress,
-        debug: options.debug,
-        signal: shutdownController.signal,
-        defaultProjectSlug: defaultProjectId,
-        defaultProjectId,
-    });
-    await server.ready;
+    const deferredReporter = createDeferredProductionStartupErrorReporter();
+    const reporter = dependencies.reporter ?? deferredReporter.reporter;
+    const initializeErrorReporting = dependencies.initializeErrorReporting ??
+        (async () => {
+            const sentryModule = await (dependencies.loadSentryModule ?? loadProductionSentryModule)();
+            deferredReporter.setSentryModule(sentryModule);
+            await sentryModule.initializeSentryFromEnv();
+        });
+    const { server, shutdownController } = await runProductionStartupWithErrorReporting(async () => {
+        const { clearAllLocalCaches } = await import("../../../src/transforms/mdx/esm-module-loader/cache/index.js");
+        await clearAllLocalCaches();
+        const { initializeOTLPWithApis } = await import("../../../src/observability/tracing/otlp-setup.js");
+        const { initializeDistributedCaches } = await import("../../../src/cache/index.js");
+        const { defaultDistributedCacheInitializers } = await import("../../../src/server/index.js");
+        await Promise.allSettled([
+            initializeOTLPWithApis(),
+            initializeDistributedCaches(defaultDistributedCacheInitializers),
+        ]);
+        const projectDir = cwd();
+        const shutdownController = new AbortController();
+        const defaultProjectId = generateDefaultProjectId(projectDir);
+        const server = await startCliProductionServer({
+            projectDir,
+            port: options.port,
+            bindAddress: options.bindAddress,
+            debug: options.debug,
+            signal: shutdownController.signal,
+            defaultProjectSlug: defaultProjectId,
+            defaultProjectId,
+        });
+        await server.ready;
+        return { server, shutdownController };
+    }, reporter, dependencies.ensureBundlerContracts ?? ensureCliBundlerContracts, initializeErrorReporting);
     let shuttingDown = false;
     const shutdown = async (signal) => {
         if (shuttingDown)
@@ -68,18 +157,18 @@ async function runProductionServer(options) {
             });
         }
         catch (error) {
-            captureApplicationError(error, { boundary: "process.shutdown" });
+            reporter.captureApplicationError(error, { boundary: "process.shutdown" });
             cliLogger.warn("Error while shutting down production server:", error);
         }
         finally {
-            await flushApplicationErrors();
+            await reporter.flushApplicationErrors();
             exitProcess(0);
         }
     };
     registerTerminationSignals(shutdown);
     await new Promise(() => { });
 }
-export async function serveCommand(options) {
+export async function serveCommand(options, dependencies = {}) {
     if (options.splitMode) {
         await runSplit(options);
         return;
@@ -89,6 +178,6 @@ export async function serveCommand(options) {
         return;
     }
     if (options.mode === "production" || options.mode === "combined") {
-        await runProductionServer(options);
+        await (dependencies.runProductionServer ?? runProductionServer)(options);
     }
 }

package/esm/cli/commands/serve/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/serve/handler.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAyBxD,QAAA,MAAM,kBAAkB;;;;;;;;GAQtB,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,OAAO,kBAgBnC,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAaxE"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/serve/handler.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAgCxD,QAAA,MAAM,kBAAkB;;;;;;;;GAQtB,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,OAAO,kBAgBnC,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAexE"}

package/esm/cli/commands/serve/handler.js

@@ -1,12 +1,19 @@
 import { defineSchema, lazySchema } from "../../../src/schemas/index.js";
-import { getEnv, getEnvNumber } from "../../../src/platform/compat/process.js";
+import { getEnv } from "../../../src/platform/index.js";
 import { DEFAULT_DEV_SERVER_PORT } from "../../utils/index.js";
 import { ServerModeSchema } from "../../shared/types.js";
 import { createArgParser, parseArgsOrThrow } from "../../shared/args.js";
 import { ensureCliBundlerContracts } from "../../shared/default-contracts.js";
+function readPortEnv(name, fallback) {
+    const value = getEnv(name);
+    if (value === undefined)
+        return fallback;
+    const port = Number.parseInt(value, 10);
+    return Number.isNaN(port) ? fallback : port;
+}
 function getDefaultServePort() {
-    const veryfrontPort = getEnvNumber("VERYFRONT_PORT", DEFAULT_DEV_SERVER_PORT);
-    return getEnvNumber("PORT", veryfrontPort);
+    const veryfrontPort = readPortEnv("VERYFRONT_PORT", DEFAULT_DEV_SERVER_PORT);
+    return readPortEnv("PORT", veryfrontPort);
 }
 function getDefaultBindAddress() {
     return getEnv("BIND_ADDRESS")?.trim() || "0.0.0.0";
@@ -49,7 +56,9 @@ export const parseServeArgs = (args) => {
 };
 export async function handleServeCommand(args) {
     const opts = parseArgsOrThrow(parseServeArgs, "serve", args);
-    await ensureCliBundlerContracts();
+    if (opts.split || opts.mode === "proxy") {
+        await ensureCliBundlerContracts();
+    }
     const { serveCommand } = await import("./command.js");
     await serveCommand({
         mode: opts.mode,

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.1168",
+    "version": "0.1.1169",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "minimumDependencyAge": {

package/esm/src/utils/version-constant.d.ts

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.1168";
+export declare const VERSION = "0.1.1169";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.1168";
+export const VERSION = "0.1.1169";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.1168",
+  "version": "0.1.1169",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -336,10 +336,10 @@
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
     "ws": "8.21.0",
-    "@veryfront/ext-bundler-esbuild": "0.1.1168",
-    "@veryfront/ext-content-mdx": "0.1.1168",
-    "@veryfront/ext-css-tailwind": "0.1.1168",
-    "@veryfront/ext-parser-babel": "0.1.1168"
+    "@veryfront/ext-bundler-esbuild": "0.1.1169",
+    "@veryfront/ext-content-mdx": "0.1.1169",
+    "@veryfront/ext-css-tailwind": "0.1.1169",
+    "@veryfront/ext-parser-babel": "0.1.1169"
   },
   "devDependencies": {
     "@types/node": "20.9.0"