JS Components

Obelisk supports three JS component types, each with its own execution model and API:

• JS Activities — side-effectful work; retried automatically on failure
• JS Workflows — deterministic orchestration; survives server crashes via replay
• JS Webhooks — HTTP handlers; can call activities and workflows

Function signatures and FFQNs

Each component's JS function name maps to the last segment of its FFQN. Parameter names use snake_case in JS but kebab-case in WIT and deployment.toml. A leading comment makes the mapping explicit:

// ffqn: tutorial:demo/activity.step(idx: u64, sleep-millis: u64) -> result<string>
export default async function step(idx, sleep_millis) { ... }

[[activity_js]]
ffqn    = "tutorial:demo/activity.step"
params  = [
  { name = "idx",         type = "u64" },
  { name = "sleep-millis", type = "u64" },
]
return_type = "result<string>"

See WIT reference for the full type reference and JSON encoding, and JS activities for how return and throw map to the result variants.

Inline WIT types

In deployment.toml, params types and return_type accept any WIT type inline — including record, variant, enum, and flags, which standard WIT requires to be declared separately. Obelisk extracts them and assigns generated names (t0, t1, …):

params = [
  { name = "point", type = "record { x: u32, y: u32 }" },
]
return_type = "result<variant { found(string), not-found }>"

OCI distribution

JS components can be pushed to and pulled from OCI registries just like WASM components. Obelisk embeds component metadata (type, allowed hosts, env vars, secrets, WIT config) in the OCI image manifest, so component add can reconstruct the deployment entry automatically:

# Push a JS webhook to an OCI registry
obelisk component push --name my_webhook --deployment deployment.toml \
  docker.io/myorg/my-webhook:v1.0.0

# Add the component from OCI (type is auto-detected from manifest metadata)
obelisk component add oci://docker.io/myorg/my-webhook:v1.0.0 \
  --name my_webhook --deployment deployment.toml --locked