Adding in types for purchaseType and recurringCycleLimit fields

[owenhuang88]

Add purchaseType and recurringCycleLimit to DiscountsApi

Background

Follow-up to the admin-web changes in https://github.com/shop/world/pull/411309 and https://github.com/shop/world/pull/411407, which add support for purchase type and recurring cycle limit fields in the discounts plugin.

This PR adds the corresponding types to @shopify/ui-extensions so that discount function settings extensions have access to these new fields in their type contract.

Part of this release plan: https://docs.google.com/document/d/1cchvYA3UEDO2o651f_FgsdRqkBSRJLBO3Ac-EAMGCb8/edit?tab=t.0#heading=h.3twiyx2rdsvm

Changes

• Added PurchaseType type ('one_time_purchase' | 'subscription' | 'both')
• Added purchaseType / updatePurchaseType signals to DiscountsApi
• Added recurringCycleLimit / updateRecurringCycleLimit signals to DiscountsApi
• Added discounts definition to the doc schema (pre-existing gap)

References

• Similar prior PR for discount classes and method: Update API and add observables for discount function settings #3641

[github-actions]

🚨🚨🚨 Docs migration in progress 🚨🚨🚨

We are actively migrating UI extension reference docs to MDX in the areas/platforms/shopify-dev zone of the monorepo. This impacts docs for the following surfaces:

• Admin UI extensions
• App Home
• Checkout UI extensions
• Customer account UI extensions
• POS UI extensions

During this migration, please be aware of the following:

.doc.ts files are being deprecated. Changes to .doc.ts files in this repo will not be reflected in the new MDX-based docs. If you need to update docs for a reference that has already been migrated, make your changes directly in the areas/platforms/shopify-dev zone of the monorepo instead.

Doc comments in .ts source files (the comment blocks above types and functions) are also affected. Generating docs from these comments currently requires a newer version of the @shopify/generate-docs library that isn't yet available. Updates to doc comments may not produce the expected output until the migration is complete.

Examples that previously lived in this repo are being moved to the areas/platforms/shopify-dev zone of the monorepo and should be authored there going forward.

What should I do?

• If your PR includes changes to .doc.ts files, doc comments, or examples, please reach out to us in #devtools-proj-templated-refs so we can help ensure your updates are captured correctly.
• If your PR is limited to source code changes (non-docs), you can ignore this notice.

Thanks for your patience while we complete the migration! 🙏

[owenhuang88]

• Adding in types for purchaseType and recurringCycleLimit fields #4275 👈 (View in Graphite)
• 2026-04

This stack of pull requests is managed by Graphite. Learn more about stacking.

[devisscher]

Nice! This looks good to me. For @vividviolet, we were thinking of adding this as a patch. Owen mentioned this is ok. So we'll put it on 2026-04 branch and do we need to do anything for releasing the new patch?

[vividviolet]

A few things you need to do:

• You need to rebase the branch on 2026-04 since the stable release already went out.
• After the PR is merged to the stable branch
  • Approve and merge the Versions PR that automatically gets created to do a patch release
  • Run the docs:sync command to create a PR to update the docs on shopify.dev

[vividviolet]

Why is this hardcoded to true?

[owenhuang88]

Just for testing convenience with the factory, and following discount classes :)