releases/v2.8.0

- [0ffad7d][michaeljymsgutierrez]: Updated release version from v2.7.0 to v2.8.0 - 2026-04-22 22:09:20
- [a1f0db2][Chael Gutierrez]: Features/record rollback attributes (#236) - 2026-04-19 02:40:11

Author: michaeljymsgutierrez

DOCS.md

@@ -155,6 +155,12 @@ to provide additional configuration for the request.</p>
 <dd><p>Reloads a record from the server.</p>
 <p>Fetches the latest data for the specified record and updates the local copy.</p>
 </dd>
+<dt><a href="#_rollbackRecordAttributes">_rollbackRecordAttributes()</a> ⇒ <code>void</code> ℗</dt>
+<dd><p>Reverts the record&#39;s attributes to their original state.</p>
+<p>This method retrieves the stored <code>originalRecord</code> (excluding internal
+ARM properties), applies those values back to the current record instance,
+and resets the <code>isDirty</code> and <code>isPristine</code> state flags.</p>
+</dd>
 <dt><a href="#_getCollectionRecord">_getCollectionRecord(collectionName, [collectionConfig], currentRecord)</a> ⇒ <code>Object</code> | <code>Array</code> ℗</dt>
 <dd><p>Retrieves records from a specified collection based on given criteria.</p>
 <p>This method retrieves records from the collection with the specified
@@ -915,6 +921,17 @@ Fetches the latest data for the specified record and updates the local copy.
 | currentRecord | <code>Object</code> |  | The record to reload. |
 | [collectionConfig] | <code>Object</code> | <code>{}</code> | Optional configuration for the collection. |
 
+<a name="_rollbackRecordAttributes"></a>
+
+## \_rollbackRecordAttributes() ⇒ <code>void</code> ℗
+Reverts the record's attributes to their original state.
+
+This method retrieves the stored `originalRecord` (excluding internal
+ARM properties), applies those values back to the current record instance,
+and resets the `isDirty` and `isPristine` state flags.
+
+**Kind**: global function  
+**Access**: private  
 <a name="_getCollectionRecord"></a>
 
 ## \_getCollectionRecord(collectionName, [collectionConfig], currentRecord) ⇒ <code>Object</code> \| <code>Array</code> ℗

README.md

@@ -9,7 +9,7 @@
     <img src="https://github.com/michaeljymsgutierrez/arm-js-library/actions/workflows/ci-cd.yml/badge.svg" alt="cicd-badge-logo" />
   </a>
   <a href="https://www.npmjs.com/package/arm-js-library">
-    <img src="https://img.shields.io/badge/npm_version-2.7.0-blue" alt="npm-badge-logo" />
+    <img src="https://img.shields.io/badge/npm_version-2.8.0-blue" alt="npm-badge-logo" />
   </a>
   <a href="https://github.com/michaeljymsgutierrez/arm-js-library?tab=MIT-1-ov-file">
     <img src="https://img.shields.io/badge/license-MIT-green" alt="license-badge-logo" />
@@ -604,7 +604,7 @@ See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/m
   "type": "addresses",
   "attributes": {
     "address1": "Test Address 1",
-    "address2": "171872.7.0222",
+    "address2": "171872.8.0222",
     "kind": "office",
     "label": "Anabu Hills",
     "latitude": "14.394261",
@@ -702,7 +702,7 @@ See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/m
     address.get('attributes.label')
     ```
 
-- **Request Functions**
+- **Request and Retrieve Functions**
   - **save(collectionConfig)**
     - Persist collection record changes to server.
     - Create a new record to server only if it doesn't already exist in the database.
@@ -711,7 +711,7 @@ See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/m
       - Will call **PUT** method: `PUT /addresses/2519858`
     - Support collectionConfig. - **optional**
       - Available collectionConfig `(skip, alias, autoResolve, ignorePayload, override)`
-    - See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/main/apps/create-next-app/src/app/demo/collection-records/request-functions/save)
+    - See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/main/apps/create-next-app/src/app/demo/collection-records/request-retrieve-functions/save)
 
     ```javascript
     // Returned promise
@@ -727,7 +727,7 @@ See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/m
       - Will call **GET** method: `GET /addresses/2519858`
     - Support collectionConfig. - **optional**
       - Available collectionConfig `(skip, alias, autoResolve, ignorePayload, override)`
-    - See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/main/apps/create-next-app/src/app/demo/collection-records/request-functions/reload)
+    - See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/main/apps/create-next-app/src/app/demo/collection-records/request-retrieve-functions/reload)
 
     ```javascript
     // Returned promise
@@ -741,12 +741,20 @@ See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/m
     })
     ```
 
+  - **rollbackAttributes()**
+    - Rollback record attributes to their original state without triggering a request.
+    - See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/main/apps/create-next-app/src/app/demo/collection-records/request-retrieve-functions/rollback-attributes)
+
+    ```javascript
+    address.rollbackAttributes()
+    ```
+
   - **destroyRecord(collectionConfig)**
     - Remove collection record permanently from server.
       - Will call **GET** method: `DELETE /addresses/2519858`
     - Support collectionConfig. - **optional**
       - Available collectionConfig `(skip, alias, autoResolve, ignorePayload, override)`
