topsyde-utils 1.3.2 → 2.0.1

package/dist/server/bun/router/router.internal.d.ts

@@ -1,15 +0,0 @@
-import { Routes } from "./routes";
-declare class Router_Internal {
-    private registry;
-    private routes;
-    constructor(routes?: Routes);
-    post<T>(req: Request): Promise<T>;
-    get<T>(req: Request): Promise<T>;
-    private handleRequest;
-    private getPath;
-    private resolve;
-    private register;
-    setRoutes(routes: Routes): void;
-    private controllerFactory;
-}
-export default Router_Internal;

package/dist/server/bun/router/router.internal.js

@@ -1,51 +0,0 @@
-import { Throwable } from "../../../index.js";
-import { ERROR_CODE } from "../../../errors.js";
-import { Debug } from "../../../utils/Lib.js";
-class Router_Internal {
-    constructor(routes) {
-        this.registry = new Map();
-        this.routes = routes ?? {};
-    }
-    async post(req) {
-        return await this.handleRequest(req);
-    }
-    async get(req) {
-        return await this.handleRequest(req);
-    }
-    async handleRequest(request) {
-        const path = this.getPath(request);
-        const output = await this.resolve(path).call(request);
-        return output;
-    }
-    getPath(request) {
-        return new URL(request.url).pathname;
-    }
-    resolve(path) {
-        const controllerKey = path.split("/")[1];
-        return this.register(controllerKey, () => this.controllerFactory(controllerKey));
-    }
-    register(controllerKey, factory) {
-        if (!this.registry.has(controllerKey)) {
-            this.registry.set(controllerKey, factory());
-            Debug.Log(`Caching controller: /${controllerKey}`);
-        }
-        return this.registry.get(controllerKey);
-    }
-    setRoutes(routes) {
-        this.routes = routes;
-    }
-    controllerFactory(controllerKey) {
-        try {
-            if (!(controllerKey in this.routes))
-                throw new Throwable(`${ERROR_CODE.INVALID_CONTROLLER}: ${controllerKey}`, { logError: false });
-            const ControllerClass = this.routes[controllerKey];
-            return new ControllerClass();
-        }
-        catch (err) {
-            console.error("controllerFactory", err);
-            throw err;
-        }
-    }
-}
-export default Router_Internal;
-//# sourceMappingURL=router.internal.js.map

package/dist/server/bun/router/router.internal.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"router.internal.js","sourceRoot":"","sources":["../../../../src/server/bun/router/router.internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG3C,MAAM,eAAe;IAIpB,YAAY,MAAe;QAHnB,aAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;QAIhD,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,IAAI,CAAI,GAAY;QACzB,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAY;QACxB,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAEO,KAAK,CAAC,aAAa,CAAI,OAAgB;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAI,OAAO,CAAC,CAAC;QACzD,OAAO,MAAM,CAAC;IACf,CAAC;IAEO,OAAO,CAAC,OAAgB;QAC/B,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IACtC,CAAC;IAEO,OAAO,CAAC,IAAY;QAC3B,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC;IAClF,CAAC;IAEO,QAAQ,CAAC,aAAqB,EAAE,OAAyB;QAChE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5C,KAAK,CAAC,GAAG,CAAC,wBAAwB,aAAa,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAe,CAAC;IACvD,CAAC;IAEM,SAAS,CAAC,MAAc;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;IAEO,iBAAiB,CAAC,aAAqB;QAC9C,IAAI,CAAC;YACJ,IAAI,CAAC,CAAC,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC;gBAAE,MAAM,IAAI,SAAS,CAAC,GAAG,UAAU,CAAC,kBAAkB,KAAK,aAAa,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YAEpI,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,aAAyC,CAAC,CAAC;YAE/E,OAAO,IAAI,eAAe,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;YACxC,MAAM,GAAG,CAAC;QACX,CAAC;IACF,CAAC;CACD;AAED,eAAe,eAAe,CAAC","sourcesContent":["import { Throwable } from \"../../..\";\nimport { ERROR_CODE } from \"../../../errors\";\nimport Controller from \"../../controller\";\nimport { Debug } from \"../../../utils/Lib\";\nimport { Routes } from \"./routes\";\n\nclass Router_Internal {\n\tprivate registry = new Map<string, Controller>();\n\tprivate routes: Routes;\n\n\tconstructor(routes?: Routes) {\n\t\tthis.routes = routes ?? {};\n\t}\n\n\tasync post<T>(req: Request): Promise<T> {\n\t\treturn await this.handleRequest(req);\n\t}\n\n\tasync get<T>(req: Request): Promise<T> {\n\t\treturn await this.handleRequest(req);\n\t}\n\n\tprivate async handleRequest<T>(request: Request): Promise<T> {\n\t\tconst path = this.getPath(request);\n\t\tconst output = await this.resolve(path).call<T>(request);\n\t\treturn output;\n\t}\n\n\tprivate getPath(request: Request): string {\n\t\treturn new URL(request.url).pathname;\n\t}\n\n\tprivate resolve(path: string): Controller {\n\t\tconst controllerKey = path.split(\"/\")[1];\n\t\treturn this.register(controllerKey, () => this.controllerFactory(controllerKey));\n\t}\n\n\tprivate register(controllerKey: string, factory: () => Controller): Controller {\n\t\tif (!this.registry.has(controllerKey)) {\n\t\t\tthis.registry.set(controllerKey, factory());\n\t\t\tDebug.Log(`Caching controller: /${controllerKey}`);\n\t\t}\n\t\treturn this.registry.get(controllerKey) as Controller;\n\t}\n\n\tpublic setRoutes(routes: Routes): void {\n\t\tthis.routes = routes;\n\t}\n\n\tprivate controllerFactory(controllerKey: string): Controller {\n\t\ttry {\n\t\t\tif (!(controllerKey in this.routes)) throw new Throwable(`${ERROR_CODE.INVALID_CONTROLLER}: ${controllerKey}`, { logError: false });\n\n\t\t\tconst ControllerClass = this.routes[controllerKey as keyof typeof this.routes];\n\n\t\t\treturn new ControllerClass();\n\t\t} catch (err) {\n\t\t\tconsole.error(\"controllerFactory\", err);\n\t\t\tthrow err;\n\t\t}\n\t}\n}\n\nexport default Router_Internal;\n"]}

