organizations 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ca06945acfae769816fdc7c19ba44778791697325d1f59967fb4794c7b8a274
-  data.tar.gz: 9601aa8b0835819532b1aed0a79a410ef4bf51f023b90088c463950dff5616c0
+  metadata.gz: bc99dabb60fe5f7d0c4ae8567fd62c4920f4a403b804dfe4e8dcac4d3c66fa11
+  data.tar.gz: '024976f0f5cd19fd8530179977a34e21d7ca54968bbf62d50eeff0d5f70dc1ea'
 SHA512:
-  metadata.gz: 666c1b825cb64d0d822d654bf1db23c6672b993e7769369d43b0afb01480e13218511b1bd7da4c100b5761360049f9408c6c74a33a177a8e86b34ce6cab27efa
-  data.tar.gz: 6416fb315eb949d06672665f5909bcf463976d265a05bbcdbc508978f5f20c6ccf9367c64c8a94ccbe1e8da57eeb934b3d12354dd9adb40ed51f00a9421f2883
+  metadata.gz: b14290ba7ecfc72544a5b4553fc5fd633ab51af9bcf1e3e1ed2bd90769ce2099a658f815191f1cf8c5e4706978d0070b80654e6b6da978b636ba6a87e60e11c9
+  data.tar.gz: 07bb21cfe8a870b8f672069ac7cb3f9512dad17ad1ea472b4cc34db9eaaf292773f05c6eb105dc5e220dc3b4b2139bfcdee1d097201774ca92cb79356373c8a3

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [0.2.0] - 2026-02-20
+
+- Namespaced all tables with `organizations_` prefix to prevent collisions with host apps
+
 ## [0.1.1] - 2026-02-19
 
 - Removed `slugifiable` dependency (deferred to host app)

data/README.md

@@ -1064,9 +1064,9 @@ The gem provides `Organizations::Organization` as the base model. You can extend
 # db/migrate/xxx_add_custom_fields_to_organizations.rb
 class AddCustomFieldsToOrganizations < ActiveRecord::Migration[8.0]
   def change
-    add_column :organizations, :support_email, :string
-    add_column :organizations, :billing_address, :text
-    add_column :organizations, :settings, :jsonb, default: {}
+    add_column :organizations_organizations, :support_email, :string
+    add_column :organizations_organizations, :billing_address, :text
+    add_column :organizations_organizations, :settings, :jsonb, default: {}
   end
 end
 ```
@@ -1110,10 +1110,10 @@ This is standard Rails practice — the gem provides the foundation (memberships
 
 The gem creates three tables:
 
-### organizations
+### organizations_organizations
 
 ```sql
-organizations
+organizations_organizations
   - id (primary key, auto-detects UUID or integer from your app)
   - name (string, required)
   - metadata (jsonb, default: {})
@@ -1123,10 +1123,10 @@ organizations
 
 > **Note:** The gem automatically detects your app's primary key type (UUID or integer) and uses it for all tables.
 
-### memberships
+### organizations_memberships
 
 ```sql
-memberships
+organizations_memberships
   - id (primary key)
   - user_id (foreign key, indexed)
   - organization_id (foreign key, indexed)
@@ -1138,10 +1138,10 @@ memberships
   unique index: [user_id, organization_id]
 ```
 
-### organization_invitations
+### organizations_invitations
 
 ```sql
-organization_invitations
+organizations_invitations
   - id (primary key)
   - organization_id (foreign key, indexed)
   - email (string, required, indexed)
@@ -1254,7 +1254,7 @@ If you display member counts frequently (pricing pages, org listings), consider
 
 ```ruby
 # In a migration
-add_column :organizations, :memberships_count, :integer, default: 0, null: false
+add_column :organizations_organizations, :memberships_count, :integer, default: 0, null: false
 
 # Reset existing counts
 Organization.find_each do |org|
