@cyguin/docs 0.1.0

package/dist/types-0oOQLVHA.d.ts

@@ -0,0 +1,52 @@
+interface DocArticle {
+    id: string;
+    title: string;
+    body_md: string;
+    section: string;
+    article_order: number;
+    published_at: number | null;
+}
+interface CreateArticleInput {
+    title: string;
+    body_md: string;
+    section: string;
+    article_order: number;
+    published_at?: number | null;
+}
+interface UpdateArticleInput {
+    title?: string;
+    body_md?: string;
+}
+interface DocsAdapter {
+    list(params?: {
+        section?: string;
+        published?: boolean;
+    }): Promise<DocArticle[]>;
+    get(id: string): Promise<DocArticle | null>;
+    create(data: CreateArticleInput): Promise<DocArticle>;
+    update(id: string, data: Partial<UpdateArticleInput>): Promise<DocArticle>;
+    delete(id: string): Promise<void>;
+    reorder(id: string, newOrder: number): Promise<void>;
+    moveSection(id: string, newSection: string): Promise<void>;
+}
+interface DocsWidgetProps {
+    apiUrl?: string;
+    mode?: 'modal' | 'sidebar';
+    triggerLabel?: string;
+    defaultOpen?: boolean;
+    className?: string;
+}
+declare const defaultCssVars: {
+    readonly '--cyguin-docs-bg': "var(--cyguin-surface, #ffffff)";
+    readonly '--cyguin-docs-text': "var(--cyguin-text, #1a1a1a)";
+    readonly '--cyguin-docs-border': "var(--cyguin-border, #e5e5e5)";
+    readonly '--cyguin-docs-accent': "var(--cyguin-primary, #6366f1)";
+    readonly '--cyguin-docs-muted': "var(--cyguin-muted, #737373)";
+    readonly '--cyguin-docs-backdrop-opacity': "0.5";
+    readonly '--cyguin-docs-radius': "var(--cyguin-radius, 8px)";
+    readonly '--cyguin-docs-shadow': "var(--cyguin-shadow, 0 4px 24px rgba(0,0,0,0.12))";
+    readonly '--cyguin-docs-trigger-size': "48px";
+    readonly '--cyguin-docs-font': "var(--cyguin-font, system-ui, sans-serif)";
+};
+
+export { type DocsWidgetProps as D, type DocArticle as a, type DocsAdapter as b, defaultCssVars as d };

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@cyguin/docs",
+  "version": "0.1.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cyguin/docs"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./next": {
+      "types": "./dist/next.d.ts",
+      "default": "./dist/next.js"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "types": "dist/index.d.ts",
+  "peerDependencies": {
+    "next": ">=14",
+    "react": ">=18"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.0.0",
+    "marked": "^12.0.0",
+    "nanoid": "^5.0.0"
+  },
+  "scripts": {
+    "build": "tsup && cp src/styles.css dist/styles.css",
+    "dev": "tsup --watch"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "next": "^14.2.0",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.5.0"
+  }
+}

package/src/adapters/index.ts

@@ -0,0 +1 @@
+export { createSQLiteAdapter } from './sqlite'

package/src/adapters/sqlite.ts

@@ -0,0 +1,95 @@
+import Database from 'better-sqlite3'
+import { nanoid } from 'nanoid'
+import type { DocsAdapter, DocArticle, CreateArticleInput, UpdateArticleInput } from '../types'
+
+interface SQLiteAdapterOptions {
+  dbPath?: string
+}
+
+export function createSQLiteAdapter(options: SQLiteAdapterOptions = {}): DocsAdapter {
+  const db = new Database(options.dbPath ?? ':memory:')
+  db.pragma('journal_mode = WAL')
+
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS doc_articles (
+      id           TEXT PRIMARY KEY,
+      title        TEXT NOT NULL,
+      body_md      TEXT NOT NULL,
+      section      TEXT NOT NULL,
+      article_order INTEGER NOT NULL,
+      published_at INTEGER
+    );
+    CREATE INDEX IF NOT EXISTS idx_doc_articles_section_order ON doc_articles (section, article_order);
+  `)
+
+  function slugify(title: string): string {
+    return title.toLowerCase().replace(/\s+/g, '-').replace(/[^a-z0-9-]/g, '')
+  }
+
+  return {
+    async list({ section, published } = {}) {
+      let sql = 'SELECT * FROM doc_articles WHERE 1=1'
+      const params: unknown[] = []
+
+      if (section !== undefined) {
+        sql += ' AND section = ?'
+        params.push(section)
+      }
+
+      if (published === true) {
+        sql += ' AND published_at IS NOT NULL'
+      } else if (published === false) {
+        sql += ' AND published_at IS NULL'
+      }
+
+      sql += ' ORDER BY section, article_order'
+
+      const rows = db.prepare(sql).all(...params) as DocArticle[]
+      return rows
+    },
+
+    async get(id: string): Promise<DocArticle | null> {
+      const row = db.prepare('SELECT * FROM doc_articles WHERE id = ?').get(id) as DocArticle | undefined
+      return row ?? null
+    },
+
+    async create(data: CreateArticleInput): Promise<DocArticle> {
+      const id = nanoid()
+      const published_at = data.published_at ?? null
+
+      db.prepare(`
+        INSERT INTO doc_articles (id, title, body_md, section, article_order, published_at)
+        VALUES (?, ?, ?, ?, ?, ?)
+      `).run(id, data.title, data.body_md, data.section, data.article_order, published_at)
+
+      return { id, ...data, published_at }
+    },
+
+    async update(id: string, data: Partial<UpdateArticleInput>): Promise<DocArticle> {
+      const existing = await this.get(id)
+      if (!existing) {
+        throw new Error(`Article not found: ${id}`)
+      }
+
+      const updated = { ...existing, ...data }
+
+      db.prepare(`
+        UPDATE doc_articles SET title = ?, body_md = ? WHERE id = ?
+      `).run(updated.title, updated.body_md, id)
+
+      return updated
+    },
+
+    async delete(id: string): Promise<void> {
+      db.prepare('DELETE FROM doc_articles WHERE id = ?').run(id)
+    },
+
+    async reorder(id: string, newOrder: number): Promise<void> {
+      db.prepare('UPDATE doc_articles SET article_order = ? WHERE id = ?').run(newOrder, id)
+    },
+
+    async moveSection(id: string, newSection: string): Promise<void> {
+      db.prepare('UPDATE doc_articles SET section = ? WHERE id = ?').run(newSection, id)
+    },
+  }
+}

package/src/app/admin/docs/[...route]/route.ts

@@ -0,0 +1,31 @@
+import { createAdminHandler } from '../../../../handlers/admin'
+
+const handler = createAdminHandler({})
+
+export async function POST(
+  request: Request,
+  context: { params?: Record<string, string | string[]> }
+) {
+  return handler(request, context)
+}
+
+export async function PUT(
+  request: Request,
+  context: { params?: Record<string, string | string[]> }
+) {
+  return handler(request, context)
+}
+
+export async function PATCH(
+  request: Request,
+  context: { params?: Record<string, string | string[]> }
+) {
+  return handler(request, context)
+}
+
+export async function DELETE(
+  request: Request,
+  context: { params?: Record<string, string | string[]> }
+) {
+  return handler(request, context)
+}

package/src/app/api/docs/[...cyguin]/route.ts

@@ -0,0 +1,10 @@
+import { createDocsHandler } from '../../../../handlers/route'
+
+const handler = createDocsHandler({})
+
+export async function GET(
+  request: Request,
+  context: { params?: Record<string, string | string[]> }
+) {
+  return handler(request, context)
+}