shopify-cli 0.9.0

data/lib/docgen/index_template.md.erb

@@ -0,0 +1,5 @@
+The Shopify App CLI has a set of core APIs that simplify the process of extending its functionality.
+
+<%- classes.each do |method| -%>
+- [<%= method.title %>](https://github.com/Shopify/shopify-app-cli/wiki/<%= method.filename %>)
+<%- end -%>

data/lib/docgen/markdown.rb

@@ -0,0 +1,101 @@
+require 'rdoc/rdoc'
+require 'erb'
+
+module RDoc
+  module Generator
+    class Markdown
+      ::RDoc::RDoc.add_generator(self)
+
+      DocClass = Struct.new(
+        :title, :kind, :comment, :class_methods, :instance_methods, :attributes,
+        :constants, :extended, :included, :filename,
+        keyword_init: true,
+      )
+      ClassMember = Struct.new(:title, :comment, :signature, :source_code, keyword_init: true)
+
+      def initialize(store, options)
+        @options = options
+        @store = store
+        @converter = ::RDoc::Markup::ToMarkdown.new
+      end
+
+      def generate
+        render(build_classes)
+      end
+
+      private
+
+      def render(data)
+        class_template_path = File.join(File.dirname(__FILE__), 'class_template.md.erb')
+        class_renderer = ERB.new(File.read(class_template_path), nil, '-')
+        data.each do |cls|
+          File.write("#{cls.filename}.md", class_renderer.result(cls.instance_eval { binding }))
+        end
+        index_template_path = File.join(File.dirname(__FILE__), 'index_template.md.erb')
+        index_renderer = ERB.new(File.read(index_template_path), nil, '-')
+        File.write("Core-APIs.md", index_renderer.result(OpenStruct.new(classes: data).instance_eval { binding }))
+      end
+
+      def build_classes
+        classes = @store.all_classes_and_modules.map do |klass|
+          is_class = @store.all_modules.find { |m| m.full_name == klass.full_name }.nil?
+          kind = is_class ? :class : :module
+          DocClass.new(
+            filename: "#{kind}-#{klass.full_name}",
+            title: klass.full_name,
+            kind: kind,
+            comment: @converter.convert(klass.comment.parse),
+            constants: build_members(klass.constants),
+            class_methods: build_members(klass.method_list.select { |m| m.type == 'class' }),
+            instance_methods: build_members(klass.method_list.select { |m| m.type == 'instance' }),
+            attributes: build_members(klass.attributes),
+            extended: build_members(klass.extends),
+            included: build_members(klass.includes),
+          )
+        end
+
+        # Remove nondescript items
+        classes.reject do |klass|
+          klass.comment.empty? && klass.constants.empty? &&
+            klass.class_methods.empty? && klass.instance_methods.empty? &&
+            klass.attributes.empty? && klass.extended.empty? &&
+            klass.included.empty?
+        end
+      end
+
+      def build_members(member_list)
+        member_list.map do |m|
+          ClassMember.new(
+            title:     m.name,
+            comment:   @converter.convert(m.comment.parse),
+            signature: m.respond_to?(:arglists) ? m.arglists : '',
+            source_code: source(m),
+          )
+        end
+      end
+
+      # Just extracts sourcecode from html formatting/highlighting into a text
+      # blob so that markdown can format it with a codeblock
+      def source(m)
+        return '' unless m.respond_to?(:token_stream)
+        # each line, get the text
+        src = (m.token_stream || []).map do |t|
+          next unless t
+          CGI.escapeHTML(t[:text])
+        end.join
+        # dedent the source
+        indent = src.length
+        lines = src.lines.to_a
+        lines.shift if src =~ /\A.*#\ *File/i # remove '# File' comment
+        lines.each do |line|
+          next unless line =~ /^ *(?=\S)/
+          n = $&.length
+          indent = n if n < indent
+          break if n == 0
+        end
+        src.gsub!(/^#{' ' * indent}/, '') if indent > 0
+        src
+      end
+    end
+  end
+end

data/lib/graphql/admin_introspection.graphql

@@ -0,0 +1,87 @@
+query IntrospectionQuery {
+  __schema {
+    queryType { name }
+    mutationType { name }
+    types {
+      ...FullType
+    }
+    directives {
+      name
+      description
+      locations
+      args {
+        ...InputValue
+      }
+    }
+  }
+}
+fragment FullType on __Type {
+  kind
+  name
+  description
+  fields(includeDeprecated: true) {
+    name
+    description
+    args {
+      ...InputValue
+    }
+    type {
+      ...TypeRef
+    }
+    isDeprecated
+    deprecationReason
+  }
+  inputFields {
+    ...InputValue
+  }
+  interfaces {
+    ...TypeRef
+  }
+  enumValues(includeDeprecated: true) {
+    name
+    description
+    isDeprecated
+    deprecationReason
+  }
+  possibleTypes {
+    ...TypeRef
+  }
+}
+fragment InputValue on __InputValue {
+  name
+  description
+  type { ...TypeRef }
+  defaultValue
+}
+fragment TypeRef on __Type {
+  kind
+  name
+  ofType {
+    kind
+    name
+    ofType {
+      kind
+      name
+      ofType {
+        kind
+        name
+        ofType {
+          kind
+          name
+          ofType {
+            kind
+            name
+            ofType {
+              kind
+              name
+              ofType {
+                kind
+                name
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

data/lib/graphql/all_organizations.graphql

@@ -0,0 +1,19 @@
+query AllOrgs{
+  organizations {
+    nodes {
+      id
+      businessName
+      website
+      stores(first: 500) {
+        nodes {
+          shopId
+          link
+          shopDomain
+          shopName
+          transferDisabled
+          convertableToPartnerTest
+        }
+      }
+    }
+  }
+}

data/lib/graphql/all_orgs_with_apps.graphql

@@ -0,0 +1,30 @@
+query AllOrgs{
+  organizations {
+    nodes {
+      id
+      businessName
+      website
+      stores(first: 500) {
+        nodes {
+          shopId
+          link
+          shopDomain
+          shopName
+          transferDisabled
+          convertableToPartnerTest
+        }
+      }
+      apps(first: 500) {
+        nodes {
+          id
+          title
+          apiKey
+          apiSecretKeys{
+            secret
+          }
+          appType
+        }
+      }
+    }
+  }
+}

data/lib/graphql/api_versions.graphql

@@ -0,0 +1,6 @@
+query {
+  publicApiVersions {
+    handle
+    displayName
+  }
+}

data/lib/graphql/convert_dev_to_test_store.graphql

@@ -0,0 +1,10 @@
+mutation convertDevToTestStore($input: ConvertDevToTestStoreInput!) {
+  convertDevToTestStore(input: $input) {
+    convertedToTestStore
+    userErrors {
+      message
+      field
+    }
+  }
+}
+

data/lib/graphql/create_app.graphql

@@ -0,0 +1,20 @@
+mutation AppCreate($org: Int!, $title: String!, $app_url: Url!, $redir: [Url]!, $type: AppType) {
+  appCreate(input: {organizationID: $org, title: $title, applicationUrl: $app_url, redirectUrlWhitelist: $redir, appType: $type}) {
+    app {
+      id
+      apiKey
+      title
+      applicationUrl
+      redirectUrlWhitelist
+      apiSecretKeys {
+        secret
+        createdAt
+      }
+      appType
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}

data/lib/graphql/create_customer.graphql

@@ -0,0 +1,9 @@
+mutation createCustomer($input: CustomerInput!){
+  customerCreate(input: $input) {
+    customer {
+      id
+      displayName
+    }
+  }
+}
+

data/lib/graphql/create_draft_order.graphql

@@ -0,0 +1,8 @@
+mutation createDrafOrder($input: DraftOrderInput!){
+  draftOrderCreate(input: $input) {
+    draftOrder {
+      id
+    }
+  }
+}
+

data/lib/graphql/create_product.graphql

@@ -0,0 +1,9 @@
+mutation createProduct($input: ProductInput!){
+  productCreate(input: $input) {
+    product {
+      id
+      title
+    }
+  }
+}
+

data/lib/graphql/extension_create.graphql

@@ -0,0 +1,21 @@
+mutation ExtensionCreate($api_key: String!, $type: ExtensionType!, $title: String!, $config: JSON!, $extension_context: String) {
+  extensionCreate(input: {apiKey: $api_key, type: $type, title: $title, config: $config, context: $extension_context}) {
+    extensionRegistration {
+      id
+      type
+      title
+      draftVersion {
+        registrationId
+        lastUserInteractionAt
+        validationErrors {
+          field
+          message
+        }
+      }
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}

data/lib/graphql/extension_update_draft.graphql

@@ -0,0 +1,18 @@
+mutation ExtensionUpdateDraft($api_key: String!, $registration_id: ID!, $config: JSON!, $context: String) {
+  extensionUpdateDraft(input: {apiKey: $api_key, registrationId: $registration_id, config: $config, context: $context}) {
+    extensionVersion {
+      registrationId
+      context
+      lastUserInteractionAt
+      location
+      validationErrors {
+        field
+        message
+      }
+    }
+    userErrors {
+      field
+      message
+    }
+  }
+}

data/lib/graphql/find_organization.graphql

@@ -0,0 +1,17 @@
+query FindOrg($id: ID!) {
+  organizations(id: $id) {
+    nodes {
+      id
+      businessName
+      website
+      stores(first: 500) {
+        nodes {
+          link
+          shopDomain
+          shopName
+        }
+      }
+    }
+  }
+}
+

data/lib/graphql/get_app_urls.graphql

@@ -0,0 +1,6 @@
+query getApp($apiKey: String!) {
+  app(apiKey: $apiKey) {
+    applicationUrl
+    redirectUrlWhitelist
+  }
+}

data/lib/graphql/update_dashboard_urls.graphql

@@ -0,0 +1,8 @@
+mutation appUpdate($input: AppUpdateInput!) {
+  appUpdate(input: $input) {
+    userErrors {
+      message
+      field
+    }
+  }
+}

data/lib/project_types/extension/cli.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Extension
+  class Project < ShopifyCli::ProjectType
+    hidden_project_type
+    creator 'App Extension', 'Extension::Commands::Create'
+
+    register_command('Extension::Commands::Build', "build")
+    register_command('Extension::Commands::Register', "register")
+    register_command('Extension::Commands::Push', "push")
+    register_command('Extension::Commands::Serve', "serve")
+    register_command('Extension::Commands::Tunnel', "tunnel")
+
+    require Project.project_filepath('messages/messages')
+    require Project.project_filepath('messages/message_loading')
+    require Project.project_filepath('extension_project_keys')
+    register_messages(Extension::Messages::MessageLoading.load)
+  end
+
+  module Commands
+    autoload :ExtensionCommand, Project.project_filepath('commands/extension_command')
+    autoload :Create, Project.project_filepath('commands/create')
+    autoload :Register, Project.project_filepath('commands/register')
+    autoload :Build, Project.project_filepath('commands/build')
+    autoload :Serve, Project.project_filepath('commands/serve')
+    autoload :Push, Project.project_filepath('commands/push')
+    autoload :Tunnel, Project.project_filepath('commands/tunnel')
+  end
+
+  module Tasks
+    autoload :UserErrors, Project.project_filepath('tasks/user_errors')
+    autoload :GetApps, Project.project_filepath('tasks/get_apps')
+    autoload :CreateExtension, Project.project_filepath('tasks/create_extension')
+    autoload :UpdateDraft, Project.project_filepath('tasks/update_draft')
+
+    module Converters
+      autoload :RegistrationConverter, Project.project_filepath('tasks/converters/registration_converter')
+      autoload :VersionConverter, Project.project_filepath('tasks/converters/version_converter')
+      autoload :ValidationErrorConverter, Project.project_filepath('tasks/converters/validation_error_converter')
+    end
+  end
+
+  module Forms
+    autoload :Create, Project.project_filepath('forms/create')
+    autoload :Register, Project.project_filepath('forms/register')
+  end
+
+  module Features
+    autoload :Argo, Project.project_filepath('features/argo')
+    autoload :ArgoSetup, Project.project_filepath('features/argo_setup')
+    autoload :ArgoSetupStep, Project.project_filepath('features/argo_setup_step')
+    autoload :ArgoSetupSteps, Project.project_filepath('features/argo_setup_steps')
+    autoload :ArgoDependencies, Project.project_filepath('features/argo_dependencies')
+    autoload :TunnelUrl, Project.project_filepath('features/tunnel_url')
+  end
+
+  module Models
+    autoload :App, Project.project_filepath('models/app')
+    autoload :Registration, Project.project_filepath('models/registration')
+    autoload :Version, Project.project_filepath('models/version')
+    autoload :Type, Project.project_filepath('models/type')
+    autoload :ValidationError, Project.project_filepath('models/validation_error')
+
+    class << self
+      Models::Type.load_all
+    end
+  end
+
+  autoload :ExtensionProjectKeys, Project.project_filepath('extension_project_keys')
+  autoload :ExtensionProject, Project.project_filepath('extension_project')
+end