postnhost 0.0.0 → 0.1.0

data/db/migrate/20260726130000_create_site_scripts.rb

@@ -0,0 +1,11 @@
+class CreateSiteScripts < ActiveRecord::Migration[7.2]
+  def change
+    create_table :postnhost_site_scripts do |t|
+      t.references :setting, null: false, foreign_key: { to_table: :postnhost_settings }
+      t.string :placement, null: false
+      t.text :script
+
+      t.timestamps
+    end
+  end
+end

data/lib/generators/postnhost/install/install_generator.rb

@@ -0,0 +1,56 @@
+module Postnhost
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      DEFAULT_MOUNT_PATH = "/blog"
+
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Creates Postnhost initializer and mounts the engine"
+
+      def create_initializer
+        template "postnhost.rb", "config/initializers/postnhost.rb"
+      end
+
+      def create_carrierwave_initializer
+        return if File.exist?("config/initializers/carrierwave.rb")
+
+        template "carrierwave.rb", "config/initializers/carrierwave.rb"
+      end
+
+      def mount_engine
+        route "mount Postnhost::Engine, at: \"#{DEFAULT_MOUNT_PATH}\""
+      end
+
+      def show_post_install
+        say ""
+        say "=" * 60
+        say "Postnhost has been installed!", :green
+        say "=" * 60
+        say ""
+        say "Next steps:"
+        say "  1. Run migrations:"
+        say "     bin/rails postnhost:install:migrations"
+        say "     bin/rails db:migrate"
+        say ""
+        say "  2. Open first-time setup in the browser:"
+        say "     http://localhost:3000#{DEFAULT_MOUNT_PATH}/onboarding"
+        say "     Or create a CMS user interactively: bin/rails g postnhost:user"
+        say ""
+        say "  3. Update config/initializers/postnhost.rb with your site settings."
+        say ""
+        say "  4. (Optional) Customize public views:"
+        say "     rails g postnhost:views --views-scope=minimal"
+        say "     # or"
+        say "     rails g postnhost:views --views-scope=full"
+        say ""
+        say "  5. (Optional) Enable host Tailwind pipeline for custom Postnhost classes:"
+        say "     rails g postnhost:tailwindcss:install"
+        say "     bundle exec rails postnhost:tailwindcss:watch"
+        say ""
+        say "  6. (Optional) Add a new public locale (copy English strings into your app):"
+        say "     rails g postnhost:locale sv"
+        say ""
+      end
+    end
+  end
+end

data/lib/generators/postnhost/install/templates/carrierwave.rb

@@ -0,0 +1,17 @@
+CarrierWave.configure do |config|
+  if Rails.env.production?
+    config.storage = :aws
+    config.aws_bucket = Postnhost.config.aws_bucket
+    config.aws_acl = "public-read"
+
+    config.aws_credentials = {
+      access_key_id: Postnhost.config.aws_access_key_id,
+      secret_access_key: Postnhost.config.aws_secret_access_key,
+      region: Postnhost.config.aws_region,
+      endpoint: Postnhost.config.aws_endpoint_url_s3,
+      stub_responses: Rails.env.test?
+    }
+  else
+    config.storage = :file
+  end
+end

data/lib/generators/postnhost/install/templates/postnhost.rb

