feat: semaphore based state syncing

client.lua

@@ -0,0 +1,41 @@
+local config = require 'config.client'
+
+---@type table<string, integer>
+local states = {}
+
+---Sets a boolean state. Runs its onSet function if the state is not previously set and the onSet function exists in config
+---@param name string
+---@return boolean firstSetter true if the state had not previously been set
+local function setState(name)
+    if not states[name] then
+        if config.states[name]?.onSet then
+            config.states[name].onSet()
+        end
+        states[name] = 1
+        return true
+    else
+        states[name] += 1
+        return false
+    end
+end
+
+---Releases a boolean state. Runs its onRelease function if this is the last call to release the state and the release function exists in config.
+---@param name string
+---@param force? boolean if true, releases the state regardless of the number of locks on it
+---@return boolean lastReleaser true if the state is fully released after this function
+local function releaseState(name, force)
+    if not states[name] then return false end
+    if states[name] <= 1 or force then
+        states[name] = nil
+        if config.states[name]?.onRelease() then
+            config.states[name].onRelease()
+        end
+        return true
+    else
+        states[name] -= 1
+        return false
+    end
+end
+
+exports('SetState', setState)
+exports('ReleaseState', releaseState)

config/client.lua

@@ -0,0 +1,4 @@
+return {
+    ---@type table<string, State>
+    states = {}
+}

fxmanifest.lua

@@ -0,0 +1,18 @@
+fx_version 'cerulean'
+game 'gta5'
+
+name 'qbx_playerstates'
+description 'Manage the state of the player'
+repository 'https://github.com/Qbox-project/qbx_playerstates'
+version '0.0.0'
+
+client_scripts {
+    'client.lua',
+}
+
+files {
+    'config/client.lua',
+}
+
+lua54 'yes'
+use_experimental_fxv2_oal 'yes'

types.lua

@@ -0,0 +1,5 @@
+---@meta
+
+---@class State
+---@field onSet? function
+---@field onRelease? function