@wsocket-io/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wSocket
+
+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,95 @@
+# wSocket JavaScript SDK
+
+Official JavaScript/TypeScript SDK for [wSocket](https://wsocket.io) — Realtime Pub/Sub over WebSockets.
+
+[![npm](https://img.shields.io/npm/v/@wsocket-io/sdk)](https://www.npmjs.com/package/@wsocket-io/sdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+## Installation
+
+```bash
+npm install @wsocket-io/sdk
+```
+
+## Quick Start
+
+```typescript
+import { createClient } from '@wsocket-io/sdk';
+
+const client = createClient('wss://your-server.com', 'your-api-key');
+client.connect();
+
+const chat = client.channel('chat:general');
+
+chat.subscribe((data, meta) => {
+  console.log(`[${meta.channel}]`, data);
+});
+
+chat.publish({ text: 'Hello from JavaScript!' });
+```
+
+## Features
+
+- **Pub/Sub** — Subscribe and publish to channels in real-time
+- **Presence** — Track who is online in a channel
+- **History** — Retrieve past messages
+- **Push Notifications** — Web Push via Service Workers
+- **Connection Recovery** — Automatic reconnection with message replay
+- **TypeScript** — Full type definitions included
+
+## Presence
+
+```typescript
+const chat = client.channel('chat:general');
+
+chat.presence.onEnter((member) => {
+  console.log(`Joined: ${member.clientId}`);
+});
+
+chat.presence.onLeave((member) => {
+  console.log(`Left: ${member.clientId}`);
+});
+
+chat.presence.enter({ name: 'Alice' });
+const members = chat.presence.get();
+```
+
+## History
+
+```typescript
+chat.onHistory((result) => {
+  result.messages.forEach((msg) => {
+    console.log(`[${msg.timestamp}] ${JSON.stringify(msg.data)}`);
+  });
+});
+
+chat.history({ limit: 50 });
+```
+
+## Push Notifications
+
+```typescript
+client.configurePush({
+  vapidPublicKey: 'your-vapid-public-key',
+  serviceWorkerPath: '/sw.js',
+});
+
+await client.push?.subscribe('alerts');
+```
+
+## Requirements
+
+- Node.js >= 18 or modern browsers
+- `ws >= 8.0` (Node.js only)
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,95 @@
+import type { ConnectionState, WSocketOptions, EventCallback } from './types.js';
+import { Channel } from './pubsub/channel.js';
+import { PubSubNamespace } from './pubsub/index.js';
+import { PushClient, type PushClientOptions } from './push/index.js';
+export type { ConnectionState, WSocketOptions, ChannelSubscription, MessageMeta, PresenceMember, HistoryMessage, HistoryResult, HistoryOptions, PublishOptions, EventCallback, ClientMessage, ServerMessage, } from './types.js';
+export { Channel } from './pubsub/channel.js';
+export { Presence } from './pubsub/presence.js';
+export { PubSubNamespace } from './pubsub/index.js';
+export { PushClient, type PushClientOptions, type PushPayload } from './push/index.js';
+export declare class WSocket {
+    private ws;
+    private url;
+    private apiKey;
+    private options;
+    private state;
+    private channels;
+    private events;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private pingInterval;
+    private lastMessageTimestamp;
+    private resumeToken;
+    /** Pub/Sub namespace — `client.pubsub.channel('name')` */
+    readonly pubsub: PubSubNamespace;
+    /** Push notifications namespace — set via `client.configurePush(options)` */
+    push: PushClient | null;
+    constructor(url: string, apiKey: string, options?: WSocketOptions);
+    /**
+     * Configure push notification access.
+     *
+     * @example
+     * ```ts
+     * client.configurePush({
+     *   baseUrl: 'http://localhost:9001',
+     *   token: 'your-api-key',
+     *   appId: 'your-app-id',
+     * });
+     *
+     * await client.push!.sendToMember('user-1', { title: 'Hello' });
+     * ```
+     */
+    configurePush(options: PushClientOptions): PushClient;
+    /** Connect to the wSocket server */
+    connect(): Promise<void>;
+    /** Disconnect from the server */
+    disconnect(): void;
+    /**
+     * Get or create a channel.
+     * @deprecated Use `client.pubsub.channel(name)` for new code.
+     */
+    channel(name: string): Channel;
+    /** Listen for client events: 'connected', 'disconnected', 'error', 'state' */
+    on(event: string, callback: EventCallback): this;
+    /** Remove an event listener */
+    off(event: string, callback: EventCallback): this;
+    /** Current connection state */
+    get connectionState(): ConnectionState;
+    private send;
+    private handleMessage;
+    private setState;
+    private emit;
+    private resubscribeAll;
+    private scheduleReconnect;
+    private startPing;
+    private stopPing;
+}
+/**
+ * Create a new wSocket client.
+ *
+ * @example
+ * ```ts
+ * import { createClient } from '@wsocket/sdk';
+ *
+ * const client = createClient('ws://localhost:9001', 'your-api-key');
+ * await client.connect();
+ *
+ * // Pub/Sub (backward compatible)
+ * const chat = client.channel('chat');
+ * chat.subscribe((data, meta) => console.log('Received:', data));
+ * chat.publish({ text: 'Hello!' });
+ *
+ * // New namespaced API
+ * client.pubsub.channel('chat').publish({ text: 'Hello!' });
+ *
+ * // Push notifications
+ * client.configurePush({
+ *   baseUrl: 'http://localhost:9001',
+ *   token: 'your-api-key',
+ *   appId: 'your-app-id',
+ * });
+ * await client.push!.sendToMember('user-1', { title: 'New message!' });
+ * ```
+ */
+export declare function createClient(url: string, apiKey: string, options?: WSocketOptions): WSocket;
+//# 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":"AACA,OAAO,KAAK,EACV,eAAe,EAAE,cAAc,EACa,aAAa,EAC1D,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIrE,YAAY,EACV,eAAe,EAAE,cAAc,EAAE,mBAAmB,EACpD,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAC1D,cAAc,EAAE,cAAc,EAAE,aAAa,EAC7C,aAAa,EAAE,aAAa,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAIvF,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAA0E;IACzF,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,WAAW,CAAuB;IAE1C,0DAA0D;IAC1D,SAAgB,MAAM,EAAE,eAAe,CAAC;IAExC,6EAA6E;IACtE,IAAI,EAAE,UAAU,GAAG,IAAI,CAAQ;gBAE1B,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB;IAiBrE;;;;;;;;;;;;;OAaG;IACH,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU;IAOrD,oCAAoC;IACpC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkDxB,iCAAiC;IACjC,UAAU,IAAI,IAAI;IAelB;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAS9B,8EAA8E;IAC9E,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAQhD,+BAA+B;IAC/B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAKjD,+BAA+B;IAC/B,IAAI,eAAe,IAAI,eAAe,CAErC;IAID,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,aAAa;IAiFrB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,QAAQ;CAMjB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAE3F"}

package/dist/index.js

@@ -0,0 +1,354 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WSocket = exports.PushClient = exports.PubSubNamespace = exports.Presence = exports.Channel = void 0;
+exports.createClient = createClient;
+const ws_1 = __importDefault(require("ws"));
+const channel_js_1 = require("./pubsub/channel.js");
+const index_js_1 = require("./pubsub/index.js");
+const index_js_2 = require("./push/index.js");
+var channel_js_2 = require("./pubsub/channel.js");
+Object.defineProperty(exports, "Channel", { enumerable: true, get: function () { return channel_js_2.Channel; } });
+var presence_js_1 = require("./pubsub/presence.js");
+Object.defineProperty(exports, "Presence", { enumerable: true, get: function () { return presence_js_1.Presence; } });
+var index_js_3 = require("./pubsub/index.js");
+Object.defineProperty(exports, "PubSubNamespace", { enumerable: true, get: function () { return index_js_3.PubSubNamespace; } });
+var index_js_4 = require("./push/index.js");
+Object.defineProperty(exports, "PushClient", { enumerable: true, get: function () { return index_js_4.PushClient; } });
+// ─── wSocket Client ────────────────────────────────────────
+class WSocket {
+    ws = null;
+    url;
+    apiKey;
+    options;
+    state = 'disconnected';
+    channels = new Map();
+    events = new Map();
+    reconnectAttempts = 0;
+    reconnectTimer = null;
+    pingInterval = null;
+    lastMessageTimestamp = 0;
+    resumeToken = null;
+    /** Pub/Sub namespace — `client.pubsub.channel('name')` */
+    pubsub;
+    /** Push notifications namespace — set via `client.configurePush(options)` */
+    push = null;
+    constructor(url, apiKey, options = {}) {
+        this.url = url;
+        this.apiKey = apiKey;
+        this.options = {
+            autoReconnect: options.autoReconnect ?? true,
+            maxReconnectAttempts: options.maxReconnectAttempts ?? 10,
+            reconnectDelay: options.reconnectDelay ?? 1000,
+            token: options.token,
+            recover: options.recover ?? true,
+        };
+        // Pubsub namespace delegates to channel()
+        this.pubsub = new index_js_1.PubSubNamespace((name) => this.channel(name));
+    }
+    // ─── Push Configuration ──────────────────────────────────
+    /**
+     * Configure push notification access.
+     *
+     * @example
+     * ```ts
+     * client.configurePush({
+     *   baseUrl: 'http://localhost:9001',
+     *   token: 'your-api-key',
+     *   appId: 'your-app-id',
+     * });
+     *
+     * await client.push!.sendToMember('user-1', { title: 'Hello' });
+     * ```
+     */
+    configurePush(options) {
+        this.push = new index_js_2.PushClient(options);
+        return this.push;
+    }
+    // ─── Connection ──────────────────────────────────────────
+    /** Connect to the wSocket server */
+    connect() {
+        return new Promise((resolve, reject) => {
+            if (this.state === 'connected') {
+                resolve();
+                return;
+            }
+            this.setState('connecting');
+            const wsUrl = this.options.token
+                ? `${this.url}?token=${encodeURIComponent(this.options.token)}`
+                : `${this.url}?key=${encodeURIComponent(this.apiKey)}`;
+            try {
+                this.ws = new ws_1.default(wsUrl);
+            }
+            catch (err) {
+                this.setState('disconnected');
+                reject(err);
+                return;
+            }
+            this.ws.on('open', () => {
+                this.setState('connected');
+                this.reconnectAttempts = 0;
+                this.startPing();
+                this.resubscribeAll();
+                resolve();
+            });
+            this.ws.on('message', (raw) => {
+                this.handleMessage(raw.toString());
+            });
+            this.ws.on('close', (code) => {
+                this.stopPing();
+                this.emit('disconnected', code);
+                if (this.state !== 'disconnected' && this.options.autoReconnect) {
+                    this.scheduleReconnect();
+                }
+            });
+            this.ws.on('error', (err) => {
+                this.emit('error', err);
+                if (this.state === 'connecting') {
+                    reject(err);
+                }
+            });
+        });
+    }
+    /** Disconnect from the server */
+    disconnect() {
+        this.setState('disconnected');
+        this.stopPing();
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+    // ─── Channels ────────────────────────────────────────────
+    /**
+     * Get or create a channel.
+     * @deprecated Use `client.pubsub.channel(name)` for new code.
+     */
+    channel(name) {
+        if (!this.channels.has(name)) {
+            this.channels.set(name, new channel_js_1.Channel(name, (msg) => this.send(msg)));
+        }
+        return this.channels.get(name);
+    }
+    // ─── Events ──────────────────────────────────────────────
+    /** Listen for client events: 'connected', 'disconnected', 'error', 'state' */
+    on(event, callback) {
+        if (!this.events.has(event)) {
+            this.events.set(event, new Set());
+        }
+        this.events.get(event).add(callback);
+        return this;
+    }
+    /** Remove an event listener */
+    off(event, callback) {
+        this.events.get(event)?.delete(callback);
+        return this;
+    }
+    /** Current connection state */
+    get connectionState() {
+        return this.state;
+    }
+    // ─── Internal ────────────────────────────────────────────
+    send(msg) {
+        if (this.ws && this.ws.readyState === ws_1.default.OPEN) {
+            this.ws.send(JSON.stringify(msg));
+        }
+    }
+    handleMessage(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        switch (msg.action) {
+            case 'message': {
+                if (msg.channel) {
+                    const ch = this.channels.get(msg.channel);
+                    if (ch) {
+                        const ts = msg.timestamp || Date.now();
+                        if (ts > this.lastMessageTimestamp) {
+                            this.lastMessageTimestamp = ts;
+                        }
+                        ch._emit(msg.data, {
+                            id: msg.id || '',
+                            channel: msg.channel,
+                            timestamp: ts,
+                        });
+                    }
+                }
+                break;
+            }
+            case 'subscribed':
+                this.emit('subscribed', msg.channel);
+                break;
+            case 'unsubscribed':
+                this.emit('unsubscribed', msg.channel);
+                break;
+            case 'ack':
+                if (msg.id === 'resume' && msg.data?.resumeToken) {
+                    this.resumeToken = msg.data.resumeToken;
+                }
+                this.emit('ack', msg.id, msg.channel);
+                break;
+            case 'error':
+                this.emit('error', new Error(msg.error || 'Unknown error'));
+                break;
+            case 'pong':
+                break;
+            case 'presence.enter': {
+                if (msg.channel) {
+                    const ch = this.channels.get(msg.channel);
+                    if (ch)
+                        ch.presence._emitEnter(msg.data);
+                }
+                break;
+            }
+            case 'presence.leave': {
+                if (msg.channel) {
+                    const ch = this.channels.get(msg.channel);
+                    if (ch)
+                        ch.presence._emitLeave(msg.data);
+                }
+                break;
+            }
+            case 'presence.update': {
+                if (msg.channel) {
+                    const ch = this.channels.get(msg.channel);
+                    if (ch)
+                        ch.presence._emitUpdate(msg.data);
+                }
+                break;
+            }
+            case 'presence.members': {
+                if (msg.channel) {
+                    const ch = this.channels.get(msg.channel);
+                    if (ch)
+                        ch.presence._emitMembers(msg.data);
+                }
+                break;
+            }
+            case 'history': {
+                if (msg.channel) {
+                    const ch = this.channels.get(msg.channel);
+                    if (ch)
+                        ch._emitHistory(msg.data);
+                }
+                break;
+            }
+        }
+    }
+    setState(state) {
+        const prev = this.state;
+        this.state = state;
+        if (prev !== state) {
+            this.emit('state', state, prev);
+            if (state === 'connected')
+                this.emit('connected');
+        }
+    }
+    emit(event, ...args) {
+        const listeners = this.events.get(event);
+        if (listeners) {
+            for (const cb of listeners) {
+                try {
+                    cb(...args);
+                }
+                catch {
+                    // don't let listener errors propagate
+                }
+            }
+        }
+    }
+    resubscribeAll() {
+        if (this.options.recover && this.lastMessageTimestamp > 0) {
+            const channelNames = [];
+            for (const [, ch] of this.channels) {
+                if (ch._hasListeners) {
+                    channelNames.push(ch.name);
+                    ch._markForResubscribe();
+                }
+            }
+            if (channelNames.length > 0) {
+                const token = this.resumeToken || btoa(JSON.stringify({
+                    channels: channelNames,
+                    lastTs: this.lastMessageTimestamp,
+                }));
+                this.send({ action: 'resume', resumeToken: token });
+                return;
+            }
+        }
+        for (const [, ch] of this.channels) {
+            if (ch._hasListeners) {
+                ch._markForResubscribe();
+                this.send({ action: 'subscribe', channel: ch.name });
+            }
+        }
+    }
+    scheduleReconnect() {
+        if (this.reconnectAttempts >= this.options.maxReconnectAttempts) {
+            this.setState('disconnected');
+            this.emit('error', new Error('Max reconnect attempts reached'));
+            return;
+        }
+        this.setState('reconnecting');
+        const delay = this.options.reconnectDelay * Math.pow(2, this.reconnectAttempts);
+        this.reconnectAttempts++;
+        this.reconnectTimer = setTimeout(() => {
+            this.connect().catch(() => {
+                // will retry via close handler
+            });
+        }, delay);
+    }
+    startPing() {
+        this.pingInterval = setInterval(() => {
+            this.send({ action: 'ping' });
+        }, 30_000);
+    }
+    stopPing() {
+        if (this.pingInterval) {
+            clearInterval(this.pingInterval);
+            this.pingInterval = null;
+        }
+    }
+}
+exports.WSocket = WSocket;
+// ─── Factory ────────────────────────────────────────────────
+/**
+ * Create a new wSocket client.
+ *
+ * @example
+ * ```ts
+ * import { createClient } from '@wsocket/sdk';
+ *
+ * const client = createClient('ws://localhost:9001', 'your-api-key');
+ * await client.connect();
+ *
+ * // Pub/Sub (backward compatible)
+ * const chat = client.channel('chat');
+ * chat.subscribe((data, meta) => console.log('Received:', data));
+ * chat.publish({ text: 'Hello!' });
+ *
+ * // New namespaced API
+ * client.pubsub.channel('chat').publish({ text: 'Hello!' });
+ *
+ * // Push notifications
+ * client.configurePush({
+ *   baseUrl: 'http://localhost:9001',
+ *   token: 'your-api-key',
+ *   appId: 'your-app-id',
+ * });
+ * await client.push!.sendToMember('user-1', { title: 'New message!' });
+ * ```
+ */
+function createClient(url, apiKey, options) {
+    return new WSocket(url, apiKey, options);
+}
+//# 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/dist/pubsub/channel.d.ts

@@ -0,0 +1,32 @@
+import type { ClientMessage, MessageMeta, HistoryResult, HistoryOptions, PublishOptions } from '../types.js';
+import { Presence } from './presence.js';
+export declare class Channel {
+    readonly name: string;
+    private sendFn;
+    private listeners;
+    private subscribed;
+    readonly presence: Presence;
+    constructor(name: string, sendFn: (msg: ClientMessage) => void);
+    /** Subscribe to messages on this channel */
+    subscribe(callback: (data: unknown, meta: MessageMeta) => void, options?: {
+        rewind?: number;
+    }): this;
+    /** Publish data to this channel */
+    publish(data: unknown, options?: PublishOptions): this;
+    /** Query message history for this channel */
+    history(options?: HistoryOptions): this;
+    /** Listen for history query results */
+    onHistory(callback: (result: HistoryResult) => void): this;
+    /** @internal Emit history result to listeners */
+    _emitHistory(result: HistoryResult): void;
+    /** Unsubscribe from this channel */
+    unsubscribe(): void;
+    /** @internal Emit a message to listeners */
+    _emit(data: unknown, meta: MessageMeta): void;
+    /** @internal Mark as needing re-subscribe (after reconnect) */
+    _markForResubscribe(): void;
+    /** @internal Whether this channel has active listeners */
+    get _hasListeners(): boolean;
+    get isSubscribed(): boolean;
+}
+//# sourceMappingURL=channel.d.ts.map

package/dist/pubsub/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/pubsub/channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7G,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,qBAAa,OAAO;aAMA,IAAI,EAAE,MAAM;IAC5B,OAAO,CAAC,MAAM;IANhB,OAAO,CAAC,SAAS,CAAsE;IACvF,OAAO,CAAC,UAAU,CAAS;IAC3B,SAAgB,QAAQ,EAAE,QAAQ,CAAC;gBAGjB,IAAI,EAAE,MAAM,EACpB,MAAM,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI;IAK9C,4CAA4C;IAC5C,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAgBpG,mCAAmC;IACnC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAYtD,6CAA6C;IAC7C,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAavC,uCAAuC;IACvC,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAQ1D,iDAAiD;IACjD,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IASzC,oCAAoC;IACpC,WAAW,IAAI,IAAI;IAMnB,4CAA4C;IAC5C,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI;IAa7C,+DAA+D;IAC/D,mBAAmB,IAAI,IAAI;IAI3B,0DAA0D;IAC1D,IAAI,aAAa,IAAI,OAAO,CAG3B;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;CACF"}

package/dist/pubsub/channel.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Channel = void 0;
+const presence_js_1 = require("./presence.js");
+class Channel {
+    name;
+    sendFn;
+    listeners = new Map();
+    subscribed = false;
+    presence;
+    constructor(name, sendFn) {
+        this.name = name;
+        this.sendFn = sendFn;
+        this.presence = new presence_js_1.Presence(name, sendFn);
+    }
+    /** Subscribe to messages on this channel */
+    subscribe(callback, options) {
+        if (!this.listeners.has('message')) {
+            this.listeners.set('message', new Set());
+        }
+        this.listeners.get('message').add(callback);
+        if (!this.subscribed) {
+            const msg = { action: 'subscribe', channel: this.name };
+            if (options?.rewind)
+                msg.rewind = options.rewind;
+            this.sendFn(msg);
+            this.subscribed = true;
+        }
+        return this;
+    }
+    /** Publish data to this channel */
+    publish(data, options) {
+        const msg = {
+            action: 'publish',
+            channel: this.name,
+            data,
+            id: crypto.randomUUID?.() || `${Date.now()}-${Math.random().toString(36).slice(2)}`,
+        };
+        if (options?.persist === false)
+            msg.persist = false;
+        this.sendFn(msg);
+        return this;
+    }
+    /** Query message history for this channel */
+    history(options) {
+        const msg = {
+            action: 'history',
+            channel: this.name,
+        };
+        if (options?.limit)
+            msg.limit = options.limit;
+        if (options?.before)
+            msg.before = options.before;
+        if (options?.after)
+            msg.after = options.after;
+        if (options?.direction)
+            msg.direction = options.direction;
+        this.sendFn(msg);
+        return this;
+    }
+    /** Listen for history query results */
+    onHistory(callback) {
+        if (!this.listeners.has('history')) {
+            this.listeners.set('history', new Set());
+        }
+        this.listeners.get('history').add(callback);
+        return this;
+    }
+    /** @internal Emit history result to listeners */
+    _emitHistory(result) {
+        const listeners = this.listeners.get('history');
+        if (listeners) {
+            for (const cb of listeners) {
+                try {
+                    cb(result);
+                }
+                catch { /* ignore */ }
+            }
+        }
+    }
+    /** Unsubscribe from this channel */
+    unsubscribe() {
+        this.sendFn({ action: 'unsubscribe', channel: this.name });
+        this.subscribed = false;
+        this.listeners.clear();
+    }
+    /** @internal Emit a message to listeners */
+    _emit(data, meta) {
+        const listeners = this.listeners.get('message');
+        if (listeners) {
+            for (const cb of listeners) {
+                try {
+                    cb(data, meta);
+                }
+                catch {
+                    // don't let listener errors break the loop
+                }
+            }
+        }
+    }
+    /** @internal Mark as needing re-subscribe (after reconnect) */
+    _markForResubscribe() {
+        this.subscribed = false;
+    }
+    /** @internal Whether this channel has active listeners */
+    get _hasListeners() {
+        const listeners = this.listeners.get('message');
+        return !!listeners && listeners.size > 0;
+    }
+    get isSubscribed() {
+        return this.subscribed;
+    }
+}
+exports.Channel = Channel;
+//# sourceMappingURL=channel.js.map

package/dist/pubsub/channel.js.map

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

package/dist/pubsub/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * PubSub namespace — provides a scoped API surface for pub/sub operations.
+ *
+ * Usage:
+ *   client.pubsub.channel('chat').subscribe(cb);
+ *   client.pubsub.channel('chat').publish({ text: 'Hello!' });
+ *
+ * This is a lightweight proxy that delegates to the main WSocket instance.
+ */
+import type { Channel } from './channel.js';
+export { Channel } from './channel.js';
+export { Presence } from './presence.js';
+export declare class PubSubNamespace {
+    private channelFn;
+    constructor(channelFn: (name: string) => Channel);
+    /** Get or create a channel (same as client.channel()) */
+    channel(name: string): Channel;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/pubsub/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pubsub/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,qBAAa,eAAe;IAExB,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO;IAG9C,yDAAyD;IACzD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG/B"}

package/dist/pubsub/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * PubSub namespace — provides a scoped API surface for pub/sub operations.
+ *
+ * Usage:
+ *   client.pubsub.channel('chat').subscribe(cb);
+ *   client.pubsub.channel('chat').publish({ text: 'Hello!' });
+ *
+ * This is a lightweight proxy that delegates to the main WSocket instance.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PubSubNamespace = exports.Presence = exports.Channel = void 0;
+var channel_js_1 = require("./channel.js");
+Object.defineProperty(exports, "Channel", { enumerable: true, get: function () { return channel_js_1.Channel; } });
+var presence_js_1 = require("./presence.js");
+Object.defineProperty(exports, "Presence", { enumerable: true, get: function () { return presence_js_1.Presence; } });
+class PubSubNamespace {
+    channelFn;
+    constructor(channelFn) {
+        this.channelFn = channelFn;
+    }
+    /** Get or create a channel (same as client.channel()) */
+    channel(name) {
+        return this.channelFn(name);
+    }
+}
+exports.PubSubNamespace = PubSubNamespace;
+//# sourceMappingURL=index.js.map

package/dist/pubsub/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pubsub/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAIH,2CAAuC;AAA9B,qGAAA,OAAO,OAAA;AAChB,6CAAyC;AAAhC,uGAAA,QAAQ,OAAA;AAEjB,MAAa,eAAe;IAEhB;IADV,YACU,SAAoC;QAApC,cAAS,GAAT,SAAS,CAA2B;IAC3C,CAAC;IAEJ,yDAAyD;IACzD,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF;AATD,0CASC"}

package/dist/pubsub/presence.d.ts

@@ -0,0 +1,36 @@
+import type { ClientMessage, PresenceMember } from '../types.js';
+/** Presence API for a channel */
+export declare class Presence {
+    private channelName;
+    private sendFn;
+    private enterListeners;
+    private leaveListeners;
+    private updateListeners;
+    private membersListeners;
+    constructor(channelName: string, sendFn: (msg: ClientMessage) => void);
+    /** Enter presence set with optional data */
+    enter(data?: Record<string, unknown>): this;
+    /** Leave presence set */
+    leave(): this;
+    /** Update presence data */
+    update(data: Record<string, unknown>): this;
+    /** Get current members */
+    get(): this;
+    /** Listen for members entering */
+    onEnter(cb: (member: PresenceMember) => void): this;
+    /** Listen for members leaving */
+    onLeave(cb: (member: PresenceMember) => void): this;
+    /** Listen for presence data updates */
+    onUpdate(cb: (member: PresenceMember) => void): this;
+    /** Listen for member list response */
+    onMembers(cb: (members: PresenceMember[]) => void): this;
+    /** @internal */
+    _emitEnter(member: PresenceMember): void;
+    /** @internal */
+    _emitLeave(member: PresenceMember): void;
+    /** @internal */
+    _emitUpdate(member: PresenceMember): void;
+    /** @internal */
+    _emitMembers(members: PresenceMember[]): void;
+}
+//# sourceMappingURL=presence.d.ts.map

package/dist/pubsub/presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/pubsub/presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEjE,iCAAiC;AACjC,qBAAa,QAAQ;IAOjB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,MAAM;IAPhB,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,gBAAgB,CAAkD;gBAGhE,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI;IAG9C,4CAA4C;IAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK3C,yBAAyB;IACzB,KAAK,IAAI,IAAI;IAKb,2BAA2B;IAC3B,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK3C,0BAA0B;IAC1B,GAAG,IAAI,IAAI;IAKX,kCAAkC;IAClC,OAAO,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;IAKnD,iCAAiC;IACjC,OAAO,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;IAKnD,uCAAuC;IACvC,QAAQ,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;IAKpD,sCAAsC;IACtC,SAAS,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,IAAI,GAAG,IAAI;IAKxD,gBAAgB;IAChB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAIxC,gBAAgB;IAChB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAIxC,gBAAgB;IAChB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAIzC,gBAAgB;IAChB,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI;CAG9C"}

package/dist/pubsub/presence.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Presence = void 0;
+/** Presence API for a channel */
+class Presence {
+    channelName;
+    sendFn;
+    enterListeners = new Set();
+    leaveListeners = new Set();
+    updateListeners = new Set();
+    membersListeners = new Set();
+    constructor(channelName, sendFn) {
+        this.channelName = channelName;
+        this.sendFn = sendFn;
+    }
+    /** Enter presence set with optional data */
+    enter(data) {
+        this.sendFn({ action: 'presence.enter', channel: this.channelName, data });
+        return this;
+    }
+    /** Leave presence set */
+    leave() {
+        this.sendFn({ action: 'presence.leave', channel: this.channelName });
+        return this;
+    }
+    /** Update presence data */
+    update(data) {
+        this.sendFn({ action: 'presence.update', channel: this.channelName, data });
+        return this;
+    }
+    /** Get current members */
+    get() {
+        this.sendFn({ action: 'presence.get', channel: this.channelName });
+        return this;
+    }
+    /** Listen for members entering */
+    onEnter(cb) {
+        this.enterListeners.add(cb);
+        return this;
+    }
+    /** Listen for members leaving */
+    onLeave(cb) {
+        this.leaveListeners.add(cb);
+        return this;
+    }
+    /** Listen for presence data updates */
+    onUpdate(cb) {
+        this.updateListeners.add(cb);
+        return this;
+    }
+    /** Listen for member list response */
+    onMembers(cb) {
+        this.membersListeners.add(cb);
+        return this;
+    }
+    /** @internal */
+    _emitEnter(member) {
+        for (const cb of this.enterListeners) {
+            try {
+                cb(member);
+            }
+            catch { }
+        }
+    }
+    /** @internal */
+    _emitLeave(member) {
+        for (const cb of this.leaveListeners) {
+            try {
+                cb(member);
+            }
+            catch { }
+        }
+    }
+    /** @internal */
+    _emitUpdate(member) {
+        for (const cb of this.updateListeners) {
+            try {
+                cb(member);
+            }
+            catch { }
+        }
+    }
+    /** @internal */
+    _emitMembers(members) {
+        for (const cb of this.membersListeners) {
+            try {
+                cb(members);
+            }
+            catch { }
+        }
+    }
+}
+exports.Presence = Presence;
+//# sourceMappingURL=presence.js.map

package/dist/pubsub/presence.js.map

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

package/dist/push/index.d.ts

@@ -0,0 +1,55 @@
+export interface PushClientOptions {
+    /** API base URL (e.g. http://localhost:9001) */
+    baseUrl: string;
+    /** API key or JWT token for auth */
+    token: string;
+    /** App ID to register push for */
+    appId: string;
+}
+export interface PushPayload {
+    title: string;
+    body?: string;
+    icon?: string;
+    image?: string;
+    badge?: string;
+    url?: string;
+    data?: Record<string, unknown>;
+    ttl?: number;
+    urgency?: 'very-low' | 'low' | 'normal' | 'high';
+}
+export declare class PushClient {
+    private baseUrl;
+    private token;
+    private appId;
+    constructor(options: PushClientOptions);
+    /** Get the VAPID public key for Web Push subscription */
+    getVapidKey(): Promise<string | null>;
+    /** Register a Web Push subscription (browser) */
+    registerWebPush(subscription: any, memberId?: string): Promise<string>;
+    /** Register an FCM device token (Android) */
+    registerFCM(deviceToken: string, memberId?: string): Promise<string>;
+    /** Register an APNs device token (iOS) */
+    registerAPNs(deviceToken: string, memberId?: string): Promise<string>;
+    /** Unregister push notifications */
+    unregister(memberId: string, platform?: 'web' | 'fcm' | 'apns'): Promise<number>;
+    /** Send a push notification to a specific member */
+    sendToMember(memberId: string, payload: PushPayload): Promise<unknown>;
+    /** Send a push notification to multiple members */
+    sendToMembers(memberIds: string[], payload: PushPayload): Promise<unknown>;
+    /** Broadcast a push notification to all subscribers of the app */
+    broadcast(payload: PushPayload): Promise<unknown>;
+    /** List push subscriptions for the app */
+    listSubscriptions(options?: {
+        memberId?: string;
+        platform?: 'web' | 'fcm' | 'apns';
+        limit?: number;
+    }): Promise<unknown>;
+    /**
+     * Request browser permission and subscribe to Web Push.
+     * Returns the PushSubscription or null if denied/unsupported.
+     * Only works in browser environments.
+     */
+    subscribeBrowser(serviceWorkerPath?: string): Promise<any | null>;
+    private api;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/push/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/push/index.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAClD;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;gBAEV,OAAO,EAAE,iBAAiB;IAMtC,yDAAyD;IACnD,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAK3C,iDAAiD;IAC3C,eAAe,CAAC,YAAY,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAa5E,6CAA6C;IACvC,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAS1E,0CAA0C;IACpC,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAS3E,oCAAoC;IAC9B,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQtF,oDAAoD;IAC9C,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAO5E,mDAAmD;IAC7C,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAOhF,kEAAkE;IAC5D,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAMvD,0CAA0C;IACpC,iBAAiB,CAAC,OAAO,CAAC,EAAE;QAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;QAClC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,OAAO,CAAC;IASpB;;;;OAIG;IACG,gBAAgB,CAAC,iBAAiB,SAAW,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;YAuB3D,GAAG;CAelB"}

package/dist/push/index.js

@@ -0,0 +1,140 @@
+"use strict";
+// ─── Push Notification Client ───────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PushClient = void 0;
+class PushClient {
+    baseUrl;
+    token;
+    appId;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/$/, '');
+        this.token = options.token;
+        this.appId = options.appId;
+    }
+    /** Get the VAPID public key for Web Push subscription */
+    async getVapidKey() {
+        const res = await this.api('GET', `/api/admin/apps/${this.appId}/push/config`);
+        return res.vapidPublicKey || null;
+    }
+    /** Register a Web Push subscription (browser) */
+    async registerWebPush(subscription, memberId) {
+        const json = typeof subscription.toJSON === 'function' ? subscription.toJSON() : subscription;
+        const res = await this.api('POST', `/api/push/register`, {
+            provider: 'web',
+            memberId: memberId || 'anonymous',
+            webPush: {
+                endpoint: json.endpoint,
+                keys: json.keys,
+            },
+        });
+        return res.subscriptionId;
+    }
+    /** Register an FCM device token (Android) */
+    async registerFCM(deviceToken, memberId) {
+        const res = await this.api('POST', `/api/push/register`, {
+            provider: 'fcm',
+            memberId: memberId || 'anonymous',
+            deviceToken,
+        });
+        return res.subscriptionId;
+    }
+    /** Register an APNs device token (iOS) */
+    async registerAPNs(deviceToken, memberId) {
+        const res = await this.api('POST', `/api/push/register`, {
+            provider: 'apns',
+            memberId: memberId || 'anonymous',
+            deviceToken,
+        });
+        return res.subscriptionId;
+    }
+    /** Unregister push notifications */
+    async unregister(memberId, platform) {
+        const res = await this.api('DELETE', `/api/push/unregister`, {
+            memberId,
+            platform,
+        });
+        return res.unregistered;
+    }
+    /** Send a push notification to a specific member */
+    async sendToMember(memberId, payload) {
+        return this.api('POST', `/api/push/send`, {
+            memberId,
+            payload,
+        });
+    }
+    /** Send a push notification to multiple members */
+    async sendToMembers(memberIds, payload) {
+        return this.api('POST', `/api/push/send`, {
+            memberIds,
+            payload,
+        });
+    }
+    /** Broadcast a push notification to all subscribers of the app */
+    async broadcast(payload) {
+        return this.api('POST', `/api/push/broadcast`, {
+            payload,
+        });
+    }
+    /** List push subscriptions for the app */
+    async listSubscriptions(options) {
+        const params = new URLSearchParams();
+        if (options?.memberId)
+            params.set('memberId', options.memberId);
+        if (options?.platform)
+            params.set('platform', options.platform);
+        if (options?.limit)
+            params.set('limit', String(options.limit));
+        const qs = params.toString();
+        return this.api('GET', `/api/push/subscriptions${qs ? '?' + qs : ''}`);
+    }
+    /**
+     * Request browser permission and subscribe to Web Push.
+     * Returns the PushSubscription or null if denied/unsupported.
+     * Only works in browser environments.
+     */
+    async subscribeBrowser(serviceWorkerPath = '/sw.js') {
+        if (typeof window === 'undefined' || !('serviceWorker' in navigator) || !('PushManager' in window)) {
+            return null;
+        }
+        const permission = await Notification.requestPermission();
+        if (permission !== 'granted')
+            return null;
+        const vapidKey = await this.getVapidKey();
+        if (!vapidKey)
+            throw new Error('VAPID public key not available');
+        const reg = await navigator.serviceWorker.register(serviceWorkerPath);
+        await navigator.serviceWorker.ready;
+        const sub = await reg.pushManager.subscribe({
+            userVisibleOnly: true,
+            applicationServerKey: urlBase64ToUint8Array(vapidKey),
+        });
+        await this.registerWebPush(sub);
+        return sub;
+    }
+    async api(method, path, body) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.token}`,
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Push API error ${res.status}: ${text}`);
+        }
+        return res.json();
+    }
+}
+exports.PushClient = PushClient;
+function urlBase64ToUint8Array(base64String) {
+    const padding = '='.repeat((4 - (base64String.length % 4)) % 4);
+    const base64 = (base64String + padding).replace(/-/g, '+').replace(/_/g, '/');
+    const raw = atob(base64);
+    const arr = new Uint8Array(raw.length);
+    for (let i = 0; i < raw.length; i++)
+        arr[i] = raw.charCodeAt(i);
+    return arr;
+}
+//# sourceMappingURL=index.js.map