package/dist/server/bun/router/router.js

@@ -1,38 +0,0 @@
-import { ERROR_CODE } from "../../../errors.js";
-import Singleton from "../../../singleton.js";
-import Guards from "../../../utils/Guards.js";
-import Router_Internal from "./router.internal.js";
-class Router extends Singleton {
-    constructor(routes) {
-        super();
-        this.internal = new Router_Internal(routes);
-    }
-    setRoutes(routes) {
-        this.internal.setRoutes(routes);
-    }
-    static async Call(request) {
-        if (Guards.IsNil(request))
-            throw ERROR_CODE.NO_REQUEST;
-        const methods = this.getMethodMap();
-        const method = methods[request.method];
-        if (Guards.IsNil(method))
-            throw ERROR_CODE.INVALID_METHOD;
-        return await method(request);
-    }
-    static SetRoutes(routes) {
-        this.GetInstance().setRoutes(routes);
-    }
-    static getMethodMap() {
-        const router = this.GetInstance();
-        return {
-            GET: async (req) => await router.internal.get(req),
-            POST: async (req) => await router.internal.post(req),
-        };
-    }
-    static GetQueryParams(request) {
-        const url = new URL(request.url);
-        return url.searchParams;
-    }
-}
-export default Router;
-//# sourceMappingURL=router.js.map

package/dist/server/bun/router/router.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../../src/server/bun/router/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAC3C,OAAO,MAAM,MAAM,uBAAuB,CAAC;AAC3C,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAOhD,MAAM,MAAO,SAAQ,SAAS;IAG7B,YAAmB,MAAe;QACjC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAEO,SAAS,CAAC,MAAc;QAC/B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAI,OAAgB;QAC3C,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;YAAE,MAAM,UAAU,CAAC,UAAU,CAAC;QACvD,MAAM,OAAO,GAAiB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEvC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;YAAE,MAAM,UAAU,CAAC,cAAc,CAAC;QAE1D,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAEM,MAAM,CAAC,SAAS,CAAC,MAAc;QACrC,IAAI,CAAC,WAAW,EAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAEO,MAAM,CAAC,YAAY;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAU,CAAC;QAC1C,OAAO;YACN,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;YAClD,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;SACpD,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,cAAc,CAAC,OAAgB;QAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,GAAG,CAAC,YAAY,CAAC;IACzB,CAAC;CACD;AAED,eAAe,MAAM,CAAC","sourcesContent":["import { ERROR_CODE } from \"../../../errors\";\nimport Singleton from \"../../../singleton\";\nimport Guards from \"../../../utils/Guards\";\nimport Router_Internal from \"./router.internal\";\nimport { Routes } from \"./routes\";\n\ntype MethodMap<T> = {\n\t[method: string]: (req: Request) => Promise<T>;\n};\n\nclass Router extends Singleton {\n\tprivate internal: Router_Internal;\n\n\tpublic constructor(routes?: Routes) {\n\t\tsuper();\n\t\tthis.internal = new Router_Internal(routes);\n\t}\n\n\tprivate setRoutes(routes: Routes): void {\n\t\tthis.internal.setRoutes(routes);\n\t}\n\n\tpublic static async Call<T>(request: Request): Promise<T> {\n\t\tif (Guards.IsNil(request)) throw ERROR_CODE.NO_REQUEST;\n\t\tconst methods: MethodMap<T> = this.getMethodMap();\n\t\tconst method = methods[request.method];\n\n\t\tif (Guards.IsNil(method)) throw ERROR_CODE.INVALID_METHOD;\n\n\t\treturn await method(request);\n\t}\n\n\tpublic static SetRoutes(routes: Routes) {\n\t\tthis.GetInstance<Router>().setRoutes(routes);\n\t}\n\n\tprivate static getMethodMap<T>(): MethodMap<T> {\n\t\tconst router = this.GetInstance<Router>();\n\t\treturn {\n\t\t\tGET: async (req) => await router.internal.get(req),\n\t\t\tPOST: async (req) => await router.internal.post(req),\n\t\t};\n\t}\n\n\tpublic static GetQueryParams(request: Request): URLSearchParams {\n\t\tconst url = new URL(request.url);\n\t\treturn url.searchParams;\n\t}\n}\n\nexport default Router;\n"]}

