@opensaas/stack-cli 0.1.7 → 0.4.0

package/src/generator/plugin-types.ts

@@ -0,0 +1,147 @@
+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

@@ -0,0 +1,46 @@
+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

@@ -0,0 +1,159 @@
+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

@@ -9,7 +9,6 @@ describe('Prisma Schema Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {},
       }
@@ -23,7 +22,6 @@ describe('Prisma Schema Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         opensaasPath: '.custom-path',
         lists: {},
@@ -38,7 +36,6 @@ describe('Prisma Schema Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           User: {
@@ -60,7 +57,6 @@ describe('Prisma Schema Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           Post: {
@@ -81,7 +77,6 @@ describe('Prisma Schema Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           Post: {
@@ -102,7 +97,6 @@ describe('Prisma Schema Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           User: {
@@ -128,7 +122,6 @@ describe('Prisma Schema Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           User: {
@@ -154,7 +147,6 @@ describe('Prisma Schema Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'postgresql',
-          url: process.env.DATABASE_URL || 'postgresql://localhost:5432/db',
         },
         lists: {
           User: {
@@ -184,7 +176,6 @@ describe('Prisma Schema Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           User: {
@@ -206,7 +197,6 @@ describe('Prisma Schema Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {},
       }

package/src/generator/prisma.ts

@@ -66,13 +66,12 @@ export function generatePrismaSchema(config: OpenSaasConfig): string {
 
   // Generator and datasource
   lines.push('generator client {')
-  lines.push('  provider = "prisma-client-js"')
+  lines.push('  provider = "prisma-client"')
   lines.push(`  output   = "../${opensaasPath}/prisma-client"`)
   lines.push('}')
   lines.push('')
   lines.push('datasource db {')
   lines.push(`  provider = "${config.db.provider}"`)
-  lines.push('  url      = env("DATABASE_URL")')
   lines.push('}')
   lines.push('')
 
@@ -91,6 +90,11 @@ export function generatePrismaSchema(config: OpenSaasConfig): string {
 
     // Add regular fields
     for (const [fieldName, fieldConfig] of Object.entries(listConfig.fields)) {
+      // Skip virtual fields - they don't create database columns
+      if (fieldConfig.virtual) {
+        continue
+      }
+
       if (fieldConfig.type === 'relationship') {
         relationshipFields.push({
           name: fieldName,

package/src/generator/types.test.ts

@@ -9,7 +9,6 @@ describe('Types Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           User: {
@@ -30,7 +29,6 @@ describe('Types Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           Post: {
@@ -51,7 +49,6 @@ describe('Types Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           Post: {
@@ -72,7 +69,6 @@ describe('Types Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           User: {
@@ -92,7 +88,6 @@ describe('Types Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           User: {
@@ -112,7 +107,6 @@ describe('Types Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           User: {
@@ -139,7 +133,6 @@ describe('Types Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           Post: {
@@ -165,7 +158,6 @@ describe('Types Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           Post: {
@@ -191,7 +183,6 @@ describe('Types Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           User: {
@@ -221,7 +212,6 @@ describe('Types Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           Product: {
@@ -243,7 +233,6 @@ describe('Types Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {
           Post: {
@@ -265,7 +254,6 @@ describe('Types Generator', () => {
       const config: OpenSaasConfig = {
         db: {
           provider: 'sqlite',
-          url: 'file:./dev.db',
         },
         lists: {},
       }