blog-kit-core

Framework-agnostic domain package for blog-kit.

blog-kit-core contains the shared vocabulary of the system: posts, authors, categories, repository contracts, editorial types, pagination, and pure transformation helpers.

Install

pnpm add blog-kit-core

Use It For

• Shared blog domain types
• Public blog-facing types
• Repository and editorial contracts
• Media repository contracts
• Pagination helpers
• Pure filtering and relationship helpers
• Transforming domain posts into public summaries

This package does not depend on React, Next.js, Supabase, or any provider SDK.

Main Exports

• Post, Author, Category
• SiteConfig
• PostRepository, EditorialRepository
• EditorialMediaRepository, EditorialMediaUpload
• EditorSession, EditorPermission
• EditorialValidationMode, EditorialValidationIssue, EditorialValidationOptions, validateEditorialPostInput
• filterPostsByCategory, filterPostsByTag
• listRelatedPosts
• createPaginationMeta, paginateItems
• estimateReadingTime
• toBlogPostSummary, toBlogPost

Example

import {
  filterPostsByTag,
  paginateItems,
  toBlogPostSummary
} from "blog-kit-core";

const summaries = posts.map((post) => toBlogPostSummary(post, siteConfig));
const taggedPosts = filterPostsByTag(posts, "nextjs");
const page = paginateItems(summaries, { page: 1, pageSize: 6 });

Editorial Validation

Use validateEditorialPostInput before persisting drafts, publishing posts, or scheduling future publication from a host app:

import { validateEditorialPostInput } from "blog-kit-core";

const issues = validateEditorialPostInput(post, "publish");
const blockingIssues = issues.filter((issue) => issue.severity === "error");

Supported modes are:

• draft: checks the title and slug fields needed for safe editorial persistence.
• publish: adds public-readiness checks for excerpt, content, and categories.
• schedule: applies publish checks and requires publishedAt to be a valid future timestamp.

Host apps can pass a deterministic clock when validating scheduled posts:

const issues = validateEditorialPostInput(post, "schedule", {
  now: new Date("2026-05-29T10:00:00.000Z")
});

Validation issues are structured with field, severity, and message, so editor UIs can map issues to controls without parsing message text.

Design Boundary

Use this package as the lowest-level dependency in your blog stack.

Keep app routes, provider clients, framework helpers, and visual components outside the core. Those belong in host apps or adapter packages.