@sweidos/eidos 1.0.12 → 1.0.17

package/dist/index.d.ts

@@ -44,6 +44,16 @@ export declare type CacheStrategy = 'cache-first' | 'stale-while-revalidate' | '
 /** Remove all items from the action queue (IDB + in-memory store). */
 export declare function clearQueue(): Promise<void>;
 
+/**
+ * Live state for a single queue item by ID. Returns `undefined` once the item
+ * is removed from the queue (after a successful replay or `clearQueue()`).
+ * @example
+ *   // Svelte
+ *   const item = eidosAction(queuedResult.id)
+ *   $: status = $item?.status  // 'pending' | 'replaying' | 'succeeded' | 'failed' | undefined
+ */
+export declare function eidosAction(id: string): EidosReadable<ActionQueueItem | undefined>;
+
 declare interface EidosConfig {
     /** Path to the eidos service worker. Defaults to '/eidos-sw.js'. */
     swPath?: string;
@@ -66,6 +76,36 @@ declare interface EidosProviderProps extends EidosConfig {
     children: ReactNode;
 }
 
+/** The action queue. Re-notifies on every queue mutation. */
+export declare const eidosQueue: EidosReadable<ActionQueueItem[]>;
+
+/**
+ * Queue counts. Re-notifies on any queue mutation — compare values inside the
+ * subscriber callback to skip work when counts haven't changed.
+ */
+export declare const eidosQueueStats: EidosReadable<{
+    pending: number;
+    failed: number;
+    replaying: number;
+    total: number;
+}>;
+
+export declare interface EidosReadable<T> {
+    /** Subscribe to value changes. Returns an unsubscribe function. */
+    subscribe(run: (value: T) => void): () => void;
+    /** Read the current value synchronously without subscribing. */
+    getState(): T;
+}
+
+/**
+ * Live cache state for a single registered resource URL.
+ * @example
+ *   // Svelte
+ *   const entry = eidosResource('/api/products')
+ *   $: hits = $entry?.cacheHits ?? 0
+ */
+export declare function eidosResource(url: string): EidosReadable<ResourceEntry | undefined>;
+
 export declare interface EidosState {
     isOnline: boolean;
     swStatus: 'idle' | 'registering' | 'active' | 'error' | 'unsupported';
@@ -74,6 +114,17 @@ export declare interface EidosState {
     queue: ActionQueueItem[];
 }
 
+/**
+ * Online status + SW lifecycle.
+ * Object identity changes on every notification — destructure or compare fields
+ * in the subscriber if you need to avoid unnecessary work.
+ */
+export declare const eidosStatus: EidosReadable<{
+    isOnline: boolean;
+    swStatus: EidosStore['swStatus'];
+    swError: string | undefined;
+}>;
+
 export declare interface EidosStore extends EidosState {
     setOnline: (online: boolean) => void;
     setSwStatus: (status: EidosState['swStatus'], error?: string) => void;
@@ -86,6 +137,9 @@ export declare interface EidosStore extends EidosState {
     hydrateQueue: (items: ActionQueueItem[]) => void;
 }
 
+/** Full Eidos state snapshot. Prefer the narrower stores below. */
+export declare const eidosStore: EidosReadable<EidosStore>;
+
 export declare interface GeneratedStrategy {
     name: string;
     swStrategy: CacheStrategy;
@@ -102,6 +156,8 @@ declare function _getState(): EidosStore;
 
 export declare function initEidos(config?: EidosConfig): Promise<void>;
 
+export declare function isBgSyncSupported(): boolean;
+
 declare type Listener = () => void;
 
 export declare interface QueuedResult {
@@ -221,26 +277,12 @@ export declare function useEidosStatus(): {
     swError: string | undefined;
 };
 
-export declare const useEidosStore: typeof _useStore;
-
-declare function _useStore(): EidosStore;
-
-declare function _useStore<T>(selector: (state: EidosStore) => T): T;
-
-declare namespace _useStore {
-    var getState: typeof _getState;
-    var subscribe: typeof _subscribe;
-    var setState: (partial: Partial<EidosStore> | ((s: EidosStore) => Partial<EidosStore>)) => void;
-}
+export declare const useEidosStore: {
+    getState: typeof _getState;
+    subscribe: typeof _subscribe;
+    setState: (partial: Partial<EidosStore> | ((s: EidosStore) => Partial<EidosStore>)) => void;
+};
 
 export declare const VERSION = "1.0.12";
 
 export { }
-
-
-declare namespace _useStore {
-    var getState: typeof _getState;
-    var subscribe: typeof _subscribe;
-    var setState: (partial: Partial<EidosStore> | ((s: EidosStore) => Partial<EidosStore>)) => void;
-}
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sweidos/eidos",
-  "version": "1.0.12",
+  "version": "1.0.17",
   "description": "Describe intent. The runtime figures out how. An abstraction layer for offline-first web apps.",
   "author": "Aditya Raj",
   "license": "MIT",