@@ -0,0 +1,36 @@
+Postnhost.configure do |config|
+  # ==> Site defaults
+  # Used when the matching Dashboard → Settings → Site field is blank.
+  # config.site_url = "https://example.com"
+  # config.public_page_size = 12
+
+  # ==> Integrations
+  # Default admin timezone used for scheduling and timestamp display
+  # config.default_timezone = 'UTC'
+
+  # OpenAI API key for AI translations.
+  # Explicit config value takes priority over credentials fallback.
+  # config.openai_api_key = "sk-..."
+  # config.openai_gpt_model = "gpt-5.6-luna"
+
+  # ==> AWS/S3 (CarrierWave uploads)
+  # Explicit config values take priority over credentials fallback:
+  # config.aws_access_key_id = "AKIA..."
+  # config.aws_secret_access_key = "..."
+  # config.aws_region = "us-east-1"
+  # config.aws_bucket = "my-bucket"
+  # config.aws_endpoint_url_s3 = "https://fly.storage.tigris.dev"
+  #
+  # Encrypted credentials (alternative to explicit settings):
+  #   postnhost:
+  #     openai_access_token: sk-...
+  #     openai_gpt_model: gpt-5.6-luna
+  #     aws_access_key_id: AKIA...
+  #     aws_secret_access_key: ...
+  #     aws_region: us-east-1
+  #     aws_bucket_name: my-bucket
+  #     aws_endpoint_url_s3: https://fly.storage.tigris.dev
+  #
+  # Litestream (SQLite backups) is not configured here — use host app
+  # config/initializers/litestream.rb + credentials (see engine README).
+end

data/lib/generators/postnhost/locale/locale_generator.rb

@@ -0,0 +1,36 @@
+require "yaml"
+
+module Postnhost
+  module Generators
+    class LocaleGenerator < Rails::Generators::Base
+      argument :locale, type: :string, desc: "Locale code to match Language#html_lang (e.g. sv, pt-BR)"
+
+      desc "Copies Postnhost English locale (en.yml) to config/locales/<locale>.yml in your app for translation."
+
+      def copy_postnhost_locale
+        code = locale.to_s.strip
+        raise Thor::Error, "Locale cannot be blank." if code.blank?
+        raise Thor::Error, "Invalid locale #{code.inspect} (use letters, numbers, hyphen, underscore, dot)." unless code.match?(/\A[a-zA-Z0-9_.-]+\z/)
+
+        destination = File.join("config/locales", "#{code}.yml")
+        if File.exist?(destination)
+          say_status :skip, "#{destination} already exists", :yellow
+          return
+        end
+
+        source_path = Postnhost::Engine.root.join("config/locales/en.yml")
+        en_tree = YAML.load_file(source_path)["en"]
+        raise Thor::Error, "Could not find `en` root key in #{source_path}" unless en_tree
+
+        header = <<~TXT
+          # Postnhost public UI translations for "#{code}".
+          # Generated by: bin/rails g postnhost:locale #{code}
+          # Translate values under postnhost.public, then add "#{code}" to config.i18n.available_locales if needed.
+
+        TXT
+
+        create_file destination, header + YAML.dump({ code => en_tree })
+      end
+    end
+  end
+end

data/lib/generators/postnhost/static_pages/static_pages_generator.rb

@@ -0,0 +1,47 @@
+module Postnhost
+  module Generators
+    class StaticPagesGenerator < Rails::Generators::Base
+      argument :slugs, type: :array, default: [], banner: "slug [slug ...]"
+
+      desc "Creates static page templates in app/views/postnhost/static_pages"
+
+      def create_static_pages
+        if slugs.empty?
+          say("Please provide at least one page slug, e.g. rails g postnhost:static_pages terms privacy", :red)
+          return
+        end
+
+        slugs.each do |raw_slug|
+          slug = raw_slug.to_s.strip
+          unless valid_slug?(slug)
+            say("Skipping invalid slug '#{raw_slug}'. Use lowercase letters, numbers, underscores, or hyphens.", :yellow)
+            next
+          end
+
+          title = slug.tr("_-", " ").split.map(&:capitalize).join(" ")
+          create_file "app/views/postnhost/static_pages/#{slug}.html.erb", static_page_template(slug, title)
+        end
+      end
+
+      private
+
+      def valid_slug?(slug)
+        slug.match?(/\A[a-z0-9_-]+\z/)
+      end
+
+      def static_page_template(slug, title)
+        <<~ERB
+          <% content_for :title, "#{title}" %>
+          <% content_for :meta_description, "#{title} page" %>
+
+          <div class="max-w-4xl mx-auto px-4 py-12">
+            <h1 class="text-3xl font-bold text-gray-900 mb-4">#{title}</h1>
+            <p class="text-gray-700">
+              Replace this template content in <code>app/views/postnhost/static_pages/#{slug}.html.erb</code>.
+            </p>
+          </div>
+        ERB
+      end
+    end
+  end
+end

