holivia 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e08b2bf86b483bed3cab49da55f6a200ce9127837190f0e996001882704a47f
-  data.tar.gz: 3e43af44fdafedba928d56ba824544d884524ccbeb97eb7f078d63c816c49440
+  metadata.gz: 6e2d692d4098918b86e1fb733a303c51b8bde37583841b2f97f11bf58b2da880
+  data.tar.gz: 14095f6175eb6fdae474eeb6b31c0b4c856a675da375461d8d5a0748c27ec022
 SHA512:
-  metadata.gz: ab7c5ee66ff7f46620407a9aab99a2c3182a19e76436e9a65c8ac78aa264205ff1095fe8ff5e81e067921e4c7108aed142417642e89a13a512da45a76ceb658b
-  data.tar.gz: 7fc1562d3ff1228d3c0775576bf2204be61d90fbb45054ecb9eec2574c45bc1c83d37ea5a37bc2ea5ec088a3a7453978c548c90428ded7736b975f55cf367646
+  metadata.gz: a881a29e44e585bee272a5fe5def48a57b089ca81be00c9ee9d54da355ecd8273c4befbedd98e26d77a978baa0a37b5b12d2a2f1af03afac10519e85e291053f
+  data.tar.gz: 1478b0f331188b5b5043f01ab4e80643b173f69bb04adeefeba87d37a28ceda194d66fb7c701034298ad2257d6afae38131990b760829c0ba332ab586425ff1a

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 ## [Unreleased]
 
+## [0.3.0] - 2026-03-11
+
+- Add multi-environment support with `~/.holivia/config.yml`
+- Add `holivia env` commands (show, list, add, use, remove, debug)
+- Add `holivia version` command
+- Add scriptable login with `--email`/`--password` flags
+- Add `ConfigError` for friendly CLI error messages
+- Add `update_env` for toggling debug per environment
+- Add selfcare CRUD commands (show, create, update, compose, schema)
+- Add content format, slide, and slide item commands
+- Allow removing current env with auto-switch to remaining
+- Update compose example to omit audio items (uploaded separately)
+- Update help with workflow for audio uploads and all new commands
+
 ## [0.2.0] - 2026-03-09
 
 - Add logout command and `Client#delete` method

data/example_content.xml

