@beechcms/api 0.4.2 → 0.5.0

package/src/public/public-read.ts

@@ -1,59 +1,59 @@
-import type { Context } from 'hono'
-import { cleanStr } from '../shared/query-utils'
-import { checkPublicOperation } from './access-policy'
-import { publicProblem, internalErrorDetail } from './problem-details'
-import { resolveEdgeCache, withCachedResponse } from './cache-utils'
-import { readSingleEntry } from './read-single'
-import { readListEntries } from './read-list'
-import { AppEnv } from '../types'
-
-export async function publicReadHandler(context: Context<AppEnv>) {
-  const seedSlug = context.req.param('seed') ?? ''
-  const seed = context.get('getSeed')(seedSlug)
-  if (!seed) {
-    const available = context.get('seedRegistry').all().map(s => s.slug).join(', ')
-    return publicProblem(context, {
-      type: 'seed-not-found',
-      title: 'Seed Not Found',
-      status: 404,
-      detail: `The content type '${seedSlug}' does not exist. Available types: ${available}.`,
-    })
-  }
-
-  const access = checkPublicOperation(seed, 'read')
-  if (!access.ok) {
-    return publicProblem(context, { type: 'operation-not-allowed', title: access.error.error, status: 403, detail: access.error.message })
-  }
-
-  const edgeCache = resolveEdgeCache(context)
-  const cacheKey = context.req.raw
-  if (edgeCache) {
-    const hit = await edgeCache.cache.match(cacheKey)
-    if (hit) return hit
-  }
-
-  const query = context.req.query()
-  const id = cleanStr(query.id)
-  const slug = cleanStr(query.slug)
-  const publishedOnly = context.env.PUBLIC_PUBLISHED_ONLY !== 'false'
-  const repository = context.get('repository')
-
-  try {
-    if (id || slug) {
-      const result = await readSingleEntry({ seed, seedSlug, repository, id, slug, publishedOnly, fieldsParam: query.fields })
-      if (!result.ok) {
-        return publicProblem(context, { type: 'entry-not-found', title: 'Not Found', status: 404, detail: result.detail })
-      }
-      return withCachedResponse(edgeCache, cacheKey, context.json({ data: result.data, meta: result.meta }, 200))
-    }
-
-    const result = await readListEntries({ seed, seedSlug, repository, query, publishedOnly })
-    return withCachedResponse(edgeCache, cacheKey, context.json(result, 200))
-  } catch (error) {
-    if (error instanceof Error && error.message.startsWith('Invalid filter:')) {
-      return publicProblem(context, { type: 'invalid-filter', title: 'Bad Request', status: 400, detail: error.message })
-    }
-    console.error('Public read error:', error)
-    return publicProblem(context, { type: 'internal-server-error', title: 'Internal Server Error', status: 500, detail: internalErrorDetail(context.env, error) })
-  }
-}
+import type { Context } from 'hono'
+import { cleanStr } from '../shared/query-utils'
+import { checkPublicOperation } from './access-policy'
+import { publicProblem, internalErrorDetail } from './problem-details'
+import { resolveEdgeCache, withCachedResponse } from './cache-utils'
+import { readSingleEntry } from './read-single'
+import { readListEntries } from './read-list'
+import { AppEnv } from '../types'
+
+export async function publicReadHandler(context: Context<AppEnv>) {
+  const seedSlug = context.req.param('seed') ?? ''
+  const seed = context.get('getSeed')(seedSlug)
+  if (!seed) {
+    const available = context.get('seedRegistry').all().map(s => s.slug).join(', ')
+    return publicProblem(context, {
+      type: 'seed-not-found',
+      title: 'Seed Not Found',
+      status: 404,
+      detail: `The content type '${seedSlug}' does not exist. Available types: ${available}.`,
+    })
+  }
+
+  const access = checkPublicOperation(seed, 'read')
+  if (!access.ok) {
+    return publicProblem(context, { type: 'operation-not-allowed', title: access.error.error, status: 403, detail: access.error.message })
+  }
+
+  const edgeCache = resolveEdgeCache(context)
+  const cacheKey = context.req.raw
+  if (edgeCache) {
+    const hit = await edgeCache.cache.match(cacheKey)
+    if (hit) return hit
+  }
+
+  const query = context.req.query()
+  const id = cleanStr(query.id)
+  const slug = cleanStr(query.slug)
+  const publishedOnly = context.env.PUBLIC_PUBLISHED_ONLY !== 'false'
+  const repository = context.get('repository')
+
+  try {
+    if (id || slug) {
+      const result = await readSingleEntry({ seed, seedSlug, repository, id, slug, publishedOnly, fieldsParam: query.fields })
+      if (!result.ok) {
+        return publicProblem(context, { type: 'entry-not-found', title: 'Not Found', status: 404, detail: result.detail })
+      }
+      return withCachedResponse(edgeCache, cacheKey, context.json({ data: result.data, meta: result.meta }, 200))
+    }
+
+    const result = await readListEntries({ seed, seedSlug, repository, query, publishedOnly })
+    return withCachedResponse(edgeCache, cacheKey, context.json(result, 200))
+  } catch (error) {
+    if (error instanceof Error && error.message.startsWith('Invalid filter:')) {
+      return publicProblem(context, { type: 'invalid-filter', title: 'Bad Request', status: 400, detail: error.message })
+    }
+    console.error('Public read error:', error)
+    return publicProblem(context, { type: 'internal-server-error', title: 'Internal Server Error', status: 500, detail: internalErrorDetail(context.env, error) })
+  }
+}

