mobiscroll-connect 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 49b200acf379cde0578e8f4b74e414b7a9fc5c71209f76e564654c74ece51959
-  data.tar.gz: 8462c4b2e4ad3c41f29d69ccd6010c21c5b598a1eb7a319d7502fd0ee6186da4
+  metadata.gz: b31a5377ff60ec4d4e5601e084d736e26bad0250ffb3c57f21e9763cbe32ce1f
+  data.tar.gz: ecaf0a97ba89509bd0ce3eba1f33d37024d0a3cdac5ff2e6cfbe85ec9bdd0395
 SHA512:
-  metadata.gz: 76adf999c8a02d7ef85a7f06e6cc537dde75b9d689ba9be0608489040a4f05b696fc1cf8002fabab6b3086deff6a3f54080ff8e83191a12b8532368c47168c94
-  data.tar.gz: '09b3556482b18761984dfa400dbe11b26288c98176afb662bbdd4ca41a2ace1768636806cab1a63a21ec1b536d16ac088b49982134d03b1ef33bb7e437c3ed2e'
+  metadata.gz: f98b8378045037ee79e53b5b5394beeb42b1ea92a0641cf0412e0598ec9bf92296568ebf8c46d625d260967e397e891110c204bd5fe6e69ae60e8d7e95cfccc2
+  data.tar.gz: 9a92b7c19a5dada68228e6d2533b996352e74b104089f3cac3676db05e9d877b08eaedc207e268067710ca81b9ea6ce85f6952086f156c047ffe59b5852a5c8b

data/README.md

@@ -35,7 +35,7 @@ client = Mobiscroll::Connect::Client.new(
 ```ruby
 url = client.auth.generate_auth_url(
   user_id:   'user-123',
-  lng:       'es', # optional: Connect page language ('en', 'es', 'fr', 'ar')
+  lng:       'es', # optional: Connect page language, see https://mobiscroll.com/docs/connect/localization#supported-languages
   providers: [
     Mobiscroll::Connect::Provider::GOOGLE,
     Mobiscroll::Connect::Provider::MICROSOFT
@@ -69,7 +69,12 @@ client.set_credentials(
 ```ruby
 status = client.auth.get_connection_status
 status.connections.each do |provider, accounts|
-  accounts.each { |a| puts "#{provider}: #{a.display}" }
+  accounts.each do |a|
+    puts "#{provider}: #{a.display}"
+    # Google's consent screen lets the user untick the calendar permission and still
+    # finish signing in. Such an account is connected but lists no calendars.
+    puts "  #{a.id} must reconnect and allow calendar access" if a.calendar_permission_granted == false
+  end
 end
 ```
 

data/lib/mobiscroll/connect/errors.rb

@@ -17,6 +17,25 @@ module Mobiscroll
       end
     end
 
+    # Raised when no connected account has the calendar access the request needs.
+    #
+    # The user completed sign-in but did not grant the calendar permission — Google's
+    # consent screen presents it as a separate checkbox. This cannot be repaired
+    # server-side, because providers only issue permissions at consent time: the
+    # accounts in +accounts+ have to run the connect flow again and allow access.
+    #
+    # Subclasses AuthenticationError, so existing rescue clauses keep working.
+    class CalendarPermissionError < AuthenticationError
+      # Array of BlockedAccount structs that must reconnect.
+      attr_reader :accounts
+
+      def initialize(message = 'No connected account has calendar access', accounts: [])
+        super(message)
+        @code = 'CALENDAR_PERMISSION_REQUIRED'
+        @accounts = accounts
+      end
+    end
+
     class NotFoundError < Error
       def initialize(message = 'Resource not found')
         super(message, code: 'NOT_FOUND_ERROR')
@@ -67,7 +86,15 @@ module Mobiscroll
 
       case status
       when 401, 403
-        AuthenticationError.new(message)
+        # A 403 the caller can act on: the account connected but never granted
+        # calendar access, so it is raised as its own type naming the accounts.
+        hash = body.is_a?(Hash) ? body : {}
+        if status == 403 && (hash['code'] || hash[:code]) == 'calendar_permission_required'
+          raw = hash['accounts'] || hash[:accounts]
+          CalendarPermissionError.new(message, accounts: Array(raw).filter_map { |a| BlockedAccount.from_h(a) })
+        else
+          AuthenticationError.new(message)
+        end
       when 404
         NotFoundError.new(message)
       when 400, 422

data/lib/mobiscroll/connect/models.rb

@@ -35,12 +35,40 @@ module Mobiscroll
       end
     end
 
-    # One connected account under a provider.
-    ConnectedAccount = Struct.new(:id, :display, keyword_init: true) do
+    # A connected account that withheld calendar access on its provider's consent screen.
+    BlockedAccount = Struct.new(:provider, :account, keyword_init: true) do
       def self.from_h(hash)
         return nil if hash.nil?
 
-        new(id: hash['id'] || hash[:id], display: hash['display'] || hash[:display])
+        new(
+          provider: hash['provider'] || hash[:provider],
+          account: hash['account'] || hash[:account]
+        )
+      end
+    end
+
+    # One connected calendar account.
+    #
+    # `granted_scopes` are the scopes the provider actually granted, which are not
+    # necessarily the ones Connect asked for: Google's consent screen lets the user untick
+    # the calendar permission and still complete sign-in.
+    #
+    # `calendar_permission_granted` is false for exactly those accounts — connected, but
+    # no calendars can be read from them until the user reconnects and allows access. It
+    # is nil when the question does not apply (Apple and CalDav authenticate with a
+    # username and app password) or no scopes were recorded for the account.
+    ConnectedAccount = Struct.new(:id, :display, :granted_scopes, :calendar_permission_granted, keyword_init: true) do
+      def self.from_h(hash)
+        return nil if hash.nil?
+
+        key = 'calendarPermissionGranted'
+        granted = hash.key?(key) ? hash[key] : hash[key.to_sym]
+        new(
+          id: hash['id'] || hash[:id],
+          display: hash['display'] || hash[:display],
+          granted_scopes: Array(hash['grantedScopes'] || hash[:grantedScopes]),
+          calendar_permission_granted: granted
+        )
       end
     end
 

data/lib/mobiscroll/connect/version.rb

@@ -2,6 +2,6 @@
 
 module Mobiscroll
   module Connect
-    VERSION = '1.1.0'
+    VERSION = '1.2.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mobiscroll-connect
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Mobiscroll
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-03 00:00:00.000000000 Z
+date: 2026-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64