@beechcms/api 0.6.0-preview.1 → 0.6.0-preview.2

package/src/features/backrefs/backrefs.handler.ts

@@ -1,168 +1,168 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-/// <reference types="@cloudflare/workers-types" />
-import { Hono } from 'hono'
-import { resolvePolicies } from '@beechcms/core'
-import { publicProblem } from '../../public/problem-details'
-import type { AppEnv } from '../../types'
-import { D1BackrefRepository, type BackrefItem } from './d1-backref.repository'
-
-const PREVIEW_LIMIT = 3
-const DEFAULT_PAGE_LIMIT = 20
-const MAX_PAGE_LIMIT = 100
-
-export const backrefsApp = new Hono<AppEnv>()
-
-// ---------------------------------------------------------------------------
-// GET /content/:targetSlug/:targetId/backrefs
-// ---------------------------------------------------------------------------
-
-backrefsApp.get('/:targetSlug/:targetId/backrefs', async (c) => {
-  const targetSlug = c.req.param('targetSlug')
-  const targetId = c.req.param('targetId')
-  const groupParam = c.req.query('group')      // '<sourceSlug>:<branchAlias>'
-  const pageParam = c.req.query('page')
-  const limitParam = c.req.query('limit')
-
-  const getSeed = c.get('getSeed')
-  const backrefMap = c.get('backrefMap')
-  const backrefRepository = new D1BackrefRepository(c.env.DB)
-
-  // 1. Resolve target seed
-  const targetSeed = getSeed(targetSlug)
-  if (!targetSeed) {
-    return publicProblem(c, {
-      type: 'not-found',
-      title: 'Not Found',
-      status: 404,
-      detail: `Seed '${targetSlug}' does not exist`,
-    })
-  }
-
-  // 2. Verify targetId exists
-  const exists = await backrefRepository.entryExists(targetSlug, targetId)
-  if (!exists) {
-    return publicProblem(c, {
-      type: 'not-found',
-      title: 'Not Found',
-      status: 404,
-      detail: `Entry '${targetId}' not found in '${targetSlug}'`,
-    })
-  }
-
-  // 3. Get sources for this target
-  const sources = backrefMap.get(targetSlug)
-  if (!sources || sources.length === 0) {
-    return c.json({ groups: [] })
-  }
-
-  // 4. Pagination
-  const page = Math.max(1, Number.parseInt(pageParam ?? '1', 10) || 1)
-  const rawLimit = Number.parseInt(limitParam ?? String(DEFAULT_PAGE_LIMIT), 10) || DEFAULT_PAGE_LIMIT
-  const limit = Math.min(Math.max(1, rawLimit), MAX_PAGE_LIMIT)
-  const offset = (page - 1) * limit
-
-  // 5. Paginated single-group request
-  if (groupParam) {
-    const colonIdx = groupParam.indexOf(':')
-    if (colonIdx === -1) {
-      return publicProblem(c, {
-        type: 'bad-request',
-        title: 'Bad Request',
-        status: 400,
-        detail: `'group' must be '<sourceSlug>:<branchAlias>'`,
-      })
-    }
-    const sourceSlug = groupParam.slice(0, colonIdx)
-    const branchAlias = groupParam.slice(colonIdx + 1)
-
-    const source = sources.find(
-      s => s.sourceSlug === sourceSlug && s.branchAlias === branchAlias
-    )
-    if (!source) {
-      return publicProblem(c, {
-        type: 'not-found',
-        title: 'Not Found',
-        status: 404,
-        detail: `Back-ref group '${groupParam}' not found for target '${targetSlug}'`,
-      })
-    }
-
-    const sourceSeed = getSeed(sourceSlug)
-    if (!sourceSeed) {
-      return c.json({ groups: [] })
-    }
-
-    const { items, total } = await backrefRepository.queryGroup(source, sourceSeed, targetId, limit, offset)
-    const filteredItems = filterVisibility(items, sourceSeed)
-
-    return c.json({
-      groups: [{
-        sourceSlug: source.sourceSlug,
-        sourceLabel: sourceSeed.labelPlural ?? sourceSeed.label,
-        branchAlias: source.branchAlias,
-        branchLabel: source.branchLabel,
-        relationship: source.relationship,
-        restricts: source.restricts,
-        total,
-        items: filteredItems,
-      }],
-    })
-  }
-
-  // 6. Preview mode — all groups, PREVIEW_LIMIT each
-  const groupResults = await Promise.all(
-    sources.map(async (source) => {
-      const sourceSeed = getSeed(source.sourceSlug)
-      if (!sourceSeed) return null
-
-      const { items, total } = await backrefRepository.queryGroup(source, sourceSeed, targetId, PREVIEW_LIMIT, 0)
-      const filteredItems = filterVisibility(items, sourceSeed)
-
-      return {
-        sourceSlug: source.sourceSlug,
-        sourceLabel: sourceSeed.labelPlural ?? sourceSeed.label,
-        branchAlias: source.branchAlias,
-        branchLabel: source.branchLabel,
-        relationship: source.relationship,
-        restricts: source.restricts,
-        total,
-        items: filteredItems,
-      }
-    })
-  )
-
-  const groups = groupResults.filter(
-    (g): g is NonNullable<typeof g> => g !== null && g.total > 0
-  )
-
-  return c.json({ groups })
-})
-
-// ---------------------------------------------------------------------------
-// Internal helpers
-// ---------------------------------------------------------------------------
-
-function filterVisibility(
-  items: BackrefItem[],
-  sourceSeed: import('@beechcms/core').Seed
-): BackrefItem[] {
-  const displayBranch = sourceSeed.branches.find(
-    b => b.alias === sourceSeed.displayNameAlias
-  )
-  if (!displayBranch) return items
-
-  const { visibility } = resolvePolicies(displayBranch)
-  if (visibility === 'hidden') {
-    return items.map(item => ({ ...item, displayName: null }))
-  }
-  if (visibility === 'masked') {
-    return items.map(item => ({
-      ...item,
-      displayName: item.displayName ? '••••••••' : null,
-    }))
-  }
-  return items
-}
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
+// See LICENSE in the repository root for license terms.
+
+/// <reference types="@cloudflare/workers-types" />
+import { Hono } from 'hono'
+import { resolvePolicies } from '@beechcms/core'
+import { publicProblem } from '../../public/problem-details'
+import type { AppEnv } from '../../types'
+import { D1BackrefRepository, type BackrefItem } from './d1-backref.repository'
+
+const PREVIEW_LIMIT = 3
+const DEFAULT_PAGE_LIMIT = 20
+const MAX_PAGE_LIMIT = 100
+
+export const backrefsApp = new Hono<AppEnv>()
+
+// ---------------------------------------------------------------------------
+// GET /content/:targetSlug/:targetId/backrefs
+// ---------------------------------------------------------------------------
+
+backrefsApp.get('/:targetSlug/:targetId/backrefs', async (c) => {
+  const targetSlug = c.req.param('targetSlug')
+  const targetId = c.req.param('targetId')
+  const groupParam = c.req.query('group')      // '<sourceSlug>:<branchAlias>'
+  const pageParam = c.req.query('page')
+  const limitParam = c.req.query('limit')
+
+  const getSeed = c.get('getSeed')
+  const backrefMap = c.get('backrefMap')
+  const backrefRepository = new D1BackrefRepository(c.env.DB)
+
+  // 1. Resolve target seed
+  const targetSeed = getSeed(targetSlug)
+  if (!targetSeed) {
+    return publicProblem(c, {
+      type: 'not-found',
+      title: 'Not Found',
+      status: 404,
+      detail: `Seed '${targetSlug}' does not exist`,
+    })
+  }
+
+  // 2. Verify targetId exists
+  const exists = await backrefRepository.entryExists(targetSlug, targetId)
+  if (!exists) {
+    return publicProblem(c, {
+      type: 'not-found',
+      title: 'Not Found',
+      status: 404,
+      detail: `Entry '${targetId}' not found in '${targetSlug}'`,
+    })
+  }
+
+  // 3. Get sources for this target
+  const sources = backrefMap.get(targetSlug)
+  if (!sources || sources.length === 0) {
+    return c.json({ groups: [] })
+  }
+
+  // 4. Pagination
+  const page = Math.max(1, Number.parseInt(pageParam ?? '1', 10) || 1)
+  const rawLimit = Number.parseInt(limitParam ?? String(DEFAULT_PAGE_LIMIT), 10) || DEFAULT_PAGE_LIMIT
+  const limit = Math.min(Math.max(1, rawLimit), MAX_PAGE_LIMIT)
+  const offset = (page - 1) * limit
+
+  // 5. Paginated single-group request
+  if (groupParam) {
+    const colonIdx = groupParam.indexOf(':')
+    if (colonIdx === -1) {
+      return publicProblem(c, {
+        type: 'bad-request',
+        title: 'Bad Request',
+        status: 400,
+        detail: `'group' must be '<sourceSlug>:<branchAlias>'`,
+      })
+    }
+    const sourceSlug = groupParam.slice(0, colonIdx)
+    const branchAlias = groupParam.slice(colonIdx + 1)
+
+    const source = sources.find(
+      s => s.sourceSlug === sourceSlug && s.branchAlias === branchAlias
+    )
+    if (!source) {
+      return publicProblem(c, {
+        type: 'not-found',
+        title: 'Not Found',
+        status: 404,
+        detail: `Back-ref group '${groupParam}' not found for target '${targetSlug}'`,
+      })
+    }
+
+    const sourceSeed = getSeed(sourceSlug)
+    if (!sourceSeed) {
+      return c.json({ groups: [] })
+    }
+
+    const { items, total } = await backrefRepository.queryGroup(source, sourceSeed, targetId, limit, offset)
+    const filteredItems = filterVisibility(items, sourceSeed)
+
+    return c.json({
+      groups: [{
+        sourceSlug: source.sourceSlug,
+        sourceLabel: sourceSeed.labelPlural ?? sourceSeed.label,
+        branchAlias: source.branchAlias,
+        branchLabel: source.branchLabel,
+        relationship: source.relationship,
+        restricts: source.restricts,
+        total,
+        items: filteredItems,
+      }],
+    })
+  }
+
+  // 6. Preview mode — all groups, PREVIEW_LIMIT each
+  const groupResults = await Promise.all(
+    sources.map(async (source) => {
+      const sourceSeed = getSeed(source.sourceSlug)
+      if (!sourceSeed) return null
+
+      const { items, total } = await backrefRepository.queryGroup(source, sourceSeed, targetId, PREVIEW_LIMIT, 0)
+      const filteredItems = filterVisibility(items, sourceSeed)
+
+      return {
+        sourceSlug: source.sourceSlug,
+        sourceLabel: sourceSeed.labelPlural ?? sourceSeed.label,
+        branchAlias: source.branchAlias,
+        branchLabel: source.branchLabel,
+        relationship: source.relationship,
+        restricts: source.restricts,
+        total,
+        items: filteredItems,
+      }
+    })
+  )
+
+  const groups = groupResults.filter(
+    (g): g is NonNullable<typeof g> => g !== null && g.total > 0
+  )
+
+  return c.json({ groups })
+})
+
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+
+function filterVisibility(
+  items: BackrefItem[],
+  sourceSeed: import('@beechcms/core').Seed
+): BackrefItem[] {
+  const displayBranch = sourceSeed.branches.find(
+    b => b.alias === sourceSeed.displayNameAlias
+  )
+  if (!displayBranch) return items
+
+  const { visibility } = resolvePolicies(displayBranch)
+  if (visibility === 'hidden') {
+    return items.map(item => ({ ...item, displayName: null }))
+  }
+  if (visibility === 'masked') {
+    return items.map(item => ({
+      ...item,
+      displayName: item.displayName ? '••••••••' : null,
+    }))
+  }
+  return items
+}

