polen 0.10.0-next.13 → 0.10.0-next.15

package/src/lib/demos/config.test.ts

@@ -1,193 +0,0 @@
-import { readFileSync } from 'node:fs'
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
-import { DemoConfig, getDemoConfig, resetDemoConfig } from './config.ts'
-
-vi.mock('node:fs', () => ({
-  readFileSync: vi.fn(),
-}))
-
-// Mock the imported TypeScript config to prevent it from affecting tests
-vi.mock('../../../.github/demo-config.ts', () => ({
-  default: null,
-}))
-
-describe('DemoConfig', () => {
-  const mockReadFileSync = readFileSync as unknown as ReturnType<typeof vi.fn>
-
-  beforeEach(() => {
-    vi.clearAllMocks()
-  })
-
-  afterEach(() => {
-    // Reset singleton
-    resetDemoConfig()
-  })
-
-  describe('constructor', () => {
-    it('loads config from default path', () => {
-      mockReadFileSync.mockReturnValue(JSON.stringify({
-        excludeDemos: ['test1', 'test2'],
-        minimumPolenVersion: '1.0.0',
-        order: ['demo1', 'demo2'],
-      }))
-
-      const config = new DemoConfig()
-
-      expect(mockReadFileSync).toHaveBeenCalledWith('.github/demo-config.json', 'utf-8')
-      expect(config.excludeDemos).toEqual(['test1', 'test2'])
-      expect(config.minimumPolenVersion).toBe('1.0.0')
-      expect(config.order).toEqual(['demo1', 'demo2'])
-    })
-
-    it('loads config from custom path', () => {
-      mockReadFileSync.mockReturnValue('{}')
-
-      const config = new DemoConfig('custom/path')
-
-      expect(mockReadFileSync).toHaveBeenCalledWith('custom/path.json', 'utf-8')
-    })
-
-    it('uses defaults when config file is missing', () => {
-      mockReadFileSync.mockImplementation(() => {
-        throw new Error('File not found')
-      })
-
-      const config = new DemoConfig()
-
-      expect(config.excludeDemos).toEqual([])
-      expect(config.minimumPolenVersion).toBe('0.1.0')
-      expect(config.order).toEqual([])
-    })
-
-    it('supports legacy minimumVersion field', () => {
-      mockReadFileSync.mockReturnValue(JSON.stringify({
-        minimumVersion: '0.8.0', // old field name
-      }))
-
-      const config = new DemoConfig()
-
-      expect(config.minimumPolenVersion).toBe('0.8.0')
-    })
-
-    it('prefers minimumPolenVersion over minimumVersion', () => {
-      mockReadFileSync.mockReturnValue(JSON.stringify({
-        minimumVersion: '0.8.0',
-        minimumPolenVersion: '0.9.0',
-      }))
-
-      const config = new DemoConfig()
-
-      expect(config.minimumPolenVersion).toBe('0.9.0')
-    })
-  })
-
-  describe('meetsMinimumPolenVersion', () => {
-    it('returns true when version meets minimum', () => {
-      mockReadFileSync.mockReturnValue(JSON.stringify({
-        minimumPolenVersion: '1.0.0',
-      }))
-
-      const config = new DemoConfig()
-
-      expect(config.meetsMinimumPolenVersion('1.0.0')).toBe(true)
-      expect(config.meetsMinimumPolenVersion('1.0.1')).toBe(true)
-      expect(config.meetsMinimumPolenVersion('2.0.0')).toBe(true)
-    })
-
-    it('returns false when version is below minimum', () => {
-      mockReadFileSync.mockReturnValue(JSON.stringify({
-        minimumPolenVersion: '1.0.0',
-      }))
-
-      const config = new DemoConfig()
-
-      expect(config.meetsMinimumPolenVersion('0.9.0')).toBe(false)
-      expect(config.meetsMinimumPolenVersion('0.9.9')).toBe(false)
-    })
-
-    it('returns false for invalid versions', () => {
-      mockReadFileSync.mockReturnValue(JSON.stringify({
-        minimumPolenVersion: '1.0.0',
-      }))
-
-      const config = new DemoConfig()
-
-      expect(config.meetsMinimumPolenVersion('invalid')).toBe(false)
-      expect(config.meetsMinimumPolenVersion('')).toBe(false)
-    })
-  })
-
-  describe('isDemoExcluded', () => {
-    it('returns true for excluded demos', () => {
-      mockReadFileSync.mockReturnValue(JSON.stringify({
-        excludeDemos: ['demo1', 'demo2'],
-      }))
-
-      const config = new DemoConfig()
-
-      expect(config.isDemoExcluded('demo1')).toBe(true)
-      expect(config.isDemoExcluded('demo2')).toBe(true)
-    })
-
-    it('returns false for non-excluded demos', () => {
-      mockReadFileSync.mockReturnValue(JSON.stringify({
-        excludeDemos: ['demo1'],
-      }))
-
-      const config = new DemoConfig()
-
-      expect(config.isDemoExcluded('demo3')).toBe(false)
-    })
-  })
-
-  describe('getOrderedDemos', () => {
-    it('orders demos according to config', () => {
-      mockReadFileSync.mockReturnValue(JSON.stringify({
-        excludeDemos: ['excluded1'],
-        order: ['demo3', 'demo1'],
-      }))
-
-      const config = new DemoConfig()
-      const availableDemos = ['demo1', 'demo2', 'demo3', 'demo4', 'excluded1']
-
-      const ordered = config.getOrderedDemos(availableDemos)
-
-      expect(ordered).toEqual(['demo3', 'demo1', 'demo2', 'demo4'])
-    })
-
-    it('handles demos in order that are not available', () => {
-      mockReadFileSync.mockReturnValue(JSON.stringify({
-        order: ['demo1', 'nonexistent', 'demo2'],
-      }))
-
-      const config = new DemoConfig()
-      const availableDemos = ['demo1', 'demo2', 'demo3']
-
-      const ordered = config.getOrderedDemos(availableDemos)
-
-      expect(ordered).toEqual(['demo1', 'demo2', 'demo3'])
-    })
-  })
-
-  describe('getDemoConfig singleton', () => {
-    it('returns same instance on multiple calls', () => {
-      mockReadFileSync.mockReturnValue('{}')
-
-      const config1 = getDemoConfig()
-      const config2 = getDemoConfig()
-
-      expect(config1).toBe(config2)
-      expect(mockReadFileSync).toHaveBeenCalledTimes(1)
-    })
-
-    it('creates new instance when path is provided', () => {
-      mockReadFileSync.mockReturnValue('{}')
-
-      const config1 = getDemoConfig()
-      const config2 = getDemoConfig('custom/path.json')
-
-      expect(config1).not.toBe(config2)
-      expect(mockReadFileSync).toHaveBeenCalledTimes(2)
-    })
-  })
-})

