Skip to content

2.16.0: replay edits, destination secrets, bridge and queue destinations, holds, full-list lookups - #11

Merged
cade25wilson merged 7 commits into
mainfrom
feat/sdk-round-2026-11
Nov 12, 2026
Merged

cade25wilson merged 7 commits into
mainfrom
feat/sdk-round-2026-11

Conversation

@cade25wilson

Copy link
Copy Markdown
Contributor

Brings the CLI up to the API as of 2026-11-12 and releases it as 2.16.0.

Fixes for live bugs

  • Slug and name lookups read only the first 100 sources, destinations, routes, transforms or filters, so anything past that was "not found". They now page through every result (stopping at 50 pages with a warning on stderr).
  • destinations update --json and routes update --json printed undefined; they now print the updated resource.

New

  • deliveries replay --patch <json|@file> / --payload <json|@file> (one or the other), --destination and --header, with readable replay error codes. Bulk replay lists ids the API didn't find.
  • Destinations:
    • create prints the one-time signingSecret, also with --json, and in the TUI;
    • get shows hasSigningSecret;
    • new commands destinations reveal-secret <id> and destinations rotate-secret <id> [--grace-period <s>].
  • Destination types: the queue types and bridge, with --event-type, --event-type-field, --event-type-prefix, --application and --allow-unverified-sources (or --config @file). test renders the bridge dry run, and outbound message get shows the bridge hop.
  • Holds: awaiting_retry/held delivery statuses and the full outbound status list, holdExpiresAt, messagesHeld after send, heldCount on route and endpoint get ("10000+" when capped), and --[no-]hold-on-circuit-open on route and endpoint create/update (sent only when given; off dead-letters as soon as the circuit opens).
  • sources create --catalog-provider.

Security

  • A malformed --config @file / send --file no longer echoes file content in the error (V8 quoted about 10 characters of the input); errors give only line and column.
  • @file is capped at 1 MB, and ~ expands to the home directory.

Behaviour notes

  • Source --json output: ipAllowlist, ipDenylist, encryptFields and maskFields are arrays now (API #131).
  • BUGS.md rows H1–H14 record the fixes.

Verification

  • npm run lint (0 errors), npm test (430 passed), npm run build.
  • Independent code review; findings fixed in 810ab4d.

Release: GitHub Release v2.16.0 → npm (NPM_TOKEN), after merge.

🤖 Generated with Claude Code

https://claude.ai/code/session_01HjDaS7Ev5M2d6wEzizwLLS

…d filters

getSources/getDestinations/getRoutes read only the first 100 rows, and
getTransforms/getFilters only the server default of 20. Name/slug
resolution uses these lists, so anything past the first page was
reported as not found. Follow page/pageSize=100 until pagination.total,
an empty or short page, or 50 pages.
…eplay, bulk-replay and delivery fields

deliveries replay read a { delivery } object the API never returns, so the
new delivery id was never shown. bulk-replay read replayed/failed instead of
queued/skipped. List/get read latency and completion from fields that do not
exist. Status colours and help now cover throttled, awaiting_retry and held,
and get shows holdExpiresAt.
create prints the one-time signingSecret (also in --json); get shows
hasSigningSecret and a per-type config view. New reveal-secret and
rotate-secret [--grace-period 0..86400]. --type accepts every API type,
including bridge, with --event-type-source/--event-type/--event-type-field/
--event-type-prefix/--application/--allow-unverified-sources and
--config <json|@file>; update merges bridge flags over the stored config.
test takes --payload and renders a bridge dry run. Fix test reading
statusCode/responseTime instead of status/latencyMs.
Routes and endpoints: --hold-on-circuit-open / --no-hold-on-circuit-open on
create and update (sent only when given; the API default stays hold), and
get shows the setting and heldCount ("10000+" when capped). Outbound:
awaiting_pull, fifo_waiting and held statuses with colours and in --status
help; messages get shows holdExpiresAt and the bridge hop; stats shows Held;
send shows messagesHeld. Routes list shows the circuit instead of an always-0
Deliveries column. Sources: --catalog-provider on create, shown on get.
…ing warning, update --json

- readJsonArg and send --file report only where JSON broke: V8's message
  quotes part of the input, which for a credentials file is a secret.
  @file reads are capped at 1 MB and @~/ expands to the home directory.
- --no-hold-on-circuit-open help: held rows are released, then dead-lettered
  if the circuit is still open. Endpoint get says n/a for FIFO and polling
  endpoints, which never hold; route get notes holds need the circuit breaker.
- Paging ends a short page by the server's reported pageSize, and warns on
  stderr and sets pagination.truncated when it stops at 50 pages.
- destinations/routes update: PATCH answers { success: true }, so --json
  re-reads the resource instead of printing undefined; tests stub the real shape.
- TUI destination create shows the one-time signing secret and waits for Enter.
- Replay shows the API's 404 message (it can be "Event not found"); bulk
  replay lists ids the API did not find.
@cade25wilson
cade25wilson merged commit 8b01728 into main Nov 12, 2026
3 checks passed
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