--- slug: 90-builtins title: Índice de builtins description: Un índice categorizado de las funciones integradas de Synsema — colecciones, texto, matemática, bytes, tiempo, JSON, I/O, HTTP, DB, memoria y response helpers. example_ids: [builtins] --- # Índice de builtins Un mapa categorizado de los builtins. Las firmas completas viven en cada página de tema; los centrales están doctested acá para que esta referencia no driftee. ```synsema -- Doc reference: a few core builtins, doctested so the reference can't drift. intent: "doc reference: core builtins" print("upper(\"hi\") = " + upper("hi") + ", join([a,b],\"-\") = " + join(["a", "b"], "-")) test "collections" assert_eq(length([1, 2, 3]), 3) assert(contains([1, 2, 3], 2)) assert_eq(slice([1, 2, 3, 4], 1, 3), [2, 3]) -- Python-style end-exclusive assert_eq(keys({"a": 1, "b": 2}), ["a", "b"]) assert_eq(values({"a": 1, "b": 2}), [1, 2]) test "text" assert_eq(upper("hi"), "HI") assert_eq(trim(" x "), "x") assert_eq(split("a,b,c", ","), ["a", "b", "c"]) assert_eq(join(["a", "b"], "-"), "a-b") assert(starts_with("hello", "he")) test "intentional ops" assert_eq(apply((n) => n * 2, [1, 2, 3]), [2, 4, 6]) assert_eq(where([1, 2, 3, 4], (n) => n > 2), [3, 4]) assert_eq(reduce([1, 2, 3], (a, b) => a + b, 0), 6) test "intentional ops accept both orders (fn-first and list-first)" assert_eq(apply([1, 2, 3], (n) => n * 2), [2, 4, 6]) -- list-first also works assert_eq(where((n) => n > 2, [1, 2, 3, 4]), [3, 4]) -- fn-first also works assert_eq(reduce((a, b) => a + b, [1, 2, 3], 10), 16) -- extra args stay at the end test "unique and index_of" assert_eq(unique([3, 1, 3, 2, 1]), [3, 1, 2]) -- first-appearance order assert_eq(index_of([10, 20, 30], 20), 1) -- by item assert_eq(index_of([1, 2, 3], (n) => n > 1), 1) -- by predicate assert_eq(index_of([1, 2], 9), nothing) -- absent → nothing, not -1 test "program & subprocess: args() and self_path() (no capability)" assert_eq(type_of(args()), "list") -- the program's argv (empty under `synsema test`) assert_eq(type_of(self_path()), "text") -- this executable's path assert(length(self_path()) > 0) ``` ## Por categoría - **Colecciones:** `length`, `contains`, `slice`, `keys`, `values`, `apply`, `where`, `reduce`, `sort_by`, `group_by`, `find_first`, `every`, `some`, `collect`, `count_where`, `flatten`, `chunk`, `zip_with`, `unique` (dedupe, orden de primera aparición, igualdad estructural), `index_of` (índice base 0 por item o predicado; ausente → `nothing`, no -1). `enumerate(list)` → `[{index, item}, …]` para loops con índice (lenguaje y templates). Los ops intencionales que toman un callable aceptan **ambos** órdenes — `apply(fn, lista)` y `apply(lista, fn)` se leen igual de bien; dos tasks o dos listas donde se esperaba una-y-una es error explícito. - **Texto:** `upper`, `lower`, `fold`, `trim`, `starts_with`, `split`, `join`, `replace_text`, `replace_re`, `matches`, `capture`, `text`, `fmt`, `strip_ansi` (engine v0.6.8+: salida de terminal → texto plano; escapes CSI/OSC/charset y bytes de control fuera, los redibujos con `\r` conservan el último cuadro). - **Números / matemática:** `+ - * / % **`, `number`, constantes `pi`/`tau`/`e`/`inf`/`nan`; `abs`, `sign`, `min`, `max`, `clamp`, `sqrt`, `cbrt`, `hypot`, `pow`, `exp`, `ln`, `log10`, `log2`, `log_base`, `floor`, `ceil`, `round`, `trunc`, `round_to`, `sin`/`cos`/`tan`/`asin`/`acos`/`atan`/`atan2`, `radians`/`degrees`, `sinh`/`cosh`/`tanh`/`asinh`/`acosh`/`atanh`, `gcd`, `lcm`, `factorial`, `is_nan`/`is_infinite`/`is_finite`, `gamma`/`lgamma`/`erf`/`erfc`/`beta`; `decimal`, `complex`/`real`/`imag`/`conj`/`arg`; predicados de tipo `is_decimal`, `is_complex`, `is_array`, `is_bytes`, `type_of`; arrays `array`, `arange`, `linspace`, `zeros`, `ones`, `eye`, `full`, `reshape`, `shape`, `ndim`, `size`, `transpose`, `trace`, `dot`, `norm`, `matmul`, `solve`, `det`, `inv`, `eig`, `svd`; `bytes_to_int`, `int_to_bytes`, `int_to_bytes_le` — ver [Bytes, matemática y arrays](/es/0.6.x/35-bytes-math-arrays). - **Bytes / cripto:** `bytes`, `decode` (encodings: `utf8`, `hex`, `base64`, `base64url`, `base58`, `base32`), `sha256`, `sha512`, `hmac_sha256`, `verify_hmac`, `constant_time_eq`. - **Web Push** (engine v0.6.15+ — ver [Tu app en el teléfono](/es/0.6.x/41b-pwa)): `push_vapid_keys()` → `{public, private}` (`require random`; la privada vuelve como `secret` con label `vapid_private`); `push_send(subscription, payload, opts)` → `{status, ok, gone, retry_after, body}` (`require net("")` — `fcm.googleapis.com` y `jmt17.google.com` (Chrome usa cualquiera), `*.notify.windows.com`, `updates.push.services.mozilla.com`, `web.push.apple.com`; `opts.vapid = {public, private: secret, subject}` obligatorio, `ttl`, `urgency`, `topic`, `timeout`; payload texto / map→JSON / bytes / `nothing`, ≤ 3993 bytes; `gone` con 404/410). RFC 8291 `aes128gcm` + VAPID RFC 8292, sin proveedor; no está en el perfil wasm. - **Web auth** (engine v0.5.5+ — ver [Login y sesiones](/es/0.6.x/40a-web-auth)): `password_hash`, `password_verify`, `jwt_sign`, `jwt_verify`, `totp`, `totp_verify` (puros); `random_bytes`, `token` (`require random`); respuestas `with_header`, `set_cookie`, `clear_cookie`; `request.cookies`; auth task de 2 parámetros. - **Identidad de agentes y auth** (engine v0.5.6+ — ver [Identidad de agentes](/es/0.6.x/46-agent-identity)): tokens de capacidad `captoken_mint`, `captoken_attenuate` (offline, sin clave), `captoken_verify`, `captoken_allows` (puros); requests firmadas `http_sign` (`require sign("CLAVE")` + auditoría) y `http_signature_verify` (puro, `opts.alg` obligatorio); OIDC de terceros `oidc_verify` (`iss`+`aud` obligatorios; el JWKS necesita `require net(host)`); `mtls_identity(cert, key, opts?)` con alcance por `opts.hosts` (`require file.read`); medición por identidad: `spend_total(unidad, identidad?)`, rate limits por identidad y `SYNSEMA_SPEND_CEILING_PER_IDENTITY="agente=UNIDAD:tope"` (cualquier unidad — ninguna moneda privilegiada); descubrimiento en `/.well-known/synsema-auth`. - **Tiempo / random:** `now`, `format_time`, `parse_time`, `date_parts` (→ `{year, month, day, hour, minute, second}`, UTC), `sleep`, `random`, `random_int` (`random`, `random_bytes` y `token` necesitan `require random`). - **JSON:** `json_encode`, `json_decode`; `json_for_script` (el mismo JSON con `<`/`>`/`&` escapados `\u00XX` — la forma segura de incrustar datos en un `