@@ -0,0 +1,52 @@
+<slides>
+  <slide title="Les relations, un déterminant vital de la santé" duration="1">
+    <slideItem type="richText">
+      Imaginez une consultation médicale tout à fait banale. On vous interroge sur le tabac, l'activité physique, la tension artérielle, l'alimentation… Et puis, soudain, une question inattendue : « Et vos relations, en ce moment, elles ressemblent à quoi ? » Sur le papier, cela paraît presque déplacé. Dans la vie réelle, c'est souvent l'inverse : nous traitons la qualité de nos liens comme un "bonus" — précieux, certes, mais secondaire. Or, une vaste synthèse scientifique invite à changer radicalement de perspective : les relations sociales ne relèvent pas seulement du confort psychologique. Elles pèsent sur la survie elle-même.
+    </slideItem>
+  </slide>
+  <slide title="Quand le lien social devient un "facteur de survie"" duration="1">
+    <slideItem type="richText">
+      Dans une vaste synthèse d'études scientifiques qui suivent des personnes dans le temps, Holt-Lunstad et ses collègues montrent que les individus disposant de relations sociales plus solides ont tendance à vivre plus longtemps que ceux dont les liens sont plus faibles. Autrement dit, à l'échelle d'une vie, la présence de liens sociaux robustes s'associe à un avantage comparable à celui de facteurs de santé classiquement scrutés.<br/><br/>Les auteurs vont plus loin : ils soulignent que l'importance des relations "rivalise" avec des risques bien connus (comme certains facteurs de mode de vie et biomédicaux) — au point de recommander que la question des liens sociaux soit prise au sérieux dans une perspective de santé publique.<br/><br/>Une précision essentielle : cet effet n'est pas cantonné à un sous-groupe fragile. Il apparaît robuste à travers l'âge, le sexe, le statut de santé initial (population générale vs patients), et différents types de mortalité. Ce que cela suggère, en filigrane : le lien social n'est pas seulement une ressource "quand tout va mal", mais une dimension continue de notre écologie de santé.
+    </slideItem>
+  </slide>
+  <slide title=""Avoir des relations", cela veut dire quoi, exactement ?" duration="1">
+    <slideItem type="richText">
+      L'un des apports les plus utiles de l'article, pour penser concrètement nos vies, est de montrer que "les relations" ne se résument pas à une variable unique. Les auteurs distinguent deux grandes dimensions :<br/><br/>1) La dimension structurelle : à quel point vous êtes "inséré" dans un tissu social<br/><ul><li>vivre seul ou non,</li><li>être marié ou non,</li><li>taille et densité du réseau,</li><li>participation à des activités, rôles sociaux (ami, collègue, voisin, membre d'un groupe),</li><li>indices composites d'intégration sociale (qui combinent plusieurs éléments).</li></ul><br/>2) La dimension fonctionnelle : ce que ces relations "font" pour vous<br/><ul><li>le soutien reçu (aide concrète, émotionnelle, informationnelle),</li><li>le soutien perçu (la conviction que l'aide serait disponible si nécessaire),</li><li>la solitude (se sentir isolé, ne pas appartenir).</li></ul><br/>Et voici une nuance psychologiquement très parlante : ces dimensions ne se recouvrent que partiellement. On peut être "bien entouré" en apparence et se sentir seul ; ou avoir peu de liens mais les vivre comme profondément fiables et soutenants.
+    </slideItem>
+  </slide>
+  <slide title="Ce qui protège le plus : l'intégration sociale… et l'expérience subjective" duration="1">
+    <slideItem type="richText">
+      Quand on regarde plus finement quelles mesures prédisent le mieux la survie, un résultat se détache : la profondeur et la diversité de l'intégration sociale semblent particulièrement puissantes.<br/><br/>Mais l'autre message fort est que l'expérience subjective compte énormément :<br/><ul><li>le soutien perçu est protecteur</li><li>une moindre solitude apparaît fortement associée à la survie</li><li>tandis que des indicateurs très simples (ex. "vivre seul ou non") sont moins prédictifs</li></ul><br/>Un point particulièrement mobilisateur : les auteurs nuancent l'idée d'un simple "seuil" (les très isolés iraient mal, les autres seraient "OK"). Ils décrivent plutôt un gradient : chaque pas vers davantage d'intégration, de soutien perçu, et moins de solitude s'associe, en moyenne, à un gain incrémental. Dit autrement : en matière de liens, <b>les petits ajustements peuvent compter</b>.
+    </slideItem>
+  </slide>
+  <slide title="Comment les relations influencent-elles la santé "par en dessous" ?" duration="1">
+    <slideItem type="richText">
+      L'article discute plusieurs voies explicatives — et c'est ici que le lien social cesse d'être abstrait.<br/><br/>1) Les voies comportementales<br/>Les relations façonnent nos habitudes : elles peuvent encourager ou modéliser des comportements de santé (activité physique, alimentation, suivi médical, adhérence aux traitements), via des normes implicites et une régulation quotidienne ("on se motive", "on veille", "on se rappelle"). Les auteurs notent aussi que l'environnement social peut renforcer des habitudes moins favorables, même si ce n'est pas le cœur de la vaste synthèse d'études scientifiques.<br/><br/>2) Les voies psychologiques<br/>Deux grands modèles sont mis en avant :<br/><ul><li>le effet tampon face au stress : en période d'épreuve (maladie, transition, deuil, crise), le soutien relationnel modifie l'évaluation cognitive de la situation et amortit les réponses émotionnelles ;</li><li>le modèle des effets généraux : même hors crise, être relié à des autres structure l'identité, apporte des rôles, du sens, de l'estime de soi, et organise la vie quotidienne de manière plus contenante.</li></ul><br/>3) Les voies biologiques<br/>Les auteurs évoquent des liens entre soutien social et paramètres physiologiques (fonction immunitaire, inflammation, régulation neuroendocrinienne du stress). Ils rappellent aussi que des interactions relationnelles négatives (hostilité conjugale, climat tendu) ont été associées à des marqueurs défavorables (inflammation, cicatrisation plus lente), illustrant la façon dont la qualité relationnelle peut "passer dans le corps".
+    </slideItem>
+  </slide>
+  <slide title="L'angle mort qui change tout : la qualité des liens" duration="1">
+    <slideItem type="richText">
+      La vaste synthèse d'études scientifiques montre un effet global : "plus de relations" s'associe à une meilleure survie. Mais les auteurs insistent sur une limite majeure : beaucoup de mesures ne captent pas la qualité (par exemple, "être marié" ne dit rien d'un mariage soutenant ou corrosif). Ils rappellent que les relations négatives sont liées à davantage de risque, et suggèrent que les bénéfices observés pourraient même être sous-estimés si l'on distinguait mieux les liens protecteurs des liens toxiques.<br/><br/>Message psychoéducatif clé : augmenter le contact ne suffit pas. L'enjeu est d'augmenter la <b>fiabilité</b>, la <b>chaleur</b>, la <b>réciprocité</b> — et, parfois, de réduire l'exposition à des interactions chroniquement délétères.
+    </slideItem>
+  </slide>
+  <slide title="Votre "bilan relationnel santé"" duration="1">
+    <slideItem type="richText">
+      Prenez une feuille. Dessinez trois colonnes : <b>Structure</b> / <b>Fonction</b> / <b>Climat</b>.<br/><br/>1) Structure : votre intégration (0–2 points par item)<br/><ul><li>Ai-je au moins deux rôles sociaux vivants en dehors du travail (ami, voisin, groupe, association, activité) ?</li><li>Est-ce que je participe à au moins une activité régulière (même modeste) qui me met en contact ?</li><li>Ai-je des liens dans plus d'un contexte (famille et amis, ou amis et collectif, etc.) ?</li></ul><br/>2) Fonction : le soutien perçu et la solitude (0–2 points)<br/><ul><li>Si j'avais un pépin, est-ce que je sais qui je pourrais appeler ?</li><li>Est-ce que je me sens "appartenir" à au moins un petit cercle où je compte ?</li><li>Est-ce que je vis souvent une <b>solitude douloureuse</b>, même entouré (inversez le score : 2 = rarement, 0 = souvent) ?</li></ul><br/>3) Climat : la qualité (0–2 points)<br/><ul><li>Mes relations clés sont-elles plutôt une source de sécurité que de tension ?</li><li>Est-ce que je peux être moi-même sans marcher sur des œufs ?</li><li>Ai-je une relation où la réciprocité est réelle (je donne et je reçois) ?</li></ul><br/>Additionnez. Puis notez, en une phrase : "Mon prochain pas relationnel santé, réaliste, serait…"<br/><br/>L'objectif n'est pas de vous juger, mais de repérer où un petit déplacement aurait le plus d'effet.
+    </slideItem>
+  </slide>
+  <slide title="Mise en pratique : 5 stratégies simples" duration="1">
+    <slideItem type="richText">
+      <ol><li><b>Miser sur l'intégration "en profondeur", pas sur l'accumulation</b><br/>Les indices complexes d'intégration sociale sont ceux qui ressortent le plus fortement. Concrètement : plutôt qu'ajouter des contacts, cherchez un rôle stable (activité, groupe, engagement léger) qui vous donne une place reconnaissable.</li><li><b>Travailler le soutien perçu : rendre l'aide imaginable</b><br/>Le soutien perçu est un prédicteur notable. Une action très simple : choisissez une personne et testez une demande petite et précise ("Tu aurais 10 minutes cette semaine pour que je te parle d'un truc ?"). Ce type de micro-expérience rend le soutien plus "réel" mentalement.</li><li><b>Si vous êtes seul : privilégier des formats qui nourrissent vraiment le lien</b><br/>L'isolement n'est pas qu'une affaire de logement : c'est aussi une affaire de qualité de connexion et de sentiment d'appartenance. Or la vaste synthèse d'études scientifiques souligne l'importance de la solitude et de l'expérience subjective. Cherchez un format où l'on se voit suffisamment pour qu'un lien s'épaississe (rendez-vous régulier, activité partagée, marche hebdo, club).</li><li><b>Faire de l'hygiène relationnelle : réduire ce qui "abîme" le corps</b><br/>Les auteurs rappellent que les relations négatives ne sont pas neutres. Sans dramatiser : identifiez une interaction récurrente qui vous laisse vidé, tendu, humilié — et introduisez une limite concrète (durée, sujet, fréquence), ou un tiers, ou une distance. La santé relationnelle n'est pas seulement l'ajout de liens : c'est aussi la diminution de l'érosion.</li><li><b>Relier santé et relations : impliquer votre réseau, même modestement</b><br/>Les auteurs plaident pour que les soins et la prévention intègrent le réseau social (par exemple, soutien dans l'adhérence, présence à des étapes clés, organisation). À l'échelle individuelle : demandez à quelqu'un de vous accompagner dans un objectif de santé (marche, rendez-vous, routine), non comme "coach", mais comme <b>allié</b>.</li></ol>
+    </slideItem>
+  </slide>
+  <slide title="Conclusion : traiter le lien social comme une infrastructure de santé" duration="1">
+    <slideItem type="richText">
+      Une des idées les plus fortes de Holt-Lunstad et al. est presque philosophique : <b>nous n'existons pas en isolation</b>. Les relations influencent la santé par des voies cognitives, émotionnelles, comportementales et biologiques — lentement, cumulativement, parfois silencieusement.<br/><br/>La bonne nouvelle, si l'on adopte la logique du gradient : vous n'avez pas besoin de "devenir ultra-sociable" du jour au lendemain pour que quelque chose bouge. Un rôle social de plus, une relation nourrie avec plus de fiabilité, un pas qui réduit la solitude, une limite posée face à une interaction délétère… peuvent constituer des investissements de santé au même titre que certaines routines de prévention.<br/><br/>Si vous sentez que la question relationnelle est sensible (solitude tenace, histoire de liens douloureux, difficulté à demander, tendance à s'isoler), un accompagnement peut aider à faire ces pas de manière progressive et sécurisée — par exemple avec un expert Holivia, pour transformer des intentions vagues ("il faut que je voie plus de monde") en stratégies fines et soutenables.
+    </slideItem>
+  </slide>
+  <slide title="Référence" duration="1">
+    <slideItem type="richText">
+      Holt-Lunstad, J., Smith, T. B., &amp; Layton, J. B. (2010). Social relationships and mortality risk: A meta-analytic review. <i>PLOS Medicine</i>, 7(7), e1000316. https://doi.org/10.1371/journal.pmed.1000316
+    </slideItem>
+  </slide>
+</slides>

