journeybook 0.1.6.pre.alpha

data/app/controllers/journeybook/admin/pages_controller.rb

@@ -0,0 +1,304 @@
+module Journeybook
+  module Admin
+    class PagesController < ApplicationController
+      before_action :set_page, only: %i[edit update source update_source component new_component add_component move_component toggle_component_visibility reorder_components delete_component destroy preview publish draft duplicate errors]
+      before_action :set_sites, only: %i[new edit create update]
+
+      def index
+        scope = current_site ? current_site.pages.includes(:site) : Page.none
+        scope = scope.by_page_type(params[:type]) if params[:type].present?
+        @pages = scope.order(updated_at: :desc)
+      end
+
+      def new
+        @page = Page.new(site: current_site || Site.order(:name).first, locale: current_site&.default_locale || "en", status: "draft", markdown: starter_markdown)
+        @templates = Journeybook.templates.for_site(@page.site)
+        @selected_template = template_for(params[:template], @page.site)
+        apply_template if @selected_template
+      end
+
+      def edit
+        set_editor_state
+      end
+
+      def source
+      end
+
+      def create
+        @page = Page.new(page_params)
+        template = template_for(params[:template_key], @page.site)
+        apply_template_path(template) if template
+
+        if @page.save
+          redirect_to edit_admin_page_path(@page, site_id: @page.site_id), notice: "Page created."
+        else
+          render :new, status: :unprocessable_entity
+        end
+      end
+
+      def update
+        if @page.update(page_params)
+          redirect_to edit_admin_page_path(@page, site_id: @page.site_id, tab: params[:tab].presence || "settings"), notice: "Page updated."
+        else
+          set_editor_state
+          render :edit, status: :unprocessable_entity
+        end
+      end
+
+      def update_source
+        if @page.update(source_params)
+          redirect_to source_admin_page_path(@page, site_id: @page.site_id), notice: "Page source updated."
+        else
+          render :source, status: :unprocessable_entity
+        end
+      end
+
+      def component
+        component_index = params[:component_index].to_i
+        markdown = ComponentTagUpdater.new.update(@page.markdown, component_index, component_props)
+
+        if @page.update(markdown: markdown)
+          redirect_params = { site_id: @page.site_id, tab: "layout" }
+          redirect_params[:component] = component_index unless params[:save_and_back].present?
+          redirect_to edit_admin_page_path(@page, **redirect_params), notice: "Component updated."
+        else
+          set_sites
+          set_editor_state
+          render :edit, status: :unprocessable_entity
+        end
+      rescue IndexError
+        redirect_to edit_admin_page_path(@page, site_id: @page.site_id, tab: "layout"), alert: "Component not found."
+      end
+
+      def new_component
+        @components = available_components.sort_by { |component| component.name.to_s }
+        @selected_component = component_for(params[:component]) || @components.first
+      end
+
+      def add_component
+        component = component_for(params[:component_name])
+
+        unless component
+          redirect_to new_component_admin_page_path(@page, site_id: @page.site_id), alert: "Component not found."
+          return
+        end
+
+        component_index = ComponentParser.new.parse(@page.markdown).length
+        markdown = ComponentTagUpdater.new.append(@page.markdown, component.name, blank_props(component))
+
+        if @page.update(markdown: markdown)
+          redirect_to edit_admin_page_path(@page, site_id: @page.site_id, tab: "layout", component: component_index), notice: "Component added."
+        else
+          @components = available_components
+          @selected_component = component
+          render :new_component, status: :unprocessable_entity
+        end
+      end
+
+      def move_component
+        markdown = ComponentTagUpdater.new.move(@page.markdown, component_index, params[:direction])
+
+        if @page.update(markdown: markdown)
+          redirect_to edit_admin_page_path(@page, site_id: @page.site_id, tab: "layout"), notice: "Component moved."
+        else
+          set_sites
+          set_editor_state
+          render :edit, status: :unprocessable_entity
+        end
+      rescue IndexError
+        redirect_to edit_admin_page_path(@page, site_id: @page.site_id, tab: "layout"), alert: "Component cannot be moved."
+      end
+
+      def reorder_components
+        markdown = ComponentTagUpdater.new.reorder(@page.markdown, component_indexes)
+        @page.update!(markdown: markdown)
+
+        head :no_content
+      rescue ArgumentError
+        head :unprocessable_entity
+      end
+
+      def toggle_component_visibility
+        markdown = ComponentTagUpdater.new.toggle_visibility(@page.markdown, component_index)
+        @page.update!(markdown: markdown)
+
+        redirect_to edit_admin_page_path(@page, site_id: @page.site_id, tab: "layout"), notice: "Component visibility updated."
+      rescue IndexError
+        redirect_to edit_admin_page_path(@page, site_id: @page.site_id, tab: "layout"), alert: "Component not found."
+      end
+
+      def delete_component
+        markdown = ComponentTagUpdater.new.delete(@page.markdown, component_index)
+
+        if @page.update(markdown: markdown)
+          redirect_to edit_admin_page_path(@page, site_id: @page.site_id, tab: "layout"), notice: "Component deleted."
+        else
+          set_sites
+          set_editor_state
+          render :edit, status: :unprocessable_entity
+        end
+      rescue IndexError
+        redirect_to edit_admin_page_path(@page, site_id: @page.site_id, tab: "layout"), alert: "Component not found."
+      end
+
+      def destroy
+        @page.destroy
+        redirect_to admin_pages_path(site_id: current_site&.id), notice: "Page deleted."
+      end
+
+      def preview
+        @journeybook_page = @page
+        @journeybook_html = PageRenderer.new.render(
+          @page,
+          form_authenticity_token: form_authenticity_token,
+          component_index: preview_component_index,
+          component_anchors: preview_component_index.nil?
+        )
+
+        render "journeybook/admin/pages/public_preview", layout: @page.layout_name
+      end
+
+      def errors
+        @publishing_errors = @page.component_validation_errors
+      end
+
+      def publish
+        if @page.update(status: "published", published_at: Time.current)
+          redirect_to admin_pages_path(site_id: @page.site_id), notice: "Page published."
+        else
+          redirect_to edit_admin_page_path(@page, site_id: @page.site_id, tab: "layout"), alert: @page.errors.full_messages.to_sentence
+        end
+      end
+
+      def draft
+        @page.update!(status: "draft")
+        redirect_to admin_pages_path(site_id: @page.site_id), notice: "Page moved to draft."
+      end
+
+      def duplicate
+        duplicate = @page.dup
+        duplicate.title = duplicate_title
+        duplicate.slug = nil
+        duplicate.path = duplicate_path
+        duplicate.status = "draft"
+        duplicate.published_at = nil
+
+        if duplicate.save
+          redirect_to edit_admin_page_path(duplicate, site_id: duplicate.site_id), notice: "Page duplicated as a draft."
+        else
+          redirect_to admin_pages_path(site_id: @page.site_id), alert: duplicate.errors.full_messages.to_sentence
+        end
+      end
+
+      private
+
+      def set_page
+        scope = current_site ? current_site.pages : Page.all
+        @page = scope.find(params[:id])
+      end
+
+      def set_sites
+        @sites = Site.order(:name)
+      end
+
+      def set_editor_state
+        @editor_tab = params[:tab] == "settings" ? "settings" : "layout"
+        @editor_pages = current_site ? current_site.pages.order(:title) : Page.includes(:site).order(:title)
+        @page_components = ComponentParser.new.parse(@page.markdown)
+        @media_assets = MediaAsset.order(created_at: :desc).limit(24)
+        @selected_component_index = params[:component].presence&.to_i
+        @selected_component_index = nil unless @selected_component_index && @page_components[@selected_component_index]
+        @selected_page_component = @page_components[@selected_component_index] if @selected_component_index
+        @selected_component_registration = Journeybook.components.registered(@selected_page_component.name) if @selected_page_component
+        @linkable_pages = @page.site.pages.order(:title)
+        @parent_pages = @page.site.pages.kb_articles.where.not(id: @page.id).order(:title)
+      end
+
+      def page_params
+        params.require(:page).permit(:site_id, :title, :path, :markdown, :meta_title, :meta_description, :status, :published_at, :layout, :locale, :page_type, :excerpt, :author_name, :parent_id, :topic, :position)
+      end
+
+      def source_params
+        params.require(:page).permit(:markdown)
+      end
+
+      def component_props
+        params.fetch(:component_props, {}).permit!.to_h
+      end
+
+      def available_components
+        Journeybook.components.for_site(@page.site).to_a
+      end
+
+      def component_for(name)
+        available_components.find { |component| component.name.to_s == name.to_s }
+      end
+
+      def blank_props(component)
+        component.normalized_props.transform_values { "" }
+      end
+
+      def component_index
+        params[:component_index].to_i
+      end
+
+      def component_indexes
+        Array(params[:component_indexes]).map(&:to_i)
+      end
+
+      def preview_component_index
+        Integer(params[:component], exception: false)
+      end
+
+      def starter_markdown
+        "{{ hero }}"
+      end
+
+      def template_for(key, site)
+        return unless key.present?
+
+        Journeybook.templates.for_site(site).find { |template| template.key.to_s == key.to_s }
+      end
+
+      def apply_template
+        @page.page_type = @selected_template.page_type
+        @page.markdown = @selected_template.markdown
+      end
+
+      def apply_template_path(template)
+        return unless template
+
+        @page.page_type = template.page_type
+        return unless template.path_prefix && @page.path.blank?
+
+        @page.path = "#{template.path_prefix}/#{@page.title.to_s.parameterize}"
+      end
+
+      def duplicate_title
+        base = "Copy of #{@page.title}"
+        return base unless @page.site.pages.where(locale: @page.locale, title: base).exists?
+
+        suffix = 2
+        loop do
+          title = "#{base} (#{suffix})"
+          return title unless @page.site.pages.where(locale: @page.locale, title: title).exists?
+
+          suffix += 1
+        end
+      end
+
+      def duplicate_path
+        base = @page.path == "/" ? "/#{@page.slug.presence || @page.title.parameterize}" : @page.path
+        candidate = "#{base}-copy"
+        suffix = 2
+
+        while @page.site.pages.where(locale: @page.locale, path: candidate).exists?
+          candidate = "#{base}-copy-#{suffix}"
+          suffix += 1
+        end
+
+        candidate
+      end
+    end
+  end
+end

