@guidelytech/sdk-core 0.9.0 → 0.11.0

package/dist/{http-47tiAlOM.d.cts → http-D047Ngxk.d.ts}

@@ -1,35 +1,4 @@
-type StorageKind = "local" | "session" | "memory";
-/** Minimal synchronous key/value store; never throws (private mode, quota, SSR). */
-interface KeyValueStore {
-    get(key: string): string | null;
-    set(key: string, value: string): void;
-    remove(key: string): void;
-}
-declare function memoryStore(): KeyValueStore;
-/** Creates a store of the requested kind, degrading to memory when unavailable. */
-declare function createStorage(kind?: StorageKind): KeyValueStore;
-declare function readJson<T>(store: KeyValueStore, key: string, fallback: T): T;
-declare function writeJson(store: KeyValueStore, key: string, value: unknown): void;
-/** Storage keys used by the SDK (documented for integrators). */
-declare const KEYS: {
-    readonly anon: "guidely:anon";
-    readonly seen: "guidely:seen";
-    readonly config: (key: string) => string;
-    readonly etag: (key: string) => string;
-    readonly state: (key: string) => string;
-    readonly user: (key: string) => string;
-    readonly queue: (key: string) => string;
-    readonly session: "guidely:session";
-    readonly active: "guidely:active";
-    readonly authoring: "guidely:authoring";
-    /** How-to capture session marker ({ token, … }) and its not-yet-uploaded steps. */
-    readonly capture: "guidely:capture";
-    readonly capturePending: "guidely:capture:pending";
-    /** Messenger conversations this browser can read: [{ id, token }]. */
-    readonly conversations: (key: string) => string;
-    /** Announcement ids opened in the messenger's News tab. */
-    readonly newsSeen: (key: string) => string;
-};
+import { S as ServerHealth } from './health-sbP9JwTE.js';
 
 interface ApiResponse<T> {
     status: number;
@@ -43,7 +12,11 @@ declare class Api {
     private readonly baseUrl;
     private readonly key;
     private readonly fetchImpl?;
-    constructor(baseUrl: string, key: string, fetchImpl?: FetchLike | undefined);
+    /** Reachability of the API, fed by every answer (see {@link ServerHealth}). */
+    readonly health: ServerHealth;
+    constructor(baseUrl: string, key: string, fetchImpl?: FetchLike | undefined, health?: ServerHealth);
+    /** Feeds an answer (or a failed request, `null`) into {@link health}. */
+    private observe;
     url(path: string, params?: Record<string, string | undefined>): string;
     private get fetcher();
     request<T>(method: "GET" | "POST", path: string, options?: {
@@ -71,7 +44,9 @@ declare class Api {
     }): Promise<ApiResponse<T>>;
     /**
      * POST that may answer with server-sent events. Each event is passed to `onEvent`; a JSON answer is
-     * returned instead. No timeout: Scout replies can take a while and the server keeps the stream alive.
+     * returned instead. Scout replies can take a while, so there is no overall timeout: the response
+     * must start within 30 s and then never go quiet for more than 60 s (the server sends keepalives),
+     * otherwise the request is aborted and rejects.
      */
     stream<T>(path: string, body: unknown, onEvent: (event: string, data: unknown) => void, headers?: Record<string, string>): Promise<ApiResponse<T>>;
     /** `navigator.sendBeacon` when available (page unload); returns false when it could not be queued. */
@@ -83,4 +58,4 @@ declare function backoffMs(attempt: number, baseMs?: number, maxMs?: number): nu
 /** Fire-and-forget POST with bounded retries (used for state sync; never blocks UI). */
 declare function postWithRetry<T>(api: Api, path: string, body: unknown, attempts?: number, baseMs?: number): Promise<ApiResponse<T> | null>;
 
-export { Api as A, type FetchLike as F, KEYS as K, type StorageKind as S, type ApiResponse as a, type KeyValueStore as b, backoffMs as c, createStorage as d, memoryStore as m, postWithRetry as p, readJson as r, sleep as s, writeJson as w };
+export { Api as A, type FetchLike as F, type ApiResponse as a, backoffMs as b, postWithRetry as p, sleep as s };