@warpfx/server 0.3.0 → 0.3.2

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /**
- * Schema types for Warp module developers.
+ * Schema types for Warp resource developers.
  *
- * Modules define their database tables in a `warp.schema.json` file
+ * Resources define their database tables in a `warp.schema.json` file
  * placed at the root of their FiveM resource. These types document
  * the expected format.
  *
@@ -81,12 +81,35 @@ interface TableDef {
      */
     access?: AccessMode;
 }
+/** Parameter/field definition for actions and functions. */
+interface ParamDef {
+    /** The data type of this parameter. */
+    type: ColumnType;
+    /** If true, this parameter is optional in the payload. */
+    optional?: boolean;
+}
+/** Action definition — declares the payload shape for a client-to-server action. */
+interface ActionDef {
+    /** Parameters the action accepts from the client. */
+    params: Record<string, ParamDef>;
+}
+/** Function definition — declares request params and return shape for a client-to-server function. */
+interface FunctionDef {
+    /** Parameters the function accepts from the client. */
+    params: Record<string, ParamDef>;
+    /** Fields the function returns to the client. */
+    returns: Record<string, ParamDef>;
+}
 /** The full warp.schema.json format. */
 interface WarpSchema {
-    /** Unique module name (used as table prefix in the database). */
+    /** Unique resource name (used as table prefix in the database). */
     module: string;
     /** Table definitions keyed by table name. */
     tables: Record<string, TableDef>;
+    /** Action definitions keyed by action name. */
+    actions?: Record<string, ActionDef>;
+    /** Function definitions keyed by function name. */
+    functions?: Record<string, FunctionDef>;
     /** Schema version number (increment when making breaking changes). */
     version?: number;
     /** Acknowledged breaking changes (required in production for destructive schema changes). */
@@ -94,7 +117,7 @@ interface WarpSchema {
 }
 
 /**
- * @warpfx/server — Server-side SDK for Warp module development.
+ * @warpfx/server — Server-side SDK for Warp resource development.
  *
  * Clean, minimal API for building FiveM server features with Warp.
  * All calls delegate to the Warp core via FiveM resource exports.
@@ -195,6 +218,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 +288,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 resource, 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.
@@ -263,9 +310,9 @@ declare function table<T = any>(name: string): Table<T>;
 declare function onReady(cb: () => void): void;
 /** Check if Warp has finished booting. */
 declare function isReady(): boolean;
-/** Register a service that other modules can resolve via use(). */
+/** Register a service that other resources can resolve via use(). */
 declare function provide<T>(token: string, service: T): void;
-/** Resolve a service registered by another module. */
+/** Resolve a service registered by another resource. */
 declare function use<T = unknown>(token: string): T;
 /** Get the shared event bus instance. */
 declare function getEvents<TMap extends Record<string, any> = Record<string, any>>(): ServerEventBus<TMap>;
@@ -290,4 +337,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 ActionDef, type ActionError, type ColumnDef, type ColumnType, type CommandOptions, type CommandParam, type EntityStore, type FunctionDef, type ParamDef, 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.2",
   "description": "Warp Framework SDK for server-side FiveM module development",
   "keywords": [
     "fivem",