Skip to content

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

3.6 KB
Raw Blame
/**
 * File Attachments API Routes
 * Handles generic file uploads for task attachments (not just images)
 */

import { Router } from 'express';
import { withBackupAssetPublication } from '../lib/backupSnapshotBoundary.js';
import { readdir, stat } from 'fs/promises';
import { join, resolve } from 'path';
import { asyncHandler, ServerError } from '../lib/errorHandler.js';
import {
  pathExists, PATHS, sanitizeFilename, getFileExtension, getMimeType,
  ATTACHMENT_ALLOWED_EXTENSIONS, isPathInsideDir, saveBase64Upload, serveLocalFile,
  unlinkGuarded,
} from '../lib/fileUtils.js';
import { MAX_BASE64_UPLOAD_BYTES } from '../lib/uploadLimits.js';
import { validateRequest, attachmentUploadRequestSchema } from '../lib/validation.js';

const ATTACHMENTS_DIR = PATHS.cosAttachments;

const router = Router();

// Bounded by the JSON body limit, not by any attachment-specific rule — a
// larger cap here is unreachable (see lib/uploadLimits.js).
const MAX_FILE_SIZE = MAX_BASE64_UPLOAD_BYTES;

// POST /api/attachments - Upload a file attachment (base64)
router.post('/', asyncHandler(async (req, res) => {
  const { data, filename } = validateRequest(attachmentUploadRequestSchema, req.body);

  // Shared pipeline: allowlist → decode → size cap → `<uuid8>-name` → write.
  const saved = await saveBase64Upload(ATTACHMENTS_DIR, { filename, data }, {
    allowedExtensions: ATTACHMENT_ALLOWED_EXTENSIONS,
    maxBytes: MAX_FILE_SIZE,
  });

  console.log(`📎 Attachment saved: ${saved.filename} (${saved.size} bytes, ${saved.mime})`);

  res.json({
    id: saved.id,
    filename: saved.filename,
    originalName: filename,
    // API-relative URL only — never the absolute FS path (leaks install layout).
    path: `/api/attachments/${encodeURIComponent(saved.filename)}`,
    size: saved.size,
    mimeType: saved.mime
  });
}));

// GET /api/attachments/:filename - Serve an attachment
router.get('/:filename', asyncHandler(async (req, res) => {
  await serveLocalFile(res, ATTACHMENTS_DIR, req.params.filename);
}));

// DELETE /api/attachments/:filename - Delete an attachment
router.delete('/:filename', asyncHandler(async (req, res) => withBackupAssetPublication(async () => {
  const { filename } = req.params;
  const safeFilename = sanitizeFilename(filename);
  const filepath = resolve(ATTACHMENTS_DIR, safeFilename);

  // Verify the resolved path is within attachments directory
  if (!isPathInsideDir(ATTACHMENTS_DIR, filepath)) {
    throw new ServerError('Invalid filename', { status: 400, code: 'INVALID_FILENAME' });
  }

  if (!(await pathExists(filepath))) {
    throw new ServerError('Attachment not found', { status: 404, code: 'NOT_FOUND' });
  }

  await unlinkGuarded(filepath);

  console.log(`🗑️ Attachment deleted: ${safeFilename}`);

  res.json({ success: true, filename: safeFilename });
})));

// GET /api/attachments - List all attachments (for debugging)
router.get('/', asyncHandler(async (req, res) => {
  if (!(await pathExists(ATTACHMENTS_DIR))) {
    return res.json({ attachments: [] });
  }

  const files = await readdir(ATTACHMENTS_DIR);
  const attachments = await Promise.all(files.map(async filename => {
    const filepath = join(ATTACHMENTS_DIR, filename);
    const stats = await stat(filepath);
    const ext = getFileExtension(filename);
    return {
      filename,
      // API-relative URL only — never the absolute FS path (leaks install layout).
      path: `/api/attachments/${encodeURIComponent(filename)}`,
      size: stats.size,
      mimeType: getMimeType(ext),
      createdAt: stats.birthtime
    };
  }));

  res.json({ attachments });
}));

export default router;