@opensaas/stack-cli 0.4.0 → 0.6.0

package/src/generator/lists.ts

@@ -1,140 +0,0 @@
-import type { OpenSaasConfig } from '@opensaas/stack-core'
-import * as fs from 'fs'
-import * as path from 'path'
-
-/**
- * Map field type string to TypeScript field type name
- */
-function getFieldTypeName(fieldType: string): string {
-  const typeMap: Record<string, string> = {
-    text: 'TextField',
-    integer: 'IntegerField',
-    checkbox: 'CheckboxField',
-    timestamp: 'TimestampField',
-    password: 'PasswordField',
-    select: 'SelectField',
-    relationship: 'RelationshipField',
-    json: 'JsonField',
-    virtual: 'VirtualField',
-  }
-
-  return typeMap[fieldType] || 'BaseFieldConfig'
-}
-
-/**
- * Generate Lists namespace with TypeInfo for each list
- * This provides strongly-typed hooks with Prisma input types
- *
- * @example
- * ```typescript
- * // Generated output:
- * export declare namespace Lists {
- *   export type Post = import('@opensaas/stack-core').ListConfig<Lists.Post.TypeInfo>
- *
- *   namespace Post {
- *     export type Item = import('./types').Post
- *     export type TypeInfo = {
- *       key: 'Post'
- *       item: Item
- *       inputs: {
- *         create: import('./prisma-client/client').Prisma.PostCreateInput
- *         update: import('./prisma-client/client').Prisma.PostUpdateInput
- *       }
- *     }
- *   }
- * }
- * ```
- */
-export function generateListsNamespace(config: OpenSaasConfig): string {
-  const lines: string[] = []
-
-  // Add header comment
-  lines.push('/**')
-  lines.push(' * Generated Lists namespace from OpenSaas configuration')
-  lines.push(' * DO NOT EDIT - This file is automatically generated')
-  lines.push(' *')
-  lines.push(' * This file provides TypeInfo for each list, enabling strong typing')
-  lines.push(' * for hooks with Prisma input types.')
-  lines.push(' *')
-  lines.push(' * @example')
-  lines.push(' * ```typescript')
-  lines.push(" * import type { Lists } from './.opensaas/lists'")
-  lines.push(' *')
-  lines.push(' * // Use TypeInfo as generic parameter')
-  lines.push(' * Post: list<Lists.Post.TypeInfo>({')
-  lines.push(' *   hooks: {')
-  lines.push(' *     resolveInput: async ({ operation, resolvedData }) => {')
-  lines.push(' *       // resolvedData is Prisma.PostCreateInput or Prisma.PostUpdateInput')
-  lines.push(' *       return resolvedData')
-  lines.push(' *     }')
-  lines.push(' *   }')
-  lines.push(' * })')
-  lines.push(' *')
-  lines.push(' * // Or use as typed constant')
-  lines.push(' * const Post: Lists.Post = list({ ... })')
-  lines.push(' * ```')
-  lines.push(' */')
-  lines.push('')
-
-  // Start Lists namespace
-  lines.push('export declare namespace Lists {')
-
-  // Generate type for each list
-  for (const [listName, listConfig] of Object.entries(config.lists)) {
-    lines.push(
-      `  export type ${listName} = import('@opensaas/stack-core').ListConfig<Lists.${listName}.TypeInfo>`,
-    )
-    lines.push('')
-    lines.push(`  namespace ${listName} {`)
-    lines.push(`    export type Item = import('./types').${listName}`)
-    lines.push('')
-
-    // Generate Fields type
-    lines.push(`    /**`)
-    lines.push(`     * Field configurations for ${listName}`)
-    lines.push(`     * Maps field names to their field config types`)
-    lines.push(`     */`)
-    lines.push(`    export type Fields = {`)
-    for (const [fieldName, fieldConfig] of Object.entries(listConfig.fields)) {
-      const fieldTypeName = getFieldTypeName(fieldConfig.type)
-      lines.push(
-        `      ${fieldName}: import('@opensaas/stack-core').${fieldTypeName}<Lists.${listName}.TypeInfo>`,
-      )
-    }
-    lines.push(`    }`)
-    lines.push('')
-
-    // Generate TypeInfo with fields property
-    lines.push(`    export type TypeInfo = {`)
-    lines.push(`      key: '${listName}'`)
-    lines.push(`      fields: Fields`)
-    lines.push(`      item: Item`)
-    lines.push(`      inputs: {`)
-    lines.push(`        create: import('./prisma-client/client').Prisma.${listName}CreateInput`)
-    lines.push(`        update: import('./prisma-client/client').Prisma.${listName}UpdateInput`)
-    lines.push(`      }`)
-    lines.push(`    }`)
-    lines.push(`  }`)
-    lines.push('')
-  }
-
-  // Close Lists namespace
-  lines.push('}')
-
-  return lines.join('\n')
-}
-
-/**
- * Write Lists namespace to file
- */
-export function writeLists(config: OpenSaasConfig, outputPath: string): void {
-  const lists = generateListsNamespace(config)
-
-  // Ensure directory exists
-  const dir = path.dirname(outputPath)
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true })
-  }
-
-  fs.writeFileSync(outputPath, lists, 'utf-8')
-}

