@docbrasil/api-systemmanager 1.1.82 → 1.1.84

package/doc/api.md

@@ -5403,6 +5403,8 @@ Api dispatch manager
     * [.errorOffline()](#Dispatch+errorOffline)
     * [.getContext(url, [session])](#Dispatch+getContext) ⇒ <code>Promise.&lt;object&gt;</code>
     * [.getClient()](#Dispatch+getClient) ⇒ <code>AxiosInstance</code>
+    * [.setAkamaiBaseUrl(url, [options])](#Dispatch+setAkamaiBaseUrl)
+    * [.getAkamaiClient()](#Dispatch+getAkamaiClient) ⇒ <code>AxiosInstance</code>
 
 <a name="Dispatch+errorOffline"></a>
 
@@ -5432,6 +5434,33 @@ Get the Axios client.
 **Kind**: instance method of [<code>Dispatch</code>](#Dispatch)  
 **Returns**: <code>AxiosInstance</code> - The Axios client.  
 **Access**: public  
+<a name="Dispatch+setAkamaiBaseUrl"></a>
+
+### dispatch.setAkamaiBaseUrl(url, [options])
+Create a dedicated Axios client for Akamai routes.
+In DEV there is no NGiNX to translate the Authorization JWT into the
+x-api-key / x-user-id / x-organization-id headers that Akamai expects.
+When an apiKey is supplied the client adds a request interceptor that
+decodes the JWT and sets those headers automatically.
+
+**Kind**: instance method of [<code>Dispatch</code>](#Dispatch)  
+**Access**: public  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| url | <code>string</code> | The Akamai base URL (e.g., http://localhost:9008 in DEV). |
+| [options] | <code>object</code> | Optional configuration |
+| [options.apiKey] | <code>string</code> | API key for Akamai authentication.   When provided, the client will transform the Authorization JWT into   x-api-key, x-user-id and x-organization-id headers on every request. |
+
+<a name="Dispatch+getAkamaiClient"></a>
+
+### dispatch.getAkamaiClient() ⇒ <code>AxiosInstance</code>
+Get the Akamai Axios client. Falls back to the default client
+for backward compatibility (e.g., PROD where NGiNX proxies all routes).
+
+**Kind**: instance method of [<code>Dispatch</code>](#Dispatch)  
+**Returns**: <code>AxiosInstance</code> - The Akamai client or default client.  
+**Access**: public  
 <a name="External"></a>
 
 ## External

package/docs/AISession.html

@@ -495,7 +495,7 @@ Use this to create a session with full metadata before triggering execution.
         <p class="tag-source">
             <a href="ai_sessions.js.html" class="button">View Source</a>
             <span>
-                <a href="ai_sessions.js.html">ai/sessions.js</a>, <a href="ai_sessions.js.html#line182">line 182</a>
+                <a href="ai_sessions.js.html">ai/sessions.js</a>, <a href="ai_sessions.js.html#line183">line 183</a>
             </span>
         </p>
     
@@ -844,7 +844,7 @@ const retData = await api.ai.sessions.create(params, authorization);</code></pre
         <p class="tag-source">
             <a href="ai_sessions.js.html" class="button">View Source</a>
             <span>
-                <a href="ai_sessions.js.html">ai/sessions.js</a>, <a href="ai_sessions.js.html#line224">line 224</a>
+                <a href="ai_sessions.js.html">ai/sessions.js</a>, <a href="ai_sessions.js.html#line226">line 226</a>
             </span>
         </p>
     
@@ -1133,7 +1133,7 @@ Returns session, execution, activities, pages, triples and summary.
         <p class="tag-source">
             <a href="ai_sessions.js.html" class="button">View Source</a>
             <span>
-                <a href="ai_sessions.js.html">ai/sessions.js</a>, <a href="ai_sessions.js.html#line74">line 74</a>
+                <a href="ai_sessions.js.html">ai/sessions.js</a>, <a href="ai_sessions.js.html#line73">line 73</a>
             </span>
         </p>
     

package/docs/Dispatch.html

@@ -314,6 +314,129 @@
 
 
 
+
+</div>
+            
+                <div class="member">
+
+
+    
+    <h4 class="name" id="getAkamaiClient">
+        <a class="href-link" href="#getAkamaiClient">#</a>
+        
+        <span class="code-name">
+            
+                getAkamaiClient<span class="signature">()</span><span class="type-signature"> &rarr; {AxiosInstance}</span>
+            
+        </span>
+    </h4>
+    
+
+    
+    
+    <div class="description">
+        Get the Akamai Axios client. Falls back to the default client
+for backward compatibility (e.g., PROD where NGiNX proxies all routes).
+    </div>
+    
+
+
+
+
+
+
+
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    
+
+    
+
+    
+
+    
+        <p class="tag-source">
+            <a href="dispatch.js.html" class="button">View Source</a>
+            <span>
+                <a href="dispatch.js.html">dispatch.js</a>, <a href="dispatch.js.html#line277">line 277</a>
+            </span>
+        </p>
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+    <div class='columns method-parameter'>
+        <div class="column is-2"><label>Returns:</label></div>
+        <div class="column is-10">
+            
+                    
+
+<div class="columns">
+    
+    <div class='param-desc column is-7'>The Akamai client or default client.</div>
+    
+    
+    <div class='column is-5 has-text-left'>
+        <label>Type: </label>
+        
+<code class="param-type">AxiosInstance</code>
+
+
+    </div>
+    
+</div>
+
+                
+        </div>
+    </div>
+
+
+
 
 </div>
             
@@ -673,6 +796,241 @@
 
 
 
+
+</div>
+            
+                <div class="member">
+
+
+    
+    <h4 class="name" id="setAkamaiBaseUrl">
+        <a class="href-link" href="#setAkamaiBaseUrl">#</a>
+        
+        <span class="code-name">
+            
+                setAkamaiBaseUrl<span class="signature">(url, options<span class="signature-attributes">opt</span>)</span><span class="type-signature"></span>
+            
+        </span>
+    </h4>
+    
+
+    
+    
+    <div class="description">
+        Create a dedicated Axios client for Akamai routes.
+In DEV there is no NGiNX to translate the Authorization JWT into the
+x-api-key / x-user-id / x-organization-id headers that Akamai expects.
+When an apiKey is supplied the client adds a request interceptor that
+decodes the JWT and sets those headers automatically.
+    </div>
+    
+
+
+
+
+
+
+
+
+
+    <h5>Parameters:</h5>
+    
+<div class="table-container">
+    <table class="params table">
+        <thead>
+        <tr>
+            
+            <th>Name</th>
+            
+
+            <th>Type</th>
+
+            
+            <th>Attributes</th>
+            
+
+            
+
+            <th class="last">Description</th>
+        </tr>
+        </thead>
+
+        <tbody>
+        
+
+            
+<tr class="deep-level-0">
+  
+      <td class="name"><code>url</code></td>
+  
+
+  <td class="type">
+  
+      
+<code class="param-type">string</code>
+
+
+  
+  </td>
+
+  
+      <td class="attributes">
+      
+
+      
+
+      
+      </td>
+  
+
+  
+
+  <td class="description last">The Akamai base URL (e.g., http://localhost:9008 in DEV).</td>
+</tr>
+
+
+        
+
+            
+<tr class="deep-level-0">
+  
+      <td class="name"><code>options</code></td>
+  
+
+  <td class="type">
+  
+      
+<code class="param-type">object</code>
+
+
+  
+  </td>
+
+  
+      <td class="attributes">
+      
+          &lt;optional><br>
+      
+
+      
+
+      
+      </td>
+  
+
+  
+
+  <td class="description last">Optional configuration</td>
+</tr>
+
+  
+  
+    
+<tr class="deep-level-1">
+  
+      <td class="name"><code>apiKey</code></td>
+  
+
+  <td class="type">
+  
+      
+<code class="param-type">string</code>
+
+
+  
+  </td>
+
+  
+      <td class="attributes">
+      
+          &lt;optional><br>
+      
+
+      
+
+      
+      </td>
+  
+
+  
+
+  <td class="description last">API key for Akamai authentication.
+  When provided, the client will transform the Authorization JWT into
+  x-api-key, x-user-id and x-organization-id headers on every request.</td>
+</tr>
+
+  
+
+
+        
+        </tbody>
+    </table>
+</div>
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+    
+
+    
+
+    
+
+    
+        <p class="tag-source">
+            <a href="dispatch.js.html" class="button">View Source</a>
+            <span>
+                <a href="dispatch.js.html">dispatch.js</a>, <a href="dispatch.js.html#line236">line 236</a>
+            </span>
+        </p>
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 
 </div>
             

package/docs/MyndAI.html

@@ -632,7 +632,7 @@
         <p class="tag-source">
             <a href="ai_index.js.html" class="button">View Source</a>
             <span>
-                <a href="ai_index.js.html">ai/index.js</a>, <a href="ai_index.js.html#line88">line 88</a>
+                <a href="ai_index.js.html">ai/index.js</a>, <a href="ai_index.js.html#line87">line 87</a>
             </span>
         </p>
     

package/docs/ai_index.js.html

@@ -102,7 +102,6 @@ class MyndAI {
 
     const self = this;
     self.parent = options.parent;
-    self._client = self.parent.dispatch.getClient();
 
     self.sessions = new AISession(options);
   }
@@ -179,7 +178,8 @@ class MyndAI {
       Joi.assert(params, Joi.object().required().error(new Error('params is required')));
       Joi.assert(params.prompt, Joi.string().required().error(new Error('Provide a prompt')));
 
-      const apiCall = self._client
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
           .post('/agents/explain', params, self._setHeader(authorization));
 
       return self._returnData(await apiCall);

package/docs/ai_sessions.js.html

@@ -101,7 +101,6 @@ class AISession {
 
     const self = this;
     self.parent = options.parent;
-    self._client = self.parent.dispatch.getClient();
   }
 
   /**
@@ -165,7 +164,8 @@ class AISession {
       Joi.assert(params, Joi.object().required().error(new Error('params is required')));
       Joi.assert(params.documentId, Joi.string().required().error(new Error('documentId is required')));
 
-      const apiCall = self._client
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
         .get(`/agents/session/document/${params.documentId}`, self._setHeader(authorization));
 
       return self._returnData(await apiCall);
@@ -227,7 +227,8 @@ class AISession {
 
       const { documentId, ...payload } = params;
 
-      const apiCall = self._client
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
         .patch(`/agents/session/document/${documentId}`, payload, self._setHeader(authorization));
 
       return self._returnData(await apiCall);
@@ -273,7 +274,8 @@ class AISession {
       Joi.assert(params, Joi.object().required().error(new Error('params is required')));
       Joi.assert(params.agentType, Joi.string().required().error(new Error('agentType is required')));
 
-      const apiCall = self._client
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
         .post('/agents/create', params, self._setHeader(authorization));
 
       return self._returnData(await apiCall);
@@ -317,7 +319,8 @@ class AISession {
 
       const { sessionId, ...payload } = params;
 
-      const apiCall = self._client
+      const client = self.parent.dispatch.getAkamaiClient();
+      const apiCall = client
         .post(`/agents/${sessionId}/execute`, payload, self._setHeader(authorization));
 
       return self._returnData(await apiCall);

package/docs/dispatch.js.html

@@ -285,6 +285,85 @@ class Dispatch {
   getClient() {
     return this._client;
   }
+
+  /**
+   * @description Decode the payload of a JWT token (base64url → JSON).
+   * Does NOT verify the signature — used only to extract claims for header building.
+   * @param {string} token JWT token string
+   * @return {object|null} Decoded payload or null on failure
+   * @private
+   */
+  _decodeJwtPayload(token) {
+    try {
+      const parts = token.split('.');
+      if (parts.length !== 3) return null;
+      const base64 = parts[1].replace(/-/g, '+').replace(/_/g, '/');
+      const json = decodeURIComponent(
+        atob(base64).split('').map(c => '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2)).join('')
+      );
+      return JSON.parse(json);
+    } catch (e) {
+      return null;
+    }
+  }
+
+  /**
+   * @description Create a dedicated Axios client for Akamai routes.
+   * In DEV there is no NGiNX to translate the Authorization JWT into the
+   * x-api-key / x-user-id / x-organization-id headers that Akamai expects.
+   * When an apiKey is supplied the client adds a request interceptor that
+   * decodes the JWT and sets those headers automatically.
+   * @param {string} url The Akamai base URL (e.g., http://localhost:9008 in DEV).
+   * @param {object} [options] Optional configuration
+   * @param {string} [options.apiKey] API key for Akamai authentication.
+   *   When provided, the client will transform the Authorization JWT into
+   *   x-api-key, x-user-id and x-organization-id headers on every request.
+   * @public
+   */
+  setAkamaiBaseUrl(url, options = {}) {
+    Joi.assert(url, Joi.string().required());
+
+    const self = this;
+
+    self._akamaiClient = Axios.create({
+      baseURL: url,
+      withCredentials: true
+    });
+
+    // When an API key is provided, add interceptor to build Akamai headers from the JWT
+    if (options.apiKey) {
+      const apiKey = options.apiKey;
+
+      self._akamaiClient.interceptors.request.use((config) => {
+        const auth = config.headers && (config.headers.Authorization || config.headers.authorization);
+        if (auth) {
+          const payload = self._decodeJwtPayload(auth);
+          if (payload) {
+            config.headers['x-api-key'] = apiKey;
+            config.headers['x-user-id'] = payload._id || payload.userId;
+            config.headers['x-organization-id'] = payload.orgId || payload.organizationId;
+            if (payload.language) {
+              config.headers['x-country'] = payload.language;
+            }
+            // Remove the Authorization header — Akamai doesn't use it
+            delete config.headers.Authorization;
+            delete config.headers.authorization;
+          }
+        }
+        return config;
+      });
+    }
+  }
+
+  /**
+   * @description Get the Akamai Axios client. Falls back to the default client
+   * for backward compatibility (e.g., PROD where NGiNX proxies all routes).
+   * @return {AxiosInstance} The Akamai client or default client.
+   * @public
+   */
+  getAkamaiClient() {
+    return this._akamaiClient || this._client;
+  }
 }
 
 export default Dispatch;

package/index.js

@@ -68,6 +68,7 @@ class API {
         }
       },
       uri: 'http://localhost:8080',
+      akamaiUri: null,
       attemptsRetry: 3,
       httpStatusToRetry: [401],
       debug: {success: true, error: true}
@@ -83,6 +84,23 @@ class API {
     self.admin = new Admin({parent: self});
     self.external = new External({parent: self});
     self.ai = new MyndAI({parent: self});
+
+    // If akamaiUri was provided in options, configure the Akamai client
+    if (self.options.akamaiUri) {
+      self.dispatch.setAkamaiBaseUrl(self.options.akamaiUri, { apiKey: self.options.akamaiApiKey });
+    }
+  }
+
+  /**
+   * @description Set the Akamai base URL for agent/AI routes.
+   * @param {string} url The Akamai base URL.
+   * @param {object} [options] Optional configuration
+   * @param {string} [options.apiKey] API key for Akamai authentication (required in DEV,
+   *   where there is no NGiNX to translate Authorization JWT into x-* headers).
+   * @public
+   */
+  setAkamaiBaseUrl(url, options = {}) {
+    this.dispatch.setAkamaiBaseUrl(url, options);
   }
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docbrasil/api-systemmanager",
   "description": "Module API System Manager",
-  "version": "1.1.82",
+  "version": "1.1.84",
   "scripts": {
     "htmldoc": "rm -rf docs && jsdoc api/** -d docs -t ./node_modules/better-docs",
     "doc": "rm -rf doc && mkdir doc && jsdoc2md api/**/* api/* > doc/api.md",