@shopify/shop-minis-cli 0.0.0-hackathon.20250221160544

package/build/commands/dev/utils/start-app/start-app-with-options.js

@@ -0,0 +1,95 @@
+import { outputDebug } from '@shopify/cli-kit/node/output';
+import { downloadBinary, getLatestRemoteVersion } from '../network.js';
+import { metadataToBinaryFileName } from '../version.js';
+import { promptBinaryUpgrade } from '../prompt-binary-upgrade.js';
+import { getPlatformConfig } from '../platform.js';
+import { BuildType } from '../types.js';
+import { isVersionAvailableLocally } from '../binaries.js';
+export const startAppWithOptions = async ({ deviceId, platform, deeplink, buildType, snapshotVersion, }, { getInstalledShopVersion, installShop, openDeeplink }, loadingHandlers) => {
+    outputDebug(`Starting app with options ${JSON.stringify({
+        deviceId,
+        platform,
+        deeplink,
+        buildType,
+        snapshotVersion,
+    })}`);
+    const { loadingEnd, loadingStart, loadingUpdate } = loadingHandlers ?? {};
+    const installedShopVersion = await getInstalledShopVersion(deviceId);
+    const hasShopAppInstalled = installedShopVersion !== null;
+    const versionToUse = await getAppVersionToUse(platform, buildType, snapshotVersion);
+    outputDebug(`Currently installed Shop version ${JSON.stringify(installedShopVersion)}`);
+    outputDebug(`Target Shop version to use ${JSON.stringify(versionToUse)}`);
+    const platformConfig = getPlatformConfig(platform);
+    if (versionToUse == null) {
+        loadingEnd?.('fail', `No binaries for ${platformConfig.name} can be found on the server!`);
+        return;
+    }
+    else {
+        loadingEnd?.();
+    }
+    // If the user specified a nightly or snapshot build
+    const userOverriddenVersion = versionToUse.type !== BuildType.Release;
+    // The installed version does not tell us which build type it is, but we can fairly
+    // safely assume that version + build number is unique across all build types, so we
+    // we will just compare the version + build number
+    const isTargetVersionInstalled = hasShopAppInstalled
+        ? installedShopVersion.version === versionToUse.version &&
+            installedShopVersion.build === versionToUse.build
+        : false;
+    const needsUpdate = installedShopVersion == null;
+    let wantsUpdate = false;
+    if (!isTargetVersionInstalled) {
+        if (userOverriddenVersion) {
+            // The user specified a version and it's not installed so do that without asking
+            wantsUpdate = true;
+        }
+        else if (hasShopAppInstalled) {
+            // The user wants a release build and we know the latest is not installed, so prompt to update
+            wantsUpdate = await promptBinaryUpgrade();
+        }
+    }
+    outputDebug(`User needs a download/install? ${needsUpdate}`);
+    outputDebug(`User wants a download/install? ${wantsUpdate}`);
+    if (needsUpdate || wantsUpdate) {
+        const binaryAlreadyDownloaded = await isVersionAvailableLocally(versionToUse);
+        if (!binaryAlreadyDownloaded) {
+            loadingStart?.('Downloading Shop (0%)');
+            await downloadBinary(versionToUse, {
+                onProgress: progress => {
+                    loadingUpdate?.(`Downloading Shop (${progress}%)`);
+                },
+            });
+        }
+        loadingStart?.(
+        // show a longer message for new installs with instructions to skip onboarding
+        installedShopVersion == null
+            ? 'Installing Shop\n  ↪ Log in with the email associated to your Shopify Partner account'
+            : 'Installing Shop');
+        await installShop(deviceId, metadataToBinaryFileName(versionToUse));
+    }
+    loadingStart?.('Opening Shop');
+    await openDeeplink(deviceId, deeplink);
+    loadingEnd?.();
+};
+/**
+ * If buildType is set to snapshot and snapshotVersion is specified, that version is returned.
+ * Otherwise, returns the latest available version for the given platform and build type.
+ */
+async function getAppVersionToUse(platform, buildType, 
+/**
+ * version formatted as version+build
+ * @example 2.5.8+5667
+ * @example 0.8.0+2
+ */
+snapshotVersion) {
+    if (snapshotVersion && buildType === BuildType.Snapshot) {
+        return {
+            build: snapshotVersion.split('+')[1],
+            platform,
+            type: BuildType.Snapshot,
+            version: snapshotVersion.split('+')[0],
+        };
+    }
+    return getLatestRemoteVersion(platform, buildType);
+}
+//# sourceMappingURL=start-app-with-options.js.map

