polen 0.11.0-next.15 → 0.11.0-next.17

package/src/lib/task/task.ts

@@ -1,129 +0,0 @@
-import type { Mask } from '#lib/mask'
-import { Effect } from 'effect'
-import type { Report } from './report.js'
-import { exitWithReport } from './report.js'
-
-// ============================================================================
-// Types
-// ============================================================================
-
-export interface Definition<$Input = any, $Output = any> {
-  name: string
-  mask?: MaskOptions<$Input, $Output> | undefined
-}
-
-export interface Task<$Input, $Output, $Error = never, $Requirements = never> {
-  (input: $Input): Effect.Effect<Report<$Input, $Output>, $Error, $Requirements>
-  definition: Definition<$Input, $Output>
-}
-
-export interface MaskOptions<$Input, $Output> {
-  /**
-   * @default true
-   */
-  input?: Mask.InferOptions<$Input>
-  /**
-   * @default true
-   */
-  output?: Mask.InferOptions<$Output>
-}
-
-// ============================================================================
-// Core Functions
-// ============================================================================
-
-export const create = <$Input, $Output, $Error = never, $Requirements = never>(
-  fn: (input: $Input) => Effect.Effect<$Output, $Error, $Requirements>,
-  options?: {
-    /**
-     * @default the fn name
-     */
-    name?: string | undefined
-    /**
-     * An optional default mask to use for successfully returned values.
-     */
-    mask?: MaskOptions<$Input, $Output> | undefined
-  },
-): Task<$Input, $Output, $Error, $Requirements> => {
-  const definition: Definition<$Input, $Output> = {
-    name: options?.name ?? 'anonymous',
-    mask: options?.mask,
-  }
-
-  const task = (input: $Input): Effect.Effect<Report<$Input, $Output>, $Error, $Requirements> =>
-    Effect.gen(function*() {
-      const start = performance.now()
-
-      const result = yield* fn(input).pipe(
-        Effect.either,
-      )
-
-      const end = performance.now()
-
-      if (result._tag === 'Right') {
-        return {
-          task: definition,
-          execution: {
-            input,
-            output: result.right,
-            timings: {
-              start,
-              end,
-              duration: end - start,
-            },
-          },
-        }
-      } else {
-        return {
-          task: definition,
-          execution: {
-            input,
-            output: result.left as Error,
-            timings: {
-              start,
-              end,
-              duration: end - start,
-            },
-          },
-        }
-      }
-    })
-
-  task.definition = definition
-
-  return task
-}
-
-/**
- * Sugar method that creates a task, executes it, and exits with the report.
- * Equivalent to: create(fn, options) -> task(input) -> exitWithReport(report)
- *
- * @param fn - The function to wrap as a task
- * @param input - Input to pass to the task
- * @param options - Combined task creation and format options
- */
-export const runAndExit = <$Input, $Output, $Error = never, $Requirements = never>(
-  fn: (input: $Input) => Effect.Effect<$Output, $Error, $Requirements>,
-  input: $Input,
-  options?: {
-    name?: string | undefined
-    mask?: MaskOptions<$Input, $Output> | undefined
-    debug?: boolean | undefined
-  },
-): Effect.Effect<never, never, $Requirements> =>
-  Effect.gen(function*() {
-    const task = create(fn, {
-      name: options?.name,
-      mask: options?.mask,
-    })
-    // The task function handles errors internally and wraps them in the report
-    // so it should never fail - it always returns a Report
-    const report = yield* task(input)
-    // exitWithReport calls process.exit, so it never returns
-    exitWithReport(report, {
-      debug: options?.debug,
-      mask: options?.mask,
-    })
-    // This line will never be reached, but TypeScript needs it for the never type
-    return yield* Effect.die('unreachable')
-  }) as Effect.Effect<never, never, $Requirements>

package/src/project-data.ts

