workspai 0.43.0

package/templates/kits/nestjs-standard/src/examples/examples.controller.ts.j2

@@ -0,0 +1,24 @@
+import { Body, Controller, Get, Param, ParseIntPipe, Post } from '@nestjs/common';
+
+import { CreateNoteDto } from './dto/create-note.dto';
+import { ExamplesService } from './examples.service';
+
+@Controller('examples/notes')
+export class ExamplesController {
+  constructor(private readonly examplesService: ExamplesService) {}
+
+  @Post()
+  create(@Body() payload: CreateNoteDto) {
+    return this.examplesService.create(payload);
+  }
+
+  @Get()
+  findAll() {
+    return this.examplesService.findAll();
+  }
+
+  @Get(':id')
+  findOne(@Param('id', ParseIntPipe) id: number) {
+    return this.examplesService.findOne(id);
+  }
+}

package/templates/kits/nestjs-standard/src/examples/examples.module.ts.j2

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+
+import { ExamplesController } from './examples.controller';
+import { ExamplesService } from './examples.service';
+
+@Module({
+  controllers: [ExamplesController],
+  providers: [ExamplesService],
+})
+export class ExamplesModule {}

package/templates/kits/nestjs-standard/src/examples/examples.service.ts.j2

@@ -0,0 +1,33 @@
+import { Injectable, NotFoundException } from '@nestjs/common';
+
+import { CreateNoteDto } from './dto/create-note.dto';
+
+export interface ExampleNote {
+  id: number;
+  title: string;
+  body: string;
+}
+
+@Injectable()
+export class ExamplesService {
+  private notes: ExampleNote[] = [];
+  private sequence = 1;
+
+  create(payload: CreateNoteDto): ExampleNote {
+    const note: ExampleNote = { id: this.sequence++, ...payload };
+    this.notes.push(note);
+    return note;
+  }
+
+  findAll(): ExampleNote[] {
+    return [...this.notes];
+  }
+
+  findOne(id: number): ExampleNote {
+    const note = this.notes.find((entry) => entry.id === id);
+    if (!note) {
+      throw new NotFoundException('Note not found');
+    }
+    return note;
+  }
+}

package/templates/kits/nestjs-standard/src/main.ts.j2

@@ -0,0 +1,53 @@
+import { Logger } from '@nestjs/common';
+import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger';
+import { NestFactory } from '@nestjs/core';
+import helmet from 'helmet';
+import compression from 'compression';
+
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule, {
+    bufferLogs: true,
+  });
+
+  const logger = new Logger('Bootstrap');
+
+  app.use(helmet());
+  app.use(compression());
+
+  app.enableCors({
+    origin: '*',
+    credentials: true,
+  });
+
+  // <<<inject:global-middleware>>>
+
+  const port = parseInt(process.env.PORT ?? '8000', 10);
+  const host = process.env.HOST ?? '0.0.0.0';
+
+  // Enable Swagger docs in development or when explicitly requested.
+  const enableDocs = process.env.RAPIDKIT_ENABLE_SWAGGER === '1' || process.env.NODE_ENV !== 'production';
+  if (enableDocs) {
+    const config = new DocumentBuilder()
+      .setTitle('{{ project_name | default("Workspai App") }} API')
+      .setDescription('Auto-generated API docs')
+      .setVersion('{{ app_version | default("1.0.0") }}')
+      .addBearerAuth()
+      .build();
+
+    const document = SwaggerModule.createDocument(app, config);
+    SwaggerModule.setup('docs', app, document);
+  }
+
+  await app.listen(port, host);
+
+  logger.log(`🚀 Application is running on http://${host}:${port}`);
+  // <<<inject:bootstrap-hooks>>>
+}
+
+bootstrap().catch((error) => {
+  // eslint-disable-next-line no-console
+  console.error('❌ Failed to bootstrap application', error);
+  process.exit(1);
+});

package/templates/kits/nestjs-standard/src/modules/index.ts.j2

