@applicaster/zapp-react-native-utils 15.0.0-rc.136 → 15.0.0-rc.137

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@applicaster/zapp-react-native-utils",
-  "version": "15.0.0-rc.136",
+  "version": "15.0.0-rc.137",
   "description": "Applicaster Zapp React Native utilities package",
   "main": "index.js",
   "types": "index.d.ts",
@@ -27,7 +27,7 @@
   },
   "homepage": "https://github.com/applicaster/quickbrick#readme",
   "dependencies": {
-    "@applicaster/applicaster-types": "15.0.0-rc.136",
+    "@applicaster/applicaster-types": "15.0.0-rc.137",
     "buffer": "^5.2.1",
     "camelize": "^1.0.0",
     "dayjs": "^1.11.10",

package/refreshUtils/RefreshCoordinator/__tests__/refreshCoordinator.test.ts

@@ -130,6 +130,51 @@ describe("RefreshCoordinator", () => {
     sub2.unsubscribe();
   });
 
+  // ----------------------------------------
+  // triggerRefresh
+  // ----------------------------------------
+  it("triggerRefresh emits refresh events for each component", () => {
+    const component1 = { id: "c1" } as ZappUIComponent;
+    const component2 = { id: "c2" } as ZappUIComponent;
+    const listener = jest.fn();
+
+    // Subscribe to all events
+    (refreshCoordinator as any).refresh$.subscribe(listener);
+
+    refreshCoordinator.triggerRefresh([component1, component2], screenId);
+
+    expect(listener).toHaveBeenCalledTimes(2);
+
+    expect(listener).toHaveBeenCalledWith({
+      component: component1,
+      screenId,
+    });
+
+    expect(listener).toHaveBeenCalledWith({
+      component: component2,
+      screenId,
+    });
+  });
+
+  it("triggerRefresh with empty components does nothing", () => {
+    const listener = jest.fn();
+
+    (refreshCoordinator as any).refresh$.subscribe(listener);
+
+    refreshCoordinator.triggerRefresh([], screenId);
+
+    expect(listener).not.toHaveBeenCalled();
+  });
+
+  it("triggerRefresh events are picked up by subscribeTo", () => {
+    const listener = jest.fn();
+
+    refreshCoordinator.subscribeTo(component, screenId, listener);
+    refreshCoordinator.triggerRefresh([component], screenId);
+
+    expect(listener).toHaveBeenCalledTimes(1);
+  });
+
   // ----------------------------------------
   // clear
   // ----------------------------------------

package/refreshUtils/RefreshCoordinator/index.ts

@@ -16,12 +16,26 @@ type ComponentToRefresh = {
 /**
  * Public contract for refresh coordination.
  *
- * register() → starts refresh timer for a component with screen context
- * subscribeTo() → listen to refresh events for a specific component and screen
- * subscribeToAny() → listen to all refresh events with throttling
+ * The coordinator serves as an event bus for component refresh events.
+ * It supports two types of producers and any number of consumers:
+ *
+ * Producers (push events into refresh$):
+ *   register()        → starts a periodic timer that emits refresh events
+ *   triggerRefresh()   → imperatively emits refresh events (e.g. pull-to-refresh)
+ *
+ * Consumers (react to refresh events):
+ *   subscribeTo()     → listen to refresh events for a specific component/screen
+ *   subscribeToAny()  → listen to all refresh events with throttling
+ *
+ * Note: subscribeTo() works independently of register(). A component can
+ * subscribe to refresh events without having auto-refresh enabled.
+ * This is how pull-to-refresh works — triggerRefresh() pushes events that
+ * are picked up by existing subscribeTo() listeners in UrlFeedResolver,
+ * even for components that don't have periodic auto-refresh timers.
  */
 interface IRefreshCoordinator {
   register(component: ZappUIComponent, screenId: string): () => void;
+  triggerRefresh(components: ZappUIComponent[], screenId: string): void;
   subscribeTo(
     component: ZappUIComponent,
     screenId: string,
@@ -37,8 +51,10 @@ interface IRefreshCoordinator {
  *
  * Design goals:
  * - One shared coordinator across the app
- * - Multiple components can register refresh timers with screen context
- * - Multiple listeners can subscribe to refresh events
+ * - Central refresh$ event bus for all refresh events
+ * - Multiple producers: periodic timers (register) and imperative triggers (triggerRefresh)
+ * - Multiple consumers: per-component (subscribeTo) and global (subscribeToAny)
+ * - Producers and consumers are independent — subscribeTo works without register
  * - Safe cleanup of timers and subscriptions
  */
 class RefreshCoordinator implements IRefreshCoordinator {
@@ -114,6 +130,19 @@ class RefreshCoordinator implements IRefreshCoordinator {
     return (): void => this.unregister(componentId, screenId);
   }
 
+  /**
+   * Imperatively triggers refresh for the given components on a screen.
+   *
+   * Pushes each component into the central refresh$ stream so that
+   * existing subscribers (e.g. UrlFeedResolver's reloadData) react
+   * to the event. Used by pull-to-refresh and programmatic refresh.
+   */
+  public triggerRefresh(components: ZappUIComponent[], screenId: string): void {
+    components.forEach((component) => {
+      this.refresh$.next({ component, screenId });
+    });
+  }
+
   /**
    * Stops and removes timer for a specific component.
    * Cleans up the RxJS subscription for that component's interval stream.