@igniter-js/cli 0.2.72 → 0.4.0

package/package.json

@@ -1,68 +1,53 @@
 {
   "name": "@igniter-js/cli",
-  "version": "0.2.72",
-  "description": "CLI for Igniter.js type-safe client generation",
-  "main": "dist/index.js",
+  "version": "0.4.0",
+  "description": "The next-generation command-line interface for Igniter.js",
   "bin": {
-    "igniter": "./bin/igniter"
+    "igniter": "./dist/index.js"
   },
-  "files": [
-    "dist",
-    "bin"
-  ],
   "scripts": {
-    "build": "tsup",
     "dev": "tsup --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "eslint src --ext .ts",
-    "lint:fix": "eslint src --ext .ts --fix",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist"
+    "build": "tsup",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit"
   },
-  "keywords": [
-    "igniter",
-    "cli",
-    "typescript",
-    "code-generation",
-    "api"
-  ],
-  "author": "Felipe Barcelos <felipebarcelospro@gmail.com>",
-  "license": "MIT",
   "dependencies": {
-    "@igniter-js/core": "*",
+    "@clack/prompts": "^0.7.0",
     "@mrleebo/prisma-ast": "^0.5.0",
-    "c12": "^3.0.4",
-    "chalk": "4.1.2",
-    "chokidar": "^3.6.0",
-    "commander": "^11.0.0",
-    "concurrently": "^7.6.0",
-    "cross-spawn": "^7.0.3",
-    "esbuild": "^0.23.0",
-    "execa": "^8.0.1",
-    "is-binary-path": "^3.0.0",
-    "ofetch": "^1.3.4",
-    "ora": "^8.2.0",
-    "prompts": "^2.4.2",
-    "tree-kill": "^1.2.2",
-    "tsx": "^4.7.0"
+    "chokidar": "^4.0.3",
+    "commander": "^12.0.0",
+    "esbuild": "^0.25.12",
+    "esbuild-node-externals": "^1.20.1",
+    "execa": "^9.6.0",
+    "handlebars": "^4.7.8",
+    "ink": "^6.5.0",
+    "js-yaml": "^4.1.0",
+    "picocolors": "^1.0.0",
+    "react": "^19.2.0",
+    "webpack-node-externals": "^3.0.0",
+    "zod": "^3.22.4",
+    "zod-to-json-schema": "^3.24.6"
   },
   "devDependencies": {
     "@igniter-js/eslint-config": "*",
     "@igniter-js/typescript-config": "*",
-    "@types/cross-spawn": "^6.0.6",
-    "@types/ioredis": "^4.28.10",
-    "@types/prompts": "^2.4.9",
-    "eslint": "^8.57.0",
-    "ioredis": "^5.6.1",
-    "tsup": "^8.0.0",
-    "typescript": "^5.6.3",
-    "vitest": "^2.1.4"
-  },
-  "peerDependencies": {
-    "typescript": "^5.0.0"
+    "@types/handlebars": "^4.1.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.11.24",
+    "@types/react": "^19.2.3",
+    "tsup": "^8.0.2",
+    "typescript": "^5.3.3"
   },
-  "publishConfig": {
-    "access": "public"
-  }
+  "keywords": [
+    "igniterjs",
+    "cli",
+    "scaffolding",
+    "codegeneration"
+  ],
+  "author": "Felipe Barcelos",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "templates"
+  ]
 }

package/templates/add-ons/auth/better-auth/auth.hbs

