rails-tenantify 🏢

gem "rails-tenantify", "~> 0.1.2", require: "rails-tenantify"

# frozen_string_literal: true

Tenantify.configure do |config|
  config.tenant_model = "Organization"       # REQUIRED — ActiveRecord class name
  config.on_tenant_not_found = :raise       # :raise | :redirect | :null_tenant
  config.audit_overrides = :log             # :log | :raise | :ignore
end

class Organization < ApplicationRecord
  validates :name, :subdomain, presence: true
end

class Project < ApplicationRecord
  include Tenantify::Scoped

  belongs_to_tenant :organization
end

class ApplicationController < ActionController::Base
  set_tenant_by :subdomain
end

set_tenant_by :header, header: "X-Tenant-ID"

# After resolver runs (or after you set current_tenant manually):
Project.all                              # scoped
Project.create!(name: "Roadmap")         # organization_id set automatically
Tenantify.current_tenant                 # => #<Organization ...>

# spec/rails_helper.rb or spec/spec_helper.rb
RSpec.configure do |config|
  config.include Tenantify::TestHelpers

  config.before do
    Tenantify::TestHelpers.clear_tenant
  end
end

with_tenant(organization) { Project.create!(name: "Demo") }

class Task < ApplicationRecord
  include Tenantify::Scoped
  belongs_to_tenant :organization
  belongs_to :project
end

set_tenant_by :subdomain
set_tenant_by :subdomain, exclude: %w[www admin]
set_tenant_by :subdomain, attribute: :slug   # custom column, default :subdomain
set_tenant_by :subdomain, only: [:index, :show]

set_tenant_by :header
set_tenant_by :header, header: "X-Tenant-ID"

# config/initializers/tenantify.rb
config.on_tenant_not_found = :raise    # Tenantify::TenantNotFoundError

# or per controller:
set_tenant_by :subdomain, fallback: "/login"   # needs :redirect in config

# app/controllers/concerns/tenantify_context.rb
module TenantifyContext
  extend ActiveSupport::Concern

  included do
    before_action :set_current_tenant_from_user
  end

  private

  def set_current_tenant_from_user
    return unless user_signed_in?

    Tenantify.current_tenant = current_user.organization
  end
end

class ApplicationController < ActionController::Base
  include TenantifyContext
end

Tenantify.current_tenant          # tenant object or nil
Tenantify.current_tenant = org    # respects audit_overrides
Tenantify.current_tenant_id       # integer or nil
Tenantify.tenant_scoped?          # false inside without_tenant

Tenantify.switch_to(org) do
  Project.all                     # scoped to org
end

Tenantify.without_tenant do
  Project.unscoped.delete_all     # bypass scope + bulk guards
end

Tenantify.tenant_class            # Organization (from tenant_model)

class ExportJob < ApplicationJob
  def perform
    Tenantify.current_tenant   # restored from enqueue time
    Project.find_each { |p| p.update!(exported: true) }
  end
end

Tenantify.current_tenant = current_organization
ExportJob.perform_later

Tenantify.current_tenant = org
Project.update_all(status: "done")       # OK

Project.unscoped.update_all(status: "x") # raises

Tenantify.without_tenant do
  Project.update_all(status: "safe")     # OK
end

task.project = other_org_project
task.valid?  # => false
task.errors[:project]  # => ["belongs to a different tenant"]

RSpec.configure do |config|
  config.include Tenantify::TestHelpers
  config.before { Tenantify::TestHelpers.clear_tenant }
end