folderblog 0.0.1 → 0.0.3

package/dist/seo/index.js

@@ -0,0 +1,274 @@
+import '../chunk-3RG5ZIWI.js';
+
+// src/seo/index.ts
+function escapeMarkup(str, aposEntity = "'") {
+  if (!str) return "";
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, aposEntity);
+}
+function escapeXml(str) {
+  return escapeMarkup(str, "&apos;");
+}
+function escapeHtml(str) {
+  return escapeMarkup(str, "&#039;");
+}
+function makeAbsoluteUrl(path, siteUrl) {
+  if (path.startsWith("http://") || path.startsWith("https://")) return path;
+  if (path.startsWith("//")) return `https:${path}`;
+  if (path.startsWith("/")) return `${siteUrl}${path}`;
+  return `${siteUrl}/${path}`;
+}
+function generateMetaTags(site, options) {
+  const title = options.title ?? site.siteName;
+  const description = options.description ?? site.siteDescription ?? "";
+  const image = options.image ?? site.ogImage ?? "";
+  const url = options.url ?? site.siteUrl;
+  const type = options.type ?? "website";
+  const absoluteImage = image ? makeAbsoluteUrl(image, site.siteUrl) : "";
+  const tags = [
+    { title },
+    { name: "description", content: description },
+    { tagName: "link", rel: "canonical", href: url },
+    { property: "og:title", content: title },
+    { property: "og:description", content: description },
+    { property: "og:url", content: url },
+    { property: "og:type", content: type },
+    { property: "og:site_name", content: site.siteName },
+    { name: "twitter:card", content: "summary_large_image" },
+    { name: "twitter:title", content: title },
+    { name: "twitter:description", content: description }
+  ];
+  if (absoluteImage) {
+    tags.push(
+      { property: "og:image", content: absoluteImage },
+      { name: "twitter:image", content: absoluteImage }
+    );
+  }
+  if (type === "article" && options.article) {
+    const { article } = options;
+    if (article.publishedTime) {
+      tags.push({ property: "article:published_time", content: article.publishedTime });
+    }
+    if (article.modifiedTime) {
+      tags.push({ property: "article:modified_time", content: article.modifiedTime });
+    }
+    if (article.tags) {
+      for (const tag of article.tags) {
+        tags.push({ property: "article:tag", content: tag });
+      }
+    }
+  }
+  return tags;
+}
+function generatePostMetaTags(site, post, url) {
+  return generateMetaTags(site, {
+    title: `${post.title} | ${site.siteName}`,
+    description: post.description || post.excerpt,
+    image: post.coverImage,
+    url,
+    type: "article",
+    article: {
+      publishedTime: post.date,
+      author: post.authorName ?? site.author?.name,
+      tags: post.tags
+    }
+  });
+}
+function generateListMetaTags(site, title, description, url, pageNumber) {
+  const pageTitle = pageNumber && pageNumber > 1 ? `${title} - Page ${pageNumber} | ${site.siteName}` : `${title} | ${site.siteName}`;
+  const tags = generateMetaTags(site, {
+    title: pageTitle,
+    description,
+    url,
+    type: "website"
+  });
+  if (pageNumber && pageNumber > 1) {
+    tags.push({ name: "robots", content: "noindex, follow" });
+  }
+  return tags;
+}
+function postToArticleJsonLd(site, post, url) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "BlogPosting",
+    headline: post.title,
+    description: post.description || post.excerpt,
+    author: {
+      "@type": post.authorName ? "Person" : "Organization",
+      name: post.authorName ?? site.author?.name ?? site.siteName
+    },
+    publisher: {
+      "@type": "Organization",
+      name: site.siteName
+    },
+    datePublished: post.date,
+    mainEntityOfPage: { "@type": "WebPage", "@id": url },
+    keywords: post.tags?.join(", "),
+    ...post.coverImage ? { image: [makeAbsoluteUrl(post.coverImage, site.siteUrl)] } : {}
+  };
+}
+function createItemListJsonLd(posts, listName, listDescription, baseUrl) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "ItemList",
+    name: listName,
+    description: listDescription,
+    numberOfItems: posts.length,
+    itemListElement: posts.map((post, index) => ({
+      "@type": "ListItem",
+      position: index + 1,
+      url: baseUrl ? `${baseUrl}/${post.slug}` : `/${post.slug}`,
+      name: post.title
+    }))
+  };
+}
+function createBreadcrumbJsonLd(items) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "BreadcrumbList",
+    itemListElement: items.map((item, index) => ({
+      "@type": "ListItem",
+      position: index + 1,
+      name: item.name,
+      item: item.url
+    }))
+  };
+}
+function createOrganizationJsonLd(site) {
+  const sameAs = [];
+  if (site.social?.twitter) sameAs.push(site.social.twitter);
+  if (site.social?.github) sameAs.push(site.social.github);
+  return {
+    "@context": "https://schema.org",
+    "@type": "Organization",
+    name: site.siteName,
+    url: site.siteUrl,
+    description: site.siteDescription,
+    ...sameAs.length > 0 ? { sameAs } : {}
+  };
+}
+function createWebsiteJsonLd(site, searchUrl) {
+  const jsonLd = {
+    "@context": "https://schema.org",
+    "@type": "WebSite",
+    name: site.siteName,
+    url: site.siteUrl,
+    description: site.siteDescription
+  };
+  if (searchUrl) {
+    jsonLd.potentialAction = {
+      "@type": "SearchAction",
+      target: {
+        "@type": "EntryPoint",
+        urlTemplate: searchUrl
+      },
+      "query-input": "required name=search_term_string"
+    };
+  }
+  return jsonLd;
+}
+function serializeJsonLd(jsonLd) {
+  return JSON.stringify(jsonLd, null, 2);
+}
+function generateRssFeed(options) {
+  const feedUrl = `${options.baseUrl}/api/feed.xml`;
+  const postPath = options.postPath ?? "/posts";
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>${escapeXml(options.title)}</title>
+    <description>${escapeXml(options.description)}</description>
+    <link>${escapeXml(options.baseUrl)}</link>
+    <atom:link href="${escapeXml(feedUrl)}" rel="self" type="application/rss+xml"/>
+    <lastBuildDate>${(/* @__PURE__ */ new Date()).toUTCString()}</lastBuildDate>
+    ${options.posts.map((post) => {
+    const postUrl = `${options.baseUrl}${postPath}/${encodeURIComponent(post.slug)}`;
+    return `
+    <item>
+      <title>${escapeXml(post.title)}</title>
+      <link>${escapeXml(postUrl)}</link>
+      <guid isPermaLink="true">${escapeXml(postUrl)}</guid>
+      <description>${escapeXml(post.description || post.excerpt)}</description>
+      ${post.date ? `<pubDate>${new Date(post.date).toUTCString()}</pubDate>` : ""}
+      ${(post.tags ?? []).map((tag) => `<category>${escapeXml(tag)}</category>`).join("\n      ")}
+    </item>`;
+  }).join("")}
+  </channel>
+</rss>`;
+}
+function generateJsonFeed(options) {
+  const postPath = options.postPath ?? "/posts";
+  return {
+    version: "https://jsonfeed.org/version/1.1",
+    title: options.title,
+    description: options.description,
+    home_page_url: options.baseUrl,
+    feed_url: `${options.baseUrl}/api/feed.json`,
+    icon: options.logo,
+    items: options.posts.map((post) => {
+      const postUrl = `${options.baseUrl}${postPath}/${encodeURIComponent(post.slug)}`;
+      return {
+        id: postUrl,
+        url: postUrl,
+        title: post.title,
+        summary: post.description || post.excerpt,
+        image: post.coverImage,
+        date_published: post.date,
+        authors: post.authorName ? [{ name: post.authorName }] : [],
+        tags: post.tags
+      };
+    })
+  };
+}
+function generateSitemap(baseUrl, posts, options) {
+  const postPath = options?.postPath ?? "/posts";
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>${escapeXml(baseUrl)}</loc>
+    <changefreq>daily</changefreq>
+    <priority>1.0</priority>
+  </url>
+  ${posts.map((post) => {
+    const postUrl = `${baseUrl}${postPath}/${encodeURIComponent(post.slug)}`;
+    return `
+  <url>
+    <loc>${escapeXml(postUrl)}</loc>
+    ${post.date ? `<lastmod>${new Date(post.date).toISOString().split("T")[0]}</lastmod>` : ""}
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>`;
+  }).join("")}
+</urlset>`;
+}
+function generateRobotsTxt(sitemapUrl, options) {
+  const lines = ["User-agent: *"];
+  if (options?.allowPaths) {
+    for (const path of options.allowPaths) {
+      lines.push(`Allow: ${path}`);
+    }
+  }
+  if (options?.disallowPaths) {
+    for (const path of options.disallowPaths) {
+      lines.push(`Disallow: ${path}`);
+    }
+  }
+  lines.push("", `Sitemap: ${sitemapUrl}`);
+  return lines.join("\n");
+}
+function metaTagsToHtml(tags) {
+  return tags.map((tag) => {
+    if (tag.title) return `<title>${escapeHtml(tag.title)}</title>`;
+    if (tag.tagName === "link") {
+      return `<link rel="${escapeHtml(tag.rel)}" href="${escapeHtml(tag.href)}">`;
+    }
+    if (tag.property) {
+      return `<meta property="${escapeHtml(tag.property)}" content="${escapeHtml(tag.content)}">`;
+    }
+    if (tag.name) {
+      return `<meta name="${escapeHtml(tag.name)}" content="${escapeHtml(tag.content)}">`;
+    }
+    return "";
+  }).filter(Boolean).join("\n");
+}
+
+export { createBreadcrumbJsonLd, createItemListJsonLd, createOrganizationJsonLd, createWebsiteJsonLd, generateJsonFeed, generateListMetaTags, generateMetaTags, generatePostMetaTags, generateRobotsTxt, generateRssFeed, generateSitemap, metaTagsToHtml, postToArticleJsonLd, serializeJsonLd };

