holivia 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e2d692d4098918b86e1fb733a303c51b8bde37583841b2f97f11bf58b2da880
-  data.tar.gz: 14095f6175eb6fdae474eeb6b31c0b4c856a675da375461d8d5a0748c27ec022
+  metadata.gz: 83d3ab262bb3fc4381d4ca420e6186ef577ce8e40db802b0658209e2ea0599b5
+  data.tar.gz: 36813fba6ea7c7cdb25d6b5cbfc97905226959e956fa02a146c9d60a54357898
 SHA512:
-  metadata.gz: a881a29e44e585bee272a5fe5def48a57b089ca81be00c9ee9d54da355ecd8273c4befbedd98e26d77a978baa0a37b5b12d2a2f1af03afac10519e85e291053f
-  data.tar.gz: 1478b0f331188b5b5043f01ab4e80643b173f69bb04adeefeba87d37a28ceda194d66fb7c701034298ad2257d6afae38131990b760829c0ba332ab586425ff1a
+  metadata.gz: 36d0c89c7d469290018d121ada800c8bf4da4fcc6af6918930c5907c283786b5aded11979050a0f6ef9fb19c127bdebb789e3b014eb09c842c568eb404421f05
+  data.tar.gz: 8e9086a2a046deec0170ec502391c8cda726963933d8597159aa98ce498e21d88a0e6aebe059606ae07387cad8655be6f88449ed3035cee1d6a161dfff316044

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 ## [Unreleased]
 
+## [0.5.0] - 2026-05-06
+
+- Add `--state` flag on `selfcare create` and `selfcare update` for AASM-driven lifecycle transitions
+- Add top-level `holivia objective` commands (`index`, `show`) for the read-only Objective resource
+- Add `holivia selfcare objective` CRUD (`index`, `show`, `create`, `update`, `delete`) for the selfcare↔objective join, with `delete` printing `{deleted: true, id: <id>}` on 204
+- Update compose example and help text to document inline `objectives` array on compose/update payloads
+- Update help text to surface the `states` and `objective_tiers` keys returned by `selfcare schema`
+
+## [0.4.0] - 2026-04-28
+
+- Add `--image FILE` flag on `selfcare create` and `selfcare update` for multipart image uploads
+- Update help text with image upload usage and the compose-then-PATCH attach flow
+
 ## [0.3.0] - 2026-03-11
 
 - Add multi-environment support with `~/.holivia/config.yml`

data/examples/compose.json

@@ -5,6 +5,11 @@
   "goal": "Comprendre et réduire le stress",
   "content_type": "video_type",
   "locale": "fr",