data/examples/compose.json

@@ -0,0 +1,58 @@
+{
+  "title": "Gestion du stress au travail",
+  "duration": 20,
+  "description": "Parcours complet sur le stress professionnel",
+  "goal": "Comprendre et réduire le stress",
+  "content_type": "video_type",
+  "locale": "fr",
+  "formats": [
+    {
+      "format_type": "video",
+      "slides": [
+        {
+          "title": "Vidéo principale",
+          "duration": 8,
+          "items": [
+            { "item_type": "WistiaItem", "code": "abc123def" }
+          ]
+        }
+      ]
+    },
+    {
+      "format_type": "audio",
+      "slides": [
+        {
+          "title": "Version audio",
+          "duration": 5
+        }
+      ]
+    },
+    {
+      "format_type": "text",
+      "slides": [
+        {
+          "title": "Introduction",
+          "duration": 3,
+          "items": [
+            { "item_type": "RichTextItem", "content": "<h2>Le stress</h2><p>Le stress est une réaction naturelle de l'organisme...</p>" }
+          ]
+        },
+        {
+          "title": "Les causes principales",
+          "duration": 4,
+          "items": [
+            { "item_type": "RichTextItem", "content": "<h2>Causes</h2><ul><li>Surcharge de travail</li><li>Manque de contrôle</li><li>Conflits interpersonnels</li></ul>" },
+            { "item_type": "RichTextItem", "content": "<h3>Facteurs aggravants</h3><p>Le manque de sommeil et la sédentarité amplifient les effets du stress.</p>" }
+          ]
+        },
+        {
+          "title": "Techniques de gestion",
+          "duration": 5,
+          "items": [
+            { "item_type": "RichTextItem", "content": "<h2>3 techniques simples</h2><ol><li>La respiration abdominale</li><li>La pause active</li><li>Le recadrage cognitif</li></ol>" }
+          ]
+        }
+      ]
+    }
+  ]
+}

