wcc-contentful 0.3.0.pre.rc3 → 0.3.0

data/lib/generators/wcc/templates/menu/generated_add_menus.ts

@@ -0,0 +1,192 @@
+
+import Migration from 'contentful-migration-cli'
+
+export = function (migration: Migration) {
+  const menu = migration.createContentType('menu', {
+    displayField: 'name',
+    name: 'Menu',
+    description: 'A Menu contains a number of Menu Buttons or other Menus, ' +
+      'which will be rendered as drop-downs.'
+  })
+
+  menu.createField('name', {
+    name: 'Menu Name',
+    type: 'Symbol',
+    localized: false,
+    required: true,
+    validations: [],
+    disabled: false,
+    omitted: false
+  })
+
+  menu.createField('items', {
+    name: 'Items',
+    type: 'Array',
+    localized: false,
+    required: false,
+    validations: [],
+    disabled: false,
+    omitted: false,
+    items:
+      {
+        type: 'Link',
+        validations:
+          [{
+            linkContentType:
+              ['dropdownMenu',
+                'menuButton'],
+            message: 'The items must be either buttons or drop-down menus.'
+          }],
+        linkType: 'Entry'
+      }
+  })
+
+  menu.changeEditorInterface('name', 'singleLine')
+  menu.changeEditorInterface('items', 'entryLinksEditor')
+
+  const menubutton = migration.createContentType('menuButton', {
+    displayField: 'text',
+    name: 'Menu Button',
+    description: 'A Menu Button is a clickable button that goes on a Menu.  It has a link to a Page or a URL.'
+  })
+
+  menubutton.createField('text', {
+    name: 'Text',
+    type: 'Symbol',
+    localized: false,
+    required: true,
+    validations:
+      [{
+        size:
+          {
+            min: 1,
+            max: 60
+          },
+        message: 'A Menu Button should have a very short text field - ideally a single word.  Please limit the text to 60 characters.'
+      }],
+    disabled: false,
+    omitted: false
+  })
+
+  menubutton.createField('icon', {
+    name: 'Icon',
+    type: 'Link',
+    localized: false,
+    required: false,
+    validations: [{ linkMimetypeGroup: ['image'] }],
+    disabled: false,
+    omitted: false,
+    linkType: 'Asset'
+  })
+
+  menubutton.createField('externalLink', {
+    name: 'External Link',
+    type: 'Symbol',
+    localized: false,
+    required: false,
+    validations:
+      [{
+        regexp: { pattern: '^(\\w+):(\\/\\/)?(\\w+:{0,1}\\w*@)?((\\w+\\.)+[^\\s\\/#]+)(:[0-9]+)?(\\/|(\\/|\\#)([\\w#!:.?+=&%@!\\-\\/]+))?$|^(\\/|(\\/|\\#)([\\w#!:.?+=&%@!\\-\\/]+))$' },
+        message: 'The external link must be a URL like \'https://www.watermark.org/\', a mailto url like \'mailto:info@watermark.org\', or a relative URL like \'#location-on-page\''
+      }],
+    disabled: false,
+    omitted: false
+  })
+
+  menubutton.createField('link', {
+    name: 'Page Link',
+    type: 'Link',
+    localized: false,
+    required: false,
+    validations:
+      [{
+        linkContentType: ['page'],
+        message: 'The Page Link must be a link to a Page which has a slug.'
+      }],
+    disabled: false,
+    omitted: false,
+    linkType: 'Entry'
+  })
+
+  menubutton.createField('ionIcon', {
+    name: 'Ion Icon',
+    type: 'Symbol',
+    localized: false,
+    required: false,
+    validations:
+      [{
+        regexp: { pattern: '^ion-[a-z\\-]+$' },
+        message: 'The icon should start with \'ion-\', like \'ion-arrow-down-c\'.  See http://ionicons.com/'
+      }],
+    disabled: false,
+    omitted: false
+  })
+
+  menubutton.createField('style', {
+    name: 'Style',
+    type: 'Symbol',
+    localized: false,
+    required: false,
+    validations: [{ in: ['oval-border'] }],
+    disabled: false,
+    omitted: false
+  })
+
+  menubutton.changeEditorInterface('text', 'singleLine')
+  menubutton.changeEditorInterface('icon', 'assetLinkEditor')
+  menubutton.changeEditorInterface('externalLink', 'singleLine')
+  menubutton.changeEditorInterface('link', 'entryLinkEditor')
+  menubutton.changeEditorInterface('ionIcon', 'singleLine')
+  menubutton.changeEditorInterface('style', 'dropdown')
+
+  const dropdownmenu = migration.createContentType('dropdownMenu', {
+    displayField: 'name',
+    name: 'Dropdown Menu',
+    description: 'A Dropdown Menu can be attached to a main menu to show additional menu items on click.'
+  })
+
+  dropdownmenu.createField('name', {
+    name: 'Menu Name',
+    type: 'Symbol',
+    localized: false,
+    required: false,
+    validations: [],
+    disabled: false,
+    omitted: false
+  })
+
+  dropdownmenu.createField('label', {
+    name: 'Menu Label',
+    type: 'Link',
+    localized: false,
+    required: false,
+    validations: [{ linkContentType: ['menuButton'] }],
+    disabled: false,
+    omitted: false,
+    linkType: 'Entry'
+  })
+
+  dropdownmenu.createField('items', {
+    name: 'Items',
+    type: 'Array',
+    localized: false,
+    required: false,
+    validations: [],
+    disabled: false,
+    omitted: false,
+    items:
+      {
+        type: 'Link',
+        validations:
+          [{
+            linkContentType:
+              ['menuButton']
+          }],
+        linkType: 'Entry'
+      }
+  })
+
+  dropdownmenu.changeEditorInterface('name', 'singleLine')
+  dropdownmenu.changeEditorInterface('label', 'entryLinkEditor')
+  dropdownmenu.changeEditorInterface('items', 'entryLinksEditor')
+}

