Skip to content
ContractSpec
Start here

Package manual · integrations

·Delivery, infrastructure and runtime operations

integration.lssm-os-queue-rabbitmq

SQL-authoritative RabbitMQ wake-up transport for LSSM OS durable queues.

integrationsintegrationv2.0.4experimentalserverbunnode
@lssm-tech/integration.lssm-os-queue-rabbitmq
bun add @lssm-tech/integration.lssm-os-queue-rabbitmq
Package source ↗Manifest ↗

Manifest declarations describe the current workspace; they do not verify registry publication or runtime execution.

Package guide

Optional RabbitMQ quorum-queue wake-up acceleration for an existing SQL-authoritative LSSM OS durable queue. The adapter requires publisher confirms, manual consumer acknowledgements, dead lettering, and an exact qualification-bound vhost/exchange/queue/routing identity.

SQL remains the only durable admission, claim, fence, reconciliation, and effect completion authority. RabbitMQ messages carry only immutable envelope and outbox identifiers/digests. A broker delivery is acknowledged only after the corresponding SQL acknowledgement is valid and durable. Malformed messages are negatively acknowledged without requeue so a qualified dead-letter policy can contain poison.

The package accepts a static structural channel. It does not load an AMQP SDK, connection URL, credential, or arbitrary module. Broker loss degrades to SQL polling; publisher-confirm ambiguity is reconciled from the SQL outbox.

Run bun run qualify:local after pulling rabbitmq:4.3.5-management-alpine for exact standalone local-live evidence. The qualification-only amqplib client declares durable exchanges, a quorum work queue, a quorum dead-letter queue, manual acknowledgements, bounded prefetch, a delivery limit, and mandatory publishing. It proves confirmed publish, unroutable return, durable-ack ordering, unacked consumer-death redelivery, poison dead lettering, broker state restart persistence, dynamic Docker port recovery, and SQL-authoritative claim fallback while the broker is stopped.

The disposable broker binds only an ephemeral 127.0.0.1 AMQP port, uses an ephemeral generated credential and vhost, persists state in an exact temporary host directory, and removes both the container and directory on every exit path. This is single-node local-live evidence; multi-node quorum leader loss, minority partitions, TLS, production vhost/user policies, sustained scale, and managed operations remain release blockers.

Relationships

THIS PACKAGEintegration.lssm-os-queue-rabbitmq7 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

2 declarations

Declared capabilities

RabbitMQ queue wake-up transport

Use qualified RabbitMQ quorum queues for wake-up acceleration while SQL remains authoritative for durable LSSM OS work and effects.

Scripts

  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • lint:checknode ../../../scripts/biome.cjs check .
  • pack:verifybun run build && bun scripts/verify-pack.ts
  • qualify:localbun scripts/qualify-rabbitmq-local.ts
  • testbun test
  • typechecktsgo --noEmit
  • typecheck:qualificationtsgo --noEmit -p tsconfig.qualification.json