create-taserjs 0.0.0 → 0.0.2

package/src/addons/registry.ts

@@ -1,9 +1,12 @@
+import { arktypeAddon } from './arktype/index.js'
 import { drizzleAddon } from './drizzle/index.js'
 import { kyselyAddon } from './kysely/index.js'
 import { pinoAddon } from './pino/index.js'
 import { prismaAddon } from './prisma/index.js'
-import type { AddonDefinition } from './types.js'
+import { valibotAddon } from './valibot/index.js'
 import { winstonAddon } from './winston/index.js'
+import { zodAddon } from './zod/index.js'
+import type { AddonDefinition } from './types.js'
 import type { CapabilitiesCatalog, ScaffoldContext } from '../core/types.js'
 import {
   DB_DRIVERS,
@@ -11,6 +14,7 @@ import {
   DEFAULT_DB_DRIVER,
   FRAMEWORKS,
   LOGGERS,
+  VALIDATORS,
 } from '../core/types.js'
 
 const ALL_ADDONS: AddonDefinition[] = [
@@ -19,10 +23,14 @@ const ALL_ADDONS: AddonDefinition[] = [
   kyselyAddon,
   pinoAddon,
   winstonAddon,
+  zodAddon,
+  arktypeAddon,
+  valibotAddon,
 ]
 
 const DB_ADDONS = ALL_ADDONS.filter(addon => addon.category === 'database')
 const LOGGER_ADDONS = ALL_ADDONS.filter(addon => addon.category === 'logger')
+const VALIDATOR_ADDONS = ALL_ADDONS.filter(addon => addon.category === 'validator')
 
 export function getCapabilitiesCatalog(): CapabilitiesCatalog {
   return {
@@ -33,6 +41,7 @@ export function getCapabilitiesCatalog(): CapabilitiesCatalog {
       defaultDriver: DEFAULT_DB_DRIVER,
     },
     loggers: [...LOGGERS],
+    validators: [...VALIDATORS],
   }
 }
 
@@ -65,9 +74,24 @@ export function resolveAddons(ctx: ScaffoldContext): AddonDefinition[] {
     throw new Error('Only one logger addon can be selected')
   }
 
+  if (ctx.validator) {
+    const validatorAddon = VALIDATOR_ADDONS.find(addon => addon.id === ctx.validator)
+    if (!validatorAddon) {
+      throw new Error(`Unknown validator addon "${ctx.validator}"`)
+    }
+    selected.push(validatorAddon)
+  }
+
+  const validatorCount = selected.filter(addon => addon.category === 'validator').length
+  if (validatorCount > 1) {
+    throw new Error('Only one validator addon can be selected')
+  }
+
   return selected
 }
 
 export function collectBootBindings(ctx: ScaffoldContext) {
-  return resolveAddons(ctx).map(addon => addon.bootBinding(ctx))
+  return resolveAddons(ctx)
+    .map(addon => addon.bootBinding?.(ctx))
+    .filter((v): v is NonNullable<typeof v> => Boolean(v))
 }

package/src/addons/types.ts

@@ -10,10 +10,10 @@ export type FileWriter = (filePath: string, contents: string) => Promise<void>
 
 export type AddonDefinition = {
   id: string
-  category: 'database' | 'logger'
+  category: 'database' | 'logger' | 'validator'
   dependencies: (ctx: ScaffoldContext) => string[]
   devDependencies: (ctx: ScaffoldContext) => string[]
   scripts?: (ctx: ScaffoldContext) => Record<string, string>
-  bootBinding: (ctx: ScaffoldContext) => BootBinding
+  bootBinding?: (ctx: ScaffoldContext) => BootBinding
   apply: (ctx: ScaffoldContext, write: FileWriter) => Promise<void>
 }

package/src/addons/valibot/index.ts

@@ -0,0 +1,3 @@
+import { ValidatorAddon } from '../validators.js'
+
+export const valibotAddon = ValidatorAddon('valibot')

package/src/addons/validators.ts

@@ -0,0 +1,39 @@
+import type { ValidatorId } from '../core/types'
+import type { AddonDefinition } from './types'
+
+export const IMPORT_LINES: Record<ValidatorId, string> = {
+  zod: `import { z } from 'zod'`,
+  arktype: `import { type } from 'arktype'`,
+  valibot: `import * as v from 'valibot'`,
+}
+
+export const VALIDATION_BLOCK_TEMPLATE: Record<ValidatorId, string> = {
+  zod: `, {
+  query: z.object({ name: z.string() }),
+}`,
+  arktype: `, {
+  query: type({ name: 'string' }),
+}`,
+  valibot: `, {
+  query: v.object({ name: v.string() }),
+}`,
+}
+
+const ROUTE_TEMPLATE = (validator: ValidatorId) => `import { reply } from '@taserjs/router'
+import { t } from '#src/taser.js'
+${IMPORT_LINES[validator]}
+
+export const Route = t.get('/'${VALIDATION_BLOCK_TEMPLATE[validator]}).handler((ctx) => {
+  return reply.json({ message: \`Hello, \${ctx.query.name}!\` })
+})
+`
+
+export const ValidatorAddon = (validator: ValidatorId): AddonDefinition => {
+  return {
+    id: validator,
+    category: 'validator',
+    dependencies: () => [validator],
+    devDependencies: () => [],
+    apply: (ctx, write) => write('src/routes/index.get.ts', ROUTE_TEMPLATE(validator)),
+  }
+}

package/src/addons/zod/index.ts

@@ -0,0 +1,3 @@
+import { ValidatorAddon } from '../validators.js'
+
+export const zodAddon = ValidatorAddon('zod')

package/src/cli.ts

@@ -14,6 +14,7 @@ async function main(): Promise<void> {
       framework: { type: 'string' },
       db: { type: 'string' },
       logger: { type: 'string' },
+      validator: { type: 'string' },
       y: { type: 'boolean', short: 'y' },
       noInstall: { type: 'boolean' },
       json: { type: 'boolean' },
@@ -26,6 +27,7 @@ async function main(): Promise<void> {
       ...(values.framework !== undefined ? { framework: values.framework } : {}),
       ...(values.db !== undefined ? { db: values.db } : {}),
       ...(values.logger !== undefined ? { logger: values.logger } : {}),
+      ...(values.validator !== undefined ? { validator: values.validator } : {}),
       ...(values.y !== undefined ? { y: values.y } : {}),
       ...(values.noInstall !== undefined ? { noInstall: values.noInstall } : {}),
       ...(values.json !== undefined ? { json: values.json } : {}),

package/src/commands/create.ts

@@ -9,12 +9,13 @@ import {
   parseDbFlag,
   parseFrameworkFlag,
   parseLoggerFlag,
+  parseValidatorFlag,
   type ParsedCreateArgs,
   resolveScaffoldDefaults,
 } from '../core/parse-options.js'
 import { scaffoldProject } from '../core/scaffold-engine.js'
-import type { DbDriver, DbOdm, Framework, LoggerId, ScaffoldResult } from '../core/types.js'
-import { DB_DRIVERS, DB_ODMS, FRAMEWORKS, LOGGERS } from '../core/types.js'
+import type { DbDriver, DbOdm, Framework, LoggerId, ScaffoldResult, ValidatorId } from '../core/types.js'
+import { DB_DRIVERS, DB_ODMS, FRAMEWORKS, LOGGERS, VALIDATORS } from '../core/types.js'
 import { validateProjectName } from '../core/validate-project-name.js'
 import { resolveUserAgent, runScript } from '../core/package-manager.js'
 
@@ -34,6 +35,10 @@ function isLoggerId(value: unknown): value is LoggerId {
   return typeof value === 'string' && (LOGGERS as readonly string[]).includes(value)
 }
 
+function isValidatorId(value: unknown): value is ValidatorId {
+  return typeof value === 'string' && (VALIDATORS as readonly string[]).includes(value)
+}
+
 async function promptInteractiveOptions(
   args: ParsedCreateArgs,
 ): Promise<ParsedCreateArgs> {
@@ -127,6 +132,25 @@ async function promptInteractiveOptions(
 
   const logger = loggerChoice === 'none' ? undefined : isLoggerId(loggerChoice) ? loggerChoice : undefined
 
+  const validatorChoice = args.validator
+    ?? await p.select({
+      message: 'Validator',
+      options: [
+        { value: 'none', label: 'None', hint: 'default' },
+        { value: 'zod', label: 'Zod' },
+        { value: 'arktype', label: 'Arktype' },
+        { value: 'valibot', label: 'Valibot' },
+      ],
+      initialValue: 'none',
+    })
+
+  if (p.isCancel(validatorChoice)) {
+    p.cancel('Scaffold cancelled.')
+    process.exit(0)
+  }
+
+  const validator = validatorChoice === 'none' ? undefined : isValidatorId(validatorChoice) ? validatorChoice : undefined
+
   return {
     projectName: String(projectName).trim(),
     framework,
@@ -135,6 +159,7 @@ async function promptInteractiveOptions(
     json: args.json,
     ...(db ? { db, driver: driver! } : {}),
     ...(logger ? { logger } : {}),
+    ...(validator ? { validator } : {}),
   }
 }
 
@@ -221,6 +246,7 @@ export function buildParsedArgsFromCli(values: {
   framework?: string
   db?: string
   logger?: string
+  validator?: string
   y?: boolean
   noInstall?: boolean
   json?: boolean
@@ -249,5 +275,9 @@ export function buildParsedArgsFromCli(values: {
     args.logger = parseLoggerFlag(values.logger)
   }
 
+  if (values.validator) {
+    args.validator = parseValidatorFlag(values.validator)
+  }
+
   return args
 }

package/src/core/package-manager.ts

@@ -27,18 +27,15 @@ function runCommand(command: string, args: string[], cwd: string): Promise<void>
   })
 }
 
-const fallback = {
-  agent: 'npm',
-  install: (packages: string[], dev: boolean) => {
-    return ['install', ...packages, dev ? '-D' : '']
-  },
-}
-
-function resolveInstallCommand(agent: Agent, packages: string[], dev: boolean): ResolvedCommand {
-  const command = resolveCommand(agent, 'install', packages)
+export function resolveInstallCommand(agent: Agent, packages: string[], dev: boolean): ResolvedCommand {
+  const args = dev ? ['-D', ...packages] : packages
+  const command = resolveCommand(agent, 'add', args)
   if (command) return command
 
-  return { command: fallback.agent, args: fallback.install(packages, dev) }
+  return {
+    command: 'npm',
+    args: ['install', ...args],
+  }
 }
 
 export async function installPackages(

package/src/core/parse-options.ts

@@ -4,11 +4,13 @@ import {
   DEFAULT_DB_DRIVER,
   FRAMEWORKS,
   LOGGERS,
+  VALIDATORS,
   type DbDriver,
   type DbOdm,
   type Framework,
   type LoggerId,
   type ScaffoldContext,
+  type ValidatorId,
 } from './types.js'
 
 export type ParsedCreateArgs = {
@@ -17,6 +19,7 @@ export type ParsedCreateArgs = {
   db?: DbOdm
   driver?: DbDriver
   logger?: LoggerId
+  validator?: ValidatorId
   yes: boolean
   noInstall: boolean
   json: boolean
@@ -38,6 +41,10 @@ function isLoggerId(value: string): value is LoggerId {
   return (LOGGERS as readonly string[]).includes(value)
 }
 
+function isValidatorId(value: string): value is ValidatorId {
+  return (VALIDATORS as readonly string[]).includes(value)
+}
+
 export function parseDbFlag(value: string): { db: DbOdm, driver: DbDriver } {
   const [odm, driver] = value.split(':')
   if (!odm || !isDbOdm(odm)) {
@@ -59,6 +66,7 @@ export function resolveScaffoldDefaults(args: ParsedCreateArgs): ScaffoldContext
   const framework = args.framework ?? 'node'
   const db = args.db
   const logger = args.logger
+  const validator = args.validator
 
   if (!args.projectName) {
     throw new Error('Project name is required')
@@ -79,6 +87,10 @@ export function resolveScaffoldDefaults(args: ParsedCreateArgs): ScaffoldContext
     result.logger = logger
   }
 
+  if (validator) {
+    result.validator = validator
+  }
+
   return result
 }
 
@@ -95,3 +107,10 @@ export function parseLoggerFlag(value: string): LoggerId {
   }
   return value
 }
+
+export function parseValidatorFlag(value: string): ValidatorId {
+  if (!isValidatorId(value)) {
+    throw new Error(`Invalid --validator "${value}". Use zod, arktype, or valibot.`)
+  }
+  return value
+}

package/src/core/project-config.ts

@@ -19,6 +19,10 @@ export async function writeProjectConfig(root: string, ctx: ScaffoldContext): Pr
     config.logger = ctx.logger
   }
 
+  if (ctx.validator) {
+    config.validator = ctx.validator
+  }
+
   await writeFile(
     path.join(root, '.taser.json'),
     `${JSON.stringify(config, null, 2)}\n`,

package/src/core/resolve-packages.ts

@@ -9,6 +9,7 @@ function frameworkPackages(framework: Framework): PackageGroups {
     'tsdown',
     'tsx',
     'typescript',
+    '@types/node',
   ]
   const scripts: Record<string, string> = {}
 

package/src/core/scaffold-engine.ts

@@ -32,6 +32,7 @@ export async function scaffoldProject(options: ScaffoldOptions): Promise<Scaffol
     framework: options.framework,
     ...(options.db ? { db: options.db, driver: options.driver } : {}),
     ...(options.logger ? { logger: options.logger } : {}),
+    ...(options.validator ? { validator: options.validator } : {}),
   }
 
   const addons = resolveAddons(ctx)
@@ -63,6 +64,7 @@ export async function scaffoldProject(options: ScaffoldOptions): Promise<Scaffol
       framework: ctx.framework,
       ...(ctx.db ? { db: ctx.db, driver: ctx.driver } : {}),
       ...(ctx.logger ? { logger: ctx.logger } : {}),
+      ...(ctx.validator ? { validator: ctx.validator } : {}),
     }
   }
 
@@ -78,5 +80,6 @@ export async function scaffoldProject(options: ScaffoldOptions): Promise<Scaffol
     framework: ctx.framework,
     ...(ctx.db ? { db: ctx.db, driver: ctx.driver } : {}),
     ...(ctx.logger ? { logger: ctx.logger } : {}),
+    ...(ctx.validator ? { validator: ctx.validator } : {}),
   }
 }

package/src/core/types.ts

@@ -18,6 +18,10 @@ export type LoggerId = 'pino' | 'winston'
 
 export const LOGGERS: readonly LoggerId[] = ['pino', 'winston']
 
+export type ValidatorId = 'zod' | 'arktype' | 'valibot'
+
+export const VALIDATORS: readonly ValidatorId[] = ['zod', 'arktype', 'valibot']
+
 export type PackageGroups = {
   dependencies: string[]
   devDependencies: string[]
@@ -31,6 +35,7 @@ export type ScaffoldContext = {
   db?: DbOdm
   driver?: DbDriver
   logger?: LoggerId
+  validator?: ValidatorId
 }
 
 export type ScaffoldOptions = ScaffoldContext & {
@@ -48,4 +53,5 @@ export type CapabilitiesCatalog = {
     defaultDriver: DbDriver
   }
   loggers: LoggerId[]
+  validators: ValidatorId[]
 }

package/src/templates/base.ts

@@ -16,8 +16,8 @@ export function packageJsonTemplate(projectName: string, scripts: Record<string,
       'dev:taser': 'taser watch',
       'start': 'tsx src/index.ts',
       'generate': 'taser generate',
-      'build': 'taser generate && tsdown build',
-      'serve': 'node dist/index.js',
+      'build': 'taser generate && tsdown',
+      'serve': 'node dist/index.mjs',
       'typecheck': 'tsc --noEmit -p tsconfig.json',
       ...scripts,
     },
@@ -31,9 +31,7 @@ export function tsdownConfigTemplate(): string {
 
 export default defineConfig({
   entry: ['./src/index.ts'],
-  format: 'esm',
   platform: 'node',
-  target: 'node20',
   outDir: 'dist',
   clean: true,
   sourcemap: true,
@@ -45,9 +43,7 @@ export function tsconfigTemplate(): string {
   return `${JSON.stringify({
     compilerOptions: {
       target: 'ES2022',
-      lib: ['ES2022', 'DOM'],
-      module: 'ESNext',
-      moduleResolution: 'bundler',
+      module: 'NodeNext',
       paths: {
         '#src/*': ['./src/*'],
       },
@@ -112,10 +108,11 @@ export const Middleware = t.middleware('/$')
 }
 
 export function indexRouteTemplate(): string {
-  return `import { t } from '#src/taser.js'
+  return `import { reply } from '@taserjs/router'
+import { t } from '#src/taser.js'
 
-export const Route = t.get('/').handler((ctx) => {
-  return ctx.reply.json({ message: 'Welcome to Taser' })
+export const Route = t.get('/').handler(() => {
+  return reply.json({ message: 'Welcome to Taser' })
 })
 `
 }
@@ -132,11 +129,13 @@ export function healthRouteTemplate(ctx: ScaffoldContext): string {
   }
 
   const body = lines.length > 0 ? `${lines.join('\n')}\n` : ''
+  const ctxArg = lines.length > 0 ? '(ctx)' : '()'
 
-  return `import { t } from '#src/taser.js'
+  return `import { reply } from '@taserjs/router'
+import { t } from '#src/taser.js'
 
-export const Route = t.get('/health').handler((ctx) => {
-${body}  return ctx.reply.json({ ok: true })
+export const Route = t.get('/health').handler(${ctxArg} => {
+${body}  return reply.json({ ok: true })
 })
 `
 }