@@ -1,10 +0,0 @@
-import type { Config } from '#api/config/$'
-import type { NavbarItem } from '#api/content/navbar'
-
-export interface ProjectData {
-  basePath: string
-  paths: Config.Config['paths']
-  navbar: NavbarItem[]
-  server: Config.Config['server']
-  warnings: Config.Config['warnings']
-}

package/src/template/catalog-bridge.ts

@@ -1,102 +0,0 @@
-import { Catalog } from '#lib/catalog/$'
-import { Effect } from 'effect'
-import PROJECT_SCHEMA from 'virtual:polen/project/schema.json'
-
-// ============================================================================
-// Catalog Storage
-// ============================================================================
-
-// Store the catalog data directly in memory
-let catalogData: Catalog.Catalog
-
-if (PROJECT_SCHEMA) {
-  catalogData = Effect.runSync(Catalog.decode(PROJECT_SCHEMA as any))
-}
-
-// ============================================================================
-// Bridge API
-// ============================================================================
-
-/**
- * Create a simplified catalog bridge without hydra
- */
-const createCatalogBridge = () => {
-  const assertCatalogLoaded = () => {
-    if (!catalogData) {
-      throw new Error(
-        'No schema catalog available. This page requires a GraphQL schema to be configured. '
-          + 'Please ensure your Polen configuration includes a valid schema source.',
-      )
-    }
-  }
-
-  return {
-    /**
-     * Get the full catalog
-     */
-    view: () => {
-      assertCatalogLoaded()
-      return Effect.succeed(catalogData)
-    },
-
-    /**
-     * Set catalog data
-     */
-    setData: (data: Catalog.Catalog) => {
-      catalogData = data
-      return Effect.succeed(undefined)
-    },
-
-    /**
-     * Add a root value (for compatibility)
-     */
-    addRootValue: (value: Catalog.Catalog) => {
-      catalogData = value
-    },
-
-    /**
-     * Export to memory (for compatibility)
-     */
-    exportToMemory: () => {
-      if (!catalogData) return []
-      // Return as a single JSON blob instead of fragments
-      return [{
-        filename: 'catalog.json',
-        content: JSON.stringify(catalogData, null, 2),
-      }]
-    },
-
-    /**
-     * Export (for compatibility)
-     */
-    export: () => {
-      // No-op in simplified version
-      return Effect.succeed(undefined)
-    },
-
-    /**
-     * Import (for compatibility)
-     */
-    import: () => {
-      // No-op in simplified version - data is already loaded
-      return Effect.succeed(undefined)
-    },
-  }
-}
-
-// ============================================================================
-// Exported Instance
-// ============================================================================
-
-export const catalogBridge = createCatalogBridge()
-
-// ============================================================================
-// Helper Functions
-// ============================================================================
-
-/**
- * Check if catalog data is available
- */
-export const hasCatalog = (): boolean => {
-  return catalogData !== undefined && catalogData !== null
-}

package/src/template/data/catalog.ts

@@ -1,7 +0,0 @@
-import { Catalog } from '#lib/catalog/$'
-import { Effect } from 'effect'
-import PROJECT_SCHEMA from 'virtual:polen/project/schema.json'
-
-export const catalog: Catalog.Catalog | null = PROJECT_SCHEMA
-  ? Effect.runSync(Catalog.decode(PROJECT_SCHEMA as any))
-  : null

package/src/template/layouts/ChangelogLayout.tsx

