postnhost 0.0.0 → 0.1.0

data/app/javascript/controllers/title_field_controller.js

@@ -0,0 +1,17 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class extends Controller {
+  preventNewLine(event) {
+    if (event.key === "Enter") {
+      event.preventDefault()
+      this.#focusEditor()
+    }
+  }
+
+  #focusEditor() {
+    const editor = document.querySelector(".ProseMirror")
+    if (editor) {
+      editor.focus()
+    }
+  }
+}

data/app/javascript/helpers/auto_save_state.js

@@ -0,0 +1,47 @@
+export default class AutoSaveState {
+  constructor() {
+    this.changeGeneration = 0
+    this.savedGeneration = 0
+    this.savingGeneration = null
+  }
+
+  get hasUnsavedChanges() {
+    return this.changeGeneration > this.savedGeneration
+  }
+
+  get isSaving() {
+    return this.savingGeneration !== null
+  }
+
+  markChanged() {
+    this.changeGeneration += 1
+  }
+
+  beginSave() {
+    if (this.isSaving || !this.hasUnsavedChanges) return null
+
+    this.savingGeneration = this.changeGeneration
+    return this.savingGeneration
+  }
+
+  completeSave(generation) {
+    this.#assertActiveSave(generation)
+    this.savedGeneration = Math.max(this.savedGeneration, generation)
+    this.savingGeneration = null
+  }
+
+  failSave(generation) {
+    this.#assertActiveSave(generation)
+    this.savingGeneration = null
+  }
+
+  hasChangesAfter(generation) {
+    return this.changeGeneration > generation
+  }
+
+  #assertActiveSave(generation) {
+    if (generation !== this.savingGeneration) {
+      throw new Error(`Expected active save generation ${this.savingGeneration}, received ${generation}`)
+    }
+  }
+}

data/app/javascript/helpers/code_highlighting.js

@@ -0,0 +1,48 @@
+import { createLowlight } from 'lowlight'
+import bash from 'highlight.js/lib/languages/bash'
+import c from 'highlight.js/lib/languages/c'
+import cpp from 'highlight.js/lib/languages/cpp'
+import csharp from 'highlight.js/lib/languages/csharp'
+import css from 'highlight.js/lib/languages/css'
+import diff from 'highlight.js/lib/languages/diff'
+import go from 'highlight.js/lib/languages/go'
+import java from 'highlight.js/lib/languages/java'
+import javascript from 'highlight.js/lib/languages/javascript'
+import json from 'highlight.js/lib/languages/json'
+import kotlin from 'highlight.js/lib/languages/kotlin'
+import markdown from 'highlight.js/lib/languages/markdown'
+import php from 'highlight.js/lib/languages/php'
+import plaintext from 'highlight.js/lib/languages/plaintext'
+import python from 'highlight.js/lib/languages/python'
+import ruby from 'highlight.js/lib/languages/ruby'
+import rust from 'highlight.js/lib/languages/rust'
+import sql from 'highlight.js/lib/languages/sql'
+import swift from 'highlight.js/lib/languages/swift'
+import typescript from 'highlight.js/lib/languages/typescript'
+import xml from 'highlight.js/lib/languages/xml'
+import yaml from 'highlight.js/lib/languages/yaml'
+
+export const codeLowlight = createLowlight({
+  bash,
+  c,
+  cpp,
+  csharp,
+  css,
+  diff,
+  go,
+  java,
+  javascript,
+  json,
+  kotlin,
+  markdown,
+  php,
+  plaintext,
+  python,
+  ruby,
+  rust,
+  sql,
+  swift,
+  typescript,
+  xml,
+  yaml,
+})

data/app/javascript/helpers/dom_helpers.js

