@xano/xanoscript-language-server 12.5.0 → 12.6.1

package/lexer/datadog.js

@@ -0,0 +1,57 @@
+import { DebugLogToken } from "./debug.js";
+import { Identifier } from "./identifier.js";
+import { createTokenByName } from "./utils.js";
+
+// datadog
+export const DatadogToken = createTokenByName("datadog", {
+  longer_alt: Identifier,
+  categories: [Identifier],
+});
+
+// datadog.log reuses the existing "log" token from debug
+export { DebugLogToken as DatadogLogToken };
+
+// datadog.log_bulk
+export const DatadogLogBulkToken = createTokenByName("log_bulk", {
+  longer_alt: Identifier,
+  categories: [Identifier],
+});
+
+// datadog.metric
+export const DatadogMetricToken = createTokenByName("metric", {
+  longer_alt: Identifier,
+  categories: [Identifier],
+});
+
+// datadog.metric_bulk
+export const DatadogMetricBulkToken = createTokenByName("metric_bulk", {
+  longer_alt: Identifier,
+  categories: [Identifier],
+});
+
+// Order matters: longer patterns must come before shorter prefixes
+// (e.g. metric_bulk before metric) so the lexer matches them correctly.
+// Note: `log_bulk` ordering vs the reused `log` token depends on
+// DatadogTokens being registered before DebugTokens in lexer/tokens.js.
+export const DatadogTokens = [
+  DatadogToken,
+  DatadogLogBulkToken,
+  DatadogMetricBulkToken,
+  DatadogMetricToken,
+];
+
+/**
+ * Maps a token name to a type
+ * @param {string} token the token name
+ */
+export function mapTokenToType(token) {
+  switch (token) {
+    case DatadogToken.name:
+    case DatadogLogBulkToken.name:
+    case DatadogMetricToken.name:
+    case DatadogMetricBulkToken.name:
+      return "function";
+    default:
+      return null;
+  }
+}

package/lexer/tokens.js

@@ -52,6 +52,10 @@ import {
   ControlTokens,
   mapTokenToType as mapControlsTokenToType,
 } from "./control.js";