package/dist/server/bun/router/routes.d.ts

@@ -1,5 +0,0 @@
-import Controller from "../../controller";
-export type Routes = {
-    [key: string]: new () => Controller;
-};
-export declare const routes: Routes;

package/dist/server/bun/router/routes.js

@@ -1,2 +0,0 @@
-export const routes = {};
-//# sourceMappingURL=routes.js.map

package/dist/server/bun/router/routes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../../src/server/bun/router/routes.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,MAAM,GAAW,EAAE,CAAC","sourcesContent":["import Controller from \"../../controller\";\n\nexport type Routes = {\n\t[key: string]: new () => Controller;\n};\n\nexport const routes: Routes = {};\n"]}

package/dist/server/bun/websocket/Channel.d.ts

@@ -1,68 +0,0 @@
-import Websocket from "./Websocket";
-import type { BroadcastOptions, I_WebsocketChannel, I_WebsocketClient, I_WebsocketEntity, WebsocketChannel, WebsocketMessage, AddMemberResult, AddMemberOptions, RemoveMemberOptions } from "./websocket.types";
-/**
- * Channel - Pub/sub topic for WebSocket clients
- *
- * ## Membership Contract
- * - `addMember()` validates capacity and adds to `members` map
- * - Client drives join via `joinChannel()` which subscribes and handles rollback
- * - If subscription fails, membership is automatically rolled back
- * - Member count never exceeds `limit`
- *
- * @example
- * const channel = new Channel("game-1", "Game Room", ws, 10);
- * const result = channel.addMember(client);
- * if (result.success) {
- *   channel.broadcast({ type: "player.joined", content: { player: client.whoami() } });
- * }
- */
-export default class Channel<T extends Websocket = Websocket> implements I_WebsocketChannel<T> {
-    createdAt: Date;
-    id: string;
-    name: string;
-    limit: number;
-    members: Map<string, I_WebsocketClient>;
-    metadata: Record<string, string>;
-    ws: T;
-    constructor(id: string, name: string, ws: T, limit?: number, members?: Map<string, I_WebsocketClient>, metadata?: Record<string, string>);
-    broadcast(message: WebsocketMessage | string, options?: BroadcastOptions): void;
-    private getFilteredMetadata;
-    hasMember(client: I_WebsocketEntity | string): boolean;
-    /**
-     * ATOMIC: Add member to channel (membership only, no side effects)
-     * Internal method used for rollback-safe operations
-     * @internal
-     */
-    private addToMembersMap;
-    /**
-     * Add a client to this channel with full coordination
-     * Handles: membership + WebSocket subscription + client-side tracking + optional notification
-     * This ensures two-way coordination between channel and client
-     */
-    addMember(client: I_WebsocketClient, options?: AddMemberOptions): AddMemberResult;
-    addMembers(clients: I_WebsocketClient[], options?: AddMemberOptions): AddMemberResult[];
-    private notifyChannelFull;
-    /**
-     * Internal method to remove a member without triggering client-side cleanup.
-     * Used for rollback operations when joinChannel fails.
-     * @internal
-     */
-    removeFromMembersMap(client: I_WebsocketClient): void;
-    /**
-     * Remove a client from this channel with full coordination
-     * Handles: membership removal + WebSocket unsubscription + client-side tracking removal + optional notification
-     * This ensures two-way coordination between channel and client
-     */
-    removeMember(entity: I_WebsocketEntity, options?: RemoveMemberOptions): false | I_WebsocketClient;
-    getMember(client: I_WebsocketEntity | string): I_WebsocketClient | undefined;
-    getMembers(clients?: string[] | I_WebsocketEntity[]): I_WebsocketClient[];
-    getMetadata(): Record<string, string>;
-    getCreatedAt(): Date;
-    getId(): string;
-    getName(): string;
-    getLimit(): number;
-    getSize(): number;
-    canAddMember(): boolean;
-    delete(): void;
-    static GetChannelType(channels: WebsocketChannel<I_WebsocketChannel> | undefined): typeof Channel;
-}

