# Server Exports

## 0R SmartTab — All Exports Reference

Complete reference for every export available in **0r-smarttab**, organized by side and category.

```lua
-- Usage from any other resource
exports['0r-smarttab']:ExportName(...)
```

***

### Table of Contents

**Server-Side Exports**

| #  | Export                      | Category       |
| -- | --------------------------- | -------------- |
| 1  | IsPlayerTabletOpen          | Tablet State   |
| 2  | GetPlayerByTabletSerial     | Tablet State   |
| 3  | IsAppEnabled                | App Management |
| 4  | GetAppJobRequirements       | App Management |
| 5  | SendNotification            | Notifications  |
| 6  | SetAppBadge                 | Notifications  |
| 7  | GetPlayerInvoiceList        | Billing        |
| 8  | GetPlayerInvoiceCount       | Billing        |
| 9  | GetPlayerUnpaidInvoiceCount | Billing        |
| 10 | GetPlayerTotalDebt          | Billing        |
| 11 | CheckUnpaidBills            | Billing        |
| 12 | CreateInvoice               | Billing        |
| 13 | IsPlayerOnDuty              | MDT / Police   |
| 14 | CheckHasWarrant             | MDT / Police   |
| 15 | SendJail                    | Prison         |

**Client-Side Exports**

| #  | Export                      | Category       |
| -- | --------------------------- | -------------- |
| 16 | IsTabletOpen                | Tablet State   |
| 17 | OpenTabletWithApp           | Tablet Control |
| 18 | SendNotification            | Notifications  |
| 19 | SetAppBadge                 | Notifications  |
| 20 | GetPlayerByTabletSerial     | Tablet State   |
| 21 | GetPlayerInvoiceList        | Billing        |
| 22 | GetPlayerInvoiceCount       | Billing        |
| 23 | GetPlayerUnpaidInvoiceCount | Billing        |
| 24 | GetPlayerTotalDebt          | Billing        |
| 25 | GetMugShotBase64            | Utility        |

***

## Server-Side Exports

> All of these run in **server scripts** only.

***

### Tablet State

#### 1. IsPlayerTabletOpen

Check whether a player currently has their tablet open.

```lua
local isOpen = exports['0r-smarttab']:IsPlayerTabletOpen(source)
```

| Parameter | Type   | Description      |
| --------- | ------ | ---------------- |
| `source`  | number | Player server ID |

| Returns | Type    |
| ------- | ------- |
| is open | boolean |

```lua
if exports['0r-smarttab']:IsPlayerTabletOpen(5) then
    print("Player 5 has their tablet open")
end
```

***

#### 2. GetPlayerByTabletSerial

Find the owner of a tablet by its serial number. The owner must be **online**.

```lua
local source, citizenId, name = exports['0r-smarttab']:GetPlayerByTabletSerial(serial)
```

| Parameter | Type   | Description                        |
| --------- | ------ | ---------------------------------- |
| `serial`  | string | Tablet serial (e.g. `"0R-A1B2C3"`) |

| Returns   | Type          | Description           |
| --------- | ------------- | --------------------- |
| source    | number \| nil | Player server ID      |
| citizenId | string \| nil | Owner citizen ID      |
| name      | string \| nil | Player character name |

```lua
local src, cid, name = exports['0r-smarttab']:GetPlayerByTabletSerial("0R-A1B2C3")
if src then
    print(name .. " owns this tablet (server id: " .. src .. ")")
end
```

***

### App Management

#### 3. IsAppEnabled

Check if a specific app is enabled in `server/apps.json`.

```lua
local enabled = exports['0r-smarttab']:IsAppEnabled(appId)
```

| Parameter | Type   | Description                                |
| --------- | ------ | ------------------------------------------ |
| `appId`   | string | App ID (e.g. `"app-mail"`, `"app-police"`) |

| Returns | Type    |
| ------- | ------- |
| enabled | boolean |

```lua
if exports['0r-smarttab']:IsAppEnabled("app-mail") then
    print("Mail app is active")
end
```

***

#### 4. GetAppJobRequirements

Get all job-restricted apps and which jobs they require.

```lua
local requirements = exports['0r-smarttab']:GetAppJobRequirements()
```

| Parameters | — |
| ---------- | - |
| none       |   |

