@wizardconnect/core 0.1.0

package/dist/relay-client.js

@@ -0,0 +1,323 @@
+import { throwUnless, unwrap } from "./primitives.js";
+import NDK, {
+  NDKPrivateKeySigner,
+  NDKUser,
+  NDKEvent,
+  NDKKind,
+  giftWrap,
+  giftUnwrap,
+} from "@nostr-dev-kit/ndk";
+import { binToHex, hash256, secp256k1 } from "@bitauth/libauth";
+import { EventEmitter } from "eventemitter3";
+import { isProtocolMessage, RelayMsgAction } from "./protocols/hdwalletv1.js";
+import { deriveNostrPublicKey } from "./utilnostr.js";
+import { MessageQueue } from "./message-queue.js";
+import { debug, error as logError, Scope } from "./log.js";
+export class RelayClient extends EventEmitter {
+  ndk;
+  paired;
+  config;
+  messageSubscription = null;
+  myPubkey;
+  myPubkeyHex;
+  lastProcessedTimestamp = 0;
+  messageQueue;
+  sequence = Math.floor(Math.random() * (Number.MAX_SAFE_INTEGER - 500_000));
+  pendingCalls = new Map();
+  pendingDeliveries = new Map();
+  constructor(config) {
+    super();
+    this.config = {
+      logNetworkActivity: true,
+      ...config,
+    };
+    this.ndk = new NDK({
+      explicitRelayUrls: this.config.explicitRelayUrls,
+      signer: new NDKPrivateKeySigner(this.config.signerPrivateKey),
+      enableOutboxModel: false,
+      autoConnectUserRelays: false,
+    });
+    this.messageQueue = new MessageQueue({
+      logActivity: this.config.logNetworkActivity,
+    });
+    this.myPubkey = unwrap(
+      secp256k1.derivePublicKeyCompressed(this.config.signerPrivateKey),
+    );
+    this.myPubkeyHex = deriveNostrPublicKey(this.config.signerPrivateKey);
+    if (this.config.pairedPublicKey) {
+      const pairedNostrPubkey =
+        this.config.pairedPublicKey.length === 33
+          ? this.config.pairedPublicKey.slice(1)
+          : this.config.pairedPublicKey;
+      this.paired = new NDKUser({ pubkey: binToHex(pairedNostrPubkey) });
+    } else {
+      this.paired = new NDKUser({ pubkey: "" });
+    }
+  }
+  setPairedPublicKey(pairedPublicKey) {
+    this.config.pairedPublicKey = pairedPublicKey;
+    const pairedNostrPubkey =
+      pairedPublicKey.length === 33
+        ? pairedPublicKey.slice(1)
+        : pairedPublicKey;
+    this.paired = new NDKUser({ pubkey: binToHex(pairedNostrPubkey) });
+    this.emit("paired");
+  }
+  getPublicKey() {
+    return this.myPubkey;
+  }
+  getPublicKeyHex() {
+    return this.myPubkeyHex;
+  }
+  isKeyExchangeComplete() {
+    if (!this.config.pairedPublicKey) {
+      return false;
+    }
+    return !this.config.pairedPublicKey.every((byte) => byte === 0);
+  }
+  async connect() {
+    if (this.config.logNetworkActivity) {
+      debug(Scope.Relay, `Connecting to relay...`);
+    }
+    if (this.lastProcessedTimestamp === 0) {
+      this.lastProcessedTimestamp = Math.floor(Date.now() / 1000) - 2;
+    }
+    try {
+      await this.ndk.connect();
+      if (this.config.logNetworkActivity) {
+        debug(Scope.Relay, `NDK connect() resolved`);
+      }
+      this.messageSubscription = this.ndk.subscribe(
+        {
+          kinds: [NDKKind.GiftWrap],
+          "#p": [this.myPubkeyHex],
+        },
+        { closeOnEose: false },
+      );
+      this.messageSubscription.on("event", async (wrappedEvent) => {
+        try {
+          const signer = this.ndk.signer;
+          if (!signer) {
+            throw new Error("No signer available");
+          }
+          const rumor = await giftUnwrap(wrappedEvent, undefined, signer);
+          if (rumor.kind === NDKKind.PrivateDirectMessage) {
+            let payload;
+            try {
+              payload = JSON.parse(rumor.content);
+            } catch (e) {
+              if (this.config.logNetworkActivity) {
+                logError(
+                  Scope.Relay,
+                  "Failed to parse message content as JSON:",
+                  e,
+                );
+              }
+              return;
+            }
+            if (
+              !payload.time ||
+              (this.lastProcessedTimestamp > 0 &&
+                payload.time < this.lastProcessedTimestamp)
+            ) {
+              if (this.config.logNetworkActivity) {
+                debug(
+                  Scope.Relay,
+                  `Ignoring already-processed message (time: ${payload.time}, action: ${payload.action}, last processed: ${this.lastProcessedTimestamp})`,
+                );
+              }
+              return;
+            }
+            // wallet_ready carries the key exchange data (public_key + secret) so it
+            // must bypass the peer filter — the dapp doesn't know the wallet's pubkey yet.
+            const isKeyExchangeMessage =
+              payload.action === RelayMsgAction.WalletReady;
+            if (!isKeyExchangeMessage && this.config.pairedPublicKey) {
+              const pairedNostrPubkey =
+                this.config.pairedPublicKey.length === 33
+                  ? binToHex(this.config.pairedPublicKey.slice(1))
+                  : binToHex(this.config.pairedPublicKey);
+              if (rumor.pubkey !== pairedNostrPubkey) {
+                if (this.config.logNetworkActivity) {
+                  debug(
+                    Scope.Relay,
+                    `Ignoring '${payload.action}' message from unknown peer: ${rumor.pubkey} (expected: ${pairedNostrPubkey})`,
+                  );
+                }
+                return;
+              }
+            }
+            if (this.config.logNetworkActivity) {
+              debug(
+                Scope.Relay,
+                `Received message ${payload.action} from relay`,
+              );
+            }
+            this.handleRelayMessage(payload);
+          } else {
+            if (this.config.logNetworkActivity) {
+              debug(
+                Scope.Relay,
+                `Ignoring non-PrivateDirectMessage, kind: ${rumor.kind}`,
+              );
+            }
+          }
+        } catch (error) {
+          if (this.config.logNetworkActivity) {
+            logError(Scope.Relay, "Error handling incoming message:", error);
+          }
+          this.emitError(error);
+        }
+      });
+      this.messageSubscription.on("close", () => {
+        if (this.config.logNetworkActivity) {
+          debug(Scope.Relay, "Subscription closed, connection may be stale");
+        }
+        this.emit("disconnect", new Error("Subscription closed"));
+      });
+      this.waitForRelaysReady();
+      if (this.config.logNetworkActivity) {
+        debug(
+          Scope.Relay,
+          `Subscription created and handler set up, emitting connection event`,
+        );
+      }
+      this.emit("connection");
+    } catch (error) {
+      if (this.config.logNetworkActivity) {
+        logError(Scope.Relay, `Connection failed:`, error);
+      }
+      throw error;
+    }
+  }
+  async disconnect() {
+    this.lastProcessedTimestamp = Math.floor(Date.now() / 1000);
+    this.messageQueue.setNotReady();
+    if (this.messageSubscription) {
+      this.messageSubscription.stop();
+      this.messageSubscription = null;
+    }
+  }
+  getLastProcessedTimestamp() {
+    return this.lastProcessedTimestamp;
+  }
+  setLastProcessedTimestamp(timestamp) {
+    this.lastProcessedTimestamp = timestamp;
+  }
+  async relay(message) {
+    if (!this.config.pairedPublicKey) {
+      throw new Error(
+        "Cannot relay message: paired public key not set. Call setPairedPublicKey() first.",
+      );
+    }
+    if (!this.messageQueue.getReady()) {
+      return this.messageQueue.enqueue(message);
+    }
+    return this.publishMessage(message);
+  }
+  async publishMessage(message) {
+    this.netlog("send", message.action);
+    const signer = this.ndk.signer;
+    if (!signer) {
+      throw new Error("No signer available");
+    }
+    const rumor = new NDKEvent(this.ndk);
+    rumor.kind = NDKKind.PrivateDirectMessage;
+    rumor.content = JSON.stringify(message);
+    rumor.created_at = Math.floor(Date.now() / 1000);
+    rumor.tags = [["p", this.paired.pubkey]];
+    const wrappedEvent = await giftWrap(rumor, this.paired, signer);
+    try {
+      await wrappedEvent.publish();
+      if (this.config.logNetworkActivity) {
+        debug(Scope.Relay, `Published message ${message.action} to relay`);
+      }
+    } catch (error) {
+      if (this.config.logNetworkActivity) {
+        logError(
+          Scope.Relay,
+          `Failed to publish message ${message.action}:`,
+          error,
+        );
+      }
+      throw error;
+    }
+  }
+  async waitForRelaysReady() {
+    const maxWaitTime = 5000;
+    const checkInterval = 100;
+    const startTime = Date.now();
+    const checkRelays = async () => {
+      const pool = this.ndk.pool;
+      if (pool) {
+        const relays = pool.relays || [];
+        // NDKRelayStatus: DISCONNECTED=1, CONNECTED=5, AUTHENTICATED=8
+        const connectedRelays = Array.from(relays.values()).filter(
+          (relay) => relay.status >= 5,
+        );
+        if (connectedRelays.length > 0) {
+          if (this.config.logNetworkActivity) {
+            debug(
+              Scope.Relay,
+              `Relays ready (${connectedRelays.length} connected), processing queued messages`,
+            );
+          }
+          await this.messageQueue.setReady((msg) => this.publishMessage(msg));
+          return;
+        }
+      }
+      if (Date.now() - startTime < maxWaitTime) {
+        setTimeout(checkRelays, checkInterval);
+      } else {
+        if (this.config.logNetworkActivity) {
+          debug(
+            Scope.Relay,
+            "Relay ready check timeout, assuming ready and processing queued messages",
+          );
+        }
+        await this.messageQueue.setReady((msg) => this.publishMessage(msg));
+      }
+    };
+    setTimeout(checkRelays, 200);
+  }
+  isConnected() {
+    return true;
+  }
+  netlog(direction, what, sequence) {
+    if (!this.config.logNetworkActivity) {
+      return;
+    }
+    const us = binToHex(hash256(this.config.signerPrivateKey)).slice(-6);
+    const them = this.config.pairedPublicKey
+      ? binToHex(this.config.pairedPublicKey).slice(-6)
+      : "??????";
+    const pending = `c${this.pendingCalls.size} d${this.pendingDeliveries.size}`;
+    if (direction === "send") {
+      debug(
+        Scope.Relay,
+        `net [${sequence ?? "?"} ${pending}] ${us} -> ${them}: ${what}`,
+      );
+    } else {
+      debug(
+        Scope.Relay,
+        `net [${sequence ?? "?"} ${pending}] ${us} <- ${them}: ${what}`,
+      );
+    }
+  }
+  async handleRelayMessage(message) {
+    throwUnless(
+      isProtocolMessage(message),
+      `Invalid protocol message: ${message}`,
+    );
+    this.emit("message", message);
+  }
+  nextSequence() {
+    const current = this.sequence;
+    this.sequence += 2;
+    return current;
+  }
+  emitError(error) {
+    this.emit("error", error);
+  }
+}
+//# sourceMappingURL=relay-client.js.map

