pressroom 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f4713e4ba3f3eaae896ab1ad8b152749fa9c0be2a66cf11210a57fd43ba5c2d7
-  data.tar.gz: cde078d6ebe1273874c9da4610b92866489f163e8b5fbeb4cd6feb1e58177640
+  metadata.gz: 12fe77175ce5888714de37ba6c8e8cd10515eb641a26e37e72514a7b68f2d3fd
+  data.tar.gz: 718322e16e261511549bf9367bc1ba7bf0aa81996dbbd6393febd52d2453a60d
 SHA512:
-  metadata.gz: f712eaa9e76b6ffa4bdab60c5fb14e09d2609872d4fdbe2dd5ab8e7e7f247684a4cee01a8de66b3771fbac532381fcf2750fbfde534954ecfc8bbff5d84e2986
-  data.tar.gz: 37524af128ab5f3d6f27516a41d51a1a5e52086396d3f3f169acf574f981364e20f191b8e0929803acdf0fcf43292d4b3e6c549f0c1ae129ecb069c2ed121d31
+  metadata.gz: 1aef309f2b3a93f37ea6a94939490aefd9e9f39dfe80bd0589cbbb0daaf82828d9df914ec2289d2b9dd643a00f1ded9d5da726fbc208c96849d51b539898ad4b
+  data.tar.gz: fd1d8f777bff8723a11e4da697e1b9724c146d0c0bf15eb76d1b9eb536586483a5737211da721ce82866d8ee027e087b70a624a45b9ba906a7c2526b24ffc48a

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.1.1
+
+- Publications: posts, categories and tags may belong to an owner, so one
+  application can host several separate blogs. Slugs are unique within a
+  publication rather than globally, which is what lets two of them each
+  have a `hello-world`.
+- `Pressroom.with_scope` and `Post.in_scope` for working inside one
+  publication, and a `config.current_scope` hook so the admin knows which
+  one it is looking at.
+- Nothing changes for an application with a single blog. Existing rows get
+  the empty scope, which means exactly what they meant before, and an
+  install that never configures `current_scope` behaves as it did in 0.1.0.
+
+  The empty scope is stored as `""` and `0` rather than nulls on purpose:
+  Postgres treats two nulls as distinct, so a nullable pair in the unique
+  index would have let two posts share a slug in the unscoped publication.
+
 ## 0.1.0
 
 First release.

data/README.md