+  "state": "published",
+  "objectives": [
+    { "objective_id": 18, "tier": "main" },
+    { "objective_id": 19, "tier": "secondary" }
+  ],
   "formats": [
     {
       "format_type": "video",

data/lib/holivia/cli/help.rb

@@ -25,9 +25,12 @@ module Holivia
           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
+                                                 (--state draft|ongoing_translation|translation_to_be_reviewed|
+                                                  translation_reviewed|published)
+          holivia selfcare update <id> [options] Update a selfcare content (same --state values)
           holivia selfcare compose               Create a full content tree atomically (no audio)
-          holivia selfcare schema                Show allowed values for content_types, format_types, item_types
+          holivia selfcare schema                Show allowed values for content_types, format_types,
+                                                 item_types, states, objective_tiers
 
         Content Formats:
           holivia selfcare format create [options]      Add a format to a selfcare content
@@ -41,6 +44,22 @@ module Holivia
           holivia selfcare item create [options]        Add an item to a slide
           holivia selfcare item update <id> [options]   Update a slide item
 
+        Objectives:
+          holivia objective index [--page N --per-page N --code CODE]  List objectives
+          holivia objective show <id>                                  Show one objective
+          Translated fields are returned in the default locale (fr).
+
+        Selfcare Content Objectives:
+          holivia selfcare objective index [--page N --per-page N --selfcare-content-id ID --objective-id ID]
+                                                List a selfcare content's associated objectives
+          holivia selfcare objective show <id>          Show one selfcare content objective
+          holivia selfcare objective create --selfcare-content-id ID --objective-id ID [--tier main|secondary]
+                                                Associate an objective to a selfcare content (tier defaults to main)
+          holivia selfcare objective update <id> --tier main|secondary  Change the tier
+          holivia selfcare objective delete <id>        Dissociate an objective from a selfcare content
+          Inline alternative: include "objectives": [{ "objective_id": ID, "tier": "main" }, ...] in the
+          JSON payload of compose/update. On update, [] clears the list; omitting the key leaves it untouched.
+
         Data Model:
           SelfcareContent → ContentFormat (format_type: text, audio, video)
             → Slide (title, duration) → SlideItem (one of: RichTextItem, VideoItem,
@@ -65,6 +84,10 @@ module Holivia
           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.
+          Image uploads use --image <path> on selfcare create/update (sent as multipart/form-data).
+          Accepted image formats: JPEG, PNG, WebP, GIF. Max size: 5 MB.
+          Compose is JSON-only — to attach an image to a composed tree, PATCH the returned id:
+            holivia selfcare update <id> --image <path>
 
         Errors:
           Validation errors (422) show structured details:

data/lib/holivia/cli.rb

@@ -8,16 +8,18 @@ require_relative "commands/format"
 require_relative "commands/slide"
 require_relative "commands/env"
 require_relative "commands/item"
+require_relative "commands/objective"
 
 module Holivia
   class CLI
-    def self.start(args)
+    def self.start(args) # rubocop:disable Metrics/CyclomaticComplexity
       command = args.shift
       case command
       when "login" then Commands::Auth.new.login(args)
       when "logout" then Commands::Auth.new.logout
       when "env" then Commands::Env.route(args)
       when "selfcare" then Commands::Selfcare.route(args)
+      when "objective" then Commands::Objective.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}"

data/lib/holivia/commands/objective.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class Objective < Base
+      BASE_PATH = "/api/v1/backoffice/objectives"
+
+      def self.route(args)
+        subcommand = args.shift
+        case subcommand
+        when "index" then new.index(args)
+        when "show"  then new.show(args)
+        else warn "Unknown objective command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def index(args = [])
+        params = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia objective index [options]"
+          opts.on("--page N", Integer) { |v| params[:page] = v }
+          opts.on("--per-page N", Integer) { |v| params[:per_page] = v }
+          opts.on("--code CODE") { |v| params[:code] = v }
+        end.parse!(args)
+
+        output(client.get(BASE_PATH, params: params))
+      end
+
+      def show(args = [])
+        id = args.shift
+        abort "Usage: holivia objective show <id>" unless id
+
+        output(client.get("#{BASE_PATH}/#{id}"))
+      end
+    end
+  end
+end

data/lib/holivia/commands/selfcare.rb

@@ -1,12 +1,20 @@
 # frozen_string_literal: true
 
 require_relative "base"
+require_relative "selfcare_objective"
 
 module Holivia
   module Commands
     class Selfcare < Base
       BASE_PATH = "/api/v1/backoffice/selfcare_contents"
       COMPOSE_EXAMPLE_PATH = Holivia.root.join("examples", "compose.json").to_s
+      IMAGE_MIME_TYPES = {
+        ".jpg" => "image/jpeg",
+        ".jpeg" => "image/jpeg",
+        ".png" => "image/png",
+        ".webp" => "image/webp",
+        ".gif" => "image/gif"
+      }.freeze
 
       def self.route(args) # rubocop:disable Metrics/CyclomaticComplexity,Metrics/MethodLength,Metrics/AbcSize
         subcommand = args.shift
@@ -20,6 +28,7 @@ module Holivia
         when "format"  then Format.route(args)
         when "slide"   then Slide.route(args)
         when "item"    then Item.route(args)
+        when "objective" then SelfcareObjective.route(args)
         else warn "Unknown selfcare command: #{subcommand}"
              exit 1
         end
@@ -36,7 +45,7 @@ module Holivia
         output(client.get("#{BASE_PATH}/#{id}"))
       end
 
-      def create(args = []) # rubocop:disable Metrics/AbcSize
+      def create(args = []) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
         options = {}
         OptionParser.new do |opts|
           opts.banner = "Usage: holivia selfcare create [options]"
@@ -45,11 +54,13 @@ module Holivia
           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 }
+          opts.on("--image FILE") { |v| options[:image] = v }
+          opts.on("--state STATE") { |v| options[:state] = 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))
+        output(client.post(BASE_PATH, body: build_body(options)))
       end
 
       def update(args = []) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
