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

package/parser/channel_trigger_parser.js

@@ -49,6 +49,7 @@ export function channelTriggerDeclaration($) {
                 {
                   "join?": "[boolean]",
                   "leave?": "[boolean]",
+                  "deliver?": "[boolean]",
                 },
               ],
             });

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();
   };