bonescript-compiler 0.5.3 → 0.5.4

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 (194) 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 +543 -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_runtime.d.ts +11 -17
  22. package/dist/emit_runtime.js +688 -29
  23. package/dist/emit_runtime.js.map +1 -1
  24. package/dist/emit_sourcemap.js +66 -66
  25. package/dist/emit_tests.js +12 -47
  26. package/dist/emit_tests.js.map +1 -1
  27. package/dist/emit_websocket.js +3 -0
  28. package/dist/emit_websocket.js.map +1 -1
  29. package/dist/emitter.js +49 -94
  30. package/dist/emitter.js.map +1 -1
  31. package/dist/extension_manager.d.ts +2 -2
  32. package/dist/extension_manager.js +20 -9
  33. package/dist/extension_manager.js.map +1 -1
  34. package/dist/ir.d.ts +0 -4
  35. package/dist/lowering.d.ts +14 -5
  36. package/dist/lowering.js +417 -66
  37. package/dist/lowering.js.map +1 -1
  38. package/dist/module_loader.d.ts +2 -2
  39. package/dist/module_loader.js +23 -20
  40. package/dist/module_loader.js.map +1 -1
  41. package/dist/optimizer.js +3 -6
  42. package/dist/optimizer.js.map +1 -1
  43. package/dist/scaffold.d.ts +2 -2
  44. package/dist/scaffold.js +319 -315
  45. package/dist/scaffold.js.map +1 -1
  46. package/dist/solver.js +1 -1
  47. package/dist/solver.js.map +1 -1
  48. package/dist/source_map.js.map +1 -0
  49. package/dist/test.js.map +1 -0
  50. package/dist/test_typechecker.d.ts +5 -0
  51. package/dist/test_typechecker.js +126 -0
  52. package/dist/test_typechecker.js.map +1 -0
  53. package/dist/typechecker.d.ts +0 -7
  54. package/dist/typechecker.js +16 -103
  55. package/dist/typechecker.js.map +1 -1
  56. package/dist/verifier.d.ts +1 -5
  57. package/dist/verifier.js +38 -142
  58. package/dist/verifier.js.map +1 -1
  59. package/package.json +52 -62
  60. package/src/algorithm_catalog.ts +345 -345
  61. package/src/ast.d.ts +244 -0
  62. package/src/ast.ts +334 -334
  63. package/src/cli.ts +624 -98
  64. package/src/emit_batch.ts +140 -140
  65. package/src/emit_capability.ts +436 -613
  66. package/src/emit_composition.ts +196 -229
  67. package/src/emit_deploy.ts +190 -187
  68. package/src/emit_events.ts +307 -362
  69. package/src/emit_extras.ts +240 -237
  70. package/src/emit_full.ts +309 -472
  71. package/src/emit_maintenance.ts +459 -459
  72. package/src/emit_runtime.ts +730 -17
  73. package/src/emit_sourcemap.ts +140 -140
  74. package/src/emit_tests.ts +205 -243
  75. package/src/emit_websocket.ts +229 -226
  76. package/src/emitter.ts +578 -626
  77. package/src/extension_manager.ts +187 -177
  78. package/src/formatter.ts +297 -297
  79. package/src/index.ts +88 -88
  80. package/src/ir.ts +215 -216
  81. package/src/lexer.d.ts +195 -0
  82. package/src/lexer.ts +630 -630
  83. package/src/lowering.ts +556 -168
  84. package/src/module_loader.ts +114 -112
  85. package/src/optimizer.ts +196 -199
  86. package/src/parse_decls.d.ts +13 -0
  87. package/src/parse_decls.ts +409 -409
  88. package/src/parse_decls2.d.ts +13 -0
  89. package/src/parse_decls2.ts +244 -244
  90. package/src/parse_expr.d.ts +7 -0
  91. package/src/parse_expr.ts +197 -197
  92. package/src/parse_types.d.ts +6 -0
  93. package/src/parse_types.ts +54 -54
  94. package/src/parser.d.ts +10 -0
  95. package/src/parser.ts +1 -1
  96. package/src/parser_base.d.ts +19 -0
  97. package/src/parser_base.ts +57 -57
  98. package/src/parser_recovery.ts +153 -153
  99. package/src/scaffold.ts +375 -371
  100. package/src/solver.ts +330 -330
  101. package/src/typechecker.d.ts +52 -0
  102. package/src/typechecker.ts +591 -700
  103. package/src/types.d.ts +38 -0
  104. package/src/types.ts +122 -122
  105. package/src/verifier.ts +49 -154
  106. package/README.md +0 -382
  107. package/dist/commands/check.d.ts +0 -5
  108. package/dist/commands/check.js +0 -34
  109. package/dist/commands/check.js.map +0 -1
  110. package/dist/commands/compile.d.ts +0 -5
  111. package/dist/commands/compile.js +0 -215
  112. package/dist/commands/compile.js.map +0 -1
  113. package/dist/commands/debug.d.ts +0 -5
  114. package/dist/commands/debug.js +0 -59
  115. package/dist/commands/debug.js.map +0 -1
  116. package/dist/commands/diff.d.ts +0 -5
  117. package/dist/commands/diff.js +0 -123
  118. package/dist/commands/diff.js.map +0 -1
  119. package/dist/commands/fmt.d.ts +0 -5
  120. package/dist/commands/fmt.js +0 -49
  121. package/dist/commands/fmt.js.map +0 -1
  122. package/dist/commands/init.d.ts +0 -5
  123. package/dist/commands/init.js +0 -96
  124. package/dist/commands/init.js.map +0 -1
  125. package/dist/commands/ir.d.ts +0 -5
  126. package/dist/commands/ir.js +0 -27
  127. package/dist/commands/ir.js.map +0 -1
  128. package/dist/commands/lex.d.ts +0 -5
  129. package/dist/commands/lex.js +0 -21
  130. package/dist/commands/lex.js.map +0 -1
  131. package/dist/commands/parse.d.ts +0 -5
  132. package/dist/commands/parse.js +0 -30
  133. package/dist/commands/parse.js.map +0 -1
  134. package/dist/commands/test.d.ts +0 -5
  135. package/dist/commands/test.js +0 -61
  136. package/dist/commands/test.js.map +0 -1
  137. package/dist/commands/verify_determinism.d.ts +0 -5
  138. package/dist/commands/verify_determinism.js +0 -64
  139. package/dist/commands/verify_determinism.js.map +0 -1
  140. package/dist/commands/watch.d.ts +0 -5
  141. package/dist/commands/watch.js +0 -50
  142. package/dist/commands/watch.js.map +0 -1
  143. package/dist/emit_auth.d.ts +0 -18
  144. package/dist/emit_auth.js +0 -507
  145. package/dist/emit_auth.js.map +0 -1
  146. package/dist/emit_database.d.ts +0 -7
  147. package/dist/emit_database.js +0 -72
  148. package/dist/emit_database.js.map +0 -1
  149. package/dist/emit_index.d.ts +0 -6
  150. package/dist/emit_index.js +0 -202
  151. package/dist/emit_index.js.map +0 -1
  152. package/dist/emit_models.d.ts +0 -12
  153. package/dist/emit_models.js +0 -171
  154. package/dist/emit_models.js.map +0 -1
  155. package/dist/emit_openapi.d.ts +0 -9
  156. package/dist/emit_openapi.js +0 -306
  157. package/dist/emit_openapi.js.map +0 -1
  158. package/dist/emit_package.d.ts +0 -7
  159. package/dist/emit_package.js +0 -68
  160. package/dist/emit_package.js.map +0 -1
  161. package/dist/emit_router.d.ts +0 -12
  162. package/dist/emit_router.js +0 -389
  163. package/dist/emit_router.js.map +0 -1
  164. package/dist/lowering_channels.d.ts +0 -11
  165. package/dist/lowering_channels.js +0 -103
  166. package/dist/lowering_channels.js.map +0 -1
  167. package/dist/lowering_entities.d.ts +0 -11
  168. package/dist/lowering_entities.js +0 -232
  169. package/dist/lowering_entities.js.map +0 -1
  170. package/dist/lowering_helpers.d.ts +0 -13
  171. package/dist/lowering_helpers.js +0 -76
  172. package/dist/lowering_helpers.js.map +0 -1
  173. package/src/commands/check.ts +0 -33
  174. package/src/commands/compile.ts +0 -191
  175. package/src/commands/debug.ts +0 -33
  176. package/src/commands/diff.ts +0 -105
  177. package/src/commands/fmt.ts +0 -22
  178. package/src/commands/init.ts +0 -72
  179. package/src/commands/ir.ts +0 -23
  180. package/src/commands/lex.ts +0 -17
  181. package/src/commands/parse.ts +0 -24
  182. package/src/commands/test.ts +0 -36
  183. package/src/commands/verify_determinism.ts +0 -66
  184. package/src/commands/watch.ts +0 -25
  185. package/src/emit_auth.ts +0 -513
  186. package/src/emit_database.ts +0 -72
  187. package/src/emit_index.ts +0 -210
  188. package/src/emit_models.ts +0 -176
  189. package/src/emit_openapi.ts +0 -315
  190. package/src/emit_package.ts +0 -66
  191. package/src/emit_router.ts +0 -408
  192. package/src/lowering_channels.ts +0 -108
  193. package/src/lowering_entities.ts +0 -258
  194. 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
+ }