@vicerp/rpc 1.0.0

package/README.md

@@ -0,0 +1,412 @@
+# @vicerp/rpc
+
+Platform-agnostic bidirectional RPC library for game frameworks. Provides procedure calls, events, and relay capabilities across the full **Browser <-> Client <-> Server** chain.
+
+## Architecture
+
+```
+Browser ──RPC──> Client ──RPC──> Server ──gRPC──> Engine
+Browser <──RPC── Client <──RPC── Server <──gRPC── Engine
+```
+
+The client acts as a pure passthrough relay. All RPC messages from the browser are forwarded to the server and vice versa. The server is where business logic lives.
+
+## Installation
+
+```bash
+npm install @vicerp/rpc
+```
+
+## Core API
+
+### `Rpc`
+
+The main class for registering procedures, making calls, and sending events.
+
+```typescript
+import { Rpc } from '@vicerp/rpc';
+
+const rpc = new Rpc(transport);
+
+// Register a procedure
+rpc.register('inventory:split', async (args) => {
+  const { slot } = args as { slot: number };
+  // ... business logic
+  return { success: true };
+});
+
+// Call a remote procedure
+const result = await rpc.call<{ success: boolean }>('inventory:split', { slot: 4 });
+
+// Fire-and-forget event
+rpc.trigger('inventory:update', { items: [...] });
+
+// Listen for events
+rpc.on('inventory:update', (args) => {
+  console.log('Inventory updated:', args);
+});
+
+// Unsubscribe
+rpc.off('inventory:update', handler);
+
+// Cleanup
+rpc.destroy();
+```
+
+#### Options
+
+```typescript
+// Call with custom timeout (default: 10s)
+const result = await rpc.call('procedure', args, { timeout: 5000 });
+```
+
+### `RpcRelay`
+
+Bidirectionally forwards all messages between two transports. Zero knowledge of message content — just pipes through.
+
+```typescript
+import { RpcRelay } from '@vicerp/rpc';
+
+const relay = new RpcRelay(transportA, transportB);
+
+// Messages from A are forwarded to B, and vice versa
+// Cleanup
+relay.destroy();
+```
+
+### `RpcTransport` (interface)
+
+All transports implement this interface:
+
+```typescript
+interface RpcTransport {
+  send(message: RpcMessage): void;
+  onMessage(handler: (message: RpcMessage) => void): void;
+  destroy(): void;
+}
+```
+
+### Message Types
+
+```typescript
+// Procedure call
+interface RpcRequest {
+  type: 'request';
+  id: string;
+  procedure: string;
+  args?: unknown;
+}
+
+// Procedure response
+interface RpcResponse {
+  type: 'response';
+  id: string;
+  result?: unknown;
+  error?: string;
+}
+
+// Fire-and-forget event
+interface RpcEvent {
+  type: 'event';
+  name: string;
+  args?: unknown;
+}
+```
+
+## Adapters
+
+### RAGE:MP
+
+#### Browser (CEF) Transport
+
+```typescript
+import { RageBrowserTransport } from '@vicerp/rpc/rage/browser';
+
+// In CEF browser code
+const transport = new RageBrowserTransport(mp);
+const rpc = new Rpc(transport);
+```
+
+#### Client Transport (Client <-> Browser)
+
+```typescript
+import { RageClientTransport } from '@vicerp/rpc/rage/client';
+
+// In client script
+const transport = new RageClientTransport(browser, mp);
+const rpc = new Rpc(transport);
+```
+
+#### Client-Server Transport (Client <-> Server)
+
+```typescript
+import { RageClientServerTransport } from '@vicerp/rpc/rage/client-server';
+
+// In client script — sends via mp.events.callRemote(), receives via mp.events
+const transport = new RageClientServerTransport(mp);
+```
+
+#### Server Transport (Server <-> Client)
+
+```typescript
+import { RageServerTransportHub, RageServerTransport } from '@vicerp/rpc/rage/server';
+
+// Create ONE hub per server (registers global event listener)
+const hub = new RageServerTransportHub(mp);
+
+// Create per-player transports
+const transport = hub.createTransport(player);
+const rpc = new Rpc(transport);
+
+// Cleanup when player disconnects
+hub.removeTransport(player);
+
+// Shutdown
+hub.destroy();
+```
+
+#### Client as Relay (recommended pattern)
+
+The client doesn't need its own `Rpc` instance — it just relays between browser and server:
+
+```typescript
+import { RpcRelay } from '@vicerp/rpc';
+import { RageClientTransport } from '@vicerp/rpc/rage/client';
+import { RageClientServerTransport } from '@vicerp/rpc/rage/client-server';
+
+const browserTransport = new RageClientTransport(browser, mp);
+const serverTransport = new RageClientServerTransport(mp);
+const relay = new RpcRelay(browserTransport, serverTransport);
+```
+
+### FiveM
+
+#### NUI Transport (Browser side)
+
+```typescript
+import { FiveMNuiTransport } from '@vicerp/rpc/fivem/nui';
+
+const transport = new FiveMNuiTransport(window);
+const rpc = new Rpc(transport);
+```
+
+#### Client Transport (Client <-> NUI)
+
+```typescript
+import { FiveMClientTransport } from '@vicerp/rpc/fivem/client';
+
+const transport = new FiveMClientTransport(fivem);
+const rpc = new Rpc(transport);
+```
+
+#### Client-Server Transport (Client <-> Server)
+
+```typescript
+import { FiveMClientServerTransport } from '@vicerp/rpc/fivem/client-server';
+
+// Sends via TriggerServerEvent(), receives via on()
+const transport = new FiveMClientServerTransport(fivem);
+```
+
+#### Server Transport (Server <-> Client)
+
+```typescript
+import { FiveMServerTransportHub } from '@vicerp/rpc/fivem/server';
+
+// Create ONE hub per server (registers global onNet listener)
+const hub = new FiveMServerTransportHub(fivem);
+
+// Create per-player transports (uses source for player ID)
+const transport = hub.createTransport(playerId);
+const rpc = new Rpc(transport);
+
+// Cleanup
+hub.removeTransport(playerId);
+hub.destroy();
+```
+
+## React Integration
+
+```typescript
+import { RpcProvider, useRpc, useRpcCall, useRpcEvent, useRpcRegister } from '@vicerp/rpc/react';
+```
+
+### `RpcProvider`
+
+Wraps your app and provides an `Rpc` instance via context.
+
+```tsx
+<RpcProvider transport={transport}>
+  <App />
+</RpcProvider>
+```
+
+### `useRpc()`
+
+Access the `Rpc` instance directly.
+
+```typescript
+const rpc = useRpc();
+```
+
+### `useRpcCall<T>(procedure, options?)`
+
+Make RPC calls with loading/error state management.
+
+```typescript
+const { data, loading, error, call } = useRpcCall<Item[]>('inventory:getItems');
+
+// Trigger the call
+await call();
+
+// Or with args
+await call({ playerId: '123' });
+```
+
+### `useRpcEvent(name, handler)`
+
+Subscribe to events (auto-cleanup on unmount).
+
+```typescript
+useRpcEvent('inventory:update', (items) => {
+  setInventory(items);
+});
+```
+
+### `useRpcRegister(name, handler)`
+
+Register a procedure handler (auto-cleanup on unmount).
+
+```typescript
+useRpcRegister('ui:getState', () => {
+  return { theme: 'dark', locale: 'en' };
+});
+```
+
+## Full Chain Example
+
+Player clicks "split" button in inventory UI:
+
+```
+1. Browser:  rpc.call('inventory:split', { slot: 4 })
+2. Client:   RpcRelay forwards to server
+3. Server:   Rpc handler receives, sends gRPC to engine
+4. Engine:   Processes split, responds via gRPC
+5. Server:   rpc.trigger('inventory:update', { ... })
+6. Client:   RpcRelay forwards to browser
+7. Browser:  useRpcEvent('inventory:update', ...) fires
+```
+
+### Browser (React)
+
+```tsx
+import { RpcProvider, useRpcCall, useRpcEvent } from '@vicerp/rpc/react';
+import { RageBrowserTransport } from '@vicerp/rpc/rage/browser';
+
+const transport = new RageBrowserTransport(mp);
+
+function Inventory() {
+  const [items, setItems] = useState([]);
+  const { call: splitItem } = useRpcCall('inventory:split');
+
+  useRpcEvent('inventory:update', (data) => setItems(data.items));
+
+  return (
+    <button onClick={() => splitItem({ slot: 4 })}>Split</button>
+  );
+}
+
+function App() {
+  return (
+    <RpcProvider transport={transport}>
+      <Inventory />
+    </RpcProvider>
+  );
+}
+```
+
+### Client (RAGE:MP)
+
+```typescript
+import { RpcRelay } from '@vicerp/rpc';
+import { RageClientTransport } from '@vicerp/rpc/rage/client';
+import { RageClientServerTransport } from '@vicerp/rpc/rage/client-server';
+
+const browser = mp.browsers.new('http://localhost:3005');
+const browserTransport = new RageClientTransport(browser, mp);
+const serverTransport = new RageClientServerTransport(mp);
+const relay = new RpcRelay(browserTransport, serverTransport);
+```
+
+### Server (RAGE:MP)
+
+```typescript
+import { Rpc } from '@vicerp/rpc';
+import { RageServerTransportHub } from '@vicerp/rpc/rage/server';
+
+const hub = new RageServerTransportHub(mp);
+
+mp.events.add('playerReady', (player) => {
+  const transport = hub.createTransport(player);
+  const rpc = new Rpc(transport);
+
+  rpc.register('inventory:split', async (args) => {
+    const { slot } = args as { slot: number };
+    // Call engine via gRPC...
+    const result = await engineConnection.splitItem(playerId, slot);
+    // Push update back to browser
+    rpc.trigger('inventory:update', { items: result.items });
+    return { success: true };
+  });
+});
+```
+
+## Subpath Exports
+
+| Import path | Description |
+|---|---|
+| `@vicerp/rpc` | Core: `Rpc`, `RpcRelay`, types, errors |
+| `@vicerp/rpc/rage/browser` | RAGE:MP CEF browser transport |
+| `@vicerp/rpc/rage/client` | RAGE:MP client transport (client <-> browser) |
+| `@vicerp/rpc/rage/client-server` | RAGE:MP client transport (client <-> server) |
+| `@vicerp/rpc/rage/server` | RAGE:MP server transport hub + per-player transport |
+| `@vicerp/rpc/fivem/nui` | FiveM NUI browser transport |
+| `@vicerp/rpc/fivem/client` | FiveM client transport (client <-> NUI) |
+| `@vicerp/rpc/fivem/client-server` | FiveM client transport (client <-> server) |
+| `@vicerp/rpc/fivem/server` | FiveM server transport hub + per-player transport |
+| `@vicerp/rpc/react` | React hooks and provider |
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+
+# Run tests with coverage
+npm run test:cov
+
+# Build (CJS + ESM)
+npm run build
+
+# Clean build output
+npm run clean
+```
+
+## Publishing
+
+```bash
+# From libs/vice/rpc directory:
+npm publish --access public
+```
+
+The `prepublishOnly` script automatically runs `clean`, `build`, and `test` before publishing.
+
+## License
+
+MIT

package/dist/cjs/adapters/fivem/client-server.d.ts

@@ -0,0 +1,3 @@
+export { FiveMClientServerTransport } from './fivem-client-server.transport';
+export type * from './fivem.types';
+//# sourceMappingURL=client-server.d.ts.map

package/dist/cjs/adapters/fivem/client-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-server.d.ts","sourceRoot":"","sources":["../../../../src/adapters/fivem/client-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,mBAAmB,eAAe,CAAC"}

package/dist/cjs/adapters/fivem/client-server.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FiveMClientServerTransport = void 0;
+var fivem_client_server_transport_1 = require("./fivem-client-server.transport");
+Object.defineProperty(exports, "FiveMClientServerTransport", { enumerable: true, get: function () { return fivem_client_server_transport_1.FiveMClientServerTransport; } });
+//# sourceMappingURL=client-server.js.map

package/dist/cjs/adapters/fivem/client-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-server.js","sourceRoot":"","sources":["../../../../src/adapters/fivem/client-server.ts"],"names":[],"mappings":";;;AAAA,iFAA6E;AAApE,2IAAA,0BAA0B,OAAA"}

package/dist/cjs/adapters/fivem/client.d.ts

@@ -0,0 +1,3 @@
+export { FiveMClientTransport } from './fivem-client.transport';
+export type * from './fivem.types';
+//# sourceMappingURL=client.d.ts.map

package/dist/cjs/adapters/fivem/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/adapters/fivem/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,mBAAmB,eAAe,CAAC"}

package/dist/cjs/adapters/fivem/client.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FiveMClientTransport = void 0;
+var fivem_client_transport_1 = require("./fivem-client.transport");
+Object.defineProperty(exports, "FiveMClientTransport", { enumerable: true, get: function () { return fivem_client_transport_1.FiveMClientTransport; } });
+//# sourceMappingURL=client.js.map

package/dist/cjs/adapters/fivem/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/adapters/fivem/client.ts"],"names":[],"mappings":";;;AAAA,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA"}

package/dist/cjs/adapters/fivem/fivem-client-server.transport.d.ts

@@ -0,0 +1,17 @@
+import { RpcTransport, RpcMessage } from '../../core/types';
+import { FiveMClientGlobal } from './fivem.types';
+/**
+ * FiveM client script transport for client <-> server communication.
+ *
+ * Sends messages to the server via TriggerServerEvent().
+ * Receives messages from the server via on().
+ */
+export declare class FiveMClientServerTransport implements RpcTransport {
+    private readonly fivem;
+    private handler;
+    constructor(fivem: FiveMClientGlobal);
+    send(message: RpcMessage): void;
+    onMessage(handler: (message: RpcMessage) => void): void;
+    destroy(): void;
+}
+//# sourceMappingURL=fivem-client-server.transport.d.ts.map

package/dist/cjs/adapters/fivem/fivem-client-server.transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fivem-client-server.transport.d.ts","sourceRoot":"","sources":["../../../../src/adapters/fivem/fivem-client-server.transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAKlD;;;;;GAKG;AACH,qBAAa,0BAA2B,YAAW,YAAY;IAGjD,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,OAAO,CAAgD;gBAElC,KAAK,EAAE,iBAAiB;IAarD,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAK/B,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAIvD,OAAO,IAAI,IAAI;CAGhB"}

package/dist/cjs/adapters/fivem/fivem-client-server.transport.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FiveMClientServerTransport = void 0;
+const C2S_EVENT = '__vicerpc:c2s';
+const S2C_EVENT = '__vicerpc:s2c';
+/**
+ * FiveM client script transport for client <-> server communication.
+ *
+ * Sends messages to the server via TriggerServerEvent().
+ * Receives messages from the server via on().
+ */
+class FiveMClientServerTransport {
+    fivem;
+    handler = null;
+    constructor(fivem) {
+        this.fivem = fivem;
+        this.fivem.on(S2C_EVENT, (_json) => {
+            if (!this.handler)
+                return;
+            try {
+                const json = typeof _json === 'string' ? _json : String(_json);
+                const message = JSON.parse(json);
+                this.handler(message);
+            }
+            catch {
+                // Ignore malformed messages
+            }
+        });
+    }
+    send(message) {
+        const json = JSON.stringify(message);
+        this.fivem.TriggerServerEvent(C2S_EVENT, json);
+    }
+    onMessage(handler) {
+        this.handler = handler;
+    }
+    destroy() {
+        this.handler = null;
+    }
+}
+exports.FiveMClientServerTransport = FiveMClientServerTransport;
+//# sourceMappingURL=fivem-client-server.transport.js.map

package/dist/cjs/adapters/fivem/fivem-client-server.transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fivem-client-server.transport.js","sourceRoot":"","sources":["../../../../src/adapters/fivem/fivem-client-server.transport.ts"],"names":[],"mappings":";;;AAGA,MAAM,SAAS,GAAG,eAAe,CAAC;AAClC,MAAM,SAAS,GAAG,eAAe,CAAC;AAElC;;;;;GAKG;AACH,MAAa,0BAA0B;IAGR;IAFrB,OAAO,GAA2C,IAAI,CAAC;IAE/D,YAA6B,KAAwB;QAAxB,UAAK,GAAL,KAAK,CAAmB;QACnD,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,KAAc,EAAE,EAAE;YAC1C,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO;YAC1B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAe,CAAC;gBAC/C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,4BAA4B;YAC9B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,OAAmB;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,SAAS,CAAC,OAAsC;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,OAAO;QACL,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;CACF;AA5BD,gEA4BC"}

package/dist/cjs/adapters/fivem/fivem-client.transport.d.ts

@@ -0,0 +1,17 @@
+import { RpcTransport, RpcMessage } from '../../core/types';
+import { FiveMClientGlobal } from './fivem.types';
+/**
+ * FiveM client script side transport.
+ *
+ * Sends messages to the NUI browser via SendNUIMessage.
+ * Receives messages from the NUI browser via RegisterNUICallback.
+ */
+export declare class FiveMClientTransport implements RpcTransport {
+    private readonly fivem;
+    private handler;
+    constructor(fivem: FiveMClientGlobal);
+    send(message: RpcMessage): void;
+    onMessage(handler: (message: RpcMessage) => void): void;
+    destroy(): void;
+}
+//# sourceMappingURL=fivem-client.transport.d.ts.map

package/dist/cjs/adapters/fivem/fivem-client.transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fivem-client.transport.d.ts","sourceRoot":"","sources":["../../../../src/adapters/fivem/fivem-client.transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAKlD;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IAG3C,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,OAAO,CAAgD;gBAElC,KAAK,EAAE,iBAAiB;IAcrD,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAO/B,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAIvD,OAAO,IAAI,IAAI;CAGhB"}

package/dist/cjs/adapters/fivem/fivem-client.transport.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FiveMClientTransport = void 0;
+const RPC_ENDPOINT = '__vicerpc';
+const RPC_MARKER = '__vicerpc';
+/**
+ * FiveM client script side transport.
+ *
+ * Sends messages to the NUI browser via SendNUIMessage.
+ * Receives messages from the NUI browser via RegisterNUICallback.
+ */
+class FiveMClientTransport {
+    fivem;
+    handler = null;
+    constructor(fivem) {
+        this.fivem = fivem;
+        this.fivem.RegisterNUICallback(RPC_ENDPOINT, (data, cb) => {
+            if (this.handler) {
+                try {
+                    const message = data;
+                    this.handler(message);
+                }
+                catch {
+                    // Ignore malformed messages
+                }
+            }
+            cb({ ok: true });
+        });
+    }
+    send(message) {
+        this.fivem.SendNUIMessage({
+            [RPC_MARKER]: true,
+            payload: message,
+        });
+    }
+    onMessage(handler) {
+        this.handler = handler;
+    }
+    destroy() {
+        this.handler = null;
+    }
+}
+exports.FiveMClientTransport = FiveMClientTransport;
+//# sourceMappingURL=fivem-client.transport.js.map

package/dist/cjs/adapters/fivem/fivem-client.transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fivem-client.transport.js","sourceRoot":"","sources":["../../../../src/adapters/fivem/fivem-client.transport.ts"],"names":[],"mappings":";;;AAGA,MAAM,YAAY,GAAG,WAAW,CAAC;AACjC,MAAM,UAAU,GAAG,WAAW,CAAC;AAE/B;;;;;GAKG;AACH,MAAa,oBAAoB;IAGF;IAFrB,OAAO,GAA2C,IAAI,CAAC;IAE/D,YAA6B,KAAwB;QAAxB,UAAK,GAAL,KAAK,CAAmB;QACnD,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,YAAY,EAAE,CAAC,IAAa,EAAE,EAA6B,EAAE,EAAE;YAC5F,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,IAAkB,CAAC;oBACnC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC;oBACP,4BAA4B;gBAC9B,CAAC;YACH,CAAC;YACD,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,OAAmB;QACtB,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC;YACxB,CAAC,UAAU,CAAC,EAAE,IAAI;YAClB,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,OAAsC;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,OAAO;QACL,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;CACF;AA/BD,oDA+BC"}

package/dist/cjs/adapters/fivem/fivem-nui.transport.d.ts

@@ -0,0 +1,17 @@
+import { RpcTransport, RpcMessage } from '../../core/types';
+/**
+ * FiveM NUI (browser) side transport.
+ *
+ * Sends messages to the client script via fetch POST to the resource endpoint.
+ * Receives messages from the client script via window message events.
+ */
+export declare class FiveMNuiTransport implements RpcTransport {
+    private handler;
+    private messageListener;
+    private resourceName;
+    constructor();
+    send(message: RpcMessage): void;
+    onMessage(handler: (message: RpcMessage) => void): void;
+    destroy(): void;
+}
+//# sourceMappingURL=fivem-nui.transport.d.ts.map

package/dist/cjs/adapters/fivem/fivem-nui.transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fivem-nui.transport.d.ts","sourceRoot":"","sources":["../../../../src/adapters/fivem/fivem-nui.transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAK5D;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,OAAO,CAAgD;IAC/D,OAAO,CAAC,eAAe,CAAgD;IACvE,OAAO,CAAC,YAAY,CAAS;;IAqB7B,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAU/B,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAIvD,OAAO,IAAI,IAAI;CAOhB"}

package/dist/cjs/adapters/fivem/fivem-nui.transport.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FiveMNuiTransport = void 0;
+const RPC_ENDPOINT = '__vicerpc';
+const RPC_MARKER = '__vicerpc';
+/**
+ * FiveM NUI (browser) side transport.
+ *
+ * Sends messages to the client script via fetch POST to the resource endpoint.
+ * Receives messages from the client script via window message events.
+ */
+class FiveMNuiTransport {
+    handler = null;
+    messageListener = null;
+    resourceName;
+    constructor() {
+        const win = window;
+        this.resourceName = win.GetParentResourceName?.() ?? 'vice';
+        this.messageListener = (event) => {
+            if (!this.handler)
+                return;
+            const data = event.data;
+            if (data && typeof data === 'object' && RPC_MARKER in data) {
+                try {
+                    const message = data.payload;
+                    this.handler(message);
+                }
+                catch {
+                    // Ignore malformed messages
+                }
+            }
+        };
+        window.addEventListener('message', this.messageListener);
+    }
+    send(message) {
+        fetch(`https://${this.resourceName}/${RPC_ENDPOINT}`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(message),
+        }).catch(() => {
+            // Ignore fetch errors (resource may not be ready)
+        });
+    }
+    onMessage(handler) {
+        this.handler = handler;
+    }
+    destroy() {
+        this.handler = null;
+        if (this.messageListener) {
+            window.removeEventListener('message', this.messageListener);
+            this.messageListener = null;
+        }
+    }
+}
+exports.FiveMNuiTransport = FiveMNuiTransport;
+//# sourceMappingURL=fivem-nui.transport.js.map