data/exe/holivia

@@ -6,6 +6,10 @@ require "holivia/cli"
 begin
   Holivia::CLI.start(ARGV)
 rescue Holivia::ApiError => e
+  warn "Error (#{e.status}): #{e.message}"
+  warn JSON.pretty_generate(e.details) if e.details.is_a?(Hash)
+  exit 1
+rescue Holivia::ConfigError => e
   warn "Error: #{e.message}"
   exit 1
 end

data/lib/holivia/cli/help.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module Holivia
+  class CLI
+    module Help
+      HELP_TEXT = <<~HELP
+        HOLIVIA CLI
+        ===========
+
+        Environment:
+          holivia env                            Show current environment
+          holivia env list                       List all configured environments
+          holivia env add <name> --url <url>     Add or update an environment (--debug / --no-debug)
+          holivia env use <name>                 Switch to an environment
+          holivia env remove <name>              Remove an environment and its credentials
+          holivia env debug [name] --true/--false  Toggle debug logging for an environment
+          Config stored at ~/.holivia/config.yml. Defaults to staging if no config exists.
+
+        Authentication:
+          holivia login [--email EMAIL --password PASSWORD]  Log in (flags or interactive prompt)
+          holivia logout                         Log out and clear stored credentials
+          Tokens are stored at ~/.holivia/credentials.<env>.json and refreshed automatically on 401.
+
+        Selfcare Contents:
+          holivia selfcare index                 List all selfcare contents
+          holivia selfcare show <id>             Show a selfcare content by id
+          holivia selfcare create [options]      Create a selfcare content
+          holivia selfcare update <id> [options] Update a selfcare content
+          holivia selfcare compose               Create a full content tree atomically (no audio)
+          holivia selfcare schema                Show allowed values for content_types, format_types, item_types
+
+        Content Formats:
+          holivia selfcare format create [options]      Add a format to a selfcare content
+          holivia selfcare format update <id> [options] Update a content format
+
+        Slides:
+          holivia selfcare slide create [options]       Add a slide to a format
+          holivia selfcare slide update <id> [options]  Update a slide
+
+        Slide Items:
+          holivia selfcare item create [options]        Add an item to a slide
+          holivia selfcare item update <id> [options]   Update a slide item
+
+        Data Model:
+          SelfcareContent → ContentFormat (format_type: text, audio, video)
+            → Slide (title, duration) → SlideItem (one of: RichTextItem, VideoItem,
+              WistiaItem, QuizItem, AudioItem, MeditationItem, BreathingItem)
+          BreathingItem and MeditationItem are rendered full screen: one per slide.
+
+        Workflow:
+          1. holivia selfcare schema         Discover valid enum values
+          2. holivia selfcare compose         Create a full content tree in one atomic request
+             Text and video items are created inline. Audio items require a file upload,
+             so compose creates the slide without items — then add them using the slide ID:
+             holivia selfcare item create --slide-id <id> --item-type AudioItem --audio <path>
+             OR build everything incrementally:
+             holivia selfcare create          → create the content
+             holivia selfcare format create   → attach a format
+             holivia selfcare slide create    → add a slide to the format
+             holivia selfcare item create     → add items to the slide (supports audio upload)
+
+        Data Input:
+          Create/update commands accept flags (run <command> --help for details).
+          Compose accepts --file <path> for a JSON payload.
+          All create/update/compose commands also accept piped JSON via stdin.
+          Audio uploads use --audio <path> on item create/update (sent as multipart/form-data).
+          Accepted audio formats: MP3, MP4, WAV, OGG, FLAC, AAC, M4A, WebM. Max size: 100 MB.
+
+        Errors:
+          Validation errors (422) show structured details:
+            path: "formats[0].slides[0]"  errors: { "title": ["can't be blank"] }
+          Auth errors return 401. Not found returns 404.
+
+        Discovery:
+          Run holivia selfcare schema to get current allowed values for all enums
+          and item types with their permitted params. Always use this over hardcoded
+          values — it is the source of truth.
+
+        Version:
+          holivia version                        Print version
+      HELP
+    end
+  end
+end

data/lib/holivia/cli.rb

@@ -1,39 +1,28 @@
 # frozen_string_literal: true
 
 require "holivia"
+require_relative "cli/help"
 require_relative "commands/auth"
 require_relative "commands/selfcare"
+require_relative "commands/format"
+require_relative "commands/slide"
+require_relative "commands/env"
+require_relative "commands/item"
 
 module Holivia
   class CLI
     def self.start(args)
       command = args.shift
       case command
-      when "login" then Commands::Auth.new.login
+      when "login" then Commands::Auth.new.login(args)
       when "logout" then Commands::Auth.new.logout
