captive-stack-detector 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f6cc07b2aebaa064c700e3efc99f2e9c08dc9cd9682206b66f6dacbcdaef476
-  data.tar.gz: eeadaa4880a5673b9b89545333cd71895be4a8f04e6ab9503ce57d6051ce7416
+  metadata.gz: d7799cc8a4c640bb12eca8a85e86e4d4e59eaae472764cc07d255f1481d8592c
+  data.tar.gz: e9481131febb4b7d7e9558ba629941d5d19025fd548b91afe458c71c51280f41
 SHA512:
-  metadata.gz: 7940bd96414ba39c325e183e898c9135e63cafca546c0189690846b5881d02fa5271358608d7d0055f240e2fa7267e0837b1b8cc51a3dc1ba3abb4172394c43c
-  data.tar.gz: a646c1aebebdc27038f703f2ac779e764d1120e00c493a75dda43b1f717de7cb80f620d91997ed2263ca92c0c39750857bfcb318e685b037383ed19980e5f72f
+  metadata.gz: ba37a8e26e9356235db1f390d9d80eefae0eb585f1709f9bb1ef5d8b90ee8c2c82e50506ddebe9fa8ae3a337b096a675e48abd95d8c586130c4ed6416d8c89cf
+  data.tar.gz: cb1e564350c211cfc8bc1906857e413e099fbe368f5d5d9029a2c7074dbaf168034aa85d5924596606f9ca9d5ded9dcd617559fb95f7befe58e647eaf161078b

data/docs/stacks.md

@@ -0,0 +1,105 @@
+# Stacks supportées
+
+Quand vous créez une application, Captive lit votre dépôt GitHub pour savoir **comment le construire et le lancer**. Cette famille de déploiement s'appelle la **stack**. Captive en connaît trois : **Rails**, **Node** et **Expo**. Si votre dépôt n'entre dans aucune, la création est refusée avec la raison exacte.
+
+Captive ne lit que **la racine du dépôt** : un `Gemfile` ou un `package.json` placé dans un sous-dossier n'est pas vu.
+
+## Rails
+
+Condition : un `Gemfile` à la racine qui contient la gem `rails`.
+
+```ruby
+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.
+
+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`.
+
+## Node
+
+Condition : un `package.json` à la racine, sans dépendance `expo`, avec un script **`start`** ou **`build`**.
+
+### Application web (SPA : Vite, React, Vue…)
+
+Votre application est buildée une fois, puis servie en fichiers statiques. Aucun process Node ne tourne en production.
+
+```json
+{
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build"
+  },
+  "devDependencies": {
+    "vite": "7.1.0"
+  }
+}
+```
+
+- Le script `build` doit produire le dossier **`dist/`** à la racine. C'est le comportement par défaut de Vite ; si vous avez changé `build.outDir`, remettez `dist`.
+- Toutes les routes inconnues renvoient `index.html` : le routage côté client (React Router, Vue Router…) fonctionne sans configuration.
+- Les variables d'environnement sont injectées **au moment du build** (par exemple `VITE_SUPABASE_URL`). Après en avoir modifié une, redéployez.
+
+### Serveur Node (Next.js, Nuxt, SvelteKit, Remix)
+
+Si votre `package.json` dépend de `next`, `nuxt`, `@sveltejs/kit` ou d'un paquet `@remix-run/…`, Captive lance un vrai serveur Node avec votre script `start`.
+
+```json
+{
+  "scripts": {
+    "build": "next build",
+    "start": "next start"
+  },
+  "dependencies": {
+    "next": "15.0.0"
+  }
+}
+```
+
+### Services
+
+- `pg` ou `postgres` provisionne une base Postgres.
+- `redis` ou `ioredis` provisionne un Redis.
+- `@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é.
+
+```json
+{
+  "dependencies": {
+    "expo": "54.0.0"
+  }
+}
+```
+
+## Ma création est refusée
+
+| Message | Cause | Que faire |
+| --- | --- | --- |
+| Aucun Gemfile ni package.json à la racine du dépôt. | Pas de fichier de dépendances à la racine. | Vérifiez que l'application est bien à la racine du dépôt, pas dans un sous-dossier (`app/`, `frontend/`…). Les monorepos ne sont pas pris en charge. |
+| Gemfile trouvé, mais sans la gem rails. | Application Ruby non Rails (Sinatra, Hanami…), ou `Gemfile` d'outillage dans un projet JavaScript. | Seul Rails est pris en charge côté Ruby. Si le `Gemfile` ne sert qu'à de l'outillage, retirez-le du dépôt. |
+| package.json trouvé, mais sans dépendance expo ni script start ou build. | Captive ne sait pas comment construire l'application. | Ajoutez un script `build` (application web) ou `start` (serveur), comme dans les exemples ci-dessus. |
+
+Si votre stack n'est pas listée ici, contactez l'équipe Captive.

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.0"
+  VERSION = "0.7.0"
 end

data/lib/captive_stack_detector.rb

@@ -8,6 +8,9 @@ require_relative "captive_stack_detector/rails_stack_detector"
 require_relative "captive_stack_detector/js_stack_detector"
 
 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__)
+
   def self.detect(local_path: nil, github_token: nil, repo: nil)
     reader = FileReader.build(local_path: local_path, github_token: github_token, repo: repo)
     detect_from(reader)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: captive-stack-detector
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Captive Studio
@@ -17,6 +17,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- docs/stacks.md
 - lib/captive/stack/detector.rb
 - lib/captive_stack_detector.rb
 - lib/captive_stack_detector/aptfile_parser.rb