package/dist/relay-client.js.map

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

package/dist/relay-handler.d.ts

@@ -0,0 +1,33 @@
+import { RelayClient } from "./relay-client.js";
+type RelayStatusCode =
+  | "connected"
+  | "reconnecting"
+  | "disconnected"
+  | "session_deleted";
+export declare class RelayStatus {
+  status: RelayStatusCode;
+  error: string | null;
+  sessionId: string | null;
+  private constructor();
+  static connected(sessionId?: string): RelayStatus;
+  static reconnecting(reason: string | null, sessionId?: string): RelayStatus;
+  static disconnected(): RelayStatus;
+  static sessionDeleted(): RelayStatus;
+}
+export interface RelayUpdatePayload {
+  client: RelayClient;
+  status: RelayStatus;
+}
+export type RelayStatusCallback = (_payload: RelayUpdatePayload) => void;
+export declare const initiateRelay: (
+  dispatchCallback: RelayStatusCallback,
+  signerPrivateKey: Uint8Array,
+  pairPublicKey: Uint8Array,
+  options?: {
+    explicitRelayUrls: string[];
+    reconnectInterval?: number;
+    maxReconnectAttempts?: number;
+    enableVisibilityHandling?: boolean;
+  },
+) => () => void;
+export {};

package/dist/relay-handler.js