package/dist/server/index.cjs

@@ -0,0 +1,33 @@
+'use strict';
+
+var chunkUCXXH2MP_cjs = require('../chunk-UCXXH2MP.cjs');
+require('../chunk-OBGZSXTJ.cjs');
+
+// src/server/index.ts
+function createHandler(options) {
+  const { domain, basePath, fetch: fetchFn = globalThis.fetch } = options;
+  const baseUrl = chunkUCXXH2MP_cjs.normalizeBaseUrl(domain);
+  const prefix = basePath ? basePath.replace(/\/$/, "") : "";
+  return async (request) => {
+    const url = new URL(request.url);
+    let path = url.pathname;
+    if (prefix && path.startsWith(prefix)) {
+      path = path.slice(prefix.length) || "/";
+    }
+    const targetUrl = `${baseUrl}${path}${url.search}`;
+    const response = await fetchFn(targetUrl, {
+      method: request.method,
+      headers: {
+        Accept: request.headers.get("Accept") ?? "*/*",
+        "User-Agent": "folderblog-sdk/0.0.1"
+      }
+    });
+    return new Response(response.body, {
+      status: response.status,
+      statusText: response.statusText,
+      headers: response.headers
+    });
+  };
+}
+
+exports.createHandler = createHandler;

package/dist/server/index.d.cts

