@nolag/signal 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @nolag/signal — Public types
+ */
+export interface NoLagSignalOptions {
+    /** Custom metadata attached to peer presence */
+    metadata?: Record<string, unknown>;
+    /** NoLag app name (default: 'signal') */
+    appName?: string;
+    /** WebSocket URL override */
+    url?: string;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+    /** Auto-reconnect on disconnect (default: true) */
+    reconnect?: boolean;
+}
+/** Resolved options with defaults applied */
+export interface ResolvedSignalOptions {
+    metadata?: Record<string, unknown>;
+    appName: string;
+    url?: string;
+    debug: boolean;
+    reconnect: boolean;
+}
+export type SignalType = 'offer' | 'answer' | 'ice-candidate' | 'renegotiate' | 'bye';
+export interface SignalMessage {
+    /** Client-generated unique ID */
+    id: string;
+    /** Signal type */
+    type: SignalType;
+    /** Sender's peerId */
+    fromPeerId: string;
+    /** Recipient's peerId (targeted delivery) */
+    toPeerId: string;
+    /** Signal payload */
+    payload: RTCSessionDescriptionInit | RTCIceCandidateInit | Record<string, unknown>;
+    /** Timestamp (ms since epoch) */
+    timestamp: number;
+}
+export interface Peer {
+    /** Stable client-generated peer ID */
+    peerId: string;
+    /** NoLag internal actor token ID */
+    actorTokenId: string;
+    /** WebRTC connection state */
+    connectionState: 'new' | 'connecting' | 'connected' | 'disconnected';
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+    /** Timestamp when the peer joined */
+    joinedAt: number;
+    /** Whether this is the local peer */
+    isLocal: boolean;
+}
+export interface SignalClientEvents {
+    connected: [];
+    disconnected: [reason: string];
+    reconnected: [];
+    error: [error: Error];
+    peerOnline: [peer: Peer];
+    peerOffline: [peer: Peer];
+}
+export interface SignalRoomEvents {
+    signal: [message: SignalMessage];
+    peerJoined: [peer: Peer];
+    peerLeft: [peer: Peer];
+}
+/** Shape of data stored in NoLag presence for signal peers */
+export interface SignalPresenceData {
+    [key: string]: unknown;
+    peerId: string;
+    metadata?: Record<string, unknown>;
+}

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function generateId(): string;
+export declare function createLogger(prefix: string, enabled: boolean): (..._args: unknown[]) => void;

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@nolag/signal",
+  "version": "0.1.0",
+  "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "description": "WebRTC signaling SDK for NoLag — peer discovery, offer/answer/ICE exchange",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "browser": "./dist/browser.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "browser": {
+        "types": "./dist/browser.d.ts",
+        "default": "./dist/browser.js"
+      },
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      },
+      "default": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NoLagApp/blueprints.git",
+    "directory": "js/signal"
+  },
+  "author": "NoLag",
+  "license": "MIT",
+  "homepage": "https://nolag.app",
+  "devDependencies": {
+    "@nolag/js-sdk": "^1.2.0"
+  },
+  "peerDependencies": {
+    "@nolag/js-sdk": "^1.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}