@xano/xanoscript-language-server 12.9.0 → 12.11.0

package/README.md

@@ -59,6 +59,7 @@ The parser supports the following XanoScript constructs:
 | `middleware` | Middleware definitions |
 | `realtime_channel` | Realtime v1 channel definitions |
 | `realtime_trigger` | Realtime v1 trigger handlers |
+| `realtime_server` | Realtime v2 server definitions (the container that owns channels) |
 | `channel` | Realtime v2 channel definitions (path templates) |
 | `message` | Realtime v2 channel message handlers |
 | `channel_trigger` | Realtime v2 channel lifecycle triggers (join/leave) |

package/package.json

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

package/parser/channel_trigger_parser.js

@@ -1,3 +1,4 @@
+import { ServerToken } from "../lexer/channel.js";
 import { ChannelTriggerToken } from "../lexer/channel_trigger.js";
 import { EqualToken, LCurly, RCurly } from "../lexer/control.js";
 import { StringLiteral } from "../lexer/literal.js";
@@ -8,6 +9,7 @@ export function channelTriggerDeclaration($) {
   return () => {
     let hasActions = false;
     let hasActive = false;
+    let hasServer = false;
     let hasChannel = false;
     let hasDescription = false;
     let hasGuid = false;
@@ -62,6 +64,18 @@ export function channelTriggerDeclaration($) {
             $.SUBRULE($.booleanValue);
           },
         },
+        {
+          GATE: () => !hasServer,
+          ALT: () => {
+            hasServer = true;
+            const subParent = $.CONSUME(ServerToken); // "server"
+            $.CONSUME3(EqualToken); // "="
+            const result = $.CONSUME2(StringLiteral); // "server_name"
+            if (result.image === `""`) {
+              $.addMissingError(subParent, "server cannot be empty");
+            }
+          },
+        },
         {
           GATE: () => !hasChannel,
           ALT: () => {
@@ -121,6 +135,10 @@ export function channelTriggerDeclaration($) {
       ]);
     });
 
+    if (!hasServer) {
+      $.addMissingError(parent, "{} is missing a server clause");
+    }
+
     if (!hasChannel) {
       $.addMissingError(parent, "{} is missing a channel clause");
     }

package/parser/message_parser.js

@@ -1,3 +1,4 @@
+import { ServerToken } from "../lexer/channel.js";
 import { EqualToken, LCurly, RCurly } from "../lexer/control.js";
 import { StringLiteral } from "../lexer/literal.js";
 import { DeliverToToken, MessageToken } from "../lexer/message.js";
@@ -6,6 +7,7 @@ import { AuthToken, Identifier, NewlineToken } from "../lexer/tokens.js";
 export function messageDeclaration($) {
   return () => {
     let hasAuth = false;
+    let hasServer = false;
     let hasChannel = false;
     let hasDeliverTo = false;
     let hasDescription = false;
@@ -42,6 +44,18 @@ export function messageDeclaration($) {
             $.CONSUME2(StringLiteral); // "user"
           },
         },
+        {
+          GATE: () => !hasServer,
+          ALT: () => {
+            hasServer = true;
+            const subParent = $.CONSUME(ServerToken); // "server"
+            $.CONSUME3(EqualToken); // "="
+            const result = $.CONSUME3(StringLiteral); // "server_name"
+            if (result.image === `""`) {
+              $.addMissingError(subParent, "server cannot be empty");
+            }
+          },
+        },
         {
           GATE: () => !hasChannel,
           ALT: () => {
@@ -125,6 +139,13 @@ export function messageDeclaration($) {
       ]);
     });
 
