ugly-app 0.1.497 → 0.1.498

package/dist/cli/version.d.ts

@@ -1,2 +1,2 @@
-export declare const CLI_VERSION = "0.1.497";
+export declare const CLI_VERSION = "0.1.498";
 //# sourceMappingURL=version.d.ts.map

package/dist/cli/version.js

@@ -1,3 +1,3 @@
 // Auto-generated by prebuild — do not edit manually
-export const CLI_VERSION = "0.1.497";
+export const CLI_VERSION = "0.1.498";
 //# sourceMappingURL=version.js.map

package/dist/server/App.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/server/App.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/server/App.ts"],"names":[],"mappings":"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"}

package/dist/server/App.js

@@ -11,24 +11,34 @@ import { parseUrl } from "../shared/Router.js";
 import { getUglyBotUrl } from "../shared/uglyBotUrl.js";
 import { oneHour } from "../shared/index.js";
 // AI providers are now always routed through ugly.bot (proxy-only).
-import { initProviderBalance } from "./ai/ProviderBalance.js";
+//
+// Heavy server modules below are loaded LAZILY (via dynamic `import()`
+// at call sites) and gated on env vars so a host without DATABASE_URL /
+// NATS_URL / R2_BUCKET / any AI provider key doesn't pay the load cost.
+// Pre-2026-06 the eager top-level imports here meant any importer of
+// `ugly-app` paid ~600ms of cumulative module load (pg, nats.js,
+// @aws-sdk/client-s3, @anthropic-ai/sdk, openai, …) even when no DB
+// or AI provider was configured — that's the cost Ugly Studio's sidecar
+// boot was eating. Lazy + env-gate cuts that to near-zero for hosts
+// that don't use the relevant subsystem.
 import { initEventCounter, initEventCounterApi, startEventCounterFlush, } from "./EventCounter.js";
 import { createAuthRoutes, getRequestUser, uglyBotAuthProvider, verifyToken, } from "./Auth.js";
 import { createTypedDB } from "./DB.js";
-import { initPg, closePg, pgQuery } from "./Pg.js";
+// ./Pg.js loaded lazily inside start() — see below.
+// Logging.ts itself is loaded eagerly (captureServerError + init*** are
+// always-on), but as of 2026-06 it lazy-loads Pg.js internally so this
+// import no longer drags in the pg driver.
 import { initLoggingApi, initServerConsoleCapture, initServerErrorCapture, recordFeedback, } from "./Logging.js";
-import { checkJetStream, connectNats, ensureKvBucket, setNatsPrefix } from "./Nats.js";
+// ./Nats.js loaded lazily inside start() — see below.
 import { getDevNamespace, namespaceBucketName, namespaceDbUrl, namespaceNatsPrefix, } from "./DevNamespace.js";
 import { RateLimitError } from "./RateLimit.js";
 import { createRouter, RouterAuthError, RouterNotFoundError, } from "./Router.js";
 import { createStoreHandlers } from "./StoreHandlers.js";
 import { getCriticalStrings, resolveLanguage, stringsVersion, } from "./Strings.js";
 import { initWebSocketServer } from "./Socket.js";
-import { createStorageClient, setStoragePrefix } from "./Storage.js";
 import { frameworkRequests } from "../shared/FrameworkRequests.js";
-import { createTextGenClient } from "./AiText.js";
-import { createImageGenClient } from "./AiImage.js";
-import { createWebSearchClient } from "./ai/WebSearchClient.js";
+// AI clients (./AiText.js, ./AiImage.js, ./ai/WebSearchClient.js,
+// ./ai/ProviderBalance.js) loaded lazily at their call sites.
 import { eventLogCapture, eventLogServerCapture, initEventLog, initEventLogApi, } from "./EventLogAdmin.js";
 import { getExperimentAssignments, } from "../shared/Experiment.js";
 export { getRequestUser, verifyToken };
