captive-stack-detector 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 487472525c07acc23f340602eca8aae3b4ef8d98c88a80e37d25f5802a45df1e
-  data.tar.gz: c18427405c1190c106b75eb64b082943e54e703d43fa17b5b340f639668d6321
+  metadata.gz: d7799cc8a4c640bb12eca8a85e86e4d4e59eaae472764cc07d255f1481d8592c
+  data.tar.gz: e9481131febb4b7d7e9558ba629941d5d19025fd548b91afe458c71c51280f41
 SHA512:
-  metadata.gz: 8bebc550e548d55b8f50c87eb781f9954086b574602c51d494585bc7d519d391fedc905cc74c802033b77f8940f718431b6452bf8e06d860e4f9aa775460baeb
-  data.tar.gz: e1f7a93e4bb0e747537139c047d75789b89b0c85232951b807a4ab93b918e43851c8bc0d85ba8fe84972a676775e673ae6611b2be27956abb9ed287b5bc15418
+  metadata.gz: ba37a8e26e9356235db1f390d9d80eefae0eb585f1709f9bb1ef5d8b90ee8c2c82e50506ddebe9fa8ae3a337b096a675e48abd95d8c586130c4ed6416d8c89cf
+  data.tar.gz: cb1e564350c211cfc8bc1906857e413e099fbe368f5d5d9029a2c7074dbaf168034aa85d5924596606f9ca9d5ded9dcd617559fb95f7befe58e647eaf161078b

data/docs/stacks.md

@@ -65,6 +65,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/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/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.7.0"
 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.7.0
 platform: ruby
 authors:
 - Captive Studio