@venizia/ignis 0.0.6 → 0.0.7-1

package/dist/components/socket-io/handlers/node.handler.d.ts

@@ -0,0 +1,9 @@
+import type { TNodeServerInstance } from '../../../base/applications';
+import { SocketIOServerHelper } from '@venizia/ignis-helpers';
+import type { IResolvedBindings, IServerOptions } from '../common';
+export declare function createNodeSocketIOHelper(opts: {
+    serverOptions: Partial<IServerOptions>;
+    httpServer: TNodeServerInstance;
+    resolvedBindings: IResolvedBindings;
+}): Promise<SocketIOServerHelper>;
+//# sourceMappingURL=node.handler.d.ts.map

package/dist/components/socket-io/handlers/node.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.handler.d.ts","sourceRoot":"","sources":["../../../../src/components/socket-io/handlers/node.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAkB,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEnE,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACvC,UAAU,EAAE,mBAAmB,CAAC;IAChC,gBAAgB,EAAE,iBAAiB,CAAC;CACrC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAiBhC"}

package/dist/components/socket-io/handlers/node.handler.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNodeSocketIOHelper = createNodeSocketIOHelper;
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+async function createNodeSocketIOHelper(opts) {
+    const { serverOptions, httpServer, resolvedBindings } = opts;
+    const { redisConnection, authenticateFn, validateRoomFn, clientConnectedFn } = resolvedBindings;
+    const socketIOHelper = new ignis_helpers_1.SocketIOServerHelper({
+        runtime: ignis_helpers_1.RuntimeModules.NODE,
+        identifier: serverOptions.identifier,
+        server: httpServer,
+        serverOptions,
+        redisConnection,
+        authenticateFn,
+        validateRoomFn,
+        clientConnectedFn,
+    });
+    await socketIOHelper.configure();
+    return socketIOHelper;
+}
+//# sourceMappingURL=node.handler.js.map

package/dist/components/socket-io/handlers/node.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.handler.js","sourceRoot":"","sources":["../../../../src/components/socket-io/handlers/node.handler.ts"],"names":[],"mappings":";;AAIA,4DAqBC;AAxBD,0DAA8E;AAGvE,KAAK,UAAU,wBAAwB,CAAC,IAI9C;IACC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IAC7D,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,GAAG,gBAAgB,CAAC;IAEhG,MAAM,cAAc,GAAG,IAAI,oCAAoB,CAAC;QAC9C,OAAO,EAAE,8BAAc,CAAC,IAAI;QAC5B,UAAU,EAAE,aAAa,CAAC,UAAW;QACrC,MAAM,EAAE,UAAU;QAClB,aAAa;QACb,eAAe;QACf,cAAc;QACd,cAAc;QACd,iBAAiB;KAClB,CAAC,CAAC;IACH,MAAM,cAAc,CAAC,SAAS,EAAE,CAAC;IAEjC,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/components/socket-io/index.d.ts

@@ -1,3 +1,3 @@
+export * from './common/keys';
 export * from './component';
-export * from './keys';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/socket-io/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/socket-io/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/socket-io/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/components/socket-io/index.js

@@ -14,6 +14,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./common/keys"), exports);
 __exportStar(require("./component"), exports);
-__exportStar(require("./keys"), exports);
 //# sourceMappingURL=index.js.map

package/dist/components/socket-io/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/socket-io/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,yCAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/socket-io/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,8CAA4B"}

package/dist/components/websocket/common/index.d.ts

@@ -0,0 +1,3 @@
+export * from './keys';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/websocket/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/websocket/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/dist/components/websocket/common/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./keys"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/components/websocket/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/websocket/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,0CAAwB"}

package/dist/components/websocket/common/keys.d.ts