data/app/controllers/journeybook/admin/redirects_controller.rb

@@ -0,0 +1,51 @@
+module Journeybook
+  module Admin
+    class RedirectsController < ApplicationController
+      before_action :set_redirect, only: %i[edit update destroy]
+
+      def index
+        @redirects = Redirect.order(:from)
+      end
+
+      def new
+        @redirect = Redirect.new(status_code: 301)
+      end
+
+      def create
+        @redirect = Redirect.new(redirect_params)
+
+        if @redirect.save
+          redirect_to admin_redirects_path, notice: "Redirect created."
+        else
+          render :new, status: :unprocessable_entity
+        end
+      end
+
+      def edit
+      end
+
+      def update
+        if @redirect.update(redirect_params)
+          redirect_to admin_redirects_path, notice: "Redirect updated."
+        else
+          render :edit, status: :unprocessable_entity
+        end
+      end
+
+      def destroy
+        @redirect.destroy
+        redirect_to admin_redirects_path, notice: "Redirect deleted."
+      end
+
+      private
+
+      def set_redirect
+        @redirect = Redirect.find(params[:id])
+      end
+
+      def redirect_params
+        params.require(:redirect).permit(:from, :to, :status_code)
+      end
+    end
+  end
+end

data/app/controllers/journeybook/admin/sites_controller.rb

