organizations 0.4.2 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 916bef6e3c027111a6da0cfa08cf015f2d872de614d55ab8978ce41e2a8ab8aa
-  data.tar.gz: 6d0fb70f4292c7a7635d16acde00f7b88cdbc9fdcc8d4268d76b65010bf16667
+  metadata.gz: 41b5d77cf4271b72a242ed018982a20a62de1aa65be8b44aeb0a1bdca6ca095f
+  data.tar.gz: 47da19b07cb78b00d63e3c682389d3b9cce80c10860883af947d25fb75ad4fa1
 SHA512:
-  metadata.gz: 78deb6016d5e62f432c1949ee9b8f700ce370e75a682451ace35a6923eb208e8f83800312cb525631fc1ee150a832f2748a67ab05b7f714873ca4b09b4e67adc
-  data.tar.gz: 529a7721cf5eef70b856a6b6e357e6d8881caf5b9108f31651cc2be7d83ea4258bde159b9a39d787ea78d71ed2b80d61939e1e5576c575df9416719729582c2f
+  metadata.gz: 21cd1f525064c45d471ec8a8e271ddb524aa21843130f2124c0e1b2f903aed5edfb8cbe0a3376f1d699983191eabfdada1304b391244ed65f5e1f7292420d693
+  data.tar.gz: f8b6512de051110d180d894a3e23c49f6b16f50b7bb81f0ba8f4d79257f79063ee345f23332d1d923bc3baff0f7feeac56f62f726594a4750a6b7b6522a57acc

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [0.4.3] - 2026-03-19
+
+- Added `can_view_billing?` and `can_manage_billing?` view helpers for billing permission checks
+- Refactored `can_manage_organization?` and `can_invite_members?` to use shared permission predicate
+- Fixed `pricing_plans` integration examples to use `current_pricing_plan` (effective plan API)
+- Clarified that billing permissions are authorization checks only, not subscription state indicators
+
 ## [0.4.2] - 2026-03-19
 
 - Added `should_create_personal_organization?` predicate as extension seam for conditional personal org creation

data/README.md

@@ -7,9 +7,9 @@
 
 `organizations` adds organizations with members to any Rails app. It handles team invites, user memberships, roles, and permissions.
 
-**🎮 [Try the live demo →](https://organizations.rameerez.com)**
+<img src="docs/organizations-invitation-accept-create-account.webp" width="500" />
 
-https://github.com/user-attachments/assets/2eddafe2-025b-4670-af9f-e0d5480508c5
+**🎮 [Try the live demo →](https://organizations.rameerez.com)**
 
 It's everything you need to turn a `User`-based app into a multi-tenant, `Organization`-based B2B SaaS (users belong in organizations, and organizations share resources and billing, etc.)
 
@@ -41,6 +41,8 @@ current_user.is_organization_owner?     # => true
 current_user.is_organization_admin?     # => true (owners inherit admin permissions)
 ```
 
+https://github.com/user-attachments/assets/2eddafe2-025b-4670-af9f-e0d5480508c5
+
 ## Installation
 
 Add to your Gemfile:
@@ -166,7 +168,7 @@ end
 
 > **Note:** This is an integration pattern, not built-in functionality. You implement the limit checks in your callbacks.
 
-If you're using [`pricing_plans`](https://github.com/rameerez/pricing_plans), you can limit how many members an organization can have based on their subscription using callbacks:
+If you're using [`pricing_plans`](https://github.com/rameerez/pricing_plans), you can limit how many members an organization can have based on their effective pricing plan using callbacks:
 
 ```ruby
 # config/initializers/pricing_plans.rb
@@ -186,7 +188,7 @@ Then hook into the `on_member_invited` callback to enforce limits. **This callba
 Organizations.configure do |config|
   config.on_member_invited do |ctx|
     org = ctx.organization
-    limit = org.current_plan.limit_for(:organization_members)
+    limit = org.current_pricing_plan.limit_for(:organization_members)
 
     if limit && org.member_count >= limit
       raise Organizations::InvitationError, "Member limit reached. Please upgrade your plan."
@@ -434,6 +436,8 @@ class SettingsController < ApplicationController
 end
 ```
 
+`manage_billing` and `view_billing` are authorization checks only. They control who in the organization can access your billing UI, but they do not imply an active Stripe subscription or determine the effective pricing plan.
+
 ### Handling unauthorized access
 
 Configure how unauthorized access is handled:
@@ -1215,7 +1219,7 @@ end
 
 ### Integrates with pricing_plans
 
-Enforce member limits based on pricing plans using callbacks:
+Enforce member limits based on the effective pricing plan using callbacks:
 
 ```ruby
 # In your Organization model

data/lib/organizations/version.rb

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

data/lib/organizations/view_helpers.rb

@@ -213,10 +213,7 @@ module Organizations
     # @param organization [Organizations::Organization] The organization
     # @return [Boolean]
     def can_manage_organization?(user, organization)
-      return false unless user && organization
-
-      role = user.role_in(organization)
-      role && Roles.has_permission?(role, :manage_settings)
+      user_has_permission_in_org?(user, organization, :manage_settings)
     end
 
     # Check if current user can invite members
@@ -225,10 +222,25 @@ module Organizations
     # @param organization [Organizations::Organization] The organization
     # @return [Boolean]
     def can_invite_members?(user, organization)
-      return false unless user && organization
+      user_has_permission_in_org?(user, organization, :invite_members)
+    end
 
-      role = user.role_in(organization)
-      role && Roles.has_permission?(role, :invite_members)
+    # Check if current user can view billing information
+    # Uses permission-based check to respect custom role configurations
+    # @param user [User] The user
+    # @param organization [Organizations::Organization] The organization
+    # @return [Boolean]
+    def can_view_billing?(user, organization)
+      user_has_permission_in_org?(user, organization, :view_billing)
+    end
+
+    # Check if current user can manage billing
+    # Uses permission-based check to respect custom role configurations
+    # @param user [User] The user
+    # @param organization [Organizations::Organization] The organization
+    # @return [Boolean]
+    def can_manage_billing?(user, organization)
+      user_has_permission_in_org?(user, organization, :manage_billing)
     end
 
     # Check if current user can remove a member

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: organizations
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.4.3
 platform: ruby
 authors:
 - rameerez