@nativewrappers/common 0.0.77 → 0.0.81

package/Command.js

@@ -0,0 +1,111 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const commands = [];
+$SERVER: {
+  on("playerJoining", () => emitNet("chat:addSuggestions", source, commands));
+}
+function registerCommand(name, commandHandler, restricted) {
+  if (Array.isArray(name)) {
+    for (const command of name) {
+      registerCommand(command, commandHandler, restricted);
+    }
+    return;
+  }
+  RegisterCommand(name, commandHandler, !!restricted);
+  $SERVER: {
+    const ace = `command.${name}`;
+    if (typeof restricted === "string") {
+      if (IsPrincipalAceAllowed(restricted, ace)) return;
+      return ExecuteCommand(`add_ace ${restricted} ${ace} allow`);
+    }
+    if (Array.isArray(restricted)) {
+      for (const principal of restricted) {
+        if (!IsPrincipalAceAllowed(principal, ace)) ExecuteCommand(`add_ace ${restricted} ${ace} allow`);
+      }
+    }
+  }
+}
+__name(registerCommand, "registerCommand");
+class Command {
+  constructor(name, help, handler, params, restricted = true) {
+    this.name = name;
+    this.help = help;
+    this.params = params;
+    this.#handler = handler;
+    this.name = `/${name}`;
+    registerCommand(name, (source2, args, raw) => this.call(source2, args, raw), restricted);
+    if (params) {
+      for (const parameter of params) {
+        if (parameter.type) {
+          parameter.help = parameter.help ? `${parameter.help} (type: ${parameter.type})` : `(type: ${parameter.type})`;
+        }
+      }
+      setTimeout(() => {
+        $SERVER: {
+          commands.push(this);
+          emitNet("chat:addSuggestions", -1, this);
+        }
+        $CLIENT: {
+          emit("chat:addSuggestion", this);
+        }
+      }, 100);
+    }
+  }
+  static {
+    __name(this, "Command");
+  }
+  #handler;
+  mapArguments(source2, args, raw) {
+    const mapped = {
+      source: source2,
+      raw
+    };
+    if (!this.params) return mapped;
+    const result = this.params.every((param, index) => {
+      const arg = args[index];
+      let value = arg;
+      switch (param.type) {
+        case "number":
+          value = +arg;
+          break;
+        case "string":
+          value = !Number(arg) ? arg : false;
+          break;
+        case "playerId":
+          $SERVER: {
+            value = arg === "me" ? source2 : +arg;
+            if (!value || !DoesPlayerExist(value.toString())) value = void 0;
+          }
+          $CLIENT: {
+            value = arg === "me" ? GetPlayerServerId(PlayerId()) : +arg;
+            if (!value || GetPlayerFromServerId(value) === -1) value = void 0;
+          }
+          break;
+        case "longString":
+          value = raw.substring(raw.indexOf(arg));
+          break;
+      }
+      if (value === void 0 && (!param.optional || param.optional && arg)) {
+        return Citizen.trace(
+          `^1command '${raw.split(" ")[0] || raw}' received an invalid ${param.type} for argument ${index + 1} (${param.name}), received '${arg}'^0`
+        );
+      }
+      mapped[param.name] = value;
+      return true;
+    });
+    return result ? mapped : null;
+  }
+  async call(source2, args, raw = args.join(" ")) {
+    const parsed = this.mapArguments(source2, args, raw);
+    if (!parsed) return;
+    try {
+      await this.#handler(parsed);
+    } catch (err) {
+      Citizen.trace(`^1command '${raw.split(" ")[0] || raw}' failed to execute!^0
+${err.message}`);
+    }
+  }
+}
+export {
+  Command
+};

package/Convar.js