@@ -0,0 +1,37 @@
+import { betterAuth } from "better-auth"
+import { database } from "@/lib/database"
+{{#if (eq addOnOptions.database.orm "prisma")}}
+import { prismaAdapter } from "better-auth/adapters/prisma";
+{{/if}}
+{{#if (eq addOnOptions.database.orm "drizzle")}}
+import { drizzleAdapter } from "better-auth/adapters/drizzle";
+{{/if}}
+{{{generatePluginImports addOnOptions.auth.plugins}}}
+
+export const auth = betterAuth({
+    appName: process.env.IGNITER_APP_NAME,
+    appSecret: process.env.IGNITER_APP_SECRET,
+    baseURL: process.env.IGNITER_API_URL,
+    basePath: process.env.IGNITER_API_BASE_PATH,
+
+    {{#if addOnOptions.database.orm}}
+    // enable database adapter
+    database: {{#if (eq addOnOptions.database.orm "prisma")}}prismaAdapter{{/if}}{{#if (eq addOnOptions.database.orm "drizzle")}}drizzleAdapter{{/if}}(database, {
+        provider: "{{addOnOptions.database.provider}}", // or "mysql", "postgresql", ...etc
+    }),
+    {{/if}}
+
+    // enable email and password authentication
+    emailAndPassword: {
+        enabled: true,
+    },
+
+    {{#if addOnOptions.auth.plugins}}
+    // enable selected authentication plugins
+    plugins: [
+        {{#each addOnOptions.auth.plugins}}
+        {{camelCase this}}(){{#unless @last}},{{/unless}}
+        {{/each}}
+    ]
+    {{/if}}
+})

package/templates/add-ons/bots/nextjs/route-handler.hbs

@@ -0,0 +1,10 @@
+import { sampleBot } from '@/bots/sample-bot';
+import { nextRouteHandlerAdapter } from '@igniter-js/bot/adapters';
+
+/**
+ * @description Next.js route handler for Igniter.js Bots
+ * @see https://igniterjs.com/docs/bots
+ */
+export const { GET, POST } = nextRouteHandlerAdapter({
+  'sample-bot': sampleBot,
+});

package/templates/add-ons/bots/sample-bot.hbs

@@ -0,0 +1,26 @@
+import { IgniterBot } from '@igniter-js/bot'
+import { telegram } from '@igniter-js/bot/adapters'
+
+/**
+ * Create the bot using IgniterBot.
+ * This provides full type inference and a fluent API.
+ *
+ * @see https://igniterjs.com/docs/bots
+ */
+export const sampleBot = IgniterBot
+  .create()
+  .withHandle('@my-bot')  // ← Your bot's handle (ID and name auto-derived)
+  .addAdapter('telegram', telegram())
+  .addCommand('start', {
+    name: 'start',
+    aliases: ['hello'],
+    description: 'Start the bot',
+    help: 'Use /start to begin',
+    async handle(ctx) {
+      await ctx.reply('👋 Welcome! I am your bot.')
+    }
+  })
+  .onMessage(async (ctx) => {
+    await ctx.reply('👋 Welcome! I am your bot.')
+  })
+  .build()

package/templates/add-ons/bots/tanstack-start/route-handler.hbs

@@ -0,0 +1,15 @@
+import { createFileRoute } from '@tanstack/react-router'
+import { tanstackStartRouteHandlerAdapter } from '@igniter-js/bot/adapters'
+import { sampleBot } from '@/bots/sample-bot'
+
+/**
+ * @description TanStack Start route handler for Igniter.js Bots
+ * @see https://igniterjs.com/docs/bots
+ */
+export const Route = createFileRoute('/api/bots/$provider/$botId')({
+  server: {
+    handlers: tanstackStartRouteHandlerAdapter({
+      'sample-bot': sampleBot,
+    }),
+  },
+})

package/templates/add-ons/database/prisma/lib.hbs

@@ -0,0 +1,11 @@
+import { PrismaClient } from '../../prisma/client/client'
+
+/**
+ * Prisma client instance for database operations.
+ *
+ * @remarks
+ * Provides type-safe database access with Prisma ORM.
+ *
+ * @see https://www.prisma.io/docs/concepts/components/prisma-client
+ */
+export const database = new PrismaClient()

package/templates/add-ons/database/prisma/prisma.config.hbs

@@ -0,0 +1,13 @@
+import { defineConfig, env } from "prisma/config";
+import 'dotenv/config';
+
+export default defineConfig({
+  schema: "prisma/schema.prisma",
+  migrations: {
+    path: "prisma/migrations",
+  },
+  engine: "classic",
+  datasource: {
+    url: env("DATABASE_URL"),
+  },
+});

package/templates/add-ons/database/prisma/schema.hbs

@@ -0,0 +1,15 @@
+// This is your Prisma schema file,
+// learn more about it in the docs: https://pris.ly/d/prisma-schema
+
+// Looking for ways to speed up your queries, or scale easily with your serverless or edge functions?
+// Try Prisma Accelerate: https://pris.ly/cli/accelerate-init
+
+generator client {
+  provider = "prisma-client"
+  output   = "../prisma/client"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}

package/templates/add-ons/jobs/jobs.ts.hbs

@@ -0,0 +1,32 @@
+import { store } from './store'
+import { createBullMQAdapter } from '@igniter-js/adapter-bullmq'
+import { z } from 'zod'
+
+/**
+ * Job queue adapter for background processing.
+ *
+ * @see https://igniterjs.com/docs/jobs
+ */
+export const jobs = createBullMQAdapter({
+  store,
+  autoStartWorker: {
+    concurrency: 1,
+    queues: ['*']
+  }
+})
+
+export const REGISTERED_JOBS = jobs.merge({
+  system: jobs.router({
+    jobs: {
+      sampleJob: jobs.register({
+        name: 'sampleJob',
+        input: z.object({
+          message: z.string()
+        }),
+        handler: async ({ input }) => {
+          console.log(input.message)
+        }
+      })
+    }
+  })
+})

package/templates/add-ons/jobs/redis.ts.hbs

@@ -0,0 +1,13 @@
+import { Redis } from 'ioredis'
+
+/**
+ * Redis client instance for caching, session storage, and pub/sub.
+ *
+ * @remarks
+ * Used for caching, session management, and real-time messaging.
+ *
+ * @see https://github.com/luin/ioredis
+ */
+export const redis = new Redis(process.env.REDIS_URL!, {
+  maxRetriesPerRequest: null,
+})

package/templates/add-ons/jobs/store.ts.hbs

@@ -0,0 +1,12 @@
+import { createRedisStoreAdapter } from '@igniter-js/adapter-redis'
+import { redis } from './redis'
+
+/**
+ * Store adapter for data persistence.
+ *
+ * @remarks
+ * Provides a unified interface for data storage operations using Redis.
+ *
+ * @see https://igniterjs.com/docs/store
+ */
+export const store = createRedisStoreAdapter(redis)

package/templates/add-ons/logging/logger.ts.hbs

@@ -0,0 +1,14 @@
+import { createConsoleLogger, IgniterLogLevel } from '@igniter-js/core'
+
+/**
+ * Logger instance for application logging.
+ *
+ * @remarks
+ * Provides structured logging with configurable log levels.
+ *
+ * @see https://github.com/felipebarcelospro/igniter-js/tree/main/packages/core
+ */
+export const logger = createConsoleLogger({
+  level: IgniterLogLevel.INFO,
+  showTimestamp: true,
+})

package/templates/add-ons/mcp/mcp.ts.hbs

@@ -0,0 +1,21 @@
+import { IgniterMcpServer } from '@igniter-js/adapter-mcp-server';
+import { AppRouter } from '@/igniter.router';
+
+/**
+ * Create the MCP server using the builder pattern.
+ * This provides full type inference and a fluent API.
+ *
+ * @see https://igniterjs.com/docs/mcp-server
+ */
+export const mcpServer = IgniterMcpServer
+  .create()
+  .router(AppRouter)
+  .withServerInfo({
+    name: '{{capitalizeSlug projectName}} MCP Server',
+    version: '1.0.0',
+  })
+  .withAdapter({
+    redisUrl: process.env.REDIS_URL!,
+    basePath: process.env.IGNITER_MCP_SERVER_BASE_PATH || '/mcp'
+  })
+  .build();

package/templates/add-ons/mcp/nextjs/route-handler.hbs

@@ -0,0 +1,11 @@
+import { mcpServer } from '@/igniter.mcp';
+
+/**
+ * Export the handler for Next.js to handle both GET and POST requests,
+ * which are used by different MCP transport methods (like SSE and WebSockets).
+ */
+export const GET = mcpServer.handler;
+export const POST = mcpServer.handler;
+export const PUT = mcpServer.handler;
+export const DELETE = mcpServer.handler;
+export const PATCH = mcpServer.handler;

package/templates/add-ons/mcp/tanstack-start/route-handler.hbs

@@ -0,0 +1,19 @@
+import { createFileRoute } from '@tanstack/react-router';
+import { mcpServer } from '@/igniter.mcp';
+
+  /**
+   * @description TanStack Start route handler adapter for Igniter.js
+   * @see https://igniterjs.com/docs/core/tanstack-start
+   */
+  export const Route = createFileRoute('/mcp/$')({
+    server: {
+      handlers: {
+        GET: ({ request }) => mcpServer.handler(request),
+        POST: ({ request }) => mcpServer.handler(request),
+        PUT: ({ request }) => mcpServer.handler(request),
+        DELETE: ({ request }) => mcpServer.handler(request),
+        PATCH: ({ request }) => mcpServer.handler(request),
+      },
+    }
+  })
+  

package/templates/add-ons/store/redis.ts.hbs

@@ -0,0 +1,13 @@
+import { Redis } from 'ioredis'
+
+/**
+ * Redis client instance for caching, session storage, and pub/sub.
+ *
+ * @remarks
+ * Used for caching, session management, and real-time messaging.
+ *
+ * @see https://github.com/luin/ioredis
+ */
+export const redis = new Redis(process.env.REDIS_URL!, {
+  maxRetriesPerRequest: null,
+})

package/templates/add-ons/store/store.ts.hbs

@@ -0,0 +1,12 @@
+import { createRedisStoreAdapter } from '@igniter-js/adapter-redis'
+import { redis } from './redis'
+
+/**
+ * Store adapter for data persistence.
+ *
+ * @remarks
+ * Provides a unified interface for data storage operations using Redis.
+ *
+ * @see https://igniterjs.com/docs/store
+ */
+export const store = createRedisStoreAdapter(redis)

package/templates/add-ons/telemetry/telemetry.ts.hbs

@@ -0,0 +1,20 @@
+import { createConsoleTelemetryAdapter } from '@igniter-js/core/adapters'
+import { store } from './store'
+
+/**
+ * Telemetry service for tracking requests and errors.
+ *
+ * @remarks
+ * Provides telemetry tracking with configurable options.
+ *
+ * @see https://github.com/felipebarcelospro/igniter-js/tree/main/packages/core
+ */
+export const telemetry = createConsoleTelemetryAdapter({
+  serviceName: '{{capitalizeSlug projectName}}',
+  enableEvents: process.env.IGNITER_TELEMETRY_ENABLE_EVENTS === 'true',
+  enableMetrics: process.env.IGNITER_TELEMETRY_ENABLE_METRICS === 'true',
+  enableTracing: process.env.IGNITER_TELEMETRY_ENABLE_TRACING === 'true',
+}, {
+  enableCliIntegration: process.env.IGNITER_TELEMETRY_ENABLE_CLI_INTEGRATION === 'true',
+  store: store
+})

package/templates/generate/feature/empty.controller.hbs

@@ -0,0 +1,20 @@
+{{!--
+  @generated by @igniter-js/new-cli
+  @description Basic controller scaffold for a new feature
+--}}
+import { igniter } from '@/igniter'
+
+export const {{controllerExport}} = igniter.controller({
+  name: '{{controllerDisplayName}}',
+  path: '/{{controllerRoute}}',
+  actions: {
+    hello: igniter.query({
+      name: 'Hello',
+      description: 'Demonstration endpoint',
+      path: '/hello',
+      handler: async ({ response }) => {
+        return response.success({ message: 'Hello from {{controllerDisplayName}}!' })
+      },
+    }),
+  },
+})

package/templates/generate/feature/empty.interfaces.hbs

@@ -0,0 +1,5 @@
+{{!--
+  @generated by @igniter-js/new-cli
+  @description Placeholder interfaces file for a new feature
+--}}
+// Define Zod schemas and TypeScript types for the {{featureName}} feature here.

package/templates/generate/feature/procedure.hbs

@@ -0,0 +1,23 @@
+{{!--
+  @generated by @igniter-js/new-cli
+  @description Basic procedure scaffold for the {{featureName}} feature
+--}}
+import { igniter } from '@/igniter'
+
+export const {{procedureExport}} = igniter.procedure({
+  name: '{{procedureDisplayName}}',
+  handler: async () => {
+    return {
+      {{procedureExport}}: {
+        services: {
+          example: () => {
+            return {
+              message: 'Hello from {{procedureDisplayName}}!',
+              timestamp: new Date().toISOString(),
+            }
+          },
+        },
+      },
+    }
+  },
+})

package/templates/generate/feature/schema.controller.hbs

@@ -0,0 +1,73 @@
+{{!--
+  @generated by @igniter-js/new-cli
+  @description CRUD controller generated from the {{modelName}} Prisma model
+--}}
+import { igniter } from '@/igniter'
+import { {{procedureExport}} } from '../procedures/{{featureName}}.procedure'
+import { Create{{modelName}}InputSchema, Update{{modelName}}InputSchema } from '../{{featureName}}.interfaces'
+
+export const {{controllerExport}} = igniter.controller({
+  name: '{{controllerDisplayName}}',
+  description: 'REST endpoints for {{modelNamePlural}}',
+  path: '/{{resourcePath}}',
+  actions: {
+    list: igniter.query({
+      name: 'List',
+      description: 'List {{modelNamePlural}}',
+      path: '/',
+      use: [{{procedureExport}}()],
+      handler: async ({ context, response }) => {
+        const records = await context.{{procedureExport}}.services.findAll()
+        return response.success(records)
+      },
+    }),
+    getById: igniter.query({
+      name: 'Get By Id',
+      description: 'Get {{modelName}} by id',
+      path: '/:id' as const,
+      use: [{{procedureExport}}()],
+      handler: async ({ request, context, response }) => {
+        const record = await context.{{procedureExport}}.services.findById(request.params.id)
+        if (!record) {
+          return response.notFound('{{modelName}} not found')
+        }
+        return response.success(record)
+      },
+    }),
+    create: igniter.mutation({
+      name: 'Create',
+      description: 'Create {{modelName}}',
+      path: '/',
+      method: 'POST',
+      body: Create{{modelName}}InputSchema,
+      use: [{{procedureExport}}()],
+      handler: async ({ request, context, response }) => {
+        const created = await context.{{procedureExport}}.services.create(request.body)
+        return response.created(created)
+      },
+    }),
+    update: igniter.mutation({
+      name: 'Update',
+      description: 'Update {{modelName}}',
+      path: '/:id' as const,
+      method: 'PUT',
+      body: Update{{modelName}}InputSchema,
+      use: [{{procedureExport}}()],
+      handler: async ({ request, context, response }) => {
+        const updated = await context.{{procedureExport}}.services.update(request.params.id, request.body)
+        return response.success(updated)
+      },
+    }),
+    delete: igniter.mutation({
+      name: 'Delete',
+      description: 'Delete {{modelName}}',
+      path: '/:id' as const,
+      method: 'DELETE',
+      use: [{{procedureExport}}()],
+      handler: async ({ request, context, response }) => {
+        await context.{{procedureExport}}.services.delete(request.params.id)
+        return response.noContent()
+      },
+    }),
+  },
+})

package/templates/generate/feature/schema.interfaces.hbs

@@ -0,0 +1,23 @@
+{{!--
+  @generated by @igniter-js/new-cli
+  @description Zod schemas and TypeScript types generated from the {{modelName}} Prisma model
+--}}
+import { z } from 'zod'
+
+export const {{modelName}}Schema = z.object({
+{{#each fields}}
+  {{name}}: {{zodType}}{{#unless @last}},{{/unless}}
+{{/each}}
+})
+
+export const Create{{modelName}}InputSchema = {{modelName}}Schema.omit({
+{{#each createOmitFields}}
+  {{this}}: true{{#unless @last}},{{/unless}}
+{{/each}}
+})
+
+export const Update{{modelName}}InputSchema = Create{{modelName}}InputSchema.partial()
+
+export type {{modelName}} = z.infer<typeof {{modelName}}Schema>
+export type Create{{modelName}}Input = z.infer<typeof Create{{modelName}}InputSchema>
+export type Update{{modelName}}Input = z.infer<typeof Update{{modelName}}InputSchema>

package/templates/generate/feature/schema.procedure.hbs

@@ -0,0 +1,23 @@
+{{!--
+  @generated by @igniter-js/new-cli
+  @description CRUD procedure generated from the {{modelName}} Prisma model
+--}}
+import { igniter } from '@/igniter'
+import type { Create{{modelName}}Input, Update{{modelName}}Input } from '../{{featureName}}.interfaces'
+
+export const {{procedureExport}} = igniter.procedure({
+  name: '{{procedureDisplayName}}',
+  handler: async (_options, { context }) => {
+    return {
+      {{procedureExport}}: {
+        services: {
+          findAll: () => context.services.database.{{prismaDelegate}}.findMany(),
+          findById: (id: {{idType}}) => context.services.database.{{prismaDelegate}}.findUnique({ where: { id } }),
+          create: (data: Create{{modelName}}Input) => context.services.database.{{prismaDelegate}}.create({ data }),
+          update: (id: {{idType}}, data: Update{{modelName}}Input) => context.services.database.{{prismaDelegate}}.update({ where: { id }, data }),
+          delete: (id: {{idType}}) => context.services.database.{{prismaDelegate}}.delete({ where: { id } }),
+        }
+      }
+    }
+  }
+})

package/templates/scaffold/example-feature/example.controller.hbs

@@ -0,0 +1,23 @@
+import { igniter } from '@/igniter'
+import { ExampleProcedure } from '../procedures/example.procedure'
+
+/**
+ * @description Example controller demonstrating Igniter.js features
+ * @see https://igniterjs.com/docs/core/controllers
+ */
+export const ExampleController = igniter.controller({
+  name: 'Example',
+  path: '/example',
+  actions: {
+    // Health check action
+    health: igniter.query({
+      name: 'health',
+      description: 'Health check',
+      path: '/',
+      use: [ExampleProcedure()],
+      handler: async ({ request, response, context }) => {
+        return response.success(context.example.hello())
+      }
+    }),
+  }
+})

package/templates/scaffold/example-feature/example.interfaces.hbs

@@ -0,0 +1,14 @@
+/**
+ * Example feature interfaces and types
+ * @description Define your feature's types here
+ */
+export interface ExampleHelloResponse {
+  status: string
+  timestamp: string
+  features: {
+    store: boolean
+    jobs: boolean
+    logging: boolean
+    telemetry: boolean
+  }
+}