@@ -0,0 +1,25 @@
+/* eslint-disable @typescript-eslint/no-var-requires, @typescript-eslint/no-require-imports, global-require */
+
+import type { DynamicModule, Type } from '@nestjs/common';
+
+// Central export for dynamically injected RapidKit Core modules
+
+type ModuleRef = DynamicModule | Type<unknown>;
+
+const registerOptionalModule = (loader: () => ModuleRef | null | undefined): ModuleRef | null => {
+	try {
+		const resolved = loader();
+		return resolved ?? null;
+	} catch {
+		return null;
+	}
+};
+
+const optionalModules: Array<ModuleRef | null> = [
+	registerOptionalModule(() => require('../config/logging.module').LoggingModule as ModuleRef),
+	registerOptionalModule(() => require('../config/settings.module').SettingsModule as ModuleRef),
+	registerOptionalModule(() => require('../deployment/deployment.module').DeploymentModule as ModuleRef),
+	// <<<inject:module-exports>>>
+];
+
+export const rapidkitModules: ModuleRef[] = optionalModules.filter(Boolean) as ModuleRef[];

package/templates/kits/nestjs-standard/test/app.controller.spec.ts.j2

@@ -0,0 +1,24 @@
+import { Test, TestingModule } from '@nestjs/testing';
+
+import { AppController } from '../src/app.controller';
+import { AppService } from '../src/app.service';
+
+describe('AppController', () => {
+  let appController: AppController;
+
+  beforeEach(async () => {
+    const app: TestingModule = await Test.createTestingModule({
+      controllers: [AppController],
+      providers: [AppService],
+    }).compile();
+
+    appController = app.get<AppController>(AppController);
+  });
+
+  it('should return health status', () => {
+    const result = appController.getHealth();
+    expect(result).toHaveProperty('status', 'ok');
+  });
+
+  // <<<inject:controller-tests>>>
+});

package/templates/kits/nestjs-standard/test/app.e2e-spec.ts.j2

@@ -0,0 +1,60 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { INestApplication } from '@nestjs/common';
+import request from 'supertest';
+
+import { AppModule } from '../src/app.module';
+
+describe('AppController (e2e)', () => {
+  let app: INestApplication;
+
+  beforeAll(async () => {
+    const moduleFixture: TestingModule = await Test.createTestingModule({
+      imports: [AppModule],
+    }).compile();
+
+    app = moduleFixture.createNestApplication();
+    await app.init();
+  });
+
+  afterAll(async () => {
+    await app.close();
+  });
+
+  it('/health (GET)', () => {
+    return request(app.getHttpServer())
+      .get('/health')
+      .expect(200)
+      .expect((res) => {
+        expect(res.body).toEqual(
+          expect.objectContaining({
+            status: 'ok',
+            timestamp: expect.any(String),
+            version: expect.any(String),
+            uptime: expect.any(Number),
+            module: expect.any(String),
+          }),
+        );
+      });
+  });
+
+  it('/examples/notes (POST + GET)', async () => {
+    const server = app.getHttpServer();
+    const createResponse = await request(server)
+      .post('/examples/notes')
+      .send({ title: 'ddd', body: 'documented via e2e' })
+      .expect(201);
+
+    const noteId = createResponse.body.id;
+
+    await request(server)
+      .get('/examples/notes')
+      .expect(200)
+      .expect((res) => {
+        expect(res.body).toEqual(
+          expect.arrayContaining([expect.objectContaining({ id: noteId, title: 'ddd' })]),
+        );
+      });
+  });
+
+  // <<<inject:e2e-tests>>>
+});

package/templates/kits/nestjs-standard/test/examples.controller.spec.ts.j2

@@ -0,0 +1,28 @@
+import { Test, TestingModule } from '@nestjs/testing';
+
+import { ExamplesController } from '../src/examples/examples.controller';
+import { ExamplesService } from '../src/examples/examples.service';
+
+describe('ExamplesController', () => {
+  let controller: ExamplesController;
+
+  beforeEach(async () => {
+    const module: TestingModule = await Test.createTestingModule({
+      controllers: [ExamplesController],
+      providers: [ExamplesService],
+    }).compile();
+
+    controller = module.get<ExamplesController>(ExamplesController);
+  });
+
+  it('creates and retrieves notes', () => {
+    const created = controller.create({ title: 'spec', body: 'covered by tests' });
+    expect(created).toMatchObject({ id: 1, title: 'spec' });
+
+    const list = controller.findAll();
+    expect(list).toHaveLength(1);
+
+    const single = controller.findOne(created.id);
+    expect(single).toMatchObject({ id: created.id, title: 'spec' });
+  });
+});