@@ -0,0 +1,11 @@
+export declare class WebSocketBindingKeys {
+    static readonly WEBSOCKET_INSTANCE = "@app/websocket/instance";
+    static readonly SERVER_OPTIONS = "@app/websocket/server-options";
+    static readonly REDIS_CONNECTION = "@app/websocket/redis-connection";
+    static readonly AUTHENTICATE_HANDLER = "@app/websocket/authenticate-handler";
+    static readonly VALIDATE_ROOM_HANDLER = "@app/websocket/validate-room-handler";
+    static readonly CLIENT_CONNECTED_HANDLER = "@app/websocket/client-connected-handler";
+    static readonly CLIENT_DISCONNECTED_HANDLER = "@app/websocket/client-disconnected-handler";
+    static readonly MESSAGE_HANDLER = "@app/websocket/message-handler";
+}
+//# sourceMappingURL=keys.d.ts.map

package/dist/components/websocket/common/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../../src/components/websocket/common/keys.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,QAAQ,CAAC,kBAAkB,6BAA6B;IAE/D,MAAM,CAAC,QAAQ,CAAC,cAAc,mCAAmC;IACjE,MAAM,CAAC,QAAQ,CAAC,gBAAgB,qCAAqC;IAErE,MAAM,CAAC,QAAQ,CAAC,oBAAoB,yCAAyC;IAC7E,MAAM,CAAC,QAAQ,CAAC,qBAAqB,0CAA0C;IAC/E,MAAM,CAAC,QAAQ,CAAC,wBAAwB,6CAA6C;IACrF,MAAM,CAAC,QAAQ,CAAC,2BAA2B,gDAAgD;IAC3F,MAAM,CAAC,QAAQ,CAAC,eAAe,oCAAoC;CACpE"}

package/dist/components/websocket/common/keys.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketBindingKeys = void 0;
+class WebSocketBindingKeys {
+    static { this.WEBSOCKET_INSTANCE = '@app/websocket/instance'; }
+    static { this.SERVER_OPTIONS = '@app/websocket/server-options'; }
+    static { this.REDIS_CONNECTION = '@app/websocket/redis-connection'; }
+    static { this.AUTHENTICATE_HANDLER = '@app/websocket/authenticate-handler'; }
+    static { this.VALIDATE_ROOM_HANDLER = '@app/websocket/validate-room-handler'; }
+    static { this.CLIENT_CONNECTED_HANDLER = '@app/websocket/client-connected-handler'; }
+    static { this.CLIENT_DISCONNECTED_HANDLER = '@app/websocket/client-disconnected-handler'; }
+    static { this.MESSAGE_HANDLER = '@app/websocket/message-handler'; }
+}
+exports.WebSocketBindingKeys = WebSocketBindingKeys;
+//# sourceMappingURL=keys.js.map

package/dist/components/websocket/common/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../../src/components/websocket/common/keys.ts"],"names":[],"mappings":";;;AAAA,MAAa,oBAAoB;aACf,uBAAkB,GAAG,yBAAyB,CAAC;aAE/C,mBAAc,GAAG,+BAA+B,CAAC;aACjD,qBAAgB,GAAG,iCAAiC,CAAC;aAErD,yBAAoB,GAAG,qCAAqC,CAAC;aAC7D,0BAAqB,GAAG,sCAAsC,CAAC;aAC/D,6BAAwB,GAAG,yCAAyC,CAAC;aACrE,gCAA2B,GAAG,4CAA4C,CAAC;aAC3E,oBAAe,GAAG,gCAAgC,CAAC;;AAVrE,oDAWC"}

package/dist/components/websocket/common/types.d.ts