package/src/features/backrefs/d1-backref.repository.ts

@@ -1,84 +1,84 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-/// <reference types="@cloudflare/workers-types" />
-import type { BackrefSource, Seed } from '@beechcms/core'
-
-export interface BackrefItem {
-  id: string
-  displayName: string | null
-  status: string
-  updated_at: number | null
-}
-
-export interface QueryGroupResult {
-  items: BackrefItem[]
-  total: number
-}
-
-export class D1BackrefRepository {
-  constructor(private readonly db: D1Database) {}
-
-  async entryExists(slug: string, id: string): Promise<boolean> {
-    const row = await this.db
-      .prepare(`SELECT id FROM content_${slug} WHERE id = ? LIMIT 1`)
-      .bind(id)
-      .first<{ id: string }>()
-    return row !== null
-  }
-
-  async queryGroup(
-    source: BackrefSource,
-    sourceSeed: Seed,
-    targetId: string,
-    limit: number,
-    offset: number,
-  ): Promise<QueryGroupResult> {
-    const displayCol = sourceSeed.displayNameAlias
-
-    if (source.relationship === 'single') {
-      const [rowsResult, countResult] = await Promise.all([
-        this.db
-          .prepare(
-            `SELECT id, status, updated_at, ${displayCol} AS displayName
-               FROM content_${source.sourceSlug}
-              WHERE ${source.branchAlias} = ?
-              ORDER BY updated_at DESC
-              LIMIT ? OFFSET ?`,
-          )
-          .bind(targetId, limit, offset)
-          .all<BackrefItem>(),
-        this.db
-          .prepare(
-            `SELECT COUNT(*) AS total FROM content_${source.sourceSlug} WHERE ${source.branchAlias} = ?`,
-          )
-          .bind(targetId)
-          .first<{ total: number }>(),
-      ])
-      return { items: rowsResult.results ?? [], total: countResult?.total ?? 0 }
-    }
-
-    const joinTable = `rel_${source.sourceSlug}_${source.branchAlias}`
-    const [rowsResult, countResult] = await Promise.all([
-      this.db
-        .prepare(
-          `SELECT c.id, c.status, c.updated_at, c.${displayCol} AS displayName
-             FROM content_${source.sourceSlug} c
-             JOIN ${joinTable} r ON r.parent_id = c.id
-            WHERE r.target_id = ?
-            ORDER BY c.updated_at DESC
-            LIMIT ? OFFSET ?`,
-        )
-        .bind(targetId, limit, offset)
-        .all<BackrefItem>(),
-      this.db
-        .prepare(
-          `SELECT COUNT(DISTINCT parent_id) AS total FROM ${joinTable} WHERE target_id = ?`,
-        )
-        .bind(targetId)
-        .first<{ total: number }>(),
-    ])
-    return { items: rowsResult.results ?? [], total: countResult?.total ?? 0 }
-  }
-}
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
+// See LICENSE in the repository root for license terms.
+
+/// <reference types="@cloudflare/workers-types" />
+import type { BackrefSource, Seed } from '@beechcms/core'
+
+export interface BackrefItem {
+  id: string
+  displayName: string | null
+  status: string
+  updated_at: number | null
+}
+
+export interface QueryGroupResult {
+  items: BackrefItem[]
+  total: number
+}
+
+export class D1BackrefRepository {
+  constructor(private readonly db: D1Database) {}
+
+  async entryExists(slug: string, id: string): Promise<boolean> {
+    const row = await this.db
+      .prepare(`SELECT id FROM content_${slug} WHERE id = ? LIMIT 1`)
+      .bind(id)
+      .first<{ id: string }>()
+    return row !== null
+  }
+
+  async queryGroup(
+    source: BackrefSource,
+    sourceSeed: Seed,
+    targetId: string,
+    limit: number,
+    offset: number,
+  ): Promise<QueryGroupResult> {
+    const displayCol = sourceSeed.displayNameAlias
+
+    if (source.relationship === 'single') {
+      const [rowsResult, countResult] = await Promise.all([
+        this.db
+          .prepare(
+            `SELECT id, status, updated_at, ${displayCol} AS displayName
+               FROM content_${source.sourceSlug}
+              WHERE ${source.branchAlias} = ?
+              ORDER BY updated_at DESC
+              LIMIT ? OFFSET ?`,
+          )
+          .bind(targetId, limit, offset)
+          .all<BackrefItem>(),
+        this.db
+          .prepare(
+            `SELECT COUNT(*) AS total FROM content_${source.sourceSlug} WHERE ${source.branchAlias} = ?`,
+          )
+          .bind(targetId)
+          .first<{ total: number }>(),
+      ])
+      return { items: rowsResult.results ?? [], total: countResult?.total ?? 0 }
+    }
+
+    const joinTable = `rel_${source.sourceSlug}_${source.branchAlias}`
+    const [rowsResult, countResult] = await Promise.all([
+      this.db
+        .prepare(
+          `SELECT c.id, c.status, c.updated_at, c.${displayCol} AS displayName
+             FROM content_${source.sourceSlug} c
+             JOIN ${joinTable} r ON r.parent_id = c.id
+            WHERE r.target_id = ?
+            ORDER BY c.updated_at DESC
+            LIMIT ? OFFSET ?`,
+        )
+        .bind(targetId, limit, offset)
+        .all<BackrefItem>(),
+      this.db
+        .prepare(
+          `SELECT COUNT(DISTINCT parent_id) AS total FROM ${joinTable} WHERE target_id = ?`,
+        )
+        .bind(targetId)
+        .first<{ total: number }>(),
+    ])
+    return { items: rowsResult.results ?? [], total: countResult?.total ?? 0 }
+  }
+}