@@ -0,0 +1,51 @@
+module Journeybook
+  module Admin
+    class SitesController < ApplicationController
+      before_action :set_site, only: %i[edit update destroy]
+
+      def index
+        @sites = Site.order(:name)
+      end
+
+      def new
+        @site = Site.new(default_locale: "en", path_prefix: "/", layout: Journeybook.configuration.default_layout)
+      end
+
+      def edit
+      end
+
+      def create
+        @site = Site.new(site_params)
+
+        if @site.save
+          redirect_to admin_sites_path, notice: "Site created."
+        else
+          render :new, status: :unprocessable_entity
+        end
+      end
+
+      def update
+        if @site.update(site_params)
+          redirect_to admin_sites_path, notice: "Site updated."
+        else
+          render :edit, status: :unprocessable_entity
+        end
+      end
+
+      def destroy
+        @site.destroy
+        redirect_to admin_sites_path, notice: "Site deleted."
+      end
+
+      private
+
+      def set_site
+        @site = Site.find(params[:id])
+      end
+
+      def site_params
+        params.require(:site).permit(:name, :key, :host, :path_prefix, :layout, :default_locale)
+      end
+    end
+  end
+end

data/app/controllers/journeybook/application_controller.rb

@@ -0,0 +1,52 @@
+module Journeybook
+  class ApplicationController < ActionController::Base
+    layout "journeybook/application"
+
+    before_action :authenticate_journeybook_admin!
+    before_action :set_current_site_context
+    helper_method :admin_nav_active?, :current_site, :site_context_path
+
+    private
+
+    attr_reader :current_site
+
+    def set_current_site_context
+      requested_site = Journeybook::Site.find_by(id: params[:site_id]) if params[:site_id].present?
+      session[:journeybook_site_id] = requested_site.id if requested_site
+
+      @current_site = Journeybook::Site.find_by(id: session[:journeybook_site_id]) || Journeybook::Site.order(:name).first
+      session[:journeybook_site_id] = @current_site.id if @current_site
+    end
+
+    def site_context_path(site)
+      url_for(request.query_parameters.merge(site_id: site.id))
+    end
+
+    def admin_nav_active?(section)
+      case section
+      when :dashboard
+        controller_path == "journeybook/admin/dashboard"
+      when :pages
+        controller_path == "journeybook/admin/pages"
+      when :sites
+        controller_path == "journeybook/admin/sites"
+      when :redirects
+        controller_path == "journeybook/admin/redirects"
+      when :components
+        controller_path == "journeybook/admin/components"
+      when :library
+        controller_path == "journeybook/admin/media_assets"
+      when :ai
+        controller_path == "journeybook/admin/ai_pages"
+      when :navigation
+        controller_path.start_with?("journeybook/admin/navigation_")
+      end
+    end
+
+    def authenticate_journeybook_admin!
+      return if Journeybook.configuration.admin_authenticator.call(self)
+
+      head :forbidden
+    end
+  end
+end