| Returns      | Type  | Description                        |
| ------------ | ----- | ---------------------------------- |
| requirements | table | `{ [appId] = { "job1", "job2" } }` |

```lua
local reqs = exports['0r-smarttab']:GetAppJobRequirements()
-- reqs["app-police"] = { "police", "sheriff" }
-- reqs["app-ems"]    = { "ambulance" }
```

***

### Notifications

#### 5. SendNotification (Server)

Send a notification to a player's tablet from the server. Shows immediately if the tablet is open, otherwise queues as a peek notification.

```lua
exports['0r-smarttab']:SendNotification(targetSrc, data)
```

| Parameter   | Type   | Description             |
| ----------- | ------ | ----------------------- |
| `targetSrc` | number | Target player server ID |
| `data`      | table  | Notification payload    |

**Payload fields:**

| Field      | Type   | Required | Description                   |
| ---------- | ------ | -------- | ----------------------------- |
| `title`    | string | yes      | Title                         |
| `message`  | string | yes      | Body text                     |
| `app`      | string | no       | App ID for icon               |
| `icon`     | string | no       | Custom icon                   |
| `duration` | number | no       | Duration in ms (default 4000) |

```lua
exports['0r-smarttab']:SendNotification(source, {
    title    = "Delivery",
    message  = "New package available for pickup.",
    app      = "app-mail",
    duration = 5000
})
```

***

#### 6. SetAppBadge (Server)

Set a badge counter on an app icon for a player (from server).

```lua
exports['0r-smarttab']:SetAppBadge(targetSrc, appId, count)
```

| Parameter   | Type   | Description               |
| ----------- | ------ | ------------------------- |
| `targetSrc` | number | Target player server ID   |
| `appId`     | string | App ID                    |
| `count`     | number | Badge number (0 to clear) |

```lua
exports['0r-smarttab']:SetAppBadge(source, "app-mail", 3)
```

***

### Billing

#### 7. GetPlayerInvoiceList

Get the full invoice list for a player (paid + unpaid). Reads from `phone_invoices` (QBCore/Qbox) or `billing` (ESX).

```lua
local invoices = exports['0r-smarttab']:GetPlayerInvoiceList(source)
```

| Parameter | Type   | Description      |
| --------- | ------ | ---------------- |
| `source`  | number | Player server ID |

| Returns  | Type         |
| -------- | ------------ |
| invoices | table \| nil |

**Each invoice object:**

| Field            | Type          | Description                         |
| ---------------- | ------------- | ----------------------------------- |
| `id`             | number/string | Invoice ID                          |
| `title`          | string        | Label                               |
| `sender`         | string        | Sender name / society               |
| `amount`         | number        | Total (with interest)               |
| `baseAmount`     | number        | Original amount                     |
| `interestAmount` | number        | Accrued interest                    |
| `status`         | string        | `"unpaid"` / `"overdue"` / `"paid"` |
| `dueDate`        | string        | Due date                            |
| `daysOverdue`    | number        | Days past due                       |

```lua
local list = exports['0r-smarttab']:GetPlayerInvoiceList(source)
if list then
    for _, inv in ipairs(list) do
        print(inv.title, inv.amount, inv.status)
    end
end
```

***

#### 8. GetPlayerInvoiceCount

Total number of invoices (paid + unpaid).

```lua
local count = exports['0r-smarttab']:GetPlayerInvoiceCount(source)
```

| Parameter | Type   |
| --------- | ------ |
| `source`  | number |

| Returns | Type   |
| ------- | ------ |
| count   | number |

***

#### 9. GetPlayerUnpaidInvoiceCount

Number of unpaid + overdue invoices only.

```lua
local unpaid = exports['0r-smarttab']:GetPlayerUnpaidInvoiceCount(source)
```

| Parameter | Type   |
| --------- | ------ |
| `source`  | number |

| Returns | Type   |
| ------- | ------ |
| count   | number |

***

#### 10. GetPlayerTotalDebt

Total debt across all unpaid/overdue invoices (interest included).

```lua
local debt = exports['0r-smarttab']:GetPlayerTotalDebt(source)
```

| Parameter | Type   |
| --------- | ------ |
| `source`  | number |

| Returns   | Type   |
| --------- | ------ |
| totalDebt | number |

