@jasonshimmy/vite-plugin-cer-app 0.23.1 → 0.24.0

package/src/__tests__/runtime/use-content.test.ts

@@ -1,226 +0,0 @@
-/**
- * Tests for queryContent() composable and QueryBuilder.
- *
- * Covers:
- * - Server-side path: reads from globalThis.__CER_CONTENT_STORE__
- * - .where() predicate filtering
- * - .sortBy() sorting
- * - .limit() and .skip() pagination
- * - .find() returns ContentMeta[]
- * - .count() returns number
- * - .first() returns ContentItem (direct path fetch fast path)
- * - .first() with filters (slow path through manifest)
- * - prefix scoping
- * - empty results
- */
-
-import { describe, it, expect, beforeEach, afterEach } from 'vitest'
-import type { ContentItem } from '../../types/content.js'
-
-const g = globalThis as Record<string, unknown>
-
-const STORE: ContentItem[] = [
-  {
-    _path: '/blog/hello',
-    _file: 'blog/hello.md',
-    _type: 'markdown',
-    title: 'Hello World',
-    description: 'First post',
-    date: '2026-04-03',
-    draft: false,
-    body: '<p>Hello</p>',
-    toc: [],
-  },
-  {
-    _path: '/blog/world',
-    _file: 'blog/world.md',
-    _type: 'markdown',
-    title: 'World Post',
-    description: 'Second post',
-    date: '2026-04-10',
-    draft: true,
-    body: '<p>World</p>',
-    toc: [],
-  },
-  {
-    _path: '/about',
-    _file: 'about.md',
-    _type: 'markdown',
-    title: 'About',
-    body: '<p>About</p>',
-    toc: [],
-  },
-  {
-    _path: '/blog',
-    _file: 'blog/index.md',
-    _type: 'markdown',
-    title: 'Blog',
-    body: '<p>Blog index</p>',
-    toc: [],
-  },
-]
-
-function setup() {
-  g['__CER_CONTENT_STORE__'] = STORE
-}
-
-function teardown() {
-  delete g['__CER_CONTENT_STORE__']
-}
-
-describe('queryContent() — .find()', () => {
-  beforeEach(setup)
-  afterEach(teardown)
-
-  it('returns all items when no prefix', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const result = await queryContent().find()
-    expect(result).toHaveLength(STORE.length)
-  })
-
-  it('filters by prefix — exact match', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const result = await queryContent('/about').find()
-    expect(result).toHaveLength(1)
-    expect(result[0]._path).toBe('/about')
-  })
-
-  it('filters by prefix — includes children', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const result = await queryContent('/blog').find()
-    expect(result.map((r) => r._path).sort()).toEqual(['/blog', '/blog/hello', '/blog/world'])
-  })
-
-  it('.where() filters items', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const result = await queryContent('/blog').where((doc) => !doc.draft).find()
-    expect(result.every((r) => !r.draft)).toBe(true)
-    expect(result.some((r) => r._path === '/blog/world')).toBe(false)
-  })
-
-  it('.where() with date filter', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const result = await queryContent('/blog')
-      .where((doc) => typeof doc.date === 'string' && doc.date >= '2026-04-09')
-      .find()
-    expect(result).toHaveLength(1)
-    expect(result[0]._path).toBe('/blog/world')
-  })
-
-  it('.sortBy() ascending', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const result = await queryContent('/blog').sortBy('date').find()
-    const dates = result.filter((r) => r.date).map((r) => r.date as string)
-    expect(dates).toEqual([...dates].sort())
-  })
-
-  it('.sortBy() descending', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const result = await queryContent('/blog').sortBy('date', 'desc').find()
-    const dates = result.filter((r) => r.date).map((r) => r.date as string)
-    expect(dates).toEqual([...dates].sort().reverse())
-  })
-
-  it('.limit() caps results', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const result = await queryContent().limit(2).find()
-    expect(result).toHaveLength(2)
-  })
-
-  it('.skip() offsets results', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const all = await queryContent().find()
-    const skipped = await queryContent().skip(1).find()
-    expect(skipped).toHaveLength(all.length - 1)
-    expect(skipped[0]._path).toBe(all[1]._path)
-  })
-
-  it('chained .where().sortBy().limit()', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const result = await queryContent('/blog')
-      .where((doc) => !doc.draft)
-      .sortBy('date', 'desc')
-      .limit(1)
-      .find()
-    expect(result).toHaveLength(1)
-  })
-
-  it('returns ContentMeta — no body in results', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const result = await queryContent().find()
-    for (const item of result) {
-      expect('body' in item).toBe(false)
-    }
-  })
-
-  it('no prefix returns all items including those outside /blog', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const result = await queryContent().find()
-    expect(result.some((r) => r._path === '/about')).toBe(true)
-  })
-})
-
-describe('queryContent() — .count()', () => {
-  beforeEach(setup)
-  afterEach(teardown)
-
-  it('returns total count with no filters', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const count = await queryContent().count()
-    expect(count).toBe(STORE.length)
-  })
-
-  it('returns filtered count with .where()', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const count = await queryContent('/blog').where((doc) => !doc.draft).count()
-    // /blog index (no draft field) + /blog/hello (draft: false)
-    expect(count).toBe(2)
-  })
-})
-
-describe('queryContent() — .first()', () => {
-  beforeEach(setup)
-  afterEach(teardown)
-
-  it('fast path: fetches item directly by path', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const item = await queryContent('/about').first()
-    expect(item).not.toBeNull()
-    expect(item?._path).toBe('/about')
-    expect(item?.body).toBe('<p>About</p>')
-  })
-
-  it('fast path: returns null for unknown path', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const item = await queryContent('/does-not-exist').first()
-    expect(item).toBeNull()
-  })
-
-  it('slow path: applies .where() filter then fetches first match', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const item = await queryContent('/blog')
-      .where((doc) => !doc.draft)
-      .first()
-    expect(item).not.toBeNull()
-    expect(item?.draft).not.toBe(true)
-  })
-
-  it('returns full ContentItem with body and toc', async () => {
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    const item = await queryContent('/blog/hello').first()
-    expect(item?.body).toBeDefined()
-    expect(Array.isArray(item?.toc)).toBe(true)
-  })
-
-  it('returns null when no prefix is set and no store', async () => {
-    // Remove store temporarily
-    delete g['__CER_CONTENT_STORE__']
-    const { queryContent } = await import('../../runtime/composables/use-content.js')
-    // Without store, the client fetch path will run; since there's no real server, it may fail.
-    // Just verify it doesn't throw — result can be null.
-    const item = await queryContent('/about').first().catch(() => null)
-    expect(item === null || item === undefined || typeof item === 'object').toBe(true)
-    // Restore
-    g['__CER_CONTENT_STORE__'] = STORE
-  })
-})

