@xano/xanoscript-language-server 12.1.0 → 12.2.0

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

@@ -54,6 +54,10 @@ import {
 } from "./control.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 +403,7 @@ export const allTokens = uniq([
   ...UtilTokens,
   ...TableTriggerTokens,
   ...WorkspaceTriggerTokens,
+  ...ErrorTriggerTokens,
   ...TaskTokens,
   ...WorkflowTestTokens,
   ...ApiGroupTokens,
@@ -446,6 +451,7 @@ const tokenMappers = [
   mapControlsTokenToType,
   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.2.0",
   "description": "Language Server Protocol implementation for XanoScript",
   "type": "module",
   "main": "server.js",

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/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",