data/lib/generators/wcc/templates/menu/models/menu.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# This model represents the 'menu' content type in Contentful.  Any linked
+# entries of the 'menu' content type will be resolved as instances of this class.
+# It exposes #find, #find_by, and #find_all methods to query Contentful.
+class Menu < WCC::Contentful::Model::Menu
+  # Add custom validations to ensure that app-specific properties exist:
+  # validate_field :foo, :String, :required
+  # validate_field :bar_links, :Array, link_to: %w[bar baz]
+
+  # Override functionality or add utilities
+  #
+  # # Example: override equality
+  # def ===(other)
+  #   ...
+  # end
+  #
+  # # Example: override "name" attribute to always be camelized.
+  # #          `@name` is populated by the gem in the initializer.
+  # def name
+  #   @name_camelized ||= @name.camelize(true)
+  # end
+end

data/lib/generators/wcc/templates/menu/models/menu_button.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# This model represents the 'menuButton' content type in Contentful.  Any linked
+# entries of the 'menuButton' content type will be resolved as instances of this class.
+# It exposes #find, #find_by, and #find_all methods to query Contentful.
+class MenuButton < WCC::Contentful::Model::MenuButton
+  # Add custom validations to ensure that app-specific properties exist:
+  # validate_field :foo, :String, :required
+  # validate_field :bar_links, :Array, link_to: %w[bar baz]
+
+  # Override functionality or add utilities
+  #
+  # # Example: override equality
+  # def ===(other)
+  #   ...
+  # end
+  #
+  # # Example: override "text" attribute to always be camelized.
+  # #          `@text` is populated by the gem in the initializer.
+  # def text
+  #   @text_camelized ||= @text.camelize(true)
+  # end
+end

data/lib/generators/wcc/templates/page/generated_add_pages.ts

@@ -0,0 +1,50 @@
+import Migration from 'contentful-migration-cli'
+
+export = function (migration: Migration) {
+  const page = migration.createContentType('page')
+    .name('Page')
+    .description('A page describes a collection of sections that correspond' +
+     'to a URL slug')
+    .displayField('title')
+
+  page.createField('title')
+    .name('Title')
+    .type('Symbol')
+    .required(true)
+
+  page.createField('slug')
+    .name('Slug')
+    .type('Symbol')
+    .required(true)
+    .validations([
+      {
+        unique: true
+      },
+      {
+        regexp: { pattern: "(\\/|\\/([\w#!:.?+=&%@!\\-\\/]))?$" },
+        message: "The slug must look like the path part of a URL and begin with a forward slash, example: '/my-page-slug'"
+      }
+    ])
+
+  page.createField('sections')
+    .name('Sections')
+    .type('Array')
+    .items({
+      type: 'Link',
+      linkType: 'Entry'
+    })
+
+  page.createField('subpages')
+    .name('Subpages')
+    .type('Array')
+    .items({
+      type: 'Link',
+      linkType: 'Entry',
+      validations: [
+        {
+          linkContentType: [ 'page' ]
+        }
+      ]
+    })
+
+}

data/lib/generators/wcc/templates/page/models/page.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# This model represents the 'page' content type in Contentful.  Any linked
+# entries of the 'page' content type will be resolved as instances of this class.
+# It exposes #find, #find_by, and #find_all methods to query Contentful.
+class Page < WCC::Contentful::Model::Page
+  # Add custom validations to ensure that app-specific properties exist:
+  # validate_field :foo, :String, :required
+  # validate_field :bar_links, :Array, link_to: %w[bar baz]
+
+  # Override functionality or add utilities
+  #
+  # # Example: override equality
+  # def ===(other)
+  #   ...
+  # end
+  #
+  # # Example: override "title" attribute to always be titlecase.
+  # #          `@title` is populated by the gem in the initializer.
+  # def title
+  #   @title_titlecased ||= @title.titlecase
+  # end
+end

data/lib/generators/wcc/templates/release

