bonescript-compiler 0.5.3 → 0.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (201) hide show
  1. package/LICENSE +21 -21
  2. package/dist/algorithm_catalog.js +166 -166
  3. package/dist/cli.d.ts +1 -2
  4. package/dist/cli.js +617 -75
  5. package/dist/cli.js.map +1 -1
  6. package/dist/emit_capability.d.ts +0 -13
  7. package/dist/emit_capability.js +134 -296
  8. package/dist/emit_capability.js.map +1 -1
  9. package/dist/emit_composition.js +3 -37
  10. package/dist/emit_composition.js.map +1 -1
  11. package/dist/emit_deploy.js +167 -165
  12. package/dist/emit_deploy.js.map +1 -1
  13. package/dist/emit_events.d.ts +0 -1
  14. package/dist/emit_events.js +275 -325
  15. package/dist/emit_events.js.map +1 -1
  16. package/dist/emit_extras.js +5 -3
  17. package/dist/emit_extras.js.map +1 -1
  18. package/dist/emit_full.js +112 -272
  19. package/dist/emit_full.js.map +1 -1
  20. package/dist/emit_maintenance.js +249 -249
  21. package/dist/emit_nakama.d.ts +23 -0
  22. package/dist/emit_nakama.js +510 -0
  23. package/dist/emit_nakama.js.map +1 -0
  24. package/dist/emit_runtime.d.ts +11 -17
  25. package/dist/emit_runtime.js +688 -29
  26. package/dist/emit_runtime.js.map +1 -1
  27. package/dist/emit_sourcemap.js +66 -66
  28. package/dist/emit_tests.js +12 -47
  29. package/dist/emit_tests.js.map +1 -1
  30. package/dist/emit_websocket.js +3 -0
  31. package/dist/emit_websocket.js.map +1 -1
  32. package/dist/emitter.js +49 -94
  33. package/dist/emitter.js.map +1 -1
  34. package/dist/extension_manager.d.ts +2 -2
  35. package/dist/extension_manager.js +20 -9
  36. package/dist/extension_manager.js.map +1 -1
  37. package/dist/index.d.ts +2 -0
  38. package/dist/index.js +3 -1
  39. package/dist/index.js.map +1 -1
  40. package/dist/ir.d.ts +0 -4
  41. package/dist/lowering.d.ts +14 -5
  42. package/dist/lowering.js +417 -66
  43. package/dist/lowering.js.map +1 -1
  44. package/dist/module_loader.d.ts +2 -2
  45. package/dist/module_loader.js +23 -20
  46. package/dist/module_loader.js.map +1 -1
  47. package/dist/optimizer.js +3 -6
  48. package/dist/optimizer.js.map +1 -1
  49. package/dist/scaffold.d.ts +2 -2
  50. package/dist/scaffold.js +319 -315
  51. package/dist/scaffold.js.map +1 -1
  52. package/dist/solver.js +1 -1
  53. package/dist/solver.js.map +1 -1
  54. package/dist/source_map.js.map +1 -0
  55. package/dist/test.js.map +1 -0
  56. package/dist/test_typechecker.d.ts +5 -0
  57. package/dist/test_typechecker.js +126 -0
  58. package/dist/test_typechecker.js.map +1 -0
  59. package/dist/typechecker.d.ts +0 -7
  60. package/dist/typechecker.js +16 -103
  61. package/dist/typechecker.js.map +1 -1
  62. package/dist/verifier.d.ts +1 -5
  63. package/dist/verifier.js +38 -142
  64. package/dist/verifier.js.map +1 -1
  65. package/package.json +53 -62
  66. package/src/algorithm_catalog.ts +345 -345
  67. package/src/ast.d.ts +244 -0
  68. package/src/ast.ts +334 -334
  69. package/src/cli.ts +704 -98
  70. package/src/emit_batch.ts +140 -140
  71. package/src/emit_capability.ts +436 -613
  72. package/src/emit_composition.ts +196 -229
  73. package/src/emit_deploy.ts +190 -187
  74. package/src/emit_events.ts +307 -362
  75. package/src/emit_extras.ts +240 -237
  76. package/src/emit_full.ts +309 -472
  77. package/src/emit_maintenance.ts +459 -459
  78. package/src/emit_nakama.ts +576 -0
  79. package/src/emit_runtime.ts +730 -17
  80. package/src/emit_sourcemap.ts +140 -140
  81. package/src/emit_tests.ts +205 -243
  82. package/src/emit_websocket.ts +229 -226
  83. package/src/emitter.ts +578 -626
  84. package/src/extension_manager.ts +187 -177
  85. package/src/formatter.ts +297 -297
  86. package/src/index.ts +90 -88
  87. package/src/ir.ts +215 -216
  88. package/src/lexer.d.ts +195 -0
  89. package/src/lexer.ts +630 -630
  90. package/src/lowering.ts +556 -168
  91. package/src/module_loader.ts +114 -112
  92. package/src/optimizer.ts +196 -199
  93. package/src/parse_decls.d.ts +13 -0
  94. package/src/parse_decls.ts +409 -409
  95. package/src/parse_decls2.d.ts +13 -0
  96. package/src/parse_decls2.ts +244 -244
  97. package/src/parse_expr.d.ts +7 -0
  98. package/src/parse_expr.ts +197 -197
  99. package/src/parse_types.d.ts +6 -0
  100. package/src/parse_types.ts +54 -54
  101. package/src/parser.d.ts +10 -0
  102. package/src/parser.ts +1 -1
  103. package/src/parser_base.d.ts +19 -0
  104. package/src/parser_base.ts +57 -57
  105. package/src/parser_recovery.ts +153 -153
  106. package/src/scaffold.ts +375 -371
  107. package/src/solver.ts +330 -330
  108. package/src/typechecker.d.ts +52 -0
  109. package/src/typechecker.ts +591 -700
  110. package/src/types.d.ts +38 -0
  111. package/src/types.ts +122 -122
  112. package/src/verifier.ts +49 -154
  113. package/README.md +0 -382
  114. package/dist/commands/check.d.ts +0 -5
  115. package/dist/commands/check.js +0 -34
  116. package/dist/commands/check.js.map +0 -1
  117. package/dist/commands/compile.d.ts +0 -5
  118. package/dist/commands/compile.js +0 -215
  119. package/dist/commands/compile.js.map +0 -1
  120. package/dist/commands/debug.d.ts +0 -5
  121. package/dist/commands/debug.js +0 -59
  122. package/dist/commands/debug.js.map +0 -1
  123. package/dist/commands/diff.d.ts +0 -5
  124. package/dist/commands/diff.js +0 -123
  125. package/dist/commands/diff.js.map +0 -1
  126. package/dist/commands/fmt.d.ts +0 -5
  127. package/dist/commands/fmt.js +0 -49
  128. package/dist/commands/fmt.js.map +0 -1
  129. package/dist/commands/init.d.ts +0 -5
  130. package/dist/commands/init.js +0 -96
  131. package/dist/commands/init.js.map +0 -1
  132. package/dist/commands/ir.d.ts +0 -5
  133. package/dist/commands/ir.js +0 -27
  134. package/dist/commands/ir.js.map +0 -1
  135. package/dist/commands/lex.d.ts +0 -5
  136. package/dist/commands/lex.js +0 -21
  137. package/dist/commands/lex.js.map +0 -1
  138. package/dist/commands/parse.d.ts +0 -5
  139. package/dist/commands/parse.js +0 -30
  140. package/dist/commands/parse.js.map +0 -1
  141. package/dist/commands/test.d.ts +0 -5
  142. package/dist/commands/test.js +0 -61
  143. package/dist/commands/test.js.map +0 -1
  144. package/dist/commands/verify_determinism.d.ts +0 -5
  145. package/dist/commands/verify_determinism.js +0 -64
  146. package/dist/commands/verify_determinism.js.map +0 -1
  147. package/dist/commands/watch.d.ts +0 -5
  148. package/dist/commands/watch.js +0 -50
  149. package/dist/commands/watch.js.map +0 -1
  150. package/dist/emit_auth.d.ts +0 -18
  151. package/dist/emit_auth.js +0 -507
  152. package/dist/emit_auth.js.map +0 -1
  153. package/dist/emit_database.d.ts +0 -7
  154. package/dist/emit_database.js +0 -72
  155. package/dist/emit_database.js.map +0 -1
  156. package/dist/emit_index.d.ts +0 -6
  157. package/dist/emit_index.js +0 -202
  158. package/dist/emit_index.js.map +0 -1
  159. package/dist/emit_models.d.ts +0 -12
  160. package/dist/emit_models.js +0 -171
  161. package/dist/emit_models.js.map +0 -1
  162. package/dist/emit_openapi.d.ts +0 -9
  163. package/dist/emit_openapi.js +0 -306
  164. package/dist/emit_openapi.js.map +0 -1
  165. package/dist/emit_package.d.ts +0 -7
  166. package/dist/emit_package.js +0 -68
  167. package/dist/emit_package.js.map +0 -1
  168. package/dist/emit_router.d.ts +0 -12
  169. package/dist/emit_router.js +0 -389
  170. package/dist/emit_router.js.map +0 -1
  171. package/dist/lowering_channels.d.ts +0 -11
  172. package/dist/lowering_channels.js +0 -103
  173. package/dist/lowering_channels.js.map +0 -1
  174. package/dist/lowering_entities.d.ts +0 -11
  175. package/dist/lowering_entities.js +0 -232
  176. package/dist/lowering_entities.js.map +0 -1
  177. package/dist/lowering_helpers.d.ts +0 -13
  178. package/dist/lowering_helpers.js +0 -76
  179. package/dist/lowering_helpers.js.map +0 -1
  180. package/src/commands/check.ts +0 -33
  181. package/src/commands/compile.ts +0 -191
  182. package/src/commands/debug.ts +0 -33
  183. package/src/commands/diff.ts +0 -105
  184. package/src/commands/fmt.ts +0 -22
  185. package/src/commands/init.ts +0 -72
  186. package/src/commands/ir.ts +0 -23
  187. package/src/commands/lex.ts +0 -17
  188. package/src/commands/parse.ts +0 -24
  189. package/src/commands/test.ts +0 -36
  190. package/src/commands/verify_determinism.ts +0 -66
  191. package/src/commands/watch.ts +0 -25
  192. package/src/emit_auth.ts +0 -513
  193. package/src/emit_database.ts +0 -72
  194. package/src/emit_index.ts +0 -210
  195. package/src/emit_models.ts +0 -176
  196. package/src/emit_openapi.ts +0 -315
  197. package/src/emit_package.ts +0 -66
  198. package/src/emit_router.ts +0 -408
  199. package/src/lowering_channels.ts +0 -108
  200. package/src/lowering_entities.ts +0 -258
  201. package/src/lowering_helpers.ts +0 -75
