@ikonai/sdk 1.0.51 → 1.0.53

package/package.json

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

package/reactive/reactive-registry.d.ts

@@ -0,0 +1,41 @@
+import { FunctionRegistry } from '../functions/function-registry';
+export type ReactiveCallback<T> = (value: T) => void;
+export interface ReactiveSubscribeOptions {
+    /**
+     * Mount id when subscribing to a server-side <c>MountReactive&lt;T&gt;</c>. Empty/omitted
+     * means "no mount scope" — works for unscoped <c>Reactive&lt;T&gt;</c>, <c>ClientReactive&lt;T&gt;</c>,
+     * and <c>UserReactive&lt;T&gt;</c>.
+     */
+    mount?: string;
+}
+/**
+ * Subscribes a local callback to a server-side <c>Reactive&lt;T&gt;</c> over the existing
+ * function-call wire. The current value is fetched on first subscribe and pushed
+ * by the server on every change. Polling is unnecessary.
+ *
+ * Routing rides the same <c>FunctionRegistry</c> machinery used for any other RPC:
+ * subscribe is an <c>Ikon.Reactive.Subscribe</c> call; updates arrive as targeted
+ * <c>Ikon.Reactive.Update</c> calls from the app server. No new opcodes.
+ */
+export declare class ReactiveRegistry {
+    private readonly subscribersByKey;
+    private readonly functionRegistry;
+    private updateHandlerUnregister;
+    constructor(functionRegistry: FunctionRegistry);
+    /**
+     * Subscribe to a server-side reactive identified by its stable id.
+     * The callback fires once with the current value, then on every server-side change.
+     * Returns an unsubscribe function.
+     *
+     * Pass <c>options.mount</c> when subscribing to a <c>MountReactive&lt;T&gt;</c>.
+     */
+    subscribe<T>(stableId: string, callback: ReactiveCallback<T>, options?: ReactiveSubscribeOptions): Promise<() => void>;
+    /**
+     * Drop all subscriptions. Intended for use during client teardown — does not
+     * notify the server (the server's per-session subscription map is cleaned up
+     * when the session disconnects).
+     */
+    detach(): void;
+    private unsubscribeOne;
+    private registerUpdateHandler;
+}