Custom Triggers

Comparable to: Custom event adapters, webhook receivers

Key Concepts

Use the concepts below when they fit the task. Not every custom trigger needs all of them.

• registerTriggerType(id, handler) defines a new trigger type with registerTrigger and unregisterTrigger callbacks
• The handler receives a TriggerConfig containing id, function_id, and config
• When the external event fires, call iii.trigger({ function_id, payload: event }) to invoke the registered function
• unregisterTriggerType cleans up when the trigger type is no longer needed
• Do not reuse built-in trigger type names: http, cron, durable:subscriber, state, stream, subscribe

Architecture

External event source (webhook, file watcher, IoT, CDC, etc.)
  → Custom trigger handler (registerTriggerType)
    → iii.trigger({ function_id, payload: event })