@xano/xanoscript-language-server 12.1.0 → 12.3.0

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/error_trigger.js

@@ -0,0 +1,23 @@
+import { Identifier } from "./identifier.js";
+import { createTokenByName } from "./utils.js";
+
+// "error_trigger"
+export const ErrorTriggerToken = createTokenByName("error_trigger", {
+  longer_alt: Identifier,
+  categories: [Identifier], // could also be an identifier
+});
+
+export const ErrorTriggerTokens = [ErrorTriggerToken];
+
+/**
+ * Maps a token name to a type
+ * @param {string} token the token name
+ */
+export function mapTokenToType(token) {
+  switch (token) {
+    case ErrorTriggerToken.name:
+      return "keyword";
+    default:
+      return null;
+  }
+}

package/lexer/tokens.js

@@ -52,8 +52,16 @@ 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 {
+  ErrorTriggerTokens,
+  mapTokenToType as mapErrorTriggerTokenToType,
+} from "./error_trigger.js";
 import {
   ExpectFnTokens,
   mapTokenToType as mapExpectTokenToType,
@@ -399,6 +407,7 @@ export const allTokens = uniq([
   ...UtilTokens,
   ...TableTriggerTokens,
   ...WorkspaceTriggerTokens,
+  ...ErrorTriggerTokens,
   ...TaskTokens,
   ...WorkflowTestTokens,
   ...ApiGroupTokens,
@@ -412,6 +421,7 @@ export const allTokens = uniq([
   ...RunTokens,
   ...ObjectTokens,
   ...StreamTokens,
+  ...DatadogTokens,
   ...DebugTokens,
   ...ExpectFnTokens,
   ...VarTokens,
@@ -444,8 +454,10 @@ const tokenMappers = [
   mapColumnTokenToType,
   mapCommentTokenToType,
   mapControlsTokenToType,
+  mapDatadogTokenToType,
   mapDbTokenToType,
   mapDebugTokenToType,
+  mapErrorTriggerTokenToType,
   mapExpectTokenToType,
   mapFunctionTokenToType,
   mapLiteralTokenToType,

package/onHover/functions.md

@@ -287,6 +287,52 @@ A `task` file defines a scheduled job that runs automatically at specified times
 
 Tasks are ideal for automating recurring operations like generating reports or syncing data.
 
+# error_trigger
+
+```xs
+error_trigger "notify on errors" {
+  input {
+    enum event? {
+      values = ["new", "regression", "fixed"]
+    }
+    int id?
+    text signature?
+    object error? {
+      schema {
+        text code?
+        text message?
+      }
+    }
+  }
+
+  stack {
+    api.request {
+      url = "https://hooks.example.com/alerts"
+      method = "POST"
+      params = {
+        event  : $input.event
+        message: $input.error.message
+      }
+    } as $api1
+  }
+}
+```
+
+An `error_trigger` file defines the workspace's error-notification handler, fired when error signatures are first captured, regress, or are marked fixed. Only one `error_trigger` exists per workspace. It includes:
+
+- A name (e.g., `"notify on errors"` or `trigger_on_error`) to identify the trigger,
+
+- An `input` block describing the payload the runtime delivers, including:
+  - `event`: which event fired the trigger — `"new"` (first capture or re-capture after the ~5 minute snapshot dedup window), `"regression"` (a previously-fixed signature re-occurred), or `"fixed"` (a user marked the signature as fixed),
+  - `signature`, `id`: stable identifiers for the error,
+  - `error`: the captured error `code` and `message`,
+  - `caller`, `statement`: where the error originated (null on `"fixed"` events),
+  - `actor`: the user who marked it fixed (only on `"fixed"` events),
+  - `count`, `first_seen`, `last_seen`, `fixed_at`: occurrence metadata.
+- A `stack` block defining the actions to take — typically calling out to a webhook, sending an email, or otherwise notifying the team.
+
+Use an `error_trigger` to wire workspace-wide alerting on top of the error-logs system without subscribing per object or per event source.
+
 # run.job
 
 ```xs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xano/xanoscript-language-server",
-  "version": "12.1.0",
+  "version": "12.3.0",
   "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/definitions/objectColumnDefinition.js

@@ -26,12 +26,12 @@ export function objectColumnDefinition($) {
       // object[]
       iterable = true;
       $.SUBRULE($.arraySlice);
+    });
 
-      // object[]? (nullable array)
-      $.OPTION3(() => {
-        nullable = true;
-        $.CONSUME(Question);
-      });
+    // object? (nullable) or object[]? (nullable array)
+    $.OPTION3(() => {
+      nullable = true;
+      $.CONSUME(Question);
     });
 
     // Column name (e.g., "user_id", "optional_column", "required_column")

package/parser/error_trigger_parser.js

@@ -0,0 +1,88 @@
+import { LCurly, RCurly } from "../lexer/control.js";
+import { ErrorTriggerToken } from "../lexer/error_trigger.js";
+import { StringLiteral } from "../lexer/literal.js";
+import { Identifier, NewlineToken } from "../lexer/tokens.js";
+
+export function errorTriggerDeclaration($) {
+  return () => {
+    let hasDescription = false;
+    let hasGuid = false;
+    let hasHistory = false;
+    let hasInput = false;
+    let hasStack = false;
+    let hasTags = false;
+
+    $.sectionStack.push("errorTriggerDeclaration");
+    // Allow leading comments and newlines before the error_trigger declaration
+    $.SUBRULE($.optionalCommentBlockFn);
+
+    const parent = $.CONSUME(ErrorTriggerToken); // error_trigger
+    const nameToken = $.OR([
+      { ALT: () => $.CONSUME(StringLiteral) },
+      { ALT: () => $.CONSUME(Identifier) },
+    ]);
+    $.validateDeclarationName(nameToken, "error_trigger");
+    $.CONSUME(LCurly); // "{"
+    $.MANY(() => {
+      $.AT_LEAST_ONE(() => $.CONSUME(NewlineToken)); // at least one new line
+      $.OR2([
+        { ALT: () => $.SUBRULE($.commentBlockFn) },
+        {
+          GATE: () => !hasDescription,
+          ALT: () => {
+            hasDescription = true;
+            $.SUBRULE($.descriptionFieldAttribute);
+          },
+        },
+        {
+          GATE: () => !hasGuid,
+          ALT: () => {
+            hasGuid = true;
+            $.SUBRULE($.guidFieldAttribute);
+          },
+        },
+        {
+          GATE: () => !hasHistory,
+          ALT: () => {
+            hasHistory = true;
+            $.SUBRULE($.historyClause);
+          },
+        },
+        {
+          GATE: () => !hasInput,
+          ALT: () => {
+            hasInput = true;
+            $.SUBRULE($.inputClause);
+          },
+        },
+        {
+          GATE: () => !hasStack,
+          ALT: () => {
+            hasStack = true;
+            $.SUBRULE($.stackClause);
+          },
+        },
+        {
+          GATE: () => !hasTags,
+          ALT: () => {
+            hasTags = true;
+            $.SUBRULE($.tagsAttribute);
+          },
+        },
+      ]);
+    });
+
+    if (!hasInput) {
+      $.addMissingError(parent, "{} is missing an input clause");
+    }
+
+    if (!hasStack) {
+      $.addMissingError(parent, "{} is missing a stack clause");
+    }
+
+    $.MANY1(() => $.CONSUME1(NewlineToken)); // optional new line
+    $.CONSUME(RCurly); // "}"
+    $.MANY2(() => $.CONSUME2(NewlineToken)); // optional new line
+    $.sectionStack.pop();
+  };
+}

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,35 @@
+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",
+    "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,35 @@
+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",
+    "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/parser.js

@@ -36,6 +36,9 @@ export function xanoscriptParser(text, scheme, preTokenized = null) {
     case "branch":
       parser.branchDeclaration();
       return parser;
+    case "error_trigger":
+      parser.errorTriggerDeclaration();
+      return parser;
     case "db":
       parser.tableDeclaration();
       return parser;

package/parser/register.js

@@ -6,6 +6,7 @@ import { register as register_attributes } from "./attributes/register.js";
 import { branchDeclaration } from "./branch_parser.js";
 import { register as register_clauses } from "./clauses/register.js";
 import { register as register_definitions } from "./definitions/register.js";
+import { errorTriggerDeclaration } from "./error_trigger_parser.js";
 import { functionDeclaration } from "./function_parser.js";
 import { register as register_functions } from "./functions/register.js";
 import { register as register_generic } from "./generic/register.js";
@@ -50,6 +51,10 @@ export const register = ($) => {
   $.queryDeclaration = $.RULE("queryDeclaration", queryDeclaration($));
   $.apiGroupDeclaration = $.RULE("apiGroupDeclaration", apiGroupDeclaration($));
   $.branchDeclaration = $.RULE("branchDeclaration", branchDeclaration($));
+  $.errorTriggerDeclaration = $.RULE(
+    "errorTriggerDeclaration",
+    errorTriggerDeclaration($)
+  );
   $.tableDeclaration = $.RULE("tableDeclaration", tableDeclaration($));
   $.mcpServerDeclaration = $.RULE(
     "mcpServerDeclaration",

package/utils.js

@@ -23,6 +23,7 @@ const schemeByFirstWord = {
   agent_trigger: "agent_trigger",
   api_group: "api_group",
   branch: "branch",
+  error_trigger: "error_trigger",
   function: "cfn",
   mcp_server: "mcp_server",
   mcp_server_trigger: "mcp_server_trigger",