@ikonai/sdk-ui 1.0.80 → 1.1.1

package/live-snapshot.d.ts

@@ -41,6 +41,11 @@ export interface LiveSnapshotState {
  * The key embeds the user id, and sibling keys for other users of the same app are pruned on
  * construction so a shared device never paints one user's UI for another. A missing user id
  * disables the live snapshot rather than falling back to a shared key.
+ *
+ * The snapshot is bound to the server instance it was captured from (see
+ * {@link setServerSessionId}): it only resumes when the next connection lands on that same
+ * instance, and a server-signaled shutdown ({@link handleServerShutdown}) clears it and stops
+ * capture — a dead instance's UI must never be painted as if it were alive.
  */
 export declare class LiveSnapshotCache {
     private readonly key;
@@ -52,10 +57,28 @@ export declare class LiveSnapshotCache {
     private readonly debounceMs;
     private writeTimer;
     private pending;
+    private serverSessionId;
+    private suppressed;
     /** Remove every stored live snapshot (all apps and users) from localStorage. Call on logout. */
     static clearAll(): void;
     constructor(config: LiveSnapshotConfig);
     load(): LiveSnapshotState | null;
+    /**
+     * Record the session id of the server instance the client is now connected to. Future writes
+     * are stamped with it, and a stored envelope captured against a DIFFERENT instance is removed:
+     * that UI can never resume, so seeding it on the next load would paint a dead-looking page.
+     * Called on every 'connected' transition — a soft reconnect (same instance) keeps the envelope,
+     * a re-authentication that lands on a new instance drops it. An envelope with no stamp (older
+     * schema, or captured before the id was known) is treated as stale.
+     */
+    setServerSessionId(serverSessionId: string): void;
+    /**
+     * The server signaled shutdown: the stored envelope depicts an instance that is going away, so
+     * a return visit must never paint it. Removes the stored snapshot, drops any pending write, and
+     * suppresses all further capture for the rest of this cache's lifetime — after this call
+     * localStorage deterministically holds no live snapshot for this app/user.
+     */
+    handleServerShutdown(): void;
     /**
      * Schedule a throttled write of the current UI state (at most one write per window, captured at
      * the trailing edge). Streams with no root are skipped. The actual write runs at idle time.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikonai/sdk-ui",
-  "version": "1.0.80",
+  "version": "1.1.1",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",

package/parse-ui-update.d.ts

@@ -1,4 +1,4 @@
-import { UIUpdate } from '../../../shared/protocol/src/index.ts';
+import { UIUpdate } from '../shared/protocol/src/index.ts';
 import { ParsedUiUpdate } from './ui-types';
 export declare class UiUpdateParseError extends Error {
     readonly causeError?: unknown | undefined;

package/ui-store-ops.d.ts

@@ -1,4 +1,4 @@
-import { UIPayload } from '../../../shared/protocol/src/index.ts';
+import { UIPayload } from '../shared/protocol/src/index.ts';
 import { UiNode } from './ui-types';
 export interface UiStreamSnapshotWire {
     streamId: string;

package/ui-types.d.ts

@@ -1,4 +1,4 @@
-import { UIPayload } from '../../../shared/protocol/src/index.ts';
+import { UIPayload } from '../shared/protocol/src/index.ts';
 export type UiUpdateType = 'full' | 'diff';
 export type UiNodeProps = Record<string, unknown>;
 export interface UiNode {

package/vite.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vite').UserConfig;
+export default _default;