@@ -0,0 +1,58 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { GlobalData } from "./GlobalData";
+class Convar {
+  static {
+    __name(this, "Convar");
+  }
+  /**
+   * @returns the current console buffer
+   */
+  buffer() {
+    $CLIENT: {
+      if (GlobalData.IS_CLIENT) {
+        throw new Error("This function isn't available on the client");
+      }
+    }
+    return GetConsoleBuffer();
+  }
+  get(variable, defaultVar) {
+    return GetConvar(variable, defaultVar);
+  }
+  getInt(variable, defaultVar) {
+    return GetConvarInt(variable, defaultVar);
+  }
+  getFloat(varName, defaultVar) {
+    return GetConvarFloat(varName, defaultVar);
+  }
+  getBool(varName, defaultVar) {
+    return GetConvarBool(varName, defaultVar);
+  }
+  set(variable, value) {
+    $CLIENT: {
+      if (GlobalData.IS_CLIENT) {
+        throw new Error("This function isn't available on the client");
+      }
+    }
+    SetConvar(variable, value);
+  }
+  setReplicated(variable, value) {
+    $CLIENT: {
+      if (GlobalData.IS_CLIENT) {
+        throw new Error("This function isn't available on the client");
+      }
+    }
+    SetConvarReplicated(variable, value);
+  }
+  setServerInfo(variable, value) {
+    $CLIENT: {
+      if (GlobalData.IS_CLIENT) {
+        throw new Error("This function isn't available on the client");
+      }
+    }
+    SetConvarServerInfo(variable, value);
+  }
+}
+export {
+  Convar
+};

package/GlobalData.js

@@ -0,0 +1,16 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class GlobalData {
+  static {
+    __name(this, "GlobalData");
+  }
+  static CurrentResource = GetCurrentResourceName();
+  static IS_SERVER = IsDuplicityVersion();
+  static IS_CLIENT = !GlobalData.IS_SERVER;
+  static NetworkTick = null;
+  static NetworkedTicks = [];
+  static EnablePrettyPrint = true;
+}
+export {
+  GlobalData
+};

package/Kvp.js

@@ -0,0 +1,137 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class Kvp {
+  static {
+    __name(this, "Kvp");
+  }
+  /**
+   * Returns the value associated with a key as a number.
+   */
+  getNumber(key) {
+    return GetResourceKvpInt(key);
+  }
+  /**
+   * Returns the value associated with a key as a float.
+   */
+  getFloat(key) {
+    return GetResourceKvpFloat(key);
+  }
+  /**
+   * Returns the value associated with a key as a string.
+   */
+  getString(key) {
+    return GetResourceKvpString(key);
+  }
+  /**
+   * Returns the value associated with a key as a parsed JSON string.
+   */
+  getJson(key) {
+    const str = GetResourceKvpString(key);
+    return str ? JSON.parse(str) : null;
+  }
+  /**
+   * Sets the value associated with a key as a number.
+   * @param async set the value using an async operation.
+   */
+  setNumber(key, value, async = false) {
+    return async ? SetResourceKvpIntNoSync(key, value) : SetResourceKvpInt(key, value);
+  }
+  /**
+   * Sets the value associated with a key as a float.
+   * @param async set the value using an async operation.
+   */
+  setFloat(key, value, async = false) {
+    return async ? SetResourceKvpFloatNoSync(key, value) : SetResourceKvpFloat(key, value);
+  }
+  /**
+   * Sets the value associated with a key as a string.
+   * @param async set the value using an async operation.
+   */
+  setString(key, value, async = false) {
+    return async ? SetResourceKvpNoSync(key, value) : SetResourceKvp(key, value);
+  }
+  /**
+   * Sets the value associated with a key as a JSON string.
+   * @param async set the value using an async operation.
+   */
+  setJson(key, value, async = false) {
+    const str = JSON.stringify(value);
+    return async ? SetResourceKvpNoSync(key, str) : SetResourceKvp(key, str);
+  }
+  /**
+   * Sets the value associated with a key as a JSON string.
+   * @param async set the value using an async operation.
+   */
+  set(key, value, async = false) {
+    switch (typeof value) {
+      case "function":
+      case "symbol":
+        throw new Error(`Failed to set Kvp for invalid type '${typeof value}'`);
+      case "undefined":
+        return this.delete(key, async);
+      case "object":
+        return this.setJson(key, value, async);
+      case "boolean":
+        value = value ? 1 : 0;
+      case "number":
+        return Number.isInteger(value) ? this.setNumber(key, value, async) : this.setFloat(key, value, async);
+      default:
+        value = String(value);
+        return this.setString(key, value, async);
+    }
+  }
+  /**
+   * Deletes the specified value for key.
+   * @param async remove the value using an async operation
+   */
+  delete(key, async = false) {
+    return async ? DeleteResourceKvpNoSync(key) : DeleteResourceKvp(key);
+  }
+  /**
+   * Commits pending asynchronous operations to disk, ensuring data consistency.
+   *
+   * Should be called after calling set methods using the async flag.
+   */
+  flush() {
+    FlushResourceKvp();
+  }
+  getAllKeys(prefix) {
+    const keys = [];
+    const handle = StartFindKvp(prefix);
+    if (handle === -1) return keys;
+    let key;
+    do {
+      key = FindKvp(handle);
+      if (key) keys.push(key);
+    } while (key);
+    EndFindKvp(handle);
+    return keys;
+  }
+  /**
+   * Returns an array of keys which match or contain the given keys.
+   */
+  getKeys(prefix) {
+    return typeof prefix === "string" ? this.getAllKeys(prefix) : prefix.flatMap((key) => this.getAllKeys(key));
+  }
+  /**
+   * Get all values from keys in an array as the specified type.
+   */
+  getValuesAsType(prefix, type) {
+    const values = this.getKeys(prefix);
+    return values.map((key) => {
+      switch (type) {
+        case "number":
+          return this.getNumber(key);
+        case "float":
+          return this.getFloat(key);
+        case "string":
+          return this.getString(key);
+        default:
+          return this.getJson(key);
+      }
+    });
+  }
+}
+export {
+  Kvp
+};

