sourced-message 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c32c4b5ea1020c0623e0f572d67a529a70630e21dd9d865a43386c4ca318915b
-  data.tar.gz: b1bf6ccf2eadf06ea8c5bf301f692a520bb9cb84de37c07a5a340a0395177ff5
+  metadata.gz: 12ddf9298bf827a4f20e9f2db6b9edababd24efa73323326e5cd5ff6bbedebc1
+  data.tar.gz: a88ab37ddb627868b20cd9a03615334a01d1f957fc3dedae25db4486623b983f
 SHA512:
-  metadata.gz: c9d6eb69097f9e6f70df79786f8a285c638d7a985f762ba15d70463109058b5884117d838242834db8771a1ee6996434695d5ab4a4dac4d9809a2d25c0456ffa
-  data.tar.gz: a1b78a345ee0f8463372e729d9cce17ad28ce9c9da6a2d137da72c174ed10d668148018b7fdb7f13529d2c6d9db78a14f8401e0d976781457f95ec52944998ba
+  metadata.gz: 154e306175767857b9471c5700fe12ec3f73c17292af5c30826e2f61afa0dc217853e56950cddbf3decf8b38c38f5837e3cad76a822c6078cfd8904ef912093b
+  data.tar.gz: 0640b5e2560fa1dfd331ee8b015dde0b5195bf1ec55efaa1cb0e98cf4b3713ca8544b4bc784495cb09f08d32d12bc2dc4c60977b60df99b021bf6f71a6e63c76

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 ## [Unreleased]
 
+## [0.4.0]
+
+- Requires plumb 0.4, whose codecs rewrite Hash keys like values: `#encode` now emits
+  String keys (`{'type' => ..., 'payload' => {'name' => ...}}`), and decoders accept
+  String or Symbol keys. `JSON.dump` output is unchanged.
+- `Codec#decode` reads the envelope's `type` and `id` under either key form, so
+  `decode(encode(message))` works without a JSON round trip.
+- `metadata` is typed as `Types::Metadata`: Symbol keys and `Types::JSONValue` values
+  (String, Numeric, boolean, nil, and Arrays/Symbol-keyed Hashes of those, at any depth).
+  Codecs now restore nested metadata keys as Symbols. A non-JSON value (a Time, a
+  Symbol) makes the message invalid and fails `#encode`, where `JSON.dump` used to
+  stringify it silently.
+- `Sourced::Message::VERSION` is now `0.4.0`.
+
 ## [0.3.0]
 
 - Add `Sourced::Message#correlation_type`, the type counterpart of `correlation_id`:

data/lib/sourced/message/codec.rb

@@ -182,23 +182,27 @@ module Sourced
       # Rebuild a message from decoded attributes. An unknown type raises: a process
       # reading types it doesn't know about is missing the class.
       #
-      # @param attrs [Hash] symbol-keyed message attributes
+      # @param attrs [Hash] message attributes, String- (as #encode emits them) or Symbol-keyed
       # @return [Sourced::Message]
       # @raise [UnknownMessageError] if the type isn't in the registry
       # @raise [UnregisteredTypeError] if the type was not compiled
       # @raise [DecodeError] if the attributes don't satisfy the schema
       def decode(attrs)
-        type = attrs[:type]
+        type = envelope(attrs, :type)
+        id = envelope(attrs, :id)
         klass = @registry[type]
-        raise UnknownMessageError, "Unknown message type: #{label(type, attrs[:id])}" unless klass
+        raise UnknownMessageError, "Unknown message type: #{label(type, id)}" unless klass
 
-        build(klass, attrs, pair(type, attrs[:id]).decoder)
+        build(klass, attrs, pair(type, id).decoder)
       rescue Plumb::ParseError => e
-        raise DecodeError, "cannot decode #{label(type, attrs[:id])}: #{e.message}"
+        raise DecodeError, "cannot decode #{label(type, id)}: #{e.message}"
       end
 
       private
 
+      # Read before the decoder runs, so it must accept both key forms the decoder does.
+      def envelope(attrs, key) = attrs.fetch(key) { attrs[key.to_s] }
+
       # --- subclass seams -------------------------------------------------------
 
       # @param klass [Class<Sourced::Message>]

data/lib/sourced/message.rb

@@ -22,7 +22,7 @@ module Sourced
   # +Sourced::Message.registry[type]+ resolves a type registered under any
   # subclass. Resolve from this root to see the whole tree.
   class Message < Plumb::Types::Data
-    VERSION = '0.3.0'
+    VERSION = '0.4.0'
 
     EMPTY_ARRAY = [].freeze
 
@@ -34,6 +34,15 @@ module Sourced
 
       # Accepts a UUID string or generates a new one when none is provided.
       AutoUUID = UUID::V4.default { SecureRandom.uuid }
+
+      # A JSON value, with Symbol-keyed objects at every depth. Typed all the way
+      # down so a codec decodes nested keys too. The self-references are deferred
+      # inside the union, not the constant itself: naming a type here freezes it,
+      # and a frozen Deferred can't materialize.
+      JSONValue = String | Numeric | Boolean | Nil |
+                  Array[Any.defer { JSONValue }] | Hash[Symbol, Any.defer { JSONValue }]
+
+      Metadata = Hash[Symbol, JSONValue]
     end
 
     # Raised by {.from} when a type string isn't registered.
@@ -47,7 +56,7 @@ module Sourced
     attribute? :causation_id, Types::UUID::V4
     attribute? :correlation_id, Types::UUID::V4
     attribute :created_at, LaxTime.default { Time.now }
-    attribute :metadata, Types::Hash.default(Plumb::BLANK_HASH)
+    attribute :metadata, Types::Metadata.default(Plumb::BLANK_HASH)
     attribute :payload, Types::Static[nil]
 
     # Lookup table mapping type strings to message subclasses.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sourced-message
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Ismael Celis
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: '0.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: '0.4'
 - !ruby/object:Gem::Dependency
   name: fugit
   requirement: !ruby/object:Gem::Requirement
@@ -74,7 +74,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.8
+rubygems_version: 4.0.21
 specification_version: 4
 summary: Canonical typed Message class and registry shared by Sourced and Sidereal.
 test_files: []