NODEDC_DESIGN_GUIDELINE/server/catalog-server.mjs

475 lines
20 KiB
JavaScript

import { createReadStream, createWriteStream } from "node:fs";
import { mkdir, readFile, readdir, rename, stat, writeFile } from "node:fs/promises";
import { createServer } from "node:http";
import { randomUUID } from "node:crypto";
import { basename, extname, join, normalize } from "node:path";
import { pipeline } from "node:stream/promises";
import { fileURLToPath } from "node:url";
const root = fileURLToPath(new URL("..", import.meta.url));
const distDir = join(root, "apps", "catalog", "dist");
const runtimeDir = join(root, "runtime-data");
const uploadDir = join(runtimeDir, "uploads");
const applicationsDir = join(runtimeDir, "applications");
const designProfilesDir = join(runtimeDir, "design-profiles");
const layoutPath = join(runtimeDir, "layout.json");
const pageRegistryPath = join(root, "registry", "pages.json");
const port = Number(process.env.PORT || 3333);
await mkdir(uploadDir, { recursive: true });
await mkdir(applicationsDir, { recursive: true });
await mkdir(designProfilesDir, { recursive: true });
const pageRegistry = JSON.parse(await readFile(pageRegistryPath, "utf8"));
function findPageTemplate(id, version) {
return pageRegistry.templates.find((template) => template.id === id && (!version || template.version === version));
}
const mimeTypes = {
".css": "text/css; charset=utf-8",
".gif": "image/gif",
".html": "text/html; charset=utf-8",
".ico": "image/x-icon",
".jpg": "image/jpeg",
".jpeg": "image/jpeg",
".js": "text/javascript; charset=utf-8",
".json": "application/json; charset=utf-8",
".map": "application/json; charset=utf-8",
".mp4": "video/mp4",
".png": "image/png",
".svg": "image/svg+xml",
".webm": "video/webm",
".webp": "image/webp",
".mov": "video/quicktime",
};
function json(response, statusCode, value) {
response.writeHead(statusCode, { "content-type": "application/json; charset=utf-8", "cache-control": "no-store" });
response.end(JSON.stringify(value));
}
function applicationError(code, statusCode = 400) {
const error = new Error(code);
error.statusCode = statusCode;
return error;
}
function normalizeSlug(value) {
return String(value || "")
.trim()
.toLowerCase()
.replace(/[^a-z0-9-]+/g, "-")
.replace(/-{2,}/g, "-")
.replace(/^-+|-+$/g, "")
.slice(0, 64);
}
function applicationPath(id) {
const safeId = String(id || "");
if (!/^[0-9a-f-]{36}$/i.test(safeId)) throw applicationError("invalid_application_id");
return join(applicationsDir, `${safeId}.json`);
}
function designProfilePath(id) {
const safeId = String(id || "");
if (safeId !== "default" && !/^[0-9a-f-]{36}$/i.test(safeId)) throw applicationError("invalid_design_profile_id");
return join(designProfilesDir, `${safeId}.json`);
}
function validateDesignProfile(value) {
if (!value || typeof value !== "object" || Array.isArray(value)) throw applicationError("invalid_design_profile");
if (value.schemaVersion !== "0.1.0") throw applicationError("unsupported_design_profile_schema");
if (value.id !== "default" && !/^[0-9a-f-]{36}$/i.test(String(value.id || ""))) throw applicationError("invalid_design_profile_id");
const name = String(value.name || "").trim();
if (!name || name.length > 120) throw applicationError("invalid_design_profile_name");
if (!value.layout || typeof value.layout !== "object" || Array.isArray(value.layout)) throw applicationError("invalid_design_profile_layout");
return { ...value, name };
}
async function ensureDefaultDesignProfile() {
try {
await readFile(designProfilePath("default"), "utf8");
} catch (error) {
if (error?.code !== "ENOENT") throw error;
let layout = {};
try { layout = JSON.parse(await readFile(layoutPath, "utf8")); } catch (layoutError) { if (layoutError?.code !== "ENOENT") throw layoutError; }
const now = new Date().toISOString();
await writeFile(designProfilePath("default"), `${JSON.stringify({
schemaVersion: "0.1.0",
id: "default",
name: "NODE.DC Default",
version: "0.6.0",
status: "draft",
layout,
timestamps: { createdAt: now, updatedAt: now },
}, null, 2)}\n`, "utf8");
}
}
await ensureDefaultDesignProfile();
async function writeDesignProfile(profile) {
const targetPath = designProfilePath(profile.id);
const tempPath = `${targetPath}.${randomUUID()}.tmp`;
await writeFile(tempPath, `${JSON.stringify(profile, null, 2)}\n`, "utf8");
await rename(tempPath, targetPath);
}
function designProfileSummary(profile) {
return { id: profile.id, name: profile.name, version: profile.version, theme: profile.layout?.theme === "light" ? "light" : "dark", updatedAt: profile.timestamps.updatedAt };
}
function nextPatchVersion(version) {
const match = String(version || "0.1.0").match(/^(\d+)\.(\d+)\.(\d+)$/);
return match ? `${match[1]}.${match[2]}.${Number(match[3]) + 1}` : "0.1.0";
}
function validateApplicationManifest(value) {
if (!value || typeof value !== "object" || Array.isArray(value)) throw applicationError("invalid_application_manifest");
if (value.schemaVersion !== "0.1.0") throw applicationError("unsupported_application_schema");
if (!/^[0-9a-f-]{36}$/i.test(String(value.id || ""))) throw applicationError("invalid_application_id");
if (value.status !== "draft") throw applicationError("invalid_application_status");
if (!/^0\.\d+\.\d+$/.test(String(value.version || ""))) throw applicationError("invalid_application_version");
if (!value.metadata || typeof value.metadata !== "object") throw applicationError("invalid_application_metadata");
const name = String(value.metadata.name || "").trim();
const slug = normalizeSlug(value.metadata.slug);
if (!name || name.length > 120) throw applicationError("invalid_application_name");
if (!slug) throw applicationError("invalid_application_slug");
if (!value.designProfile || typeof value.designProfile !== "object") throw applicationError("invalid_design_profile");
if (value.designProfile.theme !== "dark" && value.designProfile.theme !== "light") throw applicationError("invalid_application_theme");
if (!Array.isArray(value.pages)) throw applicationError("invalid_application_pages");
const pageIds = new Set();
for (const page of value.pages) {
if (!page || typeof page !== "object") throw applicationError("invalid_application_page");
const pageId = String(page.id || "").trim();
if (!/^[a-z0-9-]+$/.test(pageId) || pageIds.has(pageId)) throw applicationError("invalid_application_page_id");
pageIds.add(pageId);
if (!page.template || typeof page.template !== "object" || !String(page.template.id || "").trim()) {
throw applicationError("invalid_application_page_template");
}
const template = findPageTemplate(String(page.template.id), String(page.template.version || ""));
if (!template) throw applicationError("unknown_application_page_template");
if (!page.navigation || typeof page.navigation.visible !== "boolean") throw applicationError("invalid_application_navigation");
if (!page.features || typeof page.features !== "object" || Array.isArray(page.features)) throw applicationError("invalid_application_features");
const allowedFeatures = new Set(template.features.map((feature) => feature.id));
if (Object.keys(page.features).some((feature) => !allowedFeatures.has(feature))) throw applicationError("unsupported_application_feature");
for (const feature of template.features) {
if (feature.required && page.features[feature.id] !== true) throw applicationError("required_application_feature_disabled");
}
}
return {
...value,
metadata: {
...value.metadata,
name,
slug,
description: String(value.metadata.description || "").slice(0, 500),
},
};
}
function createApplicationManifest(input = {}) {
const templateId = String(input?.templateId || "").trim();
const templateVersion = String(input?.templateVersion || "").trim() || undefined;
const template = templateId ? findPageTemplate(templateId, templateVersion) : null;
if (templateId && !template) throw applicationError("unknown_page_template");
const now = new Date().toISOString();
const name = String(input?.name || (template ? `NODE.DC ${template.title} Demo` : "Новый модуль")).trim() || "Новый модуль";
const slug = normalizeSlug(input?.slug || name) || "nodedc-map-demo";
return {
schemaVersion: "0.1.0",
id: randomUUID(),
status: "draft",
version: "0.1.0",
metadata: {
name,
slug,
description: String(input?.description || "Первый Application Draft NDC Module Studio."),
},
designProfile: {
id: "default",
version: "0.6.0",
theme: input?.theme === "light" ? "light" : "dark",
},
pages: template ? [{
id: template.page.id,
title: template.page.title,
path: template.page.path,
template: { id: template.id, version: template.version },
navigation: { visible: true, label: template.page.navigationLabel, order: 0 },
features: Object.fromEntries(template.features.map((feature) => [feature.id, feature.required ? true : feature.defaultVisible])),
}] : [],
favicon: {
source: "design-profile",
},
timestamps: {
createdAt: now,
updatedAt: now,
},
};
}
async function writeApplicationManifest(manifest) {
const targetPath = applicationPath(manifest.id);
const tempPath = `${targetPath}.${randomUUID()}.tmp`;
await writeFile(tempPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
await rename(tempPath, targetPath);
}
function applicationSummary(manifest) {
return {
id: manifest.id,
name: manifest.metadata.name,
slug: manifest.metadata.slug,
status: manifest.status,
version: manifest.version,
theme: manifest.designProfile.theme,
pageCount: manifest.pages.length,
updatedAt: manifest.timestamps.updatedAt,
};
}
async function readJsonBody(request, maxBytes = 2 * 1024 * 1024) {
const chunks = [];
let size = 0;
for await (const chunk of request) {
size += chunk.length;
if (size > maxBytes) throw new Error("payload_too_large");
chunks.push(chunk);
}
return JSON.parse(Buffer.concat(chunks).toString("utf8"));
}
function safeUploadName(name, contentType = "") {
const allowed = new Set([".gif", ".ico", ".jpeg", ".jpg", ".m4v", ".mov", ".mp4", ".png", ".webm", ".webp"]);
const contentTypeExtensions = {
"image/gif": ".gif",
"image/x-icon": ".ico",
"image/jpeg": ".jpg",
"image/png": ".png",
"image/webp": ".webp",
"video/mp4": ".mp4",
"video/quicktime": ".mov",
"video/webm": ".webm",
};
const requestedExtension = extname(name).toLowerCase();
const extension = allowed.has(requestedExtension) ? requestedExtension : contentTypeExtensions[contentType] || ".bin";
const stem = name.replace(/\.[^.]+$/, "").replace(/[^a-z0-9_-]+/gi, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "stage-video";
return `${Date.now()}-${stem}${extension}`;
}
async function serveFile(request, response, filePath) {
const info = await stat(filePath);
const contentType = mimeTypes[extname(filePath).toLowerCase()] || "application/octet-stream";
const range = request.headers.range?.match(/^bytes=(\d*)-(\d*)$/);
if (range) {
const start = range[1] ? Number(range[1]) : 0;
const end = range[2] ? Math.min(Number(range[2]), info.size - 1) : info.size - 1;
if (!Number.isFinite(start) || !Number.isFinite(end) || start > end || start >= info.size) {
response.writeHead(416, { "content-range": `bytes */${info.size}` });
response.end();
return;
}
response.writeHead(206, {
"content-type": contentType,
"content-length": end - start + 1,
"content-range": `bytes ${start}-${end}/${info.size}`,
"accept-ranges": "bytes",
});
if (request.method === "HEAD") return response.end();
createReadStream(filePath, { start, end }).pipe(response);
return;
}
response.writeHead(200, {
"content-type": contentType,
"content-length": info.size,
"accept-ranges": "bytes",
});
if (request.method === "HEAD") return response.end();
createReadStream(filePath).pipe(response);
}
const server = createServer(async (request, response) => {
try {
const url = new URL(request.url || "/", `http://${request.headers.host || "127.0.0.1"}`);
if (url.pathname === "/api/layout" && request.method === "GET") {
try {
json(response, 200, JSON.parse(await readFile(layoutPath, "utf8")));
} catch (error) {
if (error?.code === "ENOENT") return json(response, 200, null);
throw error;
}
return;
}
if (url.pathname === "/api/applications" && request.method === "GET") {
const manifests = [];
for (const entry of await readdir(applicationsDir, { withFileTypes: true })) {
if (!entry.isFile() || !entry.name.endsWith(".json")) continue;
try {
const manifest = validateApplicationManifest(JSON.parse(await readFile(join(applicationsDir, entry.name), "utf8")));
manifests.push(applicationSummary(manifest));
} catch {
// A damaged draft must not make the complete Studio project list unavailable.
}
}
manifests.sort((left, right) => String(right.updatedAt).localeCompare(String(left.updatedAt)));
json(response, 200, manifests);
return;
}
if (url.pathname === "/api/page-templates" && request.method === "GET") {
json(response, 200, pageRegistry);
return;
}
if (url.pathname === "/api/design-profiles" && request.method === "GET") {
const profiles = [];
for (const entry of await readdir(designProfilesDir, { withFileTypes: true })) {
if (!entry.isFile() || !entry.name.endsWith(".json")) continue;
try { profiles.push(designProfileSummary(validateDesignProfile(JSON.parse(await readFile(join(designProfilesDir, entry.name), "utf8"))))); } catch { /* skip damaged draft */ }
}
profiles.sort((left, right) => left.name.localeCompare(right.name));
json(response, 200, profiles);
return;
}
if (url.pathname === "/api/design-profiles" && request.method === "POST") {
const input = await readJsonBody(request);
const now = new Date().toISOString();
const profile = validateDesignProfile({
schemaVersion: "0.1.0",
id: randomUUID(),
name: input?.name,
version: "0.1.0",
status: "draft",
layout: input?.layout,
timestamps: { createdAt: now, updatedAt: now },
});
await writeDesignProfile(profile);
json(response, 201, profile);
return;
}
const designProfileMatch = url.pathname.match(/^\/api\/design-profiles\/(default|[0-9a-f-]{36})$/i);
if (designProfileMatch && request.method === "GET") {
try { json(response, 200, validateDesignProfile(JSON.parse(await readFile(designProfilePath(designProfileMatch[1]), "utf8")))); }
catch (error) { if (error?.code === "ENOENT") return json(response, 404, { error: "design_profile_not_found" }); throw error; }
return;
}
if (designProfileMatch && request.method === "PUT") {
let current;
try { current = validateDesignProfile(JSON.parse(await readFile(designProfilePath(designProfileMatch[1]), "utf8"))); }
catch (error) { if (error?.code === "ENOENT") return json(response, 404, { error: "design_profile_not_found" }); throw error; }
const input = await readJsonBody(request);
const next = validateDesignProfile({
...current,
name: input?.name || current.name,
version: nextPatchVersion(current.version),
layout: input?.layout,
timestamps: { createdAt: current.timestamps.createdAt, updatedAt: new Date().toISOString() },
});
await writeDesignProfile(next);
json(response, 200, next);
return;
}
if (url.pathname === "/api/applications" && request.method === "POST") {
const input = await readJsonBody(request);
const manifest = validateApplicationManifest(createApplicationManifest(input));
await writeApplicationManifest(manifest);
json(response, 201, manifest);
return;
}
const applicationMatch = url.pathname.match(/^\/api\/applications\/([0-9a-f-]{36})$/i);
if (applicationMatch && request.method === "GET") {
try {
const manifest = validateApplicationManifest(JSON.parse(await readFile(applicationPath(applicationMatch[1]), "utf8")));
json(response, 200, manifest);
} catch (error) {
if (error?.code === "ENOENT") return json(response, 404, { error: "application_not_found" });
throw error;
}
return;
}
if (applicationMatch && request.method === "PUT") {
const currentPath = applicationPath(applicationMatch[1]);
let current;
try {
current = validateApplicationManifest(JSON.parse(await readFile(currentPath, "utf8")));
} catch (error) {
if (error?.code === "ENOENT") return json(response, 404, { error: "application_not_found" });
throw error;
}
const input = await readJsonBody(request);
if (String(input?.id || "") !== applicationMatch[1]) throw applicationError("application_id_mismatch");
const next = validateApplicationManifest({
...input,
timestamps: {
createdAt: current.timestamps.createdAt,
updatedAt: new Date().toISOString(),
},
});
await writeApplicationManifest(next);
json(response, 200, next);
return;
}
if (applicationMatch && request.method === "DELETE") {
const currentPath = applicationPath(applicationMatch[1]);
try { await stat(currentPath); } catch (error) { if (error?.code === "ENOENT") return json(response, 404, { error: "application_not_found" }); throw error; }
const deletedPath = join(runtimeDir, "deleted-applications");
await mkdir(deletedPath, { recursive: true });
await rename(currentPath, join(deletedPath, `${applicationMatch[1]}-${Date.now()}.json`));
json(response, 200, { deleted: true, id: applicationMatch[1] });
return;
}
if (url.pathname === "/api/layout" && request.method === "PUT") {
const layout = await readJsonBody(request);
const next = { ...layout, savedAt: new Date().toISOString(), schemaVersion: 1 };
const tempPath = `${layoutPath}.tmp`;
await writeFile(tempPath, `${JSON.stringify(next, null, 2)}\n`, "utf8");
await rename(tempPath, layoutPath);
json(response, 200, next);
return;
}
if (url.pathname === "/api/layout/media" && request.method === "PUT") {
const originalName = decodeURIComponent(String(request.headers["x-file-name"] || "stage-video.mp4"));
const fileName = safeUploadName(originalName, String(request.headers["content-type"] || ""));
const targetPath = join(uploadDir, fileName);
await pipeline(request, createWriteStream(targetPath, { flags: "wx" }));
json(response, 201, { fileName: originalName, url: `/uploads/${fileName}` });
return;
}
if (url.pathname.startsWith("/uploads/")) {
const fileName = basename(normalize(url.pathname.slice("/uploads/".length)));
await serveFile(request, response, join(uploadDir, fileName));
return;
}
const relativePath = url.pathname === "/" ? "index.html" : url.pathname.replace(/^\//, "");
const candidate = join(distDir, normalize(relativePath));
try {
await serveFile(request, response, candidate);
} catch (error) {
if (error?.code !== "ENOENT") throw error;
await serveFile(request, response, join(distDir, "index.html"));
}
} catch (error) {
const statusCode = error?.statusCode || (error?.message === "payload_too_large" ? 413 : 500);
json(response, statusCode, { error: error?.message || "server_error" });
}
});
server.listen(port, "127.0.0.1", () => {
console.log(`NODE.DC Design Guideline: http://127.0.0.1:${port}`);
console.log(`Layout store: ${layoutPath}`);
console.log(`Application drafts: ${applicationsDir}`);
});