@abndnce/pulsar-client 0.0.1

package/dist/index.d.mts

@@ -0,0 +1,32 @@
+//#region lib/connection/types.d.ts
+/**
+ * Every client connection, regardless of transport mode, satisfies this interface.
+ */
+interface PulsarClientConnection {
+  keepalive: RTCDataChannel;
+  pc: RTCPeerConnection;
+  close(): Promise<void>;
+}
+//#endregion
+//#region lib/connection/direct.d.ts
+/**
+ * Connect to a remote Pulsar server in direct mode.
+ *
+ * Designed for browsers, using the native `RTCPeerConnection` API.
+ *
+ * @param host  Server IP address
+ * @param port  Server UDP port
+ * @returns A connected PulsarClientConnection with an open keepalive channel.
+ */
+declare function connectDirect(host: string, port: number): Promise<PulsarClientConnection>;
+//#endregion
+//#region lib/connection/nostr.d.ts
+/**
+ * Connect via a Nostr relay (placeholder).
+ *
+ * In the future, this will implement a Nostr-based signaling layer for
+ * establishing peer connections through a Nostr relay.
+ */
+declare function connectNostr(_relay: string, _pubkey: string): Promise<PulsarClientConnection>;
+//#endregion
+export { type PulsarClientConnection, connectDirect, connectNostr };

package/dist/index.mjs

@@ -0,0 +1,81 @@
+//#region ../core/credentials.ts
+const PULSAR_UFRAG = "pulsar";
+const PULSAR_PWD = "pulsarpulsarpulsarpuls";
+const PULSAR_FINGERPRINT = "F1:85:10:8F:36:FF:58:D8:D0:4B:52:D7:ED:DC:5C:28:AE:7D:DB:54:0E:2A:DD:C7:C3:94:EA:A1:27:D0:4E:78";
+//#endregion
+//#region lib/connection/direct.ts
+/**
+* Connect to a remote Pulsar server in direct mode.
+*
+* Designed for browsers, using the native `RTCPeerConnection` API.
+*
+* @param host  Server IP address
+* @param port  Server UDP port
+* @returns A connected PulsarClientConnection with an open keepalive channel.
+*/
+async function connectDirect(host, port) {
+	const pc = new RTCPeerConnection();
+	const keepalive = pc.createDataChannel("keepalive", { ordered: true });
+	const offer = await pc.createOffer();
+	const mungedSdp = offer.sdp.replace(/^a=ice-ufrag:.*$/m, `a=ice-ufrag:${PULSAR_UFRAG}`).replace(/^a=ice-pwd:.*$/m, `a=ice-pwd:${PULSAR_PWD}`).replace(/^a=fingerprint:.*$/m, `a=fingerprint:sha-256 ${PULSAR_FINGERPRINT}`);
+	if (mungedSdp === offer.sdp) throw new Error("SDP munging failed – could not replace ICE credentials");
+	await pc.setLocalDescription({
+		type: "offer",
+		sdp: mungedSdp
+	});
+	const remoteSdp = [
+		"v=0",
+		"o=- 111 222 IN IP4 0.0.0.0",
+		"s=-",
+		"t=0 0",
+		`m=application ${port} UDP/DTLS/SCTP webrtc-datachannel`,
+		`c=IN IP4 ${host}`,
+		"a=mid:0",
+		`a=ice-ufrag:${PULSAR_UFRAG}`,
+		`a=ice-pwd:${PULSAR_PWD}`,
+		`a=fingerprint:sha-256 ${PULSAR_FINGERPRINT}`,
+		"a=setup:active",
+		"a=sctp-port:5000",
+		`a=candidate:1 1 UDP 2130706431 ${host} ${port} typ host`,
+		"a=end-of-candidates"
+	].join("\r\n");
+	await pc.setRemoteDescription({
+		type: "answer",
+		sdp: remoteSdp
+	});
+	await new Promise((resolve, reject) => {
+		const timeout = setTimeout(() => {
+			reject(/* @__PURE__ */ new Error("Connection timed out after 30s"));
+		}, 3e4);
+		pc.onconnectionstatechange = () => {
+			if (pc.connectionState === "connected") {
+				clearTimeout(timeout);
+				resolve();
+			} else if (pc.connectionState === "failed" || pc.connectionState === "disconnected") {
+				clearTimeout(timeout);
+				reject(/* @__PURE__ */ new Error(`Connection failed: ${pc.connectionState}`));
+			}
+		};
+	});
+	return {
+		keepalive,
+		pc,
+		async close() {
+			keepalive.close();
+			pc.close();
+		}
+	};
+}
+//#endregion
+//#region lib/connection/nostr.ts
+/**
+* Connect via a Nostr relay (placeholder).
+*
+* In the future, this will implement a Nostr-based signaling layer for
+* establishing peer connections through a Nostr relay.
+*/
+async function connectNostr(_relay, _pubkey) {
+	throw new Error("Nostr mode not yet implemented");
+}
+//#endregion
+export { connectDirect, connectNostr };

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@abndnce/pulsar-client",
+  "type": "module",
+  "version": "0.0.1",
+  "homepage": "https://github.com/abndnce/pulsar",
+  "license": "MIT",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsdown": "^0.22.0",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}