hazo_blog 0.1.0

package/CHANGE_LOG.md

@@ -0,0 +1,45 @@
+# hazo_blog — Change Log
+
+All notable changes are documented here. This project follows
+[Semantic Versioning](https://semver.org/).
+
+## 0.1.0 — 2026-06-01
+
+Initial release. SEO-first blogging package extracted from gotimer.
+
+**Core**
+- `BlogConfig` contract — the host supplies brand/author/URLs, a `hazo_connect`
+  adapter (`getHazoConnect`), an admin `authorize(req)` guard, optional tenant
+  `resolveScope(req)`, MDX component overrides, and a GA4 `onAnalyticsEvent` sink.
+- Storage via `hazo_connect` (SQLite local / PostgreSQL prod). Typed
+  `BlogRepository` over `createCrudService`; portable live-post gate
+  (`status <> 'draft' AND publish_date <= now`).
+- `BlogService` — slug/reading-time/excerpt/publish-date rules, upsert-by-slug,
+  category/tag resolution, author resolution.
+- Tables (dual SQLite + PostgreSQL migrations): `hazo_blog_posts`,
+  `hazo_blog_categories`, `hazo_blog_tags`, `hazo_blog_post_tags`. Every table has
+  a nullable `scope_id` for optional multi-tenancy.
+
+**SEO (GSC/Bing-ready)** — BlogPosting + BreadcrumbList + FAQPage JSON-LD,
+per-post canonical + OG image, `noindex` for drafts/scheduled, composable
+`getBlogSitemapEntries` / `getBlogRobotsRules` / `getBlogRssXml`.
+
+**Rendering** — sealed Next.js page factories (`createBlogIndexPage`,
+`createBlogPostPage`, `createBlogTagPage`) using SSG + ISR + `dynamicParams`;
+MDX rendered to static HTML at build/ISR via `next-mdx-remote/rsc`.
+
+**Auth** — admin routes guarded by injectable `authorize`; management API uses
+`hazo_api` API keys + `ok`/`fail` envelopes.
+
+**UI** — `PostCard`, `PostHero`, `AuthorBio`, `FaqSection`, `TableOfContents`,
+`RelatedPosts`, `BlogSearch`, MDX components (`YouTube`, `Callout`, `BlogImage`,
+`CodeBlock`), and an admin `PostForm` built on `hazo_ui`'s `MarkdownEditor`.
+
+**Analytics** — `blog_post_view` / `blog_read_complete` / `blog_search` /
+`blog_share` events via an injectable hook with a `window.gtag`/`dataLayer`
+fallback (no GA script bundled).
+
+**v1 features:** tags + tag pages, search, related posts, table of contents.
+Deferred: view counts, non-destructive sync CLI, file-based MDX content.
+
+Requires `hazo_ui >= 3.2.0` (for `MarkdownEditor`).

package/README.md

@@ -0,0 +1,179 @@
+# hazo_blog
+
+SEO-first blogging for Next.js App Router apps: posts, categories, tags, MDX
+content, and GA4 / Google Search Console / Bing-ready output (BlogPosting +
+BreadcrumbList + FAQPage JSON-LD, canonical, OG, sitemap, RSS). The package owns
+the page layout **and** all SEO; the host customizes via Tailwind theme tokens
+and a single `BlogConfig`.
+
+## Install
+
+```bash
+npm install hazo_blog
+# peers:
+npm install hazo_core hazo_connect hazo_api hazo_files hazo_ui react react-dom next
+# optional peers: hazo_images (AI images), hazo_jobs (scheduled publish), hazo_auth
+```
+
+Requires `hazo_ui >= 3.2.0` (provides the `MarkdownEditor` used by the admin form).
+
+## 1. Database
+
+Apply the schema for your engine (also runnable through your migration runner):
+
+- `db_setup_sqlite.sql` — SQLite
+- `db_setup_postgres.sql` — PostgreSQL
+
+Tables: `hazo_blog_posts`, `hazo_blog_categories`, `hazo_blog_tags`,
+`hazo_blog_post_tags` (all carry a nullable `scope_id` for optional
+multi-tenancy).
+
+## 2. Define your `BlogConfig`
+
+```ts
+// lib/blog-config.ts
+import type { BlogConfig } from "hazo_blog";
+
+export const blogConfig: BlogConfig = {
+  siteName: "Acme",
+  baseUrl: "https://acme.com",
+  basePath: "/blog",                        // default "/blog"
+  logoUrl: "https://acme.com/logo.png",
+  defaultOgImage: "https://acme.com/og.png",
+  author: { name: "Acme Team", url: "https://acme.com/about" },
+  getHazoConnect: () => myHazoConnectAdapter,    // SQLite or Postgres
+  authorize: (req) => checkAdminPermission(req),  // wire to hazo_auth
+  // resolveScope: (req) => orgIdFrom(req),       // multi-tenant only
+  // getAuthor: (id) => lookupAuthor(id),         // per-post authors
+  // onAnalyticsEvent: (name, params) => gtag("event", name, params),
+  revalidateSeconds: 3600,
+};
+```
+
+## 3. Mount the sealed pages
+
+The package owns the page implementations; you write tiny files that pass config.
+**`revalidate` and `dynamicParams` must be static literals** (a Next requirement),
+and `default` can't be destructured (reserved word):
+
+```tsx
+// app/blog/page.tsx
+import { createBlogIndexPage } from "hazo_blog/next";
+import { blogConfig } from "@/lib/blog-config";
+const page = createBlogIndexPage(blogConfig);
+export default page.default;
+export const generateMetadata = page.generateMetadata;
+export const revalidate = 3600;
+```
+
+```tsx
+// app/blog/[slug]/page.tsx
+import { createBlogPostPage } from "hazo_blog/next";
+import { blogConfig } from "@/lib/blog-config";
+const page = createBlogPostPage(blogConfig);
+export default page.default;
+export const generateMetadata = page.generateMetadata;
+export const generateStaticParams = page.generateStaticParams;
+export const revalidate = 3600;
+export const dynamicParams = true;
+```
+
+```tsx
+// app/blog/tag/[tag]/page.tsx
+import { createBlogTagPage } from "hazo_blog/next";
+import { blogConfig } from "@/lib/blog-config";
+const page = createBlogTagPage(blogConfig);
+export default page.default;
+export const generateMetadata = page.generateMetadata;
+export const revalidate = 3600;
+```
+
+## 4. Mount the API routes
+
+Route-handler factories are exported from the **main `hazo_blog` entry** (they are
+React-free, so they don't pull the React page components into your API bundles):
+
+```ts
+// app/api/blog/search/route.ts
+import { createBlogSearchRoute } from "hazo_blog";
+import { blogConfig } from "@/lib/blog-config";
+export const GET = createBlogSearchRoute(blogConfig);
+
+// app/api/blog/feed/route.ts  → RSS
+export const GET = createBlogFeedRoute(blogConfig);
+
+// app/api/admin/blog/route.ts (cookie/session, guarded by authorize)
+const admin = createBlogAdminRoutes(blogConfig);
+export const GET = admin.collection.GET;
+export const POST = admin.collection.POST;
+
+// app/api/admin/blog/[id]/route.ts
+export const PUT = admin.item.PUT;
+export const DELETE = admin.item.DELETE;
+
+// app/api/blog/manage/route.ts (programmatic, hazo_api keys; scopes blog:read / blog:write)
+const manage = createBlogManageRoutes(blogConfig);
+export const { GET, POST, PATCH } = manage;
+```
+
+## 5. Sitemap & robots
+
+`sitemap.xml` / `robots.txt` are site-level singletons — merge the blog's
+contributions into your root files:
+
+```ts
+// app/sitemap.ts
+import { createBlogService, getBlogSitemapEntries, resolveConfig } from "hazo_blog";
+import { blogConfig } from "@/lib/blog-config";
+
+export default async function sitemap() {
+  const service = createBlogService(blogConfig);
+  const { posts } = await service.listPosts({ perPage: 1000 });
+  return [/* ...your routes */, ...getBlogSitemapEntries(resolveConfig(blogConfig), posts)];
+}
+```
+
+## 6. Admin authoring form
+
+```tsx
+"use client";
+import { PostForm } from "hazo_blog/client";
+// pass categories + an endpoint; wire onImageUpload to hazo_files for paste-upload
+<PostForm categories={categories} endpoint="/api/admin/blog" onSaved={...} />
+```
+
+## Required Next.js config
+
+```js
+// next.config.js
+const nextConfig = {
+  // Transpile next-mdx-remote so Turbopack dedupes a single React copy
+  // (otherwise MDX prerender throws "React Element from an older version").
+  transpilePackages: ["hazo_blog", "hazo_ui", "next-mdx-remote"],
+  // Only if you use hazo_connect's SQLite (better-sqlite3) adapter:
+  serverExternalPackages: ["better-sqlite3"],
+};
+```
+
+- **hazo_connect SQLite uses `sql.js` (WASM)** by default — copy
+  `node_modules/sql.js/dist/sql-wasm.wasm` to your app's `public/sql-wasm.wasm`.
+- **Tailwind v4:** add `@source "../node_modules/hazo_blog/dist";` to your CSS so
+  the package's classes are compiled. The admin editor's styles load automatically
+  via `hazo_ui`'s `MarkdownEditor`.
+
+## Exports
+
+| Entry | Contents |
+|---|---|
+| `hazo_blog` | server: `createBlogService`, `createBlogRepository`, SEO builders, **route-handler factories** (React-free), types |
+| `hazo_blog/client` | client components: `PostCard`, `PostHero`, `AuthorBio`, `FaqSection`, `TableOfContents`, `RelatedPosts`, `BlogSearch`, `PostForm`, MDX components, `trackBlogEvent` |
+| `hazo_blog/next` | sealed page factories (`createBlogIndexPage/PostPage/TagPage`) + `BlogContent` (React) |
+| `hazo_blog/seo` | `buildBlogPostingJsonLd`, `buildBreadcrumbJsonLd`, `buildFaqJsonLd`, `getBlogSitemapEntries`, `getBlogRobotsRules`, `getBlogRssXml` |
+| `hazo_blog/config` | `BlogConfig` types + `resolveConfig` |
+
+See `SETUP_CHECKLIST.md` for a step-by-step integration list. A runnable demo
+lives in `test-app/`.
+
+## License
+
+MIT

package/SETUP_CHECKLIST.md

@@ -0,0 +1,54 @@
+# hazo_blog — Setup Checklist
+
+Step-by-step for adding hazo_blog to a Next.js App Router app. See `README.md`
+for full code samples.
+
+## 1. Install
+
+- [ ] `npm install hazo_blog`
+- [ ] Install peers: `hazo_core hazo_connect hazo_api hazo_files hazo_ui react react-dom next`
+- [ ] Confirm `hazo_ui >= 3.2.0` (needed for `MarkdownEditor`)
+- [ ] Optional peers as needed: `hazo_images`, `hazo_jobs`, `hazo_auth`
+
+## 2. Database
+
+- [ ] Apply `db_setup_sqlite.sql` or `db_setup_postgres.sql` (or add to your migration runner)
+- [ ] Confirm tables exist: `hazo_blog_posts`, `hazo_blog_categories`, `hazo_blog_tags`, `hazo_blog_post_tags`
+- [ ] If using `hazo_api`'s management API: ensure `hazo_api_keys` table exists (ships with hazo_api)
+
+## 3. Config
+
+- [ ] Create `lib/blog-config.ts` exporting a `BlogConfig`
+- [ ] Wire `getHazoConnect` to your hazo_connect adapter
+- [ ] Wire `authorize(req)` to your admin permission check (e.g. hazo_auth)
+- [ ] Set `siteName`, `baseUrl`, `logoUrl`, `defaultOgImage`, `author`
+- [ ] (multi-tenant only) set `resolveScope(req)`
+- [ ] (per-post authors) set `getAuthor(id)`
+- [ ] (analytics) set `onAnalyticsEvent` or rely on the `window.gtag` fallback
+
+## 4. Routes
+
+- [ ] `app/blog/page.tsx` → `createBlogIndexPage` (+ `export const revalidate = <number>`)
+- [ ] `app/blog/[slug]/page.tsx` → `createBlogPostPage` (+ `generateStaticParams`, `revalidate`, `dynamicParams = true`)
+- [ ] `app/blog/tag/[tag]/page.tsx` → `createBlogTagPage`
+- [ ] `app/api/blog/search/route.ts` → `createBlogSearchRoute` (import from `hazo_blog`)
+- [ ] `app/api/blog/feed/route.ts` → `createBlogFeedRoute`
+- [ ] `app/api/admin/blog/route.ts` + `[id]/route.ts` → `createBlogAdminRoutes`
+- [ ] (optional) `app/api/blog/manage/route.ts` → `createBlogManageRoutes`
+- [ ] Merge `getBlogSitemapEntries()` into root `app/sitemap.ts` and `getBlogRobotsRules()` into `app/robots.ts`
+
+## 5. Next.js config (required)
+
+- [ ] `transpilePackages: ["hazo_blog", "hazo_ui", "next-mdx-remote"]` ← transpiling `next-mdx-remote` prevents the "React Element from an older version" MDX prerender error
+- [ ] `serverExternalPackages: ["better-sqlite3"]` (if using the SQLite adapter)
+- [ ] Copy `node_modules/sql.js/dist/sql-wasm.wasm` → `public/sql-wasm.wasm` (hazo_connect SQLite uses sql.js/WASM)
+- [ ] Tailwind v4: add `@source "../node_modules/hazo_blog/dist";` to your CSS
+
+## 6. Verify
+
+- [ ] `next build` succeeds; `/blog` and `/blog/[slug]` prerender (SSG)
+- [ ] View-source a post: BlogPosting + BreadcrumbList JSON-LD present (FAQPage when the post has FAQ)
+- [ ] Drafts/future-scheduled posts return 404 and are absent from sitemap/RSS
+- [ ] `/api/blog/feed` returns valid RSS; `/api/blog/search?q=...` returns matches
+- [ ] Admin form (`PostForm`) saves a draft and publishes; published post appears at its URL
+- [ ] Paste a post's HTML into Google's Rich Results Test — no errors

package/db_setup_postgres.sql

@@ -0,0 +1,71 @@
+-- hazo_blog database schema — PostgreSQL
+--
+-- Supports both PostgreSQL (this file) and SQLite (db_setup_sqlite.sql).
+-- All tables use the `hazo_blog_` prefix per workspace standards.
+--
+-- Multi-tenancy: every table carries a nullable `scope_id`. Single-tenant
+-- consumers leave it NULL; multi-tenant consumers populate it and pass a scope
+-- resolver so the repository filters by it.
+
+CREATE TABLE IF NOT EXISTS hazo_blog_categories (
+  id          UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  scope_id    TEXT,
+  slug        TEXT NOT NULL,
+  name        TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT '',
+  colour      TEXT NOT NULL DEFAULT '#3B82F6',
+  created_at  TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at  TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_categories_scope_slug
+  ON hazo_blog_categories (scope_id, slug);
+
+CREATE TABLE IF NOT EXISTS hazo_blog_tags (
+  id         UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  scope_id   TEXT,
+  slug       TEXT NOT NULL,
+  name       TEXT NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_tags_scope_slug
+  ON hazo_blog_tags (scope_id, slug);
+
+CREATE TABLE IF NOT EXISTS hazo_blog_posts (
+  id               UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  scope_id         TEXT,
+  slug             TEXT NOT NULL,
+  title            TEXT NOT NULL,
+  content          TEXT NOT NULL DEFAULT '',          -- raw MDX
+  content_html     TEXT,                              -- cached rendered HTML (nullable)
+  excerpt          TEXT,
+  category_id      UUID REFERENCES hazo_blog_categories(id) ON DELETE SET NULL,
+  author_id        TEXT,                              -- optional; resolved via getAuthor()
+  meta_title       TEXT NOT NULL DEFAULT '',
+  meta_description TEXT NOT NULL DEFAULT '',
+  canonical_url    TEXT,                              -- per-post canonical override
+  og_image         TEXT,                              -- per-post OG image override
+  featured_image   TEXT,
+  image_ref        TEXT,                              -- generic image ref (was character_id)
+  faq_json         JSONB NOT NULL DEFAULT '[]',       -- [{question, answer}]
+  reading_time     INTEGER NOT NULL DEFAULT 0,        -- cached, minutes
+  status           TEXT NOT NULL DEFAULT 'draft',     -- draft | published | scheduled
+  publish_date     TIMESTAMPTZ,
+  created_at       TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at       TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_posts_scope_slug
+  ON hazo_blog_posts (scope_id, slug);
+CREATE INDEX IF NOT EXISTS idx_hazo_blog_posts_status_date
+  ON hazo_blog_posts (status, publish_date);
+CREATE INDEX IF NOT EXISTS idx_hazo_blog_posts_category
+  ON hazo_blog_posts (category_id);
+
+CREATE TABLE IF NOT EXISTS hazo_blog_post_tags (
+  id      UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  post_id UUID NOT NULL REFERENCES hazo_blog_posts(id) ON DELETE CASCADE,
+  tag_id  UUID NOT NULL REFERENCES hazo_blog_tags(id) ON DELETE CASCADE
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_post_tags_unique
+  ON hazo_blog_post_tags (post_id, tag_id);
+CREATE INDEX IF NOT EXISTS idx_hazo_blog_post_tags_tag ON hazo_blog_post_tags (tag_id);

package/db_setup_sqlite.sql

@@ -0,0 +1,77 @@
+-- hazo_blog database schema — SQLite
+--
+-- Supports both PostgreSQL (db_setup_postgres.sql) and SQLite (this file).
+-- All tables use the `hazo_blog_` prefix per workspace standards.
+--
+-- Tables:
+--   hazo_blog_posts       — blog posts (raw MDX content + cached HTML + SEO fields)
+--   hazo_blog_categories  — single category per post
+--   hazo_blog_tags        — free-form tags (many-to-many with posts)
+--   hazo_blog_post_tags   — post↔tag join
+--
+-- Multi-tenancy: every table carries a nullable `scope_id`. Single-tenant
+-- consumers (e.g. gotimer) leave it NULL; multi-tenant consumers populate it
+-- and pass a scope resolver so the repository filters by it.
+
+CREATE TABLE IF NOT EXISTS hazo_blog_categories (
+  id          TEXT PRIMARY KEY,
+  scope_id    TEXT,
+  slug        TEXT NOT NULL,
+  name        TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT '',
+  colour      TEXT NOT NULL DEFAULT '#3B82F6',
+  created_at  TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at  TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_categories_scope_slug
+  ON hazo_blog_categories (scope_id, slug);
+
+CREATE TABLE IF NOT EXISTS hazo_blog_tags (
+  id         TEXT PRIMARY KEY,
+  scope_id   TEXT,
+  slug       TEXT NOT NULL,
+  name       TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_tags_scope_slug
+  ON hazo_blog_tags (scope_id, slug);
+
+CREATE TABLE IF NOT EXISTS hazo_blog_posts (
+  id               TEXT PRIMARY KEY,
+  scope_id         TEXT,
+  slug             TEXT NOT NULL,
+  title            TEXT NOT NULL,
+  content          TEXT NOT NULL DEFAULT '',          -- raw MDX
+  content_html     TEXT,                              -- cached rendered HTML (nullable)
+  excerpt          TEXT,
+  category_id      TEXT REFERENCES hazo_blog_categories(id) ON DELETE SET NULL,
+  author_id        TEXT,                              -- optional; resolved via getAuthor()
+  meta_title       TEXT NOT NULL DEFAULT '',
+  meta_description TEXT NOT NULL DEFAULT '',
+  canonical_url    TEXT,                              -- per-post canonical override
+  og_image         TEXT,                              -- per-post OG image override
+  featured_image   TEXT,
+  image_ref        TEXT,                              -- generic image ref (was character_id)
+  faq_json         TEXT NOT NULL DEFAULT '[]',        -- [{question, answer}]
+  reading_time     INTEGER NOT NULL DEFAULT 0,        -- cached, minutes
+  status           TEXT NOT NULL DEFAULT 'draft',     -- draft | published | scheduled
+  publish_date     TEXT,
+  created_at       TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at       TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_posts_scope_slug
+  ON hazo_blog_posts (scope_id, slug);
+CREATE INDEX IF NOT EXISTS idx_hazo_blog_posts_status_date
+  ON hazo_blog_posts (status, publish_date);
+CREATE INDEX IF NOT EXISTS idx_hazo_blog_posts_category
+  ON hazo_blog_posts (category_id);
+
+CREATE TABLE IF NOT EXISTS hazo_blog_post_tags (
+  id      TEXT PRIMARY KEY,
+  post_id TEXT NOT NULL REFERENCES hazo_blog_posts(id) ON DELETE CASCADE,
+  tag_id  TEXT NOT NULL REFERENCES hazo_blog_tags(id) ON DELETE CASCADE
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_hazo_blog_post_tags_unique
+  ON hazo_blog_post_tags (post_id, tag_id);
+CREATE INDEX IF NOT EXISTS idx_hazo_blog_post_tags_tag ON hazo_blog_post_tags (tag_id);

package/dist/components/admin/post-form.d.ts

@@ -0,0 +1,18 @@
+import { type MarkdownEmbed } from "hazo_ui";
+import type { BlogCategory, BlogPostWithRelations } from "../../types/index.js";
+export interface PostFormProps {
+    /** Existing post when editing; omit to create. */
+    post?: BlogPostWithRelations | null;
+    categories?: BlogCategory[];
+    /** Endpoint that accepts the upsert payload (POST). Default "/api/admin/blog". */
+    endpoint?: string;
+    /** Called after a successful save with the server response. */
+    onSaved?: (result: unknown) => void;
+    /** MDX embeds offered in the editor toolbar (host can extend). */
+    embeds?: MarkdownEmbed[];
+    /** Paste-to-upload handler wired to hazo_files by the host. */
+    onImageUpload?: (file: File) => Promise<string | null>;
+    className?: string;
+}
+export declare function PostForm({ post, categories, endpoint, onSaved, embeds, onImageUpload, className, }: PostFormProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=post-form.d.ts.map

package/dist/components/admin/post-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-form.d.ts","sourceRoot":"","sources":["../../../src/components/admin/post-form.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7D,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EAGtB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,IAAI,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,kEAAkE;IAClE,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgBD,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,UAAe,EACf,QAA4B,EAC5B,OAAO,EACP,MAAuB,EACvB,aAAa,EACb,SAAS,GACV,EAAE,aAAa,2CA+Mf"}

package/dist/components/admin/post-form.js

@@ -0,0 +1,78 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { MarkdownEditor } from "hazo_ui";
+import { cn } from "hazo_ui/utils";
+import { slugify } from "../../lib/text.js";
+const DEFAULT_EMBEDS = [
+    { name: "youtube", label: "YT", snippet: '\n<YouTube id="VIDEO_ID" title="" />\n' },
+    {
+        name: "callout",
+        label: "Note",
+        snippet: (sel) => `\n<Callout type="info">\n${sel || "..."}\n</Callout>\n`,
+    },
+    {
+        name: "image",
+        label: "Img",
+        snippet: '\n<BlogImage src="/path.jpg" alt="" caption="" />\n',
+    },
+];
+export function PostForm({ post, categories = [], endpoint = "/api/admin/blog", onSaved, embeds = DEFAULT_EMBEDS, onImageUpload, className, }) {
+    const [title, setTitle] = useState(post?.title ?? "");
+    const [slug, setSlug] = useState(post?.slug ?? "");
+    const [slugTouched, setSlugTouched] = useState(!!post);
+    const [content, setContent] = useState(post?.content ?? "");
+    const [categoryId, setCategoryId] = useState(post?.category_id ?? "");
+    const [metaTitle, setMetaTitle] = useState(post?.meta_title ?? "");
+    const [metaDescription, setMetaDescription] = useState(post?.meta_description ?? "");
+    const [featuredImage, setFeaturedImage] = useState(post?.featured_image ?? "");
+    const [tags, setTags] = useState((post?.tags ?? []).map((t) => t.name).join(", "));
+    const [faq, setFaq] = useState(post?.faq ?? []);
+    const [saving, setSaving] = useState(false);
+    const [error, setError] = useState("");
+    function effectiveSlug() {
+        return slugTouched && slug ? slugify(slug) : slugify(title);
+    }
+    async function save(status) {
+        setSaving(true);
+        setError("");
+        try {
+            const payload = {
+                slug: effectiveSlug(),
+                title,
+                content,
+                category_id: categoryId || null,
+                meta_title: metaTitle,
+                meta_description: metaDescription,
+                featured_image: featuredImage || null,
+                tags: tags
+                    .split(",")
+                    .map((t) => t.trim())
+                    .filter(Boolean),
+                faq: faq.filter((f) => f.question.trim() && f.answer.trim()),
+                status,
+            };
+            const res = await fetch(endpoint, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify(payload),
+            });
+            if (!res.ok) {
+                setError(`Save failed (${res.status})`);
+                return;
+            }
+            onSaved?.(await res.json());
+        }
+        catch {
+            setError("Save failed");
+        }
+        finally {
+            setSaving(false);
+        }
+    }
+    const inputCls = "w-full rounded-lg border border-border bg-background px-3 py-2 text-sm outline-none focus:ring-2 focus:ring-primary";
+    return (_jsxs("form", { className: cn("space-y-5", className), onSubmit: (e) => e.preventDefault(), children: [_jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: "Title" }), _jsx("input", { className: inputCls, value: title, onChange: (e) => setTitle(e.target.value), placeholder: "Post title" })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: "Slug" }), _jsx("input", { className: inputCls, value: slugTouched ? slug : effectiveSlug(), onChange: (e) => {
+                            setSlugTouched(true);
+                            setSlug(e.target.value);
+                        }, placeholder: "auto-generated-from-title" })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: "Content (MDX)" }), _jsx(MarkdownEditor, { value: content, onChange: setContent, height: 480, embeds: embeds, onImageUpload: onImageUpload, placeholder: "Write your post in Markdown / MDX\u2026" })] }), _jsxs("div", { className: "grid gap-4 sm:grid-cols-2", children: [_jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: "Category" }), _jsxs("select", { className: inputCls, value: categoryId, onChange: (e) => setCategoryId(e.target.value), children: [_jsx("option", { value: "", children: "\u2014 none \u2014" }), categories.map((c) => (_jsx("option", { value: c.id, children: c.name }, c.id)))] })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: "Tags (comma-separated)" }), _jsx("input", { className: inputCls, value: tags, onChange: (e) => setTags(e.target.value), placeholder: "guides, timers" })] })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: "Featured image URL" }), _jsx("input", { className: inputCls, value: featuredImage, onChange: (e) => setFeaturedImage(e.target.value), placeholder: "https://\u2026" })] }), _jsxs("div", { className: "grid gap-4 sm:grid-cols-2", children: [_jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: "Meta title (SEO)" }), _jsx("input", { className: inputCls, value: metaTitle, onChange: (e) => setMetaTitle(e.target.value) })] }), _jsxs("div", { children: [_jsx("label", { className: "mb-1 block text-sm font-medium", children: "Meta description (SEO)" }), _jsx("input", { className: inputCls, value: metaDescription, onChange: (e) => setMetaDescription(e.target.value) })] })] }), _jsxs("fieldset", { className: "rounded-lg border border-border p-4", children: [_jsx("legend", { className: "px-1 text-sm font-medium", children: "FAQ" }), faq.map((item, i) => (_jsxs("div", { className: "mb-2 grid gap-2 sm:grid-cols-2", children: [_jsx("input", { className: inputCls, value: item.question, placeholder: "Question", onChange: (e) => setFaq((prev) => prev.map((f, j) => (j === i ? { ...f, question: e.target.value } : f))) }), _jsx("input", { className: inputCls, value: item.answer, placeholder: "Answer", onChange: (e) => setFaq((prev) => prev.map((f, j) => (j === i ? { ...f, answer: e.target.value } : f))) })] }, i))), _jsx("button", { type: "button", className: "mt-1 text-sm text-primary hover:underline", onClick: () => setFaq((p) => [...p, { question: "", answer: "" }]), children: "+ Add FAQ item" })] }), error && _jsx("p", { className: "text-sm text-destructive", children: error }), _jsxs("div", { className: "flex gap-3", children: [_jsx("button", { type: "button", disabled: saving, onClick: () => save("draft"), className: "rounded-lg border border-border px-4 py-2 text-sm font-medium hover:bg-accent disabled:opacity-50", children: "Save draft" }), _jsx("button", { type: "button", disabled: saving, onClick: () => save("published"), className: "rounded-lg bg-primary px-4 py-2 text-sm font-medium text-primary-foreground hover:opacity-90 disabled:opacity-50", children: saving ? "Saving…" : "Publish" })] })] }));
+}

