shopify-store-sync-mcp 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Youssef Idder
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,414 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<p align="center">
+  <img src="docs/images/hero.png" alt="shopify-store-sync-mcp: diff and sync configuration between Shopify stores from your AI assistant" width="100%">
+</p>
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-57c26e" alt="MIT license"></a>
+  <img src="https://img.shields.io/badge/node-%3E%3D20-6cb6ff" alt="Node 20+">
+  <img src="https://img.shields.io/badge/MCP-server-a371f7" alt="MCP server">
+  <img src="https://img.shields.io/badge/Shopify%20Admin%20API-2026--10-e3b341" alt="Shopify Admin API 2026-10">
+</p>
+
+# shopify-store-sync-mcp
+
+**Keep your Shopify stores in sync by asking for it.** Compare a dev store with production, see every difference field by field, review a dry-run plan, then apply it, from Claude, Cursor or any MCP client.
+
+It copies the store setup that usually gets rebuilt by hand: **metafield and metaobject definitions, metaobject entries, collections, pages, menus, redirects, store policies, metafield values and translations**, with the images they use. References between them (a size guide pointing at a product, a menu linking to a page) are carried across by handle, so they land on the right item in the target store instead of a broken ID.
+
+<table>
+<tr>
+<td width="33%" valign="top"><b>See it before it happens</b><br>Field-level diffs and a dry-run plan for every sync. Nothing is written until you apply a reviewed plan.</td>
+<td width="33%" valign="top"><b>Safe on production</b><br>Writes are off by default, protected stores need typed confirmation, drifted items are skipped, and nothing is ever deleted.</td>
+<td width="33%" valign="top"><b>References that survive</b><br>Product, collection, page, metaobject and definition IDs are remapped by handle between stores.</td>
+</tr>
+</table>
+
+> **What you need:** Node 20+ and access to the stores' admin. The quickest way to connect needs no app at all: run `shopify-store-sync-mcp connect my-store`, approve in the browser, done (it uses [Shopify CLI](https://shopify.dev/docs/api/shopify-cli)'s own sign-in). For scheduled or unattended runs, a private app works too. [Setup below](#1-connect-your-stores).
+
+<p align="center">
+  <img src="docs/images/demo.png" alt="diff_stores, plan_sync and apply_plan output: 6 created, 3 updated, 1 conflict skipped, protected store refused without confirmation" width="100%">
+</p>
+
+<sub>Real output of the server's tools on two sample stores. Regenerate with <code>npm run docs:demo && npm run docs:images</code>.</sub>
+
+## Use cases
+
+- **Dev → staging → production.** Build a new metaobject type and its entries on a dev store, check the diff against production, ship it with one reviewed plan.
+- **Multi-region brands.** Keep the EU, UK and US stores on the same definitions, menus and redirects without exporting CSVs.
+- **New market launch.** Seed a new store with the setup of an existing one, then see exactly what still differs.
+- **Drift audits.** Ask which stores have fallen out of line, without changing anything (every tool except `apply_plan` is read-only).
+
+## Why this exists
+
+Most Shopify Plus brands run more than one store: a dev store, a staging store, one per region or currency. Anyone who has kept them in step knows the routine: rebuild metaobject definitions by hand, copy FAQ entries one by one, re-link every menu item, export and import redirects through CSV. It's slow, and it breaks in quiet ways, because **every ID is different in every store**.
+
+There are plenty of Shopify Admin MCP servers that read and write a *single* store. This one is built for the job *between* stores:
+
+| | Generic Admin MCP servers | shopify-store-sync-mcp |
+|---|---|---|
+| Compare two stores | ❌ | ✅ field-level diff |
+| Cross-store ID remapping | ❌ you copy raw IDs | ✅ products, collections, pages, blogs, metaobjects, definitions, customer account pages and shop policies |
+| Dry run before writing | ❌ | ✅ every write goes through a reviewed plan |
+| Detects changes made after planning | ❌ | ✅ re-reads the target and skips anything that drifted |
+| Deletes | sometimes | **never** |
+| Production guardrails | ❌ | ✅ writes are off by default; protected stores need typed confirmation |
+| Audit trail | ❌ | ✅ JSONL log of every write |
+
+## What it syncs
+
+| Resource | Keyed by | Notes |
+|---|---|---|
+| `metafield_definitions` | `OWNER_TYPE.namespace.key` | Name, description, pinning, storefront and customer account access, capabilities, validations. A type change is reported as a conflict, since Shopify can't change a definition's type in place. |
+| `metaobject_definitions` | `type` | Schema, access, capabilities. Fields are added or updated, never removed. Self-referencing definitions are handled. |
+| `pages` | `handle` | Title, body HTML, template, published state. |
+| `metaobjects` | `type/handle` | All field values, publish status. References to products, collections, pages and other metaobjects are remapped. |
+| `menus` | `handle` | Full item tree (3 levels), including customer account menus. Links to resources are remapped; custom URLs are kept; links to things that can't be matched are left out and reported. |
+| `redirects` | `path` | Thousands are fine. |
+| `collections` | `handle` | Title, description, sort order, template, SEO and smart-collection rules (rules on a metafield definition are remapped). Manual collections keep their own product list; sales-channel publishing is not copied. Manual versus smart is reported as a conflict. |
+| `shop_policies` | `type` | Refund, privacy, terms, shipping and contact policy text. |
+| `metafields` *(opt-in)* | `OWNER/handle/namespace.key` | Metafield **values** on products and collections, landed on the item with the same handle. Reference values are remapped. Filter with `namespaces`. |
+| `translations` *(opt-in)* | `locale:Type/handle` | Translations of pages, collections, metaobjects, menus and policies. Registered against the target's own text, after the content itself is synced. The plan warns when a language isn't added to the target. |
+
+`metafields` and `translations` can be large, so they're read only when you ask for them (`resources: ["metafields"]`). App-owned (`app--…`) and Shopify-reserved (`shopify--…`) data is skipped and listed in the report.
+
+**Files and images** referenced by any of the above are matched by file name in the target. When one is missing, the plan says so and `apply_plan` uploads it from the source store.
+
+## Tools
+
+| Tool | Writes? | What it does |
+|---|---|---|
+| `list_stores` | no | Configured stores and their write permissions. Secrets are never returned. |
+| `list_resource_types` | no | What can be synced and how it's keyed. |
+| `snapshot_store` | no | Read one store's configuration in portable form. |
+| `diff_stores` | no | Only-in-source, changed (field by field), only-in-target. |
+| `plan_sync` | no | Dry-run plan: creates, updates, conflicts, missing references. Returns a `plan_id`. |
+| `get_plan` | no | Show a plan, or list recent ones. |
+| `apply_plan` | **yes** | Execute a plan, with every safety check below. |
+| `export_snapshot` | local files only | Write a store's configuration to a folder for git ([config as code](#config-as-code)). |
+| `diff_themes` | no | Compare theme templates and settings between two stores ([theme settings](#theme-settings-diff)). |
+
+Every tool except `apply_plan` is read-only toward Shopify and annotated as such, so clients can auto-approve them.
+
+What `diff_stores` reports, field by field (real output):
+
+<p align="center">
+  <img src="docs/images/field-diff.png" alt="Field-level diff: page body, menu items, definition name, and a type conflict reported but not forced" width="100%">
+</p>
+
+## Quick start
+
+### 1. Connect your stores
+
+This server is a program you run yourself, so it can't borrow the Shopify login of your AI client. Pick one of three ways to give it access.
+
+**Option 1: sign in with Shopify CLI (fastest, no app to create).** Works on any store where your Shopify account can approve app access, including client stores you collaborate on.
+
+```bash
+npm install -g @shopify/cli
+npx shopify-store-sync-mcp connect my-dev-store            # read-only
+npx shopify-store-sync-mcp connect my-staging-store --writes
+```
+
+Each `connect` opens Shopify in your browser; click **Install** to approve. It asks for read-only scopes unless you pass `--writes` (or the store is configured with `"allowWrites": true`), then prints the line to add to `stores.json`:
+
+```json
+{ "stores": { "my-dev-store": { "domain": "my-dev-store.myshopify.com", "auth": "shopify-cli" } } }
+```
+
+Requests then run through `shopify store execute`, Shopify CLI's supported command, using the sign-in it saved. Each request starts Shopify CLI (about a second), so a full diff takes tens of seconds instead of one or two with an app. That sign-in belongs to you and expires after a while; when it does, the tool says so and you run `connect` again. Because of that, use one of the options below for scheduled or unattended runs.
+
+**Option 2: a Dev Dashboard app (best for automation on your own or your organization's stores).** One app covers every store in the same Shopify organization, and tokens are fetched and refreshed for you.
+
+1. Open the [Dev Dashboard](https://dev.shopify.com/dashboard), go to **Apps**, click **Create app**, then **Create app manually**.
+2. Give it a name, for example `Store Sync`. Any URL works as the App URL (it's never opened); untick **Embed app in Shopify admin**.
+3. In **Scopes**, paste the scopes from the table below for what you'll sync, then click **Create app** and **Release**.
+4. Install it on each store: open `https://admin.shopify.com/store/<store-handle>/oauth/install?client_id=<your client ID>` and click **Install**.
+5. Under the app's **Settings**, copy the **Client ID** and **Client secret** into environment variables (step 2 reads them from there).
+
+Adding a scope later means releasing a new version and approving the update on each store (same install link).
+
+**Option 3: an access token from a custom app (a store owned by someone else, for automation).** Client credentials only work on stores in the app's own organization; elsewhere Shopify answers `shop_not_permitted`. For unattended runs on such a store, ask the owner to create a custom app in their admin (**Settings > Apps > Develop apps**), grant the scopes below, install it and share the Admin API access token (`shpat_...`). Use it as `accessToken` in step 2.
+
+| Resource | Read scope | Write scope |
+|---|---|---|
+| metafield definitions | `read_products` (and the owner type's read scope) | `write_products` (and the owner type's write scope) |
+| metaobjects and definitions | `read_metaobjects`, `read_metaobject_definitions` | `write_metaobjects`, `write_metaobject_definitions` |
+| pages | `read_online_store_pages` | `write_online_store_pages` |
+| menus | `read_online_store_navigation` | `write_online_store_navigation` |
+| redirects | `read_online_store_navigation` | `write_online_store_navigation` |
+| collections | `read_products` | `write_products` |
+| shop policies | `read_legal_policies` | `write_legal_policies` |
+| metafield values | `read_products` | `write_products` |
+| translations | `read_translations`, `read_locales` | `write_translations` |
+| files | `read_files` | `write_files` (to upload missing files) |
+| theme diff | `read_themes` | none, never writes |
+| ID remapping | `read_products`, `read_content` | none |
+
+Everything at once (the set used for the live tests), ready to paste:
+
+```text
+read_products,write_products,read_metaobjects,write_metaobjects,read_metaobject_definitions,write_metaobject_definitions,read_online_store_pages,write_online_store_pages,read_online_store_navigation,write_online_store_navigation,read_legal_policies,write_legal_policies,read_translations,write_translations,read_locales,read_files,write_files,read_themes,read_content
+```
+
+Give source stores read-only scopes when you can.
+
+### 2. Describe your stores
+
+Create `stores.json`. Secrets can come from environment variables with `env:NAME`:
+
+```json
+{
+  "stores": {
+    "dev": {
+      "domain": "my-brand-dev.myshopify.com",
+      "accessToken": "env:DEV_TOKEN",
+      "label": "Development"
+    },
+    "eu": {
+      "domain": "my-brand-eu.myshopify.com",
+      "clientId": "env:EU_CLIENT_ID",
+      "clientSecret": "env:EU_CLIENT_SECRET",
+      "allowWrites": true,
+      "protected": true
+    }
+  }
+}
+```
+
+| Option | Default | Meaning |
+|---|---|---|
+| `domain` | required | `*.myshopify.com` domain |
+| `auth` | | `"shopify-cli"`: use the sign-in saved by `connect` (no token needed), **or** |
+| `accessToken` | | Static Admin API token, **or** |
+| `clientId` + `clientSecret` | | Dev Dashboard app; tokens are fetched and refreshed automatically |
+| `apiVersion` | `2026-10` | Admin API version |
+| `allowWrites` | `false` | Must be `true` for `apply_plan` to write to this store |
+| `protected` | `false` | `apply_plan` also requires `confirm: "<domain>"` |
+
+You can also pass the whole config as JSON in `SHOPIFY_STORES`, or point `SHOPIFY_STORES_FILE` at a file elsewhere. For a single store, `SHOPIFY_STORE_DOMAIN` plus `SHOPIFY_ACCESS_TOKEN` works.
+
+### 3. Add it to your MCP client
+
+**Claude Desktop** (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "shopify-store-sync": {
+      "command": "npx",
+      "args": ["-y", "shopify-store-sync-mcp"],
+      "env": {
+        "SHOPIFY_STORES_FILE": "/absolute/path/to/stores.json",
+        "DEV_TOKEN": "shpat_...",
+        "EU_CLIENT_ID": "...",
+        "EU_CLIENT_SECRET": "..."
+      }
+    }
+  }
+}
+```
+
+**Claude Code**
+
+```bash
+claude mcp add shopify-store-sync \
+  -e SHOPIFY_STORES_FILE=/absolute/path/to/stores.json \
+  -e DEV_TOKEN=shpat_... \
+  -- npx -y shopify-store-sync-mcp
+```
+
+**Cursor** (`.cursor/mcp.json`) takes the same `command`, `args` and `env` as Claude Desktop.
+
+### 4. Ask
+
+- *"Compare dev and eu. Only metaobjects and menus."*
+- *"Which product metafield definitions in namespace custom are missing from eu?"* (uses `include: ["PRODUCT.custom.*"]`)
+- *"Plan a sync of the faq and size_guide metaobjects from dev to eu."*
+- *"Apply only ops 1 to 4 of that plan."*
+- *"Copy the French translations from dev to eu."* (uses `resources: ["translations"], locales: ["fr"]`)
+- *"Export eu's configuration to ./store-config so I can commit it."*
+- *"Has eu drifted from ./store-config?"*
+- *"What's different in the theme settings between dev and eu?"*
+
+## Command line
+
+Everything also works without an AI client. Run a command instead of starting the server:
+
+```bash
+npx shopify-store-sync-mcp stores
+npx shopify-store-sync-mcp diff dev eu --resources pages,menus
+npx shopify-store-sync-mcp plan dev eu
+npx shopify-store-sync-mcp apply <plan-id> --confirm eu.myshopify.com
+npx shopify-store-sync-mcp export eu ./store-config
+npx shopify-store-sync-mcp themes dev eu
+```
+
+`--json` gives machine-readable output and `--exit-code` makes `diff` and `themes` exit with 2 when they find differences, handy for a scheduled drift check. Run `npx shopify-store-sync-mcp help` for every option.
+
+<p align="center">
+  <img src="docs/images/cli.png" alt="CLI output of diff, plan and themes commands" width="100%">
+</p>
+
+## Config as code
+
+Export a store's configuration as one small JSON file per item, with sorted keys and no store-specific IDs, then commit it:
+
+```bash
+npx shopify-store-sync-mcp export prod ./store-config
+git add store-config && git commit -m "Snapshot prod configuration"
+```
+
+Any command or tool that takes a source also takes `dir:<path>`:
+
+- **Spot drift:** `diff dir:./store-config prod` shows what changed in production since the commit.
+- **Review changes:** edit the files or re-export from staging, and review the change as a pull request.
+- **Restore or promote:** `plan dir:./store-config prod`, then `apply`, with all the usual safety checks.
+
+<p align="center">
+  <img src="docs/images/config-as-code.png" alt="Exported store-config folder and one translation file" width="100%">
+</p>
+
+## Theme settings diff
+
+`diff_themes` (or `themes` on the command line) compares the published themes of two stores: JSON templates, section groups and `config/settings_data.json`, setting by setting. Pass theme ids to compare other themes, and `files` to narrow it down (for example `templates/product*.json`). It is read-only: themes are never written to.
+
+## How it works
+
+<p align="center">
+  <img src="docs/images/how-it-works.png" alt="Snapshot, diff, plan, apply, with safety checks before every write" width="100%">
+</p>
+
+## How it stays safe
+
+1. **Read-only by default.** `allowWrites` is `false` until you set it, per store.
+2. **Plan, then apply.** `apply_plan` only runs a plan produced by `plan_sync`. Plans expire after an hour.
+3. **Drift protection.** Before writing, the target is re-read. Any item that changed since planning is skipped, not overwritten.
+4. **No deletes.** Items that exist only in the target are listed, never removed. Fields that exist only in the target are left alone.
+5. **Protected stores.** Production needs the exact domain typed as confirmation.
+6. **Conflicts aren't forced.** A metafield definition whose type differs is reported and skipped.
+7. **Audit log.** Every write is appended to `~/.shopify-store-sync/audit.log` (override with `SYNC_AUDIT_LOG`).
+
+## How ID remapping works
+
+Every Shopify ID is store-specific, so the server never compares or copies raw IDs. When it reads a store, each `gid://shopify/...` value is rewritten into a portable reference:
+
+```
+gid://shopify/Product/8123456          →  shopify://Product/linen-shirt
+gid://shopify/Metaobject/2918          →  shopify://Metaobject/faq/returns
+gid://shopify/MetaobjectDefinition/77  →  shopify://MetaobjectDefinition/faq
+gid://shopify/CustomerAccountPage/12   →  shopify://CustomerAccountPage/orders
+gid://shopify/ShopPolicy/5             →  shopify://ShopPolicy/PRIVACY_POLICY
+gid://shopify/Menu/41                  →  shopify://Menu/main-menu
+gid://shopify/MetafieldDefinition/9    →  shopify://MetafieldDefinition/PRODUCT.custom.fabric
+gid://shopify/MediaImage/730           →  shopify://File/size-chart.png
+```
+
+This covers JSON list values (`list.product_reference`) and definition validations (`metaobject_definition_id`). When it writes, references are resolved by handle in the target. A reference that doesn't exist there is flagged in the plan before anything is written.
+
+Things in the same plan can depend on each other, for example a metaobject pointing at another one being created, or a definition that references itself. These are written in two passes: first without the pending references, then complete.
+
+Files (images, generic files and videos) are matched by file name and uploaded to the target when missing. Collection rules that filter on a metafield are remapped to the target's definition.
+
+**Not remapped yet:** product variants and articles. Their values are left out of the sync and listed as warnings, never copied as broken IDs.
+
+Two references followed from the source store to the target, as the sample sync above wrote them:
+
+<p align="center">
+  <img src="docs/images/remapping.png" alt="gid://shopify/Product/101 in dev becomes shopify://Product/linen-shirt, then gid://shopify/Product/9101 in eu" width="100%">
+</p>
+
+## Tested against live stores
+
+Besides the 60 automated tests, every feature has been run end to end between two real Shopify development stores (a Shopify Plus source and a second store as target), through the real command line and the real MCP server over stdio, authenticating with a Dev Dashboard app and the client-credentials grant:
+
+| Feature | Live result |
+|---|---|
+| Diff of all default resource types | both stores read in about 10 seconds |
+| Create: metafield and metaobject definitions, metaobjects, smart collection, page, redirect, French translation | applied, second diff empty |
+| File reference on a metaobject | image uploaded to the target by file name and linked |
+| Update: page title and body, collection description | applied, second diff empty |
+| Shop policies | synced; a policy Shopify manages automatically is reported with how to unblock it |
+| Metafield values, including a `product_reference` | applied, reference remapped to the target's own product |
+| Values on products missing from the target | skipped up front with the reason |
+| Export to a folder, then diff that folder against the store | no differences |
+| Theme settings diff | read-only, 15 files compared in about 1 second |
+| Safety: write to a read-only store | refused |
+| Safety: target edited after the plan was made | step skipped, nothing overwritten |
+| Shopify CLI sign-in on Windows (CLI 4.9.4), both stores | `connect` read-only and `--writes`; plan, apply (7 creates incl. file upload and translation), update and re-diff all exact; also through the MCP server over stdio |
+
+Behaviours of the live API found this way are covered by tests: `nodes` returns `null` for customer account pages (they're looked up by listing instead), `ShopPolicy.type` has to be aliased next to `Metaobject.type`, Shopify refuses edits to auto-managed policies, and a failed token request carries its reason (such as `app_not_installed`) in an HTML page.
+
+## Development
+
+```bash
+npm install
+npm test              # vitest: unit, sync engine against an in-memory Shopify, and MCP protocol tests
+npm run typecheck
+npm run build
+
+# Validate every GraphQL operation against Shopify's real Admin schema
+npm run validate:graphql            # defaults to 2026-10
+npm run validate:graphql -- 2027-01
+```
+
+Layout:
+
+```
+src/
+  index.ts            entrypoint: MCP server on stdio, or the CLI when given a command
+  engine.ts           everything the tools and the CLI do, in one place
+  server.ts           MCP tools
+  cli.ts              command line
+  snapshotFiles.ts    export and read snapshot folders (config as code)
+  themes.ts           read-only theme settings diff
+  config.ts           store config loading and validation
+  shopify/client.ts   Admin GraphQL client (token refresh, throttling, retries)
+  refs.ts             GID <-> portable reference mapping
+  snapshot.ts         read a store into portable form
+  diff.ts             field-level diff
+  plan.ts             dry-run plans and plan storage
+  apply.ts            guarded, drift-checked, two-pass writes
+  resources/          one adapter per resource type
+test/
+  fakeShop.ts         in-memory Admin API used by the tests
+```
+
+Adding a resource type means writing one adapter (`fetch`, `create`, `update`) in `src/resources/`. See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Roadmap
+
+- [x] Translations per locale
+- [x] File references, re-uploaded by URL
+- [x] Collections with smart-collection rules
+- [x] Shop policies, and metafield values on products and collections
+- [x] Snapshots as files, for git-tracked store config
+- [x] Command line
+- [x] Read-only theme settings diff
+- [ ] Move collection rules to Shopify's new `sources` model (`ruleSet` is deprecated but supported through 2027-01)
+- [ ] Menu item (link) translations
+- [ ] Metafield values on variants, pages and the shop
+- [ ] Markets and market web presences
+- [ ] Optional deletes, behind an explicit flag
+
+Ideas and PRs are welcome. Issues tagged `good first issue` are a good place to start.
+
+## Related projects
+
+Syncing definitions between stores isn't a new idea, and these tools are worth knowing:
+
+| Project | Type | What it covers |
+|---|---|---|
+| [groupthought/metasync](https://github.com/groupthought/metasync) | CLI | Metafield and metaobject definitions plus resource data; dry run by default; has a delete mode |
+| [TeamDijon/meta-sync](https://github.com/TeamDijon/meta-sync) | CLI | Metafield and metaobject definitions and entries; manifest-based copy; bulk mode deletes the target first |
+| [shopify-metadata-migrator](https://github.com/warriorachilles/shopify-metadata-migrator) | CLI | Copies metafield and metaobject definitions |
+| MetaMaintain, Metora, Rewind Staging | Shopify apps (paid or freemium) | Definition and entry sync through an embedded app |
+
+What this project adds: it runs inside your AI client as an MCP server (or as a CLI) with a private app you create yourself, so there's no third-party app to install from the App Store and no data leaves your machine except to Shopify. You can ask for a diff in plain language; it also covers pages, menus, redirects, collections, policies, metafield values and translations, remaps references and files across stores, keeps store configuration in git, checks for drift before writing and never deletes. If you only need a scripted one-shot copy of definitions, one of the CLIs above may be all you need.
+
+## Disclaimer
+
+Not affiliated with, endorsed by or sponsored by Shopify Inc. "Shopify" is a trademark of Shopify Inc. Test on development stores first; you are responsible for what you apply to production.
+
+## License
+
+[MIT](LICENSE) © Youssef Idder

package/dist/apply.js

@@ -0,0 +1,185 @@
+import { appendFileSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { hashData } from "./diff.js";
+import { collectRefs, mapStrings, RefToGidResolver } from "./refs.js";
+import { ADAPTERS } from "./resources/index.js";
+import { takeSnapshot } from "./snapshot.js";
+import { stateDir } from "./plan.js";
+export class ApplyRefused extends Error {
+}
+export function checkApplyAllowed(plan, target, opts) {
+    const now = opts.now ?? new Date();
+    if (plan.target.alias !== target.alias || plan.target.domain !== target.domain) {
+        throw new ApplyRefused("plan target doesn't match the configured store");
+    }
+    if (plan.status !== "pending")
+        throw new ApplyRefused(`plan was already ${plan.status.replace("_", " ")}; create a new plan`);
+    if (now > new Date(plan.expiresAt))
+        throw new ApplyRefused("plan has expired; run plan_sync again so it reflects the current target");
+    if (!target.allowWrites) {
+        throw new ApplyRefused(`writes are disabled for store "${target.alias}". Set "allowWrites": true in its config to enable them.`);
+    }
+    if (target.protected && opts.confirm !== target.domain) {
+        throw new ApplyRefused(`store "${target.alias}" is protected. Pass confirm="${target.domain}" to apply.`);
+    }
+}
+function audit(file, entry) {
+    try {
+        mkdirSync(dirname(file), { recursive: true });
+        appendFileSync(file, `${JSON.stringify({ at: new Date().toISOString(), ...entry })}\n`, { mode: 0o600 });
+    }
+    catch {
+        /* auditing must never break a sync */
+    }
+}
+const touches = (v, refs) => [...collectRefs(v)].some((r) => refs.has(r));
+/** Remove metaobject fields whose value contains any of `refs`. */
+function stripFieldsWithRefs(data, refs) {
+    const fields = { ...(data.fields ?? {}) };
+    for (const [k, v] of Object.entries(fields)) {
+        if (touches(v, refs))
+            delete fields[k];
+    }
+    return { ...data, fields };
+}
+/** Remove metaobject definition fields whose validations reference any of `refs` (e.g. a self-reference). */
+function stripFieldDefsWithRefs(data, refs) {
+    return { ...data, fields: (data.fields ?? []).filter((f) => !touches(f, refs)) };
+}
+/** Kinds that can be written in two passes: first without the unresolved parts, then complete. */
+const PARTIAL = {
+    metaobjects: stripFieldsWithRefs,
+    metaobject_definitions: stripFieldDefsWithRefs,
+};
+/** A menu link to something that can't be matched is left out rather than sent with an empty target. */
+function dropMenuItems(items, refs) {
+    return items
+        .filter((i) => !(i.resourceId && refs.has(i.resourceId)))
+        .map((i) => (i.items ? { ...i, items: dropMenuItems(i.items, refs) } : i));
+}
+/** Drop values that can never be resolved (files, variants...) instead of sending a broken ref. */
+function dropUnmappable(data, kind) {
+    const unmappable = new Set([...collectRefs(data)].filter((r) => r.startsWith("shopify://unresolved/")));
+    if (!unmappable.size)
+        return data;
+    if (kind === "metaobjects")
+        return stripFieldsWithRefs(data, unmappable);
+    if (kind === "menus")
+        return { ...data, items: dropMenuItems(data.items ?? [], unmappable) };
+    return mapStrings(data, (s) => (unmappable.has(s) ? "" : s));
+}
+export async function applyPlan(plan, client, opts = {}) {
+    checkApplyAllowed(plan, client.store, opts);
+    const log = opts.auditLog ?? process.env.SYNC_AUDIT_LOG ?? join(stateDir(), "audit.log");
+    const resolver = new RefToGidResolver(client, new Map(Object.entries(plan.files ?? {})));
+    const results = [];
+    const selected = plan.ops.filter((o) => !opts.only?.length || opts.only.includes(o.seq));
+    const runnable = [];
+    for (const op of selected) {
+        if (op.action === "conflict")
+            results.push({ seq: op.seq, kind: op.kind, key: op.key, outcome: "skipped", message: op.reason });
+        else
+            runnable.push(op);
+    }
+    // Drift check: re-read the target and skip anything that changed since the plan was made.
+    const kinds = [...new Set(runnable.map((o) => o.kind))];
+    const current = await takeSnapshot(client, kinds);
+    const currentByKind = new Map(kinds.map((k) => [k, new Map((current.resources[k]?.items ?? []).map((i) => [i.key, i]))]));
+    const ready = [];
+    for (const op of runnable) {
+        const now = currentByKind.get(op.kind)?.get(op.key);
+        if (op.action === "create" && now) {
+            results.push({ seq: op.seq, kind: op.kind, key: op.key, outcome: "skipped", message: "already exists in target now; re-run plan_sync" });
+        }
+        else if (op.action === "update" && (!now || hashData(now.data) !== op.targetHash)) {
+            results.push({ seq: op.seq, kind: op.kind, key: op.key, outcome: "skipped", message: "target changed since the plan was made; re-run plan_sync" });
+        }
+        else {
+            ready.push(op);
+        }
+    }
+    const retry = [];
+    /** Current target state, refreshed before pass 2 so updates see what pass 1 created. */
+    let pass2Targets = new Map();
+    const run = async (op, pass) => {
+        const adapter = ADAPTERS[op.kind];
+        let data = dropUnmappable(op.data, op.kind);
+        try {
+            const { value, missing } = await resolver.rewrite(data);
+            data = value;
+            const strip = PARTIAL[op.kind];
+            if (missing.length) {
+                if (strip && pass === 1) {
+                    // Probably points at something later in this plan (or at itself): write what we can now, finish in pass 2.
+                    data = strip(dropUnmappable(op.data, op.kind), new Set(missing));
+                    data = (await resolver.rewrite(data)).value;
+                    retry.push(op);
+                }
+                else {
+                    throw new Error(`references not found in target: ${missing.join(", ")}`);
+                }
+            }
+            const target = (pass === 2 && pass2Targets.get(`${op.kind}:${op.key}`)) || {
+                key: op.key,
+                id: op.targetId ?? "",
+                data: op.targetData ?? {},
+            };
+            let outcome;
+            if (op.action === "create" && pass === 1) {
+                const id = await adapter.create({ client, resolver }, op.key, data);
+                const ref = adapter.refFor?.(op.key);
+                if (ref)
+                    resolver.remember(ref, id);
+                outcome = "created";
+            }
+            else {
+                await adapter.update({ client, resolver }, target, data);
+                outcome = op.action === "create" ? "created" : "updated";
+            }
+            const msg = retry.includes(op) && pass === 1 ? "partially written; finishing references in a second pass" : undefined;
+            upsertResult({ seq: op.seq, kind: op.kind, key: op.key, outcome, message: msg });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (PARTIAL[op.kind] && pass === 1 && !retry.includes(op))
+                retry.push(op);
+            upsertResult({ seq: op.seq, kind: op.kind, key: op.key, outcome: "failed", message });
+        }
+    };
+    const upsertResult = (r) => {
+        const i = results.findIndex((x) => x.seq === r.seq);
+        if (i >= 0)
+            results[i] = r;
+        else
+            results.push(r);
+        audit(log, { plan: plan.id, target: plan.target.domain, source: plan.source.domain, ...r });
+    };
+    for (const op of ready)
+        await run(op, 1);
+    if (retry.length) {
+        const retryKinds = [...new Set(retry.map((o) => o.kind))];
+        const fresh = await takeSnapshot(client, retryKinds);
+        pass2Targets = new Map(retryKinds.flatMap((k) => (fresh.resources[k]?.items ?? []).map((i) => [`${k}:${i.key}`, i])));
+        for (const op of retry) {
+            // An op that failed outright in pass 1 and still doesn't exist must be created, not updated.
+            if (op.action === "create" && !pass2Targets.has(`${op.kind}:${op.key}`))
+                await run({ ...op }, 1);
+            else
+                await run(op, 2);
+        }
+    }
+    results.sort((a, b) => a.seq - b.seq);
+    if (resolver.uploaded.length)
+        audit(log, { plan: plan.id, target: plan.target.domain, uploadedFiles: resolver.uploaded });
+    const failed = results.filter((r) => r.outcome === "failed").length;
+    const done = results.filter((r) => r.outcome === "created" || r.outcome === "updated").length;
+    if (opts.only?.length && selected.length < plan.ops.length) {
+        // Partial run: keep the plan usable for the remaining ops (applied ones will show as drifted).
+        plan.status = "pending";
+    }
+    else {
+        plan.status = failed === 0 ? "applied" : done > 0 ? "partially_applied" : "failed";
+    }
+    return results;
+}
+//# sourceMappingURL=apply.js.map

package/dist/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../src/apply.ts"],"names":[],"mappings":"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"}