package/templates/kits/nestjs-standard/test/jest-e2e.json.j2

@@ -0,0 +1,15 @@
+{
+  "moduleFileExtensions": ["js", "json", "ts"],
+  "rootDir": "../",
+  "testEnvironment": "node",
+  "testRegex": ".e2e-spec.ts$",
+  "transform": {
+    "^.+\\.ts$": "ts-jest"
+  },
+  "setupFiles": ["dotenv/config"],
+  "moduleNameMapper": {
+    "^@config/(.*)$": "<rootDir>/src/config/$1",
+    "^@modules/(.*)$": "<rootDir>/src/modules/$1",
+    "^@shared/(.*)$": "<rootDir>/src/shared/$1"
+  }
+}

package/templates/kits/nestjs-standard/tsconfig.build.json.j2

@@ -0,0 +1,12 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "declaration": true,
+    "sourceMap": false,
+    "removeComments": true,
+    "incremental": false
+  },
+  "exclude": ["node_modules", "test", "src/**/*.spec.ts", "src/**/*.e2e-spec.ts"],
+  "include": ["src/.workspai/**/*.ts", "src/.rapidkit/**/*.ts", "src/**/*.ts"]
+}

package/templates/kits/nestjs-standard/tsconfig.json.j2

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "es2021",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "incremental": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "paths": {
+      "@config/*": ["src/config/*"],
+      "@modules/*": ["src/modules/*"],
+      "@shared/*": ["src/shared/*"]
+    }
+  },
+  "exclude": ["node_modules", "dist"],
+  "include": ["src/.workspai/**/*.ts", "src/.rapidkit/**/*.ts", "src/**/*.ts", "test/**/*.ts"]
+}

package/workspai.config.example.cjs

@@ -0,0 +1,62 @@
+/**
+ * Workspai Configuration File
+ *
+ * Place this file in your project root as:
+ * - workspai.config.cjs (CommonJS explicit, safest across package types)
+ * - workspai.config.mjs (ES Module, use export default)
+ * - workspai.config.js (only when it matches your package.json module type)
+ *
+ * Legacy rapidkit.config.* files are still read during migration, but new
+ * projects should prefer workspai.config.cjs or workspai.config.mjs.
+ *
+ * This file is automatically detected when creating workspaces or projects.
+ * CLI arguments override config file settings.
+ */
+
+module.exports = {
+  // Workspace configuration
+  workspace: {
+    // Default author name for new workspaces
+    defaultAuthor: 'Your Name or Team',
+
+    // Default Python version to use
+    // Options: '3.10' | '3.11' | '3.12'
+    pythonVersion: '3.10',
+
+    // Default installation method for RapidKit Core
+    // Options: 'poetry' | 'venv' | 'pipx'
+    installMethod: 'poetry',
+  },
+
+  // Project configuration
+  projects: {
+    // Default kit/template to use when creating projects
+    // Examples: 'fastapi.standard', 'fastapi.ddd', 'nestjs.standard'
+    defaultKit: 'fastapi.standard',
+
+    // Default modules to add to new projects
+    // These modules will be automatically added after project creation
+    addDefaultModules: [
+      // 'prisma',          // Database ORM
+      // 'redis',           // Caching
+      // 'auth-jwt',        // JWT Authentication
+      // 'monitoring',      // Monitoring and logging
+    ],
+
+    // Skip git initialization by default
+    skipGit: false,
+
+    // Skip dependency installation by default
+    skipInstall: false,
+  },
+};
+
+// Example usage:
+// npx workspai my-workspace
+// -> Uses config: author='Your Name or Team', pythonVersion='3.10', installMethod='poetry'
+//
+// npx workspai my-workspace --author "Different Author"
+// -> Overrides: author='Different Author', but still uses pythonVersion='3.10', installMethod='poetry'
+//
+// npx workspai create project my-api
+// -> Uses config: defaultKit='fastapi.standard', adds default modules