@skalfa/skalfa-socket-client 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Skalfa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,56 @@
+<p align="center">
+  <img src="https://skalfa.sejedigital.com/images/logo-skalfa.png" alt="Skalfa Logo" width="300" />
+</p>
+
+# @skalfa/skalfa-socket-client
+
+> Real-time Socket.io client wrapper and dynamic hooks extension for Skalfa Next.js applications.
+
+---
+
+## About this Package
+
+This package is part of the **Skalfa Framework**, a premium development ecosystem designed to build high-performance, modular web applications and APIs.
+
+### Usage Scope & Standalone Status
+> 🔒 **Skalfa Ecosystem Integration:** This package is designed to run **integrated within the Skalfa ecosystem** (such as Skalfa API or Skalfa App). It relies on the global service registry and core framework abstractions to operate.
+
+---
+
+## Documentation
+
+See the usage documentation at [Documentation](https://skalfa.sejedigital.com).
+
+---
+
+## Installation
+
+You can install this package using your preferred package manager:
+
+```bash
+# Using npm
+npm install @skalfa/skalfa-socket-client
+
+# Using bun
+bun add @skalfa/skalfa-socket-client
+```
+
+---
+
+## Pre-installed Dependencies
+
+The following key dependencies are packaged and managed within this project:
+
+| Dependency | Scope | Version |
+| :--- | :--- | :--- |
+| `socket.io-client` | runtime | `^4.7.5` |
+| `@types/node` | development | `^20.0.0` |
+| `@types/react` | development | `^19.0.0` |
+| `@types/react-dom` | development | `^19.0.0` |
+| `typescript` | development | `^6.0.3` |
+
+---
+
+## License
+
+This package is licensed under the **MIT License**. For full license text, see the [LICENSE](LICENSE) file.

package/dist/connect.d.ts

@@ -0,0 +1,2 @@
+import { Socket } from "socket.io-client";
+export declare function connect(): Socket | null;

package/dist/connect.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connect = connect;
+const socket_io_client_1 = require("socket.io-client");
+const skalfa_app_core_1 = require("@skalfa/skalfa-app-core");
+const state_1 = require("./state");
+function connect() {
+    if (state_1.host) {
+        if (!state_1.s) {
+            const socket = (0, socket_io_client_1.io)(state_1.host, {
+                autoConnect: true,
+                transports: ["websocket"],
+                reconnection: true,
+                reconnectionAttempts: 5,
+                reconnectionDelay: 2000,
+                withCredentials: true,
+            });
+            (0, state_1.setS)(socket);
+            socket.on("connect", () => {
+                skalfa_app_core_1.logger.socket("server connected:", socket?.id);
+            });
+            socket.on("disconnect", (reason) => {
+                skalfa_app_core_1.logger.socketError("server disconnected:", reason);
+            });
+            socket.on("connect_error", (err) => {
+                skalfa_app_core_1.logger.socketError("server connection error:", err.message);
+            });
+        }
+        else if (state_1.s.disconnected) {
+            state_1.s.connect();
+        }
+    }
+    return state_1.s;
+}

package/dist/disconnect.d.ts

@@ -0,0 +1 @@
+export declare function disconnect(): void;

package/dist/disconnect.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.disconnect = disconnect;
+const state_1 = require("./state");
+function disconnect() {
+    if (state_1.s) {
+        state_1.s.disconnect();
+        (0, state_1.setS)(null);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { connect } from "./connect";
+import { disconnect } from "./disconnect";
+import { useSocket } from "./use-socket";
+export { useSocket };
+export declare const socket: {
+    connect: typeof connect;
+    disconnect: typeof disconnect;
+};

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.socket = exports.useSocket = void 0;
+const skalfa_app_core_1 = require("@skalfa/skalfa-app-core");
+const connect_1 = require("./connect");
+const disconnect_1 = require("./disconnect");
+const use_socket_1 = require("./use-socket");
+Object.defineProperty(exports, "useSocket", { enumerable: true, get: function () { return use_socket_1.useSocket; } });
+exports.socket = {
+    // ==============================>
+    // ## Socket: connect to server
+    // ==============================>
+    connect: connect_1.connect,
+    // ==============================>
+    // ## Socket: disconnect from server
+    // ==============================>
+    disconnect: disconnect_1.disconnect,
+};
+skalfa_app_core_1.registry.register("socket", exports.socket);

package/dist/state.d.ts

@@ -0,0 +1,4 @@
+import { Socket } from "socket.io-client";
+export declare const host: any;
+export declare let s: Socket | null;
+export declare function setS(socket: Socket | null): void;

package/dist/state.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.s = exports.host = void 0;
+exports.setS = setS;
+exports.host = globalThis.process?.env?.NEXT_PUBLIC_SOCKET_URL;
+exports.s = null;
+function setS(socket) {
+    exports.s = socket;
+}

package/dist/use-socket.d.ts

@@ -0,0 +1,4 @@
+import { Socket } from "socket.io-client";
+export declare const useSocket: () => {
+    socket: Socket | null;
+};

package/dist/use-socket.js

@@ -0,0 +1,18 @@
+"use client";
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSocket = void 0;
+const react_1 = require("react");
+const index_1 = require("./index");
+const useSocket = () => {
+    const [socketState, setSocketState] = (0, react_1.useState)(null);
+    (0, react_1.useEffect)(() => {
+        const soc = index_1.socket.connect();
+        setSocketState(soc);
+        return () => {
+            soc?.off();
+        };
+    }, []);
+    return { socket: socketState };
+};
+exports.useSocket = useSocket;

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@skalfa/skalfa-socket-client",
+  "version": "1.0.3",
+  "description": "Real-time Socket.io client wrapper and dynamic hooks extension for Skalfa Next.js applications.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "keywords": [
+    "skalfa",
+    "frontend",
+    "socket"
+  ],
+  "author": "",
+  "license": "UNLICENSED",
+  "dependencies": {
+    "socket.io-client": "^4.7.5"
+  },
+  "peerDependencies": {
+    "@skalfa/skalfa-app-core": "^1.0.0",
+    "next": "^15.0.0 || ^16.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@skalfa/skalfa-app-core": "^1.0.0",
+    "@types/node": "^20.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "next": "16.1.1",
+    "react": "^19.2.1",
+    "react-dom": "^19.2.1",
+    "typescript": "^6.0.3"
+  }
+}