dexiecable 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 353c08fde431ac528532ebc11a99911154654988345d6c7fdddb479269a65194
-  data.tar.gz: ec8e1ab7b1d4f0ea74cc8da8346337cee2b9f82192de966ccc653aedd5f96a38
+  metadata.gz: dc22d844e30147740e885b5959d13a6f42c47ff9551490f4b8e61701b1481676
+  data.tar.gz: 5d82c9e2f8453aa038db8b7eb5997134e56431da93a62ecb30190e5eebef63a2
 SHA512:
-  metadata.gz: c1fabe1bc7d3aa4f16855ffc9f3d1dff472c0488b8b2959745b02225bd5503c3b9e43ea2cc253bc306c742633b5e85da4400b760072d5776f2e925d66cac0529
-  data.tar.gz: 0d3c51e4d95f3848c244a0793cd77c2de817646ebef18c79705a42d2cfb4f5e729bbbbf8de466b1cc9f04e79d3f392a1c096f8968746a0c49077b00dee44d502
+  metadata.gz: 18eb395292b406e4f0cd690eafcf9dc68ac5b39cac89c459e0685c95e7cfe42bd551348c3146df1dcd596405b6198c15ecba41ba9e48abceee8068cd65f020ac
+  data.tar.gz: b2135050a6a827ac7e0c596ed64ad8d6d568ad6f18d278a6b8c819c464564a110396fc76c597985d1d4cc4e1be2ddd0b4aab1aa9b58fb4a5b1663509a9762a7d

data/README.md

@@ -100,18 +100,20 @@ Any Dexie.js write operation triggers an immediate broadcast:
 # Single insert
 UserChannel[current_user].table("messages").add(id: 1, text: "hello")
 
-# Filtered bulk insert
-UserChannel[current_user]
-  .table("messages")
-  .where(:room_id).equals(room.id)
-  .bulkAdd(messages)
+# Bulk insert
+UserChannel[current_user].table("messages").bulkAdd(messages)
 
-# Update
+# Update (using modify)
 UserChannel[current_user]
   .table("messages")
   .where(:id).equals(msg.id)
   .modify(read: true)
 
+# Update (using update)
+UserChannel[current_user]
+  .table("messages")
+  .update(msg.id, text: "updated text")
+
 # Delete
 UserChannel[current_user]
   .table("messages")
@@ -129,7 +131,7 @@ Add to any ActiveRecord model:
 class Message < ApplicationRecord
   syncs_to_dexie via: -> { UserChannel[sender] }
   syncs_to_dexie via: -> { UserChannel[receiver] }
-  syncs_to_dexie via: PublicChannel  # broadcast to all connected clients
+  syncs_to_dexie via: RoomChannel['public']
 end
 ```
 
@@ -143,9 +145,23 @@ end
 
 | Option | Default | Description |
 |---|---|---|
-| `via:` | *(required)* | Proc (evaluated in record context), channel class, or channel instance |
+| `via:` | *(required)* | Proc (evaluated in record context), or channel instance |
 | `table:` | model's `table_name` | Override the Dexie table name. A Proc is evaluated in the record's context. |
 | `only:` | `[:create, :update, :destroy]` | Limit which events trigger a sync |
+| `if:` | *(none)* | Symbol (method name) or Proc — only sync when it returns truthy |
+| `unless:` | *(none)* | Symbol (method name) or Proc — skip sync when it returns truthy |
+
+You can combine multiple `syncs_to_dexie` declarations, each with different conditions:
+
+```ruby
+class Message < ApplicationRecord
+  syncs_to_dexie via: -> { UserChannel[sender] },
+                 if: :published?
+
+  syncs_to_dexie via: -> { AdminChannel },
+                 unless: -> { draft? }
+end
+```
 
 #### Customizing the synced payload
 

data/lib/dexiecable/active_record_ext.rb

@@ -22,16 +22,21 @@ module DexieCable
       #                evaluated in the record's context.
       # @param only   [Array<Symbol>] Limit which lifecycle events sync.
       #                Default: [:create, :update, :destroy].
-      def syncs_to_dexie(via:, table: nil, only: nil)
-        events = Array(only || %i[create update destroy])
+      # @param if     [Symbol, Proc] Only sync if the given method or proc
+      #                returns truthy (evaluated in the record's context).
+      # @param unless [Symbol, Proc] Skip sync if the given method or proc
+      #                returns truthy (evaluated in the record's context).
+      def syncs_to_dexie(via:, table: nil, only: nil, **options)
+        events     = Array(only || %i[create update destroy])
+        conditions = options.slice(:if, :unless)
 
         @dexie_sync_configs ||= []
-        @dexie_sync_configs << { via: via, table: table, only: events }
+        @dexie_sync_configs << { via: via, table: table, only: events, **conditions }
 
         if events.include?(:destroy)
           before_destroy :dexie_sync_before_destroy
 
-          after_commit on: :destroy do
+          after_commit on: :destroy, **conditions do
             channel = resolve_channel(via)
             next unless channel
             channel.table(resolve_table(table)).delete(dexie_destroy_id)
@@ -39,7 +44,7 @@ module DexieCable
         end
 
         if events.include?(:create)
-          after_commit on: :create do
+          after_commit on: :create, **conditions do
             channel = resolve_channel(via)
             next unless channel
             channel.table(resolve_table(table)).add(as_json_for_dexie)
@@ -47,7 +52,7 @@ module DexieCable
         end
 
         if events.include?(:update)
-          after_commit on: :update do
+          after_commit on: :update, **conditions do
             channel = resolve_channel(via)
             next unless channel
 

data/lib/dexiecable/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DexieCable
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dexiecable
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Stefan Buhrmester