data/lib/generators/postnhost/tailwindcss/install_generator.rb

@@ -0,0 +1,97 @@
+require "json"
+
+module Postnhost
+  module Generators
+    module Tailwindcss
+      class InstallGenerator < Rails::Generators::Base
+        source_root File.expand_path("templates", __dir__)
+
+        namespace "postnhost:tailwindcss:install"
+        desc "Install host Tailwind pipeline for Postnhost view overrides."
+
+        def create_stylesheet_directory
+          empty_directory "app/assets/stylesheets/postnhost"
+        end
+
+        def create_tailwind_config
+          path = Rails.root.join("postnhost.tailwind.config.js")
+          return if path.exist?
+
+          copy_file "tailwind.config.js", path
+        end
+
+        def create_host_stylesheet
+          path = Rails.root.join("app/assets/stylesheets/postnhost/host.tailwind.css")
+          return if path.exist?
+
+          copy_file "host.tailwind.css", path
+        end
+
+        def update_package_json
+          path = Rails.root.join("package.json")
+          return say_package_json_instructions unless path.exist?
+
+          json_data = JSON.parse(File.read(path))
+          json_data["scripts"] ||= {}
+          json_data["devDependencies"] ||= {}
+
+          json_data["scripts"]["postnhost:tailwindcss"] = tailwind_build_command
+          json_data["scripts"]["postnhost:tailwindcss:watch"] = "#{tailwind_build_command} --watch"
+
+          ensure_dependency(json_data, "tailwindcss", "^4.1.12")
+          ensure_dependency(json_data, "@tailwindcss/cli", "^4.1.12")
+          ensure_dependency(json_data, "@tailwindcss/typography", "^0.5.16")
+
+          File.write(path, "#{JSON.pretty_generate(json_data)}\n")
+
+          say "Updated package.json script:", :green
+          say "  yarn postnhost:tailwindcss:watch"
+        end
+
+        def wire_procfile_dev
+          path = Rails.root.join("Procfile.dev")
+          entry = "postnhost_css: bundle exec rails postnhost:tailwindcss:watch"
+
+          if path.exist?
+            if File.read(path).include?("postnhost:tailwindcss:watch")
+              say "Procfile.dev already includes Postnhost watcher.", :green
+            else
+              append_to_file path, "\n#{entry}\n"
+              say "Added Postnhost watcher to Procfile.dev.", :green
+            end
+          else
+            create_file "Procfile.dev", "#{entry}\n"
+            say "Created Procfile.dev with Postnhost watcher.", :green
+          end
+        end
+
+        def print_next_steps
+          say ""
+          say "Postnhost host-tailwind mode installed.", :green
+          say "Next steps:"
+          say "  1. Run bin/dev (Postnhost watcher is wired in Procfile.dev)."
+          say "  2. Keep default layout tags; Postnhost auto-loads postnhost/host when config is present."
+          say ""
+        end
+
+        private
+
+        def tailwind_build_command
+          "./node_modules/.bin/tailwindcss -i ./app/assets/stylesheets/postnhost/host.tailwind.css -o ./app/assets/builds/postnhost/host.css -c ./postnhost.tailwind.config.js --minify"
+        end
+
+        def ensure_dependency(json_data, package_name, version)
+          return if json_data["dependencies"]&.key?(package_name) || json_data["devDependencies"].key?(package_name)
+
+          json_data["devDependencies"][package_name] = version
+        end
+
+        def say_package_json_instructions
+          say "package.json not found. Add these scripts manually:", :yellow
+          say "  \"postnhost:tailwindcss\": \"#{tailwind_build_command}\""
+          say "  \"postnhost:tailwindcss:watch\": \"#{tailwind_build_command} --watch\""
+        end
+      end
+    end
+  end
+end

data/lib/generators/postnhost/tailwindcss/templates/host.tailwind.css