@@ -0,0 +1,109 @@
+// DOM manipulation utilities
+// Follows KISS principle: simple, reusable DOM operations
+
+/**
+ * Show an element by removing 'hidden' class
+ * @param {HTMLElement} element - Element to show
+ */
+export function showElement(element) {
+  if (!element) return
+  element.classList.remove('hidden')
+}
+
+/**
+ * Hide an element by adding 'hidden' class
+ * @param {HTMLElement} element - Element to hide
+ */
+export function hideElement(element) {
+  if (!element) return
+  element.classList.add('hidden')
+}
+
+/**
+ * Toggle element visibility
+ * @param {HTMLElement} element - Element to toggle
+ */
+export function toggleElement(element) {
+  if (!element) return
+  element.classList.toggle('hidden')
+}
+
+/**
+ * Create a toast notification
+ * @param {string} message - Message to display
+ * @param {string} type - Type of toast: 'success', 'error', 'info', 'warning'
+ * @param {number} duration - Duration in milliseconds (default: 5000)
+ * @returns {HTMLElement} The created toast element
+ */
+export function createToast(message, type = 'error', duration = 5000) {
+  const toastConfig = {
+    success: {
+      bg: 'bg-green-50',
+      border: 'border-green-200',
+      textColor: 'text-green-800',
+      iconColor: 'text-green-600',
+      icon: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"></path>'
+    },
+    error: {
+      bg: 'bg-red-50',
+      border: 'border-red-200',
+      textColor: 'text-red-800',
+      iconColor: 'text-red-600',
+      icon: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"></path>'
+    },
+    info: {
+      bg: 'bg-blue-50',
+      border: 'border-blue-200',
+      textColor: 'text-blue-800',
+      iconColor: 'text-blue-600',
+      icon: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 16h-1v-4h-1m1-4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z"></path>'
+    },
+    warning: {
+      bg: 'bg-yellow-50',
+      border: 'border-yellow-200',
+      textColor: 'text-yellow-800',
+      iconColor: 'text-yellow-600',
+      icon: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"></path>'
+    }
+  }
+
+
+  const config = toastConfig[type] || toastConfig.error
+
+  const toast = document.createElement('div')
+  toast.className = `fixed top-4 right-4 ${config.bg} border ${config.border} rounded-xl px-4 py-3 shadow-lg z-50`
+  toast.innerHTML = `
+    <div class="flex items-center">
+      <svg class="w-5 h-5 ${config.iconColor} mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        ${config.icon}
+      </svg>
+      <span class="text-sm ${config.textColor}">${message}</span>
+    </div>
+  `
+
+  document.body.appendChild(toast)
+
+  setTimeout(() => {
+    toast.remove()
+  }, duration)
+
+  return toast
+}
+
+/**
+ * Safely remove an element from the DOM
+ * @param {HTMLElement} element - Element to remove
+ */
+export function removeElement(element) {
+  if (!element || !element.parentNode) return
+  element.remove()
+}
+
+/**
+ * Check if element exists in DOM
+ * @param {HTMLElement} element - Element to check
+ * @returns {boolean}
+ */
+export function elementExists(element) {
+  return element && element.parentNode !== null
+}

data/app/javascript/helpers/style_helpers.js