@@ -45,6 +45,36 @@ Pressroom.configure do |config|
 end
 ```
 
+## Several publications in one application
+
+By default an application has one blog and nothing below applies.
+
+To host more than one — a blog per customer site, say — tell Pressroom which
+publication the admin is looking at:
+
+```ruby
+Pressroom.configure do |config|
+  config.current_scope { current_user.website }
+end
+```
+
+Posts, categories and tags then belong to that owner, and slugs are unique
+within a publication rather than globally, so two of them may each have a
+`hello-world`.
+
+Outside the admin, work inside one publication explicitly:
+
+```ruby
+Pressroom.with_scope(website) do
+  Pressroom::Post.create!(title: "Hello")
+end
+
+Pressroom::Post.in_scope(website).published.recent
+```
+
+Existing installs need no changes: rows written before publications existed
+carry the empty scope, which is what `in_scope(nil)` returns.
+
 Pressroom **fails closed**: an admin with no `authenticate_with` hook raises
 rather than letting anyone in.
 

data/app/controllers/pressroom/application_controller.rb

@@ -11,9 +11,28 @@ module Pressroom
     layout "pressroom/admin"
 
     before_action :authenticate_pressroom_editor!
+    around_action :within_pressroom_scope
 
     private
 
+    # Everything the admin touches happens inside one publication. An install
+    # that never configures a scope keeps working exactly as before, because
+    # the resolved scope is then nil.
+    def within_pressroom_scope(&block)
+      Pressroom.with_scope(resolved_pressroom_scope, &block)
+    end
+
+    def resolved_pressroom_scope
+      hook = Pressroom.config.current_scope
+      hook ? instance_exec(&hook) : nil
+    end
+
+    # Records the admin may act on, narrowed to the publication in hand.
+    def pressroom_scoped(relation)
+      relation.in_scope(Pressroom.current_scope)
+    end
+    helper_method :pressroom_scoped
+
     def authenticate_pressroom_editor!
       hook = Pressroom.config.authenticate_with
 

data/app/controllers/pressroom/categories_controller.rb

@@ -5,7 +5,7 @@ module Pressroom
     before_action :set_category, only: %i[edit update destroy]
 
     def index
-      @categories = Category.order(:name)
+      @categories = pressroom_scoped(Category).order(:name)
     end
 
     def new
@@ -40,7 +40,7 @@ module Pressroom
     private
 
     def set_category
-      @category = Category.find(params[:id])
+      @category = pressroom_scoped(Category).find(params[:id])
     end
 
     def category_params

data/app/controllers/pressroom/posts_controller.rb

@@ -8,7 +8,7 @@ module Pressroom
       @page = [params[:page].to_i, 1].max
       @per_page = Pressroom.config.admin_per_page
 
-      scope = Post.includes(:category).recent
+      scope = pressroom_scoped(Post).includes(:category).recent
       scope = scope.where(status: params[:status]) if Post.statuses.key?(params[:status])
 
       @total = scope.count
@@ -65,7 +65,7 @@ module Pressroom
     private
 
     def set_post
-      @post = Post.find(params[:id])
+      @post = pressroom_scoped(Post).find(params[:id])
     end
 
     def requested_publish_time

data/app/controllers/pressroom/tags_controller.rb

@@ -5,7 +5,7 @@ module Pressroom
     before_action :set_tag, only: %i[edit update destroy]
 
     def index
-      @tags = Tag.left_joins(:taggings)
+      @tags = pressroom_scoped(Tag).left_joins(:taggings)
                  .group(:id)
                  .select("pressroom_tags.*, COUNT(pressroom_taggings.id) AS posts_count")
                  .order(:name)
@@ -29,7 +29,7 @@ module Pressroom
     private
 
     def set_tag
-      @tag = Tag.find(params[:id])
+      @tag = pressroom_scoped(Tag).find(params[:id])
     end
 
     def tag_params

data/app/models/concerns/pressroom/scoped.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Pressroom
+  # Belonging to one publication among several.
+  #
+  # An application that hosts a single blog never touches any of this: the
+  # empty scope is the default, and every query without an explicit scope
+  # behaves exactly as it did before publications existed.
+  module Scoped
+    extend ActiveSupport::Concern
+
+    NO_SCOPE_TYPE = ""
+    NO_SCOPE_ID = 0
+
+    included do
+      before_validation :apply_current_scope
+
+      scope :in_scope, lambda { |owner|
+        where(scope_type: Scoped.type_for(owner), scope_id: Scoped.id_for(owner))
+      }
+    end
+
+    class_methods do
+      # Where a new record lands when the caller says nothing.
+      def default_scope_owner = Pressroom.current_scope
+    end
+
+    def self.type_for(owner) = owner ? owner.class.polymorphic_name : NO_SCOPE_TYPE
+
+    def self.id_for(owner) = owner ? owner.id : NO_SCOPE_ID
+
+    def scope
+      return nil unless scoped?
+
+      scope_type.constantize.find_by(id: scope_id)
+    end
+
+    def scope=(owner)
+      self.scope_type = Scoped.type_for(owner)
+      self.scope_id = Scoped.id_for(owner)
+    end
+
+    def scoped?
+      scope_type.present? && scope_id.to_i.positive?
+    end
+
+    private
+
+    # Only fills in a scope the caller left alone, so an explicit one always
+    # wins over the ambient one.
+    def apply_current_scope
+      return if scoped?
+      return if scope_type_changed? || scope_id_changed?
+
+      self.scope = self.class.default_scope_owner
+    end
+  end
+end

data/app/models/concerns/pressroom/sluggable.rb

@@ -14,7 +14,9 @@ module Pressroom
 
     included do
       before_validation :assign_slug
-      validates :slug, presence: true, uniqueness: true
+      # Scoped to the publication: two blogs in one application may each have
+      # a post called "hello-world".
+      validates :slug, presence: true, uniqueness: { scope: %i[scope_type scope_id] }
     end
 
     class_methods do
@@ -57,10 +59,13 @@ module Pressroom
       candidate
     end
 
+    # Collisions only matter inside one publication, so the search is narrowed
+    # the same way the uniqueness validation is.
     def slug_taken?(candidate)
-      scope = self.class.where(slug: candidate)
-      scope = scope.where.not(id: id) if persisted?
-      scope.exists?
+      taken = self.class.where(slug: candidate)
+      taken = taken.where(scope_type: scope_type, scope_id: scope_id) if respond_to?(:scope_type)
+      taken = taken.where.not(id: id) if persisted?
+      taken.exists?
     end
   end
 end

data/app/models/pressroom/category.rb

@@ -2,6 +2,7 @@
 
 module Pressroom
   class Category < ApplicationRecord
+    include Pressroom::Scoped
     include Pressroom::Sluggable
 
     self.table_name = "pressroom_categories"

data/app/models/pressroom/post.rb

@@ -8,6 +8,7 @@ module Pressroom
 
     self.table_name = "pressroom_posts"
 
+    include Pressroom::Scoped
     include Pressroom::Sluggable
 
     attribute :content, :json, default: -> { EMPTY_DOCUMENT.deep_dup }

data/app/models/pressroom/tag.rb

@@ -2,6 +2,7 @@
 
 module Pressroom
   class Tag < ApplicationRecord
+    include Pressroom::Scoped
     include Pressroom::Sluggable
 
     self.table_name = "pressroom_tags"
@@ -18,7 +19,7 @@ module Pressroom
         .map { |name| name.to_s.strip }
         .reject(&:empty?)
         .uniq
-        .map { |name| find_or_create_by!(slug: slugify(name)) { |tag| tag.name = name } }
+        .map { |name| in_scope(default_scope_owner).find_or_create_by!(slug: slugify(name)) { |tag| tag.name = name } }
     end
 
     private

data/db/migrate/20260826000001_add_publication_scope_to_pressroom.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+# Lets one application host more than one publication.
+#
+# The empty pair -- "" and 0 rather than nulls -- means "the application's
+# single publication", which is exactly what every 0.1.0 row already is. Nulls
+# would have been the obvious choice and the wrong one: Postgres treats two
+# nulls as distinct, so a nullable pair in the unique index would have allowed
+# two posts to share a slug in that unscoped publication.
+class AddPublicationScopeToPressroom < ActiveRecord::Migration[7.2]
+  TABLES = %i[pressroom_posts pressroom_categories pressroom_tags].freeze
+
+  def up
+    TABLES.each do |table|
+      add_column table, :scope_type, :string, null: false, default: ""
+      add_column table, :scope_id, :bigint, null: false, default: 0
+
+      remove_index table, :slug
+      add_index table, %i[scope_type scope_id slug], unique: true,
+                       name: "index_#{table}_on_scope_and_slug"
+    end
+
+    add_index :pressroom_posts, %i[scope_type scope_id status published_at],
+              name: "index_pressroom_posts_on_scope_and_status"
+  end
+
+  def down
+    remove_index :pressroom_posts, name: "index_pressroom_posts_on_scope_and_status"
+
+    TABLES.each do |table|
+      remove_index table, name: "index_#{table}_on_scope_and_slug"
+      add_index table, :slug, unique: true
+      remove_column table, :scope_type
+      remove_column table, :scope_id
+    end
+  end
+end

data/lib/pressroom/configuration.rb

@@ -22,11 +22,12 @@ module Pressroom
                   :unknown_block_strategy, :admin_per_page,
                   :image_content_types, :max_image_bytes
 
-    attr_writer :authenticate_with
+    attr_writer :authenticate_with, :current_scope
 
     def initialize
       @parent_controller       = "ApplicationController"
       @authenticate_with       = nil
+      @current_scope           = nil
       @author_class            = nil
       @author_name_method      = :name
       @comments                = false
@@ -49,6 +50,17 @@ module Pressroom
       @authenticate_with
     end
 
+    # Which publication the admin is looking at, evaluated in the controller
+    # so it can read params and the session. Left unset, the admin manages the
+    # application's single publication -- which is every install that has not
+    # asked for more than one.
+    #
+    #   config.current_scope { current_user.website }
+    def current_scope(&block)
+      @current_scope = block if block
+      @current_scope
+    end
+
     # Explicit configuration wins; otherwise fail loudly where a developer
     # will see it and degrade quietly where users would.
     def resolved_unknown_block_strategy

data/lib/pressroom/current.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require "active_support/current_attributes"
+
+module Pressroom
+  # The publication the current unit of work belongs to.
+  #
+  # CurrentAttributes rather than a thread variable so Rails resets it between
+  # requests and jobs on its own, which is the failure mode a hand-rolled
+  # thread local always eventually hits.
+  class Current < ActiveSupport::CurrentAttributes
+    attribute :scope
+  end
+end

data/lib/pressroom/version.rb

@@ -1,3 +1,3 @@
 module Pressroom
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/lib/pressroom.rb

@@ -4,6 +4,7 @@ require "pressroom/version"
 require "pressroom/errors"
 require "pressroom/transliteration"
 require "pressroom/configuration"
+require "pressroom/current"
 require "pressroom/blocks/schema"
 require "pressroom/blocks/definition"
 require "pressroom/blocks/registry"
@@ -34,6 +35,23 @@ module Pressroom
       @registry ||= Blocks::Registry.new
     end
 
+    # The publication the current unit of work belongs to. Nil means the
+    # application's single publication, which is what an app that never uses
+    # publications always sees.
+    def current_scope
+      Current.scope
+    end
+
+    # Runs a block against one publication. Nests, and restores the previous
+    # publication even when the block raises.
+    def with_scope(owner)
+      previous = Current.scope
+      Current.scope = owner
+      yield
+    ensure
+      Current.scope = previous
+    end
+
     # Public API: registers a block type.
     #
     #   Pressroom.register_block :callout do |b|

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: pressroom
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Alex Andreiev
 bindir: bin
 cert_chain: []
-date: 2026-08-21 00:00:00.000000000 Z
+date: 2026-08-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -92,6 +92,7 @@ files:
 - app/jobs/pressroom/application_job.rb
 - app/mailers/pressroom/application_mailer.rb
 - app/models/concerns/pressroom/authorable.rb
+- app/models/concerns/pressroom/scoped.rb
 - app/models/concerns/pressroom/sluggable.rb
 - app/models/pressroom/application_record.rb
 - app/models/pressroom/category.rb
@@ -127,6 +128,7 @@ files:
 - config/routes.rb
 - db/migrate/20260821000001_create_pressroom_posts.rb
 - db/migrate/20260821000002_create_pressroom_taxonomy.rb
+- db/migrate/20260826000001_add_publication_scope_to_pressroom.rb
 - lib/pressroom.rb
 - lib/pressroom/blocks/definition.rb
 - lib/pressroom/blocks/registry.rb
@@ -136,6 +138,7 @@ files:
 - lib/pressroom/blocks/text_extractor.rb
 - lib/pressroom/built_in_blocks.rb
 - lib/pressroom/configuration.rb
+- lib/pressroom/current.rb
 - lib/pressroom/engine.rb
 - lib/pressroom/errors.rb
 - lib/pressroom/feed.rb