@@ -64,11 +75,13 @@ module Holivia
           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 }
+          opts.on("--image FILE") { |v| options[:image] = v }
+          opts.on("--state STATE") { |v| options[:state] = 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))
+        output(client.patch("#{BASE_PATH}/#{id}", body: build_body(options)))
       end
 
       def compose(args = []) # rubocop:disable Metrics/MethodLength
@@ -93,6 +106,20 @@ module Holivia
       def schema(_args = [])
         output(client.get("#{BASE_PATH}/schema"))
       end
+
+      private
+
+      def build_body(options)
+        image_path = options.delete(:image)
+        return options unless image_path
+
+        options.merge(image: Faraday::Multipart::FilePart.new(image_path, detect_mime(image_path)))
+      end
+
+      def detect_mime(path)
+        ext = File.extname(path).downcase
+        IMAGE_MIME_TYPES.fetch(ext, "application/octet-stream")
+      end
     end
   end
 end

data/lib/holivia/commands/selfcare_objective.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class SelfcareObjective < Base
+      BASE_PATH = "/api/v1/backoffice/selfcare_content_objectives"
+
+      def self.route(args)
+        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 "delete" then new.delete(args)
+        else warn "Unknown selfcare objective command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def index(args = [])
+        params = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia selfcare objective index [options]"
+          opts.on("--page N", Integer) { |v| params[:page] = v }
+          opts.on("--per-page N", Integer) { |v| params[:per_page] = v }
+          opts.on("--selfcare-content-id ID", Integer) { |v| params[:selfcare_content_id] = v }
+          opts.on("--objective-id ID", Integer) { |v| params[:objective_id] = v }
+        end.parse!(args)
+
+        output(client.get(BASE_PATH, params: params))
+      end
+
+      def show(args = [])
+        id = args.shift
+        abort "Usage: holivia selfcare objective show <id>" unless id
+
+        output(client.get("#{BASE_PATH}/#{id}"))
+      end
+
+      def create(args = [])
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia selfcare objective create [options]"
+          opts.on("--selfcare-content-id ID", Integer) { |v| options[:selfcare_content_id] = v }
+          opts.on("--objective-id ID", Integer) { |v| options[:objective_id] = v }
+          opts.on("--tier TIER") { |v| options[:tier] = 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 objective update <id> [options]" unless id
+
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia selfcare objective update <id> [options]"
+          opts.on("--tier TIER") { |v| options[:tier] = 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 delete(args = [])
+        id = args.shift
+        abort "Usage: holivia selfcare objective delete <id>" unless id
+
+        client.delete("#{BASE_PATH}/#{id}")
+        output(deleted: true, id: id.to_i)
+      end
+    end
+  end
+end

data/lib/holivia/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: holivia
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Holivia
@@ -66,7 +66,9 @@ files:
 - lib/holivia/commands/env.rb
 - lib/holivia/commands/format.rb
 - lib/holivia/commands/item.rb
+- lib/holivia/commands/objective.rb
 - lib/holivia/commands/selfcare.rb
+- lib/holivia/commands/selfcare_objective.rb
 - lib/holivia/commands/slide.rb
 - lib/holivia/config_error.rb
 - lib/holivia/configuration.rb