@@ -0,0 +1,7 @@
+@import "tailwindcss";
+@plugin "@tailwindcss/typography";
+
+@source "../../../views/postnhost/**/*.erb";
+@source "../../../views/layouts/postnhost/**/*.erb";
+@source "../../../helpers/**/*.rb";
+@source "../../../javascript/**/*.js";

data/lib/generators/postnhost/tailwindcss/templates/tailwind.config.js

@@ -0,0 +1,8 @@
+module.exports = {
+  content: [
+    "./app/views/postnhost/**/*.erb",
+    "./app/views/layouts/postnhost/**/*.erb",
+    "./app/helpers/**/*.rb",
+    "./app/javascript/**/*.js"
+  ]
+}

data/lib/generators/postnhost/user/user_generator.rb

@@ -0,0 +1,36 @@
+module Postnhost
+  module Generators
+    class UserGenerator < Rails::Generators::Base
+      desc "Interactively creates a Postnhost CMS user"
+
+      def create_user
+        attributes = prompt_for_user_attributes
+        raise Thor::Error, "Passwords do not match." unless matching_passwords?(attributes)
+
+        user = Postnhost::User.new(attributes)
+        raise Thor::Error, user.errors.full_messages.to_sentence unless user.save
+
+        say("Created CMS user #{user.email}.", :green)
+      end
+
+      private
+
+      def prompt_for_user_attributes
+        {
+          name: ask("Name:"),
+          email: ask("Email:"),
+          password: ask_for_secret("Password:"),
+          password_confirmation: ask_for_secret("Confirm password:")
+        }
+      end
+
+      def ask_for_secret(prompt)
+        ask(prompt, echo: false).tap { say "" }
+      end
+
+      def matching_passwords?(attributes)
+        attributes[:password] == attributes[:password_confirmation]
+      end
+    end
+  end
+end

data/lib/generators/postnhost/views/views_generator.rb

