examples/endpoint-router-demo/lib/MyApp/Main.pm

filter: Statementstmt 85.3% 64 / 75 Branchbran 25.0% 1 / 4 Conditioncond 50.0% 2 / 4 MC/DCmcdc 0.0% 0 / 2 Subroutinesub 81.2% 13 / 16 Podpod 25.0% 1 / 4 totaltotal 77.1% 81 / 105 CC 5 SCAR 7.7
CC
5
Cov
81%
__ANON__
6.0
sse_metrics
4.0
ws_echo
2.1
CRAP 2.2
« lib/PAGI/App/NotFound.pm ↑ Summary blib/lib/PAGI/Endpoint/SSE.pm »
1 package MyApp::Main;
2 1 ▶use parent 'PAGI::Endpoint::Router';
Subroutine BEGIN: called CC=1 SCAR=0.0
3 1 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
4 1 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
5 1 ▶use Future::AsyncAwait;
Subroutine BEGIN: called CC=1 SCAR=0.0
6  
7 1 ▶use MyApp::API;
Subroutine BEGIN: called CC=1 SCAR=0.0
8 1 ▶use PAGI::App::File;
Subroutine BEGIN: called CC=1 SCAR=0.0
9 1 ▶use File::Spec;
Subroutine BEGIN: called CC=1 SCAR=0.0
10 1 ▶use File::Basename qw(dirname);
Subroutine BEGIN: called CC=1 SCAR=0.0
11  
12 1 ▶sub routes {
Subroutine routes: called CC=1 SCAR=0.0
Pod documented
13 1 my ($self, $r) = @_;
14  
15 # Home page
16 1 $r->get('/' => 'home');
17  
18 # API subrouter
19 1 $r->mount('/api' => 'MyApp::API');
20  
21 # WebSocket echo
22 1 $r->websocket('/ws/echo' => 'ws_echo');
23  
24 # SSE metrics
25 1 $r->sse('/events/metrics' => 'sse_metrics');
26  
27 # Static files - find the root directory dynamically
28 1 my $root = File::Spec->catdir(dirname(__FILE__), '..', '..', 'public');
29 1 $r->mount('/' => PAGI::App::File->new(root => $root));
30 }
31  
32 1 ▶async sub home {
Subroutine home: called CC=1 SCAR=0.0
Pod undocumented
33 1 my ($self, $ctx) = @_;
34  
35 # Count HTTP requests
36 1 $ctx->state->{metrics}{requests}++;
37  
38 # Access config via $ctx->state (populated by Lifespan startup)
39 1 my $config = $ctx->state->{config};
40  
41 1 my $html = <<"HTML";
42 <!DOCTYPE html>
43 <html>
44 <head>
45 <title>$config->{app_name}</title>
46 <style>
47 body { font-family: system-ui, sans-serif; max-width: 900px; margin: 2rem auto; padding: 0 1rem; }
48 h1 { color: #333; }
49 .section { background: #f5f5f5; border-radius: 8px; padding: 1rem; margin: 1rem 0; }
50 .section h2 { margin-top: 0; color: #555; }
51 input, button { padding: 0.5rem; font-size: 1rem; }
52 button { background: #007bff; color: white; border: none; border-radius: 4px; cursor: pointer; }
53 button:hover { background: #0056b3; }
54 button:disabled { background: #ccc; }
55 #ws-log, #sse-log { background: #1e1e1e; color: #0f0; padding: 1rem; border-radius: 4px;
56 height: 150px; overflow-y: auto; font-family: monospace; font-size: 0.9rem; }
57 .status { padding: 0.25rem 0.5rem; border-radius: 4px; font-size: 0.8rem; }
58 .connected { background: #28a745; color: white; }
59 .disconnected { background: #dc3545; color: white; }
60 a { color: #007bff; }
61 </style>
62 </head>
63 <body>
64 <h1>$config->{app_name}</h1>
65 <p>Version: $config->{version} | Demonstrates PAGI::Endpoint::Router with HTTP, WebSocket, and SSE</p>
66  
67 <div class="section">
68 <h2>REST API</h2>
69 <p>
70 <a href="/api/info">/api/info</a> - App information |
71 <a href="/api/users">/api/users</a> - List users |
72 <a href="/api/users/1">/api/users/1</a> - Get user by ID
73 </p>
74 <h3>Users <button id="refresh-users" style="font-size: 0.8rem;">Refresh</button></h3>
75 <div id="users-list" style="background: #fff; padding: 0.5rem; border-radius: 4px; margin-bottom: 1rem;"></div>
76 <h3>Create User</h3>
77 <p>
78 <input type="text" id="user-name" placeholder="Name" style="width: 150px;">
79 <input type="email" id="user-email" placeholder="Email" style="width: 200px;">
80 <button id="create-user">Create</button>
81 <span id="create-status" style="margin-left: 0.5rem;"></span>
82 </p>
83 </div>
84  
85 <div class="section">
86 <h2>WebSocket Echo <span id="ws-status" class="status disconnected">Disconnected</span></h2>
87 <p>
88 <input type="text" id="ws-input" placeholder="Type a message..." style="width: 300px;">
89 <button id="ws-send">Send</button>
90 <button id="ws-connect">Connect</button>
91 </p>
92 <div id="ws-log"></div>
93 </div>
94  
95 <div class="section">
96 <h2>SSE Metrics Stream <span id="sse-status" class="status disconnected">Disconnected</span></h2>
97 <p>
98 <button id="sse-connect">Connect</button>
99 <button id="sse-disconnect" disabled>Disconnect</button>
100 <span style="margin-left: 1rem;">Try disconnecting and reconnecting to see missed event count!</span>
101 </p>
102 <div id="sse-log"></div>
103 </div>
104  
105 <script>
106 // WebSocket Demo
107 let ws = null;
108 const wsLog = document.getElementById('ws-log');
109 const wsStatus = document.getElementById('ws-status');
110 const wsInput = document.getElementById('ws-input');
111 const wsSend = document.getElementById('ws-send');
112 const wsConnect = document.getElementById('ws-connect');
113  
114 function logWs(msg, type = 'info') {
115 const color = type === 'sent' ? '#ff0' : type === 'recv' ? '#0f0' : '#888';
116 wsLog.innerHTML += '<div style="color:' + color + '">' + new Date().toLocaleTimeString() + ' ' + msg + '</div>';
117 wsLog.scrollTop = wsLog.scrollHeight;
118 }
119  
120 wsConnect.onclick = () => {
121 if (ws) { ws.close(); return; }
122 ws = new WebSocket('ws://' + location.host + '/ws/echo');
123 ws.onopen = () => {
124 wsStatus.textContent = 'Connected';
125 wsStatus.className = 'status connected';
126 wsConnect.textContent = 'Disconnect';
127 logWs('Connected to /ws/echo');
128 };
129 ws.onclose = () => {
130 wsStatus.textContent = 'Disconnected';
131 wsStatus.className = 'status disconnected';
132 wsConnect.textContent = 'Connect';
133 logWs('Disconnected');
134 ws = null;
135 };
136 ws.onmessage = (e) => {
137 const data = JSON.parse(e.data);
138 logWs('Received: ' + JSON.stringify(data), 'recv');
139 };
140 };
141  
142 wsSend.onclick = () => {
143 if (!ws || ws.readyState !== WebSocket.OPEN) { alert('Not connected!'); return; }
144 const msg = wsInput.value || 'Hello!';
145 ws.send(JSON.stringify({ text: msg, timestamp: Date.now() }));
146 logWs('Sent: ' + msg, 'sent');
147 wsInput.value = '';
148 };
149  
150 wsInput.onkeypress = (e) => { if (e.key === 'Enter') wsSend.click(); };
151  
152 // SSE Demo
153 let sse = null;
154 const sseLog = document.getElementById('sse-log');
155 const sseStatus = document.getElementById('sse-status');
156 const sseConnect = document.getElementById('sse-connect');
157 const sseDisconnect = document.getElementById('sse-disconnect');
158  
159 function logSse(msg, type = 'info') {
160 const color = type === 'event' ? '#0ff' : type === 'reconnect' ? '#ff0' : '#0f0';
161 sseLog.innerHTML += '<div style="color:' + color + '">' + new Date().toLocaleTimeString() + ' ' + msg + '</div>';
162 sseLog.scrollTop = sseLog.scrollHeight;
163 }
164  
165 sseConnect.onclick = () => {
166 sse = new EventSource('/events/metrics');
167 sseStatus.textContent = 'Connecting...';
168 sseConnect.disabled = true;
169 sseDisconnect.disabled = false;
170  
171 sse.addEventListener('connected', (e) => {
172 sseStatus.textContent = 'Connected';
173 sseStatus.className = 'status connected';
174 logSse('Connected: ' + e.data, 'event');
175 });
176  
177 sse.addEventListener('reconnected', (e) => {
178 sseStatus.textContent = 'Reconnected';
179 sseStatus.className = 'status connected';
180 logSse('Reconnected: ' + e.data, 'reconnect');
181 });
182  
183 sse.addEventListener('metrics', (e) => {
184 const data = JSON.parse(e.data);
185 logSse('Metrics: requests=' + data.requests + ' ws_active=' + data.ws_active + ' ws_msgs=' + (data.ws_messages || 0) + ' seq=' + data.sse_seq, 'event');
186 });
187  
188 sse.onerror = () => {
189 if (sse.readyState === EventSource.CLOSED) {
190 sseStatus.textContent = 'Disconnected';
191 sseStatus.className = 'status disconnected';
192 logSse('Connection closed');
193 } else {
194 sseStatus.textContent = 'Reconnecting...';
195 logSse('Connection lost, reconnecting...');
196 }
197 };
198 };
199  
200 sseDisconnect.onclick = () => {
201 if (sse) { sse.close(); sse = null; }
202 sseStatus.textContent = 'Disconnected';
203 sseStatus.className = 'status disconnected';
204 sseConnect.disabled = false;
205 sseDisconnect.disabled = true;
206 logSse('Manually disconnected');
207 };
208  
209 // REST API Demo
210 const usersList = document.getElementById('users-list');
211 const refreshUsers = document.getElementById('refresh-users');
212 const createUser = document.getElementById('create-user');
213 const userName = document.getElementById('user-name');
214 const userEmail = document.getElementById('user-email');
215 const createStatus = document.getElementById('create-status');
216  
217 async function loadUsers() {
218 try {
219 const res = await fetch('/api/users');
220 const users = await res.json();
221 usersList.innerHTML = users.map(u =>
222 '<div style="padding: 0.25rem 0; border-bottom: 1px solid #eee;">' +
223 '<strong>' + u.name + '</strong> (' + u.email + ') - ID: ' + u.id + '</div>'
224 ).join('');
225 } catch (e) {
226 usersList.innerHTML = '<em>Error loading users</em>';
227 }
228 }
229  
230 refreshUsers.onclick = loadUsers;
231  
232 createUser.onclick = async () => {
233 const name = userName.value.trim();
234 const email = userEmail.value.trim();
235 if (!name || !email) {
236 createStatus.textContent = 'Name and email required';
237 createStatus.style.color = 'red';
238 return;
239 }
240 try {
241 const res = await fetch('/api/users', {
242 method: 'POST',
243 headers: { 'Content-Type': 'application/json' },
244 body: JSON.stringify({ name, email })
245 });
246 if (res.ok) {
247 const user = await res.json();
248 createStatus.textContent = 'Created user #' + user.id;
249 createStatus.style.color = 'green';
250 userName.value = '';
251 userEmail.value = '';
252 loadUsers();
253 } else {
254 createStatus.textContent = 'Error: ' + res.status;
255 createStatus.style.color = 'red';
256 }
257 } catch (e) {
258 createStatus.textContent = 'Error: ' + e.message;
259 createStatus.style.color = 'red';
260 }
261 };
262  
263 // Load users on page load
264 loadUsers();
265 </script>
266 </body>
267 </html>
268 HTML
269  
270 1 return $ctx->html($html);
271 1 }
272  
273 1 ▶async sub ws_echo {
Subroutine ws_echo: called CC=2 SCAR=7.3
Pod undocumented
274 1 my ($self, $ctx) = @_;
275 1 my $ws = $ctx->websocket;
276  
277 1 await $ws->accept;
278 1 await $ws->keepalive(25);
279  
280 # Access metrics via $ctx->state (populated by Lifespan startup)
281 1 my $metrics = $ctx->state->{metrics};
282 1 $metrics->{requests}++; # Count the WebSocket upgrade request
283 1 $metrics->{ws_active}++;
284 1 ▶ $metrics->{ws_messages} //= 0;
Condition50%1/2
$metrics->{"ws_messages"} //= 0
l!l
01
MC/DC0%0/1
$metrics->{"ws_messages"} //= 0
$metrics->{"ws_messages"}
Truth table50%1/2
A
A= $metrics->{"ws_messages"}
Aresult
11
00
285  
286 1 ▶ $ws->on_close(sub {
Subroutine __ANON__: called CC=1 SCAR=0.0
287 1 $metrics->{ws_active}--;
288 1 });
289  
290 1 await $ws->send_json({ type => 'connected' });
291  
292 0 ▶ await $ws->each_json(async sub {
Subroutine __ANON__: not called CC=1 SCAR=6.9
293 0 my ($data) = @_;
294 0 $metrics->{ws_messages}++; # Count each message received
295 0 await $ws->send_json({ type => 'echo', data => $data });
296 1 });
297 1 }
298  
299 1 ▶async sub sse_metrics {
Subroutine sse_metrics: called CC=3 SCAR=13.8
Pod undocumented
300 1 my ($self, $ctx) = @_;
301 1 my $sse = $ctx->sse;
302  
303 # Access metrics via $ctx->state (populated by Lifespan startup)
304 1 my $metrics = $ctx->state->{metrics};
305  
306 # Track sequence number for reconnection detection
307 # In production, you'd store this per-client or use timestamps
308 1 ▶ $metrics->{sse_seq} //= 0;
Condition50%1/2
$metrics->{"sse_seq"} //= 0
l!l
01
MC/DC0%0/1
$metrics->{"sse_seq"} //= 0
$metrics->{"sse_seq"}
Truth table50%1/2
A
A= $metrics->{"sse_seq"}
Aresult
11
00
309  
310 # Check if this is a reconnection (browser sends Last-Event-ID header)
311 1 ▶ if (my $last_id = $sse->last_event_id) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $last_id = $sse->last_event_id) { } 0 1 1
312 0 my $missed = $metrics->{sse_seq} - $last_id;
313 await $sse->send_event(
314 event => 'reconnected',
315 data => {
316 last_seen_id => $last_id,
317 current_id => $metrics->{sse_seq},
318 missed => $missed,
319 message => "Welcome back! You missed $missed updates.",
320 },
321 id => $metrics->{sse_seq},
322 0 retry => 3000, # Reconnect after 3 seconds if disconnected
323 );
324 } else {
325 await $sse->send_event(
326 event => 'connected',
327 data => { status => 'ok', message => 'Fresh connection' },
328 id => $metrics->{sse_seq},
329 1 retry => 3000,
330 );
331 }
332  
333 # Enable keepalive to prevent proxy timeouts
334 1 await $sse->keepalive(15);
335  
336 # Log disconnect reason - useful for debugging connection issues
337 0 ▶ $sse->on_close(sub {
Subroutine __ANON__: not called CC=2 SCAR=17.9
338 0 my ($sse, $reason) = @_;
339 # In production, you might track this in metrics or logs
340 0 ▶ warn "SSE client disconnected: $reason\n"
Branch: 1 branch
BranchTrueFalseTotal
unless $reason eq "client_closed" 0 0 0
341 unless $reason eq 'client_closed'; # Only log unexpected disconnects
342 1 });
343  
344 # Send metrics every 2 seconds using loop-agnostic every()
345 # Requires Future::IO to be installed
346 0 ▶ await $sse->every(2, async sub {
Subroutine __ANON__: not called CC=1 SCAR=6.9
347 0 $metrics->{sse_seq}++;
348 await $sse->send_event(
349 event => 'metrics',
350 data => $metrics,
351 id => $metrics->{sse_seq},
352 0 );
353 1 });
354 1 }
355  
356 1 1;
« lib/PAGI/App/NotFound.pm ↑ Summary blib/lib/PAGI/Endpoint/SSE.pm »