feat(white-label): expose MSA gating on the customer portal

app/graphql/types/customer_portal/customers/object.rb

@@ -36,6 +36,19 @@ class Object < Types::BaseObject
 
         field :premium, Boolean, null: false
 
+        # White-label / SDK MSA gating: the portal blocks all sections until the
+        # customer has signed. Signing happens on the hosted gate page.
+        field :must_sign_agreement, Boolean, null: false
+        field :agreement_signing_url, String, null: true
+
+        def must_sign_agreement
+          pending_agreement.present?
+        end
+
+        def agreement_signing_url
+          pending_agreement&.signing_url
+        end
+
         def billing_configuration
           {
             id: "#{object&.id}-c0nf",
@@ -53,6 +66,16 @@ def billing_entity_billing_configuration
         def premium
           License.premium?
         end
+
+        private
+
+        def pending_agreement
+          return @pending_agreement if defined?(@pending_agreement)
+
+          @pending_agreement = WhiteLabelAgreement
+            .where(customer_id: object.id, status: "pending")
+            .order(created_at: :desc).first
+        end
       end
     end
   end

app/models/white_label_agreement.rb

@@ -42,6 +42,17 @@ def signed_token
     self.class.verifier.generate(id, purpose: TOKEN_PURPOSE, expires_in: TOKEN_TTL)
   end
 
+  # Full URL of the hosted MSA acceptance gate for this agreement. Used by the
+  # provisioning rake task (email link) and the customer portal (sign panel).
+  def self.gate_base_url
+    (ENV["WHITE_LABEL_GATE_URL"].presence || ENV["LAGO_API_URL"].presence ||
+      ENV["LAGO_FRONT_URL"].presence || "http://localhost:3000").chomp("/")
+  end
+
+  def signing_url
+    "#{self.class.gate_base_url}/white-label/#{signed_token}"
+  end
+
   def accept!(signer:, request_ip:, user_agent:)
     update!(
       status: "accepted",

lib/tasks/flobyte.rake

@@ -219,10 +219,7 @@ module FlobyteCatalog
       puts "+ pending agreement #{agreement.id}"
     end
 
-    base = ENV["WHITE_LABEL_GATE_URL"].presence || ENV["LAGO_API_URL"].presence ||
-      ENV["LAGO_FRONT_URL"].presence || "http://localhost:3000"
-    link = "#{base.chomp("/")}/white-label/#{agreement.signed_token}"
-
+    link = agreement.signing_url
     puts "\nEmail this acceptance link to #{name} <#{email}> (valid #{WhiteLabelAgreement::TOKEN_TTL.inspect}):\n\n  #{link}\n"
     link
   end