@spfn/core 0.2.0-beta.59 → 0.2.0-beta.64

package/dist/server/index.js

@@ -1652,6 +1652,9 @@ async function stopBoss() {
 function shouldClearOnStart() {
   return getBossConfig()?.clearOnStart ?? false;
 }
+function shouldSweepOrphanSchedules() {
+  return getBossConfig()?.sweepOrphanSchedules ?? false;
+}
 
 // src/job/job-router.ts
 function isJobDef(value) {
@@ -1708,8 +1711,45 @@ async function registerJobs(router) {
     jobLogger2.info("Existing jobs cleared");
   }
   await Promise.all(jobs.map((job2) => registerJob(job2)));
+  for (const job2 of jobs) {
+    if (job2.cronExpression) {
+      registeredCronNames.add(job2.name);
+    }
+  }
+  if (shouldSweepOrphanSchedules()) {
+    await sweepOrphanSchedules(boss);
+  }
   jobLogger2.info("All jobs registered successfully");
 }
+var registeredCronNames = /* @__PURE__ */ new Set();
+async function sweepOrphanSchedules(boss) {
+  if (registeredCronNames.size === 0) {
+    jobLogger2.debug("No cron jobs declared; skipping orphan schedule sweep");
+    return;
+  }
+  try {
+    const schedules = await boss.getSchedules();
+    const orphans = schedules.filter((schedule) => !registeredCronNames.has(schedule.name));
+    if (orphans.length === 0) {
+      jobLogger2.debug("No orphan schedules found");
+      return;
+    }
+    await Promise.all(orphans.map(async (orphan) => {
+      try {
+        await boss.unschedule(orphan.name, orphan.key);
+        jobLogger2.info(`Removed orphan schedule: ${orphan.name}`);
+      } catch (error) {
+        jobLogger2.error(`Failed to remove orphan schedule: ${orphan.name}`, {
+          error: error instanceof Error ? error.message : String(error)
+        });
+      }
+    }));
+  } catch (error) {
+    jobLogger2.error("Orphan schedule sweep failed", {
+      error: error instanceof Error ? error.message : String(error)
+    });
+  }
+}
 async function ensureQueue(boss, queueName) {
   await boss.createQueue(queueName);
 }
@@ -2055,25 +2095,25 @@ async function onClientMessage(data, router, connection, subject) {
     wsLogger.error(`WebSocket message handler error: ${type}`, err);
   }
 }
+function resolveWSServerCtor(mod) {
+  return mod.WebSocketServer ?? mod.Server ?? mod.default?.WebSocketServer ?? mod.default?.Server;
+}
 async function loadWSServer() {
+  let mod;
   try {
-    const mod = await import('ws');
-    const WS = mod.default ?? mod;
-    const WSS = WS.WebSocketServer ?? WS.Server;
-    if (typeof WSS !== "function") {
-      throw new Error(
-        "WebSocketServer not found in ws module. Ensure ws@^8 is installed: pnpm add ws"
-      );
-    }
-    return WSS;
-  } catch (err) {
-    if (err instanceof Error && err.message.includes("WebSocketServer not found")) {
-      throw err;
-    }
+    mod = await import('ws');
+  } catch {
     throw new Error(
       '@spfn/core WebSocket support requires the "ws" package.\nInstall it with: pnpm add ws'
     );
   }
+  const WSS = resolveWSServerCtor(mod);
+  if (typeof WSS !== "function") {
+    throw new Error(
+      "WebSocketServer not found in ws module. Ensure ws@^8 is installed: pnpm add ws"
+    );
+  }
+  return WSS;
 }
 function getNetworkAddress() {
   const nets = networkInterfaces();
@@ -2592,6 +2632,68 @@ async function cleanupOnFailure(config) {
     serverLogger.error("Cleanup failed", cleanupError);
   }
 }
+function getInfrastructure(config) {
+  return {
+    database: config?.infrastructure?.database !== false,
+    redis: config?.infrastructure?.redis !== false
+  };
+}
+function withServerlessDefaults(config) {
+  if (!config) {
+    return config;
+  }
+  return {
+    ...config,
+    database: {
+      ...config.database,
+      healthCheck: { enabled: false, ...config.database?.healthCheck }
+    }
+  };
+}
+function warnIfJobsConfigured(config) {
+  if (config?.jobs) {
+    serverLogger.warn(
+      "Jobs are configured but this is a serverless target: the in-process pg-boss worker is NOT started here, so enqueued jobs will not be processed on this deployment. Drain the queue from a scheduled endpoint (e.g. Vercel Cron \u2192 a route that processes a batch) or run jobs on an always-on target."
+    );
+  }
+}
+async function initInfrastructure(config) {
+  const infra = getInfrastructure(config);
+  if (infra.database) {
+    await initDatabase(config?.database);
+  }
+  if (infra.redis) {
+    await initCache();
+  }
+}
+var appPromise;
+function createServerlessApp(config) {
+  if (!appPromise) {
+    appPromise = buildServerlessApp(config);
+  }
+  return appPromise;
+}
+async function buildServerlessApp(rawConfig) {
+  loadEnv();
+  const config = withServerlessDefaults(rawConfig);
+  warnIfJobsConfigured(config);
+  await initInfrastructure(config);
+  return createServer(config);
+}
+function resetServerlessApp() {
+  appPromise = void 0;
+}
+async function provisionInfrastructure(config) {
+  loadEnv();
+  if (config?.lifecycle?.beforeInfrastructure) {
+    await config.lifecycle.beforeInfrastructure(config);
+  }
+  await initInfrastructure(config);
+  if (config?.lifecycle?.afterInfrastructure) {
+    await config.lifecycle.afterInfrastructure();
+  }
+  serverLogger.info("Provisioning complete");
+}
 
 // src/server/config-builder.ts
 function collectHooks(lifecycles, key) {
@@ -2941,6 +3043,6 @@ function defineServerConfig() {
   return new ServerConfigBuilder();
 }
 
-export { createServer, defineServerConfig, getShutdownManager, loadEnv, loadEnvFiles, startServer };
+export { createServer, createServerlessApp, defineServerConfig, getShutdownManager, loadEnv, loadEnvFiles, provisionInfrastructure, resetServerlessApp, startServer };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map