@editframe/dev-server 0.51.0

package/dist/middleware.js

@@ -0,0 +1,156 @@
+import { forbidRelativePaths } from "./forbidRelativePaths.js";
+import { sendTaskResult } from "./sendTaskResult.js";
+import debug from "debug";
+import path, { join } from "node:path";
+import { rm } from "node:fs/promises";
+//#region src/middleware.ts
+function createAssetsApiMiddleware(options, deps) {
+	const { cacheImage, findOrCreateCaptions } = deps;
+	return async (req, res, next) => {
+		const log = debug("ef:dev-server:assets");
+		const reqUrl = req.url || "";
+		if (!reqUrl.startsWith("/api/v1/assets/")) return next();
+		forbidRelativePaths(req);
+		const url = new URL(reqUrl, `http://${req.headers.host}`);
+		const urlPath = url.pathname;
+		const src = url.searchParams.get("src");
+		if (!src) {
+			res.writeHead(400, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({ error: "src parameter is required" }));
+			return;
+		}
+		const isRemote = src.startsWith("http://") || src.startsWith("https://");
+		const absolutePath = isRemote ? src : path.join(options.root, src).replace("dist/", "src/");
+		log(`Handling assets API: ${urlPath} src=${src}`);
+		try {
+			if (urlPath === "/api/v1/assets/image") {
+				if (isRemote) {
+					const response = await fetch(src);
+					if (!response.ok) {
+						res.writeHead(response.status);
+						res.end();
+						return;
+					}
+					const contentType = response.headers.get("content-type") ?? "application/octet-stream";
+					const buffer = await response.arrayBuffer();
+					res.writeHead(200, { "Content-Type": contentType });
+					res.end(Buffer.from(buffer));
+				} else sendTaskResult(req, res, await cacheImage(options.cacheRoot, absolutePath));
+				return;
+			}
+			if (urlPath === "/api/v1/assets/captions") {
+				sendTaskResult(req, res, await findOrCreateCaptions(options.cacheRoot, absolutePath));
+				return;
+			}
+			res.writeHead(404, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({ error: "Unknown assets endpoint" }));
+		} catch (error) {
+			log(`Error handling assets request: ${error}`);
+			if (error.code === "ENOENT") {
+				res.writeHead(404, { "Content-Type": "text/plain" });
+				res.end("File not found");
+			} else {
+				res.writeHead(500, { "Content-Type": "application/json" });
+				res.end(JSON.stringify({ error: error.message }));
+			}
+		}
+	};
+}
+function createLocalFilesApiMiddleware(options, deps) {
+	const { generateTrack, generateScrubTrack, generateTrackFragmentIndex, md5FilePath } = deps;
+	return async (req, res, next) => {
+		const log = debug("ef:dev-server:files");
+		const reqUrl = req.url || "";
+		const url = new URL(reqUrl, `http://${req.headers.host}`);
+		const urlPath = url.pathname;
+		const src = url.searchParams.get("src");
+		if (!src || urlPath !== "/api/v1/files/index" && urlPath !== "/api/v1/files/md5" && urlPath !== "/api/v1/files/track") return next();
+		forbidRelativePaths(req);
+		const absolutePath = src.startsWith("http") ? src : path.join(options.root, src).replace("dist/", "src/");
+		log(`Handling local file API: ${urlPath} for ${absolutePath}`);
+		try {
+			if (urlPath === "/api/v1/files/index") {
+				log(`Serving track fragment index for ${absolutePath}`);
+				sendTaskResult(req, res, await generateTrackFragmentIndex(options.cacheRoot, absolutePath));
+				return;
+			}
+			if (urlPath === "/api/v1/files/md5") {
+				log(`Getting MD5 for ${absolutePath}`);
+				try {
+					const md5 = await md5FilePath(absolutePath);
+					res.writeHead(200, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ md5 }));
+				} catch (error) {
+					if (error.code === "ENOENT") {
+						res.writeHead(404, { "Content-Type": "text/plain" });
+						res.end("File not found");
+					} else {
+						res.writeHead(500, { "Content-Type": "application/json" });
+						res.end(JSON.stringify({ error: error.message }));
+					}
+				}
+				return;
+			}
+			if (urlPath === "/api/v1/files/track") {
+				const trackIdStr = url.searchParams.get("trackId");
+				const segmentIdStr = url.searchParams.get("segmentId");
+				if (!trackIdStr) {
+					res.writeHead(400, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ error: "trackId parameter is required" }));
+					return;
+				}
+				const trackId = parseInt(trackIdStr, 10);
+				if (trackId === -1) {
+					log(`Serving scrub track for ${absolutePath}`);
+					sendTaskResult(req, res, await generateScrubTrack(options.cacheRoot, absolutePath));
+					return;
+				}
+				log(`Serving track ${trackId} segment ${segmentIdStr || "all"} for ${absolutePath}`);
+				const trackUrl = `/@ef-track/${src}?trackId=${trackId}${segmentIdStr ? `&segmentId=${segmentIdStr}` : ""}`;
+				sendTaskResult(req, res, await generateTrack(options.cacheRoot, absolutePath, trackUrl));
+				return;
+			}
+		} catch (error) {
+			log(`Error handling local file request: ${error}`);
+			if (error.code === "ENOENT") {
+				res.writeHead(404, { "Content-Type": "text/plain" });
+				res.end("File not found");
+			} else {
+				res.writeHead(500, { "Content-Type": "application/json" });
+				res.end(JSON.stringify({ error: error.message }));
+			}
+		}
+	};
+}
+async function handleClearCache(req, res, cacheRoot) {
+	const log = debug("ef:dev-server");
+	if (req.method !== "DELETE") {
+		res.writeHead(405, { Allow: "DELETE" });
+		res.end();
+		return;
+	}
+	log(`Clearing cache for ${cacheRoot}`);
+	const cachePath = join(cacheRoot, ".cache");
+	const maxRetries = 3;
+	for (let attempt = 0; attempt < maxRetries; attempt++) try {
+		await rm(cachePath, {
+			recursive: true,
+			force: true
+		});
+		break;
+	} catch (error) {
+		if (error.code === "ENOENT") break;
+		if (error.code === "ENOTEMPTY" && attempt < maxRetries - 1) {
+			await new Promise((resolve) => setTimeout(resolve, 100 * (attempt + 1)));
+			continue;
+		}
+		log(`Warning: Cache clear attempt ${attempt + 1} failed: ${error.message}`);
+		if (attempt === maxRetries - 1) log(`Cache clear failed after ${maxRetries} attempts, continuing anyway`);
+	}
+	res.writeHead(200, { "Content-Type": "text/plain" });
+	res.end("Cache cleared");
+}
+//#endregion
+export { createAssetsApiMiddleware, createLocalFilesApiMiddleware, handleClearCache };
+
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","names":[],"sources":["../src/middleware.ts"],"mappings":"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"}

