cynx-lib 1.3.93 → 1.3.94

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cynx-lib",
-  "version": "1.3.93",
+  "version": "1.3.94",
   "type": "module",
   "main": "./index.cjs",
   "module": "./index.js",
@@ -41,7 +41,11 @@
       "import": "./utils/utils/session.js",
       "require": "./utils/utils/session.cjs"
     },
-    "./gen": "./gen.js"
+    "./gen": "./gen.js",
+    "./server": {
+      "import": "./utils/utils/server.js",
+      "require": "./utils/utils/server.cjs"
+    }
   },
   "peerDependencies": {
     "lucide-react": ">=0.300",

package/utils/index.cjs

@@ -32,6 +32,7 @@ __export(index_exports, {
   durationUtil: () => import_duration.default,
   oidcUtil: () => import_oidc.default,
   realtimeUtil: () => import_realtime.default,
+  serverUtil: () => import_server.default,
   sessionManagerUtil: () => import_session_manager.default,
   sessionUtil: () => import_session.default,
   storageUtil: () => import_storage.default,
@@ -60,12 +61,15 @@ var import_session = __toESM(require("./utils/session.cjs"), 1);
 var import_session_manager = __toESM(require("./utils/session_manager.cjs"), 1);
 var import_ui = __toESM(require("./utils/ui.cjs"), 1);
 var import_db = __toESM(require("./utils/db.cjs"), 1);
+__reExport(index_exports, require("./utils/server.cjs"), module.exports);
+var import_server = __toESM(require("./utils/server.cjs"), 1);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   dbUtil,
   durationUtil,
   oidcUtil,
   realtimeUtil,
+  serverUtil,
   sessionManagerUtil,
   sessionUtil,
   storageUtil,
@@ -81,5 +85,6 @@ var import_db = __toESM(require("./utils/db.cjs"), 1);
   ...require("./utils/session.cjs"),
   ...require("./utils/session_manager.cjs"),
   ...require("./utils/ui.cjs"),
-  ...require("./utils/db.cjs")
+  ...require("./utils/db.cjs"),
+  ...require("./utils/server.cjs")
 });

package/utils/index.js

@@ -19,4 +19,6 @@ export { default as durationUtil } from './utils/duration.js';
 export { default as sessionUtil } from './utils/session.js';
 export { default as sessionManagerUtil } from './utils/session_manager.js';
 export { default as uiUtil } from './utils/ui.js';
-export { default as dbUtil } from './utils/db.js';
+export { default as dbUtil } from './utils/db.js';
+export * from './utils/server.js';
+export { default as serverUtil } from './utils/server.js';

package/utils/utils/server.cjs

@@ -0,0 +1,309 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var server_exports = {};
+__export(server_exports, {
+  app_build_info: () => app_build_info,
+  app_commit: () => app_commit,
+  createRouter: () => createRouter,
+  createServer: () => createServer,
+  default: () => server_default,
+  execGit: () => execGit,
+  getNetworkIp: () => getNetworkIp,
+  loadRoutes: () => loadRoutes,
+  printServerBanner: () => printServerBanner
+});
+module.exports = __toCommonJS(server_exports);
+var import_fs = __toESM(require("fs"), 1);
+var import_path = __toESM(require("path"), 1);
+var import_os = __toESM(require("os"), 1);
+var import_http = __toESM(require("http"), 1);
+var import_child_process = require("child_process");
+let cachedCommit = null;
+let cachedBuildInfo = null;
+const bootTime = (/* @__PURE__ */ new Date()).toISOString();
+function execGit(cmd, cwd) {
+  try {
+    const stdout = (0, import_child_process.execSync)(cmd, {
+      cwd: cwd || process.cwd(),
+      stdio: ["ignore", "pipe", "ignore"],
+      timeout: 2e3,
+      encoding: "utf8"
+    });
+    return stdout ? stdout.trim() : "";
+  } catch {
+    return "";
+  }
+}
+function app_commit(cwd) {
+  if (cachedCommit !== null) {
+    return cachedCommit;
+  }
+  if (process.env.APP_COMMIT && process.env.APP_COMMIT.trim()) {
+    cachedCommit = process.env.APP_COMMIT.trim();
+    return cachedCommit;
+  }
+  if (process.env.GIT_COMMIT && process.env.GIT_COMMIT.trim()) {
+    cachedCommit = process.env.GIT_COMMIT.trim().slice(0, 7);
+    return cachedCommit;
+  }
+  cachedCommit = execGit("git rev-parse --short HEAD", cwd);
+  return cachedCommit;
+}
+function app_build_info(cwd) {
+  if (cachedBuildInfo !== null) {
+    return cachedBuildInfo;
+  }
+  const commit = app_commit(cwd);
+  const branch = process.env.APP_BRANCH && process.env.APP_BRANCH.trim() || process.env.GIT_BRANCH && process.env.GIT_BRANCH.trim() || execGit("git rev-parse --abbrev-ref HEAD", cwd) || "main";
+  const rawDate = process.env.APP_COMMIT_DATE && process.env.APP_COMMIT_DATE.trim() || execGit("git log -1 --format=%ci", cwd);
+  const commitDate = rawDate ? rawDate.slice(0, 16) : "";
+  const buildTime = process.env.BUILD_TIME && process.env.BUILD_TIME.trim() || bootTime;
+  cachedBuildInfo = {
+    commit,
+    branch,
+    commitDate,
+    buildTime
+  };
+  return cachedBuildInfo;
+}
+function getNetworkIp() {
+  try {
+    const interfaces = import_os.default.networkInterfaces();
+    for (const name of Object.keys(interfaces)) {
+      for (const iface of interfaces[name]) {
+        if (iface.family === "IPv4" && !iface.internal) {
+          return iface.address;
+        }
+      }
+    }
+  } catch {
+  }
+  return null;
+}
+function printServerBanner({
+  port,
+  elapsed,
+  commit,
+  shouldSyncDb = false,
+  isSynced = false,
+  networkIp = null
+}) {
+  const commitTag = commit ? " \x1B[32m" + commit + "\x1B[0m" : "";
+  const resolvedIp = networkIp !== void 0 ? networkIp : getNetworkIp();
+  console.log("\n  \x1B[32m\x1B[1mSERVER\x1B[0m" + commitTag + "  \x1B[90mready in " + elapsed + " ms\x1B[0m\n");
+  console.log("  \x1B[32m\u279C\x1B[0m  \x1B[1mLocal:\x1B[0m   \x1B[36mhttp://localhost:" + port + "/\x1B[0m");
+  if (resolvedIp) {
+    console.log("  \x1B[32m\u279C\x1B[0m  \x1B[1mNetwork:\x1B[0m \x1B[36mhttp://" + resolvedIp + ":" + port + "/\x1B[0m");
+  }
+  const dbStatus = isSynced ? "\x1B[32mSynced\x1B[0m" : "\x1B[90mSkipped (pass -s to sync)\x1B[0m";
+  console.log("  \x1B[32m\u279C\x1B[0m  \x1B[1mDatabase:\x1B[0m " + dbStatus + "\n");
+}
+function createRouter(options = {}) {
+  const expressModule = options.express || (typeof require !== "undefined" ? require("express") : null);
+  if (!expressModule) {
+    throw new Error("[cynx/server] express is required to use createRouter");
+  }
+  const router = expressModule.Router(options.routerOptions || {});
+  if (options.prefix) {
+    router._cynxPrefix = options.prefix;
+  }
+  return router;
+}
+function loadRoutes(app, routesDir, options = {}) {
+  if (!routesDir || !import_fs.default.existsSync(routesDir)) {
+    return [];
+  }
+  const customPrefixes = options.routePrefixes || {};
+  const mounted = [];
+  const files = import_fs.default.readdirSync(routesDir);
+  for (const file of files) {
+    const ext = import_path.default.extname(file);
+    if (![".js", ".cjs", ".mjs"].includes(ext)) continue;
+    if (file.startsWith(".") || file.startsWith("_")) continue;
+    const baseName = import_path.default.basename(file, ext);
+    const fullPath = import_path.default.resolve(routesDir, file);
+    let routeModule;
+    try {
+      routeModule = typeof require !== "undefined" ? require(fullPath) : null;
+    } catch (err) {
+      console.error(`[cynx/server] Error loading route file ${file}:`, err);
+      continue;
+    }
+    if (!routeModule) continue;
+    const router = routeModule.default || routeModule.router || routeModule;
+    if (typeof router !== "function" && (!router || typeof router.use !== "function")) {
+      continue;
+    }
+    let prefixes = router._cynxPrefix || router.prefix || customPrefixes[baseName];
+    if (!prefixes) {
+      prefixes = `/api/${baseName}`;
+    }
+    const prefixList = Array.isArray(prefixes) ? prefixes : [prefixes];
+    for (const prefix of prefixList) {
+      app.use(prefix, router);
+      mounted.push({ file, prefix });
+    }
+  }
+  return mounted;
+}
+function createServer(options = {}) {
+  const expressModule = options.express || (typeof require !== "undefined" ? require("express") : null);
+  if (!expressModule) {
+    throw new Error("[cynx/server] express is required to create a server");
+  }
+  const app = options.app || expressModule();
+  const startTime = Date.now();
+  if (options.cors !== false) {
+    const corsModule = options.corsMiddleware || (typeof require !== "undefined" ? require("cors") : null);
+    if (corsModule) {
+      app.use(typeof options.cors === "object" ? corsModule(options.cors) : corsModule());
+    }
+  }
+  if (options.compression) {
+    if (typeof options.compression === "function") {
+      app.use(options.compression);
+    } else {
+      const compModule = typeof require !== "undefined" ? require("compression") : null;
+      if (compModule) app.use(compModule());
+    }
+  }
+  const limit = options.bodyLimit || "5mb";
+  app.use(expressModule.json({ limit }));
+  app.use(expressModule.urlencoded({ extended: true, limit }));
+  if (typeof options.beforeRoutes === "function") {
+    options.beforeRoutes(app);
+  }
+  if (options.routesDir) {
+    loadRoutes(app, options.routesDir, options);
+  }
+  if (Array.isArray(options.routes)) {
+    for (const route of options.routes) {
+      if (route.prefix && route.router) {
+        const list = Array.isArray(route.prefix) ? route.prefix : [route.prefix];
+        for (const p of list) {
+          app.use(p, route.router);
+        }
+      }
+    }
+  }
+  if (options.healthcheck !== false) {
+    app.get("/api/health", (_req, res) => res.json({ status: "ok" }));
+  }
+  if (typeof options.beforeErrorHandler === "function") {
+    options.beforeErrorHandler(app);
+  }
+  if (options.errorHandler !== false) {
+    app.use((err, _req, res, _next) => {
+      console.error("[HTTP]", err);
+      res.status(err.status || 500).json({ error: err.message || "Internal server error" });
+    });
+  }
+  if (options.processHandlers !== false) {
+    process.on("unhandledRejection", (reason) => {
+      console.error("[System]", reason);
+    });
+    process.on("uncaughtException", (err) => {
+      console.error("[System]", err);
+    });
+  }
+  const port = options.port || process.env.BACKEND_PORT || process.env.PORT || 3e3;
+  const host = options.host || "0.0.0.0";
+  let httpServer = null;
+  return {
+    app,
+    get httpServer() {
+      return httpServer;
+    },
+    port,
+    host,
+    start: function(onReady) {
+      return new Promise((resolve, reject) => {
+        try {
+          httpServer = app.listen(port, host, async () => {
+            const elapsed = Date.now() - startTime;
+            const build = app_build_info();
+            if (options.banner !== false) {
+              printServerBanner({
+                port,
+                elapsed,
+                commit: build.commit,
+                shouldSyncDb: options.shouldSyncDb,
+                isSynced: options.isSynced
+              });
+            }
+            if (typeof options.onStart === "function") {
+              try {
+                await options.onStart({ app, httpServer, port, host, elapsed, build });
+              } catch (onStartErr) {
+                console.error("[cynx/server] onStart error:", onStartErr);
+              }
+            }
+            if (typeof onReady === "function") {
+              onReady({ app, httpServer, port, host, elapsed, build });
+            }
+            resolve({ app, httpServer, port, host, elapsed, build });
+          });
+          httpServer.keepAliveTimeout = options.keepAliveTimeout || 65e3;
+          httpServer.headersTimeout = options.headersTimeout || 66e3;
+        } catch (listenErr) {
+          reject(listenErr);
+        }
+      });
+    },
+    stop: function() {
+      return new Promise((resolve) => {
+        if (httpServer) {
+          httpServer.close(() => resolve());
+        } else {
+          resolve();
+        }
+      });
+    }
+  };
+}
+var server_default = {
+  createServer,
+  createRouter,
+  loadRoutes,
+  app_commit,
+  app_build_info,
+  printServerBanner,
+  getNetworkIp,
+  execGit
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  app_build_info,
+  app_commit,
+  createRouter,
+  createServer,
+  execGit,
+  getNetworkIp,
+  loadRoutes,
+  printServerBanner
+});

