@allegrocdp/preview 0.1.0-dev.10

package/dist/client/preview-client.js

@@ -0,0 +1 @@
+function r(){const e=document.getElementById("allegro-preview-data");if(!e||!e.textContent)throw new Error("[allegro-preview] Missing #allegro-preview-data element");return JSON.parse(e.textContent)}function o(e){const t=e.tab==="cut"||e.tab==="append";return{type:"template",template_id:e.slug,target_selector:t?"#allegro-preview-article":null,field_values:e.fieldValues,placement_method:e.tab==="cut"?"truncate":e.tab==="append"?"append":null,truncation_unit:e.tab==="cut"?"paragraphs":null,truncation_count:e.tab==="cut"?3:null,truncation_style:e.tab==="cut"?"cut":null,template:{id:e.slug,title:e.slug,slug:e.slug,html:e.html,css:e.css,js:e.js,external_css_urls:[]}}}window.allegro=window.allegro||[];window.allegro.push(e=>{const t=r(),l=o(t);e.interaction.renderActions([l],{skipDelays:!0}).catch(n=>{console.error("[allegro-preview] renderActions failed:",n)})});

package/dist/server.js

@@ -0,0 +1,510 @@
+#!/usr/bin/env node
+
+// src/server.ts
+import chokidar from "chokidar";
+import express from "express";
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "fs";
+import open from "open";
+import { basename, isAbsolute, join, relative, resolve } from "path";
+import { fileURLToPath } from "url";
+var __dirname = fileURLToPath(new URL(".", import.meta.url));
+var BOILERPLATE_HTML = `<div class="signup">
+  <div class="signup__eyebrow">Newsletter</div>
+  <h2 class="signup__headline">{% headline %}</h2>
+  <p class="signup__sub">{% subheadline %}</p>
+  <form class="signup__form" onsubmit="return false">
+    <div class="signup__row">
+      <input class="signup__input" type="email" placeholder="{% input_placeholder %}" />
+      <button class="signup__btn" type="submit">{% button_text %}</button>
+    </div>
+    <p class="signup__note">{% privacy_note %}</p>
+  </form>
+</div>
+`;
+var BOILERPLATE_CSS = `*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+.signup {
+  font-family: -apple-system, BlinkMacSystemFont, 'Inter', 'Segoe UI', system-ui, sans-serif;
+  -webkit-font-smoothing: antialiased;
+  padding: 16px;
+}
+
+.signup__eyebrow {
+  font-size: 11px;
+  font-weight: 700;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+  color: #6366f1;
+  margin-bottom: 8px;
+}
+
+.signup__headline {
+  font-size: clamp(20px, 4vw, 26px);
+  font-weight: 800;
+  color: #0f172a;
+  line-height: 1.2;
+  letter-spacing: -0.02em;
+  margin-bottom: 8px;
+}
+
+.signup__sub {
+  font-size: 14px;
+  color: #64748b;
+  line-height: 1.6;
+  margin-bottom: 20px;
+}
+
+.signup__row {
+  display: flex;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+
+.signup__input {
+  flex: 1;
+  min-width: 180px;
+  height: 42px;
+  padding: 0 12px;
+  border: 1.5px solid #e2e8f0;
+  border-radius: 8px;
+  font-size: 14px;
+  color: #0f172a;
+  background: #f8fafc;
+  outline: none;
+  transition: border-color 0.15s, background 0.15s;
+}
+
+.signup__input:focus { border-color: #6366f1; background: #fff; }
+.signup__input::placeholder { color: #94a3b8; }
+
+.signup__btn {
+  height: 42px;
+  padding: 0 20px;
+  background: #6366f1;
+  color: #fff;
+  border: none;
+  border-radius: 8px;
+  font-size: 14px;
+  font-weight: 600;
+  font-family: inherit;
+  cursor: pointer;
+  white-space: nowrap;
+  transition: background 0.15s;
+}
+
+.signup__btn:hover { background: #4f46e5; }
+.signup__btn:active { opacity: 0.9; }
+
+.signup__note {
+  margin-top: 10px;
+  font-size: 12px;
+  color: #94a3b8;
+}
+`;
+var BOILERPLATE_FIELDS = [
+  { slug: "headline", label: "Headline", type: "text", default_value: "Stay in the know" },
+  {
+    slug: "subheadline",
+    label: "Subheadline",
+    type: "textarea",
+    default_value: "Get the latest stories delivered to your inbox."
+  },
+  { slug: "input_placeholder", label: "Input placeholder", type: "text", default_value: "Enter your email" },
+  { slug: "button_text", label: "Button text", type: "text", default_value: "Subscribe" },
+  { slug: "privacy_note", label: "Privacy note", type: "text", default_value: "No spam. Unsubscribe anytime." }
+];
+var ARTICLE_PARAGRAPHS = [
+  "The city council voted unanimously Tuesday to approve a sweeping new infrastructure plan that would reshape public transit routes across the metropolitan area over the next decade.",
+  "Mayor Jordan Ellison called the decision a turning point for how the region thinks about getting around, noting that similar investments in peer cities have led to measurable reductions in traffic congestion and improved air quality.",
+  "The plan includes upgrades to 14 existing bus rapid transit lines, the introduction of three new light-rail corridors connecting the downtown core to outlying neighborhoods, and dedicated cycling infrastructure along six major arterials.",
+  "Critics, however, warn that the projected cost of $2.4 billion may be optimistic. Independent analysts suggest the final figure could climb to $3.8 billion once land acquisition, labor, and contingency costs are factored in over the full construction timeline.",
+  "Council member Dana Reyes, who voted in favor, acknowledged the fiscal concern but argued that inaction carries its own price, noting that congestion costs residents and businesses hundreds of millions in lost productivity each year.",
+  "Environmental groups praised the announcement, saying expanded transit capacity is essential to meet the stated goal of reducing transportation emissions by 45 percent before 2035.",
+  "Public comment sessions are scheduled for next month at community centers in all twelve districts. Construction is expected to begin no sooner than mid-next year, pending environmental review and final design approvals."
+];
+function escapeAttr(s) {
+  return s.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/>/g, "&gt;");
+}
+function sdkScriptTag(sdkUrl) {
+  if (!sdkUrl) {
+    return "";
+  }
+  return `<script src="${escapeAttr(sdkUrl)}" data-api-url="https://${new URL(sdkUrl).host}"></script>`;
+}
+function normalizeTenantSdkUrl(raw) {
+  const trimmed = raw.trim();
+  if (!trimmed) {
+    return "";
+  }
+  const withProtocol = /^https?:\/\//.test(trimmed) ? trimmed : `https://${trimmed}`;
+  return withProtocol.replace(/\/+$/, "") + "/client.js";
+}
+var COOKIE_NOOP_SCRIPT = `(function(){var _jar={};Object.defineProperty(document,'cookie',{configurable:true,get:function(){return Object.keys(_jar).map(function(k){return k+'='+_jar[k];}).join('; ');},set:function(str){var parts=str.split(';');var kv=parts[0].trim();var eq=kv.indexOf('=');var name=kv.slice(0,eq).trim();var val=kv.slice(eq+1).trim();var maxAge=null;for(var i=1;i<parts.length;i++){var p=parts[i].trim().toLowerCase();if(p.indexOf('max-age=')===0){maxAge=parseInt(p.split('=')[1],10);}}if(maxAge!==null&&maxAge<=0){delete _jar[name];}else{_jar[name]=val;}}});})();`;
+function buildPreviewData(options) {
+  const json = JSON.stringify({
+    slug: options.slug,
+    html: options.html,
+    css: options.css,
+    js: options.js,
+    fieldValues: options.fieldValues,
+    tab: options.tab
+  });
+  return json.replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/&/g, "\\u0026");
+}
+function standaloneShell(options) {
+  const cookieScript = options.blockCookies ?? true ? `<script>${COOKIE_NOOP_SCRIPT}</script>` : "";
+  return `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <script>window.__ALLEGRO_PREVIEW__ = true; localStorage.setItem('allegro_debug', 'true');</script>
+  ${cookieScript}
+  <style>
+    * { box-sizing: border-box; }
+    body { margin: 0; }
+    [data-allegro-interaction] { display: block; }
+  </style>
+</head>
+<body>
+  <script id="allegro-preview-data" type="application/json">${buildPreviewData(options)}</script>
+  ${sdkScriptTag(options.sdkUrl)}
+  <script src="/preview-client.js"></script>
+</body>
+</html>`;
+}
+function articleShell(options) {
+  const paras = ARTICLE_PARAGRAPHS.map((p) => `<p>${p}</p>`).join("\n    ");
+  const cookieScript = options.blockCookies ?? true ? `<script>${COOKIE_NOOP_SCRIPT}</script>` : "";
+  return `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <script>window.__ALLEGRO_PREVIEW__ = true; localStorage.setItem('allegro_debug', 'true');</script>
+  ${cookieScript}
+  <style>
+    *, *::before, *::after { box-sizing: border-box; }
+    body { font-family: Georgia, 'Times New Roman', serif; background: #fff; color: #111;
+           max-width: 680px; margin: 0 auto; padding: 32px 24px 64px; line-height: 1.75;
+           -webkit-font-smoothing: antialiased; }
+    h1 { font-size: 1.6rem; line-height: 1.25; margin: 0 0 6px; font-weight: 700; }
+    .meta { color: #6b7280; font-size: 0.82rem; font-family: system-ui, sans-serif; margin-bottom: 24px; }
+    p { margin: 0 0 1.1em; font-size: 1rem; overflow-wrap: break-word; }
+    [data-allegro-interaction] { display: block; margin: 24px 0; }
+  </style>
+</head>
+<body>
+  <script id="allegro-preview-data" type="application/json">${buildPreviewData(options)}</script>
+  <header>
+    <h1>Council Approves Decade-Long Transit Overhaul</h1>
+    <p class="meta">By Staff Reporter &nbsp;&middot;&nbsp; March 14, 2026</p>
+  </header>
+  <article id="allegro-preview-article">
+    ${paras}
+  </article>
+  ${sdkScriptTag(options.sdkUrl)}
+  <script src="/preview-client.js"></script>
+</body>
+</html>`;
+}
+var sseClients = /* @__PURE__ */ new Set();
+function broadcast(event) {
+  for (const client of sseClients) {
+    client.write(`event: ${event}
+data: {}
+
+`);
+  }
+}
+function broadcastReload() {
+  broadcast("reload");
+}
+function broadcastConfig() {
+  broadcast("config");
+}
+function readTemplateMeta(dir) {
+  const jsonPath = join(dir, "template.json");
+  if (!existsSync(jsonPath)) {
+    return { name: basename(dir) };
+  }
+  try {
+    const parsed = JSON.parse(readFileSync(jsonPath, "utf-8"));
+    return { name: parsed.name ?? basename(dir) };
+  } catch {
+    return { name: basename(dir) };
+  }
+}
+function isTemplateDir(dir) {
+  return existsSync(join(dir, "index.html"));
+}
+function scanTemplates(baseDir) {
+  const results = [];
+  if (isTemplateDir(baseDir)) {
+    const meta = readTemplateMeta(baseDir);
+    results.push({ slug: ".", name: meta.name });
+  }
+  try {
+    for (const entry of readdirSync(baseDir, { withFileTypes: true })) {
+      if (!entry.isDirectory() || entry.name.startsWith(".")) {
+        continue;
+      }
+      const sub = join(baseDir, entry.name);
+      if (!isTemplateDir(sub)) {
+        continue;
+      }
+      const meta = readTemplateMeta(sub);
+      results.push({ slug: entry.name, name: meta.name });
+    }
+  } catch {
+  }
+  return results;
+}
+var templateFilesCache = /* @__PURE__ */ new Map();
+function invalidateTemplateCache(filePath) {
+  const dir = filePath.replace(/[/\\][^/\\]+$/, "");
+  templateFilesCache.delete(dir);
+}
+function readTemplateFiles(dir) {
+  const read = (filename) => {
+    const filePath = join(dir, filename);
+    return existsSync(filePath) ? readFileSync(filePath, "utf-8") : "";
+  };
+  let fields = [];
+  let name = basename(dir);
+  let fieldsParseError = null;
+  const jsonPath = join(dir, "template.json");
+  if (existsSync(jsonPath)) {
+    try {
+      const parsed = JSON.parse(readFileSync(jsonPath, "utf-8"));
+      fields = parsed.fields ?? [];
+      name = parsed.name ?? name;
+    } catch (err) {
+      fieldsParseError = err instanceof Error ? err.message : "Invalid JSON in template.json";
+    }
+  }
+  const files = {
+    html: read("index.html"),
+    css: read("index.css"),
+    js: read("index.js"),
+    fields,
+    name,
+    fieldsParseError
+  };
+  templateFilesCache.set(dir, files);
+  return files;
+}
+function readTemplateFilesCached(dir) {
+  return templateFilesCache.get(dir) ?? readTemplateFiles(dir);
+}
+async function startServer(templatePath, port = 0, tenant = "") {
+  const baseDir = resolve(process.cwd(), templatePath);
+  if (!existsSync(baseDir)) {
+    console.error(`Directory not found: ${baseDir}`);
+    process.exit(1);
+  }
+  let templates = scanTemplates(baseDir);
+  const app = express();
+  const clientDistDir = join(__dirname, "client");
+  app.use(express.static(clientDistDir));
+  app.get("/api/config", (_req, res) => {
+    res.json({ defaultSlug: templates[0]?.slug ?? null, templates, tenant });
+  });
+  app.get("/api/template", (req, res) => {
+    const slug = req.query.slug ?? ".";
+    if (slug !== "." && !templates.some((template) => template.slug === slug)) {
+      res.status(404).json({ error: "Template not found" });
+      return;
+    }
+    const targetDir = slug === "." ? baseDir : join(baseDir, slug);
+    const resolvedBaseDir = resolve(baseDir);
+    const resolvedDir = resolve(targetDir);
+    const relativePath = relative(resolvedBaseDir, resolvedDir);
+    if (relativePath.startsWith("..") || isAbsolute(relativePath)) {
+      res.status(400).json({ error: "Invalid template path" });
+      return;
+    }
+    if (!existsSync(resolvedDir) || !isTemplateDir(resolvedDir)) {
+      res.status(404).json({ error: "Template not found" });
+      return;
+    }
+    res.json(readTemplateFilesCached(resolvedDir));
+  });
+  app.post("/api/template/create", express.json(), (req, res) => {
+    const body = req.body;
+    const slug = body.slug;
+    if (typeof slug !== "string" || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(slug)) {
+      res.status(400).json({
+        error: "Slug must be lowercase letters, numbers, and hyphens only (e.g. my-template)."
+      });
+      return;
+    }
+    const targetDir = join(baseDir, slug);
+    if (existsSync(targetDir)) {
+      res.status(400).json({ error: `A template named "${slug}" already exists.` });
+      return;
+    }
+    try {
+      mkdirSync(targetDir);
+      writeFileSync(join(targetDir, "index.html"), BOILERPLATE_HTML);
+      writeFileSync(join(targetDir, "index.css"), BOILERPLATE_CSS);
+      writeFileSync(
+        join(targetDir, "template.json"),
+        JSON.stringify({ name: slug, fields: BOILERPLATE_FIELDS }, null, 2) + "\n"
+      );
+    } catch (err) {
+      console.error("[allegro-preview] Failed to create template:", err);
+      res.status(500).json({ error: "Failed to create template files." });
+      return;
+    }
+    rescan();
+    res.status(201).json({ slug });
+  });
+  app.get("/api/events", (req, res) => {
+    res.setHeader("Content-Type", "text/event-stream");
+    res.setHeader("Cache-Control", "no-cache");
+    res.setHeader("Connection", "keep-alive");
+    res.flushHeaders();
+    sseClients.add(res);
+    req.on("close", () => {
+      sseClients.delete(res);
+    });
+  });
+  app.get("/preview", (req, res) => {
+    const slug = typeof req.query.slug === "string" ? req.query.slug : "";
+    const tab = typeof req.query.tab === "string" ? req.query.tab : "standalone";
+    const sdkParam = typeof req.query.sdk === "string" ? req.query.sdk : void 0;
+    if (!slug) {
+      res.status(400).send("Missing slug");
+      return;
+    }
+    if (slug !== "." && !templates.some((t) => t.slug === slug)) {
+      res.status(404).send("Template not found");
+      return;
+    }
+    const targetDir = slug === "." ? baseDir : join(baseDir, slug);
+    const resolvedBaseDir = resolve(baseDir);
+    const resolvedDir = resolve(targetDir);
+    const relativePath = relative(resolvedBaseDir, resolvedDir);
+    if (relativePath.startsWith("..") || isAbsolute(relativePath)) {
+      res.status(400).send("Invalid template path");
+      return;
+    }
+    if (!existsSync(resolvedDir) || !isTemplateDir(resolvedDir)) {
+      res.status(404).send("Template not found");
+      return;
+    }
+    const templateFiles = readTemplateFilesCached(resolvedDir);
+    const fieldValues = [];
+    for (const [key, val] of Object.entries(req.query)) {
+      if (key.startsWith("f_") && typeof val === "string") {
+        fieldValues.push({ slug: key.slice(2), value: val });
+      }
+    }
+    const effectiveSdkUrl = sdkParam ?? (tenant ? normalizeTenantSdkUrl(tenant) : void 0);
+    const blockCookies = req.query.blockCookies !== "false";
+    const shellOptions = {
+      slug,
+      html: templateFiles.html,
+      css: templateFiles.css,
+      js: templateFiles.js,
+      fieldValues,
+      tab,
+      sdkUrl: effectiveSdkUrl,
+      blockCookies
+    };
+    const rendered = tab === "standalone" ? standaloneShell(shellOptions) : articleShell(shellOptions);
+    res.setHeader("Cache-Control", "no-store");
+    res.type("html").send(rendered);
+  });
+  const indexHtmlPath = join(clientDistDir, "index.html");
+  app.get("/*path", (_req, res) => {
+    if (existsSync(indexHtmlPath)) {
+      res.type("html").send(readFileSync(indexHtmlPath));
+    } else {
+      res.status(503).send(
+        'Preview client build artifacts not found. Ensure the client is built (for example, by running "npm run build" in this package during development).'
+      );
+    }
+  });
+  const TEMPLATE_FILES = ["index.html", "index.css", "index.js", "template.json"];
+  function templateFilePaths(dir) {
+    return TEMPLATE_FILES.map((f) => join(dir, f));
+  }
+  const fileWatcher = chokidar.watch(
+    templates.flatMap((t) => templateFilePaths(t.slug === "." ? baseDir : join(baseDir, t.slug))),
+    { ignoreInitial: true }
+  );
+  fileWatcher.on("change", (changedPath) => {
+    console.log(`Changed: ${changedPath}`);
+    invalidateTemplateCache(changedPath);
+    if (basename(changedPath) === "template.json") {
+      rescan();
+    }
+    broadcastReload();
+  });
+  fileWatcher.on("add", (addedPath) => {
+    console.log(`Added: ${addedPath}`);
+    invalidateTemplateCache(addedPath);
+    if (basename(addedPath) === "index.html") {
+      rescan();
+    }
+    broadcastReload();
+  });
+  const dirWatcher = chokidar.watch(baseDir, { depth: 1, ignoreInitial: true });
+  function rescan() {
+    templates = scanTemplates(baseDir);
+    console.log(`Templates updated: ${templates.map((t) => t.slug).join(", ") || "(none)"}`);
+    broadcastConfig();
+  }
+  dirWatcher.on("addDir", (dirPath) => {
+    if (dirPath === baseDir) {
+      return;
+    }
+    setTimeout(() => {
+      rescan();
+      fileWatcher.add(templateFilePaths(dirPath));
+    }, 300);
+  });
+  dirWatcher.on("unlinkDir", (dirPath) => {
+    if (dirPath === baseDir) {
+      return;
+    }
+    rescan();
+  });
+  dirWatcher.on("add", (filePath) => {
+    if (basename(filePath) === "index.html") {
+      rescan();
+      fileWatcher.add(templateFilePaths(join(filePath, "..")));
+    }
+  });
+  const bindServer = (p) => new Promise((resolve2, reject) => {
+    const server = app.listen(p);
+    server.once("listening", () => {
+      const addr = server.address();
+      const assignedPort2 = typeof addr === "object" && addr ? addr.port : p;
+      resolve2({ server, assignedPort: assignedPort2 });
+    });
+    server.once("error", reject);
+  });
+  let assignedPort;
+  try {
+    ({ assignedPort } = await bindServer(port));
+  } catch (err) {
+    const nodeErr = err;
+    if (nodeErr.code === "EADDRINUSE" && port !== 0) {
+      console.log(`Port ${port} is in use, using a random available port instead.`);
+      ({ assignedPort } = await bindServer(0));
+    } else {
+      throw err;
+    }
+  }
+  const url = `http://localhost:${assignedPort}`;
+  console.log(`
+allegro-preview \u2192 ${url}
+`);
+  void open(url);
+}
+export {
+  startServer
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+    "$schema": "https://json.schemastore.org/package.json",
+    "name": "@allegrocdp/preview",
+    "version": "0.1.0-dev.10",
+    "description": "Local dev server for previewing Allegro templates",
+    "type": "module",
+    "bin": {
+        "allegro-preview": "./dist/cli.js"
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "npm run build:client && npm run build:cli",
+        "build:client": "vite build",
+        "build:cli": "tsup",
+        "dev": "npm run build:client -- --watch & tsup --watch",
+        "types": "tsc --noEmit",
+        "format": "prettier --write src/",
+        "format:check": "prettier --check src/"
+    },
+    "dependencies": {
+        "chokidar": "^4.0.3",
+        "commander": "^13.1.0",
+        "express": "^5.1.0",
+        "open": "^10.1.2"
+    },
+    "devDependencies": {
+        "@alleyinteractive/allegro-platform": "*",
+        "@types/express": "^5.0.1",
+        "@types/node": "^22.13.5",
+        "prettier": "^3.4.2",
+        "prettier-plugin-organize-imports": "^4.1.0",
+        "tsup": "^8.4.0",
+        "typescript": "^5.7.2",
+        "vite": "^7.0.4"
+    }
+}