@cvfile/server 0.1.0

package/dist/index.js

@@ -0,0 +1,237 @@
+import { stat, readFile } from 'fs/promises';
+import { resolve, normalize, sep } from 'path';
+import { extract, isCvFile } from '@cvfile/sdk';
+
+// src/handler.ts
+
+// src/conneg.ts
+var FORMAT_BY_MIME = {
+  "text/markdown": "markdown",
+  "text/x-markdown": "markdown",
+  "text/html": "html",
+  "application/xhtml+xml": "html",
+  "application/pdf": "pdf",
+  "application/vnd.cv+pdf": "pdf"
+};
+var FORMAT_BY_QUERY = {
+  md: "markdown",
+  markdown: "markdown",
+  html: "html",
+  pdf: "pdf",
+  cv: "pdf"
+};
+function parseAccept(header) {
+  if (!header) return [];
+  return header.split(",").map((part) => {
+    const [type, ...params] = part.trim().split(";").map((s) => s.trim());
+    let q = 1;
+    for (const p of params) {
+      const m = p.match(/^q\s*=\s*(\d*\.?\d+)/i);
+      if (m) q = Number(m[1]);
+    }
+    return { type: (type ?? "").toLowerCase(), q };
+  }).filter((p) => p.type).sort((a, b) => b.q - a.q);
+}
+function parseAcceptLanguage(header) {
+  if (!header) return [];
+  return header.split(",").map((part) => {
+    const [tag, ...params] = part.trim().split(";").map((s) => s.trim());
+    let q = 1;
+    for (const p of params) {
+      const m = p.match(/^q\s*=\s*(\d*\.?\d+)/i);
+      if (m) q = Number(m[1]);
+    }
+    return { tag: (tag ?? "").toLowerCase(), q };
+  }).filter((p) => p.tag && p.tag !== "*").sort((a, b) => b.q - a.q).map((p) => p.tag);
+}
+function negotiate(input) {
+  const language = parseAcceptLanguage(input.acceptLanguage)[0];
+  if (input.formatQuery) {
+    const fromQuery = FORMAT_BY_QUERY[input.formatQuery.toLowerCase()];
+    if (fromQuery) {
+      return { format: fromQuery, language };
+    }
+  }
+  const accepts = parseAccept(input.accept);
+  for (const a of accepts) {
+    const direct = FORMAT_BY_MIME[a.type];
+    if (direct) {
+      return { format: direct, language };
+    }
+    if (a.type === "*/*" || a.type === "application/*") {
+      return { format: "pdf", language };
+    }
+    if (a.type === "text/*") {
+      return { format: "html", language };
+    }
+  }
+  return { format: "pdf", language };
+}
+function buildLinkHeader({ selfUrl, cvMime = "application/vnd.cv+pdf" }) {
+  const sep2 = selfUrl.includes("?") ? "&" : "?";
+  return [
+    `<${selfUrl}>; rel="alternate"; type="${cvMime}"`,
+    `<${selfUrl}${sep2}format=md>; rel="alternate"; type="text/markdown"`,
+    `<${selfUrl}${sep2}format=html>; rel="alternate"; type="text/html"`
+  ].join(", ");
+}
+var PDF_PRIMARY_MIME = "application/vnd.cv+pdf";
+var PDF_FALLBACK_MIME = "application/pdf";
+var ENCODER = new TextEncoder();
+async function serveCv(req) {
+  const decision = negotiate({
+    accept: req.accept,
+    acceptLanguage: req.acceptLanguage,
+    formatQuery: req.formatQuery
+  });
+  if (decision.format === "pdf") {
+    return {
+      format: "pdf",
+      contentType: "application/vnd.cv+pdf",
+      ...decision.language !== void 0 ? { language: decision.language } : {},
+      body: req.bytes
+    };
+  }
+  const file = await extract(req.bytes);
+  const preferLang = decision.language ?? file.metadata.primaryLanguage;
+  if (decision.format === "markdown") {
+    const md = pickPayload(file, "text/markdown", preferLang);
+    if (md) {
+      return {
+        format: "markdown",
+        contentType: `text/markdown; charset=utf-8; cv-language=${md.language ?? preferLang}`,
+        ...md.language !== void 0 ? { language: md.language } : {},
+        body: md.bytes
+      };
+    }
+    return fallbackToPdf(req.bytes);
+  }
+  if (decision.format === "html") {
+    const html = pickPayload(file, "text/html", preferLang);
+    if (html) {
+      return {
+        format: "html",
+        contentType: `text/html; charset=utf-8; cv-language=${html.language ?? preferLang}`,
+        ...html.language !== void 0 ? { language: html.language } : {},
+        body: html.bytes
+      };
+    }
+    const md = pickPayload(file, "text/markdown", preferLang);
+    if (md) {
+      const body = ENCODER.encode(renderMarkdownAsHtml(md.text(), file));
+      return {
+        format: "html",
+        contentType: "text/html; charset=utf-8",
+        ...md.language !== void 0 ? { language: md.language } : {},
+        body
+      };
+    }
+    return fallbackToPdf(req.bytes);
+  }
+  return fallbackToPdf(req.bytes);
+}
+function pickPayload(file, mimeType, preferLang) {
+  const matches = file.payloads.filter((p) => p.mimeType === mimeType);
+  if (matches.length === 0) return void 0;
+  return matches.find((p) => p.language === preferLang) ?? matches[0];
+}
+function fallbackToPdf(bytes) {
+  return { format: "pdf", contentType: "application/vnd.cv+pdf", body: bytes };
+}
+function renderMarkdownAsHtml(md, file) {
+  const safe = md.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+  return `<!doctype html>
+<html lang="${file.metadata.primaryLanguage}">
+<head>
+<meta charset="utf-8">
+<title>${file.metadata.primaryPayload}</title>
+</head>
+<body>
+<pre>${safe}</pre>
+</body>
+</html>`;
+}
+
+// src/handler.ts
+function cvHandler(options = {}) {
+  const { root, loader, cacheControl = "public, max-age=300", defaultFormat } = options;
+  if (!root && !loader) {
+    throw new Error("cvHandler requires either { root } or { loader }");
+  }
+  const baseRoot = root ? resolve(root) : null;
+  return async (req, res) => {
+    try {
+      const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
+      const logical = decodeURIComponent(url.pathname);
+      const formatQuery = url.searchParams.get("format") ?? defaultFormat;
+      const bytes = await load(logical, { baseRoot, loader });
+      if (!bytes) {
+        res.statusCode = 404;
+        res.end("Not found");
+        return;
+      }
+      if (!await isCvFile(bytes)) {
+        res.statusCode = 415;
+        res.end("Not a .cv file");
+        return;
+      }
+      const result = await serveCv({
+        bytes,
+        accept: req.headers["accept"],
+        acceptLanguage: req.headers["accept-language"],
+        formatQuery: formatQuery ?? void 0
+      });
+      const link = buildLinkHeader({ selfUrl: url.pathname, cvMime: PDF_PRIMARY_MIME });
+      res.setHeader("Content-Type", result.contentType);
+      res.setHeader("Content-Length", String(result.body.length));
+      res.setHeader("Vary", "Accept, Accept-Language");
+      res.setHeader("Link", link);
+      res.setHeader("Cache-Control", cacheControl);
+      if (result.language) {
+        res.setHeader("Content-Language", result.language);
+      }
+      const filename = filenameForFormat(logical, result.format);
+      res.setHeader("Content-Disposition", `inline; filename="${filename}"`);
+      res.statusCode = 200;
+      res.end(Buffer.from(result.body));
+    } catch (err) {
+      res.statusCode = 500;
+      res.end(`cvHandler error: ${err.message}`);
+    }
+  };
+}
+async function load(logicalPath, { baseRoot, loader }) {
+  if (loader) {
+    const bytes = await loader(logicalPath);
+    return bytes ?? null;
+  }
+  if (!baseRoot) return null;
+  const safe = normalize(logicalPath).replace(/^[/\\]+/, "");
+  const full = resolve(baseRoot, safe);
+  if (!isWithin(baseRoot, full)) {
+    return null;
+  }
+  try {
+    const s = await stat(full);
+    if (!s.isFile()) return null;
+    return new Uint8Array(await readFile(full));
+  } catch {
+    return null;
+  }
+}
+function isWithin(parent, child) {
+  const rel = resolve(child);
+  const base = resolve(parent);
+  return rel === base || rel.startsWith(base + sep);
+}
+function filenameForFormat(logical, format) {
+  const base = logical.split("/").pop() ?? "document";
+  const stem = base.replace(/\.cv$/i, "").replace(/\.(pdf|md|html)$/i, "") || "document";
+  if (format === "markdown") return `${stem}.md`;
+  if (format === "html") return `${stem}.html`;
+  return `${stem}.cv`;
+}
+
+export { PDF_FALLBACK_MIME, PDF_PRIMARY_MIME, buildLinkHeader, cvHandler, negotiate, parseAccept, parseAcceptLanguage, serveCv };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/conneg.ts","../src/serve.ts","../src/handler.ts"],"names":["sep"],"mappings":"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","file":"index.js","sourcesContent":["export type ServeFormat = 'pdf' | 'markdown' | 'html';\n\nexport interface NegotiationInput {\n  accept?: string | undefined;\n  acceptLanguage?: string | undefined;\n  formatQuery?: string | undefined;\n}\n\nexport interface NegotiationResult {\n  format: ServeFormat;\n  language: string | undefined;\n}\n\nconst FORMAT_BY_MIME: Record<string, ServeFormat> = {\n  'text/markdown': 'markdown',\n  'text/x-markdown': 'markdown',\n  'text/html': 'html',\n  'application/xhtml+xml': 'html',\n  'application/pdf': 'pdf',\n  'application/vnd.cv+pdf': 'pdf',\n};\n\nconst FORMAT_BY_QUERY: Record<string, ServeFormat> = {\n  md: 'markdown',\n  markdown: 'markdown',\n  html: 'html',\n  pdf: 'pdf',\n  cv: 'pdf',\n};\n\ninterface ParsedAccept {\n  type: string;\n  q: number;\n}\n\nexport function parseAccept(header: string | undefined | null): ParsedAccept[] {\n  if (!header) return [];\n  return header\n    .split(',')\n    .map((part) => {\n      const [type, ...params] = part.trim().split(';').map((s) => s.trim());\n      let q = 1;\n      for (const p of params) {\n        const m = p.match(/^q\\s*=\\s*(\\d*\\.?\\d+)/i);\n        if (m) q = Number(m[1]);\n      }\n      return { type: (type ?? '').toLowerCase(), q };\n    })\n    .filter((p) => p.type)\n    .sort((a, b) => b.q - a.q);\n}\n\nexport function parseAcceptLanguage(header: string | undefined | null): string[] {\n  if (!header) return [];\n  return header\n    .split(',')\n    .map((part) => {\n      const [tag, ...params] = part.trim().split(';').map((s) => s.trim());\n      let q = 1;\n      for (const p of params) {\n        const m = p.match(/^q\\s*=\\s*(\\d*\\.?\\d+)/i);\n        if (m) q = Number(m[1]);\n      }\n      return { tag: (tag ?? '').toLowerCase(), q };\n    })\n    .filter((p) => p.tag && p.tag !== '*')\n    .sort((a, b) => b.q - a.q)\n    .map((p) => p.tag);\n}\n\nexport function negotiate(input: NegotiationInput): NegotiationResult {\n  const language = parseAcceptLanguage(input.acceptLanguage)[0];\n\n  if (input.formatQuery) {\n    const fromQuery = FORMAT_BY_QUERY[input.formatQuery.toLowerCase()];\n    if (fromQuery) {\n      return { format: fromQuery, language };\n    }\n  }\n\n  const accepts = parseAccept(input.accept);\n  for (const a of accepts) {\n    const direct = FORMAT_BY_MIME[a.type];\n    if (direct) {\n      return { format: direct, language };\n    }\n    if (a.type === '*/*' || a.type === 'application/*') {\n      return { format: 'pdf', language };\n    }\n    if (a.type === 'text/*') {\n      return { format: 'html', language };\n    }\n  }\n\n  return { format: 'pdf', language };\n}\n\nexport interface BuildLinkHeaderInput {\n  selfUrl: string;\n  cvMime?: string;\n}\n\nexport function buildLinkHeader({ selfUrl, cvMime = 'application/vnd.cv+pdf' }: BuildLinkHeaderInput): string {\n  const sep = selfUrl.includes('?') ? '&' : '?';\n  return [\n    `<${selfUrl}>; rel=\"alternate\"; type=\"${cvMime}\"`,\n    `<${selfUrl}${sep}format=md>; rel=\"alternate\"; type=\"text/markdown\"`,\n    `<${selfUrl}${sep}format=html>; rel=\"alternate\"; type=\"text/html\"`,\n  ].join(', ');\n}\n\nexport const PDF_PRIMARY_MIME = 'application/vnd.cv+pdf';\nexport const PDF_FALLBACK_MIME = 'application/pdf';\n","import { extract } from '@cvfile/sdk';\nimport type { CvFile, ExtractedPayload } from '@cvfile/sdk';\nimport { negotiate, type ServeFormat } from './conneg.js';\n\nexport interface ServeRequest {\n  bytes: Uint8Array;\n  accept?: string | undefined;\n  acceptLanguage?: string | undefined;\n  formatQuery?: string | undefined;\n}\n\nexport interface ServeResponse {\n  format: ServeFormat;\n  contentType: string;\n  language?: string | undefined;\n  body: Uint8Array;\n}\n\nconst ENCODER = new TextEncoder();\n\nexport async function serveCv(req: ServeRequest): Promise<ServeResponse> {\n  const decision = negotiate({\n    accept: req.accept,\n    acceptLanguage: req.acceptLanguage,\n    formatQuery: req.formatQuery,\n  });\n\n  if (decision.format === 'pdf') {\n    return {\n      format: 'pdf',\n      contentType: 'application/vnd.cv+pdf',\n      ...(decision.language !== undefined ? { language: decision.language } : {}),\n      body: req.bytes,\n    };\n  }\n\n  const file = await extract(req.bytes);\n  const preferLang = decision.language ?? file.metadata.primaryLanguage;\n\n  if (decision.format === 'markdown') {\n    const md = pickPayload(file, 'text/markdown', preferLang);\n    if (md) {\n      return {\n        format: 'markdown',\n        contentType: `text/markdown; charset=utf-8; cv-language=${md.language ?? preferLang}`,\n        ...(md.language !== undefined ? { language: md.language } : {}),\n        body: md.bytes,\n      };\n    }\n    return fallbackToPdf(req.bytes);\n  }\n\n  if (decision.format === 'html') {\n    const html = pickPayload(file, 'text/html', preferLang);\n    if (html) {\n      return {\n        format: 'html',\n        contentType: `text/html; charset=utf-8; cv-language=${html.language ?? preferLang}`,\n        ...(html.language !== undefined ? { language: html.language } : {}),\n        body: html.bytes,\n      };\n    }\n    const md = pickPayload(file, 'text/markdown', preferLang);\n    if (md) {\n      const body = ENCODER.encode(renderMarkdownAsHtml(md.text(), file));\n      return {\n        format: 'html',\n        contentType: 'text/html; charset=utf-8',\n        ...(md.language !== undefined ? { language: md.language } : {}),\n        body,\n      };\n    }\n    return fallbackToPdf(req.bytes);\n  }\n\n  return fallbackToPdf(req.bytes);\n}\n\nfunction pickPayload(file: CvFile, mimeType: string, preferLang: string): ExtractedPayload | undefined {\n  const matches = file.payloads.filter((p) => p.mimeType === mimeType);\n  if (matches.length === 0) return undefined;\n  return matches.find((p) => p.language === preferLang) ?? matches[0];\n}\n\nfunction fallbackToPdf(bytes: Uint8Array): ServeResponse {\n  return { format: 'pdf', contentType: 'application/vnd.cv+pdf', body: bytes };\n}\n\nfunction renderMarkdownAsHtml(md: string, file: CvFile): string {\n  const safe = md\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;');\n  return `<!doctype html>\n<html lang=\"${file.metadata.primaryLanguage}\">\n<head>\n<meta charset=\"utf-8\">\n<title>${file.metadata.primaryPayload}</title>\n</head>\n<body>\n<pre>${safe}</pre>\n</body>\n</html>`;\n}\n","import type { IncomingMessage, ServerResponse } from 'node:http';\nimport { readFile, stat } from 'node:fs/promises';\nimport { normalize, resolve, sep } from 'node:path';\nimport { isCvFile } from '@cvfile/sdk';\nimport { buildLinkHeader, PDF_PRIMARY_MIME } from './conneg.js';\nimport { serveCv } from './serve.js';\n\nexport interface CvHandlerOptions {\n  root?: string;\n  loader?: (logicalPath: string) => Promise<Uint8Array | null>;\n  cacheControl?: string;\n  defaultFormat?: 'pdf' | 'markdown' | 'html';\n}\n\nexport type CvHandler = (req: IncomingMessage, res: ServerResponse) => Promise<void>;\n\nexport function cvHandler(options: CvHandlerOptions = {}): CvHandler {\n  const { root, loader, cacheControl = 'public, max-age=300', defaultFormat } = options;\n  if (!root && !loader) {\n    throw new Error('cvHandler requires either { root } or { loader }');\n  }\n\n  const baseRoot = root ? resolve(root) : null;\n\n  return async (req, res) => {\n    try {\n      const url = new URL(req.url ?? '/', `http://${req.headers.host ?? 'localhost'}`);\n      const logical = decodeURIComponent(url.pathname);\n      const formatQuery = url.searchParams.get('format') ?? defaultFormat;\n\n      const bytes = await load(logical, { baseRoot, loader });\n      if (!bytes) {\n        res.statusCode = 404;\n        res.end('Not found');\n        return;\n      }\n\n      if (!(await isCvFile(bytes))) {\n        res.statusCode = 415;\n        res.end('Not a .cv file');\n        return;\n      }\n\n      const result = await serveCv({\n        bytes,\n        accept: req.headers['accept'],\n        acceptLanguage: req.headers['accept-language'],\n        formatQuery: formatQuery ?? undefined,\n      });\n\n      const link = buildLinkHeader({ selfUrl: url.pathname, cvMime: PDF_PRIMARY_MIME });\n\n      res.setHeader('Content-Type', result.contentType);\n      res.setHeader('Content-Length', String(result.body.length));\n      res.setHeader('Vary', 'Accept, Accept-Language');\n      res.setHeader('Link', link);\n      res.setHeader('Cache-Control', cacheControl);\n      if (result.language) {\n        res.setHeader('Content-Language', result.language);\n      }\n      const filename = filenameForFormat(logical, result.format);\n      res.setHeader('Content-Disposition', `inline; filename=\"${filename}\"`);\n      res.statusCode = 200;\n      res.end(Buffer.from(result.body));\n    } catch (err) {\n      res.statusCode = 500;\n      res.end(`cvHandler error: ${(err as Error).message}`);\n    }\n  };\n}\n\ninterface LoadOpts {\n  baseRoot: string | null;\n  loader?: ((logicalPath: string) => Promise<Uint8Array | null>) | undefined;\n}\n\nasync function load(logicalPath: string, { baseRoot, loader }: LoadOpts): Promise<Uint8Array | null> {\n  if (loader) {\n    const bytes = await loader(logicalPath);\n    return bytes ?? null;\n  }\n  if (!baseRoot) return null;\n  const safe = normalize(logicalPath).replace(/^[/\\\\]+/, '');\n  const full = resolve(baseRoot, safe);\n  if (!isWithin(baseRoot, full)) {\n    return null;\n  }\n  try {\n    const s = await stat(full);\n    if (!s.isFile()) return null;\n    return new Uint8Array(await readFile(full));\n  } catch {\n    return null;\n  }\n}\n\nfunction isWithin(parent: string, child: string): boolean {\n  const rel = resolve(child);\n  const base = resolve(parent);\n  return rel === base || rel.startsWith(base + sep);\n}\n\nfunction filenameForFormat(logical: string, format: 'pdf' | 'markdown' | 'html'): string {\n  const base = logical.split('/').pop() ?? 'document';\n  const stem = base.replace(/\\.cv$/i, '').replace(/\\.(pdf|md|html)$/i, '') || 'document';\n  if (format === 'markdown') return `${stem}.md`;\n  if (format === 'html') return `${stem}.html`;\n  return `${stem}.cv`;\n}\n\n"]}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@cvfile/server",
+  "version": "0.1.0",
+  "description": "Server middleware that serves .cv files with HTTP Link header content negotiation. Express, Fastify, Hono adapters.",
+  "license": "Apache-2.0",
+  "homepage": "https://cvfile.org",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cvfile/cv",
+    "directory": "packages/server-middleware-node"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./express": {
+      "types": "./dist/express.d.ts",
+      "import": "./dist/express.js",
+      "require": "./dist/express.cjs"
+    },
+    "./fastify": {
+      "types": "./dist/fastify.d.ts",
+      "import": "./dist/fastify.js",
+      "require": "./dist/fastify.cjs"
+    },
+    "./hono": {
+      "types": "./dist/hono.d.ts",
+      "import": "./dist/hono.js",
+      "require": "./dist/hono.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@cvfile/sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "express": "^5.0.0",
+    "fastify": "^5.0.0",
+    "hono": "^4.6.0",
+    "pdf-lib": "^1.17.1",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "peerDependencies": {
+    "express": "^4 || ^5",
+    "fastify": "^4 || ^5",
+    "hono": "^4"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    },
+    "fastify": {
+      "optional": true
+    },
+    "hono": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  }
+}