holivia 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 88e7b483f29ede5b8d719e09e0e64014979b01fbe4f46e3476131d5f04cf6dd4
-  data.tar.gz: 51142c7c75c2917c065e7eb99b9c5162d3c08e435722acdf2f532bcc4b17d2e7
+  metadata.gz: 61c8a59293a0b4cfb43dca7bad3c64694c75582875dff6198efea295712a1477
+  data.tar.gz: 9795ce32e8ada6e69eeedbb24549f711120ec6caa491d89fb86605bd2ecbb4a2
 SHA512:
-  metadata.gz: 2b35a23633a3f1fd43dd849297c49f2bf836d237575ccd797fdd63274743b06cabd66a8c082cb82b14992270cb1f5c1048c0fce32cd7f8c1c12032dca529ae9e
-  data.tar.gz: 4fd44133555a0453e2e21b4daad51d1ba5a7e5e42bfba0f8bce98f0b1c245af8bbcc0913a0e74964ed2c690506d12ad3fbee4a15138c52f7bcc2a5478c8aa446
+  metadata.gz: 8e68ebf330b241d4eae1d048d415adb2f6f6b551d63bed270e0ab17610535672e323a26a4c85b904e338613d48b87f88f59a9920866fc6f9dd3299229907f348
+  data.tar.gz: 9b431f54025a5420fada21b6769063b06f1da5e02cb1b5e09dc1b28bcadc534847758441fad1090b945c412c99fe9aeb24ae8c433792eaad2e4a69aba6a5c186

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.7.0] - 2026-07-02
+
+- Add `holivia communication` commands for communication library CRUD, publishing, schema discovery, and document/cover uploads
+
 ## [0.6.0] - 2026-06-05
 
 - Add `holivia appointment video-diagnostics <id>` for appointment video diagnostics

data/README.md

@@ -2,7 +2,7 @@
 
 Ruby client and command-line interface for the Holivia API.
 
-The `holivia` executable is primarily used to manage Holivia backoffice data from the terminal: environments, authentication, selfcare content, objectives, and appointment diagnostics.
+The `holivia` executable is primarily used to manage Holivia backoffice data from the terminal: environments, authentication, selfcare content, objectives, communication library items, and appointment diagnostics.
 
 Coding agents can use [`SKILL.md`](SKILL.md) as a downloadable usage guide for operating this CLI safely.
 
