@xano/xanoscript-language-server 12.10.0 → 12.12.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.10.0",
+  "version": "12.12.0",
   "description": "Language Server Protocol implementation for XanoScript",
   "type": "module",
   "main": "server.js",

package/parser/channel_parser.js

@@ -4,7 +4,6 @@ import {
   DeliveryToken,
   PublishToken,
   RateLimitToken,
-  ServerToken,
 } from "../lexer/channel.js";
 import { ChannelToken } from "../lexer/columns.js";
 import { EqualToken, LCurly, RCurly } from "../lexer/control.js";
@@ -46,12 +45,7 @@ export function channelDeclaration($) {
           GATE: () => !hasServer,
           ALT: () => {
             hasServer = true;
-            const subParent = $.CONSUME(ServerToken); // "server"
-            $.CONSUME(EqualToken); // "="
-            const result = $.CONSUME2(StringLiteral); // "server_name"
-            if (result.image === `""`) {
-              $.addMissingError(subParent, "server cannot be empty");
-            }
+            $.SUBRULE($.realtimeServerClause);
           },
         },
         {
@@ -178,7 +172,7 @@ export function channelDeclaration($) {
     });
 
     if (!hasServer) {
-      $.addMissingError(parent, "{} is missing a server clause");
+      $.addMissingError(parent, "{} is missing a realtime_server clause");
     }
 
     $.MANY1(() => $.CONSUME1(NewlineToken)); // optional new line

package/parser/channel_trigger_parser.js

@@ -1,4 +1,3 @@
-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";
@@ -68,12 +67,7 @@ export function channelTriggerDeclaration($) {
           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");
-            }
+            $.SUBRULE($.realtimeServerClause);
           },
         },
         {
@@ -136,7 +130,7 @@ export function channelTriggerDeclaration($) {
     });
 
     if (!hasServer) {
-      $.addMissingError(parent, "{} is missing a server clause");
+      $.addMissingError(parent, "{} is missing a realtime_server clause");
     }
 
     if (!hasChannel) {

package/parser/message_parser.js

@@ -1,4 +1,3 @@
-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";
@@ -48,12 +47,7 @@ export function messageDeclaration($) {
           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");
-            }
+            $.SUBRULE($.realtimeServerClause);
           },
         },
         {
@@ -142,7 +136,7 @@ export function messageDeclaration($) {
     if (!hasServer) {
       $.addMissingError(
         parent,
-        `{} ${nameToken.image} is missing a server clause`,
+        `{} ${nameToken.image} is missing a realtime_server clause`,
       );
     }
 

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