@@ -1275,9 +1275,9 @@ org.member_count
 Boolean checks use efficient SQL `EXISTS` queries:
 
 ```ruby
-user.belongs_to_any_organization?     # SELECT 1 FROM memberships WHERE ... LIMIT 1
-user.has_pending_organization_invitations?  # SELECT 1 FROM organization_invitations WHERE ... LIMIT 1
-org.has_any_members?                  # SELECT 1 FROM memberships WHERE ... LIMIT 1
+user.belongs_to_any_organization?     # SELECT 1 FROM organizations_memberships WHERE ... LIMIT 1
+user.has_pending_organization_invitations?  # SELECT 1 FROM organizations_invitations WHERE ... LIMIT 1
+org.has_any_members?                  # SELECT 1 FROM organizations_memberships WHERE ... LIMIT 1
 ```
 
 ### Scoped associations use JOINs
@@ -1287,13 +1287,13 @@ Methods like `org.admins` and `user.owned_organizations` use proper SQL JOINs:
 ```ruby
 org.admins
 # SELECT users.* FROM users
-# INNER JOIN memberships ON memberships.user_id = users.id
-# WHERE memberships.organization_id = ? AND memberships.role IN ('admin', 'owner')
+# INNER JOIN organizations_memberships ON organizations_memberships.user_id = users.id
+# WHERE organizations_memberships.organization_id = ? AND organizations_memberships.role IN ('admin', 'owner')
 
 user.owned_organizations
-# SELECT organizations.* FROM organizations
-# INNER JOIN memberships ON memberships.organization_id = organizations.id
-# WHERE memberships.user_id = ? AND memberships.role = 'owner'
+# SELECT organizations_organizations.* FROM organizations_organizations
+# INNER JOIN organizations_memberships ON organizations_memberships.organization_id = organizations_organizations.id
+# WHERE organizations_memberships.user_id = ? AND organizations_memberships.role = 'owner'
 ```
 
 ### Current organization memoization
@@ -1445,14 +1445,14 @@ The gem creates these indexes automatically:
 
 ```sql
 -- Fast membership lookups
-CREATE UNIQUE INDEX index_memberships_on_user_and_org ON memberships (user_id, organization_id);
-CREATE INDEX index_memberships_on_organization_id ON memberships (organization_id);
-CREATE INDEX index_memberships_on_role ON memberships (role);
+CREATE UNIQUE INDEX index_organizations_memberships_on_user_and_org ON organizations_memberships (user_id, organization_id);
+CREATE INDEX index_organizations_memberships_on_organization_id ON organizations_memberships (organization_id);
+CREATE INDEX index_organizations_memberships_on_role ON organizations_memberships (role);
 
 -- Fast invitation lookups
-CREATE UNIQUE INDEX index_invitations_on_token ON organization_invitations (token);
-CREATE INDEX index_invitations_on_email ON organization_invitations (email);
-CREATE UNIQUE INDEX index_invitations_pending ON organization_invitations (organization_id, LOWER(email)) WHERE accepted_at IS NULL;
+CREATE UNIQUE INDEX index_organizations_invitations_on_token ON organizations_invitations (token);
+CREATE INDEX index_organizations_invitations_on_email ON organizations_invitations (email);
+CREATE UNIQUE INDEX index_organizations_invitations_pending ON organizations_invitations (organization_id, LOWER(email)) WHERE accepted_at IS NULL;
 ```
 
 ## Migration from 1:1 relationships

data/lib/generators/organizations/install/templates/create_organizations_tables.rb.erb

@@ -6,7 +6,7 @@ class CreateOrganizationsTables < ActiveRecord::Migration<%= migration_version %
     adapter = connection.adapter_name.downcase
 
     # Organizations table
-    create_table :organizations, id: primary_key_type do |t|
+    create_table :organizations_organizations, id: primary_key_type do |t|
       t.string :name, null: false
       t.send(json_column_type, :metadata, null: json_column_null, default: json_column_default)
 
