@machhub-dev/sdk-ts 0.0.3 → 0.0.5

package/dist/cjs/classes/collection.js

@@ -28,15 +28,24 @@ class Collection {
         return this.httpService.request.get(this.collectionName + "/all", this.queryParams);
     }
     async getOne(id) {
+        if (!id) {
+            throw new Error("ID must be provided");
+        }
         return this.httpService.request.get(id);
     }
     async create(data) {
         return this.httpService.request.withJSON(data).post(this.collectionName);
     }
     async update(id, data) {
+        if (!id) {
+            throw new Error("ID must be provided");
+        }
         return this.httpService.request.withJSON(data).put(id);
     }
     async delete(id) {
+        if (!id) {
+            throw new Error("ID must be provided");
+        }
         return this.httpService.request.delete(id);
     }
 }

package/dist/cjs/classes/historian.d.ts

@@ -9,4 +9,5 @@ export declare class Historian {
     getHistoricalData(topic: string, start_time: Date, range?: string): Promise<HistorizedData[]>;
     subscribeLiveData(topic: string, callback: (data: any) => void): Promise<any>;
     getLastNValues(topic: string, n: number): Promise<HistorizedData[]>;
+    query(SurrealQL: string): Promise<any>;
 }

package/dist/cjs/classes/historian.js

@@ -36,5 +36,10 @@ class Historian {
             sort: "desc", // Fetch the latest values
         }).patch("historian/last");
     }
+    async query(SurrealQL) {
+        return this.httpService.request.withJSON({
+            query: SurrealQL
+        }).post("historian/query");
+    }
 }
 exports.Historian = Historian;

package/dist/cjs/index.d.ts

@@ -1,5 +1,4 @@
 export { SDK, type SDKConfig } from './sdk-ts.js';
-export { getAppConfig } from './utils/appConfig.js';
 export type { LoginResponse, PermissionResponse, User, Group, Feature, Permission, ActionResponse, Action, Scope } from './types/auth.models.js';
 export type { BaseResponse } from './types/response.models.js';
 export type { RecordID } from './types/recordID.models.js';

package/dist/cjs/index.js

@@ -1,7 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAppConfig = exports.SDK = void 0;
+exports.SDK = void 0;
 var sdk_ts_js_1 = require("./sdk-ts.js");
 Object.defineProperty(exports, "SDK", { enumerable: true, get: function () { return sdk_ts_js_1.SDK; } });
-var appConfig_js_1 = require("./utils/appConfig.js");
-Object.defineProperty(exports, "getAppConfig", { enumerable: true, get: function () { return appConfig_js_1.getAppConfig; } });

package/dist/cjs/sdk-ts.d.ts

