@hotmeshio/hotmesh 0.0.26 → 0.0.28

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 with its unmatched performance.
 
 ## Install
 [![npm version](https://badge.fury.io/js/%40hotmeshio%2Fhotmesh.svg)](https://badge.fury.io/js/%40hotmeshio%2Fhotmesh)
@@ -97,10 +99,12 @@ Redis governance delivers more than just reliability. Externalizing state fundam
  - `random` | Generate a deterministic random number that can be used in a reentrant process workflow (replaces `Math.random()`).
  - `executeChild` | Call another durable function and await the response. *Design sophisticated, multi-process solutions by leveraging this command.*
  - `startChild` | Call another durable function, but do not await the response.
- - `set` | Set a value (e.g, `set('name', 'value')`)
- - `get` | Get a value (e.g, `get('name')`)
+ - `set` | Set one or more name/value pairs (e.g, `set('name1', 'value1', 'name1', 'value2')`)
+ - `get` | Get a single value by name(e.g, `get('name')`)
+ - `mget` | Get multiple values by name (e.g, `get('name1', 'name2')`)
+ - `del` | Delete one or more entries by name and return the number deleted (e.g, `del('name1', 'name1')`)
  - `incr` | Increment (or decrement) a number (e.g, `incr('name', -99)`)
- - `mult` | Multiply (or divide) a number (e.g, `mult('name', 12)`)
+ - `mult` | Multiply a number (e.g, `mult('name', 12)`)
 
 Refer to the [hotmeshio/samples-typescript](https://github.com/hotmeshio/samples-typescript) repo for usage examples. 
 

package/build/package.json

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

package/build/services/durable/meshos.js

@@ -32,7 +32,7 @@ class MeshOSService {
      */
     static mintGuid() {
         const my = new this();
-        return `${my.search?.prefix?.[0]}${(0, nanoid_1.nanoid)()}}`;
+        return `${my.search?.prefix?.[0]}${(0, nanoid_1.nanoid)()}`;
     }
     /**
      * Creates an FT search index
@@ -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.28",
   "description": "Unbreakable Workflows",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/services/durable/meshos.ts

@@ -118,7 +118,7 @@ export class MeshOSService {
    */
   static mintGuid(): string {
     const my = new this();
-    return `${my.search?.prefix?.[0]}${nanoid()}}`;
+    return `${my.search?.prefix?.[0]}${nanoid()}`;
   }
 
   /**
@@ -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
 }