releases/v2.7.0

- [c991495][michaeljymsgutierrez]: Updated release version from v2.6.3 to v2.7.0 - 2026-03-22 12:02:39
- [a2b7ba1][Chael Gutierrez]: Features/request alias getter (#232) - 2026-03-22 03:09:54

Author: michaeljymsgutierrez

DOCS.md

@@ -55,6 +55,12 @@ single record object.</p>
 if <code>aliasRecords</code> is falsy). If it&#39;s a plain object, it&#39;s used directly
 (or an empty object if <code>aliasRecords</code> is falsy).</p>
 </dd>
+<dt><a href="#_addRequestAlias">_addRequestAlias(aliasName, requestHashKey)</a> ℗</dt>
+<dd><p>Adds a request alias to the request aliases object.</p>
+<p>This method maps a specific <code>aliasName</code> to a <code>requestHashKey</code> in the
+<code>requestAliases</code> dictionary. This allows the system to reference a
+specific request context using a human-readable alias.</p>
+</dd>
 <dt><a href="#_generateHashId">_generateHashId([object])</a> ⇒ <code>string</code> ℗</dt>
 <dd><p>Generates a hash ID based on the provided object.</p>
 <p>This method generates a unique hash ID by stringifying the given
@@ -332,6 +338,12 @@ not exist, it returns the provided <code>fallbackRecords</code> (if any).</p>
 <p>If <code>fallbackRecords</code> is a plain object, the method injects collection
 actions into it using <code>_injectCollectionActions</code> before returning it.</p>
 </dd>
+<dt><a href="#getRequestAlias">getRequestAlias(aliasName)</a> ⇒ <code>Object</code> | <code>null</code></dt>
+<dd><p>Retrieves the request data by resolving a readable alias to its latest request hash.</p>
+<p>The <code>requestAliases</code> property acts as a reference map, linking a human-readable
+alias to the hash of the most recent request. This method performs a lookup
+on that hash to return the actual request data.</p>
+</dd>
 <dt><a href="#createRecord">createRecord(collectionName, [collectionRecord], [collectionRecordRandomId])</a> ⇒ <code>Object</code></dt>
 <dd><p>Creates a new record in a specified collection.</p>
 <p>This method creates a new record in the collection with the given
@@ -376,8 +388,13 @@ request caching, and asynchronous loading of related resources.</p>
 <dt><a href="#_processRequestURL">_processRequestURL(requestOptions, resourceName, resourceId)</a></dt>
 <dd><p>Processes the URL for a request, constructing it from the resource name and ID.</p>
 </dd>
-<dt><a href="#_processRequestAlias">_processRequestAlias(resourceConfig, collectionRecords)</a></dt>
-<dd><p>Processes an alias for a request, adding it to the aliases store.</p>
+<dt><a href="#_processRequestAlias">_processRequestAlias(requestObject, collectionRecords)</a> ℗</dt>
+<dd><p>Processes an alias for a request, mapping both the records and the request hash.</p>
+<p>This method extracts the alias name from the request configuration and:</p>
+<ol>
+<li>Maps the alias name to the provided collection records in the aliases store.</li>
+<li>Maps the alias name to the generated request hash key in the request aliases store.</li>
+</ol>
 </dd>
 <dt><a href="#_processRequestOverride">_processRequestOverride(resourceConfig, requestOptions)</a></dt>
 <dd><p>Processes request overrides based on the provided configuration.</p>
@@ -646,6 +663,23 @@ if `aliasRecords` is falsy). If it's a plain object, it's used directly
 | aliasName | <code>string</code> | The name of the alias. |
 | aliasRecords | <code>Array</code> \| <code>Object</code> | The records to be aliased. |
 
+<a name="_addRequestAlias"></a>
+
+## \_addRequestAlias(aliasName, requestHashKey) ℗
+Adds a request alias to the request aliases object.
+
+This method maps a specific `aliasName` to a `requestHashKey` in the
+`requestAliases` dictionary. This allows the system to reference a
+specific request context using a human-readable alias.
+
+**Kind**: global function  
+**Access**: private  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| aliasName | <code>string</code> | The name of the alias for the request. |
+| requestHashKey | <code>string</code> | The unique hash key identifying the request. |
+
 <a name="_generateHashId"></a>
 
 ## \_generateHashId([object]) ⇒ <code>string</code> ℗
