polen 0.10.0 → 0.11.0-next.10

package/src/template/server/ssg/get-route-paths.test.ts

@@ -0,0 +1,132 @@
+import { beforeEach, describe, expect, test, vi } from 'vitest'
+
+// Mock node:fs/promises
+vi.mock('node:fs/promises', () => ({
+  readFile: vi.fn(),
+}))
+
+// Mock the virtual import
+vi.mock('virtual:polen/project/data.jsonsuper', () => ({
+  default: {
+    paths: {
+      project: {
+        absolute: {
+          build: {
+            assets: {
+              schemas: '/mock/schemas',
+            },
+          },
+        },
+      },
+    },
+  },
+}))
+
+// Mock the routes
+vi.mock('../../routes.js', () => ({
+  routes: [
+    {
+      path: 'reference',
+      children: [
+        {
+          path: 'version/:version',
+          children: [
+            {
+              path: ':type',
+            },
+          ],
+        },
+        {
+          path: ':type',
+        },
+      ],
+    },
+  ],
+}))
+
+// Mock the API
+vi.mock('#api/index', () => ({
+  Api: {
+    Schema: {
+      getMetadata: vi.fn(),
+      VERSION_LATEST: 'latest',
+    },
+  },
+}))
+
+describe('getRoutesPaths', () => {
+  beforeEach(() => {
+    vi.resetAllMocks()
+  })
+
+  test('should handle versioned routes without type parameter', async () => {
+    // Mock schema metadata
+    const { Api } = await import('#api/index')
+    vi.mocked(Api.Schema.getMetadata).mockResolvedValue({
+      hasSchema: true,
+      versions: ['2024-01-01', '2024-02-01'],
+    })
+
+    // Mock file system reads with proper GraphQL AST
+    const NodeFs = await import('node:fs/promises')
+    vi.mocked(NodeFs.readFile).mockImplementation(async (path) => {
+      if (typeof path === 'string' && path.includes('.json')) {
+        // Return a minimal GraphQL document AST
+        return JSON.stringify({
+          kind: 'Document',
+          definitions: [],
+        })
+      }
+      throw new Error(`Unexpected file read: ${path}`)
+    })
+
+    const { getRoutesPaths } = await import('./get-route-paths.js')
+
+    // This should not throw "Unhandled parameterized path: /reference/version/:version"
+    await expect(getRoutesPaths()).resolves.toBeDefined()
+  })
+
+  test('should generate paths for all schema versions', async () => {
+    const { Api } = await import('#api/index')
+    vi.mocked(Api.Schema.getMetadata).mockResolvedValue({
+      hasSchema: true,
+      versions: ['2024-01-01', '2024-02-01'],
+    })
+
+    // Mock schema with types - proper GraphQL AST
+    const mockSchema = {
+      kind: 'Document',
+      definitions: [
+        {
+          kind: 'ObjectTypeDefinition',
+          name: { kind: 'Name', value: 'User' },
+        },
+        {
+          kind: 'ObjectTypeDefinition',
+          name: { kind: 'Name', value: 'Post' },
+        },
+      ],
+    }
+
+    const NodeFs = await import('node:fs/promises')
+    vi.mocked(NodeFs.readFile).mockImplementation(async (path) => {
+      if (typeof path === 'string' && path.includes('.json')) {
+        return JSON.stringify(mockSchema)
+      }
+      throw new Error(`Unexpected file read: ${path}`)
+    })
+
+    const { getRoutesPaths } = await import('./get-route-paths.js')
+    const paths = await getRoutesPaths()
+
+    // Should include versioned paths
+    expect(paths).toContain('/reference/version/2024-01-01/User')
+    expect(paths).toContain('/reference/version/2024-01-01/Post')
+    expect(paths).toContain('/reference/version/2024-02-01/User')
+    expect(paths).toContain('/reference/version/2024-02-01/Post')
+
+    // Should include unversioned paths
+    expect(paths).toContain('/reference/User')
+    expect(paths).toContain('/reference/Post')
+  })
+})

package/src/template/server/ssg/get-route-paths.ts

@@ -1,7 +1,8 @@
-import { Grafaid } from '#lib/grafaid/index'
-import { visit } from 'graphql'
-// Or your specific import path for this type
+import { Api } from '#api/index'
 import { ReactRouterAid } from '#lib/react-router-aid/index'
