@shetty4l/core 0.1.8 → 0.1.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shetty4l/core",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Shared infrastructure primitives for Bun/TypeScript services",
   "repository": {
     "type": "git",

package/src/cli.ts

@@ -45,7 +45,7 @@ export function formatUptime(seconds: number): string {
 export type CommandHandler = (
   args: string[],
   json: boolean,
-) => void | Promise<void>;
+) => void | number | Promise<void | number>;
 
 export interface RunCliOpts {
   /** Service name, used in error messages. */
@@ -104,6 +104,6 @@ export async function runCli(opts: RunCliOpts): Promise<void> {
     process.exit(1);
   }
 
-  await handler(args, json);
-  process.exit(0);
+  const exitCode = (await handler(args, json)) ?? 0;
+  process.exit(exitCode);
 }

package/src/http.ts

@@ -64,6 +64,8 @@ export function healthResponse(
 // --- Server ---
 
 export interface ServerOpts {
+  /** Service name used as log prefix (e.g. "synapse"). */
+  name?: string;
   /** Port to listen on. */
   port: number;
   /** Hostname to bind to. Defaults to "127.0.0.1". */
@@ -98,8 +100,9 @@ export interface HttpServer {
  *   4. If onRequest returns null -> 404
  */
 export function createServer(opts: ServerOpts): HttpServer {
-  const { port, host = "127.0.0.1", version, onRequest } = opts;
+  const { port, host = "127.0.0.1", version, onRequest, name } = opts;
   const startTime = Date.now();
+  const prefix = name ? `${name}: ` : "";
 
   const server = Bun.serve({
     port,
@@ -122,7 +125,7 @@ export function createServer(opts: ServerOpts): HttpServer {
         }
         return result;
       } catch (error) {
-        console.error("HTTP request error:", error);
+        console.error(`${prefix}HTTP request error:`, error);
         return jsonError(
           500,
           error instanceof Error ? error.message : "Internal server error",

package/src/signals.ts

@@ -7,6 +7,8 @@
  */
 
 export interface ShutdownOpts {
+  /** Service name used as log prefix (e.g. "synapse"). */
+  name?: string;
   /** Signals to handle. Defaults to ["SIGINT", "SIGTERM"]. */
   signals?: string[];
   /** Force exit after this many ms. No timeout if omitted. */
@@ -26,6 +28,7 @@ export function onShutdown(
 ): void {
   const signals = opts?.signals ?? ["SIGINT", "SIGTERM"];
   const timeoutMs = opts?.timeoutMs;
+  const prefix = opts?.name ? `${opts.name}: ` : "";
   let shutting = false;
 
   const handler = (signal: string) => {
@@ -33,12 +36,16 @@ export function onShutdown(
       process.exit(1);
     }
     shutting = true;
-    console.log(`\n${signal} received, shutting down...`);
+    console.error(
+      `\n${prefix}${signal.toLowerCase()} received, shutting down...`,
+    );
 
     let timer: ReturnType<typeof setTimeout> | undefined;
     if (timeoutMs !== undefined) {
       timer = setTimeout(() => {
-        console.error(`Shutdown timed out after ${timeoutMs}ms, forcing exit`);
+        console.error(
+          `${prefix}shutdown timed out after ${timeoutMs}ms, forcing exit`,
+        );
         process.exit(1);
       }, timeoutMs);
       // Don't block the event loop from exiting
@@ -53,7 +60,7 @@ export function onShutdown(
           process.exit(0);
         })
         .catch((err) => {
-          console.error("Shutdown cleanup error:", err);
+          console.error(`${prefix}shutdown cleanup error:`, err);
           if (timer) clearTimeout(timer);
           process.exit(1);
         });