@@ -1252,6 +1286,22 @@ actions into it using `_injectCollectionActions` before returning it.
 | aliasName | <code>string</code> | The name of the alias to retrieve. |
 | [fallbackRecords] | <code>Array</code> \| <code>Object</code> | Optional fallback records                                           to return if the alias                                           is not found. |
 
+<a name="getRequestAlias"></a>
+
+## getRequestAlias(aliasName) ⇒ <code>Object</code> \| <code>null</code>
+Retrieves the request data by resolving a readable alias to its latest request hash.
+
+The `requestAliases` property acts as a reference map, linking a human-readable
+alias to the hash of the most recent request. This method performs a lookup
+on that hash to return the actual request data.
+
+**Kind**: global function  
+**Returns**: <code>Object</code> \| <code>null</code> - The request data object if found; otherwise, null.  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| aliasName | <code>string</code> | The readable alias name to resolve. |
+
 <a name="createRecord"></a>
 
 ## createRecord(collectionName, [collectionRecord], [collectionRecordRandomId]) ⇒ <code>Object</code>
@@ -1376,15 +1426,20 @@ Processes the URL for a request, constructing it from the resource name and ID.
 
 <a name="_processRequestAlias"></a>
 
-## \_processRequestAlias(resourceConfig, collectionRecords)
-Processes an alias for a request, adding it to the aliases store.
+## \_processRequestAlias(requestObject, collectionRecords) ℗
+Processes an alias for a request, mapping both the records and the request hash.
+
+This method extracts the alias name from the request configuration and:
+1. Maps the alias name to the provided collection records in the aliases store.
+2. Maps the alias name to the generated request hash key in the request aliases store.
 
 **Kind**: global function  
+**Access**: private  
 
 | Param | Type | Description |
 | --- | --- | --- |
-| resourceConfig | <code>Object</code> | The configuration object for the resource request, containing the alias information. |
-| collectionRecords | <code>Array</code> \| <code>Object</code> | The records to be aliased. Can be an array or an object. |
+| requestObject | <code>Object</code> | The full request object used to generate the hash ID and containing the resource configuration. |
+| collectionRecords | <code>Array</code> \| <code>Object</code> | The records to be aliased. Can be an array or a single object. |
 
 <a name="_processRequestOverride"></a>
 

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.6.3-blue" alt="npm-badge-logo" />
+    <img src="https://img.shields.io/badge/npm_version-2.7.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" />
@@ -81,7 +81,7 @@ By centralizing data management and offering flexible access to it, ARM empowers
 
 ```javascript
 // Example usage in ReactJS/NextJS
-import { observer } from 'mobx-react-lite'
+import { observer } from 'mobx-react'
 import { ARM } from '@/components/providers/arm-config-provider'
 
 const App = observer(() => {
@@ -506,6 +506,22 @@ See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/m
   </ul>
   ```
 
+- **getRequestAlias(aliasName)**
+  - Retrieving the [returned object](#returned-object-request-functions-from-server) from the request functions.
+  - See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/main/apps/create-next-app/src/app/demo/retrieve-functions-from-collections/get-request-alias)
+
+  ```javascript
+  const addresses = ARM.getRequestAlias('customerAddresses')
+
+  ARM.findAll('addresses', { alias: 'customerAddresses' })
+
+  <ul>
+    {addresses.data.map((address, index) => (
+      <li key={index}>{address.get('id')}</li>
+    ))}
+  </ul>
+  ```
+
 #### Create collection record function
 
 ---