+import { visit } from 'graphql'
+import * as NodeFs from 'node:fs/promises'
+import * as NodePath from 'node:path'
 import PROJECT_DATA from 'virtual:polen/project/data.jsonsuper'
 import { routes } from '../../routes.js'
 
@@ -10,37 +11,100 @@ import { routes } from '../../routes.js'
 // Maybe we can figure something out too.
 const knownParameterizedRouteExpressions = {
   reference_type: `/reference/:type`,
+  reference_type_field: `/reference/:type/:field`,
+  reference_version: `/reference/version/:version`,
+  reference_versioned_type: `/reference/version/:version/:type`,
+  reference_versioned_type_field: `/reference/version/:version/:type/:field`,
 }
 
-export const getRoutesPaths = (): string[] => {
+export const getRoutesPaths = async (): Promise<string[]> => {
   const paths = new Set<string>()
   const routeExpressions = ReactRouterAid.getRouteExpressions(routes)
 
+  // Helper function to load schema from filesystem and add type paths
+  const addTypePathsForVersion = async (version: string, pathPrefix: string, includeFields = false) => {
+    try {
+      const schemaFilePath = NodePath.join(PROJECT_DATA.paths.project.absolute.build.assets.schemas, `${version}.json`)
+      const schemaContent = await NodeFs.readFile(schemaFilePath, 'utf-8')
+      const schemaAst = JSON.parse(schemaContent)
+
+      visit(schemaAst, {
+        ObjectTypeDefinition(node) {
+          const typePath = `${pathPrefix}/${node.name.value}`
+          paths.add(typePath)
+
+          // Add field paths if requested
+          if (includeFields && node.fields) {
+            for (const field of node.fields) {
+              paths.add(`${typePath}/${field.name.value}`)
+            }
+          }
+        },
+        InterfaceTypeDefinition(node) {
+          const typePath = `${pathPrefix}/${node.name.value}`
+          paths.add(typePath)
+
+          // Add field paths if requested
+          if (includeFields && node.fields) {
+            for (const field of node.fields) {
+              paths.add(`${typePath}/${field.name.value}`)
+            }
+          }
+        },
+        EnumTypeDefinition(node) {
+          paths.add(`${pathPrefix}/${node.name.value}`)
+        },
+        InputObjectTypeDefinition(node) {
+          paths.add(`${pathPrefix}/${node.name.value}`)
+        },
+        UnionTypeDefinition(node) {
+          paths.add(`${pathPrefix}/${node.name.value}`)
+        },
+        ScalarTypeDefinition(node) {
+          paths.add(`${pathPrefix}/${node.name.value}`)
+        },
+      })
+    } catch (error) {
+      throw new Error(`SSG failed to load schema for version ${version}. Ensure schema assets are built. ${error}`)
+    }
+  }
+
+  const schemaMetadataPath = NodePath.join(PROJECT_DATA.paths.project.absolute.build.assets.schemas, 'metadata.json')
+
+  const schemaMetadata = await Api.Schema.getMetadata(schemaMetadataPath)
+  const { hasSchema, versions: availableVersions } = schemaMetadata
+
   for (const exp of routeExpressions) {
     if (exp === knownParameterizedRouteExpressions.reference_type) {
-      if (PROJECT_DATA.schema) {
-        const schema = PROJECT_DATA.schema.versions[0].after
-        const ast = Grafaid.Schema.AST.parse(Grafaid.Schema.print(schema))
-        visit(ast, {
-          ObjectTypeDefinition(node) {
-            paths.add(`/reference/${node.name.value}`)
-          },
-          InterfaceTypeDefinition(node) {
-            paths.add(`/reference/${node.name.value}`)
-          },
-          EnumTypeDefinition(node) {
-            paths.add(`/reference/${node.name.value}`)
-          },
-          InputObjectTypeDefinition(node) {
-            paths.add(`/reference/${node.name.value}`)
-          },
-          UnionTypeDefinition(node) {
-            paths.add(`/reference/${node.name.value}`)
-          },
-          ScalarTypeDefinition(node) {
-            paths.add(`/reference/${node.name.value}`)
-          },
-        })
+      if (hasSchema) {
+        // Add paths for latest version (no version in URL)
+        await addTypePathsForVersion(Api.Schema.VERSION_LATEST, `/reference`)
+      }
+    } else if (exp === knownParameterizedRouteExpressions.reference_version) {
+      if (hasSchema) {
+        // Add paths for version pages themselves (without type)
+        for (const version of availableVersions) {
+          paths.add(`/reference/version/${version}`)
+        }
+      }
+    } else if (exp === knownParameterizedRouteExpressions.reference_type_field) {
+      if (hasSchema) {
+        // Add paths for latest version fields
+        await addTypePathsForVersion(Api.Schema.VERSION_LATEST, `/reference`, true)
+      }
+    } else if (exp === knownParameterizedRouteExpressions.reference_versioned_type) {
+      if (hasSchema) {
+        // Add paths for all versions using new route structure
+        for (const version of availableVersions) {
+          await addTypePathsForVersion(version, `/reference/version/${version}`)
+        }
+      }
+    } else if (exp === knownParameterizedRouteExpressions.reference_versioned_type_field) {
+      if (hasSchema) {
+        // Add paths for all versions with fields
+        for (const version of availableVersions) {
+          await addTypePathsForVersion(version, `/reference/version/${version}`, true)
+        }
       }
     } else if (ReactRouterAid.isParameterizedPath(exp)) {
       throw new Error(`Unhandled parameterized path: ${exp}`)

package/src/template/sources/schema-source.ts

@@ -0,0 +1,69 @@
+import PROJECT_DATA from 'virtual:polen/project/data.jsonsuper'
+import PROJECT_SCHEMA_METADATA from 'virtual:polen/project/schema-metadata'
+import { createSchemaSource } from '../../api/schema-source/index.js'
+import { polenUrlPathAssets } from '../lib/polen-url.js'
+
+// Environment-specific IO implementation
+const io = import.meta.env.SSR
+  ? {
+    // Server-side: Read from filesystem
+    read: async (path: string) => {
+      // Dynamic import to keep fs out of client bundle
+      const { readFile } = await import('node:fs/promises')
+
+      // Extract the path after the assets route
+      // e.g., "/assets/schemas/latest.json" -> "schemas/latest.json"
+      // e.g., "/demos/pokemon/assets/schemas/latest.json" -> "schemas/latest.json"
+      const assetsRoute = PROJECT_DATA.server.routes.assets
+      const routePattern = new RegExp(`${assetsRoute}/(.+)$`)
+      const match = path.match(routePattern)
+      const assetPath = match ? match[1] : path
+
+      // In SSR, we need to read from the correct location
+      // During dev, assets are served from Polen's node_modules
+      // In production, they're in the build output directory
+      let fullPath: string
+      if (import.meta.env.DEV) {
+        // Development: Read from Polen's Vite cache
+        fullPath = `${PROJECT_DATA.paths.framework.devAssets.absolute}/${assetPath}`
+      } else {
+        // Production: Read from build output
+        // The server runs from the project root, and assets are in build/assets/
+        fullPath =
+          `${PROJECT_DATA.paths.project.relative.build.root}/${PROJECT_DATA.paths.project.relative.build.relative.assets.root}/${assetPath}`
+      }
+
+      return readFile(fullPath, 'utf-8')
+    },
+  }
+  : {
+    // Client-side: Fetch from HTTP
+    read: async (path: string) => {
+      const response = await fetch(path)
+      if (!response.ok) {
+        throw new Error(`Failed to fetch: ${path} (${response.status} ${response.statusText})`)
+      }
+      return response.text()
+    },
+  }
+
+// Create and export the source object directly
+export const schemaSource = createSchemaSource({
+  io,
+  versions: PROJECT_SCHEMA_METADATA.versions,
+  assetsPath: polenUrlPathAssets(),
+})
+
+// HMR cache invalidation for development
+if (import.meta.hot) {
+  import.meta.hot.on('polen:schema-invalidate', () => {
+    console.log('[HMR] Schema cache invalidated')
+    schemaSource.clearCache()
+
+    // Brute force approach: reload the page to ensure fresh data
+    // This guarantees all components see the updated schema immediately
+    // TODO: When we have reactive data fetching, remove this reload
+    //       and let the reactive system handle updates gracefully
+    window.location.reload()
+  })
+}

package/build/lib/graphql-document/$$.d.ts

@@ -1,5 +0,0 @@
-export * from './analysis.js';
-export * from './positioning-simple.js';
-export * from './schema-integration.js';
-export * from './types.js';
-//# sourceMappingURL=$$.d.ts.map

package/build/lib/graphql-document/$$.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"$$.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-document/$$.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,YAAY,CAAA"}

package/build/lib/graphql-document/$$.js

@@ -1,5 +0,0 @@
-export * from './analysis.js';
-export * from './positioning-simple.js';
-export * from './schema-integration.js';
-export * from './types.js';
-//# sourceMappingURL=$$.js.map

package/build/lib/graphql-document/$$.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"$$.js","sourceRoot":"","sources":["../../../src/lib/graphql-document/$$.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,YAAY,CAAA"}

package/build/lib/graphql-document/$.d.ts

@@ -1,2 +0,0 @@
-export * as GraphQLDocument from './graphql-document.js';
-//# sourceMappingURL=$.d.ts.map

package/build/lib/graphql-document/$.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"$.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-document/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,eAAe,MAAM,uBAAuB,CAAA"}

package/build/lib/graphql-document/$.js

@@ -1,2 +0,0 @@
-export * as GraphQLDocument from './graphql-document.js';
-//# sourceMappingURL=$.js.map

package/build/lib/graphql-document/$.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"$.js","sourceRoot":"","sources":["../../../src/lib/graphql-document/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,eAAe,MAAM,uBAAuB,CAAA"}

package/build/lib/graphql-document/analysis.d.ts

@@ -1,44 +0,0 @@
-import { type DocumentNode, type GraphQLError, type GraphQLSchema } from 'graphql';
-import type { AnalysisConfig, AnalysisResult, GraphQLAnalyzer, IdentifierMap } from './types.js';
-/**
- * Default GraphQL document analyzer implementation
- */
-export declare class DefaultGraphQLAnalyzer implements GraphQLAnalyzer {
-    /**
-     * Parse a GraphQL document string into an AST
-     */
-    parse(source: string): DocumentNode;
-    /**
-     * Validate a GraphQL document against a schema
-     */
-    validateAgainstSchema(ast: DocumentNode, schema: GraphQLSchema): GraphQLError[];
-    /**
-     * Extract all identifiers from a GraphQL AST
-     */
-    extractIdentifiers(ast: DocumentNode, config?: AnalysisConfig): IdentifierMap;
-    /**
-     * Perform complete analysis of a GraphQL document
-     */
-    analyze(source: string, config?: AnalysisConfig): AnalysisResult;
-    private addIdentifier;
-    private getPosition;
-    private getTypePosition;
-    private extractTypeName;
-    private isObjectField;
-    private inferReturnType;
-    private createContext;
-    private createIdentifierMap;
-}
-/**
- * Default analyzer instance
- */
-export declare const analyzer: DefaultGraphQLAnalyzer;
-/**
- * Convenience function to analyze a GraphQL document
- */
-export declare const analyze: (source: string, config?: AnalysisConfig) => AnalysisResult;
-/**
- * Convenience function to extract identifiers from a GraphQL document
- */
-export declare const extractIdentifiers: (source: string, config?: AnalysisConfig) => IdentifierMap;
-//# sourceMappingURL=analysis.d.ts.map

package/build/lib/graphql-document/analysis.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql-document/analysis.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,YAAY,EAGjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAMnB,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EACV,cAAc,EAEd,cAAc,EACd,eAAe,EAGf,aAAa,EACd,MAAM,YAAY,CAAA;AAEnB;;GAEG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAUnC;;OAEG;IACH,qBAAqB,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,GAAG,YAAY,EAAE;IAI/E;;OAEG;IACH,kBAAkB,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,GAAE,cAAmB,GAAG,aAAa;IA4MjF;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,cAAmB,GAAG,cAAc;IA+BpE,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,mBAAmB;CAsB5B;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,wBAA+B,CAAA;AAEpD;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,EAAE,SAAS,cAAc,KAAG,cAEjE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,MAAM,EAAE,SAAS,cAAc,KAAG,aAG5E,CAAA"}