@@ -0,0 +1,142 @@
+module Postnhost
+  module Generators
+    class ViewsGenerator < Rails::Generators::Base
+      desc "Copies public Postnhost views to your application for customization"
+      class_option :views_scope,
+                   type: :string,
+                   required: true,
+                   enum: %w[minimal full],
+                   desc: "Choose copied view scope: minimal (clean style-focused views) or full (all views and helper partials)."
+
+      def copy_views
+        copy_public_views
+      end
+
+      private
+
+      def copy_public_views
+        say "Copying public views...", :green
+        copy_public_views_by_scope
+        copy_template_public_views
+        copy_public_template_layouts
+        copy_shared_content_for_partials
+        copy_full_scope_shared_public_partials
+        copy_file "layouts/postnhost/_footer.html.erb", "app/views/layouts/postnhost/_footer.html.erb"
+        copy_file "layouts/postnhost/_favicon.html.erb", "app/views/layouts/postnhost/_favicon.html.erb"
+        copy_file "layouts/postnhost/public_header/_logo.html.erb", "app/views/layouts/postnhost/public_header/_logo.html.erb"
+        copy_file "layouts/postnhost/public_header/_language_switcher.html.erb", "app/views/layouts/postnhost/public_header/_language_switcher.html.erb"
+        copy_file "layouts/postnhost/public_header/_dashboard_sign_in.html.erb", "app/views/layouts/postnhost/public_header/_dashboard_sign_in.html.erb"
+        say ""
+        warn_if_host_tailwind_not_installed
+        say "Public views copied (#{views_scope})! Full scope includes every public template and layout under app/views/postnhost/public/templates/ and app/views/layouts/postnhost/public/templates/.", :green
+      end
+
+      def engine_views_path
+        Postnhost::Engine.root.join("app/views")
+      end
+
+      def copy_public_views_by_scope
+        return copy_default_template_public_views if full_scope?
+
+        copy_minimal_public_views
+      end
+
+      def copy_full_scope_shared_public_partials
+        return unless full_scope?
+
+        copy_file "postnhost/shared/_seo_meta_tags.html.erb", "app/views/postnhost/shared/_seo_meta_tags.html.erb"
+        copy_file "postnhost/shared/_structured_data.html.erb", "app/views/postnhost/shared/_structured_data.html.erb"
+      end
+
+      def copy_minimal_public_views
+        default_template_public_view_mappings.each do |source_path, destination_path|
+          copy_file source_path, File.join("app/views", destination_path)
+        end
+      end
+
+      def copy_default_template_public_views
+        default_template_public_view_mappings.each do |source_path, destination_path|
+          copy_file source_path, File.join("app/views", destination_path)
+        end
+      end
+
+      def copy_template_public_views
+        return unless full_scope?
+
+        template_public_view_files.each do |relative_path|
+          copy_file relative_path, File.join("app/views", relative_path)
+        end
+      end
+
+      def copy_public_template_layouts
+        return unless full_scope?
+
+        public_template_layout_files.each do |relative_path|
+          copy_file relative_path, File.join("app/views", relative_path)
+        end
+      end
+
+      def copy_shared_content_for_partials
+        return unless full_scope?
+
+        shared_content_for_files.each do |relative_path|
+          copy_file relative_path, File.join("app/views", relative_path)
+        end
+      end
+
+      def default_template_public_view_mappings
+        Dir.glob(engine_views_path.join("postnhost/public/templates/default/**/*.erb")).map do |path|
+          source_path = Pathname.new(path).relative_path_from(engine_views_path).to_s
+          destination_path = source_path
+          [source_path, destination_path]
+        end
+      end
+
+      def shared_content_for_files
+        Dir.glob(engine_views_path.join("postnhost/public/**/content_for/**/*.erb")).map do |path|
+          Pathname.new(path).relative_path_from(engine_views_path).to_s
+        end
+      end
+
+      def template_public_view_files
+        template_files = Dir.glob(engine_views_path.join("postnhost/public/templates/**/*.erb")).map do |path|
+          Pathname.new(path).relative_path_from(engine_views_path).to_s
+        end
+
+        template_files.reject { |path| path.start_with?("postnhost/public/templates/default/") }
+      end
+
+      def public_template_layout_files
+        Dir.glob(engine_views_path.join("layouts/postnhost/public/templates/*.erb")).map do |path|
+          Pathname.new(path).relative_path_from(engine_views_path).to_s
+        end
+      end
+
+      def full_scope?
+        views_scope == "full"
+      end
+
+      def views_scope
+        options[:views_scope]
+      end
+
+      def warn_if_host_tailwind_not_installed
+        return if host_tailwind_enabled?
+
+        say "Tip: if you add new Tailwind classes in copied views, install host pipeline:", :yellow
+        say "  rails g postnhost:tailwindcss:install"
+        say "  bundle exec rails postnhost:tailwindcss:watch"
+        say ""
+      end
+
+      def host_tailwind_enabled?
+        Rails.root.join("postnhost.tailwind.config.js").exist? &&
+          Rails.root.join("app/assets/stylesheets/postnhost/host.tailwind.css").exist?
+      end
+
+      def source_paths
+        [engine_views_path.to_s]
+      end
+    end
+  end
+end

data/lib/postnhost/configuration.rb