@@ -57,10 +67,22 @@ export function createApp(registry, requests, appDefs, configure, deleteHandlers
     // Create the typed DB client merging builtins + app collections
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const typedDb = createTypedDB(allDefs, deleteHandlers);
-    if (process.env["STORAGE_KEY_PREFIX"]) {
-        setStoragePrefix(process.env["STORAGE_KEY_PREFIX"]);
-    }
-    const storage = createStorageClient();
+    // Storage (R2 / S3) is loaded LAZILY. Hosts without an R2 / S3 bucket
+    // (e.g. Ugly Studio's sidecar, which talks to ugly.bot's storage via
+    // HTTP) skip ~150ms of `@aws-sdk/client-s3` module loading. The lazy
+    // accessor below is memoized — the actual client is created on first
+    // use, and STORAGE_KEY_PREFIX is applied at that point.
+    let _lazyStorage = null;
+    const getStorage = async () => {
+        if (_lazyStorage)
+            return _lazyStorage;
+        const mod = await import("./Storage.js");
+        if (process.env["STORAGE_KEY_PREFIX"]) {
+            mod.setStoragePrefix(process.env["STORAGE_KEY_PREFIX"]);
+        }
+        _lazyStorage = mod.createStorageClient();
+        return _lazyStorage;
+    };
     const expressApp = express();
     // Skip JSON body parsing for S3 upload proxy routes (they use express.raw() inline)
     expressApp.use((req, res, next) => {
@@ -291,22 +313,26 @@ export function createApp(registry, requests, appDefs, configure, deleteHandlers
             return { eventId };
         },
         textGen: async (userId, { model, messages }) => {
+            const { createTextGenClient } = await import("./AiText.js");
             const text = await createTextGenClient(userId).generate(messages, { model: model });
             return { text };
         },
         imageGen: async (userId, { model, prompt }) => {
+            const { createImageGenClient } = await import("./AiImage.js");
             const url = await createImageGenClient(userId).generate(prompt, {
                 model: model,
             });
             return { url };
         },
         kagiSearch: async (userId, { query, limit }) => {
+            const { createWebSearchClient } = await import("./ai/WebSearchClient.js");
             return createWebSearchClient(userId).search({
                 query,
                 ...(limit !== undefined && { limit }),
             });
         },
         kagiSummarize: async (userId, { url, text }) => {
+            const { createWebSearchClient } = await import("./ai/WebSearchClient.js");
             const summary = await createWebSearchClient(userId).summarize({
                 ...(url !== undefined && { url }),
                 ...(text !== undefined && { text }),
@@ -314,12 +340,15 @@ export function createApp(registry, requests, appDefs, configure, deleteHandlers
             return { summary };
         },
         kagiEnrichWeb: async (userId, { query }) => {
+            const { createWebSearchClient } = await import("./ai/WebSearchClient.js");
             return createWebSearchClient(userId).enrichWeb({ query });
         },
         kagiEnrichNews: async (userId, { query }) => {
+            const { createWebSearchClient } = await import("./ai/WebSearchClient.js");
             return createWebSearchClient(userId).enrichNews({ query });
         },
         uploadUrl: async (_userId, { key }) => {
+            const storage = await getStorage();
             return storage.presignedPut("temp", key);
         },
         adminGetPerfLogs: (userId, _input) => {
@@ -677,7 +706,10 @@ export function createApp(registry, requests, appDefs, configure, deleteHandlers
     expressApp.use((req, res, next) => {
         createAuthRoutes(typedDb, resolvedUserHelper, resolvedOnUserCreate, authProvider)(req, res, next);
     });
-    const wss = initWebSocketServer(httpServer, router, allCollections, storage, typedDb, resolvedUserHelper, wsPath, onSocketMessageHandlers.length > 0 ? onSocketMessageHandlers : undefined, undefined, onWsAuth ?? undefined);
+    const wss = initWebSocketServer(httpServer, router, allCollections, 
+    // Socket.ts ignores this arg (underscore-prefixed `_storage`); pass
+    // null so we don't trigger the lazy createStorageClient at boot.
+    null, typedDb, resolvedUserHelper, wsPath, onSocketMessageHandlers.length > 0 ? onSocketMessageHandlers : undefined, undefined, onWsAuth ?? undefined);
     function registerRoutes(fn) {
         const customRouter = express.Router();
         fn(customRouter);
@@ -686,7 +718,26 @@ export function createApp(registry, requests, appDefs, configure, deleteHandlers
     // Capture pageOptions in a local const so TypeScript doesn't narrow it to never inside closures
     const resolvedPageOptions = pageOptions;
     async function start(port = 3000) {
-        initProviderBalance(typedDb);
+        // ProviderBalance tracks per-provider AI spend. Only meaningful when
+        // at least one provider key is configured — hosts that route all AI
+        // through ugly.bot (Ugly Studio) skip the load (~20ms + the
+        // ProviderBalance module's dep tree).
+        const anyAi = process.env["OPENAI_API_KEY"] ||
+            process.env["ANTHROPIC_API_KEY"] ||
+            process.env["GOOGLE_API_KEY"] ||
+            process.env["GROQ_API_KEY"] ||
+            process.env["TOGETHER_API_KEY"] ||
+            process.env["FIREWORKS_API_KEY"] ||
+            process.env["FAL_API_KEY"] ||
+            process.env["OPENROUTER_KEY"] ||
+            process.env["DEEPINFRA_API_KEY"] ||
+            process.env["DEEPSEEK_API_KEY"] ||
+            process.env["MINIMAX_TOKEN"] ||
+            process.env["KAGI_API_TOKEN"];
+        if (anyAi) {
+            const { initProviderBalance } = await import("./ai/ProviderBalance.js");
+            initProviderBalance(typedDb);
+        }
         initServerConsoleCapture(typedDb);
         initEventLog(typedDb);
         // Forward error logs and feedback to ugly.bot API
@@ -739,6 +790,7 @@ export function createApp(registry, requests, appDefs, configure, deleteHandlers
             if (dbUrl) {
                 process.env["DATABASE_URL"] = namespaceDbUrl(dbUrl);
             }
+            const { setNatsPrefix } = await import("./Nats.js");
             setNatsPrefix(namespaceNatsPrefix());
             const baseBucket = process.env["R2_BUCKET"];
             if (baseBucket && !baseBucket.endsWith(`-${ns}`)) {
@@ -746,57 +798,67 @@ export function createApp(registry, requests, appDefs, configure, deleteHandlers
             }
             console.log(`[app] UGLY_APP_DEV_MODE — namespace="${ns}" db="${process.env["DATABASE_URL"]?.split("/").pop()}" bucket="${process.env["R2_BUCKET"]}"`);
         }
-        // Open Postgres pool (direct DATABASE_URL). In direct mode this just
-        // primes the singleton pool so config errors surface here instead of
-        // on the first query. Storage (R2) is lazy-initialised on first use.
-        await initPg();
-        console.log("[app] Postgres pool ready");
-        // Schema drift check + auto-migration for new collections / safe changes
-        try {
-            const { ensureSchemaSnapshotsTable, checkSchemas, formatSchemaCheckResult, } = await import("./SchemaCheck.js");
-            await ensureSchemaSnapshotsTable();
-            const schemaResult = await checkSchemas(allDefs);
-            if (schemaResult.status === "drift") {
-                if (process.env["SCHEMA_CHECK_SKIP"] === "true") {
-                    console.warn("[app] WARNING: Schema drift detected but SCHEMA_CHECK_SKIP=true — proceeding anyway!");
-                    console.warn("[app] This is unsafe. Fix the schema drift as soon as possible.");
-                    console.warn(formatSchemaCheckResult(schemaResult));
+        // Postgres init + schema check. Skipped entirely when neither
+        // DATABASE_URL nor POSTGRES_URL is set — hosts like Ugly Studio's
+        // sidecar route persistence through ugly.bot and don't need a local
+        // pg pool. Pre-2026-06 this block ran unconditionally and logged a
+        // "Schema check failed" warning on every Studio boot.
+        if (process.env["DATABASE_URL"] || process.env["POSTGRES_URL"]) {
+            const { initPg } = await import("./Pg.js");
+            await initPg();
+            console.log("[app] Postgres pool ready");
+            // Schema drift check + auto-migration for new collections / safe changes
+            try {
+                const { ensureSchemaSnapshotsTable, checkSchemas, formatSchemaCheckResult, } = await import("./SchemaCheck.js");
+                await ensureSchemaSnapshotsTable();
+                const schemaResult = await checkSchemas(allDefs);
+                if (schemaResult.status === "drift") {
+                    if (process.env["SCHEMA_CHECK_SKIP"] === "true") {
+                        console.warn("[app] WARNING: Schema drift detected but SCHEMA_CHECK_SKIP=true — proceeding anyway!");
+                        console.warn("[app] This is unsafe. Fix the schema drift as soon as possible.");
+                        console.warn(formatSchemaCheckResult(schemaResult));
+                    }
+                    else {
+                        console.error("[app] Schema drift detected — cannot start.");
+                        console.error(formatSchemaCheckResult(schemaResult));
+                        console.error('\nRun "npm run db:schema-gen" to generate migrations, then "npm run db:migrate" to apply them.');
+                        process.exit(1);
+                    }
+                }
+                else if (schemaResult.status === "baseline") {
+                    // Auto-generate and apply migrations for new collections
+                    const { autoMigrateNewCollections } = await import("./SchemaCheck.js");
+                    await autoMigrateNewCollections(schemaResult, allDefs);
                 }
                 else {
-                    console.error("[app] Schema drift detected — cannot start.");
-                    console.error(formatSchemaCheckResult(schemaResult));
-                    console.error('\nRun "npm run db:schema-gen" to generate migrations, then "npm run db:migrate" to apply them.');
-                    process.exit(1);
+                    console.log("[app] Schema check passed");
                 }
             }
-            else if (schemaResult.status === "baseline") {
-                // Auto-generate and apply migrations for new collections
-                const { autoMigrateNewCollections } = await import("./SchemaCheck.js");
-                await autoMigrateNewCollections(schemaResult, allDefs);
-            }
-            else {
-                console.log("[app] Schema check passed");
+            catch (err) {
+                console.warn("[app] Schema check failed (continuing):", err.message);
             }
         }
-        catch (err) {
-            console.warn("[app] Schema check failed (continuing):", err.message);
-        }
-        try {
-            await connectNats();
-            if (process.env["NATS_PREFIX"] || process.env["COMPOSE_PROJECT_NAME"]) {
-                setNatsPrefix(process.env["NATS_PREFIX"] ??
-                    process.env["COMPOSE_PROJECT_NAME"] ??
-                    "");
+        // NATS init + KV buckets. Skipped entirely when NATS_URL is unset —
+        // same rationale as the Pg block above.
+        if (process.env["NATS_URL"]) {
+            try {
+                const { checkJetStream, connectNats, ensureKvBucket, setNatsPrefix, } = await import("./Nats.js");
+                await connectNats();
+                if (process.env["NATS_PREFIX"] || process.env["COMPOSE_PROJECT_NAME"]) {
+                    setNatsPrefix(process.env["NATS_PREFIX"] ??
+                        process.env["COMPOSE_PROJECT_NAME"] ??
+                        "");
+                }
+                // Verify JetStream is healthy before creating KV buckets — a fast
+                // probe that surfaces permission/config issues instead of hanging.
+                await checkJetStream();
+                await ensureKvBucket("TTS", { max_bytes: 256 * 1024 * 1024 });
+                await ensureKvBucket("RATELIMIT", {});
+                console.log("[app] NATS KV buckets ready");
+            }
+            catch (err) {
+                console.warn(`[app] NATS connection failed (real-time updates, TTS cache, and rate-limiting disabled): ${err.message}`);
             }
-            // Verify JetStream is healthy before creating KV buckets — a fast probe
-            // that surfaces permission/config issues instead of hanging silently.
-            await checkJetStream();
-            await ensureKvBucket("TTS", { max_bytes: 256 * 1024 * 1024 });
-            await ensureKvBucket("RATELIMIT", {});
-            console.log("[app] NATS KV buckets ready");
-        }
-        catch (err) {
-            console.warn(`[app] NATS connection failed (real-time updates, TTS cache, and rate-limiting disabled): ${err.message}`);
         }
         // Set up page serving (must happen before httpServer.listen)
         console.log("[app] Page options:", resolvedPageOptions != null
@@ -1081,22 +1143,29 @@ export function createApp(registry, requests, appDefs, configure, deleteHandlers
         // Framework-managed background services
         initEventCounter(typedDb);
         startEventCounterFlush();
-        // TTL cleanup: delete expired rows from log tables every 15 minutes
-        const ttlCollections = [
-            { table: "consoleLog", field: "created", seconds: 7 * 86400 },
-            { table: "perfLog", field: "created", seconds: 7 * 86400 },
-            { table: "feedbackLog", field: "created", seconds: 7 * 86400 },
-            { table: "errorLog", field: "created", seconds: 7 * 86400 },
-            { table: "aiSpend", field: "created", seconds: 2 * 3600 },
-        ];
-        setInterval(() => {
-            for (const { table, field, seconds } of ttlCollections) {
-                const cutoff = new Date(Date.now() - seconds * 1000).toISOString();
-                pgQuery(`DELETE FROM "${table}" WHERE data->>'${field}' < $1`, [
-                    cutoff,
-                ]).catch(() => { });
-            }
-        }, 15 * 60_000);
+        // TTL cleanup: delete expired rows from log tables every 15 minutes.
+        // Skipped when Pg isn't configured (no DATABASE_URL) — the loop has
+        // nothing to query and the lazy pg import would error every tick.
+        if (process.env["DATABASE_URL"] || process.env["POSTGRES_URL"]) {
+            const ttlCollections = [
+                { table: "consoleLog", field: "created", seconds: 7 * 86400 },
+                { table: "perfLog", field: "created", seconds: 7 * 86400 },
+                { table: "feedbackLog", field: "created", seconds: 7 * 86400 },
+                { table: "errorLog", field: "created", seconds: 7 * 86400 },
+                { table: "aiSpend", field: "created", seconds: 2 * 3600 },
+            ];
+            setInterval(() => {
+                void (async () => {
+                    const { pgQuery } = await import("./Pg.js");
+                    for (const { table, field, seconds } of ttlCollections) {
+                        const cutoff = new Date(Date.now() - seconds * 1000).toISOString();
+                        pgQuery(`DELETE FROM "${table}" WHERE data->>'${field}' < $1`, [
+                            cutoff,
+                        ]).catch(() => { });
+                    }
+                })();
+            }, 15 * 60_000);
+        }
         const clockEnabled = process.env["CLOCK_ENABLED"] === "true";
         if (clockEnabled) {
             if (onMinuteTick) {
@@ -1130,7 +1199,11 @@ export function createApp(registry, requests, appDefs, configure, deleteHandlers
             await new Promise((resolve) => httpServer.close(() => resolve()));
             if (workerQueue)
                 await workerQueue.stop();
-            closePg();
+            // Only close pg if we actually opened it (DATABASE_URL was set).
+            if (process.env["DATABASE_URL"] || process.env["POSTGRES_URL"]) {
+                const { closePg } = await import("./Pg.js");
+                closePg();
+            }
             console.log("[App] Shutdown complete");
             process.exit(0);
         };