package/dist/cjs/adapters/fivem/fivem-nui.transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fivem-nui.transport.js","sourceRoot":"","sources":["../../../../src/adapters/fivem/fivem-nui.transport.ts"],"names":[],"mappings":";;;AAEA,MAAM,YAAY,GAAG,WAAW,CAAC;AACjC,MAAM,UAAU,GAAG,WAAW,CAAC;AAE/B;;;;;GAKG;AACH,MAAa,iBAAiB;IACpB,OAAO,GAA2C,IAAI,CAAC;IACvD,eAAe,GAA2C,IAAI,CAAC;IAC/D,YAAY,CAAS;IAE7B;QACE,MAAM,GAAG,GAAG,MAA6D,CAAC;QAC1E,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,qBAAqB,EAAE,EAAE,IAAI,MAAM,CAAC;QAE5D,IAAI,CAAC,eAAe,GAAG,CAAC,KAAmB,EAAE,EAAE;YAC7C,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO;YAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YACxB,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;gBAC3D,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAqB,CAAC;oBAC3C,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC;oBACP,4BAA4B;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC,OAAmB;QACtB,KAAK,CAAC,WAAW,IAAI,CAAC,YAAY,IAAI,YAAY,EAAE,EAAE;YACpD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACZ,kDAAkD;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,OAAsC;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,OAAO;QACL,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;YAC5D,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC9B,CAAC;IACH,CAAC;CACF;AA7CD,8CA6CC"}