From 392174c5e36c71fe8827213e6370aa147f640219 Mon Sep 17 00:00:00 2001
From: onoderakosen89 <72384345+onoderakosen89@users.noreply.github.com>
Date: Wed, 18 Nov 2026 23:24:38 -0500
Subject: [PATCH 1/2] Set up saved-note workflow and independent checks
---
examples/save-and-reload/app.mjs | 67 +++++++++++++++++++++
examples/save-and-reload/storage.test.mjs | 14 +++++
examples/save-and-reload/workflow.test.mjs | 68 ++++++++++++++++++++++
3 files changed, 149 insertions(+)
create mode 100644 examples/save-and-reload/app.mjs
create mode 100644 examples/save-and-reload/storage.test.mjs
create mode 100644 examples/save-and-reload/workflow.test.mjs
diff --git a/examples/save-and-reload/app.mjs b/examples/save-and-reload/app.mjs
new file mode 100644
index 0000000..092fe03
--- /dev/null
+++ b/examples/save-and-reload/app.mjs
@@ -0,0 +1,67 @@
+import { createServer } from 'node:http';
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseArgs } from 'node:util';
+
+export async function readNote(file) {
+ try { return await readFile(file, 'utf8'); }
+ catch (error) {
+ if (error.code === 'ENOENT') return '';
+ throw error;
+ }
+}
+
+export async function writeNote(file, note) {
+ await writeFile(file, note, 'utf8');
+}
+
+function escapeHtml(value) {
+ return value.replaceAll('&', '&').replaceAll('<', '<').replaceAll('>', '>');
+}
+
+export function createApp({ directory, simulateBadWiring = false }) {
+ const readable = join(directory, 'note.txt');
+ const writable = join(directory, 'draft.txt');
+ return createServer(async (request, response) => {
+ try {
+ if (request.url !== '/' || !['GET', 'POST'].includes(request.method)) {
+ response.writeHead(404).end();
+ return;
+ }
+ let status = '';
+ if (request.method === 'POST') {
+ let body = '';
+ for await (const chunk of request) {
+ body += chunk;
+ if (body.length > 8192) {
+ response.writeHead(413).end();
+ return;
+ }
+ }
+ await writeNote(writable, new URLSearchParams(body).get('note') ?? '');
+ status = '
Saved
';
+ }
+ const note = escapeHtml(await readNote(readable));
+ response.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' }).end(
+ 'Save a note' +
+ 'Save a note
' + status +
+ '',
+ );
+ } catch {
+ response.writeHead(500).end('Note storage unavailable.');
+ }
+ });
+}
+
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+ const { values } = parseArgs({ options: {
+ data: { type: 'string' },
+ port: { type: 'string', default: '3000' },
+ 'miswired': { type: 'boolean' },
+ } });
+ if (!values.data) throw new Error('Choose an existing data directory with --data DIR.');
+ const app = createApp({ directory: values.data, simulateBadWiring: values.miswired });
+ app.listen(Number(values.port), '127.0.0.1', () => console.log('http://127.0.0.1:' + app.address().port));
+}
diff --git a/examples/save-and-reload/storage.test.mjs b/examples/save-and-reload/storage.test.mjs
new file mode 100644
index 0000000..a7eacf2
--- /dev/null
+++ b/examples/save-and-reload/storage.test.mjs
@@ -0,0 +1,14 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import test from 'node:test';
+import { readNote, writeNote } from './app.mjs';
+
+test('the storage function writes and reads an explicit file', async t => {
+ const directory = await mkdtemp(join(tmpdir(), 'tfl-storage-'));
+ t.after(() => rm(directory, { recursive: true, force: true }));
+ const file = join(directory, 'any-file.txt');
+ await writeNote(file, 'first note');
+ assert.equal(await readNote(file), 'first note');
+});
diff --git a/examples/save-and-reload/workflow.test.mjs b/examples/save-and-reload/workflow.test.mjs
new file mode 100644
index 0000000..a5020b0
--- /dev/null
+++ b/examples/save-and-reload/workflow.test.mjs
@@ -0,0 +1,68 @@
+import assert from 'node:assert/strict';
+import { spawn } from 'node:child_process';
+import { once } from 'node:events';
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { createInterface } from 'node:readline';
+import test from 'node:test';
+import { fileURLToPath } from 'node:url';
+
+const entry = fileURLToPath(new URL('./app.mjs', import.meta.url));
+const miswired = process.env.TFL_DEMO_MISWIRED === '1';
+
+async function fixture(t, seed) {
+ const directory = await mkdtemp(join(tmpdir(), 'tfl-workflow-'));
+ t.after(() => rm(directory, { recursive: true, force: true }));
+ if (seed) await writeFile(join(directory, 'note.txt'), seed, 'utf8');
+ return directory;
+}
+
+async function runApp(directory, operation) {
+ const env = { ...process.env };
+ delete env.NODE_TEST_CONTEXT;
+ const args = [entry, '--data', directory, '--port', '0'];
+ if (miswired) args.push('--miswired');
+ const child = spawn(process.execPath, args, { env, stdio: ['ignore', 'pipe', 'pipe'] });
+ const done = once(child, 'close');
+ done.catch(() => {});
+ child.stderr.resume();
+ const lines = createInterface({ input: child.stdout });
+ const timeout = setTimeout(() => child.kill(), 5000);
+ try {
+ const first = await lines[Symbol.asyncIterator]().next();
+ if (first.done || !/^http:\/\/127\.0\.0\.1:\d+$/.test(first.value)) {
+ throw new Error('Could not start independent application entry point');
+ }
+ return await operation(first.value);
+ } finally {
+ clearTimeout(timeout);
+ lines.close();
+ if (child.exitCode === null && child.signalCode === null) child.kill();
+ await done;
+ }
+}
+
+async function page(url, options) {
+ const response = await fetch(url, { ...options, signal: AbortSignal.timeout(3000) });
+ if (response.status !== 200) throw new Error('HTTP check unavailable: ' + response.status);
+ return response.text();
+}
+
+async function saveAndReload(directory, note) {
+ const saved = await runApp(directory, url => page(url, { method: 'POST', body: new URLSearchParams({ note }) }));
+ assert.match(saved, /role="status">Saved);
+ return runApp(directory, url => page(url));
+}
+
+test('a saved note survives a fresh application process', async t => {
+ const directory = await fixture(t);
+ assert.match(await saveAndReload(directory, 'new note'), /