@unicitylabs/sphere-sdk 0.3.5 → 0.3.7

package/dist/impl/nodejs/index.d.cts

@@ -422,6 +422,27 @@ interface TransportProvider extends BaseProvider {
      * @returns Unsubscribe function
      */
     onPaymentRequestResponse?(handler: PaymentRequestResponseHandler): () => void;
+    /**
+     * Send a read receipt for a message
+     * @param recipientTransportPubkey - Transport pubkey of the message sender
+     * @param messageEventId - Event ID of the message being acknowledged
+     */
+    sendReadReceipt?(recipientTransportPubkey: string, messageEventId: string): Promise<void>;
+    /**
+     * Subscribe to incoming read receipts
+     * @returns Unsubscribe function
+     */
+    onReadReceipt?(handler: ReadReceiptHandler): () => void;
+    /**
+     * Send typing indicator to a recipient
+     * @param recipientTransportPubkey - Transport pubkey of the conversation partner
+     */
+    sendTypingIndicator?(recipientTransportPubkey: string): Promise<void>;
+    /**
+     * Subscribe to incoming typing indicators
+     * @returns Unsubscribe function
+     */
+    onTypingIndicator?(handler: TypingIndicatorHandler): () => void;
     /**
      * Get list of configured relay URLs
      */
@@ -511,6 +532,10 @@ interface IncomingMessage {
     content: string;
     timestamp: number;
     encrypted: boolean;
+    /** Set when this is a self-wrap replay (sent message recovered from relay) */
+    isSelfWrap?: boolean;
+    /** Recipient pubkey — only present on self-wrap replays */
+    recipientTransportPubkey?: string;
 }
 type MessageHandler = (message: IncomingMessage) => void;
 interface TokenTransferPayload {
@@ -632,6 +657,24 @@ interface PeerInfo {
     /** Event timestamp */
     timestamp: number;
 }
+interface IncomingReadReceipt {
+    /** Transport-specific pubkey of the sender who read the message */
+    senderTransportPubkey: string;
+    /** Event ID of the message that was read */
+    messageEventId: string;
+    /** Timestamp */
+    timestamp: number;
+}
+type ReadReceiptHandler = (receipt: IncomingReadReceipt) => void;
+interface IncomingTypingIndicator {
+    /** Transport-specific pubkey of the sender who is typing */
+    senderTransportPubkey: string;
+    /** Sender's nametag (if known) */
+    senderNametag?: string;
+    /** Timestamp */
+    timestamp: number;
+}
+type TypingIndicatorHandler = (indicator: IncomingTypingIndicator) => void;
 
 /**
  * WebSocket Abstraction
@@ -724,6 +767,8 @@ declare class NostrTransportProvider implements TransportProvider {
     private transferHandlers;
     private paymentRequestHandlers;
     private paymentRequestResponseHandlers;
+    private readReceiptHandlers;
+    private typingIndicatorHandlers;
     private broadcastHandlers;
     private eventCallbacks;
     constructor(config: NostrTransportProviderConfig);
@@ -773,6 +818,10 @@ declare class NostrTransportProvider implements TransportProvider {
     onPaymentRequest(handler: PaymentRequestHandler): () => void;
     sendPaymentRequestResponse(recipientPubkey: string, payload: PaymentRequestResponsePayload): Promise<string>;
     onPaymentRequestResponse(handler: PaymentRequestResponseHandler): () => void;
+    sendReadReceipt(recipientTransportPubkey: string, messageEventId: string): Promise<void>;
+    onReadReceipt(handler: ReadReceiptHandler): () => void;
+    sendTypingIndicator(recipientTransportPubkey: string): Promise<void>;
+    onTypingIndicator(handler: TypingIndicatorHandler): () => void;
     /**
      * Resolve any identifier to full peer information.
      * Routes to the appropriate specific resolve method based on identifier format.
@@ -1112,6 +1161,7 @@ declare const NETWORKS: {
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
         readonly electrumUrl: "wss://fulcrum.alpha.unicity.network:50004";
         readonly groupRelays: readonly ["wss://sphere-relay.unicity.network"];
+        readonly tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
     };
     readonly testnet: {
         readonly name: "Testnet";
@@ -1120,6 +1170,7 @@ declare const NETWORKS: {
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
         readonly electrumUrl: "wss://fulcrum.alpha.testnet.unicity.network:50004";
         readonly groupRelays: readonly ["wss://sphere-relay.unicity.network"];
+        readonly tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
     };
     readonly dev: {
         readonly name: "Development";
@@ -1128,6 +1179,7 @@ declare const NETWORKS: {
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
         readonly electrumUrl: "wss://fulcrum.alpha.testnet.unicity.network:50004";
         readonly groupRelays: readonly ["wss://sphere-relay.unicity.network"];
+        readonly tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
     };
 };
 type NetworkType = keyof typeof NETWORKS;
@@ -1312,6 +1364,15 @@ interface BasePriceConfig {
     /** Enable debug logging */
     debug?: boolean;
 }
+/**
+ * Base market module configuration
+ */
+interface BaseMarketConfig {
+    /** Market API base URL (default: https://market-api.unicity.network) */
+    apiUrl?: string;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+}
 /**
  * Base providers result
  * Common structure for all platforms
@@ -1327,6 +1388,13 @@ interface BaseProviders {
     price?: PriceProvider;
 }
 
+interface MarketModuleConfig {
+    /** Market API base URL (default: https://market-api.unicity.network) */
+    apiUrl?: string;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+}
+
 /** IPFS storage provider configuration */
 interface IpfsStorageConfig {
     /** Gateway URLs for HTTP API (defaults to Unicity dedicated nodes) */
@@ -1419,6 +1487,8 @@ interface NodeProvidersConfig {
         enabled?: boolean;
         relays?: string[];
     } | boolean;
+    /** Market module configuration. true = enable with defaults, object = custom config */
+    market?: BaseMarketConfig | boolean;
 }
 interface NodeProviders {
     storage: StorageProvider;
@@ -1433,6 +1503,8 @@ interface NodeProviders {
     ipfsTokenStorage?: TokenStorageProvider<TxfStorageDataBase>;
     /** Group chat config (resolved, for passing to Sphere.init) */
     groupChat?: GroupChatModuleConfig | boolean;
+    /** Market module config (resolved, for passing to Sphere.init) */
+    market?: MarketModuleConfig | boolean;
 }
 /**
  * Create all Node.js providers with default configuration

package/dist/impl/nodejs/index.d.ts

@@ -422,6 +422,27 @@ interface TransportProvider extends BaseProvider {
      * @returns Unsubscribe function
      */
     onPaymentRequestResponse?(handler: PaymentRequestResponseHandler): () => void;
+    /**
+     * Send a read receipt for a message
+     * @param recipientTransportPubkey - Transport pubkey of the message sender
+     * @param messageEventId - Event ID of the message being acknowledged
+     */
+    sendReadReceipt?(recipientTransportPubkey: string, messageEventId: string): Promise<void>;
+    /**
+     * Subscribe to incoming read receipts
+     * @returns Unsubscribe function
+     */
+    onReadReceipt?(handler: ReadReceiptHandler): () => void;
+    /**
+     * Send typing indicator to a recipient
+     * @param recipientTransportPubkey - Transport pubkey of the conversation partner
+     */
+    sendTypingIndicator?(recipientTransportPubkey: string): Promise<void>;
+    /**
+     * Subscribe to incoming typing indicators
+     * @returns Unsubscribe function
+     */
+    onTypingIndicator?(handler: TypingIndicatorHandler): () => void;
     /**
      * Get list of configured relay URLs
      */
@@ -511,6 +532,10 @@ interface IncomingMessage {
     content: string;
     timestamp: number;
     encrypted: boolean;
+    /** Set when this is a self-wrap replay (sent message recovered from relay) */
+    isSelfWrap?: boolean;
+    /** Recipient pubkey — only present on self-wrap replays */
+    recipientTransportPubkey?: string;
 }
 type MessageHandler = (message: IncomingMessage) => void;
 interface TokenTransferPayload {
@@ -632,6 +657,24 @@ interface PeerInfo {
     /** Event timestamp */
     timestamp: number;
 }
+interface IncomingReadReceipt {
+    /** Transport-specific pubkey of the sender who read the message */
+    senderTransportPubkey: string;
+    /** Event ID of the message that was read */
+    messageEventId: string;
+    /** Timestamp */
+    timestamp: number;
+}
+type ReadReceiptHandler = (receipt: IncomingReadReceipt) => void;
+interface IncomingTypingIndicator {
+    /** Transport-specific pubkey of the sender who is typing */
+    senderTransportPubkey: string;
+    /** Sender's nametag (if known) */
+    senderNametag?: string;
+    /** Timestamp */
+    timestamp: number;
+}
+type TypingIndicatorHandler = (indicator: IncomingTypingIndicator) => void;
 
 /**
  * WebSocket Abstraction
@@ -724,6 +767,8 @@ declare class NostrTransportProvider implements TransportProvider {
     private transferHandlers;
     private paymentRequestHandlers;
     private paymentRequestResponseHandlers;
+    private readReceiptHandlers;
+    private typingIndicatorHandlers;
     private broadcastHandlers;
     private eventCallbacks;
     constructor(config: NostrTransportProviderConfig);
@@ -773,6 +818,10 @@ declare class NostrTransportProvider implements TransportProvider {
     onPaymentRequest(handler: PaymentRequestHandler): () => void;
     sendPaymentRequestResponse(recipientPubkey: string, payload: PaymentRequestResponsePayload): Promise<string>;
     onPaymentRequestResponse(handler: PaymentRequestResponseHandler): () => void;
+    sendReadReceipt(recipientTransportPubkey: string, messageEventId: string): Promise<void>;
+    onReadReceipt(handler: ReadReceiptHandler): () => void;
+    sendTypingIndicator(recipientTransportPubkey: string): Promise<void>;
+    onTypingIndicator(handler: TypingIndicatorHandler): () => void;
     /**
      * Resolve any identifier to full peer information.
      * Routes to the appropriate specific resolve method based on identifier format.
@@ -1112,6 +1161,7 @@ declare const NETWORKS: {
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
         readonly electrumUrl: "wss://fulcrum.alpha.unicity.network:50004";
         readonly groupRelays: readonly ["wss://sphere-relay.unicity.network"];
+        readonly tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
     };
     readonly testnet: {
         readonly name: "Testnet";
@@ -1120,6 +1170,7 @@ declare const NETWORKS: {
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
         readonly electrumUrl: "wss://fulcrum.alpha.testnet.unicity.network:50004";
         readonly groupRelays: readonly ["wss://sphere-relay.unicity.network"];
+        readonly tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
     };
     readonly dev: {
         readonly name: "Development";
@@ -1128,6 +1179,7 @@ declare const NETWORKS: {
         readonly ipfsGateways: readonly ["https://unicity-ipfs1.dyndns.org"];
         readonly electrumUrl: "wss://fulcrum.alpha.testnet.unicity.network:50004";
         readonly groupRelays: readonly ["wss://sphere-relay.unicity.network"];
+        readonly tokenRegistryUrl: "https://raw.githubusercontent.com/unicitynetwork/unicity-ids/refs/heads/main/unicity-ids.testnet.json";
     };
 };
 type NetworkType = keyof typeof NETWORKS;
@@ -1312,6 +1364,15 @@ interface BasePriceConfig {
     /** Enable debug logging */
     debug?: boolean;
 }
+/**
+ * Base market module configuration
+ */
+interface BaseMarketConfig {
+    /** Market API base URL (default: https://market-api.unicity.network) */
+    apiUrl?: string;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+}
 /**
  * Base providers result
  * Common structure for all platforms
@@ -1327,6 +1388,13 @@ interface BaseProviders {
     price?: PriceProvider;
 }
 
+interface MarketModuleConfig {
+    /** Market API base URL (default: https://market-api.unicity.network) */
+    apiUrl?: string;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+}
+
 /** IPFS storage provider configuration */
 interface IpfsStorageConfig {
     /** Gateway URLs for HTTP API (defaults to Unicity dedicated nodes) */
@@ -1419,6 +1487,8 @@ interface NodeProvidersConfig {
         enabled?: boolean;
         relays?: string[];
     } | boolean;
+    /** Market module configuration. true = enable with defaults, object = custom config */
+    market?: BaseMarketConfig | boolean;
 }
 interface NodeProviders {
     storage: StorageProvider;
@@ -1433,6 +1503,8 @@ interface NodeProviders {
     ipfsTokenStorage?: TokenStorageProvider<TxfStorageDataBase>;
     /** Group chat config (resolved, for passing to Sphere.init) */
     groupChat?: GroupChatModuleConfig | boolean;
+    /** Market module config (resolved, for passing to Sphere.init) */
+    market?: MarketModuleConfig | boolean;
 }
 /**
  * Create all Node.js providers with default configuration