@xano/xanoscript-language-server 12.11.0 → 12.13.0

package/README.md

@@ -62,7 +62,7 @@ The parser supports the following XanoScript constructs:
 | `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) |
+| `channel_trigger` | Realtime v2 channel triggers (join/leave lifecycle, deliver per-recipient) |
 | `realtime_server_trigger` | Realtime v2 connection lifecycle triggers (connect/disconnect) |
 | `tool` | Tool definitions |
 | `workspace` | Workspace definitions |

package/lexer/realtime.js

@@ -13,12 +13,23 @@ export const GetSessionToken = createTokenByName("get_session", {
   categories: [Identifier],
 });
 
-export const RealtimeStatementTokens = [RealtimeToken, GetSessionToken];
+// publish
+export const PublishToken = createTokenByName("publish", {
+  longer_alt: Identifier,
+  categories: [Identifier],
+});
+
+export const RealtimeStatementTokens = [
+  RealtimeToken,
+  GetSessionToken,
+  PublishToken,
+];
 
 export function mapTokenToType(token) {
   switch (token) {
     case RealtimeToken.name:
     case GetSessionToken.name:
+    case PublishToken.name:
       return "function";
     default:
       return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xano/xanoscript-language-server",
-  "version": "12.11.0",
+  "version": "12.13.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";
@@ -50,6 +49,7 @@ export function channelTriggerDeclaration($) {
                 {
                   "join?": "[boolean]",
                   "leave?": "[boolean]",
+                  "deliver?": "[boolean]",
                 },
               ],
             });
@@ -68,12 +68,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 +131,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/functions/realtime/realtimePublishFn.js

@@ -0,0 +1,39 @@
+import { PublishToken } from "../../../lexer/realtime.js";
+
+// realtime.publish {
+//   realtime_server = "main"
+//   channel = "rooms/42"
+//   message = "chat"          // optional — becomes the delivered frame's `type`
+//   data = $payload
+//   auth_table = "user"       // optional — asserted identity (attribution only)
+//   auth_id = $auth.id        // optional
+// }
+//
+// Injects a server-authored event onto a realtime v2 channel (cloud-client
+// mvp:realtime_publish). `realtime_server` + `channel` + `data` are required;
+// `message`/`auth_table`/`auth_id` are optional. Flat attrs (the PHP transform
+// maps auth_table/auth_id into the nested context.auth.{dbo_id,row_id} shape).
+// Unlike realtime.get_session it has NO `as $var` binding.
+
+/**
+ * @param {import('../../base_parser.js').XanoBaseParser} $
+ */
+export function realtimePublishFn($) {
+  const requiredAttrs = ["realtime_server", "channel", "data"];
+  const optionalAttrs = [
+    "message",
+    "auth_table",
+    "auth_id",
+    "description",
+    "disabled",
+  ];
+
+  return () => {
+    $.sectionStack.push("realtimePublishFn");
+    const fnToken = $.CONSUME(PublishToken); // "publish"
+    $.SUBRULE($.functionAttrReq, {
+      ARGS: [fnToken, requiredAttrs, optionalAttrs],
+    });
+    $.sectionStack.pop();
+  };
+}

package/parser/functions/realtime/register.js

@@ -1,4 +1,5 @@
 import { realtimeGetSessionFn } from "./realtimeGetSessionFn.js";
+import { realtimePublishFn } from "./realtimePublishFn.js";
 
 /**
  * Registers all the parsers in this folder
@@ -9,4 +10,5 @@ export const register = ($) => {
     "realtimeGetSessionFn",
     realtimeGetSessionFn($),
   );
+  $.realtimePublishFn = $.RULE("realtimePublishFn", realtimePublishFn($));
 };

package/parser/functions/realtimeFn.js

@@ -12,6 +12,7 @@ export function realtimeFn($) {
     $.CONSUME(DotToken); // "."
     $.OR([
       { ALT: () => $.SUBRULE($.realtimeGetSessionFn) }, // "realtime.get_session"
+      { ALT: () => $.SUBRULE($.realtimePublishFn) }, // "realtime.publish"
     ]);
     $.sectionStack.pop();
   };

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`,
       );
     }