Module: HttpResource::ValueObject

Defined in:
lib/http_resource/value_object.rb

Overview

Mixin for response value objects, designed to pair with Ruby’s Data.define. It gives a class a tolerant ‘.from(payload)` that:

- returns nil for a nil payload (so an empty 2xx -> nil, never a ghost),
- unwraps a top-level { "data" => {...} } envelope if present,
- normalises string OR symbol keys,

then hands the inner hash to ‘build` (or the Data.define member names, when no `build` is defined) so missing keys arrive as nil instead of raising.

Contact = Data.define(:email, :name) do
  extend HttpResource::ValueObject
end
Contact.from("data" => { "email" => "a@b.se" })  # => #<data Contact email="a@b.se", name=nil>
Contact.from(nil)                                 # => nil

Resource methods should still guard ‘data && Contact.from(data)` so the caller never receives a ghost object from an empty body.

Instance Method Summary collapse

Instance Method Details

#from(payload) ⇒ Object 



21
22
23
24
25
26
 
# File 'lib/http_resource/value_object.rb', line 21

def from(payload)
  return nil if payload.nil?

  data = unwrap(payload)
  respond_to?(:build) ? build(data) : new(**slice_members(data))
end