Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
import { sendErrorResponse } from './errorHandler.js';
import { onClientDisconnect } from './sseDownload.js';
// A tar/child-backed stream exposes abort() to kill its process; a plain file read
// has none, and without destroy() its fd stays open for every download the client
// walked away from.
function teardown(stream) {
if (typeof stream.abort === 'function') stream.abort();
else stream.destroy();
}
/**
* Pipe a readable to an Express response as a file attachment.
*
* Every attachment-download route needs the same teardown, and the error
* handling is the whole reason this is shared rather than copied: the 'error'
* event fires OUTSIDE the asyncHandler promise chain, so a throw there would
* crash the process — it has to go through sendErrorResponse (shared envelope +
* headers-sent guard). Pre-stream failures (the common case: the file vanished
* after the readiness check) get the JSON error envelope; mid-stream failures
* tear the socket down, since sendErrorResponse no-ops once headers are sent.
*
* Call sites: routes/imageTo3d.js (GLB + full-mesh + USDZ), routes/backup.js
* (snapshot tarball).
*
* @param {import('express').Response} res
* @param {import('stream').Readable} stream - piped to res; may expose an
* `abort()` used to tear down an upstream child process on disconnect.
* @param {object} opts
* @param {string} opts.filename - offered to the browser as the download name.
* @param {string} opts.contentType
* @param {import('./errorHandler.js').ServerError} opts.failure - the error
* returned when the stream fails before any bytes are written.
* @param {string} opts.label - short subject for the warning log.
* @param {'attachment'|'inline'} [opts.disposition] - defaults to `attachment`.
* Pass `inline` for a format whose whole point is that the OS handler opens it
* in place rather than landing in Downloads (USDZ / AR Quick Look): Safari will
* not engage Quick Look on an `attachment` response.
*/
export function streamAttachment(res, stream, {
filename, contentType, failure, label, disposition = 'attachment',
}) {
// The route awaited settings/stat before getting here, so the client may have
// already gone — in which case res's 'close' fired before the listener below
// was installed and nothing would ever tear the stream down.
if (res.destroyed || res.writableEnded) {
teardown(stream);
return;
}
res.set('Content-Type', contentType);
// Quote the filename at the boundary rather than trusting every caller to have
// slugged it: a quote or newline in a record-derived name would otherwise
// break out of the header value.
const safeName = String(filename).replace(/[^\w.\-]+/g, '_') || 'download';
res.set('Content-Disposition', `${disposition}; filename="${safeName}"`);
// Attachments are never meant to be sniffed into an executable type.
res.set('X-Content-Type-Options', 'nosniff');
stream.on('error', (err) => {
if (res.destroyed) return; // our own abort, below — nothing left to report
console.warn(`⚠️ ${label} stream error: ${err.code || err.message}`);
if (res.headersSent) {
res.destroy(err);
return;
}
// Drop the download headers so the JSON error body isn't offered to the
// browser as an attachment named like a real file.
res.removeHeader('Content-Type');
res.removeHeader('Content-Disposition');
sendErrorResponse(res, failure);
});
onClientDisconnect(null, res, () => teardown(stream));
stream.pipe(res);
}