package/build/commands/dev/utils/start-app/start-app-with-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-app-with-options.js","sourceRoot":"","sources":["../../../../../src/commands/dev/utils/start-app/start-app-with-options.ts"],"names":[],"mappings":"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"}

package/build/commands/dev/utils/start-app/start-app.d.ts

@@ -0,0 +1,3 @@
+import { LoadingStateHandlers } from '../../../../utils/loading-state-handlers.js';
+import { StartAppParameters } from './types.js';
+export declare const startApp: (parameters: StartAppParameters, loadingLoggers: LoadingStateHandlers | null) => Promise<void>;

package/build/commands/dev/utils/start-app/start-app.js

@@ -0,0 +1,10 @@
+import { handlersForPlatform } from './config.js';
+import { startAppWithOptions } from './start-app-with-options.js';
+export const startApp = async (parameters, loadingLoggers) => {
+    const handlers = handlersForPlatform(parameters.platform);
+    if (handlers == null) {
+        throw new Error(`Unsupported platform: ${parameters.platform}`);
+    }
+    return startAppWithOptions(parameters, handlers, loadingLoggers);
+};
+//# sourceMappingURL=start-app.js.map

package/build/commands/dev/utils/start-app/start-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-app.js","sourceRoot":"","sources":["../../../../../src/commands/dev/utils/start-app/start-app.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,mBAAmB,EAAC,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAC,mBAAmB,EAAC,MAAM,6BAA6B,CAAA;AAG/D,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAC3B,UAA8B,EAC9B,cAA2C,EAC3C,EAAE;IACF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;IAEzD,IAAI,QAAQ,IAAI,IAAI,EAAE;QACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAA;KAChE;IAED,OAAO,mBAAmB,CAAC,UAAU,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAA;AAClE,CAAC,CAAA"}

package/build/commands/dev/utils/start-app/types.d.ts

@@ -0,0 +1,14 @@
+import { Platform } from '../platform.js';
+import { BuildType, VersionAndBuild } from '../types.js';
+export interface StartAppParameters {
+    deviceId: string;
+    platform: Platform;
+    deeplink: string;
+    buildType: BuildType;
+    snapshotVersion?: string;
+}
+export interface StartAppPlatformHooks {
+    getInstalledShopVersion: (deviceId: string) => Promise<VersionAndBuild | null>;
+    installShop: (deviceId: string, version: string) => Promise<void>;
+    openDeeplink: (deviceId: string, deeplink: string) => Promise<void>;
+}

package/build/commands/dev/utils/start-app/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/commands/dev/utils/start-app/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/commands/dev/utils/start-app/types.ts"],"names":[],"mappings":""}

package/build/commands/dev/utils/types.d.ts

@@ -0,0 +1,24 @@
+import { Platform } from './platform.js';
+export interface VersionAndBuild {
+    version: string;
+    build: string;
+}
+export declare enum BuildType {
+    Release = "release",
+    Nightly = "nightly",
+    Snapshot = "snapshot"
+}
+export interface BinaryMetadata {
+    version: string;
+    build: string;
+    type: BuildType;
+    platform: Platform;
+}
+export interface GetFilesApiResponse {
+    kind: 'storage#objects';
+    prefixes?: string[];
+    items?: {
+        kind: 'storage#object';
+        name: string;
+    }[];
+}

package/build/commands/dev/utils/types.js

@@ -0,0 +1,7 @@
+export var BuildType;
+(function (BuildType) {
+    BuildType["Release"] = "release";
+    BuildType["Nightly"] = "nightly";
+    BuildType["Snapshot"] = "snapshot";
+})(BuildType || (BuildType = {}));
+//# sourceMappingURL=types.js.map

package/build/commands/dev/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/commands/dev/utils/types.ts"],"names":[],"mappings":"AAOA,MAAM,CAAN,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,gCAAmB,CAAA;IACnB,gCAAmB,CAAA;IACnB,kCAAqB,CAAA;AACvB,CAAC,EAJW,SAAS,KAAT,SAAS,QAIpB"}

package/build/commands/dev/utils/version.d.ts