+import {
+  DatadogTokens,
+  mapTokenToType as mapDatadogTokenToType,
+} from "./datadog.js";
 import { DbTokens, mapTokenToType as mapDbTokenToType } from "./db.js";
 import { DebugTokens, mapTokenToType as mapDebugTokenToType } from "./debug.js";
 import {
@@ -417,6 +421,7 @@ export const allTokens = uniq([
   ...RunTokens,
   ...ObjectTokens,
   ...StreamTokens,
+  ...DatadogTokens,
   ...DebugTokens,
   ...ExpectFnTokens,
   ...VarTokens,
@@ -449,6 +454,7 @@ const tokenMappers = [
   mapColumnTokenToType,
   mapCommentTokenToType,
   mapControlsTokenToType,
+  mapDatadogTokenToType,
   mapDbTokenToType,
   mapDebugTokenToType,
   mapErrorTriggerTokenToType,

package/onHover/filters.md

@@ -2831,6 +2831,119 @@ Reduces the array to a single value using the code block to combine each element
 
 Result: `25`
 
+# lambda_map
+
+Like `map`, but the transform is written as a string of JS/TS code instead of an inline XanoScript expression. An optional final argument sets a timeout (in seconds).
+
+```xs
+[1,2,3]|lambda_map:"return $this * 2":10
+```
+
+Result: `[2,4,6]`
+
+Context variables:
+
+- `$this` - the element of the array being processed.
+- `$index` - the numerical index of the element of the array being processed.
+- `$parent` - the entire array with all of its elements.
+
+# lambda_filter
+
+Like `filter`, but the predicate is written as a string of JS/TS code. Return a truthy value to keep the element. An optional final argument sets a timeout (in seconds).
+
+```xs
+[1,2,3,4]|lambda_filter:"return $this % 2":10
+```
+
+Result: `[1,3]`
+
+Context variables:
+
+- `$this` - the element of the array being processed.
+- `$index` - the numerical index of the element of the array being processed.
+- `$parent` - the entire array with all of its elements.
+
+# lambda_some
+
+Like `some`, but the predicate is written as a string of JS/TS code. An optional final argument sets a timeout (in seconds).
+
+```xs
+[1,2,3]|lambda_some:"return $this > 2":10
+```
+
+Result: `true`
+
+Context variables:
+
+- `$this` - the element of the array being processed.
+- `$index` - the numerical index of the element of the array being processed.
+- `$parent` - the entire array with all of its elements.
+
+# lambda_every
+
+Like `every`, but the predicate is written as a string of JS/TS code. An optional final argument sets a timeout (in seconds).
+
+```xs
+[2,4,6]|lambda_every:"return $this % 2 === 0":10
+```
+
+Result: `true`
+
+Context variables:
+
+- `$this` - the element of the array being processed.
+- `$index` - the numerical index of the element of the array being processed.
+- `$parent` - the entire array with all of its elements.
+
+# lambda_find
+
+Like `find`, but the predicate is written as a string of JS/TS code. An optional final argument sets a timeout (in seconds).
+
+```xs
+[1,2,3,8,9]|lambda_find:"return $this === 8":10
+```
+
+Result: `8`
+
+Context variables:
+
+- `$this` - the element of the array being processed.
+- `$index` - the numerical index of the element of the array being processed.
+- `$parent` - the entire array with all of its elements.
+
+# lambda_findIndex
+
+Like `findIndex`, but the predicate is written as a string of JS/TS code. An optional final argument sets a timeout (in seconds).
+
+```xs
+[1,2,3,8,9]|lambda_findIndex:"return $this === 8":10
+```
+
+Result: `3`
+
+Context variables:
+
+- `$this` - the element of the array being processed.
+- `$index` - the numerical index of the element of the array being processed.
+- `$parent` - the entire array with all of its elements.
+
+# lambda_reduce
+
+Like `reduce`, but the reducer is written as a string of JS/TS code. Takes an initial value before the code block, and an optional final argument that sets a timeout (in seconds).
+
+```xs
+[1,2,3,4,5]|lambda_reduce:[]:"return [...$result, $this + 1];":10
+```
+
+Result: `[2,3,4,5,6]`
+
+Context variables:
+
+- `$this` - the element of the array being processed.
+- `$index` - the numerical index of the element of the array being processed.
+- `$parent` - the entire array with all of its elements.
+- `$result` - the result of the previous iteration, or the initial value on the first iteration.
+
 # pick
 
 Pick keys from the object to create a new object of just those keys.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xano/xanoscript-language-server",
-  "version": "12.5.0",
+  "version": "12.6.1",
   "description": "Language Server Protocol implementation for XanoScript",
   "type": "module",
   "main": "server.js",

package/parser/clauses/nakedStackFn.js

@@ -44,6 +44,7 @@ export function nakedStackFn($) {
               { ALT: () => $.SUBRULE($.redisFn) },
               { ALT: () => $.SUBRULE($.controlFn, { ARGS: [options] }) },
               { ALT: () => $.SUBRULE($.debugFn) },
+              { ALT: () => $.SUBRULE($.datadogFn) },
               { ALT: () => $.SUBRULE($.storageFn) },
               { ALT: () => $.SUBRULE($.streamFn) },
               { ALT: () => $.SUBRULE($.actionCallFn) },

package/parser/functions/datadog/datadogLogBulkFn.js

@@ -0,0 +1,21 @@
+import { DatadogLogBulkToken } from "../../../lexer/datadog.js";
+
+/**
+ * datadog.log_bulk {
+ *   entries = $entries
+ * }
+ * @param {import('../../base_parser.js').XanoBaseParser} $
+ */
+export function datadogLogBulkFn($) {
+  const requiredAttrs = ["entries"];
+  const optionalAttrs = ["description", "disabled"];
+
+  return () => {
+    $.sectionStack.push("datadogLogBulk");
+    const tokenFn = $.CONSUME(DatadogLogBulkToken); // log_bulk
+    $.SUBRULE($.functionAttrReq, {
+      ARGS: [tokenFn, requiredAttrs, optionalAttrs],
+    });
+    $.sectionStack.pop();
+  };
+}

package/parser/functions/datadog/datadogLogFn.js

@@ -0,0 +1,36 @@
+import { DatadogLogToken } from "../../../lexer/datadog.js";
+
+/**
+ * datadog.log {
+ *   message    = "hi"
+ *   status     = "info"
+ *   attributes = '{"A":"B"}'|json_decode
+ * }
+ * @param {import('../../base_parser.js').XanoBaseParser} $
+ */
+export function datadogLogFn($) {
+  const requiredAttrs = ["message"];
+  const optionalAttrs = [
+    "status",
+    "attributes",
+    "service",
+    "source",
+    "env",
+    "hostname",
+    "ddtags",
+    "tags",
+    "timestamp",
+    "connection",
+    "description",
+    "disabled",
+  ];
+
+  return () => {
+    $.sectionStack.push("datadogLog");
+    const tokenFn = $.CONSUME(DatadogLogToken); // log
+    $.SUBRULE($.functionAttrReq, {
+      ARGS: [tokenFn, requiredAttrs, optionalAttrs],
+    });
+    $.sectionStack.pop();
+  };
+}

package/parser/functions/datadog/datadogMetricBulkFn.js

@@ -0,0 +1,21 @@
+import { DatadogMetricBulkToken } from "../../../lexer/datadog.js";
+
+/**
+ * datadog.metric_bulk {
+ *   entries = $entries
+ * }
+ * @param {import('../../base_parser.js').XanoBaseParser} $
+ */
+export function datadogMetricBulkFn($) {
+  const requiredAttrs = ["entries"];
+  const optionalAttrs = ["description", "disabled"];
+
+  return () => {
+    $.sectionStack.push("datadogMetricBulk");
+    const tokenFn = $.CONSUME(DatadogMetricBulkToken); // metric_bulk
+    $.SUBRULE($.functionAttrReq, {
+      ARGS: [tokenFn, requiredAttrs, optionalAttrs],
+    });
+    $.sectionStack.pop();
+  };
+}

package/parser/functions/datadog/datadogMetricFn.js

@@ -0,0 +1,36 @@
+import { DatadogMetricToken } from "../../../lexer/datadog.js";
+
+/**
+ * datadog.metric {
+ *   metric = "requests.count"
+ *   value  = 1
+ *   type   = "count"
+ *   tags   = '{"env":"prod"}'|json_decode
+ * }
+ * @param {import('../../base_parser.js').XanoBaseParser} $
+ */
+export function datadogMetricFn($) {
+  const requiredAttrs = ["metric", "value"];
+  const optionalAttrs = [
+    "type",
+    "tags",
+    "service",
+    "source",
+    "env",
+    "hostname",
+    "ddtags",
+    "timestamp",
+    "connection",
+    "description",
+    "disabled",
+  ];
+
+  return () => {
+    $.sectionStack.push("datadogMetric");
+    const tokenFn = $.CONSUME(DatadogMetricToken); // metric
+    $.SUBRULE($.functionAttrReq, {
+      ARGS: [tokenFn, requiredAttrs, optionalAttrs],
+    });
+    $.sectionStack.pop();
+  };
+}

package/parser/functions/datadog/register.js

@@ -0,0 +1,18 @@
+import { datadogLogBulkFn } from "./datadogLogBulkFn.js";
+import { datadogLogFn } from "./datadogLogFn.js";
+import { datadogMetricBulkFn } from "./datadogMetricBulkFn.js";
+import { datadogMetricFn } from "./datadogMetricFn.js";
+
+/**
+ * Registers all the parsers in this folder
+ * @param {import('../base_parser.js').XanoBaseParser} $
+ */
+export const register = ($) => {
+  $.datadogLogFn = $.RULE("datadogLogFn", datadogLogFn($));
+  $.datadogLogBulkFn = $.RULE("datadogLogBulkFn", datadogLogBulkFn($));
+  $.datadogMetricFn = $.RULE("datadogMetricFn", datadogMetricFn($));
+  $.datadogMetricBulkFn = $.RULE(
+    "datadogMetricBulkFn",
+    datadogMetricBulkFn($)
+  );
+};

package/parser/functions/datadogFn.js

@@ -0,0 +1,20 @@
+import { DatadogToken } from "../../lexer/datadog.js";
+import { DotToken } from "../../lexer/tokens.js";
+
+/**
+ * @param {import('../base_parser.js').XanoBaseParser} $
+ */
+export function datadogFn($) {
+  return () => {
+    $.sectionStack.push("datadog");
+    $.CONSUME(DatadogToken); // "datadog"
+    $.CONSUME(DotToken); // "."
+    $.OR([
+      { ALT: () => $.SUBRULE($.datadogLogBulkFn) }, // datadog.log_bulk
+      { ALT: () => $.SUBRULE($.datadogLogFn) }, // datadog.log
+      { ALT: () => $.SUBRULE($.datadogMetricBulkFn) }, // datadog.metric_bulk
+      { ALT: () => $.SUBRULE($.datadogMetricFn) }, // datadog.metric
+    ]);
+    $.sectionStack.pop();
+  };
+}

package/parser/functions/register.js

@@ -10,6 +10,8 @@ import { register as register_cloud } from "./cloud/register.js";
 import { cloudFn } from "./cloudFn.js";
 import { controlFn } from "./controlFn.js";
 import { register as register_controls } from "./controls/register.js";
+import { register as register_datadog } from "./datadog/register.js";
+import { datadogFn } from "./datadogFn.js";
 import { register as register_db } from "./db/register.js";
 import { dbFn } from "./dbFn.js";
 import { register as register_debug } from "./debug/register.js";
@@ -56,6 +58,7 @@ export const register = ($) => {
   $.arrayFn = $.RULE("arrayFn", arrayFn($));
   $.cloudFn = $.RULE("cloudFn", cloudFn($));
   $.controlFn = $.RULE("controlFn", controlFn($));
+  $.datadogFn = $.RULE("datadogFn", datadogFn($));
   $.dbFn = $.RULE("dbFn", dbFn($));
   $.debugFn = $.RULE("debugFn", debugFn($));
   $.mathFn = $.RULE("mathFn", mathFn($));
@@ -78,6 +81,7 @@ export const register = ($) => {
   register_array($);
   register_cloud($);
   register_controls($);
+  register_datadog($);
   register_db($);
   register_debug($);
   register_math($);

package/parser/generic/chainedIdentifier.js

@@ -14,6 +14,12 @@ export function chainedIdentifier($) {
   };
 }
 
+/**
+ * `$` prefixed properties that are allowed without a warning, e.g.
+ * `$my_var.$search` or `$my_var.$this`.
+ */
+const ALLOWED_DOLLAR_PROPERTIES = new Set(["$search", "$this"]);
+
 /**
  * to be used after a variable to reference a single property depth
  * like foo.bar , foo[1] or foo["key"]
@@ -30,10 +36,12 @@ export function singleChainedIdentifier($) {
             {
               ALT: () => {
                 const token = $.CONSUME(ShortFormVariable);
-                $.addWarning(
-                  `Using \`$\` prefixed properties '${token.image}' is discouraged.`,
-                  token
-                );
+                if (!ALLOWED_DOLLAR_PROPERTIES.has(token.image)) {
+                  $.addWarning(
+                    `Using \`$\` prefixed properties '${token.image}' is discouraged.`,
+                    token
+                  );
+                }
               },
             }, // e.g., .bar
             { ALT: () => $.CONSUME(Identifier) }, // e.g., .bar

package/parser/generic/filterNames.js

@@ -279,6 +279,17 @@ export const filterNames = [
   "find",
   "findIndex",
   "reduce",
+  // Lambda variants of the array filters above. Instead of an inline XanoScript
+  // expression, they take a string of JS/TS code, e.g.
+  //   $set|lambda_map:"return $this * 2"
+  //   $set|lambda_reduce:[]:"return [...$result, $this + 1];":10
+  "lambda_map",
+  "lambda_filter",
+  "lambda_some",
+  "lambda_every",
+  "lambda_find",
+  "lambda_findIndex",
+  "lambda_reduce",
   "pick",
   "unpick",
   "text_unescape",