@open-press/cli 1.0.0 → 1.1.1

package/template/core/engine/output/static-server.mjs

@@ -1,571 +0,0 @@
-import fs from "node:fs/promises";
-import http from "node:http";
-import path from "node:path";
-import { spawn } from "node:child_process";
-import { loadConfig, publicPdfHref } from "../runtime/config.mjs";
-import { searchSourceText } from "../runtime/source-text-tools.mjs";
-import { handleProjectAssetRequest } from "../react/project-asset-endpoint.mjs";
-import { handleSourceEditRequest } from "../react/source-edit-endpoint.mjs";
-
-const [rootArg = "dist", ...rest] = process.argv.slice(2);
-const host = valueAfter(rest, "--host") ?? "127.0.0.1";
-const port = Number(valueAfter(rest, "--port") ?? "8765");
-const root = path.resolve(rootArg);
-const workspace = path.resolve(valueAfter(rest, "--workspace") ?? await inferWorkspaceRoot(root));
-const config = await loadConfig(workspace);
-
-const mimeTypes = {
-  ".html": "text/html; charset=utf-8",
-  ".css": "text/css; charset=utf-8",
-  ".js": "application/javascript; charset=utf-8",
-  ".json": "application/json; charset=utf-8",
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".gif": "image/gif",
-  ".svg": "image/svg+xml",
-  ".pdf": "application/pdf",
-};
-
-const server = http.createServer(async (req, res) => {
-  try {
-    const url = new URL(req.url ?? "/", `http://${host}:${port}`);
-    if (url.pathname === "/__openpress/status") {
-      await handleStatusRequest(req, res);
-      return;
-    }
-    if (url.pathname === "/__openpress/search") {
-      await handleSearchRequest(req, res, url);
-      return;
-    }
-    if (url.pathname === "/__openpress/source-edit") {
-      await handleSourceEditRequest(req, res, { root: workspace });
-      return;
-    }
-    if (url.pathname === "/__openpress/local-pdf-export") {
-      await handleLocalPdfExportRequest(req, res);
-      return;
-    }
-    if (url.pathname === "/__openpress/local-pdf-file") {
-      await handleLocalPdfFileRequest(req, res);
-      return;
-    }
-    if (url.pathname === "/__openpress/deploy") {
-      await handleDeployRequest(req, res);
-      return;
-    }
-    if (url.pathname === "/__openpress/media-upload") {
-      await handleMediaUploadRequest(req, res);
-      return;
-    }
-    if (url.pathname === "/__openpress/project-asset") {
-      await handleProjectAssetRequest(req, res, { root: workspace });
-      return;
-    }
-    if (url.pathname.startsWith("/openpress/media/")) {
-      await handleMediaFileRequest(req, res, url);
-      return;
-    }
-    const requested = decodeURIComponent(url.pathname === "/" ? "/index.html" : url.pathname);
-    const target = path.resolve(root, `.${requested}`);
-    if (!target.startsWith(root)) {
-      res.writeHead(403);
-      res.end("Forbidden");
-      return;
-    }
-    try {
-      const stat = await fs.stat(target);
-      const filePath = stat.isDirectory() ? path.join(target, "index.html") : target;
-      const body = await fs.readFile(filePath);
-      res.writeHead(200, { "Content-Type": mimeTypes[path.extname(filePath)] ?? "application/octet-stream" });
-      res.end(body);
-    } catch (err) {
-      // SPA fallback: when a path doesn't map to a real file AND it
-      // looks like a client-side route (no extension, not under a
-      // reserved namespace), serve index.html so the reader's URL-based
-      // routing can take over. This lets /cheatsheet / /proposal etc.
-      // reload correctly without needing host-level rewrite rules.
-      if (err?.code === "ENOENT" && shouldFallbackToIndex(url.pathname)) {
-        const indexBody = await fs.readFile(path.join(root, "index.html"));
-        res.writeHead(200, { "Content-Type": "text/html" });
-        res.end(indexBody);
-        return;
-      }
-      throw err;
-    }
-  } catch {
-    res.writeHead(404);
-    res.end("Not found");
-  }
-});
-
-function shouldFallbackToIndex(pathname) {
-  // Reserved namespaces — real resources whose 404s should stay 404.
-  if (pathname.startsWith("/openpress/")) return false;
-  if (pathname.startsWith("/__openpress/")) return false;
-  if (pathname.startsWith("/assets/")) return false;
-  // Anything with a file extension is an asset miss; fall through.
-  const lastSlash = pathname.lastIndexOf("/");
-  const tail = pathname.slice(lastSlash + 1);
-  if (tail.includes(".")) return false;
-  // Otherwise: looks like a client-side route — serve the SPA shell.
-  return true;
-}
-
-server.listen(port, host, () => {
-  console.log(`OpenPress static preview: http://${host}:${port}/`);
-});
-
-async function handleStatusRequest(req, res) {
-  if (req.method !== "GET") {
-    writeJson(res, 405, { ok: false, message: "Status endpoint requires GET." });
-    return;
-  }
-
-  const deployConfigured = isDeployConfigured();
-  const deploymentInfo = deployConfigured
-    ? await readDeploymentInfo()
-    : { deployed_at: undefined, pdf: publicPdfHref(config), public_url: undefined };
-  const dirty = deployConfigured ? await isDeploymentDirty(deploymentInfo.deployed_at) : false;
-  writeJson(res, 200, {
-    ok: true,
-    deployed_at: deploymentInfo.deployed_at,
-    pdf: deploymentInfo.pdf,
-    public_url: deploymentInfo.public_url,
-    dirty,
-    deploy_configured: deployConfigured,
-    deploy_adapter: config.deploy.adapter,
-    deploy_source: config.deploy.source,
-    deploy_project_name: config.deploy.projectName,
-    deploy_setup_message: deploySetupMessage(),
-  });
-}
-
-async function handleSearchRequest(req, res, url) {
-  if (req.method !== "GET") {
-    writeJson(res, 405, { ok: false, message: "Search endpoint requires GET." });
-    return;
-  }
-
-  const query = (url.searchParams.get("q") ?? "").trim();
-  if (!query) {
-    writeJson(res, 400, { ok: false, message: "Search query is required." });
-    return;
-  }
-
-  try {
-    const report = await searchSourceText({
-      config,
-      query,
-      scope: searchScopeFrom(url),
-      caseSensitive: url.searchParams.get("caseSensitive") === "true",
-    });
-    writeJson(res, 200, { ok: true, ...report });
-  } catch (error) {
-    writeJson(res, 500, { ok: false, message: error instanceof Error ? error.message : String(error) });
-  }
-}
-
-function searchScopeFrom(url) {
-  return url.searchParams.get("scope") === "all" ? "all" : "content";
-}
-
-function valueAfter(args, flag) {
-  const index = args.indexOf(flag);
-  return index >= 0 ? args[index + 1] : undefined;
-}
-
-async function inferWorkspaceRoot(staticRoot) {
-  for (const candidate of [staticRoot, path.dirname(staticRoot), path.dirname(path.dirname(staticRoot))]) {
-    // 1.0 workspace markers: press/index.tsx (the document entry) or
-    // package.json with an "openpress" field. Either is sufficient.
-    if (await fileExists(path.join(candidate, "press", "index.tsx"))) return candidate;
-    if (await hasOpenpressPackageField(candidate)) return candidate;
-  }
-  if (path.basename(path.dirname(staticRoot)) === ".deploy") {
-    return path.dirname(path.dirname(staticRoot));
-  }
-  return process.cwd();
-}
-
-async function hasOpenpressPackageField(dir) {
-  try {
-    const text = await fs.readFile(path.join(dir, "package.json"), "utf8");
-    const parsed = JSON.parse(text);
-    return parsed?.openpress && typeof parsed.openpress === "object";
-  } catch {
-    return false;
-  }
-}
-
-async function handleLocalPdfExportRequest(req, res) {
-  if (req.method !== "POST") {
-    writeJson(res, 405, { ok: false, message: "Local PDF export endpoint requires POST." });
-    return;
-  }
-
-  const result = await runLocalPdfExport();
-  const exists = await fileExists(config.paths.pdf);
-  writeJson(res, result.code === 0 && exists ? 200 : 500, {
-    ok: result.code === 0 && exists,
-    code: result.code,
-    pdf: `/__openpress/local-pdf-file?ts=${Date.now()}`,
-    command: "node engine/cli.mjs pdf .",
-    stdout: result.stdout,
-    stderr: result.stderr,
-  });
-}
-
-async function handleLocalPdfFileRequest(req, res) {
-  if (req.method !== "GET") {
-    writeJson(res, 405, { ok: false, message: "Local PDF file endpoint requires GET." });
-    return;
-  }
-
-  try {
-    const body = await fs.readFile(config.paths.pdf);
-    res.writeHead(200, {
-      "Content-Type": "application/pdf",
-      "Content-Disposition": `inline; filename="${config.pdf.filename}"`,
-      "Cache-Control": "no-store",
-    });
-    res.end(body);
-  } catch {
-    writeJson(res, 404, { ok: false, message: "Local PDF has not been generated yet." });
-  }
-}
-
-async function handleDeployRequest(req, res) {
-  if (req.method !== "POST") {
-    writeJson(res, 405, { ok: false, message: "Deploy endpoint requires POST." });
-    return;
-  }
-
-  if (!isDeployConfigured()) {
-    writeJson(res, 400, {
-      ok: false,
-      code: 2,
-      message: deploySetupMessage(),
-      deploy_configured: false,
-      deploy_adapter: config.deploy.adapter,
-      deploy_source: config.deploy.source,
-      deploy_project_name: config.deploy.projectName,
-      command: "node engine/cli.mjs deploy . --confirm",
-    });
-    return;
-  }
-
-  const result = await runDeploy();
-  const deployedUrl = extractDeployUrl(result.stdout);
-  if (result.code === 0 && deployedUrl) {
-    await writeDeploymentPublicUrl(deployedUrl);
-  }
-  const deploymentInfo = await readDeploymentInfo();
-  const publicUrl = deployedUrl ?? deploymentInfo.public_url;
-  writeJson(res, result.code === 0 ? 200 : 500, {
-    ok: result.code === 0,
-    code: result.code,
-    deployed_at: deploymentInfo.deployed_at,
-    pdf: deployedUrl ? `${deployedUrl}/${config.pdf.filename}` : deploymentInfo.pdf,
-    public_url: publicUrl,
-    dirty: false,
-    command: "node engine/cli.mjs deploy . --confirm",
-    stdout: result.stdout,
-    stderr: result.stderr,
-  });
-}
-
-async function handleMediaUploadRequest(req, res) {
-  if (req.method !== "POST") {
-    writeJson(res, 405, { ok: false, message: "Media upload endpoint requires POST." });
-    return;
-  }
-
-  const rawFileName = headerValue(req.headers["x-openpress-file-name"]);
-  const decodedFileName = rawFileName ? safeDecodeURIComponent(rawFileName) : "";
-  const fileName = sanitizeMediaFileName(decodedFileName);
-  if (!fileName) {
-    writeJson(res, 400, { ok: false, message: "Media upload requires a valid file name." });
-    return;
-  }
-  if (!isAllowedMediaFile(fileName)) {
-    writeJson(res, 400, { ok: false, message: "Only png, jpg, jpeg, gif, svg, and webp files can be uploaded." });
-    return;
-  }
-
-  try {
-    const body = await readRequestBuffer(req, 30 * 1024 * 1024);
-    if (body.length === 0) {
-      writeJson(res, 400, { ok: false, message: "Uploaded media file is empty." });
-      return;
-    }
-    await fs.mkdir(config.paths.mediaDir, { recursive: true });
-    const uniqueFileName = await uniqueMediaFileName(config.paths.mediaDir, fileName);
-    const targetPath = path.join(config.paths.mediaDir, uniqueFileName);
-    await fs.writeFile(targetPath, body);
-    const relativePath = path.relative(workspace, targetPath).replaceAll("\\", "/");
-    writeJson(res, 200, {
-      ok: true,
-      asset: {
-        fileName: uniqueFileName,
-        src: `/openpress/media/${encodeURIComponent(uniqueFileName)}`,
-        path: relativePath,
-        mention: `@media/${uniqueFileName}`,
-      },
-    });
-  } catch (error) {
-    writeJson(res, 500, { ok: false, message: error instanceof Error ? error.message : String(error) });
-  }
-}
-
-async function handleMediaFileRequest(req, res, url) {
-  if (req.method !== "GET" && req.method !== "HEAD") {
-    writeJson(res, 405, { ok: false, message: "Media file endpoint requires GET." });
-    return;
-  }
-
-  try {
-    const fileName = sanitizeMediaFileName(safeDecodeURIComponent(url.pathname.replace(/^\/openpress\/media\/?/, "")));
-    if (!fileName) {
-      writeJson(res, 404, { ok: false, message: "Media file not found." });
-      return;
-    }
-    const targetPath = path.join(config.paths.mediaDir, fileName);
-    const resolvedTarget = path.resolve(targetPath);
-    const mediaRoot = path.resolve(config.paths.mediaDir);
-    if (!resolvedTarget.startsWith(`${mediaRoot}${path.sep}`) && resolvedTarget !== mediaRoot) {
-      writeJson(res, 403, { ok: false, message: "Forbidden." });
-      return;
-    }
-    const body = await fs.readFile(resolvedTarget);
-    res.writeHead(200, {
-      "Content-Type": mediaMimeType(fileName),
-      "Cache-Control": "no-store",
-    });
-    if (req.method === "HEAD") {
-      res.end();
-    } else {
-      res.end(body);
-    }
-  } catch {
-    writeJson(res, 404, { ok: false, message: "Media file not found." });
-  }
-}
-
-function runLocalPdfExport() {
-  return new Promise((resolve) => {
-    const child = spawn("node", ["engine/cli.mjs", "pdf", "."], {
-      cwd: workspace,
-      shell: false,
-    });
-    let stdout = "";
-    let stderr = "";
-    child.stdout.on("data", (chunk) => {
-      stdout += String(chunk);
-    });
-    child.stderr.on("data", (chunk) => {
-      stderr += String(chunk);
-    });
-    child.on("error", (error) => {
-      resolve({ code: 1, stdout, stderr: `${stderr}${error.message}\n` });
-    });
-    child.on("close", (code) => {
-      resolve({ code: code ?? 1, stdout, stderr });
-    });
-  });
-}
-
-function runDeploy() {
-  return new Promise((resolve) => {
-    const child = spawn("node", ["engine/cli.mjs", "deploy", ".", "--confirm"], {
-      cwd: workspace,
-      shell: false,
-    });
-    let stdout = "";
-    let stderr = "";
-    child.stdout.on("data", (chunk) => {
-      stdout += String(chunk);
-    });
-    child.stderr.on("data", (chunk) => {
-      stderr += String(chunk);
-    });
-    child.on("error", (error) => {
-      resolve({ code: 1, stdout, stderr: `${stderr}${error.message}\n` });
-    });
-    child.on("close", (code) => {
-      resolve({ code: code ?? 1, stdout, stderr });
-    });
-  });
-}
-
-function isDeployConfigured() {
-  if (config.deploy.adapter === "cloudflare-pages") {
-    return typeof config.deploy.projectName === "string" && config.deploy.projectName.trim().length > 0;
-  }
-  return true;
-}
-
-function deploySetupMessage() {
-  if (isDeployConfigured()) return undefined;
-  if (config.deploy.adapter === "cloudflare-pages") {
-    return 'Cloudflare Pages deployment requires `openpress.deploy.projectName` in package.json.';
-  }
-  return `Deployment adapter \`${config.deploy.adapter}\` is not configured.`;
-}
-
-async function fileExists(filePath) {
-  try {
-    await fs.access(filePath);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function writeJson(res, status, body) {
-  res.writeHead(status, { "Content-Type": "application/json; charset=utf-8" });
-  res.end(`${JSON.stringify(body, null, 2)}\n`);
-}
-
-async function readDeploymentInfo() {
-  try {
-    const text = await fs.readFile(config.paths.deployMetadata, "utf8");
-    const deployConfig = JSON.parse(text);
-    return {
-      deployed_at: typeof deployConfig.deployed_at === "string" ? deployConfig.deployed_at : undefined,
-      pdf: typeof deployConfig.pdf === "string" ? deployConfig.pdf : publicPdfHref(config),
-      public_url: typeof deployConfig.public_url === "string" ? deployConfig.public_url : undefined,
-    };
-  } catch {
-    return { deployed_at: undefined, pdf: publicPdfHref(config), public_url: undefined };
-  }
-}
-
-async function writeDeploymentPublicUrl(publicUrl) {
-  let deployConfig = {};
-  try {
-    deployConfig = JSON.parse(await fs.readFile(config.paths.deployMetadata, "utf8"));
-  } catch {
-    deployConfig = {};
-  }
-  await fs.mkdir(path.dirname(config.paths.deployMetadata), { recursive: true });
-  await fs.writeFile(
-    config.paths.deployMetadata,
-    `${JSON.stringify({ ...deployConfig, pdf: `${publicUrl}/${config.pdf.filename}`, public_url: publicUrl }, null, 2)}\n`,
-    "utf8",
-  );
-}
-
-async function isDeploymentDirty(deployedAt) {
-  if (!deployedAt) return false;
-  const deployedTime = new Date(deployedAt).getTime();
-  if (Number.isNaN(deployedTime)) return false;
-  const newestSourceMtime = await findNewestSourceMtime(getDeploymentSourcePaths());
-  return newestSourceMtime > deployedTime + 1000;
-}
-
-function getDeploymentSourcePaths() {
-  return [
-    config.paths.sourceDir,
-    config.paths.mediaDir,
-    config.paths.themeDir,
-    config.paths.designDoc,
-    config.paths.componentsDir,
-    path.join(workspace, "src"),
-    path.join(workspace, "index.html"),
-    path.join(workspace, "package.json"),
-    path.join(workspace, "vite.config.ts"),
-  ];
-}
-
-async function findNewestSourceMtime(paths) {
-  const times = await Promise.all(paths.map((sourcePath) => findNewestMtime(sourcePath)));
-  return Math.max(0, ...times);
-}
-
-async function findNewestMtime(sourcePath) {
-  try {
-    const stat = await fs.stat(sourcePath);
-    if (!stat.isDirectory()) return stat.mtimeMs;
-    const entries = await fs.readdir(sourcePath, { withFileTypes: true });
-    const times = await Promise.all(entries.map((entry) => findNewestMtime(path.join(sourcePath, entry.name))));
-    return Math.max(stat.mtimeMs, ...times);
-  } catch {
-    return 0;
-  }
-}
-
-function headerValue(value) {
-  return Array.isArray(value) ? value[0] : value;
-}
-
-function safeDecodeURIComponent(value) {
-  try {
-    return decodeURIComponent(value);
-  } catch {
-    return value;
-  }
-}
-
-function sanitizeMediaFileName(value) {
-  const baseName = path.basename(value).trim();
-  if (!baseName) return "";
-  const ext = path.extname(baseName);
-  const stem = path.basename(baseName, ext)
-    .replace(/[\\/:*?"<>|#%{}^~[\]`]/g, "-")
-    .replace(/\s+/g, "-")
-    .replace(/-+/g, "-")
-    .replace(/^-|-$/g, "");
-  if (!stem || !ext) return "";
-  return `${stem}${ext.toLowerCase()}`;
-}
-
-function isAllowedMediaFile(fileName) {
-  return /\.(png|jpe?g|gif|svg|webp)$/i.test(fileName);
-}
-
-function mediaMimeType(fileName) {
-  const ext = path.extname(fileName).toLowerCase();
-  if (ext === ".png") return "image/png";
-  if (ext === ".jpg" || ext === ".jpeg") return "image/jpeg";
-  if (ext === ".gif") return "image/gif";
-  if (ext === ".svg") return "image/svg+xml";
-  if (ext === ".webp") return "image/webp";
-  return "application/octet-stream";
-}
-
-async function uniqueMediaFileName(mediaDir, fileName) {
-  const ext = path.extname(fileName);
-  const stem = path.basename(fileName, ext);
-  let candidate = fileName;
-  let counter = 2;
-  while (await fileExists(path.join(mediaDir, candidate))) {
-    candidate = `${stem}-${counter}${ext}`;
-    counter += 1;
-  }
-  return candidate;
-}
-
-function readRequestBuffer(req, maxBytes) {
-  return new Promise((resolve, reject) => {
-    const chunks = [];
-    let total = 0;
-    req.on("data", (chunk) => {
-      const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
-      total += buffer.length;
-      if (total > maxBytes) {
-        reject(new Error("Uploaded media file is too large."));
-        req.destroy();
-        return;
-      }
-      chunks.push(buffer);
-    });
-    req.on("end", () => resolve(Buffer.concat(chunks)));
-    req.on("error", reject);
-  });
-}
-
-function extractDeployUrl(output) {
-  const match = output.match(/https:\/\/[^\s]+\.pages\.dev/);
-  return match?.[0]?.replace(/\/$/, "");
-}

package/template/core/engine/react/caption-numbering.mjs

@@ -1,73 +0,0 @@
-const DEFAULT_CAPTION_NUMBERING = {
-  figure: "Figure",
-  table: "Table",
-  separator: " ",
-};
-
-export function normalizeCaptionNumbering(value = {}) {
-  const input = value && typeof value === "object" && !Array.isArray(value) ? value : {};
-  return {
-    figure: stringOption(input.figure, DEFAULT_CAPTION_NUMBERING.figure),
-    table: stringOption(input.table, DEFAULT_CAPTION_NUMBERING.table),
-    separator: typeof input.separator === "string" ? input.separator : DEFAULT_CAPTION_NUMBERING.separator,
-  };
-}
-
-export function createCaptionNumberingState() {
-  return {
-    figure: 0,
-    table: 0,
-    seenTables: new Set(),
-  };
-}
-
-export function numberCaptionsInHtml(html, numbering, state = createCaptionNumberingState()) {
-  if (!html) return html;
-  const options = normalizeCaptionNumbering(numbering);
-  let out = String(html);
-  out = numberTableCaptions(out, options, state);
-  out = numberFigureCaptions(out, options, state);
-  return out;
-}
-
-function numberTableCaptions(html, options, state) {
-  return html.replace(/<table\b([^>]*)>([\s\S]*?<caption\b([^>]*)>)([\s\S]*?)(<\/caption>[\s\S]*?<\/table>)/g, (match, tableAttrs, beforeCaptionText, captionAttrs, captionText, afterCaptionText) => {
-    if (captionText.includes("data-openpress-caption-label=")) return match;
-    const tableId = attrValue(tableAttrs, "data-openpress-table-id");
-    if (tableId && state.seenTables.has(tableId)) return match;
-    if (tableId) state.seenTables.add(tableId);
-    state.table += 1;
-    const label = captionLabel(options.table, state.table, options.separator);
-    return `<table${tableAttrs}>${beforeCaptionText}${captionLabelSpan("table", state.table, label)} ${captionText}${afterCaptionText}`;
-  });
-}
-
-function numberFigureCaptions(html, options, state) {
-  return html.replace(/<figure\b([^>]*)>([\s\S]*?<figcaption\b([^>]*)>)([\s\S]*?)(<\/figcaption>[\s\S]*?<\/figure>)/g, (match, figureAttrs, beforeCaptionText, captionAttrs, captionText, afterCaptionText) => {
-    if (captionText.includes("data-openpress-caption-label=")) return match;
-    state.figure += 1;
-    const label = captionLabel(options.figure, state.figure, options.separator);
-    return `<figure${figureAttrs}>${beforeCaptionText}${captionLabelSpan("figure", state.figure, label)} ${captionText}${afterCaptionText}`;
-  });
-}
-
-function captionLabel(noun, number, separator) {
-  return `${noun}${separator}${number}`;
-}
-
-function captionLabelSpan(kind, number, label) {
-  return `<span class="openpress-caption-label" data-openpress-caption-label="${kind}" data-openpress-caption-number="${number}">${escapeHtml(label)}</span>`;
-}
-
-function attrValue(attrs, name) {
-  const pattern = new RegExp(`${name}=(["'])(.*?)\\1`);
-  return attrs.match(pattern)?.[2] ?? "";
-}
-
-function stringOption(value, fallback) {
-  return typeof value === "string" && value.trim() ? value.trim() : fallback;
-}
-
-function escapeHtml(value) {
-  return String(value).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-}

package/template/core/engine/react/comment-endpoint.d.mts

@@ -1,11 +0,0 @@
-import type { IncomingMessage, ServerResponse } from "node:http";
-
-export function handleCommentRequest(
-  req: IncomingMessage,
-  res: ServerResponse,
-  options?: {
-    root?: string;
-    id?: string;
-    timestamp?: string;
-  },
-): Promise<void>;