@syncar/server 1.0.0-alpha.1 → 1.0.0-alpha.2

package/dist/index.d.ts

@@ -215,7 +215,7 @@ interface IClientConnection {
  * Message types for protocol communication
  *
  * @remarks
- * Enum defining all message types supported by the Synca protocol.
+ * Enum defining all message types supported by the Syncar protocol.
  *
  * @example
  * ```ts
@@ -309,7 +309,7 @@ declare enum ErrorCode {
  * Base message interface
  *
  * @remarks
- * All messages in the Synca protocol extend this interface with
+ * All messages in the Syncar protocol extend this interface with
  * common fields like ID, timestamp, and optional channel.
  *
  * @property id - Unique message identifier
@@ -549,7 +549,7 @@ type Message<T = unknown> = DataMessage<T> | SignalMessage | ErrorMessage | AckM
  *
  * @example
  * ```ts
- * import type { IMiddlewareAction } from '@synca/server'
+ * import type { IMiddlewareAction } from '@syncar/server'
  *
  * function handleAction(action: IMiddlewareAction) {
  *   switch (action) {
@@ -701,7 +701,7 @@ interface Context<S = Record<string, unknown>> {
  *
  * @example
  * ```ts
- * import type { Middleware } from '@synca/server'
+ * import type { Middleware } from '@syncar/server'
  *
  * const authMiddleware: Middleware = async (context, next) => {
  *   const token = context.req.message?.data?.token
@@ -1628,7 +1628,7 @@ type ServerInstance = WebSocketServer;
  *
  * @remarks
  * Configuration options for the WebSocket transport layer. Extends the
- * standard `ws` library options with Synca-specific settings.
+ * standard `ws` library options with Syncar-specific settings.
  *
  * @example
  * ```ts
@@ -1733,7 +1733,7 @@ interface WebSocketServerTransportConfig extends ServerOptions {
  * @example
  * ### Basic usage
  * ```ts
- * import { WebSocketServerTransport } from '@synca/server'
+ * import { WebSocketServerTransport } from '@syncar/server'
  *
  * const transport = new WebSocketServerTransport({
  *   server: httpServer,
@@ -1875,7 +1875,7 @@ declare class WebSocketServerTransport extends EventEmitter {
  *
  * @example
  * ```ts
- * const server = createSyncaServer({ port: 3000 })
+ * const server = createSyncarServer({ port: 3000 })
  * await server.start()
  *
  * const stats = server.getStats()
@@ -1899,15 +1899,15 @@ interface IServerStats {
  * Server configuration options
  *
  * @remarks
- * Complete configuration interface for the Synca server. These options
+ * Complete configuration interface for the Syncar server. These options
  * control the WebSocket transport layer, connection handling, middleware,
  * and performance tuning parameters.
  *
  * @example
  * ```ts
- * import { createSyncaServer } from '@synca/server'
+ * import { createSyncarServer } from '@syncar/server'
  *
- * const server = createSyncaServer({
+ * const server = createSyncarServer({
  *   port: 3000,
  *   host: '0.0.0.0',
  *   path: '/ws',
@@ -1970,7 +1970,7 @@ interface IServerOptions {
      */
     host: string;
     /**
-     * WebSocket path (default: '/synca')
+     * WebSocket path (default: '/syncar')
      *
      * @remarks
      * The URL path for WebSocket connections. Clients must connect to
@@ -2045,7 +2045,7 @@ interface IServerOptions {
     broadcastChunkSize: number;
 }
 /**
- * Synca Server - Real-time WebSocket server with pub/sub channels
+ * Syncar Server - Real-time WebSocket server with pub/sub channels
  *
  * @remarks
  * The main server class providing WebSocket communication with broadcast
@@ -2053,9 +2053,9 @@ interface IServerOptions {
  *
  * @example
  * ```ts
- * import { createSyncaServer } from '@synca/server'
+ * import { createSyncarServer } from '@syncar/server'
  *
- * const server = createSyncaServer({ port: 3000 })
+ * const server = createSyncarServer({ port: 3000 })
  * await server.start()
  *
  * // Create channels
@@ -2072,9 +2072,9 @@ interface IServerOptions {
  * chat.publish({ text: 'Welcome!' })
  * ```
  *
- * @see {@link createSyncaServer} for factory function
+ * @see {@link createSyncarServer} for factory function
  */
-declare class SyncaServer {
+declare class SyncarServer {
     private readonly config;
     private transport;
     readonly registry: ClientRegistry;
@@ -2096,7 +2096,7 @@ declare class SyncaServer {
      *
      * @example
      * ```ts
-     * const server = createSyncaServer({ port: 3000 })
+     * const server = createSyncarServer({ port: 3000 })
      * await server.start()
      * console.log('Server is running')
      * ```
@@ -2232,7 +2232,7 @@ declare class SyncaServer {
      *
      * @example
      * ```ts
-     * import { createAuthMiddleware } from '@synca/server'
+     * import { createAuthMiddleware } from '@syncar/server'
      *
      * server.use(createAuthMiddleware({
      *   verifyToken: async (token) => jwt.verify(token, SECRET)
@@ -2324,31 +2324,31 @@ declare class SyncaServer {
     private setupTransportHandlers;
 }
 /**
- * Create a Synca server with automatic WebSocket transport setup
+ * Create a Syncar server with automatic WebSocket transport setup
  *
  * @remarks
- * Factory function that creates a configured SyncaServer instance.
+ * Factory function that creates a configured SyncarServer instance.
  * Automatically sets up the WebSocket transport layer if not provided,
  * merges user configuration with defaults, and creates the client registry.
  *
  * @param config - Optional partial server configuration. All properties are optional
  * and will be merged with {@link DEFAULT_SERVER_CONFIG}.
  *
- * @returns Configured Synca server instance ready to be started
+ * @returns Configured Syncar server instance ready to be started
  *
  * @example
  * ### Basic usage
  * ```ts
- * import { createSyncaServer } from '@synca/server'
+ * import { createSyncarServer } from '@syncar/server'
  *
- * const server = createSyncaServer({ port: 3000 })
+ * const server = createSyncarServer({ port: 3000 })
  * await server.start()
  * ```
  *
  * @example
  * ### With custom configuration
  * ```ts
- * const server = createSyncaServer({
+ * const server = createSyncarServer({
  *   port: 8080,
  *   host: 'localhost',
  *   path: '/ws',
@@ -2364,14 +2364,14 @@ declare class SyncaServer {
  * ### With existing HTTP server
  * ```ts
  * import { createServer } from 'node:http'
- * import { createSyncaServer } from '@synca/server'
+ * import { createSyncarServer } from '@syncar/server'
  *
  * const httpServer = createServer((req, res) => {
  *   res.writeHead(200)
  *   res.end('OK')
  * })
  *
- * const server = createSyncaServer({
+ * const server = createSyncarServer({
  *   server: httpServer,
  *   path: '/ws',
  * })
@@ -2383,12 +2383,12 @@ declare class SyncaServer {
  * ### With Express
  * ```ts
  * import express from 'express'
- * import { createSyncaServer } from '@synca/server'
+ * import { createSyncarServer } from '@syncar/server'
  *
  * const app = express()
  * const httpServer = app.listen(3000)
  *
- * const server = createSyncaServer({
+ * const server = createSyncarServer({
  *   server: httpServer,
  *   path: '/ws',
  * })
@@ -2399,9 +2399,9 @@ declare class SyncaServer {
  * @example
  * ### With custom logger
  * ```ts
- * import { createSyncaServer } from '@synca/server'
+ * import { createSyncarServer } from '@syncar/server'
  *
- * const server = createSyncaServer({
+ * const server = createSyncarServer({
  *   port: 3000,
  *   logger: {
  *     debug: (msg, ...args) => console.debug('[DEBUG]', msg, ...args),
@@ -2415,9 +2415,9 @@ declare class SyncaServer {
  * @example
  * ### With middleware
  * ```ts
- * import { createSyncaServer, createLoggingMiddleware } from '@synca/server'
+ * import { createSyncarServer, createLoggingMiddleware } from '@syncar/server'
  *
- * const server = createSyncaServer({
+ * const server = createSyncarServer({
  *   port: 3000,
  *   middleware: [
  *     createLoggingMiddleware(),
@@ -2427,10 +2427,10 @@ declare class SyncaServer {
  * await server.start()
  * ```
  *
- * @see {@link SyncaServer} for server class API
+ * @see {@link SyncarServer} for server class API
  * @see {@link DEFAULT_SERVER_CONFIG} for default configuration values
  */
-declare function createSyncaServer(config?: Partial<IServerOptions>): SyncaServer;
+declare function createSyncarServer(config?: Partial<IServerOptions>): SyncarServer;
 
 /**
  * Middleware Factories
@@ -2496,7 +2496,7 @@ interface AuthMiddlewareOptions {
  *
  * @example
  * ```ts
- * import { createAuthMiddleware } from '@synca/server/middleware'
+ * import { createAuthMiddleware } from '@syncar/server/middleware'
  *
  * const authMiddleware = createAuthMiddleware({
  *   verifyToken: async (token) => {
@@ -2568,7 +2568,7 @@ interface LoggingMiddlewareOptions {
  *
  * @example
  * ```ts
- * import { createLoggingMiddleware } from '@synca/server/middleware'
+ * import { createLoggingMiddleware } from '@syncar/server/middleware'
  *
  * const loggingMiddleware = createLoggingMiddleware({
  *   logger: console,
@@ -2627,7 +2627,7 @@ interface RateLimitMiddlewareOptions {
  *
  * @example
  * ```ts
- * import { createRateLimitMiddleware } from '@synca/server/middleware'
+ * import { createRateLimitMiddleware } from '@syncar/server/middleware'
  *
  * const rateLimitMiddleware = createRateLimitMiddleware({
  *   maxRequests: 100,
@@ -2688,7 +2688,7 @@ interface ChannelWhitelistMiddlewareOptions {
  *
  * @example
  * ```ts
- * import { createChannelWhitelistMiddleware } from '@synca/server/middleware'
+ * import { createChannelWhitelistMiddleware } from '@syncar/server/middleware'
  *
  * const whitelistMiddleware = createChannelWhitelistMiddleware({
  *   allowedChannels: ['chat', 'notifications']
@@ -2737,7 +2737,7 @@ interface ContextOptions<S = Record<string, unknown>> {
     initialState?: S;
 }
 /**
- * Create a new Hono-style middleware context
+ * Create onion pattern middleware context
  *
  * @remarks
  * Creates a lightweight middleware context using closures to ensure properties
@@ -2800,7 +2800,7 @@ declare function createContext<S = Record<string, unknown>>(options: ContextOpti
  *
  * @example
  * ```ts
- * import { ContextManager } from '@synca/server'
+ * import { ContextManager } from '@syncar/server'
  *
  * const manager = new ContextManager()
  *
@@ -2814,7 +2814,7 @@ declare function createContext<S = Record<string, unknown>>(options: ContextOpti
  * const context = await manager.executeConnection(client, 'connect')
  * ```
  *
- * @see {@link createSyncaServer} for server-level context management
+ * @see {@link createSyncarServer} for server-level context management
  */
 declare class ContextManager {
     /** Registered middleware functions */
@@ -3120,13 +3120,13 @@ declare class ContextManager {
  * Errors Module
  *
  * @description
- * Custom error classes for the Synca server. All errors extend from
- * {@link SyncaError} and include error codes for programmatic handling.
+ * Custom error classes for the Syncar server. All errors extend from
+ * {@link SyncarError} and include error codes for programmatic handling.
  *
  * @remarks
  * The error hierarchy:
  *
- * - {@link SyncaError} - Base error class
+ * - {@link SyncarError} - Base error class
  *   - {@link ConfigError} - Server configuration issues
  *   - {@link TransportError} - WebSocket transport issues
  *   - {@link ChannelError} - Channel operation failures
@@ -3140,7 +3140,7 @@ declare class ContextManager {
  * @example
  * ### Throwing errors
  * ```ts
- * import { StateError, ValidationError } from '@synca/server'
+ * import { StateError, ValidationError } from '@syncar/server'
  *
  * function createChannel(name: string) {
  *   if (!name) {
@@ -3156,10 +3156,10 @@ declare class ContextManager {
  * ### Catching errors
  * ```ts
  * import {
- *   SyncaError,
+ *   SyncarError,
  *   MiddlewareRejectionError,
  *   StateError
- * } from '@synca/server'
+ * } from '@syncar/server'
  *
  * try {
  *   await server.start()
@@ -3168,7 +3168,7 @@ declare class ContextManager {
  *     console.error('Invalid state:', error.message)
  *   } else if (error instanceof MiddlewareRejectionError) {
  *     console.error(`Action rejected: ${error.reason}`)
- *   } else if (error instanceof SyncaError) {
+ *   } else if (error instanceof SyncarError) {
  *     console.error(`[${error.code}] ${error.message}`)
  *   }
  * }
@@ -3178,10 +3178,10 @@ declare class ContextManager {
  */
 
 /**
- * Base Synca error class
+ * Base Syncar error class
  *
  * @remarks
- * All custom errors in the Synca server extend this class. Provides
+ * All custom errors in the Syncar server extend this class. Provides
  * consistent error handling with error codes, context, and serialization.
  *
  * @property code - Error code for programmatic handling
@@ -3189,7 +3189,7 @@ declare class ContextManager {
  *
  * @example
  * ```ts
- * throw new SyncaError('Something went wrong', 'CUSTOM_ERROR', { userId: '123' })
+ * throw new SyncarError('Something went wrong', 'CUSTOM_ERROR', { userId: '123' })
  * ```
  *
  * @example
@@ -3198,7 +3198,7 @@ declare class ContextManager {
  * try {
  *   // ...
  * } catch (error) {
- *   if (error instanceof SyncaError) {
+ *   if (error instanceof SyncarError) {
  *     console.log(error.code)        // 'CUSTOM_ERROR'
  *     console.log(error.message)     // 'Something went wrong'
  *     console.log(error.context)     // { userId: '123' }
@@ -3207,7 +3207,7 @@ declare class ContextManager {
  * }
  * ```
  */
-declare class SyncaError extends Error {
+declare class SyncarError extends Error {
     /**
      * Error code for programmatic error handling
      *
@@ -3225,7 +3225,7 @@ declare class SyncaError extends Error {
      */
     readonly context?: Record<string, unknown>;
     /**
-     * Creates a new SyncaError
+     * Creates a new SyncarError
      *
      * @param message - Human-readable error message
      * @param code - Error code for programmatic handling (default: 'SYNNEL_ERROR')
@@ -3239,10 +3239,10 @@ declare class SyncaError extends Error {
      *
      * @example
      * ```ts
-     * const error = new SyncaError('Failed', 'FAIL', { id: 123 })
+     * const error = new SyncarError('Failed', 'FAIL', { id: 123 })
      * console.log(JSON.stringify(error.toJSON(), null, 2))
      * // {
-     * //   "name": "SyncaError",
+     * //   "name": "SyncarError",
      * //   "message": "Failed",
      * //   "code": "FAIL",
      * //   "context": { "id": 123 },
@@ -3264,9 +3264,9 @@ declare class SyncaError extends Error {
      *
      * @example
      * ```ts
-     * const error = new SyncaError('Failed', 'FAIL')
+     * const error = new SyncarError('Failed', 'FAIL')
      * console.log(error.toString())
-     * // "[SyncaError:FAIL] Failed"
+     * // "[SyncarError:FAIL] Failed"
      * ```
      */
     toString(): string;
@@ -3284,7 +3284,7 @@ declare class SyncaError extends Error {
  * }
  * ```
  */
-declare class ConfigError extends SyncaError {
+declare class ConfigError extends SyncarError {
     constructor(message: string, context?: Record<string, unknown>);
 }
 /**
@@ -3300,7 +3300,7 @@ declare class ConfigError extends SyncaError {
  * }
  * ```
  */
-declare class TransportError extends SyncaError {
+declare class TransportError extends SyncarError {
     constructor(message: string, context?: Record<string, unknown>);
 }
 /**
@@ -3316,7 +3316,7 @@ declare class TransportError extends SyncaError {
  * }
  * ```
  */
-declare class ChannelError extends SyncaError {
+declare class ChannelError extends SyncarError {
     constructor(message: string, context?: Record<string, unknown>);
 }
 /**
@@ -3332,7 +3332,7 @@ declare class ChannelError extends SyncaError {
  * }
  * ```
  */
-declare class ClientError extends SyncaError {
+declare class ClientError extends SyncarError {
     constructor(message: string, context?: Record<string, unknown>);
 }
 /**
@@ -3348,7 +3348,7 @@ declare class ClientError extends SyncaError {
  * }
  * ```
  */
-declare class MessageError extends SyncaError {
+declare class MessageError extends SyncarError {
     constructor(message: string, context?: Record<string, unknown>);
 }
 /**
@@ -3364,7 +3364,7 @@ declare class MessageError extends SyncaError {
  * }
  * ```
  */
-declare class ValidationError extends SyncaError {
+declare class ValidationError extends SyncarError {
     constructor(message: string, context?: Record<string, unknown>);
 }
 /**
@@ -3384,7 +3384,7 @@ declare class ValidationError extends SyncaError {
  * }
  * ```
  */
-declare class StateError extends SyncaError {
+declare class StateError extends SyncarError {
     constructor(message: string, context?: Record<string, unknown>);
 }
 /**
@@ -3599,4 +3599,4 @@ declare class MiddlewareExecutionError extends Error {
     toString(): string;
 }
 
-export { type AckMessage, BROADCAST_CHANNEL, BroadcastChannel, CLOSE_CODES, ChannelError, type ChannelName, ClientError, type ClientId, ConfigError, type Context, ContextManager, type DataMessage, ERROR_CODES, ErrorCode, type ErrorMessage, type IChannelState, type IClientConnection, type IMessageHandler, type IPublishOptions, type IServerOptions, type IServerStats, type Message, MessageError, type MessageId, MessageType, type Middleware, MiddlewareExecutionError, MiddlewareRejectionError, MulticastChannel, type SignalMessage, SignalType, StateError, type SubscriberId, SyncaServer as Synca, SyncaError, SyncaServer, type Timestamp, TransportError, ValidationError, WebSocketServerTransport, createAuthMiddleware, createChannelWhitelistMiddleware, createContext, createLoggingMiddleware, createRateLimitMiddleware, createSyncaServer };
+export { type AckMessage, BROADCAST_CHANNEL, BroadcastChannel, CLOSE_CODES, ChannelError, type ChannelName, ClientError, type ClientId, ConfigError, type Context, ContextManager, type DataMessage, ERROR_CODES, ErrorCode, type ErrorMessage, type IChannelState, type IClientConnection, type IMessageHandler, type IPublishOptions, type IServerOptions, type IServerStats, type Message, MessageError, type MessageId, MessageType, type Middleware, MiddlewareExecutionError, MiddlewareRejectionError, MulticastChannel, type SignalMessage, SignalType, StateError, type SubscriberId, SyncarServer as Syncar, SyncarError, SyncarServer, type Timestamp, TransportError, ValidationError, WebSocketServerTransport, createAuthMiddleware, createChannelWhitelistMiddleware, createContext, createLoggingMiddleware, createRateLimitMiddleware, createSyncarServer };

package/dist/index.js

@@ -1,2 +1,2 @@
-function V(){return`${Date.now()}-${Math.random().toString(36).substring(2,11)}`}function z(){return`client-${Date.now()}-${Math.random().toString(36).substring(2,9)}`}var K=1,j=128,J="__";function ie(i){return typeof i=="string"&&i.length>=K&&i.length<=j}function L(i){return i.startsWith(J)}function f(i){if(!ie(i))throw new Error(`Invalid channel name: must be between ${K} and ${j} characters`);if(L(i))throw new Error(`Reserved channel name: channel names starting with '${J}' are reserved for system use`)}function P(i){return i.type==="data"}function Y(i,e,t){return{id:t||V(),type:"data",channel:i,data:e,timestamp:Date.now()}}function O(i,e,t,n){return{id:n||V(),type:"signal",channel:i,signal:e,data:t,timestamp:Date.now()}}var oe={info:"INFO",warn:"WARN",error:"ERROR",debug:"DEBUG"};function ae(){return new Date().toISOString()}function X(i="Synca",e={}){let t={debug:!1,info:!0,warn:!0,error:!0,...e},n=(r,s)=>{let o=ae();return`[${i} ${o}] [${oe[r]}] ${s}`};return{debug:(r,...s)=>{t.debug&&console.log(n("debug",r),...s)},info:(r,...s)=>{t.info&&console.log(n("info",r),...s)},warn:(r,...s)=>{t.warn&&console.warn(n("warn",r),...s)},error:(r,...s)=>{t.error&&console.error(n("error",r),...s)}}}var y="__broadcast__",H={NORMAL:1e3,GOING_AWAY:1001,PROTOCOL_ERROR:1002,UNSUPPORTED_DATA:1003,NO_STATUS:1005,ABNORMAL:1006,INVALID_PAYLOAD:1007,POLICY_VIOLATION:1008,MESSAGE_TOO_BIG:1009,MISSING_EXTENSION:1010,INTERNAL_ERROR:1011,SERVICE_RESTART:1012,TRY_AGAIN_LATER:1013,REJECTED:4001,RATE_LIMITED:4002,CHANNEL_NOT_FOUND:4003,UNAUTHORIZED:4005},ce={REJECTED:"REJECTED",MISSING_CHANNEL:"MISSING_CHANNEL",SUBSCRIBE_REJECTED:"SUBSCRIBE_REJECTED",UNSUBSCRIBE_REJECTED:"UNSUBSCRIBE_REJECTED",RATE_LIMITED:"RATE_LIMITED",AUTH_FAILED:"AUTH_FAILED",NOT_AUTHORIZED:"NOT_AUTHORIZED",CHANNEL_NOT_ALLOWED:"CHANNEL_NOT_ALLOWED",INVALID_MESSAGE:"INVALID_MESSAGE",SERVER_ERROR:"SERVER_ERROR"},Z="/synca",D=1048576,U=3e4,B=5e3,le=3e3,de="0.0.0.0",ge="/synca",he=!0,Q={port:le,host:de,path:ge,enablePing:he,pingInterval:U,pingTimeout:B,broadcastChunkSize:500};var k=class{constructor(e,t,n=500){this.name=e;this.registry=t;this.chunkSize=n}publish(e,t){let n=this.getTargetClients(t);n.length>this.chunkSize?this.publishInChunks(e,n,t):this.publishToClients(e,n,t)}async dispatch(e,t,n){}publishToClients(e,t,n){let r=Y(this.name,e);for(let s of t){if(n?.to&&!n.to.includes(s)||n?.exclude&&n.exclude.includes(s))continue;let o=this.registry.connections.get(s);if(o)try{o.socket.send(JSON.stringify(r))}catch(a){this.registry.logger?.error(`[${this.name}] Failed to send to ${s}:`,a)}}}publishInChunks(e,t,n){let r=0,s=()=>{let o=t.slice(r,r+this.chunkSize);o.length!==0&&(this.publishToClients(e,o,n),r+=this.chunkSize,r<t.length&&setImmediate(s))};s()}},w=class extends k{constructor(e,t=500){super(y,e,t)}getTargetClients(e){return Array.from(this.registry.connections.keys())}get subscriberCount(){return this.registry.connections.size}isEmpty(){return this.registry.connections.size===0}getMiddlewares(){return[]}},E=class extends k{constructor(t){f(t.name);super(t.name,t.registry,t.options?.chunkSize);this.middlewares=[];this.messageHandlers=new Set}getTargetClients(t){return Array.from(this.registry.getChannelSubscribers(this.name))}use(t){this.middlewares.push(t)}getMiddlewares(){return[...this.middlewares]}get subscriberCount(){return this.registry.getChannelSubscribers(this.name).size}onMessage(t){return this.messageHandlers.add(t),()=>this.messageHandlers.delete(t)}subscribe(t){return this.registry.subscribe(t,this.name)}unsubscribe(t){return this.registry.unsubscribe(t,this.name)}async dispatch(t,n,r){if(this.messageHandlers.size>0)for(let s of this.messageHandlers)try{await s(t,n,r)}catch(o){this.registry.logger?.error(`[${this.name}] Error in message handler:`,o)}else this.publish(t,{exclude:[n.id]})}hasSubscriber(t){return this.registry.getChannelSubscribers(this.name).has(t)}getSubscribers(){return new Set(this.registry.getChannelSubscribers(this.name))}isEmpty(){return this.registry.getChannelSubscribers(this.name).size===0}};var g=class i extends Error{constructor(e,t="SYNNEL_ERROR",n){super(e),this.name="SyncaError",this.code=t,this.context=n,Error.captureStackTrace&&Error.captureStackTrace(this,i)}toJSON(){return{name:this.name,message:this.message,code:this.code,context:this.context,stack:this.stack}}toString(){return`[${this.name}:${this.code}] ${this.message}`}},G=class extends g{constructor(e,t){super(e,"CONFIG_ERROR",t),this.name="ConfigError"}},$=class extends g{constructor(e,t){super(e,"TRANSPORT_ERROR",t),this.name="TransportError"}},h=class extends g{constructor(e,t){super(e,"CHANNEL_ERROR",t),this.name="ChannelError"}},q=class extends g{constructor(e,t){super(e,"CLIENT_ERROR",t),this.name="ClientError"}},u=class extends g{constructor(e,t){super(e,"MESSAGE_ERROR",t),this.name="MessageError"}},F=class extends g{constructor(e,t){super(e,"VALIDATION_ERROR",t),this.name="ValidationError"}},p=class extends g{constructor(e,t){super(e,"STATE_ERROR",t),this.name="StateError"}},S=class i extends Error{constructor(t,n,r,s){super(`Action '${n}' rejected: ${t}`);this.name="MiddlewareRejectionError";this.reason=t,this.action=n,this.name="MiddlewareRejectionError",this.code=r,this.context=s,Error.captureStackTrace&&Error.captureStackTrace(this,i)}toJSON(){return{name:this.name,reason:this.reason,action:this.action,code:this.code,context:this.context,message:this.message,stack:this.stack}}toString(){return`[${this.name}:${this.action}] ${this.reason}`}},I=class i extends Error{constructor(e,t,n){super(`Middleware execution error in ${t} during ${e}: ${n.message}`),this.name="MiddlewareExecutionError",this.action=e,this.middleware=t,this.cause=n,Error.captureStackTrace&&Error.captureStackTrace(this,i)}getCause(){return this.cause}toString(){return`[${this.name}] ${this.middleware} failed during ${this.action}: ${this.cause.message}`}};var x=class{constructor(e){this.registry=e.registry,this.context=e.context,this.options={requireChannel:e.options?.requireChannel??!1,allowReservedChannels:e.options?.allowReservedChannels??!1,sendAcknowledgments:e.options?.sendAcknowledgments??!0,autoRespondToPing:e.options?.autoRespondToPing??!0}}async handleSignal(e,t){let n;t.signal==="subscribe"?n=this.context.createSubscribeContext(e,t.channel):t.signal==="unsubscribe"?n=this.context.createUnsubscribeContext(e,t.channel):n=this.context.createMessageContext(e,t);let r=async()=>{switch(t.signal){case"subscribe":await this.handleSubscribe(e,t);break;case"unsubscribe":await this.handleUnsubscribe(e,t);break;case"ping":await this.handlePing(e,t);break;case"pong":await this.handlePong(e,t);break;default:throw new u(`Unknown signal type: ${t.signal}`)}},s;t.channel&&t.channel!==y&&(s=this.registry.getChannel(t.channel));let o=this.context.getPipeline(s);await this.context.execute(n,o,r)}async handleSubscribe(e,t){let{channel:n}=t;if(!this.options.allowReservedChannels&&L(n))throw new h(`Cannot subscribe to reserved channel: ${n}`);if(n===y)throw new h("Cannot subscribe to broadcast channel");if(!this.registry.subscribe(e.id,n))throw new h(`Failed to subscribe client ${e.id} to channel ${n}`);if(this.options.sendAcknowledgments){let s=O(n,"subscribed",void 0,t.id);e.socket.send(JSON.stringify(s),()=>{})}}async handleUnsubscribe(e,t){let{channel:n}=t;if(!this.registry.isSubscribed(e.id,n))throw new h(`Client not subscribed to channel: ${n}`);if(this.registry.unsubscribe(e.id,n),this.options.sendAcknowledgments){let r=O(n,"unsubscribed",void 0,t.id);e.socket.send(JSON.stringify(r),()=>{})}}async handlePing(e,t){if(e.lastPingAt=Date.now(),this.options.autoRespondToPing){let n=O(t.channel,"pong",void 0,t.id);e.socket.send(JSON.stringify(n),()=>{})}}async handlePong(e,t){e.lastPingAt=Date.now()}getOptions(){return this.options}};var M=class{constructor(e){this.registry=e.registry,this.context=e.context,this.options={requireChannel:e.options?.requireChannel??!0}}async handleMessage(e,t){if(!P(t))throw new u("Invalid message type: expected DATA message");let n=this.registry.getChannel(t.channel);if(this.options.requireChannel&&!n)throw new h(`Channel not found: ${t.channel}`);let r=this.context.getPipeline(n),s=this.context.createMessageContext(e,t),o=async()=>{n&&await n.dispatch(t.data,e,t)};await this.context.execute(s,r,o)}canProcessMessage(e){return P(e)?this.options.requireChannel?!!this.registry.getChannel(e.channel):!0:!1}getChannelForMessage(e){return this.registry.getChannel(e.channel)}getOptions(){return this.options}};var T=class{constructor(e){this.registry=e.registry,this.options={rejectionCloseCode:e.options?.rejectionCloseCode??H.REJECTED}}async handleConnection(e){return this.registry.register(e)}async handleDisconnection(e,t){this.registry.get(e)&&this.registry.unregister(e)}getOptions(){return this.options}};var ee=i=>(e,t)=>{let n=-1,r=async s=>{if(s<=n)throw new Error("next() called multiple times");n=s;let o,a=i[s];if(a)o=await a(e,async()=>{await r(s+1)});else if(s===i.length&&t)o=await t();else return e;return o!==void 0&&!e.finalized&&(e.res=o,e.finalized=!0),e};return r(0)};function R(i){let{action:e,client:t,message:n,channel:r,initialState:s={}}=i,o=s;return{req:{action:e,client:t,message:n,channel:r},var:o,finalized:!1,get:a=>o[a],set:(a,c)=>{o[a]=c},reject:a=>{throw new S(a,e)}}}var A=class{constructor(){this.middlewares=[]}use(e){this.middlewares.push(e)}remove(e){let t=this.middlewares.indexOf(e);return t!==-1?(this.middlewares.splice(t,1),!0):!1}clear(){this.middlewares.length=0}getMiddlewares(){return[...this.middlewares]}getPipeline(e){let t=this.getMiddlewares(),n=e?.getMiddlewares?.();return n&&n.length>0&&(t=[...t,...n]),t}async executeConnection(e,t){let n=this.createConnectionContext(e,t);return await this.execute(n)}async executeMessage(e,t){let n=this.createMessageContext(e,t);return await this.execute(n)}async executeSubscribe(e,t,n){let r=this.createSubscribeContext(e,t);return await this.execute(r,this.middlewares,n)}async executeUnsubscribe(e,t,n){let r=this.createUnsubscribeContext(e,t);return await this.execute(r,this.middlewares,n)}async execute(e,t=this.middlewares,n){let r=e.req.action||"unknown",s=t.map((o,a)=>async(c,d)=>{try{await o(c,d)}catch(l){if(l instanceof S||l instanceof I)throw l;let m=o.name||`middleware[${a}]`;throw new I(r,m,l instanceof Error?l:new Error(String(l)))}});return await ee(s)(e,n)}createConnectionContext(e,t){return R({client:e,action:t})}createMessageContext(e,t){return R({client:e,message:t,action:"message"})}createSubscribeContext(e,t){return R({client:e,channel:t,action:"subscribe"})}createUnsubscribeContext(e,t){return R({client:e,channel:t,action:"unsubscribe"})}getCount(){return this.middlewares.length}hasMiddleware(){return this.middlewares.length>0}};var _=class{constructor(e){this.connections=new Map;this.subscriptions=new Map;this.channels=new Map;this.channelInstances=new Map;this.logger=e}register(e){return this.connections.set(e.id,e),e}unregister(e){let t=this.get(e);return t?(this.clearSubscriptions(t),this.connections.delete(e)):!1}clearSubscriptions(e){let t=this.subscriptions.get(e.id);if(t){for(let n of t)this.channels.get(n)?.delete(e.id);this.subscriptions.delete(e.id)}}get(e){return this.connections.get(e)}getAll(){return Array.from(this.connections.values())}getCount(){return this.connections.size}registerChannel(e){this.channels.has(e.name)||this.channels.set(e.name,new Set),this.channelInstances.set(e.name,e)}getChannel(e){return this.channelInstances.get(e)}removeChannel(e){let t=this.channels.get(e);if(!t)return!1;for(let n of t){let r=this.subscriptions.get(n);r&&r.delete(e)}return this.channelInstances.delete(e),this.channels.delete(e)}subscribe(e,t){if(f(t),!this.connections.has(e))return!1;this.channels.has(t)||this.channels.set(t,new Set);let n=this.channels.get(t);return n.has(e)||(n.add(e),this.subscriptions.has(e)||this.subscriptions.set(e,new Set),this.subscriptions.get(e).add(t)),!0}unsubscribe(e,t){let n=this.channels.get(t);if(!n||!n.has(e))return!1;n.delete(e);let r=this.subscriptions.get(e);return r&&(r.delete(t),r.size===0&&this.subscriptions.delete(e)),!0}getSubscribers(e){let t=this.channels.get(e);if(!t)return[];let n=[];for(let r of t){let s=this.connections.get(r);s&&n.push(s)}return n}getSubscriberCount(e){return this.channels.get(e)?.size??0}getChannels(){return Array.from(this.channels.keys())}getTotalSubscriptionCount(){let e=0;for(let t of this.channels.values())e+=t.size;return e}isSubscribed(e,t){return this.channels.get(t)?.has(e)??!1}getClientChannels(e){return this.subscriptions.get(e)??new Set}getChannelSubscribers(e){return this.channels.get(e)??new Set}clear(){this.connections.clear(),this.subscriptions.clear(),this.channels.clear(),this.channelInstances.clear()}};import{EventEmitter as pe}from"events";import{WebSocketServer as Ce}from"ws";var v=class extends pe{constructor(e){super(),this.setMaxListeners(100),this.connections=e.connections??new Map,this.config={...e,path:e.path??Z,maxPayload:e.maxPayload??D,enablePing:e.enablePing??!0,pingInterval:e.pingInterval??U,pingTimeout:e.pingTimeout??B,connections:this.connections};let t=e.ServerConstructor??Ce;this.wsServer=new t({server:this.config.server,path:this.config.path,maxPayload:this.config.maxPayload}),this.setupEventHandlers(),this.config.enablePing&&this.startPingTimer()}setAuthenticator(e){this.authenticator=e}setupEventHandlers(){this.wsServer.on("connection",(e,t)=>{this.handleConnection(e,t)}),this.wsServer.on("error",e=>{this.config.logger?.error("WebSocket Server Error:",e),this.emit("error",e)})}async handleConnection(e,t){let n;try{this.authenticator?n=await this.authenticator(t):this.config.generateId?n=await this.config.generateId(t):n=z()}catch(o){try{e.close(4001,o instanceof Error?o.message:"Unauthorized")}catch{}return}let r=Date.now(),s={socket:e,id:n,connectedAt:r,lastPingAt:r};this.connections.set(n,s),e.on("message",o=>{this.handleMessage(n,o)}),e.on("close",(o,a)=>{this.handleDisconnection(n)}),e.on("error",o=>{this.emit("error",o)}),this.config.enablePing&&this.setupPingPong(n,e),this.emit("connection",s)}handleMessage(e,t){try{let n=JSON.parse(t.toString()),r=this.connections.get(e);r&&n.type==="signal"&&n.signal==="pong"&&(r.lastPingAt=Date.now()),this.emit("message",e,n)}catch(n){this.config.logger?.error(`Failed to parse message from ${e}:`,n),this.emit("error",n)}}handleDisconnection(e){this.emit("disconnection",e),this.connections.delete(e)}setupPingPong(e,t){t.on("pong",()=>{let n=this.connections.get(e);n&&(n.lastPingAt=Date.now())})}startPingTimer(){this.pingTimer&&clearInterval(this.pingTimer),this.pingTimer=setInterval(()=>{this.checkConnections()},this.config.pingInterval)}checkConnections(){let e=Date.now(),t=Array.from(this.connections.values());for(let n of t){let r=n.socket,s=n.lastPingAt??n.connectedAt;if(e-s>this.config.pingInterval+this.config.pingTimeout){r.close(1e3,"Ping timeout");continue}r.readyState===1&&r.ping()}}};var N=class{constructor(e){this.status={started:!1,startedAt:void 0};if(this.config=e,this.registry=this.config.registry,this.context=new A,this.config.middleware)for(let t of this.config.middleware)this.context.use(t)}async start(){if(this.status.started)throw new p("Server is already started");this.transport=this.config.transport,this.connectionHandler=new T({registry:this.registry}),this.messageHandler=new M({registry:this.registry,context:this.context}),this.signalHandler=new x({registry:this.registry,context:this.context}),this.setupTransportHandlers(),this.broadcastChannel=new w(this.registry,this.config.broadcastChunkSize),this.registry.registerChannel(this.broadcastChannel),this.status.started=!0,this.status.startedAt=Date.now()}async stop(){!this.status.started||!this.transport||(this.connectionHandler=void 0,this.messageHandler=void 0,this.signalHandler=void 0,this.registry.clear(),this.broadcastChannel=void 0,this.status.started=!1,this.status.startedAt=void 0)}createBroadcast(){if(!this.status.started||!this.broadcastChannel)throw new p("Server must be started before creating channels");return this.broadcastChannel}createMulticast(e){if(f(e),!this.status.started||!this.transport)throw new p("Server must be started before creating channels");let t=this.registry.getChannel(e);if(t)return t;let n=new E({name:e,registry:this.registry,options:{chunkSize:this.config.broadcastChunkSize}});return this.registry.registerChannel(n),n}hasChannel(e){return!!this.registry.getChannel(e)}getChannels(){return this.registry.getChannels()}use(e){this.context.use(e)}authenticate(e){let t=this.transport||this.config.transport;t&&"setAuthenticator"in t?t.setAuthenticator(e):this.config.logger.warn("Current transport does not support setting an authenticator.")}getStats(){return{startedAt:this.status.startedAt,clientCount:this.registry.getCount(),channelCount:this.registry.getChannels().length,subscriptionCount:this.registry.getTotalSubscriptionCount()}}getConfig(){return this.config}getRegistry(){return this.registry}setupTransportHandlers(){let e=this.transport;e.on("connection",async t=>{try{await this.context.executeConnection(t,"connect"),await this.connectionHandler.handleConnection(t)}catch(n){this.config.logger.error("Error handling connection:",n)}}),e.on("disconnection",async t=>{try{let n=this.registry.get(t);n&&(await this.context.executeConnection(n,"disconnect"),await this.connectionHandler.handleDisconnection(t))}catch(n){this.config.logger.error("Error handling disconnection:",n)}}),e.on("message",async(t,n)=>{try{let r=this.registry.get(t);if(!r)return;n.type==="data"?await this.messageHandler.handleMessage(r,n):n.type==="signal"&&await this.signalHandler.handleSignal(r,n)}catch(r){this.config.logger.error("Error handling message:",r)}}),e.on("error",t=>{this.config.logger.error("Transport error:",t)})}};function me(i={}){let e=i.registry??new _,t=i.logger??X(),n={...Q,middleware:[],...i,registry:e,logger:t};return n.transport||(n.server||import("http").then(r=>{let s=r.createServer();s.listen(n.port,n.host),n.server=s}),n.transport=new v({server:n.server,path:n.path,maxPayload:i.maxPayload??D,enablePing:n.enablePing,pingInterval:n.pingInterval,pingTimeout:n.pingTimeout,connections:e.connections,generateId:n.generateId,logger:n.logger})),new N(n)}function te(i){let{verifyToken:e,getToken:t=s=>s.req.message?.data?.token,attachProperty:n="user",actions:r}=i;return async(s,o)=>{if(r&&!r.includes(s.req.action))return o();let a=t(s);a||s.reject("Authentication token required");try{let c=await e(a);s.req.client&&(s.req.client[n]=c),s.set(n,c),await o()}catch{s.reject("Authentication failed: Invalid token")}}}function ne(i={}){let{logger:e=console,logLevel:t="info",includeMessageData:n=!1,format:r,actions:s}=i;return async(o,a)=>{if(s&&!s.includes(o.req.action))return a();let c=Date.now();await a();let d=Date.now()-c,l={action:o.req.action,clientId:o.req.client?.id,channel:o.req.channel,message:n?o.req.message:void 0,duration:d},m=r?r(l):`[${l.action}] Client: ${l.clientId??"unknown"}${l.channel?` Channel: ${l.channel}`:""} (${d}ms)`;e[t](m)}}var C=new Map;function re(i={}){let{maxRequests:e=100,windowMs:t=6e4,getMessageId:n=a=>a.req.client?.id??"",actions:r=["message"]}=i,s=setInterval(()=>{let a=Date.now();for(let[c,d]of C)d.resetTime<a&&C.delete(c)},t*10),o=async(a,c)=>{if(!r.includes(a.req.action))return c();let d=n(a);if(!d)return c();let l=Date.now(),m=C.get(d);m&&m.resetTime<l&&C.delete(d);let b=C.get(d);b||(b={count:0,resetTime:l+t},C.set(d,b)),b.count>=e&&a.reject(`Rate limit exceeded. Max ${e} requests per ${t}ms`),b.count++,await c()};return o.cleanup=()=>{clearInterval(s),C.clear()},o}function se(i={}){let{allowedChannels:e=[],isDynamic:t,restrictUnsubscribe:n=!1}=i;return async(r,s)=>{if(r.req.action!=="subscribe"&&r.req.action!=="unsubscribe"||r.req.action==="unsubscribe"&&!n||!r.req.channel)return s();if(t)return t(r.req.channel,r.req.client)||r.reject(`Channel '${r.req.channel}' is not allowed`),s();e.includes(r.req.channel)||r.reject(`Channel '${r.req.channel}' is not allowed`),await s()}}export{y as BROADCAST_CHANNEL,w as BroadcastChannel,H as CLOSE_CODES,h as ChannelError,q as ClientError,G as ConfigError,A as ContextManager,ce as ERROR_CODES,u as MessageError,I as MiddlewareExecutionError,S as MiddlewareRejectionError,E as MulticastChannel,p as StateError,N as Synca,g as SyncaError,N as SyncaServer,$ as TransportError,F as ValidationError,v as WebSocketServerTransport,te as createAuthMiddleware,se as createChannelWhitelistMiddleware,R as createContext,ne as createLoggingMiddleware,re as createRateLimitMiddleware,me as createSyncaServer};
+function V(){return`${Date.now()}-${Math.random().toString(36).substring(2,11)}`}function z(){return`client-${Date.now()}-${Math.random().toString(36).substring(2,9)}`}var K=1,j=128,J="__";function ie(i){return typeof i=="string"&&i.length>=K&&i.length<=j}function L(i){return i.startsWith(J)}function f(i){if(!ie(i))throw new Error(`Invalid channel name: must be between ${K} and ${j} characters`);if(L(i))throw new Error(`Reserved channel name: channel names starting with '${J}' are reserved for system use`)}function P(i){return i.type==="data"}function Y(i,e,t){return{id:t||V(),type:"data",channel:i,data:e,timestamp:Date.now()}}function O(i,e,t,n){return{id:n||V(),type:"signal",channel:i,signal:e,data:t,timestamp:Date.now()}}var oe={info:"INFO",warn:"WARN",error:"ERROR",debug:"DEBUG"};function ae(){return new Date().toISOString()}function X(i="Syncar",e={}){let t={debug:!1,info:!0,warn:!0,error:!0,...e},n=(r,s)=>{let o=ae();return`[${i} ${o}] [${oe[r]}] ${s}`};return{debug:(r,...s)=>{t.debug&&console.log(n("debug",r),...s)},info:(r,...s)=>{t.info&&console.log(n("info",r),...s)},warn:(r,...s)=>{t.warn&&console.warn(n("warn",r),...s)},error:(r,...s)=>{t.error&&console.error(n("error",r),...s)}}}var y="__broadcast__",H={NORMAL:1e3,GOING_AWAY:1001,PROTOCOL_ERROR:1002,UNSUPPORTED_DATA:1003,NO_STATUS:1005,ABNORMAL:1006,INVALID_PAYLOAD:1007,POLICY_VIOLATION:1008,MESSAGE_TOO_BIG:1009,MISSING_EXTENSION:1010,INTERNAL_ERROR:1011,SERVICE_RESTART:1012,TRY_AGAIN_LATER:1013,REJECTED:4001,RATE_LIMITED:4002,CHANNEL_NOT_FOUND:4003,UNAUTHORIZED:4005},ce={REJECTED:"REJECTED",MISSING_CHANNEL:"MISSING_CHANNEL",SUBSCRIBE_REJECTED:"SUBSCRIBE_REJECTED",UNSUBSCRIBE_REJECTED:"UNSUBSCRIBE_REJECTED",RATE_LIMITED:"RATE_LIMITED",AUTH_FAILED:"AUTH_FAILED",NOT_AUTHORIZED:"NOT_AUTHORIZED",CHANNEL_NOT_ALLOWED:"CHANNEL_NOT_ALLOWED",INVALID_MESSAGE:"INVALID_MESSAGE",SERVER_ERROR:"SERVER_ERROR"},Z="/syncar",D=1048576,U=3e4,B=5e3,le=3e3,de="0.0.0.0",ge="/syncar",he=!0,Q={port:le,host:de,path:ge,enablePing:he,pingInterval:U,pingTimeout:B,broadcastChunkSize:500};var k=class{constructor(e,t,n=500){this.name=e;this.registry=t;this.chunkSize=n}publish(e,t){let n=this.getTargetClients(t);n.length>this.chunkSize?this.publishInChunks(e,n,t):this.publishToClients(e,n,t)}async dispatch(e,t,n){}publishToClients(e,t,n){let r=Y(this.name,e);for(let s of t){if(n?.to&&!n.to.includes(s)||n?.exclude&&n.exclude.includes(s))continue;let o=this.registry.connections.get(s);if(o)try{o.socket.send(JSON.stringify(r))}catch(a){this.registry.logger?.error(`[${this.name}] Failed to send to ${s}:`,a)}}}publishInChunks(e,t,n){let r=0,s=()=>{let o=t.slice(r,r+this.chunkSize);o.length!==0&&(this.publishToClients(e,o,n),r+=this.chunkSize,r<t.length&&setImmediate(s))};s()}},w=class extends k{constructor(e,t=500){super(y,e,t)}getTargetClients(e){return Array.from(this.registry.connections.keys())}get subscriberCount(){return this.registry.connections.size}isEmpty(){return this.registry.connections.size===0}getMiddlewares(){return[]}},E=class extends k{constructor(t){f(t.name);super(t.name,t.registry,t.options?.chunkSize);this.middlewares=[];this.messageHandlers=new Set}getTargetClients(t){return Array.from(this.registry.getChannelSubscribers(this.name))}use(t){this.middlewares.push(t)}getMiddlewares(){return[...this.middlewares]}get subscriberCount(){return this.registry.getChannelSubscribers(this.name).size}onMessage(t){return this.messageHandlers.add(t),()=>this.messageHandlers.delete(t)}subscribe(t){return this.registry.subscribe(t,this.name)}unsubscribe(t){return this.registry.unsubscribe(t,this.name)}async dispatch(t,n,r){if(this.messageHandlers.size>0)for(let s of this.messageHandlers)try{await s(t,n,r)}catch(o){this.registry.logger?.error(`[${this.name}] Error in message handler:`,o)}else this.publish(t,{exclude:[n.id]})}hasSubscriber(t){return this.registry.getChannelSubscribers(this.name).has(t)}getSubscribers(){return new Set(this.registry.getChannelSubscribers(this.name))}isEmpty(){return this.registry.getChannelSubscribers(this.name).size===0}};var g=class i extends Error{constructor(e,t="SYNNEL_ERROR",n){super(e),this.name="SyncarError",this.code=t,this.context=n,Error.captureStackTrace&&Error.captureStackTrace(this,i)}toJSON(){return{name:this.name,message:this.message,code:this.code,context:this.context,stack:this.stack}}toString(){return`[${this.name}:${this.code}] ${this.message}`}},G=class extends g{constructor(e,t){super(e,"CONFIG_ERROR",t),this.name="ConfigError"}},$=class extends g{constructor(e,t){super(e,"TRANSPORT_ERROR",t),this.name="TransportError"}},h=class extends g{constructor(e,t){super(e,"CHANNEL_ERROR",t),this.name="ChannelError"}},q=class extends g{constructor(e,t){super(e,"CLIENT_ERROR",t),this.name="ClientError"}},u=class extends g{constructor(e,t){super(e,"MESSAGE_ERROR",t),this.name="MessageError"}},F=class extends g{constructor(e,t){super(e,"VALIDATION_ERROR",t),this.name="ValidationError"}},p=class extends g{constructor(e,t){super(e,"STATE_ERROR",t),this.name="StateError"}},S=class i extends Error{constructor(t,n,r,s){super(`Action '${n}' rejected: ${t}`);this.name="MiddlewareRejectionError";this.reason=t,this.action=n,this.name="MiddlewareRejectionError",this.code=r,this.context=s,Error.captureStackTrace&&Error.captureStackTrace(this,i)}toJSON(){return{name:this.name,reason:this.reason,action:this.action,code:this.code,context:this.context,message:this.message,stack:this.stack}}toString(){return`[${this.name}:${this.action}] ${this.reason}`}},I=class i extends Error{constructor(e,t,n){super(`Middleware execution error in ${t} during ${e}: ${n.message}`),this.name="MiddlewareExecutionError",this.action=e,this.middleware=t,this.cause=n,Error.captureStackTrace&&Error.captureStackTrace(this,i)}getCause(){return this.cause}toString(){return`[${this.name}] ${this.middleware} failed during ${this.action}: ${this.cause.message}`}};var x=class{constructor(e){this.registry=e.registry,this.context=e.context,this.options={requireChannel:e.options?.requireChannel??!1,allowReservedChannels:e.options?.allowReservedChannels??!1,sendAcknowledgments:e.options?.sendAcknowledgments??!0,autoRespondToPing:e.options?.autoRespondToPing??!0}}async handleSignal(e,t){let n;t.signal==="subscribe"?n=this.context.createSubscribeContext(e,t.channel):t.signal==="unsubscribe"?n=this.context.createUnsubscribeContext(e,t.channel):n=this.context.createMessageContext(e,t);let r=async()=>{switch(t.signal){case"subscribe":await this.handleSubscribe(e,t);break;case"unsubscribe":await this.handleUnsubscribe(e,t);break;case"ping":await this.handlePing(e,t);break;case"pong":await this.handlePong(e,t);break;default:throw new u(`Unknown signal type: ${t.signal}`)}},s;t.channel&&t.channel!==y&&(s=this.registry.getChannel(t.channel));let o=this.context.getPipeline(s);await this.context.execute(n,o,r)}async handleSubscribe(e,t){let{channel:n}=t;if(!this.options.allowReservedChannels&&L(n))throw new h(`Cannot subscribe to reserved channel: ${n}`);if(n===y)throw new h("Cannot subscribe to broadcast channel");if(!this.registry.subscribe(e.id,n))throw new h(`Failed to subscribe client ${e.id} to channel ${n}`);if(this.options.sendAcknowledgments){let s=O(n,"subscribed",void 0,t.id);e.socket.send(JSON.stringify(s),()=>{})}}async handleUnsubscribe(e,t){let{channel:n}=t;if(!this.registry.isSubscribed(e.id,n))throw new h(`Client not subscribed to channel: ${n}`);if(this.registry.unsubscribe(e.id,n),this.options.sendAcknowledgments){let r=O(n,"unsubscribed",void 0,t.id);e.socket.send(JSON.stringify(r),()=>{})}}async handlePing(e,t){if(e.lastPingAt=Date.now(),this.options.autoRespondToPing){let n=O(t.channel,"pong",void 0,t.id);e.socket.send(JSON.stringify(n),()=>{})}}async handlePong(e,t){e.lastPingAt=Date.now()}getOptions(){return this.options}};var M=class{constructor(e){this.registry=e.registry,this.context=e.context,this.options={requireChannel:e.options?.requireChannel??!0}}async handleMessage(e,t){if(!P(t))throw new u("Invalid message type: expected DATA message");let n=this.registry.getChannel(t.channel);if(this.options.requireChannel&&!n)throw new h(`Channel not found: ${t.channel}`);let r=this.context.getPipeline(n),s=this.context.createMessageContext(e,t),o=async()=>{n&&await n.dispatch(t.data,e,t)};await this.context.execute(s,r,o)}canProcessMessage(e){return P(e)?this.options.requireChannel?!!this.registry.getChannel(e.channel):!0:!1}getChannelForMessage(e){return this.registry.getChannel(e.channel)}getOptions(){return this.options}};var T=class{constructor(e){this.registry=e.registry,this.options={rejectionCloseCode:e.options?.rejectionCloseCode??H.REJECTED}}async handleConnection(e){return this.registry.register(e)}async handleDisconnection(e,t){this.registry.get(e)&&this.registry.unregister(e)}getOptions(){return this.options}};var ee=i=>(e,t)=>{let n=-1,r=async s=>{if(s<=n)throw new Error("next() called multiple times");n=s;let o,a=i[s];if(a)o=await a(e,async()=>{await r(s+1)});else if(s===i.length&&t)o=await t();else return e;return o!==void 0&&!e.finalized&&(e.res=o,e.finalized=!0),e};return r(0)};function R(i){let{action:e,client:t,message:n,channel:r,initialState:s={}}=i,o=s;return{req:{action:e,client:t,message:n,channel:r},var:o,finalized:!1,get:a=>o[a],set:(a,c)=>{o[a]=c},reject:a=>{throw new S(a,e)}}}var A=class{constructor(){this.middlewares=[]}use(e){this.middlewares.push(e)}remove(e){let t=this.middlewares.indexOf(e);return t!==-1?(this.middlewares.splice(t,1),!0):!1}clear(){this.middlewares.length=0}getMiddlewares(){return[...this.middlewares]}getPipeline(e){let t=this.getMiddlewares(),n=e?.getMiddlewares?.();return n&&n.length>0&&(t=[...t,...n]),t}async executeConnection(e,t){let n=this.createConnectionContext(e,t);return await this.execute(n)}async executeMessage(e,t){let n=this.createMessageContext(e,t);return await this.execute(n)}async executeSubscribe(e,t,n){let r=this.createSubscribeContext(e,t);return await this.execute(r,this.middlewares,n)}async executeUnsubscribe(e,t,n){let r=this.createUnsubscribeContext(e,t);return await this.execute(r,this.middlewares,n)}async execute(e,t=this.middlewares,n){let r=e.req.action||"unknown",s=t.map((o,a)=>async(c,d)=>{try{await o(c,d)}catch(l){if(l instanceof S||l instanceof I)throw l;let m=o.name||`middleware[${a}]`;throw new I(r,m,l instanceof Error?l:new Error(String(l)))}});return await ee(s)(e,n)}createConnectionContext(e,t){return R({client:e,action:t})}createMessageContext(e,t){return R({client:e,message:t,action:"message"})}createSubscribeContext(e,t){return R({client:e,channel:t,action:"subscribe"})}createUnsubscribeContext(e,t){return R({client:e,channel:t,action:"unsubscribe"})}getCount(){return this.middlewares.length}hasMiddleware(){return this.middlewares.length>0}};var _=class{constructor(e){this.connections=new Map;this.subscriptions=new Map;this.channels=new Map;this.channelInstances=new Map;this.logger=e}register(e){return this.connections.set(e.id,e),e}unregister(e){let t=this.get(e);return t?(this.clearSubscriptions(t),this.connections.delete(e)):!1}clearSubscriptions(e){let t=this.subscriptions.get(e.id);if(t){for(let n of t)this.channels.get(n)?.delete(e.id);this.subscriptions.delete(e.id)}}get(e){return this.connections.get(e)}getAll(){return Array.from(this.connections.values())}getCount(){return this.connections.size}registerChannel(e){this.channels.has(e.name)||this.channels.set(e.name,new Set),this.channelInstances.set(e.name,e)}getChannel(e){return this.channelInstances.get(e)}removeChannel(e){let t=this.channels.get(e);if(!t)return!1;for(let n of t){let r=this.subscriptions.get(n);r&&r.delete(e)}return this.channelInstances.delete(e),this.channels.delete(e)}subscribe(e,t){if(f(t),!this.connections.has(e))return!1;this.channels.has(t)||this.channels.set(t,new Set);let n=this.channels.get(t);return n.has(e)||(n.add(e),this.subscriptions.has(e)||this.subscriptions.set(e,new Set),this.subscriptions.get(e).add(t)),!0}unsubscribe(e,t){let n=this.channels.get(t);if(!n||!n.has(e))return!1;n.delete(e);let r=this.subscriptions.get(e);return r&&(r.delete(t),r.size===0&&this.subscriptions.delete(e)),!0}getSubscribers(e){let t=this.channels.get(e);if(!t)return[];let n=[];for(let r of t){let s=this.connections.get(r);s&&n.push(s)}return n}getSubscriberCount(e){return this.channels.get(e)?.size??0}getChannels(){return Array.from(this.channels.keys())}getTotalSubscriptionCount(){let e=0;for(let t of this.channels.values())e+=t.size;return e}isSubscribed(e,t){return this.channels.get(t)?.has(e)??!1}getClientChannels(e){return this.subscriptions.get(e)??new Set}getChannelSubscribers(e){return this.channels.get(e)??new Set}clear(){this.connections.clear(),this.subscriptions.clear(),this.channels.clear(),this.channelInstances.clear()}};import{EventEmitter as pe}from"events";import{WebSocketServer as Ce}from"ws";var v=class extends pe{constructor(e){super(),this.setMaxListeners(100),this.connections=e.connections??new Map,this.config={...e,path:e.path??Z,maxPayload:e.maxPayload??D,enablePing:e.enablePing??!0,pingInterval:e.pingInterval??U,pingTimeout:e.pingTimeout??B,connections:this.connections};let t=e.ServerConstructor??Ce;this.wsServer=new t({server:this.config.server,path:this.config.path,maxPayload:this.config.maxPayload}),this.setupEventHandlers(),this.config.enablePing&&this.startPingTimer()}setAuthenticator(e){this.authenticator=e}setupEventHandlers(){this.wsServer.on("connection",(e,t)=>{this.handleConnection(e,t)}),this.wsServer.on("error",e=>{this.config.logger?.error("WebSocket Server Error:",e),this.emit("error",e)})}async handleConnection(e,t){let n;try{this.authenticator?n=await this.authenticator(t):this.config.generateId?n=await this.config.generateId(t):n=z()}catch(o){try{e.close(4001,o instanceof Error?o.message:"Unauthorized")}catch{}return}let r=Date.now(),s={socket:e,id:n,connectedAt:r,lastPingAt:r};this.connections.set(n,s),e.on("message",o=>{this.handleMessage(n,o)}),e.on("close",(o,a)=>{this.handleDisconnection(n)}),e.on("error",o=>{this.emit("error",o)}),this.config.enablePing&&this.setupPingPong(n,e),this.emit("connection",s)}handleMessage(e,t){try{let n=JSON.parse(t.toString()),r=this.connections.get(e);r&&n.type==="signal"&&n.signal==="pong"&&(r.lastPingAt=Date.now()),this.emit("message",e,n)}catch(n){this.config.logger?.error(`Failed to parse message from ${e}:`,n),this.emit("error",n)}}handleDisconnection(e){this.emit("disconnection",e),this.connections.delete(e)}setupPingPong(e,t){t.on("pong",()=>{let n=this.connections.get(e);n&&(n.lastPingAt=Date.now())})}startPingTimer(){this.pingTimer&&clearInterval(this.pingTimer),this.pingTimer=setInterval(()=>{this.checkConnections()},this.config.pingInterval)}checkConnections(){let e=Date.now(),t=Array.from(this.connections.values());for(let n of t){let r=n.socket,s=n.lastPingAt??n.connectedAt;if(e-s>this.config.pingInterval+this.config.pingTimeout){r.close(1e3,"Ping timeout");continue}r.readyState===1&&r.ping()}}};var N=class{constructor(e){this.status={started:!1,startedAt:void 0};if(this.config=e,this.registry=this.config.registry,this.context=new A,this.config.middleware)for(let t of this.config.middleware)this.context.use(t)}async start(){if(this.status.started)throw new p("Server is already started");this.transport=this.config.transport,this.connectionHandler=new T({registry:this.registry}),this.messageHandler=new M({registry:this.registry,context:this.context}),this.signalHandler=new x({registry:this.registry,context:this.context}),this.setupTransportHandlers(),this.broadcastChannel=new w(this.registry,this.config.broadcastChunkSize),this.registry.registerChannel(this.broadcastChannel),this.status.started=!0,this.status.startedAt=Date.now()}async stop(){!this.status.started||!this.transport||(this.connectionHandler=void 0,this.messageHandler=void 0,this.signalHandler=void 0,this.registry.clear(),this.broadcastChannel=void 0,this.status.started=!1,this.status.startedAt=void 0)}createBroadcast(){if(!this.status.started||!this.broadcastChannel)throw new p("Server must be started before creating channels");return this.broadcastChannel}createMulticast(e){if(f(e),!this.status.started||!this.transport)throw new p("Server must be started before creating channels");let t=this.registry.getChannel(e);if(t)return t;let n=new E({name:e,registry:this.registry,options:{chunkSize:this.config.broadcastChunkSize}});return this.registry.registerChannel(n),n}hasChannel(e){return!!this.registry.getChannel(e)}getChannels(){return this.registry.getChannels()}use(e){this.context.use(e)}authenticate(e){let t=this.transport||this.config.transport;t&&"setAuthenticator"in t?t.setAuthenticator(e):this.config.logger.warn("Current transport does not support setting an authenticator.")}getStats(){return{startedAt:this.status.startedAt,clientCount:this.registry.getCount(),channelCount:this.registry.getChannels().length,subscriptionCount:this.registry.getTotalSubscriptionCount()}}getConfig(){return this.config}getRegistry(){return this.registry}setupTransportHandlers(){let e=this.transport;e.on("connection",async t=>{try{await this.context.executeConnection(t,"connect"),await this.connectionHandler.handleConnection(t)}catch(n){this.config.logger.error("Error handling connection:",n)}}),e.on("disconnection",async t=>{try{let n=this.registry.get(t);n&&(await this.context.executeConnection(n,"disconnect"),await this.connectionHandler.handleDisconnection(t))}catch(n){this.config.logger.error("Error handling disconnection:",n)}}),e.on("message",async(t,n)=>{try{let r=this.registry.get(t);if(!r)return;n.type==="data"?await this.messageHandler.handleMessage(r,n):n.type==="signal"&&await this.signalHandler.handleSignal(r,n)}catch(r){this.config.logger.error("Error handling message:",r)}}),e.on("error",t=>{this.config.logger.error("Transport error:",t)})}};function me(i={}){let e=i.registry??new _,t=i.logger??X(),n={...Q,middleware:[],...i,registry:e,logger:t};return n.transport||(n.server||import("http").then(r=>{let s=r.createServer();s.listen(n.port,n.host),n.server=s}),n.transport=new v({server:n.server,path:n.path,maxPayload:i.maxPayload??D,enablePing:n.enablePing,pingInterval:n.pingInterval,pingTimeout:n.pingTimeout,connections:e.connections,generateId:n.generateId,logger:n.logger})),new N(n)}function te(i){let{verifyToken:e,getToken:t=s=>s.req.message?.data?.token,attachProperty:n="user",actions:r}=i;return async(s,o)=>{if(r&&!r.includes(s.req.action))return o();let a=t(s);a||s.reject("Authentication token required");try{let c=await e(a);s.req.client&&(s.req.client[n]=c),s.set(n,c),await o()}catch{s.reject("Authentication failed: Invalid token")}}}function ne(i={}){let{logger:e=console,logLevel:t="info",includeMessageData:n=!1,format:r,actions:s}=i;return async(o,a)=>{if(s&&!s.includes(o.req.action))return a();let c=Date.now();await a();let d=Date.now()-c,l={action:o.req.action,clientId:o.req.client?.id,channel:o.req.channel,message:n?o.req.message:void 0,duration:d},m=r?r(l):`[${l.action}] Client: ${l.clientId??"unknown"}${l.channel?` Channel: ${l.channel}`:""} (${d}ms)`;e[t](m)}}var C=new Map;function re(i={}){let{maxRequests:e=100,windowMs:t=6e4,getMessageId:n=a=>a.req.client?.id??"",actions:r=["message"]}=i,s=setInterval(()=>{let a=Date.now();for(let[c,d]of C)d.resetTime<a&&C.delete(c)},t*10),o=async(a,c)=>{if(!r.includes(a.req.action))return c();let d=n(a);if(!d)return c();let l=Date.now(),m=C.get(d);m&&m.resetTime<l&&C.delete(d);let b=C.get(d);b||(b={count:0,resetTime:l+t},C.set(d,b)),b.count>=e&&a.reject(`Rate limit exceeded. Max ${e} requests per ${t}ms`),b.count++,await c()};return o.cleanup=()=>{clearInterval(s),C.clear()},o}function se(i={}){let{allowedChannels:e=[],isDynamic:t,restrictUnsubscribe:n=!1}=i;return async(r,s)=>{if(r.req.action!=="subscribe"&&r.req.action!=="unsubscribe"||r.req.action==="unsubscribe"&&!n||!r.req.channel)return s();if(t)return t(r.req.channel,r.req.client)||r.reject(`Channel '${r.req.channel}' is not allowed`),s();e.includes(r.req.channel)||r.reject(`Channel '${r.req.channel}' is not allowed`),await s()}}export{y as BROADCAST_CHANNEL,w as BroadcastChannel,H as CLOSE_CODES,h as ChannelError,q as ClientError,G as ConfigError,A as ContextManager,ce as ERROR_CODES,u as MessageError,I as MiddlewareExecutionError,S as MiddlewareRejectionError,E as MulticastChannel,p as StateError,N as Syncar,g as SyncarError,N as SyncarServer,$ as TransportError,F as ValidationError,v as WebSocketServerTransport,te as createAuthMiddleware,se as createChannelWhitelistMiddleware,R as createContext,ne as createLoggingMiddleware,re as createRateLimitMiddleware,me as createSyncarServer};
 //# sourceMappingURL=index.js.map