Bun CommandsTrigger

Bun CommandsTrigger
Certified
Trigger a flow when Bun commands match a condition

Polls by running Bun commands in a script container (default image oven/bun) and emits when exitCondition matches. Edge mode (the default) emits only on a transition from not matching to matching, remembering the previous result in the namespace KV store. Polls every 60s by default. Accepts 'exit N' or a regex (fallback substring) matched against emitted vars; a failed run has no vars, so only 'exit N' can match a failure.

yaml
type: io.kestra.plugin.scripts.bun.CommandsTrigger

Examples

Trigger when commands fail with an implicit error (exit 1).

yaml
id: commands_trigger
namespace: company.team

triggers:
  - id: commands_failure
    type: io.kestra.plugin.scripts.bun.CommandsTrigger
    interval: PT60S
    exitCondition: "exit 1"
    edge: true
    containerImage: oven/bun
    commands:
      - bun run missing.ts

tasks:
  - id: log
    type: io.kestra.plugin.core.log.Log
    message: "Triggered with exitCode={{ trigger.exitCode }} (condition={{ trigger.condition }})"

Properties

commands *array

SubTypestring

Bun commands to execute

Commands executed on each poll (same semantics as the Bun Commands task).

exitCondition *string

Condition to match

Condition evaluated after each commands execution. The trigger emits an event only when this condition matches.

Supported forms:

'exit N' (example: 'exit 1'): matches when the process exit code equals N.
Any other string: treated as a regex (or substring if regex is invalid) matched against the task's 'vars' (when commands emit ::{"outputs": ...}::). On a failed run no vars are available to match against, so only an 'exit N' condition can match a failure.

allowConcurrent boolean

Defaultfalse

Specifies whether a trigger is allowed to start a new execution even if a previous run is still in progress.

containerImage string

Defaultoven/bun

Docker image used to execute the commands

Container image used by the underlying Commands task to run Bun commands. Defaults to 'oven/bun'.

edge booleanstring

Defaulttrue

Edge trigger mode

If true (default), the trigger emits only on a transition from 'not matching' to 'matching' (anti-spam). The previous result is kept in the namespace KV store, keyed by flow and trigger id. If false, the trigger emits on every poll where the condition matches.

interval string

DefaultPT1M

Formatduration

Check interval

Interval between polling evaluations.

stopAfter array

SubTypestring

Possible Values

CREATEDSUBMITTEDRUNNINGPAUSEDRESTARTEDKILLINGSUCCESSWARNINGFAILEDKILLEDCANCELLEDQUEUEDRETRYINGRETRIEDSKIPPEDBREAKPOINTRESUBMITTED

List of execution states after which a trigger should be stopped (a.k.a. disabled).

when string

Defaulttrue

A condition that determines whether the trigger should run.

A Pebble expression evaluated at trigger time. The trigger fires only when the expression evaluates to a truthy value (true, a non-empty string, a non-zero number). Use this to gate trigger execution on dynamic runtime values such as execution labels, flow variables, or environment conditions.

Outputs

condition string

Rendered condition

Rendered value of the exitCondition property for this poll.

exitCode integer

Commands exit code

Exit code returned by the Bun process (may be null if not available).

timestamp string

Formatdate-time

Timestamp of the event that fired the trigger

vars object

Commands vars