events.iterate.com

Event type

events.iterate.com/stream/connection-opened

A live connection from this stream to a processEventBatch callback opened. Appended by the stream itself once per actual open; reconnecting after a transient break is a new connection. Ephemeral: runtime connection state is authoritative for presence, and a reconnect storm against a crash-looping host must not grow the durable journal (the 2026-08-11 revival death spiral journaled ~1500 durable open/close facts per revival cycle, making every replay heavier than the last).

Payload schema

connectionKeystring
kind"session" | "hosted"
openedByobjectoptional
descriptionstringoptional
userobjectoptional
idstringoptional
emailstring
namestringoptional
picturestringoptional
processorobjectoptional
announcementobject
slugstring
versionstring
descriptionstring
consumesstring[]
emitsstring[]
ownedEventsobject[]
typestring
descriptionstringoptional
Raw JSON schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "connectionKey": {
      "type": "string",
      "minLength": 1
    },
    "kind": {
      "type": "string",
      "enum": [
        "session",
        "hosted"
      ]
    },
    "openedBy": {
      "type": "object",
      "properties": {
        "description": {
          "type": "string"
        },
        "user": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "minLength": 1
            },
            "email": {
              "type": "string",
              "minLength": 1
            },
            "name": {
              "type": "string",
              "minLength": 1
            },
            "picture": {
              "type": "string",
              "minLength": 1
            }
          },
          "required": [
            "email"
          ]
        },
        "processor": {
          "type": "object",
          "properties": {
            "announcement": {
              "type": "object",
              "properties": {
                "slug": {
                  "type": "string",
                  "minLength": 1
                },
                "version": {
                  "type": "string",
                  "minLength": 1
                },
                "description": {
                  "type": "string"
                },
                "consumes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "emits": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "ownedEvents": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string",
                        "minLength": 1
                      },
                      "description": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "type"
                    ]
                  }
                }
              },
              "required": [
                "slug",
                "version",
                "description",
                "consumes",
                "emits",
                "ownedEvents"
              ]
            }
          },
          "required": [
            "announcement"
          ]
        }
      }
    }
  },
  "required": [
    "connectionKey",
    "kind"
  ]
}