@@ -588,7 +604,7 @@ See example [here](https://github.com/michaeljymsgutierrez/arm-js-library/tree/m
   "type": "addresses",
   "attributes": {
     "address1": "Test Address 1",
-    "address2": "171872.6.3222",
+    "address2": "171872.7.0222",
     "kind": "office",
     "label": "Anabu Hills",
     "latitude": "14.394261",
@@ -1063,4 +1079,4 @@ const addresses = [
 
 ## License
 
-This project is licensed under the MIT License.
+This project is licensed under the [MIT](https://github.com/michaeljymsgutierrez/arm-js-library/blob/main/LICENSE.md) License.

apps/create-next-app/next.config.mjs

@@ -1,5 +1,8 @@
 /** @type {import('next').NextConfig} */
 const nextConfig = {
+  turbopack: {
+    root: '../../',
+  },
   async redirects() {
     return [
       {

apps/create-next-app/src/app/demo/page.jsx

@@ -40,6 +40,7 @@ const DemoPage = () => {
     '/demo/request-functions-from-server/query',
     '/demo/request-functions-from-server/returned-object',
     '/demo/retrieve-functions-from-collections/get-alias',
+    '/demo/retrieve-functions-from-collections/get-request-alias',
     '/demo/retrieve-functions-from-collections/get-collection',
     '/demo/retrieve-functions-from-collections/peek-all',
     '/demo/retrieve-functions-from-collections/peek-record',
@@ -54,10 +55,18 @@ const DemoPage = () => {
   return (
     <div className="flex justify-center items-center min-h-screen bg-gray-100 p-5">
       <div className="bg-white p-8 rounded-lg shadow-xl w-full max-w-2xl">
-        <h1 className="text-3xl font-bold text-center mb-8">Demo Links</h1>
+        <a href="https://www.npmjs.com/package/arm-js-library">
+          <img
+            src="https://assets-omega-neon.vercel.app/images/arm-js-title-logo.png"
+            alt="arm-js-logo"
+            height="200"
+            width="143.7"
+            className="my-8 mx-auto"
+          />
+        </a>
         <input
           type="text"
-          placeholder="Search demos..."
+          placeholder="Search demo links..."
           className="w-full p-3 mb-6 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500"
           value={searchTerm}
           onChange={(e) => setSearchTerm(e.target.value)}

apps/create-next-app/src/app/demo/retrieve-functions-from-collections/get-request-alias/controller.js

@@ -0,0 +1,11 @@
+'use client'
+
+import { ARM } from '@/components/providers/arm-config-provider'
+
+const Controller = () => {
+  return {
+    addresses: ARM.getRequestAlias('customerAddresses'),
+  }
+}
+
+export default Controller

apps/create-next-app/src/app/demo/retrieve-functions-from-collections/get-request-alias/model.js

@@ -0,0 +1,11 @@
+'use client'
+
+import { ARM } from '@/components/providers/arm-config-provider'
+
+const Model = () => {
+  return {
+    addresses: ARM.findAll('addresses', { alias: 'customerAddresses' }),
+  }
+}
+
+export default Model

apps/create-next-app/src/app/demo/retrieve-functions-from-collections/get-request-alias/page.jsx

@@ -0,0 +1,52 @@
+'use client'
+
+import { observer } from 'mobx-react'
+import Controller from './controller'
+import Model from './model'
+
+const Page = observer(() => {
+  const controller = Controller()
+  const { isLoading } = Model()
+
+  return (
+    <table>
+      <thead>
+        <tr>
+          <th>ADDRESS1</th>
+          <th>ADDRESS2</th>
+          <th>CITY</th>
+          <th>POST CODE</th>
+          <th>LANDMARK</th>
+          <th>KIND</th>
+          <th>LABEL</th>
+          <th>LONGITUDE</th>
+          <th>LATITUDE</th>
+        </tr>
+      </thead>
+      <tbody>
+        {isLoading && (
+          <tr>
+            <td colSpan="9">Loading...</td>
+          </tr>
+        )}
+
+        {!isLoading &&
+          controller.addresses?.data.map((address) => (
+            <tr key={address.get('id')}>
+              <td>{address.get('attributes.address1')}</td>
+              <td>{address.get('attributes.address2')}</td>
+              <td>{address.get('attributes.city')}</td>
+              <td>{address.get('attributes.post-code')}</td>
+              <td>{address.get('attributes.landmark')}</td>
+              <td>{address.get('attributes.kind')}</td>
+              <td>{address.get('attributes.label')}</td>
+              <td>{address.get('attributes.longitude')}</td>
+              <td>{address.get('attributes.latitude')}</td>
+            </tr>
+          ))}
+      </tbody>
+    </table>
+  )
+})
+
+export default Page