pg-sse 0.1.2

package/dist/index.mjs

@@ -0,0 +1,258 @@
+"use client";
+import {
+  SseProvider,
+  useSseStatus,
+  useSubscription
+} from "./chunk-GFLW4AMU.mjs";
+
+// src/shared/emitter.ts
+import { EventEmitter } from "events";
+var TypedEmitter = class {
+  emitter = new EventEmitter();
+  on(event, listener) {
+    this.emitter.on(event, listener);
+    return this;
+  }
+  once(event, listener) {
+    this.emitter.once(event, listener);
+    return this;
+  }
+  off(event, listener) {
+    this.emitter.off(event, listener);
+    return this;
+  }
+  emit(event, payload) {
+    return this.emitter.emit(event, payload);
+  }
+  addListener(event, listener) {
+    this.emitter.addListener(event, listener);
+    return this;
+  }
+  removeListener(event, listener) {
+    this.emitter.removeListener(event, listener);
+    return this;
+  }
+  removeAllListeners(event) {
+    this.emitter.removeAllListeners(event);
+    return this;
+  }
+};
+
+// src/server/listener.ts
+import { Client } from "pg";
+var PostgresSseListener = class {
+  events = new TypedEmitter();
+  client = null;
+  isConnected = false;
+  isDisconnecting = false;
+  retryCount = 0;
+  reconnectTimer = null;
+  // In-memory registry of active SSE clients
+  clients = /* @__PURE__ */ new Map();
+  config;
+  channels;
+  constructor(config, channels = "db_changes") {
+    this.config = config;
+    this.channels = Array.isArray(channels) ? channels : [channels];
+    const channelRegex = /^[a-zA-Z0-9_]+$/;
+    for (const channel of this.channels) {
+      if (!channelRegex.test(channel)) {
+        throw new Error(
+          `Invalid channel name: "${channel}". Channel names must be alphanumeric and underscores only.`
+        );
+      }
+    }
+  }
+  async connect() {
+    if (this.isConnected) return;
+    this.isDisconnecting = false;
+    try {
+      this.client = typeof this.config === "string" ? new Client(this.config) : new Client(this.config);
+      this.client.on("error", (err) => {
+        this.handleConnectionError(err);
+      });
+      this.client.on("notification", (msg) => {
+        this.handleNotification(msg);
+      });
+      await this.client.connect();
+      for (const channel of this.channels) {
+        await this.client.query(`LISTEN ${channel}`);
+      }
+      this.isConnected = true;
+      this.retryCount = 0;
+      this.events.emit("connected", void 0);
+    } catch (err) {
+      this.handleConnectionError(err);
+    }
+  }
+  async disconnect() {
+    this.isDisconnecting = true;
+    this.isConnected = false;
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = null;
+    }
+    if (this.client) {
+      try {
+        await this.client.end();
+      } catch (err) {
+      } finally {
+        this.client = null;
+      }
+    }
+  }
+  getActiveConnections() {
+    return this.clients.size;
+  }
+  registerClient(clientId, send) {
+    this.clients.set(clientId, send);
+  }
+  unregisterClient(clientId) {
+    this.clients.delete(clientId);
+  }
+  broadcast(event, data) {
+    const message = `event: ${event}
+data: ${JSON.stringify(data)}
+
+`;
+    for (const send of this.clients.values()) {
+      try {
+        send(message);
+      } catch (err) {
+      }
+    }
+  }
+  handleConnectionError(err) {
+    if (this.isDisconnecting) return;
+    this.isConnected = false;
+    this.events.emit("error", err);
+    if (this.client) {
+      this.client.end().catch(() => {
+      });
+      this.client = null;
+    }
+    this.scheduleReconnect();
+  }
+  scheduleReconnect() {
+    if (this.reconnectTimer) return;
+    this.retryCount++;
+    const delay = Math.min(1e3 * Math.pow(2, this.retryCount - 1), 3e4);
+    const jitter = Math.random() * 1e3;
+    const finalDelay = delay + jitter;
+    this.events.emit("reconnect", this.retryCount);
+    this.reconnectTimer = setTimeout(async () => {
+      this.reconnectTimer = null;
+      try {
+        await this.connect();
+      } catch (err) {
+      }
+    }, finalDelay);
+  }
+  handleNotification(msg) {
+    if (!msg.payload) return;
+    try {
+      let parsedPayload;
+      try {
+        parsedPayload = JSON.parse(msg.payload);
+      } catch (e) {
+        parsedPayload = msg.payload;
+      }
+      const isObjectPayload = typeof parsedPayload === "object" && parsedPayload !== null;
+      const payloadObj = isObjectPayload ? parsedPayload : null;
+      const eventPayload = payloadObj ? {
+        table: payloadObj.table || "unknown",
+        action: payloadObj.action || "INSERT",
+        id: payloadObj.id !== void 0 ? payloadObj.id : "",
+        ...payloadObj
+      } : {
+        table: "unknown",
+        action: "INSERT",
+        id: "",
+        data: parsedPayload
+      };
+      this.events.emit("notification", eventPayload);
+      this.broadcast("notification", eventPayload);
+    } catch (err) {
+      this.events.emit(
+        "error",
+        new Error(
+          `Failed to process notification payload: ${err.message}`
+        )
+      );
+    }
+  }
+};
+
+// src/server/handler.ts
+function createSseHandler(listener, req) {
+  const clientId = Math.random().toString(36).substring(2, 15);
+  const encoder = new TextEncoder();
+  const responseStream = new TransformStream();
+  const writer = responseStream.writable.getWriter();
+  let isCleanedUp = false;
+  function cleanup() {
+    if (isCleanedUp) return;
+    isCleanedUp = true;
+    clearInterval(keepAliveInterval);
+    listener.unregisterClient(clientId);
+    try {
+      writer.close();
+    } catch (err) {
+    }
+  }
+  function send(data) {
+    if (isCleanedUp) return;
+    writer.write(encoder.encode(data)).catch(() => {
+      cleanup();
+    });
+  }
+  listener.registerClient(clientId, send);
+  const keepAliveInterval = setInterval(() => {
+    if (isCleanedUp) return;
+    writer.write(encoder.encode(": keep-alive\n\n")).catch(() => {
+      cleanup();
+    });
+  }, 2e4);
+  const handshake = {
+    type: "handshake",
+    clientId,
+    activeConnections: listener.getActiveConnections()
+  };
+  writer.write(
+    encoder.encode(
+      `event: handshake
+data: ${JSON.stringify(handshake)}
+
+`
+    )
+  ).catch(() => {
+    cleanup();
+  });
+  if (req?.signal) {
+    if (req.signal.aborted) {
+      cleanup();
+    } else {
+      req.signal.addEventListener("abort", () => {
+        cleanup();
+      });
+    }
+  }
+  return new Response(responseStream.readable, {
+    headers: {
+      "Content-Type": "text/event-stream",
+      "Cache-Control": "no-cache, no-transform",
+      Connection: "keep-alive",
+      "X-Accel-Buffering": "no"
+      // Turn off buffering in Nginx/Vercel
+    }
+  });
+}
+export {
+  PostgresSseListener,
+  SseProvider,
+  TypedEmitter,
+  createSseHandler,
+  useSseStatus,
+  useSubscription
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/emitter.ts","../src/server/listener.ts","../src/server/handler.ts"],"sourcesContent":["import { EventEmitter } from \"events\";\n\nexport class TypedEmitter<Events extends object> {\n  private emitter = new EventEmitter();\n\n  on<K extends keyof Events>(\n    event: K,\n    listener: (payload: Events[K]) => void,\n  ): this {\n    this.emitter.on(event as string, listener);\n    return this;\n  }\n\n  once<K extends keyof Events>(\n    event: K,\n    listener: (payload: Events[K]) => void,\n  ): this {\n    this.emitter.once(event as string, listener);\n    return this;\n  }\n\n  off<K extends keyof Events>(\n    event: K,\n    listener: (payload: Events[K]) => void,\n  ): this {\n    this.emitter.off(event as string, listener);\n    return this;\n  }\n\n  emit<K extends keyof Events>(event: K, payload: Events[K]): boolean {\n    return this.emitter.emit(event as string, payload);\n  }\n\n  addListener<K extends keyof Events>(\n    event: K,\n    listener: (payload: Events[K]) => void,\n  ): this {\n    this.emitter.addListener(event as string, listener);\n    return this;\n  }\n\n  removeListener<K extends keyof Events>(\n    event: K,\n    listener: (payload: Events[K]) => void,\n  ): this {\n    this.emitter.removeListener(event as string, listener);\n    return this;\n  }\n\n  removeAllListeners(event?: keyof Events): this {\n    this.emitter.removeAllListeners(event as string);\n    return this;\n  }\n}\n","import { Client, ClientConfig } from \"pg\";\nimport { TypedEmitter } from \"../shared/emitter\";\n\nexport interface SseListenerEvents {\n  connected: void;\n  error: Error;\n  reconnect: number;\n  notification: {\n    table: string;\n    action: \"INSERT\" | \"UPDATE\" | \"DELETE\";\n    id: string | number;\n    [key: string]: unknown;\n  };\n}\n\nexport interface SseListener {\n  connect(): Promise<void>;\n  disconnect(): Promise<void>;\n  events: TypedEmitter<SseListenerEvents>;\n  getActiveConnections(): number;\n  registerClient(clientId: string, send: (data: string) => void): void;\n  unregisterClient(clientId: string): void;\n  broadcast(event: string, data: unknown): void;\n}\n\nexport class PostgresSseListener implements SseListener {\n  public events = new TypedEmitter<SseListenerEvents>();\n  private client: Client | null = null;\n  private isConnected = false;\n  private isDisconnecting = false;\n  private retryCount = 0;\n  private reconnectTimer: NodeJS.Timeout | null = null;\n\n  // In-memory registry of active SSE clients\n  private clients = new Map<string, (data: string) => void>();\n\n  private readonly config: ClientConfig | string;\n  private readonly channels: string[];\n\n  constructor(\n    config: ClientConfig | string,\n    channels: string | string[] = \"db_changes\",\n  ) {\n    this.config = config;\n    this.channels = Array.isArray(channels) ? channels : [channels];\n\n    // Security validation of channel names to prevent SQL injection via LISTEN\n    const channelRegex = /^[a-zA-Z0-9_]+$/;\n    for (const channel of this.channels) {\n      if (!channelRegex.test(channel)) {\n        throw new Error(\n          `Invalid channel name: \"${channel}\". Channel names must be alphanumeric and underscores only.`,\n        );\n      }\n    }\n  }\n\n  public async connect(): Promise<void> {\n    if (this.isConnected) return;\n    this.isDisconnecting = false;\n\n    try {\n      this.client =\n        typeof this.config === \"string\"\n          ? new Client(this.config)\n          : new Client(this.config);\n\n      this.client.on(\"error\", (err) => {\n        this.handleConnectionError(err);\n      });\n\n      this.client.on(\"notification\", (msg) => {\n        this.handleNotification(msg);\n      });\n\n      await this.client.connect();\n\n      for (const channel of this.channels) {\n        // Safe because of strict regex validation in constructor\n        await this.client.query(`LISTEN ${channel}`);\n      }\n\n      this.isConnected = true;\n      this.retryCount = 0;\n      this.events.emit(\"connected\", undefined);\n    } catch (err) {\n      this.handleConnectionError(err as Error);\n    }\n  }\n\n  public async disconnect(): Promise<void> {\n    this.isDisconnecting = true;\n    this.isConnected = false;\n\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = null;\n    }\n\n    if (this.client) {\n      try {\n        await this.client.end();\n      } catch (err) {\n        // Ignore errors during clean disconnect\n      } finally {\n        this.client = null;\n      }\n    }\n  }\n\n  public getActiveConnections(): number {\n    return this.clients.size;\n  }\n\n  public registerClient(clientId: string, send: (data: string) => void): void {\n    this.clients.set(clientId, send);\n  }\n\n  public unregisterClient(clientId: string): void {\n    this.clients.delete(clientId);\n  }\n\n  public broadcast(event: string, data: unknown): void {\n    const message = `event: ${event}\\ndata: ${JSON.stringify(data)}\\n\\n`;\n    for (const send of this.clients.values()) {\n      try {\n        send(message);\n      } catch (err) {\n        // Client stream might be closed/broken\n      }\n    }\n  }\n\n  private handleConnectionError(err: Error) {\n    if (this.isDisconnecting) return;\n\n    this.isConnected = false;\n    this.events.emit(\"error\", err);\n\n    if (this.client) {\n      this.client.end().catch(() => {});\n      this.client = null;\n    }\n\n    this.scheduleReconnect();\n  }\n\n  private scheduleReconnect() {\n    if (this.reconnectTimer) return;\n\n    this.retryCount++;\n    // Exponential backoff: 1s, 2s, 4s, 8s, 16s, max 30s\n    const delay = Math.min(1000 * Math.pow(2, this.retryCount - 1), 30000);\n    // Add jitter: up to 1000ms\n    const jitter = Math.random() * 1000;\n    const finalDelay = delay + jitter;\n\n    this.events.emit(\"reconnect\", this.retryCount);\n\n    this.reconnectTimer = setTimeout(async () => {\n      this.reconnectTimer = null;\n      try {\n        await this.connect();\n      } catch (err) {\n        // Error will trigger handleConnectionError which calls scheduleReconnect again\n      }\n    }, finalDelay);\n  }\n\n  private handleNotification(msg: { channel: string; payload?: string }) {\n    if (!msg.payload) return;\n\n    try {\n      let parsedPayload: unknown;\n      try {\n        parsedPayload = JSON.parse(msg.payload);\n      } catch (e) {\n        parsedPayload = msg.payload; // Fallback to raw string\n      }\n\n      // Check if the payload matches the expected structure, or wrap it\n      const isObjectPayload =\n        typeof parsedPayload === \"object\" && parsedPayload !== null;\n      const payloadObj = isObjectPayload\n        ? (parsedPayload as Record<string, unknown>)\n        : null;\n\n      const eventPayload = payloadObj\n        ? {\n            table: (payloadObj.table as string) || \"unknown\",\n            action:\n              (payloadObj.action as \"INSERT\" | \"UPDATE\" | \"DELETE\") || \"INSERT\",\n            id:\n              payloadObj.id !== undefined\n                ? (payloadObj.id as string | number)\n                : \"\",\n            ...payloadObj,\n          }\n        : {\n            table: \"unknown\",\n            action: \"INSERT\" as const,\n            id: \"\",\n            data: parsedPayload,\n          };\n\n      // Emit typed event\n      this.events.emit(\"notification\", eventPayload);\n\n      // Broadcast to all active client SSE streams\n      this.broadcast(\"notification\", eventPayload);\n    } catch (err) {\n      // Avoid throwing unhandled exception inside event loop\n      this.events.emit(\n        \"error\",\n        new Error(\n          `Failed to process notification payload: ${(err as Error).message}`,\n        ),\n      );\n    }\n  }\n}\n","import { SseListener } from \"./listener\";\n\n/**\n * Creates an HTTP Response for Server-Sent Events (SSE) compatible with Next.js Route Handlers.\n * Handles client registration, keep-alive pings, and resource cleanup on client disconnect.\n *\n * @param listener The active SseListener instance.\n * @param req Optional incoming Request object to listen for connection aborts.\n * @returns A Response object streaming SSE.\n */\nexport function createSseHandler(\n  listener: SseListener,\n  req?: Request,\n): Response {\n  const clientId = Math.random().toString(36).substring(2, 15);\n  const encoder = new TextEncoder();\n  const responseStream = new TransformStream();\n  const writer = responseStream.writable.getWriter();\n\n  let isCleanedUp = false;\n\n  function cleanup() {\n    if (isCleanedUp) return;\n    isCleanedUp = true;\n\n    clearInterval(keepAliveInterval);\n    listener.unregisterClient(clientId);\n\n    try {\n      writer.close();\n    } catch (err) {\n      // Stream is already closed\n    }\n  }\n\n  function send(data: string) {\n    if (isCleanedUp) return;\n\n    writer.write(encoder.encode(data)).catch(() => {\n      // Write failed, connection probably severed\n      cleanup();\n    });\n  }\n\n  // Register client to receive broadcasts\n  listener.registerClient(clientId, send);\n\n  // Keep-alive timer to prevent proxies (Cloud Run, Cloudflare, etc.) from timing out\n  const keepAliveInterval = setInterval(() => {\n    if (isCleanedUp) return;\n    writer.write(encoder.encode(\": keep-alive\\n\\n\")).catch(() => {\n      cleanup();\n    });\n  }, 20000);\n\n  // Initial handshake to establish the client ID and current active connections count\n  const handshake = {\n    type: \"handshake\",\n    clientId,\n    activeConnections: listener.getActiveConnections(),\n  };\n\n  writer\n    .write(\n      encoder.encode(\n        `event: handshake\\ndata: ${JSON.stringify(handshake)}\\n\\n`,\n      ),\n    )\n    .catch(() => {\n      cleanup();\n    });\n\n  // Watch for request cancellation/abort\n  if (req?.signal) {\n    if (req.signal.aborted) {\n      cleanup();\n    } else {\n      req.signal.addEventListener(\"abort\", () => {\n        cleanup();\n      });\n    }\n  }\n\n  return new Response(responseStream.readable, {\n    headers: {\n      \"Content-Type\": \"text/event-stream\",\n      \"Cache-Control\": \"no-cache, no-transform\",\n      Connection: \"keep-alive\",\n      \"X-Accel-Buffering\": \"no\", // Turn off buffering in Nginx/Vercel\n    },\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/server.d.mts

@@ -0,0 +1,66 @@
+import { ClientConfig } from 'pg';
+
+declare class TypedEmitter<Events extends object> {
+    private emitter;
+    on<K extends keyof Events>(event: K, listener: (payload: Events[K]) => void): this;
+    once<K extends keyof Events>(event: K, listener: (payload: Events[K]) => void): this;
+    off<K extends keyof Events>(event: K, listener: (payload: Events[K]) => void): this;
+    emit<K extends keyof Events>(event: K, payload: Events[K]): boolean;
+    addListener<K extends keyof Events>(event: K, listener: (payload: Events[K]) => void): this;
+    removeListener<K extends keyof Events>(event: K, listener: (payload: Events[K]) => void): this;
+    removeAllListeners(event?: keyof Events): this;
+}
+
+interface SseListenerEvents {
+    connected: void;
+    error: Error;
+    reconnect: number;
+    notification: {
+        table: string;
+        action: "INSERT" | "UPDATE" | "DELETE";
+        id: string | number;
+        [key: string]: unknown;
+    };
+}
+interface SseListener {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    events: TypedEmitter<SseListenerEvents>;
+    getActiveConnections(): number;
+    registerClient(clientId: string, send: (data: string) => void): void;
+    unregisterClient(clientId: string): void;
+    broadcast(event: string, data: unknown): void;
+}
+declare class PostgresSseListener implements SseListener {
+    events: TypedEmitter<SseListenerEvents>;
+    private client;
+    private isConnected;
+    private isDisconnecting;
+    private retryCount;
+    private reconnectTimer;
+    private clients;
+    private readonly config;
+    private readonly channels;
+    constructor(config: ClientConfig | string, channels?: string | string[]);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    getActiveConnections(): number;
+    registerClient(clientId: string, send: (data: string) => void): void;
+    unregisterClient(clientId: string): void;
+    broadcast(event: string, data: unknown): void;
+    private handleConnectionError;
+    private scheduleReconnect;
+    private handleNotification;
+}
+
+/**
+ * Creates an HTTP Response for Server-Sent Events (SSE) compatible with Next.js Route Handlers.
+ * Handles client registration, keep-alive pings, and resource cleanup on client disconnect.
+ *
+ * @param listener The active SseListener instance.
+ * @param req Optional incoming Request object to listen for connection aborts.
+ * @returns A Response object streaming SSE.
+ */
+declare function createSseHandler(listener: SseListener, req?: Request): Response;
+
+export { PostgresSseListener, type SseListener, type SseListenerEvents, createSseHandler };

package/dist/server.d.ts

@@ -0,0 +1,66 @@
+import { ClientConfig } from 'pg';
+
+declare class TypedEmitter<Events extends object> {
+    private emitter;
+    on<K extends keyof Events>(event: K, listener: (payload: Events[K]) => void): this;
+    once<K extends keyof Events>(event: K, listener: (payload: Events[K]) => void): this;
+    off<K extends keyof Events>(event: K, listener: (payload: Events[K]) => void): this;
+    emit<K extends keyof Events>(event: K, payload: Events[K]): boolean;
+    addListener<K extends keyof Events>(event: K, listener: (payload: Events[K]) => void): this;
+    removeListener<K extends keyof Events>(event: K, listener: (payload: Events[K]) => void): this;
+    removeAllListeners(event?: keyof Events): this;
+}
+
+interface SseListenerEvents {
+    connected: void;
+    error: Error;
+    reconnect: number;
+    notification: {
+        table: string;
+        action: "INSERT" | "UPDATE" | "DELETE";
+        id: string | number;
+        [key: string]: unknown;
+    };
+}
+interface SseListener {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    events: TypedEmitter<SseListenerEvents>;
+    getActiveConnections(): number;
+    registerClient(clientId: string, send: (data: string) => void): void;
+    unregisterClient(clientId: string): void;
+    broadcast(event: string, data: unknown): void;
+}
+declare class PostgresSseListener implements SseListener {
+    events: TypedEmitter<SseListenerEvents>;
+    private client;
+    private isConnected;
+    private isDisconnecting;
+    private retryCount;
+    private reconnectTimer;
+    private clients;
+    private readonly config;
+    private readonly channels;
+    constructor(config: ClientConfig | string, channels?: string | string[]);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    getActiveConnections(): number;
+    registerClient(clientId: string, send: (data: string) => void): void;
+    unregisterClient(clientId: string): void;
+    broadcast(event: string, data: unknown): void;
+    private handleConnectionError;
+    private scheduleReconnect;
+    private handleNotification;
+}
+
+/**
+ * Creates an HTTP Response for Server-Sent Events (SSE) compatible with Next.js Route Handlers.
+ * Handles client registration, keep-alive pings, and resource cleanup on client disconnect.
+ *
+ * @param listener The active SseListener instance.
+ * @param req Optional incoming Request object to listen for connection aborts.
+ * @returns A Response object streaming SSE.
+ */
+declare function createSseHandler(listener: SseListener, req?: Request): Response;
+
+export { PostgresSseListener, type SseListener, type SseListenerEvents, createSseHandler };

package/dist/server.js

@@ -0,0 +1,277 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/server/index.ts
+var server_exports = {};
+__export(server_exports, {
+  PostgresSseListener: () => PostgresSseListener,
+  createSseHandler: () => createSseHandler
+});
+module.exports = __toCommonJS(server_exports);
+
+// src/server/listener.ts
+var import_pg = require("pg");
+
+// src/shared/emitter.ts
+var import_events = require("events");
+var TypedEmitter = class {
+  emitter = new import_events.EventEmitter();
+  on(event, listener) {
+    this.emitter.on(event, listener);
+    return this;
+  }
+  once(event, listener) {
+    this.emitter.once(event, listener);
+    return this;
+  }
+  off(event, listener) {
+    this.emitter.off(event, listener);
+    return this;
+  }
+  emit(event, payload) {
+    return this.emitter.emit(event, payload);
+  }
+  addListener(event, listener) {
+    this.emitter.addListener(event, listener);
+    return this;
+  }
+  removeListener(event, listener) {
+    this.emitter.removeListener(event, listener);
+    return this;
+  }
+  removeAllListeners(event) {
+    this.emitter.removeAllListeners(event);
+    return this;
+  }
+};
+
+// src/server/listener.ts
+var PostgresSseListener = class {
+  events = new TypedEmitter();
+  client = null;
+  isConnected = false;
+  isDisconnecting = false;
+  retryCount = 0;
+  reconnectTimer = null;
+  // In-memory registry of active SSE clients
+  clients = /* @__PURE__ */ new Map();
+  config;
+  channels;
+  constructor(config, channels = "db_changes") {
+    this.config = config;
+    this.channels = Array.isArray(channels) ? channels : [channels];
+    const channelRegex = /^[a-zA-Z0-9_]+$/;
+    for (const channel of this.channels) {
+      if (!channelRegex.test(channel)) {
+        throw new Error(
+          `Invalid channel name: "${channel}". Channel names must be alphanumeric and underscores only.`
+        );
+      }
+    }
+  }
+  async connect() {
+    if (this.isConnected) return;
+    this.isDisconnecting = false;
+    try {
+      this.client = typeof this.config === "string" ? new import_pg.Client(this.config) : new import_pg.Client(this.config);
+      this.client.on("error", (err) => {
+        this.handleConnectionError(err);
+      });
+      this.client.on("notification", (msg) => {
+        this.handleNotification(msg);
+      });
+      await this.client.connect();
+      for (const channel of this.channels) {
+        await this.client.query(`LISTEN ${channel}`);
+      }
+      this.isConnected = true;
+      this.retryCount = 0;
+      this.events.emit("connected", void 0);
+    } catch (err) {
+      this.handleConnectionError(err);
+    }
+  }
+  async disconnect() {
+    this.isDisconnecting = true;
+    this.isConnected = false;
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = null;
+    }
+    if (this.client) {
+      try {
+        await this.client.end();
+      } catch (err) {
+      } finally {
+        this.client = null;
+      }
+    }
+  }
+  getActiveConnections() {
+    return this.clients.size;
+  }
+  registerClient(clientId, send) {
+    this.clients.set(clientId, send);
+  }
+  unregisterClient(clientId) {
+    this.clients.delete(clientId);
+  }
+  broadcast(event, data) {
+    const message = `event: ${event}
+data: ${JSON.stringify(data)}
+
+`;
+    for (const send of this.clients.values()) {
+      try {
+        send(message);
+      } catch (err) {
+      }
+    }
+  }
+  handleConnectionError(err) {
+    if (this.isDisconnecting) return;
+    this.isConnected = false;
+    this.events.emit("error", err);
+    if (this.client) {
+      this.client.end().catch(() => {
+      });
+      this.client = null;
+    }
+    this.scheduleReconnect();
+  }
+  scheduleReconnect() {
+    if (this.reconnectTimer) return;
+    this.retryCount++;
+    const delay = Math.min(1e3 * Math.pow(2, this.retryCount - 1), 3e4);
+    const jitter = Math.random() * 1e3;
+    const finalDelay = delay + jitter;
+    this.events.emit("reconnect", this.retryCount);
+    this.reconnectTimer = setTimeout(async () => {
+      this.reconnectTimer = null;
+      try {
+        await this.connect();
+      } catch (err) {
+      }
+    }, finalDelay);
+  }
+  handleNotification(msg) {
+    if (!msg.payload) return;
+    try {
+      let parsedPayload;
+      try {
+        parsedPayload = JSON.parse(msg.payload);
+      } catch (e) {
+        parsedPayload = msg.payload;
+      }
+      const isObjectPayload = typeof parsedPayload === "object" && parsedPayload !== null;
+      const payloadObj = isObjectPayload ? parsedPayload : null;
+      const eventPayload = payloadObj ? {
+        table: payloadObj.table || "unknown",
+        action: payloadObj.action || "INSERT",
+        id: payloadObj.id !== void 0 ? payloadObj.id : "",
+        ...payloadObj
+      } : {
+        table: "unknown",
+        action: "INSERT",
+        id: "",
+        data: parsedPayload
+      };
+      this.events.emit("notification", eventPayload);
+      this.broadcast("notification", eventPayload);
+    } catch (err) {
+      this.events.emit(
+        "error",
+        new Error(
+          `Failed to process notification payload: ${err.message}`
+        )
+      );
+    }
+  }
+};
+
+// src/server/handler.ts
+function createSseHandler(listener, req) {
+  const clientId = Math.random().toString(36).substring(2, 15);
+  const encoder = new TextEncoder();
+  const responseStream = new TransformStream();
+  const writer = responseStream.writable.getWriter();
+  let isCleanedUp = false;
+  function cleanup() {
+    if (isCleanedUp) return;
+    isCleanedUp = true;
+    clearInterval(keepAliveInterval);
+    listener.unregisterClient(clientId);
+    try {
+      writer.close();
+    } catch (err) {
+    }
+  }
+  function send(data) {
+    if (isCleanedUp) return;
+    writer.write(encoder.encode(data)).catch(() => {
+      cleanup();
+    });
+  }
+  listener.registerClient(clientId, send);
+  const keepAliveInterval = setInterval(() => {
+    if (isCleanedUp) return;
+    writer.write(encoder.encode(": keep-alive\n\n")).catch(() => {
+      cleanup();
+    });
+  }, 2e4);
+  const handshake = {
+    type: "handshake",
+    clientId,
+    activeConnections: listener.getActiveConnections()
+  };
+  writer.write(
+    encoder.encode(
+      `event: handshake
+data: ${JSON.stringify(handshake)}
+
+`
+    )
+  ).catch(() => {
+    cleanup();
+  });
+  if (req?.signal) {
+    if (req.signal.aborted) {
+      cleanup();
+    } else {
+      req.signal.addEventListener("abort", () => {
+        cleanup();
+      });
+    }
+  }
+  return new Response(responseStream.readable, {
+    headers: {
+      "Content-Type": "text/event-stream",
+      "Cache-Control": "no-cache, no-transform",
+      Connection: "keep-alive",
+      "X-Accel-Buffering": "no"
+      // Turn off buffering in Nginx/Vercel
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PostgresSseListener,
+  createSseHandler
+});
+//# sourceMappingURL=server.js.map