@@ -14,9 +14,9 @@ class CreateOrganizationsTables < ActiveRecord::Migration<%= migration_version %
     end
 
     # Memberships join table (User ↔ Organization)
-    create_table :memberships, id: primary_key_type do |t|
+    create_table :organizations_memberships, id: primary_key_type do |t|
       t.references :user, null: false, type: foreign_key_type, foreign_key: true
-      t.references :organization, null: false, type: foreign_key_type, foreign_key: true
+      t.references :organization, null: false, type: foreign_key_type, foreign_key: { to_table: :organizations_organizations }
       t.references :invited_by, null: true, type: foreign_key_type, foreign_key: { to_table: :users }
       t.string :role, null: false, default: "member"
       t.send(json_column_type, :metadata, null: json_column_null, default: json_column_default)
@@ -24,27 +24,22 @@ class CreateOrganizationsTables < ActiveRecord::Migration<%= migration_version %
       t.timestamps
     end
 
-    add_index :memberships, [:user_id, :organization_id], unique: true
-    add_index :memberships, :role
+    add_index :organizations_memberships, [:user_id, :organization_id], unique: true
+    add_index :organizations_memberships, :role
 
     # Enforce "at most one owner membership per organization" at DB level where possible.
-    if adapter.include?("postgresql")
+    # Both PostgreSQL and SQLite support partial indexes with identical syntax.
+    if adapter.include?("postgresql") || adapter.include?("sqlite")
       execute <<-SQL
-        CREATE UNIQUE INDEX index_memberships_single_owner
-        ON memberships (organization_id)
-        WHERE role = 'owner'
-      SQL
-    elsif adapter.include?("sqlite")
-      execute <<-SQL
-        CREATE UNIQUE INDEX index_memberships_single_owner
-        ON memberships (organization_id)
+        CREATE UNIQUE INDEX index_organizations_memberships_single_owner
+        ON organizations_memberships (organization_id)
         WHERE role = 'owner'
       SQL
     end
 
     # Invitations table
-    create_table :organization_invitations, id: primary_key_type do |t|
-      t.references :organization, null: false, type: foreign_key_type, foreign_key: true
+    create_table :organizations_invitations, id: primary_key_type do |t|
+      t.references :organization, null: false, type: foreign_key_type, foreign_key: { to_table: :organizations_organizations }
       # invited_by is nullable to support dependent: :nullify when user is deleted
       t.references :invited_by, null: true, type: foreign_key_type, foreign_key: { to_table: :users }
       t.string :email, null: false
@@ -56,29 +51,22 @@ class CreateOrganizationsTables < ActiveRecord::Migration<%= migration_version %
       t.timestamps
     end
 
-    add_index :organization_invitations, :token, unique: true
-    add_index :organization_invitations, :email
+    add_index :organizations_invitations, :token, unique: true
+    add_index :organizations_invitations, :email
 
     # Unique partial index: only one pending (non-accepted) invitation per email per org
-    # Both PostgreSQL and SQLite support partial indexes
-    if adapter.include?("postgresql")
-      execute <<-SQL
-        CREATE UNIQUE INDEX index_invitations_pending_unique
-        ON organization_invitations (organization_id, LOWER(email))
-        WHERE accepted_at IS NULL
-      SQL
-    elsif adapter.include?("sqlite")
-      # SQLite supports partial indexes since 3.8.0
+    # Both PostgreSQL and SQLite (3.8.0+) support partial indexes with identical syntax.
+    if adapter.include?("postgresql") || adapter.include?("sqlite")
       execute <<-SQL
-        CREATE UNIQUE INDEX index_invitations_pending_unique
-        ON organization_invitations (organization_id, LOWER(email))
+        CREATE UNIQUE INDEX index_organizations_invitations_pending_unique
+        ON organizations_invitations (organization_id, LOWER(email))
         WHERE accepted_at IS NULL
       SQL
     elsif adapter.include?("mysql")
       # MySQL doesn't support partial indexes, so we use a generated column that is
       # only non-NULL for pending invitations and enforce uniqueness on that value.
       execute <<-SQL