package/src/__tests__/runtime/use-cookie.test.ts

@@ -1,277 +0,0 @@
-/**
- * @vitest-environment happy-dom
- */
-import { describe, it, expect, beforeEach, afterEach } from 'vitest'
-import type { IncomingMessage, ServerResponse } from 'node:http'
-import { AsyncLocalStorage } from 'node:async_hooks'
-import { useCookie } from '../../runtime/composables/use-cookie.js'
-
-// ─── Helpers ─────────────────────────────────────────────────────────────────
-
-function makeReqRes(cookieHeader = ''): { req: IncomingMessage; res: ServerResponse } {
-  const req = { headers: { cookie: cookieHeader } } as unknown as IncomingMessage
-  const headers: Record<string, string | string[]> = {}
-  const res = {
-    getHeader: (name: string) => headers[name.toLowerCase()],
-    setHeader(name: string, value: string | string[]) { headers[name.toLowerCase()] = value },
-  } as unknown as ServerResponse
-  return { req, res }
-}
-
-// ─── SSR path ─────────────────────────────────────────────────────────────────
-
-describe('useCookie — SSR (via AsyncLocalStorage)', () => {
-  const store = new AsyncLocalStorage<{ req: IncomingMessage; res: ServerResponse }>()
-
-  beforeEach(() => {
-    ;(globalThis as Record<string, unknown>)['__CER_REQ_STORE__'] = store
-  })
-
-  afterEach(() => {
-    delete (globalThis as Record<string, unknown>)['__CER_REQ_STORE__']
-  })
-
-  it('reads a cookie from the request', () => {
-    const { req, res } = makeReqRes('token=abc123; other=xyz')
-    store.run({ req, res }, () => {
-      const cookie = useCookie('token')
-      expect(cookie.value).toBe('abc123')
-    })
-  })
-
-  it('returns undefined for a missing cookie', () => {
-    const { req, res } = makeReqRes('other=xyz')
-    store.run({ req, res }, () => {
-      const cookie = useCookie('missing')
-      expect(cookie.value).toBeUndefined()
-    })
-  })
-
-  it('writes a Set-Cookie header on set()', () => {
-    const { req, res } = makeReqRes()
-    store.run({ req, res }, () => {
-      useCookie('session').set('s1')
-    })
-    const header = res.getHeader('Set-Cookie') as string[]
-    expect(header).toBeDefined()
-    const value = Array.isArray(header) ? header[0] : header
-    expect(value).toContain('session=s1')
-    expect(value).toContain('Path=/')
-    expect(value).toContain('SameSite=Lax')
-  })
-
-  it('defaults SameSite to Lax when no sameSite option is provided', () => {
-    const { req, res } = makeReqRes()
-    store.run({ req, res }, () => {
-      useCookie('tok').set('v')
-    })
-    const header = res.getHeader('Set-Cookie') as string[]
-    const value = Array.isArray(header) ? header[0] : header
-    expect(value).toContain('SameSite=Lax')
-  })
-
-  it('appends to existing Set-Cookie headers', () => {
-    const { req, res } = makeReqRes()
-    store.run({ req, res }, () => {
-      useCookie('a').set('1')
-      useCookie('b').set('2')
-    })
-    const header = res.getHeader('Set-Cookie') as string[]
-    expect(Array.isArray(header)).toBe(true)
-    expect(header).toHaveLength(2)
-    expect(header[0]).toContain('a=1')
-    expect(header[1]).toContain('b=2')
-  })
-
-  it('writes Max-Age=0 on remove()', () => {
-    const { req, res } = makeReqRes('session=old')
-    store.run({ req, res }, () => {
-      useCookie('session').remove()
-    })
-    const header = res.getHeader('Set-Cookie') as string[]
-    const value = Array.isArray(header) ? header[0] : header
-    expect(value).toContain('Max-Age=0')
-  })
-
-  it('forwards options (httpOnly, secure, sameSite) when setting', () => {
-    const { req, res } = makeReqRes()
-    store.run({ req, res }, () => {
-      useCookie('auth').set('tok', { httpOnly: true, secure: true, sameSite: 'Strict' })
-    })
-    const header = res.getHeader('Set-Cookie') as string[]
-    const value = Array.isArray(header) ? header[0] : header
-    expect(value).toContain('HttpOnly')
-    expect(value).toContain('Secure')
-    expect(value).toContain('SameSite=Strict')
-  })
-
-  it('forwards options (maxAge, path, domain) when removing', () => {
-    const { req, res } = makeReqRes('auth=tok')
-    store.run({ req, res }, () => {
-      useCookie('auth').remove({ path: '/app', domain: 'example.com' })
-    })
-    const header = res.getHeader('Set-Cookie') as string[]
-    const value = Array.isArray(header) ? header[0] : header
-    expect(value).toContain('Max-Age=0')
-    expect(value).toContain('Path=/app')
-    expect(value).toContain('Domain=example.com')
-  })
-
-  it('decodes percent-encoded cookie values', () => {
-    const { req, res } = makeReqRes(`msg=${encodeURIComponent('hello world')}`)
-    store.run({ req, res }, () => {
-      const cookie = useCookie('msg')
-      expect(cookie.value).toBe('hello world')
-    })
-  })
-
-  it('round-trips values with special characters (spaces, slashes, unicode)', () => {
-    const specialValue = 'hello world/path?q=1&r=2 ✓'
-    const { req, res } = makeReqRes(`special=${encodeURIComponent(specialValue)}`)
-    store.run({ req, res }, () => {
-      const cookie = useCookie('special')
-      expect(cookie.value).toBe(specialValue)
-    })
-  })
-
-  it('encodes special characters in Set-Cookie when setting a value', () => {
-    const { req, res } = makeReqRes()
-    const specialValue = 'hello world/path?q=1'
-    store.run({ req, res }, () => {
-      useCookie('data').set(specialValue)
-    })
-    const header = res.getHeader('Set-Cookie') as string[]
-    const cookieStr = Array.isArray(header) ? header[0] : header
-    // Value must be percent-encoded in the Set-Cookie header
-    expect(cookieStr).toContain(encodeURIComponent(specialValue))
-    expect(cookieStr).not.toContain(specialValue)
-  })
-
-  it('survives a malformed cookie segment without throwing', () => {
-    // A segment with no '=' should be skipped gracefully
-    const { req, res } = makeReqRes('broken; valid=ok; =noname')
-    store.run({ req, res }, () => {
-      const cookie = useCookie('valid')
-      expect(cookie.value).toBe('ok')
-      expect(useCookie('broken').value).toBeUndefined()
-    })
-  })
-
-  it('uses raw value when decodeURIComponent throws (malformed percent-encoding)', () => {
-    // '%ZZ' is invalid percent-encoding and causes decodeURIComponent to throw.
-    // The parser must fall back to the raw value instead of crashing.
-    const { req, res } = makeReqRes('bad=%ZZ; good=ok')
-    store.run({ req, res }, () => {
-      expect(useCookie('bad').value).toBe('%ZZ')
-      expect(useCookie('good').value).toBe('ok')
-    })
-  })
-
-  it('returns undefined value outside a store context', () => {
-    // store is registered but no run() context — getStore() returns null
-    const cookie = useCookie('x')
-    expect(cookie.value).toBeUndefined()
-  })
-
-  it('applies defaultOptions when no call-time options are passed to set()', () => {
-    const { req, res } = makeReqRes()
-    store.run({ req, res }, () => {
-      useCookie('auth', { httpOnly: true, secure: true, sameSite: 'Strict' }).set('tok')
-    })
-    const header = res.getHeader('Set-Cookie') as string[]
-    const value = Array.isArray(header) ? header[0] : header
-    expect(value).toContain('HttpOnly')
-    expect(value).toContain('Secure')
-    expect(value).toContain('SameSite=Strict')
-  })
-
-  it('call-time options override defaultOptions', () => {
-    const { req, res } = makeReqRes()
-    store.run({ req, res }, () => {
-      useCookie('pref', { sameSite: 'Strict', httpOnly: true }).set('v', { sameSite: 'Lax' })
-    })
-    const header = res.getHeader('Set-Cookie') as string[]
-    const value = Array.isArray(header) ? header[0] : header
-    // call-time sameSite: 'Lax' must win over the default 'Strict'
-    expect(value).toContain('SameSite=Lax')
-    expect(value).not.toContain('SameSite=Strict')
-    // defaultOptions httpOnly is still inherited
-    expect(value).toContain('HttpOnly')
-  })
-
-  it('defaultOptions are applied on remove() when no call-time options are passed', () => {
-    const { req, res } = makeReqRes('secure=tok')
-    store.run({ req, res }, () => {
-      useCookie('secure', { path: '/app', domain: 'example.com' }).remove()
-    })
-    const header = res.getHeader('Set-Cookie') as string[]
-    const value = Array.isArray(header) ? header[0] : header
-    expect(value).toContain('Max-Age=0')
-    expect(value).toContain('Path=/app')
-    expect(value).toContain('Domain=example.com')
-  })
-})
-
-// ─── Client path ──────────────────────────────────────────────────────────────
-
-describe('useCookie — client (document.cookie)', () => {
-  beforeEach(() => {
-    // Ensure no SSR store leaks into client tests
-    delete (globalThis as Record<string, unknown>)['__CER_REQ_STORE__']
-    // Clear document cookies
-    document.cookie.split(';').forEach((c) => {
-      const name = c.split('=')[0].trim()
-      if (name) document.cookie = `${name}=; Max-Age=0; Path=/`
-    })
-  })
-
-  it('reads a cookie set via document.cookie', () => {
-    document.cookie = 'theme=dark'
-    const cookie = useCookie('theme')
-    expect(cookie.value).toBe('dark')
-  })
-
-  it('returns undefined when the cookie is not set', () => {
-    const cookie = useCookie('nonexistent')
-    expect(cookie.value).toBeUndefined()
-  })
-
-  it('writes to document.cookie on set()', () => {
-    useCookie('lang').set('en')
-    const cookie = useCookie('lang')
-    expect(cookie.value).toBe('en')
-  })
-
-  it('removes a cookie on remove()', () => {
-    document.cookie = 'removeme=yes'
-    useCookie('removeme').remove()
-    const cookie = useCookie('removeme')
-    // After removal the cookie value should be empty or undefined
-    expect(cookie.value === undefined || cookie.value === '').toBe(true)
-  })
-
-  it('percent-encodes values with special characters', () => {
-    useCookie('data').set('hello world')
-    const raw = document.cookie
-    expect(raw).toContain('hello%20world')
-  })
-})
-
-// ─── Build-time / unknown context ─────────────────────────────────────────────
-
-describe('useCookie — unknown context (no store, no document)', () => {
-  it('returns undefined value and no-op set/remove when neither SSR nor client context is available', () => {
-    delete (globalThis as Record<string, unknown>)['__CER_REQ_STORE__']
-    // Simulate a non-browser, non-SSR context by verifying the composable
-    // falls through to the default branch (value === undefined, methods are no-ops).
-    // We can verify this by calling with a store that has no active context.
-    const store = new AsyncLocalStorage()
-    ;(globalThis as Record<string, unknown>)['__CER_REQ_STORE__'] = store
-    // getStore() returns null because we're outside a run() context
-    const cookie = useCookie('x')
-    expect(cookie.value).toBeUndefined()
-    expect(() => cookie.set('val')).not.toThrow()
-    expect(() => cookie.remove()).not.toThrow()
-    delete (globalThis as Record<string, unknown>)['__CER_REQ_STORE__']
-  })
-})