Merge pull request #68 from zendesk/likun/commonjs_support

APPS-1524 As an App developer I expect CommonJS Support in Apps

Author: Travers McInerney

lib/zendesk_apps_support/assets/src.js.erb

@@ -1,26 +1,36 @@
 (function() {
-    with( require('apps/framework/app_scope') ) {
+  with( ZendeskApps.AppScope.create() ) {
+    <% unless modules.nil? %>
+    require.modules = {
+      <% modules.each do |path, content| %>
+        '<%= path %>': function(exports, require, module) {
+          <%= content %>
+        },
+      <% end %>
+      eom: undefined
+    };
+    <% end %>
 
-        var source = <%= source %>;
+    var source = <%= source %>;
 
-        ZendeskApps[<%= name.to_json %>] = ZendeskApps.defineApp(source)
-                .reopenClass({ location: <%= location.to_json %> })
-                .reopen({
-                    assetUrlPrefix: <%= asset_url_prefix.to_json %>,
-                    appClassName: <%= app_class_name.to_json %>,
-                    author: {
-                        name: <%= author[:name].to_json %>,
-                        email: <%= author[:email].to_json %>
-                    },
-                    translations: <%= translations.to_json %>,
-                    templates: <%= templates.to_json %>,
-                    frameworkVersion: <%= framework_version.to_json %>
-                });
+    var app = ZendeskApps.defineApp(source)
+      .reopenClass({ location: <%= location.to_json %> })
+      .reopen({
+        assetUrlPrefix: <%= asset_url_prefix.to_json %>,
+        appClassName: <%= app_class_name.to_json %>,
+        author: {
+          name: <%= author[:name].to_json %>,
+          email: <%= author[:email].to_json %>
+        },
+        translations: <%= translations.to_json %>,
+        templates: <%= templates.to_json %>,
+        frameworkVersion: <%= framework_version.to_json %>,
+      });
 
-    }
-
-    ZendeskApps[<%= name.to_json %>].install({"id": <%= app_id %>, "app_id": <%= app_id %>, "settings": <%= settings.to_json %>});
+    ZendeskApps[<%= name.to_json %>] = app;
+  }
 
+  ZendeskApps[<%= name.to_json %>].install({"id": <%= app_id %>, "app_id": <%= app_id %>, "settings": <%= settings.to_json %>});
 }());
 
 ZendeskApps.trigger && ZendeskApps.trigger('ready');

lib/zendesk_apps_support/package.rb

@@ -10,11 +10,12 @@ class Package
     DEFAULT_SCSS   = File.read(File.expand_path('../assets/default_styles.scss', __FILE__))
     SRC_TEMPLATE   = Erubis::Eruby.new( File.read(File.expand_path('../assets/src.js.erb', __FILE__)) )
 
-    attr_reader :root, :warnings
+    attr_reader :lib_root, :root, :warnings
     attr_accessor :requirements_only
 
     def initialize(dir)
       @root = Pathname.new(File.expand_path(dir))
+      @lib_root = Pathname.new(File.join(@root, 'lib'))
       @warnings = []
       @requirements_only = false
     end
@@ -46,10 +47,28 @@ def validate
       end
     end
 
+    def app_js
+      read_file("app.js")
+    end
+
+    def commonjs_modules
+      return unless has_lib_js?
+
+      lib_files.each_with_object({}) do |file, modules|
+        name          = file.relative_path.gsub!(/^lib\//, '')
+        content       = file.read
+        modules[name] = content
+      end
+    end
+
     def files
       non_tmp_files
     end
 
+    def lib_files
+      @lib_files ||= files.select { |f| f =~ /^lib\/.*\.js$/ }
+    end
+
     def template_files
       files.select { |f| f =~ /^templates\/.*\.hdbs$/ }
     end
@@ -76,7 +95,7 @@ def app_translations
 
     def readified_js(app_name, app_id, asset_url_prefix, settings={})
       manifest = manifest_json
-      source = read_file("app.js")
+      source = app_js
       name = app_name || manifest[:name] || 'Local App'
       location = manifest[:location]
       app_class_name = "app-#{app_id}"
@@ -97,7 +116,8 @@ def readified_js(app_name, app_id, asset_url_prefix, settings={})
           :framework_version => framework_version,
           :templates => templates,
           :settings => settings,
-          :app_id => app_id
+          :app_id => app_id,
+          :modules => commonjs_modules
       )
     end
 
@@ -110,6 +130,10 @@ def has_js?
       file_exists?("app.js")
     end
 
+    def has_lib_js?
+      lib_files.any?
+    end
+
     def has_manifest?
       file_exists?("manifest.json")
     end

lib/zendesk_apps_support/validations/source.rb

@@ -15,29 +15,38 @@ module Source
 
         # predefined globals:
         :predef => %w(_ console services helpers alert window document self
-                      JSON Base64 clearInterval clearTimeout setInterval setTimeout)
+                      JSON Base64 clearInterval clearTimeout setInterval setTimeout
+                      require module exports top frames parent)
       }.freeze
 
       class <<self
         def call(package)
-          source = package.files.find { |f| f.relative_path == 'app.js' }
+          app   = package.files.find { |file| file.relative_path == 'app.js' }
+          files = package.lib_files << app
 
           if package.requirements_only
-            return source ? [ ValidationError.new(:no_app_js_required) ] : []
+            return app ? [ ValidationError.new(:no_app_js_required) ] : []
           end
 
-          return [ ValidationError.new(:missing_source) ] unless source
+          return [ ValidationError.new(:missing_source) ] unless app
 
-          jshint_errors = linter.lint(source.read)
-          if jshint_errors.any?
-            [ JSHintValidationError.new(source.relative_path, jshint_errors) ]
-          else
-            []
-          end
+          jshint_errors(files).flatten!
         end
 
         private
 
+        def jshint_error(file)
+          errors = linter.lint(file.read)
+          [ JSHintValidationError.new(file.relative_path, errors) ] if errors.any?
+        end
+
+        def jshint_errors(files)
+          files.each_with_object([]) do |file, errors|
+            error = jshint_error(file)
+            errors << error unless error.nil?
+          end
+        end
+
         def linter
           Jshintrb::Lint.new(LINTER_OPTIONS)
         end

spec/app/app.js

@@ -1,11 +1,14 @@
 (function() {
 
   return {
+    a: require('a.js'),
+
     events: {
       'app.activated':'doSomething'
     },
 
     doSomething: function() {
+      console.log(a.name);
     }
   };
 

spec/app/lib/a.js

@@ -0,0 +1,5 @@
+var a = {
+  name: 'This is A'
+};
+
+module.exports = a;

spec/app/lib/a.txt

@@ -0,0 +1,5 @@
+var b = {
+  name: 'This is B'
+};
+
+module.exports = b;

spec/app/lib/nested/b.js

@@ -0,0 +1,6 @@
+h1 {
+  color: red;
+  span {
+    color: green;
+  }
+}

spec/invalid_app/app.css

@@ -0,0 +1,13 @@
+(function() {
+
+  return {
+    events: {
+      'app.activated':'doSomething'
+    },
+
+    doSomething: function() {
+      console.log("Invalid app");
+    }
+  };
+
+}());