helios-press 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e3b7ae24fbb56776cc12ecba0e5c5f8c4fe86add758aceeddf4a2556233f65ad
+  data.tar.gz: 27ec84d4133ac49444df9b70f145214e1c57757f8098e19af4d3261271a08eef
+SHA512:
+  metadata.gz: d0224ef4872b8727d78d1dc9e1aba083b254bf6380a0e1cf5ea5ffbd4b30a8903b1847253963620f7a2f84a4da93a621d31fba0a81b0297c7e70b9f68236fddb
+  data.tar.gz: 26d02bcc128f38ead744f8dacc50005caa749bb2f8da86249af09053aed2461766f32594e439242a4bf91765816dfcb6c5e3492d91281bf1d5a2a8a590c75b38

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright TODO: Write your name
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,122 @@
+# Helios::Press
+
+A Rails engine providing a WordPress-like block editor for blog posts. Supports text (ActionText), image stacks with configurable grid layouts, and video blocks (via helios-videos) with drag-to-reorder.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "helios-press"
+gem "helios-videos"  # Optional: enables video blocks
+```
+
+Then:
+
+```bash
+bundle install
+bin/rails helios_press:install:migrations
+bin/rails db:migrate
+```
+
+**Prerequisites:**
+- ActionText must be installed in your host app (`bin/rails action_text:install`)
+- ActiveStorage must be installed (`bin/rails active_storage:install`)
+
+## Configuration
+
+Create `config/initializers/helios_press.rb`:
+
+```ruby
+Helios::Press.configure do |config|
+  # Parent controller for admin views (must provide authentication)
+  config.admin_parent_controller = "Admin::BaseController"
+
+  # Optional slug prefix for posts
+  config.post_slug_prefix = nil  # e.g., "blog/" for /blog/my-post
+
+  # API authentication (for external post ingestion)
+  # Default: checks X-API-Key header against BLOG_INGEST_API_KEY env var
+  config.api_authentication = ->(controller) {
+    expected = ENV["BLOG_INGEST_API_KEY"]
+    provided = controller.request.headers["X-API-Key"]
+    unless expected.present? && ActiveSupport::SecurityUtils.secure_compare(expected, provided.to_s)
+      controller.render json: { error: "unauthorized" }, status: :unauthorized
+    end
+  }
+end
+```
+
+## Routes
+
+Mount the engine:
+
+```ruby
+mount Helios::Press::Engine, at: "/helios_press"
+```
+
+This provides:
+- **Admin UI**: `/helios_press/admin/posts` - Full block editor
+- **API**: `POST /helios_press/api/posts` - Ingest posts from external sources
+- **Public**: Define your own catch-all route pointing to `Helios::Press::PostsController#show`
+
+## JavaScript Setup
+
+Register the Stimulus controllers in your host app:
+
+```javascript
+import {
+  HeliosPressBlocksController,
+  HeliosPressTextBlockController,
+  HeliosPressImageBlockController
+} from "helios-press"
+
+application.register("helios-press-blocks", HeliosPressBlocksController)
+application.register("helios-press-text-block", HeliosPressTextBlockController)
+application.register("helios-press-image-block", HeliosPressImageBlockController)
+
+// If using helios-videos:
+import { HeliosVideoBlockController } from "helios-videos"
+application.register("helios-video-block", HeliosVideoBlockController)
+```
+
+**npm dependencies** (add to your host app's package.json):
+- `sortablejs`
+- `@hotwired/stimulus`
+- `@rails/activestorage`
+- `trix` and `@rails/actiontext`
+
+## CSS
+
+Include the block editor styles in your asset pipeline:
+
+```css
+/* In your application CSS */
+@import "helios/press/blocks";
+```
+
+## Block Types
+
+- **Text**: Rich text editing via ActionText. Double-click to edit, Save/Cancel buttons.
+- **Image Container**: Drag images to add. Configurable grid (1-6 images per row). Reorder by dragging. Click captions to edit.
+- **Video Container** (requires helios-videos): Drag a video file to create. Direct upload to S3, automatic processing via Mux/Cloudflare.
+
+## API Ingestion
+
+POST to `/helios_press/api/posts` with `X-API-Key` header:
+
+```json
+{
+  "external_id": "my-post-123",
+  "title": "My Post Title",
+  "slug": "my-post-title",
+  "description": "Meta description",
+  "keywords": "keyword1, keyword2",
+  "body_html": "<p>Post content...</p>",
+  "published": true
+}
+```
+
+## License
+
+Proprietary. All rights reserved.

data/Rakefile

@@ -0,0 +1,3 @@
+require "bundler/setup"
+
+require "bundler/gem_tasks"

data/app/assets/stylesheets/helios/press/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/assets/stylesheets/helios/press/blocks.css

@@ -0,0 +1,231 @@
+/* Helios Press - Block Editor Styles */
+
+.block-placeholder {
+  position: relative;
+  height: 16px;
+  margin: 16px 0;
+  cursor: pointer;
+  transition: all 0.2s ease;
+}
+
+.block-placeholder .placeholder-line {
+  position: absolute;
+  top: 50%;
+  left: 0;
+  right: 0;
+  height: 2px;
+  background-color: transparent;
+  transition: all 0.2s ease;
+  transform: translateY(-50%);
+}
+
+.block-placeholder:hover .placeholder-line,
+.block-placeholder.drag-over .placeholder-line {
+  height: 4px;
+  background-color: #0d6efd;
+  box-shadow: 0 0 8px rgba(13, 110, 253, 0.3);
+}
+
+.content-block {
+  position: relative;
+  background: white;
+  border: 1px solid #dee2e6;
+  border-radius: 0.375rem;
+  margin: 0 0 0 2.5rem;
+  padding: 1rem;
+  transition: box-shadow 0.2s ease;
+}
+
+.content-block:hover {
+  box-shadow: 0 0.125rem 0.25rem rgba(0, 0, 0, 0.075);
+}
+
+.content-block .drag-handle {
+  position: absolute;
+  left: -2.5rem;
+  top: 0.5rem;
+  cursor: grab;
+  color: #6c757d;
+  font-size: 1.25rem;
+  padding: 0.25rem;
+  transition: color 0.2s ease;
+}
+
+.content-block .drag-handle:active {
+  cursor: grabbing;
+}
+
+.content-block .drag-handle:hover {
+  color: #495057;
+}
+
+.content-block .block-content {
+  min-height: 50px;
+}
+
+.block-ghost {
+  opacity: 0.4;
+  background-color: #f8f9fa;
+}
+
+.block-dragging {
+  opacity: 0.8;
+  cursor: grabbing;
+}
+
+/* Block View/Edit Mode */
+.block-view-mode {
+  min-height: 50px;
+  padding: 0.5rem;
+  cursor: pointer;
+  border-radius: 0.25rem;
+  transition: background-color 0.2s ease;
+}
+
+.block-view-mode:hover {
+  background-color: #f8f9fa;
+}
+
+.block-view-mode p:last-child {
+  margin-bottom: 0;
+}
+
+.block-edit-mode trix-editor {
+  min-height: 100px;
+}
+
+/* Image Block */
+.image-block-container .images-grid {
+  display: grid;
+  grid-template-columns: repeat(var(--grid-columns, 3), 1fr);
+  gap: 1rem;
+  margin-bottom: 1rem;
+}
+
+.image-block-container .image-item {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.image-block-container .image-wrapper {
+  position: relative;
+  aspect-ratio: 1;
+  overflow: hidden;
+  border-radius: 0.375rem;
+  background-color: #f8f9fa;
+}
+
+.image-block-container .image-wrapper .block-image {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+
+.image-block-container .image-wrapper .image-delete {
+  position: absolute;
+  top: 0.5rem;
+  right: 0.5rem;
+  opacity: 0;
+  transition: opacity 0.2s ease;
+}
+
+.image-block-container .image-wrapper:hover .image-delete {
+  opacity: 1;
+}
+
+.image-block-container .image-caption .caption-view {
+  min-height: 1.5rem;
+  padding: 0.25rem 0.5rem;
+  cursor: pointer;
+  border-radius: 0.25rem;
+  font-size: 0.875rem;
+  color: #6c757d;
+  transition: background-color 0.2s ease;
+}
+
+.image-block-container .image-caption .caption-view:hover {
+  background-color: #f8f9fa;
+}
+
+.image-block-container .image-caption .caption-edit input {
+  font-size: 0.875rem;
+}
+
+.image-block-container .image-dropzone {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  aspect-ratio: 1;
+  padding: 1rem;
+  border: 2px dashed #dee2e6;
+  border-radius: 0.375rem;
+  background-color: #f8f9fa;
+  color: #6c757d;
+  cursor: pointer;
+  transition: all 0.2s ease;
+}
+
+.image-block-container .image-dropzone i {
+  font-size: 1.5rem;
+  margin-bottom: 0.25rem;
+}
+
+.image-block-container .image-dropzone p {
+  margin: 0;
+  font-size: 0.75rem;
+  text-align: center;
+}
+
+.image-block-container .image-dropzone:hover,
+.image-block-container .image-dropzone.drag-over {
+  border-color: #0d6efd;
+  background-color: rgba(13, 110, 253, 0.05);
+  color: #0d6efd;
+}
+
+.image-ghost {
+  opacity: 0.4;
+}
+
+/* Public Post View */
+.post {
+  max-width: 800px;
+  margin: 0 auto;
+}
+
+.post .post-header {
+  border-bottom: 2px solid #dee2e6;
+  padding-bottom: 1.5rem;
+}
+
+.post .post-header h1 {
+  font-weight: 700;
+  line-height: 1.2;
+}
+
+.post .post-content .text-block {
+  font-size: 1.125rem;
+  line-height: 1.75;
+  color: #212529;
+}
+
+.post .post-content .image-block .images-grid {
+  display: grid;
+  grid-template-columns: repeat(var(--grid-columns, 3), 1fr);
+  gap: 1.5rem;
+}
+
+.post .post-content .image-block .images-grid .image-item img {
+  width: 100%;
+  height: auto;
+  object-fit: cover;
+}
+
+.post .post-content .image-block .images-grid .image-item .image-caption {
+  font-size: 0.875rem;
+  font-style: italic;
+  text-align: center;
+}

data/app/controllers/helios/press/admin/base_controller.rb

@@ -0,0 +1,9 @@
+module Helios
+  module Press
+    module Admin
+      class BaseController < ::ApplicationController
+        layout "helios/press/admin"
+      end
+    end
+  end
+end

data/app/controllers/helios/press/admin/block_images_controller.rb

@@ -0,0 +1,75 @@
+module Helios
+  module Press
+    module Admin
+      class BlockImagesController < Helios::Press::Admin::BaseController
+        before_action :set_post
+        before_action :set_block
+        before_action :set_block_image, only: [:update, :destroy]
+
+        def create
+          position = @block.block_images.maximum(:position).to_i + 1
+          @block_image = @block.block_images.build(block_image_params)
+          @block_image.position = position
+
+          if @block_image.save
+            respond_to do |format|
+              format.turbo_stream do
+                render turbo_stream: turbo_stream.replace(
+                  "block-#{@block.id}",
+                  partial: "helios/press/admin/blocks/block",
+                  locals: { block: @block.reload, post: @post }
+                )
+              end
+            end
+          else
+            head :unprocessable_entity
+          end
+        end
+
+        def update
+          if @block_image.update(block_image_params)
+            head :ok
+          else
+            head :unprocessable_entity
+          end
+        end
+
+        def destroy
+          position = @block_image.position
+          @block_image.destroy
+
+          @block.block_images.where("position > ?", position).update_all("position = position - 1")
+
+          head :ok
+        end
+
+        def reorder
+          image_ids = params[:image_ids]
+          image_ids.each_with_index do |image_id, index|
+            @block.block_images.find(image_id).update_column(:position, index)
+          end
+
+          head :ok
+        end
+
+        private
+
+        def set_post
+          @post = Post.find(params[:post_id])
+        end
+
+        def set_block
+          @block = @post.blocks.find(params[:block_id])
+        end
+
+        def set_block_image
+          @block_image = @block.block_images.find(params[:id])
+        end
+
+        def block_image_params
+          params.require(:block_image).permit(:file, :caption)
+        end
+      end
+    end
+  end
+end

data/app/controllers/helios/press/admin/blocks_controller.rb

@@ -0,0 +1,103 @@
+module Helios
+  module Press
+    module Admin
+      class BlocksController < Helios::Press::Admin::BaseController
+        before_action :set_post
+        before_action :set_block, only: [:update, :destroy]
+
+        def create
+          target_position = block_params[:position].to_i
+
+          # Shift positions of blocks at and after the new position
+          @post.blocks.where("position >= ?", target_position).update_all("position = position + 1")
+
+          @block = @post.blocks.build(block_params.except(:position))
+          @block.position = target_position
+
+          if @block.save
+            # Handle image uploads for image_container blocks
+            if @block.image_container? && params[:images].present?
+              params[:images].each do |key, image_data|
+                file = image_data[:file]
+                next unless file.present?
+
+                position = key.to_i
+                block_image = @block.block_images.build(position: position)
+                block_image.file.attach(file)
+                block_image.save!
+              end
+            end
+
+            # Handle video upload for video_container blocks (when helios-videos is present)
+            if @block.video_container? && params[:video_signed_id].present? && Helios::Press.videos_enabled?
+              video = Helios::Videos::Video.new(name: params[:video_name], block: @block)
+              video.video_file.attach(params[:video_signed_id])
+              video.save!
+            end
+
+            respond_to do |format|
+              format.turbo_stream do
+                render turbo_stream: turbo_stream.replace(
+                  "blocks-container",
+                  partial: "helios/press/admin/posts/blocks_container",
+                  locals: { post: @post.reload }
+                )
+              end
+            end
+          else
+            head :unprocessable_entity
+          end
+        end
+
+        def update
+          if @block.update(block_params)
+            respond_to do |format|
+              format.turbo_stream do
+                render turbo_stream: turbo_stream.replace(
+                  "block-#{@block.id}",
+                  partial: "helios/press/admin/blocks/block",
+                  locals: { block: @block, post: @post }
+                )
+              end
+              format.html { head :ok }
+            end
+          else
+            head :unprocessable_entity
+          end
+        end
+
+        def destroy
+          position = @block.position
+          @block.destroy
+
+          @post.blocks.where("position > ?", position).update_all("position = position - 1")
+
+          head :ok
+        end
+
+        def reorder
+          block_ids = params[:block_ids]
+          block_ids.each_with_index do |block_id, index|
+            @post.blocks.find(block_id).update_column(:position, index)
+          end
+
+          head :ok
+        end
+
+        private
+
+        def set_post
+          @post = Post.find(params[:post_id])
+        end
+
+        def set_block
+          @block = @post.blocks.find(params[:id])
+        end
+
+        def block_params
+          params.require(:block).permit(:block_type, :position, :content, :columns)
+        end
+      end
+    end
+  end
+end

data/app/controllers/helios/press/admin/posts_controller.rb

@@ -0,0 +1,72 @@
+module Helios
+  module Press
+    module Admin
+      class PostsController < Helios::Press::Admin::BaseController
+        before_action :set_post, only: [:edit, :update, :destroy]
+
+        def index
+          @posts = Post.reverse_sorted
+
+          if params[:search].present?
+            search_term = "%#{params[:search]}%"
+            @posts = @posts.where("name ILIKE ? OR keywords ILIKE ?", search_term, search_term)
+          end
+
+          @posts = @posts.order(created_at: :desc)
+        end
+
+        def new
+          @post = Post.new
+        end
+
+        def create
+          @post = Post.new(post_params)
+
+          if @post.save
+            redirect_to helios_press.edit_admin_post_path(@post), notice: "Post was successfully created."
+          else
+            render :new, status: :unprocessable_entity
+          end
+        end
+
+        def edit
+        end
+
+        def update
+          if params[:publish].present?
+            update_params = post_params.merge(published: true)
+            success_message = "Post was successfully published."
+          else
+            update_params = post_params
+            success_message = "Post was successfully updated."
+          end
+
+          if @post.update(update_params)
+            redirect_to helios_press.edit_admin_post_path(@post), notice: success_message
+          else
+            render :edit, status: :unprocessable_entity
+          end
+        end
+
+        def destroy
+          @post.destroy
+          redirect_to helios_press.admin_posts_path, notice: "Post was successfully deleted."
+        end
+
+        private
+
+        def set_post
+          @post = Post.find(params[:id])
+        end
+
+        def post_params
+          params.require(:post).permit(:name, :published, :slug, :keywords, :description)
+        end
+
+        def helios_press
+          Helios::Press::Engine.routes.url_helpers
+        end
+      end
+    end
+  end
+end

data/app/controllers/helios/press/api/base_controller.rb

@@ -0,0 +1,25 @@
+module Helios
+  module Press
+    module Api
+      class BaseController < ActionController::API
+        before_action :authenticate_ingest!
+
+        private
+
+        def authenticate_ingest!
+          auth_proc = Helios::Press.configuration.api_authentication
+          if auth_proc
+            auth_proc.call(self)
+          else
+            # Default: check X-API-Key header against BLOG_INGEST_API_KEY env var
+            expected = ENV["BLOG_INGEST_API_KEY"]
+            provided = request.headers["X-API-Key"]
+            return if expected.present? && ActiveSupport::SecurityUtils.secure_compare(expected, provided.to_s)
+
+            render json: { error: "unauthorized" }, status: :unauthorized
+          end
+        end
+      end
+    end
+  end
+end