loggable_activity 0.1.56 → 0.1.58

data/docs/LoggableActivity/Activity.html

@@ -75,21 +75,17 @@
     <li ><a href="#method-c-activities_for_actor">::activities_for_actor</a>
     <li ><a href="#method-c-last">::last</a>
     <li ><a href="#method-c-latest">::latest</a>
+    <li ><a href="#method-i-actor_deleted-3F">#actor_deleted?</a>
     <li ><a href="#method-i-actor_display_name">#actor_display_name</a>
-    <li ><a href="#method-i-actor_key">#actor_key</a>
+    <li ><a href="#method-i-actor_secret_key">#actor_secret_key</a>
     <li ><a href="#method-i-attrs">#attrs</a>
     <li ><a href="#method-i-must_have_at_least_one_payload">#must_have_at_least_one_payload</a>
     <li ><a href="#method-i-ordered_payloads">#ordered_payloads</a>
-    <li ><a href="#method-i-path">#path</a>
-    <li ><a href="#method-i-previous_associations_attrs">#previous_associations_attrs</a>
+    <li ><a href="#method-i-payloads_attrs">#payloads_attrs</a>
     <li ><a href="#method-i-primary_payload">#primary_payload</a>
-    <li ><a href="#method-i-primary_payload_attrs">#primary_payload_attrs</a>
+    <li ><a href="#method-i-primary_route">#primary_route</a>
     <li ><a href="#method-i-record_display_name">#record_display_name</a>
     <li ><a href="#method-i-record_key">#record_key</a>
-    <li ><a href="#method-i-relations_attrs">#relations_attrs</a>
-    <li ><a href="#method-i-update_activity_attrs">#update_activity_attrs</a>
-    <li ><a href="#method-i-update_attrs">#update_attrs</a>
-    <li ><a href="#method-i-updated_relations_attrs">#updated_relations_attrs</a>
   </ul>
 </div>
 
@@ -131,9 +127,9 @@
           <p>Returns a list of activities for a given actor.</p>
 
           <div class="method-source-code" id="activities_for_actor-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 155</span>
+            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 124</span>
 <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier ruby-title">activities_for_actor</span>(<span class="ruby-identifier">actor</span>, <span class="ruby-identifier">limit</span> = <span class="ruby-value">20</span>, <span class="ruby-identifier">params</span> = { <span class="ruby-value">offset:</span> <span class="ruby-value">0</span> })
-  <span class="ruby-constant">LoggableActivity</span><span class="ruby-operator">::</span><span class="ruby-constant">Activity</span>.<span class="ruby-identifier">latest</span>(<span class="ruby-identifier">limit</span>, <span class="ruby-identifier">params</span>).<span class="ruby-identifier">where</span>(<span class="ruby-value">actor:</span>)
+  <span class="ruby-operator">::</span><span class="ruby-constant">LoggableActivity</span><span class="ruby-operator">::</span><span class="ruby-constant">Activity</span>.<span class="ruby-identifier">latest</span>(<span class="ruby-identifier">limit</span>, <span class="ruby-identifier">params</span>).<span class="ruby-identifier">where</span>(<span class="ruby-value">actor:</span>)
 <span class="ruby-keyword">end</span></pre>
           </div>
         </div>
@@ -151,10 +147,10 @@
         </div>
 
         <div class="method-description">
-          <p>Returns the last activity.</p>
+          <p>Returns the last activity. This is done to support of UUID primary keys.</p>
 
           <div class="method-source-code" id="last-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 171</span>
+            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 142</span>
 <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier ruby-title">last</span>(<span class="ruby-identifier">limit</span> = <span class="ruby-value">1</span>)
   <span class="ruby-keyword">return</span> <span class="ruby-identifier">latest</span>(<span class="ruby-value">1</span>).<span class="ruby-identifier">first</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">limit</span> <span class="ruby-operator">==</span> <span class="ruby-value">1</span>
 
@@ -176,16 +172,16 @@
         </div>
 
         <div class="method-description">
-          <p>Returns a list of activities ordered by creation date.</p>
+          <p>Returns a list of activities ordered by creation date. This is done to support UUID primary keys.</p>
 
           <div class="method-source-code" id="latest-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 160</span>
