Hello world
')).toEqual([]); + }); + + it('extracts a single doc ID from a page-embed div', () => { + const html = ''; + expect(extractEmbedIds(html)).toEqual(['abc-123']); + }); + + it('extracts multiple doc IDs from multiple embed nodes', () => { + const html = [ + '', + 'Some text
', + '', + ].join('\n'); + expect(extractEmbedIds(html)).toEqual(['id-1', 'id-2']); + }); + + it('ignores elements without data-doc-id', () => { + const html = ''; + expect(extractEmbedIds(html)).toEqual([]); + }); +}); + +// --------------------------------------------------------------------------- +// Route handler β GET /api/docs/preview +// --------------------------------------------------------------------------- + +const { createSupabaseServerClient, createSupabaseAdminClient, getAuthContext } = vi.hoisted(() => ({ + createSupabaseServerClient: vi.fn(), + createSupabaseAdminClient: vi.fn(), + getAuthContext: vi.fn(), +})); + +const getDocPreviewMock = vi.fn(); + +vi.mock('@/lib/supabase/server', () => ({ createSupabaseServerClient })); +vi.mock('@/lib/supabase/admin', () => ({ createSupabaseAdminClient })); +vi.mock('@/lib/auth-helpers', () => ({ getAuthContext })); +vi.mock('@/services/docs', () => ({ + DocsService: class { + getDocPreview = getDocPreviewMock; + }, +})); + +// Supabase client stub for collectTransitiveEmbeds BFS (no embeds in target docs) +const fromMock = vi.fn().mockReturnValue({ + select: vi.fn().mockReturnThis(), + eq: vi.fn().mockReturnThis(), + in: vi.fn().mockResolvedValue({ data: [] }), +}); +const mockDbClient = { from: fromMock }; + +import { GET } from './route'; + +const mockAuth = { + id: 'team-member-1', + org_id: 'org-1', + project_id: 'project-1', + project_name: 'Test', + type: 'human' as const, + rateLimitExceeded: false, +}; + +describe('GET /api/docs/preview', () => { + beforeEach(() => { + createSupabaseServerClient.mockReset(); + createSupabaseAdminClient.mockReset(); + getAuthContext.mockReset(); + getDocPreviewMock.mockReset(); + fromMock.mockClear(); + + createSupabaseServerClient.mockResolvedValue(mockDbClient); + createSupabaseAdminClient.mockReturnValue(mockDbClient); + getAuthContext.mockResolvedValue(mockAuth); + }); + + it('returns 401 when not authenticated', async () => { + getAuthContext.mockResolvedValue(null); + const res = await GET(new Request('http://localhost/api/docs/preview?q=my-doc')); + expect(res.status).toBe(401); + }); + + it('returns 429 when rate limit exceeded', async () => { + getAuthContext.mockResolvedValue({ + ...mockAuth, + rateLimitExceeded: true, + rateLimitRemaining: 0, + rateLimitResetAt: 9999, + }); + const res = await GET(new Request('http://localhost/api/docs/preview?q=my-doc')); + expect(res.status).toBe(429); + }); + + it('returns 400 when q param is missing', async () => { + const res = await GET(new Request('http://localhost/api/docs/preview')); + expect(res.status).toBe(400); + }); + + it('returns 404 when document is not found', async () => { + getDocPreviewMock.mockResolvedValue(null); + const res = await GET(new Request('http://localhost/api/docs/preview?q=nonexistent')); + expect(res.status).toBe(404); + }); + + it('returns preview fields with empty embedChain when doc has no embeds', async () => { + getDocPreviewMock.mockResolvedValue({ + id: 'doc-abc', + title: 'My Doc', + icon: 'π', + slug: 'my-doc', + content: 'No embeds here
', + }); + + const res = await GET(new Request('http://localhost/api/docs/preview?q=my-doc')); + expect(res.status).toBe(200); + const body = await res.json(); + expect(body.data).toMatchObject({ + id: 'doc-abc', + title: 'My Doc', + icon: 'π', + slug: 'my-doc', + embedChain: [], + }); + }); + + it('accepts UUID as q param and passes it to service', async () => { + const uuid = '12345678-1234-1234-1234-123456789abc'; + getDocPreviewMock.mockResolvedValue({ + id: uuid, + title: 'UUID Doc', + icon: null, + slug: 'uuid-doc', + content: null, + }); + + const res = await GET(new Request(`http://localhost/api/docs/preview?q=${uuid}`)); + expect(res.status).toBe(200); + expect(getDocPreviewMock).toHaveBeenCalledWith('project-1', uuid); + }); + + it('accepts slug as q param and passes it to service', async () => { + getDocPreviewMock.mockResolvedValue({ + id: 'doc-xyz', + title: 'Slug Doc', + icon: null, + slug: 'my-slug', + content: null, + }); + + const res = await GET(new Request('http://localhost/api/docs/preview?q=my-slug')); + expect(res.status).toBe(200); + expect(getDocPreviewMock).toHaveBeenCalledWith('project-1', 'my-slug'); + }); +}); diff --git a/apps/web/src/app/api/docs/preview/route.ts b/apps/web/src/app/api/docs/preview/route.ts new file mode 100644 index 0000000..53a5066 --- /dev/null +++ b/apps/web/src/app/api/docs/preview/route.ts @@ -0,0 +1,104 @@ +import { createSupabaseServerClient } from '@/lib/supabase/server'; +import { createSupabaseAdminClient } from '@/lib/supabase/admin'; +import { DocsService } from '@/services/docs'; +import { getAuthContext } from '@/lib/auth-helpers'; +import { apiSuccess, ApiErrors } from '@/lib/api-response'; +import { handleApiError } from '@/lib/api-error'; +import type { SupabaseClient } from '@supabase/supabase-js'; + +/** + * Extract all doc IDs referenced by page-embed nodes from an HTML string. + * Exported for unit testing. + */ +export function extractEmbedIds(html: string | null | undefined): string[] { + if (!html) return []; + const ids: string[] = []; + const regex = /data-doc-id="([^"]+)"/g; + let m: RegExpExecArray | null; + while ((m = regex.exec(html)) !== null) { + if (m[1]) ids.push(m[1]); + } + return ids; +} + +/** + * BFS over the embed graph starting from `startDocId`, collecting all + * transitively-embedded doc IDs (up to `maxDepth` hops). + * Used to detect indirect circular embeds (AβBβA). + */ +async function collectTransitiveEmbeds( + supabase: SupabaseClient, + projectId: string, + startDocId: string, + maxDepth = 5, +): Promise+ {doc.title} +
+/{doc.slug}
+