@@ -0,0 +1,19 @@
+import type { DefaultRedisHelper, IBunWebSocketConfig, TWebSocketAuthenticateFn, TWebSocketClientConnectedFn, TWebSocketClientDisconnectedFn, TWebSocketMessageHandler, TWebSocketValidateRoomFn } from '@venizia/ignis-helpers';
+export interface IServerOptions {
+    identifier: string;
+    path?: string;
+    defaultRooms?: string[];
+    serverOptions?: IBunWebSocketConfig;
+    heartbeatInterval?: number;
+    heartbeatTimeout?: number;
+}
+export declare const DEFAULT_SERVER_OPTIONS: IServerOptions;
+export interface IResolvedBindings {
+    redisConnection: DefaultRedisHelper;
+    authenticateFn: TWebSocketAuthenticateFn;
+    validateRoomFn?: TWebSocketValidateRoomFn;
+    clientConnectedFn?: TWebSocketClientConnectedFn;
+    clientDisconnectedFn?: TWebSocketClientDisconnectedFn;
+    messageHandler?: TWebSocketMessageHandler;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/websocket/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/websocket/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,8BAA8B,EAC9B,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,wBAAwB,CAAC;AAGhC,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,sBAAsB,EAAE,cAGpC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,kBAAkB,CAAC;IACpC,cAAc,EAAE,wBAAwB,CAAC;IACzC,cAAc,CAAC,EAAE,wBAAwB,CAAC;IAC1C,iBAAiB,CAAC,EAAE,2BAA2B,CAAC;IAChD,oBAAoB,CAAC,EAAE,8BAA8B,CAAC;IACtD,cAAc,CAAC,EAAE,wBAAwB,CAAC;CAC3C"}

package/dist/components/websocket/common/types.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SERVER_OPTIONS = void 0;
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+exports.DEFAULT_SERVER_OPTIONS = {
+    identifier: 'WEBSOCKET_SERVER',
+    path: ignis_helpers_1.WebSocketDefaults.PATH,
+};
+//# sourceMappingURL=types.js.map

package/dist/components/websocket/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/components/websocket/common/types.ts"],"names":[],"mappings":";;;AASA,0DAA2D;AAW9C,QAAA,sBAAsB,GAAmB;IACpD,UAAU,EAAE,kBAAkB;IAC9B,IAAI,EAAE,iCAAiB,CAAC,IAAI;CAC7B,CAAC"}

package/dist/components/websocket/component.d.ts

@@ -0,0 +1,13 @@
+import { BaseApplication } from '../../base/applications';
+import { BaseComponent } from '../../base/components';
+import { ValueOrPromise } from '@venizia/ignis-helpers';
+import { type IServerOptions } from './common';
+export declare class WebSocketComponent extends BaseComponent {
+    private application;
+    protected serverOptions: IServerOptions;
+    constructor(application: BaseApplication);
+    private resolveBindings;
+    private registerBunHook;
+    binding(): ValueOrPromise<void>;
+}
+//# sourceMappingURL=component.d.ts.map

package/dist/components/websocket/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../src/components/websocket/component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAsB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIlD,OAAO,EAWL,cAAc,EAGf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,UAAU,CAAC;AAGlB,qBAAa,kBAAmB,SAAQ,aAAa;IAIG,OAAO,CAAC,WAAW;IAHzE,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC;gBAGsB,WAAW,EAAE,eAAe;IA0C1F,OAAO,CAAC,eAAe;IAuDvB,OAAO,CAAC,eAAe;IAyDd,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC;CA2BzC"}

package/dist/components/websocket/component.js

@@ -0,0 +1,169 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var WebSocketComponent_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketComponent = void 0;
+const applications_1 = require("../../base/applications");
+const components_1 = require("../../base/components");
+const metadata_1 = require("../../base/metadata");
+const bindings_1 = require("../../common/bindings");
+const inversion_1 = require("../../helpers/inversion");
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+const common_1 = require("./common");
+const handlers_1 = require("./handlers");
+let WebSocketComponent = WebSocketComponent_1 = class WebSocketComponent extends components_1.BaseComponent {
+    constructor(application) {
+        super({
+            scope: WebSocketComponent_1.name,
+            initDefault: { enable: true, container: application },
+            bindings: {
+                [common_1.WebSocketBindingKeys.SERVER_OPTIONS]: inversion_1.Binding.bind({
+                    key: common_1.WebSocketBindingKeys.SERVER_OPTIONS,
+                }).toValue(common_1.DEFAULT_SERVER_OPTIONS),
+                [common_1.WebSocketBindingKeys.REDIS_CONNECTION]: inversion_1.Binding.bind({
+                    key: common_1.WebSocketBindingKeys.REDIS_CONNECTION,
+                }).toValue(null),
+                [common_1.WebSocketBindingKeys.AUTHENTICATE_HANDLER]: inversion_1.Binding.bind({
+                    key: common_1.WebSocketBindingKeys.AUTHENTICATE_HANDLER,
+                }).toValue(null),
+                [common_1.WebSocketBindingKeys.VALIDATE_ROOM_HANDLER]: inversion_1.Binding.bind({
+                    key: common_1.WebSocketBindingKeys.VALIDATE_ROOM_HANDLER,
+                }).toValue(null),
+                [common_1.WebSocketBindingKeys.CLIENT_CONNECTED_HANDLER]: inversion_1.Binding.bind({
+                    key: common_1.WebSocketBindingKeys.CLIENT_CONNECTED_HANDLER,
+                }).toValue(null),
+                [common_1.WebSocketBindingKeys.CLIENT_DISCONNECTED_HANDLER]: inversion_1.Binding.bind({
+                    key: common_1.WebSocketBindingKeys.CLIENT_DISCONNECTED_HANDLER,
+                }).toValue(null),
+                [common_1.WebSocketBindingKeys.MESSAGE_HANDLER]: inversion_1.Binding.bind({
+                    key: common_1.WebSocketBindingKeys.MESSAGE_HANDLER,
+                }).toValue(null),
+            },
+        });
+        this.application = application;
+    }
+    // --------------------------------------------------------------------------
+    resolveBindings() {
+        const extraServerOptions = this.application.get({
+            key: common_1.WebSocketBindingKeys.SERVER_OPTIONS,
+            isOptional: true,
+        }) ?? {};
+        this.serverOptions = Object.assign({}, common_1.DEFAULT_SERVER_OPTIONS, extraServerOptions);
+        const redisConnection = this.application.get({
+            key: common_1.WebSocketBindingKeys.REDIS_CONNECTION,
+        });
+        if (!(redisConnection instanceof ignis_helpers_1.DefaultRedisHelper)) {
+            throw (0, ignis_helpers_1.getError)({
+                message: '[WebSocketComponent][resolveBindings] Invalid instance of redisConnection | Please init connection with RedisHelper for single redis connection or RedisClusterHelper for redis cluster mode!',
+            });
+        }
+        const authenticateFn = this.application.get({
+            key: common_1.WebSocketBindingKeys.AUTHENTICATE_HANDLER,
+        });
+        if (!authenticateFn) {
+            throw (0, ignis_helpers_1.getError)({
+                message: '[WebSocketComponent] Invalid authenticateFn to setup WebSocket server!',
+            });
+        }
+        const validateRoomFn = this.application.get({
+            key: common_1.WebSocketBindingKeys.VALIDATE_ROOM_HANDLER,
+        }) ?? undefined;
+        const clientConnectedFn = this.application.get({
+            key: common_1.WebSocketBindingKeys.CLIENT_CONNECTED_HANDLER,
+        }) ?? undefined;
+        const clientDisconnectedFn = this.application.get({
+            key: common_1.WebSocketBindingKeys.CLIENT_DISCONNECTED_HANDLER,
+        }) ?? undefined;
+        const messageHandler = this.application.get({
+            key: common_1.WebSocketBindingKeys.MESSAGE_HANDLER,
+        }) ?? undefined;
+        return {
+            redisConnection,
+            authenticateFn,
+            validateRoomFn,
+            clientConnectedFn,
+            clientDisconnectedFn,
+            messageHandler,
+        };
+    }
+    // --------------------------------------------------------------------------
+    registerBunHook(opts) {
+        const { redisConnection, authenticateFn, validateRoomFn, clientConnectedFn, clientDisconnectedFn, messageHandler, } = opts;
+        const serverOptions = this.serverOptions;
+        const logger = this.logger.for(this.registerBunHook.name);
+        this.application.registerPostStartHook({
+            identifier: 'websocket-initialize',
+            hook: async () => {
+                const serverInstance = this.application.getServerInstance();
+                const honoServer = this.application.getServer();
+                if (!serverInstance) {
+                    throw (0, ignis_helpers_1.getError)({
+                        message: '[WebSocketComponent] Bun server instance not available!',
+                    });
+                }
+                const wsHelper = new ignis_helpers_1.WebSocketServerHelper({
+                    identifier: serverOptions.identifier,
+                    path: serverOptions.path,
+                    defaultRooms: serverOptions.defaultRooms,
+                    serverOptions: serverOptions.serverOptions,
+                    heartbeatInterval: serverOptions.heartbeatInterval,
+                    heartbeatTimeout: serverOptions.heartbeatTimeout,
+                    server: serverInstance,
+                    redisConnection,
+                    authenticateFn,
+                    validateRoomFn,
+                    clientConnectedFn,
+                    clientDisconnectedFn,
+                    messageHandler,
+                });
+                await wsHelper.configure();
+                this.application.bind({ key: common_1.WebSocketBindingKeys.WEBSOCKET_INSTANCE }).toValue(wsHelper);
+                const wsPath = serverOptions.path ?? ignis_helpers_1.WebSocketDefaults.PATH;
+                serverInstance.reload({
+                    fetch: (0, handlers_1.createBunFetchHandler)({ wsPath, honoServer }),
+                    websocket: wsHelper.getBunWebSocketHandler(),
+                });
+                logger.info('WebSocket initialized for Bun runtime');
+            },
+        });
+    }
+    // --------------------------------------------------------------------------
+    binding() {
+        const logger = this.logger.for(this.binding.name);
+        if (!this.application) {
+            throw (0, ignis_helpers_1.getError)({
+                statusCode: ignis_helpers_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                message: '[binding] Invalid application to bind WebSocketComponent',
+            });
+        }
+        logger.info('Binding WebSocket for application...');
+        // Runtime check — Bun only
+        const runtime = ignis_helpers_1.RuntimeModules.detect();
+        if (runtime === ignis_helpers_1.RuntimeModules.NODE) {
+            throw (0, ignis_helpers_1.getError)({
+                statusCode: ignis_helpers_1.HTTP.ResultCodes.RS_5.InternalServerError,
+                message: '[WebSocketComponent] Node.js runtime is not supported yet. Please use Bun runtime.',
+            });
+        }
+        const resolved = this.resolveBindings();
+        logger.debug('WebSocket Server Options: %j', this.serverOptions);
+        this.registerBunHook(resolved);
+    }
+};
+exports.WebSocketComponent = WebSocketComponent;
+exports.WebSocketComponent = WebSocketComponent = WebSocketComponent_1 = __decorate([
+    __param(0, (0, metadata_1.inject)({ key: bindings_1.CoreBindings.APPLICATION_INSTANCE })),
+    __metadata("design:paramtypes", [applications_1.BaseApplication])
+], WebSocketComponent);
+//# sourceMappingURL=component.js.map

package/dist/components/websocket/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../../../src/components/websocket/component.ts"],"names":[],"mappings":"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"}

package/dist/components/websocket/handlers/bun.handler.d.ts

@@ -0,0 +1,7 @@
+import type { OpenAPIHono } from '@hono/zod-openapi';
+import type { TBunServerInstance } from '../../../base/applications';
+export declare function createBunFetchHandler(opts: {
+    wsPath: string;
+    honoServer: OpenAPIHono;
+}): (req: Request, server: TBunServerInstance) => Promise<Response | undefined>;
+//# sourceMappingURL=bun.handler.d.ts.map

package/dist/components/websocket/handlers/bun.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun.handler.d.ts","sourceRoot":"","sources":["../../../../src/components/websocket/handlers/bun.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,WAAW,CAAC;CACzB,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CA0B9E"}

package/dist/components/websocket/handlers/bun.handler.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBunFetchHandler = createBunFetchHandler;
+function createBunFetchHandler(opts) {
+    const { wsPath, honoServer } = opts;
+    return async (req, server) => {
+        const url = new URL(req.url);
+        const isWebSocketUpgrade = url.pathname === wsPath && req.headers.get('upgrade')?.toLowerCase() === 'websocket';
+        // Not a WebSocket request — delegate to Hono
+        if (!isWebSocketUpgrade) {
+            return honoServer.fetch(req, server);
+        }
+        // Accept connection — authentication happens post-connect via 'authenticate' event
+        const isUpgraded = server.upgrade(req, {
+            data: {
+                clientId: crypto.randomUUID(),
+            },
+        });
+        if (!isUpgraded) {
+            return new Response('WebSocket upgrade failed', { status: 500 });
+        }
+        return undefined;
+    };
+}
+//# sourceMappingURL=bun.handler.js.map

package/dist/components/websocket/handlers/bun.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun.handler.js","sourceRoot":"","sources":["../../../../src/components/websocket/handlers/bun.handler.ts"],"names":[],"mappings":";;AAGA,sDA6BC;AA7BD,SAAgB,qBAAqB,CAAC,IAGrC;IACC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAEpC,OAAO,KAAK,EAAE,GAAY,EAAE,MAA0B,EAAiC,EAAE;QACvF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,kBAAkB,GACtB,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,KAAK,WAAW,CAAC;QAEvF,6CAA6C;QAC7C,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxB,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC;QAED,mFAAmF;QACnF,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;YACrC,IAAI,EAAE;gBACJ,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE;aAC9B;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,QAAQ,CAAC,0BAA0B,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,SAAgC,CAAC;IAC1C,CAAC,CAAC;AACJ,CAAC"}

package/dist/components/websocket/handlers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './bun.handler';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/websocket/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/websocket/handlers/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/components/websocket/handlers/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./bun.handler"), exports);
+//# sourceMappingURL=index.js.map

package/dist/components/websocket/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/websocket/handlers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B"}

package/dist/components/websocket/index.d.ts

@@ -0,0 +1,3 @@
+export * from './common/keys';
+export * from './component';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/websocket/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/websocket/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/components/websocket/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./common/keys"), exports);
+__exportStar(require("./component"), exports);
+//# sourceMappingURL=index.js.map

package/dist/components/websocket/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/websocket/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,8CAA4B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/ignis",
-  "version": "0.0.6",
+  "version": "0.0.7-1",
   "description": "JS/TS Server Infrastructure with Hono Framework",
   "keywords": [
     "hono",
@@ -99,7 +99,7 @@
   "license": "MIT",
   "dependencies": {
     "@venizia/ignis-boot": "^0.0.3",
-    "@venizia/ignis-helpers": "^0.0.5",
+    "@venizia/ignis-helpers": "^0.0.6-1",
     "@venizia/ignis-inversion": "^0.0.5",
     "lodash": "^4.17.21",
     "reflect-metadata": "^0.2.2"

package/dist/components/socket-io/keys.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/components/socket-io/keys.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,kBAAkB,6BAA6B;IAE/D,MAAM,CAAC,QAAQ,CAAC,cAAc,mCAAmC;IACjE,MAAM,CAAC,QAAQ,CAAC,gBAAgB,qCAAqC;IAErE,MAAM,CAAC,QAAQ,CAAC,oBAAoB,yCAAyC;IAC7E,MAAM,CAAC,QAAQ,CAAC,qBAAqB,0CAA0C;IAC/E,MAAM,CAAC,QAAQ,CAAC,wBAAwB,6CAA6C;CACtF"}

package/dist/components/socket-io/keys.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/components/socket-io/keys.ts"],"names":[],"mappings":";;;AAAA,MAAa,mBAAmB;aACd,uBAAkB,GAAG,yBAAyB,CAAC;aAE/C,mBAAc,GAAG,+BAA+B,CAAC;aACjD,qBAAgB,GAAG,iCAAiC,CAAC;aAErD,yBAAoB,GAAG,qCAAqC,CAAC;aAC7D,0BAAqB,GAAG,sCAAsC,CAAC;aAC/D,6BAAwB,GAAG,yCAAyC,CAAC;;AARvF,kDASC"}