+            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 130</span>
 <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier ruby-title">latest</span>(<span class="ruby-identifier">limit</span> = <span class="ruby-value">20</span>, <span class="ruby-identifier">params</span> = { <span class="ruby-value">offset:</span> <span class="ruby-value">0</span> })
   <span class="ruby-identifier">offset</span> = <span class="ruby-identifier">params</span>[<span class="ruby-value">:offset</span>] <span class="ruby-operator">||</span> <span class="ruby-value">0</span>
-  <span class="ruby-constant">LoggableActivity</span><span class="ruby-operator">::</span><span class="ruby-constant">Activity</span>
+  <span class="ruby-operator">::</span><span class="ruby-constant">LoggableActivity</span><span class="ruby-operator">::</span><span class="ruby-constant">Activity</span>
     .<span class="ruby-identifier">all</span>
     .<span class="ruby-identifier">order</span>(<span class="ruby-value">created_at:</span> <span class="ruby-value">:desc</span>)
-    .<span class="ruby-identifier">includes</span>(<span class="ruby-value">:payloads</span>)
+    .<span class="ruby-identifier">includes</span>(<span class="ruby-value">payloads:</span> <span class="ruby-value">:encryption_key</span>)
     .<span class="ruby-identifier">offset</span>(<span class="ruby-identifier">offset</span>)
     .<span class="ruby-identifier">limit</span>(<span class="ruby-identifier">limit</span>)
 <span class="ruby-keyword">end</span></pre>
@@ -225,11 +221,11 @@
 </pre>
 
           <div class="method-source-code" id="actor_display_name-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 148</span>
