sockress-client 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,107 @@
+type HTTPMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+export interface SockressClientOptions {
+    baseUrl: string;
+    socketPath?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+    reconnectInterval?: number;
+    maxReconnectInterval?: number;
+    autoConnect?: boolean;
+    preferSocket?: boolean;
+    fetchImpl?: typeof fetch;
+    wsFactory?: WebSocketFactory;
+    credentials?: RequestCredentials;
+}
+export interface SockressClientRequest {
+    path: string;
+    method?: HTTPMethod;
+    headers?: Record<string, string>;
+    query?: Record<string, string | number | boolean | Array<string | number | boolean>>;
+    body?: unknown;
+    timeout?: number;
+    signal?: AbortSignal;
+    disableHttpFallback?: boolean;
+}
+export interface SockressClientResponse<T = unknown> {
+    status: number;
+    ok: boolean;
+    headers: Record<string, string>;
+    body: T;
+    json: <R = T>() => R;
+    text: () => string;
+    raw: () => T;
+}
+export type EventMap = {
+    open: void;
+    close: {
+        code?: number;
+        reason?: string;
+    };
+    error: unknown;
+    reconnect: {
+        attempt: number;
+    };
+};
+type Listener<K extends keyof EventMap> = (payload: EventMap[K]) => void;
+type WebSocketLike = {
+    readyState: number;
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    onopen?: ((event: any) => void) | null;
+    onmessage?: ((event: any) => void) | null;
+    onclose?: ((event: any) => void) | null;
+    onerror?: ((event: any) => void) | null;
+    addEventListener?(type: string, listener: (event: any) => void): void;
+    removeEventListener?(type: string, listener: (event: any) => void): void;
+    on?(type: string, listener: (...args: unknown[]) => void): void;
+    off?(type: string, listener: (...args: unknown[]) => void): void;
+};
+export type WebSocketFactory = (url: string) => WebSocketLike;
+interface NormalizedOptions {
+    baseUrl: string;
+    socketPath: string;
+    headers: Record<string, string>;
+    timeout: number;
+    reconnectInterval: number;
+    maxReconnectInterval: number;
+    autoConnect: boolean;
+    preferSocket: boolean;
+    fetchImpl: typeof fetch;
+    wsFactory?: WebSocketFactory;
+    credentials: RequestCredentials;
+}
+export declare class SockressClient {
+    private readonly options;
+    private ws?;
+    private reconnectAttempts;
+    private pending;
+    private queue;
+    private listeners;
+    private socketEnabled;
+    constructor(options: NormalizedOptions);
+    static create(options: SockressClientOptions): SockressClient;
+    on<K extends keyof EventMap>(event: K, listener: Listener<K>): () => void;
+    off<K extends keyof EventMap>(event: K, listener: Listener<K>): void;
+    emit<K extends keyof EventMap>(event: K, payload: EventMap[K]): void;
+    connect(): Promise<void>;
+    private attachSocketHandlers;
+    private flushQueue;
+    private scheduleReconnect;
+    private handleSocketMessage;
+    private applyCookies;
+    private clearPending;
+    private rejectAllPending;
+    private canUseSocket;
+    request<T = unknown>(options: SockressClientRequest): Promise<SockressClientResponse<T>>;
+    get<T = unknown>(path: string, options?: Omit<SockressClientRequest, 'path' | 'method'>): Promise<SockressClientResponse<T>>;
+    post<T = unknown>(path: string, options?: Omit<SockressClientRequest, 'path' | 'method'>): Promise<SockressClientResponse<T>>;
+    put<T = unknown>(path: string, options?: Omit<SockressClientRequest, 'path' | 'method'>): Promise<SockressClientResponse<T>>;
+    patch<T = unknown>(path: string, options?: Omit<SockressClientRequest, 'path' | 'method'>): Promise<SockressClientResponse<T>>;
+    delete<T = unknown>(path: string, options?: Omit<SockressClientRequest, 'path' | 'method'>): Promise<SockressClientResponse<T>>;
+    private sendViaSocket;
+    private sendViaHttp;
+    close(): void;
+}
+export declare function createSockressClient(options: SockressClientOptions): SockressClient;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,422 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SockressClient = void 0;
+exports.createSockressClient = createSockressClient;
+const nanoid_1 = require("nanoid");
+class SockressClient {
+    constructor(options) {
+        this.options = options;
+        this.reconnectAttempts = 0;
+        this.pending = new Map();
+        this.queue = [];
+        this.listeners = {
+            open: new Set(),
+            close: new Set(),
+            error: new Set(),
+            reconnect: new Set()
+        };
+        this.socketEnabled = true;
+        if (options.autoConnect) {
+            this.connect().catch(() => {
+                // Ignore initial connection failures, HTTP fallback will handle requests.
+            });
+        }
+    }
+    static create(options) {
+        return new SockressClient(normalizeOptions(options));
+    }
+    on(event, listener) {
+        this.listeners[event].add(listener);
+        return () => this.off(event, listener);
+    }
+    off(event, listener) {
+        this.listeners[event].delete(listener);
+    }
+    emit(event, payload) {
+        for (const listener of this.listeners[event]) {
+            listener(payload);
+        }
+    }
+    async connect() {
+        if (!this.options.wsFactory) {
+            this.socketEnabled = false;
+            return;
+        }
+        if (this.ws && this.ws.readyState === 1) {
+            return;
+        }
+        const socketUrl = buildSocketUrl(this.options.baseUrl, this.options.socketPath);
+        this.ws = this.options.wsFactory(socketUrl);
+        this.attachSocketHandlers(this.ws);
+    }
+    attachSocketHandlers(socket) {
+        const handleOpen = () => {
+            this.reconnectAttempts = 0;
+            this.emit('open', undefined);
+            this.flushQueue();
+        };
+        const handleMessage = (event) => {
+            const data = resolveEventData(event);
+            if (data) {
+                this.handleSocketMessage(data);
+            }
+        };
+        const handleError = (event) => {
+            this.emit('error', event);
+            this.rejectAllPending(new Error('Socket error'));
+        };
+        const handleClose = (details) => {
+            this.emit('close', { code: details === null || details === void 0 ? void 0 : details.code, reason: details === null || details === void 0 ? void 0 : details.reason });
+            this.rejectAllPending(new Error('Socket closed'));
+            this.scheduleReconnect();
+        };
+        if (typeof socket.addEventListener === 'function') {
+            socket.addEventListener('open', () => handleOpen());
+            socket.addEventListener('message', (event) => handleMessage(event));
+            socket.addEventListener('error', (event) => handleError(event));
+            socket.addEventListener('close', (event) => handleClose(extractCloseDetails(event)));
+        }
+        else if (typeof socket.on === 'function') {
+            socket.on('open', handleOpen);
+            socket.on('message', (data) => handleMessage({ data }));
+            socket.on('error', handleError);
+            socket.on('close', (...args) => {
+                const [code, reason] = args;
+                handleClose({
+                    code: typeof code === 'number' ? code : undefined,
+                    reason: typeof reason === 'string' ? reason : typeof reason === 'object' && reason ? `${reason}` : undefined
+                });
+            });
+        }
+        else {
+            socket.onopen = () => handleOpen();
+            socket.onmessage = (event) => handleMessage(event);
+            socket.onerror = (event) => handleError(event);
+            socket.onclose = (event) => handleClose(extractCloseDetails(event));
+        }
+    }
+    flushQueue() {
+        if (!this.ws || this.ws.readyState !== 1)
+            return;
+        while (this.queue.length) {
+            const payload = this.queue.shift();
+            if (!payload)
+                continue;
+            this.ws.send(JSON.stringify(payload));
+        }
+    }
+    scheduleReconnect() {
+        if (!this.socketEnabled || !this.options.wsFactory) {
+            return;
+        }
+        this.reconnectAttempts += 1;
+        const delay = Math.min(this.options.reconnectInterval * this.reconnectAttempts, this.options.maxReconnectInterval);
+        setTimeout(() => {
+            this.emit('reconnect', { attempt: this.reconnectAttempts });
+            this.connect().catch(() => {
+                // keep trying silently
+            });
+        }, delay);
+    }
+    handleSocketMessage(raw) {
+        try {
+            const payload = JSON.parse(raw);
+            if (payload.type === 'error') {
+                const pending = payload.id ? this.pending.get(payload.id) : null;
+                const error = new Error(payload.message);
+                if (pending) {
+                    this.clearPending(payload.id);
+                    pending.reject(error);
+                }
+                else {
+                    this.emit('error', error);
+                }
+                return;
+            }
+            const pending = this.pending.get(payload.id);
+            if (!pending) {
+                return;
+            }
+            this.clearPending(payload.id);
+            const response = createClientResponse(payload);
+            this.applyCookies(payload.cookies);
+            pending.resolve(response);
+        }
+        catch (error) {
+            this.emit('error', error);
+        }
+    }
+    applyCookies(cookies) {
+        if (!cookies || typeof document === 'undefined')
+            return;
+        for (const cookie of cookies) {
+            document.cookie = cookie;
+        }
+    }
+    clearPending(id) {
+        const pending = this.pending.get(id);
+        if (pending === null || pending === void 0 ? void 0 : pending.timeout) {
+            clearTimeout(pending.timeout);
+        }
+        this.pending.delete(id);
+    }
+    rejectAllPending(error) {
+        for (const [id, pending] of this.pending.entries()) {
+            this.clearPending(id);
+            pending.reject(error);
+        }
+    }
+    canUseSocket() {
+        return Boolean(this.options.wsFactory && this.socketEnabled && this.ws && this.ws.readyState === 1);
+    }
+    async request(options) {
+        var _a, _b;
+        const method = (options.method || 'GET').toUpperCase();
+        const path = normalizePath(options.path);
+        const headers = { ...this.options.headers, ...((_a = options.headers) !== null && _a !== void 0 ? _a : {}) };
+        const query = options.query ? normalizeQuery(options.query) : undefined;
+        const timeout = (_b = options.timeout) !== null && _b !== void 0 ? _b : this.options.timeout;
+        if (this.options.preferSocket && this.socketEnabled) {
+            try {
+                return await this.sendViaSocket({ method, path, headers, query, body: options.body, timeout });
+            }
+            catch (error) {
+                if (options.disableHttpFallback) {
+                    throw error;
+                }
+            }
+        }
+        return this.sendViaHttp({ method, path, headers, query, body: options.body, signal: options.signal });
+    }
+    get(path, options) {
+        return this.request({ ...(options !== null && options !== void 0 ? options : {}), path, method: 'GET' });
+    }
+    post(path, options) {
+        return this.request({ ...(options !== null && options !== void 0 ? options : {}), path, method: 'POST' });
+    }
+    put(path, options) {
+        return this.request({ ...(options !== null && options !== void 0 ? options : {}), path, method: 'PUT' });
+    }
+    patch(path, options) {
+        return this.request({ ...(options !== null && options !== void 0 ? options : {}), path, method: 'PATCH' });
+    }
+    delete(path, options) {
+        return this.request({ ...(options !== null && options !== void 0 ? options : {}), path, method: 'DELETE' });
+    }
+    async sendViaSocket(input) {
+        if (!this.options.wsFactory) {
+            this.socketEnabled = false;
+            throw new Error('Socket transport is unavailable');
+        }
+        await this.connect();
+        const id = (0, nanoid_1.nanoid)();
+        const payload = {
+            type: 'request',
+            id,
+            method: input.method,
+            path: input.path,
+            headers: input.headers,
+            query: input.query,
+            body: input.body
+        };
+        const responsePromise = new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.clearPending(id);
+                reject(new Error('Socket request timed out'));
+            }, input.timeout);
+            this.pending.set(id, { resolve, reject, timeout });
+        });
+        const serialized = JSON.stringify(payload);
+        if (this.canUseSocket()) {
+            this.ws.send(serialized);
+        }
+        else {
+            this.queue.push(payload);
+        }
+        return responsePromise;
+    }
+    async sendViaHttp(input) {
+        var _a;
+        const url = buildHttpUrl(this.options.baseUrl, input.path, input.query);
+        const headers = new Headers(input.headers);
+        const init = {
+            method: input.method,
+            headers,
+            credentials: this.options.credentials,
+            signal: input.signal
+        };
+        if (input.body !== undefined && input.method !== 'GET' && input.method !== 'HEAD') {
+            if (typeof input.body === 'string' ||
+                input.body instanceof URLSearchParams ||
+                isBlob(input.body) ||
+                isFormData(input.body)) {
+                init.body = input.body;
+            }
+            else {
+                init.body = JSON.stringify(input.body);
+                if (!headers.has('content-type')) {
+                    headers.set('content-type', 'application/json');
+                }
+            }
+        }
+        const response = await this.options.fetchImpl(url, init);
+        const text = await response.text();
+        let parsed = text;
+        const contentType = (_a = response.headers.get('content-type')) !== null && _a !== void 0 ? _a : '';
+        if (contentType.includes('application/json') && text) {
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                parsed = text;
+            }
+        }
+        const headersObj = {};
+        response.headers.forEach((value, key) => {
+            headersObj[key.toLowerCase()] = value;
+        });
+        return {
+            status: response.status,
+            ok: response.ok,
+            headers: headersObj,
+            body: parsed,
+            json: () => parsed,
+            text: () => text,
+            raw: () => parsed
+        };
+    }
+    close() {
+        this.socketEnabled = false;
+        if (this.ws) {
+            this.ws.close();
+            this.ws = undefined;
+        }
+        this.queue = [];
+        this.rejectAllPending(new Error('Client closed'));
+    }
+}
+exports.SockressClient = SockressClient;
+function createSockressClient(options) {
+    return SockressClient.create(options);
+}
+function normalizeOptions(options) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    if (!options.baseUrl) {
+        throw new Error('baseUrl is required');
+    }
+    const fetchImpl = (_a = options.fetchImpl) !== null && _a !== void 0 ? _a : globalThis.fetch;
+    if (!fetchImpl) {
+        throw new Error('Fetch implementation is not available in this environment');
+    }
+    const wsFactory = (_b = options.wsFactory) !== null && _b !== void 0 ? _b : (typeof WebSocket !== 'undefined' ? (url) => new WebSocket(url) : undefined);
+    return {
+        baseUrl: options.baseUrl.replace(/\/+$/, ''),
+        socketPath: (_c = options.socketPath) !== null && _c !== void 0 ? _c : '/sockress',
+        headers: { ...((_d = options.headers) !== null && _d !== void 0 ? _d : {}) },
+        timeout: (_e = options.timeout) !== null && _e !== void 0 ? _e : 15000,
+        reconnectInterval: (_f = options.reconnectInterval) !== null && _f !== void 0 ? _f : 1000,
+        maxReconnectInterval: (_g = options.maxReconnectInterval) !== null && _g !== void 0 ? _g : 15000,
+        autoConnect: (_h = options.autoConnect) !== null && _h !== void 0 ? _h : true,
+        preferSocket: (_j = options.preferSocket) !== null && _j !== void 0 ? _j : true,
+        fetchImpl,
+        wsFactory,
+        credentials: (_k = options.credentials) !== null && _k !== void 0 ? _k : 'include'
+    };
+}
+function buildSocketUrl(baseUrl, socketPath) {
+    const url = new URL(socketPath, baseUrl);
+    url.protocol = url.protocol.replace('http', 'ws');
+    return url.toString();
+}
+function buildHttpUrl(baseUrl, path, query) {
+    const url = new URL(path, baseUrl);
+    if (query) {
+        for (const [key, value] of Object.entries(query)) {
+            if (Array.isArray(value)) {
+                value.forEach((entry) => url.searchParams.append(key, entry));
+            }
+            else {
+                url.searchParams.append(key, value);
+            }
+        }
+    }
+    return url.toString();
+}
+function normalizePath(path) {
+    if (!path.startsWith('/')) {
+        return `/${path}`;
+    }
+    return path;
+}
+function normalizeQuery(query) {
+    const result = {};
+    for (const [key, value] of Object.entries(query)) {
+        if (Array.isArray(value)) {
+            result[key] = value.map((item) => String(item));
+        }
+        else {
+            result[key] = String(value);
+        }
+    }
+    return result;
+}
+function createClientResponse(payload) {
+    var _a;
+    const headers = (_a = payload.headers) !== null && _a !== void 0 ? _a : {};
+    const status = payload.status;
+    const body = payload.body;
+    return {
+        status,
+        ok: status >= 200 && status < 300,
+        headers,
+        body,
+        json: () => body,
+        text: () => (typeof body === 'string' ? body : JSON.stringify(body)),
+        raw: () => body
+    };
+}
+function extractCloseDetails(event) {
+    if (!event || typeof event !== 'object')
+        return {};
+    const closeEvent = event;
+    return {
+        code: closeEvent.code,
+        reason: closeEvent.reason
+    };
+}
+function resolveEventData(event) {
+    if (!event)
+        return '';
+    if (typeof event === 'string')
+        return event;
+    if (typeof event === 'object' && 'data' in event) {
+        return toText(event.data);
+    }
+    return toText(event);
+}
+const textDecoder = typeof TextDecoder !== 'undefined' ? new TextDecoder() : null;
+function toText(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (value instanceof ArrayBuffer) {
+        return textDecoder ? textDecoder.decode(value) : '';
+    }
+    if (ArrayBuffer.isView(value)) {
+        const view = value;
+        if (textDecoder) {
+            return textDecoder.decode(view.buffer.slice(view.byteOffset, view.byteOffset + view.byteLength));
+        }
+    }
+    if (value && typeof value.toString === 'function') {
+        return value.toString();
+    }
+    return '';
+}
+function isBlob(value) {
+    return typeof Blob !== 'undefined' && value instanceof Blob;
+}
+function isFormData(value) {
+    return typeof FormData !== 'undefined' && value instanceof FormData;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "sockress-client",
+  "version": "0.1.0",
+  "description": "Client SDK for Sockress with socket-first transport and HTTP fallback",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "commonjs",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "nanoid": "^5.0.7"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.10"
+  }
+}