package/src/generator/plugin-types.ts

@@ -1,147 +0,0 @@
-import type { OpenSaasConfig } from '@opensaas/stack-core'
-import * as fs from 'fs'
-import * as path from 'path'
-
-/**
- * Generate TypeScript declaration for plugin data types
- * Creates type-safe access to config._pluginData
- */
-function generatePluginDataInterface(config: OpenSaasConfig): string {
-  const lines: string[] = []
-
-  lines.push('/**')
-  lines.push(' * Plugin data storage types')
-  lines.push(' * Provides type-safe access to config._pluginData')
-  lines.push(' */')
-  lines.push('export interface PluginData {')
-
-  // Check if we have plugin data types to generate
-  if (config._pluginData && Object.keys(config._pluginData).length > 0) {
-    for (const pluginName of Object.keys(config._pluginData)) {
-      // Skip internal keys
-      if (pluginName.startsWith('__')) continue
-
-      // For each plugin, we'll add a Record<string, unknown> entry
-      // TODO: In the future, plugins could export their data types for proper typing
-      lines.push(`  ${pluginName}?: Record<string, unknown>`)
-    }
-  }
-
-  lines.push('}')
-
-  return lines.join('\n')
-}
-
-/**
- * Generate TypeScript declaration for plugin runtime services
- * Creates type-safe access to context.plugins
- */
-function generatePluginServicesInterface(config: OpenSaasConfig): string {
-  const lines: string[] = []
-  const imports: string[] = []
-
-  // Check if we have plugins with runtime functions
-  const pluginsWithRuntime = (config._plugins || config.plugins || []).filter((p) => p.runtime)
-
-  // Collect imports from plugins that provide runtime service types
-  if (pluginsWithRuntime.length > 0) {
-    for (const plugin of pluginsWithRuntime) {
-      if (plugin.runtimeServiceTypes) {
-        imports.push(plugin.runtimeServiceTypes.import)
-      }
-    }
-  }
-
-  // Add imports at the top if any exist
-  if (imports.length > 0) {
-    lines.push(...imports)
-    lines.push('')
-  }
-
-  lines.push('/**')
-  lines.push(' * Plugin runtime services')
-  lines.push(' * Provides type-safe access to context.plugins')
-  lines.push(' * Extends Record to allow compatibility with base AccessContext type')
-  lines.push(' */')
-  lines.push(
-    'export interface PluginServices extends Record<string, Record<string, any> | undefined> {',
-  )
-
-  if (pluginsWithRuntime.length > 0) {
-    for (const plugin of pluginsWithRuntime) {
-      if (plugin.runtimeServiceTypes) {
-        // Use typed runtime service from plugin
-        lines.push(`  ${plugin.name}?: ${plugin.runtimeServiceTypes.typeName}`)
-      } else {
-        // Fallback to Record<string, any> for plugins without type metadata
-        lines.push(`  ${plugin.name}?: Record<string, any>`)
-      }
-    }
-  }
-
-  lines.push('}')
-
-  return lines.join('\n')
-}
-
-/**
- * Generate module augmentation for OpenSaaS core types
- * Note: We cannot augment _pluginData or plugins properties directly due to type constraints
- * Instead, users should cast to PluginServices when accessing context.plugins
- */
-function generateModuleAugmentation(): string {
-  const lines: string[] = []
-
-  lines.push('')
-  lines.push('/**')
-  lines.push(' * Declare this module to make interfaces available globally')
-  lines.push(' * Import this file to get typed plugin access')
-  lines.push(' */')
-  lines.push('declare global {')
-  lines.push('  // Plugin types are available as PluginServices interface')
-  lines.push('}')
-
-  return lines.join('\n')
-}
-
-/**
- * Generate complete plugin types file
- */
-export function generatePluginTypes(config: OpenSaasConfig): string {
-  const lines: string[] = []
-
-  // Add header comment
-  lines.push('/**')
-  lines.push(' * Generated plugin types from OpenSaas configuration')
-  lines.push(' * DO NOT EDIT - This file is automatically generated')
-  lines.push(' *')
-  lines.push(' * This file provides type-safe access to:')
-  lines.push(' * - config._pluginData - Plugin configuration data')
-  lines.push(' * - context.plugins - Plugin runtime services')
-  lines.push(' */')
-  lines.push('')
-
-  // Generate interfaces
-  lines.push(generatePluginDataInterface(config))
-  lines.push(generatePluginServicesInterface(config))
-
-  // Generate module augmentation
-  lines.push(generateModuleAugmentation())
-
-  return lines.join('\n')
-}
-
-/**
- * Write plugin types to file
- */
-export function writePluginTypes(config: OpenSaasConfig, outputPath: string): void {
-  const pluginTypes = generatePluginTypes(config)
-
-  // Ensure directory exists
-  const dir = path.dirname(outputPath)
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true })
-  }
-
-  fs.writeFileSync(outputPath, pluginTypes, 'utf-8')
-}