***

#### 11. CheckUnpaidBills

Quick boolean check + count for unpaid bills.

```lua
local hasUnpaid, count = exports['0r-smarttab']:CheckUnpaidBills(source)
```

| Parameter | Type   |
| --------- | ------ |
| `source`  | number |

| Returns   | Type    | Description                      |
| --------- | ------- | -------------------------------- |
| hasUnpaid | boolean | `true` if any unpaid bills exist |
| count     | number  | Number of unpaid bills           |

```lua
local hasUnpaid, count = exports['0r-smarttab']:CheckUnpaidBills(source)
if hasUnpaid then
    print("Player owes " .. count .. " bill(s)")
end
```

***

#### 12. CreateInvoice

Create a new invoice for a target citizen. Officer info is auto-resolved from `source`. Supports QBCore/Qbox (`phone_invoices`) and ESX (`billing`).

```lua
exports['0r-smarttab']:CreateInvoice(source, targetId, amount, reason)
```

| Parameter  | Type   | Description                    |
| ---------- | ------ | ------------------------------ |
| `source`   | number | Officer / sender server ID     |
| `targetId` | string | Target citizen ID / identifier |
| `amount`   | number | Amount (> 0)                   |
| `reason`   | string | Invoice label / reason         |

Returns nothing (async).

```lua
exports['0r-smarttab']:CreateInvoice(source, "ABC12345", 5000, "Speeding violation")
```

***

### MDT / Police

#### 13. IsPlayerOnDuty

Check if a player is currently on duty (job `onduty` flag).

```lua
local onDuty = exports['0r-smarttab']:IsPlayerOnDuty(source)
```

| Parameter | Type   |
| --------- | ------ |
| `source`  | number |

| Returns | Type    |
| ------- | ------- |
| onDuty  | boolean |

```lua
if exports['0r-smarttab']:IsPlayerOnDuty(source) then
    print("Officer is on duty")
end
```

***

#### 14. CheckHasWarrant

Check if a citizen has active warrants in the MDT.

```lua
local hasWarrant, count, records = exports['0r-smarttab']:CheckHasWarrant(citizenid)
```

| Parameter   | Type   |
| ----------- | ------ |
| `citizenid` | string |

| Returns    | Type    | Description              |
| ---------- | ------- | ------------------------ |
| hasWarrant | boolean | `true` if warrants exist |
| count      | number  | Number of warrants       |
| records    | table   | Array of warrant rows    |

```lua
local has, count, recs = exports['0r-smarttab']:CheckHasWarrant("ABC12345")
if has then
    print(count .. " active warrant(s)")
end
```

***

### Prison

#### 15. SendJail

Send a player to jail. Auto-detects the prison resource (`xt-prison`, `qb-prison`, `qb-policejob`, `esx_policejob`).

```lua
exports['0r-smarttab']:SendJail(source, targetId, jailTime)
```

| Parameter  | Type   | Description                    |
| ---------- | ------ | ------------------------------ |
| `source`   | number | Officer server ID              |
| `targetId` | string | Target citizen ID / identifier |
| `jailTime` | number | Time in months/minutes (> 0)   |

Returns nothing. Target must be **online**.

```lua
exports['0r-smarttab']:SendJail(source, "ABC12345", 30)
```

***

## Client-Side Exports

> All of these run in **client scripts** only and affect the local player.

***

### Tablet State & Control

#### 16. IsTabletOpen

Check if the local player's tablet is currently open.

```lua
local isOpen = exports['0r-smarttab']:IsTabletOpen()
```

| Parameters | — |
| ---------- | - |
| none       |   |

| Returns | Type    |
| ------- | ------- |
| isOpen  | boolean |

```lua
if exports['0r-smarttab']:IsTabletOpen() then
    print("My tablet is open")
end
```

***

#### 17. OpenTabletWithApp

Open the tablet and jump directly to a specific app. The player must have a tablet item in their inventory.

```lua
exports['0r-smarttab']:OpenTabletWithApp(appId)
```

| Parameter | Type   | Description                       |
| --------- | ------ | --------------------------------- |
| `appId`   | string | App ID or action from `apps.json` |

Returns nothing.

