types.lua

---@alias MnrDebugLevel 'debug' | 'info' | 'warn' | 'error'| 'fatal'

---@alias MnrDebugAPI fun(level: MnrDebugLevel, text: string, ...: any)

---@class CronjobAPIOptions
---@field maxDelay number

---@class MnrCronjob
---@field schedulerId number
---@field expression string
---@field stop fun(self: MnrCronjob): boolean

---@class MnrClientRPC
---@field send fun(name: string, timeout: number | false | nil, cb: function, ...: any)
---@field fetch fun(name: string, timeout: number | false | nil, ...: any): any
---@field handle fun(name: string, handler: function)

---@class TypecheckDefinition
---@field expected string
---@field required? boolean
---@field defaults? any

---@alias MnrImportAPI fun(path: string, ext: 'lua'|'json', cache?: boolean, env?: table): any

---@class MnrNumAPI
---@field clamp fun(value: number, min: number, max: number): number

---@class MnrTimestampAPI
---@field unix fun(value: string): integer                                                                      Parses a DATE or DATETIME string into a Unix timestamp using the host's local time
---@field string fun(unix: integer, withTime?: boolean): string                                                 Formats a Unix timestamp back into a DATE or DATETIME string using the host's local time

---@class MnrTypecheckAPI
---@field single fun(value: any, definition: TypecheckDefinition): any?, string?
---@field schema fun(input: table, schema: table<string, TypecheckDefinition>, output?: table): table?, string?

---@class MnrServerRPC
---@field send fun(name: string, playerId: number, timeout: number | false | nil, cb: function, ...: any)
---@field fetch fun(name: string, playerId: number, timeout: number | false | nil, ...: any): any
---@field handle fun(name: string, handler: fun(playerId: number, ...: any))

---@class MnrSharedAPI
---@field debug MnrDebugAPI
---@field import MnrImportAPI
---@field num MnrNumAPI
---@field timestamp MnrTimestampAPI
---@field typecheck MnrTypecheckAPI

---@class MnrClientAPI : MnrSharedAPI
---@field rpc MnrClientRPC

---@class MnrServerAPI : MnrSharedAPI
---@field cronjob fun(expression: string, callback: fun(d: osdate), options: CronjobAPIOptions): MnrCronjob
---@field rpc MnrServerRPC

---@alias MnrAPI MnrClientAPI | MnrServerAPI