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

2.6 KB
Raw Blame
/**
 * Digital Twin document CRUD.
 *
 *   GET    /documents         → list
 *   GET    /documents/:id     → single (404 when unknown)
 *   POST   /documents         → create (201)
 *   PUT    /documents/:id     → update (404 when unknown)
 *   DELETE /documents/:id     → delete (204 / 404)
 */

import { Router } from 'express';
import * as digitalTwinService from '../../services/digital-twin.js';
import { asyncHandler, ServerError } from '../../lib/errorHandler.js';
import { validateRequest, isPaginationRequested, paginateArray } from '../../lib/validation.js';
import {
  createDocumentInputSchema,
  updateDocumentInputSchema,
} from '../../lib/digitalTwinValidation.js';

const router = Router();

/**
 * GET /api/digital-twin/documents
 * List all digital twin documents. Backward-compatible full array by default;
 * opt into a bounded `{ items, total, limit, offset }` envelope with
 * `?limit=`/`?offset=`.
 */
router.get('/documents', asyncHandler(async (req, res) => {
  const documents = await digitalTwinService.getDocuments();
  if (!isPaginationRequested(req.query)) return res.json(documents);
  res.json(paginateArray(documents, req.query, { defaultLimit: 50, maxLimit: 500 }));
}));

/**
 * GET /api/digital-twin/documents/:id
 * Get a single document with content
 */
router.get('/documents/:id', asyncHandler(async (req, res) => {
  const document = await digitalTwinService.getDocumentById(req.params.id);
  if (!document) {
    throw new ServerError('Document not found', { status: 404, code: 'NOT_FOUND' });
  }
  res.json(document);
}));

/**
 * POST /api/digital-twin/documents
 * Create a new document
 */
router.post('/documents', asyncHandler(async (req, res) => {
  const data = validateRequest(createDocumentInputSchema, req.body);
  const document = await digitalTwinService.createDocument(data);
  res.status(201).json(document);
}));

/**
 * PUT /api/digital-twin/documents/:id
 * Update a document
 */
router.put('/documents/:id', asyncHandler(async (req, res) => {
  const data = validateRequest(updateDocumentInputSchema, req.body);
  const document = await digitalTwinService.updateDocument(req.params.id, data);
  if (!document) {
    throw new ServerError('Document not found', { status: 404, code: 'NOT_FOUND' });
  }
  res.json(document);
}));

/**
 * DELETE /api/digital-twin/documents/:id
 * Delete a document
 */
router.delete('/documents/:id', asyncHandler(async (req, res) => {
  const deleted = await digitalTwinService.deleteDocument(req.params.id);
  if (!deleted) {
    throw new ServerError('Document not found', { status: 404, code: 'NOT_FOUND' });
  }
  res.status(204).send();
}));

export default router;