package/Resource.js

@@ -0,0 +1,54 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { GlobalData } from "./GlobalData";
+class Resource {
+  constructor(name) {
+    this.name = name;
+  }
+  static {
+    __name(this, "Resource");
+  }
+  getMetadata(metadataKey, index) {
+    return GetResourceMetadata(this.name, metadataKey, index);
+  }
+  getPath() {
+    return GetResourcePath(this.name);
+  }
+  loadFile(fileName) {
+    return LoadResourceFile(this.name, fileName);
+  }
+  saveFile(fileName, data, length) {
+    $CLIENT: {
+      if (GlobalData.IS_CLIENT) {
+        throw new Error("This function isn't available on the client");
+      }
+    }
+    return SaveResourceFile(this.name, fileName, data, length);
+  }
+  scheduleTick() {
+    $CLIENT: {
+      if (GlobalData.IS_CLIENT) {
+        throw new Error("This function isn't available on the client");
+      }
+    }
+    return ScheduleResourceTick(this.name);
+  }
+  start() {
+    StartResource(this.name);
+  }
+  stop() {
+    StopResource(this.name);
+  }
+  static startResource(name) {
+    StartResource(name);
+  }
+  static stopResource(name) {
+    StopResource(name);
+  }
+  static resourceCount() {
+    return GetNumResources();
+  }
+}
+export {
+  Resource
+};

package/decors/Events.js

