Client Exports

---@return table
local config = exports["lb-phone"]:GetConfig()

---@return vector3[]
local cellTowers = exports["lb-phone"]:GetCellTowers()

---@param number string # The number to format
---@return string # The formatted number
local formattedNumber = exports["lb-phone"]:FormatNumber(number)

---@param link string # The link to the image/video
exports["lb-phone"]:SaveToGallery(link)

---@param number? string
---@return boolean
local hasPhone = exports["lb-phone"]:HasPhoneItem(number)

---@alias CheckEvent "openPhone" | "playNativePhoneSound"
 
---@param event CheckEvent
---@param handler fun(...: any): boolean
---@return number id
local id = exports["lb-phone"]:AddCheck(event, handler)

---@param id number
---@return boolean success
local success = exports["lb-phone"]:RemoveCheck(id)

---@return string?
local phoneNumber = exports["lb-phone"]:GetEquippedPhoneNumber()

---@param open? boolean # If true, the phone is opened, if false, the phone is closed. If nil, the phone it toggles.
---@param noFocus? boolean # If true, the cursor is hidden when opening the phone.
exports["lb-phone"]:ToggleOpen(open, noFocus)

---@return boolean
local isOpen = exports["lb-phone"]:IsOpen()

---@return boolean
local isPhoneOnScreen = exports["lb-phone"]:IsPhoneOnScreen()

---@return boolean
local isDisabled = exports["lb-phone"]:IsDisabled()

---@param disabled boolean
exports["lb-phone"]:ToggleDisabled(disabled)

---@param show boolean
exports["lb-phone"]:ToggleHomeIndicator(show)

---@param landscape boolean
exports["lb-phone"]:ToggleLandscape(landscape)

---@class NotificationData
---@field app? string # Identifier of the app that sent the notification, optional
---@field title string # Title of the notification
---@field content? string # Content of the notification, optional
---@field thumbnail? string # Thumbnail URL, optional
---@field avatar? string # Avatar URL, optional
---@field showAvatar? boolean # Whether to show an avatar placeholder if no avatar was sent, optional
 
---@param data NotificationData
exports["lb-phone"]:SendNotification({
    app = "Settings",
    title = "Test",
    content = "This is a test notification",
})

---@param flashlight boolean
exports["lb-phone"]:ToggleFlashlight(flashlight)

---@return boolean
local flashlightEnabled = exports["lb-phone"]:GetFlashlight()

---@param bars? number | false
exports["lb-phone"]:SetServiceBars(bars)

exports["lb-phone"]:ReloadPhone()

---@param variation number # The variation of the phone, has to be configured in `Config.Item.Names`
exports["lb-phone"]:SetPhoneVariation(variation)

---@param selfieMode? boolean
exports["lb-phone"]:EnableWalkableCam(selfieMode)

exports["lb-phone"]:DisableWalkableCam()

---@return boolean
local enabled = exports["lb-phone"]:IsWalkingCamEnabled()

---@param selfieMode boolean
exports["lb-phone"]:ToggleSelfieCam(selfieMode)

exports["lb-phone"]:ToggleCameraFrozen()

---@return boolean
local selfieCam = exports["lb-phone"]:IsSelfieCam()

---@return table
local settings = exports["lb-phone"]:GetSettings()

---@return boolean
local airplaneMode = exports["lb-phone"]:GetAirplaneMode()

---@return boolean
local streamerMode = exports["lb-phone"]:GetStreamerMode()

---@return boolean
local isLive = exports["lb-phone"]:IsLive()

---@class BirdyPostData
---@field content string # The content of the post
---@field attachments? string[] # URLs of the attachments
---@field replyTo? string # The ID of the post to reply to
---@field hashtags? string[] # Hashtags used in the post
 
---@param data BirdyPostData
---@return boolean # Whether the post was successful
exports["lb-phone"]:PostBirdy(data)

---@class ContactData
---@field number string
---@field firstname string
---@field lastname? string
---@field avatar? string
---@field email? string
---@field address? string
 
---@param data ContactData
---@return boolean success
exports["lb-phone"]:AddContact({
    number = "01234567890",
    firstname = "John",
    lastname = "Doe",
    avatar = "https://example.com/avatar",
    email =  "[email protected]",
    address = "Eclipse Towers, Penthouse Suite 1",
})

---@param app string # The app (identifier) to open
---@param data? table # Data to pass to the app
exports["lb-phone"]:OpenApp(app, data)

---@param options? { app?: string, closeCompletely?: boolean }
exports["lb-phone"]:CloseApp(options)

---@param app string
---@param hidden boolean
exports["lb-phone"]:SetAppHidden(app, hidden)

---@param app string
---@param installed boolean
exports["lb-phone"]:SetAppInstalled(app, installed)

---@class CustomApp
---@field identifier string # A unique identifier of the app
---@field ui string # The path to the HTML file
---@field name string
---@field description string
---@field images? string[] # An array of images for the app on the app store
---@field developer? string # The developer of the app
---@field defaultApp? boolean # If set to true, the app will be added automatically
---@field size? number # Size in kB
---@field icon? string # A url to the icon of the app
---@field price? number # Require players to purchase the app with in-game money
---@field landscape? boolean
---@field game? boolean
---@field onDelete? function # Called when the app is uninstalled
---@field fixBlur? boolean # If set to true, the app will not be blurry. This requires you to use the em/rem units in your CSS
---@field onClose? function # Called when the app is closed
---@field onOpen? function # Called when the app is opened
 
