typical_situation 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48bf00bdaee8edb5e3fbf54b68ca577960068cae3dac7804ca56169d738c834c
-  data.tar.gz: e11a3d08dd5991937bb08b2b3a731d8bd67f91b19658c25239bef18e60e4f921
+  metadata.gz: 1806328a0281819fd09cedb96002dd5e038f56a2b292c608b8e1920bd3e7cf25
+  data.tar.gz: fb92828cdf08f013652d379c96e52177b1f6005184b24ac6ea9e9273b4d94383
 SHA512:
-  metadata.gz: 584cecff5e2be5ac3201983c4a2e0fbe1ec69cf5cd7cc18c91aa2d267bb73a8680194137774889fe9cd546c3f3dc55ee35bcef53ff643e8b5ff54eb741a7e6fe
-  data.tar.gz: e31342f32bc78ce7aecf165ce64c51fb38f1fd3d8031ffeec891f38b972945fc0da002227a919afc7942ca61179fe3de4e4dbf4fe3f82af77cc9a014b7ed1b14
+  metadata.gz: 4d997a83448cd809e5c884c67fb55cd5be7fe1cf2869b6b177e884300c06cd63b65fce54c85f594b68f239bee417b629e9e9335480ed049c6f05d02d0ad2592f
+  data.tar.gz: c4b44e7839dfdcdc8d896354748e154e12c270bfc1c93be8f9167b65f774d24f970ebdc69dc493890bd0f47c582d8075a14d8622963647d69b0c0e55c7bf8c54

data/README.md

@@ -117,9 +117,10 @@ For index actions, resources move through this pipeline:
 
 1. `collection` - base relation from the host controller
 2. `scoped_resource` - visibility/tenant/security scoping
-3. `prepare_resources` - search or filter transforms
+3. `apply_filtering` - request-driven search and filter transforms
 4. `apply_sorting` - default sorting from `default_sorting_attribute`
 5. `paginate_resources` - pagination adapter hook
+6. `prepare_resources` - post-process the loaded records
 
 **Scoped Collections** - Restrict the base collection based on user permissions, tenancy, or other security boundaries:
 
@@ -136,13 +137,21 @@ end
 **Search and Filtering** - Apply request-driven filters after scoping and before sorting/pagination:
 
 ```ruby
-def prepare_resources(resources)
+def apply_filtering(resources)
   resources = resources.where(status: params[:status]) if params[:status].present?
   resources = resources.where("title ILIKE ?", "%#{params[:q]}%") if params[:q].present?
   resources
 end
 ```
 
+**Post-processing** - Mutate or decorate the final paginated record set (e.g. compute a derived attribute on every record):
+
+```ruby
+def prepare_resources(resources)
+  resources.each { |post| post.current_user_liked = liked_post_ids.include?(post.id) }
+end
+```
+
 **Custom Lookup** - Use different attributes for finding resources:
 
 ```ruby

data/lib/typical_situation/operations.rb

@@ -46,22 +46,28 @@ module TypicalSituation
     # Collection pipeline lifecycle:
     #   collection         - base relation (user-defined, required)
     #   scoped_resource    - wraps/scopes the collection (visibility, tenancy, PHI)
-    #   prepare_resources  - standardized additional transforms (search, filter)
+    #   apply_filtering    - applies search/filter params
     #   apply_sorting      - applies ORDER BY
     #   paginate_resources - applies pagination
+    #   prepare_resources  - post-processes the loaded records (e.g. set a computed attribute)
     #
-    # Override +prepare_resources+ in host controllers to add search/filter
-    # behavior without touching sorting or pagination hooks.
+    # Override +apply_filtering+ to add search/filter behavior.
+    # Override +prepare_resources+ to mutate or decorate the final record set.
     def get_resources
       resources = scoped_resource
-      resources = prepare_resources(resources)
+      resources = apply_filtering(resources)
       resources = apply_sorting(resources)
       resources = paginate_resources(resources)
+      resources = prepare_resources(resources)
       @resources = resources
       set_collection_instance
       @resources
     end
 
+    def apply_filtering(resources)
+      resources
+    end
+
     def prepare_resources(resources)
       resources
     end

data/lib/typical_situation/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TypicalSituation
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: typical_situation
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Mars Hall