Skip to content

New Event Queues Docs#2431

Draft
sjvans wants to merge 5 commits intomainfrom
event-queues
Draft

New Event Queues Docs#2431
sjvans wants to merge 5 commits intomainfrom
event-queues

Conversation

@sjvans
Copy link
Copy Markdown
Contributor

@sjvans sjvans commented Mar 3, 2026

No description provided.

@sjvans sjvans changed the title first draft of new event queues docs New Event Queues Docs Mar 17, 2026
:::


### Callbacks (SAGA Patterns) { #callbacks }
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Node.js only


[[toc]]


Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

general issue: "queued" vs "outboxed" and "unqueued" vs "unboxed" in Node.js/ Java




### Service API { #service-api }
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

more pseudo code style

|-----|-------------|
| `srv.emit(event, data)` | Emit a fire-and-forget event message |
| `srv.send(event, data)` | Send a request (return value discarded for queued services) |
| `srv.run(query)` | Run a CQL query (return value discarded for queued services) |
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

.run needed here?

:::


### Background Tasks { #background-tasks }
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

java variant missing

```


### Queueing by Configuration { #by-configuration }
Copy link
Copy Markdown
Contributor Author

@sjvans sjvans Apr 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

remove

:::


### Auto-Outboxed Services { #auto-outboxed }
Copy link
Copy Markdown
Contributor Author

@sjvans sjvans Apr 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • "outboxed by default"
  • plus: inboxed by default (which nothing is, but should maybe be mentioned here as well)

Because the event message is written within the same database transaction as your business data, a rollback of the transaction also removes the event message.
No event is ever dispatched for a transaction that didn't commit.

### Guaranteed Order { #guaranteed-order }
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

remove

:::


### Error Handling { #errors }
Copy link
Copy Markdown
Contributor Author

@sjvans sjvans Apr 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Node.js vs Java not prominent enough
  • add example in context of existing service, such as intercept audit logging
  • Java doesn't yet have concept of unrecoverable errors that become dead letters (pr currently pending review)




## Deferred Principal Propagation { #principal-propagation }
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

remove and re-add once we know how it works




## Configuration
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

streamline

| `ordered` | `true` | Process entries in submission order |


### In-Memory Queue
Copy link
Copy Markdown
Contributor Author

@sjvans sjvans Apr 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

remove?




## Manual Processing { #flush }
Copy link
Copy Markdown
Contributor Author

@sjvans sjvans Apr 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

remove? or add java? what's the use case for stakeholders? flushing is automatic...

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant