Skip to content

CEXT-6508: implement webhook configuration updates - #627

Merged
iivvaannxx merged 3 commits into
CEXT-6527/webhooks-lifecycle-reworkfrom
CEXT-6508-webhook-modifications
Aug 20, 2026
Merged

CEXT-6508: implement webhook configuration updates#627
iivvaannxx merged 3 commits into
CEXT-6527/webhooks-lifecycle-reworkfrom
CEXT-6508-webhook-modifications

Conversation

@obarcelonap

@obarcelonap obarcelonap commented Aug 13, 2026 •
edited by iivvaannxx
Loading

Copy link
Copy Markdown
Member

Description

Extends webhook upgrade planning to detect configuration changes when a webhook keeps the same identity. Changes to fields, conditions, headers, URLs, priorities, timeouts, and other mutable settings now produce an update operation.

Commerce treats webhook subscription as a guarded insert rather than an upsert, so apply unsubscribes the current live registration and subscribes the target payload. The resulting snapshot contains the target configuration, while OAuth credentials are sent only to Commerce and are not persisted.

Related Issue

CEXT-6508

Motivation and Context

Previously, webhooks matched by identity were carried forward even when their configuration changed, so config-only changes between app versions were not applied.

How Has This Been Tested?

Added unit coverage for changed and equivalent configurations, update execution, retry behavior, and credential handling, plus integration coverage for the Commerce unsubscribe-and-subscribe flow. Ran the full repository test suite, typecheck, lint, build, OpenAPI lint, and package validation.

Screenshots (if appropriate):

N/A

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)

Checklist:

  • I have signed the Adobe Open Source CLA.
  • My code follows the code style of this project.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.
  • I have read the CONTRIBUTING document.
  • I have read the DEVELOPMENT document.
  • I have added tests to cover my changes.
  • All new and existing tests passed.

@changeset-bot

changeset-bot Bot commented Aug 13, 2026 •
edited
Loading

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 60030a4

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages
Name Type
@adobe/aio-commerce-lib-app Minor
@adobe/aio-commerce-plugin-app-migration Patch
@adobe/aio-commerce-plugin-app-management Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@github-actions github-actions Bot added with-changeset The PR contains a Changeset file. pkg: aio-commerce-lib-app Includes changes in `packages/aio-commerce-lib-app` labels Aug 13, 2026
@obarcelonap obarcelonap changed the title CEXT-6508: implement webhook configuration updates for upgrade planning CEXT-6508: implement webhook configuration updates Aug 13, 2026
@iivvaannxx
iivvaannxx force-pushed the CEXT-6508-webhook-modifications branch from 98341d7 to d1146fd Compare August 19, 2026 20:05
@iivvaannxx
iivvaannxx changed the base branch from main to CEXT-6527/webhooks-lifecycle-rework August 19, 2026 20:05
@iivvaannxx
iivvaannxx force-pushed the CEXT-6508-webhook-modifications branch from 62a6d00 to 5d710f6 Compare August 20, 2026 09:34
@iivvaannxx
iivvaannxx force-pushed the CEXT-6508-webhook-modifications branch from 5d710f6 to 1943e2b Compare August 20, 2026 09:36
@iivvaannxx

iivvaannxx commented Aug 20, 2026

Copy link
Copy Markdown
Collaborator

/snapshot

@github-actions

github-actions Bot commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

📦 Alpha packages published

Package Version
@adobe/aio-commerce-lib-app 2.0.0-alpha-20260820093849
@adobe/aio-commerce-sdk 2.0.0-alpha-20260820093849

Install:

npm install @adobe/aio-commerce-lib-app@2.0.0-alpha-20260820093849
npm install @adobe/aio-commerce-sdk@2.0.0-alpha-20260820093849

You can also install by just specifying the tag:

npm install @adobe/aio-commerce-sdk@alpha

But note that the tag will always point to the latest alpha snapshot, so it may not be the same version as listed above.

@iivvaannxx
iivvaannxx force-pushed the CEXT-6508-webhook-modifications branch from 1943e2b to 08a7303 Compare August 20, 2026 10:20
@iivvaannxx

iivvaannxx commented Aug 20, 2026

Copy link
Copy Markdown
Collaborator

/snapshot

@github-actions

github-actions Bot commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

📦 Alpha packages published

Package Version
@adobe/aio-commerce-lib-app 2.0.0-alpha-20260820102237
@adobe/aio-commerce-sdk 2.0.0-alpha-20260820102237

Install:

npm install @adobe/aio-commerce-lib-app@2.0.0-alpha-20260820102237
npm install @adobe/aio-commerce-sdk@2.0.0-alpha-20260820102237

You can also install by just specifying the tag:

npm install @adobe/aio-commerce-sdk@alpha

But note that the tag will always point to the latest alpha snapshot, so it may not be the same version as listed above.

@iivvaannxx
iivvaannxx force-pushed the CEXT-6508-webhook-modifications branch from 08a7303 to 5aec05d Compare August 20, 2026 10:48
@iivvaannxx

iivvaannxx commented Aug 20, 2026

Copy link
Copy Markdown
Collaborator

/snapshot

@github-actions

github-actions Bot commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

📦 Alpha packages published

Package Version
@adobe/aio-commerce-lib-app 2.0.0-alpha-20260820105026
@adobe/aio-commerce-sdk 2.0.0-alpha-20260820105026

Install:

npm install @adobe/aio-commerce-lib-app@2.0.0-alpha-20260820105026
npm install @adobe/aio-commerce-sdk@2.0.0-alpha-20260820105026

You can also install by just specifying the tag:

npm install @adobe/aio-commerce-sdk@alpha

But note that the tag will always point to the latest alpha snapshot, so it may not be the same version as listed above.

@iivvaannxx
iivvaannxx force-pushed the CEXT-6508-webhook-modifications branch from 5aec05d to ea34f3f Compare August 20, 2026 11:01
@iivvaannxx
iivvaannxx force-pushed the CEXT-6508-webhook-modifications branch from ea34f3f to c6932f1 Compare August 20, 2026 11:02
@iivvaannxx
iivvaannxx force-pushed the CEXT-6508-webhook-modifications branch from c6932f1 to b24029e Compare August 20, 2026 11:49
@iivvaannxx
iivvaannxx force-pushed the CEXT-6508-webhook-modifications branch 2 times, most recently from 1cd7413 to c7785e1 Compare August 20, 2026 11:54
@iivvaannxx

iivvaannxx commented Aug 20, 2026

Copy link
Copy Markdown
Collaborator

/snapshot

@github-actions

github-actions Bot commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

📦 Alpha packages published

Package Version
@adobe/aio-commerce-lib-app 2.0.0-alpha-20260820115733
@adobe/aio-commerce-sdk 2.0.0-alpha-20260820115733

Install:

npm install @adobe/aio-commerce-lib-app@2.0.0-alpha-20260820115733
npm install @adobe/aio-commerce-sdk@2.0.0-alpha-20260820115733

You can also install by just specifying the tag:

npm install @adobe/aio-commerce-sdk@alpha

But note that the tag will always point to the latest alpha snapshot, so it may not be the same version as listed above.

@iivvaannxx
iivvaannxx force-pushed the CEXT-6508-webhook-modifications branch from c7785e1 to 390b443 Compare August 20, 2026 12:24
@iivvaannxx

iivvaannxx commented Aug 20, 2026

Copy link
Copy Markdown
Collaborator

/snapshot

@github-actions

github-actions Bot commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

📦 Alpha packages published

Package Version
@adobe/aio-commerce-lib-app 2.0.0-alpha-20260820122858
@adobe/aio-commerce-sdk 2.0.0-alpha-20260820122858

Install:

npm install @adobe/aio-commerce-lib-app@2.0.0-alpha-20260820122858
npm install @adobe/aio-commerce-sdk@2.0.0-alpha-20260820122858

You can also install by just specifying the tag:

npm install @adobe/aio-commerce-sdk@alpha

But note that the tag will always point to the latest alpha snapshot, so it may not be the same version as listed above.

@iivvaannxx
iivvaannxx force-pushed the CEXT-6508-webhook-modifications branch from 390b443 to b424ca1 Compare August 20, 2026 12:46
obarcelonap and others added 3 commits August 20, 2026 14:57
@obarcelonap @iivvaannxx
CEXT-6508: implement webhook configuration updates for upgrade planning
f8f0d35 
Extend the webhooks domain's upgrade plan/apply to detect field-level config
changes (fields, rules/conditions, headers, url, priority, timeouts, etc.) for
webhooks whose identity is unchanged between the installed and target app
versions, and update only the affected properties in place. Commerce's
subscribe endpoint is a guarded insert (not an upsert), so applying an update
unsubscribes the live identity before resubscribing with the desired payload,
mirroring the sequence already used for renames.
@iivvaannxx
fix webhook update release note
121b175 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@iivvaannxx
validate webhook type and method
60030a4 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@iivvaannxx
iivvaannxx force-pushed the CEXT-6508-webhook-modifications branch from b424ca1 to 60030a4 Compare August 20, 2026 12:57
@iivvaannxx
iivvaannxx merged commit e5cbdf1 into main Aug 20, 2026
8 of 10 checks passed
@iivvaannxx
iivvaannxx deleted the CEXT-6508-webhook-modifications branch August 20, 2026 13:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@mariam21arauj mariam21arauj mariam21arauj approved these changes

Assignees

No one assigned

Labels

pkg: aio-commerce-lib-app Includes changes in `packages/aio-commerce-lib-app` plugin: aio-commerce-plugin-app-management plugin: aio-commerce-plugin-app-migration with-changeset The PR contains a Changeset file.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@obarcelonap @iivvaannxx @mariam21arauj