@@ -166,6 +166,29 @@ Show video diagnostics for an appointment:
 holivia appointment video-diagnostics 42
 ```
 
+List communication library items:
+
+```bash
+holivia communication index --locale fr --document-type poster
+```
+
+Create a communication item:
+
+```bash
+holivia communication create \
+  --title "Launch poster" \
+  --locale fr \
+  --document-type poster \
+  --document launch-poster.pdf \
+  --cover-image cover.png
+```
+
+Publish it:
+
+```bash
+holivia communication publish 123
+```
+
 ## Files And Uploads
 
 Selfcare create and update commands can upload images with `--image <path>`.
@@ -182,6 +205,8 @@ holivia selfcare item create --slide-id 456 --item-type AudioItem --audio medita
 
 Compose is JSON-only. To attach an image to a composed content tree, update the returned content id afterward with `holivia selfcare update <id> --image <path>`.
 
+Communication item create and update commands upload the required document with `--document <path>` and can upload or replace the cover image with `--cover-image <path>`.
+
 ## Development
 
 After checking out the repo, run:

data/lib/holivia/cli/help.rb

@@ -49,6 +49,17 @@ module Holivia
           holivia objective show <id>                                  Show one objective
           Translated fields are returned in the default locale (fr).
 
+        Communication Items:
+          holivia communication index [--page N --per-page N --query TEXT --locale LOCALE --document-type TYPE]
+                                                List communication library items
+          holivia communication show <id>       Show one communication item
+          holivia communication create [options] Create a communication item with a required document upload
+          holivia communication update <id> [options] Update metadata or replace uploads
+          holivia communication publish <id>    Publish a draft communication item
+          holivia communication unpublish <id>  Unpublish a communication item and clear published_at
+          holivia communication delete <id>     Delete a communication item
+          holivia communication schema          Show allowed document_types and locales
+
         Appointments:
           holivia appointment video-diagnostics <id>  Show video diagnostics for an appointment
 
@@ -89,6 +100,8 @@ module Holivia
           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.
+          Communication uploads use --document <path> and optional --cover-image <path>.
+          The API validates accepted communication upload formats and file sizes.
           Compose is JSON-only — to attach an image to a composed tree, PATCH the returned id:
             holivia selfcare update <id> --image <path>
 

data/lib/holivia/cli.rb

@@ -10,6 +10,7 @@ require_relative "commands/env"
 require_relative "commands/item"
 require_relative "commands/objective"
 require_relative "commands/appointment"
+require_relative "commands/communication_item"
 
 module Holivia
   class CLI
@@ -22,6 +23,7 @@ module Holivia
       when "selfcare" then Commands::Selfcare.route(args)
       when "objective" then Commands::Objective.route(args)
       when "appointment" then Commands::Appointment.route(args)
+      when "communication" then Commands::CommunicationItem.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/communication_item.rb

@@ -0,0 +1,145 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Holivia
+  module Commands
+    class CommunicationItem < Base # rubocop:disable Metrics/ClassLength
+      BASE_PATH = "/api/v1/backoffice/communication_items"
+      CONTENT_TYPE_BY_EXTENSION = {
+        ".gif" => "image/gif",
+        ".jpeg" => "image/jpeg",
+        ".jpg" => "image/jpeg",
+        ".mov" => "video/quicktime",
+        ".mp4" => "video/mp4",
+        ".pdf" => "application/pdf",
+        ".png" => "image/png",
+        ".ppt" => "application/vnd.ms-powerpoint",
+        ".pptx" => "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+        ".webm" => "video/webm",
+        ".webp" => "image/webp",
+        ".zip" => "application/zip"
+      }.freeze
+
+      def self.route(args) # rubocop:disable Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/MethodLength
+        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 "publish" then new.publish(args)
+        when "unpublish" then new.unpublish(args)
+        when "delete" then new.delete(args)
+        when "schema" then new.schema(args)
+        else warn "Unknown communication command: #{subcommand}"
+             exit 1
+        end
+      end
+
+      def index(args = []) # rubocop:disable Metrics/AbcSize
+        params = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia communication index [options]"
+          opts.on("--page N", Integer) { |v| params[:page] = v }
+          opts.on("--per-page N", Integer) { |v| params[:per_page] = v }
+          opts.on("--query TEXT") { |v| params[:query] = v }
+          opts.on("--locale LOCALE") { |v| params[:locale] = v }
+          opts.on("--document-type TYPE") { |v| params[:document_type] = v }
+        end.parse!(args)
+
+        output(client.get(BASE_PATH, params: params))
+      end
+
+      def show(args = [])
+        id = args.shift
+        abort "Usage: holivia communication show <id>" unless id
+
+        output(client.get("#{BASE_PATH}/#{id}"))
+      end
+
+      def create(args = [])
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia communication create [options]"
+          add_write_options(opts, options)
+        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 = [])
+        id = args.shift
+        abort "Usage: holivia communication update <id> [options]" unless id
+
+        options = {}
+        OptionParser.new do |opts|
+          opts.banner = "Usage: holivia communication update <id> [options]"
+          add_write_options(opts, options)
+        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
+
+      def publish(args = [])
+        transition(args, "publish")
+      end
+
+      def unpublish(args = [])
+        transition(args, "unpublish")
+      end
+
+      def delete(args = [])
+        id = args.shift
+        abort "Usage: holivia communication delete <id>" unless id
+
+        client.delete("#{BASE_PATH}/#{id}")
+        output(deleted: true, id: id.to_i)
+      end
+
+      def schema(_args = [])
+        output(client.get("#{BASE_PATH}/schema"))
+      end
+
+      private
+
+      def add_write_options(opts, options)
+        opts.on("--title TITLE") { |v| options[:title] = v }
+        opts.on("--description DESC") { |v| options[:description] = v }
+        opts.on("--document-type TYPE") { |v| options[:document_type] = v }
+        opts.on("--locale LOCALE") { |v| options[:locale] = v }
+        opts.on("--cover-image FILE") { |v| options[:cover_image] = v }
+        opts.on("--document FILE") { |v| options[:document] = v }
+      end
+
+      def transition(args, event)
+        id = args.shift
+        abort "Usage: holivia communication #{event} <id>" unless id
+
+        output(client.patch("#{BASE_PATH}/#{id}/#{event}"))
+      end
+
+      def build_body(options)
+        options = options.dup
+        attach_file_part(options, :cover_image)
+        attach_file_part(options, :document)
+        options
+      end
+
+      def attach_file_part(options, key)
+        path = options[key]
+        return unless path
+
+        options[key] = Faraday::Multipart::FilePart.new(path, detect_mime(path))
+      end
+
+      def detect_mime(path)
+        CONTENT_TYPE_BY_EXTENSION.fetch(File.extname(path).downcase, "application/octet-stream")
+      end
+    end
+  end
+end

data/lib/holivia/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: holivia
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Holivia
@@ -65,6 +65,7 @@ files:
 - lib/holivia/commands/appointment.rb
 - lib/holivia/commands/auth.rb
 - lib/holivia/commands/base.rb
+- lib/holivia/commands/communication_item.rb
 - lib/holivia/commands/env.rb
 - lib/holivia/commands/format.rb
 - lib/holivia/commands/item.rb