@@ -0,0 +1,56 @@
+/**
+ * folderblog/server - Server-side middleware for embedding folder.blog content
+ *
+ * Provides a Web Standard Request/Response handler that works with
+ * any framework (Hono, Express via adapter, Next.js, etc.)
+ *
+ * @example Hono
+ * ```ts
+ * import { Hono } from 'hono';
+ * import { createHandler } from 'folderblog/server';
+ *
+ * const app = new Hono();
+ * const handler = createHandler({ domain: 'yourname.folder.blog' });
+ *
+ * app.get('/blog/*', (c) => handler(c.req.raw));
+ * ```
+ *
+ * @example Node.js
+ * ```ts
+ * import { createHandler } from 'folderblog/server';
+ *
+ * const handler = createHandler({ domain: 'yourname.folder.blog' });
+ * // Use with any Request/Response compatible server
+ * ```
+ *
+ * @packageDocumentation
+ */
+interface FolderBlogHandlerOptions {
+    /** The folder.blog domain to proxy (e.g. 'yourname.folder.blog') */
+    domain: string;
+    /** Base path prefix to strip from incoming requests (e.g. '/blog') */
+    basePath?: string;
+    /** Custom fetch implementation */
+    fetch?: typeof fetch;
+}
+type FolderBlogHandler = (request: Request) => Promise<Response>;
+/**
+ * Create a Web Standard handler that proxies requests to a folder.blog site.
+ *
+ * Maps incoming request paths to the blog's API and returns the response.
+ * Strips the basePath prefix if provided.
+ *
+ * @example
+ * ```ts
+ * const handler = createHandler({
+ *   domain: 'yourname.folder.blog',
+ *   basePath: '/blog',
+ * });
+ *
+ * // GET /blog/api/posts → proxied to yourname.folder.blog/api/posts
+ * const response = await handler(request);
+ * ```
+ */
+declare function createHandler(options: FolderBlogHandlerOptions): FolderBlogHandler;
+
+export { type FolderBlogHandler, type FolderBlogHandlerOptions, createHandler };

package/dist/server/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * folderblog/server - Server-side middleware for embedding folder.blog content
+ *
+ * Provides a Web Standard Request/Response handler that works with
+ * any framework (Hono, Express via adapter, Next.js, etc.)
+ *
+ * @example Hono
+ * ```ts
+ * import { Hono } from 'hono';
+ * import { createHandler } from 'folderblog/server';
+ *
+ * const app = new Hono();
+ * const handler = createHandler({ domain: 'yourname.folder.blog' });
+ *
+ * app.get('/blog/*', (c) => handler(c.req.raw));
+ * ```
+ *
+ * @example Node.js
+ * ```ts
+ * import { createHandler } from 'folderblog/server';
+ *
+ * const handler = createHandler({ domain: 'yourname.folder.blog' });
+ * // Use with any Request/Response compatible server
+ * ```
+ *
+ * @packageDocumentation
+ */
+interface FolderBlogHandlerOptions {
+    /** The folder.blog domain to proxy (e.g. 'yourname.folder.blog') */
+    domain: string;
+    /** Base path prefix to strip from incoming requests (e.g. '/blog') */
+    basePath?: string;
+    /** Custom fetch implementation */
+    fetch?: typeof fetch;
+}
+type FolderBlogHandler = (request: Request) => Promise<Response>;
+/**
+ * Create a Web Standard handler that proxies requests to a folder.blog site.
+ *
+ * Maps incoming request paths to the blog's API and returns the response.
+ * Strips the basePath prefix if provided.
+ *
+ * @example
+ * ```ts
+ * const handler = createHandler({
+ *   domain: 'yourname.folder.blog',
+ *   basePath: '/blog',
+ * });
+ *
+ * // GET /blog/api/posts → proxied to yourname.folder.blog/api/posts
+ * const response = await handler(request);
+ * ```
+ */
+declare function createHandler(options: FolderBlogHandlerOptions): FolderBlogHandler;
+
+export { type FolderBlogHandler, type FolderBlogHandlerOptions, createHandler };

package/dist/server/index.js

