@dudousxd/nestjs-codegen 0.2.0

package/dist/nest/index.d.cts

@@ -0,0 +1,67 @@
+import { DynamicModule, OnApplicationBootstrap, OnModuleDestroy } from '@nestjs/common';
+import { U as UserConfig } from '../index-BwIRjOQA.cjs';
+import 'ts-morph';
+
+/**
+ * Options for {@link NestjsCodegenModule.forRoot}. These ARE the codegen config —
+ * no `nestjs-codegen.config.ts` file is required. Import the module in your root
+ * `AppModule` and the typed client regenerates as you edit your controllers:
+ *
+ * @example
+ * ```ts
+ * import { NestjsCodegenModule } from '@dudousxd/nestjs-codegen/nest';
+ *
+ * @Module({
+ *   imports: [
+ *     NestjsCodegenModule.forRoot({
+ *       contracts: { glob: 'src/**\/*.controller.ts' },
+ *       codegen: { outDir: 'src/generated' },
+ *       extensions: [tanstackQuery()],
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+interface CodegenModuleOptions extends UserConfig {
+    /**
+     * Master switch for the boot-time watcher. When omitted, the watcher runs in every
+     * environment EXCEPT production (`process.env.NODE_ENV === 'production'`) — codegen is a
+     * dev/CI build step, not a production-runtime concern. Set `false` to disable entirely,
+     * or `true` to force it on even in production.
+     */
+    enabled?: boolean;
+    /** Project root used to resolve globs / `outDir`. Defaults to `process.cwd()`. */
+    cwd?: string;
+}
+/** DI token holding the raw {@link CodegenModuleOptions} passed to `forRoot`. */
+declare const CODEGEN_MODULE_OPTIONS: unique symbol;
+/**
+ * Decide whether the boot-time watcher should start, given the module options and the
+ * current `NODE_ENV`. Explicit `enabled` always wins; otherwise default on unless prod.
+ */
+declare function shouldRun(options: CodegenModuleOptions, env: string | undefined): boolean;
+/**
+ * Boots the codegen watcher on application start and tears it down on shutdown.
+ * The watcher does an initial full generate, then regenerates `routes.ts`/`api.ts`/
+ * `forms.ts` as controllers and DTOs change — mirroring `nestjs-codegen codegen --watch`,
+ * but driven by the Nest lifecycle so no separate process is needed in dev.
+ */
+declare class NestjsCodegenService implements OnApplicationBootstrap, OnModuleDestroy {
+    private readonly options;
+    private readonly logger;
+    private watcher;
+    constructor(options: CodegenModuleOptions);
+    onApplicationBootstrap(): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+}
+/**
+ * NestJS module that auto-starts the codegen watcher on app boot — the recommended way
+ * to wire `@dudousxd/nestjs-codegen` into a Nest app. For CI/pre-deploy, run the
+ * one-shot CLI (`nestjs-codegen codegen`) instead.
+ */
+declare class NestjsCodegenModule {
+    static forRoot(options?: CodegenModuleOptions): DynamicModule;
+}
+
+export { CODEGEN_MODULE_OPTIONS, type CodegenModuleOptions, NestjsCodegenModule, NestjsCodegenService, shouldRun };

package/dist/nest/index.d.ts

@@ -0,0 +1,67 @@
+import { DynamicModule, OnApplicationBootstrap, OnModuleDestroy } from '@nestjs/common';
+import { U as UserConfig } from '../index-BwIRjOQA.js';
+import 'ts-morph';
+
+/**
+ * Options for {@link NestjsCodegenModule.forRoot}. These ARE the codegen config —
+ * no `nestjs-codegen.config.ts` file is required. Import the module in your root
+ * `AppModule` and the typed client regenerates as you edit your controllers:
+ *
+ * @example
+ * ```ts
+ * import { NestjsCodegenModule } from '@dudousxd/nestjs-codegen/nest';
+ *
+ * @Module({
+ *   imports: [
+ *     NestjsCodegenModule.forRoot({
+ *       contracts: { glob: 'src/**\/*.controller.ts' },
+ *       codegen: { outDir: 'src/generated' },
+ *       extensions: [tanstackQuery()],
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+interface CodegenModuleOptions extends UserConfig {
+    /**
+     * Master switch for the boot-time watcher. When omitted, the watcher runs in every
+     * environment EXCEPT production (`process.env.NODE_ENV === 'production'`) — codegen is a
+     * dev/CI build step, not a production-runtime concern. Set `false` to disable entirely,
+     * or `true` to force it on even in production.
+     */
+    enabled?: boolean;
+    /** Project root used to resolve globs / `outDir`. Defaults to `process.cwd()`. */
+    cwd?: string;
+}
+/** DI token holding the raw {@link CodegenModuleOptions} passed to `forRoot`. */
+declare const CODEGEN_MODULE_OPTIONS: unique symbol;
+/**
+ * Decide whether the boot-time watcher should start, given the module options and the
+ * current `NODE_ENV`. Explicit `enabled` always wins; otherwise default on unless prod.
+ */
+declare function shouldRun(options: CodegenModuleOptions, env: string | undefined): boolean;
+/**
+ * Boots the codegen watcher on application start and tears it down on shutdown.
+ * The watcher does an initial full generate, then regenerates `routes.ts`/`api.ts`/
+ * `forms.ts` as controllers and DTOs change — mirroring `nestjs-codegen codegen --watch`,
+ * but driven by the Nest lifecycle so no separate process is needed in dev.
+ */
+declare class NestjsCodegenService implements OnApplicationBootstrap, OnModuleDestroy {
+    private readonly options;
+    private readonly logger;
+    private watcher;
+    constructor(options: CodegenModuleOptions);
+    onApplicationBootstrap(): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+}
+/**
+ * NestJS module that auto-starts the codegen watcher on app boot — the recommended way
+ * to wire `@dudousxd/nestjs-codegen` into a Nest app. For CI/pre-deploy, run the
+ * one-shot CLI (`nestjs-codegen codegen`) instead.
+ */
+declare class NestjsCodegenModule {
+    static forRoot(options?: CodegenModuleOptions): DynamicModule;
+}
+
+export { CODEGEN_MODULE_OPTIONS, type CodegenModuleOptions, NestjsCodegenModule, NestjsCodegenService, shouldRun };