basecradle 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40d7b447c5bbeb18244e440069f09432d808525a96ef2aa1232ae560c3c41194
-  data.tar.gz: 12bcc5f74631bd1f48fa8fbe6ea0882283e03cddfcdf68336ed631e7a68e8325
+  metadata.gz: 38e4a8615dfc599f925f007f022e20323dbb39555dbcc3556a867ccc7d6026dd
+  data.tar.gz: 8460d80cc0d400cf5c513ba77f92589a7150f7b10df083c6cb2c123fc60692d3
 SHA512:
-  metadata.gz: 235a1d21044f525ca69c2cffb0909ffc05e8dcd2e63da7d2d5db51f30b34a7eeecf73434a029fc80b08421c1e04dcc61d0461f92e657e27a6b140a19e5f378f0
-  data.tar.gz: aa1f71ee1a7efdde1ca609d0768e23efc4c9a2b0f63602e43411752f05ef470b5bfb9cbb0eb4c2c3df38b99b3ca89fedf7de302ff01af5eafd869cd82af8208c
+  metadata.gz: 425c45374d3c0915d392836fdc70e31962f02cec3ab4c6e625954dae83fb0dae58684e768b525860a074c6ce06f3fd92f0e4fe1de10d194a36ccc5eb6c1ad8e5
+  data.tar.gz: 9c3b1d147958205aff066f2d17f82841e5ac940279a7cd1c0da1b7be398942f7022dae0ff2f9b1f6a3cc44f407b1242c42da010cb9880a79359a0e2625474ee1

data/CHANGELOG.md

@@ -9,6 +9,25 @@ section**. The newest heading is always the version `lib/basecradle/version.rb`
 a release writes its entry and its version in the same PR — and `test/changelog_test.rb`
 fails CI if the two ever disagree.
 
+## [0.12.0] - 2026-10-17
+
+### Changed
+
+- **Breaking: `contact_message.update_status(status)` is now `contact_message.set_status(status)`**
+  ([#234](https://github.com/basecradle/basecradle-ruby/issues/234)). Same operation
+  (`PATCH /contact_messages/{id}/status`), same argument, same in-place update and
+  `self` return; only the name changes. An operation's verb is part of the SDK
+  contract: one operation, one verb in every SDK, taken from the API documentation's
+  name for it ("Setting a Contact Message's Status"). The Python SDK already says
+  `set_status`; this release brings Ruby to the same word (`@origin`, 2026-10-16;
+  basecradle#691). No alias is kept — the gem is 0.x and the method shipped one
+  release ago.
+
+### Migrating
+
+Rename the call: `message.update_status("spam")` becomes `message.set_status("spam")`.
+Calling the old name raises `NoMethodError`.
+
 ## [0.11.0] - 2026-10-10
 
 ### Added
@@ -653,6 +672,7 @@ the Python SDK's behavior in idiomatic Ruby. Zero runtime dependencies.
 - **Quality bars** — a README-as-tested-doc harness (every example runs against a mocked
   API) and a spec drift-guard (CI fails if the live API grows beyond the SDK).
 
+[0.12.0]: https://github.com/basecradle/basecradle-ruby/releases/tag/v0.12.0
 [0.11.0]: https://github.com/basecradle/basecradle-ruby/releases/tag/v0.11.0
 [0.10.4]: https://github.com/basecradle/basecradle-ruby/releases/tag/v0.10.4
 [0.10.3]: https://github.com/basecradle/basecradle-ruby/releases/tag/v0.10.3

data/README.md

@@ -361,7 +361,7 @@ bc.contact_messages.filter(status: "received").each do |message|  # newest first
   puts message.honeypot_filled         # the bot trap: the platform records it, never acts on it
   puts message.data.keys.inspect       # one self-describing slot per vendor
 
-  message.update_status("spam") if message.honeypot_filled  # "received" | "closed" | "spam"
+  message.set_status("spam") if message.honeypot_filled  # "received" | "closed" | "spam"
 end
 
 message = bc.contact_messages.get("019e7750-66ee-7b28-b052-67cdb5b10ca0")
@@ -373,7 +373,7 @@ bc.notes.each { |n| puts n.body }  # every note, across every subject, newest fi
 ```
 
 A contact message is a flat record with no `type`/`content` wrapper, so `message.uuid`
-is its identity. `update_status` changes the triage verdict in any direction (reopen with
+is its identity. `set_status` changes the triage verdict in any direction (reopen with
 `"received"`). It updates the object you called it on and returns it. `add_note` returns
 the new `BaseCradle::Note` and leaves `message.notes` as it was fetched, so call
 `bc.contact_messages.get` again to read the record with the new note embedded. A note

data/lib/basecradle/contact_messages.rb

@@ -44,14 +44,14 @@ module BaseCradle
   # identity, and it embeds its notes in full.
   #
   # Nothing is ever rejected on a score — the record is the data, and an admin decides,
-  # with +update_status+ and +add_note+.
+  # with +set_status+ and +add_note+.
   class ContactMessage < ApiObject
     attribute :uuid
     attribute :name
     attribute :email_address
     attribute :body
     # "received" (the default) | "closed" | "spam" — the triage verdict, set with
-    # +update_status+. Treat an unrecognized value as forward-compatible, never an error.
+    # +set_status+. Treat an unrecognized value as forward-compatible, never an error.
     attribute :status
     # The signed-in user who submitted it (nested-actor form), or +nil+ for a visitor
     # without an account.
@@ -72,12 +72,12 @@ module BaseCradle
     attribute :updated_at
 
     # Set the triage verdict: +"received"+, +"closed"+ or +"spam"+. It moves in any
-    # direction — reopening a closed message is +update_status("received")+.
+    # direction — reopening a closed message is +set_status("received")+.
     #
     # Live object: the API returns the whole contact message, and this object reads it from
     # here on (+status+ and +updated_at+ included), then returns +self+. Raises
     # +ValidationError+ (422) for a status outside the three.
-    def update_status(status)
+    def set_status(status)
       response = require_client.request("PATCH", "/contact_messages/#{uuid}/status",
                                         json: { "contact_message" => { "status" => status } })
       @data = response.fetch("contact_message")
@@ -106,7 +106,7 @@ module BaseCradle
   # or fetch one by uuid. Admin-only.
   #
   #   bc.contact_messages.filter(status: "received").each do |message|
-  #     message.update_status("spam") if message.honeypot_filled
+  #     message.set_status("spam") if message.honeypot_filled
   #   end
   class ContactMessagesResource
     include Enumerable

data/lib/basecradle/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BaseCradle
-  VERSION = "0.11.0"
+  VERSION = "0.12.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: basecradle
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Drawk Kwast