package/dist/server/bun/websocket/Channel.js

@@ -1,263 +0,0 @@
-import { Guards, Lib } from "../../../utils/index.js";
-import Message from "./Message.js";
-import { E_WebsocketMessageType } from "./websocket.enums.js";
-/**
- * Channel - Pub/sub topic for WebSocket clients
- *
- * ## Membership Contract
- * - `addMember()` validates capacity and adds to `members` map
- * - Client drives join via `joinChannel()` which subscribes and handles rollback
- * - If subscription fails, membership is automatically rolled back
- * - Member count never exceeds `limit`
- *
- * @example
- * const channel = new Channel("game-1", "Game Room", ws, 10);
- * const result = channel.addMember(client);
- * if (result.success) {
- *   channel.broadcast({ type: "player.joined", content: { player: client.whoami() } });
- * }
- */
-export default class Channel {
-    constructor(id, name, ws, limit, members, metadata) {
-        this.createdAt = new Date();
-        this.id = id;
-        this.name = name;
-        this.limit = limit ?? 5;
-        this.members = members ?? new Map();
-        this.metadata = metadata ?? {};
-        this.ws = ws;
-    }
-    broadcast(message, options) {
-        if (Guards.IsString(message)) {
-            const msg = {
-                type: "message",
-                content: { message },
-            };
-            message = msg;
-        }
-        const output = Message.Create(message, { ...options, channel: this.id });
-        // Include channel metadata if requested
-        if (options?.includeMetadata) {
-            output.metadata = options.includeMetadata === true ? this.getMetadata() : this.getFilteredMetadata(options.includeMetadata);
-        }
-        const serializedMessage = Message.Serialize(output);
-        // If we need to exclude clients, send individually to prevent excluded clients from receiving
-        if (options?.excludeClients && options.excludeClients.length > 0) {
-            const excludeSet = new Set(options.excludeClients); // O(1) lookup
-            for (const [clientId, client] of this.members) {
-                if (!excludeSet.has(clientId)) {
-                    try {
-                        client.ws.send(serializedMessage);
-                    }
-                    catch (error) {
-                        Lib.Warn(`Failed to send to client ${clientId}:`, error);
-                    }
-                }
-            }
-            return;
-        }
-        // Otherwise use pub/sub for everyone
-        this.ws.server.publish(this.id, serializedMessage);
-    }
-    // Helper method for filtered metadata
-    getFilteredMetadata(keys) {
-        const metadata = this.getMetadata();
-        const filtered = {};
-        for (const key of keys) {
-            if (metadata[key] !== undefined) {
-                filtered[key] = metadata[key];
-            }
-        }
-        return filtered;
-    }
-    hasMember(client) {
-        if (typeof client === "string")
-            return this.members.has(client);
-        return this.members.has(client.id);
-    }
-    /**
-     * ATOMIC: Add member to channel (membership only, no side effects)
-     * Internal method used for rollback-safe operations
-     * @internal
-     */
-    addToMembersMap(client, options) {
-        // Check if already a member
-        if (this.members.has(client.id)) {
-            return { success: false, reason: "already_member" };
-        }
-        // Check capacity
-        if (!this.canAddMember()) {
-            // Optionally notify client why they can't join
-            if (options?.notify_when_full) {
-                this.notifyChannelFull(client);
-            }
-            return { success: false, reason: "full" };
-        }
-        try {
-            this.members.set(client.id, client);
-            return { success: true, client };
-        }
-        catch (error) {
-            // Rollback
-            this.members.delete(client.id);
-            return {
-                success: false,
-                reason: "error",
-                error: error instanceof Error ? error : new Error(String(error)),
-            };
-        }
-    }
-    /**
-     * Add a client to this channel with full coordination
-     * Handles: membership + WebSocket subscription + client-side tracking + optional notification
-     * This ensures two-way coordination between channel and client
-     */
-    addMember(client, options) {
-        // 1. Atomic membership add
-        const result = this.addToMembersMap(client, options);
-        if (!result.success) {
-            return result;
-        }
-        try {
-            // 2. Subscribe client's WebSocket to channel pub/sub topic
-            // CRITICAL: Without this, client won't receive channel.broadcast() messages
-            client.subscribe(this.id);
-            // 3. Track channel on client side (client's channels map)
-            client.trackChannel(this);
-            // 4. Optional welcome notification
-            if (options?.notify) {
-                client.send({
-                    type: E_WebsocketMessageType.CLIENT_JOIN_CHANNEL,
-                    content: { message: "Welcome to the channel" },
-                    channel: this.id,
-                    client: client.whoami(),
-                });
-            }
-            return result;
-        }
-        catch (error) {
-            // Rollback on failure: remove membership + unsubscribe + untrack
-            this.removeFromMembersMap(client);
-            client.unsubscribe(this.id);
-            client.untrackChannel(this);
-            throw error;
-        }
-    }
-    addMembers(clients, options) {
-        const results = [];
-        for (const client of clients) {
-            const result = this.addMember(client, options);
-            results.push(result);
-            if (!result.success) {
-                // Stop adding further members on failure
-                break;
-            }
-        }
-        return results;
-    }
-    notifyChannelFull(client) {
-        client.send({
-            type: E_WebsocketMessageType.ERROR,
-            content: {
-                message: `Channel "${this.name}" is full (${this.limit} members)`,
-                code: "CHANNEL_FULL",
-                channel: this.id,
-            },
-        });
-    }
-    /**
-     * Internal method to remove a member without triggering client-side cleanup.
-     * Used for rollback operations when joinChannel fails.
-     * @internal
-     */
-    removeFromMembersMap(client) {
-        this.members.delete(client.id);
-    }
-    /**
-     * Remove a client from this channel with full coordination
-     * Handles: membership removal + WebSocket unsubscription + client-side tracking removal + optional notification
-     * This ensures two-way coordination between channel and client
-     */
-    removeMember(entity, options) {
-        // 1. Check if member exists
-        if (!this.members.has(entity.id))
-            return false;
-        const client = this.members.get(entity.id);
-        if (!client)
-            return false;
-        // 2. Remove from channel members (atomic operation)
-        this.removeFromMembersMap(client);
-        // 3. Unsubscribe client's WebSocket from channel pub/sub topic
-        client.unsubscribe(this.id);
-        // 4. Untrack channel on client side (remove from client's channels map)
-        client.untrackChannel(this);
-        // 5. Optional goodbye notification
-        if (options?.notify) {
-            client.send({
-                type: E_WebsocketMessageType.CLIENT_LEAVE_CHANNEL,
-                content: { message: "You left the channel" },
-                channel: this.id,
-                client: client.whoami(),
-            });
-        }
-        return client;
-    }
-    getMember(client) {
-        if (typeof client === "string")
-            return this.members.get(client);
-        return this.members.get(client.id);
-    }
-    getMembers(clients) {
-        if (!clients)
-            return Array.from(this.members.values());
-        return clients.map((client) => this.getMember(client)).filter((client) => client !== undefined);
-    }
-    getMetadata() {
-        return this.metadata;
-    }
-    getCreatedAt() {
-        return this.createdAt;
-    }
-    getId() {
-        return this.id;
-    }
-    getName() {
-        return this.name;
-    }
-    getLimit() {
-        return this.limit;
-    }
-    getSize() {
-        return this.members.size;
-    }
-    canAddMember() {
-        const size = this.getSize();
-        return size < this.limit;
-    }
-    delete() {
-        //first remove all members
-        this.members.forEach((member) => {
-            this.removeMember(member, { notify: true });
-        });
-        //then clear members map
-        this.members.clear();
-    }
-    static GetChannelType(channels) {
-        if (!channels)
-            return Channel;
-        if (channels.size > 0) {
-            const firstChannel = channels.values().next().value;
-            if (firstChannel) {
-                return firstChannel.constructor;
-            }
-            else {
-                return Channel;
-            }
-        }
-        else {
-            Lib.Warn("Channels are empty, using default channel class");
-            return Channel;
-        }
-    }
-}
-//# sourceMappingURL=Channel.js.map