@@ -1,185 +0,0 @@
-import { Catalog } from '#lib/catalog/$'
-import { Change } from '#lib/change/$'
-import { Revision } from '#lib/revision/$'
-import { Version } from '#lib/version/$'
-import { Box, Flex, Text } from '@radix-ui/themes'
-import React, { useEffect, useMemo, useState } from 'react'
-import { useParams } from 'react-router'
-import { renderDate } from '../components/Changelog/Changelog.js'
-import { ChangelogVersionPicker } from '../components/Changelog/ChangelogVersionPicker.js'
-
-interface ChangelogLayoutProps {
-  children: React.ReactNode
-  catalog: Catalog.Catalog
-}
-
-interface VersionCounts {
-  breaking: number
-  dangerous: number
-  safe: number
-}
-
-const calculateCounts = (revision: Revision.Revision): VersionCounts => {
-  return {
-    breaking: revision.changes.filter(Change.isBreaking).length,
-    dangerous: revision.changes.filter(Change.isDangerous).length,
-    safe: revision.changes.filter(Change.isSafe).length,
-  }
-}
-
-const SidebarEntry: React.FC<{
-  revision: Revision.Revision
-  counts: VersionCounts
-  isActive: boolean
-}> = ({ revision, counts, isActive }) => {
-  const dateId = revision.date
-
-  return (
-    <Box mb='2'>
-      <a
-        href={`#${dateId}`}
-        style={{
-          textDecoration: 'none',
-          display: 'flex',
-          alignItems: 'center',
-          justifyContent: 'space-between',
-          padding: '0.5rem 0.75rem',
-          borderRadius: '4px',
-          backgroundColor: isActive ? 'var(--gray-a3)' : 'transparent',
-          color: 'inherit',
-          transition: 'background-color 0.2s',
-        }}
-        onClick={(e) => {
-          e.preventDefault()
-          // Update URL hash
-          window.history.pushState(null, '', `#${dateId}`)
-          // Dispatch custom event for pushState
-          window.dispatchEvent(new Event('pushstate'))
-          // Smooth scroll to element
-          document.getElementById(dateId)?.scrollIntoView({ behavior: 'smooth' })
-        }}
-      >
-        <Text size='2' weight={isActive ? 'medium' : 'regular'}>
-          {renderDate(revision.date)}
-        </Text>
-        <Flex gap='2' align='center'>
-          {counts.breaking > 0 && (
-            <Text size='1' weight='medium' style={{ color: '#ef4444' }}>
-              {counts.breaking}
-            </Text>
-          )}
-          {counts.dangerous > 0 && (
-            <Text size='1' weight='medium' style={{ color: '#f59e0b' }}>
-              {counts.dangerous}
-            </Text>
-          )}
-          {counts.safe > 0 && (
-            <Text size='1' weight='medium' style={{ color: '#10b981' }}>
-              {counts.safe}
-            </Text>
-          )}
-        </Flex>
-      </a>
-    </Box>
-  )
-}
-
-export const ChangelogLayout: React.FC<ChangelogLayoutProps> = ({ children, catalog }) => {
-  const [activeRevision, setActiveRevision] = useState<string | null>(null)
-  const params = useParams()
-  const urlVersion = params['version']
-
-  // Get available versions if catalog is versioned
-  const availableVersions = useMemo(() => {
-    if (Catalog.Versioned.is(catalog)) {
-      return catalog.entries.map(entry => Version.toString(entry.version))
-    }
-    return []
-  }, [catalog])
-
-  // Get revisions for the current version (for sidebar)
-  const revisions = useMemo(() => {
-    if (Catalog.Unversioned.is(catalog)) {
-      return catalog.schema.revisions
-    } else {
-      // For versioned catalogs, show only current version's revisions
-      if (urlVersion) {
-        const entry = catalog.entries.find(e => Version.toString(e.version) === urlVersion)
-        return entry ? entry.revisions : []
-      }
-      // No revisions if no version selected (will redirect)
-      return []
-    }
-  }, [catalog, urlVersion])
-
-  // Calculate counts for all revisions (SSR-safe)
-  const revisionsWithCounts = revisions.map(revision => ({
-    revision,
-    counts: calculateCounts(revision),
-  }))
-
-  // Track active revision based on URL hash
-  useEffect(() => {
-    const handleHashChange = () => {
-      const hash = window.location.hash.slice(1)
-      setActiveRevision(hash || null)
-    }
-
-    // Set initial active revision
-    handleHashChange()
-
-    // Listen for hash changes
-    window.addEventListener('hashchange', handleHashChange)
-
-    // Listen for pushState/replaceState (custom event we'll dispatch)
-    window.addEventListener('pushstate', handleHashChange)
-
-    return () => {
-      window.removeEventListener('hashchange', handleHashChange)
-      window.removeEventListener('pushstate', handleHashChange)
-    }
-  }, [])
-
-  return (
-    <Flex gap='6' style={{ position: 'relative' }}>
-      {/* Sidebar */}
-      <Box
-        style={{
-          position: 'sticky',
-          top: '2rem',
-          height: 'fit-content',
-          minWidth: '250px',
-          maxHeight: 'calc(100vh - 4rem)',
-          overflowY: 'auto',
-        }}
-      >
-        {/* Version picker for versioned catalogs */}
-        {Catalog.Versioned.is(catalog) && availableVersions.length > 1 && urlVersion && (
-          <Box mb='3'>
-            <ChangelogVersionPicker
-              versions={availableVersions}
-              currentVersion={urlVersion}
-            />
-          </Box>
-        )}
-
-        <Text size='2' weight='medium' mb='3' style={{ display: 'block' }}>
-          Revisions
-        </Text>
-        {revisionsWithCounts.map(({ revision, counts }) => (
-          <SidebarEntry
-            key={revision.date}
-            revision={revision}
-            counts={counts}
-            isActive={activeRevision === revision.date}
-          />
-        ))}
-      </Box>
-
-      {/* Main content */}
-      <Box style={{ flex: 1, minWidth: 0 }}>
-        {children}
-      </Box>
-    </Flex>
-  )
-}