package/dist/push/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,72 @@
+export type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+export interface WSocketOptions {
+    /** Auto reconnect on disconnect (default: true) */
+    autoReconnect?: boolean;
+    /** Max reconnect attempts (default: 10) */
+    maxReconnectAttempts?: number;
+    /** Base reconnect delay in ms (default: 1000) */
+    reconnectDelay?: number;
+    /** Use JWT token instead of API key for auth */
+    token?: string;
+    /** Enable connection state recovery — resend missed messages on reconnect (default: true) */
+    recover?: boolean;
+}
+export interface ChannelSubscription {
+    channel: string;
+    callback: (data: unknown, meta: MessageMeta) => void;
+}
+export interface MessageMeta {
+    id: string;
+    channel: string;
+    timestamp: number;
+}
+export type EventCallback = (...args: unknown[]) => void;
+export interface ClientMessage {
+    action: 'subscribe' | 'unsubscribe' | 'publish' | 'ping' | 'presence.enter' | 'presence.leave' | 'presence.update' | 'presence.get' | 'history';
+    channel?: string;
+    data?: unknown;
+    id?: string;
+    persist?: boolean;
+    rewind?: number;
+    limit?: number;
+    before?: number;
+    after?: number;
+    direction?: 'forward' | 'backward';
+}
+export interface ServerMessage {
+    action: 'message' | 'subscribed' | 'unsubscribed' | 'error' | 'pong' | 'ack' | 'presence.enter' | 'presence.leave' | 'presence.update' | 'presence.members' | 'history';
+    channel?: string;
+    data?: unknown;
+    id?: string;
+    error?: string;
+    timestamp?: number;
+}
+export interface PresenceMember {
+    clientId: string;
+    data?: Record<string, unknown>;
+    joinedAt: number;
+}
+export interface HistoryMessage {
+    id: string;
+    channel: string;
+    data: unknown;
+    publisherId: string;
+    timestamp: number;
+    sequence: number;
+}
+export interface HistoryResult {
+    channel: string;
+    messages: HistoryMessage[];
+    hasMore: boolean;
+}
+export interface HistoryOptions {
+    limit?: number;
+    before?: number;
+    after?: number;
+    direction?: 'forward' | 'backward';
+}
+export interface PublishOptions {
+    /** Set to false to skip persisting to history (ephemeral message) */
+    persist?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;AAE3F,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6FAA6F;IAC7F,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAIzD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,GACpD,gBAAgB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,cAAc,GACxE,SAAS,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GACxE,gBAAgB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,kBAAkB,GAC5E,SAAS,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// ─── Shared Types ───────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,+DAA+D"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@wsocket-io/sdk",
+  "version": "0.1.0",
+  "description": "wSocket JavaScript SDK — Realtime Pub/Sub client",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist", "README.md", "LICENSE"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wsocket-io/sdk-js.git"
+  },
+  "homepage": "https://wsocket.io",
+  "bugs": {
+    "url": "https://github.com/wsocket-io/sdk-js/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": ["websocket", "pubsub", "realtime", "wsocket"],
+  "license": "MIT",
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5",
+    "@types/node": "^22.12.0",
+    "@types/ws": "^8.5.14"
+  }
+}