package/dist/router.d.ts

@@ -0,0 +1,31 @@
+import { AssetFunctions } from "./jitTranscodeMiddleware.js";
+import { EfHandlers } from "./efHandlers.js";
+import { ServerResponse } from "node:http";
+import { IncomingMessage as IncomingMessage$1, NextFunction } from "connect";
+
+//#region src/router.d.ts
+interface DevServerOptions {
+  root: string;
+  cacheRoot: string;
+  handleRemoteUrls?: boolean;
+}
+interface RouterAssetFunctions extends AssetFunctions {
+  cacheImage: (cacheRoot: string, src: string) => Promise<any>;
+  findOrCreateCaptions: (cacheRoot: string, src: string) => Promise<any>;
+  md5FilePath: (src: string) => Promise<string>;
+}
+type ConnectMiddleware = (req: IncomingMessage$1, res: ServerResponse, next: NextFunction) => void | Promise<void>;
+/**
+ * Assemble the full Editframe middleware stack.
+ * Returns a single Connect-compatible middleware function that can be mounted
+ * onto any Connect/Express/Vite/http server.
+ */
+declare function createEditframeRouter(options: DevServerOptions, assetFns: RouterAssetFunctions, efHandlers: EfHandlers): ConnectMiddleware;
+/**
+ * Inject the apiHost script into an HTML string.
+ * Each framework adapter calls this from its own HTML transform hook.
+ */
+declare function injectApiHostScript(html: string, origin: string): string;
+//#endregion
+export { DevServerOptions, RouterAssetFunctions, createEditframeRouter, injectApiHostScript };
+//# sourceMappingURL=router.d.ts.map

package/dist/router.js

