@laot/nuix 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LAOT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,172 @@
+# NUIX
+
+> Modular, type-safe TypeScript library for FiveM NUI projects. Zero runtime dependencies.
+
+## Install
+
+```bash
+npm install @laot/nuix
+```
+
+## Quick Start
+
+### 1. Define Your Event Map
+
+```ts
+import type { NuiEventMap } from "@laot/nuix";
+
+interface MyEvents extends NuiEventMap {
+  getPlayer: { request: { id: number }; response: { name: string; level: number } };
+  sendNotify: { request: { message: string }; response: void };
+}
+```
+
+### 2. Typed FetchNui
+
+```ts
+import { createFetchNui } from "@laot/nuix";
+
+const fetchNui = createFetchNui<MyEvents>();
+
+// Fully typed — request and response inferred from event map
+const player = await fetchNui("getPlayer", { id: 1 });
+console.log(player.name); // ✅ typed as string
+
+await fetchNui("sendNotify", { message: "Hello!" });
+
+// With timeout (throws descriptive error on timeout)
+const data = await fetchNui("getPlayer", { id: 2 }, { timeout: 5000 });
+```
+
+### 3. NUI Message Listener
+
+```ts
+import { onNuiMessage } from "@laot/nuix";
+
+interface MyMessages extends NuiEventMap {
+  showMenu: { request: { items: string[] }; response: void };
+  hideMenu: { request: void; response: void };
+}
+
+const unsub = onNuiMessage<MyMessages, "showMenu">("showMenu", (data) => {
+  console.log(data.items); // ✅ typed as string[]
+});
+
+// Clean up
+unsub();
+```
+
+### 4. Lua-Style Formatter
+
+```ts
+import { luaFormat } from "@laot/nuix";
+
+luaFormat("Hello %s, you are level %d", "Laot", 42);
+// → "Hello Laot, you are level 42"
+
+luaFormat("Accuracy: %f%%", 99.5);
+// → "Accuracy: 99.5%"
+```
+
+### 5. Translator
+
+```ts
+import { createTranslator, mergeLocales } from "@laot/nuix";
+
+const _U = createTranslator({
+  locales: {
+    client: {
+      greeting: "Hello %s!",
+      level: "Level %d",
+    },
+    server: {
+      error: "Error: %s",
+    },
+    flat_key: "Plain message: %s",
+  },
+});
+
+_U("client.greeting", "MISSING", "Laot");  // → "Hello Laot!"
+_U("client.level", "MISSING", 42);         // → "Level 42"
+_U("flat_key", "MISSING", "test");         // → "Plain message: test"
+_U("no.key", "Not found");                // → "Not found"
+
+// Deep-merge multiple locale files
+const base = { client: { greeting: "Hello %s!" } };
+const overrides = { client: { greeting: "Hey %s, welcome back!" } };
+const merged = mergeLocales(base, overrides);
+const _T = createTranslator({ locales: merged });
+
+_T("client.greeting", "MISSING", "Laot"); // → "Hey Laot, welcome back!"
+```
+
+### 6. Debug Mode
+
+Enable console logging for every `fetchNui` call — useful during local development:
+
+```ts
+const fetchNui = createFetchNui<MyEvents>({ debug: true });
+
+await fetchNui("getPlayer", { id: 1 });
+// Console:
+// [NUIX] → getPlayer { id: 1 }
+// [NUIX] ← getPlayer { name: "Laot", level: 42 }
+```
+
+### 7. Mock Data (Local Development)
+
+When developing outside FiveM, `fetchNui` can return pre-defined mock responses instead of making real HTTP calls:
+
+```ts
+const fetchNui = createFetchNui<MyEvents>({
+  debug: true,
+  mockData: {
+    // Static response
+    getPlayer: { name: "DevPlayer", level: 99 },
+
+    // Dynamic response based on request
+    sendNotify: (req) => {
+      console.log("Mock notification:", req.message);
+    },
+  },
+});
+
+const player = await fetchNui("getPlayer", { id: 1 });
+// Console: [NUIX] → getPlayer { id: 1 }
+// Console: [NUIX] ← getPlayer (mock) { name: "DevPlayer", level: 99 }
+// player = { name: "DevPlayer", level: 99 }
+```
+
+## Lua Callback Example
+
+```lua
+-- client side
+RegisterNUICallback("getPlayer", function(data, cb)
+    local player = GetPlayerData(data.id)
+    cb({ name = player.name, level = player.level })
+end)
+
+-- sending messages to NUI
+SendNUIMessage({ action = "showMenu", data = { items = {"Pistol", "Rifle"} } })
+```
+
+## API Reference
+
+| Export | Type | Description |
+|---|---|---|
+| `createFetchNui<TMap>(options?)` | Factory | Returns a typed `fetchNui` function (supports debug & mock) |
+| `onNuiMessage<TMap, K>(action, handler)` | Function | Listens for NUI messages by action |
+| `luaFormat(template, ...args)` | Function | Lua-style `%s`/`%d`/`%f` formatter |
+| `createTranslator(options)` | Factory | Returns a `_U` translator function |
+| `mergeLocales(...records)` | Function | Deep-merges locale records |
+
+## Build
+
+```bash
+npm run build      # ESM + CJS + .d.ts
+npm run typecheck   # tsc --noEmit
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,168 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createFetchNui: () => createFetchNui,
+  createTranslator: () => createTranslator,
+  luaFormat: () => luaFormat,
+  mergeLocales: () => mergeLocales,
+  onNuiMessage: () => onNuiMessage
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+function getResourceName() {
+  if (typeof window !== "undefined" && window.GetParentResourceName) {
+    return window.GetParentResourceName();
+  }
+  return "nui-frame-app";
+}
+function createFetchNui(factoryOptions) {
+  const debug = factoryOptions?.debug ?? false;
+  const mockData = factoryOptions?.mockData;
+  return async function fetchNui(event, data, options) {
+    if (debug) {
+      console.log(`[NUIX] \u2192 ${event}`, data ?? {});
+    }
+    if (mockData && event in mockData) {
+      const mock = mockData[event];
+      if (mock === void 0) {
+        throw new Error(`[NUIX] Mock data for "${event}" is undefined`);
+      }
+      const result = typeof mock === "function" ? mock(data) : mock;
+      if (debug) {
+        console.log(`[NUIX] \u2190 ${event} (mock)`, result);
+      }
+      return result;
+    }
+    const url = `https://${getResourceName()}/${event}`;
+    const controller = options?.timeout ? new AbortController() : void 0;
+    let timeoutId;
+    if (controller && options?.timeout) {
+      timeoutId = setTimeout(() => controller.abort(), options.timeout);
+    }
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json; charset=UTF-8" },
+        body: JSON.stringify(data ?? {}),
+        signal: controller?.signal
+      });
+      if (!response.ok) {
+        throw new Error(`[NUIX] fetchNui("${event}") failed with HTTP ${response.status}`);
+      }
+      const result = await response.json();
+      if (debug) {
+        console.log(`[NUIX] \u2190 ${event}`, result);
+      }
+      return result;
+    } catch (error) {
+      if (error instanceof DOMException && error.name === "AbortError") {
+        throw new Error(`[NUIX] fetchNui("${event}") timed out after ${options?.timeout}ms`);
+      }
+      throw error;
+    } finally {
+      if (timeoutId !== void 0) clearTimeout(timeoutId);
+    }
+  };
+}
+
+// src/listener.ts
+function onNuiMessage(action, handler) {
+  const listener = (event) => {
+    const payload = event.data;
+    if (!payload || typeof payload !== "object") return;
+    if (payload.action !== action) return;
+    handler(payload.data);
+  };
+  window.addEventListener("message", listener);
+  return () => {
+    window.removeEventListener("message", listener);
+  };
+}
+
+// src/utils.ts
+function luaFormat(template, ...args) {
+  let argIndex = 0;
+  return template.replace(/%([sdfi%])/g, (match, specifier) => {
+    if (specifier === "%") return "%";
+    const raw = args[argIndex++];
+    switch (specifier) {
+      case "s":
+        return String(raw ?? "");
+      case "d":
+      case "i": {
+        const num = Number(raw);
+        return String(Number.isNaN(num) ? 0 : Math.floor(num));
+      }
+      case "f": {
+        const num = Number(raw);
+        return String(Number.isNaN(num) ? 0 : num);
+      }
+      default:
+        return match;
+    }
+  });
+}
+function resolveKey(locales, key) {
+  const segments = key.split(".");
+  let current = locales;
+  for (const segment of segments) {
+    if (typeof current !== "object" || current === null) return void 0;
+    const next = current[segment];
+    if (next === void 0) return void 0;
+    current = next;
+  }
+  return typeof current === "string" ? current : void 0;
+}
+function createTranslator(options) {
+  const { locales } = options;
+  return (key, fallback, ...args) => {
+    const template = resolveKey(locales, key);
+    if (template === void 0) {
+      return fallback;
+    }
+    return args.length > 0 ? luaFormat(template, ...args) : template;
+  };
+}
+function mergeLocales(...records) {
+  const result = {};
+  for (const record of records) {
+    for (const [key, value] of Object.entries(record)) {
+      const existing = result[key];
+      if (typeof value === "object" && typeof existing === "object" && existing !== void 0) {
+        result[key] = mergeLocales(existing, value);
+      } else {
+        result[key] = value;
+      }
+    }
+  }
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createFetchNui,
+  createTranslator,
+  luaFormat,
+  mergeLocales,
+  onNuiMessage
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/listener.ts","../src/utils.ts"],"sourcesContent":["// ─── Types ───\r\nexport type {\r\n\tNuiEventMap,\r\n\tNuiMessagePayload,\r\n\tFetchNuiOptions,\r\n\tFetchNuiFactoryOptions,\r\n\tLocaleRecord,\r\n\tTranslatorOptions,\r\n\tTranslatorFn,\r\n\tFormatArg,\r\n\tUnsubscribeFn,\r\n\tNuiMessageHandler,\r\n} from \"./types\";\r\n\r\n// ─── Client ───\r\nexport { createFetchNui } from \"./client\";\r\n\r\n// ─── Listener ───\r\nexport { onNuiMessage } from \"./listener\";\r\n\r\n// ─── Utils ───\r\nexport { luaFormat, createTranslator, mergeLocales } from \"./utils\";\r\n","import type { NuiEventMap, FetchNuiOptions, FetchNuiFactoryOptions } from \"./types\";\r\n\r\n// ─── Resource Name ───\r\n\r\n/**\r\n * Grabs the resource name from FiveM's injected global.\r\n * Falls back to `\"nui-frame-app\"` when running outside the game (local dev, tests).\r\n */\r\nfunction getResourceName(): string {\r\n\tif (typeof window !== \"undefined\" && window.GetParentResourceName) {\r\n\t\treturn window.GetParentResourceName();\r\n\t}\r\n\treturn \"nui-frame-app\";\r\n}\r\n\r\n// ─── FetchNui Factory ───\r\n\r\n/**\r\n * Creates a fully typed `fetchNui` function tied to your event map.\r\n *\r\n * The returned function POSTs JSON to `https://<resourceName>/<event>`,\r\n * which maps 1:1 to `RegisterNUICallback` on the Lua side.\r\n *\r\n * Supports optional debug logging, mock data for local dev, and per-call timeout.\r\n *\r\n * @example\r\n * ```ts\r\n * interface MyEvents extends NuiEventMap {\r\n *   getPlayer: { request: { id: number }; response: { name: string } };\r\n *   notify:    { request: { msg: string }; response: void };\r\n * }\r\n *\r\n * // Production usage\r\n * const fetchNui = createFetchNui<MyEvents>();\r\n * const player = await fetchNui(\"getPlayer\", { id: 1 });\r\n * // player.name is typed as string\r\n *\r\n * // Local dev with mocks + debug\r\n * const fetchNui = createFetchNui<MyEvents>({\r\n *   debug: true,\r\n *   mockData: {\r\n *     getPlayer: { name: \"DevPlayer\" },\r\n *     notify: (req) => { console.log(\"Mock:\", req.msg); },\r\n *   },\r\n * });\r\n * ```\r\n *\r\n * Lua side:\r\n * ```lua\r\n * RegisterNUICallback(\"getPlayer\", function(data, cb)\r\n *     local player = GetPlayerData(data.id)\r\n *     cb({ name = player.name })\r\n * end)\r\n * ```\r\n */\r\nexport function createFetchNui<TMap extends NuiEventMap>(factoryOptions?: FetchNuiFactoryOptions<TMap>) {\r\n\tconst debug = factoryOptions?.debug ?? false;\r\n\tconst mockData = factoryOptions?.mockData;\r\n\r\n\treturn async function fetchNui<K extends keyof TMap & string>(\r\n\t\tevent: K,\r\n\t\tdata?: TMap[K][\"request\"],\r\n\t\toptions?: FetchNuiOptions,\r\n\t): Promise<TMap[K][\"response\"]> {\r\n\t\tif (debug) {\r\n\t\t\tconsole.log(`[NUIX] → ${event}`, data ?? {});\r\n\t\t}\r\n\r\n\t\t// ─── Mock Mode ───\r\n\r\n\t\tif (mockData && event in mockData) {\r\n\t\t\tconst mock = mockData[event];\r\n\r\n\t\t\tif (mock === undefined) {\r\n\t\t\t\tthrow new Error(`[NUIX] Mock data for \"${event}\" is undefined`);\r\n\t\t\t}\r\n\r\n\t\t\tconst result =\r\n\t\t\t\ttypeof mock === \"function\"\r\n\t\t\t\t\t? (mock as (req: TMap[K][\"request\"]) => TMap[K][\"response\"])(data as TMap[K][\"request\"])\r\n\t\t\t\t\t: mock;\r\n\r\n\t\t\tif (debug) {\r\n\t\t\t\tconsole.log(`[NUIX] ← ${event} (mock)`, result);\r\n\t\t\t}\r\n\r\n\t\t\treturn result as TMap[K][\"response\"];\r\n\t\t}\r\n\r\n\t\t// ─── Real Fetch ───\r\n\r\n\t\tconst url = `https://${getResourceName()}/${event}`;\r\n\r\n\t\tconst controller = options?.timeout ? new AbortController() : undefined;\r\n\t\tlet timeoutId: ReturnType<typeof setTimeout> | undefined;\r\n\r\n\t\tif (controller && options?.timeout) {\r\n\t\t\ttimeoutId = setTimeout(() => controller.abort(), options.timeout);\r\n\t\t}\r\n\r\n\t\ttry {\r\n\t\t\tconst response = await fetch(url, {\r\n\t\t\t\tmethod: \"POST\",\r\n\t\t\t\theaders: { \"Content-Type\": \"application/json; charset=UTF-8\" },\r\n\t\t\t\tbody: JSON.stringify(data ?? {}),\r\n\t\t\t\tsignal: controller?.signal,\r\n\t\t\t});\r\n\r\n\t\t\tif (!response.ok) {\r\n\t\t\t\tthrow new Error(`[NUIX] fetchNui(\"${event}\") failed with HTTP ${response.status}`);\r\n\t\t\t}\r\n\r\n\t\t\tconst result = (await response.json()) as TMap[K][\"response\"];\r\n\r\n\t\t\tif (debug) {\r\n\t\t\t\tconsole.log(`[NUIX] ← ${event}`, result);\r\n\t\t\t}\r\n\r\n\t\t\treturn result;\r\n\t\t} catch (error) {\r\n\t\t\tif (error instanceof DOMException && error.name === \"AbortError\") {\r\n\t\t\t\tthrow new Error(`[NUIX] fetchNui(\"${event}\") timed out after ${options?.timeout}ms`);\r\n\t\t\t}\r\n\t\t\tthrow error;\r\n\t\t} finally {\r\n\t\t\tif (timeoutId !== undefined) clearTimeout(timeoutId);\r\n\t\t}\r\n\t};\r\n}\r\n","import type { NuiEventMap, NuiMessagePayload, NuiMessageHandler, UnsubscribeFn } from \"./types\";\r\n\r\n// ─── NUI Message Listener ───\r\n\r\n/**\r\n * Listens for NUI messages from Lua (`SendNUIMessage`), filtered by action name.\r\n * Only messages matching the given `action` trigger the handler.\r\n * Returns a cleanup function to stop listening.\r\n *\r\n * @example\r\n * ```ts\r\n * interface MyMessages extends NuiEventMap {\r\n *   showMenu: { request: { items: string[] }; response: void };\r\n *   hideMenu: { request: void;               response: void };\r\n * }\r\n *\r\n * const unsub = onNuiMessage<MyMessages, \"showMenu\">(\"showMenu\", (data) => {\r\n *   console.log(data.items); // typed as string[]\r\n * });\r\n *\r\n * // Stop listening when done\r\n * unsub();\r\n * ```\r\n *\r\n * Lua side:\r\n * ```lua\r\n * SendNUIMessage({ action = \"showMenu\", data = { items = {\"Pistol\", \"Rifle\"} } })\r\n * ```\r\n */\r\nexport function onNuiMessage<TMap extends NuiEventMap, K extends keyof TMap & string>(\r\n\taction: K,\r\n\thandler: NuiMessageHandler<TMap[K][\"request\"]>,\r\n): UnsubscribeFn {\r\n\tconst listener = (event: MessageEvent<NuiMessagePayload<TMap[K][\"request\"]>>) => {\r\n\t\tconst payload = event.data;\r\n\r\n\t\tif (!payload || typeof payload !== \"object\") return;\r\n\t\tif (payload.action !== action) return;\r\n\r\n\t\thandler(payload.data);\r\n\t};\r\n\r\n\twindow.addEventListener(\"message\", listener);\r\n\r\n\treturn () => {\r\n\t\twindow.removeEventListener(\"message\", listener);\r\n\t};\r\n}\r\n","import type { FormatArg, LocaleRecord, TranslatorFn, TranslatorOptions } from \"./types\";\r\n\r\n// ─── Lua-Style Formatter ───\r\n\r\n/**\r\n * Formats a string using Lua-style placeholders.\r\n *\r\n * Specifiers:\r\n * - `%s` — string (null/undefined becomes empty string)\r\n * - `%d` — integer (floors the value, NaN becomes 0)\r\n * - `%f` — float (NaN becomes 0)\r\n * - `%%` — literal percent sign\r\n *\r\n * @example\r\n * ```ts\r\n * luaFormat(\"Hello %s, you are level %d\", \"Laot\", 42);\r\n * // → \"Hello Laot, you are level 42\"\r\n *\r\n * luaFormat(\"Accuracy: %f%%\", 99.5);\r\n * // → \"Accuracy: 99.5%\"\r\n *\r\n * luaFormat(\"Safe: %s %d\", undefined, NaN);\r\n * // → \"Safe:  0\"\r\n * ```\r\n */\r\nexport function luaFormat(template: string, ...args: FormatArg[]): string {\r\n\tlet argIndex = 0;\r\n\r\n\treturn template.replace(/%([sdfi%])/g, (match, specifier: string) => {\r\n\t\tif (specifier === \"%\") return \"%\";\r\n\r\n\t\tconst raw = args[argIndex++];\r\n\r\n\t\tswitch (specifier) {\r\n\t\t\tcase \"s\":\r\n\t\t\t\treturn String(raw ?? \"\");\r\n\r\n\t\t\tcase \"d\":\r\n\t\t\tcase \"i\": {\r\n\t\t\t\tconst num = Number(raw);\r\n\t\t\t\treturn String(Number.isNaN(num) ? 0 : Math.floor(num));\r\n\t\t\t}\r\n\r\n\t\t\tcase \"f\": {\r\n\t\t\t\tconst num = Number(raw);\r\n\t\t\t\treturn String(Number.isNaN(num) ? 0 : num);\r\n\t\t\t}\r\n\r\n\t\t\tdefault:\r\n\t\t\t\treturn match;\r\n\t\t}\r\n\t});\r\n}\r\n\r\n// ─── Dot-Notation Resolver ───\r\n\r\n/**\r\n * Walks a nested locale object by splitting the key on `.`\r\n * Returns the string value at the end of the path, or `undefined` if any segment is missing.\r\n *\r\n * `\"client.greeting\"` → looks up `locales.client.greeting`\r\n * `\"flat_key\"` → looks up `locales.flat_key` directly\r\n */\r\nfunction resolveKey(locales: LocaleRecord, key: string): string | undefined {\r\n\tconst segments = key.split(\".\");\r\n\tlet current: LocaleRecord | string = locales;\r\n\r\n\tfor (const segment of segments) {\r\n\t\tif (typeof current !== \"object\" || current === null) return undefined;\r\n\t\tconst next: string | LocaleRecord | undefined = current[segment];\r\n\t\tif (next === undefined) return undefined;\r\n\t\tcurrent = next;\r\n\t}\r\n\r\n\treturn typeof current === \"string\" ? current : undefined;\r\n}\r\n\r\n// ─── Translator Factory ───\r\n\r\n/**\r\n * Creates a `_U(key, fallback, ...args)` translator bound to a locale record.\r\n *\r\n * The key supports dot-notation to traverse nested locale objects.\r\n * If the key isn't found, the fallback string is returned as-is.\r\n * Any extra args are passed through `luaFormat` for placeholder substitution.\r\n *\r\n * @example\r\n * ```ts\r\n * const _U = createTranslator({\r\n *   locales: {\r\n *     client: {\r\n *       greeting: \"Hello %s!\",\r\n *       level: \"Level %d\",\r\n *     },\r\n *     server: {\r\n *       error: \"Error: %s\",\r\n *     },\r\n *     flat_key: \"Plain message\",\r\n *   },\r\n * });\r\n *\r\n * _U(\"client.greeting\", \"MISSING\", \"Laot\");  // → \"Hello Laot!\"\r\n * _U(\"client.level\", \"MISSING\", 42);         // → \"Level 42\"\r\n * _U(\"flat_key\", \"MISSING\");                 // → \"Plain message\"\r\n * _U(\"no.key\", \"Not found\");                 // → \"Not found\"\r\n * ```\r\n */\r\nexport function createTranslator(options: TranslatorOptions): TranslatorFn {\r\n\tconst { locales } = options;\r\n\r\n\treturn (key: string, fallback: string, ...args: FormatArg[]): string => {\r\n\t\tconst template = resolveKey(locales, key);\r\n\r\n\t\tif (template === undefined) {\r\n\t\t\treturn fallback;\r\n\t\t}\r\n\r\n\t\treturn args.length > 0 ? luaFormat(template, ...args) : template;\r\n\t};\r\n}\r\n\r\n// ─── Deep Merge ───\r\n\r\n/**\r\n * Deep-merges multiple locale records into one.\r\n * Later records override earlier ones on key conflicts.\r\n * Nested objects are merged recursively, not replaced entirely.\r\n *\r\n * @example\r\n * ```ts\r\n * const base = { client: { greeting: \"Hello %s!\", level: \"Level %d\" } };\r\n * const overrides = { client: { greeting: \"Hey %s!\" } };\r\n *\r\n * const merged = mergeLocales(base, overrides);\r\n * // merged.client.greeting → \"Hey %s!\"\r\n * // merged.client.level    → \"Level %d\" (preserved from base)\r\n * ```\r\n */\r\nexport function mergeLocales(...records: LocaleRecord[]): LocaleRecord {\r\n\tconst result: LocaleRecord = {};\r\n\r\n\tfor (const record of records) {\r\n\t\tfor (const [key, value] of Object.entries(record)) {\r\n\t\t\tconst existing = result[key];\r\n\r\n\t\t\tif (typeof value === \"object\" && typeof existing === \"object\" && existing !== undefined) {\r\n\t\t\t\tresult[key] = mergeLocales(existing, value);\r\n\t\t\t} else {\r\n\t\t\t\tresult[key] = value;\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n\r\n\treturn result;\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,248 @@
+/**
+ * Extend this to map your NUI callback names to their request/response shapes.
+ * Both `fetchNui` and `onNuiMessage` use this map for full type inference.
+ *
+ * @example
+ * ```ts
+ * interface MyEvents extends NuiEventMap {
+ *   getPlayer:  { request: { id: number }; response: { name: string; level: number } };
+ *   sendNotify: { request: { message: string }; response: void };
+ * }
+ *
+ * // Now fetchNui("getPlayer", { id: 1 }) returns Promise<{ name: string; level: number }>
+ * ```
+ */
+interface NuiEventMap {
+    [event: string]: {
+        request: unknown;
+        response: unknown;
+    };
+}
+/**
+ * The shape Lua sends via `SendNUIMessage`.
+ * Every message has an `action` string and a `data` payload.
+ *
+ * Lua side:
+ * ```lua
+ * SendNUIMessage({ action = "showMenu", data = { items = {"Pistol", "Rifle"} } })
+ * ```
+ */
+interface NuiMessagePayload<TData = unknown> {
+    action: string;
+    data: TData;
+}
+interface FetchNuiOptions {
+    /**
+     * Timeout in ms. If the Lua callback doesn't respond within this window,
+     * the promise rejects with a descriptive timeout error.
+     */
+    timeout?: number;
+}
+/**
+ * Options passed to `createFetchNui()` at factory level.
+ *
+ * @example
+ * ```ts
+ * const fetchNui = createFetchNui<MyEvents>({
+ *   debug: true,
+ *   mockData: {
+ *     getPlayer: { name: "Dev", level: 99 },
+ *     sendNotify: (req) => { console.log(req.message); },
+ *   },
+ * });
+ * ```
+ */
+interface FetchNuiFactoryOptions<TMap extends NuiEventMap> {
+    /** Logs every `fetchNui` call and response to the console with `[NUIX]` prefix. */
+    debug?: boolean;
+    /**
+     * Mock responses for local development outside FiveM.
+     * Can be a static value or a function that receives the request and returns the response.
+     * When a mock exists for an event, no HTTP call is made.
+     */
+    mockData?: {
+        [K in keyof TMap]?: TMap[K]["response"] | ((request: TMap[K]["request"]) => TMap[K]["response"]);
+    };
+}
+/**
+ * Locale record — can be flat strings or nested objects.
+ * Nested keys are accessed via dot-notation in the translator.
+ *
+ * @example
+ * ```ts
+ * const locales: LocaleRecord = {
+ *   client: {
+ *     greeting: "Hello %s!",
+ *     level: "Level %d",
+ *   },
+ *   simple_key: "No nesting here",
+ * };
+ * ```
+ */
+type LocaleRecord = {
+    [key: string]: string | LocaleRecord;
+};
+interface TranslatorOptions {
+    /** The locale map. Same structure as `LocaleRecord` — flat or nested. */
+    locales: LocaleRecord;
+}
+/**
+ * Translator function returned by `createTranslator`.
+ *
+ * @param key      - Dot-notated key like `'client.greeting'` or flat like `'title'`
+ * @param fallback - Returned when the key doesn't exist in the locale map
+ * @param args     - Format arguments for `%s`, `%d`, `%f` placeholders
+ *
+ * @example
+ * ```ts
+ * _U("client.greeting", "MISSING", "Laot");  // → "Hello Laot!"
+ * _U("no.key", "Not found");                 // → "Not found"
+ * ```
+ */
+type TranslatorFn = (key: string, fallback: string, ...args: FormatArg[]) => string;
+/**
+ * Types that `luaFormat` accepts as arguments.
+ * `null` and `undefined` are handled safely — they won't crash the formatter.
+ */
+type FormatArg = string | number | boolean | null | undefined;
+/** Cleanup function — call it to remove the listener. */
+type UnsubscribeFn = () => void;
+/** Callback invoked when a matching NUI message arrives. */
+type NuiMessageHandler<TData = unknown> = (data: TData) => void;
+
+/**
+ * Creates a fully typed `fetchNui` function tied to your event map.
+ *
+ * The returned function POSTs JSON to `https://<resourceName>/<event>`,
+ * which maps 1:1 to `RegisterNUICallback` on the Lua side.
+ *
+ * Supports optional debug logging, mock data for local dev, and per-call timeout.
+ *
+ * @example
+ * ```ts
+ * interface MyEvents extends NuiEventMap {
+ *   getPlayer: { request: { id: number }; response: { name: string } };
+ *   notify:    { request: { msg: string }; response: void };
+ * }
+ *
+ * // Production usage
+ * const fetchNui = createFetchNui<MyEvents>();
+ * const player = await fetchNui("getPlayer", { id: 1 });
+ * // player.name is typed as string
+ *
+ * // Local dev with mocks + debug
+ * const fetchNui = createFetchNui<MyEvents>({
+ *   debug: true,
+ *   mockData: {
+ *     getPlayer: { name: "DevPlayer" },
+ *     notify: (req) => { console.log("Mock:", req.msg); },
+ *   },
+ * });
+ * ```
+ *
+ * Lua side:
+ * ```lua
+ * RegisterNUICallback("getPlayer", function(data, cb)
+ *     local player = GetPlayerData(data.id)
+ *     cb({ name = player.name })
+ * end)
+ * ```
+ */
+declare function createFetchNui<TMap extends NuiEventMap>(factoryOptions?: FetchNuiFactoryOptions<TMap>): <K extends keyof TMap & string>(event: K, data?: TMap[K]["request"], options?: FetchNuiOptions) => Promise<TMap[K]["response"]>;
+
+/**
+ * Listens for NUI messages from Lua (`SendNUIMessage`), filtered by action name.
+ * Only messages matching the given `action` trigger the handler.
+ * Returns a cleanup function to stop listening.
+ *
+ * @example
+ * ```ts
+ * interface MyMessages extends NuiEventMap {
+ *   showMenu: { request: { items: string[] }; response: void };
+ *   hideMenu: { request: void;               response: void };
+ * }
+ *
+ * const unsub = onNuiMessage<MyMessages, "showMenu">("showMenu", (data) => {
+ *   console.log(data.items); // typed as string[]
+ * });
+ *
+ * // Stop listening when done
+ * unsub();
+ * ```
+ *
+ * Lua side:
+ * ```lua
+ * SendNUIMessage({ action = "showMenu", data = { items = {"Pistol", "Rifle"} } })
+ * ```
+ */
+declare function onNuiMessage<TMap extends NuiEventMap, K extends keyof TMap & string>(action: K, handler: NuiMessageHandler<TMap[K]["request"]>): UnsubscribeFn;
+
+/**
+ * Formats a string using Lua-style placeholders.
+ *
+ * Specifiers:
+ * - `%s` — string (null/undefined becomes empty string)
+ * - `%d` — integer (floors the value, NaN becomes 0)
+ * - `%f` — float (NaN becomes 0)
+ * - `%%` — literal percent sign
+ *
+ * @example
+ * ```ts
+ * luaFormat("Hello %s, you are level %d", "Laot", 42);
+ * // → "Hello Laot, you are level 42"
+ *
+ * luaFormat("Accuracy: %f%%", 99.5);
+ * // → "Accuracy: 99.5%"
+ *
+ * luaFormat("Safe: %s %d", undefined, NaN);
+ * // → "Safe:  0"
+ * ```
+ */
+declare function luaFormat(template: string, ...args: FormatArg[]): string;
+/**
+ * Creates a `_U(key, fallback, ...args)` translator bound to a locale record.
+ *
+ * The key supports dot-notation to traverse nested locale objects.
+ * If the key isn't found, the fallback string is returned as-is.
+ * Any extra args are passed through `luaFormat` for placeholder substitution.
+ *
+ * @example
+ * ```ts
+ * const _U = createTranslator({
+ *   locales: {
+ *     client: {
+ *       greeting: "Hello %s!",
+ *       level: "Level %d",
+ *     },
+ *     server: {
+ *       error: "Error: %s",
+ *     },
+ *     flat_key: "Plain message",
+ *   },
+ * });
+ *
+ * _U("client.greeting", "MISSING", "Laot");  // → "Hello Laot!"
+ * _U("client.level", "MISSING", 42);         // → "Level 42"
+ * _U("flat_key", "MISSING");                 // → "Plain message"
+ * _U("no.key", "Not found");                 // → "Not found"
+ * ```
+ */
+declare function createTranslator(options: TranslatorOptions): TranslatorFn;
+/**
+ * Deep-merges multiple locale records into one.
+ * Later records override earlier ones on key conflicts.
+ * Nested objects are merged recursively, not replaced entirely.
+ *
+ * @example
+ * ```ts
+ * const base = { client: { greeting: "Hello %s!", level: "Level %d" } };
+ * const overrides = { client: { greeting: "Hey %s!" } };
+ *
+ * const merged = mergeLocales(base, overrides);
+ * // merged.client.greeting → "Hey %s!"
+ * // merged.client.level    → "Level %d" (preserved from base)
+ * ```
+ */
+declare function mergeLocales(...records: LocaleRecord[]): LocaleRecord;
+
+export { type FetchNuiFactoryOptions, type FetchNuiOptions, type FormatArg, type LocaleRecord, type NuiEventMap, type NuiMessageHandler, type NuiMessagePayload, type TranslatorFn, type TranslatorOptions, type UnsubscribeFn, createFetchNui, createTranslator, luaFormat, mergeLocales, onNuiMessage };

package/dist/index.d.ts

@@ -0,0 +1,248 @@
+/**
+ * Extend this to map your NUI callback names to their request/response shapes.
+ * Both `fetchNui` and `onNuiMessage` use this map for full type inference.
+ *
+ * @example
+ * ```ts
+ * interface MyEvents extends NuiEventMap {
+ *   getPlayer:  { request: { id: number }; response: { name: string; level: number } };
+ *   sendNotify: { request: { message: string }; response: void };
+ * }
+ *
+ * // Now fetchNui("getPlayer", { id: 1 }) returns Promise<{ name: string; level: number }>
+ * ```
+ */
+interface NuiEventMap {
+    [event: string]: {
+        request: unknown;
+        response: unknown;
+    };
+}
+/**
+ * The shape Lua sends via `SendNUIMessage`.
+ * Every message has an `action` string and a `data` payload.
+ *
+ * Lua side:
+ * ```lua
+ * SendNUIMessage({ action = "showMenu", data = { items = {"Pistol", "Rifle"} } })
+ * ```
+ */
+interface NuiMessagePayload<TData = unknown> {
+    action: string;
+    data: TData;
+}
+interface FetchNuiOptions {
+    /**
+     * Timeout in ms. If the Lua callback doesn't respond within this window,
+     * the promise rejects with a descriptive timeout error.
+     */
+    timeout?: number;
+}
+/**
+ * Options passed to `createFetchNui()` at factory level.
+ *
+ * @example
+ * ```ts
+ * const fetchNui = createFetchNui<MyEvents>({
+ *   debug: true,
+ *   mockData: {
+ *     getPlayer: { name: "Dev", level: 99 },
+ *     sendNotify: (req) => { console.log(req.message); },
+ *   },
+ * });
+ * ```
+ */
+interface FetchNuiFactoryOptions<TMap extends NuiEventMap> {
+    /** Logs every `fetchNui` call and response to the console with `[NUIX]` prefix. */
+    debug?: boolean;
+    /**
+     * Mock responses for local development outside FiveM.
+     * Can be a static value or a function that receives the request and returns the response.
+     * When a mock exists for an event, no HTTP call is made.
+     */
+    mockData?: {
+        [K in keyof TMap]?: TMap[K]["response"] | ((request: TMap[K]["request"]) => TMap[K]["response"]);
+    };
+}
+/**
+ * Locale record — can be flat strings or nested objects.
+ * Nested keys are accessed via dot-notation in the translator.
+ *
+ * @example
+ * ```ts
+ * const locales: LocaleRecord = {
+ *   client: {
+ *     greeting: "Hello %s!",
+ *     level: "Level %d",
+ *   },
+ *   simple_key: "No nesting here",
+ * };
+ * ```
+ */
+type LocaleRecord = {
+    [key: string]: string | LocaleRecord;
+};
+interface TranslatorOptions {
+    /** The locale map. Same structure as `LocaleRecord` — flat or nested. */
+    locales: LocaleRecord;
+}
+/**
+ * Translator function returned by `createTranslator`.
+ *
+ * @param key      - Dot-notated key like `'client.greeting'` or flat like `'title'`
+ * @param fallback - Returned when the key doesn't exist in the locale map
+ * @param args     - Format arguments for `%s`, `%d`, `%f` placeholders
+ *
+ * @example
+ * ```ts
+ * _U("client.greeting", "MISSING", "Laot");  // → "Hello Laot!"
+ * _U("no.key", "Not found");                 // → "Not found"
+ * ```
+ */
+type TranslatorFn = (key: string, fallback: string, ...args: FormatArg[]) => string;
+/**
+ * Types that `luaFormat` accepts as arguments.
+ * `null` and `undefined` are handled safely — they won't crash the formatter.
+ */
+type FormatArg = string | number | boolean | null | undefined;
+/** Cleanup function — call it to remove the listener. */
+type UnsubscribeFn = () => void;
+/** Callback invoked when a matching NUI message arrives. */
+type NuiMessageHandler<TData = unknown> = (data: TData) => void;
+
+/**
+ * Creates a fully typed `fetchNui` function tied to your event map.
+ *
+ * The returned function POSTs JSON to `https://<resourceName>/<event>`,
+ * which maps 1:1 to `RegisterNUICallback` on the Lua side.
+ *
+ * Supports optional debug logging, mock data for local dev, and per-call timeout.
+ *
+ * @example
+ * ```ts
+ * interface MyEvents extends NuiEventMap {
+ *   getPlayer: { request: { id: number }; response: { name: string } };
+ *   notify:    { request: { msg: string }; response: void };
+ * }
+ *
+ * // Production usage
+ * const fetchNui = createFetchNui<MyEvents>();
+ * const player = await fetchNui("getPlayer", { id: 1 });
+ * // player.name is typed as string
+ *
+ * // Local dev with mocks + debug
+ * const fetchNui = createFetchNui<MyEvents>({
+ *   debug: true,
+ *   mockData: {
+ *     getPlayer: { name: "DevPlayer" },
+ *     notify: (req) => { console.log("Mock:", req.msg); },
+ *   },
+ * });
+ * ```
+ *
+ * Lua side:
+ * ```lua
+ * RegisterNUICallback("getPlayer", function(data, cb)
+ *     local player = GetPlayerData(data.id)
+ *     cb({ name = player.name })
+ * end)
+ * ```
+ */
+declare function createFetchNui<TMap extends NuiEventMap>(factoryOptions?: FetchNuiFactoryOptions<TMap>): <K extends keyof TMap & string>(event: K, data?: TMap[K]["request"], options?: FetchNuiOptions) => Promise<TMap[K]["response"]>;
+
+/**
+ * Listens for NUI messages from Lua (`SendNUIMessage`), filtered by action name.
+ * Only messages matching the given `action` trigger the handler.
+ * Returns a cleanup function to stop listening.
+ *
+ * @example
+ * ```ts
+ * interface MyMessages extends NuiEventMap {
+ *   showMenu: { request: { items: string[] }; response: void };
+ *   hideMenu: { request: void;               response: void };
+ * }
+ *
+ * const unsub = onNuiMessage<MyMessages, "showMenu">("showMenu", (data) => {
+ *   console.log(data.items); // typed as string[]
+ * });
+ *
+ * // Stop listening when done
+ * unsub();
+ * ```
+ *
+ * Lua side:
+ * ```lua
+ * SendNUIMessage({ action = "showMenu", data = { items = {"Pistol", "Rifle"} } })
+ * ```
+ */
+declare function onNuiMessage<TMap extends NuiEventMap, K extends keyof TMap & string>(action: K, handler: NuiMessageHandler<TMap[K]["request"]>): UnsubscribeFn;
+
+/**
+ * Formats a string using Lua-style placeholders.
+ *
+ * Specifiers:
+ * - `%s` — string (null/undefined becomes empty string)
+ * - `%d` — integer (floors the value, NaN becomes 0)
+ * - `%f` — float (NaN becomes 0)
+ * - `%%` — literal percent sign
+ *
+ * @example
+ * ```ts
+ * luaFormat("Hello %s, you are level %d", "Laot", 42);
+ * // → "Hello Laot, you are level 42"
+ *
+ * luaFormat("Accuracy: %f%%", 99.5);
+ * // → "Accuracy: 99.5%"
+ *
+ * luaFormat("Safe: %s %d", undefined, NaN);
+ * // → "Safe:  0"
+ * ```
+ */
+declare function luaFormat(template: string, ...args: FormatArg[]): string;
+/**
+ * Creates a `_U(key, fallback, ...args)` translator bound to a locale record.
+ *
+ * The key supports dot-notation to traverse nested locale objects.
+ * If the key isn't found, the fallback string is returned as-is.
+ * Any extra args are passed through `luaFormat` for placeholder substitution.
+ *
+ * @example
+ * ```ts
+ * const _U = createTranslator({
+ *   locales: {
+ *     client: {
+ *       greeting: "Hello %s!",
+ *       level: "Level %d",
+ *     },
+ *     server: {
+ *       error: "Error: %s",
+ *     },
+ *     flat_key: "Plain message",
+ *   },
+ * });
+ *
+ * _U("client.greeting", "MISSING", "Laot");  // → "Hello Laot!"
+ * _U("client.level", "MISSING", 42);         // → "Level 42"
+ * _U("flat_key", "MISSING");                 // → "Plain message"
+ * _U("no.key", "Not found");                 // → "Not found"
+ * ```
+ */
+declare function createTranslator(options: TranslatorOptions): TranslatorFn;
+/**
+ * Deep-merges multiple locale records into one.
+ * Later records override earlier ones on key conflicts.
+ * Nested objects are merged recursively, not replaced entirely.
+ *
+ * @example
+ * ```ts
+ * const base = { client: { greeting: "Hello %s!", level: "Level %d" } };
+ * const overrides = { client: { greeting: "Hey %s!" } };
+ *
+ * const merged = mergeLocales(base, overrides);
+ * // merged.client.greeting → "Hey %s!"
+ * // merged.client.level    → "Level %d" (preserved from base)
+ * ```
+ */
+declare function mergeLocales(...records: LocaleRecord[]): LocaleRecord;
+
+export { type FetchNuiFactoryOptions, type FetchNuiOptions, type FormatArg, type LocaleRecord, type NuiEventMap, type NuiMessageHandler, type NuiMessagePayload, type TranslatorFn, type TranslatorOptions, type UnsubscribeFn, createFetchNui, createTranslator, luaFormat, mergeLocales, onNuiMessage };

package/dist/index.js

@@ -0,0 +1,137 @@
+// src/client.ts
+function getResourceName() {
+  if (typeof window !== "undefined" && window.GetParentResourceName) {
+    return window.GetParentResourceName();
+  }
+  return "nui-frame-app";
+}
+function createFetchNui(factoryOptions) {
+  const debug = factoryOptions?.debug ?? false;
+  const mockData = factoryOptions?.mockData;
+  return async function fetchNui(event, data, options) {
+    if (debug) {
+      console.log(`[NUIX] \u2192 ${event}`, data ?? {});
+    }
+    if (mockData && event in mockData) {
+      const mock = mockData[event];
+      if (mock === void 0) {
+        throw new Error(`[NUIX] Mock data for "${event}" is undefined`);
+      }
+      const result = typeof mock === "function" ? mock(data) : mock;
+      if (debug) {
+        console.log(`[NUIX] \u2190 ${event} (mock)`, result);
+      }
+      return result;
+    }
+    const url = `https://${getResourceName()}/${event}`;
+    const controller = options?.timeout ? new AbortController() : void 0;
+    let timeoutId;
+    if (controller && options?.timeout) {
+      timeoutId = setTimeout(() => controller.abort(), options.timeout);
+    }
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json; charset=UTF-8" },
+        body: JSON.stringify(data ?? {}),
+        signal: controller?.signal
+      });
+      if (!response.ok) {
+        throw new Error(`[NUIX] fetchNui("${event}") failed with HTTP ${response.status}`);
+      }
+      const result = await response.json();
+      if (debug) {
+        console.log(`[NUIX] \u2190 ${event}`, result);
+      }
+      return result;
+    } catch (error) {
+      if (error instanceof DOMException && error.name === "AbortError") {
+        throw new Error(`[NUIX] fetchNui("${event}") timed out after ${options?.timeout}ms`);
+      }
+      throw error;
+    } finally {
+      if (timeoutId !== void 0) clearTimeout(timeoutId);
+    }
+  };
+}
+
+// src/listener.ts
+function onNuiMessage(action, handler) {
+  const listener = (event) => {
+    const payload = event.data;
+    if (!payload || typeof payload !== "object") return;
+    if (payload.action !== action) return;
+    handler(payload.data);
+  };
+  window.addEventListener("message", listener);
+  return () => {
+    window.removeEventListener("message", listener);
+  };
+}
+
+// src/utils.ts
+function luaFormat(template, ...args) {
+  let argIndex = 0;
+  return template.replace(/%([sdfi%])/g, (match, specifier) => {
+    if (specifier === "%") return "%";
+    const raw = args[argIndex++];
+    switch (specifier) {
+      case "s":
+        return String(raw ?? "");
+      case "d":
+      case "i": {
+        const num = Number(raw);
+        return String(Number.isNaN(num) ? 0 : Math.floor(num));
+      }
+      case "f": {
+        const num = Number(raw);
+        return String(Number.isNaN(num) ? 0 : num);
+      }
+      default:
+        return match;
+    }
+  });
+}
+function resolveKey(locales, key) {
+  const segments = key.split(".");
+  let current = locales;
+  for (const segment of segments) {
+    if (typeof current !== "object" || current === null) return void 0;
+    const next = current[segment];
+    if (next === void 0) return void 0;
+    current = next;
+  }
+  return typeof current === "string" ? current : void 0;
+}
+function createTranslator(options) {
+  const { locales } = options;
+  return (key, fallback, ...args) => {
+    const template = resolveKey(locales, key);
+    if (template === void 0) {
+      return fallback;
+    }
+    return args.length > 0 ? luaFormat(template, ...args) : template;
+  };
+}
+function mergeLocales(...records) {
+  const result = {};
+  for (const record of records) {
+    for (const [key, value] of Object.entries(record)) {
+      const existing = result[key];
+      if (typeof value === "object" && typeof existing === "object" && existing !== void 0) {
+        result[key] = mergeLocales(existing, value);
+      } else {
+        result[key] = value;
+      }
+    }
+  }
+  return result;
+}
+export {
+  createFetchNui,
+  createTranslator,
+  luaFormat,
+  mergeLocales,
+  onNuiMessage
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/listener.ts","../src/utils.ts"],"sourcesContent":["import type { NuiEventMap, FetchNuiOptions, FetchNuiFactoryOptions } from \"./types\";\r\n\r\n// ─── Resource Name ───\r\n\r\n/**\r\n * Grabs the resource name from FiveM's injected global.\r\n * Falls back to `\"nui-frame-app\"` when running outside the game (local dev, tests).\r\n */\r\nfunction getResourceName(): string {\r\n\tif (typeof window !== \"undefined\" && window.GetParentResourceName) {\r\n\t\treturn window.GetParentResourceName();\r\n\t}\r\n\treturn \"nui-frame-app\";\r\n}\r\n\r\n// ─── FetchNui Factory ───\r\n\r\n/**\r\n * Creates a fully typed `fetchNui` function tied to your event map.\r\n *\r\n * The returned function POSTs JSON to `https://<resourceName>/<event>`,\r\n * which maps 1:1 to `RegisterNUICallback` on the Lua side.\r\n *\r\n * Supports optional debug logging, mock data for local dev, and per-call timeout.\r\n *\r\n * @example\r\n * ```ts\r\n * interface MyEvents extends NuiEventMap {\r\n *   getPlayer: { request: { id: number }; response: { name: string } };\r\n *   notify:    { request: { msg: string }; response: void };\r\n * }\r\n *\r\n * // Production usage\r\n * const fetchNui = createFetchNui<MyEvents>();\r\n * const player = await fetchNui(\"getPlayer\", { id: 1 });\r\n * // player.name is typed as string\r\n *\r\n * // Local dev with mocks + debug\r\n * const fetchNui = createFetchNui<MyEvents>({\r\n *   debug: true,\r\n *   mockData: {\r\n *     getPlayer: { name: \"DevPlayer\" },\r\n *     notify: (req) => { console.log(\"Mock:\", req.msg); },\r\n *   },\r\n * });\r\n * ```\r\n *\r\n * Lua side:\r\n * ```lua\r\n * RegisterNUICallback(\"getPlayer\", function(data, cb)\r\n *     local player = GetPlayerData(data.id)\r\n *     cb({ name = player.name })\r\n * end)\r\n * ```\r\n */\r\nexport function createFetchNui<TMap extends NuiEventMap>(factoryOptions?: FetchNuiFactoryOptions<TMap>) {\r\n\tconst debug = factoryOptions?.debug ?? false;\r\n\tconst mockData = factoryOptions?.mockData;\r\n\r\n\treturn async function fetchNui<K extends keyof TMap & string>(\r\n\t\tevent: K,\r\n\t\tdata?: TMap[K][\"request\"],\r\n\t\toptions?: FetchNuiOptions,\r\n\t): Promise<TMap[K][\"response\"]> {\r\n\t\tif (debug) {\r\n\t\t\tconsole.log(`[NUIX] → ${event}`, data ?? {});\r\n\t\t}\r\n\r\n\t\t// ─── Mock Mode ───\r\n\r\n\t\tif (mockData && event in mockData) {\r\n\t\t\tconst mock = mockData[event];\r\n\r\n\t\t\tif (mock === undefined) {\r\n\t\t\t\tthrow new Error(`[NUIX] Mock data for \"${event}\" is undefined`);\r\n\t\t\t}\r\n\r\n\t\t\tconst result =\r\n\t\t\t\ttypeof mock === \"function\"\r\n\t\t\t\t\t? (mock as (req: TMap[K][\"request\"]) => TMap[K][\"response\"])(data as TMap[K][\"request\"])\r\n\t\t\t\t\t: mock;\r\n\r\n\t\t\tif (debug) {\r\n\t\t\t\tconsole.log(`[NUIX] ← ${event} (mock)`, result);\r\n\t\t\t}\r\n\r\n\t\t\treturn result as TMap[K][\"response\"];\r\n\t\t}\r\n\r\n\t\t// ─── Real Fetch ───\r\n\r\n\t\tconst url = `https://${getResourceName()}/${event}`;\r\n\r\n\t\tconst controller = options?.timeout ? new AbortController() : undefined;\r\n\t\tlet timeoutId: ReturnType<typeof setTimeout> | undefined;\r\n\r\n\t\tif (controller && options?.timeout) {\r\n\t\t\ttimeoutId = setTimeout(() => controller.abort(), options.timeout);\r\n\t\t}\r\n\r\n\t\ttry {\r\n\t\t\tconst response = await fetch(url, {\r\n\t\t\t\tmethod: \"POST\",\r\n\t\t\t\theaders: { \"Content-Type\": \"application/json; charset=UTF-8\" },\r\n\t\t\t\tbody: JSON.stringify(data ?? {}),\r\n\t\t\t\tsignal: controller?.signal,\r\n\t\t\t});\r\n\r\n\t\t\tif (!response.ok) {\r\n\t\t\t\tthrow new Error(`[NUIX] fetchNui(\"${event}\") failed with HTTP ${response.status}`);\r\n\t\t\t}\r\n\r\n\t\t\tconst result = (await response.json()) as TMap[K][\"response\"];\r\n\r\n\t\t\tif (debug) {\r\n\t\t\t\tconsole.log(`[NUIX] ← ${event}`, result);\r\n\t\t\t}\r\n\r\n\t\t\treturn result;\r\n\t\t} catch (error) {\r\n\t\t\tif (error instanceof DOMException && error.name === \"AbortError\") {\r\n\t\t\t\tthrow new Error(`[NUIX] fetchNui(\"${event}\") timed out after ${options?.timeout}ms`);\r\n\t\t\t}\r\n\t\t\tthrow error;\r\n\t\t} finally {\r\n\t\t\tif (timeoutId !== undefined) clearTimeout(timeoutId);\r\n\t\t}\r\n\t};\r\n}\r\n","import type { NuiEventMap, NuiMessagePayload, NuiMessageHandler, UnsubscribeFn } from \"./types\";\r\n\r\n// ─── NUI Message Listener ───\r\n\r\n/**\r\n * Listens for NUI messages from Lua (`SendNUIMessage`), filtered by action name.\r\n * Only messages matching the given `action` trigger the handler.\r\n * Returns a cleanup function to stop listening.\r\n *\r\n * @example\r\n * ```ts\r\n * interface MyMessages extends NuiEventMap {\r\n *   showMenu: { request: { items: string[] }; response: void };\r\n *   hideMenu: { request: void;               response: void };\r\n * }\r\n *\r\n * const unsub = onNuiMessage<MyMessages, \"showMenu\">(\"showMenu\", (data) => {\r\n *   console.log(data.items); // typed as string[]\r\n * });\r\n *\r\n * // Stop listening when done\r\n * unsub();\r\n * ```\r\n *\r\n * Lua side:\r\n * ```lua\r\n * SendNUIMessage({ action = \"showMenu\", data = { items = {\"Pistol\", \"Rifle\"} } })\r\n * ```\r\n */\r\nexport function onNuiMessage<TMap extends NuiEventMap, K extends keyof TMap & string>(\r\n\taction: K,\r\n\thandler: NuiMessageHandler<TMap[K][\"request\"]>,\r\n): UnsubscribeFn {\r\n\tconst listener = (event: MessageEvent<NuiMessagePayload<TMap[K][\"request\"]>>) => {\r\n\t\tconst payload = event.data;\r\n\r\n\t\tif (!payload || typeof payload !== \"object\") return;\r\n\t\tif (payload.action !== action) return;\r\n\r\n\t\thandler(payload.data);\r\n\t};\r\n\r\n\twindow.addEventListener(\"message\", listener);\r\n\r\n\treturn () => {\r\n\t\twindow.removeEventListener(\"message\", listener);\r\n\t};\r\n}\r\n","import type { FormatArg, LocaleRecord, TranslatorFn, TranslatorOptions } from \"./types\";\r\n\r\n// ─── Lua-Style Formatter ───\r\n\r\n/**\r\n * Formats a string using Lua-style placeholders.\r\n *\r\n * Specifiers:\r\n * - `%s` — string (null/undefined becomes empty string)\r\n * - `%d` — integer (floors the value, NaN becomes 0)\r\n * - `%f` — float (NaN becomes 0)\r\n * - `%%` — literal percent sign\r\n *\r\n * @example\r\n * ```ts\r\n * luaFormat(\"Hello %s, you are level %d\", \"Laot\", 42);\r\n * // → \"Hello Laot, you are level 42\"\r\n *\r\n * luaFormat(\"Accuracy: %f%%\", 99.5);\r\n * // → \"Accuracy: 99.5%\"\r\n *\r\n * luaFormat(\"Safe: %s %d\", undefined, NaN);\r\n * // → \"Safe:  0\"\r\n * ```\r\n */\r\nexport function luaFormat(template: string, ...args: FormatArg[]): string {\r\n\tlet argIndex = 0;\r\n\r\n\treturn template.replace(/%([sdfi%])/g, (match, specifier: string) => {\r\n\t\tif (specifier === \"%\") return \"%\";\r\n\r\n\t\tconst raw = args[argIndex++];\r\n\r\n\t\tswitch (specifier) {\r\n\t\t\tcase \"s\":\r\n\t\t\t\treturn String(raw ?? \"\");\r\n\r\n\t\t\tcase \"d\":\r\n\t\t\tcase \"i\": {\r\n\t\t\t\tconst num = Number(raw);\r\n\t\t\t\treturn String(Number.isNaN(num) ? 0 : Math.floor(num));\r\n\t\t\t}\r\n\r\n\t\t\tcase \"f\": {\r\n\t\t\t\tconst num = Number(raw);\r\n\t\t\t\treturn String(Number.isNaN(num) ? 0 : num);\r\n\t\t\t}\r\n\r\n\t\t\tdefault:\r\n\t\t\t\treturn match;\r\n\t\t}\r\n\t});\r\n}\r\n\r\n// ─── Dot-Notation Resolver ───\r\n\r\n/**\r\n * Walks a nested locale object by splitting the key on `.`\r\n * Returns the string value at the end of the path, or `undefined` if any segment is missing.\r\n *\r\n * `\"client.greeting\"` → looks up `locales.client.greeting`\r\n * `\"flat_key\"` → looks up `locales.flat_key` directly\r\n */\r\nfunction resolveKey(locales: LocaleRecord, key: string): string | undefined {\r\n\tconst segments = key.split(\".\");\r\n\tlet current: LocaleRecord | string = locales;\r\n\r\n\tfor (const segment of segments) {\r\n\t\tif (typeof current !== \"object\" || current === null) return undefined;\r\n\t\tconst next: string | LocaleRecord | undefined = current[segment];\r\n\t\tif (next === undefined) return undefined;\r\n\t\tcurrent = next;\r\n\t}\r\n\r\n\treturn typeof current === \"string\" ? current : undefined;\r\n}\r\n\r\n// ─── Translator Factory ───\r\n\r\n/**\r\n * Creates a `_U(key, fallback, ...args)` translator bound to a locale record.\r\n *\r\n * The key supports dot-notation to traverse nested locale objects.\r\n * If the key isn't found, the fallback string is returned as-is.\r\n * Any extra args are passed through `luaFormat` for placeholder substitution.\r\n *\r\n * @example\r\n * ```ts\r\n * const _U = createTranslator({\r\n *   locales: {\r\n *     client: {\r\n *       greeting: \"Hello %s!\",\r\n *       level: \"Level %d\",\r\n *     },\r\n *     server: {\r\n *       error: \"Error: %s\",\r\n *     },\r\n *     flat_key: \"Plain message\",\r\n *   },\r\n * });\r\n *\r\n * _U(\"client.greeting\", \"MISSING\", \"Laot\");  // → \"Hello Laot!\"\r\n * _U(\"client.level\", \"MISSING\", 42);         // → \"Level 42\"\r\n * _U(\"flat_key\", \"MISSING\");                 // → \"Plain message\"\r\n * _U(\"no.key\", \"Not found\");                 // → \"Not found\"\r\n * ```\r\n */\r\nexport function createTranslator(options: TranslatorOptions): TranslatorFn {\r\n\tconst { locales } = options;\r\n\r\n\treturn (key: string, fallback: string, ...args: FormatArg[]): string => {\r\n\t\tconst template = resolveKey(locales, key);\r\n\r\n\t\tif (template === undefined) {\r\n\t\t\treturn fallback;\r\n\t\t}\r\n\r\n\t\treturn args.length > 0 ? luaFormat(template, ...args) : template;\r\n\t};\r\n}\r\n\r\n// ─── Deep Merge ───\r\n\r\n/**\r\n * Deep-merges multiple locale records into one.\r\n * Later records override earlier ones on key conflicts.\r\n * Nested objects are merged recursively, not replaced entirely.\r\n *\r\n * @example\r\n * ```ts\r\n * const base = { client: { greeting: \"Hello %s!\", level: \"Level %d\" } };\r\n * const overrides = { client: { greeting: \"Hey %s!\" } };\r\n *\r\n * const merged = mergeLocales(base, overrides);\r\n * // merged.client.greeting → \"Hey %s!\"\r\n * // merged.client.level    → \"Level %d\" (preserved from base)\r\n * ```\r\n */\r\nexport function mergeLocales(...records: LocaleRecord[]): LocaleRecord {\r\n\tconst result: LocaleRecord = {};\r\n\r\n\tfor (const record of records) {\r\n\t\tfor (const [key, value] of Object.entries(record)) {\r\n\t\t\tconst existing = result[key];\r\n\r\n\t\t\tif (typeof value === \"object\" && typeof existing === \"object\" && existing !== undefined) {\r\n\t\t\t\tresult[key] = mergeLocales(existing, value);\r\n\t\t\t} else {\r\n\t\t\t\tresult[key] = value;\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n\r\n\treturn result;\r\n}\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,49 @@
+{
+	"name": "@laot/nuix",
+	"version": "1.0.0",
+	"description": "Modular, type-safe TypeScript library for FiveM NUI projects",
+	"type": "module",
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.js"
+			},
+			"require": {
+				"types": "./dist/index.d.cts",
+				"default": "./dist/index.cjs"
+			}
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "tsup",
+		"typecheck": "tsc --noEmit"
+	},
+	"keywords": [
+		"fivem",
+		"nui",
+		"typescript",
+		"cfx",
+		"citizenfx"
+	],
+	"author": "laot",
+	"homepage": "https://github.com/laot7490/nuix#readme",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/laot7490/nuix.git"
+	},
+	"bugs": {
+		"url": "https://github.com/laot7490/nuix/issues"
+	},
+	"license": "MIT",
+	"devDependencies": {
+		"tsup": "^8.4.0",
+		"typescript": "^5.7.3"
+	}
+}