Utilities

sub GTV_Log(tag as String, msg as String)
    ' Prints only when IS_DEV_BUILD = true (bs_const in manifest)
    #if IS_DEV_BUILD
        print "[GTV][" + tag + "] " + msg
    #end if
end sub

sub GTV_Warn(tag as String, msg as String)
    print "[GTV][WARN][" + tag + "] " + msg
end sub

sub GTV_Error(tag as String, msg as String)
    print "[GTV][ERROR][" + tag + "] " + msg
end sub

function GTV_HttpGet(
    url       as String,
    timeoutMs as Integer = 15000
) as Object

{ code: Integer, body: String, ok: Boolean }
' ok = (code >= 200 and code < 300)
' code = -1 on timeout or connection failure

function GTV_HttpPost(
    url       as String,
    jsonBody  as String,
    timeoutMs as Integer = 15000
) as Object

function GTV_BuildQuery(params as Object) as String

function GTV_UrlEncode(s as String) as String

function GTV_BuildUserAgent(di = invalid as Dynamic) as String

function GTV_GetAppVersion() as String
function GTV_GetAppIdentity() as String
function GTV_GetBrandedDeviceModel(di = invalid as Dynamic) as String

function GTV_RegRead(key as String, defaultVal = "" as String) as String
sub     GTV_RegWrite(key as String, value as String)
sub     GTV_RegDelete(key as String)

function GTV_RegHasCredentials() as Boolean
function GTV_RegLoadCredentials() as Object
    ' Returns { username: String, password: String } or invalid
sub     GTV_RegSaveCredentials(username as String, password as String)
sub     GTV_RegClearCredentials()

function GTV_RegLoadLastServer() as String
sub     GTV_RegSaveLastServer(serverUrl as String)
sub     GTV_RegClearCache()
    ' Deletes REG_KEY_SERVER and REG_KEY_CHANNEL

function GTV_RegLoadLastChannelIndex() as Integer
sub     GTV_RegSaveLastChannelIndex(idx as Integer)

function GTV_RegLoadSafeMarginPct() as Integer
    ' Clamped to [UI_SAFE_MARGIN_MIN_PCT, UI_SAFE_MARGIN_MAX_PCT]
sub     GTV_RegSaveSafeMarginPct(pct as Integer)

function GTV_LoadServerProfiles() as Object
    ' Returns array of sanitized server profiles from registry,
    ' falling back to GTV_DefaultServerProfiles() if none saved.

sub GTV_SaveServerProfiles(profiles as Object)

function GTV_ServerList() as Object
    ' Returns array of baseUrl strings from current profiles.

function GTV_FindActiveServer(forcedServer = "" as String) as String
    ' Probes the auto-probe list and returns the first reachable server URL.
    ' Saves it to registry via GTV_RegSaveLastServer().

function GTV_ServerBuildAutoProbeList() as Object
    ' Builds ordered probe list: LAN servers repeated SERVER_LAN_FORCE_RETRIES
    ' times, then WAN servers.

function GTV_ServerBuildRequestSequence(preferredBaseUrl = "" as String) as Object
    ' Like GTV_ServerBuildAutoProbeList() but puts preferredBaseUrl first.

function GTV_ServerInferType(baseUrl as String) as String
    ' Returns "lan" for RFC-1918 addresses (172.17.*, 192.168.*, 10.*,
    ' localhost), "wan" for everything else.

function GTV_ServerNormalizeBaseUrl(raw as Dynamic) as String
    ' Strips trailing slash, validates scheme (http/https).
    ' Returns "" for invalid URLs.

function GTV_ServerGetProfileById(profiles as Object, profileId as String) as Dynamic
function GTV_ServerGetProfileByBaseUrl(profiles as Object, baseUrl as String) as Dynamic

function GTV_ServerUpsertProfile(profiles as Object, profile as Object) as Object
function GTV_ServerDeleteProfile(profiles as Object, profileId as String) as Object
function GTV_ServerCanDelete(profiles as Object, profileId as String) as Boolean
    ' Returns false if deleting would leave the list empty.

function GTV_ServerCreateProfile(name as String, baseUrl as String, existing = invalid as Dynamic) as Dynamic
function GTV_ServerDescribe(profile as Dynamic) as String
    ' Returns a human-readable string: "Local [LAN] - http://172.17.11.2:3333"

[
    {
        id      : "local_default"
        name    : "Local"
        baseUrl : "http://172.17.11.2:3333"
        type    : "lan"
        builtIn : true
        enabled : true
    },
    {
        id      : "public_default"
        name    : "Publico"
        baseUrl : "https://admin.globaltv.lat"
        type    : "wan"
        builtIn : true
        enabled : true
    }
]

function GTV_ParseM3U(text as String) as Object

{
    channels               : [],   ' sorted by channel number
    categories             : [],   ' deduplicated group-title values
    droppedMissingNumber   : 0,    ' entries dropped due to missing channel-number
    droppedDuplicateNumber : 0,    ' entries dropped due to duplicate number
    fallbackAssigned       : 0     ' entries assigned an auto-index (non-strict mode only)
}

function GTV_ExtractAttr(src as String, attrName as String) as String
    ' Extracts attrName="value" or attrName='value' from an #EXTINF line.
    ' Handles both double-quoted and single-quoted values.

function GTV_NormalizeChannelUrl(rawUrl as String) as String
    ' hls://  -> http://
    ' hlss:// -> https://
    ' All others passed through unchanged.

function GTV_ExtractStreamIdFromChannelUrl(rawUrl as String) as String
    ' Walks URL path segments in reverse, looking for a hex segment
    ' of >= 12 characters (likely a stream UUID). Used to populate
    ' channel.streamId and channel.contentId.

function GTV_PingServer(baseUrl as String) as Boolean

if GTV_PingServer("https://admin.globaltv.lat")
    ' server is reachable
end if

function GTV_IsOnline() as Boolean
    ' Returns true if roDeviceInfo.GetConnectionType() is non-empty.
    ' An empty string means no network interface is connected.

function GTV_GetConnectionType() as String
    ' Returns the raw connection type string from roDeviceInfo
    ' (e.g. "WiFiConnection", "WiredConnection", "").

function GTV_HasInternet(activeServer as String) as Boolean
    ' Combines GTV_IsOnline() with GTV_PingServer() for a full
    ' two-stage connectivity check:
    '   1. Device has a network interface (GTV_IsOnline)
    '   2. The active server health endpoint is reachable (GTV_PingServer)