ensure 9labs_hiab

add_ace group.admin hiab.admin allow

apps = {
    ['lb-phone'] = true, ['lb-tablet'] = true,
    ['qs-smartphone-pro'] = true, ['qs-smartphone'] = true,
    ['yseries'] = true, ['yphone'] = true, ['yflip-phone'] = true,
    ['okokPhone'] = true, ['gksphone'] = true, ['gks-tablet'] = true,
    ['meteo-jobtablet'] = true,
},

{
  "name": "HIAB Recovery",
  "light_icon": "https://cfx-nui-9labs_hiab/web/dist/app-icon.png",
  "dark_icon": "https://cfx-nui-9labs_hiab/web/dist/app-icon.png",
  "default": true,
  "category": "business",
  "custom_app_id": "9labs_hiab",
  "redirect": "custom_app",
  "url": "https://cfx-nui-9labs_hiab/web/dist/index.html?app=phone"
}

https://cfx-nui-9labs_hiab/web/dist/index.html?app=phone
https://cfx-nui-9labs_hiab/web/dist/index.html?app=tablet

advanced = {
    autoDispatch = false,      -- no call until the player asks for one
    requestCommand = 'hiabcall',
    jobHud = false,            -- optional: no on-screen job panel, the job lives on the phone
},

local function text(shift)
    if not shift then return 'Off shift' end
    local m = shift.mission
    if not m then return shift.manual and 'Ready, request a call' or ('Next call in %ss'):format(shift.next or 0) end
    if m.stage == 'travel' then return ('Go to the %s'):format(m.label or m.model) end
    if m.stage == 'load' then return ('Load the %s'):format(m.label or m.model) end
    return ('Deliver to %s'):format(m.dropLabel or 'the drop-off')
end

AddEventHandler('9labs_hiab:stateChanged', function(src, shift)
    exports['your_phone']:SendNotification(src, { app = 'HIAB', title = 'Towing', text = text(shift) })
end)

AddEventHandler('9labs_hiab:jobPaid', function(src, data)
    exports['your_phone']:SendNotification(src, { app = 'HIAB', title = 'Paid', text = ('$%d'):format(data.total) })
end)

-- a code or button in your phone app asks for a call
RegisterNetEvent('your_phone:towing:request', function()
    local r = exports['9labs_hiab']:RequestMission(source)
    if not r.ok then exports['your_phone']:SendNotification(source, { app = 'HIAB', title = 'Towing', text = r.message }) end
end)

function Custom.identity(src) return GetPlayerIdentifierByType(src, 'license') end -- stable character id
function Custom.name(src) return GetPlayerName(src) end
function Custom.addMoney(src, account, amount, reason) return false end          -- return true on success
function Custom.removeMoney(src, account, amount, reason) return false end
function Custom.getMoney(src, account) return 0 end
function Custom.hasJob(src, job, grade) return true end                          -- only used when a job is set
function Custom.giveKeys(src, vehicle, plate) end
function Custom.removeKeys(src, vehicle, plate) end

function Custom.showPrompt(text, key) end
function Custom.hidePrompt() end
function Custom.notify(text, kind) end                 -- kind: 'info', 'success', 'error'
function Custom.addTarget(id, coords, radius, options) return nil end -- options: { { label, icon, onSelect } }, return a handle
function Custom.removeTarget(handle) end
function Custom.setFuel(vehicle, level) end            -- used when fuel = 'custom'
function Custom.lockInventory(locked) end              -- used when lockInventory = 'custom'

-- true when the player is on a HIAB shift
local onDuty = exports['9labs_hiab']:IsOnDuty(source)

-- level and statistics of the player's current character, or nil
local p = exports['9labs_hiab']:GetProfile(source)
-- p.level, p.xp, p.levelXp, p.nextXp, p.maxLevel, p.jobs, p.earned, p.best, p.km, p.rating, p.name