package/src/generator/prisma-config.ts

@@ -1,46 +0,0 @@
-import type { OpenSaasConfig } from '@opensaas/stack-core'
-import * as fs from 'fs'
-import * as path from 'path'
-
-/**
- * Generate Prisma config file for CLI commands
- *
- * Prisma 7 requires a prisma.config.ts file at the project root for CLI commands
- * like `prisma db push` and `prisma migrate dev`. This is separate from the
- * runtime configuration (which uses adapters in opensaas.config.ts).
- *
- * The CLI config provides the database URL for schema operations, while the
- * runtime config provides adapters for actual query execution.
- */
-export function generatePrismaConfig(_config: OpenSaasConfig): string {
-  const lines: string[] = []
-
-  // Import dotenv for environment variable loading
-  lines.push("import 'dotenv/config'")
-  lines.push("import { defineConfig, env } from 'prisma/config'")
-  lines.push('')
-  lines.push('export default defineConfig({')
-  lines.push("  schema: 'prisma/schema.prisma',")
-  lines.push('  datasource: {')
-  lines.push("    url: env('DATABASE_URL'),")
-  lines.push('  },')
-  lines.push('})')
-  lines.push('')
-
-  return lines.join('\n')
-}
-
-/**
- * Write Prisma config to file
- */
-export function writePrismaConfig(config: OpenSaasConfig, outputPath: string): void {
-  const prismaConfig = generatePrismaConfig(config)
-
-  // Ensure directory exists
-  const dir = path.dirname(outputPath)
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true })
-  }
-
-  fs.writeFileSync(outputPath, prismaConfig, 'utf-8')
-}

package/src/generator/prisma-extensions.ts