---@param appData CustomApp
---@return boolean success
---@return string? errorMessage
local success, errorMessage = exports["lb-phone"]:AddCustomApp({
    identifier = "custom-app",
    name = "Custom App",
    description = "This is a custom app",
    ui = "ui/index.html"
})

---@param identifier string
---@return boolean success
---@return string? errorMessage
local success, errorMessage = exports["lb-phone"]:RemoveCustomApp(identifier)

---@param identifier string
---@param data any
---@return boolean success
---@return string? errorMessage
exports["lb-phone"]:SendCustomAppMessage(identifier, data)

---@param options { component: string, ... } # The component to show and its options
---@param cb function # Callback function with the result
exports["lb-phone"]:ShowComponent({
    component = "gallery", # component to show
    # other options
}, function(...)
    print("Result:", ...)
end)

---@class CameraComponentData
---@field default { type: "Photo" | "Video" | "Landscape", flash: boolean, camera: "rear" | "front" }
---@field permissions { toggleFlash: boolean, flipCamera: boolean, takePhoto: boolean, takeVideo: boolean, takeLandscapePhoto: boolean }
---@field saveToGallery boolean
---@field cb fun(src: string)
 
---@param data CameraComponentData
---@return string
local url = exports["lb-phone"]:SetCameraComponent(data)

---@param phoneNumber string
exports["lb-phone"]:SetContactModal(phoneNumber)

---@return boolean # If the phone has 0% battery
local dead = exports["lb-phone"]:IsPhoneDead()

---@return number # The battery percentage, 0-100
local battery = exports["lb-phone"]:GetBattery()

---@param battery number # The battery percentage, 0-100
exports["lb-phone"]:SetBattery(battery)

---@param charging boolean
exports["lb-phone"]:ToggleCharging(charging)

---@return boolean
local charging = exports["lb-phone"]:IsCharging()

---@param company string # The company to send the message to
---@param message string
---@param anonymous? boolean # Whether the message should be sent anonymously
exports["lb-phone"]:SendCompanyMessage(company, message, anonymous)

---@param company string # The company to send the message to
---@param coords? vector3 # The coordinates to send, if not provided it will send the player's current location
---@param anonymous? boolean # Whether the message should be sent anonymously
exports["lb-phone"]:SendCompanyCoords(company, coords, anonymous)

---@return boolean
local callsEnabled = exports["lb-phone"]:GetCompanyCallsStatus()

---@param enabled boolean
---@return boolean
exports["lb-phone"]:ToggleCompanyCalls(enabled)

---@param coin string
---@return number
local value = exports["lb-phone"]:GetCoinValue(coin)

---@class CryptoWalletEntry
---@field change_24h number
---@field current_price number
---@field id string
---@field image string
---@field name string
---@field prices number[]
---@field symbol string
---@field owned number
 
---@return CryptoWalletEntry[]
local wallet = exports["lb-phone"]:GetCryptoWallet()

---@param coin string
---@return CryptoWalletEntry | false
local coinData = exports["lb-phone"]:GetOwnedCoin(coin)

---@class CallOptions
---@field number? string
---@field company? string
---@field videoCall? boolean
---@field hideNumber? boolean
 
---@param options CallOptions
exports["lb-phone"]:CreateCall(options)

---@return boolean
local inCall = exports["lb-phone"]:IsInCall()

---@class IncomingCall
---@field id string
---@field accept fun()
---@field deny fun() # Declines/ends the call without triggering onEnd
---@field setName fun(name: string)
---@field hasEnded fun(): boolean
 
---@class CustomNumberData
---@field onCall fun(incomingCall: IncomingCall)
---@field onEnd? fun()
---@field onAction? fun(action: "mute" | "unmute" | "enable_speaker" | "disable_speaker")
---@field onKeypad? fun(key: string)
 
---@param number string
---@param data CustomNumberData
---@return boolean success
---@return string? reason
local success, reason = exports["lb-phone"]:CreateCustomNumber(number, data)

---@param number string
---@return boolean success
---@return string? reason
local success, reason = exports["lb-phone"]:RemoveCustomNumber(number)

---@param validator fun(phoneNumber: string): boolean
---@param data CustomNumberData
---@return number
local id = exports["lb-phone"]:CreateDynamicCustomNumber(validator, data)

---@param id number
---@return boolean success
local success = exports["lb-phone"]:RemoveDynamicCustomNumber(id)

---@return boolean
local success = exports["lb-phone"]:EndCustomCall()

---@param event string
---@param handler fun(...) : ...
exports["lb-phone"]:RegisterClientCallback(event, handler)

---@param event string
---@param ... any
local data = exports["lb-phone"]:AwaitCallback(event, ...)

---@param event string
---@param cb fun(...): any
---@param ... any
local data = exports["lb-phone"]:TriggerCallback(event, cb, ...)