package/src/lib/demos/config.ts

@@ -1,205 +0,0 @@
-import { gte as semverGte, parse as semverParse } from '@vltpkg/semver'
-import { readFileSync } from 'node:fs'
-import type { DemoConfigData } from './config-schema.ts'
-import { DemoConfigSchema, LegacyDemoConfigSchema } from './config-schema.ts'
-
-// Try to import the TypeScript config
-let importedConfig: DemoConfigData | null = null
-try {
-  // @ts-ignore - This import might fail if the file doesn't exist
-  const configModule = await import('../../../.github/demo-config.ts')
-  importedConfig = configModule.default || configModule.demoConfig
-} catch {
-  // Config file doesn't exist or failed to load
-}
-
-// Default configuration
-const DEFAULT_CONFIG: DemoConfigData = {
-  examples: {
-    exclude: [],
-    order: [],
-    minimumPolenVersion: '0.1.0',
-  },
-  deployment: {
-    basePaths: {},
-    redirects: [],
-    gc: {
-      retainStableVersions: true,
-      retainCurrentCycle: true,
-      retainDays: 30,
-    },
-  },
-  ui: {
-    theme: {
-      primaryColor: '#000',
-      backgroundColor: '#fff',
-      textColor: '#000',
-      mutedTextColor: '#666',
-    },
-    branding: {
-      title: 'Polen Demos',
-      description: 'Interactive GraphQL API documentation',
-    },
-  },
-  metadata: {
-    disabledDemos: {
-      github: {
-        title: 'GitHub API',
-        description: "Browse GitHub's extensive GraphQL API with over 1600 types.",
-        reason: 'Currently disabled due to build performance.',
-      },
-    },
-  },
-}
-
-export class DemoConfig {
-  private data: DemoConfigData
-  private configPath: string
-
-  constructor(configPath: string = '.github/demo-config') {
-    this.configPath = configPath
-    this.data = this.loadConfig()
-  }
-
-  private loadConfig(): DemoConfigData {
-    // Check if we're loading the default config path and have an imported TypeScript config
-    if (this.configPath === '.github/demo-config' && importedConfig) {
-      const parsed = DemoConfigSchema.safeParse(importedConfig)
-      if (parsed.success) {
-        return parsed.data
-      }
-    }
-
-    // Try JSON config
-    try {
-      const jsonConfigPath = `${this.configPath}.json`
-      const raw = JSON.parse(readFileSync(jsonConfigPath, 'utf-8'))
-
-      // Try to parse as modern config first
-      const modernParse = DemoConfigSchema.safeParse(raw)
-      if (modernParse.success) {
-        return modernParse.data
-      }
-
-      // Fall back to legacy config format
-      const legacyParse = LegacyDemoConfigSchema.safeParse(raw)
-      if (legacyParse.success) {
-        const legacy = legacyParse.data
-        return {
-          ...DEFAULT_CONFIG,
-          examples: {
-            ...DEFAULT_CONFIG.examples,
-            exclude: legacy.excludeDemos || DEFAULT_CONFIG.examples.exclude,
-            order: legacy.order || DEFAULT_CONFIG.examples.order,
-            minimumPolenVersion: legacy.minimumPolenVersion || legacy.minimumVersion
-              || DEFAULT_CONFIG.examples.minimumPolenVersion,
-          },
-        }
-      }
-
-      throw new Error('Invalid config format')
-    } catch (e) {
-      console.warn(`No config file found at ${this.configPath}.json, using defaults`)
-      return DEFAULT_CONFIG
-    }
-  }
-
-  get excludeDemos(): string[] {
-    return this.data.examples.exclude
-  }
-
-  get minimumPolenVersion(): string {
-    return this.data.examples.minimumPolenVersion
-  }
-
-  get order(): string[] {
-    return this.data.examples.order
-  }
-
-  get fullConfig(): DemoConfigData {
-    return this.data
-  }
-
-  /**
-   * Check if a Polen version meets the minimum requirement
-   */
-  meetsMinimumPolenVersion(polenVersion: string): boolean {
-    const versionParsed = semverParse(polenVersion)
-    const minVersionParsed = semverParse(this.minimumPolenVersion)
-
-    if (!versionParsed || !minVersionParsed) {
-      return false
-    }
-
-    return semverGte(versionParsed, minVersionParsed)
-  }
-
-  /**
-   * Check if a demo is excluded
-   */
-  isDemoExcluded(demoName: string): boolean {
-    return this.data.examples.exclude.includes(demoName)
-  }
-
-  /**
-   * Get ordered list of demos (non-excluded)
-   * @param availableDemos List of all available demo names
-   * @returns Ordered list with configured order first, then alphabetical
-   */
-  getOrderedDemos(availableDemos: string[]): string[] {
-    const nonExcluded = availableDemos.filter(demo => !this.isDemoExcluded(demo))
-    const orderedDemos: string[] = []
-    const remainingDemos = [...nonExcluded]
-
-    // Add demos in the specified order
-    for (const demo of this.order) {
-      if (nonExcluded.includes(demo)) {
-        orderedDemos.push(demo)
-        const index = remainingDemos.indexOf(demo)
-        if (index > -1) {
-          remainingDemos.splice(index, 1)
-        }
-      }
-    }
-
-    // Add remaining demos in alphabetical order
-    remainingDemos.sort()
-    orderedDemos.push(...remainingDemos)
-
-    return orderedDemos
-  }
-
-  /**
-   * Get deployment path for a version
-   */
-  getDeploymentPath(version: string, isStable: boolean = false): string {
-    return isStable ? '/latest/' : `/${version}/`
-  }
-
-  /**
-   * Get all disabled demos with metadata
-   */
-  getDisabledDemos(): Record<string, { title: string; description: string; reason?: string }> {
-    return this.data.metadata.disabledDemos
-  }
-}
-
-// Singleton instance for convenience
-let defaultConfig: DemoConfig | null = null
-
-export function getDemoConfig(configPath?: string): DemoConfig {
-  if (configPath) {
-    // Always create new instance when path is provided
-    return new DemoConfig(configPath)
-  }
-
-  if (!defaultConfig) {
-    defaultConfig = new DemoConfig()
-  }
-  return defaultConfig
-}
-
-// For testing only
-export function resetDemoConfig(): void {
-  defaultConfig = null
-}

package/src/lib/demos/index.ts

@@ -1,9 +0,0 @@
-/**
- * Public API for the demos library
- */
-
-export { demoBuilder } from './builder.ts'
-export type { DemoConfigData } from './config-schema.ts'
-export { DemoConfig, getDemoConfig, resetDemoConfig } from './config.ts'
-export { buildDemosHome, buildDemosHomeWithCatalog, type CatalogOptions, type Options } from './ui/landing-page.ts'
-export { getDemoExamples } from './utils.ts'