-      when "selfcare" then route_selfcare(args)
-      when "--help", "-h", nil then print_help
+      when "env" then Commands::Env.route(args)
+      when "selfcare" then Commands::Selfcare.route(args)
+      when "version", "--version", "-v" then puts "holivia #{Holivia::VERSION}"
+      when "--help", "-h", nil then puts Help::HELP_TEXT
       else warn "Unknown command: #{command}"
            exit 1
       end
     end
-
-    def self.route_selfcare(args)
-      subcommand = args.shift
-      case subcommand
-      when "index" then Commands::Selfcare.new.index
-      else warn "Unknown selfcare command: #{subcommand}"
-           exit 1
-      end
-    end
-
-    def self.print_help
-      puts "Usage: holivia <command>"
-      puts ""
-      puts "Commands:"
-      puts "  login           Log in to Holivia"
-      puts "  logout          Log out of Holivia"
-      puts "  selfcare index  List selfcare contents"
-    end
   end
 end

data/lib/holivia/client.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "faraday"
+require "faraday/multipart"
 
 module Holivia
   class Client
@@ -18,6 +19,10 @@ module Holivia
       request(:get, path, params:, headers:)
     end
 
+    def patch(path, body: {}, headers: {})
+      request(:patch, path, body:, headers:)
+    end
+
     def delete(path, headers: {})
       request(:delete, path, headers:)
     end
@@ -52,8 +57,9 @@ module Holivia
 
     def connection
       @connection ||= http.new(url: base_url) do |f|
+        f.request :multipart
         f.request :json
-        f.response :logger if Holivia.configuration.debug
+        f.response :logger if Holivia.configuration.debug?
         f.response :json
         f.adapter Faraday.default_adapter
       end

data/lib/holivia/commands/auth.rb

@@ -1,16 +1,21 @@
 # frozen_string_literal: true
 
 require "io/console"
+require "optparse"
 
 module Holivia
   module Commands
     class Auth
-      def login
-        print "Email: "
-        email = $stdin.gets.chomp
-        print "Password: "
-        password = $stdin.noecho(&:gets).chomp
-        puts
+      def login(args = [])
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia login [--email EMAIL --password PASSWORD]"
+          opts.on("--email EMAIL") { |v| options[:email] = v }
+          opts.on("--password PASSWORD") { |v| options[:password] = v }
+        end.parse!(args)
+
+        email = options[:email] || prompt("Email: ")
+        password = options[:password] || prompt_secret("Password: ")
 
         Holivia::Auth.new.login(email: email, password: password)
         puts "Logged in successfully."
@@ -20,6 +25,20 @@ module Holivia
         Holivia::Auth.new.logout
         puts "Logged out successfully."
       end
+
+      private
+
+      def prompt(label)
+        print label
+        $stdin.gets.chomp
+      end
+
+      def prompt_secret(label)
+        print label
+        result = $stdin.noecho(&:gets).chomp
+        puts
+        result
+      end
     end
   end
 end

data/lib/holivia/commands/base.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "optparse"
+
+module Holivia
+  module Commands
+    class Base
+      private
+
+      def client
+        @client ||= Client.new
+      end
+
+      def output(response)
+        puts JSON.pretty_generate(response)
+      end
+
+      def piped_json
+        return {} if $stdin.tty?
+
+        input = $stdin.read
+        return {} if input.empty?
+
+        JSON.parse(input, symbolize_names: true)
+      end
+    end
+  end
+end

data/lib/holivia/commands/env.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class Env < Base
+      def self.route(args)
+        subcommand = args.shift
+        case subcommand
+        when "add"    then new.add(args)
+        when "use"    then new.use(args)
+        when "remove" then new.remove(args)
+        when "debug"  then new.debug(args)
+        when "list"   then new.list
+        when nil then new.show
+        else warn "Unknown env command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def show
+        puts "Environment: #{config.current_env}"
+        puts "URL:         #{config.base_url}"
+        puts "Debug:       #{config.debug?}"
+        puts "Credentials: #{File.exist?(config.credentials_path) ? "yes" : "no"}"
+      end
+
+      def list
+        config.environments.each do |name, env|
+          prefix = name == config.current_env ? "*" : " "
+          puts "#{prefix} #{name}\t#{env["url"]}"
+        end
+      end
+
+      def add(args = [])
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia env add <name> --url <url> [--debug]"
+          opts.on("--url URL") { |v| options[:url] = v }
+          opts.on("--debug") { options[:debug] = true }
+          opts.on("--no-debug") { options[:debug] = false }
+        end.parse!(args)
+
+        name = args.shift
+        abort "Usage: holivia env add <name> --url <url>" unless name && options[:url]
+
+        config.add_env(name, url: options[:url], debug: options[:debug])
+        puts "Environment '#{name}' added."
+      end
+
+      def use(args = [])
+        name = args.shift
+        abort "Usage: holivia env use <name>" unless name
+
+        config.use_env(name)
+        puts "Switched to '#{name}'."
+      end
+
+      def remove(args = [])
+        name = args.shift
+        abort "Usage: holivia env remove <name>" unless name
+
+        config.remove_env(name)
+        puts "Environment '#{name}' removed."
+      end
+
+      def debug(args = [])
+        value = nil
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia env debug [name] --true/--false"
+          opts.on("--true") { value = true }
+          opts.on("--false") { value = false }
+        end.parse!(args)
+
+        name = args.shift || config.current_env
+        abort "Usage: holivia env debug [name] --true/--false" if value.nil?
+
+        config.update_env(name, debug: value)
+        puts "Debug #{value ? "on" : "off"} for '#{name}'."
+      end
+
+      private
+
+      def config
+        @config ||= Holivia.configuration
+      end
+    end
+  end
+end