@@ -0,0 +1,64 @@
+import { Platform } from './platform.js';
+import { BinaryMetadata, BuildType } from './types.js';
+/**
+ * @example
+ * filenames [
+ *   "2.76.0+3.release.apk",
+ *   "2.76.0+3.release.zip",
+ *   "2.77.0+5.release.apk",
+ *   "2.77.0+3.release.zip",
+ *   "2.77.0+10.release.apk",
+ *   "2.77.0+10.release.zip",
+ * ]
+ * returns { version: "2.77.0", build: "10", type: "release", platform: "ios" }
+ */
+export declare function getLatestVersionFromFilesList(filenames: string[], platform: Platform, type: BuildType): BinaryMetadata | null;
+/**
+ * @example
+ * platform android
+ * version 2.76.0
+ * build 24
+ * type release
+ * returns "2.76.0+24.release.apk"
+ *
+ * platform ios
+ * version 2.55.0
+ * build 4
+ * type nightly
+ * returns "2.55.0+4.nightly.zip"
+ */
+export declare function metadataToBinaryFileName(metadata: BinaryMetadata): string;
+/**
+ * @example
+ * binaryFileName "2.76.0+123.snapshot.apk"
+ * returns true
+ *
+ * binaryFileName "word.exe"
+ * returns false
+ */
+export declare function isValidBinaryFileName(binaryFileName: string): boolean;
+/**
+ * @example
+ * binaryFileName "2.76.0+123.snapshot.apk"
+ * returns { version: "2.16.0", build: "123", type: "snapshot", platform: "android" }
+ *
+ * binaryFileName "2.16.0+3.zip"
+ * returns { version: "2.16.0", build "3", platform: "ios" }
+ */
+export declare function binaryFileNameToMetadata(binaryFileName: string): Readonly<{
+    version: string;
+    build: string;
+    type: BuildType;
+    platform: Platform;
+}>;
+/**
+ * @example
+ *
+ * version "2.76.0"
+ * build "3"
+ * returns "2.76.0+3"
+ */
+export declare function convertToSemver({ version, build, }: {
+    version: string;
+    build: string;
+}): string;

package/build/commands/dev/utils/version.js

