@repdf/preview 0.0.1

package/LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 repdf
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+STILL IN DEVELOPMENT
+
+repdf preview app

package/dist/index.cjs

@@ -0,0 +1,373 @@
+#!/usr/bin/env node
+"use strict";
+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 (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/cli/index.ts
+var import_commander = require("commander");
+
+// package.json
+var package_default = {
+  name: "@repdf/preview",
+  version: "0.0.1",
+  type: "module",
+  private: false,
+  main: "dist/index.js",
+  exports: {
+    "./package.json": "./package.json",
+    ".": {
+      import: "./dist/index.js",
+      default: "./dist/index.cjs"
+    }
+  },
+  description: "preview app for repdf. Not ready for production use.",
+  keywords: ["pdf", "typescript", "react"],
+  homepage: "https://repdf.dev",
+  author: "repdf labs",
+  files: ["dist"],
+  license: "MIT",
+  scripts: {
+    tsup: "tsup --tsconfig tsconfig.build.json",
+    build: "next build",
+    dev: "next dev",
+    lint: "next lint",
+    start: "next start",
+    "check-exports": "attw --pack .",
+    format: "biome check --write .",
+    "local-release": "changeset publish"
+  },
+  dependencies: {
+    "@react-email/render": "1.0.1",
+    "@react-email/tailwind": "0.1.0",
+    "@tanstack/react-query": "^5.59.0",
+    "@tanstack/react-query-devtools": "^5.59.0",
+    "@trpc/client": "^11.0.0-rc.553",
+    "@trpc/next": "^11.0.0-rc.553",
+    "@trpc/react-query": "^11.0.0-rc.553",
+    "@trpc/server": "^11.0.0-rc.553",
+    chokidar: "4.0.1",
+    clsx: "^2.1.1",
+    commander: "^12.1.0",
+    "dependency-tree": "^11.0.1",
+    esbuild: "0.24.0",
+    express: "^4.21.0",
+    glob: "^11.0.0",
+    "js-beautify": "^1.15.1",
+    "js-dependency-extractor": "^1.0.3",
+    "lucide-react": "^0.445.0",
+    next: "^14.2.14",
+    nuqs: "^1.19.3",
+    ora: "^8.1.0",
+    pino: "^9.4.0",
+    "pino-pretty": "^11.2.2",
+    "prism-react-renderer": "^2.4.0",
+    puppeteer: "^23.4.1",
+    react: "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-use-websocket": "^4.9.0",
+    "source-map-js": "^1.2.1",
+    "stacktrace-parser": "^0.1.10",
+    "string-ts": "^2.2.0",
+    superjson: "^2.2.1",
+    "tailwind-merge": "^2.5.2",
+    tsup: "8.3.0",
+    tsx: "^4.19.1",
+    webpack: "^5.95.0",
+    ws: "^8.18.0",
+    zod: "^3.23.8"
+  },
+  devDependencies: {
+    "@changesets/cli": "2.27.9",
+    "@arethetypeswrong/cli": "0.16.4",
+    "@biomejs/biome": "1.9.3",
+    "@types/express": "^5.0.0",
+    "@types/js-beautify": "^1.14.3",
+    "@types/node": "^20.14.10",
+    "@types/react": "^18.3.11",
+    "@types/react-dom": "^18.3.0",
+    "@types/ws": "^8.5.12",
+    postcss: "^8.4.39",
+    "prettier-plugin-tailwindcss": "^0.6.8",
+    "react-email": "3.0.1",
+    tailwindcss: "^3.4.13",
+    typescript: "^5.6.3"
+  },
+  packageManager: "pnpm@9.7.1"
+};
+
+// src/cli/commands/dev.ts
+var import_node_fs2 = __toESM(require("fs"), 1);
+
+// src/logger.ts
+var import_pino = __toESM(require("pino"), 1);
+var logger = (0, import_pino.default)({
+  transport: {
+    target: "pino-pretty"
+  },
+  level: "debug"
+});
+var logger_default = logger;
+
+// src/cli/commands/server.ts
+var import_node_url = require("url");
+var import_path = __toESM(require("path"), 1);
+var import_express = __toESM(require("express"), 1);
+var import_next = __toESM(require("next"), 1);
+var import_ws = __toESM(require("ws"), 1);
+var import_ws2 = require("ws");
+
+// src/utils/files/pdfTemplateWatcher.ts
+var chokidar = __toESM(require("chokidar"), 1);
+
+// src/constants.ts
+var RELATIVE_PATH_TO_PDF_FOLDER = () => {
+  if (!process.env.RELATIVE_PATH_TO_PDF_FOLDER) {
+    throw new Error("RELATIVE_PATH_TO_PDF_FOLDER is not set");
+  }
+  return process.env.RELATIVE_PATH_TO_PDF_FOLDER;
+};
+var ABSOLUTE_PATH_TO_PDF_FOLDER = () => {
+  if (!process.env.ABSOLUTE_PATH_TO_PDF_FOLDER) {
+    throw new Error("ABSOLUTE_PATH_TO_PDF_FOLDER is not set");
+  }
+  return process.env.ABSOLUTE_PATH_TO_PDF_FOLDER;
+};
+
+// src/utils/files/dependencyTree.ts
+var import_dependency_tree = __toESM(require("dependency-tree"), 1);
+function getDependencyTree({
+  relViewerPath,
+  outputType
+}) {
+  const options = {
+    filename: relViewerPath,
+    //TODO does this work with absolute paths?
+    directory: ".",
+    // requireConfig: 'path/to/requirejs/config', // optional
+    // webpackConfig: 'path/to/webpack/config', // optional
+    tsConfig: "tsconfig.json",
+    // optional
+    // nodeModulesConfig: {
+    //     entry: 'module'
+    // }, // optional
+    filter: (path3) => path3.indexOf("node_modules") === -1,
+    // remove node_node modules from tree
+    // nonExistent: [], // optional
+    noTypeDefinitions: false
+    // optional
+  };
+  if (outputType === "list") {
+    return import_dependency_tree.default.toList(options);
+  }
+  return (0, import_dependency_tree.default)(options);
+}
+
+// src/utils/files/getPdfTemplates.ts
+var import_node_fs = __toESM(require("fs"), 1);
+var import_node_path = __toESM(require("path"), 1);
+var import_glob = require("glob");
+function isPotentialPdfTemplate(relViewerPath) {
+  const stat = import_node_fs.default.statSync(relViewerPath);
+  if (stat.isDirectory()) return false;
+  const fileName = import_node_path.default.basename(relViewerPath);
+  if (fileName.startsWith("_")) {
+    return false;
+  }
+  const extension = import_node_path.default.extname(relViewerPath);
+  if (![".tsx", ".ts", ".jsx", ".js"].includes(extension)) {
+    return false;
+  }
+  const absoluteFilePath = import_node_path.default.resolve(relViewerPath);
+  if (!import_node_fs.default.existsSync(absoluteFilePath)) {
+    return false;
+  }
+  const fileContents = import_node_fs.default.readFileSync(absoluteFilePath, "utf8");
+  const hasDefaultExport = fileContents.includes("export default");
+  return hasDefaultExport;
+}
+function getPdfTemplates() {
+  const potentialTemplateFilePaths = import_glob.glob.sync(
+    `${RELATIVE_PATH_TO_PDF_FOLDER()}/**/*.{tsx,jsx,js}`,
+    { nodir: true }
+  );
+  logger_default.debug({ potentialTemplateFilePaths });
+  const filteredTemplateFilePaths = potentialTemplateFilePaths.filter(
+    isPotentialPdfTemplate
+  );
+  return filteredTemplateFilePaths.map((file) => {
+    const relTemplatePath = file.replace(
+      `${RELATIVE_PATH_TO_PDF_FOLDER()}/`,
+      ""
+    );
+    const pathParts = relTemplatePath.split("/");
+    let topParentFolder = null;
+    if (pathParts.length > 1 && pathParts[0]) {
+      topParentFolder = pathParts[0];
+    }
+    return {
+      fileName: import_node_path.default.basename(file),
+      // just the file name
+      relTemplatePath,
+      relViewerPath: file,
+      // to where script is being run
+      absolutePath: import_node_path.default.resolve(file),
+      // file system
+      topParentFolder
+    };
+  });
+}
+
+// src/utils/files/pdfTemplateWatcher.ts
+function pdfTemplateWatcher() {
+  const pdfTemplates = getPdfTemplates();
+  const allFiles = /* @__PURE__ */ new Set();
+  for (const pdfTemplate of pdfTemplates) {
+    allFiles.add(pdfTemplate.absolutePath);
+    const dependencyTree2 = getDependencyTree({
+      relViewerPath: pdfTemplate.relViewerPath,
+      outputType: "list"
+    });
+    for (const absoluteFilePath of dependencyTree2) {
+      allFiles.add(absoluteFilePath);
+    }
+  }
+  const watcher2 = chokidar.watch(ABSOLUTE_PATH_TO_PDF_FOLDER(), {
+    persistent: true,
+    ignoreInitial: true,
+    ignored: /(^|[\/\\])\../
+    // Ignore dot files
+  });
+  watcher2.add(Array.from(allFiles));
+  watcher2.on("add", (filePath) => logger_default.debug(`File ${filePath} has been added`)).on(
+    "change",
+    (filePath) => logger_default.debug(`File ${filePath} has been changed`)
+  ).on(
+    "unlink",
+    (filePath) => logger_default.debug(`File ${filePath} has been removed`)
+  ).on("error", (error) => logger_default.error(`Watcher error: ${error}`));
+  return watcher2;
+}
+
+// src/cli/commands/server.ts
+var getEnvVariablesForPreviewApp = (relativePathToPdfsDirectory, cwd) => {
+  return {
+    RELATIVE_PATH_TO_PDF_FOLDER: relativePathToPdfsDirectory,
+    ABSOLUTE_PATH_TO_PDF_FOLDER: import_path.default.resolve(cwd, relativePathToPdfsDirectory),
+    USER_PROJECT_LOCATION: cwd
+    // TODO what is this used for if anything
+  };
+};
+var previewServer;
+var clients = /* @__PURE__ */ new Set();
+var watcher;
+var startPreviewServer = async (pdfsDirRelativePath, port) => {
+  previewServer = (0, import_express.default)();
+  const server = previewServer.listen(port);
+  const wss = new import_ws2.WebSocketServer({ noServer: true });
+  process.env = {
+    ...process.env,
+    NODE_ENV: "development",
+    ...getEnvVariablesForPreviewApp(
+      // If we don't do normalization here, stuff like https://github.com/resend/react-email/issues/1354 happens.
+      import_path.default.normalize(pdfsDirRelativePath),
+      process.cwd()
+    )
+  };
+  const nextApp = (0, import_next.default)({
+    dev: true,
+    //process.env.NODE_ENV !== "production",
+    conf: {
+      images: {
+        // This is to avoid the warning with sharp
+        unoptimized: true
+      }
+    }
+  });
+  nextApp.prepare().then(() => {
+    previewServer.use((req, res, next2) => {
+      nextApp.getRequestHandler()(req, res, (0, import_node_url.parse)(req.url, true));
+    });
+    watcher = pdfTemplateWatcher();
+    watcher.on("all", () => {
+      for (const client of Array.from(clients)) {
+        client.send(`file changed ${(/* @__PURE__ */ new Date()).toISOString()}`);
+      }
+      watcher = pdfTemplateWatcher();
+    });
+    wss.on("connection", (ws) => {
+      clients.add(ws);
+      logger_default.info("New client connected");
+      ws.on("message", (message, isBinary) => {
+        logger_default.info(`Message received: ${message}`);
+        for (const client of Array.from(clients)) {
+          if (client.readyState === import_ws.default.OPEN && message.toString() !== `{"event":"ping"}`) {
+            client.send(message, { binary: isBinary });
+          }
+        }
+      });
+      ws.on("close", () => {
+        clients.delete(ws);
+        logger_default.info("Client disconnected");
+      });
+    });
+    server.on("upgrade", (req, socket, head) => {
+      logger_default.info("upgrading to websockets", req.url);
+      const { pathname } = (0, import_node_url.parse)(req.url || "/", true);
+      if (pathname === "/_next/webpack-hmr") {
+        logger_default.info("inside nextjs hot module reloading path");
+        nextApp.getUpgradeHandler()(req, socket, head);
+      }
+      if (pathname === "/api/ws") {
+        wss.handleUpgrade(req, socket, head, (ws) => {
+          wss.emit("connection", ws, req);
+        });
+      }
+    });
+  });
+  return previewServer;
+};
+
+// src/cli/commands/dev.ts
+var dev = async ({
+  dir: relativePathToPdfFolder,
+  port
+}) => {
+  try {
+    if (!import_node_fs2.default.existsSync(relativePathToPdfFolder)) {
+      throw new Error(`Missing ${relativePathToPdfFolder} folder`);
+    }
+    const devServer = await startPreviewServer(
+      relativePathToPdfFolder,
+      parseInt(port)
+    );
+  } catch (error) {
+    logger_default.error(error);
+    process.exit(1);
+  }
+};
+
+// src/cli/index.ts
+var PACKAGE_NAME = "repdf";
+import_commander.program.name(PACKAGE_NAME).description("A live preview of your pdf templates").version(package_default.version);
+import_commander.program.command("dev").description("Starts the preview pdf development app").option("-d --dir <path>", "Directory containing pdf templates", "./src/pdfs").option("-p --port <port>", "Port to run dev server on", "3000").action(dev);
+import_commander.program.parse();

package/dist/index.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,350 @@
+#!/usr/bin/env node
+
+// src/cli/index.ts
+import { program } from "commander";
+
+// package.json
+var package_default = {
+  name: "@repdf/preview",
+  version: "0.0.1",
+  type: "module",
+  private: false,
+  main: "dist/index.js",
+  exports: {
+    "./package.json": "./package.json",
+    ".": {
+      import: "./dist/index.js",
+      default: "./dist/index.cjs"
+    }
+  },
+  description: "preview app for repdf. Not ready for production use.",
+  keywords: ["pdf", "typescript", "react"],
+  homepage: "https://repdf.dev",
+  author: "repdf labs",
+  files: ["dist"],
+  license: "MIT",
+  scripts: {
+    tsup: "tsup --tsconfig tsconfig.build.json",
+    build: "next build",
+    dev: "next dev",
+    lint: "next lint",
+    start: "next start",
+    "check-exports": "attw --pack .",
+    format: "biome check --write .",
+    "local-release": "changeset publish"
+  },
+  dependencies: {
+    "@react-email/render": "1.0.1",
+    "@react-email/tailwind": "0.1.0",
+    "@tanstack/react-query": "^5.59.0",
+    "@tanstack/react-query-devtools": "^5.59.0",
+    "@trpc/client": "^11.0.0-rc.553",
+    "@trpc/next": "^11.0.0-rc.553",
+    "@trpc/react-query": "^11.0.0-rc.553",
+    "@trpc/server": "^11.0.0-rc.553",
+    chokidar: "4.0.1",
+    clsx: "^2.1.1",
+    commander: "^12.1.0",
+    "dependency-tree": "^11.0.1",
+    esbuild: "0.24.0",
+    express: "^4.21.0",
+    glob: "^11.0.0",
+    "js-beautify": "^1.15.1",
+    "js-dependency-extractor": "^1.0.3",
+    "lucide-react": "^0.445.0",
+    next: "^14.2.14",
+    nuqs: "^1.19.3",
+    ora: "^8.1.0",
+    pino: "^9.4.0",
+    "pino-pretty": "^11.2.2",
+    "prism-react-renderer": "^2.4.0",
+    puppeteer: "^23.4.1",
+    react: "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-use-websocket": "^4.9.0",
+    "source-map-js": "^1.2.1",
+    "stacktrace-parser": "^0.1.10",
+    "string-ts": "^2.2.0",
+    superjson: "^2.2.1",
+    "tailwind-merge": "^2.5.2",
+    tsup: "8.3.0",
+    tsx: "^4.19.1",
+    webpack: "^5.95.0",
+    ws: "^8.18.0",
+    zod: "^3.23.8"
+  },
+  devDependencies: {
+    "@changesets/cli": "2.27.9",
+    "@arethetypeswrong/cli": "0.16.4",
+    "@biomejs/biome": "1.9.3",
+    "@types/express": "^5.0.0",
+    "@types/js-beautify": "^1.14.3",
+    "@types/node": "^20.14.10",
+    "@types/react": "^18.3.11",
+    "@types/react-dom": "^18.3.0",
+    "@types/ws": "^8.5.12",
+    postcss: "^8.4.39",
+    "prettier-plugin-tailwindcss": "^0.6.8",
+    "react-email": "3.0.1",
+    tailwindcss: "^3.4.13",
+    typescript: "^5.6.3"
+  },
+  packageManager: "pnpm@9.7.1"
+};
+
+// src/cli/commands/dev.ts
+import fs2 from "node:fs";
+
+// src/logger.ts
+import pino from "pino";
+var logger = pino({
+  transport: {
+    target: "pino-pretty"
+  },
+  level: "debug"
+});
+var logger_default = logger;
+
+// src/cli/commands/server.ts
+import { parse } from "node:url";
+import path2 from "path";
+import express from "express";
+import next from "next";
+import WebSocket from "ws";
+import { WebSocketServer } from "ws";
+
+// src/utils/files/pdfTemplateWatcher.ts
+import * as chokidar from "chokidar";
+
+// src/constants.ts
+var RELATIVE_PATH_TO_PDF_FOLDER = () => {
+  if (!process.env.RELATIVE_PATH_TO_PDF_FOLDER) {
+    throw new Error("RELATIVE_PATH_TO_PDF_FOLDER is not set");
+  }
+  return process.env.RELATIVE_PATH_TO_PDF_FOLDER;
+};
+var ABSOLUTE_PATH_TO_PDF_FOLDER = () => {
+  if (!process.env.ABSOLUTE_PATH_TO_PDF_FOLDER) {
+    throw new Error("ABSOLUTE_PATH_TO_PDF_FOLDER is not set");
+  }
+  return process.env.ABSOLUTE_PATH_TO_PDF_FOLDER;
+};
+
+// src/utils/files/dependencyTree.ts
+import dependencyTree from "dependency-tree";
+function getDependencyTree({
+  relViewerPath,
+  outputType
+}) {
+  const options = {
+    filename: relViewerPath,
+    //TODO does this work with absolute paths?
+    directory: ".",
+    // requireConfig: 'path/to/requirejs/config', // optional
+    // webpackConfig: 'path/to/webpack/config', // optional
+    tsConfig: "tsconfig.json",
+    // optional
+    // nodeModulesConfig: {
+    //     entry: 'module'
+    // }, // optional
+    filter: (path3) => path3.indexOf("node_modules") === -1,
+    // remove node_node modules from tree
+    // nonExistent: [], // optional
+    noTypeDefinitions: false
+    // optional
+  };
+  if (outputType === "list") {
+    return dependencyTree.toList(options);
+  }
+  return dependencyTree(options);
+}
+
+// src/utils/files/getPdfTemplates.ts
+import fs from "node:fs";
+import path from "node:path";
+import { glob } from "glob";
+function isPotentialPdfTemplate(relViewerPath) {
+  const stat = fs.statSync(relViewerPath);
+  if (stat.isDirectory()) return false;
+  const fileName = path.basename(relViewerPath);
+  if (fileName.startsWith("_")) {
+    return false;
+  }
+  const extension = path.extname(relViewerPath);
+  if (![".tsx", ".ts", ".jsx", ".js"].includes(extension)) {
+    return false;
+  }
+  const absoluteFilePath = path.resolve(relViewerPath);
+  if (!fs.existsSync(absoluteFilePath)) {
+    return false;
+  }
+  const fileContents = fs.readFileSync(absoluteFilePath, "utf8");
+  const hasDefaultExport = fileContents.includes("export default");
+  return hasDefaultExport;
+}
+function getPdfTemplates() {
+  const potentialTemplateFilePaths = glob.sync(
+    `${RELATIVE_PATH_TO_PDF_FOLDER()}/**/*.{tsx,jsx,js}`,
+    { nodir: true }
+  );
+  logger_default.debug({ potentialTemplateFilePaths });
+  const filteredTemplateFilePaths = potentialTemplateFilePaths.filter(
+    isPotentialPdfTemplate
+  );
+  return filteredTemplateFilePaths.map((file) => {
+    const relTemplatePath = file.replace(
+      `${RELATIVE_PATH_TO_PDF_FOLDER()}/`,
+      ""
+    );
+    const pathParts = relTemplatePath.split("/");
+    let topParentFolder = null;
+    if (pathParts.length > 1 && pathParts[0]) {
+      topParentFolder = pathParts[0];
+    }
+    return {
+      fileName: path.basename(file),
+      // just the file name
+      relTemplatePath,
+      relViewerPath: file,
+      // to where script is being run
+      absolutePath: path.resolve(file),
+      // file system
+      topParentFolder
+    };
+  });
+}
+
+// src/utils/files/pdfTemplateWatcher.ts
+function pdfTemplateWatcher() {
+  const pdfTemplates = getPdfTemplates();
+  const allFiles = /* @__PURE__ */ new Set();
+  for (const pdfTemplate of pdfTemplates) {
+    allFiles.add(pdfTemplate.absolutePath);
+    const dependencyTree2 = getDependencyTree({
+      relViewerPath: pdfTemplate.relViewerPath,
+      outputType: "list"
+    });
+    for (const absoluteFilePath of dependencyTree2) {
+      allFiles.add(absoluteFilePath);
+    }
+  }
+  const watcher2 = chokidar.watch(ABSOLUTE_PATH_TO_PDF_FOLDER(), {
+    persistent: true,
+    ignoreInitial: true,
+    ignored: /(^|[\/\\])\../
+    // Ignore dot files
+  });
+  watcher2.add(Array.from(allFiles));
+  watcher2.on("add", (filePath) => logger_default.debug(`File ${filePath} has been added`)).on(
+    "change",
+    (filePath) => logger_default.debug(`File ${filePath} has been changed`)
+  ).on(
+    "unlink",
+    (filePath) => logger_default.debug(`File ${filePath} has been removed`)
+  ).on("error", (error) => logger_default.error(`Watcher error: ${error}`));
+  return watcher2;
+}
+
+// src/cli/commands/server.ts
+var getEnvVariablesForPreviewApp = (relativePathToPdfsDirectory, cwd) => {
+  return {
+    RELATIVE_PATH_TO_PDF_FOLDER: relativePathToPdfsDirectory,
+    ABSOLUTE_PATH_TO_PDF_FOLDER: path2.resolve(cwd, relativePathToPdfsDirectory),
+    USER_PROJECT_LOCATION: cwd
+    // TODO what is this used for if anything
+  };
+};
+var previewServer;
+var clients = /* @__PURE__ */ new Set();
+var watcher;
+var startPreviewServer = async (pdfsDirRelativePath, port) => {
+  previewServer = express();
+  const server = previewServer.listen(port);
+  const wss = new WebSocketServer({ noServer: true });
+  process.env = {
+    ...process.env,
+    NODE_ENV: "development",
+    ...getEnvVariablesForPreviewApp(
+      // If we don't do normalization here, stuff like https://github.com/resend/react-email/issues/1354 happens.
+      path2.normalize(pdfsDirRelativePath),
+      process.cwd()
+    )
+  };
+  const nextApp = next({
+    dev: true,
+    //process.env.NODE_ENV !== "production",
+    conf: {
+      images: {
+        // This is to avoid the warning with sharp
+        unoptimized: true
+      }
+    }
+  });
+  nextApp.prepare().then(() => {
+    previewServer.use((req, res, next2) => {
+      nextApp.getRequestHandler()(req, res, parse(req.url, true));
+    });
+    watcher = pdfTemplateWatcher();
+    watcher.on("all", () => {
+      for (const client of Array.from(clients)) {
+        client.send(`file changed ${(/* @__PURE__ */ new Date()).toISOString()}`);
+      }
+      watcher = pdfTemplateWatcher();
+    });
+    wss.on("connection", (ws) => {
+      clients.add(ws);
+      logger_default.info("New client connected");
+      ws.on("message", (message, isBinary) => {
+        logger_default.info(`Message received: ${message}`);
+        for (const client of Array.from(clients)) {
+          if (client.readyState === WebSocket.OPEN && message.toString() !== `{"event":"ping"}`) {
+            client.send(message, { binary: isBinary });
+          }
+        }
+      });
+      ws.on("close", () => {
+        clients.delete(ws);
+        logger_default.info("Client disconnected");
+      });
+    });
+    server.on("upgrade", (req, socket, head) => {
+      logger_default.info("upgrading to websockets", req.url);
+      const { pathname } = parse(req.url || "/", true);
+      if (pathname === "/_next/webpack-hmr") {
+        logger_default.info("inside nextjs hot module reloading path");
+        nextApp.getUpgradeHandler()(req, socket, head);
+      }
+      if (pathname === "/api/ws") {
+        wss.handleUpgrade(req, socket, head, (ws) => {
+          wss.emit("connection", ws, req);
+        });
+      }
+    });
+  });
+  return previewServer;
+};
+
+// src/cli/commands/dev.ts
+var dev = async ({
+  dir: relativePathToPdfFolder,
+  port
+}) => {
+  try {
+    if (!fs2.existsSync(relativePathToPdfFolder)) {
+      throw new Error(`Missing ${relativePathToPdfFolder} folder`);
+    }
+    const devServer = await startPreviewServer(
+      relativePathToPdfFolder,
+      parseInt(port)
+    );
+  } catch (error) {
+    logger_default.error(error);
+    process.exit(1);
+  }
+};
+
+// src/cli/index.ts
+var PACKAGE_NAME = "repdf";
+program.name(PACKAGE_NAME).description("A live preview of your pdf templates").version(package_default.version);
+program.command("dev").description("Starts the preview pdf development app").option("-d --dir <path>", "Directory containing pdf templates", "./src/pdfs").option("-p --port <port>", "Port to run dev server on", "3000").action(dev);
+program.parse();

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@repdf/preview",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "import": "./dist/index.js",
+      "default": "./dist/index.cjs"
+    }
+  },
+  "description": "preview app for repdf. Not ready for production use.",
+  "keywords": ["pdf", "typescript", "react"],
+  "homepage": "https://repdf.dev",
+  "author": "repdf labs",
+  "files": ["dist"],
+  "license": "MIT",
+  "scripts": {
+    "tsup": "tsup --tsconfig tsconfig.build.json",
+    "build": "next build",
+    "dev": "next dev",
+    "lint": "next lint",
+    "start": "next start",
+    "check-exports": "attw --pack .",
+    "format": "biome check --write .",
+    "local-release": "changeset publish"
+  },
+  "dependencies": {
+    "@react-email/render": "1.0.1",
+    "@react-email/tailwind": "0.1.0",
+    "@tanstack/react-query": "^5.59.0",
+    "@tanstack/react-query-devtools": "^5.59.0",
+    "@trpc/client": "^11.0.0-rc.553",
+    "@trpc/next": "^11.0.0-rc.553",
+    "@trpc/react-query": "^11.0.0-rc.553",
+    "@trpc/server": "^11.0.0-rc.553",
+    "chokidar": "4.0.1",
+    "clsx": "^2.1.1",
+    "commander": "^12.1.0",
+    "dependency-tree": "^11.0.1",
+    "esbuild": "0.24.0",
+    "express": "^4.21.0",
+    "glob": "^11.0.0",
+    "js-beautify": "^1.15.1",
+    "js-dependency-extractor": "^1.0.3",
+    "lucide-react": "^0.445.0",
+    "next": "^14.2.14",
+    "nuqs": "^1.19.3",
+    "ora": "^8.1.0",
+    "pino": "^9.4.0",
+    "pino-pretty": "^11.2.2",
+    "prism-react-renderer": "^2.4.0",
+    "puppeteer": "^23.4.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-use-websocket": "^4.9.0",
+    "source-map-js": "^1.2.1",
+    "stacktrace-parser": "^0.1.10",
+    "string-ts": "^2.2.0",
+    "superjson": "^2.2.1",
+    "tailwind-merge": "^2.5.2",
+    "tsup": "8.3.0",
+    "tsx": "^4.19.1",
+    "webpack": "^5.95.0",
+    "ws": "^8.18.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@changesets/cli": "2.27.9",
+    "@arethetypeswrong/cli": "0.16.4",
+    "@biomejs/biome": "1.9.3",
+    "@types/express": "^5.0.0",
+    "@types/js-beautify": "^1.14.3",
+    "@types/node": "^20.14.10",
+    "@types/react": "^18.3.11",
+    "@types/react-dom": "^18.3.0",
+    "@types/ws": "^8.5.12",
+    "postcss": "^8.4.39",
+    "prettier-plugin-tailwindcss": "^0.6.8",
+    "react-email": "3.0.1",
+    "tailwindcss": "^3.4.13",
+    "typescript": "^5.6.3"
+  },
+  "packageManager": "pnpm@9.7.1"
+}