[Themes] Add push, pull, and fetchStoreThemes to Themes Package Public Exports

[jamesmengo]

WHY are these changes introduced?

Fixes https://github.com/Shopify/develop-advanced-edits/issues/346

WHAT is this pull request doing?

• Exports the push, pull, and fetchStoreThemes` commands via the CLI package

How to test your changes?

1. Checkout and build this branch
2. Create a file in a package that includes @shopify/theme, such as packages/app/src/cli/test.ts
3. Import push, pull, and fetchStoreThemes
4. Hover over the function definition to see the JSDoc
5. Hover over the args inside of push and pull to see the JSDoc for the args inside flags
6. Test the autocomplete for flags args

Google.Chrome.-.Delete.Audio.+.Video.Recordings.Descript.Help.mp4

Template

import {fetchStoreThemes, pull, push} from '@shopify/theme'

await pull({
  development: true,
})
await push({
  development: true,
  only: ['asdf'],
})
await fetchStoreThemes('fqdn', 'asdf')

Post-release steps

• Partner comms

Measuring impact

How do we know this change was effective? Please choose one

• n/a - this doesn't need measurement, e.g. a linting rule or a bug-fix
• Existing analytics will cater for this addition
• PR includes analytics changes to measure impact
• Following up on this separately - https://github.com/Shopify/develop-advanced-edits/issues/348

Checklist

• I've considered possible cross-platform impacts (Mac, Linux, Windows)
• I've considered possible documentation changes

[github-actions]

Thanks for your contribution!

Depending on what you are working on, you may want to request a review from a Shopify team:

• Themes: @shopify/advanced-edits
• UI extensions: @shopify/ui-extensions-cli
  • Checkout UI extensions: @shopify/checkout-ui-extensions-api-stewardship
• Hydrogen: @shopify/hydrogen
• Other: @shopify/app-inner-loop

[github-actions]

Coverage report

St.❔	Category	Percentage	Covered / Total
🟡	Statements	72.76%	8485/11662
🟡	Branches	69.45%	4155/5983
🟡	Functions	71.55%	2201/3076
🟡	Lines	73.09%	8029/10985

Test suite run success

1928 tests passing in 872 suites.

Report generated by 🧪jest coverage report action from 967447b

[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/url.d.ts

@@ -5,11 +5,4 @@
  * @returns True if the URL is valid, false otherwise.
  * @throws An error if URL's constructor throws an error other than .
  */
-export declare function isValidURL(url: string): boolean;
-/**
- * Safely parse a string into a URL.
- *
- * @param url - The string to parse into a URL.
- * @returns A URL object if the parsing is successful, undefined otherwise.
- */
-export declare function safeParseURL(url: string): URL | undefined;
\ No newline at end of file
+export declare function isValidURL(url: string): boolean;
\ No newline at end of file

packages/cli-kit/dist/public/node/node-package-manager.d.ts

@@ -293,17 +293,4 @@ export declare function addResolutionOrOverride(directory: string, dependencies:
  * @param packageJSON - Package.json file to write.
  */
 export declare function writePackageJSON(directory: string, packageJSON: PackageJson): Promise<void>;
-/**
- * Infers the package manager to be used based on the provided options and environment.
- *
- * This function determines the package manager in the following order of precedence:
- * 1. Uses the package manager specified in the options, if valid.
- * 2. Infers the package manager from the user agent string.
- * 3. Infers the package manager used for the global CLI installation.
- * 4. Defaults to 'npm' if no other method succeeds.
- *
- * @param optionsPackageManager - The package manager specified in the options (if any).
- * @returns The inferred package manager as a PackageManager type.
- */
-export declare function inferPackageManager(optionsPackageManager: string | undefined, env?: NodeJS.ProcessEnv): PackageManager;
 export {};
\ No newline at end of file

[github-actions]

We detected some changes at either packages/*/src or packages/cli-kit/assets/cli-ruby/** and there are no updates in the .changeset.
If the changes are user-facing, run "pnpm changeset add" to track your changes and include them in the next release CHANGELOG.

[karreiro]

/snapit

[github-actions]

🫰✨ Thanks @karreiro! Your snapshot has been published to npm.

Test the snapshot by intalling your package globally:

pnpm i -g @shopify/[email protected]

After installing, validate the version by running just shopify in your terminal
If the versions don't match, you might have multiple global instances installed.
Use which shopify to find out which one you are running and uninstall it.

[karreiro]

Thank you, @jamesmengo!