data/lib/holivia/commands/format.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class Format < Base
+      BASE_PATH = "/api/v1/backoffice/content_formats"
+
+      def self.route(args)
+        subcommand = args.shift
+        case subcommand
+        when "create" then new.create(args)
+        when "update" then new.update(args)
+        else warn "Unknown selfcare format command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def create(args = [])
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia selfcare format create [options]"
+          opts.on("--selfcare-content-id ID", Integer) { |v| options[:selfcare_content_id] = v }
+          opts.on("--format-type TYPE") { |v| options[:format_type] = v }
+        end.parse!(args)
+        options = options.merge(piped_json)
+
+        abort "No options provided. Use --help for usage." if options.empty?
+        output(client.post(BASE_PATH, body: options))
+      end
+
+      def update(args = [])
+        id = args.shift
+        abort "Usage: holivia selfcare format update <id> [options]" unless id
+
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia selfcare format update <id> [options]"
+          opts.on("--format-type TYPE") { |v| options[:format_type] = v }
+        end.parse!(args)
+        options = options.merge(piped_json)
+
+        abort "No options provided. Use --help for usage." if options.empty?
+        output(client.patch("#{BASE_PATH}/#{id}", body: options))
+      end
+    end
+  end
+end

data/lib/holivia/commands/item.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class Item < Base
+      BASE_PATH = "/api/v1/backoffice/slide_items"
+      MIME_TYPES = {
+        ".mp3" => "audio/mpeg",
+        ".mp4" => "audio/mp4",
+        ".wav" => "audio/wav",
+        ".ogg" => "audio/ogg",
+        ".flac" => "audio/flac",
+        ".aac" => "audio/aac",
+        ".m4a" => "audio/mp4",
+        ".webm" => "audio/webm"
+      }.freeze
+
+      def self.route(args)
+        subcommand = args.shift
+        case subcommand
+        when "create" then new.create(args)
+        when "update" then new.update(args)
+        else warn "Unknown selfcare item command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def create(args = []) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia selfcare item create [options]"
+          opts.on("--slide-id ID", Integer) { |v| options[:slide_id] = v }
+          opts.on("--item-type TYPE") { |v| options[:item_type] = v }
+          # RichTextItem
+          opts.on("--content CONTENT") { |v| options[:content] = v }
+          # VideoItem
+          opts.on("--url URL") { |v| options[:url] = v }
+          # WistiaItem
+          opts.on("--code CODE") { |v| options[:code] = v }
+          # QuizItem
+          opts.on("--form-url URL") { |v| options[:form_url] = v }
+          opts.on("--score-threshold N", Integer) { |v| options[:score_threshold] = v }
+          opts.on("--total-score N", Integer) { |v| options[:total_score] = v }
+          # MeditationItem / BreathingItem
+          opts.on("--title TITLE") { |v| options[:title] = v }
+          opts.on("--duration DURATION", Integer) { |v| options[:duration] = v }
+          opts.on("--subtitle SUBTITLE") { |v| options[:subtitle] = v }
+          # BreathingItem
+          opts.on("--cycles N", Integer) { |v| options[:cycles] = v }
+          opts.on("--start-delay N", Integer) { |v| options[:start_delay] = v }
+          opts.on("--sequence SEQUENCE") { |v| options[:sequence] = JSON.parse(v) }
+          # Audio file upload
+          opts.on("--audio FILE") { |v| options[:audio] = v }
+        end.parse!(args)
+        options = options.merge(piped_json)
+
+        abort "No options provided. Use --help for usage." if options.empty?
+        output(client.post(BASE_PATH, body: build_body(options)))
+      end
+
+      def update(args = []) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+        id = args.shift
+        abort "Usage: holivia selfcare item update <id> [options]" unless id
+
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia selfcare item update <id> [options]"
+          opts.on("--item-type TYPE") { |v| options[:item_type] = v }
+          opts.on("--content CONTENT") { |v| options[:content] = v }
+          opts.on("--url URL") { |v| options[:url] = v }
+          opts.on("--code CODE") { |v| options[:code] = v }
+          opts.on("--form-url URL") { |v| options[:form_url] = v }
+          opts.on("--score-threshold N", Integer) { |v| options[:score_threshold] = v }
+          opts.on("--total-score N", Integer) { |v| options[:total_score] = v }
+          opts.on("--title TITLE") { |v| options[:title] = v }
+          opts.on("--duration DURATION", Integer) { |v| options[:duration] = v }
+          opts.on("--subtitle SUBTITLE") { |v| options[:subtitle] = v }
+          opts.on("--cycles N", Integer) { |v| options[:cycles] = v }
+          opts.on("--start-delay N", Integer) { |v| options[:start_delay] = v }
+          opts.on("--sequence SEQUENCE") { |v| options[:sequence] = JSON.parse(v) }
+          opts.on("--audio FILE") { |v| options[:audio] = v }
+        end.parse!(args)
+        options = options.merge(piped_json)
+
+        abort "No options provided. Use --help for usage." if options.empty?
+        output(client.patch("#{BASE_PATH}/#{id}", body: build_body(options)))
+      end
+
+      private
+
+      def build_body(options)
+        audio_path = options.delete(:audio)
+        return options unless audio_path
+
+        mime = detect_mime(audio_path)
+        options.merge(audio: Faraday::Multipart::FilePart.new(audio_path, mime))
+      end
+
+      def detect_mime(path)
+        ext = File.extname(path).downcase
+        MIME_TYPES.fetch(ext, "application/octet-stream")
+      end
+    end
+  end
+end

