@enfyra/mcp-server 0.1.69 → 0.1.71

package/dist/lib/mcp-example-websocket.js

@@ -0,0 +1,103 @@
+export const websocketExamples = {
+    title: 'Socket.IO gateways, events, rooms, and browser connection',
+    useWhen: 'Use when creating realtime features.',
+    examples: [
+        {
+            name: 'Browser client connection through app bridge',
+            code: `import { io } from "socket.io-client"
+
+const socket = io("/chat", {
+  path: "/socket.io",
+  withCredentials: true,
+  transports: ["polling", "websocket"]
+})`,
+            notes: [
+                '/chat is the Socket.IO namespace.',
+                '/socket.io is the app-origin transport path proxied to Enfyra app /ws/socket.io.',
+                'Do not connect browser code directly to the hidden backend.',
+            ],
+        },
+        {
+            name: 'Connection script confirms authenticated readiness',
+            code: `if (!@USER?.id) {
+  @SOCKET.disconnect()
+  return
+}
+
+@SOCKET.reply("chat:ready", { userId: @USER.id })`,
+            notes: [
+                'Authenticated Enfyra sockets already load @USER.',
+                'Enfyra joins user_<userId> automatically after the connection script succeeds; do not manually duplicate that lifecycle room.',
+            ],
+        },
+        {
+            name: 'Chat join event',
+            code: `const conversationId = @BODY.conversationId
+if (!conversationId) @THROW400("conversationId is required")
+
+const membership = await #secure.chat_conversation_member.find({
+  filter: {
+    conversation: { id: { _eq: conversationId } },
+    member: { id: { _eq: @USER.id } }
+  },
+  limit: 1
+})
+
+if (!membership.data[0]) @THROW403("Not a conversation member")
+
+@SOCKET.join(\`conversation:\${conversationId}\`)
+@SOCKET.reply("chat:joined", { conversationId })`,
+            notes: [
+                'Join conversation rooms, not member-id rooms.',
+                'conversationId is a request/room identifier; DB filters still use the relation property conversation.',
+                'Check membership server-side; do not trust the client.',
+                'Use #secure.table_name for explicit user-facing table access so field permissions remain enforced; still select exact fields and sanitize returned data.',
+            ],
+        },
+        {
+            name: 'Chat message event with room broadcast and persistence',
+            code: `const { conversationId, text, clientId } = @BODY
+if (!conversationId || !text) @THROW400("conversationId and text are required")
+
+const membership = await #secure.chat_conversation_member.find({
+  filter: {
+    conversation: { id: { _eq: conversationId } },
+    member: { id: { _eq: @USER.id } }
+  },
+  limit: 1
+})
+if (!membership.data[0]) @THROW403("Not a conversation member")
+
+const created = await #secure.chat_message.create({
+  data: {
+    conversation: { id: conversationId },
+    sender: { id: @USER.id },
+    text,
+    persistStatus: "persisted"
+  }
+})
+
+const message = created.data?.[0] ?? null
+if (message?.id) {
+  await #secure.chat_conversation.update({
+    id: conversationId,
+    data: { lastMessage: { id: message.id }, updatedAt: message.createdAt || new Date().toISOString() }
+  })
+}
+@SOCKET.emitToCurrentRoom(\`conversation:\${conversationId}\`, "chat:message", {
+  clientId,
+  message
+})
+
+return { ok: true, message }`,
+            notes: [
+                'Do not ask the client for senderId. The sender relation is derived from @USER.id.',
+                'conversationId is accepted only as the room/business identifier; persistence uses relation properties conversation and sender, not physical FK fields.',
+                'Event scripts should explicitly emit replies/broadcasts.',
+                '@SOCKET has no generic emit() method. Use reply/emitToCurrentRoom/broadcastToRoom in bound websocket scripts.',
+                'Use #table_name for explicit table access in generated scripts; select exact fields, enforce membership checks, and return shaped payloads.',
+            ],
+        },
+    ],
+};
+//# sourceMappingURL=mcp-example-websocket.js.map

package/dist/lib/mcp-example-websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-example-websocket.js","sourceRoot":"","sources":["../../src/lib/mcp-example-websocket.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,KAAK,EAAE,2DAA2D;IAClE,OAAO,EAAE,sCAAsC;IAC/C,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,8CAA8C;YACpD,IAAI,EAAE;;;;;;GAMX;YACK,KAAK,EAAE;gBACL,mCAAmC;gBACnC,kFAAkF;gBAClF,6DAA6D;aAC9D;SACF;QACD;YACE,IAAI,EAAE,oDAAoD;YAC1D,IAAI,EAAE;;;;;kDAKoC;YAC1C,KAAK,EAAE;gBACL,kDAAkD;gBAClD,+HAA+H;aAChI;SACF;QACD;YACE,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE;;;;;;;;;;;;;;iDAcmC;YACzC,KAAK,EAAE;gBACL,+CAA+C;gBAC/C,uGAAuG;gBACvG,wDAAwD;gBACxD,0JAA0J;aAC3J;SACF;QACD;YACE,IAAI,EAAE,wDAAwD;YAC9D,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAiCe;YACrB,KAAK,EAAE;gBACL,mFAAmF;gBACnF,wJAAwJ;gBACxJ,0DAA0D;gBAC1D,+GAA+G;gBAC/G,6IAA6I;aAC9I;SACF;KACF;CACF,CAAC"}

package/dist/lib/mcp-examples.d.ts

@@ -9,7 +9,7 @@ export declare const EXAMPLE_CATEGORIES: {
             notes: string[];
         }[];
     };
-    'oauth-setup': {
+    "oauth-setup": {
         title: string;
         useWhen: string;
         examples: {
@@ -18,7 +18,7 @@ export declare const EXAMPLE_CATEGORIES: {
             notes: string[];
         }[];
     };
-    'schema-relations': {
+    "schema-relations": {
         title: string;
         useWhen: string;
         examples: {
@@ -27,7 +27,7 @@ export declare const EXAMPLE_CATEGORIES: {
             notes: string[];
         }[];
     };
-    'queries-deep': {
+    "queries-deep": {
         title: string;
         useWhen: string;
         examples: {
@@ -45,7 +45,7 @@ export declare const EXAMPLE_CATEGORIES: {
             notes: string[];
         }[];
     };
-    'handlers-hooks': {
+    "handlers-hooks": {
         title: string;
         useWhen: string;
         examples: {
@@ -54,7 +54,7 @@ export declare const EXAMPLE_CATEGORIES: {
             notes: string[];
         }[];
     };
-    'permissions-rls': {
+    "permissions-rls": {
         title: string;
         useWhen: string;
         examples: {