package/utils/utils/server.js

@@ -0,0 +1,369 @@
+/**
+ * cynx/server — Universal Microservice & HTTP Server Engine (server.js)
+ *
+ * Provides a standardized, zero-boilerplate Node.js / Express server runner:
+ *  - Automatic route discovery and declarative mounting from routes directory
+ *  - Standardized start-up banner with commit info, timing, and network IP
+ *  - Git commit & build info extraction (app_commit, app_build_info)
+ *  - Preconfigured middleware: CORS, Compression, Body parsers with limits
+ *  - Lifecycle hooks (beforeRoutes, beforeErrorHandler, onStart)
+ *  - Resilience settings (keepAliveTimeout, headersTimeout, process error catchers)
+ *  - Built-in /api/health endpoint
+ *
+ * STRICT NO EMOJIS!
+ */
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import http from 'http';
+import { execSync } from 'child_process';
+
+let cachedCommit = null;
+let cachedBuildInfo = null;
+const bootTime = new Date().toISOString();
+
+/**
+ * Execute git command safely with timeout.
+ */
+export function execGit(cmd, cwd) {
+  try {
+    const stdout = execSync(cmd, {
+      cwd: cwd || process.cwd(),
+      stdio: ['ignore', 'pipe', 'ignore'],
+      timeout: 2000,
+      encoding: 'utf8',
+    });
+    return stdout ? stdout.trim() : '';
+  } catch {
+    return '';
+  }
+}
+
+/**
+ * Get current git commit hash (short 7-char).
+ */
+export function app_commit(cwd) {
+  if (cachedCommit !== null) {
+    return cachedCommit;
+  }
+
+  if (process.env.APP_COMMIT && process.env.APP_COMMIT.trim()) {
+    cachedCommit = process.env.APP_COMMIT.trim();
+    return cachedCommit;
+  }
+
+  if (process.env.GIT_COMMIT && process.env.GIT_COMMIT.trim()) {
+    cachedCommit = process.env.GIT_COMMIT.trim().slice(0, 7);
+    return cachedCommit;
+  }
+
+  cachedCommit = execGit('git rev-parse --short HEAD', cwd);
+  return cachedCommit;
+}
+
+/**
+ * Get application build and git metadata.
+ */
+export function app_build_info(cwd) {
+  if (cachedBuildInfo !== null) {
+    return cachedBuildInfo;
+  }
+
+  const commit = app_commit(cwd);
+
+  const branch =
+    (process.env.APP_BRANCH && process.env.APP_BRANCH.trim()) ||
+    (process.env.GIT_BRANCH && process.env.GIT_BRANCH.trim()) ||
+    execGit('git rev-parse --abbrev-ref HEAD', cwd) ||
+    'main';
+
+  const rawDate =
+    (process.env.APP_COMMIT_DATE && process.env.APP_COMMIT_DATE.trim()) ||
+    execGit('git log -1 --format=%ci', cwd);
+  const commitDate = rawDate ? rawDate.slice(0, 16) : '';
+
+  const buildTime =
+    (process.env.BUILD_TIME && process.env.BUILD_TIME.trim()) ||
+    bootTime;
+
+  cachedBuildInfo = {
+    commit,
+    branch,
+    commitDate,
+    buildTime,
+  };
+
+  return cachedBuildInfo;
+}
+
+/**
+ * Resolve local network IPv4 address.
+ */
+export function getNetworkIp() {
+  try {
+    const interfaces = os.networkInterfaces();
+    for (const name of Object.keys(interfaces)) {
+      for (const iface of interfaces[name]) {
+        if (iface.family === 'IPv4' && !iface.internal) {
+          return iface.address;
+        }
+      }
+    }
+  } catch {
+    // fallback
+  }
+  return null;
+}
+
+/**
+ * Print standardized start-up banner.
+ */
+export function printServerBanner({
+  port,
+  elapsed,
+  commit,
+  shouldSyncDb = false,
+  isSynced = false,
+  networkIp = null,
+}) {
+  const commitTag = commit ? ' \x1b[32m' + commit + '\x1b[0m' : '';
+  const resolvedIp = networkIp !== undefined ? networkIp : getNetworkIp();
+
+  console.log('\n  \x1b[32m\x1b[1mSERVER\x1b[0m' + commitTag + '  \x1b[90mready in ' + elapsed + ' ms\x1b[0m\n');
+  console.log('  \x1b[32m➜\x1b[0m  \x1b[1mLocal:\x1b[0m   \x1b[36mhttp://localhost:' + port + '/\x1b[0m');
+  if (resolvedIp) {
+    console.log('  \x1b[32m➜\x1b[0m  \x1b[1mNetwork:\x1b[0m \x1b[36mhttp://' + resolvedIp + ':' + port + '/\x1b[0m');
+  }
+  const dbStatus = isSynced
+    ? '\x1b[32mSynced\x1b[0m'
+    : '\x1b[90mSkipped (pass -s to sync)\x1b[0m';
+  console.log('  \x1b[32m➜\x1b[0m  \x1b[1mDatabase:\x1b[0m ' + dbStatus + '\n');
+}
+
+/**
+ * Helper to create a router with route metadata.
+ */
+export function createRouter(options = {}) {
+  const expressModule = options.express || (typeof require !== 'undefined' ? require('express') : null);
+  if (!expressModule) {
+    throw new Error('[cynx/server] express is required to use createRouter');
+  }
+
+  const router = expressModule.Router(options.routerOptions || {});
+  if (options.prefix) {
+    router._cynxPrefix = options.prefix;
+  }
+  return router;
+}
+
+/**
+ * Auto-discover and mount routes from a directory.
+ */
+export function loadRoutes(app, routesDir, options = {}) {
+  if (!routesDir || !fs.existsSync(routesDir)) {
+    return [];
+  }
+
+  const customPrefixes = options.routePrefixes || {};
+  const mounted = [];
+  const files = fs.readdirSync(routesDir);
+
+  for (const file of files) {
+    const ext = path.extname(file);
+    if (!['.js', '.cjs', '.mjs'].includes(ext)) continue;
+    if (file.startsWith('.') || file.startsWith('_')) continue;
+
+    const baseName = path.basename(file, ext);
+    const fullPath = path.resolve(routesDir, file);
+
+    let routeModule;
+    try {
+      routeModule = typeof require !== 'undefined' ? require(fullPath) : null;
+    } catch (err) {
+      console.error(`[cynx/server] Error loading route file ${file}:`, err);
+      continue;
+    }
+
+    if (!routeModule) continue;
+
+    const router = routeModule.default || routeModule.router || routeModule;
+    if (typeof router !== 'function' && (!router || typeof router.use !== 'function')) {
+      continue;
+    }
+
+    // Determine mount prefix(es)
+    let prefixes = router._cynxPrefix || router.prefix || customPrefixes[baseName];
+    if (!prefixes) {
+      prefixes = `/api/${baseName}`;
+    }
+
+    const prefixList = Array.isArray(prefixes) ? prefixes : [prefixes];
+    for (const prefix of prefixList) {
+      app.use(prefix, router);
+      mounted.push({ file, prefix });
+    }
+  }
+
+  return mounted;
+}
+
+/**
+ * Create and configure standardized Express application and HTTP server.
+ */
+export function createServer(options = {}) {
+  const expressModule = options.express || (typeof require !== 'undefined' ? require('express') : null);
+  if (!expressModule) {
+    throw new Error('[cynx/server] express is required to create a server');
+  }
+
+  const app = options.app || expressModule();
+  const startTime = Date.now();
+
+  // 1. CORS
+  if (options.cors !== false) {
+    const corsModule = options.corsMiddleware || (typeof require !== 'undefined' ? require('cors') : null);
+    if (corsModule) {
+      app.use(typeof options.cors === 'object' ? corsModule(options.cors) : corsModule());
+    }
+  }
+
+  // 2. Compression
+  if (options.compression) {
+    if (typeof options.compression === 'function') {
+      app.use(options.compression);
+    } else {
+      const compModule = typeof require !== 'undefined' ? require('compression') : null;
+      if (compModule) app.use(compModule());
+    }
+  }
+
+  // 3. Body Parsers
+  const limit = options.bodyLimit || '5mb';
+  app.use(expressModule.json({ limit }));
+  app.use(expressModule.urlencoded({ extended: true, limit }));
+
+  // 4. Hook before routes (custom loggers, metrics, etc.)
+  if (typeof options.beforeRoutes === 'function') {
+    options.beforeRoutes(app);
+  }
+
+  // 5. Auto-mount routes
+  if (options.routesDir) {
+    loadRoutes(app, options.routesDir, options);
+  }
+
+  // 6. Explicit routes list
+  if (Array.isArray(options.routes)) {
+    for (const route of options.routes) {
+      if (route.prefix && route.router) {
+        const list = Array.isArray(route.prefix) ? route.prefix : [route.prefix];
+        for (const p of list) {
+          app.use(p, route.router);
+        }
+      }
+    }
+  }
+
+  // 7. Built-in healthcheck
+  if (options.healthcheck !== false) {
+    app.get('/api/health', (_req, res) => res.json({ status: 'ok' }));
+  }
+
+  // 8. Hook before error handler (e.g. Sentry.setupExpressErrorHandler)
+  if (typeof options.beforeErrorHandler === 'function') {
+    options.beforeErrorHandler(app);
+  }
+
+  // 9. Standardized JSON Error Handler
+  if (options.errorHandler !== false) {
+    app.use((err, _req, res, _next) => {
+      console.error('[HTTP]', err);
+      res.status(err.status || 500).json({ error: err.message || 'Internal server error' });
+    });
+  }
+
+  // 10. Process level unhandled error safety
+  if (options.processHandlers !== false) {
+    process.on('unhandledRejection', (reason) => {
+      console.error('[System]', reason);
+    });
+
+    process.on('uncaughtException', (err) => {
+      console.error('[System]', err);
+    });
+  }
+
+  const port = options.port || process.env.BACKEND_PORT || process.env.PORT || 3000;
+  const host = options.host || '0.0.0.0';
+  let httpServer = null;
+
+  return {
+    app,
+    get httpServer() {
+      return httpServer;
+    },
+    port,
+    host,
+    start: function (onReady) {
+      return new Promise((resolve, reject) => {
+        try {
+          httpServer = app.listen(port, host, async () => {
+            const elapsed = Date.now() - startTime;
+            const build = app_build_info();
+
+            // Print banner if not disabled
+            if (options.banner !== false) {
+              printServerBanner({
+                port,
+                elapsed,
+                commit: build.commit,
+                shouldSyncDb: options.shouldSyncDb,
+                isSynced: options.isSynced,
+              });
+            }
+
+            if (typeof options.onStart === 'function') {
+              try {
+                await options.onStart({ app, httpServer, port, host, elapsed, build });
+              } catch (onStartErr) {
+                console.error('[cynx/server] onStart error:', onStartErr);
+              }
+            }
+
+            if (typeof onReady === 'function') {
+              onReady({ app, httpServer, port, host, elapsed, build });
+            }
+
+            resolve({ app, httpServer, port, host, elapsed, build });
+          });
+
+          httpServer.keepAliveTimeout = options.keepAliveTimeout || 65000;
+          httpServer.headersTimeout = options.headersTimeout || 66000;
+        } catch (listenErr) {
+          reject(listenErr);
+        }
+      });
+    },
+    stop: function () {
+      return new Promise((resolve) => {
+        if (httpServer) {
+          httpServer.close(() => resolve());
+        } else {
+          resolve();
+        }
+      });
+    },
+  };
+}
+
+export default {
+  createServer,
+  createRouter,
+  loadRoutes,
+  app_commit,
+  app_build_info,
+  printServerBanner,
+  getNetworkIp,
+  execGit,
+};