-    - See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/main/apps/create-next-app/src/app/demo/collection-records/request-functions/destroy-record)
+    - See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/main/apps/create-next-app/src/app/demo/collection-records/request-retrieve-functions/destroy-record)
 
     ```javascript
     // Returned promise
@@ -779,7 +787,7 @@ See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/m
           - Sort returned collection records based on passed array of sort criteria.
         - **config - Object**
           - Contains request config such as `(skip, alias, autoResolve, ignorePayload, override)` which are currently available.
-    - See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/main/apps/create-next-app/src/app/demo/collection-records/request-functions/get-collection)
+    - See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/main/apps/create-next-app/src/app/demo/collection-records/request-retrieve-functions/get-collection)
 
     ```javascript
     // Get user record from the server but don't preload addresses records.
@@ -1056,26 +1064,9 @@ const addresses = [
 
 ## Credits
 
-<a href="https://www.facebook.com/skpcls" title="Axl Asuncion (Graphic Artist) - Original logo/design creator">
-  <img 
-    src="https://assets-omega-neon.vercel.app/images/axl.png" 
-    alt="Axl Asuncion" 
-    height="40" width="40" />
-</a>
-
-<a href="https://github.com/luigircruz" title="Luigi Cruz (Developer) - Features and bugs feedback" >
-  <img 
-    src="https://assets-omega-neon.vercel.app/images/luigi.png" 
-    alt="Luigi Cruz"
-    height="40" width="40" />
-</a>
-
-<a href="https://github.com/DicksonPal" title="Dickson Palomeras (Developer) - Features and bugs feedback" >
-  <img 
-    src="https://assets-omega-neon.vercel.app/images/dickson.png" 
-    alt="Dickson Palomeras"
-    height="40" width="40" />
-</a>
+- **[Axl Asuncion](https://www.facebook.com/skpcls)** - Original logo/design creator
+- **[Luigi Cruz](https://github.com/luigircruz)** - Features and bugs feedback
+- **[Dickson Palomeras](https://github.com/DicksonPal)** - Features and bugs feedback
 
 ## License
 

…equest-functions/destroy-record/model.js …trieve-functions/destroy-record/model.jsapps/create-next-app/src/app/demo/collection-records/request-functions/destroy-record/model.js renamed to apps/create-next-app/src/app/demo/collection-records/request-retrieve-functions/destroy-record/model.js apps/create-next-app/src/app/demo/collection-records/request-functions/destroy-record/model.js renamed to apps/create-next-app/src/app/demo/collection-records/request-retrieve-functions/destroy-record/model.js

@@ -0,0 +1,132 @@
+'use client'
+
+import { observer } from 'mobx-react'
+import Model from './model'
+
+const Page = observer(() => {
+  const { isLoading, data: address } = Model()
+
+  if (isLoading) return <div>Loading...</div>
+
+  return (
+    <form onSubmit={(event) => event.preventDefault()}>
+      <div className="form-control">
+        <label htmlFor="address1">Address1</label>
+        <input
+          type="text"
+          name="address1"
+          value={address.get('attributes.address1') ?? ''}
+          onChange={(event) =>
+            address.set('attributes.address1', event.target.value)
+          }
+        />
+      </div>
+
+      <div className="form-control">
+        <label htmlFor="address2">Address2</label>
+        <input
+          type="text"
+          name="address2"
+          value={address.get('attributes.address2') ?? ''}
+          onChange={(event) =>
+            address.set('attributes.address2', event.target.value)
+          }
+        />
+      </div>
+
+      <div className="form-control">
+        <label htmlFor="city">City</label>
+        <input
+          type="text"
+          name="city"
+          value={address.get('attributes.city') ?? ''}
+          onChange={(event) =>
+            address.set('attributes.city', event.target.value)
+          }
+        />
+      </div>
+
+      <div className="form-control">
+        <label htmlFor="post-code">Post code</label>
+        <input
+          type="text"
+          name="post-code"
+          value={address.get('attributes.post-code') ?? ''}
+          onChange={(event) =>
+            address.set('attributes.post-code', event.target.value)
+          }
+        />
+      </div>
+
+      <div className="form-control">
+        <label htmlFor="landmark">Landmark</label>
+        <input
+          type="text"
+          name="landmark"
+          value={address.get('attributes.landmark') ?? ''}
+          onChange={(event) =>
+            address.set('attributes.landmark', event.target.value)
+          }
+        />
+      </div>
+
+      <div className="form-control">
+        <label htmlFor="kind">Kind</label>
+        <input
+          type="text"
+          name="kind"
+          value={address.get('attributes.kind') ?? ''}
+          onChange={(event) =>
+            address.set('attributes.kind', event.target.value)
+          }
+        />
+      </div>
+
+      <div className="form-control">
+        <label htmlFor="label">Label</label>
+        <input
+          type="text"
+          name="label"
+          value={address.get('attributes.label') ?? ''}
+          onChange={(event) =>
+            address.set('attributes.label', event.target.value)
+          }
+        />
+      </div>
+
+      <div className="form-control">
+        <label htmlFor="latitude">Latitude</label>
+        <input
+          type="text"
+          name="latitude"
+          value={address.get('attributes.latitude')}
+          onChange={(event) =>
+            address.set('attributes.latitude', event.target.value)
+          }
+        />
+      </div>
+
+      <div className="form-control">
+        <label htmlFor="longitude">Longitude</label>
+        <input
+          type="text"
+          name="longitude"
+          value={address.get('attributes.longitude')}
+          onChange={(event) =>
+            address.set('attributes.longitude', event.target.value)
+          }
+        />
+      </div>
+
+      <div className="form-control">
+        <button
+          className="blue-btn"
+          onClick={() => address.rollbackAttributes()}>
+          Rollback Attributes
+        </button>
+      </div>
+    </form>
+  )
+})
+
+export default Page