@commonpub/server

Framework-agnostic business logic for CommonPub.

Overview

Consolidates all server-side business logic (content CRUD, social interactions, communities, learning, docs, federation, admin, audit) into a single package with no framework dependency. Server routes in apps/reference are thin wrappers that call into this package.

Installation

pnpm add @commonpub/server

Architecture

All functions accept explicit dependencies (database connection, config) rather than importing globals. This makes the logic testable and portable across frameworks.

import { createContent, getContentBySlug } from '@commonpub/server';

// Functions take (db, config, ...args) — no framework coupling
const content = await createContent(db, config, { title, type, authorId });
const published = await getContentBySlug(db, 'my-project', userId, 'alice');

Modules

| Module | Purpose | |--------|---------| | content | Content CRUD, publishing, view counts, federation hooks | | social | Likes, comments, bookmarks, follows, mentions | | hub | Hub CRUD (community/product/company), membership, posts, moderation, bans, invites | | learning | Paths, modules, lessons, enrollment, progress, certificates | | docs | Sites, versions, pages, navigation, search | | federation | Keypairs, actor resolution, follow management, content federation, hub mirroring | | admin | Platform stats, user management, reports, instance settings | | notification | Notification creation, listing, and real-time counts | | messaging | Conversations, direct messages, unread counts | | product | Product CRUD, content-product associations | | contest | Contest CRUD, entries, judging | | video | Video management and categories | | profile | User profile updates | | security | CSP builder, security headers | | oauthCodes | Authorization code store with TTL |

Dependencies

• @commonpub/schema — Table definitions and validators
• @commonpub/config — Feature flags and instance config
• @commonpub/auth — Auth types and guards
• @commonpub/protocol — AP protocol types
• @commonpub/docs — Docs rendering pipeline
• @commonpub/learning — Learning path engine
• drizzle-orm — Database queries

Development

pnpm build        # Compile TypeScript
pnpm test         # Run tests
pnpm typecheck    # Type-check without emitting