package/dist/server/bun/websocket/Channel.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Channel.js","sourceRoot":"","sources":["../../../../src/server/bun/websocket/Channel.ts"],"names":[],"mappings":"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","sourcesContent":["import { Guards, Lib } from \"../../../utils\";\nimport Message from \"./Message\";\nimport Websocket from \"./Websocket\";\nimport type {\n\tBroadcastOptions,\n\tI_WebsocketChannel,\n\tI_WebsocketClient,\n\tI_WebsocketEntity,\n\tWebsocketChannel,\n\tWebsocketMessage,\n\tAddMemberResult,\n\tAddMemberOptions,\n\tRemoveMemberOptions,\n} from \"./websocket.types\";\nimport { E_WebsocketMessageType } from \"./websocket.enums\";\n\n/**\n * Channel - Pub/sub topic for WebSocket clients\n *\n * ## Membership Contract\n * - `addMember()` validates capacity and adds to `members` map\n * - Client drives join via `joinChannel()` which subscribes and handles rollback\n * - If subscription fails, membership is automatically rolled back\n * - Member count never exceeds `limit`\n *\n * @example\n * const channel = new Channel(\"game-1\", \"Game Room\", ws, 10);\n * const result = channel.addMember(client);\n * if (result.success) {\n *   channel.broadcast({ type: \"player.joined\", content: { player: client.whoami() } });\n * }\n */\nexport default class Channel<T extends Websocket = Websocket> implements I_WebsocketChannel<T> {\n\tpublic createdAt: Date = new Date();\n\tpublic id: string;\n\tpublic name: string;\n\tpublic limit: number;\n\tpublic members: Map<string, I_WebsocketClient>;\n\tpublic metadata: Record<string, string>;\n\tpublic ws: T;\n\n\tconstructor(id: string, name: string, ws: T, limit?: number, members?: Map<string, I_WebsocketClient>, metadata?: Record<string, string>) {\n\t\tthis.id = id;\n\t\tthis.name = name;\n\t\tthis.limit = limit ?? 5;\n\t\tthis.members = members ?? new Map();\n\t\tthis.metadata = metadata ?? {};\n\t\tthis.ws = ws;\n\t}\n\n\tpublic broadcast(message: WebsocketMessage | string, options?: BroadcastOptions) {\n\t\tif (Guards.IsString(message)) {\n\t\t\tconst msg: WebsocketMessage = {\n\t\t\t\ttype: \"message\",\n\t\t\t\tcontent: { message },\n\t\t\t};\n\t\t\tmessage = msg;\n\t\t}\n\n\t\tconst output = Message.Create(message, { ...options, channel: this.id });\n\n\t\t// Include channel metadata if requested\n\t\tif (options?.includeMetadata) {\n\t\t\toutput.metadata = options.includeMetadata === true ? this.getMetadata() : this.getFilteredMetadata(options.includeMetadata);\n\t\t}\n\n\t\tconst serializedMessage = Message.Serialize(output);\n\n\t\t// If we need to exclude clients, send individually to prevent excluded clients from receiving\n\t\tif (options?.excludeClients && options.excludeClients.length > 0) {\n\t\t\tconst excludeSet = new Set(options.excludeClients); // O(1) lookup\n\n\t\t\tfor (const [clientId, client] of this.members) {\n\t\t\t\tif (!excludeSet.has(clientId)) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tclient.ws.send(serializedMessage);\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tLib.Warn(`Failed to send to client ${clientId}:`, error);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\t// Otherwise use pub/sub for everyone\n\t\tthis.ws.server.publish(this.id, serializedMessage);\n\t}\n\n\t// Helper method for filtered metadata\n\tprivate getFilteredMetadata(keys: string[]) {\n\t\tconst metadata = this.getMetadata();\n\t\tconst filtered: Record<string, string> = {};\n\n\t\tfor (const key of keys) {\n\t\t\tif (metadata[key] !== undefined) {\n\t\t\t\tfiltered[key] = metadata[key];\n\t\t\t}\n\t\t}\n\n\t\treturn filtered;\n\t}\n\n\tpublic hasMember(client: I_WebsocketEntity | string) {\n\t\tif (typeof client === \"string\") return this.members.has(client);\n\t\treturn this.members.has(client.id);\n\t}\n\n\t/**\n\t * ATOMIC: Add member to channel (membership only, no side effects)\n\t * Internal method used for rollback-safe operations\n\t * @internal\n\t */\n\tprivate addToMembersMap(client: I_WebsocketClient, options?: AddMemberOptions): AddMemberResult {\n\t\t// Check if already a member\n\t\tif (this.members.has(client.id)) {\n\t\t\treturn { success: false, reason: \"already_member\" };\n\t\t}\n\n\t\t// Check capacity\n\t\tif (!this.canAddMember()) {\n\t\t\t// Optionally notify client why they can't join\n\t\t\tif (options?.notify_when_full) {\n\t\t\t\tthis.notifyChannelFull(client);\n\t\t\t}\n\t\t\treturn { success: false, reason: \"full\" };\n\t\t}\n\n\t\ttry {\n\t\t\tthis.members.set(client.id, client);\n\t\t\treturn { success: true, client };\n\t\t} catch (error) {\n\t\t\t// Rollback\n\t\t\tthis.members.delete(client.id);\n\t\t\treturn {\n\t\t\t\tsuccess: false,\n\t\t\t\treason: \"error\",\n\t\t\t\terror: error instanceof Error ? error : new Error(String(error)),\n\t\t\t};\n\t\t}\n\t}\n\n\t/**\n\t * Add a client to this channel with full coordination\n\t * Handles: membership + WebSocket subscription + client-side tracking + optional notification\n\t * This ensures two-way coordination between channel and client\n\t */\n\tpublic addMember(client: I_WebsocketClient, options?: AddMemberOptions): AddMemberResult {\n\t\t// 1. Atomic membership add\n\t\tconst result = this.addToMembersMap(client, options);\n\t\tif (!result.success) {\n\t\t\treturn result;\n\t\t}\n\n\t\ttry {\n\t\t\t// 2. Subscribe client's WebSocket to channel pub/sub topic\n\t\t\t// CRITICAL: Without this, client won't receive channel.broadcast() messages\n\t\t\tclient.subscribe(this.id);\n\n\t\t\t// 3. Track channel on client side (client's channels map)\n\t\t\tclient.trackChannel(this);\n\n\t\t\t// 4. Optional welcome notification\n\t\t\tif (options?.notify) {\n\t\t\t\tclient.send({\n\t\t\t\t\ttype: E_WebsocketMessageType.CLIENT_JOIN_CHANNEL,\n\t\t\t\t\tcontent: { message: \"Welcome to the channel\" },\n\t\t\t\t\tchannel: this.id,\n\t\t\t\t\tclient: client.whoami(),\n\t\t\t\t});\n\t\t\t}\n\n\t\t\treturn result;\n\t\t} catch (error) {\n\t\t\t// Rollback on failure: remove membership + unsubscribe + untrack\n\t\t\tthis.removeFromMembersMap(client);\n\t\t\tclient.unsubscribe(this.id);\n\t\t\tclient.untrackChannel(this);\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tpublic addMembers(clients: I_WebsocketClient[], options?: AddMemberOptions): AddMemberResult[] {\n\t\tconst results: AddMemberResult[] = [];\n\t\tfor (const client of clients) {\n\t\t\tconst result = this.addMember(client, options);\n\t\t\tresults.push(result);\n\t\t\tif (!result.success) {\n\t\t\t\t// Stop adding further members on failure\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t\treturn results;\n\t}\n\n\tprivate notifyChannelFull(client: I_WebsocketClient): void {\n\t\tclient.send({\n\t\t\ttype: E_WebsocketMessageType.ERROR,\n\t\t\tcontent: {\n\t\t\t\tmessage: `Channel \"${this.name}\" is full (${this.limit} members)`,\n\t\t\t\tcode: \"CHANNEL_FULL\",\n\t\t\t\tchannel: this.id,\n\t\t\t},\n\t\t});\n\t}\n\n\t/**\n\t * Internal method to remove a member without triggering client-side cleanup.\n\t * Used for rollback operations when joinChannel fails.\n\t * @internal\n\t */\n\tpublic removeFromMembersMap(client: I_WebsocketClient): void {\n\t\tthis.members.delete(client.id);\n\t}\n\n\t/**\n\t * Remove a client from this channel with full coordination\n\t * Handles: membership removal + WebSocket unsubscription + client-side tracking removal + optional notification\n\t * This ensures two-way coordination between channel and client\n\t */\n\tpublic removeMember(entity: I_WebsocketEntity, options?: RemoveMemberOptions) {\n\t\t// 1. Check if member exists\n\t\tif (!this.members.has(entity.id)) return false;\n\t\tconst client = this.members.get(entity.id);\n\t\tif (!client) return false;\n\n\t\t// 2. Remove from channel members (atomic operation)\n\t\tthis.removeFromMembersMap(client);\n\n\t\t// 3. Unsubscribe client's WebSocket from channel pub/sub topic\n\t\tclient.unsubscribe(this.id);\n\n\t\t// 4. Untrack channel on client side (remove from client's channels map)\n\t\tclient.untrackChannel(this);\n\n\t\t// 5. Optional goodbye notification\n\t\tif (options?.notify) {\n\t\t\tclient.send({\n\t\t\t\ttype: E_WebsocketMessageType.CLIENT_LEAVE_CHANNEL,\n\t\t\t\tcontent: { message: \"You left the channel\" },\n\t\t\t\tchannel: this.id,\n\t\t\t\tclient: client.whoami(),\n\t\t\t});\n\t\t}\n\n\t\treturn client;\n\t}\n\n\tpublic getMember(client: I_WebsocketEntity | string) {\n\t\tif (typeof client === \"string\") return this.members.get(client);\n\t\treturn this.members.get(client.id);\n\t}\n\n\tpublic getMembers(clients?: string[] | I_WebsocketEntity[]): I_WebsocketClient[] {\n\t\tif (!clients) return Array.from(this.members.values());\n\t\treturn clients.map((client) => this.getMember(client)).filter((client) => client !== undefined) as I_WebsocketClient[];\n\t}\n\n\tpublic getMetadata() {\n\t\treturn this.metadata;\n\t}\n\n\tpublic getCreatedAt() {\n\t\treturn this.createdAt;\n\t}\n\n\tpublic getId() {\n\t\treturn this.id;\n\t}\n\n\tpublic getName() {\n\t\treturn this.name;\n\t}\n\n\tpublic getLimit() {\n\t\treturn this.limit;\n\t}\n\n\tpublic getSize() {\n\t\treturn this.members.size;\n\t}\n\n\tpublic canAddMember() {\n\t\tconst size = this.getSize();\n\t\treturn size < this.limit;\n\t}\n\n\tpublic delete() {\n\t\t//first remove all members\n\t\tthis.members.forEach((member) => {\n\t\t\tthis.removeMember(member, { notify: true });\n\t\t});\n\t\t//then clear members map\n\t\tthis.members.clear();\n\t}\n\n\tpublic static GetChannelType(channels: WebsocketChannel<I_WebsocketChannel> | undefined) {\n\t\tif (!channels) return Channel;\n\t\tif (channels.size > 0) {\n\t\t\tconst firstChannel = channels.values().next().value;\n\t\t\tif (firstChannel) {\n\t\t\t\treturn firstChannel.constructor as typeof Channel;\n\t\t\t} else {\n\t\t\t\treturn Channel;\n\t\t\t}\n\t\t} else {\n\t\t\tLib.Warn(\"Channels are empty, using default channel class\");\n\t\t\treturn Channel;\n\t\t}\n\t}\n}\n"]}