@@ -0,0 +1,80 @@
+import { forbidRelativePaths } from "./forbidRelativePaths.js";
+import { createJitTranscodeMiddleware } from "./jitTranscodeMiddleware.js";
+import { createAssetsApiMiddleware, createLocalFilesApiMiddleware } from "./middleware.js";
+import debug from "debug";
+//#region src/router.ts
+/**
+* Assemble the full Editframe middleware stack.
+* Returns a single Connect-compatible middleware function that can be mounted
+* onto any Connect/Express/Vite/http server.
+*/
+function createEditframeRouter(options, assetFns, efHandlers) {
+	const jitMiddleware = createJitTranscodeMiddleware({
+		root: options.root,
+		cacheRoot: options.cacheRoot,
+		handleRemoteUrls: options.handleRemoteUrls
+	}, assetFns);
+	const assetsMiddleware = createAssetsApiMiddleware(options, assetFns);
+	const filesMiddleware = createLocalFilesApiMiddleware(options, assetFns);
+	const efMiddleware = async (req, res, next) => {
+		const log = debug("ef:dev-server");
+		if (!req.url?.startsWith("/@ef")) return next();
+		forbidRelativePaths(req);
+		log(`Handling ${req.url} at ${(/* @__PURE__ */ new Date()).toISOString()}`);
+		const cacheRoot = options.cacheRoot.replace("dist/", "src/");
+		const efPrefix = req.url.split("/")[1];
+		switch (efPrefix) {
+			case "@ef-clear-cache":
+				await efHandlers.clearCache(req, res, cacheRoot);
+				break;
+			case "@ef-sign-url":
+				await efHandlers.signUrl(req, res);
+				break;
+			case "@ef-write-snapshot":
+				if (efHandlers.writeSnapshot) await efHandlers.writeSnapshot(req, res);
+				else {
+					res.writeHead(404, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ error: "Snapshot endpoints not available in this configuration" }));
+				}
+				break;
+			case "@ef-compare-snapshot":
+				if (efHandlers.compareSnapshot) await efHandlers.compareSnapshot(req, res);
+				else {
+					res.writeHead(404, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ error: "Snapshot endpoints not available in this configuration" }));
+				}
+				break;
+			case "@ef-compare-two-images":
+				if (efHandlers.compareTwoImages) await efHandlers.compareTwoImages(req, res);
+				else {
+					res.writeHead(404, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ error: "Snapshot endpoints not available in this configuration" }));
+				}
+				break;
+			default:
+				log(`Unknown ef prefix: ${efPrefix}`);
+				break;
+		}
+	};
+	return (req, res, next) => {
+		jitMiddleware(req, res, () => {
+			assetsMiddleware(req, res, () => {
+				filesMiddleware(req, res, () => {
+					efMiddleware(req, res, next);
+				});
+			});
+		});
+	};
+}
+/**
+* Inject the apiHost script into an HTML string.
+* Each framework adapter calls this from its own HTML transform hook.
+*/
+function injectApiHostScript(html, origin) {
+	const script = `<script>window.__EDITFRAME__ = Object.assign({}, window.__EDITFRAME__, { apiHost: "${origin}" });<\/script>`;
+	return html.replace(/(<head[^>]*>)/i, `$1${script}`);
+}
+//#endregion
+export { createEditframeRouter, injectApiHostScript };
+
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","names":[],"sources":["../src/router.ts"],"mappings":";;;;;;;;;;AAoCA,SAAgB,sBACd,SACA,UACA,YACmB;CAOnB,MAAM,gBAAgB,6BANmB;EACvC,MAAM,QAAQ;EACd,WAAW,QAAQ;EACnB,kBAAkB,QAAQ;EAC3B,EAE8D,SAAS;CACxE,MAAM,mBAAmB,0BAA0B,SAAS,SAAS;CACrE,MAAM,kBAAkB,8BAA8B,SAAS,SAAS;CAExE,MAAM,eAAe,OAAO,KAAsB,KAAqB,SAAuB;EAC5F,MAAM,MAAM,MAAM,gBAAgB;AAElC,MAAI,CAAC,IAAI,KAAK,WAAW,OAAO,CAC9B,QAAO,MAAM;AAGf,sBAAoB,IAAI;AACxB,MAAI,YAAY,IAAI,IAAI,uBAAM,IAAI,MAAM,EAAC,aAAa,GAAG;EAEzD,MAAM,YAAY,QAAQ,UAAU,QAAQ,SAAS,OAAO;EAC5D,MAAM,WAAW,IAAI,IAAI,MAAM,IAAI,CAAC;AAEpC,UAAQ,UAAR;GACE,KAAK;AACH,UAAM,WAAW,WAAW,KAAK,KAAK,UAAU;AAChD;GACF,KAAK;AACH,UAAM,WAAW,QAAQ,KAAK,IAAI;AAClC;GACF,KAAK;AACH,QAAI,WAAW,cACb,OAAM,WAAW,cAAc,KAAK,IAAI;SACnC;AACL,SAAI,UAAU,KAAK,EAAE,gBAAgB,oBAAoB,CAAC;AAC1D,SAAI,IAAI,KAAK,UAAU,EAAE,OAAO,0DAA0D,CAAC,CAAC;;AAE9F;GACF,KAAK;AACH,QAAI,WAAW,gBACb,OAAM,WAAW,gBAAgB,KAAK,IAAI;SACrC;AACL,SAAI,UAAU,KAAK,EAAE,gBAAgB,oBAAoB,CAAC;AAC1D,SAAI,IAAI,KAAK,UAAU,EAAE,OAAO,0DAA0D,CAAC,CAAC;;AAE9F;GACF,KAAK;AACH,QAAI,WAAW,iBACb,OAAM,WAAW,iBAAiB,KAAK,IAAI;SACtC;AACL,SAAI,UAAU,KAAK,EAAE,gBAAgB,oBAAoB,CAAC;AAC1D,SAAI,IAAI,KAAK,UAAU,EAAE,OAAO,0DAA0D,CAAC,CAAC;;AAE9F;GACF;AACE,QAAI,sBAAsB,WAAW;AACrC;;;AAKN,SAAQ,KAAsB,KAAqB,SAAuB;AACxE,gBAAc,KAAK,WAAW;AAC5B,oBAAiB,KAAK,WAAW;AAC/B,oBAAgB,KAAK,WAAW;AAC9B,kBAAa,KAAK,KAAK,KAAK;MAC5B;KACF;IACF;;;;;;;AAQN,SAAgB,oBAAoB,MAAc,QAAwB;CACxE,MAAM,SAAS,sFAAsF,OAAO;AAC5G,QAAO,KAAK,QAAQ,kBAAkB,KAAK,SAAS"}

