postnhost 0.0.0 → 0.1.1

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,55 @@
+module Postnhost
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      DEFAULT_MOUNT_PATH = "/blog"
+
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Creates the 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 your app:"
+        say "     #{DEFAULT_MOUNT_PATH}/onboarding"
+        say "     Or create a CMS user interactively: bin/rails g postnhost:user"
+        say ""
+        say "  3. Review config/initializers/postnhost.rb for optional defaults, production uploads, and AI translations."
+        say ""
+        say "  4. (Optional) Customize public views:"
+        say "     bin/rails g postnhost:views --views-scope=minimal"
+        say "     or"
+        say "     bin/rails g postnhost:views --views-scope=full"
+        say ""
+        say "  5. (Optional) Enable host Tailwind support for custom PostnHost classes:"
+        say "     bin/rails g postnhost:tailwindcss:install"
+        say ""
+        say "  6. (Optional) Add a new public locale (copy English strings into your app):"
+        say "     bin/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 the 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. bin/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,100 @@
+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 support for PostnHost view overrides."
+
+        def create_stylesheet_directory
+          empty_directory "app/assets/stylesheets/postnhost"
+        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?
+
+          @package_json_present = true
+
+          json_data = JSON.parse(File.read(path))
+          json_data["scripts"] ||= {}
+          json_data["devDependencies"] ||= {}
+
+          json_data["scripts"]["postnhost:tailwindcss"] = "bundle exec rails postnhost:tailwindcss:build"
+          json_data["scripts"]["postnhost:tailwindcss:watch"] = "bundle exec rails postnhost:tailwindcss: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 with PostnHost Tailwind scripts and dependencies.", :green
+        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 the PostnHost watcher.", :green
+            else
+              append_to_file path, "\n#{entry}\n"
+              say "Added the PostnHost watcher to Procfile.dev.", :green
+            end
+          else
+            create_file "Procfile.dev", "#{entry}\n"
+            say "Created Procfile.dev with the PostnHost watcher.", :green
+          end
+        end
+
+        def print_next_steps
+          say ""
+          say "PostnHost host Tailwind support installed.", :green
+          say "Next steps:"
+          step = 1
+
+          if @package_json_present
+            say "  #{step}. Install dependencies with the JavaScript package manager used by this app."
+            step += 1
+          end
+
+          if Rails.root.join("bin/dev").exist?
+            say "  #{step}. Run bin/dev; the PostnHost watcher is wired in Procfile.dev."
+          else
+            say "  #{step}. Run bin/rails postnhost:tailwindcss:watch alongside your Rails server."
+          end
+
+          say "  #{step + 1}. Use normal Tailwind classes in copied PostnHost views."
+          say "  #{step + 2}. Keep the default layout tags; the combined build overrides postnhost/application automatically."
+          say ""
+        end
+
+        private
+
+        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 a Tailwind CSS 4 compiler to the host Gemfile:", :yellow
+          say '  gem "tailwindcss-ruby", "~> 4.0"'
+          say "Then run bundle install."
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,4 @@
+@source "../../../views/postnhost/**/*.erb";
+@source "../../../views/layouts/postnhost/**/*.erb";
+@source "../../../helpers/**/*.rb";
+@source "../../../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,140 @@
+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 views_scope == "full" ? "All public templates and layouts were copied." : "The minimal public view set was copied.", :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 Tailwind support:", :yellow
+        say "  bin/rails g postnhost:tailwindcss:install"
+        say ""
+      end
+
+      def host_tailwind_enabled?
+        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/css_build.rb

@@ -0,0 +1,68 @@
+require "English"
+require "fileutils"
+
+require_relative "css_scope"
+
+module Postnhost
+  class CssBuild
+    POLL_INTERVAL = 0.1
+
+    class << self
+      def run(command:, unscoped_path:, output_path:, watch: false)
+        FileUtils.rm_f(unscoped_path)
+
+        if watch
+          watch(command:, unscoped_path:, output_path:)
+        else
+          system(*command, exception: true)
+          CssScope.scope_file(unscoped_path, output_path)
+        end
+      ensure
+        FileUtils.rm_f(unscoped_path)
+      end
+
+      private
+
+      def watch(command:, unscoped_path:, output_path:)
+        process_id = Process.spawn(*command)
+        applied_signature = nil
+        pending_signature = nil
+
+        loop do
+          process_status = Process.waitpid(process_id, Process::WNOHANG)
+          signature = file_signature(unscoped_path)
+
+          if signature && signature == pending_signature && signature != applied_signature
+            CssScope.scope_file(unscoped_path, output_path)
+            applied_signature = signature
+          end
+
+          pending_signature = signature
+          break if process_status
+
+          sleep POLL_INTERVAL
+        end
+
+        raise "Tailwind CSS watcher exited unsuccessfully" unless $CHILD_STATUS.success?
+      ensure
+        terminate(process_id)
+      end
+
+      def file_signature(path)
+        return unless File.exist?(path)
+
+        stat = File.stat(path)
+        [stat.mtime.to_f, stat.size]
+      end
+
+      def terminate(process_id)
+        return unless process_id
+
+        Process.kill("TERM", process_id)
+        Process.wait(process_id)
+      rescue Errno::ESRCH, Errno::ECHILD
+        nil
+      end
+    end
+  end
+end