@@ -0,0 +1,9 @@
+#!/bin/sh
+
+set -e
+
+echo "Migrating database..."
+bundle exec rake db:migrate
+
+DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+$DIR/contentful migrate -y

data/lib/generators/wcc/templates/wcc_contentful.rb

@@ -0,0 +1,17 @@
+
+WCC::Contentful.configure do |config|
+  # Required
+  config.access_token = # Contentful CDN access token
+  config.space = # Contentful Space ID
+
+  # Optional
+  config.management_token = # Contentful API management token
+  config.default_locale = # Set default locale, if left blank this is 'en-US'
+  config.content_delivery = # :direct, :eager_sync, or :lazy_sync
+end
+
+# Download content types, build models, and sync content
+WCC::Contentful.init!
+
+# Validate that models conform to a defined specification
+WCC::Contentful.validate_models! unless defined?(Rails) && Rails.env.development?

data/lib/wcc/contentful.rb

@@ -12,6 +12,7 @@ require 'wcc/contentful/services'
 require 'wcc/contentful/simple_client'
 require 'wcc/contentful/store'
 require 'wcc/contentful/content_type_indexer'
+require 'wcc/contentful/model_validators'
 require 'wcc/contentful/model'
 require 'wcc/contentful/model_methods'
 require 'wcc/contentful/model_singleton_methods'
@@ -25,8 +26,6 @@ module WCC::Contentful
   class << self
     # Gets the current configuration, after calling WCC::Contentful.configure
     attr_reader :configuration
-
-    attr_reader :types
   end
 
   # Configures the WCC::Contentful gem to talk to a Contentful space.
@@ -53,6 +52,8 @@ module WCC::Contentful
   def self.init!
     raise ArgumentError, 'Please first call WCC:Contentful.configure' if configuration.nil?
 
+    @mutex ||= Mutex.new
+
     # we want as much as possible the raw JSON from the API so use the management
     # client if possible
     client = Services.instance.management_client ||
@@ -74,6 +75,35 @@ module WCC::Contentful
 
     WCC::Contentful::ModelBuilder.new(@types).build_models
 
+    # Extend all model types w/ validation & extra fields
+    @types.each_value do |t|
+      file = File.dirname(__FILE__) + "/contentful/model/#{t.name.underscore}.rb"
+      require file if File.exist?(file)
+    end
+
     require_relative 'contentful/client_ext' if defined?(::Contentful)
   end
+
+  # Runs validations over the content types returned from the Contentful API.
+  # Validations are configured on predefined model classes using the
+  # `validate_field` directive.  Example:
+  #    validate_field :top_button, :Link, :optional, link_to: 'menuButton'
+  # This results in a WCC::Contentful::ValidationError
+  # if the 'topButton' field in the 'menu' content type is not a link.
+  def self.validate_models!
+    # Ensure application models are loaded before we validate
+    Dir[Rails.root.join('app/models/**/*.rb')].each { |file| require file } if defined?(Rails)
+
+    content_types = WCC::Contentful::ModelValidators.transform_content_types_for_validation(
+      @content_types
+    )
+    errors = WCC::Contentful::Model.schema.call(content_types)
+    raise WCC::Contentful::ValidationError, errors.errors unless errors.success?
+  end
+
+  # TODO: https://zube.io/watermarkchurch/development/c/2234 init graphql
+  # def self.init_graphql!
+  #   require 'wcc/contentful/graphql'
+  #   etc...
+  # end
 end

data/lib/wcc/contentful/exceptions.rb

@@ -1,6 +1,39 @@
 # frozen_string_literal: true
 
 module WCC::Contentful
+  # Raised by {WCC::Contentful.validate_models!} if a content type in the space
+  # does not match the validation defined on the associated model.
+  class ValidationError < StandardError
+    Message =
+      Struct.new(:path, :error) do
+        def to_s
+          "#{path}: #{error}"
+        end
+      end
+
+    attr_reader :errors
+
+    def initialize(errors)
+      @errors = ValidationError.join_msg_keys(errors)
+      super("Content Type Schema from Contentful failed validation!\n  #{@errors.join("\n  ")}")
+    end
+
+    # Turns the error messages hash into an array of message structs like:
+    # menu.fields.name.type: must be equal to String
+    def self.join_msg_keys(hash)
+      ret =
+        hash.map do |k, v|
+          if v.is_a?(Hash)
+            msgs = join_msg_keys(v)
+            msgs.map { |msg| Message.new(k.to_s + '.' + msg.path, msg.error) }
+          else
+            v.map { |msg| Message.new(k.to_s, msg) }
+          end
+        end
+      ret.flatten(1)
+    end
+  end
+
   class SyncError < StandardError
   end
 

data/lib/wcc/contentful/model.rb

@@ -38,6 +38,7 @@
 # @api Model
 class WCC::Contentful::Model
   extend WCC::Contentful::Helpers
+  extend WCC::Contentful::ModelValidators
 
   # The Model base class maintains a registry which is best expressed as a
   # class var.