@@ -1,159 +0,0 @@
-import type { OpenSaasConfig, FieldConfig } from '@opensaas/stack-core'
-import * as fs from 'fs'
-import * as path from 'path'
-
-/**
- * Generate Prisma result extensions configuration
- * This creates a Prisma client extension that calls field resolveOutput hooks
- */
-export function generatePrismaExtensions(config: OpenSaasConfig): string {
-  const lines: string[] = []
-
-  // Add header comment
-  lines.push('/**')
-  lines.push(' * Generated Prisma result extensions from OpenSaas configuration')
-  lines.push(' * DO NOT EDIT - This file is automatically generated')
-  lines.push(' */')
-  lines.push('')
-
-  // Add imports
-  lines.push("import { Prisma } from './prisma-client/client'")
-  lines.push("import configOrPromise from '../opensaas.config'")
-  lines.push('')
-
-  // Resolve config synchronously if possible (will be resolved by context.ts anyway)
-  lines.push('// Resolve config - may be a promise if plugins are present')
-  lines.push('let resolvedConfig: any = null')
-  lines.push('const configPromise = Promise.resolve(configOrPromise)')
-  lines.push('configPromise.then(cfg => { resolvedConfig = cfg })')
-  lines.push('')
-
-  // Check if any fields have result extensions or are virtual
-  let hasExtensions = false
-  for (const listConfig of Object.values(config.lists)) {
-    for (const fieldConfig of Object.values(listConfig.fields)) {
-      if (fieldConfig.resultExtension || fieldConfig.virtual) {
-        hasExtensions = true
-        break
-      }
-    }
-    if (hasExtensions) break
-  }
-
-  if (!hasExtensions) {
-    // No extensions needed - export a no-op
-    lines.push('/**')
-    lines.push(' * No result extensions configured')
-    lines.push(' */')
-    lines.push('export const prismaExtensions = {}')
-    lines.push('')
-    return lines.join('\n')
-  }
-
-  // Generate result extensions
-  lines.push('/**')
-  lines.push(' * Prisma result extensions for field transformations and virtual fields')
-  lines.push(' * Delegates to field resolveOutput hooks from config for runtime transformations')
-  lines.push(' */')
-  lines.push('export const prismaExtensions = Prisma.defineExtension({')
-  lines.push('  result: {')
-
-  // Generate extensions for each list
-  for (const [listName, listConfig] of Object.entries(config.lists)) {
-    // Include both fields with resultExtension AND virtual fields
-    const fieldsWithExtensions: Array<[string, FieldConfig]> = Object.entries(
-      listConfig.fields,
-    ).filter(([_, config]) => config.resultExtension || config.virtual)
-
-    if (fieldsWithExtensions.length === 0) continue
-
-    const modelKey = listName.charAt(0).toLowerCase() + listName.slice(1) // camelCase
-
-    lines.push(`    ${modelKey}: {`)
-
-    for (const [fieldName, fieldConfig] of fieldsWithExtensions) {
-      const isVirtual = fieldConfig.virtual
-
-      lines.push(`      ${fieldName}: {`)
-
-      if (isVirtual) {
-        // Virtual fields don't need database fields - they compute from the full item
-        lines.push(`        needs: {},`)
-      } else {
-        // Non-virtual fields need their database value
-        lines.push(`        needs: { ${fieldName}: true },`)
-      }
-
-      lines.push(`        compute: (${modelKey}) => {`)
-
-      if (!isVirtual) {
-        // For non-virtual fields, get the database value and check nullability
-        lines.push(`          const value = ${modelKey}.${fieldName}`)
-        lines.push(`          if (value === null || value === undefined) {`)
-        lines.push(`            return undefined`)
-        lines.push(`          }`)
-      }
-
-      lines.push(`          // Call field's resolveOutput hook if available (synchronously)`)
-      lines.push(`          if (!resolvedConfig) {`)
-      lines.push(
-        `            // Config not yet resolved - return undefined for virtual, value for regular`,
-      )
-      if (isVirtual) {
-        lines.push(`            return undefined`)
-      } else {
-        lines.push(`            return value`)
-      }
-      lines.push(`          }`)
-      lines.push(
-        `          const fieldConfig = resolvedConfig.lists['${listName}'].fields['${fieldName}']`,
-      )
-      lines.push(`          if (fieldConfig.hooks?.resolveOutput) {`)
-      lines.push(`            return fieldConfig.hooks.resolveOutput({`)
-      lines.push(`              operation: 'query',`)
-      if (isVirtual) {
-        lines.push(`              value: undefined, // Virtual fields have no stored value`)
-      } else {
-        lines.push(`              value,`)
-      }
-      lines.push(`              item: ${modelKey},`)
-      lines.push(`              listKey: '${listName}',`)
-      lines.push(`              fieldName: '${fieldName}',`)
-      lines.push(
-        `              context: null as any, // Extension context doesn't have full context`,
-      )
-      lines.push(`            })`)
-      lines.push(`          }`)
-      if (isVirtual) {
-        lines.push(`          return undefined`)
-      } else {
-        lines.push(`          return value`)
-      }
-      lines.push(`        },`)
-      lines.push(`      },`)
-    }
-
-    lines.push(`    },`)
-  }
-
-  lines.push('  },')
-  lines.push('})')
-  lines.push('')
-
-  return lines.join('\n')
-}
-
-/**
- * Write Prisma extensions configuration to file
- */
-export function writePrismaExtensions(config: OpenSaasConfig, outputPath: string): void {
-  const extensions = generatePrismaExtensions(config)
-
-  // Ensure directory exists
-  const dir = path.dirname(outputPath)
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true })
-  }
-
-  fs.writeFileSync(outputPath, extensions, 'utf-8')
-}

package/src/generator/prisma.test.ts

