trigger

package

v0.1.0-alpha.3 Latest Latest Go to latest Published: Oct 25, 2026 License: Apache-2.0 Imports: 15 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/githugt/flowi-lib

Links

Open Source Insights

Documentation ¶

Overview ¶

Package trigger is the HTTP interface that starts flow runs:

POST /flows/<flow>/run[?collection=<c>][&wait=<duration>]
GET  /runs/<id>
GET  /healthz

Every route but /healthz needs "Authorization: Bearer <token>". The token is checked before the path is looked at, so a caller without it learns nothing about which flows exist. An address that sends ten bad tokens in a minute is answered 429 until the minute ends.

The endpoint speaks plain HTTP, so the token crosses the network in the clear: keep it on loopback, or put a TLS-terminating proxy in front.

Index ¶

Variables
func New(o Options) (http.Handler, error)
type Options

Constants ¶

This section is empty.

Variables ¶

View Source

var ErrNoToken = errors.New("triggers need a token")

ErrNoToken is returned by New when the token is empty: triggers without authentication are never offered.

Functions ¶

func New ¶

func New(o Options) (http.Handler, error)

New returns the trigger handler.

Types ¶

type Options ¶

type Options struct {
	Token   string
	Runs    *runs.Manager
	MaxWait time.Duration // longest ?wait= honoured (default 5m)
	Logger  *slog.Logger
	Now     func() time.Time // for the failure window (default time.Now)
}

Options configure the handler.

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL