initial commitHEADprimary

7 files changed, 503 insertions, 0 deletions

diff --git a/src/utility/constant.ts b/src/utility/constant.ts
new file mode 100644
index 0000000..d734164
--- /dev/null
+++ b/src/utility/constant.ts
@@ -0,0 +1,64 @@
+
+
+
+/*** IMPORT ------------------------------------------- ***/
+
+import { join } from "dep/std.ts";
+
+/*** UTILITY ------------------------------------------ ***/
+
+const baseDirectory = await Deno.realPath(".");
+const isDevelopment = Deno.args.includes("development");
+
+/*** EXPORT ------------------------------------------- ***/
+
+export const author = "Paul Anthony Webb";
+export const description = "Welcome to Paul Anthony Webb’s corner of the ’Net where he’ll regale you with whatever he finds interesting.";
+export const descriptionRemarks = "Nifty notes and snippets I come across that aren’t suitable for long-form posts.";
+export const email = "paul+blog@webb.page";
+export const environment = isDevelopment ? "development" : "production";
+export const feedDirectory = join(baseDirectory, "feed");
+export const memoDirectory = join(baseDirectory, "memos");
+export const port = Number(Deno.env.has("PORT") ? Deno.env.get("PORT") : 3465);
+export const remarkDirectory = join(baseDirectory, "remarks");
+export const remarkRegex = /^(WR-\d*).txt$/;
+export const title = "the webb blog";
+export const titleRemarks = "the webb blog • remarks";
+export const url = "https://blog.webb.page";
+export const urlRemarks = "https://blog.webb.page/remarks";
+
+export async function getVersion() {
+  let version = "";
+
+  try {
+    version = await Deno.readTextFile("./version.txt");
+  } catch {
+    /*** ignore ***/
+  }
+
+  return version.trim();
+}
+
+export const errorMessage = `
+
+
+
+
+
+
+
+Document: HTTP 404                                                 ERROR
+                                                                    20XX
+
+                               Not Found
+
+Body
+
+   Not sure what you were looking for but, it’s not here. Welp. Maybe
+   try the main page[1]?
+
+References
+
+   [1] <https://blog.webb.page>
+
+`;
diff --git a/src/utility/feed/atom.ts b/src/utility/feed/atom.ts
new file mode 100644
index 0000000..d8827e9
--- /dev/null
+++ b/src/utility/feed/atom.ts
@@ -0,0 +1,87 @@
+
+
+
+/*** UTILITY ------------------------------------------ ***/
+
+import { BaseFeed, escapeXML, type FeedOptions } from "./helper.ts";
+
+interface AtomEntry {
+  content?: {
+    body: string;
+    type?: string;
+  };
+  id: string;
+  image?: string;
+  link: string;
+  summary: string;
+  title: string;
+  updated?: Date;
+}
+
+/*** EXPORT ------------------------------------------- ***/
+
+export class FeedAtom extends BaseFeed<AtomEntry> {
+  constructor(options: FeedOptions) {
+    super(options);
+  }
+
+  build(): string {
+    const xmlParts: string[] = [
+      `<?xml version="1.0" encoding="UTF-8"?>\n`,
+      `<feed xmlns="http://www.w3.org/2005/Atom">\n`,
+      `  <title>${escapeXML(this.options.title)}</title>\n`,
+      `  <subtitle>${escapeXML(this.options.description)}</subtitle>\n`,
+      `  <link rel="alternate" href="${escapeXML(this.options.link)}"/>\n`,
+      `  <link rel="self" href="${escapeXML(this.options.link)}"/>\n`,
+      `  <updated>${this.options.updated?.toISOString()}</updated>\n`,
+      `  <generator>${this.options.generator || "the webb blog"}</generator>\n`,
+      `  <id>${escapeXML(this.options.link)}</id>\n`
+    ];
+
+    for (const author of this.options.authors) {
+      xmlParts.push(`  <author>\n`);
+
+      if (author.name)
+        xmlParts.push(`    <name>${escapeXML(author.name)}</name>\n`);
+
+      if (author.email)
+        xmlParts.push(`    <email>${escapeXML(author.email)}</email>\n`);
+
+      if (author.link)
+        xmlParts.push(`    <uri>${escapeXML(author.link)}</uri>\n`);
+
+      xmlParts.push(`  </author>\n`);
+    }
+
+    if (this.options.icon) {
+      xmlParts.push(`  <icon>${escapeXML(this.options.icon)}</icon>\n`);
+      xmlParts.push(`  <logo>${escapeXML(this.options.icon)}</logo>\n`);
+    }
+
+    if (this.options.feed)
+      xmlParts.push(`  <link rel="self" href="${escapeXML(this.options.feed)}"/>\n`);
+
+    for (const entry of this.items) {
+      xmlParts.push(
+        `  <entry>\n`,
+        `    <title type="html">${escapeXML(entry.title)}</title>\n`,
+        `    <link href="${escapeXML(entry.link)}"/>\n`,
+        `    <id>${escapeXML(entry.id)}</id>\n`,
+        `    <updated>${entry.updated?.toISOString() || new Date().toISOString()}</updated>\n`,
+        `    <summary type="html">${escapeXML(entry.summary)}</summary>\n`,
+        `    <content type="${entry.content?.type || "html"}">${escapeXML(entry.content?.body || entry.summary)}</content>\n`,
+        entry.image ?
+          `    <media:thumbnail url="${escapeXML(entry.image)}" />\n` :
+          "",
+        `  </entry>\n`
+      );
+    }
+
+    for (const category of this.categories) {
+      xmlParts.push(`  <category term="${escapeXML(category)}"/>\n`);
+    }
+
+    xmlParts.push("</feed>");
+    return xmlParts.join("");
+  }
+}
diff --git a/src/utility/feed/helper.ts b/src/utility/feed/helper.ts
new file mode 100644
index 0000000..0177364
--- /dev/null
+++ b/src/utility/feed/helper.ts
@@ -0,0 +1,67 @@
+
+
+
+/*** EXPORT ------------------------------------------- ***/
+
+export interface FeedOptions {
+  authors: Array<{
+    name: string;
+    email?: string;
+    link?: string;
+  }>;
+  copyright?: string;
+  description: string;
+  feed?: string;
+  feedLinks?: {
+    atom?: string;
+  };
+  generator?: string;
+  icon?: string;
+  id?: string;
+  language?: string;
+  link: string;
+  title: string;
+  updated?: Date;
+}
+
+export function escapeXML(unsafe: string): string {
+  const escapeMap: { [key: string]: string } = {
+    "<": "&lt;",
+    ">": "&gt;",
+    "&": "&amp;",
+    "'": "&apos;",
+    '"': "&quot;"
+  };
+
+  return unsafe.replace(/[<>&'"]/g, (c) => escapeMap[c] || c);
+}
+
+export abstract class BaseFeed<T> {
+  protected categories: Set<string>;
+  protected items: Array<T>;
+  protected options: FeedOptions;
+
+  constructor(options: FeedOptions) {
+    this.categories = new Set();
+    this.items = [];
+
+    this.options = {
+      ...options,
+      updated: options.updated || new Date()
+    };
+  }
+
+  abstract build(): string;
+
+  addCategory(category: string) {
+    this.categories.add(category);
+  }
+
+  addContributor(contributor: { name: string; email: string; link?: string }) {
+    this.options.authors.push(contributor);
+  }
+
+  addItem(item: T) {
+    this.items.push(item);
+  }
+}
diff --git a/src/utility/feed/index.ts b/src/utility/feed/index.ts
new file mode 100644
index 0000000..d58609a
--- /dev/null
+++ b/src/utility/feed/index.ts
@@ -0,0 +1,12 @@
+
+
+
+/*** EXPORT ------------------------------------------- ***/
+
+export { FeedAtom as ATOM } from "./atom.ts";
+export { FeedJSON as JSON } from "./json.ts";
+export { FeedRSS as RSS } from "./rss.ts";
+
+
+
+/*** forked from https://github.com/GabsEdits/feed ***/
diff --git a/src/utility/feed/json.ts b/src/utility/feed/json.ts
new file mode 100644
index 0000000..589aeae
--- /dev/null
+++ b/src/utility/feed/json.ts
@@ -0,0 +1,41 @@
+
+
+
+/*** UTILITY ------------------------------------------ ***/
+
+import { BaseFeed, type FeedOptions } from "./helper.ts";
+
+interface JsonItem {
+  content_html?: string;
+  date_published?: Date;
+  id: string;
+  title: string;
+  url: string;
+}
+
+/*** EXPORT ------------------------------------------- ***/
+
+export class FeedJSON extends BaseFeed<JsonItem> {
+  constructor(options: FeedOptions) {
+    super(options);
+  }
+
+  build(): string {
+    const json: Record<string, unknown> = {
+      feed_url: this.options.feed,
+      home_page_url: this.options.link,
+      icon: this.options.icon,
+      items: this.items.map(({ content_html, date_published, id, title, url }) => ({
+        ...(content_html && { content_html }),
+        date_published: date_published?.toISOString() || new Date().toUTCString,
+        id,
+        title,
+        url
+      })),
+      title: this.options.title,
+      version: "https://jsonfeed.org/version/1"
+    };
+
+    return JSON.stringify(json, null, 2);
+  }
+}
diff --git a/src/utility/feed/rss.ts b/src/utility/feed/rss.ts
new file mode 100644
index 0000000..c3971bb
--- /dev/null
+++ b/src/utility/feed/rss.ts
@@ -0,0 +1,85 @@
+
+
+
+/*** UTILITY ------------------------------------------ ***/
+
+import { BaseFeed, escapeXML, type FeedOptions } from "./helper.ts";
+
+interface RssItem {
+  content: {
+    body: string;
+  };
+  description: string;
+  id: string;
+  image?: string;
+  link: string;
+  title: string;
+  updated?: Date;
+}
+
+/*** EXPORT ------------------------------------------- ***/
+
+export class FeedRSS extends BaseFeed<RssItem> {
+  constructor(options: FeedOptions) {
+    super(options);
+  }
+
+  build(): string {
+    const xmlParts: string[] = [
+      `<?xml version="1.0" encoding="UTF-8"?>\n`,
+      `<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:slash="http://purl.org/rss/1.0/modules/slash/" xmlns:sy="http://purl.org/rss/1.0/modules/syndication/" xmlns:wfw="http://wellformedweb.org/CommentAPI/">\n`,
+      `  <channel>\n`,
+      `    <title><![CDATA[${escapeXML(this.options.title)}]]></title>\n`,
+      `    <description><![CDATA[${escapeXML(this.options.description)}]]></description>\n`,
+      `    <link>${escapeXML(this.options.link)}</link>\n`,
+      `    <lastBuildDate>${this.options.updated?.toUTCString()}</lastBuildDate>\n`,
+      `    <language>${this.options.language || "en-US"}</language>\n`,
+      `    <generator>${escapeXML(this.options.generator || "the webb blog")}</generator>\n`,
+      `    <atom:link href="${escapeXML(this.options.link)}" rel="self" type="application/rss+xml"/>\n`
+    ];
+
+    if (this.options.authors.length > 0) {
+      const authorXml = this.options.authors.map((author) => {
+        const escapedEmail = author.email ? escapeXML(author.email) : "";
+        const escapedName = author.name ? escapeXML(author.name) : "";
+        const emailPart = escapedEmail ? `${escapedEmail} ` : "";
+
+        return (
+          `    <webMaster>${emailPart}(${escapedName})</webMaster>\n` +
+          `    <managingEditor>${emailPart}(${escapedName})</managingEditor>\n`
+        );
+      }).join("");
+
+      xmlParts.push(authorXml);
+    }
+
+    if (this.items.length > 0) {
+      const itemsXml = this.items.map((item) => {
+        const contentXml = item.content ?
+          `      <content:encoded><![CDATA[${escapeXML(item.content.body)}]]></content:encoded>\n` :
+          "";
+
+        const imageXml = item.image ?
+          `      <media:thumbnail url="${escapeXML(item.image)}" />\n` :
+          "";
+
+        return (
+          `    <item>\n` +
+          `      <title>${escapeXML(item.title)}</title>\n` +
+          `      <link>${escapeXML(item.link)}</link>\n` +
+          `      <guid>${escapeXML(item.id)}</guid>\n` +
+          `      <pubDate>${item.updated?.toUTCString() || new Date().toUTCString()}</pubDate>\n` +
+          `      <description>${escapeXML(item.description)}</description>\n` +
+          contentXml +
+          imageXml +
+          `    </item>\n`
+        );
+      }).join("");
+
+      xmlParts.push(itemsXml);
+    }
+
+    xmlParts.push(`  </channel>\n`, `</rss>`);
+    return xmlParts.join("");
+  }
+}
diff --git a/src/utility/markdown.ts b/src/utility/markdown.ts
new file mode 100644
index 0000000..f78cfee
--- /dev/null
+++ b/src/utility/markdown.ts
@@ -0,0 +1,147 @@
+
+
+
+/*** EXPORT ------------------------------------------- ***/
+
+export default (input: string): string => {
+  const codeBlocks: { content: string; index: number; language: string; }[] = [];
+  const codeBlockPattern = /```(\w*)[ \t]*\r?\n([\s\S]*?)\r?\n[ \t]*```/g;
+  const inlineCode: string[] = [];
+  const inlineCodePattern = /`([^`]+)`/g;
+  const refPattern = /\s*\[(\w+)\]\s+<([^>]+)>$/gm;
+  const refs = new Map<string, string>();
+
+  /*** extract and replace code blocks with placeholders ***/
+  let processed = input.replace(codeBlockPattern, (_match, language, content) => {
+    const index = codeBlocks.length;
+
+    codeBlocks.push({
+      content: content.trimEnd(),
+      index,
+      language: language || ""
+    });
+
+    return `<!--CODE:BLOCK:${index}-->`;
+  });
+
+  /*** extract inline code ***/
+  processed = processed.replace(inlineCodePattern, (_match, content) => {
+    const index = inlineCode.length;
+    inlineCode.push(content);
+    return `<!--INLINE:CODE:${index}-->`;
+  });
+
+  /*** extract reference definitions (images/links) ***/
+  for (const match of processed.matchAll(refPattern)) {
+    const [, ref, url] = match;
+    refs.set(ref, url);
+  }
+
+  /*** remove reference definitions before blockquote processing ***/
+  processed = processed.replace(refPattern, "");
+
+  /*** process blockquotes ***/
+  processed = processBlockquotes(processed);
+
+  processed = processed
+    .replace(/(\n){6}/g, "")    /*** remove 6 lines from the top of the memo ***/
+    .replace("References", "")  /*** remove reference to reference definitions from output ***/
+    .replace(/(\*\*|__)(.*?)\1/g, `<strong style="white-space: nowrap;">$2</strong>`) /*** bold ***/
+    .replace(/(\*|_)(.*?)\1/g, "<em>$2</em>")   /*** italic ***/
+    .replace(/(\~\~)(.*?)\1/g, `<del>$2</del>`) /*** strikethrough ***/
+    .replace(/'/g, "’")         /*** fancy apostrophe ***/
+    .replace(/(:nbhyp:)/g, "‑") /*** non‑breaking hyphen ***/
+    // deno-lint-ignore no-irregular-whitespace
+    .replace(/(:nbsp:)/g, " ")  /*** non‑breaking space ***/
+    .replace(/(\.\.\.)/g, "…")  /*** ellipsis ***/
+    .replace(/---/g, "<hr/>")
+    .replace(/📸\[([^\]]+)\]\[(\w+)\]/g, (match, alt, ref) => {
+      const url = refs.get(ref);
+      return url ? `<img src="${url}" alt="${alt}" loading="lazy">` : match;
+    })
+    .replace(/📼\[([^\]]+)\]\[(\w+)\]/g, (match, alt, ref) => {
+      const url = refs.get(ref);
+      return url ? `<iframe allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen frameborder="0" referrerpolicy="strict-origin-when-cross-origin" src="${url}" title="${alt}"></iframe>` : match;
+    })
+    .replace(/\[(\w+)\](?!\s+<|\()/g, (match, ref) => {
+      const url = refs.get(ref);
+      const isExternal = url && url.startsWith("http://") || url && url.startsWith("https://");
+
+      return url ?
+        isExternal ?
+          `<a href="${url + (url.includes("?") ? "&" : "?")}ref=blog.webb.page" target="_blank">[${ref}]</a>` :
+          `<a href="${url}">[${ref}]</a>` :
+        match;
+    })
+    .replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_match, text, url) => {
+      const isExternal = url.startsWith("http://") || url.startsWith("https://");
+
+      return isExternal ?
+        `<a href="${url}?ref=blog.webb.page" target="_blank">${text}</a>` :
+        `<a href="${url}">${text}</a>`;
+    });
+
+  /*** restore inline code ***/
+  for (const block in inlineCode) {
+    processed = processed.replace(`<!--INLINE:CODE:${block}-->`, `<code>${escapeHtml(inlineCode[block])}</code>`);
+  }
+
+  /*** restore code blocks ***/
+  for (const block of codeBlocks) {
+    const langAttr = block.language ? ` data-language="${block.language}"` : "";
+    const html = `<pre><code${langAttr}>\n${escapeHtml(block.content)}\n\n</code></pre>`;
+
+    processed = processed.replace(`<!--CODE:BLOCK:${block.index}-->`, html);
+  }
+
+  // console.log(processed); /*** for troubleshooting ***/
+
+  return processed.trimEnd();
+}
+
+/*** HELPER ------------------------------------------- ***/
+
+function escapeHtml(str: string): string {
+  return str
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+}
+
+function processBlockquotes(input: string): string {
+  const lines = input.split("\n");
+  const result: string[] = [];
+  let quoteBuffer: string[] = [];
+
+  const flushQuote = () => {
+    if (quoteBuffer.length > 0) {
+      /*** special indentation to fit memo/remark formatting ***/
+      result.push(`<blockquote>\n   ${quoteBuffer.join("\n   ")}\n\n</blockquote>`);
+      quoteBuffer = [];
+      // TODO
+      // : handle links within blockquotes (WM-032)
+    }
+  };
+
+  for (const line of lines) {
+    /*** preserve code block placeholders ***/
+    if (line.includes("<!--CODE:BLOCK") || line.includes("<!--INLINE:CODE")) {
+      flushQuote();
+      result.push(line);
+      continue;
+    }
+
+    const quoteMatch = line.match(/\s*>\s?(.*)$/);
+
+    if (quoteMatch) {
+      quoteBuffer.push(quoteMatch[1]);
+    } else {
+      flushQuote();
+      result.push(line);
+    }
+  }
+
+  flushQuote();
+  return result.join("\n");
+}