package/dist/sendTaskResult.d.ts

@@ -0,0 +1,8 @@
+import { IncomingMessage, ServerResponse } from "node:http";
+import { TaskResult } from "@editframe/assets";
+
+//#region src/sendTaskResult.d.ts
+declare const sendTaskResult: (req: IncomingMessage, res: ServerResponse<IncomingMessage>, taskResult: TaskResult) => ServerResponse<IncomingMessage> | undefined;
+//#endregion
+export { sendTaskResult };
+//# sourceMappingURL=sendTaskResult.d.ts.map

package/dist/sendTaskResult.js

@@ -0,0 +1,67 @@
+import debug from "debug";
+import { createReadStream, statSync } from "node:fs";
+import mime from "mime";
+//#region src/sendTaskResult.ts
+const sendTaskResult = (req, res, taskResult) => {
+	const { cachePath, md5Sum } = taskResult;
+	const filePath = cachePath;
+	const headers = { etag: md5Sum };
+	const log = debug("ef:sendfile");
+	const sendStartTime = Date.now();
+	try {
+		const stats = statSync(filePath);
+		log(`Sending file ${filePath} (size: ${stats.size} bytes)`);
+		if (req.headers.range) {
+			const [x, y] = req.headers.range.replace("bytes=", "").split("-");
+			let end = Number.parseInt(y ?? "0", 10) || stats.size - 1;
+			const start = Number.parseInt(x ?? "0", 10) || 0;
+			if (end >= stats.size) end = stats.size - 1;
+			if (start >= stats.size) {
+				log("Range start is greater than file size");
+				res.setHeader("Content-Range", `bytes */${stats.size}`);
+				res.statusCode = 416;
+				return res.end();
+			}
+			res.writeHead(206, {
+				...headers,
+				"Content-Type": mime.getType(filePath) || "text/plain",
+				"Cache-Control": "max-age=3600",
+				"Content-Range": `bytes ${start}-${end}/${stats.size}`,
+				"Content-Length": end - start + 1,
+				"Accept-Ranges": "bytes"
+			});
+			log(`Sending ${filePath} range ${start}-${end}/${stats.size}`);
+			const readStream = createReadStream(filePath, {
+				start,
+				end
+			});
+			readStream.on("end", () => {
+				log(`Range request completed in ${Date.now() - sendStartTime}ms`);
+			});
+			readStream.pipe(res);
+		} else {
+			res.writeHead(200, {
+				...headers,
+				"Content-Type": mime.getType(filePath) || "text/plain",
+				"Cache-Control": "max-age=3600",
+				"Content-Length": stats.size
+			});
+			log(`Sending full file ${filePath} (${stats.size} bytes)`);
+			const readStream = createReadStream(filePath);
+			readStream.on("end", () => {
+				log(`File send completed in ${Date.now() - sendStartTime}ms`);
+			});
+			readStream.pipe(res);
+		}
+	} catch (error) {
+		log(`Error sending file after ${Date.now() - sendStartTime}ms:`, error);
+		if (!res.headersSent) {
+			res.writeHead(500, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({ error: error.message }));
+		}
+	}
+};
+//#endregion
+export { sendTaskResult };
+
+//# sourceMappingURL=sendTaskResult.js.map