package/src/index.ts

@@ -0,0 +1,585 @@
+import { nanoid } from 'nanoid';
+
+type HTTPMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+
+interface SocketRequestPayload {
+  type: 'request';
+  id: string;
+  method: HTTPMethod;
+  path: string;
+  headers: Record<string, string>;
+  query?: Record<string, string | string[]>;
+  body?: unknown;
+}
+
+interface SocketResponsePayload {
+  type: 'response';
+  id: string;
+  status: number;
+  headers?: Record<string, string>;
+  body?: unknown;
+  cookies?: string[];
+}
+
+interface SocketErrorPayload {
+  type: 'error';
+  id?: string;
+  message: string;
+  code?: string;
+}
+
+export interface SockressClientOptions {
+  baseUrl: string;
+  socketPath?: string;
+  headers?: Record<string, string>;
+  timeout?: number;
+  reconnectInterval?: number;
+  maxReconnectInterval?: number;
+  autoConnect?: boolean;
+  preferSocket?: boolean;
+  fetchImpl?: typeof fetch;
+  wsFactory?: WebSocketFactory;
+  credentials?: RequestCredentials;
+}
+
+export interface SockressClientRequest {
+  path: string;
+  method?: HTTPMethod;
+  headers?: Record<string, string>;
+  query?: Record<string, string | number | boolean | Array<string | number | boolean>>;
+  body?: unknown;
+  timeout?: number;
+  signal?: AbortSignal;
+  disableHttpFallback?: boolean;
+}
+
+export interface SockressClientResponse<T = unknown> {
+  status: number;
+  ok: boolean;
+  headers: Record<string, string>;
+  body: T;
+  json: <R = T>() => R;
+  text: () => string;
+  raw: () => T;
+}
+
+export type EventMap = {
+  open: void;
+  close: { code?: number; reason?: string };
+  error: unknown;
+  reconnect: { attempt: number };
+};
+
+type Listener<K extends keyof EventMap> = (payload: EventMap[K]) => void;
+
+type WebSocketLike = {
+  readyState: number;
+  send(data: string): void;
+  close(code?: number, reason?: string): void;
+  onopen?: ((event: any) => void) | null;
+  onmessage?: ((event: any) => void) | null;
+  onclose?: ((event: any) => void) | null;
+  onerror?: ((event: any) => void) | null;
+  addEventListener?(type: string, listener: (event: any) => void): void;
+  removeEventListener?(type: string, listener: (event: any) => void): void;
+  on?(type: string, listener: (...args: unknown[]) => void): void;
+  off?(type: string, listener: (...args: unknown[]) => void): void;
+};
+
+export type WebSocketFactory = (url: string) => WebSocketLike;
+
+interface PendingRequest {
+  resolve: (value: SockressClientResponse<any>) => void;
+  reject: (reason?: unknown) => void;
+  timeout?: ReturnType<typeof setTimeout>;
+}
+
+interface NormalizedOptions {
+  baseUrl: string;
+  socketPath: string;
+  headers: Record<string, string>;
+  timeout: number;
+  reconnectInterval: number;
+  maxReconnectInterval: number;
+  autoConnect: boolean;
+  preferSocket: boolean;
+  fetchImpl: typeof fetch;
+  wsFactory?: WebSocketFactory;
+  credentials: RequestCredentials;
+}
+
+export class SockressClient {
+  private ws?: WebSocketLike;
+  private reconnectAttempts = 0;
+  private pending = new Map<string, PendingRequest>();
+  private queue: SocketRequestPayload[] = [];
+  private listeners: { [K in keyof EventMap]: Set<Listener<K>> } = {
+    open: new Set(),
+    close: new Set(),
+    error: new Set(),
+    reconnect: new Set()
+  };
+  private socketEnabled = true;
+
+  constructor(private readonly options: NormalizedOptions) {
+    if (options.autoConnect) {
+      this.connect().catch(() => {
+        // Ignore initial connection failures, HTTP fallback will handle requests.
+      });
+    }
+  }
+
+  static create(options: SockressClientOptions): SockressClient {
+    return new SockressClient(normalizeOptions(options));
+  }
+
+  on<K extends keyof EventMap>(event: K, listener: Listener<K>): () => void {
+    this.listeners[event].add(listener as Listener<K>);
+    return () => this.off(event, listener);
+  }
+
+  off<K extends keyof EventMap>(event: K, listener: Listener<K>): void {
+    this.listeners[event].delete(listener as Listener<K>);
+  }
+
+  emit<K extends keyof EventMap>(event: K, payload: EventMap[K]): void {
+    for (const listener of this.listeners[event]) {
+      listener(payload);
+    }
+  }
+
+  async connect(): Promise<void> {
+    if (!this.options.wsFactory) {
+      this.socketEnabled = false;
+      return;
+    }
+    if (this.ws && this.ws.readyState === 1) {
+      return;
+    }
+    const socketUrl = buildSocketUrl(this.options.baseUrl, this.options.socketPath);
+    this.ws = this.options.wsFactory(socketUrl);
+    this.attachSocketHandlers(this.ws);
+  }
+
+  private attachSocketHandlers(socket: WebSocketLike): void {
+    const handleOpen = () => {
+      this.reconnectAttempts = 0;
+      this.emit('open', undefined);
+      this.flushQueue();
+    };
+    const handleMessage = (event: unknown) => {
+      const data = resolveEventData(event);
+      if (data) {
+        this.handleSocketMessage(data);
+      }
+    };
+    const handleError = (event: unknown) => {
+      this.emit('error', event);
+      this.rejectAllPending(new Error('Socket error'));
+    };
+    const handleClose = (details?: { code?: number; reason?: string }) => {
+      this.emit('close', { code: details?.code, reason: details?.reason });
+      this.rejectAllPending(new Error('Socket closed'));
+      this.scheduleReconnect();
+    };
+    if (typeof socket.addEventListener === 'function') {
+      socket.addEventListener('open', () => handleOpen());
+      socket.addEventListener('message', (event) => handleMessage(event));
+      socket.addEventListener('error', (event) => handleError(event));
+      socket.addEventListener('close', (event) => handleClose(extractCloseDetails(event)));
+    } else if (typeof socket.on === 'function') {
+      socket.on('open', handleOpen);
+      socket.on('message', (data: unknown) => handleMessage({ data }));
+      socket.on('error', handleError);
+      socket.on('close', (...args: unknown[]) => {
+        const [code, reason] = args;
+        handleClose({
+          code: typeof code === 'number' ? code : undefined,
+          reason: typeof reason === 'string' ? reason : typeof reason === 'object' && reason ? `${reason}` : undefined
+        });
+      });
+    } else {
+      socket.onopen = () => handleOpen();
+      socket.onmessage = (event) => handleMessage(event);
+      socket.onerror = (event) => handleError(event);
+      socket.onclose = (event) => handleClose(extractCloseDetails(event));
+    }
+  }
+
+  private flushQueue(): void {
+    if (!this.ws || this.ws.readyState !== 1) return;
+    while (this.queue.length) {
+      const payload = this.queue.shift();
+      if (!payload) continue;
+      this.ws.send(JSON.stringify(payload));
+    }
+  }
+
+  private scheduleReconnect(): void {
+    if (!this.socketEnabled || !this.options.wsFactory) {
+      return;
+    }
+    this.reconnectAttempts += 1;
+    const delay = Math.min(
+      this.options.reconnectInterval * this.reconnectAttempts,
+      this.options.maxReconnectInterval
+    );
+    setTimeout(() => {
+      this.emit('reconnect', { attempt: this.reconnectAttempts });
+      this.connect().catch(() => {
+        // keep trying silently
+      });
+    }, delay);
+  }
+
+  private handleSocketMessage(raw: string): void {
+    try {
+      const payload = JSON.parse(raw) as SocketResponsePayload | SocketErrorPayload;
+      if (payload.type === 'error') {
+        const pending = payload.id ? this.pending.get(payload.id) : null;
+        const error = new Error(payload.message);
+        if (pending) {
+          this.clearPending(payload.id!);
+          pending.reject(error);
+        } else {
+          this.emit('error', error);
+        }
+        return;
+      }
+      const pending = this.pending.get(payload.id);
+      if (!pending) {
+        return;
+      }
+      this.clearPending(payload.id);
+      const response = createClientResponse(payload);
+      this.applyCookies(payload.cookies);
+      pending.resolve(response);
+    } catch (error) {
+      this.emit('error', error);
+    }
+  }
+
+  private applyCookies(cookies?: string[]): void {
+    if (!cookies || typeof document === 'undefined') return;
+    for (const cookie of cookies) {
+      document.cookie = cookie;
+    }
+  }
+
+  private clearPending(id: string): void {
+    const pending = this.pending.get(id);
+    if (pending?.timeout) {
+      clearTimeout(pending.timeout);
+    }
+    this.pending.delete(id);
+  }
+
+  private rejectAllPending(error: Error): void {
+    for (const [id, pending] of this.pending.entries()) {
+      this.clearPending(id);
+      pending.reject(error);
+    }
+  }
+
+  private canUseSocket(): boolean {
+    return Boolean(this.options.wsFactory && this.socketEnabled && this.ws && this.ws.readyState === 1);
+  }
+
+  async request<T = unknown>(options: SockressClientRequest): Promise<SockressClientResponse<T>> {
+    const method = (options.method || 'GET').toUpperCase() as HTTPMethod;
+    const path = normalizePath(options.path);
+    const headers = { ...this.options.headers, ...(options.headers ?? {}) };
+    const query = options.query ? normalizeQuery(options.query) : undefined;
+    const timeout = options.timeout ?? this.options.timeout;
+
+    if (this.options.preferSocket && this.socketEnabled) {
+      try {
+        return await this.sendViaSocket<T>({ method, path, headers, query, body: options.body, timeout });
+      } catch (error) {
+        if (options.disableHttpFallback) {
+          throw error;
+        }
+      }
+    }
+    return this.sendViaHttp<T>({ method, path, headers, query, body: options.body, signal: options.signal });
+  }
+
+  get<T = unknown>(
+    path: string,
+    options?: Omit<SockressClientRequest, 'path' | 'method'>
+  ): Promise<SockressClientResponse<T>> {
+    return this.request<T>({ ...(options ?? {}), path, method: 'GET' });
+  }
+
+  post<T = unknown>(
+    path: string,
+    options?: Omit<SockressClientRequest, 'path' | 'method'>
+  ): Promise<SockressClientResponse<T>> {
+    return this.request<T>({ ...(options ?? {}), path, method: 'POST' });
+  }
+
+  put<T = unknown>(
+    path: string,
+    options?: Omit<SockressClientRequest, 'path' | 'method'>
+  ): Promise<SockressClientResponse<T>> {
+    return this.request<T>({ ...(options ?? {}), path, method: 'PUT' });
+  }
+
+  patch<T = unknown>(
+    path: string,
+    options?: Omit<SockressClientRequest, 'path' | 'method'>
+  ): Promise<SockressClientResponse<T>> {
+    return this.request<T>({ ...(options ?? {}), path, method: 'PATCH' });
+  }
+
+  delete<T = unknown>(
+    path: string,
+    options?: Omit<SockressClientRequest, 'path' | 'method'>
+  ): Promise<SockressClientResponse<T>> {
+    return this.request<T>({ ...(options ?? {}), path, method: 'DELETE' });
+  }
+
+  private async sendViaSocket<T>(input: {
+    method: HTTPMethod;
+    path: string;
+    headers: Record<string, string>;
+    query?: Record<string, string | string[]>;
+    body?: unknown;
+    timeout: number;
+  }): Promise<SockressClientResponse<T>> {
+    if (!this.options.wsFactory) {
+      this.socketEnabled = false;
+      throw new Error('Socket transport is unavailable');
+    }
+    await this.connect();
+    const id = nanoid();
+    const payload: SocketRequestPayload = {
+      type: 'request',
+      id,
+      method: input.method,
+      path: input.path,
+      headers: input.headers,
+      query: input.query,
+      body: input.body
+    };
+    const responsePromise = new Promise<SockressClientResponse<T>>((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        this.clearPending(id);
+        reject(new Error('Socket request timed out'));
+      }, input.timeout);
+      this.pending.set(id, { resolve, reject, timeout });
+    });
+    const serialized = JSON.stringify(payload);
+    if (this.canUseSocket()) {
+      this.ws!.send(serialized);
+    } else {
+      this.queue.push(payload);
+    }
+    return responsePromise;
+  }
+
+  private async sendViaHttp<T>(input: {
+    method: HTTPMethod;
+    path: string;
+    headers: Record<string, string>;
+    query?: Record<string, string | string[]>;
+    body?: unknown;
+    signal?: AbortSignal;
+  }): Promise<SockressClientResponse<T>> {
+    const url = buildHttpUrl(this.options.baseUrl, input.path, input.query);
+    const headers = new Headers(input.headers);
+    const init: RequestInit = {
+      method: input.method,
+      headers,
+      credentials: this.options.credentials,
+      signal: input.signal
+    };
+    if (input.body !== undefined && input.method !== 'GET' && input.method !== 'HEAD') {
+      if (
+        typeof input.body === 'string' ||
+        input.body instanceof URLSearchParams ||
+        isBlob(input.body) ||
+        isFormData(input.body)
+      ) {
+        init.body = input.body as BodyInit;
+      } else {
+        init.body = JSON.stringify(input.body);
+        if (!headers.has('content-type')) {
+          headers.set('content-type', 'application/json');
+        }
+      }
+    }
+    const response = await this.options.fetchImpl(url, init);
+    const text = await response.text();
+    let parsed: unknown = text;
+    const contentType = response.headers.get('content-type') ?? '';
+    if (contentType.includes('application/json') && text) {
+      try {
+        parsed = JSON.parse(text);
+      } catch {
+        parsed = text;
+      }
+    }
+    const headersObj: Record<string, string> = {};
+    response.headers.forEach((value, key) => {
+      headersObj[key.toLowerCase()] = value;
+    });
+    return {
+      status: response.status,
+      ok: response.ok,
+      headers: headersObj,
+      body: parsed as T,
+      json: <R>() => parsed as R,
+      text: () => text,
+      raw: () => parsed as T
+    };
+  }
+
+  close(): void {
+    this.socketEnabled = false;
+    if (this.ws) {
+      this.ws.close();
+      this.ws = undefined;
+    }
+    this.queue = [];
+    this.rejectAllPending(new Error('Client closed'));
+  }
+}
+
+export function createSockressClient(options: SockressClientOptions): SockressClient {
+  return SockressClient.create(options);
+}
+
+function normalizeOptions(options: SockressClientOptions): NormalizedOptions {
+  if (!options.baseUrl) {
+    throw new Error('baseUrl is required');
+  }
+  const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+  if (!fetchImpl) {
+    throw new Error('Fetch implementation is not available in this environment');
+  }
+  const wsFactory =
+    options.wsFactory ??
+    (typeof WebSocket !== 'undefined' ? (url: string) => new WebSocket(url) as WebSocketLike : undefined);
+  return {
+    baseUrl: options.baseUrl.replace(/\/+$/, ''),
+    socketPath: options.socketPath ?? '/sockress',
+    headers: { ...(options.headers ?? {}) },
+    timeout: options.timeout ?? 15_000,
+    reconnectInterval: options.reconnectInterval ?? 1_000,
+    maxReconnectInterval: options.maxReconnectInterval ?? 15_000,
+    autoConnect: options.autoConnect ?? true,
+    preferSocket: options.preferSocket ?? true,
+    fetchImpl,
+    wsFactory,
+    credentials: options.credentials ?? 'include'
+  };
+}
+
+function buildSocketUrl(baseUrl: string, socketPath: string): string {
+  const url = new URL(socketPath, baseUrl);
+  url.protocol = url.protocol.replace('http', 'ws');
+  return url.toString();
+}
+
+function buildHttpUrl(
+  baseUrl: string,
+  path: string,
+  query?: Record<string, string | string[]>
+): string {
+  const url = new URL(path, baseUrl);
+  if (query) {
+    for (const [key, value] of Object.entries(query)) {
+      if (Array.isArray(value)) {
+        value.forEach((entry) => url.searchParams.append(key, entry));
+      } else {
+        url.searchParams.append(key, value);
+      }
+    }
+  }
+  return url.toString();
+}
+
+function normalizePath(path: string): string {
+  if (!path.startsWith('/')) {
+    return `/${path}`;
+  }
+  return path;
+}
+
+function normalizeQuery(
+  query: Record<string, string | number | boolean | Array<string | number | boolean>>
+): Record<string, string | string[]> {
+  const result: Record<string, string | string[]> = {};
+  for (const [key, value] of Object.entries(query)) {
+    if (Array.isArray(value)) {
+      result[key] = value.map((item) => String(item));
+    } else {
+      result[key] = String(value);
+    }
+  }
+  return result;
+}
+
+function createClientResponse<T = unknown>(payload: SocketResponsePayload): SockressClientResponse<T> {
+  const headers = payload.headers ?? {};
+  const status = payload.status;
+  const body = payload.body as T;
+  return {
+    status,
+    ok: status >= 200 && status < 300,
+    headers,
+    body,
+    json: <R = T>() => body as unknown as R,
+    text: () => (typeof body === 'string' ? body : JSON.stringify(body)),
+    raw: () => body
+  };
+}
+
+function extractCloseDetails(event: unknown): { code?: number; reason?: string } {
+  if (!event || typeof event !== 'object') return {};
+  const closeEvent = event as Partial<CloseEvent>;
+  return {
+    code: closeEvent.code,
+    reason: closeEvent.reason
+  };
+}
+
+function resolveEventData(event: unknown): string {
+  if (!event) return '';
+  if (typeof event === 'string') return event;
+  if (typeof event === 'object' && 'data' in (event as Record<string, unknown>)) {
+    return toText((event as { data: unknown }).data);
+  }
+  return toText(event);
+}
+
+const textDecoder = typeof TextDecoder !== 'undefined' ? new TextDecoder() : null;
+
+function toText(value: unknown): string {
+  if (typeof value === 'string') {
+    return value;
+  }
+  if (value instanceof ArrayBuffer) {
+    return textDecoder ? textDecoder.decode(value) : '';
+  }
+  if (ArrayBuffer.isView(value)) {
+    const view = value as ArrayBufferView;
+    if (textDecoder) {
+      return textDecoder.decode(view.buffer.slice(view.byteOffset, view.byteOffset + view.byteLength));
+    }
+  }
+  if (value && typeof (value as { toString: () => string }).toString === 'function') {
+    return (value as { toString: () => string }).toString();
+  }
+  return '';
+}
+
+function isBlob(value: unknown): value is Blob {
+  return typeof Blob !== 'undefined' && value instanceof Blob;
+}
+
+function isFormData(value: unknown): value is FormData {
+  return typeof FormData !== 'undefined' && value instanceof FormData;
+}
+

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist",
+    "lib": ["ES2020", "DOM"],
+    "module": "CommonJS"
+  },
+  "include": ["src"]
+}