data/app/controllers/journeybook/form_submissions_controller.rb

@@ -0,0 +1,55 @@
+module Journeybook
+  class FormSubmissionsController < ActionController::Base
+    protect_from_forgery with: :exception
+
+    FORM_FIELDS = %w[firstname lastname name email phone company contact_subject message privacy subject].freeze
+    MAX_REQUEST_BYTES = 20.kilobytes
+    MAX_FIELD_LENGTH = 5_000
+
+    rate_limit to: 5, within: 1.minute, by: -> { request.remote_ip }, only: :create, with: -> {
+      redirect_to redirect_location, alert: "Please wait before sending another message."
+    }
+
+    def create
+      return redirect_to redirect_location, notice: confirmation_text if honeypot_triggered?
+
+      validate_submission!
+      FormMailer.new.deliver(fields: form_fields)
+      redirect_to redirect_location, notice: confirmation_text
+    rescue SubmissionError, FormMailer::ConfigurationError, PostmarkClient::Error => error
+      redirect_to redirect_location, alert: error.message
+    end
+
+    private
+
+    class SubmissionError < StandardError; end
+
+    def form_fields
+      params.permit(*FORM_FIELDS).to_h.transform_values { |value| value.to_s.strip }
+    end
+
+    def validate_submission!
+      raise SubmissionError, "The form submission is too large." if request.content_length.to_i > MAX_REQUEST_BYTES
+
+      fields = form_fields
+      raise SubmissionError, "Please provide a valid email address." unless fields["email"].match?(URI::MailTo::EMAIL_REGEXP)
+      raise SubmissionError, "Please enter a message." if params.key?(:message) && fields["message"].blank?
+      raise SubmissionError, "The form submission contains a field that is too long." if fields.values.any? { |value| value.length > MAX_FIELD_LENGTH }
+    end
+
+    def honeypot_triggered?
+      params[:website].present?
+    end
+
+    def redirect_location
+      return_to = params[:return_to].to_s
+      return return_to if return_to.start_with?("/") && !return_to.start_with?("//")
+
+      request.referer.presence || "/"
+    end
+
+    def confirmation_text
+      params[:confirmation_text].to_s.strip.presence || "Thanks, your message was sent."
+    end
+  end
+end

data/app/helpers/journeybook/application_helper.rb

@@ -0,0 +1,4 @@
+module Journeybook
+  module ApplicationHelper
+  end
+end

data/app/helpers/journeybook/navigation_helper.rb

@@ -0,0 +1,11 @@
+module Journeybook
+  module NavigationHelper
+    def journeybook_menu(key, site: nil)
+      site ||= @journeybook_site || @journeybook_page&.site
+      return unless site
+
+      @journeybook_navigation_menus ||= {}
+      @journeybook_navigation_menus[[ site.id, key.to_s ]] ||= site.navigation_menus.includes(items: :page).find_by(key: key.to_s)
+    end
+  end
+end

