@tellaro/tql 0.1.11 → 0.1.12

package/dist/src/completionProvider.js

@@ -1,7 +1,7 @@
 var I = Object.defineProperty;
 var S = (e, t, a) => t in e ? I(e, t, { enumerable: !0, configurable: !0, writable: !0, value: a }) : e[t] = a;
 var p = (e, t, a) => S(e, typeof t != "symbol" ? t + "" : t, a);
-import { tokenizeTql as b, COMPARISON_OPERATORS as A, LOGICAL_OPERATORS as L, AGGREGATION_FUNCTIONS as R, VISUALIZATION_TYPES as $, TYPE_HINTS as P, MUTATORS as D } from "./tokenizer.js";
+import { tokenizeTql as b, COMPARISON_OPERATORS as A, LOGICAL_OPERATORS as L, AGGREGATION_FUNCTIONS as R, VISUALIZATION_TYPES as $, TYPE_HINTS as P, MUTATORS as D, ENRICHMENT_MUTATORS as ENRICHMENT_MUTATORS, MUTATOR_PARAMETERS as MUTATOR_PARAMETERS } from "./tokenizer.js";
 import { fuzzyMatch as _ } from "./fuzzyMatcher.js";
 import { getSchemaCache as M } from "./schemaCache.js";
 const E = [
@@ -281,8 +281,14 @@ function G(e, t, a) {
   const n = o[o.length - 1], r = o.length > 1 ? o[o.length - 2] : null, d = n.end === t && !((u = e[t - 1]) != null && u.match(/\s/)), s = d ? n.value : void 0;
   if (n.type === "logicalOp")
     return { type: "start" };
-  if (n.type === "paren" && n.value === "(")
+  if (n.type === "paren" && n.value === "(") {
+    // Check if previous token is a mutator - we're inside mutator params
+    if (r && r.type === "mutator") {
+      const mutatorName = r.value.toLowerCase();
+      return { type: "mutator_params", mutatorName: mutatorName, usedParams: [], partialText: s };
+    }
     return { type: "after_paren" };
+  }
   if (n.type === "arrow")
     return { type: "after_arrow", partialText: s };
   if (n.type === "doubleColon")
@@ -358,7 +364,15 @@ function ae(e, t = {}) {
       n.push(...x(o.partialText, o.fieldType)), n.push(H());
       break;
     case "after_mutator":
-      n.push(...x(o.partialText, o.mutatorOutputType));
+      // Check if this is an enrichment mutator (geo, nslookup, etc.)
+      // Enrichment mutators don't need operators - they transform the field into enriched data
+      if (o.mutatorName && ENRICHMENT_MUTATORS.includes(o.mutatorName)) {
+        // Suggest logical operators (AND, OR) or pipe for chaining
+        n.push(...C());
+        n.push(H());
+      } else {
+        n.push(...x(o.partialText, o.mutatorOutputType));
+      }
       break;
     case "after_operator":
       n.push(...Y(o.fieldName, t));
@@ -383,6 +397,9 @@ function ae(e, t = {}) {
     case "after_by":
       n.push(...y(t.fields, o.partialText));
       break;
+    case "mutator_params":
+      n.push(...getMutatorParameterCompletions(o.mutatorName, o.usedParams, o.partialText));
+      break;
     default:
       n.push(...y(t.fields, o.partialText)), n.push(...x(o.partialText)), n.push(...C());
   }
@@ -674,6 +691,52 @@ function ie(e, t, a) {
   const i = b(e.substring(0, t)), o = i[i.length - 1];
   return !!(o && o.type === "field" && o.value.length >= 2);
 }
+/**
+ * Get mutator parameter completions
+ * @param mutatorName - The mutator name (e.g., "geo", "nslookup")
+ * @param usedParams - Parameters already used in the current call
+ * @param partialText - Partial text for filtering
+ */
+function getMutatorParameterCompletions(mutatorName, usedParams = [], partialText) {
+  const params = MUTATOR_PARAMETERS[mutatorName];
+  if (!params || params.length === 0) {
+    return [];
+  }
+
+  // Filter out already used parameters
+  const usedSet = new Set(usedParams.map(p => p.toLowerCase()));
+  const availableParams = params.filter(p => !usedSet.has(p.name.toLowerCase()));
+
+  // Filter by partial text if provided
+  let filteredParams = availableParams;
+  if (partialText) {
+    const searchText = partialText.toLowerCase();
+    filteredParams = availableParams.filter(p =>
+      p.name.toLowerCase().includes(searchText)
+    );
+  }
+
+  return filteredParams.map((param, idx) => {
+    // Generate insert text based on parameter type
+    let insertText = `${param.name}=`;
+    if (param.type === "boolean") {
+      insertText = `${param.name}=true`;
+    } else if (param.type === "string") {
+      insertText = `${param.name}="$1"`;
+    } else if (param.type === "number") {
+      insertText = `${param.name}=$1`;
+    }
+
+    return {
+      label: param.name,
+      insertText: insertText,
+      kind: "property",
+      detail: `${param.type} - ${param.description}`,
+      documentation: param.description,
+      sortOrder: 100 + idx
+    };
+  });
+}
 export {
   oe as getCompletionTriggerCharacters,
   ae as getCompletions,

package/dist/src/parser.js

@@ -1,7 +1,7 @@
 var c = Object.defineProperty;
 var d = (r, e, t) => e in r ? c(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
 var o = (r, e, t) => d(r, typeof e != "symbol" ? e + "" : e, t);
-import { tokenizeTql as p, COMPARISON_OPERATORS as v } from "./tokenizer.js";
+import { tokenizeTql as p, COMPARISON_OPERATORS as v, ENRICHMENT_MUTATORS as ENRICHMENT_MUTATORS } from "./tokenizer.js";
 const f = 50, k = /* @__PURE__ */ new Set(["logicalOp", "paren"]);
 class y {
   constructor(e) {
@@ -220,6 +220,22 @@ class y {
       mutators: n,
       end: this.previous().end
     }), !this.check("operator")) {
+      // Check if the last mutator is an enrichment mutator (geo, nslookup, etc.)
+      // Enrichment mutators don't require an operator - they transform the field into enriched data
+      const lastMutator = n.length > 0 ? n[n.length - 1] : null;
+      const isEnrichmentMutator = lastMutator && ENRICHMENT_MUTATORS.includes(lastMutator);
+
+      if (isEnrichmentMutator) {
+        // Return a valid enrichment expression without error
+        return {
+          type: "enrichment",
+          field: t,
+          mutator: lastMutator,
+          start: t.start,
+          end: t.end
+        };
+      }
+
       const s = this.isAtEnd() ? this.previous() : this.peek(), h = n.length > 0 ? `'${e.value}' with mutator` : `'${e.value}'`;
       return this.addError(
         `Expected operator after field ${h}`,

package/dist/src/tokenizer.d.ts

@@ -20,6 +20,20 @@ export declare const COLLECTION_OPERATORS: TqlCollectionOperator[];
  * Synchronized with Python/Rust implementations.
  */
 export declare const MUTATORS: TqlMutator[];
+/**
+ * Enrichment mutators that don't require an operator after them.
+ * These mutators transform the field into an enriched object/value that stands alone.
+ */
+export declare const ENRICHMENT_MUTATORS: string[];
+/**
+ * Parameters available for mutators that support function call syntax.
+ */
+export interface MutatorParameter {
+    name: string;
+    type: 'boolean' | 'string' | 'number';
+    description: string;
+}
+export declare const MUTATOR_PARAMETERS: Record<string, MutatorParameter[]>;
 /**
  * All aggregation functions supported by TQL.
  * Synchronized with Python/Rust implementations.

package/dist/src/tokenizer.js

@@ -1,6 +1,52 @@
 var l = Object.defineProperty;
 var u = (o, e, n) => e in o ? l(o, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : o[e] = n;
 var a = (o, e, n) => u(o, typeof e != "symbol" ? e + "" : e, n);
+// Enrichment mutators that don't require an operator after them
+// These mutators transform the field into an enriched object/value that stands alone
+const ENRICHMENT_MUTATORS = [
+  "geo",
+  "geoip",
+  "geoip_lookup",
+  "nslookup"
+];
+
+// Parameters available for mutators that support function call syntax
+// e.g., geo(force=true, save=true)
+const MUTATOR_PARAMETERS = {
+  geo: [
+    { name: "force", type: "boolean", description: "Force lookup even if geo data already exists" },
+    { name: "save", type: "boolean", description: "Save results to the record" },
+    { name: "field", type: "string", description: "Field name to save results to" },
+    { name: "cache", type: "boolean", description: "Enable caching of lookup results" },
+    { name: "cache_ttl", type: "number", description: "Cache TTL in seconds" }
+  ],
+  geoip: [
+    { name: "force", type: "boolean", description: "Force lookup even if geo data already exists" },
+    { name: "save", type: "boolean", description: "Save results to the record" },
+    { name: "field", type: "string", description: "Field name to save results to" },
+    { name: "cache", type: "boolean", description: "Enable caching of lookup results" },
+    { name: "cache_ttl", type: "number", description: "Cache TTL in seconds" }
+  ],
+  geoip_lookup: [
+    { name: "force", type: "boolean", description: "Force lookup even if geo data already exists" },
+    { name: "save", type: "boolean", description: "Save results to the record" },
+    { name: "field", type: "string", description: "Field name to save results to" },
+    { name: "cache", type: "boolean", description: "Enable caching of lookup results" },
+    { name: "cache_ttl", type: "number", description: "Cache TTL in seconds" }
+  ],
+  nslookup: [
+    { name: "record_type", type: "string", description: "DNS record type (A, AAAA, MX, etc.)" },
+    { name: "cache", type: "boolean", description: "Enable caching of lookup results" },
+    { name: "cache_ttl", type: "number", description: "Cache TTL in seconds" }
+  ],
+  split: [
+    { name: "delimiter", type: "string", description: "Delimiter to split on (default: comma)" }
+  ],
+  replace: [
+    { name: "find", type: "string", description: "Text to find" },
+    { name: "replace", type: "string", description: "Text to replace with" }
+  ]
+};
 const p = [
   // Equality
   "eq",
@@ -413,9 +459,11 @@ export {
   _ as AGGREGATION_FUNCTIONS,
   f as COLLECTION_OPERATORS,
   p as COMPARISON_OPERATORS,
+  ENRICHMENT_MUTATORS,
   w as KEYWORDS,
   k as LOGICAL_OPERATORS,
   m as MUTATORS,
+  MUTATOR_PARAMETERS,
   d as NEGATION_SYMBOL_OPERATORS,
   c as SYMBOL_OPERATORS,
   g as TYPE_HINTS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tellaro/tql",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "Tellaro Query Language (TQL) parser, validator, and autocomplete for JavaScript/TypeScript",
   "type": "module",
   "main": "./dist/index.js",
@@ -23,17 +23,11 @@
     "README.md"
   ],
   "scripts": {
-    "build": "vite build",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:shared": "vitest run --grep 'shared-fixtures'",
     "test:e2e": "playwright test",
-    "test:e2e:ui": "playwright test --ui",
-    "playground:serve": "vite --config vite.playground.config.ts --port 5174",
-    "playground:dev": "vite --config vite.playground.config.ts",
-    "lint": "eslint src vue tests --ext .ts,.vue",
-    "typecheck": "vue-tsc --noEmit",
-    "prepublishOnly": "npm run build"
+    "test:e2e:ui": "playwright test --ui"
   },
   "repository": {
     "type": "git",