package/src/public/read-list.ts

@@ -1,50 +1,50 @@
-import type { Seed, ContentRepository } from '@beechcms/core'
-import { cleanStr } from '../shared/query-utils'
-import { toFlatPublicEntry } from './entry-projection'
-import { buildPublicListMeta } from './response-builder'
-import { parsePublicFilter, parsePublicPagination, parseLatestCount, toEngineFilters } from './query-builder'
-
-type ReadListInput = {
-  seed: Seed
-  seedSlug: string
-  repository: ContentRepository
-  query: Record<string, string | undefined>
-  publishedOnly: boolean
-}
-
-export async function readListEntries(input: ReadListInput) {
-  const { seed, seedSlug, repository, query, publishedOnly } = input
-
-  const parsedFilter = parsePublicFilter(query.filter)
-  const allMode = cleanStr(query.all)?.toLowerCase() === 'true'
-  const latestMode = cleanStr(query.latest) !== null
-  const latestCount = latestMode ? parseLatestCount(query.latest ?? '') : null
-  const pagination = allMode ? { page: 1, limit: 100 } : parsePublicPagination(query)
-  const offset = (pagination.page - 1) * pagination.limit
-  const search = cleanStr(query.search) ?? ''
-  const engineFilters = toEngineFilters(seed, parsedFilter)
-  const sortBy = cleanStr(query.orderBy) ?? 'created_at'
-  const sortDir = (cleanStr(query.orderDir) ?? 'desc').toLowerCase() === 'asc' ? 'ASC' : 'DESC'
-
-  const { items, total } = await repository.findMany(seed, {
-    filters: engineFilters,
-    search: search || undefined,
-    status: publishedOnly ? 'published' : null,
-    pagination: {
-      limit: latestMode ? (latestCount ?? 10) : pagination.limit,
-      offset: latestMode ? 0 : offset,
-    },
-    orderBy: latestMode ? { column: 'created_at', dir: 'DESC' } : { column: sortBy, dir: sortDir },
-  })
-
-  const data = items.map(item => toFlatPublicEntry(item, seed, query.fields))
-
-  if (latestMode) {
-    return { data, meta: { total, returned: data.length, seed: seedSlug } }
-  }
-
-  return {
-    data,
-    meta: buildPublicListMeta({ total, page: pagination.page, limit: pagination.limit, returned: data.length, seed: seedSlug }),
-  }
-}
+import type { Seed, ContentRepository } from '@beechcms/core'
+import { cleanStr } from '../shared/query-utils'
+import { toFlatPublicEntry } from './entry-projection'
+import { buildPublicListMeta } from './response-builder'
+import { parsePublicFilter, parsePublicPagination, parseLatestCount, toEngineFilters } from './query-builder'
+
+type ReadListInput = {
+  seed: Seed
+  seedSlug: string
+  repository: ContentRepository
+  query: Record<string, string | undefined>
+  publishedOnly: boolean
+}
+
+export async function readListEntries(input: ReadListInput) {
+  const { seed, seedSlug, repository, query, publishedOnly } = input
+
+  const parsedFilter = parsePublicFilter(query.filter)
+  const allMode = cleanStr(query.all)?.toLowerCase() === 'true'
+  const latestMode = cleanStr(query.latest) !== null
+  const latestCount = latestMode ? parseLatestCount(query.latest ?? '') : null
+  const pagination = allMode ? { page: 1, limit: 100 } : parsePublicPagination(query)
+  const offset = (pagination.page - 1) * pagination.limit
+  const search = cleanStr(query.search) ?? ''
+  const engineFilters = toEngineFilters(seed, parsedFilter)
+  const sortBy = cleanStr(query.orderBy) ?? 'created_at'
+  const sortDir = (cleanStr(query.orderDir) ?? 'desc').toLowerCase() === 'asc' ? 'ASC' : 'DESC'
+
+  const { items, total } = await repository.findMany(seed, {
+    filters: engineFilters,
+    search: search || undefined,
+    status: publishedOnly ? 'published' : null,
+    pagination: {
+      limit: latestMode ? (latestCount ?? 10) : pagination.limit,
+      offset: latestMode ? 0 : offset,
+    },
+    orderBy: latestMode ? { column: 'created_at', dir: 'DESC' } : { column: sortBy, dir: sortDir },
+  })
+
+  const data = items.map(item => toFlatPublicEntry(item, seed, query.fields))
+
+  if (latestMode) {
+    return { data, meta: { total, returned: data.length, seed: seedSlug } }
+  }
+
+  return {
+    data,
+    meta: buildPublicListMeta({ total, page: pagination.page, limit: pagination.limit, returned: data.length, seed: seedSlug }),
+  }
+}

