edge.forms.takoform.com/AtLeastOnceQueue@0.1.0

At-Least-Once Queue

Buffer messages for unordered, at-least-once delivery.

Public package readback verified

Host support and admission are separate from package publication. These fields describe portable desired state, not a provider-specific deployment command.

How it fits

Retention is required; delivery delay defaults to zero. A queue has at most one consumer. Producers and inbound consumption are configured separately.

Works with: Queue Consumer · Worker Version

Full contract description

Message queue with at-least-once delivery and no ordering guarantee, exactly as fixed by the edge.queue Interface. There is no ordering field: a FIFO queue is a different Form. Message bodies are opaque bytes, a message identity is stable across redeliveries, and a queue has AT MOST ONE consumer — two would split the stream between two retry policies and two dead-letter destinations, which leaves the queue's own behavior unstatable (decision 0020).

Kind: AtLeastOnceQueue
Definition version: 0.1.0
Role: identity

Desired state

deliveryDelaySecondsOptional · integer: Default delay before a sent message becomes deliverable, in seconds. Omitting it delivers immediately.
default: 0
maximum: 43200
minimum: 0
messageRetentionSecondsRequired · integer: How long an undelivered message is retained before it is dropped, in seconds.
maximum: 1209600
minimum: 60

Example desired state

This is the exact fixtures/desired.json from this package, not a complete Host API request or OpenTofu configuration. Replace example resource references and artifact digests with your own; it does not provision anything by itself.

{
  "deliveryDelaySeconds": 0,
  "messageRetentionSeconds": 345600
}

Read source fixture

Full desired-state schema

Nested fields, allowed alternatives and all schema constraints. Host-validated semantics also apply; read the contract description above.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "description": "Message queue with at-least-once delivery and no ordering guarantee, exactly as fixed by the edge.queue Interface. There is no ordering field: a FIFO queue is a different Form. Message bodies are opaque bytes, a message identity is stable across redeliveries, and a queue has AT MOST ONE consumer — two would split the stream between two retry policies and two dead-letter destinations, which leaves the queue's own behavior unstatable (decision 0020).",
  "properties": {
    "deliveryDelaySeconds": {
      "default": 0,
      "description": "Default delay before a sent message becomes deliverable, in seconds. Omitting it delivers immediately.",
      "maximum": 43200,
      "minimum": 0,
      "type": "integer"
    },
    "messageRetentionSeconds": {
      "description": "How long an undelivered message is retained before it is dropped, in seconds.",
      "maximum": 1209600,
      "minimum": 60,
      "type": "integer"
    }
  },
  "required": [
    "messageRetentionSeconds"
  ],
  "title": "At-Least-Once Queue desired state",
  "type": "object"
}

Lifecycle

create
read
update
delete
import
observe

Provided interfaces

edge.queue@1.0.0sha256:d8ed5c673cb544f5b2bd61aa66ac1c1a716276cf072232b3a0d06471403c2ff7

Canonical package locator

Package digest: sha256:6777eacc4ce141342f97f4bb06e2adaeb714461c0f2f91226f7f4c6f1a0c19b9
Schema digest: sha256:0355b4d3073bc2707fccb6edd8c90350892059ecf08abfec00a00d950c9eaa0e
Tag: forms/k-mvsgozjomzxxe3ltfz2gc23pmzxxe3jomnxw2l2borggkyltorhw4y3fkf2wk5lf/sha256-6777eacc4ce141342f97f4bb06e2adaeb714461c0f2f91226f7f4c6f1a0c19b9
Source path: forms/releases/k-mvsgozjomzxxe3ltfz2gc23pmzxxe3jomnxw2l2borggkyltorhw4y3fkf2wk5lf/sha256-6777eacc4ce141342f97f4bb06e2adaeb714461c0f2f91226f7f4c6f1a0c19b9
Signed set: e7f8a39311dd011b8467e97e7f300cabb9a6b06c

Open immutable package

Four-field FormRef

{
  "apiVersion": "edge.forms.takoform.com",
  "kind": "AtLeastOnceQueue",
  "definitionVersion": "0.1.0",
  "schemaDigest": "sha256:0355b4d3073bc2707fccb6edd8c90350892059ecf08abfec00a00d950c9eaa0e"
}