@mergehez/dokie-node 0.1.2

package/dist/index.cjs

@@ -0,0 +1,266 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let node_fs = require("node:fs");
+node_fs = __toESM(node_fs);
+let node_path = require("node:path");
+node_path = __toESM(node_path);
+const _coreExports = createDokieServerExports(node_path.default.resolve(__dirname, "../assets/dokie.html"), (assetPath) => node_fs.default.readFileSync(assetPath, "utf8"));
+function normalizeFetchRequest(req) {
+	const url = new URL(req.url);
+	return {
+		get(name) {
+			return req.headers.get(name) ?? void 0;
+		},
+		header(name) {
+			return req.headers.get(name) ?? void 0;
+		},
+		headers: Object.fromEntries(req.headers.entries()),
+		hostname: url.host,
+		protocol: url.protocol.replace(/:$/, "")
+	};
+}
+function forCustomServer() {
+	return {
+		createDokieHandler: _coreExports.createDokieHandler,
+		createDokieMiddleware: _coreExports.createDokieHandler,
+		getDokieAssetPath: _coreExports.getDokieAssetPath,
+		registerDokieRoute: _coreExports.registerDokieRoute,
+		renderDokieHtml: _coreExports.renderDokieHtml
+	};
+}
+function forFetch() {
+	function renderDokieHtmlForFetch(options = {}, req) {
+		return _coreExports.renderDokieHtml(options, req ? normalizeFetchRequest(req) : void 0);
+	}
+	function createDokieHandlerForFetch(options = {}) {
+		return function dokieFetchHandler(req) {
+			const html = renderDokieHtmlForFetch(options, req);
+			return new Response(html, { headers: { "Content-Type": "text/html; charset=utf-8" } });
+		};
+	}
+	return {
+		createDokieHandler: createDokieHandlerForFetch,
+		createDokieMiddleware: createDokieHandlerForFetch,
+		getDokieAssetPath: _coreExports.getDokieAssetPath,
+		renderDokieHtml: renderDokieHtmlForFetch
+	};
+}
+function escapeHtml(value) {
+	return String(value).replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&#39;");
+}
+function safeJson(value) {
+	return JSON.stringify(value).replaceAll("<", "\\u003c").replaceAll(">", "\\u003e").replaceAll("&", "\\u0026").replaceAll("\u2028", "\\u2028").replaceAll("\u2029", "\\u2029");
+}
+function trimTrailingSlash(value) {
+	return typeof value === "string" ? value.replace(/\/+$/, "") : value;
+}
+function getRequestHeader(req, name) {
+	if (!req) return;
+	if (typeof req.get === "function") return req.get(name);
+	if (typeof req.header === "function") return req.header(name);
+	const headers = req.headers ?? {};
+	const value = headers[name.toLowerCase()] ?? headers[name];
+	return Array.isArray(value) ? value[0] : value;
+}
+function getOpenApiJsonUrl(currentHostname, options = {}) {
+	const configuredUrl = options.openApiJsonUrl ?? "/openapi.json";
+	if (typeof configuredUrl !== "string" || configuredUrl.length === 0) return "/openapi.json";
+	if (/^[a-z]+:\/\//i.test(configuredUrl)) return configuredUrl;
+	if (configuredUrl.startsWith("/") && currentHostname) return `${currentHostname}${configuredUrl}`;
+	return configuredUrl;
+}
+function buildDokieConfig(options = {}, req) {
+	const getProtocol = () => {
+		if (!req) return "http";
+		if (typeof req.protocol === "string" && req.protocol.length > 0) return req.protocol;
+		const forwardedProto = getRequestHeader(req, "x-forwarded-proto");
+		if (typeof forwardedProto === "string" && forwardedProto.length > 0) return forwardedProto.split(",")[0].trim();
+		if (req.socket?.encrypted || req.connection?.encrypted) return "https";
+		return "http";
+	};
+	const currentHost = (() => {
+		if (!req) return;
+		if (typeof req.hostname === "string" && req.hostname.length > 0) {
+			const port = req.socket?.localPort;
+			return req.hostname.includes(":") || !port ? req.hostname : `${req.hostname}:${port}`;
+		}
+		const forwardedHost = getRequestHeader(req, "x-forwarded-host");
+		if (typeof forwardedHost === "string" && forwardedHost.length > 0) return forwardedHost.split(",")[0].trim();
+		const host = getRequestHeader(req, "host");
+		return typeof host === "string" && host.length > 0 ? host : void 0;
+	})();
+	const currentHostname = typeof options.currentHostname === "string" && options.currentHostname.length > 0 ? trimTrailingSlash(options.currentHostname) ?? "" : currentHost ? `${getProtocol()}://${currentHost}` : "";
+	return {
+		currentHostname,
+		openApiJsonUrl: getOpenApiJsonUrl(currentHostname, options),
+		hostnames: Array.isArray(options.hostnames) && options.hostnames.length > 0 ? options.hostnames : currentHostname ? [currentHostname] : [],
+		variables: options.variables ?? {},
+		headers: options.headers ?? {},
+		postscripts: options.postscripts ?? {},
+		bodies: options.bodies ?? {},
+		favorites: options.favorites ?? []
+	};
+}
+function sendHtml(res, html) {
+	if (!res) throw new TypeError("A response object is required.");
+	if (typeof res.type === "function") res.type("html");
+	if (typeof res.setHeader === "function") res.setHeader("Content-Type", "text/html; charset=utf-8");
+	if (typeof res.send === "function") return res.send(html);
+	if (typeof res.end === "function") return res.end(html);
+	throw new TypeError("The response object must support send() or end().");
+}
+function createDokieServerExports(defaultAssetPath, readAsset) {
+	function getDokieAssetPath() {
+		return defaultAssetPath;
+	}
+	function renderDokieHtml(options = {}, req) {
+		const html = readAsset(options.assetPath ?? defaultAssetPath);
+		const dokieConfig = buildDokieConfig(options, req);
+		const finalHtml = html.replace("/*dokie-inject-area*/", `window.dokie = ${safeJson(dokieConfig)};`);
+		if (typeof options.title === "string" && options.title.trim().length > 0) return finalHtml.replace("<title>Dokie</title>", `<title>${escapeHtml(options.title)}</title>`);
+		return finalHtml;
+	}
+	function createDokieHandler(options = {}) {
+		return function dokieHandler(req, res) {
+			return sendHtml(res, renderDokieHtml(options, req));
+		};
+	}
+	function registerDokieRoute(app, options = {}) {
+		if (!app || typeof app.get !== "function") throw new TypeError("registerDokieRoute expects an app with a get(path, handler) method.");
+		const routePath = options.routePath ?? "/dokie";
+		const handler = createDokieHandler(options);
+		app.get(routePath, handler);
+		return handler;
+	}
+	return {
+		createDokieHandler,
+		createDokieMiddleware: createDokieHandler,
+		getDokieAssetPath,
+		registerDokieRoute,
+		renderDokieHtml
+	};
+}
+//#endregion
+//#region src/express.ts
+function forExpress() {
+	return {
+		createDokieHandler: _coreExports.createDokieHandler,
+		createDokieMiddleware: _coreExports.createDokieHandler,
+		getDokieAssetPath: _coreExports.getDokieAssetPath,
+		registerDokieRoute: _coreExports.registerDokieRoute,
+		renderDokieHtml: _coreExports.renderDokieHtml
+	};
+}
+//#endregion
+//#region src/fastify.ts
+function forFastify() {
+	function normalizeFastifyRequest(req) {
+		const header = (name) => {
+			const rawHeader = req.raw?.header?.(name);
+			if (typeof rawHeader === "string" && rawHeader.length > 0) return rawHeader;
+			const directHeader = req.header?.(name);
+			if (typeof directHeader === "string" && directHeader.length > 0) return directHeader;
+			const headers = req.headers ?? req.raw?.headers;
+			const value = headers?.[name.toLowerCase()] ?? headers?.[name];
+			return Array.isArray(value) ? value[0] : value;
+		};
+		return {
+			connection: req.raw?.connection,
+			get: req.raw?.get?.bind(req.raw),
+			header,
+			headers: req.headers ?? req.raw?.headers,
+			hostname: req.hostname ?? req.raw?.hostname,
+			protocol: req.protocol ?? req.raw?.protocol,
+			socket: req.raw?.socket
+		};
+	}
+	const renderDokieHtmlForFastify = (options = {}, req) => {
+		return _coreExports.renderDokieHtml(options, req ? normalizeFastifyRequest(req) : void 0);
+	};
+	function createDokieHandlerForFastify(options = {}) {
+		return function dokieFastifyHandler(req, reply) {
+			const html = renderDokieHtmlForFastify(options, req);
+			if (typeof reply.type === "function") reply.type("text/html; charset=utf-8");
+			if (typeof reply.header === "function") reply.header("Content-Type", "text/html; charset=utf-8");
+			if (typeof reply.send === "function") return reply.send(html);
+			throw new TypeError("The Fastify reply object must support send().");
+		};
+	}
+	return {
+		createDokieHandler: createDokieHandlerForFastify,
+		createDokieMiddleware: createDokieHandlerForFastify,
+		getDokieAssetPath: _coreExports.getDokieAssetPath,
+		renderDokieHtml: renderDokieHtmlForFastify,
+		registerDokieRoute(app, options = {}) {
+			if (!app || typeof app.get !== "function") throw new TypeError("registerDokieRoute expects a Fastify instance with a get(path, handler) method.");
+			const routePath = options.routePath ?? "/dokie";
+			const handler = createDokieHandlerForFastify(options);
+			app.get(routePath, handler);
+			return handler;
+		}
+	};
+}
+//#endregion
+//#region src/hono.ts
+function forHono() {
+	function normalizeHonoRequest(req) {
+		const url = new URL(req.url);
+		return {
+			get: req.get?.bind(req),
+			header: req.header?.bind(req),
+			headers: req.raw ? Object.fromEntries(req.raw.headers.entries()) : void 0,
+			hostname: url.host,
+			protocol: url.protocol.replace(/:$/, "")
+		};
+	}
+	function renderDokieHtmlForHono(options = {}, req) {
+		return _coreExports.renderDokieHtml(options, req ? normalizeHonoRequest(req) : void 0);
+	}
+	function createDokieHandlerForHono(options = {}) {
+		return function dokieHonoHandler(context) {
+			const html = renderDokieHtmlForHono(options, context.req);
+			if (typeof context.html === "function") return context.html(html);
+			return new Response(html, { headers: { "Content-Type": "text/html; charset=utf-8" } });
+		};
+	}
+	return {
+		createDokieHandler: createDokieHandlerForHono,
+		createDokieMiddleware: createDokieHandlerForHono,
+		getDokieAssetPath: _coreExports.getDokieAssetPath,
+		renderDokieHtml: renderDokieHtmlForHono,
+		registerDokieRoute(app, options = {}) {
+			if (!app || typeof app.get !== "function") throw new TypeError("registerDokieRoute expects a Hono app with a get(path, handler) method.");
+			const routePath = options.routePath ?? "/dokie";
+			const handler = createDokieHandlerForHono(options);
+			app.get(routePath, handler);
+			return handler;
+		}
+	};
+}
+//#endregion
+exports.forCustomServer = forCustomServer;
+exports.forExpress = forExpress;
+exports.forFastify = forFastify;
+exports.forFetch = forFetch;
+exports.forHono = forHono;

package/dist/index.d.cts

@@ -0,0 +1,113 @@
+//#region src/base.d.ts
+type DokieRequestLike = {
+  connection?: {
+    encrypted?: boolean;
+  };
+  get?(name: string): string | undefined;
+  header?(name: string): string | undefined;
+  headers?: Record<string, string | string[] | undefined>;
+  hostname?: string;
+  protocol?: string;
+  socket?: {
+    encrypted?: boolean;
+    localPort?: number;
+  };
+};
+type DokieResponseLike = {
+  end?(chunk?: string): unknown;
+  send?(body: string): unknown;
+  setHeader?(name: string, value: string): unknown;
+  type?(value: string): unknown;
+};
+type DokieAppLike = {
+  get(path: string, handler: (req: DokieRequestLike, res: DokieResponseLike) => unknown): unknown;
+};
+type DokieFetchRequestLike = Request;
+type DokieOptions = {
+  bodies?: Record<string, string>;
+  currentHostname?: string;
+  favorites?: string[];
+  headers?: Record<string, string>;
+  hostnames?: string[];
+  openApiJsonUrl?: string;
+  postscripts?: Record<string, string>;
+  title?: string;
+  variables?: Record<string, string>;
+  assetPath?: string;
+  routePath?: string;
+};
+declare function forCustomServer(): {
+  createDokieHandler: (options?: DokieOptions) => (req: DokieRequestLike, res: DokieResponseLike) => unknown;
+  createDokieMiddleware: (options?: DokieOptions) => (req: DokieRequestLike, res: DokieResponseLike) => unknown;
+  getDokieAssetPath: () => string;
+  registerDokieRoute: (app: DokieAppLike, options?: DokieOptions) => (req: DokieRequestLike, res: DokieResponseLike) => unknown;
+  renderDokieHtml: (options?: DokieOptions, req?: DokieRequestLike) => string;
+};
+declare function forFetch(): {
+  createDokieHandler: (options?: DokieOptions) => (req: DokieFetchRequestLike) => Response;
+  createDokieMiddleware: (options?: DokieOptions) => (req: DokieFetchRequestLike) => Response;
+  getDokieAssetPath: () => string;
+  renderDokieHtml: (options?: DokieOptions, req?: DokieFetchRequestLike) => string;
+};
+//#endregion
+//#region src/express.d.ts
+declare function forExpress(): {
+  createDokieHandler: (options?: DokieOptions) => (req: DokieRequestLike, res: DokieResponseLike) => unknown;
+  createDokieMiddleware: (options?: DokieOptions) => (req: DokieRequestLike, res: DokieResponseLike) => unknown;
+  getDokieAssetPath: () => string;
+  registerDokieRoute: (app: DokieAppLike, options?: DokieOptions) => (req: DokieRequestLike, res: DokieResponseLike) => unknown;
+  renderDokieHtml: (options?: DokieOptions, req?: DokieRequestLike) => string;
+};
+//#endregion
+//#region src/fastify.d.ts
+type FastifyRawRequestLike = DokieRequestLike & {
+  headers?: Record<string, string | string[] | undefined>;
+  hostname?: string;
+  protocol?: string;
+};
+type FastifyRequestLike = {
+  header?(name: string): string | undefined;
+  headers?: Record<string, string | string[] | undefined>;
+  hostname?: string;
+  protocol?: string;
+  raw?: FastifyRawRequestLike;
+};
+type FastifyReplyLike = {
+  header?(name: string, value: string): unknown;
+  send?(body: string): unknown;
+  type?(value: string): unknown;
+};
+type FastifyInstanceLike = {
+  get(path: string, handler: (req: FastifyRequestLike, reply: FastifyReplyLike) => unknown): unknown;
+};
+declare function forFastify(): {
+  createDokieHandler: (options?: DokieOptions) => (req: FastifyRequestLike, reply: FastifyReplyLike) => unknown;
+  createDokieMiddleware: (options?: DokieOptions) => (req: FastifyRequestLike, reply: FastifyReplyLike) => unknown;
+  getDokieAssetPath: () => string;
+  renderDokieHtml: (options?: DokieOptions, req?: FastifyRequestLike) => string;
+  registerDokieRoute(app: FastifyInstanceLike, options?: DokieOptions): (req: FastifyRequestLike, reply: FastifyReplyLike) => unknown;
+};
+//#endregion
+//#region src/hono.d.ts
+type HonoRequestLike = {
+  get?(name: string): string | undefined;
+  header?(name: string): string | undefined;
+  raw?: Request;
+  url: string;
+};
+type HonoContextLike = {
+  html?(html: string, status?: number): unknown;
+  req: HonoRequestLike;
+};
+type HonoAppLike = {
+  get(path: string, handler: (context: HonoContextLike) => unknown): unknown;
+};
+declare function forHono(): {
+  createDokieHandler: (options?: DokieOptions) => (context: HonoContextLike) => unknown;
+  createDokieMiddleware: (options?: DokieOptions) => (context: HonoContextLike) => unknown;
+  getDokieAssetPath: () => string;
+  renderDokieHtml: (options?: DokieOptions, req?: HonoRequestLike) => string;
+  registerDokieRoute(app: HonoAppLike, options?: DokieOptions): (context: HonoContextLike) => unknown;
+};
+//#endregion
+export { type DokieAppLike, type DokieFetchRequestLike, type DokieOptions, type DokieRequestLike, type DokieResponseLike, forCustomServer, forExpress, forFastify, forFetch, forHono };

package/dist/index.d.mts

@@ -0,0 +1,113 @@
+//#region src/base.d.ts
+type DokieRequestLike = {
+  connection?: {
+    encrypted?: boolean;
+  };
+  get?(name: string): string | undefined;
+  header?(name: string): string | undefined;
+  headers?: Record<string, string | string[] | undefined>;
+  hostname?: string;
+  protocol?: string;
+  socket?: {
+    encrypted?: boolean;
+    localPort?: number;
+  };
+};
+type DokieResponseLike = {
+  end?(chunk?: string): unknown;
+  send?(body: string): unknown;
+  setHeader?(name: string, value: string): unknown;
+  type?(value: string): unknown;
+};
+type DokieAppLike = {
+  get(path: string, handler: (req: DokieRequestLike, res: DokieResponseLike) => unknown): unknown;
+};
+type DokieFetchRequestLike = Request;
+type DokieOptions = {
+  bodies?: Record<string, string>;
+  currentHostname?: string;
+  favorites?: string[];
+  headers?: Record<string, string>;
+  hostnames?: string[];
+  openApiJsonUrl?: string;
+  postscripts?: Record<string, string>;
+  title?: string;
+  variables?: Record<string, string>;
+  assetPath?: string;
+  routePath?: string;
+};
+declare function forCustomServer(): {
+  createDokieHandler: (options?: DokieOptions) => (req: DokieRequestLike, res: DokieResponseLike) => unknown;
+  createDokieMiddleware: (options?: DokieOptions) => (req: DokieRequestLike, res: DokieResponseLike) => unknown;
+  getDokieAssetPath: () => string;
+  registerDokieRoute: (app: DokieAppLike, options?: DokieOptions) => (req: DokieRequestLike, res: DokieResponseLike) => unknown;
+  renderDokieHtml: (options?: DokieOptions, req?: DokieRequestLike) => string;
+};
+declare function forFetch(): {
+  createDokieHandler: (options?: DokieOptions) => (req: DokieFetchRequestLike) => Response;
+  createDokieMiddleware: (options?: DokieOptions) => (req: DokieFetchRequestLike) => Response;
+  getDokieAssetPath: () => string;
+  renderDokieHtml: (options?: DokieOptions, req?: DokieFetchRequestLike) => string;
+};
+//#endregion
+//#region src/express.d.ts
+declare function forExpress(): {
+  createDokieHandler: (options?: DokieOptions) => (req: DokieRequestLike, res: DokieResponseLike) => unknown;
+  createDokieMiddleware: (options?: DokieOptions) => (req: DokieRequestLike, res: DokieResponseLike) => unknown;
+  getDokieAssetPath: () => string;
+  registerDokieRoute: (app: DokieAppLike, options?: DokieOptions) => (req: DokieRequestLike, res: DokieResponseLike) => unknown;
+  renderDokieHtml: (options?: DokieOptions, req?: DokieRequestLike) => string;
+};
+//#endregion
+//#region src/fastify.d.ts
+type FastifyRawRequestLike = DokieRequestLike & {
+  headers?: Record<string, string | string[] | undefined>;
+  hostname?: string;
+  protocol?: string;
+};
+type FastifyRequestLike = {
+  header?(name: string): string | undefined;
+  headers?: Record<string, string | string[] | undefined>;
+  hostname?: string;
+  protocol?: string;
+  raw?: FastifyRawRequestLike;
+};
+type FastifyReplyLike = {
+  header?(name: string, value: string): unknown;
+  send?(body: string): unknown;
+  type?(value: string): unknown;
+};
+type FastifyInstanceLike = {
+  get(path: string, handler: (req: FastifyRequestLike, reply: FastifyReplyLike) => unknown): unknown;
+};
+declare function forFastify(): {
+  createDokieHandler: (options?: DokieOptions) => (req: FastifyRequestLike, reply: FastifyReplyLike) => unknown;
+  createDokieMiddleware: (options?: DokieOptions) => (req: FastifyRequestLike, reply: FastifyReplyLike) => unknown;
+  getDokieAssetPath: () => string;
+  renderDokieHtml: (options?: DokieOptions, req?: FastifyRequestLike) => string;
+  registerDokieRoute(app: FastifyInstanceLike, options?: DokieOptions): (req: FastifyRequestLike, reply: FastifyReplyLike) => unknown;
+};
+//#endregion
+//#region src/hono.d.ts
+type HonoRequestLike = {
+  get?(name: string): string | undefined;
+  header?(name: string): string | undefined;
+  raw?: Request;
+  url: string;
+};
+type HonoContextLike = {
+  html?(html: string, status?: number): unknown;
+  req: HonoRequestLike;
+};
+type HonoAppLike = {
+  get(path: string, handler: (context: HonoContextLike) => unknown): unknown;
+};
+declare function forHono(): {
+  createDokieHandler: (options?: DokieOptions) => (context: HonoContextLike) => unknown;
+  createDokieMiddleware: (options?: DokieOptions) => (context: HonoContextLike) => unknown;
+  getDokieAssetPath: () => string;
+  renderDokieHtml: (options?: DokieOptions, req?: HonoRequestLike) => string;
+  registerDokieRoute(app: HonoAppLike, options?: DokieOptions): (context: HonoContextLike) => unknown;
+};
+//#endregion
+export { type DokieAppLike, type DokieFetchRequestLike, type DokieOptions, type DokieRequestLike, type DokieResponseLike, forCustomServer, forExpress, forFastify, forFetch, forHono };