Add the option to provide a top-level meta node

Author: jondruse

lib/jsonapi-serializers/serializer.rb

@@ -222,6 +222,7 @@ def self.serialize(objects, options = {})
       options[:context] = options.delete('context') || options[:context] || {}
       options[:skip_collection_check] = options.delete('skip_collection_check') || options[:skip_collection_check] || false
       options[:base_url] = options.delete('base_url') || options[:base_url]
+      options[:meta] = options.delete('meta') || options[:meta]
 
       # Normalize includes.
       includes = options[:include]
@@ -273,6 +274,7 @@ def self.serialize(objects, options = {})
       result = {
         'data' => primary_data,
       }
+      result['meta'] = options[:meta] if options[:meta]
 
       # If 'include' relationships are given, recursively find and include each object.
       if includes

spec/serializer_spec.rb

@@ -333,6 +333,14 @@ def serialize_primary(object, options = {})
         'data' => serialize_primary(post, {serializer: MyApp::PostSerializer}),
       })
     end
+    it 'can include a top level meta node' do
+      post = create(:post)
+      meta = {authors: ['Yehuda Katz', 'Steve Klabnik'], copyright: 'Copyright 2015 Example Corp.'}
+      expect(JSONAPI::Serializer.serialize(post, meta: meta)).to eq({
+        'meta' => meta,
+        'data' => serialize_primary(post, {serializer: MyApp::PostSerializer}),
+      })
+    end
     it 'can serialize a single object with an `each` method by passing skip_collection_check: true' do
       post = create(:post)
       post.define_singleton_method(:each) do