shopify-cli 0.9.0

data/lib/project_types/node/commands/populate/customer.rb

@@ -0,0 +1,31 @@
+require 'shopify_cli'
+
+module Node
+  module Commands
+    class Populate
+      class Customer < ShopifyCli::AdminAPI::PopulateResourceCommand
+        @input_type = :CustomerInput
+
+        def defaults
+          first_name, last_name = ShopifyCli::Helpers::Haikunator.name
+          {
+            firstName: first_name,
+            lastName: last_name,
+          }
+        end
+
+        def message(data)
+          ret = data['customerCreate']['customer']
+          id = ShopifyCli::API.gid_to_id(ret['id'])
+          @ctx.message(
+            'node.populate.customer.added',
+            ret['displayName'],
+            ShopifyCli::Project.current.env.shop,
+            admin_url,
+            id
+          )
+        end
+      end
+    end
+  end
+end

data/lib/project_types/node/commands/populate/draft_order.rb

@@ -0,0 +1,28 @@
+require 'shopify_cli'
+
+module Node
+  module Commands
+    class Populate
+      class DraftOrder < ShopifyCli::AdminAPI::PopulateResourceCommand
+        @input_type = :DraftOrderInput
+
+        def defaults
+          {
+            lineItems: [{
+              originalUnitPrice: price,
+              quantity: 1,
+              weight: { value: 10, unit: 'GRAMS' },
+              title: ShopifyCli::Helpers::Haikunator.title,
+            }],
+          }
+        end
+
+        def message(data)
+          ret = data['draftOrderCreate']['draftOrder']
+          id = ShopifyCli::API.gid_to_id(ret['id'])
+          @ctx.message('node.populate.draft_order.added', ShopifyCli::Project.current.env.shop, admin_url, id)
+        end
+      end
+    end
+  end
+end

data/lib/project_types/node/commands/populate/product.rb

@@ -0,0 +1,30 @@
+require 'shopify_cli'
+
+module Node
+  module Commands
+    class Populate
+      class Product < ShopifyCli::AdminAPI::PopulateResourceCommand
+        @input_type = :ProductInput
+
+        def defaults
+          {
+            title: ShopifyCli::Helpers::Haikunator.title,
+            variants: [{ price: price }],
+          }
+        end
+
+        def message(data)
+          ret = data['productCreate']['product']
+          id = ShopifyCli::API.gid_to_id(ret['id'])
+          @ctx.message(
+            'node.populate.product.added',
+            ret['title'],
+            ShopifyCli::Project.current.env.shop,
+            admin_url,
+            id
+          )
+        end
+      end
+    end
+  end
+end

data/lib/project_types/node/commands/serve.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+module Node
+  module Commands
+    class Serve < ShopifyCli::Command
+      prerequisite_task :ensure_env, :ensure_dev_store
+
+      options do |parser, flags|
+        parser.on('--host=HOST') do |h|
+          flags[:host] = h.gsub('"', '')
+        end
+      end
+
+      def call(*)
+        project = ShopifyCli::Project.current
+        url = options.flags[:host] || ShopifyCli::Tunnel.start(@ctx)
+        @ctx.abort(@ctx.message('node.serve.error.host_must_be_https')) if url.match(/^https/i).nil?
+        project.env.update(@ctx, :host, url)
+        ShopifyCli::Tasks::UpdateDashboardURLS.call(
+          @ctx,
+          url: url,
+          callback_url: "/auth/callback",
+        )
+        if @ctx.mac? && project.env.shop
+          @ctx.puts(@ctx.message('node.serve.open_info', project.env.shop))
+          @ctx.on_siginfo do
+            @ctx.open_url!("#{project.env.host}/auth?shop=#{project.env.shop}")
+          end
+        end
+        CLI::UI::Frame.open(@ctx.message('node.serve.running_server')) do
+          env = project.env.to_h
+          env['PORT'] = ShopifyCli::Tunnel::PORT.to_s
+          @ctx.system('npm run dev', env: env)
+        end
+      end
+
+      def self.help
+        ShopifyCli::Context.message('node.serve.help', ShopifyCli::TOOL_NAME)
+      end
+
+      def self.extended_help
+        ShopifyCli::Context.message('node.serve.extended_help')
+      end
+    end
+  end
+end

