2026-11-04 10:24:09 -08:00
// Web console tests, the Send button: public/send-state.js decides whether
// Send is available and what its button says, from the shared page state. It
// only defines, so it imports here under plain Node and each case sets `page`
// directly.
// Run with: node --test scripts/test-web-console-send-state.mjs
import test from "node:test" ;
import assert from "node:assert/strict" ;
import { page , fresh } from "../src/web-console/public/state.js" ;
import { WORKING_GRACE_MS } from "../src/web-console/public/selectors.js" ;
2026-11-04 12:09:43 -08:00
import { sendState , suggestState } from "../src/web-console/public/send-state.js" ;
2026-11-04 10:24:09 -08:00
const MIN = 60 * 1000 ;
const ago = ( ms ) => new Date ( Date . now () - ms ). toISOString ();
const question = ( id = "q1" , extra = {}) => ({ id , kind : "choice" , title : "Export format" , status : "open" , required : true , ... extra });
// A waiting agent seen just now, one open question, nothing staged.
function setup ({ agent = { status : "waiting" }, items = [ question ()], ... S } = {}) {
page . S = { workflow : "test" , agent , items , ... S };
page . local = fresh ();
page . gone = false ;
page . pendingResult = false ;
page . agentLastSeen = ago ( 0 );
page . chatFrame = null ;
}
const working = ( sinceMs , extra = {}) => ({ status : "working" , since : ago ( sinceMs ), ... extra });
2026-11-17 18:08:01 -08:00
test ( "send state: a finished session is closed, and says stopped when its headline says paused" , () => {
2026-11-04 10:24:09 -08:00
setup ({ finish : { headline : "Phase 3 is done" } });
page . local . staged . q1 = { k : "A" };
2026-11-17 18:08:01 -08:00
// A finished session has nothing to send, ever: the button is hidden and the words stay.
assert . deepEqual ( sendState (), { disabled : true , why : "This session is finished." , short : "Session finished" , hide : true });
2026-11-04 10:24:09 -08:00
setup ({ finish : { headline : "Paused at Step 2" } });
2026-11-17 18:08:01 -08:00
assert . deepEqual ( sendState (), { disabled : true , why : "This session is stopped." , short : "Session stopped" , hide : true });
2026-11-04 10:24:09 -08:00
});
test ( "send state: a finish wins over a dropped connection" , () => {
setup ({ finish : { headline : "Done" } });
page . gone = true ;
assert . equal ( sendState (). short , "Session finished" );
});
test ( "send state: offline reads Not connected, whatever is staged" , () => {
setup ();
page . local . staged . q1 = { k : "A" };
page . gone = true ;
assert . deepEqual ( sendState (), { disabled : true , why : "Not connected right now." , short : "Not connected" });
});
test ( "send state: the loop driving locks Send until a question it does not handle waits" , () => {
setup ({ loop : { driving : true }, items : [ question ( "q1" , { handledBy : "loop" })] });
page . local . staged . q1 = { k : "A" };
assert . deepEqual ( sendState (), { disabled : true , why : "The loop is building. Cards unlock when it needs you." , short : "The loop is building" });
setup ({ loop : { driving : true }, items : [ question ( "q2" )] });
page . local . staged . q2 = { k : "A" };
assert . deepEqual ( sendState (), { disabled : false , why : "" }, "a question for the person unlocks it" );
setup ({ loop : { driving : true }, loopEnd : { at : ago ( 0 ) }, items : [ question ( "q1" , { handledBy : "loop" })] });
page . local . staged . q1 = { k : "A" };
assert . deepEqual ( sendState (), { disabled : false , why : "" }, "a posted loopEnd lets go of the page" );
});
test ( "send state: a send still being collected stays disabled, and says so once nobody comes for it" , () => {
setup ();
page . local . staged . q1 = { k : "A" };
page . pendingResult = true ;
assert . deepEqual ( sendState (), { disabled : true , why : "Your last answers are on their way. One moment." , short : "" });
page . agentLastSeen = ago ( 2 * MIN );
assert . deepEqual ( sendState (), {
disabled : true ,
why : "Saved, and waiting for Plan2Code to come back for them." ,
short : "Saved, not picked up" ,
});
});
test ( "send state: while the agent works, an answer or a note to an open question can still go" , () => {
setup ({ agent : working ( MIN ) });
page . local . staged . q1 = { k : "A" };
const open = { disabled : false , why : "Plan2Code is still working. Your answers wait for it to look." , short : "Still working · it reads this next" };
assert . deepEqual ( sendState (), open );
setup ({ agent : working ( MIN ) });
page . local . drafts [ "thread-q1" ] = "Prefer CSV for Excel." ;
assert . deepEqual ( sendState (), open , "a typed note counts as much as a staged answer" );
});
test ( "send state: a question already sent is not the person's turn while the agent works" , () => {
setup ({ agent : working ( MIN ) });
page . local . staged . q1 = { k : "A" };
page . local . sent . q1 = true ;
assert . deepEqual ( sendState (), { disabled : true , why : "Wait for Plan2Code to finish." , short : "" });
});
test ( "send state: past the working grace, something staged can be pushed through" , () => {
setup ({ agent : working ( WORKING_GRACE_MS + MIN ), items : [] });
page . local . staged . q1 = { k : "A" };
assert . deepEqual ( sendState (), { disabled : false , why : "Plan2Code has been busy a while. You can send anyway." , short : "Busy · send anyway" });
});
test ( "send state: past the working grace with nothing staged, open questions say a note unlocks Send" , () => {
setup ({ agent : working ( WORKING_GRACE_MS + MIN ), items : [ question ( "q1" , { submitted : { at : ago ( MIN ) } })] });
assert . deepEqual ( sendState (), {
disabled : true ,
why : "Plan2Code has been busy a while. Answer something or add a note, and you can send anyway." ,
short : "Busy · a note unlocks Send" ,
});
setup ({ agent : working ( WORKING_GRACE_MS + MIN ), items : [] });
assert . deepEqual ( sendState (), { disabled : true , why : "Plan2Code has been busy a while." , short : "Busy a while" });
});
test ( "send state: quietMinutes stretches the working grace" , () => {
setup ({ agent : working ( 10 * MIN , { quietMinutes : 30 }), items : [] });
page . local . staged . q1 = { k : "A" };
assert . deepEqual ( sendState (), { disabled : true , why : "Wait for Plan2Code to finish." , short : "" });
setup ({ agent : working ( 31 * MIN , { quietMinutes : 30 }), items : [] });
page . local . staged . q1 = { k : "A" };
assert . equal ( sendState (). short , "Busy · send anyway" , "past the stretched grace the hatch opens" );
});
test ( "send state: inside the working grace Send waits, and reads Gone quiet once the agent is adrift" , () => {
setup ({ agent : working ( MIN ), items : [] });
assert . deepEqual ( sendState (), { disabled : true , why : "Wait for Plan2Code to finish." , short : "" });
setup ({ agent : working ( 4 * MIN ), items : [] });
page . agentLastSeen = ago ( 4 * MIN );
assert . deepEqual ( sendState (), { disabled : true , why : "Wait for Plan2Code to finish." , short : "Gone quiet" });
});
test ( "send state: an idle page enables Send only once something is staged or typed" , () => {
setup ();
assert . deepEqual ( sendState (), { disabled : true , why : "" });
page . local . staged . q1 = { k : "A" };
assert . deepEqual ( sendState (), { disabled : false , why : "" });
setup ();
page . local . drafts [ "thread-q1" ] = " " ;
assert . deepEqual ( sendState (), { disabled : true , why : "" }, "a blank note is nothing to send" );
});
test ( "send state: a note waits while its picture uploads, and goes once it is ready" , () => {
setup ();
page . local . drafts [ "thread-q1" ] = "See the screenshot." ;
page . local . images . q1 = [{ key : "a" , status : "uploading" }];
assert . deepEqual ( sendState (), { disabled : true , why : "" }, "a held note is not sent" );
page . local . images . q1 = [{ key : "a" , status : "ready" , url : "/uploads/a.jpg" }];
assert . deepEqual ( sendState (), { disabled : false , why : "" });
});
2026-11-04 12:09:43 -08:00
test ( "send state: told there is something to send, an idle page enables it with nothing staged" , () => {
setup ();
assert . deepEqual ( sendState (), { disabled : true , why : "" }, "left out, it reads what is staged" );
assert . deepEqual ( sendState ( true ), { disabled : false , why : "" });
assert . deepEqual ( sendState ( false ), { disabled : true , why : "" });
});
test ( "suggest state: the chip follows Send, and waits while its own request does" , () => {
const ready = { disabled : false , why : "Ask Plan2Code what it would pick here, and why." };
setup ();
assert . deepEqual ( suggestState ( question ()), ready , "nothing staged is needed: the request is the payload" );
setup ({ finish : { headline : "Phase 3 is done" } });
assert . deepEqual ( suggestState ( question ()), { disabled : true , why : "This session is finished." });
setup ();
page . pendingResult = true ;
assert . deepEqual ( suggestState ( question ()), { disabled : true , why : "Your last answers are on their way. One moment." });
const at = ago ( MIN );
const asked = question ( "q1" , { sentNote : { at , text : "" , suggest : true }, thread : [{ who : "user" , at , text : "" , suggest : true }] });
setup ({ items : [ asked ] });
assert . deepEqual ( suggestState ( asked ), { disabled : true , why : "Plan2Code has your request for suggestions on this one." });
const plain = question ( "q1" , { sentNote : { at , text : "Hm" }, thread : [{ who : "user" , at , text : "Hm" }] });
setup ({ items : [ plain ] });
assert . deepEqual ( suggestState ( plain ), ready , "a plain note waiting does not hold the chip" );
const replied = { ... asked , thread : [... asked . thread , { who : "agent" , at : ago ( 0 ), text : "I would pick CSV." }] };
setup ({ items : [ replied ] });
assert . deepEqual ( suggestState ( replied ), ready , "the agent's reply frees it" );
});
2026-11-17 18:08:01 -08:00
// One phrase for a page that lost the server (Help's "Not connected" state):
// the constant is exported, the send button uses it, and every other place
// that says it imports it instead of typing its own wording.
test ( "the not-connected phrase is one exported constant and the sites use it" , async () => {
const { NOT_CONNECTED , NOT_CONNECTED_KEPT , notConnected } = await import ( "../src/web-console/public/labels.js" );
assert . equal ( NOT_CONNECTED , "Not connected right now." );
assert . equal ( notConnected (), NOT_CONNECTED );
assert . equal ( notConnected ( NOT_CONNECTED_KEPT ), ` ${ NOT_CONNECTED } ${ NOT_CONNECTED_KEPT } ` );
setup ();
page . gone = true ;
assert . equal ( sendState (). why , NOT_CONNECTED );
const fs = await import ( "node:fs" );
const root = new URL ( "../src/web-console/public/" , import . meta . url );
const sites = [ "send-state.js" , "notepad.js" , "screens/core.js" , "screens/cleanup.js" , "screens/learning-row.js" , "screens/ask.js" , "screens/notepad.js" , "screens/ending.js" ];
for ( const file of sites ) {
const text = fs . readFileSync ( new URL ( file , root ), "utf8" );
assert . match ( text , /labels\.js"/ , ` ${ file } imports the constant` );
assert . doesNotMatch ( text , /["'`][^"'`\n]*(Lost contact with Plan2Code|Plan2Code is not reachable|Plan2Code is not answering)/ , ` ${ file } types no wording of its own` );
}
});