@@ -0,0 +1,64 @@
+require "uri"
+
+module Postnhost
+  class Configuration
+    PUBLIC_PAGE_SIZE_RANGE = (1..100)
+
+    # Integrations
+    attr_accessor :openai_api_key, :openai_gpt_model, :default_timezone
+
+    # Site defaults
+    attr_reader :site_url, :public_page_size
+
+    # AWS/S3 Storage
+    attr_accessor :aws_access_key_id, :aws_secret_access_key,
+                  :aws_region, :aws_bucket, :aws_endpoint_url_s3
+
+    def initialize
+      # Integrations
+      @default_timezone = rails_default_timezone
+      @site_url = nil
+      @public_page_size = 12
+      @openai_api_key = credentials_dig(:postnhost, :openai_access_token)
+      @openai_gpt_model = credentials_dig(:postnhost, :openai_gpt_model)
+      # AWS/S3 (from Rails credentials)
+      @aws_access_key_id = credentials_dig(:postnhost, :aws_access_key_id)
+      @aws_secret_access_key = credentials_dig(:postnhost, :aws_secret_access_key)
+      @aws_region = credentials_dig(:postnhost, :aws_region)
+      @aws_bucket = credentials_dig(:postnhost, :aws_bucket_name)
+      @aws_endpoint_url_s3 = credentials_dig(:postnhost, :aws_endpoint_url_s3)
+    end
+
+    def site_url=(value)
+      if value.blank?
+        @site_url = nil
+        return
+      end
+
+      normalized_url = value.to_s.strip.chomp("/")
+      uri = URI.parse(normalized_url)
+      raise ArgumentError, "site_url must be an HTTP(S) origin without a path, query, or fragment" unless uri.is_a?(URI::HTTP) && uri.host.present? && uri.userinfo.nil? && uri.path.blank? && uri.query.nil? && uri.fragment.nil?
+
+      @site_url = normalized_url
+    rescue URI::InvalidURIError
+      raise ArgumentError, "site_url must be a valid URL"
+    end
+
+    def public_page_size=(value)
+      page_size = Integer(value, exception: false)
+      raise ArgumentError, "public_page_size must be an integer between 1 and 100" unless page_size && PUBLIC_PAGE_SIZE_RANGE.cover?(page_size)
+
+      @public_page_size = page_size
+    end
+
+    private
+
+    def credentials_dig(*keys)
+      Rails.application.credentials.dig(*keys)
+    end
+
+    def rails_default_timezone
+      Rails.application.config.time_zone.presence || "UTC"
+    end
+  end
+end

data/lib/postnhost/engine.rb

@@ -0,0 +1,57 @@
+module Postnhost
+  class Engine < ::Rails::Engine
+    isolate_namespace Postnhost
+
+    # Initialize configuration before other initializers
+    initializer "postnhost.configuration", before: :load_config_initializers do
+      Postnhost.configure
+    end
+
+    initializer "postnhost.yaml_column_permitted_classes" do |app|
+      permitted_classes = app.config.active_record.yaml_column_permitted_classes ||= []
+      [
+        ActiveSupport::TimeWithZone,
+        ActiveSupport::TimeZone,
+        Time,
+        Date,
+        Symbol
+      ].each do |klass|
+        permitted_classes << klass unless permitted_classes.include?(klass)
+      end
+    end
+
+    initializer "postnhost.i18n_patch" do
+      I18n.backend.singleton_class.prepend(Postnhost::Settings::I18nPatch) unless I18n.backend.singleton_class.ancestors.include?(Postnhost::Settings::I18nPatch)
+    end
+
+    # Asset pipeline configuration (Sprockets + Propshaft compatible)
+    initializer "postnhost.assets" do |app|
+      if app.config.respond_to?(:assets)
+        # For Propshaft: add builds directory so postnhost/application.css is found
+        # The path structure is: builds/postnhost/application.css
+        # When requesting "postnhost/application", Propshaft finds it in builds/
+        app.config.assets.paths << Engine.root.join("app", "assets", "builds").to_s
+        app.config.assets.paths << Engine.root.join("app", "assets", "images").to_s
+
+        # For Sprockets: programmatically add all assets to precompile
+        if defined?(::Sprockets)
+          asset_paths = [
+            %w[app assets builds postnhost],
+            %w[app assets images postnhost]
+          ]
+
+          paths_to_precompile = asset_paths.flat_map do |path|
+            Dir[Engine.root.join(*path, "**", "*")].filter_map do |file|
+              next unless File.file?(file)
+
+              Pathname.new(file).relative_path_from(Engine.root.join(*path)).to_s
+            end
+          end
+
+          app.config.assets.precompile += paths_to_precompile
+          app.config.assets.precompile += %w[postnhost_manifest.js]
+        end
+      end
+    end
+  end
+end