captive-stack-detector 0.6.1 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 487472525c07acc23f340602eca8aae3b4ef8d98c88a80e37d25f5802a45df1e
-  data.tar.gz: c18427405c1190c106b75eb64b082943e54e703d43fa17b5b340f639668d6321
+  metadata.gz: 72edac67211d3cbb3b67441fa5b0bb67e160bef105a770754638576bd7be25f1
+  data.tar.gz: c5664e645e6897ec75bdc1cfae9bf97ba9ccaa019a26ff8ada90f85ff91dcb22
 SHA512:
-  metadata.gz: 8bebc550e548d55b8f50c87eb781f9954086b574602c51d494585bc7d519d391fedc905cc74c802033b77f8940f718431b6452bf8e06d860e4f9aa775460baeb
-  data.tar.gz: e1f7a93e4bb0e747537139c047d75789b89b0c85232951b807a4ab93b918e43851c8bc0d85ba8fe84972a676775e673ae6611b2be27956abb9ed287b5bc15418
+  metadata.gz: 0ca13e0e77a74ca4f6e3624b755d73f0f8d3c1b15e29ef7706f6251fc9ffcbcab4e14b4372c8768b8baddb7285b91f096b48393ce86845d93bbc3db63e66847d
+  data.tar.gz: 57b1ded773d8cd32707b8e7c3388a9bff4316f9af64ebf8fa45bd619c2dff9261b4659fb4ed34d6b06a8bca7514abef550c1971b02e86e75144d224101f1ebef

data/docs/stacks.md

@@ -15,6 +15,7 @@ gem "rails", "8.1.0"
 - Avec une gem d'assets (`propshaft`, `sprockets-rails`, `importmap-rails`, `jsbundling-rails`, `cssbundling-rails`, `tailwindcss-rails`…), l'application est construite avec ses assets frontend.
 - Sans gem d'assets, elle est construite comme une API.
 - `gem "pg"` provisionne une base Postgres, `gem "redis"` ou `gem "sidekiq"` un Redis.
+- Les bibliothèques système exigées par certaines gems sont installées dans l'image : `ruby-vips` (libvips), `mini_magick` et `rmagick` (imagemagick), `sqlite3`, et `ethon` (libcurl), y compris quand la gem n'arrive qu'en dépendance d'une autre via le `Gemfile.lock`. Pour une bibliothèque non détectée, listez le paquet Debian dans un `Aptfile` à la racine.
 
 Si un `Gemfile` est présent, c'est toujours lui qui décide : un dépôt avec un `Gemfile` sans Rails est refusé, même s'il a aussi un `package.json`.
 
@@ -65,6 +66,23 @@ Si votre `package.json` dépend de `next`, `nuxt`, `@sveltejs/kit` ou d'un paque
 - `@supabase/supabase-js` ou `@supabase/ssr` provisionne un backend Supabase.
 - Une ligne `worker: <commande>` dans un `Procfile` lance un worker.
 
+
+### Variables exposées au navigateur
+
+Une variable n'arrive dans le code du navigateur que si elle porte le préfixe de votre bundler. Captive le déduit de vos dépendances :
+
+| Dépendance | Préfixe |
+| --- | --- |
+| `expo` | `EXPO_PUBLIC_` |
+| `next` | `NEXT_PUBLIC_` |
+| `vite` | `VITE_` |
+
+Si plusieurs sont présentes, c'est le premier de la liste qui l'emporte (`vite` est souvent là pour les tests seulement).
+
+Avec un backend Supabase, Captive pose l'URL et la clé publique sous ce préfixe, avec les deux noms de clé en usage : `VITE_SUPABASE_URL`, `VITE_SUPABASE_ANON_KEY` et `VITE_SUPABASE_PUBLISHABLE_KEY` pour une application Vite, par exemple. Côté serveur, les mêmes valeurs sont disponibles sans préfixe : `SUPABASE_URL` et `SUPABASE_ANON_KEY`.
+
+Ces variables sont lues **au build** : après en avoir changé une, redéployez.
+
 ## 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/gem_package_map.rb

@@ -2,7 +2,7 @@
 
 module CaptiveStackDetector
   # Connaissance « quel gem exige quels paquets système ». Rend les paires gem → paquets
-  # pour les gems effectivement déclarés dans le Gemfile passé.
+  # pour les gems déclarés dans le Gemfile ou résolus dans le Gemfile.lock (dépendances transitives).
   module GemPackageMap
     MAP = {
       "ruby-vips"          => %w[libvips42 libvips-dev],
@@ -10,11 +10,18 @@ module CaptiveStackDetector
       "rmagick"            => %w[imagemagick],
       "wkhtmltopdf-binary" => %w[], # retiré de Debian Trixie, projet upstream abandonné
       "sqlite3"            => %w[libsqlite3-dev],
+      "ethon"              => %w[libcurl4t64], # charge libcurl via FFI (dépendance de typhoeus)
     }.freeze
 
