@warpfx/server 0.3.2 → 0.3.3

package/dist/index.d.ts

@@ -268,6 +268,37 @@ declare function fn<T = any>(name: string, handler: (player: Player, payload: an
  * }, (player, args) => { ... });
  */
 declare function command(name: string, handlerOrOptions: CommandOptions | ((player: Player, args: string[], raw: string) => void), handler?: (player: Player, args: string[], raw: string) => void): void;
+/** Context passed to middleware handlers. */
+interface MiddlewareContext extends Player {
+    /** The action or function name being dispatched. */
+    actionName: string;
+    /** The payload sent by the client. */
+    payload: any;
+}
+/**
+ * Register middleware that intercepts actions and functions.
+ *
+ * Middleware runs in registration order, wrapping the handler (Koa-style).
+ * Use glob patterns to match action/function names.
+ *
+ * @example
+ * // Module-scoped — applies to all economy actions
+ * middleware('economy:*', async (ctx, next) => {
+ *   const entity = getEntity(ctx.citizenId);
+ *   if (entity?.getComponent('frozen')) {
+ *     throw error('FROZEN', 'Account is frozen');
+ *   }
+ *   await next();
+ * });
+ *
+ * // Global — applies to everything
+ * middleware('*', async (ctx, next) => {
+ *   const start = Date.now();
+ *   await next();
+ *   console.log(`[${ctx.actionName}] ${Date.now() - start}ms`);
+ * });
+ */
+declare function middleware(pattern: string, handler: (ctx: MiddlewareContext, next: () => Promise<void>) => Promise<void> | void): void;
 /**
  * Create an error to throw from action/function handlers.
  * The error is sent back to the client with a structured code and message.
@@ -337,4 +368,4 @@ declare function getBridge(): any;
 /** Subscribe to database tables. */
 declare function subscribe(queries: string[]): Promise<void>;
 
-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 };
+export { type AccessMode, type ActionDef, type ActionError, type ColumnDef, type ColumnType, type CommandOptions, type CommandParam, type EntityStore, type FunctionDef, type MiddlewareContext, 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, middleware, onPlayerConnect, onPlayerDisconnect, onPlayerSpawned, onReady, onTableChange, provide, spawnPlayer, subscribe, table, use };

package/dist/index.js

@@ -31,6 +31,7 @@ __export(index_exports, {
   getPlayer: () => getPlayer,
   getPlayers: () => getPlayers,
   isReady: () => isReady,
+  middleware: () => middleware,
   onPlayerConnect: () => onPlayerConnect,
   onPlayerDisconnect: () => onPlayerDisconnect,
   onPlayerSpawned: () => onPlayerSpawned,
@@ -59,6 +60,9 @@ function command(name, handlerOrOptions, handler) {
     warp().command(name, handlerOrOptions, handler);
   }
 }
+function middleware(pattern, handler) {
+  warp().middleware(pattern, handler);
+}
 function error(code, message) {
   return warp().error(code, message);
 }
@@ -126,6 +130,7 @@ function subscribe(queries) {
   getPlayer,
   getPlayers,
   isReady,
+  middleware,
   onPlayerConnect,
   onPlayerDisconnect,
   onPlayerSpawned,

package/package.json

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