live 0.13.1 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf47630cac82b5611f454d7c61b1db67d8802c91eabc819d44d2e1a82ffd1d96
-  data.tar.gz: ce5bcd2dd5a5bc0c98357eb963aaa38ff83c4e312da85c0f3b4e79ca546e6d72
+  metadata.gz: 63034baadcba271590245009b106e82bc142734cbc4978d7a47c264a8368d92c
+  data.tar.gz: ddb382c9499a3560ece8341a61e6d78076b2b2544fbb7ff3de1371e315e321bd
 SHA512:
-  metadata.gz: cd5eaca0a5038361c60d13de5bc8b5e8e5ce66f0e828c74c0c199d6a8d9706bee31fbeff1365155b41b59241c2be4f405f6d1186c44b928510d1d94ad7e42000
-  data.tar.gz: 0f0956b2f4a4d79af54ee01e965585d370633eac1ad23ded24c817e43f0b7b8dd681a5187607fe2fdf4fa52be385f4c20ec25a09c55ceee5c00fe846c8a4cde1
+  metadata.gz: c8c7edabe0b494d83b0260e803cf39899eb4a2bd91a8eba9e714ccf255f23cd7bb76ee19df9811bc255f316cc113c67fa9814b0152fcd0d05382e3c5e8f93877
+  data.tar.gz: d4e8a3bfebf1bd77374cba4bac80d428b218834c2f0acb773268093aeb14ea14f3131194533c7a8aa0094431d20ee224f584d4babe6c27d9e7852119223cb578

data/lib/live/element.rb

@@ -79,7 +79,7 @@ module Live
 		def rpc(*arguments)
 			if @page
 				# This update might not be sent right away. Therefore, mutable arguments may be serialized to JSON at a later time (or never). This could be a race condition:
-				@page.updates.enqueue(arguments)
+				@page.enqueue(arguments)
 			else
 				# This is a programming error, as it probably means the element is still part of the logic of the server side (e.g. async loop), but it is not bound to a page, so there is nothing to update/access/rpc.
 				raise PageError, "Element is not bound to a page, make sure to implement #close!"

data/lib/live/page.rb

@@ -27,9 +27,6 @@ module Live
 			@updates = Async::Queue.new
 		end
 		
-		# The queue of outstanding events to be sent to the client.
-		attr :updates
-		
 		# Bind a client-side element to a server side element.
 		# @parameter element [Live::Element] The element to bind.
 		def bind(element)
@@ -84,6 +81,10 @@ module Live
 			end
 		end
 		
+		def enqueue(update)
+			@updates.enqueue(::Protocol::WebSocket::TextMessage.generate(update))
+		end
+		
 		# Process a single incoming message from the network.
 		def process_message(message)
 			case message[0]
@@ -93,7 +94,7 @@ module Live
 					self.bind(element)
 				else
 					Console.warn(self, "Could not resolve element:", message)
-					@updates.enqueue(["error", message[1], "Could not resolve element!"])
+					self.enqueue(["error", message[1], "Could not resolve element!"])
 				end
 			when "unbind"
 				# Unbind a client-side element from a server-side element.
@@ -101,7 +102,7 @@ module Live
 					element.close unless @attached.key?(message[1])
 				else
 					Console.warn(self, "Could not unbind element:", message)
-					@updates.enqueue(["error", message[1], "Could not unbind element!"])
+					self.enqueue(["error", message[1], "Could not unbind element!"])
 				end
 			when "event"
 				# Handle an event from the client.
@@ -113,22 +114,43 @@ module Live
 		
 		# Run the event handling loop with the given websocket connection.
 		# @parameter connection [Async::WebSocket::Connection]
-		def run(connection)
+		def run(connection, keep_alive: 10)
 			Sync do |task|
+				last_update = Async::Clock.now
+				
 				queue_task = task.async do
 					while update = @updates.dequeue
-						::Protocol::WebSocket::TextMessage.generate(update).send(connection)
+						update.send(connection)
 						
 						# Flush the output if there are no more updates:
-						connection.flush if @updates.empty?
+						if @updates.empty?
+							connection.flush
+						end
+					end
+				end
+				
+				keep_alive_task = task.async do
+					while true
+						sleep(keep_alive)
+						
+						duration = Async::Clock.now - last_update
+						
+						# We synchronize all writes to the update queue:
+						if duration > keep_alive
+							@updates.enqueue(::Protocol::WebSocket::PingMessage.new)
+						end
 					end
 				end
 				
 				while message = connection.read
+					last_update = Async::Clock.now
 					process_message(message.parse)
 				end
 			ensure
+				keep_alive_task&.stop
+				
 				self.close
+				
 				queue_task&.stop
 			end
 		end

data/lib/live/version.rb

@@ -4,5 +4,5 @@
 # Copyright, 2021-2024, by Samuel Williams.
 
 module Live
-	VERSION = "0.13.1"
+	VERSION = "0.14.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: live
 version: !ruby/object:Gem::Version
-  version: 0.13.1
+  version: 0.14.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -39,7 +39,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-09-23 00:00:00.000000000 Z
+date: 2024-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async-websocket
@@ -55,6 +55,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.27'
+- !ruby/object:Gem::Dependency
+  name: protocol-websocket
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
 - !ruby/object:Gem::Dependency
   name: xrb
   requirement: !ruby/object:Gem::Requirement
@@ -104,7 +118,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: Live HTML tags updated via a WebSocket.