@keystrokehq/shopify 0.0.15 → 0.0.16-integration-id-canonicalization.0

package/README.md

@@ -1,35 +1,25 @@
 # @keystrokehq/shopify
 
-Shopify Admin API integration for Keystroke workflows.
+Shopify Admin API integration for Keystroke workflows. The package follows the canonical Playbook 18 **strict** shape: credential sets and operations are discovered from source primitives, while `src/provider-apps/` retains the platform provider-app seed descriptor.
 
-The package root is intentionally non-canonical. Import from explicit subpaths.
+Per-store `SHOPIFY_STORE_DOMAIN` and `SHOPIFY_ACCESS_TOKEN` fields are required on the user credential set. OAuth uses shop-domain templating via `src/utils/oauth-connection.ts`. Webhook subscription helpers live in `src/utils/webhook-management.ts` (not catalog operations).
 
 ## Public Subpaths
 
-- `@keystrokehq/shopify/connection`
-- `@keystrokehq/shopify/client`
+- `@keystrokehq/shopify` — root barrel (`credential-sets`, `operations`, `schemas`)
+- `@keystrokehq/shopify/credential-sets`
+- `@keystrokehq/shopify/operations`
 - `@keystrokehq/shopify/schemas`
-- `@keystrokehq/shopify/events`
-- `@keystrokehq/shopify/shop`
-- `@keystrokehq/shopify/products`
-- `@keystrokehq/shopify/collections`
-- `@keystrokehq/shopify/orders`
-- `@keystrokehq/shopify/customers`
-- `@keystrokehq/shopify/blogs`
-- `@keystrokehq/shopify/articles`
-- `@keystrokehq/shopify/locations`
-- `@keystrokehq/shopify/inventory`
-- `@keystrokehq/shopify/fulfillments`
-- `@keystrokehq/shopify/triggers`
+- `catalog discovery via `src/provider-apps/`` — provider seed descriptor only
 
 ## Read Store Data
 
 ```ts
 import { Workflow } from '@keystrokehq/core';
 import { z } from 'zod';
-import { shopify } from '@keystrokehq/shopify/connection';
-import { getShop } from '@keystrokehq/shopify/shop';
-import { listProducts } from '@keystrokehq/shopify/products';
+import { shopifyCredentialSet } from '@keystrokehq/shopify/credential-sets';
+import { getShopOperation } from '@keystrokehq/shopify/operations';
+import { listProductsOperation } from '@keystrokehq/shopify/operations';
 
 export const syncCatalog = new Workflow({
   id: 'sync-shopify-catalog',
@@ -40,139 +30,10 @@ export const syncCatalog = new Workflow({
     storeName: z.string(),
     productCount: z.number(),
   }),
-  run: async () => {
-    const store = await getShop.run({});
-    const products = await listProducts.run({
-      first: 25,
-      query: 'status:active',
-    });
-
-    return {
-      credentialSetId: shopify.resolvedCredentialSetId,
-      storeName: store.name,
-      productCount: products.nodes.length,
-    };
-  },
-});
-```
-
-## Create Orders And Adjust Inventory
-
-```ts
-import { Workflow } from '@keystrokehq/core';
-import { z } from 'zod';
-import { createOrder } from '@keystrokehq/shopify/orders';
-import { adjustInventoryQuantities } from '@keystrokehq/shopify/inventory';
-
-export const backofficeWriteFlow = new Workflow({
-  id: 'shopify-backoffice-write-flow',
-  name: 'Shopify Backoffice Write Flow',
-  input: z.object({ variantId: z.string(), inventoryItemId: z.string(), locationId: z.string() }),
-  output: z.object({ queued: z.boolean() }),
-  run: async (input) => {
-    await createOrder.run({
-      currency: 'USD',
-      email: 'buyer@example.com',
-      lineItems: [
-        {
-          variantId: input.variantId,
-          quantity: 1,
-        },
-      ],
-    });
-
-    await adjustInventoryQuantities.run({
-      reason: 'correction',
-      referenceDocumentUri: 'gid://keystroke/inventory-adjustment/docs-example',
-      changes: [
-        {
-          inventoryItemId: input.inventoryItemId,
-          locationId: input.locationId,
-          delta: -1,
-        },
-      ],
-    });
-
-    return { queued: true };
-  },
+  steps: [
+    getShopOperation.asStep('shop'),
+    listProductsOperation.asStep('products'),
+  ],
+  credentialSets: [shopifyCredentialSet],
 });
 ```
-
-## Bind Webhook Triggers
-
-```ts
-import { Workflow } from '@keystrokehq/core';
-import { z } from 'zod';
-import { webhooks } from '@keystrokehq/shopify/triggers';
-
-const orderCreated = webhooks.orderCreated({
-  name: 'Shopify Order Created',
-  transform: (event) => ({
-    orderId: event.resourceId ?? event.payload.admin_graphql_api_id ?? '',
-    topic: event.topic,
-  }),
-});
-
-export const onNewShopifyOrder = new Workflow({
-  id: 'on-new-shopify-order',
-  name: 'On New Shopify Order',
-  input: z.object({
-    orderId: z.string(),
-    topic: z.literal('orders/create'),
-  }),
-  output: z.object({ ok: z.boolean() }),
-  triggers: [orderCreated],
-  run: async () => ({ ok: true }),
-});
-```
-
-## Notes
-
-- Mutating operations are marked with `needsApproval: true`.
-- Shopify webhook helpers are direct-binding surfaces under `@keystrokehq/shopify/triggers`.
-- Hidden `_official` and `_runtime` exports are for repo internals, not workflow authoring.
-
-## Live Test Runbook
-
-The Shopify package now has dedicated `test:int` coverage for every exported operation plus live webhook subscription management:
-
-- `shop.int.test.ts`
-- `products.int.test.ts`
-- `collections.int.test.ts`
-- `customers.int.test.ts`
-- `blogs.int.test.ts`
-- `articles.int.test.ts`
-- `orders.int.test.ts`
-- `inventory.int.test.ts`
-- `locations.int.test.ts`
-- `fulfillments.int.test.ts`
-- `webhook-management.int.test.ts`
-
-Set up `.env.test` with at least:
-
-- `RUN_LIVE_INT=true`
-- `SHOPIFY_LIVE_STORE_DOMAIN`
-- `SHOPIFY_LIVE_ACCESS_TOKEN`
-- `SHOPIFY_LIVE_REFRESH_TOKEN` for control-plane refresh coverage
-- `PUBLIC_SERVER_URL` for webhook subscription coverage
-- `KEYSTROKE_OFFICIAL_SHOPIFY_APP_ID`
-- `KEYSTROKE_OFFICIAL_SHOPIFY_CLIENT_ID`
-- `KEYSTROKE_OFFICIAL_SHOPIFY_CLIENT_SECRET`
-- `KEYSTROKE_OFFICIAL_SHOPIFY_WEBHOOK_SECRET`
-
-Recommended execution flow:
-
-```bash
-pnpm test:int:wiring
-pnpm --filter @keystrokehq/shopify test:int
-pnpm --filter @keystroke/server test:int
-pnpm --filter @keystroke/control-plane test:int
-```
-
-Operational guidance:
-
-- Use a dedicated disposable dev store. `orders`, `inventory`, `fulfillments`, and webhook tests are destructive by design.
-- Keep `PUBLIC_SERVER_URL` pointed at a real public tunnel or staging URL when exercising webhook subscription or OAuth callback flows.
-- The package test helpers try to clean up created products, collections, blogs, articles, and order-free customers automatically.
-- Orders with fulfillment history and customers with placed orders should be treated as disposable-store artifacts rather than shared-environment fixtures.
-- Shopify webhook subscription management requires `read_webhooks` and `write_webhooks` scopes in addition to the Admin API scopes used by the operation surface.