-    def self.matches(gemfile)
-      content = gemfile.to_s
-      MAP.select { |gem, _| content.match?(/gem ['"]#{Regexp.escape(gem)}['"]/) }
+    def self.matches(*sources)
+      content = sources.join("\n")
+      MAP.select { |gem, _| content.match?(pattern(gem)) }
+    end
+
+    # Déclaration `gem "x"` du Gemfile, ou spec résolue `    x (1.2.3)` du Gemfile.lock.
+    def self.pattern(gem)
+      name = Regexp.escape(gem)
+      /gem ['"]#{name}['"]|^ {4}#{name} \(/
     end
   end
 end

data/lib/captive_stack_detector/js_stack_detector.rb

@@ -22,6 +22,7 @@ module CaptiveStackDetector
         runtime:         Runtime.new(ruby: nil, node: @reader.node_version),
         env_vars:        {},
         system_packages: [],
+        public_env_prefix: @analyzer.public_env_prefix,
       )
     end
 

data/lib/captive_stack_detector/package_json_analyzer.rb

@@ -5,6 +5,7 @@ require_relative "ssr_framework_detector"
 
 module CaptiveStackDetector
   class PackageJsonAnalyzer
+    PUBLIC_ENV_PREFIXES = { "expo" => "EXPO_PUBLIC_", "next" => "NEXT_PUBLIC_", "vite" => "VITE_" }.freeze
     # Des clients, pas des ORM : Prisma ou Drizzle parlent aussi MySQL et SQLite, leur
     # présence ne dit pas que l'app attend une base Postgres.
     POSTGRES_CLIENTS = %w[pg postgres].freeze
@@ -41,6 +42,12 @@ module CaptiveStackDetector
       any_dep?(SUPABASE_CLIENTS) ? "supabase" : nil
     end
 
+    # Le premier bundler trouvé, dans l'ordre du type : vite en dernier, parce qu'il arrive
+    # souvent avec Vitest sans construire le front.
+    def public_env_prefix
+      PUBLIC_ENV_PREFIXES.find { |dependance, _| deps.key?(dependance) }&.last
+    end
+
     private
 
     def any_dep?(names)

data/lib/captive_stack_detector/rails_stack_detector.rb

@@ -5,6 +5,7 @@ require_relative "system_package_detector"
 require_relative "solid_queue_worker"
 
 module CaptiveStackDetector
+  # Construit le Result d'une app Rails à partir des fichiers du repo.
   class RailsStackDetector
     def initialize(reader, analyzer)
       @reader   = reader
@@ -34,8 +35,9 @@ module CaptiveStackDetector
 
     def system_packages
       SystemPackageDetector.new(
-        gemfile: @reader.read("Gemfile"),
-        aptfile: @reader.read("Aptfile"),
+        gemfile:  @reader.read("Gemfile"),
+        aptfile:  @reader.read("Aptfile"),
+        lockfile: @reader.read("Gemfile.lock"),
       ).packages
     end
   end

data/lib/captive_stack_detector/system_package_detector.rb

@@ -4,27 +4,32 @@ require_relative "aptfile_parser"
 require_relative "gem_package_map"
 
 module CaptiveStackDetector
+  # Paquets APT à installer dans l'image : ceux qu'exigent les gems du Gemfile/Gemfile.lock, plus l'Aptfile.
   class SystemPackageDetector
-    def initialize(gemfile:, aptfile:)
-      @gemfile = gemfile.to_s
+    def initialize(gemfile:, aptfile:, lockfile: nil)
+      @gem_sources = [ gemfile, lockfile ]
       @aptfile = aptfile.to_s
     end
 
     def packages
       result = (from_gemfile + from_aptfile).uniq
-      $stderr.puts "[captive-stack-detector] paquets système détectés : #{result.any? ? result.join(", ") : "aucun"}"
+      $stderr.puts "[captive-stack-detector] paquets système détectés : #{describe(result, "aucun")}"
       result
     end
 
     private
 
     def from_gemfile
-      GemPackageMap.matches(@gemfile).each_with_object([]) do |(gem, pkgs), result|
-        $stderr.puts "[captive-stack-detector] gem '#{gem}' détecté → #{pkgs.any? ? pkgs.join(", ") : "aucun paquet"}"
+      GemPackageMap.matches(*@gem_sources).each_with_object([]) do |(gem, pkgs), result|
+        $stderr.puts "[captive-stack-detector] gem '#{gem}' détecté → #{describe(pkgs, "aucun paquet")}"
         result.concat(pkgs)
       end
     end
 
+    def describe(pkgs, none)
+      pkgs.any? ? pkgs.join(", ") : none
+    end
+
     def from_aptfile
       AptfileParser.parse(@aptfile).each do |pkg|
         $stderr.puts "[captive-stack-detector] Aptfile → paquet '#{pkg}'"

data/lib/captive_stack_detector/types.rb

@@ -4,7 +4,12 @@ module CaptiveStackDetector
   Services = Data.define(:database, :queue, :backend)
   Worker   = Data.define(:command)
   Runtime  = Data.define(:ruby, :node)
-  Result   = Data.define(:type, :subtype, :services, :worker, :runtime, :env_vars, :system_packages)
+  # 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
+    def initialize(public_env_prefix: nil, **) = super
+  end
 
   # reason : :no_manifest, :no_rails ou :no_node_entry, pour que l'appelant explique le refus.
   class UnsupportedStack < StandardError

data/lib/captive_stack_detector/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: captive-stack-detector
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.8.1
 platform: ruby
 authors:
 - Captive Studio