@hotmeshio/hotmesh 0.0.26 → 0.0.27

package/README.md

@@ -3,9 +3,11 @@
 
 Elevate Redis from an in-memory data cache, and turn your unpredictable functions into unbreakable workflows.
 
-**HotMesh** is a wrapper for Redis that exposes a higher level set of domain constructs like ‘activities’, ‘workflows’, 'jobs', etc. Behind the scenes, it uses *Redis Data* (Hash, ZSet, List); *Redis Streams* (XReadGroup, XAdd, XLen, etc); and *Redis Publish/Subscribe*.
+**HotMesh** is a wrapper for Redis that exposes concepts like ‘activities’, ‘workflows’, and 'jobs'. Behind the scenes, it uses *Redis Data* (Hash, ZSet, List); *Redis Streams* (XReadGroup, XAdd, XLen, etc); and *Redis Publish/Subscribe*.
 
-It's still Redis in the background, but the information flow is reversed. Instead of your functions calling Redis (e.g., for caching a document), Redis governs your function execution. If your microservice container goes down or your function simply fails, HotMesh will restore function state at the point of failure and retry until it succeeds.
+It's still Redis in the background, but your functions are run as *reentrant processes* and are executed in a distributed environment, with all the benefits of a distributed system, including fault tolerance, scalability, and high availability.
+
+Write functions in your own preferred style, and let Redis govern their execution at its unmatched scale and performance.
 
 ## Install
 [![npm version](https://badge.fury.io/js/%40hotmeshio%2Fhotmesh.svg)](https://badge.fury.io/js/%40hotmeshio%2Fhotmesh)

package/build/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hotmeshio/hotmesh",
-    "version": "0.0.26",
+    "version": "0.0.27",
     "description": "Unbreakable Workflows",
     "main": "build/index.js",
     "types": "build/index.d.ts",

package/build/services/durable/meshos.js

@@ -206,16 +206,16 @@ class MeshOSService {
                     return `${prefixedFieldName}:"${value}"`;
                 case 'NUMERIC':
                     let range = '';
-                    if (is.startsWith('=')) {
+                    if (is.startsWith('=')) { //equal
                         range = `[${value} ${value}]`;
                     }
-                    else if (is === '<') {
+                    else if (is.startsWith('<')) { //less than or equal
                         range = `[-inf ${value}]`;
                     }
-                    else if (is === '>') {
+                    else if (is.startsWith('>')) { //greater than or equal
                         range = `[${value} +inf]`;
                     }
-                    else if (is === '[]') {
+                    else if (is === '[]') { //between
                         range = `[${value[0]} ${value[1]}]`;
                     }
                     return `${prefixedFieldName}:${range}`;

package/build/services/durable/search.d.ts

@@ -23,9 +23,10 @@ export declare class Search {
      * calling any method that produces side effects (changes the value)
      */
     getSearchSessionGuid(): string;
-    set(key: string, value: string): Promise<void>;
+    set(...args: string[]): Promise<void>;
     get(key: string): Promise<string>;
-    del(key: string): Promise<void>;
+    mget(...args: string[]): Promise<string[]>;
+    del(...args: string[]): Promise<number | void>;
     incr(key: string, val: number): Promise<number>;
     mult(key: string, val: number): Promise<number>;
 }

package/build/services/durable/search.js

@@ -59,12 +59,17 @@ class Search {
         //return the search session as it would exist in the search session index
         return `${this.searchSessionId}-${this.searchSessionIndex++}-`;
     }
-    async set(key, value) {
+    async set(...args) {
         const ssGuid = this.getSearchSessionGuid();
         const ssGuidValue = Number(await this.store.exec('HINCRBYFLOAT', this.jobId, ssGuid, '1'));
         if (ssGuidValue === 1) {
-            //only allowed to set a value the first time
-            await this.store.exec('HSET', this.jobId, this.safeKey(key), value.toString());
+            const safeArgs = [];
+            for (let i = 0; i < args.length; i += 2) {
+                const key = this.safeKey(args[i]);
+                const value = args[i + 1].toString();
+                safeArgs.push(key, value);
+            }
+            await this.store.exec('HSET', this.jobId, ...safeArgs);
         }
     }
     async get(key) {
@@ -76,11 +81,29 @@ class Search {
             return '';
         }
     }
-    async del(key) {
+    async mget(...args) {
+        const safeArgs = [];
+        for (let i = 0; i < args.length; i++) {
+            safeArgs.push(this.safeKey(args[i]));
+        }
+        try {
+            return await this.store.exec('HMGET', this.jobId, ...safeArgs);
+        }
+        catch (err) {
+            this.hotMeshClient.logger.error('durable-search-mget-error', { err });
+            return [];
+        }
+    }
+    async del(...args) {
         const ssGuid = this.getSearchSessionGuid();
         const ssGuidValue = Number(await this.store.exec('HINCRBYFLOAT', this.jobId, ssGuid, '1'));
         if (ssGuidValue === 1) {
-            await this.store.exec('HDEL', this.jobId, this.safeKey(key));
+            const safeArgs = [];
+            for (let i = 0; i < args.length; i++) {
+                safeArgs.push(this.safeKey(args[i]));
+            }
+            const response = await this.store.exec('HDEL', this.jobId, ...safeArgs);
+            return isNaN(response) ? undefined : Number(response);
         }
     }
     async incr(key, val) {

package/build/types/durable.d.ts

@@ -84,7 +84,7 @@ type WorkerConfig = {
 };
 type FindWhereQuery = {
     field: string;
-    is: string;
+    is: '=' | '==' | '>=' | '<=' | '[]';
     value: string | boolean | number | [number, number];
     type?: string;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hotmeshio/hotmesh",
-  "version": "0.0.26",
+  "version": "0.0.27",
   "description": "Unbreakable Workflows",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/services/durable/meshos.ts

@@ -309,13 +309,13 @@ export class MeshOSService {
           return `${prefixedFieldName}:"${value}"`;
         case 'NUMERIC':
           let range = '';
-          if (is.startsWith('=')) {
+          if (is.startsWith('=')) {        //equal
             range = `[${value} ${value}]`;
-          } else if (is === '<') {
+          } else if (is.startsWith('<')) { //less than or equal
             range = `[-inf ${value}]`;
-          } else if (is === '>') {
+          } else if (is.startsWith('>')) { //greater than or equal
             range = `[${value} +inf]`;
-          } else if (is === '[]') {
+          } else if (is === '[]') {        //between
             range = `[${value[0]} ${value[1]}]`
           }
           return `${prefixedFieldName}:${range}`;

package/services/durable/search.ts

@@ -69,12 +69,17 @@ export class Search {
     return `${this.searchSessionId}-${this.searchSessionIndex++}-`;
   }
 
-  async set(key: string, value: string): Promise<void> {
+  async set(...args: string[]): Promise<void> {
     const ssGuid = this.getSearchSessionGuid();
     const ssGuidValue = Number(await this.store.exec('HINCRBYFLOAT', this.jobId, ssGuid, '1') as string);
     if (ssGuidValue === 1) {
-      //only allowed to set a value the first time
-      await this.store.exec('HSET', this.jobId, this.safeKey(key), value.toString());
+      const safeArgs: string[] = [];
+      for (let i = 0; i < args.length; i += 2) {
+        const key = this.safeKey(args[i]);
+        const value = args[i+1].toString();
+        safeArgs.push(key, value);
+      }
+      await this.store.exec('HSET', this.jobId, ...safeArgs);
     }
   }
 
@@ -87,11 +92,29 @@ export class Search {
     }
   }
 
-  async del(key: string): Promise<void> {
+  async mget(...args: string[]): Promise<string[]> {
+    const safeArgs: string[] = [];
+    for (let i = 0; i < args.length; i++) {
+      safeArgs.push(this.safeKey(args[i]));
+    }
+    try {
+      return await this.store.exec('HMGET', this.jobId, ...safeArgs) as string[];
+    } catch (err) {
+      this.hotMeshClient.logger.error('durable-search-mget-error', { err });
+      return [];
+    }
+  }
+
+  async del(...args: string[]): Promise<number | void> {
     const ssGuid = this.getSearchSessionGuid();
     const ssGuidValue = Number(await this.store.exec('HINCRBYFLOAT', this.jobId, ssGuid, '1') as string);
     if (ssGuidValue === 1) {
-      await this.store.exec('HDEL', this.jobId, this.safeKey(key));
+      const safeArgs: string[] = [];
+      for (let i = 0; i < args.length; i++) {
+        safeArgs.push(this.safeKey(args[i]));
+      }
+      const response = await this.store.exec('HDEL', this.jobId, ...safeArgs);
+      return isNaN(response as unknown as number) ? undefined : Number(response);
     }
   }
 

package/types/durable.ts

@@ -95,7 +95,7 @@ type WorkerConfig = {
 
 type FindWhereQuery = {
   field: string;
-  is: string;
+  is: '=' | '==' | '>=' | '<=' | '[]';
   value: string | boolean | number | [number, number];
   type?: string; //default is TEXT
 }