@@ -0,0 +1,168 @@
+// Centralized Tailwind CSS class definitions for consistent styling across the app
+// Following DRY principle: define once, use everywhere
+
+// Button State Classes
+export const BUTTON_STATES = {
+  primary: ['bg-gray-900', 'text-white', 'border-gray-900', 'hover:bg-gray-800', 'cursor-pointer'],
+  secondary: ['bg-white', 'border-gray-300', 'text-gray-700', 'hover:bg-gray-50', 'cursor-pointer'],
+  disabled: ['bg-gray-300', 'text-gray-500', 'cursor-not-allowed'],
+  saved: ['bg-white', 'border-gray-300', 'text-gray-700', 'hover:bg-gray-50', 'opacity-50', 'cursor-not-allowed'],
+  saving: ['opacity-75', 'cursor-not-allowed'],
+  uploading: ['bg-purple-100', 'text-purple-800', 'border-purple-200', 'cursor-not-allowed'],
+  error: ['bg-red-600', 'text-white', 'border-red-600', 'hover:bg-red-700']
+}
+
+// Editor Toolbar States
+export const EDITOR_STATES = {
+  active: ['bg-gray-900', 'text-white'],
+  inactive: ['text-gray-500', 'hover:text-gray-900', 'hover:bg-gray-100'],
+  disabled: ['opacity-50', 'cursor-not-allowed'],
+  dragOver: ['border-blue-500', 'border-2', 'border-dashed', 'bg-blue-50']
+}
+
+// Animation Classes
+export const ANIMATION_CLASSES = {
+  fadeIn: ['transition-all', 'duration-300', 'ease-out', 'scale-100', 'opacity-100'],
+  fadeOut: ['transform', 'scale-95', 'opacity-0'],
+  initial: ['transform', 'scale-95', 'opacity-0']
+}
+
+// Drag & Drop States
+export const DRAG_STATES = {
+  over: ['border-gray-400', 'bg-gray-50'],
+  leave: []
+}
+
+// Utility Functions
+
+/**
+ * Apply multiple CSS classes to an element
+ * @param {HTMLElement} element - Target element
+ * @param {string[]} classes - Array of class names to add
+ */
+export function applyClasses(element, classes) {
+  if (!element || !Array.isArray(classes)) return
+  element.classList.add(...classes)
+}
+
+/**
+ * Remove multiple CSS classes from an element
+ * @param {HTMLElement} element - Target element
+ * @param {string[]} classes - Array of class names to remove
+ */
+export function removeClasses(element, classes) {
+  if (!element || !Array.isArray(classes)) return
+  element.classList.remove(...classes)
+}
+
+/**
+ * Toggle classes: remove old set, add new set
+ * @param {HTMLElement} element - Target element
+ * @param {string[]} addClasses - Classes to add
+ * @param {string[]} removeClasses - Classes to remove
+ */
+export function toggleClasses(element, addClasses, removeClasses) {
+  if (!element) return
+
+  if (Array.isArray(removeClasses) && removeClasses.length > 0) {
+    element.classList.remove(...removeClasses)
+  }
+
+  if (Array.isArray(addClasses) && addClasses.length > 0) {
+    element.classList.add(...addClasses)
+  }
+}
+
+/**
+ * Set button to primary state
+ * @param {HTMLElement} button - Button element
+ */
+export function setPrimaryButton(button) {
+  if (!button) return
+  toggleClasses(button, BUTTON_STATES.primary, [
+    ...BUTTON_STATES.secondary,
+    ...BUTTON_STATES.disabled,
+    ...BUTTON_STATES.saved,
+    ...BUTTON_STATES.saving,
+    ...BUTTON_STATES.uploading,
+    ...BUTTON_STATES.error
+  ])
+  button.disabled = false
+}
+
+/**
+ * Set button to disabled state
+ * @param {HTMLElement} button - Button element
+ */
+export function setDisabledButton(button) {
+  if (!button) return
+  toggleClasses(button, BUTTON_STATES.disabled, [
+    ...BUTTON_STATES.primary,
+    ...BUTTON_STATES.secondary,
+    ...BUTTON_STATES.saved,
+    ...BUTTON_STATES.saving,
+    ...BUTTON_STATES.uploading,
+    ...BUTTON_STATES.error
+  ])
+  button.disabled = true
+}
+
+/**
+ * Set button to error state
+ * @param {HTMLElement} button - Button element
+ */
+export function setErrorButton(button) {
+  if (!button) return
+  toggleClasses(button, BUTTON_STATES.error, [
+    ...BUTTON_STATES.primary,
+    ...BUTTON_STATES.secondary,
+    ...BUTTON_STATES.saved,
+    ...BUTTON_STATES.saving,
+    ...BUTTON_STATES.uploading,
+    ...BUTTON_STATES.disabled
+  ])
+  button.disabled = false
+}
+
+/**
+ * Set button to saved state
+ * @param {HTMLElement} button - Button element
+ */
+export function setSavedButton(button) {
+  if (!button) return
+  toggleClasses(button, BUTTON_STATES.saved, [
+    ...BUTTON_STATES.primary,
+    ...BUTTON_STATES.saving,
+    ...BUTTON_STATES.uploading,
+    ...BUTTON_STATES.error
+  ])
+  button.disabled = true
+}
+
+/**
+ * Set button to saving state
+ * @param {HTMLElement} button - Button element
+ */
+export function setSavingButton(button) {
+  if (!button) return
+  removeClasses(button, BUTTON_STATES.uploading)
+  applyClasses(button, BUTTON_STATES.saving)
+  removeClasses(button, ['cursor-pointer'])
+  button.disabled = true
+}
+
+/**
+ * Set button to uploading state
+ * @param {HTMLElement} button - Button element
+ */
+export function setUploadingButton(button) {
+  if (!button) return
+  toggleClasses(button, BUTTON_STATES.uploading, [
+    ...BUTTON_STATES.primary,
+    ...BUTTON_STATES.secondary,
+    ...BUTTON_STATES.saved,
+    ...BUTTON_STATES.error
+  ])
+  applyClasses(button, BUTTON_STATES.saving)
+  button.disabled = true
+}

data/app/jobs/postnhost/application_job.rb