@@ -0,0 +1,125 @@
+import { RelayClient } from "./relay-client.js";
+import { createConnectionManager } from "./connection-manager.js";
+import { debug, error as logError, Scope } from "./log.js";
+export class RelayStatus {
+  status;
+  error;
+  sessionId;
+  constructor(status, error, sessionId = null) {
+    this.status = status;
+    this.error = error;
+    this.sessionId = sessionId;
+  }
+  static connected(sessionId) {
+    return new RelayStatus("connected", null, sessionId || null);
+  }
+  static reconnecting(reason, sessionId) {
+    return new RelayStatus("reconnecting", reason, sessionId || null);
+  }
+  static disconnected() {
+    return new RelayStatus("disconnected", null, null);
+  }
+  static sessionDeleted() {
+    return new RelayStatus("session_deleted", null, null);
+  }
+}
+export const initiateRelay = (
+  dispatchCallback,
+  signerPrivateKey,
+  pairPublicKey,
+  options,
+) => {
+  const client = new RelayClient({
+    explicitRelayUrls: options?.explicitRelayUrls ?? [],
+    signerPrivateKey: signerPrivateKey,
+    pairedPublicKey: pairPublicKey,
+  });
+  let lastProcessedTimestamp = 0;
+  const connectionManager = createConnectionManager(
+    client,
+    {
+      onConnected: () => {
+        if (lastProcessedTimestamp > 0) {
+          client.setLastProcessedTimestamp(lastProcessedTimestamp);
+        } else {
+          lastProcessedTimestamp = client.getLastProcessedTimestamp();
+        }
+        dispatchCallback({
+          client,
+          status: RelayStatus.connected(),
+        });
+      },
+      onReconnecting: (_client, reason) => {
+        dispatchCallback({
+          client,
+          status: RelayStatus.reconnecting(reason),
+        });
+      },
+      onDisconnected: () => {
+        dispatchCallback({
+          client,
+          status: RelayStatus.disconnected(),
+        });
+      },
+      onError: (_client, _error) => {
+        // Error handling is already done in onReconnecting
+      },
+    },
+    {
+      connected: "connection",
+      disconnected: "disconnect",
+      error: "error",
+    },
+    {
+      reconnectInterval: options?.reconnectInterval,
+      maxReconnectAttempts: options?.maxReconnectAttempts,
+      enableVisibilityHandling: options?.enableVisibilityHandling ?? true,
+      scope: Scope.Relay,
+      onVisibilityChange: async (context) => {
+        if (context.state === "hidden") {
+          debug(Scope.Relay, "Page hidden, disconnecting relay");
+          context.setPaused(true);
+          try {
+            await client.disconnect();
+            lastProcessedTimestamp = client.getLastProcessedTimestamp();
+            debug(
+              Scope.Relay,
+              `Disconnected, last processed timestamp: ${lastProcessedTimestamp}`,
+            );
+            dispatchCallback({
+              client,
+              status: RelayStatus.disconnected(),
+            });
+          } catch (error) {
+            logError(
+              Scope.Relay,
+              "Error disconnecting on visibility change:",
+              error,
+            );
+          }
+        } else if (context.state === "visible") {
+          if (context.isPaused()) {
+            debug(Scope.Relay, "Page visible, reconnecting relay");
+            context.setPaused(false);
+            context.startConnectionLoop();
+          }
+        }
+      },
+    },
+  );
+  connectionManager.startConnectionLoop();
+  return () => {
+    dispatchCallback({
+      client,
+      status: RelayStatus.disconnected(),
+    });
+    (async () => {
+      try {
+        await connectionManager.cleanup();
+      } catch {
+        // Ignore disconnect errors during cleanup
+      }
+    })();
+  };
+};
+//# sourceMappingURL=relay-handler.js.map

