@smythos/sre 1.6.14 → 1.7.5

package/src/helpers/LocalCache.helper.ts

@@ -3,6 +3,13 @@ interface CacheItem<T> {
     expiry: number;
 }
 
+/**
+ * A local cache helper used to cache data, functions or object instances
+ * This is useful when you need to cache an object and refresh the cache if the object is accessed within a certain time period
+ *
+ * @template K - The type of the key
+ * @template V - The type of the value
+ */
 export class LocalCache<K, V> {
     private cache: Map<K, V>;
     private expiryMap: Map<K, number>;
@@ -48,6 +55,12 @@ export class LocalCache<K, V> {
         timeout.unref(); //unblock the event loop
     }
 
+    /**
+     * Get the value from the cache, and update the TTL if provided
+     * @param key - The key to get the value from the cache
+     * @param ttlMs - The TTL in milliseconds
+     * @returns The value from the cache
+     */
     get(key: K, ttlMs?: number): V | undefined {
         if (!this.has(key)) {
             return undefined;
@@ -60,6 +73,11 @@ export class LocalCache<K, V> {
         return value;
     }
 
+    /**
+     * Check if the key exists in the cache
+     * @param key - The key to check if it exists in the cache
+     * @returns True if the key exists in the cache, false otherwise
+     */
     has(key: K): boolean {
         if (!this.cache.has(key)) {
             return false;

package/src/helpers/TemplateString.helper.ts

@@ -101,19 +101,30 @@ export class TemplateStringHelper {
     /**
      * Parses a template string by replacing the placeholders with the values from the provided data object
      * unmatched placeholders will be left as is
+     * Recursively resolves nested template variables until no more variables are found
      */
-    public parse(data: Record<string, string>, regex: TemplateStringMatch = Match.default) {
+    public parse(data: Record<string, string>, regex: TemplateStringMatch = Match.default, maxDepth: number = 5) {
         if (typeof this._current !== 'string' || typeof data !== 'object') return this;
-        this._current = this._current.replace(regex, (match, token) => {
-            let val = data?.[token] ?? match; // Use nullish coalescing to preserve falsy values (0, '', false)
 
-            //if no exact match, try to parse the token as a JSON expression
-            if (!data?.[token]) {
-                val = JSONExpression(data, token) || `{{${token}}}`; //if no match, use the token as is
-            }
+        // Keep parsing until no more template variables are resolved or max depth is reached
+        // this is useful for chained template variables : e.g {{defaultVar}} => "text {{nestedVar}} more text" ==> "text value of nestedVar more text"
+        for (let i = 0; i < maxDepth; i++) {
+            const previous = this._current;
 
-            return typeof val === 'object' ? JSON.stringify(val) : escapeJsonField(val);
-        });
+            this._current = this._current.replace(regex, (match, token) => {
+                let val = data?.[token] ?? match; // Use nullish coalescing to preserve falsy values (0, '', false)
+
+                //if no exact match, try to parse the token as a JSON expression
+                if (!data?.[token]) {
+                    val = JSONExpression(data, token) || `{{${token}}}`; //if no match, use the token as is
+                }
+
+                return typeof val === 'object' ? JSON.stringify(val) : escapeJsonField(val);
+            });
+
+            // Break early if no changes were made : we parsed all the template variables
+            if (previous === this._current) break;
+        }
 
         return this;
     }

package/src/index.ts

@@ -54,12 +54,14 @@ export * from './Core/boot';
 export * from './Core/Connector.class';
 export * from './Core/ConnectorsService';
 export * from './Core/DummyConnector';
+export * from './Core/ExternalEventsReceiver';
 export * from './Core/HookService';
 export * from './Core/SmythRuntime.class';
 export * from './Core/SystemEvents';
 export * from './helpers/AWSLambdaCode.helper';
 export * from './helpers/BinaryInput.helper';
 export * from './helpers/Conversation.helper';
+export * from './helpers/Crypto.helper';
 export * from './helpers/ECMASandbox.helper';
 export * from './helpers/JsonContent.helper';
 export * from './helpers/LocalCache.helper';
@@ -92,6 +94,10 @@ export * from './Components/APICall/parseHeaders';
 export * from './Components/APICall/parseProxy';
 export * from './Components/APICall/parseUrl';
 export * from './Components/Image/imageSettings.config';
+export * from './Components/Triggers/Gmail.trigger';
+export * from './Components/Triggers/JobScheduler.trigger';
+export * from './Components/Triggers/Trigger.class';
+export * from './Components/Triggers/WhatsApp.trigger';
 export * from './subsystems/AgentManager/Agent.class';
 export * from './subsystems/AgentManager/Agent.helper';
 export * from './subsystems/AgentManager/AgentLogger.class';
@@ -116,6 +122,10 @@ export * from './subsystems/AgentManager/AgentData.service/AgentDataConnector';
 export * from './subsystems/AgentManager/AgentData.service/index';
 export * from './subsystems/AgentManager/Component.service/ComponentConnector';
 export * from './subsystems/AgentManager/Component.service/index';
+export * from './subsystems/AgentManager/Scheduler.service/index';
+export * from './subsystems/AgentManager/Scheduler.service/Job.class';
+export * from './subsystems/AgentManager/Scheduler.service/Schedule.class';
+export * from './subsystems/AgentManager/Scheduler.service/SchedulerConnector';
 export * from './subsystems/ComputeManager/Code.service/CodeConnector';
 export * from './subsystems/ComputeManager/Code.service/index';
 export * from './subsystems/IO/CLI.service/CLIConnector';
@@ -144,6 +154,8 @@ export * from './subsystems/Security/AccessControl/AccessRequest.class';
 export * from './subsystems/Security/AccessControl/ACL.class';
 export * from './subsystems/Security/Account.service/AccountConnector';
 export * from './subsystems/Security/Account.service/index';
+export * from './subsystems/Security/Credentials/Credentials.class';
+export * from './subsystems/Security/Credentials/ManagedOAuth2Credentials.class';
 export * from './subsystems/Security/ManagedVault.service/index';
 export * from './subsystems/Security/ManagedVault.service/ManagedVaultConnector';
 export * from './subsystems/Security/Vault.service/index';
@@ -153,6 +165,7 @@ export * from './subsystems/AgentManager/AgentData.service/connectors/CLIAgentDa
 export * from './subsystems/AgentManager/AgentData.service/connectors/LocalAgentDataConnector.class';
 export * from './subsystems/AgentManager/AgentData.service/connectors/NullAgentData.class';
 export * from './subsystems/AgentManager/Component.service/connectors/LocalComponentConnector.class';
+export * from './subsystems/AgentManager/Scheduler.service/connectors/LocalScheduler.class';
 export * from './subsystems/ComputeManager/Code.service/connectors/AWSLambdaCode.class';
 export * from './subsystems/IO/Log.service/connectors/ConsoleLog.class';
 export * from './subsystems/IO/NKV.service/connectors/NKVLocalStorage.class';

package/src/index.ts.bak

@@ -54,12 +54,14 @@ export * from './Core/boot';
 export * from './Core/Connector.class';
 export * from './Core/ConnectorsService';
 export * from './Core/DummyConnector';
+export * from './Core/ExternalEventsReceiver';
 export * from './Core/HookService';
 export * from './Core/SmythRuntime.class';
 export * from './Core/SystemEvents';
 export * from './helpers/AWSLambdaCode.helper';
 export * from './helpers/BinaryInput.helper';
 export * from './helpers/Conversation.helper';
+export * from './helpers/Crypto.helper';
 export * from './helpers/ECMASandbox.helper';
 export * from './helpers/JsonContent.helper';
 export * from './helpers/LocalCache.helper';
@@ -92,6 +94,10 @@ export * from './Components/APICall/parseHeaders';
 export * from './Components/APICall/parseProxy';
 export * from './Components/APICall/parseUrl';
 export * from './Components/Image/imageSettings.config';
+export * from './Components/Triggers/Gmail.trigger';
+export * from './Components/Triggers/JobScheduler.trigger';
+export * from './Components/Triggers/Trigger.class';
+export * from './Components/Triggers/WhatsApp.trigger';
 export * from './subsystems/AgentManager/Agent.class';
 export * from './subsystems/AgentManager/Agent.helper';
 export * from './subsystems/AgentManager/AgentLogger.class';
@@ -116,6 +122,10 @@ export * from './subsystems/AgentManager/AgentData.service/AgentDataConnector';
 export * from './subsystems/AgentManager/AgentData.service/index';
 export * from './subsystems/AgentManager/Component.service/ComponentConnector';
 export * from './subsystems/AgentManager/Component.service/index';
+export * from './subsystems/AgentManager/Scheduler.service/index';
+export * from './subsystems/AgentManager/Scheduler.service/Job.class';
+export * from './subsystems/AgentManager/Scheduler.service/Schedule.class';
+export * from './subsystems/AgentManager/Scheduler.service/SchedulerConnector';
 export * from './subsystems/ComputeManager/Code.service/CodeConnector';
 export * from './subsystems/ComputeManager/Code.service/index';
 export * from './subsystems/IO/CLI.service/CLIConnector';
@@ -144,6 +154,8 @@ export * from './subsystems/Security/AccessControl/AccessRequest.class';
 export * from './subsystems/Security/AccessControl/ACL.class';
 export * from './subsystems/Security/Account.service/AccountConnector';
 export * from './subsystems/Security/Account.service/index';
+export * from './subsystems/Security/Credentials/Credentials.class';
+export * from './subsystems/Security/Credentials/ManagedOAuth2Credentials.class';
 export * from './subsystems/Security/ManagedVault.service/index';
 export * from './subsystems/Security/ManagedVault.service/ManagedVaultConnector';
 export * from './subsystems/Security/Vault.service/index';
@@ -153,6 +165,7 @@ export * from './subsystems/AgentManager/AgentData.service/connectors/CLIAgentDa
 export * from './subsystems/AgentManager/AgentData.service/connectors/LocalAgentDataConnector.class';
 export * from './subsystems/AgentManager/AgentData.service/connectors/NullAgentData.class';
 export * from './subsystems/AgentManager/Component.service/connectors/LocalComponentConnector.class';
+export * from './subsystems/AgentManager/Scheduler.service/connectors/LocalScheduler.class';
 export * from './subsystems/ComputeManager/Code.service/connectors/AWSLambdaCode.class';
 export * from './subsystems/IO/Log.service/connectors/ConsoleLog.class';
 export * from './subsystems/IO/NKV.service/connectors/NKVLocalStorage.class';