package/src/features/backrefs/index.ts

@@ -1,5 +1,5 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-export { backrefsApp } from './backrefs.handler'
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
+// See LICENSE in the repository root for license terms.
+
+export { backrefsApp } from './backrefs.handler'

package/src/features/content/constants.ts

@@ -1,16 +1,16 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-export const CONTENT_ERRORS = {
-  INVALID_SLUG: 'Invalid slug',
-  INVALID_SLUG_OR_ID: 'Invalid slug or id',
-  INVALID_JSON_BODY: 'Invalid JSON body',
-  NOT_FOUND: 'Not found',
-  SEED_NOT_FOUND: 'Seed not found',
-  DATABASE_ERROR: 'Database error',
-  SLUG_CONFLICT: 'Slug already exists for this schema',
-  SENSITIVE_FIELD_EDIT: 'Cannot edit sensitive fields',
-  BULK_SIZE_EXCEEDED: 'Cannot edit more than 500 entries at once',
-  FIELD_NOT_BULK_EDITABLE: 'Field cannot be bulk-edited',
-} as const
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
+// See LICENSE in the repository root for license terms.
+
+export const CONTENT_ERRORS = {
+  INVALID_SLUG: 'Invalid slug',
+  INVALID_SLUG_OR_ID: 'Invalid slug or id',
+  INVALID_JSON_BODY: 'Invalid JSON body',
+  NOT_FOUND: 'Not found',
+  SEED_NOT_FOUND: 'Seed not found',
+  DATABASE_ERROR: 'Database error',
+  SLUG_CONFLICT: 'Slug already exists for this schema',
+  SENSITIVE_FIELD_EDIT: 'Cannot edit sensitive fields',
+  BULK_SIZE_EXCEEDED: 'Cannot edit more than 500 entries at once',
+  FIELD_NOT_BULK_EDITABLE: 'Field cannot be bulk-edited',
+} as const