@@ -0,0 +1,9 @@
+module Postnhost
+  class ApplicationJob < ::ActiveJob::Base
+    # Automatically retry jobs that encountered a deadlock
+    # retry_on ActiveRecord::Deadlocked
+
+    # Most jobs are safe to ignore if the underlying records are no longer available
+    # discard_on ActiveJob::DeserializationError
+  end
+end

data/app/jobs/postnhost/scheduled_article_job.rb

@@ -0,0 +1,13 @@
+module Postnhost
+  class ScheduledArticleJob < ApplicationJob
+    queue_as :publishing
+
+    queue_with_priority 1
+
+    retry_on StandardError, attempts: 3
+
+    def perform(article_id)
+      Postnhost::Publishing::Articles::PublishScheduled.call(article_id:, job_id:)
+    end
+  end
+end

data/app/jobs/postnhost/translation/article_variant_job.rb

@@ -0,0 +1,17 @@
+module Postnhost
+  module Translation
+    class ArticleVariantJob < ApplicationJob
+      queue_as :default
+
+      queue_with_priority 1
+
+      retry_on StandardError, attempts: 3
+
+      def perform(article_id, language_id)
+        result = ArticleVariantTranslator.call(article_id:, language_id:)
+
+        result.success? ? result : raise(StandardError, result.errors.to_sentence)
+      end
+    end
+  end
+end

data/app/jobs/postnhost/translation/category_variant_job.rb

@@ -0,0 +1,17 @@
+module Postnhost
+  module Translation
+    class CategoryVariantJob < ApplicationJob
+      queue_as :default
+
+      queue_with_priority 1
+
+      retry_on StandardError, attempts: 3
+
+      def perform(category_id, language_id)
+        result = CategoryVariantTranslator.call(category_id:, language_id:)
+
+        result.success? ? result : raise(StandardError, result.errors.to_sentence)
+      end
+    end
+  end
+end

data/app/jobs/postnhost/translation/page_variant_job.rb

@@ -0,0 +1,17 @@
+module Postnhost
+  module Translation
+    class PageVariantJob < ApplicationJob
+      queue_as :default
+
+      queue_with_priority 1
+
+      retry_on StandardError, attempts: 3
+
+      def perform(page_id, language_id)
+        result = PageVariantTranslator.call(page_id:, language_id:)
+
+        result.success? ? result : raise(StandardError, result.errors.to_sentence)
+      end
+    end
+  end
+end

data/app/models/concerns/postnhost/article/image_uploadable.rb

@@ -0,0 +1,11 @@
+module Postnhost::Article::ImageUploadable
+  extend ActiveSupport::Concern
+
+  include Postnhost::InlineImageUploadable
+
+  private
+
+  def inline_image_uploader_class
+    Postnhost::InlineArticleImageUploader
+  end
+end

data/app/models/concerns/postnhost/excerpt_optimizable.rb

@@ -0,0 +1,57 @@
+module Postnhost
+  module ExcerptOptimizable
+    extend ActiveSupport::Concern
+
+    CUSTOM_EXCERPT_MAX_CHARS = 160
+
+    included do
+      validate :custom_excerpt_length_within_limit
+      before_validation :populate_auto_excerpt, if: :should_populate_auto_excerpt?
+    end
+
+    class_methods do
+      def custom_excerpt_max_chars
+        CUSTOM_EXCERPT_MAX_CHARS
+      end
+
+      def computed_auto_excerpt(content)
+        plain_content = plain_text_with_spacing(content.to_s)
+        return if plain_content.blank?
+
+        sentence_excerpt = plain_content[/\A(?:.*?[.!?](?:\s+|$)){1,2}/m]&.strip
+        fallback_excerpt = sentence_excerpt.presence || plain_content
+        return fallback_excerpt if fallback_excerpt.length <= custom_excerpt_max_chars
+
+        "#{fallback_excerpt[0, custom_excerpt_max_chars].rstrip}..."
+      end
+
+      private
+
+      def plain_text_with_spacing(content)
+        return content.squish unless content.include?("<")
+
+        content_with_breaks = content.gsub(%r{</(p|div|li|h[1-6]|blockquote|pre|tr|td|th)>|<br\s*/?>}i, " ")
+        ActionController::Base.helpers.strip_tags(content_with_breaks).squish
+      end
+    end
+
+    private
+
+    def custom_excerpt_length_within_limit
+      return if custom_excerpt.blank?
+
+      excerpt = custom_excerpt.to_s.squish
+      return if excerpt.length <= self.class.custom_excerpt_max_chars
+
+      errors.add(:custom_excerpt, "must be #{self.class.custom_excerpt_max_chars} characters or fewer")
+    end
+
+    def should_populate_auto_excerpt?
+      will_save_change_to_content? || auto_excerpt.blank?
+    end
+
+    def populate_auto_excerpt
+      self.auto_excerpt = self.class.computed_auto_excerpt(content)
+    end
+  end
+end

