recourse 7.6.0 → 7.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2a20bbc5915a1d57b72fb203edfdd05c1bd5f994c428b0520f2ef9af73ec3f0
-  data.tar.gz: a6ba069086c36351dd7072d09a2909f64bd17a84346d8ef31921fd953592a61d
+  metadata.gz: f8e518ee85484be8de5cc4a1533a9b8677d97417706a8c93210a02b2ad067040
+  data.tar.gz: 98e1b1f4173a12c8935783d5194715affd66ebfd33de377b0010c86352be83c4
 SHA512:
-  metadata.gz: c98284ac83b4a7b5419f747e69028dff262aa5281745c61bc8fbd01d7dd0eeb07dc4706ffbbb531133c8c8bc1b2478e75b55a12484cb39a6ca2b539df2821ea5
-  data.tar.gz: cdede705768f5b68438efd3d1e80f1120827614a16d8bf11b9556aad5107184f4691d18e893a3d2ee8e1223a1ceef92f74c9026c60d278c6e3d904aa332edae9
+  metadata.gz: 11c62eca29bcd4fdd171ff3d1fe2f5829b41ff0d4d057cff38a8c24749b5bb8d610962906746ba828e6163d7ad0ac89bb0e7a5a1ef44b84250967b95e4173708
+  data.tar.gz: f4801d3c52a5228fe075f50940fd01833c81966c232b17e0d093dffda29d0b75f93e73cf91d13fdf05a9a55bd41e7adaad2c84653d8a5f5b79fe7102c8146458

data/CHANGELOG.md

@@ -7,6 +7,17 @@ For more information about changelogs, check [Keep a Changelog](http://keepachan
 
 ## [Unreleased]
 
+## 7.6.1 - 2026-09-20
+
+* [FIX] The three write seams are marked `@api private`
+
+  `create_resource`, `update_resource` and `destroy_resource` are how the gem writes a
+  record, not a shelf for a host to reach. A host with something of its own to do on a
+  write writes the action.
+
+  The comment over `destroy_resource` still described the `destroy!` it stopped being in
+  7.2.0, and said the opposite of what it now does.
+
 ## 7.6.0 - 2026-09-20
 
 * [CHANGE] The layout titles the page, so a host template cannot lose it

data/app/controllers/concerns/recourse/attachment_writing.rb

@@ -9,17 +9,20 @@ module Recourse
 
     # A new record, then the files that came with it, in one transaction: a record
     # half-saved is worse than one not saved.
+    # @api private
     def create_resource(record)
       record.transaction { super && attach_submitted_files(record) }
     end
 
-    # The same for one that already exists.
+    # A record that already exists, then the files that came with it.
+    # @api private
     def update_resource(record)
       super && attach_submitted_files(record)
     end
 
     # On a page of what a record has attached, the row between the two goes and the
     # file stays for whatever else points at it; everywhere else the record itself goes.
+    # @api private
     def destroy_resource(record)
       return super unless attachment_reflection
 

data/app/controllers/concerns/recourse/reference_resolution.rb

@@ -7,14 +7,16 @@ module Recourse
 
     # A new record, unless a typed label named more than one row, which is answered on
     # the form rather than by writing a guess.
+    # @api private
     def create_resource(record)
       return false if ambiguous_references? record
 
       record.save
     end
 
-    # The same for one that already exists. The parameters are read before the refusal
-    # is asked about, since reading them is what notices an ambiguous label.
+    # A record that already exists, under the same refusal. The parameters are read
+    # before it is asked about, since reading them is what notices an ambiguous label.
+    # @api private
     def update_resource(record)
       attributes = resource_params
       return false if ambiguous_references? record
@@ -22,8 +24,9 @@ module Recourse
       record.update attributes
     end
 
-    # And the record gone. `destroy!`, so a callback that stops one says so rather than
-    # leaving the page claiming it worked.
+    # The record gone, or false where a callback refused to give it up, which the page
+    # says where the row still is.
+    # @api private
     def destroy_resource(record) = record.destroy
 
     # A foreign key whose label is typed arrives as that label, so it is looked up

data/lib/recourse/version.rb

@@ -1,4 +1,4 @@
 module Recourse
   # Version of the gem, read by the gemspec and by hosts checking compatibility.
-  VERSION = '7.6.0'
+  VERSION = '7.6.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: recourse
 version: !ruby/object:Gem::Version
-  version: 7.6.0
+  version: 7.6.1
 platform: ruby
 authors:
 - claudiob