@core / site

1.1.0 ▾

1.1.0

已验证MIT

GitHub

站点设置、可编辑的多级菜单，以及防循环和开放重定向的重定向管理

代码10 个文件上下文约 583 个 token扫描通过

约 583 个 token→ src/lib/site/AGENTS.md→ .cursor/rules/genpm-core-site.mdc

这正是你的 AI 在 src/lib/site 中工作时读取的内容。不会向其上下文添加其他任何内容。

@core/site — rules for AI agents

Purpose

What every site has: settings (name, logo, contact, social profiles, legal page paths) as a @core/content singleton, editable menus up to 3 levels as a content collection (slug = location: header, footer), and redirects managed from the admin with loop detection, safe targets (site paths or https to allowed hosts) and hit counters. No page content, no SEO tags (@core/seo reads these settings).

Map

index.ts — public API: getSiteSettings, getMenu, upsertRedirect (by from), updateRedirect (by id), resolveRedirect, redirectResponse, siteAdminResources.
content.ts — siteSettings, menus and their schemas. redirects.ts — redirect logic. links.ts — link validation.
adapters/hono.ts — redirectMiddleware. adapters/next.ts — redirectFor(req).

Integration

Env: SITE_URL (https://example.com), optional SITE_REDIRECT_HOSTS (comma-separated external hosts allowed as redirect targets). Migrations as in src/lib/db/AGENTS.md.
Import this module once at startup (it registers the site_settings and menus content definitions).
Seed initial values with seedEntry (@core/content): settings and the header/footer menus, using the site's current ones.
Render: const settings = await getSiteSettings({ locale }), const items = await getMenu('header', { locale }).
Redirects: Hono app.use(redirectMiddleware); Next.js middleware.ts with runtime: 'nodejs' calling redirectFor(req).
Add ...siteAdminResources() to src/genpm/admin.ts.
Verify: create a redirect /old → /new and request /old (301 to /new).

Conventions

Menu links are site paths, https://, mailto: or tel:; open external links with rel="noopener".
Redirect sources are exact paths without query; the incoming query string is preserved.
Permissions: site_settings:*, menus:*, redirects:read|create|update|delete.

Don't

Don't hardcode the site name, logo or menus in components once this module is installed.
Don't build redirects from user input; only from the admin through upsertRedirect / updateRedirect. Editing changes that row by id and fails with invalid_path (422) if the new from belongs to another redirect.
Don't put legal text here; only the paths of the legal pages.

# @core/site — rules for AI agents

## Purpose
What every site has: settings (name, logo, contact, social profiles, legal page paths) as a @core/content singleton,
editable menus up to 3 levels as a content collection (slug = location: `header`, `footer`), and redirects managed
from the admin with loop detection, safe targets (site paths or https to allowed hosts) and hit counters.
No page content, no SEO tags (@core/seo reads these settings).

## Map
- `index.ts` — public API: `getSiteSettings`, `getMenu`, `upsertRedirect` (by `from`), `updateRedirect` (by id), `resolveRedirect`, `redirectResponse`, `siteAdminResources`.
- `content.ts` — `siteSettings`, `menus` and their schemas. `redirects.ts` — redirect logic. `links.ts` — link validation.
- `adapters/hono.ts` — `redirectMiddleware`. `adapters/next.ts` — `redirectFor(req)`.

## Integration
1. Env: `SITE_URL` (`https://example.com`), optional `SITE_REDIRECT_HOSTS` (comma-separated external hosts allowed as redirect targets). Migrations as in `src/lib/db/AGENTS.md`.
2. Import this module once at startup (it registers the `site_settings` and `menus` content definitions).
3. Seed initial values with `seedEntry` (@core/content): settings and the `header`/`footer` menus, using the site's current ones.
4. Render: `const settings = await getSiteSettings({ locale })`, `const items = await getMenu('header', { locale })`.
5. Redirects: Hono `app.use(redirectMiddleware)`; Next.js `middleware.ts` with `runtime: 'nodejs'` calling `redirectFor(req)`.
6. Add `...siteAdminResources()` to `src/genpm/admin.ts`.
7. Verify: create a redirect `/old → /new` and request `/old` (301 to `/new`).

## Conventions
- Menu links are site paths, `https://`, `mailto:` or `tel:`; open external links with `rel="noopener"`.
- Redirect sources are exact paths without query; the incoming query string is preserved.
- Permissions: `site_settings:*`, `menus:*`, `redirects:read|create|update|delete`.

## Don't
- Don't hardcode the site name, logo or menus in components once this module is installed.
- Don't build redirects from user input; only from the admin through `upsertRedirect` / `updateRedirect`. Editing changes that row by id and fails with `invalid_path` (422) if the new `from` belongs to another redirect.
- Don't put legal text here; only the paths of the legal pages.

应用 .genpmignore 后将被注入的确切目录树。固定于

src/lib/site/adapters/next.ts只读 · b7c13fa

// Adaptador Next.js, sin importar `next`. En `middleware.ts` (runtime Node, Next ≥ 15.5):
//   import { redirectFor } from '@/lib/site/adapters/next';
//   export async function middleware(req: Request) { return (await redirectFor(req)) ?? undefined; }
//   export const config = { runtime: 'nodejs', matcher: ['/((?!_next|api|favicon.ico).*)'] };
// Sin middleware Node: llama a `redirectFor` desde `app/not-found.tsx` o desde un catch-all antes del 404.
import { redirectResponse } from '../index.ts';

export async function redirectFor(req: Request): Promise<Response | null> {
  if (req.method !== 'GET' && req.method !== 'HEAD') return null;
  return redirectResponse(req);
}