Skip to content

chore(pos): remove deprecated .observe event extension targets#4535

Merged
vctrchu merged 2 commits into
2026-07-rcfrom
pos-delete-observe-targets
Jul 2, 2026
Merged

chore(pos): remove deprecated .observe event extension targets#4535
vctrchu merged 2 commits into
2026-07-rcfrom
pos-delete-observe-targets

Conversation

@vctrchu

@vctrchu vctrchu commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

What

Removes the four POS .observe event extension targets and their exclusive payload types:

  • pos.transaction-complete.event.observe
  • pos.cash-tracking-session-start.event.observe
  • pos.cash-tracking-session-complete.event.observe
  • pos.cart-update.event.observe

Why

These were early-access targets, deprecated and marked @private in #4146. Runtime telemetry over the last 30 days shows almost no usage: three of them had zero events, and transaction-complete had 4 initializations from a single known early-access partner shop. The replacement target, pos.app.ready.data, ships in this version line.

image

Migration

Removed target Replacement on pos.app.ready.data
pos.transaction-complete.event.observe shopify.addEventListener('transactioncomplete', callback)
pos.cash-tracking-session-start.event.observe shopify.addEventListener('cashtrackingsessionstart', callback)
pos.cash-tracking-session-complete.event.observe shopify.addEventListener('cashtrackingsessioncomplete', callback)
pos.cart-update.event.observe shopify.cart.current.subscribe()

Notes

  • Also removes the EventExtensionTargets / EventExtensionTarget types and the TransactionCompleteData, CashTrackingSessionStartData, CashTrackingSessionCompleteData, and CartUpdateEventData payload types. The receipt-target type TransactionCompleteWithReprintData is unchanged.
  • ui-extensions-tester mock factories for these targets are removed.
  • Generated reference docs under docs/.../generated are produced by the docs pipeline and aren't regenerated here.

Part of https://github.com/shop/issues-retail/issues/31540

Remove the four early-access POS .observe targets (transaction-complete,
cash-tracking-session-start, cash-tracking-session-complete, cart-update)
and their exclusive payload types. Replacement is the pos.app.ready.data
background target with addEventListener / cart.current.subscribe().

Assisted-By: devx/8ba453a3-96d0-4701-a8cc-43c4651bd027
@vctrchu vctrchu requested a review from mcvinci June 30, 2026 23:42
@vctrchu vctrchu self-assigned this Jun 30, 2026
@vctrchu vctrchu requested a review from a team June 30, 2026 23:48
@vctrchu vctrchu merged commit d70009a into 2026-07-rc Jul 2, 2026
6 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.

3 participants