captive-stack-detector 0.9.1 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4db20c393b2e76e3a4f80f2a8919ce8d1213270a092d5548645e526b00ec8b92
-  data.tar.gz: 7e3cd75908ef3bd96b0bc8ce7d5907d0826ffb75a43dc6ff27a05bd1896d61b8
+  metadata.gz: 5275b5b8c6fc70aec72f1ab4de5c4301c93e8e269908d93fc8db6d7735f99540
+  data.tar.gz: e8ba22932d1a222f38f5b6d569c32d772af28930ccfc8c9967c916db9ac14152
 SHA512:
-  metadata.gz: 875c9629aef59227685231cb08a2bcf074dd478e3cd1a1aa5b36c245209e03c462ec8d5bf9fb1bd2ad2bdf95667e38aeee2a3d1ef8b96365f281d14dbbeda8a8
-  data.tar.gz: d41f464ed90e3ae49dcc9edf78c5ca33b6464ae0abf46f708781c7b4e41552526db7664133590375d695b6da7c8c0e787be38d9c8ea38acabefa5ac2fa3d0dc9
+  metadata.gz: 18fd7d008bb7eba3e0f9b6a1efc3baead566d0cb3b676b49126776ec6112692a43334bdc199bb59c883d28aac67abf5e54515077bc79f4a9c265b7d36b57989f
+  data.tar.gz: be421c440ddee1fecdeeacec913e83cbdf2cdd23094ce1fbae24f9450bf02507a4d701746c389b912ed31b95ba7fc4483170e9eb4c586a0ce1db8b6167385500

data/docs/stacks.md

