API Reference

Complete reference for all built-in funcs in Flowa.

Type Functions

Function	Purpose	Example
`type(x)`	Get type of value	`type(42)` → `"number"`
`len(x)`	Length	`len("hello")` → `5`
`tonumber(s)`	Convert to number	`tonumber("42")` → `42`
`tostring(x)`	Convert to string	`tostring(42)` → `"42"`
`str(x)`	Alias for tostring	`str(42)` → `"42"`
`int(x)`	Alias for tonumber	`int("42")` → `42`

String Functions

Function	Purpose	Example
`upper(s)`	Convert to uppercase	`upper("hello")` → `"HELLO"`
`lower(s)`	Convert to lowercase	`lower("WORLD")` → `"world"`
`substring(s, start, end)`	Extract substring	`substring("hello", 0, 3)` → `"hel"`
`contains(s, substr)`	Check if contains	`contains("hello", "ell")` → `true`
`trim(s)`	Remove whitespace	`trim(" hi ")` → `"hi"`
`replace(s, old, new)`	Replace text	`replace("hi", "i", "o")` → `"ho"`
`split(s, delim)`	Split into array	`split("a,b,c", ",")` → `["a","b","c"]`
`join(arr, sep)`	Join with separator	`join(["a", "b"], "-")` → `"a-b"`
`startsWith(s, p)`	Check prefix	`startsWith("abc", "a")` → `true`
`endsWith(s, suf)`	Check suffix	`endsWith("abc", "c")` → `true`
`charAt(s, i)`	Get char at index	`charAt("abc", 0)` → `"a"`

Math Functions

Function	Purpose	Aliases
`sqrt(x)`	Square root
`power(x, y)`	Exponentiation	`pow(x, y)`
`floor(x)`	Round down
`ceil(x)`	Round up
`round(x)`	Round nearest
`abs(x)`	Absolute value
`min(a, b)`	Minimum
`max(a, b)`	Maximum

Array Functions

Function	Purpose	Example
`push(arr, x)`	Add element	`push([1,2], 3)` → `[1,2,3]`
`pop(arr)`	Remove last	`pop([1,2,3])` → `3`
`shift(arr)`	Remove first	`shift([1,2,3])` → `1`
`reverse(arr)`	Reverse array	`reverse([1,2,3])` → `[3,2,1]`
`sort(arr)`	Sort array	`sort([3,1,2])` → `[1,2,3]`
`slice(arr, start, end)`	Extract portion	`slice([1,2,3,4], 1, 3)` → `[2,3]`
`includes(arr, x)`	Check contains	`includes([1,2,3], 2)` → `true`
`indexOf(arr, x)`	Find index	`indexOf([1,2,3], 2)` → `1`

Hash Functions

Function	Purpose	Example
`keys(hash)`	Get all keys	`keys({"a": 1, "b": 2})` → `["a", "b"]`
`values(hash)`	Get all values	`values({"a": 1, "b": 2})` → `[1, 2]`
`key in hash`	Check key exists	`"name" in user` → `true`

System Functions

Function	Purpose
`exit(code)`	Terminate program
`sleep(ms)`	Sleep for milliseconds
`random()`	Random number (0-100)
`print(s)`	Print to stdout

Error Handling (Result)

Function	Purpose
`Ok(val)`	Create success result
`Err(val)`	Create error result
`isOk(res)`	Check if success
`isErr(res)`	Check if error
`unwrap(res)`	Get value or panic

File System Module (fs)

func	Description
`fs.readFile(path)`	Read file contents
`fs.writeFile(path, content)`	Write to file
`fs.appendFile(path, content)`	Append to file
`fs.exists(path)`	Check if file exists

JSON Module

func	Description
`json.stringify(obj)`	Convert to JSON string
`json.parse(str)`	Parse JSON string

Authentication Module (auth)

func	Description
`auth.hash(password)`	Hash password with bcrypt
`auth.verify(password, hash)`	Verify password

JWT Module

func	Description
`jwt.sign(payload)`	Create JWT token
`jwt.verify(token)`	Verify token validity
`jwt.decode(token)`	Decode token payload

Email Module (mail)

func	Description
`mail.send(to, subject, body)`	Send email via SMTP

SQLite Module

func	Description
`sqlite.open(path)`	Open/create database
`sqlite.exec(db, sql)`	Execute SQL statement
`sqlite.query(db, sql)`	Execute SELECT query
`sqlite.close(db)`	Close database

HTTP Module

func	Description
`http.createServer()`	Create HTTP server
`server.on(method, path, handler)`	Add route handler
`server.listen(port)`	Start listening
`http.get(url)`	Make GET request
`http.post(url, data)`	Make POST request

Cron Module

func	Description
`cron.schedule(expr, fn)`	Schedule periodic task

Logging Module

func	Description
`log.info(msg)`	Info level log
`log.warn(msg)`	Warning level log
`log.error(msg)`	Error level log
`log.debug(msg)`	Debug level log

OS Module

func	Description

Environment Variables

Access via env object:

let value = env.VARIABLE_NAME;
let api_key = env.API_KEY;

Operators

Arithmetic

+ Addition
- Subtraction
* Multiplication
/ Division
% Modulo

Comparison

== Equal
!= Not equal
< Less than
<= Less than or equal
> Greater than
>= Greater than or equal

Logical

&& Logical AND
|| Logical OR
! Logical NOT

Time Module

Function	Purpose
`time.now_ms()`	Returns current timestamp in milliseconds
`time.since_s(reference_ms)`	Returns elapsed time in seconds since the reference timestamp

Test Module

Function	Purpose
`test(description, function)`	Run a test case with description
`assert(condition, message)`	Assert that a condition is true, throws error if false

Keywords

Reserved keywords:

let, func, if, else, while, for, return, 
true, false, null, break, continue, import, export

Next Steps

Examples - See funcs in action
Language Guide - Learn the language
GitHub (opens in a new tab) - Source code

Troubleshooting