@@ -0,0 +1,101 @@
+import _ from 'lodash';
+import { valid as isValidSemver, compareBuild as semverCompare } from 'semver';
+import escapeStringRegexp from 'escape-string-regexp';
+import { getBuildTypeForBinaryBuildType } from './build-type.js';
+import { Platform, getPlatformConfig, getPlatformForBinaryFileExtension, } from './platform.js';
+import { BuildType } from './types.js';
+/**
+ * @example
+ * filenames [
+ *   "2.76.0+3.release.apk",
+ *   "2.76.0+3.release.zip",
+ *   "2.77.0+5.release.apk",
+ *   "2.77.0+3.release.zip",
+ *   "2.77.0+10.release.apk",
+ *   "2.77.0+10.release.zip",
+ * ]
+ * returns { version: "2.77.0", build: "10", type: "release", platform: "ios" }
+ */
+export function getLatestVersionFromFilesList(filenames, platform, type) {
+    const localVersions = _.uniq(filenames
+        .filter(isValidBinaryFileName)
+        .map(binaryFileNameToMetadata)
+        .filter(metadata => isValidSemver(convertToSemver(metadata)))
+        .filter(metadata => metadata.platform === platform)
+        .filter(metadata => metadata.type === type)).sort((lhs, rhs) => semverCompare(convertToSemver(lhs), convertToSemver(rhs)));
+    return localVersions.slice(-1)[0] ?? null;
+}
+/**
+ * @example
+ * platform android
+ * version 2.76.0
+ * build 24
+ * type release
+ * returns "2.76.0+24.release.apk"
+ *
+ * platform ios
+ * version 2.55.0
+ * build 4
+ * type nightly
+ * returns "2.55.0+4.nightly.zip"
+ */
+export function metadataToBinaryFileName(metadata) {
+    return `${metadata.version}+${metadata.build}.${metadata.type}.${getPlatformConfig(metadata.platform).extension}`;
+}
+/**
+ * @example
+ * binaryFileName "2.76.0+123.snapshot.apk"
+ * returns true
+ *
+ * binaryFileName "word.exe"
+ * returns false
+ */
+export function isValidBinaryFileName(binaryFileName) {
+    try {
+        binaryFileNameToMetadata(binaryFileName);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * @example
+ * binaryFileName "2.76.0+123.snapshot.apk"
+ * returns { version: "2.16.0", build: "123", type: "snapshot", platform: "android" }
+ *
+ * binaryFileName "2.16.0+3.zip"
+ * returns { version: "2.16.0", build "3", platform: "ios" }
+ */
+export function binaryFileNameToMetadata(binaryFileName) {
+    const allBuildTypes = Object.values(BuildType)
+        .map(escapeStringRegexp)
+        .join('|');
+    const allExtensions = Object.values(Platform)
+        .map(platform => getPlatformConfig(platform).extension)
+        .map(escapeStringRegexp)
+        .join('|');
+    const regexPattern = `(?<version>\\d+\\.\\d+\\.\\d+)(\\+(?<build>\\d+))\\.(?<type>${allBuildTypes})\\.(?<extension>${allExtensions})`;
+    const matches = binaryFileName.match(regexPattern);
+    if (!matches) {
+        throw new Error(`Invalid file name: ${binaryFileName}`);
+    }
+    const { version, build, type, extension } = matches.groups;
+    return Object.freeze({
+        version,
+        build,
+        type: getBuildTypeForBinaryBuildType(type),
+        platform: getPlatformForBinaryFileExtension(extension),
+    });
+}
+/**
+ * @example
+ *
+ * version "2.76.0"
+ * build "3"
+ * returns "2.76.0+3"
+ */
+export function convertToSemver({ version, build, }) {
+    return `${version}+${build}`;
+}
+//# sourceMappingURL=version.js.map

package/build/commands/dev/utils/version.js.map

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

package/build/commands/dev/utils/with-retries.d.ts

@@ -0,0 +1,4 @@
+export declare function withRetries<T>(getResult: () => Promise<T>, isResultReady?: (result: T) => boolean, { maxRetries, timeBetweenRetries }?: {
+    timeBetweenRetries: number;
+    maxRetries: number;
+}): Promise<T>;

package/build/commands/dev/utils/with-retries.js

@@ -0,0 +1,24 @@
+// TODO: worth adding some specs
+export async function withRetries(getResult, isResultReady = Boolean, { maxRetries, timeBetweenRetries } = { timeBetweenRetries: 1000, maxRetries: 120 }) {
+    if (maxRetries === 0) {
+        throw new Error();
+    }
+    try {
+        const result = await getResult();
+        if (isResultReady(result)) {
+            return result;
+        }
+    }
+    catch {
+        // do nothing
+    }
+    return new Promise(resolve => {
+        setTimeout(() => {
+            resolve(withRetries(getResult, isResultReady, {
+                timeBetweenRetries,
+                maxRetries: maxRetries - 1,
+            }));
+        }, timeBetweenRetries);
+    });
+}
+//# sourceMappingURL=with-retries.js.map

package/build/commands/dev/utils/with-retries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-retries.js","sourceRoot":"","sources":["../../../../src/commands/dev/utils/with-retries.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAA2B,EAC3B,gBAAwC,OAAO,EAC/C,EAAC,UAAU,EAAE,kBAAkB,EAAC,GAAG,EAAC,kBAAkB,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAC;IAE9E,IAAI,UAAU,KAAK,CAAC,EAAE;QACpB,MAAM,IAAI,KAAK,EAAE,CAAA;KAClB;IACD,IAAI;QACF,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAA;QAChC,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE;YACzB,OAAO,MAAM,CAAA;SACd;KACF;IAAC,MAAM;QACN,aAAa;KACd;IACD,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QAC3B,UAAU,CAAC,GAAG,EAAE;YACd,OAAO,CACL,WAAW,CAAC,SAAS,EAAE,aAAa,EAAE;gBACpC,kBAAkB;gBAClB,UAAU,EAAE,UAAU,GAAG,CAAC;aAC3B,CAAC,CACH,CAAA;QACH,CAAC,EAAE,kBAAkB,CAAC,CAAA;IACxB,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/build/commands/doctor/index.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+export interface DoctorCommandArgs {
+    verbose?: boolean;
+    fix?: boolean;
+}
+export declare const command: Command;

package/build/commands/doctor/index.js

@@ -0,0 +1,21 @@
+import { Command } from 'commander';
+import { handler as handleError } from '@shopify/cli-kit/node/error';
+import { diagnoseDependencies } from './utils/diagnose-dependencies.js';
+export const command = new Command()
+    .name('doctor')
+    .description('Diagnose and fix common Node.js, iOS, Android & React Native issues.')
+    .option('--verbose', 'print debugging messages')
+    .option('--fix', 'Attempt to fix all diagnosed issues.')
+    .action(async (options) => {
+    try {
+        const dependenciesValidationResult = await diagnoseDependencies(options.fix);
+        if (dependenciesValidationResult) {
+            console.log('\n✅ The configuration for your mini is correct.');
+        }
+    }
+    catch (err) {
+        delete err.stack; // delete the stack to avoid a verbose logging in case of unhandled errors
+        await handleError(err);
+    }
+});
+//# sourceMappingURL=index.js.map

package/build/commands/doctor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/doctor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AACjC,OAAO,EAAC,OAAO,IAAI,WAAW,EAAC,MAAM,6BAA6B,CAAA;AAElE,OAAO,EAAC,oBAAoB,EAAC,MAAM,kCAAkC,CAAA;AAOrE,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;KACjC,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CACV,sEAAsE,CACvE;KACA,MAAM,CAAC,WAAW,EAAE,0BAA0B,CAAC;KAC/C,MAAM,CAAC,OAAO,EAAE,sCAAsC,CAAC;KACvD,MAAM,CAAC,KAAK,EAAE,OAA0B,EAAE,EAAE;IAC3C,IAAI;QACF,MAAM,4BAA4B,GAAG,MAAM,oBAAoB,CAC7D,OAAO,CAAC,GAAG,CACZ,CAAA;QAED,IAAI,4BAA4B,EAAE;YAChC,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAA;SAC/D;KACF;IAAC,OAAO,GAAG,EAAE;QACZ,OAAQ,GAAa,CAAC,KAAK,CAAA,CAAC,0EAA0E;QACtG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAA;KACvB;AACH,CAAC,CAAC,CAAA"}

package/build/commands/doctor/utils/diagnose-dependencies.d.ts

@@ -0,0 +1,7 @@
+export declare function diagnoseDependencies(autoFix?: boolean): Promise<boolean>;
+export declare function getInvalidDependencies(): {
+    duplicatedDependencies: string[];
+    duplicatedDevDependencies: string[];
+    nonSupportedDependencies: string[];
+    areDependenciesInvalid: boolean;
+};

package/build/commands/doctor/utils/diagnose-dependencies.js

@@ -0,0 +1,113 @@
+import path from 'path';
+import fs from 'fs';
+import { AbortError } from '@shopify/cli-kit/node/error';
+import chalk from 'chalk';
+import { hardResetDependencies } from '../../../utils/package-manager.js';
+import { wrapWithLoadingIndicator } from '../../../utils/wrap-with-loading-indicator.js';
+const DEPENDENCIES_ALLOWLIST = [
+    '@shopify/shop-minis-runtime',
+    '@shopify/shop-minis-platform-sdk',
+    '@shopify/shop-minis-ui-extensions',
+];
+export async function diagnoseDependencies(autoFix) {
+    const { areDependenciesInvalid, duplicatedDependencies, duplicatedDevDependencies, nonSupportedDependencies, } = getInvalidDependencies();
+    if (areDependenciesInvalid) {
+        console.log(chalk.red(`\n❌ Found some issues with the dependencies of your mini. Read more about supported dependencies in ${chalk.bold('https://shop.app/minis/docs/build-a-shop-mini/dependencies/')}`));
+        logNonSupportedDependencies(nonSupportedDependencies);
+        logDuplicatedDependencies(duplicatedDependencies);
+        logDuplicatedDependencies(duplicatedDevDependencies, true);
+    }
+    if (autoFix) {
+        await removeInvalidDependencies({
+            packageJsonPath: path.join(process.cwd(), 'package.json'),
+            duplicatedDependencies,
+            duplicatedDevDependencies,
+            nonSupportedDependencies,
+        });
+    }
+    else if (areDependenciesInvalid) {
+        logTroubleshootInstructions();
+    }
+    // mark the validation as failed if there are any duplicated dependencies or dev dependencies
+    return !areDependenciesInvalid;
+}
+export function getInvalidDependencies() {
+    const runtimePackageJsonPath = path.join(process.cwd(), 'node_modules', '@shopify', 'shop-minis-runtime', 'package.json');
+    const runtimeDependencies = getPackageJsonByPath(runtimePackageJsonPath).dependencies;
+    const miniPackageJsonPath = path.join(process.cwd(), 'package.json');
+    const miniPackageJson = getPackageJsonByPath(miniPackageJsonPath);
+    const duplicatedDependencies = Object.keys(miniPackageJson.dependencies).filter(dependency => Boolean(runtimeDependencies[dependency]));
+    const duplicatedDevDependencies = Object.keys(miniPackageJson.devDependencies).filter(devDependency => Boolean(runtimeDependencies[devDependency]));
+    // everything that's listed as a dependency as is not in the allowlist and is not duplicated is invalid
+    // only allowed dependencies should be listed in the package.json of a mini
+    const nonSupportedDependencies = Object.keys(miniPackageJson.dependencies).filter(dependency => !DEPENDENCIES_ALLOWLIST.includes(dependency) &&
+        !duplicatedDependencies.includes(dependency));
+    const areDependenciesInvalid = Boolean(duplicatedDependencies.length +
+        duplicatedDevDependencies.length +
+        nonSupportedDependencies.length);
+    return {
+        duplicatedDependencies,
+        duplicatedDevDependencies,
+        nonSupportedDependencies,
+        areDependenciesInvalid,
+    };
+}
+function logNonSupportedDependencies(dependencies) {
+    if (dependencies.length === 0) {
+        return;
+    }
+    console.log(chalk.red('\n❌ Usage of the following dependencies in your mini is not supported:'));
+    dependencies.forEach(dependency => console.log(`- ${dependency}`));
+}
+function logDuplicatedDependencies(dependencies, isDev = false) {
+    if (dependencies.length === 0) {
+        return;
+    }
+    console.log(chalk.red(`\n❌ The following ${isDev ? 'devDependencies' : 'dependencies'} are duplicated with @shopify/shop-minis-runtime:`));
+    dependencies.forEach(dependency => console.log(`- ${dependency}`));
+}
+function getPackageJsonByPath(packageJsonPath) {
+    let packageJson = {};
+    try {
+        const packageJsonString = fs.readFileSync(packageJsonPath).toString('utf-8');
+        packageJson = JSON.parse(packageJsonString);
+    }
+    catch {
+        throw new AbortError(`Failed to read from file on path ${packageJsonPath}`);
+    }
+    return packageJson;
+}
+function logTroubleshootInstructions() {
+    console.log(chalk.cyan(`\nℹ️  This error is potentially fixable with the ${chalk.bold('--fix')} option.`));
+    console.log(chalk.cyan('\nℹ️  If you want to fix this error manually, try:'));
+    console.log('1. Remove the invalid dependencies and/or devDependencies from your package.json');
+    console.log('2. Remove the node_modules folder and the dependencies lockfile (package-lock.json or yarn.lock)');
+    console.log('3. Reinstall dependencies');
+    console.log('4. Commit the changes to the package.json and lockfile');
+}
+async function removeInvalidDependencies({ packageJsonPath, duplicatedDependencies, duplicatedDevDependencies, nonSupportedDependencies, }) {
+    if (!duplicatedDependencies.length &&
+        !duplicatedDevDependencies.length &&
+        !nonSupportedDependencies.length) {
+        return;
+    }
+    const packageJson = getPackageJsonByPath(packageJsonPath);
+    nonSupportedDependencies.forEach(dependency => {
+        delete packageJson.dependencies[dependency];
+    });
+    duplicatedDependencies.forEach(dependency => {
+        delete packageJson.dependencies[dependency];
+    });
+    duplicatedDevDependencies.forEach(devDependency => {
+        delete packageJson.devDependencies[devDependency];
+    });
+    fs.writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, // keep the new line at the end of the file
+    {
+        encoding: 'utf-8',
+    });
+    await wrapWithLoadingIndicator(hardResetDependencies(), {
+        loadingMessage: 'Removing invalid dependencies and recreating lockfiles...',
+        successMessage: 'Dependencies reinstalled',
+    });
+}
+//# sourceMappingURL=diagnose-dependencies.js.map

package/build/commands/doctor/utils/diagnose-dependencies.js.map

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

package/build/commands/features/index.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+export interface FeaturesCommandArgs {
+    enable?: string;
+    disable?: string;
+}
+export declare const command: Command;