@@ -1,211 +0,0 @@
-import { describe, it, expect } from 'vitest'
-import { generatePrismaSchema } from './prisma.js'
-import type { OpenSaasConfig } from '@opensaas/stack-core'
-import { text, integer, relationship, checkbox, timestamp } from '@opensaas/stack-core/fields'
-
-describe('Prisma Schema Generator', () => {
-  describe('generatePrismaSchema', () => {
-    it('should generate basic schema with datasource and generator', () => {
-      const config: OpenSaasConfig = {
-        db: {
-          provider: 'sqlite',
-        },
-        lists: {},
-      }
-
-      const schema = generatePrismaSchema(config)
-
-      expect(schema).toMatchSnapshot()
-    })
-
-    it('should use custom opensaasPath for generator output', () => {
-      const config: OpenSaasConfig = {
-        db: {
-          provider: 'sqlite',
-        },
-        opensaasPath: '.custom-path',
-        lists: {},
-      }
-
-      const schema = generatePrismaSchema(config)
-
-      expect(schema).toMatchSnapshot()
-    })
-
-    it('should generate model with basic fields', () => {
-      const config: OpenSaasConfig = {
-        db: {
-          provider: 'sqlite',
-        },
-        lists: {
-          User: {
-            fields: {
-              name: text({ validation: { isRequired: true } }),
-              email: text({ validation: { isRequired: true } }),
-              age: integer(),
-            },
-          },
-        },
-      }
-
-      const schema = generatePrismaSchema(config)
-
-      expect(schema).toMatchSnapshot()
-    })
-
-    it('should generate model with checkbox field', () => {
-      const config: OpenSaasConfig = {
-        db: {
-          provider: 'sqlite',
-        },
-        lists: {
-          Post: {
-            fields: {
-              title: text(),
-              isPublished: checkbox({ defaultValue: false }),
-            },
-          },
-        },
-      }
-
-      const schema = generatePrismaSchema(config)
-
-      expect(schema).toMatchSnapshot()
-    })
-
-    it('should generate model with timestamp field', () => {
-      const config: OpenSaasConfig = {
-        db: {
-          provider: 'sqlite',
-        },
-        lists: {
-          Post: {
-            fields: {
-              title: text(),
-              publishedAt: timestamp(),
-            },
-          },
-        },
-      }
-
-      const schema = generatePrismaSchema(config)
-
-      expect(schema).toMatchSnapshot()
-    })
-
-    it('should generate many-to-one relationship', () => {
-      const config: OpenSaasConfig = {
-        db: {
-          provider: 'sqlite',
-        },
-        lists: {
-          User: {
-            fields: {
-              name: text(),
-            },
-          },
-          Post: {
-            fields: {
-              title: text(),
-              author: relationship({ ref: 'User.posts' }),
-            },
-          },
-        },
-      }
-
-      const schema = generatePrismaSchema(config)
-
-      expect(schema).toMatchSnapshot()
-    })
-
-    it('should generate one-to-many relationship', () => {
-      const config: OpenSaasConfig = {
-        db: {
-          provider: 'sqlite',
-        },
-        lists: {
-          User: {
-            fields: {
-              name: text(),
-              posts: relationship({ ref: 'Post.author', many: true }),
-            },
-          },
-          Post: {
-            fields: {
-              title: text(),
-            },
-          },
-        },
-      }
-
-      const schema = generatePrismaSchema(config)
-
-      expect(schema).toMatchSnapshot()
-    })
-
-    it('should generate multiple models', () => {
-      const config: OpenSaasConfig = {
-        db: {
-          provider: 'postgresql',
-        },
-        lists: {
-          User: {
-            fields: {
-              name: text(),
-            },
-          },
-          Post: {
-            fields: {
-              title: text(),
-            },
-          },
-          Comment: {
-            fields: {
-              content: text(),
-            },
-          },
-        },
-      }
-
-      const schema = generatePrismaSchema(config)
-
-      expect(schema).toMatchSnapshot()
-    })
-
-    it('should always include system fields', () => {
-      const config: OpenSaasConfig = {
-        db: {
-          provider: 'sqlite',
-        },
-        lists: {
-          User: {
-            fields: {
-              name: text(),
-            },
-          },
-        },
-      }
-
-      const schema = generatePrismaSchema(config)
-
-      expect(schema).toContain('id        String   @id @default(cuid())')
-      expect(schema).toContain('createdAt DateTime @default(now())')
-      expect(schema).toContain('updatedAt DateTime @updatedAt')
-    })
-
-    it('should handle empty lists config', () => {
-      const config: OpenSaasConfig = {
-        db: {
-          provider: 'sqlite',
-        },
-        lists: {},
-      }
-
-      const schema = generatePrismaSchema(config)
-
-      expect(schema).toContain('generator client {')
-      expect(schema).toContain('datasource db {')
-      expect(schema).not.toContain('model')
-    })
-  })
-})