Add order-insensitive deep object comparison to cli-kit

[isaacroldan]

Part 1 of 8 — splitting #8040 (refactor of deploy extension matching) into a reviewable stack.

WHY are these changes introduced?

Later PRs render a deploy/release diff by comparing local vs. remote app configuration. Config arrays such as webhook subscriptions can be semantically equal while differing only in element order, so a plain deep-equal reports false differences.

WHAT is this pull request doing?

Adds deepCompareWithOrderInsensitiveArrays (and two private helpers) to @shopify/cli-kit/common/object — a deep comparison that treats arrays as unordered. Purely additive; no existing export changes.

How to test your changes?

pnpm --filter @shopify/cli-kit exec vitest run src/public/common/object.test.ts

[isaacroldan]

• Make deploy consumers speak app-module UUID/registration-ID maps #8047 : 2 dependent PRs (#8048 , #8054 )
• Fix webhook subscription UID to omit the literal "undefined" for absent filters #8046
• Classify webhook subscription modules as configuration experience #8045
• Add order-insensitive deep object comparison to cli-kit #8044 👈 (View in Graphite)
• main

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

[github-actions]

Differences in type declarations

We detected differences in the type declarations generated by Typescript for this branch compared to the baseline ('main' branch). Please, review them to ensure they are backward-compatible. Here are some important things to keep in mind:

• Some seemingly private modules might be re-exported through public modules.
• If the branch is behind main you might see odd diffs, rebase main into this branch.

New type declarations

We found no new type declarations in this PR

Existing type declarations

packages/cli-kit/dist/public/common/object.d.ts

@@ -38,6 +38,14 @@ export declare function mapValues<T extends object, TResult>(source: T | null |
  * @returns True if the objects are equal, false otherwise.
  */
 export declare function deepCompare(one: object, two: object): boolean;
+/**
+ * Deeply compares two values and treats arrays as order-insensitive.
+ *
+ * @param one - The first value to be compared.
+ * @param two - The second value to be compared.
+ * @returns True if the normalized values are equal, false otherwise.
+ */
+export declare function deepCompareWithOrderInsensitiveArrays(one: unknown, two: unknown): boolean;
 /**
  * Return the difference between two nested objects.
  *

[isaacroldan]

Merge activity

• Jul 10, 1:41 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• Jul 10, 1:41 PM UTC: @isaacroldan added this pull request to the GitHub merge queue with Graphite.