relayx-js 1.0.14 → 1.0.16

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+V1.0.16
+- URL Fix
+
+V1.0.15
+- Wildcard topic pub / sub
+- Message replay on reconnect
+
 V1.0.8
 - History API fetch() to consume()
 

package/examples/example_chat.js

@@ -11,7 +11,7 @@ async function run(){
         api_key: process.env.AUTH_JWT,
         secret: process.env.AUTH_SECRET
     });
-    await realtime.init(true, {
+    await realtime.init(false, {
         max_retries: 2,
         debug: true
     });
@@ -32,8 +32,8 @@ async function run(){
         console.log("power-telemetry", data);
     });
 
-    await realtime.on("test232", (data) => {
-        console.log("test232", data);
+    await realtime.on("hello.*", (data) => {
+        console.log("hello.*", data);
     });
 
     realtime.on(MESSAGE_RESEND, (data) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "relayx-js",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "main": "realtime/realtime.js",
   "type": "module",
   "scripts": {

package/realtime/dns_change.js

@@ -0,0 +1,20 @@
+import dns from 'node:dns';
+
+export function initDNSSpoof(){
+    const originalLookup = dns.lookup;
+
+    // Override for the whole process
+    dns.lookup = function patchedLookup(hostname, options, callback) {
+
+    // ── Our one special case ──────────────────────────────────
+    if (hostname === 'api2.relay-x.io') {
+        // Map to loop‑back; family 4 avoids ::1
+        return process.nextTick(() =>
+        callback(null, [{address: '127.0.0.1', family: 4}])
+        );
+    }
+
+    // Anything else → real DNS
+    return originalLookup.call(dns, hostname, options, callback);
+    };
+}

package/realtime/realtime.js

@@ -2,6 +2,7 @@ import { connect, JSONCodec, Events, DebugEvents, AckPolicy, ReplayPolicy, creds
 import { DeliverPolicy, jetstream } from "@nats-io/jetstream";
 import { encode, decode } from "@msgpack/msgpack";
 import { v4 as uuidv4 } from 'uuid';
+import { initDNSSpoof } from "./dns_change.js";
 
 export class Realtime {
 
@@ -109,23 +110,28 @@ export class Realtime {
         this.staging = staging; 
         this.opts = opts;
 
-        if (staging !== undefined || staging !== null){
-            this.#baseUrl = staging ? [
-                "nats://0.0.0.0:4221",
-                "nats://0.0.0.0:4222",
-                "nats://0.0.0.0:4223"
-                ] : 
-                [
+        if(process.env.PROXY){
+            this.#baseUrl = ["tls://api2.relay-x.io:8666"];
+            initDNSSpoof();
+        }else{
+            if (staging !== undefined || staging !== null){
+                this.#baseUrl = staging ? [
+                        "nats://0.0.0.0:4221",
+                        "nats://0.0.0.0:4222",
+                        "nats://0.0.0.0:4223",
+                    ] : 
+                    [
+                        `tls://api.relay-x.io:4221`,
+                        `tls://api.relay-x.io:4222`,
+                        `tls://api.relay-x.io:4223`
+                    ];
+            }else{
+                this.#baseUrl = [
                     `tls://api.relay-x.io:4221`,
                     `tls://api.relay-x.io:4222`,
                     `tls://api.relay-x.io:4223`
                 ];
-        }else{
-            this.#baseUrl = [
-                `tls://api.relay-x.io:4221`,
-                `tls://api.relay-x.io:4222`,
-                `tls://api.relay-x.io:4223`
-            ];
+            }
         }
 
         this.#log(this.#baseUrl);
@@ -180,6 +186,7 @@ export class Realtime {
                 reconnectTimeWait: 1000,
                 authenticator: credsAuth,
                 token: this.api_key,
+                resolve: process.env.PROXY ? false : true
             });
 
             this.#jetstream = await jetstream(this.#natsClient);
@@ -574,7 +581,7 @@ export class Realtime {
 
         var opts = { 
             name: `${topic}_${uuidv4()}`,
-            filter_subjects: [this.#getStreamTopic(topic), this.#getStreamTopic(topic) + "_presence"],
+            filter_subjects: [this.#getStreamTopic(topic)],
             replay_policy: ReplayPolicy.Instant,
             opt_start_time: new Date(),
             ack_policy: AckPolicy.Explicit,
@@ -664,7 +671,7 @@ export class Realtime {
             this.#latencyPush = setTimeout(async () => {
                 this.#log("setTimeout called");
 
-                if(this.#latency.length > 0){
+                if(this.#latency.length > 0 && this.connected){
                     this.#log("Push from setTimeout")
                     await this.#pushLatencyData({
                         timezone: timeZone,
@@ -736,7 +743,9 @@ export class Realtime {
             var arrayCheck = ![CONNECTED, DISCONNECTED, RECONNECT, this.#RECONNECTED,
                 this.#RECONNECTING, this.#RECONN_FAIL, MESSAGE_RESEND, SERVER_DISCONNECT].includes(topic);
 
-            var spaceStarCheck = !topic.includes(" ") && !topic.includes("*") && !topic.includes(".");
+            const TOPIC_REGEX = /^(?!\$)[A-Za-z0-9_,.*>\$-]+$/;
+
+            var spaceStarCheck = !topic.includes(" ") && TOPIC_REGEX.test(topic);
 
             return arrayCheck && spaceStarCheck;
         }else{

package/tests/test.js

@@ -1,5 +1,4 @@
 import { Realtime, CONNECTED, RECONNECT, DISCONNECTED, MESSAGE_RESEND } from "../realtime/realtime.js";
-import axios from "axios";
 import { test, before, after } from 'node:test';
 import assert from 'node:assert';
 
@@ -8,10 +7,10 @@ let realTimeEnabled;
 before(async () => {
     // Start server for testing. Run local server!!
     realTimeEnabled = new Realtime({
-        api_key: process.env.user_key,
-        secret: process.env.secret
+        api_key: process.env.AUTH_JWT,
+        secret: process.env.AUTH_SECRET
     });
-    await realTimeEnabled.init(true, {
+    await realTimeEnabled.init(false, {
         debug: true
     });
     await realTimeEnabled.connect();
@@ -55,8 +54,8 @@ test("No creds in constructor", async () => {
 
 test('init() function test', async () => {
     var realtime =  new Realtime({
-        api_key: process.env.user_key,
-        secret: process.env.secret
+        api_key: process.env.AUTH_JWT,
+        secret: process.env.AUTH_SECRET
     });
     await realtime.init(true);
 
@@ -119,37 +118,10 @@ test("Namespace check test", async () => {
     assert.strictEqual(realTimeEnabled.topicHash.length > 0, true)
 });
 
-test("Retry method test", async () => {
-    var retryMethod = realTimeEnabled.testRetryTillSuccess(); 
-
-    assert.notStrictEqual(retryMethod, null, "Obj != null")
-
-    function testMethod1(arg){
-        return {
-            success: true, 
-            output: arg
-        }
-    }
-
-    var output = await retryMethod(testMethod1, 5, 1, "test_output")
-
-    assert.strictEqual(output, "test_output");
-
-    function testMethod2(){
-        return {
-            success: false,
-            output: null
-        }
-    }
-
-    output = await retryMethod(testMethod2, 5, 1);
-    assert.strictEqual(output, null);
-});
-
 test("get publish retry count test based in init()", async () => {
     var realtime =  new Realtime({
-        api_key: process.env.user_key,
-        secret: process.env.secret
+        api_key: process.env.AUTH_JWT,
+        secret: process.env.AUTH_SECRET
     });
 
     await realtime.init({
@@ -199,6 +171,60 @@ test("Testing publish(topic, data) method", async () => {
     });
 
     assert.strictEqual(response, true);
+
+    response = await realTimeEnabled.publish("hello.hey", {
+        message: "Hello World!"
+    });
+
+    assert.strictEqual(response, true);
+
+    response = await realTimeEnabled.publish("hello.*", {
+        message: "Hello World!"
+    });
+
+    assert.strictEqual(response, true);
+
+    response = await realTimeEnabled.publish("hello.>", {
+        message: "Hello World!"
+    });
+
+    assert.strictEqual(response, true);
+
+    response = await realTimeEnabled.publish("test-room", {
+        message: "Hello World!"
+    });
+
+    assert.strictEqual(response, true);
+
+    response = await realTimeEnabled.publish("test-room.*", {
+        message: "Hello World!"
+    });
+
+    assert.strictEqual(response, true);
+
+    response = await realTimeEnabled.publish("test-room.>", {
+        message: "Hello World!"
+    });
+
+    assert.strictEqual(response, true);
+
+    response = await realTimeEnabled.publish("test_room", {
+        message: "Hello World!"
+    });
+
+    assert.strictEqual(response, true);
+
+    response = await realTimeEnabled.publish("test_room.*", {
+        message: "Hello World!"
+    });
+
+    assert.strictEqual(response, true);
+
+    response = await realTimeEnabled.publish("test_room.>", {
+        message: "Hello World!"
+    });
+
+    assert.strictEqual(response, true);
 });
 
 test("Testing publish(topic, data) with invalid inputs", async () => {
@@ -271,8 +297,8 @@ test("Testing publish(topic, data) with invalid inputs", async () => {
 
 test("on() test", async () => {
     var realtime = new Realtime({
-        api_key: process.env.user_key,
-        secret: process.env.secret
+        api_key: process.env.AUTH_JWT,
+        secret: process.env.AUTH_SECRET
     });
 
     await assert.rejects(async () => {
@@ -349,8 +375,8 @@ test("on() test", async () => {
 
 test("off() test", async () => {
     var realtime = new Realtime({
-        api_key: process.env.user_key,
-        secret: process.env.secret
+        api_key: process.env.AUTH_JWT,
+        secret: process.env.AUTH_SECRET
     });
 
     await assert.rejects(async () => {
@@ -397,8 +423,8 @@ test("off() test", async () => {
 
 test("Get stream name test", () => {
     var realtime = new Realtime({
-        api_key: process.env.user_key,
-        secret: process.env.secret
+        api_key: process.env.AUTH_JWT,
+        secret: process.env.AUTH_SECRET
     });
 
     realtime.namespace = "spacex-dragon-program"
@@ -449,7 +475,76 @@ test("Test isTopicValidMethod()", () => {
         assert.strictEqual(valid, false);
     });
 
-    var unreservedValidTopics = ["hello", "test-room", "heyyyyy", "room-connect"]; 
+    unreservedInvalidTopics = [
+        '$internal',          // starts with $
+        'hello world',        // space
+        'topic/',             // slash
+        'name?',              // ?
+        'foo#bar',            // #
+        'bar.baz!',           // !
+        ' space',             // leading space
+        'tab\tchar',          // tab
+        'line\nbreak',        // newline
+        'comma ,',            // space + comma
+        '',                   // empty string
+        'bad|pipe',           // |
+        'semi;colon',         // ;
+        'colon:here',         // :
+        "quote's",            // '
+        '"doublequote"',      // "
+        'brackets[]',         // []
+        'brace{}',            // {}
+        'paren()',            // ()
+        'plus+sign',          // +
+        'eq=val',             // =
+        'gt>lt<',             // < mixed with >
+        'percent%',           // %
+        'caret^',             // ^
+        'ampersand&',         // &
+        'back\\slash',        // backslash
+        '中文字符',            // non‑ASCII
+        '👍emoji',            // emoji
+        'foo\rbar',           // carriage return
+        'end '                // trailing space
+    ];
+        
+    unreservedInvalidTopics.forEach(topic => {
+        var valid = realTimeEnabled.isTopicValid(topic);
+        assert.strictEqual(valid, false);
+    });
+
+    var unreservedValidTopics = [
+        'Orders',
+        'customer_123',
+        'foo-bar',
+        'a,b,c',
+        '*',
+        'foo>*',
+        'hello$world',
+        'topic.123',
+        'ABC_def-ghi',
+        'data_stream_2025',
+        'NODE*',
+        'pubsub>events',
+        'log,metric,error',
+        'X123_Y456',
+        'multi.step.topic',
+        'batch-process',
+        'sensor1_data',
+        'finance$Q2',
+        'alpha,beta,gamma',
+        'Z9_Y8-X7',
+        'config>*',
+        'route-map',
+        'STATS_2025-07',
+        'msg_queue*',
+        'update>patch',
+        'pipeline_v2',
+        'FOO$BAR$BAZ',
+        'user.profile',
+        'id_001-xyz',
+        'event_queue>'
+    ]; 
 
     unreservedValidTopics.forEach(topic => {
         var valid = realTimeEnabled.isTopicValid(topic);

package/realtime/history.js

@@ -1,160 +0,0 @@
-import axios from 'axios';
-
-/**
- * Class responsible for getting messages stored in the DB
- */
-export class History{
-    
-    #api_key = null;
-    #staging = null;
-    #baseUrl = null;
-    #debug = null;
-
-    constructor(api_key){
-        this.#api_key = api_key;
-    }
-
-    init(staging, debug){
-        this.#staging = staging;
-        this.#debug = debug;
-
-        this.#setBaseUrl();
-    }
-
-    /**
-     * Get message from DB since a $timestamp
-     * @param {number} timestamp - unix timestamp
-     * @param {number} page - page number of pagination
-     * @param {number} limit - limit per page
-     * @returns - Message array
-     */
-    async getMessagesSince(topic, timestamp, page, limit){
-        if(topic == null || topic == undefined){
-            return new Error("$topic variable missing in getMessagesSince()");
-        }else{
-            if(typeof topic !== "string"){
-                return new Error("$topic is not a string");
-            }
-        }
-
-        if(timestamp == null || timestamp == undefined){
-            return new Error("$timestamp variable missing in getMessagesSince()");
-        }else{
-            if(!Number.isInteger(timestamp) && !Number.isNaN(timestamp)){
-                return new Error("$timestamp is either NaN or not an invalid integer");
-            }
-        }
-
-        if(page == null || page == undefined){
-            return new Error("$page variable missing in getMessagesSince()");
-        }else{
-            if(!Number.isInteger(page) && !Number.isNaN(page)){
-                return new Error("$page is either NaN or not an invalid integer");
-            }
-        }
-
-        if(limit == null || limit == undefined){
-            return new Error("$limit variable missing in getMessagesSince()");
-        }else{
-            if(!Number.isInteger(limit) && !Number.isNaN(limit)){
-                console.log("$limit is either NaN or not an invalid integer")
-                return new Error("$limit is either NaN or not an invalid integer");
-            }
-        }
-
-        try{
-            var startTime = Date.now();
-            var urlPart = `/history/since?topic=${topic}&timestamp=${timestamp}&page=${page}&limit=${limit}`
-
-            var response = await axios.get(this.#baseUrl + urlPart,{
-                headers: {
-                    "Authorization": `Bearer ${this.#api_key}`
-                }
-            });
-
-            var data = response.data
-            this.#log(data);
-
-            this.#logResponseTime(startTime, urlPart);
-
-            if (data?.status === "SUCCESS"){
-                return data.data;
-            }else{
-                return null;
-            }
-       }catch(err){
-            throw Error(err.message);
-       }
-    }
-
-    /**
-     * Get message from DB by ID
-     * @param {string} id - ID of the message
-     * @returns - Message object
-     */
-    async getMessageById(id){
-        var startTime = Date.now();
-        var urlPart = `/history/message-by-id?id=${id}`;
-
-        if(id !== null && id !== undefined){
-            try{
-                var response = await axios.get(this.#baseUrl + urlPart,{
-                    headers: {
-                        "Authorization": `Bearer ${this.#api_key}`
-                    }
-                });
-    
-                var data = response.data
-                this.#log(data);
-
-                this.#logResponseTime(startTime, urlPart);
-    
-                if (data?.status === "SUCCESS"){
-                    return data.data;
-                }else{
-                    return null;
-                }
-           }catch(err){
-                throw new Error(err.message);
-           }
-        }else{
-            return null;
-        }
-    }
-
-    // Utility Functions
-    /**
-     * Constructs base url based on staging flag
-     */
-    #setBaseUrl(){
-        if (this.#staging !== undefined || this.#staging !== null){
-            this.#baseUrl = this.#staging ? "http://127.0.0.1:3000" : "http://128.199.176.185:3000";
-        }else{
-            this.#baseUrl = "http://128.199.176.185:3000";
-        }
-    }
-
-    #log(msg){
-        if(this.#debug !== null && this.#debug !== undefined && (typeof this.#debug == "boolean")){
-            if(this.#debug){
-                console.log(msg);
-            }
-        }
-    }
-
-    async #logResponseTime(startTime, url){
-        var responseTime = Date.now() - startTime;
-
-        var data = {
-            "url": url,
-            "response_time": responseTime
-        }
-
-        await axios.post(this.#baseUrl + "/metrics/log", data, {
-            headers: {
-                "Authorization": `Bearer ${this.#api_key}`
-            }
-        });
-    }
-
-}