package/dist/relay-handler.js.map

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

package/dist/utilnostr.d.ts

@@ -0,0 +1,4 @@
+export declare function deriveNostrPublicKey(privateKey: Uint8Array): string;
+export declare function deriveNostrPublicKeyBytes(
+  privateKey: Uint8Array,
+): Uint8Array;

package/dist/utilnostr.js

@@ -0,0 +1,16 @@
+import { binToHex, secp256k1 } from "@bitauth/libauth";
+import { unwrap } from "./primitives.js";
+export function deriveNostrPublicKey(privateKey) {
+  const publicKeyCompressed = unwrap(
+    secp256k1.derivePublicKeyCompressed(privateKey),
+  );
+  const publicKeyNostr = publicKeyCompressed.slice(1);
+  return binToHex(publicKeyNostr);
+}
+export function deriveNostrPublicKeyBytes(privateKey) {
+  const publicKeyCompressed = unwrap(
+    secp256k1.derivePublicKeyCompressed(privateKey),
+  );
+  return publicKeyCompressed.slice(1);
+}
+//# sourceMappingURL=utilnostr.js.map

package/dist/utilnostr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilnostr.js","sourceRoot":"","sources":["../src/utilnostr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,UAAU,oBAAoB,CAAC,UAAsB;IACzD,MAAM,mBAAmB,GAAG,MAAM,CAChC,SAAS,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAChD,CAAC;IACF,MAAM,cAAc,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,QAAQ,CAAC,cAAc,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,UAAsB;IAC9D,MAAM,mBAAmB,GAAG,MAAM,CAChC,SAAS,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAChD,CAAC;IACF,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC"}

