@machhub-dev/sdk-ts 0.0.16 → 1.0.1

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

@@ -1,5 +1,6 @@
 import { HTTPService } from "../services/http.service.js";
 import { MQTTService } from "../services/mqtt.service.js";
+import { Operator } from "../types/operator.models.js";
 export declare class CollectionError extends Error {
     operation: string;
     collectionName: string;
@@ -12,7 +13,7 @@ export declare class Collection {
     protected collectionName: string;
     protected queryParams: Record<string, any>;
     constructor(httpService: HTTPService, mqttService: MQTTService | null, collectionName: string);
-    filter(fieldName: string, operator: "=" | ">" | "<" | "<=" | ">=" | "!=" | "CONTAINS" | "IN", value: any): Collection;
+    filter(fieldName: string, operator: Operator, value: any): Collection;
     sort(field: string, direction?: "asc" | "desc"): Collection;
     limit(limit: number): Collection;
     offset(offset: number): Collection;
@@ -21,6 +22,7 @@ export declare class Collection {
     first(): Promise<any>;
     getAll(options?: {
         expand?: string | string[];
+        fields?: string | string[];
     }): Promise<any[]>;
     count(options?: {
         filter?: any;

package/dist/cjs/classes/collection.js

@@ -55,7 +55,10 @@ class Collection {
         try {
             this.applyOptions(options);
             if (options?.expand) {
-                this.queryParams.expand = Array.isArray(options.expand) ? options.expand.join() : options.expand;
+                this.queryParams.expand = Array.isArray(options.expand) ? options.expand.join(",") : options.expand;
+            }
+            if (options?.fields) {
+                this.queryParams.fields = Array.isArray(options.fields) ? options.fields.join(",") : options.fields;
             }
             return await this.httpService.request.get(this.collectionName + "/all", this.queryParams);
         }

package/dist/cjs/index.d.ts

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

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

@@ -11,5 +11,6 @@ export declare class MQTTService {
     clearTopics(): void;
     publish(topic: string, message: unknown): boolean;
     private attachMessageListener;
+    private matchesTopic;
     private parseMessage;
 }

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

@@ -89,7 +89,7 @@ class MQTTService {
         });
         this.client.on('message', (topic, message) => {
             for (const subscribedTopic of this.subscribedTopics) {
-                if (topic === subscribedTopic.topic) {
+                if (this.matchesTopic(subscribedTopic.topic, topic)) {
                     const parsedMessage = this.parseMessage(message, topic);
                     subscribedTopic.handler(parsedMessage);
                     break;
@@ -97,6 +97,40 @@ class MQTTService {
             }
         });
     }
+    // Matches MQTT topic patterns with wildcards (+ for single level, # for multi-level)
+    matchesTopic(pattern, topic) {
+        // Handle exact match first for performance
+        if (pattern === topic) {
+            return true;
+        }
+        const patternParts = pattern.split('/');
+        const topicParts = topic.split('/');
+        let i = 0;
+        let j = 0;
+        while (i < patternParts.length && j < topicParts.length) {
+            const patternPart = patternParts[i];
+            if (patternPart === '#') {
+                // Multi-level wildcard matches everything from this point
+                return true;
+            }
+            else if (patternPart === '+') {
+                // Single-level wildcard matches any single level
+                i++;
+                j++;
+            }
+            else if (patternPart === topicParts[j]) {
+                // Exact match
+                i++;
+                j++;
+            }
+            else {
+                // No match
+                return false;
+            }
+        }
+        // Check if we've consumed both pattern and topic completely
+        return i === patternParts.length && j === topicParts.length;
+    }
     parseMessage(message, topic) {
         try {
             return JSON.parse(message.toString());

package/dist/cjs/types/operator.models.d.ts

@@ -0,0 +1,28 @@
+/**
+ * SurrealDB Operators
+ * Reference: https://surrealdb.com/docs/surrealql/operators
+ */
+/**
+ * Comparison operators
+ */
+export type ComparisonOperator = "=" | "!=" | "==" | "?=" | "*=" | "~" | "!~" | "?~" | "*~" | "<" | "<=" | ">" | ">=";
+/**
+ * Containment operators
+ */
+export type ContainmentOperator = "CONTAINS" | "CONTAINSNOT" | "CONTAINSALL" | "CONTAINSANY" | "CONTAINSNONE" | "INSIDE" | "NOTINSIDE" | "ALLINSIDE" | "ANYINSIDE" | "NONEINSIDE";
+/**
+ * String operators
+ */
+export type StringOperator = "@@" | "@0@" | "@1@" | "@2@" | "@3@";
+/**
+ * Array operators
+ */
+export type ArrayOperator = "IN" | "NOT IN";
+/**
+ * All available operators in SurrealDB
+ */
+export type Operator = ComparisonOperator | ContainmentOperator | StringOperator | ArrayOperator;
+/**
+ * Common operators for basic queries
+ */
+export type BasicOperator = "=" | "!=" | "<" | "<=" | ">" | ">=" | "CONTAINS" | "IN";

package/dist/cjs/types/operator.models.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * SurrealDB Operators
+ * Reference: https://surrealdb.com/docs/surrealql/operators
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/classes/collection.d.ts

@@ -1,5 +1,6 @@
 import { HTTPService } from "../services/http.service.js";
 import { MQTTService } from "../services/mqtt.service.js";
+import { Operator } from "../types/operator.models.js";
 export declare class CollectionError extends Error {
     operation: string;
     collectionName: string;
@@ -12,7 +13,7 @@ export declare class Collection {
     protected collectionName: string;
     protected queryParams: Record<string, any>;
     constructor(httpService: HTTPService, mqttService: MQTTService | null, collectionName: string);
-    filter(fieldName: string, operator: "=" | ">" | "<" | "<=" | ">=" | "!=" | "CONTAINS" | "IN", value: any): Collection;
+    filter(fieldName: string, operator: Operator, value: any): Collection;
     sort(field: string, direction?: "asc" | "desc"): Collection;
     limit(limit: number): Collection;
     offset(offset: number): Collection;
@@ -21,6 +22,7 @@ export declare class Collection {
     first(): Promise<any>;
     getAll(options?: {
         expand?: string | string[];
+        fields?: string | string[];
     }): Promise<any[]>;
     count(options?: {
         filter?: any;

package/dist/classes/collection.js

@@ -51,7 +51,10 @@ export class Collection {
         try {
             this.applyOptions(options);
             if (options?.expand) {
-                this.queryParams.expand = Array.isArray(options.expand) ? options.expand.join() : options.expand;
+                this.queryParams.expand = Array.isArray(options.expand) ? options.expand.join(",") : options.expand;
+            }
+            if (options?.fields) {
+                this.queryParams.fields = Array.isArray(options.fields) ? options.fields.join(",") : options.fields;
             }
             return await this.httpService.request.get(this.collectionName + "/all", this.queryParams);
         }

package/dist/index.d.ts

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

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

@@ -11,5 +11,6 @@ export declare class MQTTService {
     clearTopics(): void;
     publish(topic: string, message: unknown): boolean;
     private attachMessageListener;
+    private matchesTopic;
     private parseMessage;
 }

package/dist/services/mqtt.service.js

@@ -83,7 +83,7 @@ export class MQTTService {
         });
         this.client.on('message', (topic, message) => {
             for (const subscribedTopic of this.subscribedTopics) {
-                if (topic === subscribedTopic.topic) {
+                if (this.matchesTopic(subscribedTopic.topic, topic)) {
                     const parsedMessage = this.parseMessage(message, topic);
                     subscribedTopic.handler(parsedMessage);
                     break;
@@ -91,6 +91,40 @@ export class MQTTService {
             }
         });
     }
+    // Matches MQTT topic patterns with wildcards (+ for single level, # for multi-level)
+    matchesTopic(pattern, topic) {
+        // Handle exact match first for performance
+        if (pattern === topic) {
+            return true;
+        }
+        const patternParts = pattern.split('/');
+        const topicParts = topic.split('/');
+        let i = 0;
+        let j = 0;
+        while (i < patternParts.length && j < topicParts.length) {
+            const patternPart = patternParts[i];
+            if (patternPart === '#') {
+                // Multi-level wildcard matches everything from this point
+                return true;
+            }
+            else if (patternPart === '+') {
+                // Single-level wildcard matches any single level
+                i++;
+                j++;
+            }
+            else if (patternPart === topicParts[j]) {
+                // Exact match
+                i++;
+                j++;
+            }
+            else {
+                // No match
+                return false;
+            }
+        }
+        // Check if we've consumed both pattern and topic completely
+        return i === patternParts.length && j === topicParts.length;
+    }
     parseMessage(message, topic) {
         try {
             return JSON.parse(message.toString());

package/dist/types/operator.models.d.ts

@@ -0,0 +1,28 @@
+/**
+ * SurrealDB Operators
+ * Reference: https://surrealdb.com/docs/surrealql/operators
+ */
+/**
+ * Comparison operators
+ */
+export type ComparisonOperator = "=" | "!=" | "==" | "?=" | "*=" | "~" | "!~" | "?~" | "*~" | "<" | "<=" | ">" | ">=";
+/**
+ * Containment operators
+ */
+export type ContainmentOperator = "CONTAINS" | "CONTAINSNOT" | "CONTAINSALL" | "CONTAINSANY" | "CONTAINSNONE" | "INSIDE" | "NOTINSIDE" | "ALLINSIDE" | "ANYINSIDE" | "NONEINSIDE";
+/**
+ * String operators
+ */
+export type StringOperator = "@@" | "@0@" | "@1@" | "@2@" | "@3@";
+/**
+ * Array operators
+ */
+export type ArrayOperator = "IN" | "NOT IN";
+/**
+ * All available operators in SurrealDB
+ */
+export type Operator = ComparisonOperator | ContainmentOperator | StringOperator | ArrayOperator;
+/**
+ * Common operators for basic queries
+ */
+export type BasicOperator = "=" | "!=" | "<" | "<=" | ">" | ">=" | "CONTAINS" | "IN";

package/dist/types/operator.models.js

@@ -0,0 +1,5 @@
+/**
+ * SurrealDB Operators
+ * Reference: https://surrealdb.com/docs/surrealql/operators
+ */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@machhub-dev/sdk-ts",
-  "version": "0.0.16",
+  "version": "1.0.1",
   "description": "MACHHUB TYPESCRIPT SDK",
   "keywords": [
     "machhub",

package/src/classes/collection.ts

@@ -1,5 +1,6 @@
 import { HTTPService } from "../services/http.service.js";
 import { MQTTService } from "../services/mqtt.service.js";
+import { Operator } from "../types/operator.models.js";
 
 export class CollectionError extends Error {
   public operation: string;
@@ -28,7 +29,7 @@ export class Collection {
   }
 
 
-  filter(fieldName: string, operator: "=" | ">" | "<" | "<=" | ">=" | "!=" | "CONTAINS" | "IN", value: any): Collection {
+  filter(fieldName: string, operator: Operator, value: any): Collection {
     this.queryParams[`filter[${fieldName}][${operator}][${typeof value}]`] = value;
     return this;
   }
@@ -68,11 +69,14 @@ export class Collection {
     return results[0] ?? null
   }
 
-  async getAll(options?: { expand?: string | string[] }): Promise<any[]> {
+  async getAll(options?: { expand?: string | string[], fields?: string | string[] }): Promise<any[]> {
     try {
       this.applyOptions(options)
       if (options?.expand) {
-        this.queryParams.expand = Array.isArray(options.expand) ? options.expand.join() : options.expand
+        this.queryParams.expand = Array.isArray(options.expand) ? options.expand.join(",") : options.expand
+      }
+      if (options?.fields) {
+        this.queryParams.fields = Array.isArray(options.fields) ? options.fields.join(",") : options.fields
       }
       return await this.httpService.request.get(this.collectionName + "/all", this.queryParams);
     } catch (error) {

package/src/index.ts

@@ -2,6 +2,7 @@ export { SDK, type SDKConfig } from './sdk-ts.js';
 
 // Export individual types
 export type { LoginResponse, PermissionResponse, User, Group, Feature, Permission, ActionResponse, Action, Scope } from './types/auth.models.js';
+export type { Operator } from './types/operator.models.js';
 export type { BaseResponse } from './types/response.models.js';
 export type { RecordID } from './types/recordID.models.js';
 export type { HistorizedData } from './types/tag.models.js';

package/src/services/mqtt.service.ts

@@ -101,7 +101,7 @@ export class MQTTService {
 
         this.client.on('message', (topic: string, message: Buffer) => {
             for (const subscribedTopic of this.subscribedTopics) {
-                if (topic === subscribedTopic.topic) {
+                if (this.matchesTopic(subscribedTopic.topic, topic)) {
                     const parsedMessage = this.parseMessage(message, topic);
                     subscribedTopic.handler(parsedMessage);
                     break;
@@ -110,6 +110,43 @@ export class MQTTService {
         });
     }
 
+    // Matches MQTT topic patterns with wildcards (+ for single level, # for multi-level)
+    private matchesTopic(pattern: string, topic: string): boolean {
+        // Handle exact match first for performance
+        if (pattern === topic) {
+            return true;
+        }
+
+        const patternParts = pattern.split('/');
+        const topicParts = topic.split('/');
+
+        let i = 0;
+        let j = 0;
+
+        while (i < patternParts.length && j < topicParts.length) {
+            const patternPart = patternParts[i];
+
+            if (patternPart === '#') {
+                // Multi-level wildcard matches everything from this point
+                return true;
+            } else if (patternPart === '+') {
+                // Single-level wildcard matches any single level
+                i++;
+                j++;
+            } else if (patternPart === topicParts[j]) {
+                // Exact match
+                i++;
+                j++;
+            } else {
+                // No match
+                return false;
+            }
+        }
+
+        // Check if we've consumed both pattern and topic completely
+        return i === patternParts.length && j === topicParts.length;
+    }
+
     private parseMessage(message: Buffer, topic: string): unknown {
         try {
             return JSON.parse(message.toString());

package/src/types/operator.models.ts

@@ -0,0 +1,68 @@
+/**
+ * SurrealDB Operators
+ * Reference: https://surrealdb.com/docs/surrealql/operators
+ */
+
+/**
+ * Comparison operators
+ */
+export type ComparisonOperator =
+  | "=" // Equal to
+  | "!=" // Not equal to
+  | "==" // Exact equality
+  | "?=" // Matches a condition
+  | "*=" // All match a condition
+  | "~" // Contains / matches regex
+  | "!~" // Does not contain / match regex
+  | "?~" // Matches a condition (fuzzy)
+  | "*~" // All match a condition (fuzzy)
+  | "<" // Less than
+  | "<=" // Less than or equal to
+  | ">" // Greater than
+  | ">=" // Greater than or equal to;
+
+/**
+ * Containment operators
+ */
+export type ContainmentOperator =
+  | "CONTAINS" // Contains a value
+  | "CONTAINSNOT" // Does not contain a value
+  | "CONTAINSALL" // Contains all values
+  | "CONTAINSANY" // Contains any value
+  | "CONTAINSNONE" // Contains none of the values
+  | "INSIDE" // Value is inside
+  | "NOTINSIDE" // Value is not inside
+  | "ALLINSIDE" // All values are inside
+  | "ANYINSIDE" // Any value is inside
+  | "NONEINSIDE"; // No values are inside
+
+/**
+ * String operators
+ */
+export type StringOperator =
+  | "@@" // Matches a condition (full-text search)
+  | "@0@" // Matches a condition (exact match)
+  | "@1@" // Matches a condition (fuzzy match level 1)
+  | "@2@" // Matches a condition (fuzzy match level 2)
+  | "@3@"; // Matches a condition (fuzzy match level 3)
+
+/**
+ * Array operators
+ */
+export type ArrayOperator =
+  | "IN" // Value is in array
+  | "NOT IN"; // Value is not in array
+
+/**
+ * All available operators in SurrealDB
+ */
+export type Operator =
+  | ComparisonOperator
+  | ContainmentOperator
+  | StringOperator
+  | ArrayOperator;
+
+/**
+ * Common operators for basic queries
+ */
+export type BasicOperator = "=" | "!=" | "<" | "<=" | ">" | ">=" | "CONTAINS" | "IN";