com.blockether.vis.internal.automation.core — com.blockether/vis 0.2.30

Automation definitions: validation, storage and the wire shape.

An automation joins triggers, one prompt, one target and delivery options. The runner owns execution; this namespace never starts a turn. Definitions keep the contract spelling: string keys in snake_case.

->wire clj

(->wire {:keys [id definition created_at updated_at webhook_secret
                callback_secret]
         :as row}
        last-run
        now)

The contract shape of one stored automation. Secrets never appear.

create! clj

(create! db input now)

delete! clj

(delete! db id)

describe clj

(describe db id now)

The wire shape of one automation, or a 404 ex-info.

limit clj

(limit k)

One value of the contract x-vis-limits.

list-all clj

(list-all db now)

new-secret clj

(new-secret)

A Standard Webhooks secret: whsec_ and 32 random bytes in base64.

next-fire clj

(next-fire trigger anchor from)

The first fire time of one schedule trigger strictly after from, or nil. anchor is the start of an interval schedule.

next-run-at clj

(next-run-at {:keys [definition created_at]} now)

The next scheduled fire time of an enabled automation after now, or nil.

normalize clj

(normalize definition)

Fill the optional fields of a valid input with their defaults.

not-found! clj

(not-found! what id)

rotate-secret! clj

(rotate-secret! db id kind now)

Create or replace one secret and answer it once.

run clj

(run db run-id)

run->wire clj

(run->wire run automation-name)

run-filter clj

(run-filter {:strs [automation_id status session_id limit]})

The run filter of the wire parameters automation_id, status, session_id and limit. limit defaults to 50 and stays between 1 and 200.

runs clj

(runs db opts)

Runs newest first, with the automation names.

schedule-kinds clj

update! clj

(update! db id patch now)

Replace the given top-level fields and validate the result as a whole.

validate clj

(validate definition now)

Check one complete definition; answer it with defaults. Throws ex-info with :status 400 and a readable message.

webhook-trigger clj

(webhook-trigger definition)