data/lib/project_types/node/commands/tunnel.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'shopify_cli'
+
+module Node
+  module Commands
+    class Tunnel < ShopifyCli::Command
+      # subcommands :auth, :start, :stop
+
+      def call(args, _name)
+        subcommand = args.shift
+        case subcommand
+        when 'auth'
+          token = args.shift
+          if token.nil?
+            @ctx.puts(@ctx.message('node.tunnel.error.token_argument_missing'))
+            @ctx.puts("#{self.class.help}\n#{self.class.extended_help}")
+          else
+            ShopifyCli::Tunnel.auth(@ctx, token)
+          end
+        when 'start'
+          ShopifyCli::Tunnel.start(@ctx)
+        when 'stop'
+          ShopifyCli::Tunnel.stop(@ctx)
+        else
+          @ctx.puts(self.class.help)
+        end
+      end
+
+      def self.help
+        ShopifyCli::Context.message('node.tunnel.help', ShopifyCli::TOOL_NAME)
+      end
+
+      def self.extended_help
+        ShopifyCli::Context.message('node.tunnel.extended_help', ShopifyCli::TOOL_NAME)
+      end
+    end
+  end
+end

data/lib/project_types/node/forms/create.rb

@@ -0,0 +1,87 @@
+require 'uri'
+
+module Node
+  module Forms
+    class Create < ShopifyCli::Form
+      attr_accessor :name
+      flag_arguments :title, :organization_id, :shop_domain, :type
+
+      def ask
+        self.title ||= CLI::UI::Prompt.ask(ctx.message('node.forms.create.app_name'))
+        self.type = ask_type
+        self.name = self.title.downcase.split(" ").join("_")
+        self.organization_id ||= organization["id"].to_i
+        self.shop_domain ||= ask_shop_domain
+      end
+
+      private
+
+      def ask_type
+        if type.nil?
+          return CLI::UI::Prompt.ask(ctx.message('node.forms.create.app_type.select')) do |handler|
+            handler.option(ctx.message('node.forms.create.app_type.select_public')) { 'public' }
+            handler.option(ctx.message('node.forms.create.app_type.select_custom')) { 'custom' }
+          end
+        end
+
+        unless ShopifyCli::Tasks::CreateApiClient::VALID_APP_TYPES.include?(type)
+          ctx.abort(ctx.message('node.forms.create.error.invalid_app_type', type))
+        end
+        ctx.puts(ctx.message('node.forms.create.app_type.selected', type))
+        type
+      end
+
+      def organizations
+        @organizations ||= ShopifyCli::PartnersAPI::Organizations.fetch_all(ctx)
+      end
+
+      def organization
+        @organization ||= if !organization_id.nil?
+          org = ShopifyCli::PartnersAPI::Organizations.fetch(ctx, id: organization_id)
+          if org.nil?
+            ctx.puts(ctx.message('node.forms.create.authentication_issue', ShopifyCli::TOOL_NAME))
+            ctx.abort(ctx.message('node.forms.create.error.organization_not_found'))
+          end
+          org
+        elsif organizations.count == 0
+          ctx.puts(ctx.message('node.forms.create.partners_notice'))
+          ctx.puts(ctx.message('node.forms.create.authentication_issue', ShopifyCli::TOOL_NAME))
+          ctx.abort(ctx.message('node.forms.create.error.no_organizations'))
+        elsif organizations.count == 1
+          org = organizations.first
+          ctx.puts(ctx.message('node.forms.create.organization',
+            ctx.message('core.partners_api.org_name_and_id', org['businessName'], org['id'])))
+          org
+        else
+          org_id = CLI::UI::Prompt.ask(ctx.message('node.forms.create.organization_select')) do |handler|
+            organizations.each do |o|
+              handler.option(ctx.message('core.partners_api.org_name_and_id', o['businessName'], o['id'])) { o['id'] }
+            end
+          end
+          organizations.find { |o| o['id'] == org_id }
+        end
+      end
+
+      def ask_shop_domain
+        valid_stores = organization['stores'].select do |store|
+          store['transferDisabled'] == true || store['convertableToPartnerTest'] == true
+        end
+
+        if valid_stores.count == 0
+          ctx.puts(ctx.message('node.forms.create.no_development_stores'))
+          ctx.puts(ctx.message('node.forms.create.create_store', organization['id']))
+          ctx.puts(ctx.message('node.forms.create.authentication_issue', ShopifyCli::TOOL_NAME))
+        elsif valid_stores.count == 1
+          domain = valid_stores.first['shopDomain']
+          ctx.puts(ctx.message('node.forms.create.development_store', domain))
+          domain
+        else
+          CLI::UI::Prompt.ask(
+            ctx.message('node.forms.create.development_store_select'),
+            options: valid_stores.map { |s| s['shopDomain'] }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/project_types/node/messages/messages.rb

@@ -0,0 +1,260 @@
+# frozen_string_literal: true
+
+module Node
+  module Messages
+    MESSAGES = {
+      node: {
+        error: {
+          generic: "Error",
+        },
+
+        create: {
+          help: <<~HELP,
+          {{command:%s create node}}: Creates an embedded nodejs app.
+            Usage: {{command:%s create node}}
+            Options:
+              {{command:--name=NAME}} App name. Any string.
+              {{command:--app_url=APPURL}} App URL. Must be a valid URL.
+              {{command:--organization_id=ID}} Partner organization ID. Must be an existing organization.
+              {{command:--shop_domain=MYSHOPIFYDOMAIN }} Development store URL. Must be an existing development store.
+          HELP
+          error: {
+            node_required: "node is required to create an app project. Download at https://nodejs.org/en/download.",
+            node_version_failure: "Failed to get the current node version. Please make sure it is installed as " \
+              "per the instructions at https://nodejs.org/en.",
+            npm_required: "npm is required to create an app project. Download at https://www.npmjs.com/get-npm.",
+            npm_version_failure: "Failed to get the current npm version. Please make sure it is installed as per " \
+              "the instructions at https://www.npmjs.com/get-npm.",
+          },
+          info: {
+            created: "{{v}} {{green:%s}} was created in your Partner Dashboard {{underline:%s}}",
+            serve: "{{*}} Change into your new project folder {{green:%s}} and run {{command:%s serve}} to start a " \
+              "local server",
+            install: "{{*}} Then, visit {{underline:%s/test}} to install {{green:%s}} on your Dev Store",
+          },
+          node_version: "node %s",
+          npm_version: "npm %s",
+        },
+
+        deploy: {
+          help: <<~HELP,
+          Deploy the current Node project to a hosting service. Heroku ({{underline:https://www.heroku.com}}) is currently the only option, but more will be added in the future.
+            Usage: {{command:%s deploy [ heroku ]}}
+          HELP
+          extended_help: <<~HELP,
+          {{bold:Subcommands:}}
+            {{cyan:heroku}}: Deploys the current Node project to Heroku.
+              Usage: {{command:%s deploy heroku}}
+          HELP
+          heroku: {
+            help: <<~HELP,
+            Deploy the current Node project to Heroku
+              Usage: {{command:%s deploy heroku}}
+            HELP
+            downloading: "Downloading Heroku CLI…",
+            downloaded: "Downloaded Heroku CLI",
+            installing: "Installing Heroku CLI…",
+            installed: "Installed Heroku CLI",
+            authenticating: "Authenticating with Heroku…",
+            authenticated: "{{v}} Authenticated with Heroku",
+            authenticated_with_account: "{{v}} Authenticated with Heroku as `%s`",
+            deploying: "Deploying to Heroku…",
+            deployed: "{{v}} Deployed to Heroku",
+            git: {
+              checking: "Checking git repo…",
+              initialized: "Git repo initialized",
+              what_branch: "What branch would you like to deploy?",
+              branch_selected: "{{v}} Git branch `%s` selected for deploy",
+            },
+            app: {
+              no_apps_found: "No existing Heroku app found. What would you like to do?",
+              name: "What is your Heroku app’s name?",
+              select: "Specify an existing Heroku app",
+              selecting: "Selecting Heroku app `%s`…",
+              selected: "{{v}} Heroku app `%s` selected",
+              create: "Create a new Heroku app",
+              creating: "Creating new Heroku app…",
+              created: "{{v}} New Heroku app created",
+            },
+          },
+        },
+
+        generate: {
+          help: <<~HELP,
+          Generate code in your Node project. Supports generating new billing API calls, new pages, or new webhooks.
+            Usage: {{command:%s generate [ billing | page | webhook ]}}
+          HELP
+          extended_help: <<~EXAMPLES,
+          {{bold:Examples:}}
+            {{cyan:%s generate webhook PRODUCTS_CREATE}}
+              Generate and register a new webhook that will be called every time a new product is created on your store.
+          EXAMPLES
+
+          error: {
+            name_exists: "%s already exists!",
+            generic: "Error generating %s",
+          },
+
+          billing: {
+            help: <<~HELP,
+            Enable charging for your app. This command generates the necessary code to call Shopify’s billing API.
+              Usage: {{command:%s generate billing [ one-time-billing | recurring-billing ]}}
+            HELP
+            type_select: "How would you like to charge for your app?",
+            generating: "Generating %s code ...",
+            generated: "{{green:%s}} generated in server/server.js",
+          },
+
+          page: {
+            help: <<~HELP,
+            Generate a new page in your app with the specified name. New files are generated inside the project’s “/pages” directory.
+              Usage: {{command:%s generate page <pagename>}}
+            HELP
+            error: {
+              invalid_page_type: "Invalid page type.",
+            },
+            type_select: "Which template would you like to use?",
+            generating: "Generating %s page...",
+            generated: "{{green: %s}} generated in pages/%s",
+          },
+
+          webhook: {
+            help: <<~HELP,
+            Generate and register a new webhook that listens for the specified Shopify store event.
+              Usage: {{command:%s generate webhook <type>}}
+            HELP
+            type_select: "What type of webhook would you like to create?",
+            generating: "Generating webhook: %s",
+            generated: "{{green:%s}} generated in server/server.js",
+          },
+        },
+
+        open: {
+          help: <<~HELP,
+          Open your local development app in the default browser.
+            Usage: {{command:%s open}}
+          HELP
+        },
+
+        populate: {
+          help: <<~HELP,
+          Populate your Shopify development store with example customers, orders, or products.
+            Usage: {{command:%s populate [ customers | draftorders | products ]}}
+          HELP
+          extended_help: <<~HELP,
+          {{bold:Subcommands:}}
+
+            {{cyan:customers [options]}}: Add dummy customers to the specified development store.
+              Usage: {{command:%1$s populate customers}}
+
+            {{cyan:draftorders [options]}}: Add dummy orders to the specified development store.
+              Usage: {{command:%1$s populate draftorders}}
+
+            {{cyan:products [options]}}: Add dummy products to the specified development store.
+              Usage: {{command:%1$s populate products}}
+
+          {{bold:Options:}}
+
+            {{cyan:--count [integer]}}: The number of dummy items to populate. Defaults to 5.
+            {{cyan:--silent}}: Silence the populate output.
+            {{cyan:--help}}: Display more options specific to each subcommand.
+
+          {{bold:Examples:}}
+
+            {{command:%1$s populate products}}
+              Populate your development store with 5 additional products.
+
+            {{command:%1$s populate customers --count 30}}
+              Populate your development store with 30 additional customers.
+
+            {{command:%1$s populate draftorders}}
+              Populate your development store with 5 additional orders.
+
+            {{command:%1$s populate products --help}}
+              Display the list of options available to customize the {{command:%1$s populate products}} command.
+          HELP
+
+          customer: {
+            added: "%s added to {{green:%s}} at {{underline:%scustomers/%d}}",
+          },
+
+          draft_order: {
+            added: "DraftOrder added to {{green:%s}} at {{underline:%sdraft_orders/%d}}",
+          },
+
+          product: {
+            added: "%s added to {{green:%s}} at {{underline:%sproducts/%d}}",
+          },
+        },
+
+        serve: {
+          help: <<~HELP,
+          Start a local development node server for your project, as well as a public ngrok tunnel to your localhost.
+            Usage: {{command:%s serve}}
+          HELP
+          extended_help: <<~HELP,
+          {{bold:Options:}}
+            {{cyan:--host=HOST}}: Bypass running tunnel and use custom host. HOST must be HTTPS url.
+          HELP
+
+          error: {
+            host_must_be_https: "HOST must be a HTTPS url.",
+          },
+
+          open_info: "{{*}} Press {{yellow: Control-T}} to open this project in {{green:%s}} ",
+          running_server: "Running server...",
+        },
+
+        tunnel: {
+          help: <<~HELP,
+          Start or stop an http tunnel to your local development app using ngrok.
+            Usage: {{command:%s tunnel [ auth | start | stop ]}}
+          HELP
+          extended_help: <<~HELP,
+          {{bold:Subcommands:}}
+
+            {{cyan:auth}}: Writes an ngrok auth token to ~/.ngrok2/ngrok.yml to connect with an ngrok account. Visit https://dashboard.ngrok.com/signup to sign up.
+              Usage: {{command:%1$s tunnel auth <token>}}
+
+            {{cyan:start}}: Starts an ngrok tunnel, will print the URL for an existing tunnel if already running.
+              Usage: {{command:%1$s tunnel start}}
+
+            {{cyan:stop}}: Stops the ngrok tunnel.
+              Usage: {{command:%1$s tunnel stop}}
+
+          HELP
+
+          error: {
+            token_argument_missing: "{{x}} {{red:auth requires a token argument}}\n\n",
+          },
+        },
+
+        forms: {
+          create: {
+            error: {
+              invalid_app_type: "Invalid app type %s",
+              organization_not_found: "Cannot find a partner organization with that ID",
+              no_organizations: "No partner organizations available.",
+            },
+
+            authentication_issue: "For authentication issues, run {{command:%s logout}} to clear invalid credentials",
+            partners_notice: "Please visit https://partners.shopify.com/ to create a partners account",
+            no_development_stores: "{{x}} No Development Stores available.",
+            create_store: "Visit {{underline:https://partners.shopify.com/%s/stores}} to create one",
+            app_name: "App Name",
+            app_type: {
+              select: "What type of app are you building?",
+              select_public: "Public: An app built for a wide merchant audience.",
+              select_custom: "Custom: An app custom built for a single client.",
+              selected: "App type {{green:%s}}",
+            },
+            organization_select: "Select partner organization",
+            organization: "Partner organization {{green:%s}}",
+            development_store_select: "Select a development store",
+            development_store: "Using development store {{green:%s}}",
+          },
+        },
+      },
+    }.freeze
+  end
+end