@gravito/monolith 1.0.0-alpha.2

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@gravito/monolith",
+  "version": "1.0.0-alpha.2",
+  "description": "Content management and Markdown rendering orbit for Gravito",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target node",
+    "test": "bun test"
+  },
+  "keywords": [
+    "gravito",
+    "orbit",
+    "content",
+    "markdown",
+    "cms"
+  ],
+  "author": "Carl Lee <carllee0520@gmail.com>",
+  "license": "MIT",
+  "peerDependencies": {
+    "gravito-core": "1.0.0-beta.2"
+  },
+  "dependencies": {
+    "marked": "^11.1.1",
+    "gray-matter": "^4.0.3"
+  },
+  "devDependencies": {
+    "bun-types": "latest",
+    "@types/marked": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://github.com/gravito-framework/gravito#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gravito-framework/gravito.git",
+    "directory": "packages/monolith"
+  }
+}

package/src/ContentManager.ts

@@ -0,0 +1,116 @@
+import { readdir, readFile, stat } from 'node:fs/promises'
+import { join, parse } from 'node:path'
+import matter from 'gray-matter'
+import { marked } from 'marked'
+
+export interface ContentItem {
+  slug: string
+  body: string // The HTML content
+  excerpt?: string
+  // biome-ignore lint/suspicious/noExplicitAny: Frontmatter can be anything
+  meta: Record<string, any> // Frontmatter data
+  raw: string // The raw markdown
+}
+
+export interface CollectionConfig {
+  path: string // e.g., 'resources/content/docs'
+}
+
+export class ContentManager {
+  private collections = new Map<string, CollectionConfig>()
+  // Simple memory cache: collection:locale:slug -> ContentItem
+  private cache = new Map<string, ContentItem>()
+
+  constructor(private rootDir: string) {}
+
+  /**
+   * Register a new content collection
+   */
+  defineCollection(name: string, config: CollectionConfig) {
+    this.collections.set(name, config)
+  }
+
+  /**
+   * Find a single content item
+   * @param collectionName The collection name (e.g. 'docs')
+   * @param slug The file slug (e.g. 'installation')
+   * @param locale The locale (e.g. 'en')
+   */
+  async find(collectionName: string, slug: string, locale = 'en'): Promise<ContentItem | null> {
+    const config = this.collections.get(collectionName)
+    if (!config) {
+      throw new Error(`Collection '${collectionName}' not defined`)
+    }
+
+    const cacheKey = `${collectionName}:${locale}:${slug}`
+    if (this.cache.has(cacheKey)) {
+      return this.cache.get(cacheKey)!
+    }
+
+    // Determine path strategy
+    // Strategy: {root}/{path}/{locale}/{slug}.md
+    const filePath = join(this.rootDir, config.path, locale, `${slug}.md`)
+
+    try {
+      const exists = await stat(filePath)
+        .then(() => true)
+        .catch(() => false)
+      if (!exists) {
+        return null
+      }
+
+      const fileContent = await readFile(filePath, 'utf-8')
+      const { data, content, exemption } = matter(fileContent)
+
+      const html = await marked.parse(content)
+
+      const item: ContentItem = {
+        slug,
+        body: html,
+        meta: data,
+        raw: content,
+        excerpt: exemption,
+      }
+
+      this.cache.set(cacheKey, item)
+      return item
+    } catch (e) {
+      console.error(`[Orbit-Content] Error reading file: ${filePath}`, e)
+      return null
+    }
+  }
+
+  /**
+   * List all items in a collection for a locale
+   * Useful for generating sitemaps or index pages
+   */
+  async list(collectionName: string, locale = 'en'): Promise<ContentItem[]> {
+    const config = this.collections.get(collectionName)
+    if (!config) {
+      throw new Error(`Collection '${collectionName}' not defined`)
+    }
+
+    const dirPath = join(this.rootDir, config.path, locale)
+
+    try {
+      const files = await readdir(dirPath)
+      const items: ContentItem[] = []
+
+      for (const file of files) {
+        if (!file.endsWith('.md')) {
+          continue
+        }
+        const slug = parse(file).name
+        const item = await this.find(collectionName, slug, locale)
+        if (item) {
+          items.push(item)
+        }
+      }
+
+      return items
+    } catch (_e) {
+      // Directory likely doesn't exist for this locale
+      return []
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,42 @@
+import type { GravitoOrbit, PlanetCore } from 'gravito-core'
+import { type CollectionConfig, ContentManager } from './ContentManager'
+
+declare module 'gravito-core' {
+  interface Variables {
+    content: ContentManager
+  }
+}
+
+export interface ContentConfig {
+  root?: string // Defaults to process.cwd()
+  collections?: Record<string, CollectionConfig>
+}
+
+export class OrbitMonolith implements GravitoOrbit {
+  constructor(private config: ContentConfig = {}) {}
+
+  install(core: PlanetCore): void {
+    const root = this.config.root || process.cwd()
+    const manager = new ContentManager(root)
+
+    // Register Collections from Config
+    if (this.config.collections) {
+      for (const [name, config] of Object.entries(this.config.collections)) {
+        manager.defineCollection(name, config)
+      }
+    }
+
+    // Register Default 'docs' and 'blog' if folders exist?
+    // Let's stick to explicit configuration for now to avoid magic.
+
+    // Inject into request context
+    core.adapter.use('*', async (c, next) => {
+      c.set('content', manager)
+      await next()
+    })
+
+    core.logger.info('Orbit Monolith installed ⬛️')
+  }
+}
+
+export * from './ContentManager'

package/tests/content.test.ts

@@ -0,0 +1,41 @@
+import { describe, expect, test } from 'bun:test'
+import { join } from 'node:path'
+import { ContentManager } from '../src/ContentManager'
+
+describe('Orbit Content Manager', () => {
+  const rootDir = join(import.meta.dir, 'fixtures')
+  const manager = new ContentManager(rootDir)
+
+  manager.defineCollection('docs', {
+    path: 'docs',
+  })
+
+  test('it reads markdown content with frontmatter', async () => {
+    const item = await manager.find('docs', 'install', 'en')
+
+    expect(item).not.toBeNull()
+    expect(item?.slug).toBe('install')
+    expect(item?.meta.title).toBe('Installation Guide')
+    expect(item?.body).toContain('<h1>Installation</h1>')
+    expect(item?.body).toContain('<pre><code class="language-bash">bun add @gravito/core')
+  })
+
+  test('it respects locale', async () => {
+    const item = await manager.find('docs', 'install', 'zh')
+
+    expect(item).not.toBeNull()
+    expect(item?.meta.title).toBe('安裝指南')
+    expect(item?.body).toContain('<h1>安裝</h1>')
+  })
+
+  test('it returns null for missing files', async () => {
+    const item = await manager.find('docs', 'missing', 'en')
+    expect(item).toBeNull()
+  })
+
+  test('it lists items in collection', async () => {
+    const items = await manager.list('docs', 'en')
+    expect(items.length).toBeGreaterThan(0)
+    expect(items[0].slug).toBe('install')
+  })
+})

package/tests/fixtures/docs/en/install.md

@@ -0,0 +1,13 @@
+---
+title: Installation Guide
+description: How to install Gravito
+date: 2024-01-01
+---
+
+# Installation
+
+To install Gravito, run:
+
+```bash
+bun add @gravito/core
+```

package/tests/fixtures/docs/zh/install.md

@@ -0,0 +1,13 @@
+---
+title: 安裝指南
+description: 如何安裝 Gravito
+date: 2024-01-01
+---
+
+# 安裝
+
+執行以下指令安裝：
+
+```bash
+bun add @gravito/core
+```

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+    "extends": "../../tsconfig.json",
+    "compilerOptions": {
+        "outDir": "./dist",
+        "baseUrl": ".",
+        "paths": {
+            "gravito-core": ["../../packages/core/src/index.ts"],
+            "@gravito/*": ["../../packages/*/src/index.ts"]
+        }
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist",
+        "**/*.test.ts"
+    ]
+}