package/dist/components/author-bio.d.ts

@@ -0,0 +1,7 @@
+import type { AuthorInfo } from "../types/index.js";
+export interface AuthorBioProps {
+    author: AuthorInfo;
+    className?: string;
+}
+export declare function AuthorBio({ author, className }: AuthorBioProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=author-bio.d.ts.map

package/dist/components/author-bio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"author-bio.d.ts","sourceRoot":"","sources":["../../src/components/author-bio.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,cAAc,2CA0B9D"}

package/dist/components/author-bio.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import Image from "next/image";
+import { cn } from "hazo_ui/utils";
+export function AuthorBio({ author, className }) {
+    return (_jsxs("aside", { className: cn("my-8 flex items-center gap-4 rounded-xl border border-border bg-muted/30 p-5", className), children: [author.avatar && (_jsx(Image, { src: author.avatar, alt: author.name, width: 56, height: 56, className: "h-14 w-14 rounded-full object-cover" })), _jsxs("div", { className: "min-w-0", children: [_jsx("p", { className: "text-sm text-muted-foreground", children: "Written by" }), _jsx("a", { href: author.url, className: "font-semibold text-foreground hover:text-primary", children: author.name }), author.bio && _jsx("p", { className: "mt-1 text-sm text-muted-foreground", children: author.bio })] })] }));
+}

package/dist/components/blog-post-view-tracker.d.ts

@@ -0,0 +1,10 @@
+export interface BlogPostViewTrackerProps {
+    slug: string;
+    title: string;
+}
+/**
+ * Fires `blog_post_view` on mount and `blog_read_complete` once the reader
+ * scrolls near the bottom. Renders nothing.
+ */
+export declare function BlogPostViewTracker({ slug, title }: BlogPostViewTrackerProps): null;
+//# sourceMappingURL=blog-post-view-tracker.d.ts.map

package/dist/components/blog-post-view-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-post-view-tracker.d.ts","sourceRoot":"","sources":["../../src/components/blog-post-view-tracker.tsx"],"names":[],"mappings":"AAKA,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,wBAAwB,QAoB5E"}

package/dist/components/blog-post-view-tracker.js

@@ -0,0 +1,27 @@
+"use client";
+import { useEffect } from "react";
+import { trackBlogEvent } from "../lib/analytics.js";
+/**
+ * Fires `blog_post_view` on mount and `blog_read_complete` once the reader
+ * scrolls near the bottom. Renders nothing.
+ */
+export function BlogPostViewTracker({ slug, title }) {
+    useEffect(() => {
+        trackBlogEvent("blog_post_view", { slug, title });
+        let completed = false;
+        function onScroll() {
+            if (completed)
+                return;
+            const scrolled = window.scrollY + window.innerHeight;
+            const threshold = document.body.scrollHeight * 0.9;
+            if (scrolled >= threshold) {
+                completed = true;
+                trackBlogEvent("blog_read_complete", { slug, title });
+                window.removeEventListener("scroll", onScroll);
+            }
+        }
+        window.addEventListener("scroll", onScroll, { passive: true });
+        return () => window.removeEventListener("scroll", onScroll);
+    }, [slug, title]);
+    return null;
+}

package/dist/components/blog-search.d.ts

@@ -0,0 +1,9 @@
+export interface BlogSearchProps {
+    /** Endpoint that returns { posts: SearchResult[] } for ?q=. Default `${basePath}/api/search`. */
+    endpoint?: string;
+    basePath?: string;
+    placeholder?: string;
+    className?: string;
+}
+export declare function BlogSearch({ endpoint, basePath, placeholder, className, }: BlogSearchProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=blog-search.d.ts.map

package/dist/components/blog-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-search.d.ts","sourceRoot":"","sources":["../../src/components/blog-search.tsx"],"names":[],"mappings":"AAaA,MAAM,WAAW,eAAe;IAC9B,iGAAiG;IACjG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,QAAkB,EAClB,WAA6B,EAC7B,SAAS,GACV,EAAE,eAAe,2CA+DjB"}