helios-videos 0.2.2 → 0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 90c90412e0be6b8438feb0129620e91766d5b2f0fa15722bb00fe3a03c80a8a0
-  data.tar.gz: 5b82e8bb7682216178fc888d30d66b9f1eb4746a5a495857356ce72b2cd2ada2
+  metadata.gz: 8c03ed3c9ea414e292983ce7c1f1d1ac495856f33aaa6905038f8ded18ddaa66
+  data.tar.gz: 6deccbb50d252ecb25d463d4c906d14de211d5aafabf8c66a20aa720e46d7063
 SHA512:
-  metadata.gz: 12b78de84b83372472d8f66ebdf008927bf79539922de8c3a5cf6544a12ed48d69e6d5cc92c5c16a39595cfc99a673efa2f04a0d80fa2b96999926e0721d1528
-  data.tar.gz: 25c95116eaa741366cd243523e8548a60377abae2180b118ef173dfd08958d84b41de43c072177be11e068d34f7c2e55abbf90670d3fb88c913726fc38d8a73b
+  metadata.gz: f39a5f944414c430914414159a88a40e364068d4a0dc202fe8c6a4bc3d68ff1e6c3df3d426817964855d32dc752b6d1e4b84f7c5bd4d9412fae6e1b734461eb2
+  data.tar.gz: 87cdb6e6e05b8c45e643a901b56bd94b463b428e64402f27dc64d84e5558e41a5ebe3e7b799e79417db99cda97bd89aac12801bd5be5f595cb640a18f978ef89

data/README.md

@@ -18,7 +18,11 @@ bin/rails helios_videos:install:migrations
 bin/rails db:migrate
 ```
 
-**Prerequisites:** Your host app must have ActiveStorage installed (`bin/rails active_storage:install`).
+**Prerequisites:**
+- ActiveStorage must be installed in your host app (`bin/rails active_storage:install`)
+- Add the Ruby gem for your chosen video processor to your **host app's Gemfile**:
+  - **Mux**: `gem "mux_ruby"`
+  - **Cloudflare**: no additional gem needed (uses HTTP API directly)
 
 ## Configuration
 
@@ -195,15 +199,34 @@ Helios::Videos::Migration::ConvertVideoJob.perform_later(
 )
 ```
 
-## JavaScript
+## JavaScript Setup
 
-If your host app needs the video block Stimulus controller:
+Your host app must import the Stimulus controller and the video player library for your chosen processor.
+
+### Mux
+
+```javascript
+import '@mux/mux-player'  // Required — registers the <mux-player> custom element
+
+import { HeliosVideoBlockController } from "helios/videos"
+application.register("helios-video-block", HeliosVideoBlockController)
+```
+
+**npm dependency** (add to your host app's `package.json`):
+
+```bash
+yarn add @mux/mux-player
+```
+
+### Cloudflare
 
 ```javascript
 import { HeliosVideoBlockController } from "helios/videos"
-application.register("video-block", HeliosVideoBlockController)
+application.register("helios-video-block", HeliosVideoBlockController)
 ```
 
+No additional npm packages are needed for Cloudflare — it uses a standard `<video>` element with HLS.
+
 ### Vite
 
 If your host app uses Vite, add an alias so Vite can resolve the gem's JavaScript:

data/db/migrate/20250510000001_create_helios_videos_videos.rb

@@ -1,12 +1,14 @@
 class CreateHeliosVideosVideos < ActiveRecord::Migration[8.0]
   def change
-    create_table :helios_videos_videos do |t|
+    primary_key_type, foreign_key_type = primary_and_foreign_key_types
+
+    create_table :helios_videos_videos, id: primary_key_type do |t|
       t.string :name
       t.string :key
       t.jsonb :playback_urls
       t.boolean :requires_signed_urls, default: false, null: false
       t.string :provider
-      t.integer :block_id
+      t.column :block_id, foreign_key_type
 
       t.timestamps
     end
@@ -15,4 +17,14 @@ class CreateHeliosVideosVideos < ActiveRecord::Migration[8.0]
     add_index :helios_videos_videos, :key, unique: true
     add_index :helios_videos_videos, :provider
   end
+
+  private
+
+  def primary_and_foreign_key_types
+    config = Rails.configuration.generators
+    setting = config.options[config.orm][:primary_key_type]
+    primary_key_type = setting || :primary_key
+    foreign_key_type = setting || :bigint
+    [primary_key_type, foreign_key_type]
+  end
 end

data/lib/helios/videos/version.rb

@@ -1,5 +1,5 @@
 module Helios
   module Videos
-    VERSION = "0.2.2"
+    VERSION = "0.3"
   end
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: helios-videos
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: '0.3'
 platform: ruby
 authors:
 - Jason Fleetwood-Boldt
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-05-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -83,6 +84,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/heliosdev/helios-videos
   source_code_uri: https://github.com/heliosdev/helios-videos
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -97,7 +99,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.4.19
+signing_key:
 specification_version: 4
 summary: Video upload, processing, and streaming for Rails via Mux or Cloudflare Stream
 test_files: []