@warpfx/server 0.3.0 → 0.3.1

package/dist/index.d.ts

@@ -195,6 +195,15 @@ interface ActionError {
     code: string;
     message: string;
 }
+/** Describes a single table row change. */
+interface TableChange<T = any> {
+    /** The type of change. */
+    type: "insert" | "update" | "delete";
+    /** The current row (new on insert/update, deleted row on delete). */
+    row: T;
+    /** The previous row (on update only, undefined otherwise). */
+    oldRow?: T;
+}
 /**
  * Register an action handler that clients can invoke.
  *
@@ -256,6 +265,21 @@ declare function error(code: string, message?: string): Error;
  * await accounts.update(citizenId, { balance: 500 });
  */
 declare function table<T = any>(name: string): Table<T>;
+/**
+ * React to any change in a database table.
+ *
+ * Fires on insert, update, or delete — regardless of what caused the change
+ * (action, another module, migration, Studio edit). Works on all tables
+ * including server-only tables without an `access` field.
+ *
+ * @example
+ * onTableChange<Account>('economy_accounts', (change) => {
+ *   if (change.type === 'update' && change.row.balance < 0) {
+ *     accounts.update(change.row.citizenId, { frozen: true });
+ *   }
+ * });
+ */
+declare function onTableChange<T = any>(table: string, handler: (change: TableChange<T>) => void): void;
 /**
  * Register a callback to run when Warp is fully booted.
  * If Warp is already ready, the callback fires immediately.
@@ -290,4 +314,4 @@ declare function getBridge(): any;
 /** Subscribe to database tables. */
 declare function subscribe(queries: string[]): Promise<void>;
 
-export { type AccessMode, type ActionError, type ColumnDef, type ColumnType, type CommandOptions, type CommandParam, type EntityStore, type Player, type PlayerEntity, type PlayerRow, type PlayerState, type ServerEventBus, type Table, type TableDef, type WarpSchema, action, command, error, fn, getBridge, getEntities, getEntity, getEvents, getPlayer, getPlayers, isReady, onPlayerConnect, onPlayerDisconnect, onPlayerSpawned, onReady, provide, spawnPlayer, subscribe, table, use };
+export { type AccessMode, type ActionError, type ColumnDef, type ColumnType, type CommandOptions, type CommandParam, type EntityStore, type Player, type PlayerEntity, type PlayerRow, type PlayerState, type ServerEventBus, type Table, type TableChange, type TableDef, type WarpSchema, action, command, error, fn, getBridge, getEntities, getEntity, getEvents, getPlayer, getPlayers, isReady, onPlayerConnect, onPlayerDisconnect, onPlayerSpawned, onReady, onTableChange, provide, spawnPlayer, subscribe, table, use };

package/dist/index.js

@@ -35,6 +35,7 @@ __export(index_exports, {
   onPlayerDisconnect: () => onPlayerDisconnect,
   onPlayerSpawned: () => onPlayerSpawned,
   onReady: () => onReady,
+  onTableChange: () => onTableChange,
   provide: () => provide,
   spawnPlayer: () => spawnPlayer,
   subscribe: () => subscribe,
@@ -64,6 +65,9 @@ function error(code, message) {
 function table(name) {
   return warp().table(name);
 }
+function onTableChange(table2, handler) {
+  warp().onTableChange(table2, handler);
+}
 function onReady(cb) {
   warp().onReady(cb);
 }
@@ -126,6 +130,7 @@ function subscribe(queries) {
   onPlayerDisconnect,
   onPlayerSpawned,
   onReady,
+  onTableChange,
   provide,
   spawnPlayer,
   subscribe,

package/package.json

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