@shopify/cli-kit 3.20.1 → 3.21.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @shopify/cli-kit
 
+## 3.21.0
+
+### Minor Changes
+
+- 5cda6300: Enable external access to cli inside a spin instance
+
+### Patch Changes
+
+- e4352f2e: Do not report handled tunnel plugin errors to Bugsnag
+- c906187f: Add backticks surrounding command tokens
+
 ## 3.20.1
 
 ### Patch Changes

package/dist/plugins/tunnel.d.ts

@@ -1,4 +1,11 @@
+import { Result } from '../public/common/result.js';
 import { FanoutHookFunction, PluginReturnsForHook } from '../plugins.js';
+import { ExtendableError } from '../error.js';
+export declare type TunnelErrorType = 'invalid-provider' | 'tunnel-already-running' | 'wrong-credentials' | 'unknown';
+export declare class TunnelError extends ExtendableError {
+    type: TunnelErrorType;
+    constructor(type: TunnelErrorType, message?: string);
+}
 /**
  * Tunnel Plugins types
  *
@@ -11,9 +18,9 @@ export interface HookReturnPerTunnelPlugin {
             provider: string;
         };
         pluginReturns: {
-            [pluginName: string]: {
-                url: string | undefined;
-            };
+            [pluginName: string]: Result<{
+                url: string;
+            }, TunnelError>;
         };
     };
     tunnel_provider: {

package/dist/plugins/tunnel.js

@@ -1,10 +1,18 @@
+import { err } from '../public/common/result.js';
+import { ExtendableError } from '../error.js';
+export class TunnelError extends ExtendableError {
+    constructor(type, message) {
+        super(message);
+        this.type = type;
+    }
+}
 export const defineProvider = (input) => {
     return async () => input;
 };
 export const startTunnel = (options) => {
     return async (inputs) => {
         if (inputs.provider !== options.provider)
-            return { url: undefined };
+            return err(new TunnelError('invalid-provider'));
         return options.action(inputs.port);
     };
 };

package/dist/plugins/tunnel.js.map

@@ -1 +1 @@
-{"version":3,"file":"tunnel.js","sourceRoot":"","sources":["../../src/plugins/tunnel.ts"],"names":[],"mappings":"AA2BA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAqB,EAA0B,EAAE;IAC9E,OAAO,KAAK,IAAI,EAAE,CAAC,KAAK,CAAA;AAC1B,CAAC,CAAA;AACD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAsD,EAAuB,EAAE;IACzG,OAAO,KAAK,EAAE,MAAwC,EAA8B,EAAE;QACpF,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ;YAAE,OAAO,EAAC,GAAG,EAAE,SAAS,EAAC,CAAA;QACjE,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC,CAAA;AACH,CAAC,CAAA","sourcesContent":["import {FanoutHookFunction, PluginReturnsForHook} from '../plugins.js'\n\n/**\n * Tunnel Plugins types\n *\n * Any plugin that provides tunnel functionality should implement `defineProvider`and `startTunnel`\n */\nexport interface HookReturnPerTunnelPlugin {\n  tunnel_start: {\n    options: {port: number; provider: string}\n    pluginReturns: {\n      [pluginName: string]: {url: string | undefined}\n    }\n  }\n  tunnel_provider: {\n    options: {[key: string]: never}\n    pluginReturns: {\n      [pluginName: string]: {name: string}\n    }\n  }\n}\n\nexport type TunnelProviderFunction = FanoutHookFunction<'tunnel_provider', ''>\nexport type TunnelStartFunction = FanoutHookFunction<'tunnel_start', ''>\nexport type TunnelStartReturn = PluginReturnsForHook<'tunnel_start', ''>\nexport type TunnelStartAction = (port: number) => Promise<TunnelStartReturn>\n\nexport const defineProvider = (input: {name: string}): TunnelProviderFunction => {\n  return async () => input\n}\nexport const startTunnel = (options: {provider: string; action: TunnelStartAction}): TunnelStartFunction => {\n  return async (inputs: {provider: string; port: number}): Promise<TunnelStartReturn> => {\n    if (inputs.provider !== options.provider) return {url: undefined}\n    return options.action(inputs.port)\n  }\n}\n"]}
+{"version":3,"file":"tunnel.js","sourceRoot":"","sources":["../../src/plugins/tunnel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAS,MAAM,4BAA4B,CAAA;AAEtD,OAAO,EAAC,eAAe,EAAC,MAAM,aAAa,CAAA;AAG3C,MAAM,OAAO,WAAY,SAAQ,eAAe;IAE9C,YAAY,IAAqB,EAAE,OAAgB;QACjD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AA2BD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAqB,EAA0B,EAAE;IAC9E,OAAO,KAAK,IAAI,EAAE,CAAC,KAAK,CAAA;AAC1B,CAAC,CAAA;AACD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAsD,EAAuB,EAAE;IACzG,OAAO,KAAK,EAAE,MAAwC,EAA8B,EAAE;QACpF,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ;YAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAA;QACzF,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC,CAAA;AACH,CAAC,CAAA","sourcesContent":["import {err, Result} from '../public/common/result.js'\nimport {FanoutHookFunction, PluginReturnsForHook} from '../plugins.js'\nimport {ExtendableError} from '../error.js'\n\nexport type TunnelErrorType = 'invalid-provider' | 'tunnel-already-running' | 'wrong-credentials' | 'unknown'\nexport class TunnelError extends ExtendableError {\n  type: TunnelErrorType\n  constructor(type: TunnelErrorType, message?: string) {\n    super(message)\n    this.type = type\n  }\n}\n\n/**\n * Tunnel Plugins types\n *\n * Any plugin that provides tunnel functionality should implement `defineProvider`and `startTunnel`\n */\nexport interface HookReturnPerTunnelPlugin {\n  tunnel_start: {\n    options: {port: number; provider: string}\n    pluginReturns: {\n      [pluginName: string]: Result<{url: string}, TunnelError>\n    }\n  }\n  tunnel_provider: {\n    options: {[key: string]: never}\n    pluginReturns: {\n      [pluginName: string]: {name: string}\n    }\n  }\n}\n\nexport type TunnelProviderFunction = FanoutHookFunction<'tunnel_provider', ''>\nexport type TunnelStartFunction = FanoutHookFunction<'tunnel_start', ''>\nexport type TunnelStartReturn = PluginReturnsForHook<'tunnel_start', ''>\nexport type TunnelStartAction = (port: number) => Promise<TunnelStartReturn>\n\nexport const defineProvider = (input: {name: string}): TunnelProviderFunction => {\n  return async () => input\n}\nexport const startTunnel = (options: {provider: string; action: TunnelStartAction}): TunnelStartFunction => {\n  return async (inputs: {provider: string; port: number}): Promise<TunnelStartReturn> => {\n    if (inputs.provider !== options.provider) return err(new TunnelError('invalid-provider'))\n    return options.action(inputs.port)\n  }\n}\n"]}

package/dist/plugins.d.ts

@@ -2,6 +2,7 @@ import { JsonMap } from './json.js';
 import { PickByPrefix } from './typing/pick-by-prefix.js';
 import { MonorailEventPublic, MonorailEventSensitive } from './monorail.js';
 import { HookReturnPerTunnelPlugin } from './plugins/tunnel.js';
+import { Result } from './public/common/result.js';
 import { Config, Interfaces } from '@oclif/core';
 /**
  * Convenience function to trigger a hook, and gather any successful responses. Failures are ignored.
@@ -35,7 +36,7 @@ interface HookReturnsPerPlugin extends HookReturnPerTunnelPlugin {
             [key: string]: unknown;
         };
         pluginReturns: {
-            [key: string]: JsonMap;
+            [key: string]: JsonMap | Result<JsonMap, Error>;
         };
     };
 }
@@ -54,6 +55,11 @@ export declare function getListOfTunnelPlugins(config: Config): Promise<{
     plugins: string[];
     error?: string;
 }>;
+export interface TunnelPluginError {
+    provider: string;
+    type: 'multiple-urls' | 'handled-error' | 'unknown' | 'no-provider';
+    message?: string;
+}
 /**
  * Execute the 'tunnel_start' hook for the given provider.
  * Fails if there aren't plugins for that provider or if there are more than one.
@@ -63,8 +69,5 @@ export declare function getListOfTunnelPlugins(config: Config): Promise<{
  * @param provider - selected provider, must be unique
  * @returns tunnel URL from the selected provider
  */
-export declare function runTunnelPlugin(config: Config, port: number, provider: string): Promise<{
-    url?: string;
-    error?: string;
-}>;
+export declare function runTunnelPlugin(config: Config, port: number, provider: string): Promise<Result<string, TunnelPluginError>>;
 export {};

package/dist/plugins.js

@@ -1,4 +1,5 @@
 import { getArrayContainsDuplicates, getArrayRejectingUndefined } from './public/common/array.js';
+import { err } from './public/common/result.js';
 /**
  * Convenience function to trigger a hook, and gather any successful responses. Failures are ignored.
  *
@@ -34,11 +35,15 @@ export async function getListOfTunnelPlugins(config) {
  */
 export async function runTunnelPlugin(config, port, provider) {
     const hooks = await fanoutHooks(config, 'tunnel_start', { port, provider });
-    const urls = getArrayRejectingUndefined(Object.values(hooks).map((key) => key?.url));
-    if (urls.length > 1)
-        return { error: 'multiple-urls' };
-    if (urls.length === 0)
-        return { error: 'no-urls' };
-    return { url: urls[0] };
+    const urlResults = Object.values(hooks).filter((tunnelResponse) => !tunnelResponse?.isErr() || tunnelResponse.error.type !== 'invalid-provider');
+    if (urlResults.length > 1)
+        return err({ provider, type: 'multiple-urls' });
+    if (urlResults.length === 0 || !urlResults[0])
+        return err({ provider, type: 'no-provider' });
+    return urlResults[0]
+        .map((data) => data.url)
+        .mapError((error) => error.type === 'unknown'
+        ? { provider, type: 'unknown', message: error.message }
+        : { provider, type: 'handled-error' });
 }
 //# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,0BAA0B,EAAE,0BAA0B,EAAC,MAAM,0BAA0B,CAAA;AAG/F;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAyB,EACzB,KAAa,EACb,OAA4C,EAC5C,OAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACzD,8DAA8D;IAC9D,OAAO,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAC,MAAM,EAAE,MAAM,EAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAQ,CAAA;AAClG,CAAC;AA4CD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAc;IACzD,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAA;IAC9D,MAAM,KAAK,GAAG,0BAA0B,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAA;IACtF,IAAI,0BAA0B,CAAC,KAAK,CAAC;QAAE,OAAO,EAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,+BAA+B,EAAC,CAAA;IACtG,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,CAAA;AACzB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,IAAY,EACZ,QAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAC,CAAC,CAAA;IACzE,MAAM,IAAI,GAAG,0BAA0B,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;IACpF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAC,KAAK,EAAE,eAAe,EAAC,CAAA;IACpD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAC,KAAK,EAAE,SAAS,EAAC,CAAA;IAChD,OAAO,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,EAAC,CAAA;AACvB,CAAC","sourcesContent":["import {JsonMap} from './json.js'\nimport {PickByPrefix} from './typing/pick-by-prefix.js'\nimport {MonorailEventPublic, MonorailEventSensitive} from './monorail.js'\nimport {HookReturnPerTunnelPlugin} from './plugins/tunnel.js'\nimport {getArrayContainsDuplicates, getArrayRejectingUndefined} from './public/common/array.js'\nimport {Config, Interfaces} from '@oclif/core'\n\n/**\n * Convenience function to trigger a hook, and gather any successful responses. Failures are ignored.\n *\n * Responses are organised into a dictionary, keyed by plug-in name. Only plug-ins that have hooks registered for the given event, and the hooks were run successfully, are included.\n */\nexport async function fanoutHooks<TPluginMap extends HookReturnsPerPlugin, TEvent extends string & keyof TPluginMap>(\n  config: Interfaces.Config,\n  event: TEvent,\n  options: TPluginMap[typeof event]['options'],\n  timeout?: number,\n): Promise<Partial<TPluginMap[typeof event]['pluginReturns']>> {\n  const res = await config.runHook(event, options, timeout)\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return Object.fromEntries(res.successes.map(({result, plugin}) => [plugin.name, result])) as any\n}\n\ntype AppSpecificMonorailFields = PickByPrefix<MonorailEventPublic, 'app_', 'project_type' | 'api_key' | 'partner_id'> &\n  PickByPrefix<MonorailEventPublic, 'cmd_extensions_'> &\n  PickByPrefix<MonorailEventPublic, 'cmd_scaffold_'>\n\ntype AppSpecificSensitiveMonorailFields = PickByPrefix<MonorailEventSensitive, 'app_'>\n\ninterface HookReturnsPerPlugin extends HookReturnPerTunnelPlugin {\n  public_command_metadata: {\n    options: {[key: string]: never}\n    pluginReturns: {\n      '@shopify/app': Partial<AppSpecificMonorailFields>\n      [pluginName: string]: JsonMap\n    }\n  }\n  sensitive_command_metadata: {\n    options: {[key: string]: never}\n    pluginReturns: {\n      '@shopify/app': Partial<AppSpecificSensitiveMonorailFields>\n      [pluginName: string]: JsonMap\n    }\n  }\n  [hookName: string]: {\n    options: {[key: string]: unknown}\n    pluginReturns: {[key: string]: JsonMap}\n  }\n}\n\nexport type PluginReturnsForHook<\n  TEvent extends keyof TPluginMap,\n  TPluginName extends keyof TPluginMap[TEvent]['pluginReturns'],\n  TPluginMap extends HookReturnsPerPlugin = HookReturnsPerPlugin,\n> = TPluginMap[TEvent]['pluginReturns'][TPluginName]\n\nexport type FanoutHookFunction<\n  TEvent extends keyof TPluginMap = string,\n  TPluginName extends keyof TPluginMap[TEvent]['pluginReturns'] = string,\n  TPluginMap extends HookReturnsPerPlugin = HookReturnsPerPlugin,\n> = (\n  this: Interfaces.Hook.Context,\n  options: TPluginMap[TEvent]['options'] & {config: Interfaces.Config},\n) => Promise<PluginReturnsForHook<TEvent, TPluginName, TPluginMap>>\n\n/**\n * Execute the 'tunnel_provider' hook, and return the list of available tunnel providers.\n * Fail if there are multiple plugins for the same provider\n *\n * @param config - oclif config used to execute hooks\n * @returns list of available tunnel plugins\n */\nexport async function getListOfTunnelPlugins(config: Config): Promise<{plugins: string[]; error?: string}> {\n  const hooks = await fanoutHooks(config, 'tunnel_provider', {})\n  const names = getArrayRejectingUndefined(Object.values(hooks).map((key) => key?.name))\n  if (getArrayContainsDuplicates(names)) return {plugins: names, error: 'multiple-plugins-for-provider'}\n  return {plugins: names}\n}\n\n/**\n * Execute the 'tunnel_start' hook for the given provider.\n * Fails if there aren't plugins for that provider or if there are more than one.\n *\n * @param config - oclif config used to execute hooks\n * @param port - port where the tunnel will be started\n * @param provider - selected provider, must be unique\n * @returns tunnel URL from the selected provider\n */\nexport async function runTunnelPlugin(\n  config: Config,\n  port: number,\n  provider: string,\n): Promise<{url?: string; error?: string}> {\n  const hooks = await fanoutHooks(config, 'tunnel_start', {port, provider})\n  const urls = getArrayRejectingUndefined(Object.values(hooks).map((key) => key?.url))\n  if (urls.length > 1) return {error: 'multiple-urls'}\n  if (urls.length === 0) return {error: 'no-urls'}\n  return {url: urls[0]}\n}\n"]}
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,0BAA0B,EAAE,0BAA0B,EAAC,MAAM,0BAA0B,CAAA;AAC/F,OAAO,EAAC,GAAG,EAAS,MAAM,2BAA2B,CAAA;AAGrD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAyB,EACzB,KAAa,EACb,OAA4C,EAC5C,OAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACzD,8DAA8D;IAC9D,OAAO,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAC,MAAM,EAAE,MAAM,EAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAQ,CAAA;AAClG,CAAC;AA4CD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAc;IACzD,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAA;IAC9D,MAAM,KAAK,GAAG,0BAA0B,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAA;IACtF,IAAI,0BAA0B,CAAC,KAAK,CAAC;QAAE,OAAO,EAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,+BAA+B,EAAC,CAAA;IACtG,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,CAAA;AACzB,CAAC;AAQD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,IAAY,EACZ,QAAgB;IAEhB,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAC,CAAC,CAAA;IACzE,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAC5C,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,kBAAkB,CACjG,CAAA;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,EAAC,QAAQ,EAAE,IAAI,EAAE,eAAe,EAAC,CAAC,CAAA;IACxE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC,EAAC,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAC,CAAC,CAAA;IAE1F,OAAO,UAAU,CAAC,CAAC,CAAC;SACjB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;SACvB,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CAClB,KAAK,CAAC,IAAI,KAAK,SAAS;QACtB,CAAC,CAAC,EAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAC;QACrD,CAAC,CAAC,EAAC,QAAQ,EAAE,IAAI,EAAE,eAAe,EAAC,CACtC,CAAA;AACL,CAAC","sourcesContent":["import {JsonMap} from './json.js'\nimport {PickByPrefix} from './typing/pick-by-prefix.js'\nimport {MonorailEventPublic, MonorailEventSensitive} from './monorail.js'\nimport {HookReturnPerTunnelPlugin} from './plugins/tunnel.js'\nimport {getArrayContainsDuplicates, getArrayRejectingUndefined} from './public/common/array.js'\nimport {err, Result} from './public/common/result.js'\nimport {Config, Interfaces} from '@oclif/core'\n\n/**\n * Convenience function to trigger a hook, and gather any successful responses. Failures are ignored.\n *\n * Responses are organised into a dictionary, keyed by plug-in name. Only plug-ins that have hooks registered for the given event, and the hooks were run successfully, are included.\n */\nexport async function fanoutHooks<TPluginMap extends HookReturnsPerPlugin, TEvent extends string & keyof TPluginMap>(\n  config: Interfaces.Config,\n  event: TEvent,\n  options: TPluginMap[typeof event]['options'],\n  timeout?: number,\n): Promise<Partial<TPluginMap[typeof event]['pluginReturns']>> {\n  const res = await config.runHook(event, options, timeout)\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return Object.fromEntries(res.successes.map(({result, plugin}) => [plugin.name, result])) as any\n}\n\ntype AppSpecificMonorailFields = PickByPrefix<MonorailEventPublic, 'app_', 'project_type' | 'api_key' | 'partner_id'> &\n  PickByPrefix<MonorailEventPublic, 'cmd_extensions_'> &\n  PickByPrefix<MonorailEventPublic, 'cmd_scaffold_'>\n\ntype AppSpecificSensitiveMonorailFields = PickByPrefix<MonorailEventSensitive, 'app_'>\n\ninterface HookReturnsPerPlugin extends HookReturnPerTunnelPlugin {\n  public_command_metadata: {\n    options: {[key: string]: never}\n    pluginReturns: {\n      '@shopify/app': Partial<AppSpecificMonorailFields>\n      [pluginName: string]: JsonMap\n    }\n  }\n  sensitive_command_metadata: {\n    options: {[key: string]: never}\n    pluginReturns: {\n      '@shopify/app': Partial<AppSpecificSensitiveMonorailFields>\n      [pluginName: string]: JsonMap\n    }\n  }\n  [hookName: string]: {\n    options: {[key: string]: unknown}\n    pluginReturns: {[key: string]: JsonMap | Result<JsonMap, Error>}\n  }\n}\n\nexport type PluginReturnsForHook<\n  TEvent extends keyof TPluginMap,\n  TPluginName extends keyof TPluginMap[TEvent]['pluginReturns'],\n  TPluginMap extends HookReturnsPerPlugin = HookReturnsPerPlugin,\n> = TPluginMap[TEvent]['pluginReturns'][TPluginName]\n\nexport type FanoutHookFunction<\n  TEvent extends keyof TPluginMap = string,\n  TPluginName extends keyof TPluginMap[TEvent]['pluginReturns'] = string,\n  TPluginMap extends HookReturnsPerPlugin = HookReturnsPerPlugin,\n> = (\n  this: Interfaces.Hook.Context,\n  options: TPluginMap[TEvent]['options'] & {config: Interfaces.Config},\n) => Promise<PluginReturnsForHook<TEvent, TPluginName, TPluginMap>>\n\n/**\n * Execute the 'tunnel_provider' hook, and return the list of available tunnel providers.\n * Fail if there are multiple plugins for the same provider\n *\n * @param config - oclif config used to execute hooks\n * @returns list of available tunnel plugins\n */\nexport async function getListOfTunnelPlugins(config: Config): Promise<{plugins: string[]; error?: string}> {\n  const hooks = await fanoutHooks(config, 'tunnel_provider', {})\n  const names = getArrayRejectingUndefined(Object.values(hooks).map((key) => key?.name))\n  if (getArrayContainsDuplicates(names)) return {plugins: names, error: 'multiple-plugins-for-provider'}\n  return {plugins: names}\n}\n\nexport interface TunnelPluginError {\n  provider: string\n  type: 'multiple-urls' | 'handled-error' | 'unknown' | 'no-provider'\n  message?: string\n}\n\n/**\n * Execute the 'tunnel_start' hook for the given provider.\n * Fails if there aren't plugins for that provider or if there are more than one.\n *\n * @param config - oclif config used to execute hooks\n * @param port - port where the tunnel will be started\n * @param provider - selected provider, must be unique\n * @returns tunnel URL from the selected provider\n */\nexport async function runTunnelPlugin(\n  config: Config,\n  port: number,\n  provider: string,\n): Promise<Result<string, TunnelPluginError>> {\n  const hooks = await fanoutHooks(config, 'tunnel_start', {port, provider})\n  const urlResults = Object.values(hooks).filter(\n    (tunnelResponse) => !tunnelResponse?.isErr() || tunnelResponse.error.type !== 'invalid-provider',\n  )\n  if (urlResults.length > 1) return err({provider, type: 'multiple-urls'})\n  if (urlResults.length === 0 || !urlResults[0]) return err({provider, type: 'no-provider'})\n\n  return urlResults[0]\n    .map((data) => data.url)\n    .mapError((error) =>\n      error.type === 'unknown'\n        ? {provider, type: 'unknown', message: error.message}\n        : {provider, type: 'handled-error'},\n    )\n}\n"]}

package/dist/private/node/ui/components/Command.js

@@ -4,7 +4,10 @@ import React from 'react';
  * `Command` displays a command as non-dimmed text.
  */
 const Command = ({ command }) => {
-    return React.createElement(Text, null, command);
+    return React.createElement(Text, null,
+        "`",
+        command,
+        "`");
 };
 export { Command };
 //# sourceMappingURL=Command.js.map

package/dist/private/node/ui/components/Command.js.map

@@ -1 +1 @@
-{"version":3,"file":"Command.js","sourceRoot":"","sources":["../../../../../src/private/node/ui/components/Command.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,KAAK,CAAA;AACxB,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB;;GAEG;AACH,MAAM,OAAO,GAAoB,CAAC,EAAC,OAAO,EAAiC,EAAe,EAAE;IAC1F,OAAO,oBAAC,IAAI,QAAE,OAAO,CAAQ,CAAA;AAC/B,CAAC,CAAA;AAED,OAAO,EAAC,OAAO,EAAC,CAAA","sourcesContent":["import {Text} from 'ink'\nimport React from 'react'\n\ninterface Props {\n  command: string\n}\n\n/**\n * `Command` displays a command as non-dimmed text.\n */\nconst Command: React.FC<Props> = ({command}: React.PropsWithChildren<Props>): JSX.Element => {\n  return <Text>{command}</Text>\n}\n\nexport {Command}\n"]}
+{"version":3,"file":"Command.js","sourceRoot":"","sources":["../../../../../src/private/node/ui/components/Command.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,KAAK,CAAA;AACxB,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB;;GAEG;AACH,MAAM,OAAO,GAAoB,CAAC,EAAC,OAAO,EAAiC,EAAe,EAAE;IAC1F,OAAO,oBAAC,IAAI;;QAAG,OAAO;YAAS,CAAA;AACjC,CAAC,CAAA;AAED,OAAO,EAAC,OAAO,EAAC,CAAA","sourcesContent":["import {Text} from 'ink'\nimport React from 'react'\n\ninterface Props {\n  command: string\n}\n\n/**\n * `Command` displays a command as non-dimmed text.\n */\nconst Command: React.FC<Props> = ({command}: React.PropsWithChildren<Props>): JSX.Element => {\n  return <Text>`{command}`</Text>\n}\n\nexport {Command}\n"]}

package/dist/public/common/result.d.ts

@@ -0,0 +1,88 @@
+export declare type Result<TValue, TError> = Ok<TValue, TError> | Err<TValue, TError>;
+/**
+ * Utility metho to create an `Ok` result from a `value`
+ *
+ * @param value - `value` used to crete the `Result`
+ * @returns an instance of a `Ok` `Result` inferring its type
+ */
+export declare const ok: <TValue, TError = never>(value: TValue) => Ok<TValue, TError>;
+/**
+ * Utility method to create an `Error` result from an `error`
+ *
+ * @param err - `error` used to crete the `Result`
+ * @returns an instance of an `Error` `Result` inferring its type
+ */
+export declare const err: <TValue = never, TError = unknown>(err: TError) => Err<TValue, TError>;
+export declare class Ok<TValue, TError> {
+    readonly value: TValue;
+    constructor(value: TValue);
+    /**
+     * Check if a `Result` is an `Err` inferring its type. `!isErr()` should be used before accessing the `value`
+     *
+     * @returns `false` as the `Resul` is `OK`
+     */
+    isErr(): this is Err<TValue, TError>;
+    /**
+     * Runs the `handler` method an return the same an unaltered copy of the `Result`. It could be used to log an
+     * output when the result is `Ok` without breaking the flow
+     *
+     * @param handler - method to be run when the result is `Ok`
+     * @returns a copy of the same `Result`
+     */
+    doOnOk(handler: (value: TValue) => void): Result<TValue, TError>;
+    /**
+     * A safe mode to get the `value` of the `Result`
+     *
+     * @returns the `value` of the `Result`
+     */
+    valueOrThrow(): TValue;
+    /**
+     * Maps the value to another one with a different type. It leaves the `Error` type unaltered
+     *
+     * @param mapper - The mapper method to apply an `OK` value
+     * @returns a new result with the new mapped value
+     */
+    map<TMappedValue>(mapper: (value: TValue) => TMappedValue): Result<TMappedValue, TError>;
+    /**
+     * Maps the error type to another one. It leaves the `Ok` type and value unaltered
+     *
+     * @param _mapper - This mapper method is not used for an `Ok` value
+     * @returns a new result with the new mapped error type and an value
+     */
+    mapError<TMappedError>(_mapper: (error: TError) => TMappedError): Result<TValue, TMappedError>;
+}
+export declare class Err<TValue, TError> {
+    readonly error: TError;
+    constructor(error: TError);
+    /**
+     * Check if a `Result` is an `Err` inferring its type. `!isErr()` should be used before accessing the `value`
+     *
+     * @returns `false` as the `Resul` is `OK`
+     */
+    isErr(): this is Err<TValue, TError>;
+    /**
+     * Return an unaltered copy of the `Error` without doing anything.
+     *
+     * @param _handler - This handler method is not used for an `Error`
+     * @returns a copy of the same `Error`
+     */
+    doOnOk(_handler: (value: TValue) => void): Result<TValue, TError>;
+    /**
+     * A safe mode to throw the `error` of the `Result`
+     */
+    valueOrThrow(): TValue;
+    /**
+     * Maps the value type to another one. It leaves the `Error` unaltered
+     *
+     * @param _mapper - This mapper method is not used for an `Error` value
+     * @returns a new result with the new value type and an unaltered error
+     */
+    map<TMappedValue>(_mapper: (valueOrThrow: TValue) => TMappedValue): Result<TMappedValue, TError>;
+    /**
+     * Maps the error to another one with a different type. It leaves the value type unaltered
+     *
+     * @param mapper - The mapper method to apply an `Error` value
+     * @returns a new result with the new mapped error
+     */
+    mapError<TMappedError>(mapper: (error: TError) => TMappedError): Result<TValue, TMappedError>;
+}

package/dist/public/common/result.js

@@ -0,0 +1,111 @@
+/**
+ * Utility metho to create an `Ok` result from a `value`
+ *
+ * @param value - `value` used to crete the `Result`
+ * @returns an instance of a `Ok` `Result` inferring its type
+ */
+export const ok = (value) => new Ok(value);
+/**
+ * Utility method to create an `Error` result from an `error`
+ *
+ * @param err - `error` used to crete the `Result`
+ * @returns an instance of an `Error` `Result` inferring its type
+ */
+export const err = (err) => new Err(err);
+export class Ok {
+    constructor(value) {
+        this.value = value;
+    }
+    /**
+     * Check if a `Result` is an `Err` inferring its type. `!isErr()` should be used before accessing the `value`
+     *
+     * @returns `false` as the `Resul` is `OK`
+     */
+    isErr() {
+        return false;
+    }
+    /**
+     * Runs the `handler` method an return the same an unaltered copy of the `Result`. It could be used to log an
+     * output when the result is `Ok` without breaking the flow
+     *
+     * @param handler - method to be run when the result is `Ok`
+     * @returns a copy of the same `Result`
+     */
+    doOnOk(handler) {
+        handler(this.value);
+        return ok(this.value);
+    }
+    /**
+     * A safe mode to get the `value` of the `Result`
+     *
+     * @returns the `value` of the `Result`
+     */
+    valueOrThrow() {
+        return this.value;
+    }
+    /**
+     * Maps the value to another one with a different type. It leaves the `Error` type unaltered
+     *
+     * @param mapper - The mapper method to apply an `OK` value
+     * @returns a new result with the new mapped value
+     */
+    map(mapper) {
+        return ok(mapper(this.value));
+    }
+    /**
+     * Maps the error type to another one. It leaves the `Ok` type and value unaltered
+     *
+     * @param _mapper - This mapper method is not used for an `Ok` value
+     * @returns a new result with the new mapped error type and an value
+     */
+    mapError(_mapper) {
+        return ok(this.value);
+    }
+}
+export class Err {
+    constructor(error) {
+        this.error = error;
+    }
+    /**
+     * Check if a `Result` is an `Err` inferring its type. `!isErr()` should be used before accessing the `value`
+     *
+     * @returns `false` as the `Resul` is `OK`
+     */
+    isErr() {
+        return true;
+    }
+    /**
+     * Return an unaltered copy of the `Error` without doing anything.
+     *
+     * @param _handler - This handler method is not used for an `Error`
+     * @returns a copy of the same `Error`
+     */
+    doOnOk(_handler) {
+        return err(this.error);
+    }
+    /**
+     * A safe mode to throw the `error` of the `Result`
+     */
+    valueOrThrow() {
+        throw this.error;
+    }
+    /**
+     * Maps the value type to another one. It leaves the `Error` unaltered
+     *
+     * @param _mapper - This mapper method is not used for an `Error` value
+     * @returns a new result with the new value type and an unaltered error
+     */
+    map(_mapper) {
+        return err(this.error);
+    }
+    /**
+     * Maps the error to another one with a different type. It leaves the value type unaltered
+     *
+     * @param mapper - The mapper method to apply an `Error` value
+     * @returns a new result with the new mapped error
+     */
+    mapError(mapper) {
+        return err(mapper(this.error));
+    }
+}
+//# sourceMappingURL=result.js.map

package/dist/public/common/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/public/common/result.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,EAAE,GAAG,CAAyB,KAAa,EAAsB,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAA;AAE9F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CAAmC,GAAW,EAAuB,EAAE,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;AAEvG,MAAM,OAAO,EAAE;IACb,YAAqB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAEtC;;;;OAIG;IACH,KAAK;QACH,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,OAAgC;QACrC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACnB,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACvB,CAAC;IAED;;;;OAIG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAe,MAAuC;QACvD,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IAC/B,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAe,OAAwC;QAC7D,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACvB,CAAC;CACF;AAED,MAAM,OAAO,GAAG;IACd,YAAqB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAEtC;;;;OAIG;IACH,KAAK;QACH,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAiC;QACtC,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC;IAED;;OAEG;IACH,YAAY;QACV,MAAM,IAAI,CAAC,KAAK,CAAA;IAClB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAe,OAA+C;QAC/D,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAe,MAAuC;QAC5D,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IAChC,CAAC;CACF","sourcesContent":["/* eslint-disable node/handle-callback-err */\nexport type Result<TValue, TError> = Ok<TValue, TError> | Err<TValue, TError>\n\n/**\n * Utility metho to create an `Ok` result from a `value`\n *\n * @param value - `value` used to crete the `Result`\n * @returns an instance of a `Ok` `Result` inferring its type\n */\nexport const ok = <TValue, TError = never>(value: TValue): Ok<TValue, TError> => new Ok(value)\n\n/**\n * Utility method to create an `Error` result from an `error`\n *\n * @param err - `error` used to crete the `Result`\n * @returns an instance of an `Error` `Result` inferring its type\n */\nexport const err = <TValue = never, TError = unknown>(err: TError): Err<TValue, TError> => new Err(err)\n\nexport class Ok<TValue, TError> {\n  constructor(readonly value: TValue) {}\n\n  /**\n   * Check if a `Result` is an `Err` inferring its type. `!isErr()` should be used before accessing the `value`\n   *\n   * @returns `false` as the `Resul` is `OK`\n   */\n  isErr(): this is Err<TValue, TError> {\n    return false\n  }\n\n  /**\n   * Runs the `handler` method an return the same an unaltered copy of the `Result`. It could be used to log an\n   * output when the result is `Ok` without breaking the flow\n   *\n   * @param handler - method to be run when the result is `Ok`\n   * @returns a copy of the same `Result`\n   */\n  doOnOk(handler: (value: TValue) => void): Result<TValue, TError> {\n    handler(this.value)\n    return ok(this.value)\n  }\n\n  /**\n   * A safe mode to get the `value` of the `Result`\n   *\n   * @returns the `value` of the `Result`\n   */\n  valueOrThrow(): TValue {\n    return this.value\n  }\n\n  /**\n   * Maps the value to another one with a different type. It leaves the `Error` type unaltered\n   *\n   * @param mapper - The mapper method to apply an `OK` value\n   * @returns a new result with the new mapped value\n   */\n  map<TMappedValue>(mapper: (value: TValue) => TMappedValue): Result<TMappedValue, TError> {\n    return ok(mapper(this.value))\n  }\n\n  /**\n   * Maps the error type to another one. It leaves the `Ok` type and value unaltered\n   *\n   * @param _mapper - This mapper method is not used for an `Ok` value\n   * @returns a new result with the new mapped error type and an value\n   */\n  mapError<TMappedError>(_mapper: (error: TError) => TMappedError): Result<TValue, TMappedError> {\n    return ok(this.value)\n  }\n}\n\nexport class Err<TValue, TError> {\n  constructor(readonly error: TError) {}\n\n  /**\n   * Check if a `Result` is an `Err` inferring its type. `!isErr()` should be used before accessing the `value`\n   *\n   * @returns `false` as the `Resul` is `OK`\n   */\n  isErr(): this is Err<TValue, TError> {\n    return true\n  }\n\n  /**\n   * Return an unaltered copy of the `Error` without doing anything.\n   *\n   * @param _handler - This handler method is not used for an `Error`\n   * @returns a copy of the same `Error`\n   */\n  doOnOk(_handler: (value: TValue) => void): Result<TValue, TError> {\n    return err(this.error)\n  }\n\n  /**\n   * A safe mode to throw the `error` of the `Result`\n   */\n  valueOrThrow(): TValue {\n    throw this.error\n  }\n\n  /**\n   * Maps the value type to another one. It leaves the `Error` unaltered\n   *\n   * @param _mapper - This mapper method is not used for an `Error` value\n   * @returns a new result with the new value type and an unaltered error\n   */\n  map<TMappedValue>(_mapper: (valueOrThrow: TValue) => TMappedValue): Result<TMappedValue, TError> {\n    return err(this.error)\n  }\n\n  /**\n   * Maps the error to another one with a different type. It leaves the value type unaltered\n   *\n   * @param mapper - The mapper method to apply an `Error` value\n   * @returns a new result with the new mapped error\n   */\n  mapError<TMappedError>(mapper: (error: TError) => TMappedError): Result<TValue, TMappedError> {\n    return err(mapper(this.error))\n  }\n}\n"]}

package/dist/public/node/ui.d.ts

@@ -35,12 +35,12 @@ declare type RenderAlertOptions = Omit<AlertProps, 'type'>;
  * │  Body                                                    │
  * │                                                          │
  * │  Next steps                                              │
- * │    • Run cd santorini-goods                              │
- * │    • To preview your project, run npm app dev            │
- * │    • To add extensions, run npm generate extension       │
+ * │    • Run `cd santorini-goods`                            │
+ * │    • To preview your project, run `npm app dev`          │
+ * │    • To add extensions, run `npm generate extension`     │
  * │                                                          │
  * │  Reference                                               │
- * │    • Run npm shopify help                                │
+ * │    • Run `npm shopify help`                              │
  * │    • Press 'return' to open the dev docs:                │
  * │      https://shopify.dev                                 │
  * │                                                          │
@@ -72,12 +72,12 @@ export declare function renderInfo(options: RenderAlertOptions): void;
  * │  Body                                                    │
  * │                                                          │
  * │  Next steps                                              │
- * │    • Run cd santorini-goods                              │
- * │    • To preview your project, run npm app dev            │
- * │    • To add extensions, run npm generate extension       │
+ * │    • Run `cd santorini-goods`                              │
+ * │    • To preview your project, run `npm app dev`            │
+ * │    • To add extensions, run `npm generate extension`       │
  * │                                                          │
  * │  Reference                                               │
- * │    • Run npm shopify help                                │
+ * │    • Run `npm shopify help`                                │
  * │    • Press 'return' to open the dev docs:                │
  * │      https://shopify.dev                                 │
  * │                                                          │
@@ -109,12 +109,12 @@ export declare function renderSuccess(options: RenderAlertOptions): void;
  * │  Body                                                    │
  * │                                                          │
  * │  Next steps                                              │
- * │    • Run cd santorini-goods                              │
- * │    • To preview your project, run npm app dev            │
- * │    • To add extensions, run npm generate extension       │
+ * │    • Run `cd santorini-goods`                            │
+ * │    • To preview your project, run `npm app dev`          │
+ * │    • To add extensions, run `npm generate extension`     │
  * │                                                          │
  * │  Reference                                               │
- * │    • Run npm shopify help                                │
+ * │    • Run `npm shopify help`                              │
  * │    • Press 'return' to open the dev docs:                │
  * │      https://shopify.dev                                 │
  * │                                                          │

package/dist/public/node/ui.js

@@ -33,12 +33,12 @@ export async function renderConcurrent({ processes, abortController, showTimesta
  * │  Body                                                    │
  * │                                                          │
  * │  Next steps                                              │
- * │    • Run cd santorini-goods                              │
- * │    • To preview your project, run npm app dev            │
- * │    • To add extensions, run npm generate extension       │
+ * │    • Run `cd santorini-goods`                            │
+ * │    • To preview your project, run `npm app dev`          │
+ * │    • To add extensions, run `npm generate extension`     │
  * │                                                          │
  * │  Reference                                               │
- * │    • Run npm shopify help                                │
+ * │    • Run `npm shopify help`                              │
  * │    • Press 'return' to open the dev docs:                │
  * │      https://shopify.dev                                 │
  * │                                                          │
@@ -72,12 +72,12 @@ export function renderInfo(options) {
  * │  Body                                                    │
  * │                                                          │
  * │  Next steps                                              │
- * │    • Run cd santorini-goods                              │
- * │    • To preview your project, run npm app dev            │
- * │    • To add extensions, run npm generate extension       │
+ * │    • Run `cd santorini-goods`                              │
+ * │    • To preview your project, run `npm app dev`            │
+ * │    • To add extensions, run `npm generate extension`       │
  * │                                                          │
  * │  Reference                                               │
- * │    • Run npm shopify help                                │
+ * │    • Run `npm shopify help`                                │
  * │    • Press 'return' to open the dev docs:                │
  * │      https://shopify.dev                                 │
  * │                                                          │
@@ -111,12 +111,12 @@ export function renderSuccess(options) {
  * │  Body                                                    │
  * │                                                          │
  * │  Next steps                                              │
- * │    • Run cd santorini-goods                              │
- * │    • To preview your project, run npm app dev            │
- * │    • To add extensions, run npm generate extension       │
+ * │    • Run `cd santorini-goods`                            │
+ * │    • To preview your project, run `npm app dev`          │
+ * │    • To add extensions, run `npm generate extension`     │
  * │                                                          │
  * │  Reference                                               │
- * │    • Run npm shopify help                                │
+ * │    • Run `npm shopify help`                              │
  * │    • Press 'return' to open the dev docs:                │
  * │      https://shopify.dev                                 │
  * │                                                          │

package/dist/public/node/ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../../src/public/node/ui.tsx"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,sDAAsD,CAAA;AAEnF,OAAO,EAAC,MAAM,EAAC,MAAM,0BAA0B,CAAA;AAE/C,OAAO,EAAC,KAAK,EAAC,MAAM,gCAAgC,CAAA;AACpD,OAAO,EAAC,UAAU,EAAE,KAAK,EAAC,MAAM,gCAAgC,CAAA;AAGhE,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAA;AAQhD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAC,SAAS,EAAE,eAAe,EAAE,cAAc,GAAG,IAAI,EAA0B;IACjH,MAAM,EAAC,aAAa,EAAC,GAAG,MAAM,CAC5B,oBAAC,gBAAgB,IACf,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,IAAI,IAAI,eAAe,EAAE,EACzD,cAAc,EAAE,cAAc,GAC9B,CACH,CAAA;IAED,OAAO,aAAa,EAAE,CAAA;AACxB,CAAC;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,UAAU,CAAC,OAA2B;IACpD,KAAK,CAAC,EAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAC,CAAC,CAAA;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,aAAa,CAAC,OAA2B;IACvD,KAAK,CAAC,EAAC,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,EAAC,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,aAAa,CAAC,OAA2B;IACvD,KAAK,CAAC,EAAC,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,EAAC,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,UAAU,CAAC,KAAK,CAAC,CAAA;AACnB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAC,OAAmB;IAC7C,KAAK,CAAC,OAAO,CAAC,CAAA;AAChB,CAAC","sourcesContent":["import ConcurrentOutput from '../../private/node/ui/components/ConcurrentOutput.js'\nimport {OutputProcess} from '../../output.js'\nimport {render} from '../../private/node/ui.js'\nimport {Fatal} from '../../error.js'\nimport {alert} from '../../private/node/ui/alert.js'\nimport {fatalError, error} from '../../private/node/ui/error.js'\nimport {AlertProps} from '../../private/node/ui/components/Alert.js'\nimport {ErrorProps} from '../../private/node/ui/components/Error.js'\nimport React from 'react'\nimport {AbortController} from 'abort-controller'\n\ninterface RenderConcurrentOptions {\n  processes: OutputProcess[]\n  abortController?: AbortController\n  showTimestamps?: boolean\n}\n\n/**\n * Renders output from concurrent processes to the terminal with {@link ConcurrentOutput}.\n */\nexport async function renderConcurrent({processes, abortController, showTimestamps = true}: RenderConcurrentOptions) {\n  const {waitUntilExit} = render(\n    <ConcurrentOutput\n      processes={processes}\n      abortController={abortController ?? new AbortController()}\n      showTimestamps={showTimestamps}\n    />,\n  )\n\n  return waitUntilExit()\n}\n\ntype RenderAlertOptions = Omit<AlertProps, 'type'>\n\n/**\n * Renders an information banner to the console.\n *\n * Basic:\n *\n * ```\n * ╭─ info ───────────────────────────────────────────────────╮\n * │                                                          │\n * │  Body                                                    │\n * │                                                          │\n * ╰──────────────────────────────────────────────────────────╯\n * ```\n *\n * Complete:\n * ```\n * ╭─ info ───────────────────────────────────────────────────╮\n * │                                                          │\n * │  Title                                                   │\n * │                                                          │\n * │  Body                                                    │\n * │                                                          │\n * │  Next steps                                              │\n * │    • Run cd santorini-goods                              │\n * │    • To preview your project, run npm app dev            │\n * │    • To add extensions, run npm generate extension       │\n * │                                                          │\n * │  Reference                                               │\n * │    • Run npm shopify help                                │\n * │    • Press 'return' to open the dev docs:                │\n * │      https://shopify.dev                                 │\n * │                                                          │\n * │  Link: https://shopify.com                               │\n * │                                                          │\n * ╰──────────────────────────────────────────────────────────╯\n * ```\n */\nexport function renderInfo(options: RenderAlertOptions) {\n  alert({...options, type: 'info'})\n}\n\n/**\n * Renders a success banner to the console.\n *\n * Basic:\n *\n * ```\n * ╭─ success ────────────────────────────────────────────────╮\n * │                                                          │\n * │  Title                                                   │\n * │                                                          │\n * ╰──────────────────────────────────────────────────────────╯\n * ```\n *\n * Complete:\n * ```\n * ╭─ success ────────────────────────────────────────────────╮\n * │                                                          │\n * │  Title                                                   │\n * │                                                          │\n * │  Body                                                    │\n * │                                                          │\n * │  Next steps                                              │\n * │    • Run cd santorini-goods                              │\n * │    • To preview your project, run npm app dev            │\n * │    • To add extensions, run npm generate extension       │\n * │                                                          │\n * │  Reference                                               │\n * │    • Run npm shopify help                                │\n * │    • Press 'return' to open the dev docs:                │\n * │      https://shopify.dev                                 │\n * │                                                          │\n * │  Link: https://shopify.com                               │\n * │                                                          │\n * ╰──────────────────────────────────────────────────────────╯\n * ```\n */\nexport function renderSuccess(options: RenderAlertOptions) {\n  alert({...options, type: 'success'})\n}\n\n/**\n * Renders a warning banner to the console.\n *\n * Basic:\n *\n * ```\n * ╭─ warning ────────────────────────────────────────────────╮\n * │                                                          │\n * │  Title                                                   │\n * │                                                          │\n * ╰──────────────────────────────────────────────────────────╯\n * ```\n *\n * Complete:\n * ```\n * ╭─ warning ────────────────────────────────────────────────╮\n * │                                                          │\n * │  Title                                                   │\n * │                                                          │\n * │  Body                                                    │\n * │                                                          │\n * │  Next steps                                              │\n * │    • Run cd santorini-goods                              │\n * │    • To preview your project, run npm app dev            │\n * │    • To add extensions, run npm generate extension       │\n * │                                                          │\n * │  Reference                                               │\n * │    • Run npm shopify help                                │\n * │    • Press 'return' to open the dev docs:                │\n * │      https://shopify.dev                                 │\n * │                                                          │\n * │  Link: https://shopify.com                               │\n * │                                                          │\n * ╰──────────────────────────────────────────────────────────╯\n * ```\n */\nexport function renderWarning(options: RenderAlertOptions) {\n  alert({...options, type: 'warning'})\n}\n\n/**\n * Renders a Fatal error to the console inside a banner.\n *\n * ```\n * ╭─ error ──────────────────────────────────────────────────╮\n * │                                                          │\n * │  Couldn't connect to the Shopify Partner Dashboard.      │\n * │                                                          │\n * │  Check your internet connection and try again.           │\n * │                                                          │\n * ╰──────────────────────────────────────────────────────────╯\n * ```\n */\nexport function renderFatalError(error: Fatal) {\n  fatalError(error)\n}\n\n/**\n * Renders a generic error to the console inside a banner.\n *\n * ```\n * ╭─ error ──────────────────────────────────────────────────╮\n * │                                                          │\n * │  Something went wrong.                                   │\n * │                                                          │\n * │  Check your internet connection.                         │\n * │                                                          │\n * ╰──────────────────────────────────────────────────────────╯\n * ```\n */\nexport function renderError(options: ErrorProps) {\n  error(options)\n}\n"]}
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../../src/public/node/ui.tsx"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,sDAAsD,CAAA;AAEnF,OAAO,EAAC,MAAM,EAAC,MAAM,0BAA0B,CAAA;AAE/C,OAAO,EAAC,KAAK,EAAC,MAAM,gCAAgC,CAAA;AACpD,OAAO,EAAC,UAAU,EAAE,KAAK,EAAC,MAAM,gCAAgC,CAAA;AAGhE,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAA;AAQhD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAC,SAAS,EAAE,eAAe,EAAE,cAAc,GAAG,IAAI,EAA0B;IACjH,MAAM,EAAC,aAAa,EAAC,GAAG,MAAM,CAC5B,oBAAC,gBAAgB,IACf,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,IAAI,IAAI,eAAe,EAAE,EACzD,cAAc,EAAE,cAAc,GAC9B,CACH,CAAA;IAED,OAAO,aAAa,EAAE,CAAA;AACxB,CAAC;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,UAAU,CAAC,OAA2B;IACpD,KAAK,CAAC,EAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAC,CAAC,CAAA;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,aAAa,CAAC,OAA2B;IACvD,KAAK,CAAC,EAAC,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,EAAC,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,aAAa,CAAC,OAA2B;IACvD,KAAK,CAAC,EAAC,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,EAAC,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,UAAU,CAAC,KAAK,CAAC,CAAA;AACnB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAC,OAAmB;IAC7C,KAAK,CAAC,OAAO,CAAC,CAAA;AAChB,CAAC","sourcesContent":["import ConcurrentOutput from '../../private/node/ui/components/ConcurrentOutput.js'\nimport {OutputProcess} from '../../output.js'\nimport {render} from '../../private/node/ui.js'\nimport {Fatal} from '../../error.js'\nimport {alert} from '../../private/node/ui/alert.js'\nimport {fatalError, error} from '../../private/node/ui/error.js'\nimport {AlertProps} from '../../private/node/ui/components/Alert.js'\nimport {ErrorProps} from '../../private/node/ui/components/Error.js'\nimport React from 'react'\nimport {AbortController} from 'abort-controller'\n\ninterface RenderConcurrentOptions {\n  processes: OutputProcess[]\n  abortController?: AbortController\n  showTimestamps?: boolean\n}\n\n/**\n * Renders output from concurrent processes to the terminal with {@link ConcurrentOutput}.\n */\nexport async function renderConcurrent({processes, abortController, showTimestamps = true}: RenderConcurrentOptions) {\n  const {waitUntilExit} = render(\n    <ConcurrentOutput\n      processes={processes}\n      abortController={abortController ?? new AbortController()}\n      showTimestamps={showTimestamps}\n    />,\n  )\n\n  return waitUntilExit()\n}\n\ntype RenderAlertOptions = Omit<AlertProps, 'type'>\n\n/**\n * Renders an information banner to the console.\n *\n * Basic:\n *\n * ```\n * ╭─ info ───────────────────────────────────────────────────╮\n * │                                                          │\n * │  Body                                                    │\n * │                                                          │\n * ╰──────────────────────────────────────────────────────────╯\n * ```\n *\n * Complete:\n * ```\n * ╭─ info ───────────────────────────────────────────────────╮\n * │                                                          │\n * │  Title                                                   │\n * │                                                          │\n * │  Body                                                    │\n * │                                                          │\n * │  Next steps                                              │\n * │    • Run `cd santorini-goods`                            │\n * │    • To preview your project, run `npm app dev`          │\n * │    • To add extensions, run `npm generate extension`     │\n * │                                                          │\n * │  Reference                                               │\n * │    • Run `npm shopify help`                              │\n * │    • Press 'return' to open the dev docs:                │\n * │      https://shopify.dev                                 │\n * │                                                          │\n * │  Link: https://shopify.com                               │\n * │                                                          │\n * ╰──────────────────────────────────────────────────────────╯\n * ```\n */\nexport function renderInfo(options: RenderAlertOptions) {\n  alert({...options, type: 'info'})\n}\n\n/**\n * Renders a success banner to the console.\n *\n * Basic:\n *\n * ```\n * ╭─ success ────────────────────────────────────────────────╮\n * │                                                          │\n * │  Title                                                   │\n * │                                                          │\n * ╰──────────────────────────────────────────────────────────╯\n * ```\n *\n * Complete:\n * ```\n * ╭─ success ────────────────────────────────────────────────╮\n * │                                                          │\n * │  Title                                                   │\n * │                                                          │\n * │  Body                                                    │\n * │                                                          │\n * │  Next steps                                              │\n * │    • Run `cd santorini-goods`                              │\n * │    • To preview your project, run `npm app dev`            │\n * │    • To add extensions, run `npm generate extension`       │\n * │                                                          │\n * │  Reference                                               │\n * │    • Run `npm shopify help`                                │\n * │    • Press 'return' to open the dev docs:                │\n * │      https://shopify.dev                                 │\n * │                                                          │\n * │  Link: https://shopify.com                               │\n * │                                                          │\n * ╰──────────────────────────────────────────────────────────╯\n * ```\n */\nexport function renderSuccess(options: RenderAlertOptions) {\n  alert({...options, type: 'success'})\n}\n\n/**\n * Renders a warning banner to the console.\n *\n * Basic:\n *\n * ```\n * ╭─ warning ────────────────────────────────────────────────╮\n * │                                                          │\n * │  Title                                                   │\n * │                                                          │\n * ╰──────────────────────────────────────────────────────────╯\n * ```\n *\n * Complete:\n * ```\n * ╭─ warning ────────────────────────────────────────────────╮\n * │                                                          │\n * │  Title                                                   │\n * │                                                          │\n * │  Body                                                    │\n * │                                                          │\n * │  Next steps                                              │\n * │    • Run `cd santorini-goods`                            │\n * │    • To preview your project, run `npm app dev`          │\n * │    • To add extensions, run `npm generate extension`     │\n * │                                                          │\n * │  Reference                                               │\n * │    • Run `npm shopify help`                              │\n * │    • Press 'return' to open the dev docs:                │\n * │      https://shopify.dev                                 │\n * │                                                          │\n * │  Link: https://shopify.com                               │\n * │                                                          │\n * ╰──────────────────────────────────────────────────────────╯\n * ```\n */\nexport function renderWarning(options: RenderAlertOptions) {\n  alert({...options, type: 'warning'})\n}\n\n/**\n * Renders a Fatal error to the console inside a banner.\n *\n * ```\n * ╭─ error ──────────────────────────────────────────────────╮\n * │                                                          │\n * │  Couldn't connect to the Shopify Partner Dashboard.      │\n * │                                                          │\n * │  Check your internet connection and try again.           │\n * │                                                          │\n * ╰──────────────────────────────────────────────────────────╯\n * ```\n */\nexport function renderFatalError(error: Fatal) {\n  fatalError(error)\n}\n\n/**\n * Renders a generic error to the console inside a banner.\n *\n * ```\n * ╭─ error ──────────────────────────────────────────────────╮\n * │                                                          │\n * │  Something went wrong.                                   │\n * │                                                          │\n * │  Check your internet connection.                         │\n * │                                                          │\n * ╰──────────────────────────────────────────────────────────╯\n * ```\n */\nexport function renderError(options: ErrorProps) {\n  error(options)\n}\n"]}

package/dist/session/exchange.d.ts

@@ -1,6 +1,6 @@
 import { ApplicationToken, IdentityToken } from './schema.js';
 import { CodeAuthResult } from './authorize.js';
-import { Result } from '../common/result.js';
+import { Result } from '../public/common/result.js';
 export declare class InvalidGrantError extends Error {
 }
 export interface ExchangeScopes {

package/dist/session/exchange.js

@@ -3,7 +3,8 @@ import * as secureStore from './store.js';
 import { Abort } from '../error.js';
 import { identity as identityFqdn } from '../environment/fqdn.js';
 import { shopifyFetch } from '../http.js';
-import { err, ok } from '../common/result.js';
+import { err, ok } from '../public/common/result.js';
+import { AbortError } from '@shopify/cli-kit/node/error';
 export class InvalidGrantError extends Error {
 }
 const InvalidIdentityError = () => new Abort('\nError validating auth session', "We've cleared the current session, please try again");
@@ -124,9 +125,9 @@ async function tokenRequestErrorHandler(error) {
         // There's an scenario when Identity returns "invalid_request" when exchanging an identity token.
         // This means the token is invalid. We clear the session and throw an error to let the caller know.
         await secureStore.remove();
-        return InvalidIdentityError();
+        return new AbortError('\nError validating auth session', "We've cleared the current session, please try again");
     }
-    return new Abort(error);
+    return new AbortError(error);
 }
 async function tokenRequest(params) {
     const fqdn = await identityFqdn();