Skip to content
ContractSpec
Start here

Package manual · integrations

·Delivery, infrastructure and runtime operations

integration.lssm-os-queue-sqs

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

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

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

Package guide

Optional Amazon SQS and SQS-compatible wake-up acceleration for an existing SQL-authoritative LSSM OS DurableQueuePortV2. The adapter calls SQL first for admission, always obtains claims and effect fences from SQL, and deletes an SQS message only after a validated durable SQL acknowledgement.

SQS messages contain an immutable envelope identifier/digest and outbox identifier/digest only. Queue payloads, provider results, credentials, claims, and Runtime Node fences never enter SQS. Delivery is therefore at-least-once; duplicates and transport loss are harmless wake-up conditions. When SQS is unavailable, consumers continue with bounded SQL polling.

The package accepts a static structural client rather than loading an SDK or reading credentials. Production composition must inject an exact digest-valid sqs capability profile, distinct SQL and SQS component bindings, and a qualified queue URL. AWS SDK, Scaleway SQS, LocalStack, and other compatible clients can be wrapped outside this package without expanding its authority.

Relationships

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

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

3 declarations

Declared capabilities

SQS queue wake-up transport

Use Amazon SQS or a compatible service as at-least-once wake-up acceleration over a SQL-authoritative LSSM OS durable queue.

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
  • testbun test
  • typechecktsgo --noEmit