@honua/react 0.0.20-alpha.0

package/runtime/map-package-watch.d.ts

@@ -0,0 +1,78 @@
+import { type MapPackageDiff } from "./diff.js";
+import { type FetchMapPackageOptions, type FetchMapPackageResult, type MapPackageLocator } from "./map-package-fetch.js";
+import type { MapPackageRealtimeCheckpoint, MapPackageRealtimeFallbackMode, MapPackageRealtimeTransportKind, MapPackageRealtimeWatchOptions } from "./map-package-realtime.js";
+import type { HonuaMapPackage } from "./map-package.js";
+import type { HonuaMapRuntime } from "./runtime.js";
+export type MapPackageWatchEvent = {
+    readonly type: "connected";
+    readonly transport: MapPackageRealtimeTransportKind;
+    readonly channel?: string;
+    readonly url?: string;
+    readonly advertised: boolean;
+    readonly resumedFrom?: MapPackageRealtimeCheckpoint;
+} | {
+    readonly type: "disconnected";
+    readonly transport?: MapPackageRealtimeTransportKind;
+    readonly reason?: string;
+    readonly willReconnect: boolean;
+    readonly reconnectAttempt?: number;
+} | {
+    readonly type: "stale";
+    readonly reason: string;
+    readonly retryAfterMs?: number;
+    readonly fallback: boolean;
+} | {
+    readonly type: "fallback";
+    readonly mode: MapPackageRealtimeFallbackMode;
+    readonly reason: string;
+    readonly error?: unknown;
+} | {
+    readonly type: "fetched";
+    readonly result: FetchMapPackageResult;
+} | {
+    readonly type: "unchanged";
+    readonly result: FetchMapPackageResult;
+} | {
+    readonly type: "updated";
+    readonly result: FetchMapPackageResult;
+    readonly diff: MapPackageDiff | undefined;
+    readonly applied: boolean;
+} | {
+    readonly type: "reload-required";
+    readonly result: FetchMapPackageResult;
+    readonly diff: MapPackageDiff;
+    readonly reason: string;
+} | {
+    readonly type: "error";
+    readonly error: unknown;
+} | {
+    readonly type: "disposed";
+};
+export interface WatchMapPackageOptions extends FetchMapPackageOptions {
+    /** Runtime to update after a changed package is fetched. */
+    readonly runtime?: HonuaMapRuntime;
+    /** Previous package snapshot for diffing when no runtime is supplied. */
+    readonly initialPackage?: HonuaMapPackage;
+    /** Defaults to true when `runtime` is supplied. */
+    readonly applyUpdates?: boolean;
+    /** Polling cadence. Defaults to 30 seconds. */
+    readonly intervalMs?: number;
+    /** Delay changed-package application to coalesce rapid fetches. Defaults to 0. */
+    readonly debounceMs?: number;
+    /** Fetch immediately on watcher creation. Defaults to true. */
+    readonly immediate?: boolean;
+    /** Realtime channel configuration. Omit to use package-advertised channels; pass false to force polling. */
+    readonly realtime?: false | MapPackageRealtimeWatchOptions;
+    readonly onEvent?: (event: MapPackageWatchEvent) => void | Promise<void>;
+    readonly onUpdate?: (event: Extract<MapPackageWatchEvent, {
+        type: "updated";
+    }>) => void | Promise<void>;
+    readonly onError?: (error: unknown) => void | Promise<void>;
+}
+export interface MapPackageWatchHandle {
+    readonly disposed: boolean;
+    refresh(): Promise<void>;
+    dispose(): void;
+}
+export declare function watchMapPackage(locator: MapPackageLocator, options: WatchMapPackageOptions): MapPackageWatchHandle;
+//# sourceMappingURL=map-package-watch.d.ts.map

package/runtime/map-package-watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-package-watch.d.ts","sourceRoot":"","sources":["../../../src/runtime/map-package-watch.ts"],"names":[],"mappings":"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"}