package/dist/wallet-relay.d.ts

@@ -0,0 +1,20 @@
+import { RelayClient } from "./relay-client.js";
+import { RelayStatusCallback } from "./relay-handler.js";
+export interface WalletRelayOptions {
+  uri: string;
+  walletPrivateKey: Uint8Array;
+  explicitRelayUrls?: string[];
+  reconnectInterval?: number;
+  maxReconnectAttempts?: number;
+}
+export interface WalletRelayResult {
+  client: RelayClient;
+  dappPublicKey: Uint8Array;
+  walletPublicKey: Uint8Array;
+  secret: string;
+  cleanup: () => void;
+}
+export declare function initiateWalletRelay(
+  statusCallback: RelayStatusCallback,
+  options: WalletRelayOptions,
+): WalletRelayResult;

package/dist/wallet-relay.js

@@ -0,0 +1,71 @@
+import { initiateRelay } from "./relay-handler.js";
+import { decodeKeyExchangeURI, DEFAULT_RELAY_PORT } from "./key-exchange.js";
+import { binToHex, hexToBin } from "@bitauth/libauth";
+import { deriveNostrPublicKeyBytes } from "./utilnostr.js";
+export function initiateWalletRelay(statusCallback, options) {
+  let decoded;
+  try {
+    decoded = decodeKeyExchangeURI(options.uri);
+  } catch (err) {
+    throw new Error(`Failed to decode connection URI: ${err.message}`, {
+      cause: err,
+    });
+  }
+  const dappPublicKeyHex = decoded.publicKey;
+  const secret = decoded.secret;
+  const dappPublicKeyNostr = hexToBin(dappPublicKeyHex);
+  const hostname = decoded.hostname;
+  const protocol = decoded.protocol;
+  const port = decoded.port;
+  const relayUrl = `${protocol}://${hostname}${port === (protocol === "wss" ? DEFAULT_RELAY_PORT : 80) ? "" : `:${port}`}`;
+  const walletPublicKeyNostr = deriveNostrPublicKeyBytes(
+    options.walletPrivateKey,
+  );
+  const walletPublicKeyHex = binToHex(walletPublicKeyNostr);
+  let relayClient = null;
+  const wrappedCallback = (payload) => {
+    if (!relayClient) {
+      relayClient = payload.client;
+    }
+    if (payload.status.status === "connected") {
+      // Set dapp's pubkey so outbound messages are addressed correctly.
+      // The wallet's own pubkey + secret are delivered via wallet_ready.
+      relayClient.setPairedPublicKey(dappPublicKeyNostr);
+    }
+    statusCallback(payload);
+  };
+  const relayUrls = [relayUrl];
+  if (options.explicitRelayUrls && options.explicitRelayUrls.length > 0) {
+    for (const explicitUrl of options.explicitRelayUrls) {
+      if (!relayUrls.includes(explicitUrl)) {
+        relayUrls.push(explicitUrl);
+      }
+    }
+  }
+  const cleanup = initiateRelay(
+    wrappedCallback,
+    options.walletPrivateKey,
+    dappPublicKeyNostr,
+    {
+      explicitRelayUrls: relayUrls,
+      reconnectInterval: options.reconnectInterval,
+      maxReconnectAttempts: options.maxReconnectAttempts,
+    },
+  );
+  const result = {
+    get client() {
+      if (!relayClient) {
+        throw new Error(
+          "Relay client not yet initialized. Wait for connection status callback.",
+        );
+      }
+      return relayClient;
+    },
+    dappPublicKey: dappPublicKeyNostr,
+    walletPublicKey: walletPublicKeyNostr,
+    secret,
+    cleanup,
+  };
+  return result;
+}
+//# sourceMappingURL=wallet-relay.js.map

