Redis list — destinations/redis_list

# examples/destinations/redis_list.yaml
#
# Reference config for a Redis / Valkey list destination (redis_list).
#
# redis_list stores webhook payloads as JSON-encoded strings pushed to the
# HEAD of a Redis list via LPUSH. Consumers read with BRPOP (blocking right-pop)
# or RPOP for a simple, FIFO work-queue pattern.
#
# Bounding the list length (LPUSH + LTRIM) is not available from YAML:
#   redis_options.max_len is not a publish-node field. Lists are unbounded
#   unless consumers trim. consumer_group, ttl, and key_template are invalid
#   for redis_list.
#
# Valkey is fully supported; point redis.url at a Valkey node.

server:
  addr: ":8080"
  max_body_bytes: 1048576

destinations:
  events:
    type: redis_list

    redis:
      # ── Single-node / proxy mode (default) ────────────────────────────────
      mode: single          # single | cluster | sentinel
      url: "${REDIS_URL}"   # redis:// or rediss:// URL; set REDIS_URL in env

      # ── Cluster mode (uncomment and populate addrs; remove url) ───────────
      # mode: cluster
      # addrs:
      #   - "redis-1:6379"
      #   - "redis-2:6379"
      #   - "redis-3:6379"

      # ── Sentinel mode (uncomment; remove url; set master_name) ────────────
      # mode: sentinel
      # addrs:
      #   - "sentinel-1:26379"
      #   - "sentinel-2:26379"
      # master_name: "mymaster"

      # ── Optional auth ─────────────────────────────────────────────────────
      # username: "myuser"       # optional; only if your Redis requires auth (or reference an env var you export)
      # password: "mypassword"

      # ── Optional database index (single/sentinel only; cluster ignores it) ─
      # db: 0

      # ── Optional key prefix prepended to every list target ────────────────
      # key_prefix: "hookway"

      # ── Optional TLS (required for rediss:// or private-CA servers) ───────
      # tls:
      #   enabled: false
      #   # For private / self-signed CAs:
      #   # ca_cert: "/etc/ssl/certs/redis-ca.pem"
      #   # Mutual TLS — both must be set together:
      #   # client_cert: "/etc/ssl/certs/redis-client.pem"
      #   # client_key:  "/etc/ssl/private/redis-client.key"
      #   # Override the server's SNI name:
      #   # server_name: "redis.internal"
      #   # Dev only — disables certificate verification; never use in production:
      #   # insecure_skip_verify: false

flows:
  # Webhook events routed to a Redis list. Consumers use BRPOP/RPOP on the
  # list key to dequeue and process messages in FIFO order.
  webhook_events:
    nodes:
      - {id: in, type: http_trigger, path: /webhooks/events, methods: [POST]}
      - {id: body, type: read_body, max_bytes: 1048576}
      - {id: auth, type: auth, scheme: hmac_sha256_hex, secret: "${WEBHOOK_SECRET}", signature_header: X-Hub-Signature-256}
      - {id: env, type: envelope, body_format: json}
      # List key (without the key_prefix, if set). Must match
      # ^[a-zA-Z0-9._-]{1,128}$
      # Previously set redis_options.max_len: 50000 (not a publish-node field).
      # NOTE: consumer_group, ttl, and key_template are NOT valid for
      # redis_list — validation will reject them.
      - {id: out, type: publish, destination: events, target: webhooks.list, create: true}
    edges: [in>body, body>auth, auth>env, env>out]