data/lib/holivia/commands/selfcare.rb

@@ -1,14 +1,97 @@
 # frozen_string_literal: true
 
+require_relative "base"
+
 module Holivia
   module Commands
-    class Selfcare
+    class Selfcare < Base
       BASE_PATH = "/api/v1/backoffice/selfcare_contents"
+      COMPOSE_EXAMPLE_PATH = Holivia.root.join("examples", "compose.json").to_s
+
+      def self.route(args) # rubocop:disable Metrics/CyclomaticComplexity,Metrics/MethodLength,Metrics/AbcSize
+        subcommand = args.shift
+        case subcommand
+        when "index"   then new.index(args)
+        when "show"    then new.show(args)
+        when "create"  then new.create(args)
+        when "update"  then new.update(args)
+        when "compose" then new.compose(args)
+        when "schema"  then new.schema(args)
+        when "format"  then Format.route(args)
+        when "slide"   then Slide.route(args)
+        when "item"    then Item.route(args)
+        else warn "Unknown selfcare command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def index(_args = [])
+        output(client.get(BASE_PATH))
+      end
+
+      def show(args = [])
+        id = args.shift
+        abort "Usage: holivia selfcare show <id>" unless id
+
+        output(client.get("#{BASE_PATH}/#{id}"))
+      end
+
+      def create(args = []) # rubocop:disable Metrics/AbcSize
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia selfcare create [options]"
+          opts.on("--title TITLE") { |v| options[:title] = v }
+          opts.on("--locale LOCALE") { |v| options[:locale] = v }
+          opts.on("--content-type TYPE") { |v| options[:content_type] = v }
+          opts.on("--duration DURATION", Integer) { |v| options[:duration] = v }
+          opts.on("--description DESC") { |v| options[:description] = v }
+        end.parse!(args)
+        options = options.merge(piped_json)
+
+        abort "No options provided. Use --help for usage." if options.empty?
+        output(client.post(BASE_PATH, body: options))
+      end
+
+      def update(args = []) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+        id = args.shift
+        abort "Usage: holivia selfcare update <id> [options]" unless id
+
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia selfcare update <id> [options]"
+          opts.on("--title TITLE") { |v| options[:title] = v }
+          opts.on("--locale LOCALE") { |v| options[:locale] = v }
+          opts.on("--content-type TYPE") { |v| options[:content_type] = v }
+          opts.on("--duration DURATION", Integer) { |v| options[:duration] = v }
+          opts.on("--description DESC") { |v| options[:description] = v }
+        end.parse!(args)
+        options = options.merge(piped_json)
+
+        abort "No options provided. Use --help for usage." if options.empty?
+        output(client.patch("#{BASE_PATH}/#{id}", body: options))
+      end
+
+      def compose(args = []) # rubocop:disable Metrics/MethodLength
+        show_example = false
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia selfcare compose --file <path>"
+          opts.on("--file FILE") { |v| options = JSON.parse(File.read(v), symbolize_names: true) }
+          opts.on("--example", "Print a valid compose JSON template") { show_example = true }
+        end.parse!(args)
+
+        if show_example
+          puts File.read(COMPOSE_EXAMPLE_PATH)
+          return
+        end
+
+        options = options.merge(piped_json)
+        abort "Usage: holivia selfcare compose --file <path>" if options.empty?
+        output(client.post("#{BASE_PATH}/compose", body: options))
+      end
 
-      def index
-        client = Client.new
-        response = client.get(BASE_PATH)
-        puts JSON.pretty_generate(response)
+      def schema(_args = [])
+        output(client.get("#{BASE_PATH}/schema"))
       end
     end
   end

data/lib/holivia/commands/slide.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class Slide < Base
+      BASE_PATH = "/api/v1/backoffice/slides"
+
+      def self.route(args)
+        subcommand = args.shift
+        case subcommand
+        when "create" then new.create(args)
+        when "update" then new.update(args)
+        else warn "Unknown selfcare slide command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def create(args = [])
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia selfcare slide create [options]"
+          opts.on("--content-format-id ID", Integer) { |v| options[:content_format_id] = v }
+          opts.on("--title TITLE") { |v| options[:title] = v }
+          opts.on("--duration DURATION", Integer) { |v| options[:duration] = v }
+        end.parse!(args)
+        options = options.merge(piped_json)
+
+        abort "No options provided. Use --help for usage." if options.empty?
+        output(client.post(BASE_PATH, body: options))
+      end
+
+      def update(args = [])
+        id = args.shift
+        abort "Usage: holivia selfcare slide update <id> [options]" unless id
+
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia selfcare slide update <id> [options]"
+          opts.on("--title TITLE") { |v| options[:title] = v }
+          opts.on("--duration DURATION", Integer) { |v| options[:duration] = v }
+        end.parse!(args)
+        options = options.merge(piped_json)
+
+        abort "No options provided. Use --help for usage." if options.empty?
+        output(client.patch("#{BASE_PATH}/#{id}", body: options))
+      end
+    end
+  end
+end