package/dist/wallet-relay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-relay.js","sourceRoot":"","sources":["../src/wallet-relay.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAkB3D,MAAM,UAAU,mBAAmB,CACjC,cAAmC,EACnC,OAA2B;IAE3B,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,CAAC,OAAO,EAAE,EAAE;YACjE,KAAK,EAAE,GAAG;SACX,CAAC,CAAC;IACL,CAAC;IAED,MAAM,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;IAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,MAAM,kBAAkB,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAEtD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,MAAM,QAAQ,GAAG,GAAG,QAAQ,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;IAEzH,MAAM,oBAAoB,GAAG,yBAAyB,CACpD,OAAO,CAAC,gBAAgB,CACzB,CAAC;IACF,MAAM,kBAAkB,GAAG,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IAE1D,IAAI,WAAW,GAAuB,IAAI,CAAC;IAE3C,MAAM,eAAe,GAAwB,CAC3C,OAA2B,EAC3B,EAAE;QACF,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/B,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC1C,kEAAkE;YAClE,mEAAmE;YACnE,WAAY,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC;QACtD,CAAC;QAED,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC,CAAC;IAEF,MAAM,SAAS,GAAa,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,iBAAiB,IAAI,OAAO,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtE,KAAK,MAAM,WAAW,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACpD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACrC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,aAAa,CAC3B,eAAe,EACf,OAAO,CAAC,gBAAgB,EACxB,kBAAkB,EAClB;QACE,iBAAiB,EAAE,SAAS;QAC5B,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;KACnD,CACF,CAAC;IAEF,MAAM,MAAM,GAAsB;QAChC,IAAI,MAAM;YACR,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CACb,wEAAwE,CACzE,CAAC;YACJ,CAAC;YACD,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,aAAa,EAAE,kBAAkB;QACjC,eAAe,EAAE,oBAAoB;QACrC,MAAM;QACN,OAAO;KACR,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@wizardconnect/core",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Transport and protocol primitives for WizardConnect",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest --config vitest.config.ts --run --passWithNoTests",
+    "lint:prettier": "prettier . --list-different",
+    "lint:eslint": "eslint .",
+    "lint": "npm run lint:eslint && npm run lint:prettier",
+    "fix": "npm run fix:eslint && npm run fix:prettier",
+    "fix:prettier": "prettier . --write",
+    "fix:eslint": "npm run lint:eslint -- --fix"
+  },
+  "dependencies": {
+    "@bch-wc2/interfaces": "^0.0.8",
+    "@nostr-dev-kit/ndk": "^2.18.1",
+    "@bitauth/libauth": "^3.1.0-next.2",
+    "eventemitter3": "^5.0.1",
+    "isomorphic-ws": "^5.0.0",
+    "lossless-json": "^4.3.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.2",
+    "vitest": "^3.2.3"
+  }
+}