@igniter-js/cli 0.4.4 → 0.4.6

package/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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/dist/templates/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
+  }
+}

package/dist/templates/templates/scaffold/example-feature/example.procedure.hbs

@@ -0,0 +1,28 @@
+import { igniter } from "@/igniter";
+import type { ExampleHelloResponse } from "../example.interfaces";
+
+/**
+ * @description Example procedure demonstrating Igniter.js features
+ * @see https://igniterjs.com/docs/core/procedures
+ */
+export const ExampleProcedure = igniter.procedure({
+  name: 'ExampleProcedure',
+  handler(options, { request, response, context }) {
+    return {
+      example: {
+        hello: (): ExampleHelloResponse => {
+          return {
+            status: 'ok',
+            timestamp: new Date().toISOString(),
+            features: {
+              store: !!igniter.store,
+              jobs: !!igniter.jobs,
+              logging: !!igniter.logger,
+              telemetry: !!igniter.telemetry,
+            }
+          }
+        }
+      }
+    }
+  },
+})

package/dist/templates/templates/scaffold/igniter.schema.hbs

@@ -0,0 +1,21 @@
+/* eslint-disable */
+/* prettier-ignore */
+
+/**
+ * Generated by @igniter-js/cli
+ *
+ * WARNING: DO NOT EDIT THIS FILE MANUALLY
+ *
+ * This file was automatically generated from your Igniter router.
+ * Any changes made to this file will be overwritten when the CLI regenerates it.
+ *
+ * To modify the client API, update your controller files instead.
+ *
+ * Generated: {{generatedAt}}
+ */
+
+// Generated by @igniter-js/cli - DO NOT EDIT
+
+export const AppRouterSchema = {{{schemaString}}} as const
+
+export type AppRouterSchemaType = typeof AppRouterSchema

package/dist/templates/templates/starters/igniter.client.hbs

@@ -0,0 +1,52 @@
+/* eslint-disable */
+/* prettier-ignore */
+/* biome-ignore */
+
+import { createIgniterClient, useIgniterQueryClient } from '@igniter-js/core/client'
+import type { AppRouterType } from './igniter.router'
+
+/**
+ * ⚠️ WARNING! ⚠️
+ * 
+ * This file is auto-generated. 
+ * DO NOT EDIT OR MODIFY THIS FILE DIRECTLY!
+ * Your changes will be lost if this file is regenerated.
+ * 
+ * Any manual changes should be made in your source router or schema files.
+ * For more information, visit:
+ * https://igniterjs.com/docs/core/client
+ */
+
+ 
+/**
+* Type-safe API client generated from your Igniter router
+*
+* Usage in Server Components:
+* const users = await api.users.list.query()
+*
+* Usage in Client Components:
+* const { data } = api.users.list.useQuery()
+*
+* Note: Adjust environment variable prefixes (e.g., NEXT_PUBLIC_, BUN_PUBLIC_, DENO_PUBLIC_, REACT_APP_)
+* @see https://igniterjs.com/docs/core/client
+*/
+export const api = createIgniterClient<AppRouterType>({
+  baseURL: process.env.IGNITER_API_URL || 'http://localhost:3000',
+  basePATH: process.env.IGNITER_API_BASE_PATH || '/api/v1',
+  router: () => {
+    if (typeof window === 'undefined') {
+      return require('./igniter.router').AppRouter
+    }
+
+    return require('./igniter.schema').AppRouterSchema
+  },
+})
+
+/**
+  * Type-safe query client generated from your Igniter router
+  *
+  * Usage in Client Components:
+  * const { invalidate } = useQueryClient()
+  * @see https://igniterjs.com/docs/core/client
+  */
+export const useQueryClient = useIgniterQueryClient<AppRouterType>;

package/dist/templates/templates/starters/igniter.context.hbs

@@ -0,0 +1,10 @@
+
+/**
+ * @description Create the context of the Igniter.js application
+ * @see https://igniterjs.com/docs/core/context
+ */
+export const createIgniterAppContext = () => {
+  return {
+    // Add application-wide context properties here, like database clients.
+  }
+}