package/dist/sendTaskResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendTaskResult.js","names":[],"sources":["../src/sendTaskResult.ts"],"mappings":";;;;AAMA,MAAa,kBACX,KACA,KACA,eACG;CACH,MAAM,EAAE,WAAW,WAAW;CAC9B,MAAM,WAAW;CACjB,MAAM,UAAU,EACd,MAAM,QACP;CACD,MAAM,MAAM,MAAM,cAAc;CAChC,MAAM,gBAAgB,KAAK,KAAK;AAChC,KAAI;EACF,MAAM,QAAQ,SAAS,SAAS;AAChC,MAAI,gBAAgB,SAAS,UAAU,MAAM,KAAK,SAAS;AAE3D,MAAI,IAAI,QAAQ,OAAO;GACrB,MAAM,CAAC,GAAG,KAAK,IAAI,QAAQ,MAAM,QAAQ,UAAU,GAAG,CAAC,MAAM,IAAI;GACjE,IAAI,MAAM,OAAO,SAAS,KAAK,KAAK,GAAG,IAAI,MAAM,OAAO;GACxD,MAAM,QAAQ,OAAO,SAAS,KAAK,KAAK,GAAG,IAAI;AAE/C,OAAI,OAAO,MAAM,KACf,OAAM,MAAM,OAAO;AAGrB,OAAI,SAAS,MAAM,MAAM;AACvB,QAAI,wCAAwC;AAC5C,QAAI,UAAU,iBAAiB,WAAW,MAAM,OAAO;AACvD,QAAI,aAAa;AACjB,WAAO,IAAI,KAAK;;AAGlB,OAAI,UAAU,KAAK;IACjB,GAAG;IACH,gBAAgB,KAAK,QAAQ,SAAS,IAAI;IAC1C,iBAAiB;IACjB,iBAAiB,SAAS,MAAM,GAAG,IAAI,GAAG,MAAM;IAChD,kBAAkB,MAAM,QAAQ;IAChC,iBAAiB;IAClB,CAAC;AACF,OAAI,WAAW,SAAS,SAAS,MAAM,GAAG,IAAI,GAAG,MAAM,OAAO;GAC9D,MAAM,aAAa,iBAAiB,UAAU;IAAE;IAAO;IAAK,CAAC;AAC7D,cAAW,GAAG,aAAa;AAEzB,QAAI,8BADY,KAAK,KAAK,GAAG,cACa,IAAI;KAC9C;AACF,cAAW,KAAK,IAAI;SACf;AACL,OAAI,UAAU,KAAK;IACjB,GAAG;IACH,gBAAgB,KAAK,QAAQ,SAAS,IAAI;IAC1C,iBAAiB;IACjB,kBAAkB,MAAM;IACzB,CAAC;AACF,OAAI,qBAAqB,SAAS,IAAI,MAAM,KAAK,SAAS;GAC1D,MAAM,aAAa,iBAAiB,SAAS;AAC7C,cAAW,GAAG,aAAa;AAEzB,QAAI,0BADY,KAAK,KAAK,GAAG,cACS,IAAI;KAC1C;AACF,cAAW,KAAK,IAAI;;UAEf,OAAO;AAEd,MAAI,4BADY,KAAK,KAAK,GAAG,cACW,MAAM,MAAM;AACpD,MAAI,CAAC,IAAI,aAAa;AACpB,OAAI,UAAU,KAAK,EAAE,gBAAgB,oBAAoB,CAAC;AAC1D,OAAI,IAAI,KAAK,UAAU,EAAE,OAAQ,MAAgB,SAAS,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,22 @@
+import { EfHandlers } from "./efHandlers.js";
+import { DevServerOptions, RouterAssetFunctions } from "./router.js";
+import * as http from "node:http";
+
+//#region src/server.d.ts
+interface EditframeDevServerOptions extends DevServerOptions {
+  port?: number;
+}
+/**
+ * Create a standalone http.Server that serves the full Editframe dev media API.
+ *
+ * Use this for toolchains that do not expose a Connect middleware stack
+ * (e.g. Webpack, Rspack, Next.js custom server). The server listens on its
+ * own port; adapters inject window.__EDITFRAME__.apiHost pointing at that port.
+ *
+ * Vite adapters should prefer createEditframeRouter() and mount it directly
+ * onto server.middlewares instead.
+ */
+declare function createEditframeDevServer(options: EditframeDevServerOptions, assetFns: RouterAssetFunctions, efHandlers: EfHandlers): http.Server;
+//#endregion
+export { EditframeDevServerOptions, createEditframeDevServer };
+//# sourceMappingURL=server.d.ts.map