-        ALTER TABLE organization_invitations
+        ALTER TABLE organizations_invitations
         ADD COLUMN pending_email VARCHAR(255)
         GENERATED ALWAYS AS (
           CASE
@@ -88,10 +76,10 @@ class CreateOrganizationsTables < ActiveRecord::Migration<%= migration_version %
         ) STORED
       SQL
 
-      add_index :organization_invitations, [:organization_id, :pending_email], unique: true, name: "index_invitations_pending_unique"
+      add_index :organizations_invitations, [:organization_id, :pending_email], unique: true, name: "index_organizations_invitations_pending_unique"
     else
       # For other adapters, fall back to app-level validation.
-      add_index :organization_invitations, [:organization_id, :email], name: "index_invitations_on_org_and_email"
+      add_index :organizations_invitations, [:organization_id, :email], name: "index_organizations_invitations_on_org_and_email"
     end
   end
 

data/lib/organizations/models/concerns/has_organizations.rb

@@ -74,7 +74,7 @@ module Organizations
 
             # Organizations where user is owner (efficient JOIN)
             has_many :owned_organizations,
-                     -> { where(memberships: { role: "owner" }) },
+                     -> { where(organizations_memberships: { role: "owner" }) },
                      through: :memberships,
                      source: :organization,
                      class_name: "Organizations::Organization"

data/lib/organizations/models/invitation.rb

@@ -18,7 +18,7 @@ module Organizations
   #   invitation.expired?   # => false
   #
   class Invitation < ActiveRecord::Base
-    self.table_name = "organization_invitations"
+    self.table_name = "organizations_invitations"
 
     # === Associations ===
 

data/lib/organizations/models/membership.rb

@@ -16,7 +16,7 @@ module Organizations
   #   membership.demote_to!(:member)
   #
   class Membership < ActiveRecord::Base
-    self.table_name = "memberships"
+    self.table_name = "organizations_memberships"
 
     # Error raised when trying to demote below current role
     class CannotDemoteOwner < Organizations::Error; end

data/lib/organizations/models/organization.rb

@@ -16,7 +16,7 @@ module Organizations
   #   org.member_count # => 5
   #
   class Organization < ActiveRecord::Base
-    self.table_name = "organizations"
+    self.table_name = "organizations_organizations"
 
     # Error raised when trying to perform invalid operations on organization
     class CannotRemoveOwner < Organizations::Error; end
@@ -54,7 +54,7 @@ module Organizations
     # @param user [User] The user
     # @return [ActiveRecord::Relation]
     scope :with_member, ->(user) {
-      joins(:memberships).where(memberships: { user_id: user.id })
+      joins(:memberships).where(organizations_memberships: { user_id: user.id })
     }
 
     # === Member Query Methods ===
@@ -75,7 +75,7 @@ module Organizations
     # Uses efficient JOIN query to avoid N+1
     # @return [ActiveRecord::Relation<User>]
     def admins
-      users.where(memberships: { role: %w[owner admin] }).distinct
+      users.where(organizations_memberships: { role: %w[owner admin] }).distinct
     end
 
     # Alias for users (semantic convenience)

data/lib/organizations/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Organizations
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

data/lib/organizations/view_helpers.rb

@@ -258,8 +258,8 @@ module Organizations
       memberships = user.memberships
                         .includes(:organization)
                         .joins(:organization)
-                        .select("memberships.id, memberships.organization_id, memberships.role, " \
-                                "organizations.id AS org_id, organizations.name AS org_name")
+                        .select("organizations_memberships.id, organizations_memberships.organization_id, organizations_memberships.role, " \
+                                "organizations_organizations.id AS org_id, organizations_organizations.name AS org_name")
 
       current_data = nil
       others = []

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: organizations
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - rameerez
 bindir: exe
 cert_chain: []
-date: 2026-02-19 00:00:00.000000000 Z
+date: 2026-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties