@utsp/network-client 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Thomas Piquet
+
+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,36 @@
+# @utsp/network-client
+
+> ⚠️ **PROTOTYPE - NOT READY FOR PRODUCTION**
+>
+> This package is currently in early development and should **NOT** be used in production.
+> The API is unstable and subject to breaking changes without notice.
+
+Client-side network communication layer for UTSP (Universal Text Stream Protocol).
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## ⚠️ Development Status
+
+**This is a prototype package under active development.**
+
+- ❌ No stable API
+- ❌ No documentation available yet
+- ❌ Breaking changes expected
+- ❌ Not recommended for production use
+
+**Please check back later for updates or watch the repository for release announcements.**
+
+## Installation
+
+```bash
+npm install @utsp/network-client
+```
+
+## Repository
+
+- [GitHub](https://github.com/thp-software/utsp)
+- [Issues](https://github.com/thp-software/utsp/issues)
+
+## License
+
+MIT © 2025 Thomas Piquet

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var c=Object.defineProperty;var w=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var v=Object.prototype.hasOwnProperty;var C=(o,t,e)=>t in o?c(o,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):o[t]=e;var g=(o,t)=>c(o,"name",{value:t,configurable:!0});var I=(o,t)=>{for(var e in t)c(o,e,{get:t[e],enumerable:!0})},$=(o,t,e,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of y(t))!v.call(o,s)&&s!==e&&c(o,s,{get:()=>t[s],enumerable:!(n=w(t,s))||n.enumerable});return o};var R=o=>$(c({},"__esModule",{value:!0}),o);var r=(o,t,e)=>(C(o,typeof t!="symbol"?t+"":t,e),e);var b={};I(b,{NetworkState:()=>d.NetworkState,SocketIOClient:()=>a});module.exports=R(b);var d=require("@utsp/types");var u=require("socket.io-client"),i=require("@utsp/types");var m=class m{constructor(t){r(this,"socket",null);r(this,"options");r(this,"_state",i.NetworkState.Disconnected);r(this,"pingTimestamp",0);r(this,"latency",0);r(this,"pingInterval",null);if(!t.url||typeof t.url!="string")throw new Error("SocketIOClient: Invalid URL - must be a non-empty string");try{if(!new globalThis.URL(t.url).protocol)throw new Error("Invalid protocol")}catch{throw new Error(`SocketIOClient: Invalid URL format - ${t.url}`)}if(t.reconnectDelay!==void 0&&(t.reconnectDelay<0||!Number.isFinite(t.reconnectDelay)))throw new Error(`SocketIOClient: Invalid reconnectDelay - must be a positive number (got ${t.reconnectDelay})`);if(t.maxReconnectAttempts!==void 0&&(!Number.isInteger(t.maxReconnectAttempts)||t.maxReconnectAttempts<0))throw new Error(`SocketIOClient: Invalid maxReconnectAttempts - must be a positive integer (got ${t.maxReconnectAttempts})`);if(t.timeout!==void 0&&(t.timeout<=0||!Number.isFinite(t.timeout)))throw new Error(`SocketIOClient: Invalid timeout - must be a positive number (got ${t.timeout})`);this.options={url:t.url,autoReconnect:t.autoReconnect??!0,reconnectDelay:t.reconnectDelay??1e3,maxReconnectAttempts:t.maxReconnectAttempts??10,timeout:t.timeout??5e3,auth:t.auth??{},debug:t.debug??!1},this.log("Client initialized",{url:this.options.url,autoReconnect:this.options.autoReconnect})}get state(){return this._state}isConnected(){return this._state===i.NetworkState.Connected&&this.socket?.connected===!0}async connect(){if(this.socket&&this.isConnected()){this.log("Already connected");return}return this.log(`Connecting to ${this.options.url}...`),this._state=i.NetworkState.Connecting,new Promise((t,e)=>{this.socket=(0,u.io)(this.options.url,{auth:this.options.auth,reconnection:this.options.autoReconnect,reconnectionDelay:this.options.reconnectDelay,reconnectionAttempts:this.options.maxReconnectAttempts,timeout:this.options.timeout,transports:["websocket"]}),this.socket.on("connect",()=>{this.log(`Connected with ID: ${this.socket?.id}`),this._state=i.NetworkState.Connected,this.startPingMonitor(),t()}),this.socket.on("connect_error",n=>{this.log(`Connection error: ${n.message}`),this._state=i.NetworkState.Error,e(n)}),this.socket.on("disconnect",n=>{this.log(`Disconnected: ${n}`),this._state=i.NetworkState.Disconnected,this.stopPingMonitor()}),this.socket.on("reconnect_attempt",n=>{this.log(`Reconnection attempt ${n}...`),this._state=i.NetworkState.Reconnecting}),this.socket.on("reconnect",n=>{this.log(`Reconnected after ${n} attempts`),this._state=i.NetworkState.Connected,this.startPingMonitor()}),this.socket.on("reconnect_failed",()=>{this.log("Reconnection failed"),this._state=i.NetworkState.Error}),this.socket.on("pong",()=>{this.latency=Date.now()-this.pingTimestamp,this.log(`Ping: ${this.latency}ms`)})})}disconnect(){this.socket&&(this.log("Disconnecting..."),this.stopPingMonitor(),this.socket.disconnect(),this._state=i.NetworkState.Disconnected)}send(t,e){if(!t||typeof t!="string"){this.log(`Cannot send: invalid event name (${typeof t})`);return}if(!this.isConnected()||!this.socket){this.log(`Cannot send '${t}': not connected`);return}try{this.socket.volatile.emit(t,e)}catch(n){this.log(`Error sending '${t}':`,n)}}on(t,e){if(!t||typeof t!="string")throw new Error(`Invalid event name: ${t}`);if(typeof e!="function")throw new Error(`Invalid handler for event '${t}': must be a function`);if(!this.socket){this.log(`Cannot listen to '${t}': socket not initialized`);return}this.socket.on(t,e),this.log(`Listening to '${t}'`)}off(t,e){this.socket&&(this.socket.off(t,e),this.log(`Stopped listening to '${t}'`))}removeAllListeners(t){this.socket&&(t?(this.socket.removeAllListeners(t),this.log(`Removed all listeners for '${t}'`)):(this.socket.removeAllListeners(),this.log("Removed all listeners")))}async request(t,e,n=5e3){if(!t||typeof t!="string")throw new Error(`Invalid event name: ${t}`);if(!Number.isFinite(n)||n<=0)throw new Error(`Invalid timeout: ${n} (must be a positive number)`);if(!this.isConnected())throw new Error("Cannot send request: not connected to server");return new Promise((s,p)=>{let l=`${t}_response`,f=setTimeout(()=>{this.off(l,h),p(new Error(`Request timeout after ${n}ms: ${t}`))},n),h=g(k=>{clearTimeout(f),this.off(l,h),s(k)},"responseHandler");this.on(l,h),this.send(t,e),this.log(`Request sent: ${t} (timeout: ${n}ms)`)})}getPing(){return this.latency}destroy(){this.log("Destroying client..."),this.stopPingMonitor(),this.socket&&(this.socket.removeAllListeners(),this.socket.disconnect(),this.socket=null),this._state=i.NetworkState.Disconnected,this.log("Client destroyed")}startPingMonitor(){this.pingInterval||(this.pingInterval=setInterval(()=>{this.isConnected()&&this.socket&&(this.pingTimestamp=Date.now(),this.socket.emit("ping"))},2e3),this.log("Ping monitor started"))}stopPingMonitor(){this.pingInterval&&(clearInterval(this.pingInterval),this.pingInterval=null,this.log("Ping monitor stopped"))}log(t,e){this.options.debug&&(e!==void 0?console.warn(`[SocketIOClient] ${t}`,e):console.warn(`[SocketIOClient] ${t}`))}};g(m,"SocketIOClient");var a=m;0&&(module.exports={NetworkState,SocketIOClient});

package/dist/index.d.ts

@@ -0,0 +1,310 @@
+import { INetworkClient, NetworkClientOptions, NetworkState, NetworkEventHandler } from '@utsp/types';
+export { AnyNetworkMessage, ChatMessage, ClientInfo, ErrorMessage, INetworkClient, InputMessage, JoinMessage, JoinResponseMessage, LeaveMessage, LoadMessage, MessageType, NetworkClientOptions, NetworkEventHandler, NetworkMessage, NetworkState, PingMessage, PongMessage, UpdateMessage } from '@utsp/types';
+
+/**
+ * Socket.IO Client Implementation
+ *
+ * Production-ready Socket.IO client for real-time communication with UTSP servers.
+ * Implements the INetworkClient interface with automatic reconnection, latency monitoring,
+ * and comprehensive error handling. Browser-safe with no Node.js dependencies.
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { SocketIOClient } from '@utsp/network-client';
+ *
+ * const client = new SocketIOClient({
+ *   url: 'http://localhost:3000',
+ *   autoReconnect: true,
+ *   debug: false
+ * });
+ *
+ * await client.connect();
+ * console.log('Connected:', client.isConnected());
+ *
+ * client.on('update', (data) => {
+ *   console.log('Received update:', data);
+ * });
+ *
+ * client.send('input', { key: 'ArrowUp' });
+ * ```
+ *
+ * @example With Authentication
+ * ```typescript
+ * const client = new SocketIOClient({
+ *   url: 'https://game.example.com',
+ *   auth: {
+ *     token: 'user-auth-token',
+ *     userId: '12345'
+ *   }
+ * });
+ *
+ * await client.connect();
+ * ```
+ *
+ * @example Request-Response Pattern
+ * ```typescript
+ * try {
+ *   const response = await client.request('getPlayerStats', { playerId: '123' }, 5000);
+ *   console.log('Stats:', response);
+ * } catch (error) {
+ *   console.error('Request failed:', error);
+ * }
+ * ```
+ */
+
+/**
+ * Socket.IO client implementation for UTSP network communication
+ *
+ * Features:
+ * - Automatic reconnection with exponential backoff
+ * - Real-time latency monitoring (ping/pong)
+ * - Request-response pattern with timeout
+ * - Type-safe event handling
+ * - Connection state management
+ * - Debug logging
+ *
+ * @implements {INetworkClient}
+ */
+declare class SocketIOClient implements INetworkClient {
+    private socket;
+    private options;
+    private _state;
+    private pingTimestamp;
+    private latency;
+    private pingInterval;
+    /**
+     * Create a new Socket.IO client instance
+     *
+     * @param options - Client configuration options
+     * @throws {Error} If URL is invalid or options are malformed
+     *
+     * @example
+     * ```typescript
+     * const client = new SocketIOClient({
+     *   url: 'http://localhost:3000',
+     *   autoReconnect: true,
+     *   reconnectDelay: 1000,
+     *   maxReconnectAttempts: 10,
+     *   timeout: 5000,
+     *   debug: false
+     * });
+     * ```
+     */
+    constructor(options: NetworkClientOptions);
+    /**
+     * Get current connection state
+     *
+     * @returns Current network state (Disconnected, Connecting, Connected, Reconnecting, Error)
+     *
+     * @example
+     * ```typescript
+     * console.log('State:', client.state); // NetworkState.Connected
+     * ```
+     */
+    get state(): NetworkState;
+    /**
+     * Check if client is currently connected
+     *
+     * @returns true if connected and socket is active, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (client.isConnected()) {
+     *   client.send('message', data);
+     * }
+     * ```
+     */
+    isConnected(): boolean;
+    /**
+     * Connect to the server
+     *
+     * Establishes a WebSocket connection to the configured server URL.
+     * Automatically sets up reconnection logic if enabled.
+     *
+     * @returns Promise that resolves when connected, rejects on connection error
+     * @throws {Error} If connection fails or times out
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   await client.connect();
+     *   console.log('Connected successfully');
+     * } catch (error) {
+     *   console.error('Connection failed:', error);
+     * }
+     * ```
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the server
+     *
+     * Gracefully closes the WebSocket connection and stops all monitoring.
+     * Safe to call multiple times.
+     *
+     * @example
+     * ```typescript
+     * client.disconnect();
+     * console.log('Disconnected');
+     * ```
+     */
+    disconnect(): void;
+    /**
+     * Send an event to the server
+     *
+     * Uses volatile emit to prevent message queuing during disconnection.
+     * Events sent while disconnected will be silently dropped.
+     *
+     * @param event - Event name to emit
+     * @param data - Event payload (any serializable data)
+     *
+     * @example
+     * ```typescript
+     * client.send('input', { key: 'ArrowUp', timestamp: Date.now() });
+     * client.send('chat', { message: 'Hello world!' });
+     * ```
+     */
+    send(event: string, data: any): void;
+    /**
+     * Register an event listener
+     *
+     * Listens for events from the server. Multiple handlers can be registered
+     * for the same event.
+     *
+     * @param event - Event name to listen for
+     * @param handler - Callback function to handle event data
+     *
+     * @example
+     * ```typescript
+     * client.on<UpdateMessage>('update', (data) => {
+     *   console.log('Game update:', data);
+     * });
+     *
+     * client.on('chat', (message) => {
+     *   console.log('Chat:', message);
+     * });
+     * ```
+     */
+    on<T = any>(event: string, handler: NetworkEventHandler<T>): void;
+    /**
+     * Unregister a specific event listener
+     *
+     * Removes a previously registered handler for an event. The handler reference
+     * must be the exact same function object that was registered.
+     *
+     * @param event - Event name
+     * @param handler - Handler function to remove (must be same reference)
+     *
+     * @example
+     * ```typescript
+     * const handler = (data) => console.log(data);
+     * client.on('update', handler);
+     * // ... later
+     * client.off('update', handler);
+     * ```
+     */
+    off<T = any>(event: string, handler: NetworkEventHandler<T>): void;
+    /**
+     * Remove all listeners for an event or all events
+     *
+     * If event name is provided, removes all listeners for that specific event.
+     * If no event name, removes all listeners for all events.
+     *
+     * @param event - Optional event name. If omitted, removes all listeners.
+     *
+     * @example
+     * ```typescript
+     * // Remove all 'update' listeners
+     * client.removeAllListeners('update');
+     *
+     * // Remove ALL listeners
+     * client.removeAllListeners();
+     * ```
+     */
+    removeAllListeners(event?: string): void;
+    /**
+     * Send a request and wait for response (request-response pattern)
+     *
+     * Implements a request-response pattern on top of Socket.IO events.
+     * Automatically listens for `${event}_response` and handles timeout.
+     *
+     * @param event - Request event name
+     * @param data - Request payload
+     * @param timeout - Timeout in milliseconds (default: 5000ms)
+     * @returns Promise resolving to the response data
+     * @throws {Error} If not connected, request times out, or server returns error
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const stats = await client.request<PlayerStats>(
+     *     'getPlayerStats',
+     *     { playerId: '123' },
+     *     3000
+     *   );
+     *   console.log('Stats:', stats);
+     * } catch (error) {
+     *   console.error('Request failed:', error);
+     * }
+     * ```
+     */
+    request<T = any>(event: string, data: any, timeout?: number): Promise<T>;
+    /**
+     * Get current network latency (ping time)
+     *
+     * Returns the round-trip time in milliseconds of the most recent ping.
+     * Updated every 2 seconds while connected.
+     *
+     * @returns Latency in milliseconds, or 0 if not yet measured
+     *
+     * @example
+     * ```typescript
+     * console.log('Latency:', client.getPing(), 'ms');
+     * ```
+     */
+    getPing(): number;
+    /**
+     * Destroy the client and clean up all resources
+     *
+     * Disconnects from server, removes all listeners, and releases resources.
+     * Client instance cannot be reused after calling destroy().
+     *
+     * @example
+     * ```typescript
+     * // Cleanup before page unload
+     * window.addEventListener('beforeunload', () => {
+     *   client.destroy();
+     * });
+     * ```
+     */
+    destroy(): void;
+    /**
+     * Start ping monitoring for latency measurement
+     *
+     * Sends a ping every 2 seconds to measure round-trip time.
+     * Only runs while connected.
+     *
+     * @private
+     */
+    private startPingMonitor;
+    /**
+     * Stop ping monitoring
+     *
+     * Clears the ping interval timer.
+     *
+     * @private
+     */
+    private stopPingMonitor;
+    /**
+     * Debug logging utility
+     *
+     * Logs messages when debug mode is enabled. Uses console.warn
+     * to ensure visibility in production environments.
+     *
+     * @param message - Log message
+     * @param data - Optional data to log
+     * @private
+     */
+    private log;
+}
+
+export { SocketIOClient, SocketIOClient as SocketIOClientType };

package/dist/index.mjs

@@ -0,0 +1 @@
+var g=Object.defineProperty;var f=(i,t,e)=>t in i?g(i,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):i[t]=e;var a=(i,t)=>g(i,"name",{value:t,configurable:!0});var s=(i,t,e)=>(f(i,typeof t!="symbol"?t+"":t,e),e);import{NetworkState as E}from"@utsp/types";import{io as k}from"socket.io-client";import{NetworkState as o}from"@utsp/types";var h=class h{constructor(t){s(this,"socket",null);s(this,"options");s(this,"_state",o.Disconnected);s(this,"pingTimestamp",0);s(this,"latency",0);s(this,"pingInterval",null);if(!t.url||typeof t.url!="string")throw new Error("SocketIOClient: Invalid URL - must be a non-empty string");try{if(!new globalThis.URL(t.url).protocol)throw new Error("Invalid protocol")}catch{throw new Error(`SocketIOClient: Invalid URL format - ${t.url}`)}if(t.reconnectDelay!==void 0&&(t.reconnectDelay<0||!Number.isFinite(t.reconnectDelay)))throw new Error(`SocketIOClient: Invalid reconnectDelay - must be a positive number (got ${t.reconnectDelay})`);if(t.maxReconnectAttempts!==void 0&&(!Number.isInteger(t.maxReconnectAttempts)||t.maxReconnectAttempts<0))throw new Error(`SocketIOClient: Invalid maxReconnectAttempts - must be a positive integer (got ${t.maxReconnectAttempts})`);if(t.timeout!==void 0&&(t.timeout<=0||!Number.isFinite(t.timeout)))throw new Error(`SocketIOClient: Invalid timeout - must be a positive number (got ${t.timeout})`);this.options={url:t.url,autoReconnect:t.autoReconnect??!0,reconnectDelay:t.reconnectDelay??1e3,maxReconnectAttempts:t.maxReconnectAttempts??10,timeout:t.timeout??5e3,auth:t.auth??{},debug:t.debug??!1},this.log("Client initialized",{url:this.options.url,autoReconnect:this.options.autoReconnect})}get state(){return this._state}isConnected(){return this._state===o.Connected&&this.socket?.connected===!0}async connect(){if(this.socket&&this.isConnected()){this.log("Already connected");return}return this.log(`Connecting to ${this.options.url}...`),this._state=o.Connecting,new Promise((t,e)=>{this.socket=k(this.options.url,{auth:this.options.auth,reconnection:this.options.autoReconnect,reconnectionDelay:this.options.reconnectDelay,reconnectionAttempts:this.options.maxReconnectAttempts,timeout:this.options.timeout,transports:["websocket"]}),this.socket.on("connect",()=>{this.log(`Connected with ID: ${this.socket?.id}`),this._state=o.Connected,this.startPingMonitor(),t()}),this.socket.on("connect_error",n=>{this.log(`Connection error: ${n.message}`),this._state=o.Error,e(n)}),this.socket.on("disconnect",n=>{this.log(`Disconnected: ${n}`),this._state=o.Disconnected,this.stopPingMonitor()}),this.socket.on("reconnect_attempt",n=>{this.log(`Reconnection attempt ${n}...`),this._state=o.Reconnecting}),this.socket.on("reconnect",n=>{this.log(`Reconnected after ${n} attempts`),this._state=o.Connected,this.startPingMonitor()}),this.socket.on("reconnect_failed",()=>{this.log("Reconnection failed"),this._state=o.Error}),this.socket.on("pong",()=>{this.latency=Date.now()-this.pingTimestamp,this.log(`Ping: ${this.latency}ms`)})})}disconnect(){this.socket&&(this.log("Disconnecting..."),this.stopPingMonitor(),this.socket.disconnect(),this._state=o.Disconnected)}send(t,e){if(!t||typeof t!="string"){this.log(`Cannot send: invalid event name (${typeof t})`);return}if(!this.isConnected()||!this.socket){this.log(`Cannot send '${t}': not connected`);return}try{this.socket.volatile.emit(t,e)}catch(n){this.log(`Error sending '${t}':`,n)}}on(t,e){if(!t||typeof t!="string")throw new Error(`Invalid event name: ${t}`);if(typeof e!="function")throw new Error(`Invalid handler for event '${t}': must be a function`);if(!this.socket){this.log(`Cannot listen to '${t}': socket not initialized`);return}this.socket.on(t,e),this.log(`Listening to '${t}'`)}off(t,e){this.socket&&(this.socket.off(t,e),this.log(`Stopped listening to '${t}'`))}removeAllListeners(t){this.socket&&(t?(this.socket.removeAllListeners(t),this.log(`Removed all listeners for '${t}'`)):(this.socket.removeAllListeners(),this.log("Removed all listeners")))}async request(t,e,n=5e3){if(!t||typeof t!="string")throw new Error(`Invalid event name: ${t}`);if(!Number.isFinite(n)||n<=0)throw new Error(`Invalid timeout: ${n} (must be a positive number)`);if(!this.isConnected())throw new Error("Cannot send request: not connected to server");return new Promise((m,u)=>{let r=`${t}_response`,d=setTimeout(()=>{this.off(r,c),u(new Error(`Request timeout after ${n}ms: ${t}`))},n),c=a(p=>{clearTimeout(d),this.off(r,c),m(p)},"responseHandler");this.on(r,c),this.send(t,e),this.log(`Request sent: ${t} (timeout: ${n}ms)`)})}getPing(){return this.latency}destroy(){this.log("Destroying client..."),this.stopPingMonitor(),this.socket&&(this.socket.removeAllListeners(),this.socket.disconnect(),this.socket=null),this._state=o.Disconnected,this.log("Client destroyed")}startPingMonitor(){this.pingInterval||(this.pingInterval=setInterval(()=>{this.isConnected()&&this.socket&&(this.pingTimestamp=Date.now(),this.socket.emit("ping"))},2e3),this.log("Ping monitor started"))}stopPingMonitor(){this.pingInterval&&(clearInterval(this.pingInterval),this.pingInterval=null,this.log("Ping monitor stopped"))}log(t,e){this.options.debug&&(e!==void 0?console.warn(`[SocketIOClient] ${t}`,e):console.warn(`[SocketIOClient] ${t}`))}};a(h,"SocketIOClient");var l=h;export{E as NetworkState,l as SocketIOClient};

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@utsp/network-client",
+  "version": "0.1.1",
+  "description": "UTSP Network Client - Client-side communication adapters",
+  "author": "Thomas Piquet",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thp-software/utsp.git",
+    "directory": "packages/network-client"
+  },
+  "bugs": {
+    "url": "https://github.com/thp-software/utsp/issues"
+  },
+  "homepage": "https://github.com/thp-software/utsp/tree/master/packages/network-client#readme",
+  "keywords": [
+    "utsp",
+    "network",
+    "client",
+    "websocket",
+    "socket.io",
+    "communication",
+    "multi-user",
+    "real-time",
+    "terminal"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "socket.io-client": "^4.7.2",
+    "@utsp/types": "0.1.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs packages/network-client",
+    "dev": "tsc --watch",
+    "clean": "rimraf dist",
+    "lint": "eslint \"src/**/*.ts\" --max-warnings 0",
+    "lint:fix": "eslint \"src/**/*.ts\" --fix",
+    "typecheck": "tsc --noEmit"
+  }
+}