+            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 117</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">actor_display_name</span>
-  <span class="ruby-keyword">return</span> <span class="ruby-constant">I18n</span>.<span class="ruby-identifier">t</span>(<span class="ruby-string">&#39;loggable.activity.deleted&#39;</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">encrypted_actor_display_name</span>.<span class="ruby-identifier">nil?</span>
+  <span class="ruby-keyword">return</span> <span class="ruby-constant">I18n</span>.<span class="ruby-identifier">t</span>(<span class="ruby-string">&#39;loggable.activity.deleted&#39;</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">actor_deleted?</span>
 
-  <span class="ruby-constant">LoggableActivity</span><span class="ruby-operator">::</span><span class="ruby-constant">Encryption</span>.<span class="ruby-identifier">decrypt</span>(<span class="ruby-identifier">encrypted_actor_display_name</span>, <span class="ruby-identifier">actor_key</span>)
+  <span class="ruby-operator">::</span><span class="ruby-constant">LoggableActivity</span><span class="ruby-operator">::</span><span class="ruby-constant">Encryption</span>.<span class="ruby-identifier">decrypt</span>(<span class="ruby-identifier">encrypted_actor_name</span>, <span class="ruby-identifier">actor_secret_key</span>)
 <span class="ruby-keyword">end</span></pre>
           </div>
         </div>
@@ -253,7 +249,7 @@
 <ul><li>
 <p>:record_type: The class name of the record.</p>
 </li><li>
-<p>:payload_type: A descriptor of the payload’s role (e.g., ‘primary_payload’ or ‘current_association’).</p>
+<p>:related_to_activity_as: A descriptor of the payload’s role (e.g., ‘primary_payload’ or ‘current_association’).</p>
 </li><li>
 <p>:attrs: A hash of the record’s attributes.</p>
 </li></ul>
@@ -266,23 +262,22 @@
 <p>Sample return value:</p>
 
 <pre>[
-  { record_type: MODEL_NAME, payload_type: &quot;primary_payload&quot;, attrs: { &quot;KEY&quot; =&gt; &quot;VALUE&quot;, ... } },
-  { record_type: MODEL_NAME, payload_type: &quot;current_association&quot;, attrs: { &quot;KEY&quot; =&gt; &quot;VALUE&quot;, ... } },
+  { record_type: MODEL_NAME, related_to_activity_as: &quot;primary_payload&quot;, attrs: { &quot;KEY&quot; =&gt; &quot;VALUE&quot;, ... } },
+  { record_type: MODEL_NAME, related_to_activity_as: &quot;current_association&quot;, attrs: { &quot;KEY&quot; =&gt; &quot;VALUE&quot;, ... } },
   ...
 ]</pre>
 
           <div class="method-source-code" id="attrs-source">
             <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 37</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">attrs</span>
-  <span class="ruby-identifier">ordered_payloads</span>.<span class="ruby-identifier">map</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">payload</span><span class="ruby-operator">|</span>
-    {
-      <span class="ruby-value">record_type:</span> <span class="ruby-identifier">payload</span>.<span class="ruby-identifier">record_type</span>,
-      <span class="ruby-value">record_id:</span> <span class="ruby-identifier">payload</span>.<span class="ruby-identifier">record_id</span>,
-      <span class="ruby-value">payload_type:</span> <span class="ruby-identifier">payload</span>.<span class="ruby-identifier">payload_type</span>,
-      <span class="ruby-value">attrs:</span> <span class="ruby-identifier">payload</span>.<span class="ruby-identifier">attrs</span>,
-      <span class="ruby-value">path:</span> <span class="ruby-identifier">payload</span>.<span class="ruby-identifier">payload_route</span>
-    }
-  <span class="ruby-keyword">end</span>
+  {
+    <span class="ruby-value">actor_type:</span>,
+    <span class="ruby-value">actor_id:</span>,
+    <span class="ruby-value">action:</span>,
+    <span class="ruby-value">actor_display_name:</span>,
+    <span class="ruby-value">record_display_name:</span>,
+    <span class="ruby-value">payloads:</span> <span class="ruby-identifier">payloads_attrs</span>
+  }
 <span class="ruby-keyword">end</span></pre>
           </div>
         </div>
@@ -290,32 +285,33 @@
 
       </div>
 
-      <div id="method-i-path" class="method-detail ">
+      <div id="method-i-payloads_attrs" class="method-detail ">
         <div class="method-header">
           <div class="method-heading">
-            <span class="method-name">path</span><span
+            <span class="method-name">payloads_attrs</span><span
               class="method-args">()</span>
             <span class="method-click-advice">click to toggle source</span>
           </div>
         </div>
 
         <div class="method-description">
-          <p>Returns the path for the activity.</p>
+          
 
-<p>Example:</p>
-
-<pre class="ruby"><span class="ruby-ivar">@activity</span>.<span class="ruby-identifier">path</span>
-</pre>
-
-<p>Returns:</p>
-
-<pre class="ruby"><span class="ruby-string">&quot;/path/to/activity&quot;</span>
-</pre>
-
-          <div class="method-source-code" id="path-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 135</span>
-<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">path</span>
-  <span class="ruby-identifier">primary_payload</span>&amp;.<span class="ruby-identifier">route</span>
+          <div class="method-source-code" id="payloads_attrs-source">
+            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 48</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">payloads_attrs</span>
+  <span class="ruby-identifier">ordered_payloads</span>.<span class="ruby-identifier">map</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">payload</span><span class="ruby-operator">|</span>
+    {
+      <span class="ruby-value">related_to_activity_as:</span> <span class="ruby-identifier">payload</span>.<span class="ruby-identifier">related_to_activity_as</span>,
+      <span class="ruby-value">record_type:</span> <span class="ruby-identifier">payload</span>.<span class="ruby-identifier">record_type</span>,
+      <span class="ruby-value">record_id:</span> <span class="ruby-identifier">payload</span>.<span class="ruby-identifier">deleted?</span> <span class="ruby-operator">?</span> <span class="ruby-keyword">nil</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">payload</span>.<span class="ruby-identifier">record_id</span>,
+      <span class="ruby-value">attrs:</span> <span class="ruby-identifier">payload</span>.<span class="ruby-identifier">attrs</span>,
+      <span class="ruby-value">route:</span> <span class="ruby-identifier">payload</span>.<span class="ruby-identifier">payload_route</span>,
+      <span class="ruby-value">record_display_name:</span> <span class="ruby-identifier">payload</span>.<span class="ruby-identifier">record_display_name</span>,
+      <span class="ruby-value">current_payload:</span> <span class="ruby-identifier">payload</span>.<span class="ruby-identifier">current_payload</span>,
+      <span class="ruby-value">data_owner:</span> <span class="ruby-identifier">payload</span>.<span class="ruby-identifier">data_owner</span>
+    }
+  <span class="ruby-keyword">end</span>
 <span class="ruby-keyword">end</span></pre>
           </div>
         </div>
@@ -323,31 +319,32 @@
 
       </div>
 
-      <div id="method-i-primary_payload_attrs" class="method-detail ">
+      <div id="method-i-primary_route" class="method-detail ">
         <div class="method-header">
           <div class="method-heading">
-            <span class="method-name">primary_payload_attrs</span><span
+            <span class="method-name">primary_route</span><span
               class="method-args">()</span>
             <span class="method-click-advice">click to toggle source</span>
           </div>
         </div>
 
         <div class="method-description">
-          <p>Returns the attributes for the primary payload, without the relations.</p>
+          <p>Returns the path for the activity.</p>
 
 <p>Example:</p>
 
-<pre class="ruby"><span class="ruby-ivar">@activity</span>.<span class="ruby-identifier">primary_payload_attrs</span>
+<pre class="ruby"><span class="ruby-ivar">@activity</span>.<span class="ruby-identifier">path</span>
 </pre>
 
 <p>Returns:</p>
 
-<pre>{ &quot;KEY_A&quot; =&gt; &quot;VALUE_A&quot;, &quot;KEY_B&quot; =&gt; &quot;VALUE_B&quot;, ... }</pre>
+<pre class="ruby"><span class="ruby-string">&quot;/path/to/activity&quot;</span>
+</pre>
 
-          <div class="method-source-code" id="primary_payload_attrs-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 88</span>
-<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">primary_payload_attrs</span>
-  <span class="ruby-identifier">primary_payload</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">primary_payload</span>.<span class="ruby-identifier">attrs</span> <span class="ruby-operator">:</span> {}
+          <div class="method-source-code" id="primary_route-source">
+            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 104</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">primary_route</span>
+  <span class="ruby-identifier">primary_payload</span>.<span class="ruby-identifier">payload_route</span>
 <span class="ruby-keyword">end</span></pre>
           </div>
         </div>
@@ -378,11 +375,9 @@
 </pre>
 
           <div class="method-source-code" id="record_display_name-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 120</span>
+            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 91</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">record_display_name</span>
-  <span class="ruby-keyword">return</span> <span class="ruby-constant">I18n</span>.<span class="ruby-identifier">t</span>(<span class="ruby-string">&#39;loggable.activity.deleted&#39;</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">encrypted_record_display_name</span>.<span class="ruby-identifier">nil?</span>
-
-  <span class="ruby-constant">LoggableActivity</span><span class="ruby-operator">::</span><span class="ruby-constant">Encryption</span>.<span class="ruby-identifier">decrypt</span>(<span class="ruby-identifier">encrypted_record_display_name</span>, <span class="ruby-identifier">record_key</span>)
+  <span class="ruby-identifier">primary_payload</span>.<span class="ruby-identifier">record_display_name</span>
 <span class="ruby-keyword">end</span></pre>
           </div>
         </div>
@@ -390,92 +385,29 @@
 
       </div>
 
-      <div id="method-i-relations_attrs" class="method-detail ">
-        <div class="method-header">
-          <div class="method-heading">
-            <span class="method-name">relations_attrs</span><span
-              class="method-args">()</span>
-            <span class="method-click-advice">click to toggle source</span>
-          </div>
-        </div>
-
-        <div class="method-description">
-          <p>Returns the attributes for the relations.</p>
-
-<p>Example:</p>
-
-<pre class="ruby"><span class="ruby-ivar">@activity</span>.<span class="ruby-identifier">relations_attrs</span>
-</pre>
-
-<p>Returns:</p>
-
-<pre>[
-  {
-    record_type: CLASS.NAME,
-    record_id: INTEGER,
-    payload_type: ENUM 
-    attrs: { &quot;KEY_A&quot; =&gt; &quot;VALUE_A&quot;, &quot;KEY_B&quot; =&gt; &quot;VALUE_B&quot;, ... }
-  }
-]</pre>
-
-          <div class="method-source-code" id="relations_attrs-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 107</span>
-<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">relations_attrs</span>
-  <span class="ruby-identifier">attrs</span>.<span class="ruby-identifier">filter</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span> <span class="ruby-identifier">p</span>[<span class="ruby-value">:payload_type</span>] <span class="ruby-operator">==</span> <span class="ruby-string">&#39;current_association&#39;</span> }
-<span class="ruby-keyword">end</span></pre>
-          </div>
-        </div>
-
+    </section>
 
-      </div>
+     <section id="private-instance-5Buntitled-5D-method-details" class="method-section">
+       <header>
+         <h3>Private Instance Methods</h3>
+       </header>
 
-      <div id="method-i-update_activity_attrs" class="method-detail ">
+      <div id="method-i-actor_deleted-3F" class="method-detail ">
         <div class="method-header">
           <div class="method-heading">
-            <span class="method-name">update_activity_attrs</span><span
+            <span class="method-name">actor_deleted?</span><span
               class="method-args">()</span>
             <span class="method-click-advice">click to toggle source</span>
           </div>
         </div>
 
         <div class="method-description">
-          <p>Returns a hash describing the attributes of an update activity, including updated attributes for a record and any updated related attributes.</p>
-
-<p>Example:</p>
-
-<pre class="ruby"><span class="ruby-ivar">@activity</span>.<span class="ruby-identifier">update_activity_attrs</span>
-</pre>
-
-<p>The return value is structured as follows:</p>
-<ul><li>
-<p>:update_attrs contains the attributes of the record being updated, detailing changes from previous to new values.</p>
-</li><li>
-<p>:updated_relations_attrs is an array of hashes, each representing an updated related record. Each hash details the previous and current attributes of the relation.</p>
-</li></ul>
-
-<p>Example Return Structure:</p>
+          <p>Check if the actor is deleted. If the actor is deleted, it will return true. This way we don’t rely on access to the main DB to check if the actor is deleted.</p>
 
-<pre>{
-  update_attrs: {
-    record_class: &quot;CLASS.NAME&quot;,
-    attrs: [{ &quot;KEY&quot; =&gt; { from: &quot;OLD_VALUE&quot;, to: &quot;NEW_VALUE&quot; } }]
-  },
-  updated_relations_attrs: [
-    {
-      record_class: &quot;CLASS.NAME&quot;,
-      previous_attrs: { attrs: { &quot;KEY&quot; =&gt; &quot;VALUE&quot;, ... } },
-      current_attrs: { attrs: { &quot;KEY&quot; =&gt; &quot;VALUE&quot;, ... } }
-    }
-  ]
-}</pre>
-
-          <div class="method-source-code" id="update_activity_attrs-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 72</span>
-<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">update_activity_attrs</span>
-  {
-    <span class="ruby-value">update_attrs:</span>,
-    <span class="ruby-value">updated_relations_attrs:</span>
-  }
+          <div class="method-source-code" id="actor_deleted-3F-source">
+            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 177</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">actor_deleted?</span>
+  <span class="ruby-identifier">actor_secret_key</span>.<span class="ruby-identifier">nil?</span>
 <span class="ruby-keyword">end</span></pre>
           </div>
         </div>
@@ -483,17 +415,10 @@
 
       </div>
 
-    </section>
-
-     <section id="private-instance-5Buntitled-5D-method-details" class="method-section">
-       <header>
-         <h3>Private Instance Methods</h3>
-       </header>
-
-      <div id="method-i-actor_key" class="method-detail ">
+      <div id="method-i-actor_secret_key" class="method-detail ">
         <div class="method-header">
           <div class="method-heading">
-            <span class="method-name">actor_key</span><span
+            <span class="method-name">actor_secret_key</span><span
               class="method-args">()</span>
             <span class="method-click-advice">click to toggle source</span>
           </div>
@@ -502,12 +427,11 @@
         <div class="method-description">
           <p>Returns the key for the actor.</p>
 
-          <div class="method-source-code" id="actor_key-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 224</span>
-<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">actor_key</span>
-  <span class="ruby-keyword">return</span> <span class="ruby-keyword">nil</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">actor</span>.<span class="ruby-identifier">nil?</span>
-
-  <span class="ruby-constant">LoggableActivity</span><span class="ruby-operator">::</span><span class="ruby-constant">EncryptionKey</span>.<span class="ruby-identifier">for_record</span>(<span class="ruby-identifier">actor</span>)&amp;.<span class="ruby-identifier">key</span>
+          <div class="method-source-code" id="actor_secret_key-source">
+            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 182</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">actor_secret_key</span>
+  <span class="ruby-comment"># @actor_key_secret_key ||=</span>
+  <span class="ruby-operator">::</span><span class="ruby-constant">LoggableActivity</span><span class="ruby-operator">::</span><span class="ruby-constant">EncryptionKey</span>.<span class="ruby-identifier">for_record_by_type_and_id</span>(<span class="ruby-identifier">actor_type</span>, <span class="ruby-identifier">actor_id</span>)&amp;.<span class="ruby-identifier">secret_key</span>
 <span class="ruby-keyword">end</span></pre>
           </div>
         </div>
@@ -528,7 +452,7 @@
           <p>Validates that the activity has at least one payload.</p>
 
           <div class="method-source-code" id="must_have_at_least_one_payload-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 231</span>
+            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 188</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">must_have_at_least_one_payload</span>
   <span class="ruby-identifier">errors</span>.<span class="ruby-identifier">add</span>(<span class="ruby-value">:payloads</span>, <span class="ruby-string">&#39;must have at least one payload&#39;</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">payloads</span>.<span class="ruby-identifier">empty?</span>
 <span class="ruby-keyword">end</span></pre>
@@ -548,35 +472,13 @@
         </div>
 
         <div class="method-description">
-          <p>Returns payloads sorted by :payload_type.</p>
+          <p>Returns payloads sorted by :related_to_activity_as.</p>
 
           <div class="method-source-code" id="ordered_payloads-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 212</span>
+            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 162</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">ordered_payloads</span>
-  <span class="ruby-identifier">payloads</span>.<span class="ruby-identifier">order</span>(<span class="ruby-value">:payload_type</span>)
-<span class="ruby-keyword">end</span></pre>
-          </div>
-        </div>
-
-
-      </div>
-
-      <div id="method-i-previous_associations_attrs" class="method-detail ">
-        <div class="method-header">
-          <div class="method-heading">
-            <span class="method-name">previous_associations_attrs</span><span
-              class="method-args">()</span>
-            <span class="method-click-advice">click to toggle source</span>
-          </div>
-        </div>
-
-        <div class="method-description">
-          <p>Returns the previous association attributes.</p>
-
-          <div class="method-source-code" id="previous_associations_attrs-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 207</span>
-<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">previous_associations_attrs</span>
-  <span class="ruby-identifier">attrs</span>.<span class="ruby-identifier">select</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span> <span class="ruby-identifier">p</span>[<span class="ruby-value">:payload_type</span>] <span class="ruby-operator">==</span> <span class="ruby-string">&#39;previous_association&#39;</span> }
+  <span class="ruby-comment"># payloads.order(related_to_activity_as: :desc)</span>
+  <span class="ruby-identifier">payloads</span>
 <span class="ruby-keyword">end</span></pre>
           </div>
         </div>
@@ -594,12 +496,19 @@
         </div>
 
         <div class="method-description">
-          <p>Returns the primary payload.</p>
+          <p>Returns the primary payload associated with the activity.</p>
+
+<p>Example usage:</p>
+
+<pre class="ruby"><span class="ruby-identifier">payload</span> = <span class="ruby-ivar">@activity</span>.<span class="ruby-identifier">primary_payload</span>
+<span class="ruby-identifier">payload</span>.<span class="ruby-identifier">record_type</span>  <span class="ruby-comment"># =&gt; &#39;SOMD_MODEL_NAME&#39;</span>
+</pre>
 
           <div class="method-source-code" id="primary_payload-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 189</span>
+            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 156</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">primary_payload</span>
-  <span class="ruby-identifier">ordered_payloads</span>.<span class="ruby-identifier">find</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span> <span class="ruby-identifier">p</span>.<span class="ruby-identifier">payload_type</span> <span class="ruby-operator">==</span> <span class="ruby-string">&#39;primary_payload&#39;</span> }
+  <span class="ruby-identifier">related_to_activity_as</span> = <span class="ruby-node">%w[primary_payload primary_update_payload primary_destroy_payload]</span>
+  <span class="ruby-identifier">payloads</span>.<span class="ruby-identifier">detect</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span> <span class="ruby-identifier">related_to_activity_as</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">p</span>.<span class="ruby-identifier">related_to_activity_as</span>) }
 <span class="ruby-keyword">end</span></pre>
           </div>
         </div>
@@ -620,69 +529,11 @@
           <p>Returns the key for the logged record.</p>
 
           <div class="method-source-code" id="record_key-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 217</span>
+            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 168</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">record_key</span>
   <span class="ruby-keyword">return</span> <span class="ruby-keyword">nil</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">record</span>.<span class="ruby-identifier">nil?</span>
 
-  <span class="ruby-constant">LoggableActivity</span><span class="ruby-operator">::</span><span class="ruby-constant">EncryptionKey</span>.<span class="ruby-identifier">for_record</span>(<span class="ruby-identifier">record</span>)&amp;.<span class="ruby-identifier">key</span>
-<span class="ruby-keyword">end</span></pre>
-          </div>
-        </div>
-
-
-      </div>
-
-      <div id="method-i-update_attrs" class="method-detail ">
-        <div class="method-header">
-          <div class="method-heading">
-            <span class="method-name">update_attrs</span><span
-              class="method-args">()</span>
-            <span class="method-click-advice">click to toggle source</span>
-          </div>
-        </div>
-
-        <div class="method-description">
-          <p>Returns the attributes for the update+payload.</p>
-
-          <div class="method-source-code" id="update_attrs-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 180</span>
-<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">update_attrs</span>
-  <span class="ruby-identifier">update_payload_attrs</span> = <span class="ruby-identifier">attrs</span>.<span class="ruby-identifier">find</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span> <span class="ruby-identifier">p</span>[<span class="ruby-value">:payload_type</span>] <span class="ruby-operator">==</span> <span class="ruby-string">&#39;update_payload&#39;</span> }
-  <span class="ruby-keyword">return</span> <span class="ruby-keyword">nil</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">update_payload_attrs</span>
-
-  <span class="ruby-identifier">update_payload_attrs</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value">:payload_type</span>)
-  <span class="ruby-identifier">update_payload_attrs</span>
-<span class="ruby-keyword">end</span></pre>
-          </div>
-        </div>
-
-
-      </div>
-
-      <div id="method-i-updated_relations_attrs" class="method-detail ">
-        <div class="method-header">
-          <div class="method-heading">
-            <span class="method-name">updated_relations_attrs</span><span
-              class="method-args">()</span>
-            <span class="method-click-advice">click to toggle source</span>
-          </div>
-        </div>
-
-        <div class="method-description">
-          <p>Returns the attributes for the updated relations.</p>
-
-          <div class="method-source-code" id="updated_relations_attrs-source">
-            <pre><span class="ruby-comment"># File lib/loggable_activity/activity.rb, line 194</span>
-<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">updated_relations_attrs</span>
-  <span class="ruby-identifier">grouped_associations</span> = <span class="ruby-identifier">attrs</span>.<span class="ruby-identifier">group_by</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span> <span class="ruby-identifier">p</span>[<span class="ruby-value">:record_type</span>] }
-
-  <span class="ruby-identifier">grouped_associations</span>.<span class="ruby-identifier">map</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">record_type</span>, <span class="ruby-identifier">payloads</span><span class="ruby-operator">|</span>
-    <span class="ruby-identifier">previous_attrs</span> = <span class="ruby-identifier">payloads</span>.<span class="ruby-identifier">find</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span> <span class="ruby-identifier">p</span>[<span class="ruby-value">:payload_type</span>] <span class="ruby-operator">==</span> <span class="ruby-string">&#39;previous_association&#39;</span> }
-    <span class="ruby-identifier">current_attrs</span> = <span class="ruby-identifier">payloads</span>.<span class="ruby-identifier">find</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span> <span class="ruby-identifier">p</span>[<span class="ruby-value">:payload_type</span>] <span class="ruby-operator">==</span> <span class="ruby-string">&#39;current_association&#39;</span> }
-    <span class="ruby-keyword">next</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">previous_attrs</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">current_attrs</span>.<span class="ruby-identifier">nil?</span>
-
-    { <span class="ruby-value">record_type:</span>, <span class="ruby-value">previous_attrs:</span>, <span class="ruby-value">current_attrs:</span> }
-  <span class="ruby-keyword">end</span>.<span class="ruby-identifier">compact</span>
+  <span class="ruby-operator">::</span><span class="ruby-constant">LoggableActivity</span><span class="ruby-operator">::</span><span class="ruby-constant">EncryptionKey</span>.<span class="ruby-identifier">for_record</span>(<span class="ruby-identifier">record</span>)&amp;.<span class="ruby-identifier">secret_key</span>
 <span class="ruby-keyword">end</span></pre>
           </div>
         </div>