@unicitylabs/sphere-sdk 0.14.1-dev.1 → 0.14.1

package/dist/core/index.d.cts

@@ -659,8 +659,8 @@ interface SphereEventMap {
     };
     /** The wallet-api inventory mirror changed — re-read tokens()/assets(). */
     'inventory:updated': Record<string, never>;
-    /** History changed — re-read via history(). */
-    'history:updated': Record<string, never>;
+    /** History changed — carries the just-recorded client-shaped entry (same toEntry mapping history() serves). */
+    'history:updated': HistoryEntry;
     'payment_request:incoming': PaymentRequestView;
     'payment_request:updated': {
         id: string;
@@ -2632,6 +2632,14 @@ interface FacadeSession {
     start(): Promise<void>;
     stop(): Promise<void>;
     subscribeStream(stream: 'inventory' | 'mailbox' | 'payment_requests', handler: () => void): () => void;
+    /** §5.1: the latched server syncEpoch ('' before first server contact). */
+    currentEpoch(): string;
+    /**
+     * §5.1 restore hook — REQUIRED so an unwired restore protocol is a COMPILE
+     * ERROR: handlers run and are AWAITED on a syncEpoch change BEFORE any
+     * stream nudge resumes. The facade registers handleEpochChange here.
+     */
+    subscribeEpochChange(handler: (epoch: string) => Promise<void>): () => void;
     /**
      * Optional connection-status feed (same wiring pattern as the streams; the
      * emission point is the session's existing `connection:status` transition).
@@ -2920,7 +2928,6 @@ interface PaymentsV2TransportArgs {
     /** Per-(network, address) scoped KV — refresh token, cursors, seen-set live here. */
     kv: ScopedKV;
     emitStatus: (status: ConnectionStatus) => void;
-    onEpochChange: (epoch: string) => Promise<void>;
 }
 /**
  * The `Sphere.init({ walletApi })` transport config — built by

package/dist/core/index.d.ts

@@ -659,8 +659,8 @@ interface SphereEventMap {
     };
     /** The wallet-api inventory mirror changed — re-read tokens()/assets(). */
     'inventory:updated': Record<string, never>;
-    /** History changed — re-read via history(). */
-    'history:updated': Record<string, never>;
+    /** History changed — carries the just-recorded client-shaped entry (same toEntry mapping history() serves). */
+    'history:updated': HistoryEntry;
     'payment_request:incoming': PaymentRequestView;
     'payment_request:updated': {
         id: string;
@@ -2632,6 +2632,14 @@ interface FacadeSession {
     start(): Promise<void>;
     stop(): Promise<void>;
     subscribeStream(stream: 'inventory' | 'mailbox' | 'payment_requests', handler: () => void): () => void;
+    /** §5.1: the latched server syncEpoch ('' before first server contact). */
+    currentEpoch(): string;
+    /**
+     * §5.1 restore hook — REQUIRED so an unwired restore protocol is a COMPILE
+     * ERROR: handlers run and are AWAITED on a syncEpoch change BEFORE any
+     * stream nudge resumes. The facade registers handleEpochChange here.
+     */
+    subscribeEpochChange(handler: (epoch: string) => Promise<void>): () => void;
     /**
      * Optional connection-status feed (same wiring pattern as the streams; the
      * emission point is the session's existing `connection:status` transition).
@@ -2920,7 +2928,6 @@ interface PaymentsV2TransportArgs {
     /** Per-(network, address) scoped KV — refresh token, cursors, seen-set live here. */
     kv: ScopedKV;
     emitStatus: (status: ConnectionStatus) => void;
-    onEpochChange: (epoch: string) => Promise<void>;
 }
 /**
  * The `Sphere.init({ walletApi })` transport config — built by