package/src/vite/plugins/schema-assets.ts

@@ -1,265 +0,0 @@
-import { Api } from '#api/index'
-import type { Vite } from '#dep/vite/index'
-import { Catalog } from '#lib/catalog/$'
-import { debugPolen } from '#singletons/debug'
-import * as NodeFileSystem from '@effect/platform-node/NodeFileSystem'
-import { Cache } from '@wollybeard/kit'
-import { Effect } from 'effect'
-import * as NodeFs from 'node:fs/promises'
-import * as NodePath from 'node:path'
-
-/**
- * Vite plugin that generates JSON assets for GraphQL schemas at build time.
- *
- * This plugin:
- * - Reads GraphQL schema files from the project
- * - Applies schema augmentations
- * - Converts schemas to AST format and emits as JSON assets
- * - Creates a metadata file with available versions
- * - Provides a virtual module for accessing schema metadata
- *
- * The generated assets enable client-side loading of different schema versions
- * without requiring all schemas to be bundled into the main JavaScript bundle.
- *
- * @param config - Polen configuration object
- * @returns Vite plugin instance
- */
-export const SchemaAssets = (config: Api.Config.Config): Vite.Plugin => {
-  const debug = debugPolen.sub(`vite-plugin:schema-assets`)
-  let viteServer: Vite.ViteDevServer | null = null
-
-  const schemaLoad = Cache.memoize(async () => {
-    return await Effect.runPromise(
-      Api.Schema.loadOrNull(config).pipe(
-        Effect.provide(NodeFileSystem.layer),
-      ),
-    )
-  })
-
-  // Helper to check if a file is a schema file that should trigger regeneration
-  const isSchemaFile = (file: string): boolean => {
-    if (!config.schema) return false
-
-    const absoluteFile = NodePath.resolve(file)
-
-    // Check if file path matches the configured schema file
-    if (config.schema.sources?.file?.path) {
-      const absoluteSchemaFile = NodePath.resolve(
-        config.paths.project.rootDir,
-        config.schema.sources.file.path,
-      )
-      if (absoluteFile === absoluteSchemaFile) return true
-    }
-
-    // Check if file path is within the configured schema directory
-    if (config.schema.sources?.directory?.path) {
-      const absoluteSchemaDir = NodePath.resolve(
-        config.paths.project.rootDir,
-        config.schema.sources.directory.path,
-      )
-      if (absoluteFile.startsWith(absoluteSchemaDir + NodePath.sep)) return true
-    }
-
-    // Check if file is the introspection file
-    if (config.schema.sources?.introspection?.url) {
-      const absoluteIntrospectionFile = NodePath.resolve(
-        config.paths.project.rootDir,
-        `schema.introspection.json`,
-      )
-      if (absoluteFile === absoluteIntrospectionFile) return true
-    }
-
-    return false
-  }
-
-  // Helper to send HMR invalidation signal for schema changes
-  const sendSchemaInvalidation = (server: Vite.ViteDevServer) => {
-    server.ws.send({
-      type: 'custom',
-      event: 'polen:schema-invalidate',
-      data: { timestamp: Date.now() },
-    })
-    debug(`hmr:schemaInvalidationSent`, {})
-  }
-
-  // Helper to write assets
-  const writeDevAssets = async (
-    loadedCatalog: Api.Schema.InputSource.LoadedCatalog,
-  ) => {
-    const { data: catalog } = loadedCatalog
-    if (!catalog) throw new Error('No catalog data to write')
-
-    // Encode catalog to convert GraphQLSchema to AST, then write as JSON
-    const devAssetsDir = config.paths.framework.devAssets.schemas
-    await NodeFs.mkdir(devAssetsDir, { recursive: true })
-    const catalogPath = NodePath.join(devAssetsDir, 'catalog.json')
-
-    const encodedCatalog = await Effect.runPromise(Catalog.encode(catalog))
-
-    await NodeFs.writeFile(catalogPath, JSON.stringify(encodedCatalog, null, 2))
-
-    debug(`devAssetsWritten`)
-  }
-
-  return {
-    name: `polen:schema-assets`,
-
-    configureServer(server) {
-      viteServer = server
-
-      // Clear all assets when dev server starts
-      const clearAssets = async () => {
-        try {
-          // Clear all assets
-          const devAssetsDir = config.paths.framework.devAssets.schemas
-          await NodeFs.rm(devAssetsDir, { recursive: true, force: true })
-          debug(`devAssetsCleared`, {})
-        } catch (error) {
-          // Ignore errors during clearing
-          debug(`devAssetsClearError`, { error })
-        }
-      }
-
-      // Clear assets immediately
-      void clearAssets()
-
-      // Set up file watching for schema source files
-      // TODO: Even when schema is disabled, we should still watch for schema file patterns
-      // during development. If a user enables schema in config during dev, we need to be
-      // ready to detect and load schema files immediately. Currently we skip file watching
-      // entirely when schema is disabled, which means manual dev server restart is required.
-      if (config.schema?.sources?.directory?.path) {
-        // Watch the entire directory for directory mode
-        server.watcher.add(config.schema.sources.directory.path)
-        debug(`watchingSchemaDirectory`, { path: config.schema.sources.directory.path })
-      }
-
-      if (config.schema?.sources?.file?.path) {
-        // Watch the specific file for file mode
-        server.watcher.add(config.schema.sources.file.path)
-        debug(`watchingSchemaFile`, { path: config.schema.sources.file.path })
-      }
-
-      if (config.schema?.sources?.introspection?.url) {
-        // Watch the introspection file if introspection is configured
-        const introspectionFilePath = NodePath.join(config.paths.project.rootDir, `schema.introspection.json`)
-        server.watcher.add(introspectionFilePath)
-        debug(`watchingIntrospectionFile`, { path: introspectionFilePath })
-      }
-
-      // Handle file removal
-      server.watcher.on('unlink', async (file) => {
-        const schemaFileDetected = isSchemaFile(file)
-
-        if (schemaFileDetected) {
-          debug(`schemaFileRemoved`, { file })
-
-          try {
-            // Clear cache and regenerate
-            schemaLoad.clear()
-            const loadedSchema = await schemaLoad()
-            if (!loadedSchema) return
-
-            // const { data: schemaData, manifest, source } = loadedSchema
-
-            // If file was deleted but can be recreated, attempt recreation
-            if (!loadedSchema.data && loadedSchema.source.reCreate) {
-              debug(`attemptingSchemaRecreation`, { sourceType: loadedSchema.source.name })
-              try {
-                const recreatedData = await loadedSchema.source.reCreate({} as any, { paths: config.paths })
-                if (recreatedData) {
-                  // Clear cache again and reload after recreation
-                  schemaLoad.clear()
-                  const reloadResult = await schemaLoad()
-                  if (reloadResult?.data) {
-                    await writeDevAssets(reloadResult)
-                    debug(`hmr:schemaRecreatedAndWritten`)
-                  }
-                } else {
-                  debug(`hmr:schemaRecreationFailed`, { reason: 'reCreate returned null' })
-                }
-              } catch (recreationError) {
-                debug(`hmr:schemaRecreationFailed`, { error: recreationError })
-              }
-            } else if (loadedSchema.data) {
-              // Write new assets without the removed file
-              await writeDevAssets(loadedSchema)
-              debug(`hmr:schemaAssetsUpdatedAfterRemoval`)
-            } else {
-              // No schema data and cannot recreate - clear catalog file
-              const catalogPath = NodePath.join(config.paths.framework.devAssets.schemas, 'catalog.json')
-              await NodeFs.rm(catalogPath, { force: true })
-              debug(`hmr:catalogCleared`, {})
-            }
-          } catch (error) {
-            debug(`hmr:schemaRemovalFailed`, { error })
-          }
-
-          // Send HMR invalidation signal
-          sendSchemaInvalidation(server)
-        }
-      })
-    },
-
-    async buildStart() {
-      debug(`buildStart`, {})
-
-      // Load and process schema data
-      const loadedSchema = await schemaLoad()
-      if (!loadedSchema) {
-        debug(`schemaDisabled`, {})
-        return
-      }
-      const { data: schemaData } = loadedSchema
-
-      if (!schemaData) {
-        debug(`noSchemaFound`, {})
-        return
-      }
-
-      // Handle asset generation differently for dev vs build
-      if (viteServer) {
-        // Dev mode: Write assets directly to filesystem
-        await writeDevAssets(loadedSchema)
-        debug(`devMode:schemaAssetsWritten`, {})
-        return
-      }
-
-      // Build mode: Encode and emit catalog as a single JSON file
-      const encodedCatalog = await Effect.runPromise(Catalog.encode(schemaData))
-      const catalogJson = JSON.stringify(encodedCatalog, null, 2)
-      this.emitFile({
-        type: `asset`,
-        fileName: `${config.paths.project.relative.build.relative.assets.root}/schemas/catalog.json`,
-        source: catalogJson,
-      })
-
-      debug(`buildMode:catalogAssetEmitted`)
-    },
-
-    async handleHotUpdate({ file, server }) {
-      const schemaFileDetected = isSchemaFile(file)
-      if (schemaFileDetected) {
-        debug(`schemaFileChanged`, { file })
-
-        // Regenerate schema assets
-        try {
-          schemaLoad.clear()
-          const schema = await schemaLoad()
-
-          if (schema?.data) {
-            debug(`hmr:schemaRegenerated`)
-
-            // Write new assets to filesystem
-            await writeDevAssets(schema)
-          }
-        } catch (error) {
-          debug(`hmr:schemaRegenerationFailed`, { error })
-        }
-
-        // Send HMR invalidation signal
-        sendSchemaInvalidation(server)
-      }
-    },
-  }
-}