+    if (!hasServer) {
+      $.addMissingError(
+        parent,
+        `{} ${nameToken.image} is missing a server clause`,
+      );
+    }
+
     if (!hasChannel) {
       $.addMissingError(
         parent,

package/parser/parser.js

@@ -60,6 +60,9 @@ export function xanoscriptParser(text, scheme, preTokenized = null) {
     case "middleware":
       parser.middlewareDeclaration();
       return parser;
+    case "realtime_server":
+      parser.realtimeServerDeclaration();
+      return parser;
     case "realtime_server_trigger":
       parser.realtimeServerTriggerDeclaration();
       return parser;

package/parser/realtime_server_parser.js

@@ -0,0 +1,95 @@
+import { EqualToken, LCurly, RCurly } from "../lexer/control.js";
+import { StringLiteral } from "../lexer/literal.js";
+import { ActiveToken } from "../lexer/mcp_server.js";
+import { RealtimeServerToken } from "../lexer/realtime_server_trigger.js";
+import { Identifier, NewlineToken } from "../lexer/tokens.js";
+
+export function realtimeServerDeclaration($) {
+  return () => {
+    let hasActive = false;
+    let hasCanonical = false;
+    let hasDescription = false;
+    let hasGuid = false;
+    let hasDocs = false;
+    let hasHistory = false;
+    let hasTags = false;
+
+    $.sectionStack.push("realtimeServerDeclaration");
+    // Allow leading comments and newlines before the realtime_server declaration
+    $.SUBRULE($.optionalCommentBlockFn);
+    $.CONSUME(RealtimeServerToken); // realtime_server
+    const nameToken = $.OR([
+      { ALT: () => $.CONSUME(StringLiteral) },
+      { ALT: () => $.CONSUME(Identifier) },
+    ]);
+    $.validateDeclarationName(nameToken, "realtime_server");
+    $.CONSUME(LCurly); // "{"
+    $.MANY(() => {
+      $.AT_LEAST_ONE(() => $.CONSUME(NewlineToken)); // at least one new line
+      $.OR2([
+        {
+          ALT: () => $.SUBRULE($.commentBlockFn),
+        },
+        {
+          GATE: () => !hasActive,
+          ALT: () => {
+            hasActive = true;
+
+            $.CONSUME(ActiveToken); // "active"
+            $.CONSUME(EqualToken); // "="
+            $.SUBRULE($.booleanValue); // true/false
+          },
+        },
+        {
+          GATE: () => !hasCanonical,
+          ALT: () => {
+            hasCanonical = true;
+            $.SUBRULE($.canonicalClause);
+          },
+        },
+        {
+          GATE: () => !hasDescription,
+          ALT: () => {
+            hasDescription = true;
+            $.SUBRULE($.descriptionFieldAttribute);
+          },
+        },
+        {
+          GATE: () => !hasGuid,
+          ALT: () => {
+            hasGuid = true;
+            $.SUBRULE($.guidFieldAttribute);
+          },
+        },
+        {
+          GATE: () => !hasDocs,
+          ALT: () => {
+            hasDocs = true;
+            $.SUBRULE($.docsFieldAttribute);
+          },
+        },
+        {
+          GATE: () => !hasHistory,
+          ALT: () => {
+            hasHistory = true;
+            $.SUBRULE($.historyClause);
+          },
+        },
+        {
+          GATE: () => !hasTags,
+          ALT: () => {
+            hasTags = true;
+            $.SUBRULE($.tagsAttribute);
+          },
+        },
+      ]);
+    });
+
+    // All fields are optional — only the declaration name is required.
+
+    $.MANY1(() => $.CONSUME1(NewlineToken)); // optional new line
+    $.CONSUME(RCurly); // "}"
+    $.MANY2(() => $.CONSUME2(NewlineToken)); // optional new line
+    $.sectionStack.pop();
+  };
+}

package/parser/register.js

@@ -19,6 +19,7 @@ import { register as register_metadata } from "./metadata/register.js";
 import { middlewareDeclaration } from "./middleware_parser.js";
 import { queryDeclaration } from "./query_parser.js";
 import { realtimeChannelDeclaration } from "./realtime_channel_parser.js";
+import { realtimeServerDeclaration } from "./realtime_server_parser.js";
 import { realtimeServerTriggerDeclaration } from "./realtime_server_trigger_parser.js";
 import { realtimeTriggerDeclaration } from "./realtime_trigger_parser.js";
 import {
@@ -78,6 +79,10 @@ export const register = ($) => {
     "middlewareDeclaration",
     middlewareDeclaration($)
   );
+  $.realtimeServerDeclaration = $.RULE(
+    "realtimeServerDeclaration",
+    realtimeServerDeclaration($)
+  );
   $.realtimeServerTriggerDeclaration = $.RULE(
     "realtimeServerTriggerDeclaration",
     realtimeServerTriggerDeclaration($)

package/utils.js

@@ -32,6 +32,7 @@ const schemeByFirstWord = {
   message: "message",
   middleware: "middleware",
   query: "api",
+  realtime_server: "realtime_server",
   realtime_server_trigger: "realtime_server_trigger",
   realtime_trigger: "realtime_trigger",
   realtime_channel: "realtime_channel",