```lua
-- Open directly to the Mail app
exports['0r-smarttab']:OpenTabletWithApp("app-mail")

-- Open directly to a custom app
exports['0r-smarttab']:OpenTabletWithApp("customapp")

-- Open directly to Settings
exports['0r-smarttab']:OpenTabletWithApp("settings")

-- Open directly to the Police MDT
exports['0r-smarttab']:OpenTabletWithApp("app-police")
```

***

### Notifications

#### 18. SendNotification (Client)

Send a notification to the local player's tablet. If open, appears immediately; if closed, queues and shows a peek animation.

```lua
exports['0r-smarttab']:SendNotification(data)
```

| Parameter | Type  | Description                                          |
| --------- | ----- | ---------------------------------------------------- |
| `data`    | table | Notification payload (same fields as server version) |

```lua
exports['0r-smarttab']:SendNotification({
    title   = "Alert",
    message = "Something happened nearby.",
    app     = "app-police",
    duration = 4000
})
```

***

#### 19. SetAppBadge (Client)

Set a badge counter on an app icon (local player only).

```lua
exports['0r-smarttab']:SetAppBadge(appId, count)
```

| Parameter | Type   | Description               |
| --------- | ------ | ------------------------- |
| `appId`   | string | App ID                    |
| `count`   | number | Badge number (0 to clear) |

```lua
exports['0r-smarttab']:SetAppBadge("app-mail", 5)
```

***

### Tablet Lookup (Async)

#### 20. GetPlayerByTabletSerial (Client)

Look up a tablet's owner by serial number. Queries the server asynchronously.

```lua
exports['0r-smarttab']:GetPlayerByTabletSerial(serial, callback)
```

| Parameter  | Type     | Description                            |
| ---------- | -------- | -------------------------------------- |
| `serial`   | string   | Tablet serial number                   |
| `callback` | function | `function(result)` — result is a table |

**Result table:**

| Field       | Type          |
| ----------- | ------------- |
| `source`    | number \| nil |
| `citizenid` | string \| nil |
| `name`      | string \| nil |

```lua
exports['0r-smarttab']:GetPlayerByTabletSerial("0R-A1B2C3", function(result)
    if result.source then
        print(result.name .. " — server id: " .. result.source)
    end
end)
```

***

### Billing (Async)

All client billing exports query the server and return data via callback.

#### 21. GetPlayerInvoiceList (Client)

```lua
exports['0r-smarttab']:GetPlayerInvoiceList(function(list)
    for _, inv in ipairs(list) do
        print(inv.title, inv.amount, inv.status)
    end
end)
```

| Parameter  | Type           |
| ---------- | -------------- |
| `callback` | function(list) |

***

#### 22. GetPlayerInvoiceCount (Client)

```lua
exports['0r-smarttab']:GetPlayerInvoiceCount(function(count)
    print("Total invoices: " .. count)
end)
```

| Parameter  | Type            |
| ---------- | --------------- |
| `callback` | function(count) |

***

#### 23. GetPlayerUnpaidInvoiceCount (Client)

```lua
exports['0r-smarttab']:GetPlayerUnpaidInvoiceCount(function(count)
    print("Unpaid: " .. count)
end)
```

| Parameter  | Type            |
| ---------- | --------------- |
| `callback` | function(count) |

***

#### 24. GetPlayerTotalDebt (Client)

```lua
exports['0r-smarttab']:GetPlayerTotalDebt(function(debt)
    print("Total debt: $" .. debt)
end)
```

| Parameter  | Type                |
| ---------- | ------------------- |
| `callback` | function(totalDebt) |

***

### Utility

#### 25. GetMugShotBase64

Capture a ped's headshot as a texture dictionary string (for NUI/UI display).

```lua
local txd = exports['0r-smarttab']:GetMugShotBase64(ped, transparent)
```

| Parameter     | Type    | Description                |
| ------------- | ------- | -------------------------- |
| `ped`         | number  | Ped handle                 |
| `transparent` | boolean | Use transparent background |

| Returns | Type   | Description                                   |
| ------- | ------ | --------------------------------------------- |
| txd     | string | Texture dictionary name (`"none"` on failure) |

```lua
local ped = PlayerPedId()
local headshot = exports['0r-smarttab']:GetMugShotBase64(ped, true)
```