@@ -1,226 +1,229 @@
1
- /**
2
- * BoneScript WebSocket Runtime Emitter
3
- * Generates runnable WebSocket servers for `channel` declarations.
4
- */
5
-
6
- import * as IR from "./ir";
7
- import { toSnakeCase } from "./lowering_helpers";
8
-
9
- function toCamelCase(s: string): string {
10
- return s.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
11
- }
12
-
13
- // ─── WebSocket Server ────────────────────────────────────────────────────────
14
-
15
- export function emitWebSocketServer(system: IR.IRSystem): string {
16
- const channels = system.modules.filter(m => m.kind === "realtime_service");
17
- if (channels.length === 0) return "";
18
-
19
- const lines: string[] = [];
20
- lines.push(`// Generated by BoneScript compiler. DO NOT EDIT.`);
21
- lines.push(`// WebSocket server for realtime channels`);
22
- lines.push(``);
23
- lines.push(`import { WebSocketServer, WebSocket } from "ws";`);
24
- lines.push(`import { IncomingMessage, Server } from "http";`);
25
- lines.push(`import jwt from "jsonwebtoken";`);
26
- lines.push(`import { eventBus } from "./events";`);
27
- lines.push(`import { logger } from "./logger";`);
28
- lines.push(``);
29
- lines.push(`const JWT_SECRET = process.env.JWT_SECRET || "bonescript-dev-secret-change-in-production";`);
30
- lines.push(``);
31
- // Redis pub/sub for multi-instance support
32
- lines.push(`// Redis pub/sub for multi-instance WebSocket broadcasting`);
33
- lines.push(`let redisSub: any = null;`);
34
- lines.push(`let redisPub: any = null;`);
35
- lines.push(`if (process.env.REDIS_URL) {`);
36
- lines.push(` try {`);
37
- lines.push(` const { createClient } = require("redis");`);
38
- lines.push(` redisSub = createClient({ url: process.env.REDIS_URL });`);
39
- lines.push(` redisPub = createClient({ url: process.env.REDIS_URL });`);
40
- lines.push(` Promise.all([redisSub.connect(), redisPub.connect()]).then(() => {`);
41
- lines.push(` logger.info("redis_connected", { event: "startup" });`);
42
- lines.push(` }).catch((e: any) => {`);
43
- lines.push(` logger.error("redis_connect_failed", { event: "startup", metadata: { error: e.message } });`);
44
- lines.push(` redisSub = null; redisPub = null;`);
45
- lines.push(` });`);
46
- lines.push(` } catch { redisSub = null; redisPub = null; }`);
47
- lines.push(`}`);
48
-
49
- // Per-channel client registry
50
- lines.push(`interface Client {`);
51
- lines.push(` socket: WebSocket;`);
52
- lines.push(` user_id: string;`);
53
- lines.push(` channel: string;`);
54
- lines.push(` topics: Set<string>;`);
55
- lines.push(`}`);
56
- lines.push(``);
57
- lines.push(`const clients: Map<string, Set<Client>> = new Map();`);
58
- lines.push(``);
59
-
60
- // Channel configs
61
- lines.push(`const CHANNELS: Record<string, { ordering: string; persistence: string; max_size: number }> = {`);
62
- for (const ch of channels) {
63
- lines.push(` "${ch.name}": {`);
64
- lines.push(` ordering: "${ch.config["ordering"] || "fifo"}",`);
65
- lines.push(` persistence: "${ch.config["persistence"] || "none"}",`);
66
- lines.push(` max_size: ${ch.config["max_size"] || 10000},`);
67
- lines.push(` },`);
68
- }
69
- lines.push(`};`);
70
- lines.push(``);
71
-
72
- // Message buffer for persistence
73
- lines.push(`const messageBuffers: Map<string, any[]> = new Map();`);
74
- lines.push(``);
75
- lines.push(`function getBuffer(channel: string): any[] {`);
76
- lines.push(` const buf = messageBuffers.get(channel);`);
77
- lines.push(` if (buf) return buf;`);
78
- lines.push(` const fresh: any[] = [];`);
79
- lines.push(` messageBuffers.set(channel, fresh);`);
80
- lines.push(` return fresh;`);
81
- lines.push(`}`);
82
- lines.push(``);
83
- lines.push(`function persistMessage(channel: string, msg: any) {`);
84
- lines.push(` const cfg = CHANNELS[channel];`);
85
- lines.push(` if (!cfg || cfg.persistence === "none") return;`);
86
- lines.push(` const buf = getBuffer(channel);`);
87
- lines.push(` buf.push(msg);`);
88
- lines.push(``);
89
- lines.push(` // Honor persistence config (last_N, full)`);
90
- lines.push(` const match = cfg.persistence.match(/^last_(\\d+)$/);`);
91
- lines.push(` if (match) {`);
92
- lines.push(` const limit = parseInt(match[1], 10);`);
93
- lines.push(` while (buf.length > limit) buf.shift();`);
94
- lines.push(` } else if (buf.length > cfg.max_size) {`);
95
- lines.push(` buf.shift();`);
96
- lines.push(` }`);
97
- lines.push(`}`);
98
- lines.push(``);
99
-
100
- // Setup function
101
- lines.push(`export function setupWebSocketServer(httpServer: Server): WebSocketServer {`);
102
- lines.push(` const wss = new WebSocketServer({ server: httpServer, path: "/ws" });`);
103
- lines.push(``);
104
- lines.push(` wss.on("connection", (socket: WebSocket, req: IncomingMessage) => {`);
105
- lines.push(` const url = new URL(req.url || "/", \`http://\${req.headers.host}\`);`);
106
- lines.push(` const channel = url.searchParams.get("channel") || "";`);
107
- lines.push(` const token = url.searchParams.get("token") || "";`);
108
- lines.push(``);
109
- lines.push(` if (!CHANNELS[channel]) {`);
110
- lines.push(` socket.send(JSON.stringify({ type: "error", message: "Unknown channel: " + channel }));`);
111
- lines.push(` socket.close();`);
112
- lines.push(` return;`);
113
- lines.push(` }`);
114
- lines.push(``);
115
- lines.push(` let userId: string;`);
116
- lines.push(` try {`);
117
- lines.push(` const decoded = jwt.verify(token, JWT_SECRET) as { sub: string };`);
118
- lines.push(` userId = decoded.sub;`);
119
- lines.push(` } catch {`);
120
- lines.push(` socket.send(JSON.stringify({ type: "error", message: "Authentication failed" }));`);
121
- lines.push(` socket.close();`);
122
- lines.push(` return;`);
123
- lines.push(` }`);
124
- lines.push(``);
125
- lines.push(` const client: Client = { socket, user_id: userId, channel, topics: new Set() };`);
126
- lines.push(` const set = clients.get(channel) || new Set();`);
127
- lines.push(` set.add(client);`);
128
- lines.push(` clients.set(channel, set);`);
129
- lines.push(``);
130
- lines.push(` console.log(\`[ws] User \${userId} connected to \${channel} (\${set.size} active)\`);`);
131
- lines.push(``);
132
- lines.push(` // Send buffered history`);
133
- lines.push(` const history = messageBuffers.get(channel) || [];`);
134
- lines.push(` for (const msg of history) {`);
135
- lines.push(` socket.send(JSON.stringify(msg));`);
136
- lines.push(` }`);
137
- lines.push(``);
138
- lines.push(` socket.send(JSON.stringify({ type: "connected", channel, history_size: history.length }));`);
139
- lines.push(``);
140
- lines.push(` socket.on("message", (data) => {`);
141
- lines.push(` try {`);
142
- lines.push(` const msg = JSON.parse(data.toString());`);
143
- lines.push(``);
144
- lines.push(` if (msg.type === "subscribe" && msg.topic) {`);
145
- lines.push(` client.topics.add(msg.topic);`);
146
- lines.push(` return;`);
147
- lines.push(` }`);
148
- lines.push(` if (msg.type === "unsubscribe" && msg.topic) {`);
149
- lines.push(` client.topics.delete(msg.topic);`);
150
- lines.push(` return;`);
151
- lines.push(` }`);
152
- lines.push(``);
153
- lines.push(` // Broadcast`);
154
- lines.push(` const broadcast = {`);
155
- lines.push(` type: msg.type || "message",`);
156
- lines.push(` payload: msg.payload || msg,`);
157
- lines.push(` from: userId,`);
158
- lines.push(` timestamp: new Date().toISOString(),`);
159
- lines.push(` };`);
160
- lines.push(``);
161
- lines.push(` persistMessage(channel, broadcast);`);
162
- lines.push(` broadcastToChannel(channel, broadcast, client);`);
163
- lines.push(` } catch (e: any) {`);
164
- lines.push(` socket.send(JSON.stringify({ type: "error", message: e.message }));`);
165
- lines.push(` }`);
166
- lines.push(` });`);
167
- lines.push(``);
168
- lines.push(` socket.on("close", () => {`);
169
- lines.push(` const set = clients.get(channel);`);
170
- lines.push(` if (set) set.delete(client);`);
171
- lines.push(` console.log(\`[ws] User \${userId} disconnected from \${channel}\`);`);
172
- lines.push(` });`);
173
- lines.push(``);
174
- lines.push(` // Heartbeat`);
175
- lines.push(` const heartbeat = setInterval(() => {`);
176
- lines.push(` if (socket.readyState === WebSocket.OPEN) {`);
177
- lines.push(` socket.ping();`);
178
- lines.push(` } else {`);
179
- lines.push(` clearInterval(heartbeat);`);
180
- lines.push(` }`);
181
- lines.push(` }, 30000);`);
182
- lines.push(` });`);
183
- lines.push(``);
184
- lines.push(` // Bridge: forward eventBus events to WebSocket clients`);
185
- for (const ch of channels) {
186
- lines.push(` // Channel '${ch.name}' bridge`);
187
- }
188
- lines.push(``);
189
- // Redis subscription for cross-instance delivery
190
- lines.push(` // Subscribe to Redis channels for cross-instance delivery`);
191
- lines.push(` if (redisSub) {`);
192
- for (const ch of channels) {
193
- lines.push(` redisSub.subscribe("ws:${ch.name}", (message: string) => {`);
194
- lines.push(` const set = clients.get("${ch.name}");`);
195
- lines.push(` if (!set) return;`);
196
- lines.push(` for (const client of set) {`);
197
- lines.push(` if (client.socket.readyState === WebSocket.OPEN) client.socket.send(message);`);
198
- lines.push(` }`);
199
- lines.push(` }).catch(() => {});`);
200
- }
201
- lines.push(` }`);
202
- lines.push(` return wss;`);
203
- lines.push(`}`);
204
- lines.push(``);
205
- lines.push(`function broadcastToChannel(channel: string, message: any, exclude?: Client) {`);
206
- lines.push(` const set = clients.get(channel);`);
207
- lines.push(` const data = JSON.stringify(message);`);
208
- lines.push(` // Broadcast to local clients`);
209
- lines.push(` if (set) {`);
210
- lines.push(` for (const client of set) {`);
211
- lines.push(` if (client === exclude) continue;`);
212
- lines.push(` if (client.socket.readyState === WebSocket.OPEN) {`);
213
- lines.push(` client.socket.send(data);`);
214
- lines.push(` }`);
215
- lines.push(` }`);
216
- lines.push(` }`);
217
- lines.push(` // Publish to Redis for cross-instance delivery`);
218
- lines.push(` if (redisPub) {`);
219
- lines.push(` redisPub.publish(\`ws:\${channel}\`, data).catch(() => {});`);
220
- lines.push(` }`);
221
- lines.push(`}`);
222
- lines.push(``);
223
- lines.push(`export { broadcastToChannel };`);
224
-
225
- return lines.join("\n");
226
- }
1
+ /**
2
+ * BoneScript WebSocket Runtime Emitter
3
+ * Generates runnable WebSocket servers for `channel` declarations.
4
+ */
5
+
6
+ import * as IR from "./ir";
7
+
8
+ function toSnakeCase(s: string): string {
9
+ return s.replace(/([a-z])([A-Z])/g, "$1_$2").toLowerCase();
10
+ }
11
+
12
+ function toCamelCase(s: string): string {
13
+ return s.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
14
+ }
15
+
16
+ // ─── WebSocket Server ────────────────────────────────────────────────────────
17
+
18
+ export function emitWebSocketServer(system: IR.IRSystem): string {
19
+ const channels = system.modules.filter(m => m.kind === "realtime_service");
20
+ if (channels.length === 0) return "";
21
+
22
+ const lines: string[] = [];
23
+ lines.push(`// Generated by BoneScript compiler. DO NOT EDIT.`);
24
+ lines.push(`// WebSocket server for realtime channels`);
25
+ lines.push(``);
26
+ lines.push(`import { WebSocketServer, WebSocket } from "ws";`);
27
+ lines.push(`import { IncomingMessage, Server } from "http";`);
28
+ lines.push(`import jwt from "jsonwebtoken";`);
29
+ lines.push(`import { eventBus } from "./events";`);
30
+ lines.push(`import { logger } from "./logger";`);
31
+ lines.push(``);
32
+ lines.push(`const JWT_SECRET = process.env.JWT_SECRET || "bonescript-dev-secret-change-in-production";`);
33
+ lines.push(``);
34
+ // Redis pub/sub for multi-instance support
35
+ lines.push(`// Redis pub/sub for multi-instance WebSocket broadcasting`);
36
+ lines.push(`let redisSub: any = null;`);
37
+ lines.push(`let redisPub: any = null;`);
38
+ lines.push(`if (process.env.REDIS_URL) {`);
39
+ lines.push(` try {`);
40
+ lines.push(` const { createClient } = require("redis");`);
41
+ lines.push(` redisSub = createClient({ url: process.env.REDIS_URL });`);
42
+ lines.push(` redisPub = createClient({ url: process.env.REDIS_URL });`);
43
+ lines.push(` Promise.all([redisSub.connect(), redisPub.connect()]).then(() => {`);
44
+ lines.push(` logger.info("redis_connected", { event: "startup" });`);
45
+ lines.push(` }).catch((e: any) => {`);
46
+ lines.push(` logger.error("redis_connect_failed", { event: "startup", metadata: { error: e.message } });`);
47
+ lines.push(` redisSub = null; redisPub = null;`);
48
+ lines.push(` });`);
49
+ lines.push(` } catch { redisSub = null; redisPub = null; }`);
50
+ lines.push(`}`);
51
+
52
+ // Per-channel client registry
53
+ lines.push(`interface Client {`);
54
+ lines.push(` socket: WebSocket;`);
55
+ lines.push(` user_id: string;`);
56
+ lines.push(` channel: string;`);
57
+ lines.push(` topics: Set<string>;`);
58
+ lines.push(`}`);
59
+ lines.push(``);
60
+ lines.push(`const clients: Map<string, Set<Client>> = new Map();`);
61
+ lines.push(``);
62
+
63
+ // Channel configs
64
+ lines.push(`const CHANNELS: Record<string, { ordering: string; persistence: string; max_size: number }> = {`);
65
+ for (const ch of channels) {
66
+ lines.push(` "${ch.name}": {`);
67
+ lines.push(` ordering: "${ch.config["ordering"] || "fifo"}",`);
68
+ lines.push(` persistence: "${ch.config["persistence"] || "none"}",`);
69
+ lines.push(` max_size: ${ch.config["max_size"] || 10000},`);
70
+ lines.push(` },`);
71
+ }
72
+ lines.push(`};`);
73
+ lines.push(``);
74
+
75
+ // Message buffer for persistence
76
+ lines.push(`const messageBuffers: Map<string, any[]> = new Map();`);
77
+ lines.push(``);
78
+ lines.push(`function getBuffer(channel: string): any[] {`);
79
+ lines.push(` const buf = messageBuffers.get(channel);`);
80
+ lines.push(` if (buf) return buf;`);
81
+ lines.push(` const fresh: any[] = [];`);
82
+ lines.push(` messageBuffers.set(channel, fresh);`);
83
+ lines.push(` return fresh;`);
84
+ lines.push(`}`);
85
+ lines.push(``);
86
+ lines.push(`function persistMessage(channel: string, msg: any) {`);
87
+ lines.push(` const cfg = CHANNELS[channel];`);
88
+ lines.push(` if (!cfg || cfg.persistence === "none") return;`);
89
+ lines.push(` const buf = getBuffer(channel);`);
90
+ lines.push(` buf.push(msg);`);
91
+ lines.push(``);
92
+ lines.push(` // Honor persistence config (last_N, full)`);
93
+ lines.push(` const match = cfg.persistence.match(/^last_(\\d+)$/);`);
94
+ lines.push(` if (match) {`);
95
+ lines.push(` const limit = parseInt(match[1], 10);`);
96
+ lines.push(` while (buf.length > limit) buf.shift();`);
97
+ lines.push(` } else if (buf.length > cfg.max_size) {`);
98
+ lines.push(` buf.shift();`);
99
+ lines.push(` }`);
100
+ lines.push(`}`);
101
+ lines.push(``);
102
+
103
+ // Setup function
104
+ lines.push(`export function setupWebSocketServer(httpServer: Server): WebSocketServer {`);
105
+ lines.push(` const wss = new WebSocketServer({ server: httpServer, path: "/ws" });`);
106
+ lines.push(``);
107
+ lines.push(` wss.on("connection", (socket: WebSocket, req: IncomingMessage) => {`);
108
+ lines.push(` const url = new URL(req.url || "/", \`http://\${req.headers.host}\`);`);
109
+ lines.push(` const channel = url.searchParams.get("channel") || "";`);
110
+ lines.push(` const token = url.searchParams.get("token") || "";`);
111
+ lines.push(``);
112
+ lines.push(` if (!CHANNELS[channel]) {`);
113
+ lines.push(` socket.send(JSON.stringify({ type: "error", message: "Unknown channel: " + channel }));`);
114
+ lines.push(` socket.close();`);
115
+ lines.push(` return;`);
116
+ lines.push(` }`);
117
+ lines.push(``);
118
+ lines.push(` let userId: string;`);
119
+ lines.push(` try {`);
120
+ lines.push(` const decoded = jwt.verify(token, JWT_SECRET) as { sub: string };`);
121
+ lines.push(` userId = decoded.sub;`);
122
+ lines.push(` } catch {`);
123
+ lines.push(` socket.send(JSON.stringify({ type: "error", message: "Authentication failed" }));`);
124
+ lines.push(` socket.close();`);
125
+ lines.push(` return;`);
126
+ lines.push(` }`);
127
+ lines.push(``);
128
+ lines.push(` const client: Client = { socket, user_id: userId, channel, topics: new Set() };`);
129
+ lines.push(` const set = clients.get(channel) || new Set();`);
130
+ lines.push(` set.add(client);`);
131
+ lines.push(` clients.set(channel, set);`);
132
+ lines.push(``);
133
+ lines.push(` console.log(\`[ws] User \${userId} connected to \${channel} (\${set.size} active)\`);`);
134
+ lines.push(``);
135
+ lines.push(` // Send buffered history`);
136
+ lines.push(` const history = messageBuffers.get(channel) || [];`);
137
+ lines.push(` for (const msg of history) {`);
138
+ lines.push(` socket.send(JSON.stringify(msg));`);
139
+ lines.push(` }`);
140
+ lines.push(``);
141
+ lines.push(` socket.send(JSON.stringify({ type: "connected", channel, history_size: history.length }));`);
142
+ lines.push(``);
143
+ lines.push(` socket.on("message", (data) => {`);
144
+ lines.push(` try {`);
145
+ lines.push(` const msg = JSON.parse(data.toString());`);
146
+ lines.push(``);
147
+ lines.push(` if (msg.type === "subscribe" && msg.topic) {`);
148
+ lines.push(` client.topics.add(msg.topic);`);
149
+ lines.push(` return;`);
150
+ lines.push(` }`);
151
+ lines.push(` if (msg.type === "unsubscribe" && msg.topic) {`);
152
+ lines.push(` client.topics.delete(msg.topic);`);
153
+ lines.push(` return;`);
154
+ lines.push(` }`);
155
+ lines.push(``);
156
+ lines.push(` // Broadcast`);
157
+ lines.push(` const broadcast = {`);
158
+ lines.push(` type: msg.type || "message",`);
159
+ lines.push(` payload: msg.payload || msg,`);
160
+ lines.push(` from: userId,`);
161
+ lines.push(` timestamp: new Date().toISOString(),`);
162
+ lines.push(` };`);
163
+ lines.push(``);
164
+ lines.push(` persistMessage(channel, broadcast);`);
165
+ lines.push(` broadcastToChannel(channel, broadcast, client);`);
166
+ lines.push(` } catch (e: any) {`);
167
+ lines.push(` socket.send(JSON.stringify({ type: "error", message: e.message }));`);
168
+ lines.push(` }`);
169
+ lines.push(` });`);
170
+ lines.push(``);
171
+ lines.push(` socket.on("close", () => {`);
172
+ lines.push(` const set = clients.get(channel);`);
173
+ lines.push(` if (set) set.delete(client);`);
174
+ lines.push(` console.log(\`[ws] User \${userId} disconnected from \${channel}\`);`);
175
+ lines.push(` });`);
176
+ lines.push(``);
177
+ lines.push(` // Heartbeat`);
178
+ lines.push(` const heartbeat = setInterval(() => {`);
179
+ lines.push(` if (socket.readyState === WebSocket.OPEN) {`);
180
+ lines.push(` socket.ping();`);
181
+ lines.push(` } else {`);
182
+ lines.push(` clearInterval(heartbeat);`);
183
+ lines.push(` }`);
184
+ lines.push(` }, 30000);`);
185
+ lines.push(` });`);
186
+ lines.push(``);
187
+ lines.push(` // Bridge: forward eventBus events to WebSocket clients`);
188
+ for (const ch of channels) {
189
+ lines.push(` // Channel '${ch.name}' bridge`);
190
+ }
191
+ lines.push(``);
192
+ // Redis subscription for cross-instance delivery
193
+ lines.push(` // Subscribe to Redis channels for cross-instance delivery`);
194
+ lines.push(` if (redisSub) {`);
195
+ for (const ch of channels) {
196
+ lines.push(` redisSub.subscribe("ws:${ch.name}", (message: string) => {`);
197
+ lines.push(` const set = clients.get("${ch.name}");`);
198
+ lines.push(` if (!set) return;`);
199
+ lines.push(` for (const client of set) {`);
200
+ lines.push(` if (client.socket.readyState === WebSocket.OPEN) client.socket.send(message);`);
201
+ lines.push(` }`);
202
+ lines.push(` }).catch(() => {});`);
203
+ }
204
+ lines.push(` }`);
205
+ lines.push(` return wss;`);
206
+ lines.push(`}`);
207
+ lines.push(``);
208
+ lines.push(`function broadcastToChannel(channel: string, message: any, exclude?: Client) {`);
209
+ lines.push(` const set = clients.get(channel);`);
210
+ lines.push(` const data = JSON.stringify(message);`);
211
+ lines.push(` // Broadcast to local clients`);
212
+ lines.push(` if (set) {`);
213
+ lines.push(` for (const client of set) {`);
214
+ lines.push(` if (client === exclude) continue;`);
215
+ lines.push(` if (client.socket.readyState === WebSocket.OPEN) {`);
216
+ lines.push(` client.socket.send(data);`);
217
+ lines.push(` }`);
218
+ lines.push(` }`);
219
+ lines.push(` }`);
220
+ lines.push(` // Publish to Redis for cross-instance delivery`);
221
+ lines.push(` if (redisPub) {`);
222
+ lines.push(` redisPub.publish(\`ws:\${channel}\`, data).catch(() => {});`);
223
+ lines.push(` }`);
224
+ lines.push(`}`);
225
+ lines.push(``);
226
+ lines.push(`export { broadcastToChannel };`);
227
+
228
+ return lines.join("\n");
229
+ }