data/app/javascript/journeybook/application.js

@@ -0,0 +1,5 @@
+import { Application } from "@hotwired/stimulus"
+import ComponentSearchController from "journeybook/component_search_controller"
+
+const application = Application.start()
+application.register("journeybook-component-search", ComponentSearchController)

data/app/javascript/journeybook/component_search_controller.js

@@ -0,0 +1,13 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class extends Controller {
+  static targets = [ "input", "item" ]
+
+  filter() {
+    const query = this.inputTarget.value.trim().toLowerCase()
+
+    this.itemTargets.forEach((item) => {
+      item.hidden = Boolean(query) && !item.dataset.componentSearchName.toLowerCase().includes(query)
+    })
+  }
+}

data/app/jobs/journeybook/application_job.rb

@@ -0,0 +1,4 @@
+module Journeybook
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/models/journeybook/ai_style_prompt.rb

@@ -0,0 +1,6 @@
+module Journeybook
+  class AiStylePrompt < ApplicationRecord
+    validates :name, :prompt, presence: true
+    validates :name, uniqueness: true
+  end
+end

data/app/models/journeybook/application_record.rb

@@ -0,0 +1,5 @@
+module Journeybook
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/models/journeybook/media_asset.rb

@@ -0,0 +1,26 @@
+module Journeybook
+  class MediaAsset < ApplicationRecord
+    IMAGE_CONTENT_TYPES = %w[image/png image/jpeg image/webp image/gif image/svg+xml].freeze
+
+    validates :title, :storage_key, :original_filename, :content_type, :byte_size, presence: true
+    validates :storage_key, uniqueness: true
+    validates :content_type, inclusion: { in: IMAGE_CONTENT_TYPES }
+    validates :byte_size, numericality: { greater_than: 0 }
+
+    before_destroy :delete_storage_object
+
+    def public_url
+      Journeybook::Storage::S3Client.new.public_url(storage_key)
+    end
+
+    def tag_list
+      tags.to_s.split(",").map(&:strip).reject(&:blank?)
+    end
+
+    private
+
+    def delete_storage_object
+      Journeybook::Storage::S3Client.new.delete(storage_key)
+    end
+  end
+end

data/app/models/journeybook/navigation_item.rb

@@ -0,0 +1,45 @@
+module Journeybook
+  class NavigationItem < ApplicationRecord
+    belongs_to :navigation_menu
+    belongs_to :page, class_name: "Page", optional: true
+
+    before_validation :normalize_external_url
+
+    validates :label, presence: true
+    validates :external_url, format: { with: %r{\A(?:https?://|/|#)}, message: "must be an absolute URL, path, or anchor" }, allow_blank: true
+    validate :has_destination
+    validate :page_belongs_to_menu_site
+
+    scope :ordered, -> { order(:position, :id) }
+
+    def displayable?
+      visible? && (external_url.present? || page&.published?)
+    end
+
+    def href
+      navigation_menu.site.public_path_for(page) || external_url
+    end
+
+    def target
+      "_blank" if open_in_new_window?
+    end
+
+    private
+
+    def normalize_external_url
+      self.external_url = external_url.to_s.strip.presence
+    end
+
+    def has_destination
+      return if page.present? ^ external_url.present?
+
+      errors.add(:base, "Select either a page or an external URL")
+    end
+
+    def page_belongs_to_menu_site
+      return unless page && page.site_id != navigation_menu.site_id
+
+      errors.add(:page, "must belong to the same site as the menu")
+    end
+  end
+end

data/app/models/journeybook/navigation_menu.rb

@@ -0,0 +1,23 @@
+module Journeybook
+  class NavigationMenu < ApplicationRecord
+    belongs_to :site
+    has_many :items, class_name: "NavigationItem", dependent: :destroy
+
+    before_validation :normalize_key
+
+    validates :key, :title, presence: true
+    validates :key, uniqueness: { scope: :site_id }
+
+    scope :ordered, -> { order(:position, :title) }
+
+    def visible_items
+      @visible_items ||= items.includes(:page).order(:position, :id).select(&:displayable?)
+    end
+
+    private
+
+    def normalize_key
+      self.key = key.to_s.parameterize(separator: "_").underscore
+    end
+  end
+end