feat(v1.1.9): TriggerEvent::Queue + TriggerKind::Queue + types

Add the data-shape pieces for v1.1.9's queue surface; behavior lands in
later commits. Each piece compiles independently.

- shared/trigger_event.rs: TriggerEvent::Queue variant (queue_name,
  message, enqueued_at, attempt, message_id). source() returns "queue".
  Surfaced to scripts as ctx.event.queue with op = "receive".
- manager-core/trigger_repo.rs: TriggerKind::Queue + TriggerDetails::Queue +
  CreateQueueTrigger + ActiveQueueConsumer + QueueDetailRow + QueueConsumerRow.
  PostgresTriggerRepo gains create_queue_trigger (advisory-lock-then-SELECT
  enforces one-consumer-per-queue), list_active_queue_consumers (dispatcher
  scan), touch_queue_trigger_last_fired_at. hydrate_one hydrates the Queue arm.
- manager-core/outbox_repo.rs: OutboxSourceKind::Invoke for invoke_async()
  outbox rows.
- manager-core/dispatcher.rs: placeholder OutboxSourceKind::Invoke arm (logs +
  drops the row) so the workspace compiles; real arm lands in commit 10.
- manager-core/trigger_config.rs: queue_reclaim_interval_ms (30000) +
  queue_default_visibility_timeout_secs (30) env-overridable knobs.
- executor-core/engine.rs: trigger_event_to_dynamic handles Queue → builds
  ctx.event.queue map.
- manager-core/triggers_api.rs: in-memory mock TriggerRepo gains the three
  new methods (returns Default-ish values for tests).

Unit tests: TriggerEvent::Queue serde round-trip, TriggerKind::Queue wire
round-trip, advisory_lock_key stability per (app_id, queue_name) pair.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
MechaCat02
2026-06-06 19:08:21 +02:00
parent 4054af41ed
commit 9ce3c4c704
7 changed files with 453 additions and 0 deletions

View File

@@ -207,6 +207,17 @@ pub enum TriggerEvent {
message_id: Option<String>,
},
/// A queue:receive trigger fired this handler. v1.1.9. Surfaced to
/// scripts as `ctx.event.queue`. `attempt` is 1-based — it's the
/// current delivery attempt (increments per nack-and-retry).
Queue {
queue_name: String,
message: serde_json::Value,
enqueued_at: DateTime<Utc>,
attempt: u32,
message_id: String,
},
/// A dead-letter row fired this handler. The original event is
/// nested verbatim plus the dead-letter metadata the design notes
/// §4 require.
@@ -235,6 +246,7 @@ impl TriggerEvent {
Self::Files { .. } => "files",
Self::Pubsub { .. } => "pubsub",
Self::Email { .. } => "email",
Self::Queue { .. } => "queue",
Self::DeadLetter { .. } => "dead_letter",
}
}
@@ -254,3 +266,49 @@ pub struct DeadLetterEventDetail {
pub first_attempt_at: DateTime<Utc>,
pub last_attempt_at: DateTime<Utc>,
}
#[cfg(test)]
mod queue_event_tests {
use super::*;
#[test]
fn queue_event_round_trip_serde() {
let original = TriggerEvent::Queue {
queue_name: "payments.process".into(),
message: serde_json::json!({ "order_id": 123, "amount": 4999 }),
enqueued_at: DateTime::parse_from_rfc3339("2026-06-06T12:00:00Z")
.unwrap()
.with_timezone(&Utc),
attempt: 2,
message_id: "01234567-89ab-cdef-0123-456789abcdef".into(),
};
let wire = serde_json::to_value(&original).unwrap();
assert_eq!(wire["source"], "queue");
assert_eq!(wire["queue_name"], "payments.process");
assert_eq!(wire["attempt"], 2);
let back: TriggerEvent = serde_json::from_value(wire).unwrap();
match back {
TriggerEvent::Queue {
queue_name,
attempt,
..
} => {
assert_eq!(queue_name, "payments.process");
assert_eq!(attempt, 2);
}
other => panic!("expected Queue, got {other:?}"),
}
}
#[test]
fn queue_source_discriminant() {
let event = TriggerEvent::Queue {
queue_name: "x".into(),
message: serde_json::Value::Null,
enqueued_at: Utc::now(),
attempt: 1,
message_id: "id".into(),
};
assert_eq!(event.source(), "queue");
}
}