package/dist/{schemas.d.mts → common-C2s35du9.d.mts}

@@ -1,6 +1,7 @@
 import { z } from "zod";
 
-//#region src/schemas.d.ts
+//#region src/schemas/common.d.ts
+declare const shopifyStoreDomainSchema: z.ZodString;
 declare const shopifyCredentialsSchema: z.ZodObject<{
   SHOPIFY_STORE_DOMAIN: z.ZodString;
   SHOPIFY_ACCESS_TOKEN: z.ZodString;
@@ -230,4 +231,4 @@ type ShopifyFulfillment = z.infer<typeof shopifyFulfillmentSchema>;
 type ShopifyBlog = z.infer<typeof shopifyBlogSchema>;
 type ShopifyArticle = z.infer<typeof shopifyArticleSchema>;
 //#endregion
-export { ShopifyArticle, ShopifyBlog, ShopifyCollection, ShopifyCredentialsShape, ShopifyCustomer, ShopifyFulfillment, ShopifyInventoryLevel, ShopifyJob, ShopifyLocation, ShopifyOrder, ShopifyProduct, ShopifyShop, shopifyArticleSchema, shopifyBlogSchema, shopifyCollectionSchema, shopifyConnectionNodesSchema, shopifyCredentialsSchema, shopifyCustomerSchema, shopifyFulfillmentSchema, shopifyGlobalIdSchema, shopifyGraphqlErrorSchema, shopifyImageSchema, shopifyInventoryItemSchema, shopifyInventoryLevelSchema, shopifyJobSchema, shopifyLocationSchema, shopifyMetafieldSchema, shopifyMoneyBagSchema, shopifyMoneySchema, shopifyOrderSchema, shopifyPageInfoSchema, shopifyProductSchema, shopifySeoSchema, shopifyShopSchema, shopifyUserErrorSchema };
+export { shopifyOrderSchema as A, shopifyInventoryItemSchema as C, shopifyMetafieldSchema as D, shopifyLocationSchema as E, shopifyStoreDomainSchema as F, shopifyUserErrorSchema as I, shopifyProductSchema as M, shopifySeoSchema as N, shopifyMoneyBagSchema as O, shopifyShopSchema as P, shopifyImageSchema as S, shopifyJobSchema as T, shopifyCredentialsSchema as _, ShopifyCustomer as a, shopifyGlobalIdSchema as b, ShopifyJob as c, ShopifyProduct as d, ShopifyShop as f, shopifyConnectionNodesSchema as g, shopifyCollectionSchema as h, ShopifyCredentialsShape as i, shopifyPageInfoSchema as j, shopifyMoneySchema as k, ShopifyLocation as l, shopifyBlogSchema as m, ShopifyBlog as n, ShopifyFulfillment as o, shopifyArticleSchema as p, ShopifyCollection as r, ShopifyInventoryLevel as s, ShopifyArticle as t, ShopifyOrder as u, shopifyCustomerSchema as v, shopifyInventoryLevelSchema as w, shopifyGraphqlErrorSchema as x, shopifyFulfillmentSchema as y };

package/dist/{schemas.mjs → common-JZyHdK6p.mjs}

@@ -1,7 +1,7 @@
-import { i as shopifyStoreDomainSchema } from "./integration-B5LK_0eR.mjs";
 import { z } from "zod";
 
-//#region src/schemas.ts
+//#region src/schemas/common.ts
+const shopifyStoreDomainSchema = z.string().min(1).regex(/^[a-z0-9][a-z0-9-]*\.myshopify\.com$/i, "Shopify store domain must look like \"example.myshopify.com\".");
 const shopifyCredentialsSchema = z.object({
 	SHOPIFY_STORE_DOMAIN: shopifyStoreDomainSchema,
 	SHOPIFY_ACCESS_TOKEN: z.string().min(1)
@@ -161,4 +161,4 @@ const shopifyArticleSchema = z.object({
 });
 
 //#endregion
-export { shopifyArticleSchema, shopifyBlogSchema, shopifyCollectionSchema, shopifyConnectionNodesSchema, shopifyCredentialsSchema, shopifyCustomerSchema, shopifyFulfillmentSchema, shopifyGlobalIdSchema, shopifyGraphqlErrorSchema, shopifyImageSchema, shopifyInventoryItemSchema, shopifyInventoryLevelSchema, shopifyJobSchema, shopifyLocationSchema, shopifyMetafieldSchema, shopifyMoneyBagSchema, shopifyMoneySchema, shopifyOrderSchema, shopifyPageInfoSchema, shopifyProductSchema, shopifySeoSchema, shopifyShopSchema, shopifyUserErrorSchema };
+export { shopifyStoreDomainSchema as C, shopifyShopSchema as S, shopifyMoneySchema as _, shopifyCredentialsSchema as a, shopifyProductSchema as b, shopifyGlobalIdSchema as c, shopifyInventoryItemSchema as d, shopifyInventoryLevelSchema as f, shopifyMoneyBagSchema as g, shopifyMetafieldSchema as h, shopifyConnectionNodesSchema as i, shopifyGraphqlErrorSchema as l, shopifyLocationSchema as m, shopifyBlogSchema as n, shopifyCustomerSchema as o, shopifyJobSchema as p, shopifyCollectionSchema as r, shopifyFulfillmentSchema as s, shopifyArticleSchema as t, shopifyImageSchema as u, shopifyOrderSchema as v, shopifyUserErrorSchema as w, shopifySeoSchema as x, shopifyPageInfoSchema as y };

package/dist/credential-sets/index.d.mts

@@ -0,0 +1,2 @@
+import { i as shopifyCredentialSet, n as shopifyAppCredentialSet, r as ShopifyCredentials, t as ShopifyAppCredentials } from "../shopify-app.credential-set-DuAYUhzY.mjs";
+export { type ShopifyAppCredentials, type ShopifyCredentials, shopifyAppCredentialSet, shopifyCredentialSet };

package/dist/credential-sets/index.mjs

@@ -0,0 +1,4 @@
+import { t as shopifyCredentialSet } from "../shopify.credential-set-CaxST3GP.mjs";
+import { t as shopifyAppCredentialSet } from "../shopify-app.credential-set-M3vKwTji.mjs";
+
+export { shopifyAppCredentialSet, shopifyCredentialSet };

package/dist/index.d.mts

@@ -1 +1,4 @@
-export { };
+import { i as shopifyCredentialSet, n as shopifyAppCredentialSet, r as ShopifyCredentials, t as ShopifyAppCredentials } from "./shopify-app.credential-set-DuAYUhzY.mjs";
+import { A as deleteCollectionOperation, B as cancelOrderOperation, C as getCustomerOrdersOperation, D as getArticleOperation, E as getBlogOperation, F as createFulfillmentOperation, H as addProductsToCollectionOperation, I as createCustomerOperation, L as createCollectionOperation, M as deleteArticleOperation, N as createProductOperation, O as deleteProductOperation, P as createOrderOperation, R as createBlogOperation, S as getFulfillmentOperation, T as getCollectionOperation, V as adjustInventoryQuantitiesOperation, _ as getProductOperation, a as updateArticleOperation, b as getInventoryLevelsForItemOperation, c as listOrdersOperation, d as listFulfillmentOrdersForOrderOperation, f as listCustomersOperation, g as getShopOperation, h as listArticlesOperation, i as updateBlogOperation, j as deleteBlogOperation, k as deleteCustomerOperation, l as listLocationsOperation, m as listBlogsOperation, n as updateOrderOperation, o as removeProductsFromCollectionOperation, p as listCollectionsOperation, r as updateCustomerOperation, s as listProductsOperation, t as updateProductOperation, u as listInventoryItemsOperation, v as getOrderOperation, w as getCustomerOperation, x as getInventoryItemOperation, y as getLocationOperation, z as createArticleOperation } from "./update-shopify-product.operation-Db_kLuJa.mjs";
+import { A as shopifyOrderSchema, C as shopifyInventoryItemSchema, D as shopifyMetafieldSchema, E as shopifyLocationSchema, F as shopifyStoreDomainSchema, I as shopifyUserErrorSchema, M as shopifyProductSchema, N as shopifySeoSchema, O as shopifyMoneyBagSchema, P as shopifyShopSchema, S as shopifyImageSchema, T as shopifyJobSchema, _ as shopifyCredentialsSchema, a as ShopifyCustomer, b as shopifyGlobalIdSchema, c as ShopifyJob, d as ShopifyProduct, f as ShopifyShop, g as shopifyConnectionNodesSchema, h as shopifyCollectionSchema, i as ShopifyCredentialsShape, j as shopifyPageInfoSchema, k as shopifyMoneySchema, l as ShopifyLocation, m as shopifyBlogSchema, n as ShopifyBlog, o as ShopifyFulfillment, p as shopifyArticleSchema, r as ShopifyCollection, s as ShopifyInventoryLevel, t as ShopifyArticle, u as ShopifyOrder, v as shopifyCustomerSchema, w as shopifyInventoryLevelSchema, x as shopifyGraphqlErrorSchema, y as shopifyFulfillmentSchema } from "./common-C2s35du9.mjs";
+export { ShopifyAppCredentials, ShopifyArticle, ShopifyBlog, ShopifyCollection, ShopifyCredentials, ShopifyCredentialsShape, ShopifyCustomer, ShopifyFulfillment, ShopifyInventoryLevel, ShopifyJob, ShopifyLocation, ShopifyOrder, ShopifyProduct, ShopifyShop, addProductsToCollectionOperation, addProductsToCollectionOperation as addProductsToCollectionTool, adjustInventoryQuantitiesOperation, adjustInventoryQuantitiesOperation as adjustInventoryQuantitiesTool, cancelOrderOperation, cancelOrderOperation as cancelOrderTool, createArticleOperation, createArticleOperation as createArticleTool, createBlogOperation, createBlogOperation as createBlogTool, createCollectionOperation, createCollectionOperation as createCollectionTool, createCustomerOperation, createCustomerOperation as createCustomerTool, createFulfillmentOperation, createFulfillmentOperation as createFulfillmentTool, createOrderOperation, createOrderOperation as createOrderTool, createProductOperation, createProductOperation as createProductTool, deleteArticleOperation, deleteArticleOperation as deleteArticleTool, deleteBlogOperation, deleteBlogOperation as deleteBlogTool, deleteCollectionOperation, deleteCollectionOperation as deleteCollectionTool, deleteCustomerOperation, deleteCustomerOperation as deleteCustomerTool, deleteProductOperation, deleteProductOperation as deleteProductTool, getArticleOperation, getArticleOperation as getArticleTool, getBlogOperation, getBlogOperation as getBlogTool, getCollectionOperation, getCollectionOperation as getCollectionTool, getCustomerOperation, getCustomerOperation as getCustomerTool, getCustomerOrdersOperation, getCustomerOrdersOperation as getCustomerOrdersTool, getFulfillmentOperation, getFulfillmentOperation as getFulfillmentTool, getInventoryItemOperation, getInventoryItemOperation as getInventoryItemTool, getInventoryLevelsForItemOperation, getInventoryLevelsForItemOperation as getInventoryLevelsForItemTool, getLocationOperation, getLocationOperation as getLocationTool, getOrderOperation, getOrderOperation as getOrderTool, getProductOperation, getProductOperation as getProductTool, getShopOperation, getShopOperation as getShopTool, listArticlesOperation, listArticlesOperation as listArticlesTool, listBlogsOperation, listBlogsOperation as listBlogsTool, listCollectionsOperation, listCollectionsOperation as listCollectionsTool, listCustomersOperation, listCustomersOperation as listCustomersTool, listFulfillmentOrdersForOrderOperation, listFulfillmentOrdersForOrderOperation as listFulfillmentOrdersForOrderTool, listInventoryItemsOperation, listInventoryItemsOperation as listInventoryItemsTool, listLocationsOperation, listLocationsOperation as listLocationsTool, listOrdersOperation, listOrdersOperation as listOrdersTool, listProductsOperation, listProductsOperation as listProductsTool, removeProductsFromCollectionOperation, removeProductsFromCollectionOperation as removeProductsFromCollectionTool, shopifyAppCredentialSet, shopifyArticleSchema, shopifyBlogSchema, shopifyCollectionSchema, shopifyConnectionNodesSchema, shopifyCredentialSet, shopifyCredentialsSchema, shopifyCustomerSchema, shopifyFulfillmentSchema, shopifyGlobalIdSchema, shopifyGraphqlErrorSchema, shopifyImageSchema, shopifyInventoryItemSchema, shopifyInventoryLevelSchema, shopifyJobSchema, shopifyLocationSchema, shopifyMetafieldSchema, shopifyMoneyBagSchema, shopifyMoneySchema, shopifyOrderSchema, shopifyPageInfoSchema, shopifyProductSchema, shopifySeoSchema, shopifyShopSchema, shopifyStoreDomainSchema, shopifyUserErrorSchema, updateArticleOperation, updateArticleOperation as updateArticleTool, updateBlogOperation, updateBlogOperation as updateBlogTool, updateCustomerOperation, updateCustomerOperation as updateCustomerTool, updateOrderOperation, updateOrderOperation as updateOrderTool, updateProductOperation, updateProductOperation as updateProductTool };

package/dist/index.mjs

@@ -1 +1,6 @@
-export {  };
+import { C as shopifyStoreDomainSchema, S as shopifyShopSchema, _ as shopifyMoneySchema, a as shopifyCredentialsSchema, b as shopifyProductSchema, c as shopifyGlobalIdSchema, d as shopifyInventoryItemSchema, f as shopifyInventoryLevelSchema, g as shopifyMoneyBagSchema, h as shopifyMetafieldSchema, i as shopifyConnectionNodesSchema, l as shopifyGraphqlErrorSchema, m as shopifyLocationSchema, n as shopifyBlogSchema, o as shopifyCustomerSchema, p as shopifyJobSchema, r as shopifyCollectionSchema, s as shopifyFulfillmentSchema, t as shopifyArticleSchema, u as shopifyImageSchema, v as shopifyOrderSchema, w as shopifyUserErrorSchema, x as shopifySeoSchema, y as shopifyPageInfoSchema } from "./common-JZyHdK6p.mjs";
+import { t as shopifyCredentialSet } from "./shopify.credential-set-CaxST3GP.mjs";
+import { t as shopifyAppCredentialSet } from "./shopify-app.credential-set-M3vKwTji.mjs";
+import { A as deleteCollectionOperation, B as cancelOrderOperation, C as getCustomerOrdersOperation, D as getArticleOperation, E as getBlogOperation, F as createFulfillmentOperation, H as addProductsToCollectionOperation, I as createCustomerOperation, L as createCollectionOperation, M as deleteArticleOperation, N as createProductOperation, O as deleteProductOperation, P as createOrderOperation, R as createBlogOperation, S as getFulfillmentOperation, T as getCollectionOperation, V as adjustInventoryQuantitiesOperation, _ as getProductOperation, a as updateArticleOperation, b as getInventoryLevelsForItemOperation, c as listOrdersOperation, d as listFulfillmentOrdersForOrderOperation, f as listCustomersOperation, g as getShopOperation, h as listArticlesOperation, i as updateBlogOperation, j as deleteBlogOperation, k as deleteCustomerOperation, l as listLocationsOperation, m as listBlogsOperation, n as updateOrderOperation, o as removeProductsFromCollectionOperation, p as listCollectionsOperation, r as updateCustomerOperation, s as listProductsOperation, t as updateProductOperation, u as listInventoryItemsOperation, v as getOrderOperation, w as getCustomerOperation, x as getInventoryItemOperation, y as getLocationOperation, z as createArticleOperation } from "./update-shopify-product.operation-ByYhZggW.mjs";
+
+export { addProductsToCollectionOperation, addProductsToCollectionOperation as addProductsToCollectionTool, adjustInventoryQuantitiesOperation, adjustInventoryQuantitiesOperation as adjustInventoryQuantitiesTool, cancelOrderOperation, cancelOrderOperation as cancelOrderTool, createArticleOperation, createArticleOperation as createArticleTool, createBlogOperation, createBlogOperation as createBlogTool, createCollectionOperation, createCollectionOperation as createCollectionTool, createCustomerOperation, createCustomerOperation as createCustomerTool, createFulfillmentOperation, createFulfillmentOperation as createFulfillmentTool, createOrderOperation, createOrderOperation as createOrderTool, createProductOperation, createProductOperation as createProductTool, deleteArticleOperation, deleteArticleOperation as deleteArticleTool, deleteBlogOperation, deleteBlogOperation as deleteBlogTool, deleteCollectionOperation, deleteCollectionOperation as deleteCollectionTool, deleteCustomerOperation, deleteCustomerOperation as deleteCustomerTool, deleteProductOperation, deleteProductOperation as deleteProductTool, getArticleOperation, getArticleOperation as getArticleTool, getBlogOperation, getBlogOperation as getBlogTool, getCollectionOperation, getCollectionOperation as getCollectionTool, getCustomerOperation, getCustomerOperation as getCustomerTool, getCustomerOrdersOperation, getCustomerOrdersOperation as getCustomerOrdersTool, getFulfillmentOperation, getFulfillmentOperation as getFulfillmentTool, getInventoryItemOperation, getInventoryItemOperation as getInventoryItemTool, getInventoryLevelsForItemOperation, getInventoryLevelsForItemOperation as getInventoryLevelsForItemTool, getLocationOperation, getLocationOperation as getLocationTool, getOrderOperation, getOrderOperation as getOrderTool, getProductOperation, getProductOperation as getProductTool, getShopOperation, getShopOperation as getShopTool, listArticlesOperation, listArticlesOperation as listArticlesTool, listBlogsOperation, listBlogsOperation as listBlogsTool, listCollectionsOperation, listCollectionsOperation as listCollectionsTool, listCustomersOperation, listCustomersOperation as listCustomersTool, listFulfillmentOrdersForOrderOperation, listFulfillmentOrdersForOrderOperation as listFulfillmentOrdersForOrderTool, listInventoryItemsOperation, listInventoryItemsOperation as listInventoryItemsTool, listLocationsOperation, listLocationsOperation as listLocationsTool, listOrdersOperation, listOrdersOperation as listOrdersTool, listProductsOperation, listProductsOperation as listProductsTool, removeProductsFromCollectionOperation, removeProductsFromCollectionOperation as removeProductsFromCollectionTool, shopifyAppCredentialSet, shopifyArticleSchema, shopifyBlogSchema, shopifyCollectionSchema, shopifyConnectionNodesSchema, shopifyCredentialSet, shopifyCredentialsSchema, shopifyCustomerSchema, shopifyFulfillmentSchema, shopifyGlobalIdSchema, shopifyGraphqlErrorSchema, shopifyImageSchema, shopifyInventoryItemSchema, shopifyInventoryLevelSchema, shopifyJobSchema, shopifyLocationSchema, shopifyMetafieldSchema, shopifyMoneyBagSchema, shopifyMoneySchema, shopifyOrderSchema, shopifyPageInfoSchema, shopifyProductSchema, shopifySeoSchema, shopifyShopSchema, shopifyStoreDomainSchema, shopifyUserErrorSchema, updateArticleOperation, updateArticleOperation as updateArticleTool, updateBlogOperation, updateBlogOperation as updateBlogTool, updateCustomerOperation, updateCustomerOperation as updateCustomerTool, updateOrderOperation, updateOrderOperation as updateOrderTool, updateProductOperation, updateProductOperation as updateProductTool };

package/dist/operations/index.d.mts

@@ -0,0 +1,2 @@
+import { A as deleteCollectionOperation, B as cancelOrderOperation, C as getCustomerOrdersOperation, D as getArticleOperation, E as getBlogOperation, F as createFulfillmentOperation, H as addProductsToCollectionOperation, I as createCustomerOperation, L as createCollectionOperation, M as deleteArticleOperation, N as createProductOperation, O as deleteProductOperation, P as createOrderOperation, R as createBlogOperation, S as getFulfillmentOperation, T as getCollectionOperation, V as adjustInventoryQuantitiesOperation, _ as getProductOperation, a as updateArticleOperation, b as getInventoryLevelsForItemOperation, c as listOrdersOperation, d as listFulfillmentOrdersForOrderOperation, f as listCustomersOperation, g as getShopOperation, h as listArticlesOperation, i as updateBlogOperation, j as deleteBlogOperation, k as deleteCustomerOperation, l as listLocationsOperation, m as listBlogsOperation, n as updateOrderOperation, o as removeProductsFromCollectionOperation, p as listCollectionsOperation, r as updateCustomerOperation, s as listProductsOperation, t as updateProductOperation, u as listInventoryItemsOperation, v as getOrderOperation, w as getCustomerOperation, x as getInventoryItemOperation, y as getLocationOperation, z as createArticleOperation } from "../update-shopify-product.operation-Db_kLuJa.mjs";
+export { addProductsToCollectionOperation, addProductsToCollectionOperation as addProductsToCollectionTool, adjustInventoryQuantitiesOperation, adjustInventoryQuantitiesOperation as adjustInventoryQuantitiesTool, cancelOrderOperation, cancelOrderOperation as cancelOrderTool, createArticleOperation, createArticleOperation as createArticleTool, createBlogOperation, createBlogOperation as createBlogTool, createCollectionOperation, createCollectionOperation as createCollectionTool, createCustomerOperation, createCustomerOperation as createCustomerTool, createFulfillmentOperation, createFulfillmentOperation as createFulfillmentTool, createOrderOperation, createOrderOperation as createOrderTool, createProductOperation, createProductOperation as createProductTool, deleteArticleOperation, deleteArticleOperation as deleteArticleTool, deleteBlogOperation, deleteBlogOperation as deleteBlogTool, deleteCollectionOperation, deleteCollectionOperation as deleteCollectionTool, deleteCustomerOperation, deleteCustomerOperation as deleteCustomerTool, deleteProductOperation, deleteProductOperation as deleteProductTool, getArticleOperation, getArticleOperation as getArticleTool, getBlogOperation, getBlogOperation as getBlogTool, getCollectionOperation, getCollectionOperation as getCollectionTool, getCustomerOperation, getCustomerOperation as getCustomerTool, getCustomerOrdersOperation, getCustomerOrdersOperation as getCustomerOrdersTool, getFulfillmentOperation, getFulfillmentOperation as getFulfillmentTool, getInventoryItemOperation, getInventoryItemOperation as getInventoryItemTool, getInventoryLevelsForItemOperation, getInventoryLevelsForItemOperation as getInventoryLevelsForItemTool, getLocationOperation, getLocationOperation as getLocationTool, getOrderOperation, getOrderOperation as getOrderTool, getProductOperation, getProductOperation as getProductTool, getShopOperation, getShopOperation as getShopTool, listArticlesOperation, listArticlesOperation as listArticlesTool, listBlogsOperation, listBlogsOperation as listBlogsTool, listCollectionsOperation, listCollectionsOperation as listCollectionsTool, listCustomersOperation, listCustomersOperation as listCustomersTool, listFulfillmentOrdersForOrderOperation, listFulfillmentOrdersForOrderOperation as listFulfillmentOrdersForOrderTool, listInventoryItemsOperation, listInventoryItemsOperation as listInventoryItemsTool, listLocationsOperation, listLocationsOperation as listLocationsTool, listOrdersOperation, listOrdersOperation as listOrdersTool, listProductsOperation, listProductsOperation as listProductsTool, removeProductsFromCollectionOperation, removeProductsFromCollectionOperation as removeProductsFromCollectionTool, updateArticleOperation, updateArticleOperation as updateArticleTool, updateBlogOperation, updateBlogOperation as updateBlogTool, updateCustomerOperation, updateCustomerOperation as updateCustomerTool, updateOrderOperation, updateOrderOperation as updateOrderTool, updateProductOperation, updateProductOperation as updateProductTool };

package/dist/operations/index.mjs

@@ -0,0 +1,3 @@
+import { A as deleteCollectionOperation, B as cancelOrderOperation, C as getCustomerOrdersOperation, D as getArticleOperation, E as getBlogOperation, F as createFulfillmentOperation, H as addProductsToCollectionOperation, I as createCustomerOperation, L as createCollectionOperation, M as deleteArticleOperation, N as createProductOperation, O as deleteProductOperation, P as createOrderOperation, R as createBlogOperation, S as getFulfillmentOperation, T as getCollectionOperation, V as adjustInventoryQuantitiesOperation, _ as getProductOperation, a as updateArticleOperation, b as getInventoryLevelsForItemOperation, c as listOrdersOperation, d as listFulfillmentOrdersForOrderOperation, f as listCustomersOperation, g as getShopOperation, h as listArticlesOperation, i as updateBlogOperation, j as deleteBlogOperation, k as deleteCustomerOperation, l as listLocationsOperation, m as listBlogsOperation, n as updateOrderOperation, o as removeProductsFromCollectionOperation, p as listCollectionsOperation, r as updateCustomerOperation, s as listProductsOperation, t as updateProductOperation, u as listInventoryItemsOperation, v as getOrderOperation, w as getCustomerOperation, x as getInventoryItemOperation, y as getLocationOperation, z as createArticleOperation } from "../update-shopify-product.operation-ByYhZggW.mjs";
+
+export { addProductsToCollectionOperation, addProductsToCollectionOperation as addProductsToCollectionTool, adjustInventoryQuantitiesOperation, adjustInventoryQuantitiesOperation as adjustInventoryQuantitiesTool, cancelOrderOperation, cancelOrderOperation as cancelOrderTool, createArticleOperation, createArticleOperation as createArticleTool, createBlogOperation, createBlogOperation as createBlogTool, createCollectionOperation, createCollectionOperation as createCollectionTool, createCustomerOperation, createCustomerOperation as createCustomerTool, createFulfillmentOperation, createFulfillmentOperation as createFulfillmentTool, createOrderOperation, createOrderOperation as createOrderTool, createProductOperation, createProductOperation as createProductTool, deleteArticleOperation, deleteArticleOperation as deleteArticleTool, deleteBlogOperation, deleteBlogOperation as deleteBlogTool, deleteCollectionOperation, deleteCollectionOperation as deleteCollectionTool, deleteCustomerOperation, deleteCustomerOperation as deleteCustomerTool, deleteProductOperation, deleteProductOperation as deleteProductTool, getArticleOperation, getArticleOperation as getArticleTool, getBlogOperation, getBlogOperation as getBlogTool, getCollectionOperation, getCollectionOperation as getCollectionTool, getCustomerOperation, getCustomerOperation as getCustomerTool, getCustomerOrdersOperation, getCustomerOrdersOperation as getCustomerOrdersTool, getFulfillmentOperation, getFulfillmentOperation as getFulfillmentTool, getInventoryItemOperation, getInventoryItemOperation as getInventoryItemTool, getInventoryLevelsForItemOperation, getInventoryLevelsForItemOperation as getInventoryLevelsForItemTool, getLocationOperation, getLocationOperation as getLocationTool, getOrderOperation, getOrderOperation as getOrderTool, getProductOperation, getProductOperation as getProductTool, getShopOperation, getShopOperation as getShopTool, listArticlesOperation, listArticlesOperation as listArticlesTool, listBlogsOperation, listBlogsOperation as listBlogsTool, listCollectionsOperation, listCollectionsOperation as listCollectionsTool, listCustomersOperation, listCustomersOperation as listCustomersTool, listFulfillmentOrdersForOrderOperation, listFulfillmentOrdersForOrderOperation as listFulfillmentOrdersForOrderTool, listInventoryItemsOperation, listInventoryItemsOperation as listInventoryItemsTool, listLocationsOperation, listLocationsOperation as listLocationsTool, listOrdersOperation, listOrdersOperation as listOrdersTool, listProductsOperation, listProductsOperation as listProductsTool, removeProductsFromCollectionOperation, removeProductsFromCollectionOperation as removeProductsFromCollectionTool, updateArticleOperation, updateArticleOperation as updateArticleTool, updateBlogOperation, updateBlogOperation as updateBlogTool, updateCustomerOperation, updateCustomerOperation as updateCustomerTool, updateOrderOperation, updateOrderOperation as updateOrderTool, updateProductOperation, updateProductOperation as updateProductTool };

package/dist/schemas/index.d.mts

@@ -0,0 +1,2 @@
+import { A as shopifyOrderSchema, C as shopifyInventoryItemSchema, D as shopifyMetafieldSchema, E as shopifyLocationSchema, F as shopifyStoreDomainSchema, I as shopifyUserErrorSchema, M as shopifyProductSchema, N as shopifySeoSchema, O as shopifyMoneyBagSchema, P as shopifyShopSchema, S as shopifyImageSchema, T as shopifyJobSchema, _ as shopifyCredentialsSchema, a as ShopifyCustomer, b as shopifyGlobalIdSchema, c as ShopifyJob, d as ShopifyProduct, f as ShopifyShop, g as shopifyConnectionNodesSchema, h as shopifyCollectionSchema, i as ShopifyCredentialsShape, j as shopifyPageInfoSchema, k as shopifyMoneySchema, l as ShopifyLocation, m as shopifyBlogSchema, n as ShopifyBlog, o as ShopifyFulfillment, p as shopifyArticleSchema, r as ShopifyCollection, s as ShopifyInventoryLevel, t as ShopifyArticle, u as ShopifyOrder, v as shopifyCustomerSchema, w as shopifyInventoryLevelSchema, x as shopifyGraphqlErrorSchema, y as shopifyFulfillmentSchema } from "../common-C2s35du9.mjs";
+export { ShopifyArticle, ShopifyBlog, ShopifyCollection, ShopifyCredentialsShape, ShopifyCustomer, ShopifyFulfillment, ShopifyInventoryLevel, ShopifyJob, ShopifyLocation, ShopifyOrder, ShopifyProduct, ShopifyShop, shopifyArticleSchema, shopifyBlogSchema, shopifyCollectionSchema, shopifyConnectionNodesSchema, shopifyCredentialsSchema, shopifyCustomerSchema, shopifyFulfillmentSchema, shopifyGlobalIdSchema, shopifyGraphqlErrorSchema, shopifyImageSchema, shopifyInventoryItemSchema, shopifyInventoryLevelSchema, shopifyJobSchema, shopifyLocationSchema, shopifyMetafieldSchema, shopifyMoneyBagSchema, shopifyMoneySchema, shopifyOrderSchema, shopifyPageInfoSchema, shopifyProductSchema, shopifySeoSchema, shopifyShopSchema, shopifyStoreDomainSchema, shopifyUserErrorSchema };

package/dist/schemas/index.mjs

@@ -0,0 +1,3 @@
+import { C as shopifyStoreDomainSchema, S as shopifyShopSchema, _ as shopifyMoneySchema, a as shopifyCredentialsSchema, b as shopifyProductSchema, c as shopifyGlobalIdSchema, d as shopifyInventoryItemSchema, f as shopifyInventoryLevelSchema, g as shopifyMoneyBagSchema, h as shopifyMetafieldSchema, i as shopifyConnectionNodesSchema, l as shopifyGraphqlErrorSchema, m as shopifyLocationSchema, n as shopifyBlogSchema, o as shopifyCustomerSchema, p as shopifyJobSchema, r as shopifyCollectionSchema, s as shopifyFulfillmentSchema, t as shopifyArticleSchema, u as shopifyImageSchema, v as shopifyOrderSchema, w as shopifyUserErrorSchema, x as shopifySeoSchema, y as shopifyPageInfoSchema } from "../common-JZyHdK6p.mjs";
+
+export { shopifyArticleSchema, shopifyBlogSchema, shopifyCollectionSchema, shopifyConnectionNodesSchema, shopifyCredentialsSchema, shopifyCustomerSchema, shopifyFulfillmentSchema, shopifyGlobalIdSchema, shopifyGraphqlErrorSchema, shopifyImageSchema, shopifyInventoryItemSchema, shopifyInventoryLevelSchema, shopifyJobSchema, shopifyLocationSchema, shopifyMetafieldSchema, shopifyMoneyBagSchema, shopifyMoneySchema, shopifyOrderSchema, shopifyPageInfoSchema, shopifyProductSchema, shopifySeoSchema, shopifyShopSchema, shopifyStoreDomainSchema, shopifyUserErrorSchema };

package/dist/shopify-app.credential-set-DuAYUhzY.d.mts

@@ -0,0 +1,65 @@
+import { CredentialSet } from "@keystrokehq/core";
+import { z } from "zod";
+import * as _keystrokehq_core_credential_set0 from "@keystrokehq/core/credential-set";
+import { InferCredentialSetAuth } from "@keystrokehq/core/credential-set";
+
+//#region src/credential-sets/shopify.credential-set.d.ts
+declare const shopifyCredentialSet: CredentialSet<"shopify", z.ZodObject<{
+  SHOPIFY_STORE_DOMAIN: z.ZodString;
+  SHOPIFY_ACCESS_TOKEN: z.ZodString;
+}, z.core.$strip>, {
+  kind: "oauth";
+  tokenType: "refreshable";
+  authUrl: "https://{shop}.myshopify.com/admin/oauth/authorize";
+  tokenUrl: "https://{shop}.myshopify.com/admin/oauth/access_token";
+  revokeUrl: null;
+  scopes: readonly ["read_products", "write_products", "read_orders", "write_orders", "read_customers", "write_customers", "read_inventory", "write_inventory", "read_locations", "read_fulfillments", "write_fulfillments", "read_content", "write_content", "read_webhooks", "write_webhooks"];
+  vault: {
+    readonly accessToken: "SHOPIFY_ACCESS_TOKEN";
+    readonly raw: {
+      readonly SHOPIFY_STORE_DOMAIN: "_shopifyShopDomain";
+    };
+  };
+  buildAuthUrl: ({
+    oauthClient,
+    redirectUri,
+    state,
+    connection,
+    initiateInput,
+    requestedScopes
+  }: _keystrokehq_core_credential_set0.BuildAuthUrlContext) => string;
+  exchangeCode: ({
+    oauthClient,
+    code,
+    queryParams
+  }: _keystrokehq_core_credential_set0.ExchangeCodeContext) => Promise<_keystrokehq_core_credential_set0.TokenResult>;
+  refreshToken: ({
+    oauthClient,
+    refreshToken
+  }: _keystrokehq_core_credential_set0.RefreshTokenContext) => Promise<_keystrokehq_core_credential_set0.TokenResult>;
+  extractInstallationInfo: ({
+    tokenResult
+  }: _keystrokehq_core_credential_set0.ExtractInstallationContext) => {
+    externalInstallationId: string | undefined;
+    externalWorkspaceId: string | undefined;
+    metadata: {
+      shopDomain: string;
+    } | undefined;
+  };
+  id: string;
+}[]>;
+type ShopifyCredentials = InferCredentialSetAuth<typeof shopifyCredentialSet>;
+//#endregion
+//#region src/credential-sets/shopify-app.credential-set.d.ts
+declare const shopifyAppCredentialSet: CredentialSet<"shopify-app", z.ZodObject<{
+  clientId: z.ZodString;
+  clientSecret: z.ZodString;
+  webhookSecret: z.ZodString;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  clientId: z.ZodString;
+  clientSecret: z.ZodString;
+  webhookSecret: z.ZodString;
+}, z.core.$strip>>[] | undefined>;
+type ShopifyAppCredentials = InferCredentialSetAuth<typeof shopifyAppCredentialSet>;
+//#endregion
+export { shopifyCredentialSet as i, shopifyAppCredentialSet as n, ShopifyCredentials as r, ShopifyAppCredentials as t };

package/dist/shopify-app.credential-set-M3vKwTji.mjs

@@ -0,0 +1,17 @@
+import { CredentialSet } from "@keystrokehq/core";
+import { z } from "zod";
+
+//#region src/credential-sets/shopify-app.credential-set.ts
+const shopifyAppCredentialSet = new CredentialSet({
+	id: "shopify-app",
+	exposure: "platform-only",
+	name: "Shopify App",
+	auth: z.object({
+		clientId: z.string(),
+		clientSecret: z.string(),
+		webhookSecret: z.string()
+	})
+});
+
+//#endregion
+export { shopifyAppCredentialSet as t };

package/dist/shopify.credential-set-CaxST3GP.mjs

@@ -0,0 +1,205 @@
+import { C as shopifyStoreDomainSchema } from "./common-JZyHdK6p.mjs";
+import { CredentialSet } from "@keystrokehq/core";
+import { z } from "zod";
+import { createHmac, timingSafeEqual } from "node:crypto";
+
+//#region ../../packages/credential-connection/dist/defaults-YE9AvLIc.mjs
+/**
+* Shared OAuth 2.0 token-response plumbing.
+*
+* `parseOAuthTokenResponse` handles the two common wire formats (JSON and
+* form-urlencoded, the latter used by GitHub unless you explicitly ask for
+* JSON). `normalizeOAuthTokens` pulls the standard fields out of the parsed
+* body in both the flat form and Slack's nested `authed_user.access_token`
+* form. These helpers are exposed so integration authors overriding
+* `exchangeCode` / `refreshToken` do not have to re-implement them.
+*/
+var TokenExchangeError = class extends Error {
+	httpStatus;
+	constructor(httpStatus) {
+		super(`Token exchange failed: HTTP ${httpStatus}`);
+		this.name = "TokenExchangeError";
+		this.httpStatus = httpStatus;
+	}
+};
+async function parseOAuthTokenResponse(response) {
+	const contentType = response.headers.get("content-type")?.toLowerCase() ?? "";
+	if (contentType.includes("application/json")) return await response.json();
+	const text = await response.text();
+	if (!text.trim()) return {};
+	if (contentType.includes("application/x-www-form-urlencoded") || text.includes("=")) {
+		const params = new URLSearchParams(text);
+		return Object.fromEntries(params.entries());
+	}
+	throw new Error(`Unsupported OAuth token response content type: ${contentType || "unknown"}`);
+}
+function normalizeOAuthTokens(tokenData) {
+	const authedUser = tokenData.authed_user;
+	const rawAccessToken = tokenData.access_token ?? authedUser?.access_token;
+	const rawRefreshToken = tokenData.refresh_token;
+	const rawExpiresIn = tokenData.expires_in;
+	const rawInstanceUrl = tokenData.instance_url;
+	return {
+		accessToken: typeof rawAccessToken === "string" ? rawAccessToken : void 0,
+		refreshToken: typeof rawRefreshToken === "string" ? rawRefreshToken : void 0,
+		expiresIn: typeof rawExpiresIn === "number" ? rawExpiresIn : typeof rawExpiresIn === "string" ? Number(rawExpiresIn) || void 0 : void 0,
+		instanceUrl: typeof rawInstanceUrl === "string" ? rawInstanceUrl : void 0
+	};
+}
+
+//#endregion
+//#region src/utils/oauth-connection.ts
+/**
+* Shopify OAuth connection configuration.
+*
+* Shopify's OAuth flow is per-shop: every handshake is scoped to a specific
+* `{shop}.myshopify.com` domain that the user supplies up front. That shop
+* domain shows up in three places that make Shopify different from a plain
+* OAuth 2.0 integration:
+*
+*  - `buildAuthUrl` must point at the shop-specific authorize endpoint at
+*    `https://{shop}.myshopify.com/admin/oauth/authorize`. The shop domain is
+*    threaded in from the initiate-connection request via `initiateInput`.
+*  - `exchangeCode` verifies the Shopify HMAC signature on the callback query
+*    string before trusting any of it, and POSTs to the same shop-specific
+*    token endpoint. HMAC verification uses `timingSafeEqual` to avoid leaking
+*    bytes through timing side channels.
+*  - `refreshToken` reads the shop domain out of `oauthClient.metadata` (set
+*    during the initial exchange) so proactive refreshes still target the
+*    right store, and the `vault` mapping promotes the shop domain into
+*    `SHOPIFY_STORE_DOMAIN` so the vault has both the access token and the
+*    store it belongs to.
+*
+* Shopify responds with JSON, so we reuse `parseOAuthTokenResponse` +
+* `normalizeOAuthTokens` from `@keystrokehq/credential-connection` to avoid reimplementing
+* the token-response plumbing.
+*/
+function normalizeShopifyShopDomain(raw) {
+	const trimmed = raw?.trim().toLowerCase();
+	if (!trimmed) throw new Error("Shopify requires a store domain.");
+	const normalized = trimmed.endsWith(".myshopify.com") ? trimmed : `${trimmed}.myshopify.com`;
+	if (!/^[a-z0-9][a-z0-9-]*\.myshopify\.com$/i.test(normalized)) throw new Error("Invalid Shopify store domain.");
+	return normalized;
+}
+function verifyShopifyCallbackHmac(queryParams, clientSecret) {
+	const receivedHmac = queryParams.hmac;
+	if (!receivedHmac) return false;
+	const canonical = Object.entries(queryParams).filter(([key]) => key !== "hmac" && key !== "signature").sort(([left], [right]) => left.localeCompare(right)).map(([key, value]) => `${key}=${value}`).join("&");
+	const expected = createHmac("sha256", clientSecret).update(canonical).digest("hex");
+	const received = Buffer.from(receivedHmac, "utf8");
+	const expectedBuffer = Buffer.from(expected, "utf8");
+	if (received.length !== expectedBuffer.length) return false;
+	return timingSafeEqual(received, expectedBuffer);
+}
+function resolveShopifyTokenUrl(shopDomain) {
+	return `https://${shopDomain}/admin/oauth/access_token`;
+}
+async function shopifyTokenPost(shopDomain, body, missingTokenError) {
+	const response = await fetch(resolveShopifyTokenUrl(shopDomain), {
+		method: "POST",
+		headers: {
+			Accept: "application/json",
+			"Content-Type": "application/json"
+		},
+		body: JSON.stringify(body)
+	});
+	if (!response.ok) throw new TokenExchangeError(response.status);
+	const raw = await parseOAuthTokenResponse(response);
+	raw._shopifyShopDomain = shopDomain;
+	const { accessToken, refreshToken, expiresIn } = normalizeOAuthTokens(raw);
+	if (!accessToken) throw new Error(missingTokenError);
+	return {
+		accessToken,
+		refreshToken,
+		expiresIn,
+		raw
+	};
+}
+const shopifyOAuthConnection = {
+	kind: "oauth",
+	tokenType: "refreshable",
+	authUrl: "https://{shop}.myshopify.com/admin/oauth/authorize",
+	tokenUrl: "https://{shop}.myshopify.com/admin/oauth/access_token",
+	revokeUrl: null,
+	scopes: [
+		"read_products",
+		"write_products",
+		"read_orders",
+		"write_orders",
+		"read_customers",
+		"write_customers",
+		"read_inventory",
+		"write_inventory",
+		"read_locations",
+		"read_fulfillments",
+		"write_fulfillments",
+		"read_content",
+		"write_content",
+		"read_webhooks",
+		"write_webhooks"
+	],
+	vault: {
+		accessToken: "SHOPIFY_ACCESS_TOKEN",
+		raw: { SHOPIFY_STORE_DOMAIN: "_shopifyShopDomain" }
+	},
+	buildAuthUrl({ oauthClient, redirectUri, state, connection, initiateInput, requestedScopes }) {
+		const rawShopDomain = initiateInput?.shopDomain;
+		if (typeof rawShopDomain !== "string") throw new Error("Shopify requires a store domain.");
+		const scopes = requestedScopes ?? connection.scopes;
+		const shopDomain = normalizeShopifyShopDomain(rawShopDomain);
+		const url = new URL(`https://${shopDomain}/admin/oauth/authorize`);
+		url.searchParams.set("client_id", oauthClient.clientId);
+		url.searchParams.set("scope", scopes.join(","));
+		url.searchParams.set("redirect_uri", redirectUri);
+		url.searchParams.set("state", state);
+		return url.toString();
+	},
+	async exchangeCode({ oauthClient, code, queryParams }) {
+		if (!code) throw new Error("Missing authorization code");
+		const shopDomain = normalizeShopifyShopDomain(queryParams.shop);
+		if (!verifyShopifyCallbackHmac(queryParams, oauthClient.clientSecret)) throw new Error("Invalid Shopify OAuth callback signature");
+		return shopifyTokenPost(shopDomain, {
+			client_id: oauthClient.clientId,
+			client_secret: oauthClient.clientSecret,
+			code
+		}, "No access token in Shopify response");
+	},
+	async refreshToken({ oauthClient, refreshToken }) {
+		const rawShopDomain = oauthClient.metadata?.shopDomain;
+		if (typeof rawShopDomain !== "string") throw new Error("Missing Shopify store domain for token refresh.");
+		return shopifyTokenPost(normalizeShopifyShopDomain(rawShopDomain), {
+			grant_type: "refresh_token",
+			refresh_token: refreshToken,
+			client_id: oauthClient.clientId,
+			client_secret: oauthClient.clientSecret
+		}, "No access token in Shopify refresh response");
+	},
+	extractInstallationInfo({ tokenResult }) {
+		const shopDomain = typeof tokenResult.raw._shopifyShopDomain === "string" ? tokenResult.raw._shopifyShopDomain : void 0;
+		return {
+			externalInstallationId: shopDomain,
+			externalWorkspaceId: shopDomain,
+			metadata: shopDomain ? { shopDomain } : void 0
+		};
+	}
+};
+
+//#endregion
+//#region src/credential-sets/shopify.credential-set.ts
+const shopifyAuthSchema = z.object({
+	SHOPIFY_STORE_DOMAIN: shopifyStoreDomainSchema,
+	SHOPIFY_ACCESS_TOKEN: z.string().min(1)
+});
+const shopifyCredentialSet = new CredentialSet({
+	id: "shopify",
+	name: "Shopify",
+	description: "Shopify Admin API — stores, products, orders, customers, and webhooks",
+	auth: shopifyAuthSchema,
+	connections: [{
+		id: "oauth",
+		...shopifyOAuthConnection
+	}]
+});
+
+//#endregion
+export { shopifyCredentialSet as t };