data/app/models/concerns/postnhost/inline_image_uploadable.rb

@@ -0,0 +1,40 @@
+module Postnhost::InlineImageUploadable
+  extend ActiveSupport::Concern
+
+  IMAGE_MAX_SIZE = 20.megabytes
+  SUPPORTED_CONTENT_TYPES = %w[image/jpeg image/png image/gif image/webp image/heic].freeze
+
+  def upload_inline_image(file)
+    return { success: false, error: "Invalid file type" } unless valid_image_file_type?(file)
+    return { success: false, error: "File too large" } if image_file_too_large?(file)
+
+    uploader = inline_image_uploader_class.new(self, :inline_image)
+    uploader.store!(file)
+
+    {
+      success: true,
+      url: uploader.url,
+      filename: uploader.identifier
+    }
+  rescue CarrierWave::ProcessingError, CarrierWave::IntegrityError => e
+    Rails.logger.error("CarrierWave inline image error: #{e.message}")
+    { success: false, error: "Invalid image file" }
+  rescue StandardError => e
+    Rails.logger.error("Inline image processing error: #{e.message}")
+    { success: false, error: "Error processing image" }
+  end
+
+  private
+
+  def valid_image_file_type?(file)
+    SUPPORTED_CONTENT_TYPES.include?(file.content_type)
+  end
+
+  def image_file_too_large?(file)
+    file.size > IMAGE_MAX_SIZE
+  end
+
+  def inline_image_uploader_class
+    raise NotImplementedError, "including class must define #inline_image_uploader_class"
+  end
+end

data/app/models/concerns/postnhost/page/image_uploadable.rb

@@ -0,0 +1,11 @@
+module Postnhost::Page::ImageUploadable
+  extend ActiveSupport::Concern
+
+  include Postnhost::InlineImageUploadable
+
+  private
+
+  def inline_image_uploader_class
+    Postnhost::InlinePageImageUploader
+  end
+end

data/app/models/concerns/postnhost/primary_language_guard.rb

@@ -0,0 +1,18 @@
+module Postnhost
+  module PrimaryLanguageGuard
+    extend ActiveSupport::Concern
+
+    included do
+      validate :primary_language_must_not_duplicate_a_variant
+    end
+
+    private
+
+    def primary_language_must_not_duplicate_a_variant
+      return if language_id.blank?
+      return unless translation_variants.exists?(language_id: language_id)
+
+      errors.add(:language_id, "cannot duplicate an existing translation")
+    end
+  end
+end

data/app/models/concerns/postnhost/public_revision_touch.rb

@@ -0,0 +1,15 @@
+module Postnhost
+  module PublicRevisionTouch
+    extend ActiveSupport::Concern
+
+    included do
+      after_commit :bump_public_site_revision
+    end
+
+    private
+
+    def bump_public_site_revision
+      Postnhost::PublicSiteRevision.bump!
+    end
+  end
+end

data/app/models/concerns/postnhost/schema_localizable.rb

@@ -0,0 +1,28 @@
+module Postnhost
+  module SchemaLocalizable
+    extend ActiveSupport::Concern
+
+    def schema_locale_overrides_hash
+      schema_locale_overrides.is_a?(Hash) ? schema_locale_overrides.deep_stringify_keys : {}
+    end
+
+    def schema_translations_for(locale)
+      schema_locale_overrides_hash.fetch(locale.to_s, {})
+    end
+
+    def schema_text_for(locale:, key:, fallback:)
+      field = key.to_s
+      value = schema_translations_for(locale)[field].presence
+      return value if value.present?
+
+      default_locale_value = schema_translations_for(schema_default_locale_key)[field].presence
+      return default_locale_value if default_locale_value.present?
+
+      fallback
+    end
+
+    def schema_default_locale_key
+      @schema_default_locale_key ||= Postnhost::Language.find_by(default: true)&.html_lang.presence || I18n.default_locale.to_s
+    end
+  end
+end

data/app/models/postnhost/application_record.rb

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