feat(clerk): expose resolved ledgerId from token strategy

Author: necrodome

use-fireproof/clerk/clerk-token-strategy.ts

@@ -11,6 +11,7 @@ export class ClerkTokenStrategy implements TokenStrategie {
   private dashApi: DashboardApiImpl<unknown>;
   private apiUrl: string;
   private lastExpiryMs: number | null = null;
+  private resolvedLedgerId: string | null = null;
 
   constructor(dashApi: DashboardApiImpl<unknown>, apiUrl: string) {
     this.dashApi = dashApi;
@@ -25,6 +26,14 @@ export class ClerkTokenStrategy implements TokenStrategie {
     return this.lastExpiryMs;
   }
 
+  /**
+   * Get the resolved ledger ID from the last ensureCloudToken call.
+   * Returns null if no token has been obtained yet.
+   */
+  getLedgerId(): string | null {
+    return this.resolvedLedgerId;
+  }
+
   hash(): string {
     return this.apiUrl;
   }
@@ -85,6 +94,9 @@ export class ClerkTokenStrategy implements TokenStrategie {
     if (res.expiresDate) {
       this.lastExpiryMs = new Date(res.expiresDate).getTime();
     }
+    if (res.ledger) {
+      this.resolvedLedgerId = res.ledger;
+    }
     return {
       token: res.cloudToken,
       ...res,

use-fireproof/clerk/types.ts

@@ -41,6 +41,8 @@ export interface UseFireproofClerkResult extends UseFireproof {
   syncStatus: SyncStatus;
   /** Last sync error if any */
   lastSyncError?: Error;
+  /** Resolved ledger ID from the dashboard (available after attach) */
+  ledgerId: string | null;
 }
 
 export interface ClerkContextValue {

use-fireproof/clerk/use-fireproof-clerk.ts

@@ -51,6 +51,7 @@ export function useFireproofClerk(name: string | Database): UseFireproofClerkRes
   const [attachState, setAttachState] = useState<AttachState>({ status: "detached" });
   const [syncStatus, setSyncStatus] = useState<SyncStatus>("idle");
   const [lastSyncError, setLastSyncError] = useState<Error | undefined>(undefined);
+  const [ledgerId, setLedgerId] = useState<string | null>(null);
 
   const attachingRef = useRef(false);
   const refreshTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
@@ -125,6 +126,7 @@ export function useFireproofClerk(name: string | Database): UseFireproofClerkRes
       }
 
       retryCountRef.current = 0;
+      setLedgerId(strategy.getLedgerId());
       setAttachState({ status: "attached", attached });
       setSyncStatus("synced");
       setLastSyncError(undefined);
@@ -170,6 +172,7 @@ export function useFireproofClerk(name: string | Database): UseFireproofClerkRes
       }
 
       retryCountRef.current = 0;
+      setLedgerId(strategy.getLedgerId());
       setAttachState({ status: "attached", attached });
       setSyncStatus("synced");
       setLastSyncError(undefined);
@@ -351,5 +354,6 @@ export function useFireproofClerk(name: string | Database): UseFireproofClerkRes
     isSyncing: attachState.status === "attached",
     syncStatus,
     lastSyncError,
+    ledgerId,
   };
 }