@@ -0,0 +1,170 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { GlobalData } from "../GlobalData";
+var ConVarType = /* @__PURE__ */ ((ConVarType2) => {
+  ConVarType2[ConVarType2["String"] = 0] = "String";
+  ConVarType2[ConVarType2["Integer"] = 1] = "Integer";
+  ConVarType2[ConVarType2["Float"] = 2] = "Float";
+  ConVarType2[ConVarType2["Boolean"] = 3] = "Boolean";
+  return ConVarType2;
+})(ConVarType || {});
+const DisablePrettyPrint = /* @__PURE__ */ __name(() => GlobalData.EnablePrettyPrint = false, "DisablePrettyPrint");
+function Exports(exportName) {
+  return /* @__PURE__ */ __name(function actualDecorator(originalMethod, context) {
+    if (context.private) {
+      throw new Error("Exports does not work on private methods, please mark the method as public");
+    }
+    context.addInitializer(function() {
+      exports(exportName, (...args) => {
+        return originalMethod.call(this, ...args);
+      });
+    });
+  }, "actualDecorator");
+}
+__name(Exports, "Exports");
+function Event(eventName) {
+  return /* @__PURE__ */ __name(function actualDecorator(originalMethod, context) {
+    if (context.private) {
+      throw new Error("Event does not work on private methods, please mark the method as public");
+    }
+    context.addInitializer(function() {
+      on(eventName, (...args) => {
+        try {
+          return originalMethod.call(this, ...args);
+        } catch (e) {
+          REMOVE_EVENT_LOG: {
+            if (!GlobalData.EnablePrettyPrint) return;
+            console.error("------- EVENT ERROR --------");
+            console.error(`Call to ${eventName} errored`);
+            console.error(`Data: ${JSON.stringify(args)}`);
+            console.error(`Error: ${e}`);
+            console.error("------- END EVENT ERROR --------");
+          }
+        }
+      });
+    });
+  }, "actualDecorator");
+}
+__name(Event, "Event");
+function NetEvent(eventName, remoteOnly = true) {
+  return /* @__PURE__ */ __name(function actualDecorator(originalMethod, context) {
+    if (context.private) {
+      throw new Error("NetEvent does not work on private methods, please mark the method as public");
+    }
+    context.addInitializer(function() {
+      onNet(eventName, (...args) => {
+        const src = source;
+        try {
+          $CLIENT: {
+            if (GlobalData.IS_CLIENT && remoteOnly && source !== 65535) {
+              return;
+            }
+          }
+          return originalMethod.call(this, ...args);
+        } catch (e) {
+          REMOVE_NET_EVENT_LOG: {
+            if (!GlobalData.EnablePrettyPrint) return;
+            console.error("------- NET EVENT ERROR --------");
+            console.error(`Call to ${eventName} errored`);
+            console.error(`Caller: ${src}`);
+            console.error(`Data: ${JSON.stringify(args)}`);
+            console.error(`Error: ${e}`);
+            console.error("------- END NET EVENT ERROR --------");
+          }
+        }
+      });
+    });
+  }, "actualDecorator");
+}
+__name(NetEvent, "NetEvent");
+function NuiEvent(eventName) {
+  return /* @__PURE__ */ __name(function actualDecorator(originalMethod, context) {
+    if (context.private) {
+      throw new Error("NuiEvent does not work on private methods, please mark the method as public");
+    }
+    context.addInitializer(function() {
+      RegisterNuiCallback(eventName, (...args) => {
+        return originalMethod.call(this, ...args);
+      });
+    });
+  }, "actualDecorator");
+}
+__name(NuiEvent, "NuiEvent");
+const get_convar_fn = /* @__PURE__ */ __name((con_var_type) => {
+  switch (con_var_type) {
+    case 0 /* String */:
+      return GetConvar;
+    case 1 /* Integer */:
+      return GetConvarInt;
+    case 2 /* Float */:
+      return GetConvarFloat;
+    case 3 /* Boolean */:
+      return GetConvarBool;
+    // needed so typescript wont complain about "unreachable code" for the error below
+    default:
+  }
+  throw new Error("Got invalid ConVarType");
+}, "get_convar_fn");
+function ConVar(name, is_floating_point, deserialize) {
+  return /* @__PURE__ */ __name(function actualDecorator(_initialValue, context, ..._args) {
+    if (context.private) {
+      throw new Error("ConVar does not work on private types, please mark the field as public");
+    }
+    context.addInitializer(function() {
+      const t = this;
+      const default_value = Reflect.get(t, context.name);
+      const default_type = typeof default_value;
+      let con_var_type = null;
+      if (default_type === "number") {
+        if (is_floating_point || !Number.isInteger(default_value)) {
+          con_var_type = 2 /* Float */;
+        } else {
+          con_var_type = 1 /* Integer */;
+        }
+      } else if (default_type === "boolean") {
+        con_var_type = 3 /* Boolean */;
+      } else if (default_value === "string") {
+        con_var_type = 0 /* String */;
+      }
+      if (!deserialize && con_var_type === null) {
+        throw new Error("You should provide a deserialize function if you want to convert this to an object type");
+      }
+      if (con_var_type === null) {
+        con_var_type = 0 /* String */;
+      }
+      const con_var_fn = get_convar_fn(con_var_type);
+      const get_convar_value = /* @__PURE__ */ __name(() => {
+        const data = con_var_fn(name, default_value);
+        return deserialize ? deserialize(data) : data;
+      }, "get_convar_value");
+      Reflect.set(t, context.name, get_convar_value());
+      AddConvarChangeListener(name, () => {
+        Reflect.set(t, context.name, get_convar_value());
+      });
+    });
+  }, "actualDecorator");
+}
+__name(ConVar, "ConVar");
+function SetTick() {
+  return /* @__PURE__ */ __name(function actualDecorator(originalMethod, context) {
+    if (context.private) {
+      throw new Error("SetTick does not work on private types, please mark the field as public");
+    }
+    context.addInitializer(function() {
+      setTick(async () => {
+        await originalMethod.call(this);
+      });
+    });
+  }, "actualDecorator");
+}
+__name(SetTick, "SetTick");
+export {
+  ConVar,
+  ConVarType,
+  DisablePrettyPrint,
+  Event,
+  Exports,
+  NetEvent,
+  NuiEvent,
+  SetTick
+};