-- the player's shift and current call, or false when off shift
local shift = exports['9labs_hiab']:GetShiftState(source)
-- shift.truck (net id), shift.deposit, shift.next (seconds until the next call, automatic mode only)
-- shift.manual = true and shift.ready (seconds until a call can be requested) with advanced.autoDispatch = false
-- shift.mission = { id, kind, stage ('travel' | 'load' | 'deliver'),
--   label, model, vehicle (net id of the customer's car), npc (net id of the customer),
--   npcName, price, km, dropLabel, spot, drop, deadline (unix time), limit (seconds) }

-- start or end a shift from your own script
local r = exports['9labs_hiab']:StartShift(source)        -- same rules as the foreman: only at the yard
local r = exports['9labs_hiab']:StartShift(source, { spawn = vector4(x, y, z, h) })
-- with an options table the yard distance is not checked; spawn is optional (default: a free truck bay)
-- job, deposit and keys work as usual. Returns { ok, truck (net id) } or { ok = false, error }

local r = exports['9labs_hiab']:EndShift(source)          -- { ok, summary }, or { ok = false, confirm = true, error } when the truck is not back
local r = exports['9labs_hiab']:EndShift(source, true)    -- end it anyway; the deposit is kept when the truck is not back
local r = exports['9labs_hiab']:EndShift(source, { force = true })   -- same as passing true
local r = exports['9labs_hiab']:EndShift(source, { refund = true })  -- your script decides the deposit refund
-- a truck that is back but still carries a car returns { ok = false, error } (no confirm): unload it first
local r = exports['9labs_hiab']:AbandonMission(source)    -- { ok }

-- hand out a call now (for advanced.autoDispatch = false, works in both modes)
local r = exports['9labs_hiab']:RequestMission(source)
-- { ok = true, mission } or { ok = false, reason, message, seconds }
-- reason: 'off_duty' | 'busy' | 'cooldown' (seconds left) | 'too_fast' (2 s between requests) | 'no_calls'
-- message is the localized text; the player is not notified, show it the way your script wants

-- current crane state of a truck by network id, or nil
local state = exports['9labs_hiab']:GetCraneState(netId)
-- state.pose (yaw, rotate, boom, jib, extension, legs, rigging, drop)
-- state.mode ('empty' | 'lifted' | 'secured'), state.load, state.operator

-- server side, e.g. when your own NPC hands out the truck
local r = exports['9labs_hiab']:StartShift(source, { spawn = vector4(471.0, -1305.0, 29.2, 115.0) })
if not r.ok then print(r.error) end

-- when your NPC takes the truck back
exports['9labs_hiab']:EndShift(source, { refund = true })

exports['9labs_hiab']:DeployStabilizers(truck)
exports['9labs_hiab']:StowCrane(truck)
exports['9labs_hiab']:AttachNearbyVehicle(truck)
exports['9labs_hiab']:LoadToBed(truck)
exports['9labs_hiab']:ReleaseLoad(truck)
local pose = exports['9labs_hiab']:GetCranePose(truck)

local shift = exports['9labs_hiab']:GetShiftState()       -- same shape as the server export
exports['9labs_hiab']:SetMissionWaypoint()                 -- GPS to the pickup or drop-off of the current call
exports['9labs_hiab']:SetMissionWaypoint('depot')          -- GPS to the yard
local r = exports['9labs_hiab']:RequestMission()           -- asks for a call for this player; the result message is shown as a notification

AddEventHandler('9labs_hiab:client:stateChanged', function(shift) end)

AddEventHandler('9labs_hiab:shiftStarted', function(src, data)
    -- data.truck (net id), data.plate, data.deposit, data.account
end)

AddEventHandler('9labs_hiab:shiftEnded', function(src, data)
    -- data.reason: 'returned' | 'away' | 'truck_lost' | 'dropped' | 'character'
    -- data.jobs, data.earned, data.deposit, data.refunded (boolean)
end)

AddEventHandler('9labs_hiab:jobPaid', function(src, data)
    -- data.kind: 'breakdown' | 'accident' | 'parking' | 'repossession'
    -- data.pay, data.tip, data.total, data.paid (boolean), data.account
    -- data.stars, data.xp, data.leveled, data.km, data.late, data.damaged
end)

AddEventHandler('9labs_hiab:stateChanged', function(src, shift)
    -- every shift or call change; shift has the same shape as GetShiftState (false = off shift)
end)

AddEventHandler('9lh:craneEvent', function(truckNet, event, vehicleNet, at)
    -- event: 'deploy' | 'stow' | 'hooked' | 'secured' | 'unsecured' | 'released'
    -- at: world position where the car was set down ('released' only)
end)

AddEventHandler('9labs_hiab:jobPaid', function(src, data)
    if data.paid then
        exports['your_banking']:AddSocietyMoney('tow', math.floor(data.total * .1))
    end
end)

9labs_hiab:rpc:q
9lh:*