data/lib/holivia/config_error.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Holivia
+  class ConfigError < StandardError; end
+end

data/lib/holivia/configuration.rb

@@ -1,13 +1,71 @@
 # frozen_string_literal: true
 
+require "yaml"
+require_relative "env_manager"
+
 module Holivia
   class Configuration
-    attr_accessor :base_url, :credentials_path, :debug
+    include EnvManager
+
+    CONFIG_DIR = File.expand_path("~/.holivia")
+    DEFAULT_ENV = "staging"
+    DEFAULT_URL = "https://staging.holivia.fr"
+
+    attr_reader :config_dir
+
+    def initialize(config_dir: CONFIG_DIR)
+      @config_dir = config_dir
+      @config = load_config
+    end
+
+    def current_env
+      @config["current_env"]
+    end
+
+    def environments
+      @config["environments"]
+    end
+
+    def base_url
+      environments.dig(current_env, "url")
+    end
+
+    def credentials_path
+      File.join(config_dir, "credentials.#{current_env}.json")
+    end
+
+    def debug?
+      environments.dig(current_env, "debug") == true
+    end
+
+    private
+
+    attr_reader :config
+
+    def config_path
+      File.join(config_dir, "config.yml")
+    end
+
+    def load_config
+      raw = YAML.safe_load_file(config_path)
+      validated_config(raw)
+    rescue Errno::ENOENT
+      default_config
+    end
+
+    def validated_config(raw)
+      return default_config unless raw.is_a?(Hash)
+      return default_config unless raw["environments"].is_a?(Hash)
+      return default_config unless raw["current_env"].is_a?(String)
+
+      raw
+    end
 
-    def initialize
-      @base_url = ENV.fetch("HOLIVIA_API_URL", "http://localhost:3000")
-      @credentials_path = File.expand_path("~/.holivia/credentials.json")
-      @debug = ENV["HOLIVIA_DEBUG"] == "true"
+    def default_config
+      {
+        "current_env" => DEFAULT_ENV,
+        "environments" => { DEFAULT_ENV => { "url" => DEFAULT_URL } }
+      }
     end
   end
 end

data/lib/holivia/env_manager.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require "yaml"
+require "fileutils"
+
+module Holivia
+  module EnvManager
+    def add_env(name, url:, debug: nil)
+      env = { "url" => url }
+      env["debug"] = debug unless debug.nil?
+      config["environments"][name] = env
+      config["current_env"] = name if config["environments"].size == 1
+      save_config
+    end
+
+    def use_env(name)
+      raise ConfigError, "Unknown environment '#{name}'" unless config["environments"].key?(name)
+
+      config["current_env"] = name
+      save_config
+    end
+
+    def update_env(name, **attrs)
+      raise ConfigError, "Unknown environment '#{name}'" unless config["environments"].key?(name)
+
+      attrs.each { |k, v| config["environments"][name][k.to_s] = v }
+      save_config
+    end
+
+    def remove_env(name)
+      raise ConfigError, "Cannot remove '#{name}' — it is the only environment" if config["environments"].size == 1
+
+      config["environments"].delete(name)
+      config["current_env"] = config["environments"].keys.first if name == current_env
+      FileUtils.rm_f(File.join(config_dir, "credentials.#{name}.json"))
+      save_config
+    end
+
+    private
+
+    def save_config
+      FileUtils.mkdir_p(config_dir)
+      File.write(config_path, YAML.dump(config))
+    end
+  end
+end

data/lib/holivia/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Holivia
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/holivia.rb

@@ -1,8 +1,10 @@
 # frozen_string_literal: true
 
+require "pathname"
 require_relative "holivia/version"
 require_relative "holivia/configuration"
 require_relative "holivia/api_error"
+require_relative "holivia/config_error"
 require_relative "holivia/client"
 require_relative "holivia/auth"
 
@@ -10,12 +12,12 @@ module Holivia
   class << self
     attr_writer :configuration
 
-    def configuration
-      @configuration ||= Configuration.new
+    def root
+      Pathname.new(File.expand_path("..", __dir__))
     end
 
-    def configure
-      yield(configuration)
+    def configuration
+      @configuration ||= Configuration.new
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: holivia
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Holivia
@@ -23,6 +23,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-multipart
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 description: API client library and command-line tool for the Holivia platform
 email:
 - dev@holivia.fr
@@ -38,15 +52,25 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- example_content.xml
+- examples/compose.json
 - exe/holivia
 - lib/holivia.rb
 - lib/holivia/api_error.rb
 - lib/holivia/auth.rb
 - lib/holivia/cli.rb
+- lib/holivia/cli/help.rb
 - lib/holivia/client.rb
 - lib/holivia/commands/auth.rb
+- lib/holivia/commands/base.rb
+- lib/holivia/commands/env.rb
+- lib/holivia/commands/format.rb
+- lib/holivia/commands/item.rb
 - lib/holivia/commands/selfcare.rb
+- lib/holivia/commands/slide.rb
+- lib/holivia/config_error.rb
 - lib/holivia/configuration.rb
+- lib/holivia/env_manager.rb
 - lib/holivia/version.rb
 - mise.toml
 - sig/holivia.rbs