package/src/public/read-single.ts

@@ -1,44 +1,44 @@
-import { EntryNotFoundError } from '@beechcms/core'
-import type { Seed, ContentRepository } from '@beechcms/core'
-import { toFlatPublicEntry } from './entry-projection'
-import { buildPublicSingleMeta } from './response-builder'
-
-type ReadSingleInput = {
-  seed: Seed
-  seedSlug: string
-  repository: ContentRepository
-  id: string | null
-  slug: string | null
-  publishedOnly: boolean
-  fieldsParam?: string
-}
-
-export type ReadSingleResult =
-  | { ok: true; data: Record<string, unknown>; meta: { seed: string } }
-  | { ok: false; detail: string }
-
-export async function readSingleEntry(input: ReadSingleInput): Promise<ReadSingleResult> {
-  const { seed, seedSlug, repository, id, slug, publishedOnly, fieldsParam } = input
-  const label = id ?? slug!
-
-  try {
-    const entry = id
-      ? await repository.findById(seed, id)
-      : await repository.findBySlug(seed, slug!)
-
-    if (publishedOnly && entry.status !== 'published') {
-      return { ok: false, detail: `Entry '${label}' not found or not published.` }
-    }
-
-    return {
-      ok: true,
-      data: toFlatPublicEntry(entry, seed, fieldsParam),
-      meta: buildPublicSingleMeta(seedSlug),
-    }
-  } catch (error) {
-    if (error instanceof EntryNotFoundError) {
-      return { ok: false, detail: `Entry '${label}' not found for content type '${seedSlug}'.` }
-    }
-    throw error
-  }
-}
+import { EntryNotFoundError } from '@beechcms/core'
+import type { Seed, ContentRepository } from '@beechcms/core'
+import { toFlatPublicEntry } from './entry-projection'
+import { buildPublicSingleMeta } from './response-builder'
+
+type ReadSingleInput = {
+  seed: Seed
+  seedSlug: string
+  repository: ContentRepository
+  id: string | null
+  slug: string | null
+  publishedOnly: boolean
+  fieldsParam?: string
+}
+
+export type ReadSingleResult =
+  | { ok: true; data: Record<string, unknown>; meta: { seed: string } }
+  | { ok: false; detail: string }
+
+export async function readSingleEntry(input: ReadSingleInput): Promise<ReadSingleResult> {
+  const { seed, seedSlug, repository, id, slug, publishedOnly, fieldsParam } = input
+  const label = id ?? slug!
+
+  try {
+    const entry = id
+      ? await repository.findById(seed, id)
+      : await repository.findBySlug(seed, slug!)
+
+    if (publishedOnly && entry.status !== 'published') {
+      return { ok: false, detail: `Entry '${label}' not found or not published.` }
+    }
+
+    return {
+      ok: true,
+      data: toFlatPublicEntry(entry, seed, fieldsParam),
+      meta: buildPublicSingleMeta(seedSlug),
+    }
+  } catch (error) {
+    if (error instanceof EntryNotFoundError) {
+      return { ok: false, detail: `Entry '${label}' not found for content type '${seedSlug}'.` }
+    }
+    throw error
+  }
+}

package/src/search-utils.ts

@@ -53,7 +53,7 @@ export function decodeCursor(cursor: string): { rank: number; entryId: string }
     const sep     = decoded.lastIndexOf(":")
     if (sep === -1) return null
     return {
-      rank:    parseFloat(decoded.slice(0, sep)),
+      rank:    Number.parseFloat(decoded.slice(0, sep)),
       entryId: decoded.slice(sep + 1),
     }
   } catch {

package/src/search.ts

@@ -18,7 +18,7 @@ searchRouter.get("/", async (c) => {
   const queryText  = c.req.query("q")?.trim() ?? ""
   const schemaSlug = c.req.query("schema_slug") ?? null
   const status     = c.req.query("status") ?? null
-  const rawLimit   = parseInt(c.req.query("limit") ?? "20", 10)
+  const rawLimit   = Number.parseInt(c.req.query("limit") ?? "20", 10)
   const limit      = Math.min(Math.max(rawLimit, 1), 50)
   const cursor     = c.req.query("cursor") ?? null