Table of Contents

Organization lifecycle events

Last updated:

Helium defines committed post-transaction facts for material organization transitions. Consumer handlers run after commit with at-least-once delivery.

Warning

OrganizationCreated is produced by the implemented onboarding foundation. Membership-change, ownership-transfer, invitation communication, cache invalidation, and complete WS-005 reaction readiness remain in progress.

Supported facts

  • OrganizationCreated after successful first-organization onboarding.
  • OrganizationMembershipChanged after invitation acceptance, role change, or member removal.
  • OrganizationOwnershipTransferred after successful ownership transfer.

Event identity remains stable across retries and duplicate delivery. Payloads contain approved public identifiers and values, not persistence entities, tokens, cookie state, provider SDK objects, or internal authorization details.

Transaction boundary

Authoritative organization state and required outbox work commit atomically. Rolled-back transitions create no executable lifecycle or communication work. Consumer handler failure cannot roll back committed framework state.

Handler responsibilities

Consumer handlers use independent consumer-owned transactions, tolerate duplicate delivery, use event identity for idempotency, and avoid treating delivery order as globally guaranteed.