@warpfx/client 0.3.0 → 0.3.2

package/dist/index.d.ts

@@ -1,14 +1,21 @@
 /**
- * @warpfx/client — Client-side SDK for Warp module development.
+ * @warpfx/client — Client-side SDK for Warp resource development.
  *
  * Clean, minimal API for building FiveM client features with Warp.
  * All calls delegate to the Warp core via FiveM resource exports.
  *
  * Usage:
  *   import { accounts } from './db'; // auto-generated reactive store
- *   import { action, call } from '@warpfx/client';
+ *   import { action, call, watch } from '@warpfx/client';
+ *
+ *   accounts.watch((newVal, oldVal) => {
+ *     if (newVal[0]?.balance < oldVal[0]?.balance) showNotification('Balance decreased!');
+ *   });
+ *
+ *   watch([accounts, inventory], ([acc, inv], [prevAcc, prevInv]) => {
+ *     console.log('Something changed');
+ *   });
  *
- *   accounts.watch((data) => console.log('Balance:', data[0].balance));
  *   action('deposit', { amount: 100 });
  *   const { balance } = await call('getBalance', { targetId: 'xyz' });
  */
@@ -75,6 +82,24 @@ declare function call<T = any>(name: string, payload?: any, timeout?: number): P
  * console.log(accounts.value);
  */
 declare function sync<T = any>(key: string, defaultValue?: T): SyncRef<T>;
+/**
+ * Watch multiple sync refs and react when any of them change.
+ * Batches changes from the same tick into a single callback.
+ * Returns an unsubscribe function.
+ *
+ * @example
+ * const accounts = sync<Account[]>('accounts');
+ * const inventory = sync<Item[]>('inventory');
+ *
+ * const unsub = watch([accounts, inventory], ([acc, inv], [prevAcc, prevInv]) => {
+ *   console.log('Something changed');
+ * });
+ */
+declare function watch<T extends readonly SyncRef[]>(refs: readonly [...T], handler: (newValues: {
+    [K in keyof T]: T[K] extends SyncRef<infer V> ? V : never;
+}, oldValues: {
+    [K in keyof T]: T[K] extends SyncRef<infer V> ? V : never;
+}) => void): () => void;
 /**
  * Register a global error handler for all action errors.
  * Returns an unsubscribe function.
@@ -120,4 +145,4 @@ declare function onNUI<T = any>(name: string, handler: (data: T) => any): void;
  */
 declare function registerKeybind(name: string, options: KeybindOptions): void;
 
-export { type ActionError, type ClientEventBus, type KeybindOptions, type ShowNUIOptions, type SyncRef, action, call, getEvents, hideNUI, isReady, onError, onNUI, onReady, registerKeybind, sendNUI, setNUIFocus, showNUI, sync };
+export { type ActionError, type ClientEventBus, type KeybindOptions, type ShowNUIOptions, type SyncRef, action, call, getEvents, hideNUI, isReady, onError, onNUI, onReady, registerKeybind, sendNUI, setNUIFocus, showNUI, sync, watch };

package/dist/index.js

@@ -32,7 +32,8 @@ __export(index_exports, {
   sendNUI: () => sendNUI,
   setNUIFocus: () => setNUIFocus,
   showNUI: () => showNUI,
-  sync: () => sync
+  sync: () => sync,
+  watch: () => watch
 });
 module.exports = __toCommonJS(index_exports);
 function warp() {
@@ -47,6 +48,24 @@ function call(name, payload, timeout) {
 function sync(key, defaultValue) {
   return warp().sync(key, defaultValue);
 }
+function watch(refs, handler) {
+  let scheduled = false;
+  let oldSnapshot = refs.map((r) => r.value);
+  const unsubs = refs.map(
+    (ref) => ref.watch(() => {
+      if (!scheduled) {
+        scheduled = true;
+        Promise.resolve().then(() => {
+          scheduled = false;
+          const newSnapshot = refs.map((r) => r.value);
+          handler(newSnapshot, oldSnapshot);
+          oldSnapshot = newSnapshot;
+        });
+      }
+    })
+  );
+  return () => unsubs.forEach((fn) => fn());
+}
 function onError(handler) {
   return warp().onError(handler);
 }
@@ -91,5 +110,6 @@ function registerKeybind(name, options) {
   sendNUI,
   setNUIFocus,
   showNUI,
-  sync
+  sync,
+  watch
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warpfx/client",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Warp Framework SDK for client-side FiveM module development",
   "keywords": [
     "client",