@@ -0,0 +1,31 @@
+import { normalizeBaseUrl } from '../chunk-Q6EXKX6K.js';
+import '../chunk-3RG5ZIWI.js';
+
+// src/server/index.ts
+function createHandler(options) {
+  const { domain, basePath, fetch: fetchFn = globalThis.fetch } = options;
+  const baseUrl = normalizeBaseUrl(domain);
+  const prefix = basePath ? basePath.replace(/\/$/, "") : "";
+  return async (request) => {
+    const url = new URL(request.url);
+    let path = url.pathname;
+    if (prefix && path.startsWith(prefix)) {
+      path = path.slice(prefix.length) || "/";
+    }
+    const targetUrl = `${baseUrl}${path}${url.search}`;
+    const response = await fetchFn(targetUrl, {
+      method: request.method,
+      headers: {
+        Accept: request.headers.get("Accept") ?? "*/*",
+        "User-Agent": "folderblog-sdk/0.0.1"
+      }
+    });
+    return new Response(response.body, {
+      status: response.status,
+      statusText: response.statusText,
+      headers: response.headers
+    });
+  };
+}
+
+export { createHandler };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "folderblog",
-  "version": "0.0.1",
-  "description": "SDK for consuming folder.blog content APIs",
+  "version": "0.0.3",
+  "description": "Official SDK for folder.blog — client, server middleware, and markdown processing",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -11,7 +11,61 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
-    }
+    },
+    "./local": {
+      "types": "./dist/local/index.d.ts",
+      "import": "./dist/local/index.js",
+      "require": "./dist/local/index.cjs"
+    },
+    "./processor": {
+      "types": "./dist/processor/index.d.ts",
+      "import": "./dist/processor/index.js",
+      "require": "./dist/processor/index.cjs"
+    },
+    "./processor/plugins": {
+      "types": "./dist/processor/plugins.d.ts",
+      "import": "./dist/processor/plugins.js",
+      "require": "./dist/processor/plugins.cjs"
+    },
+    "./processor/types": {
+      "types": "./dist/processor/types.d.ts",
+      "import": "./dist/processor/types.js",
+      "require": "./dist/processor/types.cjs"
+    },
+    "./seo": {
+      "types": "./dist/seo/index.d.ts",
+      "import": "./dist/seo/index.js",
+      "require": "./dist/seo/index.cjs"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js",
+      "require": "./dist/server/index.cjs"
+    },
+    "./cli": {
+      "types": "./dist/cli/index.d.ts",
+      "import": "./dist/cli/index.js",
+      "require": "./dist/cli/index.cjs"
+    },
+    "./plugins/embed-transformers": {
+      "types": "./dist/plugins/embed-transformers.d.ts",
+      "import": "./dist/plugins/embed-transformers.js",
+      "require": "./dist/plugins/embed-transformers.cjs"
+    },
+    "./plugins/embed-cloudflare-ai": {
+      "types": "./dist/plugins/embed-cloudflare-ai.d.ts",
+      "import": "./dist/plugins/embed-cloudflare-ai.js",
+      "require": "./dist/plugins/embed-cloudflare-ai.cjs"
+    },
+    "./plugins/similarity": {
+      "types": "./dist/plugins/similarity.d.ts",
+      "import": "./dist/plugins/similarity.js",
+      "require": "./dist/plugins/similarity.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "folderblog": "./dist/cli/bin.js"
   },
   "files": [
     "dist"
@@ -21,33 +75,66 @@
     "dev": "tsup --watch",
     "test": "vitest run",
     "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "pnpm build"
   },
+  "dependencies": {
+    "@sindresorhus/slugify": "^2.2.1",
+    "commander": "^13.0.0",
+    "github-slugger": "^2.0.0",
+    "gray-matter": "^4.0.3",
+    "hast-util-to-string": "^3.0.1",
+    "mdast-util-to-string": "^4.0.0",
+    "minisearch": "^7.2.0",
+    "rehype-autolink-headings": "^7.1.0",
+    "rehype-external-links": "^3.0.0",
+    "rehype-raw": "^7.0.0",
+    "rehype-slug": "6.0.0",
+    "rehype-stringify": "^10.0.1",
+    "remark-gfm": "^4.0.0",
+    "remark-obsidian-link": "^0.2.4",
+    "remark-parse": "^11.0.0",
+    "remark-rehype": "^11.1.1",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.0.0",
+    "vfile": "^6.0.3"
+  },
+  "devDependencies": {
+    "@folderblog/processor": "workspace:*",
+    "@huggingface/transformers": "^3.8.1",
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.2",
+    "vitest": "^2.0.0"
+  },
   "keywords": [
     "folderblog",
+    "folder-blog",
     "blog",
     "cms",
     "headless",
     "api",
     "sdk",
     "markdown",
-    "static-site"
+    "static-site",
+    "processor"
   ],
   "author": "",
   "license": "MIT",
   "homepage": "https://folder.blog",
   "repository": {
     "type": "git",
-    "url": "https://github.com/anthropics/folderblog"
+    "url": "https://github.com/iplanwebsites/folder-blog-mono"
   },
-  "sideEffects": false,
-  "devDependencies": {
-    "tsup": "^8.0.0",
-    "typescript": "^5.7.2",
-    "vitest": "^2.0.0"
+  "peerDependencies": {
+    "@huggingface/transformers": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@huggingface/transformers": {
+      "optional": true
+    }
   },
+  "sideEffects": false,
   "engines": {
     "node": ">=18.0.0"
   }