@@ -116,9 +116,22 @@ Condition : ni `Gemfile` ni `package.json` à la racine, mais un `public/index.h
 
 - Si `public/` existe, seul ce dossier est servi.
 - Sinon la racine est servie, limitée aux fichiers web (HTML, JavaScript, CSS, JSON, images, polices, manifeste, texte). Les dossiers cachés (`.git/`, `.github/`), `supabase/`, vos scripts SQL ou votre documentation ne sont jamais publiés.
-- Un dossier `supabase/` avec son `config.toml` provisionne un backend Supabase.
+- Un dossier `supabase/` avec son `config.toml` provisionne un backend Supabase et sa base Postgres.
 - Faute de build, aucune variable n'est injectée : votre code lit directement l'adresse de l'API, par exemple `location.origin`.
 
+## Options Supabase recommandées
+
+Avec un backend Supabase (application Node ou site statique), Captive lit votre code et vous recommande les options de l'add-on dont il a besoin, chacune avec sa raison (par exemple « votre code appelle signUp »). Une recommandation ne s'active pas seule : vous la retrouvez dans le dashboard au moment de la création.
+
+| Option | Recommandée quand |
+| --- | --- |
+| `smtp` | votre JavaScript ou TypeScript appelle `signUp`, `resetPasswordForEmail`, `signInWithOtp`, `inviteUserByEmail` ou `updateUser({ email })` : Supabase doit envoyer un email. Une connexion par `signInWithPassword` ou la double authentification (`auth.mfa`) n'en envoie pas. |
+| `realtime` | votre code s'abonne à un canal (`.channel(`) ou aux changements de la base (`postgres_changes`). |
+| `pg_cron` | un fichier `.sql` du dépôt (dont `supabase/migrations/` et `db/`) appelle `cron.schedule`, ou `net.http_` (pg_net est livré avec pg_cron). |
+| `vault` | un fichier `.sql` utilise le coffre Supabase (`vault.create_secret`, `vault.decrypted_secrets`…). |
+
+Les dépendances (`node_modules/`), sorties de build, tests et fichiers vendored sont ignorés, comme pour les variables. L'analyse est statique : un appel construit dynamiquement n'est pas vu ; activez alors l'option vous-même.
+
 ## Expo
 
 Condition : un `package.json` à la racine avec la dépendance `expo` (dans `dependencies` ou `devDependencies`). Aucun script n'est exigé.

data/lib/captive_stack_detector/addon_recommender.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative "recommendation_rule"
+require_relative "repo_sources"
+
+module CaptiveStackDetector
+  # Propose les options de l'add-on Supabase que le code du dépôt utilise, chacune avec sa raison.
+  class AddonRecommender
+    # Appels d'auth qui envoient un email ; signInWithPassword et auth.mfa n'en envoient pas.
+    AUTH_EMAILS = /
+      \b(?<call>signUp|resetPasswordForEmail|signInWithOtp|inviteUserByEmail)\(
+      | \b(?<call>updateUser)\(\s*\{\s*email\b
+    /x
+    RULES = [
+      RecommendationRule.new("smtp", :js, AUTH_EMAILS),
+      RecommendationRule.new("realtime", :js, /\.(?<call>channel)\(|(?<call>postgres_changes)/),
+      RecommendationRule.new("pg_cron", :sql, /\b(?<call>cron\.schedule|net\.http_)/),
+      RecommendationRule.new("vault", :sql, /\b(?<call>vault)\./),
+    ].freeze
+
+    def initialize(reader)
+      @reader = reader
+    end
+
+    # Seul Supabase a des options : les autres stacks gardent recommendations vide, sans lire les sources.
+    def apply(result)
+      return result unless result.services.backend == "supabase"
+
+      sources = RepoSources.new(@reader)
+      result.with(recommendations: RULES.filter_map { |rule| rule.recommend(sources) })
+    end
+  end
+end

data/lib/captive_stack_detector/recommendation_rule.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require_relative "types"
+
+module CaptiveStackDetector
+  # Une option d'add-on et les appels qui la justifient ; le groupe nommé call est l'appel cité dans la raison.
+  class RecommendationRule < Data.define(:option, :kind, :pattern)
+    LABELS = { js: "votre code", sql: "votre SQL" }.freeze
+
+    def recommend(sources)
+      call = pattern.match(sources.of(kind))&.[](:call)
+      call && Recommendation.new(addon: "supabase", option: option, reason: "#{LABELS.fetch(kind)} appelle #{call}")
+    end
+  end
+end

data/lib/captive_stack_detector/repo_sources.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative "js_env_files"
+
+module CaptiveStackDetector
+  # Contenu des sources JS et SQL du dépôt, hors dépendances, builds et tests (mêmes exclusions que JsEnvFiles).
+  class RepoSources
+    def self.kind(path)
+      return nil if JsEnvFiles::EXCLUDED.match?(path)
+      return :sql if path.end_with?(".sql")
+
+      :js if JsEnvFiles::SOURCE.match?(path)
+    end
+
+    def initialize(reader)
+      @reader = reader
+      @paths  = reader.list(".").sort.map { |entry| entry.delete_prefix("./") }.group_by { |path| self.class.kind(path) }
+    end
+
+    # Tout le code d'un genre (:js ou :sql), fichier par fichier, en un seul texte.
+    def of(kind) = @paths.fetch(kind, []).map { |path| @reader.read(path).to_s }.join("\n")
+  end
+end

data/lib/captive_stack_detector/static_site_detector.rb

@@ -4,10 +4,13 @@ require_relative "types"
 
 module CaptiveStackDetector
   # Un site statique sans manifeste ni build (index.html qui charge ses scripts) : stack node
-  # sans subtype, servie telle quelle. Supabase se reconnaît à son dossier, faute de package.json.
+  # sans subtype, servie telle quelle. Supabase (et sa base Postgres) se reconnaît à son dossier, faute de package.json.
   class StaticSiteDetector
     ENTRIES = %w[public/index.html index.html].freeze
     NO_RUNTIME = Runtime.new(ruby: nil, node: nil)
+    NO_SERVICES = Services.new(database: nil, queue: nil, backend: nil)
+    # Supabase repose sur Postgres, comme le déduit PackageJsonAnalyzer pour une stack Node.
+    SUPABASE = Services.new(database: "postgres", queue: nil, backend: "supabase")
 
     def initialize(reader)
       @reader = reader
@@ -20,13 +23,9 @@ module CaptiveStackDetector
     def detect
       Result.new(
         type: "node", subtype: nil, worker: nil, env_vars: {}, system_packages: [],
-        services: Services.new(database: nil, queue: nil, backend: backend),
+        services: @reader.read("supabase/config.toml") ? SUPABASE : NO_SERVICES,
         runtime: NO_RUNTIME,
       )
     end
-
-    private
-
-    def backend = ("supabase" if @reader.read("supabase/config.toml"))
   end
 end

data/lib/captive_stack_detector/types.rb

@@ -4,12 +4,14 @@ module CaptiveStackDetector
   Services = Data.define(:database, :queue, :backend)
   Worker   = Data.define(:command)
   Runtime  = Data.define(:ruby, :node)
+  # Option d'add-on que la détection propose d'activer, avec sa raison lisible par le client.
+  Recommendation = Data.define(:addon, :option, :reason)
   # public_env_prefix : préfixe des variables que le bundler expose au navigateur
   # (VITE_, NEXT_PUBLIC_, EXPO_PUBLIC_), nil sans bundler front (PackageJsonAnalyzer).
   Result   = Data.define(:type, :subtype, :services, :worker, :runtime, :env_vars, :system_packages,
-                         :public_env_prefix) do
+                         :public_env_prefix, :recommendations) do
     # env_vars : { "NOM" => valeur }, fusionné par captive-admin au provisionnement.
-    def initialize(env_vars:, public_env_prefix: nil, **)
+    def initialize(env_vars:, public_env_prefix: nil, recommendations: [], **)
       Hash.try_convert(env_vars) or raise ArgumentError, "env_vars doit être un Hash"
       super
     end

data/lib/captive_stack_detector/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CaptiveStackDetector
-  VERSION = "0.9.1"
+  VERSION = "0.10.0"
 end

data/lib/captive_stack_detector.rb

@@ -7,7 +7,9 @@ require_relative "captive_stack_detector/gemfile_analyzer"
 require_relative "captive_stack_detector/rails_stack_detector"
 require_relative "captive_stack_detector/js_stack_detector"
 require_relative "captive_stack_detector/static_site_detector"
+require_relative "captive_stack_detector/addon_recommender"
 
+# Déduit d'un dépôt sa stack, ses services et les options d'add-on à recommander.
 module CaptiveStackDetector
   # Doc publique des stacks supportées, livrée dans la gem et affichée par le dashboard (ADR 0003).
   DOC_PATH = File.expand_path("../docs/stacks.md", __dir__)
@@ -18,6 +20,11 @@ module CaptiveStackDetector
   end
 
   def self.detect_from(reader)
+    AddonRecommender.new(reader).apply(detect_stack(reader))
+  end
+  private_class_method :detect_from
+
+  def self.detect_stack(reader)
     gemfile      = reader.read("Gemfile")
     package_json = reader.read("package.json")
 
@@ -29,5 +36,5 @@ module CaptiveStackDetector
 
     static_site.detect
   end
-  private_class_method :detect_from
+  private_class_method :detect_stack
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: captive-stack-detector
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.10.0
 platform: ruby
 authors:
 - Captive Studio
@@ -20,6 +20,7 @@ files:
 - docs/stacks.md
 - lib/captive/stack/detector.rb
 - lib/captive_stack_detector.rb
+- lib/captive_stack_detector/addon_recommender.rb
 - lib/captive_stack_detector/aptfile_parser.rb
 - lib/captive_stack_detector/env_template_scanner.rb
 - lib/captive_stack_detector/env_vars_scanner.rb
@@ -38,7 +39,9 @@ files:
 - lib/captive_stack_detector/node_version_detector.rb
 - lib/captive_stack_detector/package_json_analyzer.rb
 - lib/captive_stack_detector/rails_stack_detector.rb
+- lib/captive_stack_detector/recommendation_rule.rb
 - lib/captive_stack_detector/recurring_schedule.rb
+- lib/captive_stack_detector/repo_sources.rb
 - lib/captive_stack_detector/ruby_version_detector.rb
 - lib/captive_stack_detector/solid_queue_usage.rb
 - lib/captive_stack_detector/solid_queue_worker.rb