package/dist/server/bun/websocket/Client.d.ts

@@ -1,87 +0,0 @@
-import { ServerWebSocket } from "bun";
-import type { I_WebsocketClient, WebsocketEntityData, WebsocketChannel, WebsocketStructuredMessage, I_WebsocketEntity, I_WebsocketChannel, WebsocketMessageOptions } from "./websocket.types";
-import { E_ClientState } from "./websocket.enums";
-/**
- * Client - Connected WebSocket client with channel membership
- *
- * ## Channel Membership
- * - Maintains own channel list and handles Bun pub/sub subscriptions
- * - `joinChannel()` adds to channel, subscribes, and handles rollback on failure
- * - Always use `channel.addMember(client)` in application code, not `client.joinChannel()` directly
- *
- * @example
- * // ✅ Correct
- * channel.addMember(client);
- *
- * // ❌ Incorrect - internal use only
- * client.joinChannel(channel);
- */
-export default class Client implements I_WebsocketClient {
-    private _id;
-    private _name;
-    private _ws;
-    private _channels;
-    private _state;
-    private _connectedAt?;
-    private _disconnectedAt?;
-    private set ws(value);
-    get ws(): ServerWebSocket<WebsocketEntityData>;
-    private set id(value);
-    get id(): string;
-    get name(): string;
-    private set name(value);
-    private set channels(value);
-    get channels(): WebsocketChannel<I_WebsocketChannel>;
-    get state(): E_ClientState;
-    constructor(entity: I_WebsocketEntity);
-    canReceiveMessages(): boolean;
-    markConnected(): void;
-    markDisconnecting(): void;
-    markDisconnected(): void;
-    getConnectionInfo(): {
-        id: string;
-        name: string;
-        state: E_ClientState;
-        connectedAt: Date | undefined;
-        disconnectedAt: Date | undefined;
-        uptime: number;
-        channelCount: number;
-    };
-    /**
-     * HELPER: Track channel on client side (for channel.addMember coordination)
-     * Allows channel to update client's internal channel map
-     * @internal Used by channel.addMember()
-     */
-    trackChannel(channel: I_WebsocketChannel): void;
-    /**
-     * HELPER: Untrack channel on client side (for channel.addMember rollback)
-     * Allows channel to remove from client's internal channel map during rollback
-     * @internal Used by channel.addMember() error handling
-     */
-    untrackChannel(channel: I_WebsocketChannel): void;
-    /**
-     * Join a channel (thin wrapper that delegates to channel.addMember)
-     * channel.addMember() handles all coordination: membership + subscription + tracking + notification
-     */
-    joinChannel(channel: I_WebsocketChannel, send?: boolean): {
-        success: boolean;
-        reason: string;
-    };
-    /**
-     * Leave a channel (thin wrapper that delegates to channel.removeMember)
-     * channel.removeMember() handles all coordination: membership removal + unsubscription + tracking removal + notification
-     */
-    leaveChannel(channel: I_WebsocketChannel, send?: boolean): void;
-    joinChannels(channels: I_WebsocketChannel[], send?: boolean): void;
-    leaveChannels(channels?: I_WebsocketChannel[], send?: boolean): void;
-    whoami(): {
-        id: string;
-        name: string;
-    };
-    send(message: string, options?: WebsocketMessageOptions): void;
-    send(message: WebsocketStructuredMessage): void;
-    subscribe(channel: string): void;
-    unsubscribe(channel: string): void;
-    static GetClientType(clients: Map<string, I_WebsocketClient> | undefined): typeof Client;
-    static System(): WebsocketEntityData;
-}