package/dist/server.js

@@ -0,0 +1,26 @@
+import { createEditframeRouter } from "./router.js";
+import * as http from "node:http";
+//#region src/server.ts
+/**
+* Create a standalone http.Server that serves the full Editframe dev media API.
+*
+* Use this for toolchains that do not expose a Connect middleware stack
+* (e.g. Webpack, Rspack, Next.js custom server). The server listens on its
+* own port; adapters inject window.__EDITFRAME__.apiHost pointing at that port.
+*
+* Vite adapters should prefer createEditframeRouter() and mount it directly
+* onto server.middlewares instead.
+*/
+function createEditframeDevServer(options, assetFns, efHandlers) {
+	const router = createEditframeRouter(options, assetFns, efHandlers);
+	return http.createServer((req, res) => {
+		router(req, res, () => {
+			res.writeHead(404, { "Content-Type": "text/plain" });
+			res.end("Not found");
+		});
+	});
+}
+//#endregion
+export { createEditframeDevServer };
+
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","names":[],"sources":["../src/server.ts"],"mappings":";;;;;;;;;;;;;AAoBA,SAAgB,yBACd,SACA,UACA,YACa;CACb,MAAM,SAAS,sBAAsB,SAAS,UAAU,WAAW;AAUnE,QARe,KAAK,cAAc,KAAsB,QAAwB;AAE9E,SAAO,KAAK,WAAW;AACrB,OAAI,UAAU,KAAK,EAAE,gBAAgB,cAAc,CAAC;AACpD,OAAI,IAAI,YAAY;IACpB;GACF"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@editframe/dev-server",
+  "version": "0.51.0",
+  "description": "Framework-agnostic Editframe dev media server",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsdown",
+    "build:watch": "tsdown --watch"
+  },
+  "type": "module",
+  "author": "",
+  "license": "SEE LICENSE IN LICENSE-FULL.md",
+  "dependencies": {
+    "@editframe/api": "0.51.0",
+    "@editframe/assets": "0.51.0",
+    "connect": "^3.7.0",
+    "debug": "^4.3.5",
+    "mime": "^4.0.3",
+    "odiff-bin": "^4.3.2"
+  },
+  "devDependencies": {
+    "@types/connect": "^3.4.38",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.9.3"
+  },
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "exports": {
+      ".": {
+        "import": {
+          "types": "./dist/index.d.ts",
+          "default": "./dist/index.js"
+        }
+      },
+      "./package.json": "./package.json"
+    }
+  }
+}

package/tsdown.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from "tsdown";
+
+import { createTsdownConfig } from "../tsdown.config.base.ts";
+
+export default defineConfig(
+  createTsdownConfig({
+    platform: "node",
+  }),
+);