studio-engine 0.137.0 → 0.138.0

data/lib/studio.rb

@@ -12,6 +12,7 @@ require "active_support/core_ext/module/attribute_accessors"
 require "active_support/core_ext/numeric/time"
 require "active_support/core_ext/integer/time"
 require "studio/version"
+require "studio/roles"
 require "studio/local_path"
 require "studio/public_file_version"
 require "studio/component_gallery"
@@ -77,6 +78,10 @@ require "studio/redis"
 require "studio/cable"
 require "studio/connections"
 require "studio/connections/stand_in"
+require "studio/integrations"
+require "studio/integrations/quickbooks"
+require "studio/integrations/egnyte"
+require "studio/integrations/microsoft_365"
 require "studio/survey"
 require "studio/survey/breakdown"
 require "studio/survey/export"
@@ -1203,7 +1208,8 @@ module Studio
 
   # ---- Connections (docs/CONNECTIONS.md) ------------------------------------
   #
-  # The generic OAuth 2.0 connection tooling. The engine names no provider: a
+  # The generic OAuth 2.0 connection tooling. The tooling names no provider (the
+  # engine's own definitions are Studio::Integrations, below): a
   # host declares each in an initializer and draws its routes.
   #
   #   Studio.define_connection :files, label: "Acme Files", env: {...}, ...
@@ -1259,6 +1265,58 @@ module Studio
     end
   end
 
+  # ---- Integrations (docs/INTEGRATIONS.md) -----------------------------------
+  #
+  # The engine's own connection definitions (Studio::Integrations): QuickBooks,
+  # Egnyte and Microsoft 365. Connection only; a host writes its readers.
+  #
+  #   # config/initializers/studio_integrations.rb
+  #   Studio.enable_integration :quickbooks,
+  #     env: { client_id: "INTUIT_CLIENT_ID", client_secret: "INTUIT_CLIENT_SECRET", environment: "INTUIT_ENVIRONMENT" },
+  #     panel: "admin/integrations/quickbooks_panel"
+  #   # config/routes.rb
+  #   Studio.draw_integrations_routes(self)
+  #
+  # env: names the host's env vars (never values); the integration stays off
+  # until its client id and secret are set. panel: a host partial rendered on
+  # the integration's page with locals integration: and connections:.
+  def self.enable_integration(key, env:, panel: nil, label: nil, scopes: nil)
+    Integrations.enable(key, env:, panel:, label:, scopes:)
+  end
+
+  def self.integration(key)
+    Integrations.fetch(key)
+  end
+
+  def self.integrations
+    Integrations.all
+  end
+
+  # Draws the admin integrations page and, for every enabled integration, its
+  # page and connection routes (Studio.draw_connection_routes), all served by
+  # Studio::IntegrationsController unless the host names its own:
+  #
+  #   GET    /<path>                            <as>                    the list
+  #   GET    /<path>/<key>                      <as>_<key>              one integration's page
+  #   POST   /<path>/<key>/connect              <as>_<key>_connect      (also GET when it takes no account at Connect)
+  #   GET    /<path>/<key>/callback             <as>_<key>_callback     the redirect URI to register
+  #   DELETE /<path>/<key>/connections/:id      <as>_<key>_disconnect
+  #
+  # path: defaults to admin/integrations, so QuickBooks's redirect URI is
+  # /admin/integrations/quickbooks/callback. Call it after every
+  # enable_integration (an initializer runs before the routes load).
+  def self.draw_integrations_routes(router, path: "admin/integrations", controller: "studio/integrations", as: nil)
+    path = path.to_s.delete_prefix("/").delete_suffix("/")
+    controller = controller.to_s.delete_prefix("/")
+    as = (as || path.tr("/-", "__")).to_s
+    Integrations.mount_path = path
+    router.instance_exec { get path, to: "#{controller}#index", as: as }
+    Integrations.all.each do |integration|
+      draw_connection_routes(router, integration.key, path: "#{path}/#{integration.key}", controller:, as: "#{as}_#{integration.key}",
+                                                      show: true, return_to: ["/#{path}/#{integration.key}", "/#{path}"])
+    end
+  end
+
   # Define a survey in app code. See Studio::Survey for the DSL.
   def self.define_survey(slug, &block)
     Survey.define(slug, &block)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: studio-engine
 version: !ruby/object:Gem::Version
-  version: 0.137.0
+  version: 0.138.0
 platform: ruby
 authors:
 - Alex McRitchie
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-11-08 00:00:00.000000000 Z
+date: 2026-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -468,6 +468,7 @@ files:
 - app/controllers/studio/geo_settings_controller.rb
 - app/controllers/studio/google_setup_requests_controller.rb
 - app/controllers/studio/health_reports_controller.rb
+- app/controllers/studio/integrations_controller.rb
 - app/controllers/studio/knowledge_docs_controller.rb
 - app/controllers/studio/links_controller.rb
 - app/controllers/studio/local_emails_controller.rb
@@ -596,6 +597,7 @@ files:
 - app/mailers/studio/profile_mailer.rb
 - app/mailers/user_mailer.rb
 - app/models/concerns/sluggable.rb
+- app/models/concerns/studio/account.rb
 - app/models/concerns/studio/board/rankable.rb
 - app/models/concerns/studio/omniauth_user.rb
 - app/models/current.rb
@@ -716,6 +718,9 @@ files:
 - app/views/studio/google_sign_in/_setup_modal.html.erb
 - app/views/studio/health_report_mailer/daily.html.erb
 - app/views/studio/health_report_mailer/daily.text.erb
+- app/views/studio/integrations/_card.html.erb
+- app/views/studio/integrations/index.html.erb
+- app/views/studio/integrations/show.html.erb
 - app/views/studio/knowledge_docs/_access_chips.html.erb
 - app/views/studio/knowledge_docs/_browser.html.erb
 - app/views/studio/knowledge_docs/_chip_styles.html.erb
@@ -882,6 +887,9 @@ files:
 - db/migrate/20261103120000_create_studio_user_sessions.rb
 - db/migrate/20261108120000_add_device_revocation_to_studio_user_sessions.rb
 - db/migrate/20261108130000_create_studio_connections.rb
+- db/migrate/20261108160000_require_slugs_on_engine_tables.rb
+- db/migrate/20261108160001_add_engine_state_checks.rb
+- db/migrate/20261108170000_add_users_role_known_check.rb
 - docs/BOOKING.md
 - docs/SITE_FOOTER.md
 - lib/active_storage/service/studio_trash_s3_service.rb
@@ -932,6 +940,10 @@ files:
 - lib/studio/icons/lucide/rocket.svg
 - lib/studio/icons/lucide/user.svg
 - lib/studio/image_cache.rb
+- lib/studio/integrations.rb
+- lib/studio/integrations/egnyte.rb
+- lib/studio/integrations/microsoft_365.rb
+- lib/studio/integrations/quickbooks.rb
 - lib/studio/ip_locations.rb
 - lib/studio/js_identifier.rb
 - lib/studio/js_literal.rb
@@ -975,6 +987,7 @@ files:
 - lib/studio/public_file_version.rb
 - lib/studio/public_user.rb
 - lib/studio/redis.rb
+- lib/studio/roles.rb
 - lib/studio/s3.rb
 - lib/studio/s3/multipart.rb
 - lib/studio/s3/trash.rb