@@ -6,6 +6,7 @@ import { Flow } from "./classes/flow.js";
 import { Auth } from "./classes/auth.js";
 export interface SDKConfig {
     application_id: string;
+    developer_key?: string;
     httpUrl?: string;
     mqttUrl?: string;
     natsUrl?: string;
@@ -28,7 +29,7 @@ export declare class SDK {
      *
      * const config: SDKConfig = {
      *   application_id: 'your-app-id',
-     *   httpUrl: 'http://localhost:80', // optional (default = http://localhost:80)
+     *   httpUrl: 'http://localhost:6188', // optional (default = http://localhost:6188)
      *   mqttUrl: 'ws://localhost:180',  // optional (default = ws://localhost:180)
      *   natsUrl: 'ws://localhost:7500', // optional (default = ws://localhost:7500)
      * };
@@ -40,7 +41,7 @@ export declare class SDK {
      * @param config {SDKConfig} The configuration object containing initialization parameters. See SDKConfig for details.
      * @returns {Promise<boolean>} Resolves to true if initialization is successful.
      */
-    Initialize(config: SDKConfig): Promise<boolean>;
+    Initialize(config?: SDKConfig): Promise<boolean>;
     /**
      * Getter for `auth`. Ensures `auth` is accessed only after initialization.
      */

package/dist/cjs/sdk-ts.js

@@ -4,7 +4,6 @@ exports.SDK = void 0;
 const http_service_js_1 = require("./services/http.service.js");
 const mqtt_service_js_1 = require("./services/mqtt.service.js");
 const nats_service_js_1 = require("./services/nats.service.js");
-const appConfig_js_1 = require("./utils/appConfig.js");
 const collection_js_1 = require("./classes/collection.js");
 const historian_js_1 = require("./classes/historian.js");
 const tag_js_1 = require("./classes/tag.js");
@@ -17,22 +16,10 @@ class HTTPClient {
     /**
      * Creates a new HTTPClient instance
      * @param applicationID The ID for your application (required)
-     * @param httpUrl The base URL for HTTP connection (default = http://localhost:80)
+     * @param httpUrl The base URL for HTTP connection (default = http://localhost:6188)
      */
-    constructor(applicationID, httpUrl = "http://localhost:80") {
-        if (!applicationID) {
-            const config = (0, appConfig_js_1.getAppConfig)();
-            if (config != undefined) {
-                applicationID = config.application_id;
-            }
-            else {
-                throw new Error("Failed to get Configuration.");
-            }
-            if (!applicationID) {
-                throw new Error("Application ID is required. Set it via the APP_ID environment variable or pass it as a parameter.");
-            }
-        }
-        this.httpService = new http_service_js_1.HTTPService(httpUrl, MACHHUB_SDK_PATH, applicationID);
+    constructor(applicationID, httpUrl, developerKey) {
+        this.httpService = new http_service_js_1.HTTPService(httpUrl, MACHHUB_SDK_PATH, applicationID, developerKey);
     }
     /**
      * Gets server info
@@ -51,7 +38,7 @@ class MQTTClient {
      * @param applicationID The ID for your application
      * @param mqttUrl The base URL for MQTT connection (default = ws://localhost:180)
      */
-    static async getInstance(applicationID, mqttUrl = "ws://localhost:180") {
+    static async getInstance(applicationID, mqttUrl = "ws://localhost:180", developerKey) {
         // if (!applicationID) {
         //   applicationID = process.env.APP_ID;
         //   if (!applicationID) {
@@ -59,7 +46,7 @@ class MQTTClient {
         //   }
         // }
         if (!this.instance) {
-            const mqttService = await mqtt_service_js_1.MQTTService.getInstance(mqttUrl);
+            const mqttService = await mqtt_service_js_1.MQTTService.getInstance(mqttUrl, developerKey);
             this.instance = new MQTTClient(mqttService); // Use the constructor to initialize the instance
         }
         return this.instance;
@@ -136,7 +123,7 @@ class SDK {
      *
      * const config: SDKConfig = {
      *   application_id: 'your-app-id',
-     *   httpUrl: 'http://localhost:80', // optional (default = http://localhost:80)
+     *   httpUrl: 'http://localhost:6188', // optional (default = http://localhost:6188)
      *   mqttUrl: 'ws://localhost:180',  // optional (default = ws://localhost:180)
      *   natsUrl: 'ws://localhost:7500', // optional (default = ws://localhost:7500)
      * };
@@ -150,9 +137,31 @@ class SDK {
      */
     async Initialize(config) {
         try {
+            // console.log("Initializing SDK with config:", config)
+            // Methods to initialize config 
+            // 1. Via application_id + URLs + developer key passed in config parameter
+            // 2. Via development server - Set via Extension/ 
+            //          API to get Config (All SDK URLs default to localhost with port from querying current window or 61888)
+            if (config === undefined)
+                config = { application_id: "" };
+            if (!config.application_id)
+                config = { application_id: "" };
+            // console.log("Using application_id:", config.application_id);
+            const PORT = await getEnvPort();
+            // console.log("Using port:", PORT);
+            if (!config.httpUrl) {
+                config.httpUrl = "http://localhost:" + PORT;
+            }
+            if (!config.mqttUrl) {
+                config.mqttUrl = "ws://localhost:" + PORT + "/mqtt";
+            }
+            if (!config.natsUrl) {
+                config.natsUrl = "ws://localhost:" + PORT + "/nats";
+            }
             const { application_id, httpUrl, mqttUrl, natsUrl } = config;
-            this.http = new HTTPClient(application_id, httpUrl);
-            this.mqtt = await MQTTClient.getInstance(application_id, mqttUrl);
+            // console.log("Final config:", { application_id, httpUrl, mqttUrl, natsUrl });
+            this.http = new HTTPClient(application_id, httpUrl, config.developer_key);
+            this.mqtt = await MQTTClient.getInstance(application_id, mqttUrl, config.developer_key);
             this.nats = await NATSClient.getInstance(application_id, natsUrl);
             this._historian = new historian_js_1.Historian(this.http["httpService"], this.mqtt["mqttService"]);
             this._tag = new tag_js_1.Tag(this.http["httpService"], this.mqtt["mqttService"]);
@@ -225,3 +234,35 @@ class SDK {
     }
 }
 exports.SDK = SDK;
+async function getEnvPort() {
+    try {
+        const response = await fetchData(window.location.origin + "/_cfg");
+        // console.log('Response:', response);
+        // console.log('runtimeID: ', response.runtimeID);
+        // console.log('applicationID: ', response.runtimeID.split('XmchX')[0]);
+        return response.port;
+    }
+    catch (error) {
+        // console.log('No configured runtime ID:', error);
+        // TODO: Use DevPort from SDK Config or default to 61888
+        return "61888";
+    }
+}
+async function fetchData(url) {
+    try {
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'Accept': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        const data = await response.json();
+        return data;
+    }
+    catch (error) {
+        throw error;
+    }
+}

package/dist/cjs/services/http.service.d.ts

@@ -8,16 +8,20 @@ export declare class HTTPException extends Error {
 export declare class HTTPService {
     private url;
     private applicationID;
-    constructor(url: string, prefix?: string, applicationID?: string);
+    private developerKey?;
+    constructor(url: string, prefix: string, applicationID: string, developerKey?: string);
     get request(): RequestParameters;
+    private addRuntimeHeaders;
+    private getCookie;
 }
 declare class RequestParameters {
     private base;
     private applicationID;
+    private developerKey?;
     query?: Record<string, string>;
     init?: RequestInit;
     headers?: Record<string, string>;
-    constructor(base: URL, applicationID: string, query?: Record<string, string>);
+    constructor(base: URL, applicationID: string, developerKey?: string, query?: Record<string, string>);
     private withQuery;
     private parseInit;
     withBody(body: BodyInit): RequestParameters;
@@ -30,6 +34,7 @@ declare class RequestParameters {
     setBearerToken(token: string): RequestParameters;
     withAccessToken(): RequestParameters;
     withDomain(): RequestParameters;
+    withDeveloperKey(): RequestParameters;
     withContentType(mime: string): RequestParameters;
     withJSON(body: Record<string, unknown>): RequestParameters;
     get<ReturnType>(path: string, query?: Record<string, string>): Promise<ReturnType>;

package/dist/cjs/services/http.service.js

@@ -14,24 +14,47 @@ class HTTPException extends Error {
 }
 exports.HTTPException = HTTPException;
 class HTTPService {
-    constructor(url, prefix, applicationID) {
+    constructor(url, prefix, applicationID, developerKey) {
         if (prefix == null)
             prefix = "";
         this.url = new URL(prefix, url);
         this.applicationID = "domains:" + applicationID;
+        this.developerKey = developerKey;
     }
     get request() {
-        return new RequestParameters(this.url, this.applicationID);
+        return new RequestParameters(this.url, this.applicationID, this.developerKey);
+    }
+    addRuntimeHeaders(headers = {}) {
+        // Add runtime ID from cookie if available (for hosted applications)
+        if (typeof document !== 'undefined') {
+            const runtimeID = this.getCookie('machhub_runtime_id');
+            if (runtimeID) {
+                headers['X-MachHub-Runtime-ID'] = runtimeID;
+            }
+        }
+        return headers;
+    }
+    getCookie(name) {
+        if (typeof document === 'undefined')
+            return null;
+        const value = `; ${document.cookie}`;
+        const parts = value.split(`; ${name}=`);
+        if (parts.length === 2) {
+            return parts.pop()?.split(';').shift() || null;
+        }
+        return null;
     }
 }
 exports.HTTPService = HTTPService;
 class RequestParameters {
-    constructor(base, applicationID, query) {
+    constructor(base, applicationID, developerKey, query) {
         this.base = base;
         this.applicationID = applicationID;
+        this.developerKey = developerKey;
         this.query = query;
         this.withDomain(); // Ensure withDomain() is called by default
         this.withAccessToken(); // Ensure withAccessToken() is called by default
+        this.withDeveloperKey(); // Ensure withDeveloperKey() is called by default
     }
     withQuery(path, query) {
         const newPath = [this.base.pathname, path].map(pathPart => pathPart.replace(/(^\/|\/$)/g, "")).join("/");
@@ -119,6 +142,12 @@ class RequestParameters {
         this.setHeader("Domain", this.applicationID);
         return this;
     }
+    withDeveloperKey() {
+        if (!this.developerKey)
+            return this;
+        this.setHeader("X-Machhub-Api-Key", this.developerKey);
+        return this;
+    }
     withContentType(mime) {
         this.setHeader("Content-Type", mime);
         return this;

package/dist/cjs/services/mqtt.service.d.ts

@@ -5,7 +5,7 @@ export declare class MQTTService {
     private static instance;
     private subscribedTopics;
     constructor(url: string);
-    static getInstance(url?: string): Promise<MQTTService>;
+    static getInstance(url?: string, developerKey?: string): Promise<MQTTService>;
     static resetInstance(): void;
     addTopicHandler(topic: string, handler: (message: unknown) => void): void;
     clearTopics(): void;

package/dist/cjs/services/mqtt.service.js

@@ -10,13 +10,20 @@ class MQTTService {
         this.subscribedTopics = [];
         this.url = url;
     }
-    static async getInstance(url = "ws://localhost:180") {
+    static async getInstance(url = "ws://localhost:180", developerKey) {
         if (!this.instance || !this.instance.client) {
             this.instance = new MQTTService(url);
             // Ensure the URL is set correctly
             this.instance.url = url;
             // Initialize the MQTT client
-            this.instance.client = mqtt_1.default.connect(this.instance.url, { protocolVersion: 5 });
+            const connectOptions = {
+                protocolVersion: 5,
+                ...(developerKey && {
+                    username: "mch_developer_key",
+                    password: developerKey,
+                })
+            };
+            this.instance.client = mqtt_1.default.connect(this.instance.url, connectOptions);
             this.instance.attachMessageListener();
             // console.log("MQTT Client initialized with URL:", this.instance.url);
         }
@@ -75,7 +82,7 @@ class MQTTService {
     }
     attachMessageListener() {
         this.client.on('connect', () => {
-            console.log("MQTT connected to", this.url);
+            // console.log("MQTT connected to", this.url);
         });
         this.client.on('error', (error) => {
             console.error("MQTT connection error:", error);

package/dist/classes/collection.js

@@ -25,15 +25,24 @@ export class Collection {
         return this.httpService.request.get(this.collectionName + "/all", this.queryParams);
     }
     async getOne(id) {
+        if (!id) {
+            throw new Error("ID must be provided");
+        }
         return this.httpService.request.get(id);
     }
     async create(data) {
         return this.httpService.request.withJSON(data).post(this.collectionName);
     }
     async update(id, data) {
+        if (!id) {
+            throw new Error("ID must be provided");
+        }
         return this.httpService.request.withJSON(data).put(id);
     }
     async delete(id) {
+        if (!id) {
+            throw new Error("ID must be provided");
+        }
         return this.httpService.request.delete(id);
     }
 }

package/dist/classes/historian.d.ts

@@ -9,4 +9,5 @@ export declare class Historian {
     getHistoricalData(topic: string, start_time: Date, range?: string): Promise<HistorizedData[]>;
     subscribeLiveData(topic: string, callback: (data: any) => void): Promise<any>;
     getLastNValues(topic: string, n: number): Promise<HistorizedData[]>;
+    query(SurrealQL: string): Promise<any>;
 }

package/dist/classes/historian.js

@@ -33,4 +33,9 @@ export class Historian {
             sort: "desc", // Fetch the latest values
         }).patch("historian/last");
     }
+    async query(SurrealQL) {
+        return this.httpService.request.withJSON({
+            query: SurrealQL
+        }).post("historian/query");
+    }
 }

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 export { SDK, type SDKConfig } from './sdk-ts.js';
-export { getAppConfig } from './utils/appConfig.js';
 export type { LoginResponse, PermissionResponse, User, Group, Feature, Permission, ActionResponse, Action, Scope } from './types/auth.models.js';
 export type { BaseResponse } from './types/response.models.js';
 export type { RecordID } from './types/recordID.models.js';

package/dist/index.js

@@ -1,2 +1 @@
 export { SDK } from './sdk-ts.js';
-export { getAppConfig } from './utils/appConfig.js';

package/dist/sdk-ts.d.ts

@@ -6,6 +6,7 @@ import { Flow } from "./classes/flow.js";
 import { Auth } from "./classes/auth.js";
 export interface SDKConfig {
     application_id: string;
+    developer_key?: string;
     httpUrl?: string;
     mqttUrl?: string;
     natsUrl?: string;
@@ -28,7 +29,7 @@ export declare class SDK {
      *
      * const config: SDKConfig = {
      *   application_id: 'your-app-id',
-     *   httpUrl: 'http://localhost:80', // optional (default = http://localhost:80)
+     *   httpUrl: 'http://localhost:6188', // optional (default = http://localhost:6188)
      *   mqttUrl: 'ws://localhost:180',  // optional (default = ws://localhost:180)
      *   natsUrl: 'ws://localhost:7500', // optional (default = ws://localhost:7500)
      * };
@@ -40,7 +41,7 @@ export declare class SDK {
      * @param config {SDKConfig} The configuration object containing initialization parameters. See SDKConfig for details.
      * @returns {Promise<boolean>} Resolves to true if initialization is successful.
      */
-    Initialize(config: SDKConfig): Promise<boolean>;
+    Initialize(config?: SDKConfig): Promise<boolean>;
     /**
      * Getter for `auth`. Ensures `auth` is accessed only after initialization.
      */

package/dist/sdk-ts.js

@@ -1,7 +1,6 @@
 import { HTTPService } from "./services/http.service.js";
 import { MQTTService } from "./services/mqtt.service.js";
 import { NATSService } from "./services/nats.service.js";
-import { getAppConfig } from "./utils/appConfig.js";
 import { Collection } from "./classes/collection.js";
 import { Historian } from "./classes/historian.js";
 import { Tag } from "./classes/tag.js";
@@ -14,22 +13,10 @@ class HTTPClient {
     /**
      * Creates a new HTTPClient instance
      * @param applicationID The ID for your application (required)
-     * @param httpUrl The base URL for HTTP connection (default = http://localhost:80)
+     * @param httpUrl The base URL for HTTP connection (default = http://localhost:6188)
      */
-    constructor(applicationID, httpUrl = "http://localhost:80") {
-        if (!applicationID) {
-            const config = getAppConfig();
-            if (config != undefined) {
-                applicationID = config.application_id;
-            }
-            else {
-                throw new Error("Failed to get Configuration.");
-            }
-            if (!applicationID) {
-                throw new Error("Application ID is required. Set it via the APP_ID environment variable or pass it as a parameter.");
-            }
-        }
-        this.httpService = new HTTPService(httpUrl, MACHHUB_SDK_PATH, applicationID);
+    constructor(applicationID, httpUrl, developerKey) {
+        this.httpService = new HTTPService(httpUrl, MACHHUB_SDK_PATH, applicationID, developerKey);
     }
     /**
      * Gets server info
@@ -48,7 +35,7 @@ class MQTTClient {
      * @param applicationID The ID for your application
      * @param mqttUrl The base URL for MQTT connection (default = ws://localhost:180)
      */
-    static async getInstance(applicationID, mqttUrl = "ws://localhost:180") {
+    static async getInstance(applicationID, mqttUrl = "ws://localhost:180", developerKey) {
         // if (!applicationID) {
         //   applicationID = process.env.APP_ID;
         //   if (!applicationID) {
@@ -56,7 +43,7 @@ class MQTTClient {
         //   }
         // }
         if (!this.instance) {
-            const mqttService = await MQTTService.getInstance(mqttUrl);
+            const mqttService = await MQTTService.getInstance(mqttUrl, developerKey);
             this.instance = new MQTTClient(mqttService); // Use the constructor to initialize the instance
         }
         return this.instance;
@@ -133,7 +120,7 @@ export class SDK {
      *
      * const config: SDKConfig = {
      *   application_id: 'your-app-id',
-     *   httpUrl: 'http://localhost:80', // optional (default = http://localhost:80)
+     *   httpUrl: 'http://localhost:6188', // optional (default = http://localhost:6188)
      *   mqttUrl: 'ws://localhost:180',  // optional (default = ws://localhost:180)
      *   natsUrl: 'ws://localhost:7500', // optional (default = ws://localhost:7500)
      * };
@@ -147,9 +134,31 @@ export class SDK {
      */
     async Initialize(config) {
         try {
+            // console.log("Initializing SDK with config:", config)
+            // Methods to initialize config 
+            // 1. Via application_id + URLs + developer key passed in config parameter
+            // 2. Via development server - Set via Extension/ 
+            //          API to get Config (All SDK URLs default to localhost with port from querying current window or 61888)
+            if (config === undefined)
+                config = { application_id: "" };
+            if (!config.application_id)
+                config = { application_id: "" };
+            // console.log("Using application_id:", config.application_id);
+            const PORT = await getEnvPort();
+            // console.log("Using port:", PORT);
+            if (!config.httpUrl) {
+                config.httpUrl = "http://localhost:" + PORT;
+            }
+            if (!config.mqttUrl) {
+                config.mqttUrl = "ws://localhost:" + PORT + "/mqtt";
+            }
+            if (!config.natsUrl) {
+                config.natsUrl = "ws://localhost:" + PORT + "/nats";
+            }
             const { application_id, httpUrl, mqttUrl, natsUrl } = config;
-            this.http = new HTTPClient(application_id, httpUrl);
-            this.mqtt = await MQTTClient.getInstance(application_id, mqttUrl);
+            // console.log("Final config:", { application_id, httpUrl, mqttUrl, natsUrl });
+            this.http = new HTTPClient(application_id, httpUrl, config.developer_key);
+            this.mqtt = await MQTTClient.getInstance(application_id, mqttUrl, config.developer_key);
             this.nats = await NATSClient.getInstance(application_id, natsUrl);
             this._historian = new Historian(this.http["httpService"], this.mqtt["mqttService"]);
             this._tag = new Tag(this.http["httpService"], this.mqtt["mqttService"]);
@@ -221,3 +230,35 @@ export class SDK {
         return new Collection(this.http["httpService"], this.mqtt ? this.mqtt["mqttService"] : null, collectionName);
     }
 }
+async function getEnvPort() {
+    try {
+        const response = await fetchData(window.location.origin + "/_cfg");
+        // console.log('Response:', response);
+        // console.log('runtimeID: ', response.runtimeID);
+        // console.log('applicationID: ', response.runtimeID.split('XmchX')[0]);
+        return response.port;
+    }
+    catch (error) {
+        // console.log('No configured runtime ID:', error);
+        // TODO: Use DevPort from SDK Config or default to 61888
+        return "61888";
+    }
+}
+async function fetchData(url) {
+    try {
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'Accept': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        const data = await response.json();
+        return data;
+    }
+    catch (error) {
+        throw error;
+    }
+}

package/dist/services/http.service.d.ts

@@ -8,16 +8,20 @@ export declare class HTTPException extends Error {
 export declare class HTTPService {
     private url;
     private applicationID;
-    constructor(url: string, prefix?: string, applicationID?: string);
+    private developerKey?;
+    constructor(url: string, prefix: string, applicationID: string, developerKey?: string);
     get request(): RequestParameters;
+    private addRuntimeHeaders;
+    private getCookie;
 }
 declare class RequestParameters {
     private base;
     private applicationID;
+    private developerKey?;
     query?: Record<string, string>;
     init?: RequestInit;
     headers?: Record<string, string>;
-    constructor(base: URL, applicationID: string, query?: Record<string, string>);
+    constructor(base: URL, applicationID: string, developerKey?: string, query?: Record<string, string>);
     private withQuery;
     private parseInit;
     withBody(body: BodyInit): RequestParameters;
@@ -30,6 +34,7 @@ declare class RequestParameters {
     setBearerToken(token: string): RequestParameters;
     withAccessToken(): RequestParameters;
     withDomain(): RequestParameters;
+    withDeveloperKey(): RequestParameters;
     withContentType(mime: string): RequestParameters;
     withJSON(body: Record<string, unknown>): RequestParameters;
     get<ReturnType>(path: string, query?: Record<string, string>): Promise<ReturnType>;

package/dist/services/http.service.js

@@ -10,23 +10,46 @@ export class HTTPException extends Error {
     }
 }
 export class HTTPService {
-    constructor(url, prefix, applicationID) {
+    constructor(url, prefix, applicationID, developerKey) {
         if (prefix == null)
             prefix = "";
         this.url = new URL(prefix, url);
         this.applicationID = "domains:" + applicationID;
+        this.developerKey = developerKey;
     }
     get request() {
-        return new RequestParameters(this.url, this.applicationID);
+        return new RequestParameters(this.url, this.applicationID, this.developerKey);
+    }
+    addRuntimeHeaders(headers = {}) {
+        // Add runtime ID from cookie if available (for hosted applications)
+        if (typeof document !== 'undefined') {
+            const runtimeID = this.getCookie('machhub_runtime_id');
+            if (runtimeID) {
+                headers['X-MachHub-Runtime-ID'] = runtimeID;
+            }
+        }
+        return headers;
+    }
+    getCookie(name) {
+        if (typeof document === 'undefined')
+            return null;
+        const value = `; ${document.cookie}`;
+        const parts = value.split(`; ${name}=`);
+        if (parts.length === 2) {
+            return parts.pop()?.split(';').shift() || null;
+        }
+        return null;
     }
 }
 class RequestParameters {
-    constructor(base, applicationID, query) {
+    constructor(base, applicationID, developerKey, query) {
         this.base = base;
         this.applicationID = applicationID;
+        this.developerKey = developerKey;
         this.query = query;
         this.withDomain(); // Ensure withDomain() is called by default
         this.withAccessToken(); // Ensure withAccessToken() is called by default
+        this.withDeveloperKey(); // Ensure withDeveloperKey() is called by default
     }
     withQuery(path, query) {
         const newPath = [this.base.pathname, path].map(pathPart => pathPart.replace(/(^\/|\/$)/g, "")).join("/");
@@ -114,6 +137,12 @@ class RequestParameters {
         this.setHeader("Domain", this.applicationID);
         return this;
     }
+    withDeveloperKey() {
+        if (!this.developerKey)
+            return this;
+        this.setHeader("X-Machhub-Api-Key", this.developerKey);
+        return this;
+    }
     withContentType(mime) {
         this.setHeader("Content-Type", mime);
         return this;

package/dist/services/mqtt.service.d.ts

@@ -5,7 +5,7 @@ export declare class MQTTService {
     private static instance;
     private subscribedTopics;
     constructor(url: string);
-    static getInstance(url?: string): Promise<MQTTService>;
+    static getInstance(url?: string, developerKey?: string): Promise<MQTTService>;
     static resetInstance(): void;
     addTopicHandler(topic: string, handler: (message: unknown) => void): void;
     clearTopics(): void;

package/dist/services/mqtt.service.js

@@ -4,13 +4,20 @@ export class MQTTService {
         this.subscribedTopics = [];
         this.url = url;
     }
-    static async getInstance(url = "ws://localhost:180") {
+    static async getInstance(url = "ws://localhost:180", developerKey) {
         if (!this.instance || !this.instance.client) {
             this.instance = new MQTTService(url);
             // Ensure the URL is set correctly
             this.instance.url = url;
             // Initialize the MQTT client
-            this.instance.client = mqtt.connect(this.instance.url, { protocolVersion: 5 });
+            const connectOptions = {
+                protocolVersion: 5,
+                ...(developerKey && {
+                    username: "mch_developer_key",
+                    password: developerKey,
+                })
+            };
+            this.instance.client = mqtt.connect(this.instance.url, connectOptions);
             this.instance.attachMessageListener();
             // console.log("MQTT Client initialized with URL:", this.instance.url);
         }
@@ -69,7 +76,7 @@ export class MQTTService {
     }
     attachMessageListener() {
         this.client.on('connect', () => {
-            console.log("MQTT connected to", this.url);
+            // console.log("MQTT connected to", this.url);
         });
         this.client.on('error', (error) => {
             console.error("MQTT connection error:", error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@machhub-dev/sdk-ts",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "MACHHUB TYPESCRIPT SDK",
   "keywords": [
     "machhub",
@@ -23,11 +23,11 @@
     "mqtt": "^5.10.4",
     "safe-buffer": "^5.2.1",
     "typescript": "^5.8.3",
-    "undici-types": "^7.4.0"
+    "undici-types": "^7.4.0",
+    "@nats-io/nats-core": "^3.0.2",
+    "@nats-io/transport-node": "^3.0.2"
   },
   "devDependencies": {
-    "@nats-io/nats-core": "^3.0.2",
-    "@nats-io/transport-node": "^3.0.2",
     "@types/node": "^22.13.5"
   }
-}
+}

package/src/classes/collection.ts

@@ -38,6 +38,9 @@ export class Collection {
   }
 
   async getOne(id: string): Promise<any> {
+    if (!id) {
+      throw new Error("ID must be provided");
+    }
     return this.httpService.request.get(id);
   }
 
@@ -46,10 +49,16 @@ export class Collection {
   }
 
   async update(id: string, data: Record<string, any>): Promise<any> {
+    if (!id) {
+      throw new Error("ID must be provided");
+    }
     return this.httpService.request.withJSON(data).put(id);
   }
 
   async delete(id: string): Promise<any> {
+    if (!id) {
+      throw new Error("ID must be provided");
+    }
     return this.httpService.request.delete(id);
   }
 }

package/src/classes/historian.ts

@@ -46,4 +46,10 @@ export class Historian {
       sort: "desc", // Fetch the latest values
     }).patch("historian/last");
   }
+
+  async query(SurrealQL:string): Promise<any> {
+    return this.httpService.request.withJSON({
+      query: SurrealQL
+    }).post("historian/query");
+  }
 }

package/src/index.ts

@@ -1,5 +1,4 @@
 export { SDK, type SDKConfig } from './sdk-ts.js';
-export { getAppConfig } from './utils/appConfig.js';
 
 // Export individual types
 export type { LoginResponse, PermissionResponse, User, Group, Feature, Permission, ActionResponse, Action, Scope } from './types/auth.models.js';

package/src/sdk-ts.ts

@@ -1,7 +1,6 @@
 import { HTTPService } from "./services/http.service.js";
 import { MQTTService } from "./services/mqtt.service.js";
 import { NATSService } from "./services/nats.service.js";
-import { getAppConfig } from "./utils/appConfig.js";
 import { Collection } from "./classes/collection.js";
 import { Historian } from "./classes/historian.js";
 import { Tag } from "./classes/tag.js";
@@ -18,21 +17,10 @@ class HTTPClient {
   /**
    * Creates a new HTTPClient instance
    * @param applicationID The ID for your application (required)
-   * @param httpUrl The base URL for HTTP connection (default = http://localhost:80)
+   * @param httpUrl The base URL for HTTP connection (default = http://localhost:6188)
    */
-  constructor(applicationID: string, httpUrl: string = "http://localhost:80") {
-    if (!applicationID) {
-      const config = getAppConfig()
-      if (config != undefined) {
-        applicationID = config.application_id;
-      } else {
-        throw new Error("Failed to get Configuration.");
-      }
-      if (!applicationID) {
-        throw new Error("Application ID is required. Set it via the APP_ID environment variable or pass it as a parameter.");
-      }
-    }
-    this.httpService = new HTTPService(httpUrl, MACHHUB_SDK_PATH, applicationID);
+  constructor(applicationID: string, httpUrl:string, developerKey?: string) {
+    this.httpService = new HTTPService(httpUrl, MACHHUB_SDK_PATH, applicationID, developerKey);
   }
 
   /**
@@ -57,7 +45,7 @@ class MQTTClient {
    * @param applicationID The ID for your application
    * @param mqttUrl The base URL for MQTT connection (default = ws://localhost:180)
    */
-  static async getInstance(applicationID?: string, mqttUrl: string = "ws://localhost:180"): Promise<MQTTClient> {
+  static async getInstance(applicationID?: string, mqttUrl: string = "ws://localhost:180", developerKey? :string): Promise<MQTTClient> {
     // if (!applicationID) {
     //   applicationID = process.env.APP_ID;
     //   if (!applicationID) {
@@ -65,7 +53,7 @@ class MQTTClient {
     //   }
     // }
     if (!this.instance) {
-      const mqttService = await MQTTService.getInstance(mqttUrl);
+      const mqttService = await MQTTService.getInstance(mqttUrl, developerKey);
       this.instance = new MQTTClient(mqttService); // Use the constructor to initialize the instance
     }
     return this.instance;
@@ -133,6 +121,7 @@ class NATSClient {
 
 export interface SDKConfig {
   application_id: string;
+  developer_key?: string;
   httpUrl?: string;
   mqttUrl?: string;
   natsUrl?: string;
@@ -158,7 +147,7 @@ export class SDK {
    *
    * const config: SDKConfig = {
    *   application_id: 'your-app-id',
-   *   httpUrl: 'http://localhost:80', // optional (default = http://localhost:80)
+   *   httpUrl: 'http://localhost:6188', // optional (default = http://localhost:6188)
    *   mqttUrl: 'ws://localhost:180',  // optional (default = ws://localhost:180)
    *   natsUrl: 'ws://localhost:7500', // optional (default = ws://localhost:7500)
    * };
@@ -170,13 +159,43 @@ export class SDK {
    * @param config {SDKConfig} The configuration object containing initialization parameters. See SDKConfig for details.
    * @returns {Promise<boolean>} Resolves to true if initialization is successful.
    */
-  public async Initialize(config: SDKConfig): Promise<boolean> {
+  public async Initialize(config?: SDKConfig): Promise<boolean> {
     try {
+      // console.log("Initializing SDK with config:", config)
+
+      // Methods to initialize config 
+      // 1. Via application_id + URLs + developer key passed in config parameter
+      // 2. Via development server - Set via Extension/ 
+      //          API to get Config (All SDK URLs default to localhost with port from querying current window or 61888)
+
+      if (config === undefined) config = { application_id: "" }
+      if (!config.application_id) config = { application_id: "" }
+      // console.log("Using application_id:", config.application_id);
+
+
+      const PORT = await getEnvPort();
+      // console.log("Using port:", PORT);
+
+      if (!config.httpUrl) {
+        config.httpUrl = "http://localhost:" + PORT;
+      }
+
+      if (!config.mqttUrl) {
+        config.mqttUrl = "ws://localhost:" + PORT + "/mqtt";
+      }
+
+      if (!config.natsUrl) {
+        config.natsUrl = "ws://localhost:" + PORT + "/nats";
+      }
+
       const { application_id, httpUrl, mqttUrl, natsUrl } = config;
 
-      this.http = new HTTPClient(application_id, httpUrl);
-      this.mqtt = await MQTTClient.getInstance(application_id, mqttUrl);
+      // console.log("Final config:", { application_id, httpUrl, mqttUrl, natsUrl });
+
+      this.http = new HTTPClient(application_id, httpUrl, config.developer_key);
+      this.mqtt = await MQTTClient.getInstance(application_id, mqttUrl, config.developer_key);
       this.nats = await NATSClient.getInstance(application_id, natsUrl);
+      
       this._historian = new Historian(this.http["httpService"], this.mqtt["mqttService"]);
       this._tag = new Tag(this.http["httpService"], this.mqtt["mqttService"]);
       this._function = new Function(this.http["httpService"], this.nats["natsService"]);
@@ -252,4 +271,39 @@ export class SDK {
     }
     return new Collection(this.http["httpService"], this.mqtt ? this.mqtt["mqttService"] : null, collectionName);
   }
-}
+}
+
+async function getEnvPort(): Promise<string> {
+  try {
+    const response = await fetchData<{runtimeID:string, port:string}>(window.location.origin + "/_cfg");
+    // console.log('Response:', response);
+    // console.log('runtimeID: ', response.runtimeID);
+    // console.log('applicationID: ', response.runtimeID.split('XmchX')[0]);
+    return response.port;
+  } catch (error) {
+    // console.log('No configured runtime ID:', error);
+    // TODO: Use DevPort from SDK Config or default to 61888
+    return "61888";
+  }
+}
+
+
+async function fetchData<T>(url: string): Promise<T> {
+  try {
+    const response = await fetch(url, {
+      method: 'GET',
+      headers: {
+        'Accept': 'application/json',
+      },
+    });
+
+    if (!response.ok) {
+      throw new Error(`HTTP error! status: ${response.status}`);
+    }
+
+    const data: T = await response.json();
+    return data;
+  } catch (error) {
+    throw error;
+  }
+}

package/src/services/http.service.ts

@@ -9,7 +9,7 @@ export class HTTPException extends Error {
         this.statusText = statusText;
         this.body = body;
     }
-    
+
     public get message(): string {
         return `(EXCEPTION) ${this.statusText} - ${this.body}`
     }
@@ -18,37 +18,65 @@ export class HTTPException extends Error {
 export class HTTPService {
     private url: URL;
     private applicationID: string;
+    private developerKey?: string;
 
-    constructor(url: string, prefix?: string, applicationID?:string) {
+    constructor(url: string, prefix: string, applicationID: string, developerKey?: string) {
         if (prefix == null) prefix = "";
         this.url = new URL(prefix, url);
         this.applicationID = "domains:" + applicationID
+        this.developerKey = developerKey
     }
 
     public get request(): RequestParameters {
-        return new RequestParameters(this.url, this.applicationID);
+        return new RequestParameters(this.url, this.applicationID, this.developerKey);
+    }
+
+    private addRuntimeHeaders(headers: Record<string, string> = {}): Record<string, string> {
+        // Add runtime ID from cookie if available (for hosted applications)
+        if (typeof document !== 'undefined') {
+            const runtimeID = this.getCookie('machhub_runtime_id');
+            if (runtimeID) {
+                headers['X-MachHub-Runtime-ID'] = runtimeID;
+            }
+        }
+
+        return headers;
+    }
+
+    private getCookie(name: string): string | null {
+        if (typeof document === 'undefined') return null;
+
+        const value = `; ${document.cookie}`;
+        const parts = value.split(`; ${name}=`);
+        if (parts.length === 2) {
+            return parts.pop()?.split(';').shift() || null;
+        }
+        return null;
     }
 }
 
 class RequestParameters {
     private base: URL;
     private applicationID: string;
+    private developerKey?: string;
     public query?: Record<string, string>;
     public init?: RequestInit;
     public headers?: Record<string, string>;
 
-    constructor(base: URL, applicationID:string, query?: Record<string, string>) {
+    constructor(base: URL, applicationID: string, developerKey?:string, query?: Record<string, string>) {
         this.base = base;
         this.applicationID = applicationID;
+        this.developerKey = developerKey;
         this.query = query;
         this.withDomain(); // Ensure withDomain() is called by default
         this.withAccessToken(); // Ensure withAccessToken() is called by default
+        this.withDeveloperKey(); // Ensure withDeveloperKey() is called by default
     }
 
     private withQuery(path: string, query?: Record<string, string>): URL {
         const newPath = [this.base.pathname, path].map(pathPart => pathPart.replace(/(^\/|\/$)/g, "")).join("/");
         const newURL = new URL(newPath, this.base);
-        
+
         for (const key in query) {
             newURL.searchParams.append(key, query[key]);
         }
@@ -59,7 +87,7 @@ class RequestParameters {
         if (method == null && this.headers == null) return;
 
         let tempInit = Object.assign({}, this.init);
-        
+
         if (tempInit == null) {
             tempInit = {} as RequestInit;
         }
@@ -69,7 +97,7 @@ class RequestParameters {
         if (this.headers != null && tempInit != null) {
             tempInit.headers = Object.assign({}, this.headers);
         }
-        
+
         return tempInit;
     }
 
@@ -147,6 +175,13 @@ class RequestParameters {
         return this;
     }
 
+    public withDeveloperKey(): RequestParameters {
+        if (!this.developerKey) return this;
+        this.setHeader("X-Machhub-Api-Key", this.developerKey);
+        return this;
+    }
+
+
     public withContentType(mime: string): RequestParameters {
         this.setHeader("Content-Type", mime);
         return this;
@@ -159,7 +194,7 @@ class RequestParameters {
 
     public async get<ReturnType>(path: string, query?: Record<string, string>): Promise<ReturnType> {
         const response = await fetch(this.withQuery(path, query), this.parseInit());
-        
+
         if (!response.ok) {
             throw new HTTPException(
                 response.status,
@@ -172,7 +207,7 @@ class RequestParameters {
 
     public async post<ReturnType>(path: string, query?: Record<string, string>, body?: FormData | Record<string, string>): Promise<ReturnType> {
         const init: RequestInit = this.parseInit("POST") || {};
-    
+
         if (body) {
             if (body instanceof FormData) {
                 init.body = body;
@@ -184,9 +219,9 @@ class RequestParameters {
                 };
             }
         }
-    
+
         const response = await fetch(this.withQuery(path, query), init);
-        
+
         if (!response.ok) {
             throw new HTTPException(
                 response.status,
@@ -196,11 +231,11 @@ class RequestParameters {
         }
         return response.json() as ReturnType;
     }
-    
+
 
     public async put<ReturnType>(path: string, query?: Record<string, string>): Promise<ReturnType> {
         const response = await fetch(this.withQuery(path, query), this.parseInit("PUT"));
-        
+
         if (!response.ok) {
             throw new HTTPException(
                 response.status,
@@ -213,7 +248,7 @@ class RequestParameters {
 
     public async delete<ReturnType>(path: string, query?: Record<string, string>): Promise<ReturnType> {
         const response = await fetch(this.withQuery(path, query), this.parseInit("DELETE"));
-        
+
         if (!response.ok) {
             throw new HTTPException(
                 response.status,
@@ -226,7 +261,7 @@ class RequestParameters {
 
     public async patch<ReturnType>(path: string, query?: Record<string, string>): Promise<ReturnType> {
         const response = await fetch(this.withQuery(path, query), this.parseInit("PATCH"));
-        
+
         if (!response.ok) {
             throw new HTTPException(
                 response.status,

package/src/services/mqtt.service.ts

@@ -15,7 +15,7 @@ export class MQTTService {
         this.url = url;
     }
 
-    static async getInstance(url: string = "ws://localhost:180"): Promise<MQTTService> {
+    static async getInstance(url: string = "ws://localhost:180", developerKey?:string): Promise<MQTTService> {
         if (!this.instance || !this.instance.client) {
             this.instance = new MQTTService(url);
 
@@ -23,7 +23,14 @@ export class MQTTService {
             this.instance.url = url;
 
             // Initialize the MQTT client
-            this.instance.client = mqtt.connect(this.instance.url, { protocolVersion: 5 });
+            const connectOptions = {
+                protocolVersion: 5 as const,
+                ...(developerKey && {
+                    username: "mch_developer_key",
+                    password: developerKey,
+                })
+            };
+            this.instance.client = mqtt.connect(this.instance.url, connectOptions);
             this.instance.attachMessageListener();
             // console.log("MQTT Client initialized with URL:", this.instance.url);
         }
@@ -85,7 +92,7 @@ export class MQTTService {
 
     private attachMessageListener(): void {
         this.client.on('connect', () => {
-            console.log("MQTT connected to", this.url);
+            // console.log("MQTT connected to", this.url);
         });
 
         this.client.on('error', (error: Error) => {

package/src/utils/appConfig.ts

@@ -1,30 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-
-interface AppConfig {
-  application_id: string;
-}
-
-export function getAppConfig(): AppConfig {
-  console.log("getAppConfig")
-  if (typeof process !== 'undefined' && process.env && process.env.APP_CONFIG_PATH) {
-    // Node.js environment
-    console.log(process.env)
-    console.log(process.env.APP_CONFIG_PATH)
-
-    const configPath = process.env.APP_CONFIG_PATH || path.resolve(__dirname, '../../../sdk.config.json');
-    const rawData = fs.readFileSync(configPath, 'utf-8');
-    return JSON.parse(rawData) as AppConfig;
-  } else {
-    try {
-      const configPath = path.resolve('../../../sdk.config.json');
-      console.log(configPath)
-      const rawData = fs.readFileSync(configPath, 'utf-8');
-      console.log("TEST")
-      console.log(rawData)
-      return JSON.parse(rawData) as AppConfig;
-    } catch (e:any){
-        throw new Error("Configuration not found. Set it via the APP_CONFIG_PATH environment variable : " + e);
-    }
-  }
-}