@tellaro/tql 0.1.17 → 0.2.0

package/dist/src/semanticPreview.js

@@ -1,11 +1,11 @@
-import { parseTql as y } from "./parser.js";
-import { analyzeComplexity as p } from "./complexityAnalyzer.js";
+import { parseTql as g } from "./parser.js";
+import { analyzeComplexity as m } from "./complexityAnalyzer.js";
 class u {
   /**
    * Generate a complete preview for a TQL query
    */
   generatePreview(t) {
-    const r = y(t), i = p(t), n = [], s = {};
+    const r = g(t), i = m(t), n = [], s = {};
     if (!r.ast)
       return {
         fields: [],
@@ -16,7 +16,7 @@ class u {
         operatorSummary: {}
       };
     this.extractFieldUsage(r.ast, n, s);
-    const a = this.buildLogicTree(r.ast), c = [...new Set(n.map((l) => l.name))];
+    const a = this.buildLogicTree(r.ast), c = [...new Set(n.map((o) => o.name))];
     return {
       fields: n,
       logicTree: a,
@@ -173,70 +173,68 @@ class u {
     };
   }
 }
-function b(e) {
+function T(e) {
   return new u().generatePreview(e);
 }
-function F(e) {
+function v(e) {
   return new u().generatePreview(e).fields;
 }
-function N(e) {
+function $(e) {
   return new u().generatePreview(e).logicTree;
 }
-function P(e) {
+function b(e) {
   return new u().generatePreview(e).uniqueFields;
 }
-function U(e) {
+function F(e) {
   return new u().generatePreview(e).operatorSummary;
 }
-function g(e) {
-  var t, r, i;
+function h(e) {
   if (e.type === "comparison") {
-    const n = (t = e.mutators) != null && t.length ? ` | ${e.mutators.join(" | ")}` : "", s = m(e.value);
-    return `${e.field}${n} ${e.operator} ${s}`;
+    const t = e.mutators?.length ? ` | ${e.mutators.join(" | ")}` : "", r = f(e.value);
+    return `${e.field}${t} ${e.operator} ${r}`;
   }
-  return e.type === "NOT" && ((r = e.children) == null ? void 0 : r.length) === 1 ? `NOT (${g(e.children[0])})` : e.type === "group" && ((i = e.children) == null ? void 0 : i.length) === 1 ? `(${g(e.children[0])})` : (e.type === "AND" || e.type === "OR") && e.children ? e.children.map(g).join(` ${e.type} `) : "";
+  return e.type === "NOT" && e.children?.length === 1 ? `NOT (${h(e.children[0])})` : e.type === "group" && e.children?.length === 1 ? `(${h(e.children[0])})` : (e.type === "AND" || e.type === "OR") && e.children ? e.children.map(h).join(` ${e.type} `) : "";
 }
-function m(e) {
-  return e === null ? "null" : e === void 0 ? "" : typeof e == "string" ? `"${e}"` : Array.isArray(e) ? `[${e.map(m).join(", ")}]` : String(e);
+function f(e) {
+  return e === null ? "null" : e === void 0 ? "" : typeof e == "string" ? `"${e}"` : Array.isArray(e) ? `[${e.map(f).join(", ")}]` : String(e);
 }
-function L(e, t = "") {
+function N(e, t = "") {
   if (!e)
     return "(empty)";
   const r = [];
-  return o(e, r, "", !0), r.join(`
+  return l(e, r, "", !0), r.join(`
 `);
 }
-function o(e, t, r, i) {
-  var a, c, l;
+function l(e, t, r, i) {
   const n = i ? "└── " : "├── ", s = i ? "    " : "│   ";
   if (e.type === "comparison") {
-    const h = (a = e.mutators) != null && a.length ? ` | ${e.mutators.join(" | ")}` : "", f = m(e.value);
-    t.push(`${r}${n}${e.field}${h} ${e.operator} ${f}`);
-  } else e.type === "NOT" ? (t.push(`${r}${n}NOT`), (c = e.children) != null && c.length && o(e.children[0], t, r + s, !0)) : e.type === "group" ? (t.push(`${r}${n}GROUP`), (l = e.children) != null && l.length && o(e.children[0], t, r + s, !0)) : e.children && (t.push(`${r}${n}${e.type}`), e.children.forEach((h, f) => {
-    const d = f === e.children.length - 1;
-    o(h, t, r + s, d);
+    const a = e.mutators?.length ? ` | ${e.mutators.join(" | ")}` : "", c = f(e.value);
+    t.push(`${r}${n}${e.field}${a} ${e.operator} ${c}`);
+  } else e.type === "NOT" ? (t.push(`${r}${n}NOT`), e.children?.length && l(e.children[0], t, r + s, !0)) : e.type === "group" ? (t.push(`${r}${n}GROUP`), e.children?.length && l(e.children[0], t, r + s, !0)) : e.children && (t.push(`${r}${n}${e.type}`), e.children.forEach((a, c) => {
+    const o = c === e.children.length - 1;
+    l(a, t, r + s, o);
   }));
 }
-function w(e) {
-  return e ? e.type === "comparison" ? [e] : e.children ? e.children.flatMap(w) : [] : [];
+function d(e) {
+  return e ? e.type === "comparison" ? [e] : e.children ? e.children.flatMap(d) : [] : [];
 }
-function T(e) {
+function y(e) {
   if (!e)
     return 0;
   if (!e.children || e.children.length === 0)
     return 1;
-  const t = e.children.map(T);
+  const t = e.children.map(y);
   return 1 + Math.max(...t);
 }
 export {
   u as SemanticPreview,
-  w as flattenLogicTree,
-  L as formatLogicTreeAscii,
-  g as formatLogicTreeNode,
-  b as generatePreview,
-  F as getFieldUsage,
-  N as getLogicTree,
-  T as getLogicTreeDepth,
-  U as getOperatorSummary,
-  P as getUniqueFields
+  d as flattenLogicTree,
+  N as formatLogicTreeAscii,
+  h as formatLogicTreeNode,
+  T as generatePreview,
+  v as getFieldUsage,
+  $ as getLogicTree,
+  y as getLogicTreeDepth,
+  F as getOperatorSummary,
+  b as getUniqueFields
 };

package/dist/src/tokenizer.d.ts

@@ -1,5 +1,4 @@
 import { TqlAggregationFunction, TqlCollectionOperator, TqlComparisonOperator, TqlLogicalOperator, TqlMutator, TqlToken, TqlTypeHint, TqlVisualizationType } from './types';
-
 /**
  * All comparison operators supported by TQL.
  * Includes negated variants using both `not_` prefix and `!` prefix.
@@ -20,20 +19,6 @@ 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,109 +1,4 @@
-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)
-// Synced with Python TQL ALLOWED_MUTATORS definition
-const MUTATOR_PARAMETERS = {
-  // String transformation mutators
-  lowercase: [
-    { name: "field", type: "string", description: "Field name to save the lowercase result. Default: transforms value in-place for comparison only (not persisted)" }
-  ],
-  uppercase: [
-    { name: "field", type: "string", description: "Field name to save the uppercase result. Default: transforms value in-place for comparison only (not persisted)" }
-  ],
-  trim: [
-    { name: "field", type: "string", description: "Field name to save the trimmed result. Default: transforms value in-place for comparison only (not persisted)" }
-  ],
-  split: [
-    { name: "delimiter", type: "string", description: "Character(s) to split on. Default: comma (',')" },
-    { name: "field", type: "string", description: "Field name to save array result. Default: returns array for comparison only (not persisted)" }
-  ],
-  length: [
-    { name: "field", type: "string", description: "Field name to save the length. Default: returns length for comparison only (not persisted)" }
-  ],
-  replace: [
-    { name: "find", type: "string", description: "Text to search for (required)" },
-    { name: "replace", type: "string", description: "Text to replace with (required)" },
-    { name: "field", type: "string", description: "Field name to save result. Default: returns replaced string for comparison only (not persisted)" }
-  ],
-  // Security mutators
-  refang: [
-    { name: "field", type: "string", description: "Field name to save the refanged result. Default: returns refanged value for comparison only" }
-  ],
-  defang: [
-    { name: "field", type: "string", description: "Field name to save the defanged result. Default: returns defanged value for comparison only" }
-  ],
-  // Encoding mutators
-  b64encode: [
-    { name: "field", type: "string", description: "Field name to save encoded result. Default: returns encoded value for comparison only" }
-  ],
-  b64decode: [
-    { name: "field", type: "string", description: "Field name to save decoded result. Default: returns decoded value for comparison only" }
-  ],
-  urldecode: [
-    { name: "field", type: "string", description: "Field name to save decoded result. Default: returns decoded value for comparison only" }
-  ],
-  hexencode: [
-    { name: "field", type: "string", description: "Field name to save hex-encoded result. Default: returns encoded value for comparison only" }
-  ],
-  hexdecode: [
-    { name: "field", type: "string", description: "Field name to save hex-decoded result. Default: returns decoded value for comparison only" }
-  ],
-  md5: [
-    { name: "field", type: "string", description: "Field name to save the MD5 hash. Default: returns hash for comparison only" }
-  ],
-  sha256: [
-    { name: "field", type: "string", description: "Field name to save the SHA256 hash. Default: returns hash for comparison only" }
-  ],
-  // Network mutators - no parameters, return boolean
-  is_private: [],  // Returns boolean indicating if IP is in RFC1918 private ranges
-  is_global: [],   // Returns boolean indicating if IP is globally routable
-  // DNS mutator
-  nslookup: [
-    { name: "servers", type: "array", description: "DNS servers to query. Default: system DNS servers" },
-    { name: "types", type: "array", description: "DNS record types to query (A, AAAA, MX, TXT, etc.). Default: ['A']" },
-    { name: "append_field", type: "string", description: "Field name to append results to" },
-    { name: "force", type: "boolean", description: "Force lookup even if DNS data already exists. Default: false" },
-    { name: "save", type: "boolean", description: "Save results to the record. Default: true" },
-    { name: "field", type: "string", description: "Field name to save results to. Default: appends .dns to source field" }
-  ],
-  // GeoIP mutators
-  geo: [
-    { name: "db_path", type: "string", description: "Path to MaxMind GeoIP database. Default: uses system-configured path" },
-    { name: "force", type: "boolean", description: "Force lookup even if geo data exists. Default: false (skips if data exists)" },
-    { name: "save", type: "boolean", description: "Save enrichment to the record. Default: true" },
-    { name: "field", type: "string", description: "Field name prefix for geo data. Default: appends .geo to source field" },
-    { name: "cache", type: "boolean", description: "Enable caching of lookup results. Default: true" },
-    { name: "cache_ttl", type: "number", description: "Cache TTL in seconds. Default: 3600 (1 hour)" }
-  ],
-  geoip: [
-    { name: "db_path", type: "string", description: "Path to MaxMind GeoIP database. Default: uses system-configured path" },
-    { name: "force", type: "boolean", description: "Force lookup even if geo data exists. Default: false (skips if data exists)" },
-    { name: "save", type: "boolean", description: "Save enrichment to the record. Default: true" },
-    { name: "field", type: "string", description: "Field name prefix for geo data. Default: appends .geo to source field" },
-    { name: "cache", type: "boolean", description: "Enable caching of lookup results. Default: true" },
-    { name: "cache_ttl", type: "number", description: "Cache TTL in seconds. Default: 3600 (1 hour)" }
-  ],
-  geoip_lookup: [
-    { name: "db_path", type: "string", description: "Path to MaxMind GeoIP database. Default: uses system-configured path" },
-    { name: "force", type: "boolean", description: "Force lookup even if geo data exists. Default: false (skips if data exists)" },
-    { name: "save", type: "boolean", description: "Save enrichment to the record. Default: true" },
-    { name: "field", type: "string", description: "Field name prefix for geo data. Default: appends .geo to source field" },
-    { name: "cache", type: "boolean", description: "Enable caching of lookup results. Default: true" },
-    { name: "cache_ttl", type: "number", description: "Cache TTL in seconds. Default: 3600 (1 hour)" }
-  ]
-};
-const p = [
+const c = [
   // Equality
   "eq",
   "ne",
@@ -144,7 +39,7 @@ const p = [
   "not_any",
   "not_all",
   "not_none"
-], c = {
+], h = {
   "==": "eq",
   "=": "eq",
   "!=": "ne",
@@ -152,7 +47,7 @@ const p = [
   ">=": "gte",
   "<": "lt",
   "<=": "lte"
-}, d = {
+}, l = {
   "!in": "not_in",
   "!contains": "not_contains",
   "!startswith": "not_startswith",
@@ -166,7 +61,7 @@ const p = [
   "!any": "not_any",
   "!all": "not_all",
   "!none": "not_none"
-}, k = ["AND", "OR", "NOT"], f = ["ANY", "ALL", "NONE"], m = [
+}, u = ["AND", "OR", "NOT"], p = ["ANY", "ALL", "NONE"], d = [
   // String mutators
   "lowercase",
   "uppercase",
@@ -201,7 +96,7 @@ const p = [
   "sum",
   "min",
   "max"
-], _ = [
+], k = [
   // Counting
   "count",
   "unique_count",
@@ -230,7 +125,7 @@ const p = [
   "values",
   "unique",
   "distinct"
-], g = [
+], f = [
   "string",
   "str",
   "number",
@@ -245,10 +140,8 @@ const p = [
   "array",
   "list",
   "object",
-  "geo",
-  "geo_point",
-  "ip"
-], T = [
+  "geo"
+], m = [
   "bar",
   "barchart",
   "line",
@@ -268,14 +161,14 @@ const p = [
   "nested_pie",
   "nested_donut",
   "chord"
-], w = ["by", "as", "null", "true", "false", "stats", "top", "bottom"];
-class b {
+], _ = ["by", "as", "null", "true", "false", "stats", "top", "bottom"];
+class g {
+  input;
+  position;
+  line;
+  column;
+  tokens;
   constructor(e) {
-    a(this, "input");
-    a(this, "position");
-    a(this, "line");
-    a(this, "column");
-    a(this, "tokens");
     this.input = e, this.position = 0, this.line = 1, this.column = 1, this.tokens = [];
   }
   /**
@@ -330,8 +223,8 @@ class b {
     for (; !this.isAtEnd() && this.peek() !== e; )
       if (this.peek() === "\\") {
         if (this.advance(), !this.isAtEnd()) {
-          const h = this.advance();
-          switch (h) {
+          const a = this.advance();
+          switch (a) {
             case "n":
               s += `
 `;
@@ -352,7 +245,7 @@ class b {
               s += "'";
               break;
             default:
-              s += h;
+              s += a;
           }
         }
       } else
@@ -401,7 +294,7 @@ class b {
       const s = t + this.peek();
       if (s === "=>")
         return this.advance(), this.makeToken("arrow", "=>", e, n, i);
-      (s in c || s === "==" || s === "!=") && (t = s, this.advance());
+      (s in h || s === "==" || s === "!=") && (t = s, this.advance());
     }
     if (t === "!") {
       const s = this.position;
@@ -409,12 +302,12 @@ class b {
       for (; !this.isAtEnd() && this.isIdentifierChar(this.peek()); )
         r += this.advance();
       if (r) {
-        if ("!" + r in d)
+        if ("!" + r in l)
           return this.makeToken("operator", "!" + r, e, n, i);
         this.position = s, this.column = i + 1;
       }
     }
-    return t in c || t === "==" || t === "=" || t === "!=" || t === ">" || t === ">=" || t === "<" || t === "<=" ? this.makeToken("operator", t, e, n, i) : this.makeToken("unknown", t, e, n, i);
+    return t in h || t === "==" || t === "=" || t === "!=" || t === ">" || t === ">=" || t === "<" || t === "<=" ? this.makeToken("operator", t, e, n, i) : this.makeToken("unknown", t, e, n, i);
   }
   /**
    * Scan an identifier (field name, operator keyword, etc.)
@@ -432,7 +325,7 @@ class b {
    */
   classifyIdentifier(e) {
     const n = e.toUpperCase(), i = e.toLowerCase();
-    return k.includes(n) ? "logicalOp" : f.includes(n) ? "collectionOp" : i === "true" || i === "false" ? "boolean" : i === "null" ? "null" : i === "stats" ? "keyword" : p.includes(i) ? "operator" : _.includes(i) ? "aggregation" : m.includes(i) ? "mutator" : g.includes(i) ? "typeHint" : T.includes(i) ? "visualization" : w.includes(i) ? "keyword" : "field";
+    return u.includes(n) ? "logicalOp" : p.includes(n) ? "collectionOp" : i === "true" || i === "false" ? "boolean" : i === "null" ? "null" : i === "stats" ? "keyword" : c.includes(i) ? "operator" : k.includes(i) ? "aggregation" : d.includes(i) ? "mutator" : f.includes(i) ? "typeHint" : m.includes(i) ? "visualization" : _.includes(i) ? "keyword" : "field";
   }
   // ============================================================================
   // Helper Methods
@@ -479,22 +372,22 @@ class b {
     return e === "=" || e === "!" || e === ">" || e === "<";
   }
 }
-function v(o) {
-  return new b(o).tokenize();
+function T(o) {
+  return new g(o).tokenize();
 }
-function A(o) {
-  return v(o).filter((e) => e.type !== "whitespace");
+function w(o) {
+  return T(o).filter((e) => e.type !== "whitespace");
 }
-function E(o, e) {
+function b(o, e) {
   for (const n of o)
     if (e >= n.start && e < n.end)
       return n;
   return null;
 }
-function S(o, e, n) {
+function v(o, e, n) {
   return o.filter((i) => i.start < n && i.end > e);
 }
-function I(o, e) {
+function O(o, e) {
   let n = null;
   for (const i of o)
     if (i.end <= e)
@@ -503,7 +396,7 @@ function I(o, e) {
       break;
   return n;
 }
-function y(o, e, n = !0) {
+function A(o, e, n = !0) {
   const i = n ? o.filter((s) => s.type !== "whitespace") : o;
   let t = null;
   for (const s of i)
@@ -514,23 +407,21 @@ function y(o, e, n = !0) {
   return t;
 }
 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,
-  b as TqlTokenizer,
-  T as VISUALIZATION_TYPES,
-  y as findPreviousToken,
-  E as findTokenAtPosition,
-  I as findTokenBefore,
-  S as findTokensInRange,
-  v as tokenizeTql,
-  A as tokenizeTqlNoWhitespace
+  k as AGGREGATION_FUNCTIONS,
+  p as COLLECTION_OPERATORS,
+  c as COMPARISON_OPERATORS,
+  _ as KEYWORDS,
+  u as LOGICAL_OPERATORS,
+  d as MUTATORS,
+  l as NEGATION_SYMBOL_OPERATORS,
+  h as SYMBOL_OPERATORS,
+  f as TYPE_HINTS,
+  g as TqlTokenizer,
+  m as VISUALIZATION_TYPES,
+  A as findPreviousToken,
+  b as findTokenAtPosition,
+  O as findTokenBefore,
+  v as findTokensInRange,
+  T as tokenizeTql,
+  w as tokenizeTqlNoWhitespace
 };

package/dist/src/types.d.ts

@@ -236,6 +236,14 @@ export interface TqlInputEmits {
     (e: "parse", result: TqlParseResult): void;
     (e: "submit", value: string): void;
 }
+/**
+ * Reactive reference type for Vue computed properties.
+ * This is a simplified type that matches Vue's ComputedRef interface
+ * without requiring Vue as a direct dependency.
+ */
+export interface ReactiveRef<T> {
+    readonly value: T;
+}
 export interface TqlInputExpose {
     focus(): void;
     blur(): void;
@@ -245,6 +253,12 @@ export interface TqlInputExpose {
     getTokenAtPosition(pos: number): TqlToken | null;
     getCursorPosition(): number;
     setCursorPosition(pos: number): void;
+    /** Whether the current query is valid (no syntax errors). Access via .value */
+    isValid: ReactiveRef<boolean>;
+    /** Whether the current query has validation errors. Access via .value */
+    hasErrors: ReactiveRef<boolean>;
+    /** Array of current validation errors. Access via .value */
+    errors: ReactiveRef<TqlParseError[]>;
 }
 export type ComplexityScore = "low" | "medium" | "high";
 export interface ComplexityWarning {

package/dist/src/validator.d.ts

@@ -1,5 +1,4 @@
 import { TqlParseError, TqlParseWarning, TqlValidationOptions, TqlValidationResult } from './types';
-
 export declare class TqlValidator {
     private options;
     private errors;