From e5b7837c91f1e4e8218d852248c74f387e291baf Mon Sep 17 00:00:00 2001
From: Henry Stelle <henry.stelle@shopify.com>
Date: Mon, 17 Aug 2026 16:14:07 -0700
Subject: [PATCH] Add POS Resolution API types

---
 .changeset/pos-resolution-api.md              |  5 +++++
 .../src/surfaces/point-of-sale/api.ts         |  4 ++++
 .../api/resolution-api/resolution-api.ts      | 21 +++++++++++++++++++
 3 files changed, 30 insertions(+)
 create mode 100644 .changeset/pos-resolution-api.md
 create mode 100644 packages/ui-extensions/src/surfaces/point-of-sale/api/resolution-api/resolution-api.ts

diff --git a/.changeset/pos-resolution-api.md b/.changeset/pos-resolution-api.md
new file mode 100644
index 0000000000..97bae8ace1
--- /dev/null
+++ b/.changeset/pos-resolution-api.md
@@ -0,0 +1,5 @@
+---
+'@shopify/ui-extensions': minor
+---
+
+Add the POS Resolution API types.
diff --git a/packages/ui-extensions/src/surfaces/point-of-sale/api.ts b/packages/ui-extensions/src/surfaces/point-of-sale/api.ts
index 78845cb465..8427e561a3 100644
--- a/packages/ui-extensions/src/surfaces/point-of-sale/api.ts
+++ b/packages/ui-extensions/src/surfaces/point-of-sale/api.ts
@@ -20,6 +20,10 @@ export type {
   ExtensionApiContent,
 } from './api/extension-api/extension-api';
 export type {ActionTargetApi} from './api/action-target-api/action-target-api';
+export type {
+  ResolutionApi,
+  ResolutionApiContent,
+} from './api/resolution-api/resolution-api';
 export type {DataTargetApi} from './api/data-target-api/data-target-api';
 export type {
   TransactionCompleteEvent,
diff --git a/packages/ui-extensions/src/surfaces/point-of-sale/api/resolution-api/resolution-api.ts b/packages/ui-extensions/src/surfaces/point-of-sale/api/resolution-api/resolution-api.ts
new file mode 100644
index 0000000000..15e22bf83f
--- /dev/null
+++ b/packages/ui-extensions/src/surfaces/point-of-sale/api/resolution-api/resolution-api.ts
@@ -0,0 +1,21 @@
+import type {ReadonlySignalLike} from '../../../../shared';
+import type {ShopifyInterceptMap} from '../../events';
+
+/**
+ * Provides access to the intercepted workflow that initiated a resolution flow.
+ *
+ * @private
+ */
+export interface ResolutionApiContent {
+  /** The intercepted workflow event being resolved. */
+  event: ReadonlySignalLike<ShopifyInterceptMap[keyof ShopifyInterceptMap]>;
+}
+
+/**
+ * Provides access to the current resolution context.
+ *
+ * @private
+ */
+export interface ResolutionApi {
+  resolution: ResolutionApiContent;
+}