@korajs/server 0.1.0

package/dist/internal.js

@@ -0,0 +1,150 @@
+import "./chunk-DGUM43GV.js";
+
+// src/transport/memory-server-transport.ts
+var MemoryServerTransport = class {
+  connected = true;
+  messageHandler = null;
+  closeHandler = null;
+  errorHandler = null;
+  sentMessages = [];
+  sendToClient = null;
+  clientDisconnect = null;
+  /**
+   * Wire up the send-to-client function and client disconnect notifier.
+   * Called by createServerTransportPair.
+   */
+  _link(sendToClient, clientDisconnect) {
+    this.sendToClient = sendToClient;
+    this.clientDisconnect = clientDisconnect;
+  }
+  /**
+   * Deliver a message from the client side into this transport.
+   * Called by the linked client transport.
+   */
+  _receiveFromClient(message) {
+    this.messageHandler?.(message);
+  }
+  /**
+   * Notify this transport that the client disconnected.
+   */
+  _notifyClientDisconnected() {
+    if (!this.connected) return;
+    this.connected = false;
+    this.closeHandler?.(1e3, "client disconnected");
+  }
+  send(message) {
+    if (!this.connected) {
+      throw new Error("Cannot send message: server transport is not connected");
+    }
+    this.sentMessages.push(message);
+    this.sendToClient?.(message);
+  }
+  onMessage(handler) {
+    this.messageHandler = handler;
+  }
+  onClose(handler) {
+    this.closeHandler = handler;
+  }
+  onError(handler) {
+    this.errorHandler = handler;
+  }
+  isConnected() {
+    return this.connected;
+  }
+  close(code, reason) {
+    if (!this.connected) return;
+    this.connected = false;
+    this.clientDisconnect?.();
+  }
+  // --- Testing helpers ---
+  /** Get all messages sent through this transport. */
+  getSentMessages() {
+    return [...this.sentMessages];
+  }
+  /** Simulate a disconnect from the client side. */
+  simulateDisconnect() {
+    this._notifyClientDisconnected();
+  }
+};
+var MemoryClientTransport = class {
+  connected = true;
+  messageHandler = null;
+  closeHandler = null;
+  errorHandler = null;
+  sentMessages = [];
+  sendToServer = null;
+  serverNotifyDisconnect = null;
+  _link(sendToServer, serverNotifyDisconnect) {
+    this.sendToServer = sendToServer;
+    this.serverNotifyDisconnect = serverNotifyDisconnect;
+  }
+  _receiveFromServer(message) {
+    this.messageHandler?.(message);
+  }
+  _notifyServerDisconnected() {
+    if (!this.connected) return;
+    this.connected = false;
+    this.closeHandler?.("server disconnected");
+  }
+  async connect(_url) {
+    this.connected = true;
+  }
+  async disconnect() {
+    if (!this.connected) return;
+    this.connected = false;
+    this.serverNotifyDisconnect?.();
+  }
+  send(message) {
+    if (!this.connected) {
+      throw new Error("Cannot send message: client transport is not connected");
+    }
+    this.sentMessages.push(message);
+    this.sendToServer?.(message);
+  }
+  onMessage(handler) {
+    this.messageHandler = handler;
+  }
+  onClose(handler) {
+    this.closeHandler = handler;
+  }
+  onError(handler) {
+    this.errorHandler = handler;
+  }
+  isConnected() {
+    return this.connected;
+  }
+  getSentMessages() {
+    return [...this.sentMessages];
+  }
+  simulateIncoming(message) {
+    this.messageHandler?.(message);
+  }
+  simulateDisconnect(reason) {
+    this.connected = false;
+    this.closeHandler?.(reason);
+  }
+  simulateError(error) {
+    this.errorHandler?.(error);
+  }
+  clearSentMessages() {
+    this.sentMessages.length = 0;
+  }
+};
+function createServerTransportPair() {
+  const client = new MemoryClientTransport();
+  const server = new MemoryServerTransport();
+  client._link(
+    (msg) => server._receiveFromClient(msg),
+    () => server._notifyClientDisconnected()
+  );
+  server._link(
+    (msg) => client._receiveFromServer(msg),
+    () => client._notifyServerDisconnected()
+  );
+  return { client, server };
+}
+export {
+  MemoryServerTransport,
+  createServerTransportPair
+};
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport/memory-server-transport.ts"],"sourcesContent":["import type { SyncMessage } from '@korajs/sync'\nimport type {\n\tServerCloseHandler,\n\tServerErrorHandler,\n\tServerMessageHandler,\n\tServerTransport,\n} from './server-transport'\n\n/**\n * In-memory server transport for testing. Wraps the server side of a\n * MemoryTransport pair, adapting it to the ServerTransport interface.\n *\n * Messages sent through this transport arrive at the linked client MemoryTransport.\n */\nexport class MemoryServerTransport implements ServerTransport {\n\tprivate connected = true\n\tprivate messageHandler: ServerMessageHandler | null = null\n\tprivate closeHandler: ServerCloseHandler | null = null\n\tprivate errorHandler: ServerErrorHandler | null = null\n\tprivate readonly sentMessages: SyncMessage[] = []\n\tprivate sendToClient: ((message: SyncMessage) => void) | null = null\n\tprivate clientDisconnect: (() => void) | null = null\n\n\t/**\n\t * Wire up the send-to-client function and client disconnect notifier.\n\t * Called by createServerTransportPair.\n\t */\n\t_link(sendToClient: (message: SyncMessage) => void, clientDisconnect: () => void): void {\n\t\tthis.sendToClient = sendToClient\n\t\tthis.clientDisconnect = clientDisconnect\n\t}\n\n\t/**\n\t * Deliver a message from the client side into this transport.\n\t * Called by the linked client transport.\n\t */\n\t_receiveFromClient(message: SyncMessage): void {\n\t\tthis.messageHandler?.(message)\n\t}\n\n\t/**\n\t * Notify this transport that the client disconnected.\n\t */\n\t_notifyClientDisconnected(): void {\n\t\tif (!this.connected) return\n\t\tthis.connected = false\n\t\tthis.closeHandler?.(1000, 'client disconnected')\n\t}\n\n\tsend(message: SyncMessage): void {\n\t\tif (!this.connected) {\n\t\t\tthrow new Error('Cannot send message: server transport is not connected')\n\t\t}\n\t\tthis.sentMessages.push(message)\n\t\tthis.sendToClient?.(message)\n\t}\n\n\tonMessage(handler: ServerMessageHandler): void {\n\t\tthis.messageHandler = handler\n\t}\n\n\tonClose(handler: ServerCloseHandler): void {\n\t\tthis.closeHandler = handler\n\t}\n\n\tonError(handler: ServerErrorHandler): void {\n\t\tthis.errorHandler = handler\n\t}\n\n\tisConnected(): boolean {\n\t\treturn this.connected\n\t}\n\n\tclose(code?: number, reason?: string): void {\n\t\tif (!this.connected) return\n\t\tthis.connected = false\n\t\tthis.clientDisconnect?.()\n\t}\n\n\t// --- Testing helpers ---\n\n\t/** Get all messages sent through this transport. */\n\tgetSentMessages(): SyncMessage[] {\n\t\treturn [...this.sentMessages]\n\t}\n\n\t/** Simulate a disconnect from the client side. */\n\tsimulateDisconnect(): void {\n\t\tthis._notifyClientDisconnected()\n\t}\n}\n\n/**\n * Minimal client-side transport that pairs with MemoryServerTransport.\n * Implements the same interface shape as @korajs/sync MemoryTransport but\n * specifically designed for server testing without importing internal modules.\n */\nclass MemoryClientTransport {\n\tprivate connected = true\n\tprivate messageHandler: ((message: SyncMessage) => void) | null = null\n\tprivate closeHandler: ((reason: string) => void) | null = null\n\tprivate errorHandler: ((error: Error) => void) | null = null\n\tprivate readonly sentMessages: SyncMessage[] = []\n\tprivate sendToServer: ((message: SyncMessage) => void) | null = null\n\tprivate serverNotifyDisconnect: (() => void) | null = null\n\n\t_link(sendToServer: (message: SyncMessage) => void, serverNotifyDisconnect: () => void): void {\n\t\tthis.sendToServer = sendToServer\n\t\tthis.serverNotifyDisconnect = serverNotifyDisconnect\n\t}\n\n\t_receiveFromServer(message: SyncMessage): void {\n\t\tthis.messageHandler?.(message)\n\t}\n\n\t_notifyServerDisconnected(): void {\n\t\tif (!this.connected) return\n\t\tthis.connected = false\n\t\tthis.closeHandler?.('server disconnected')\n\t}\n\n\tasync connect(_url: string): Promise<void> {\n\t\tthis.connected = true\n\t}\n\n\tasync disconnect(): Promise<void> {\n\t\tif (!this.connected) return\n\t\tthis.connected = false\n\t\tthis.serverNotifyDisconnect?.()\n\t}\n\n\tsend(message: SyncMessage): void {\n\t\tif (!this.connected) {\n\t\t\tthrow new Error('Cannot send message: client transport is not connected')\n\t\t}\n\t\tthis.sentMessages.push(message)\n\t\tthis.sendToServer?.(message)\n\t}\n\n\tonMessage(handler: (message: SyncMessage) => void): void {\n\t\tthis.messageHandler = handler\n\t}\n\n\tonClose(handler: (reason: string) => void): void {\n\t\tthis.closeHandler = handler\n\t}\n\n\tonError(handler: (error: Error) => void): void {\n\t\tthis.errorHandler = handler\n\t}\n\n\tisConnected(): boolean {\n\t\treturn this.connected\n\t}\n\n\tgetSentMessages(): SyncMessage[] {\n\t\treturn [...this.sentMessages]\n\t}\n\n\tsimulateIncoming(message: SyncMessage): void {\n\t\tthis.messageHandler?.(message)\n\t}\n\n\tsimulateDisconnect(reason: string): void {\n\t\tthis.connected = false\n\t\tthis.closeHandler?.(reason)\n\t}\n\n\tsimulateError(error: Error): void {\n\t\tthis.errorHandler?.(error)\n\t}\n\n\tclearSentMessages(): void {\n\t\tthis.sentMessages.length = 0\n\t}\n}\n\n/**\n * Create a linked pair of memory transports for server testing.\n * Messages sent on `client` arrive at `server` and vice versa.\n * The client transport implements SyncTransport-compatible interface.\n */\nexport function createServerTransportPair(): {\n\tclient: MemoryClientTransport\n\tserver: MemoryServerTransport\n} {\n\tconst client = new MemoryClientTransport()\n\tconst server = new MemoryServerTransport()\n\n\t// Wire: client.send → server._receiveFromClient\n\t// Wire: server.send → client._receiveFromServer\n\tclient._link(\n\t\t(msg) => server._receiveFromClient(msg),\n\t\t() => server._notifyClientDisconnected(),\n\t)\n\tserver._link(\n\t\t(msg) => client._receiveFromServer(msg),\n\t\t() => client._notifyServerDisconnected(),\n\t)\n\n\treturn { client, server }\n}\n"],"mappings":"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","names":[]}

package/dist/server-transport-CU1BLWgr.d.cts

@@ -0,0 +1,35 @@
+import { SyncMessage } from '@korajs/sync';
+
+/**
+ * Handler for incoming sync messages on the server side.
+ */
+type ServerMessageHandler = (message: SyncMessage) => void;
+/**
+ * Handler for connection close events on the server side.
+ */
+type ServerCloseHandler = (code: number, reason: string) => void;
+/**
+ * Handler for transport errors on the server side.
+ */
+type ServerErrorHandler = (error: Error) => void;
+/**
+ * Server-side transport interface. Unlike SyncTransport (client-side),
+ * the server does not connect outward — it receives connections.
+ * Each ServerTransport represents one already-established client connection.
+ */
+interface ServerTransport {
+    /** Send a sync message to the connected client */
+    send(message: SyncMessage): void;
+    /** Register a handler for incoming messages from the client */
+    onMessage(handler: ServerMessageHandler): void;
+    /** Register a handler for connection close events */
+    onClose(handler: ServerCloseHandler): void;
+    /** Register a handler for transport errors */
+    onError(handler: ServerErrorHandler): void;
+    /** Returns true if the transport connection is active */
+    isConnected(): boolean;
+    /** Close the connection to the client */
+    close(code?: number, reason?: string): void;
+}
+
+export type { ServerTransport as S, ServerMessageHandler as a, ServerCloseHandler as b, ServerErrorHandler as c };

package/dist/server-transport-CU1BLWgr.d.ts

@@ -0,0 +1,35 @@
+import { SyncMessage } from '@korajs/sync';
+
+/**
+ * Handler for incoming sync messages on the server side.
+ */
+type ServerMessageHandler = (message: SyncMessage) => void;
+/**
+ * Handler for connection close events on the server side.
+ */
+type ServerCloseHandler = (code: number, reason: string) => void;
+/**
+ * Handler for transport errors on the server side.
+ */
+type ServerErrorHandler = (error: Error) => void;
+/**
+ * Server-side transport interface. Unlike SyncTransport (client-side),
+ * the server does not connect outward — it receives connections.
+ * Each ServerTransport represents one already-established client connection.
+ */
+interface ServerTransport {
+    /** Send a sync message to the connected client */
+    send(message: SyncMessage): void;
+    /** Register a handler for incoming messages from the client */
+    onMessage(handler: ServerMessageHandler): void;
+    /** Register a handler for connection close events */
+    onClose(handler: ServerCloseHandler): void;
+    /** Register a handler for transport errors */
+    onError(handler: ServerErrorHandler): void;
+    /** Returns true if the transport connection is active */
+    isConnected(): boolean;
+    /** Close the connection to the client */
+    close(code?: number, reason?: string): void;
+}
+
+export type { ServerTransport as S, ServerMessageHandler as a, ServerCloseHandler as b, ServerErrorHandler as c };

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@korajs/server",
+  "version": "0.1.0",
+  "description": "Kora.js self-hosted sync server",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./internal": {
+      "import": {
+        "types": "./dist/internal.d.ts",
+        "default": "./dist/internal.js"
+      },
+      "require": {
+        "types": "./dist/internal.d.cts",
+        "default": "./dist/internal.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "better-sqlite3": "^12.8.0",
+    "drizzle-orm": "^0.45.2",
+    "ws": "^8.18.0",
+    "@korajs/core": "0.1.0",
+    "@korajs/sync": "0.1.0"
+  },
+  "peerDependencies": {
+    "postgres": "^3.4.0"
+  },
+  "peerDependenciesMeta": {
+    "postgres": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@fast-check/vitest": "0.2.0",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/ws": "^8.5.13",
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.4"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src/",
+    "clean": "rm -rf dist .turbo coverage"
+  }
+}