@flusys/nestjs-event-manager 4.0.2 → 4.1.0

package/README.md

@@ -1,152 +1,80 @@
-# Event Manager Package Guide
+# @flusys/nestjs-event-manager
 
-> **Package:** `@flusys/nestjs-event-manager`
-> **Version:** 4.0.2
-> **Type:** Calendar event management with recurrence support and multi-tenant capabilities
+> Calendar event management for NestJS — recurrence patterns (DAILY, WEEKLY, BIWEEKLY, MONTHLY), participant tracking with status, company scoping, and a cross-module adapter for dependency-free integration.
 
-This comprehensive guide covers the event manager package - calendar-based event scheduling with participants and recurrence patterns.
+[![npm version](https://img.shields.io/npm/v/@flusys/nestjs-event-manager.svg)](https://www.npmjs.com/package/@flusys/nestjs-event-manager)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![NestJS](https://img.shields.io/badge/NestJS-11.x-red.svg)](https://nestjs.com/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18.x-green.svg)](https://nodejs.org/)
+
+---
 
 ## Table of Contents
 
 - [Overview](#overview)
+- [Features](#features)
+- [Compatibility](#compatibility)
 - [Installation](#installation)
-- [Constants](#constants)
-- [Package Architecture](#package-architecture)
-- [Module Setup](#module-setup)
+- [Quick Start](#quick-start)
+- [Module Registration](#module-registration)
+  - [forRoot (Sync)](#forroot-sync)
+  - [forRootAsync (Factory)](#forrootasync-factory)
+- [Configuration Reference](#configuration-reference)
+- [API Endpoints](#api-endpoints)
 - [Entities](#entities)
-- [Services](#services)
-- [Controllers](#controllers)
-- [DTOs](#dtos)
-- [Recurrence Handling](#recurrence-handling)
-- [REST API Endpoints](#rest-api-endpoints)
-- [DataSource Provider Pattern](#datasource-provider-pattern)
-- [Multi-Tenant Support](#multi-tenant-support)
-- [Swagger Configuration](#swagger-configuration)
-- [Event Manager Adapter](#event-manager-adapter)
-- [Best Practices](#best-practices)
-- [API Reference](#api-reference)
+- [Recurrence Patterns](#recurrence-patterns)
+- [Participant Status](#participant-status)
+- [Cross-Module Adapter (EVENT_MANAGER_ADAPTER)](#cross-module-adapter-event_manager_adapter)
+- [Exported Services](#exported-services)
+- [Programmatic Usage](#programmatic-usage)
+- [Troubleshooting](#troubleshooting)
+- [License](#license)
 
 ---
 
 ## Overview
 
-`@flusys/nestjs-event-manager` provides a comprehensive event management system:
-
-- **Event CRUD** - Create, read, update, delete events with rich metadata
-- **Recurrence Support** - Daily, weekly, biweekly, and monthly patterns
-- **Participant Management** - Track event participants with status
-- **Calendar Queries** - Date range queries with recurrence expansion
-- **Adapter Pattern** - Cross-module event creation without direct dependencies
-- **Company Scoping** - Per-company event isolation
-- **Multi-Tenant Support** - Separate databases per tenant
-
-### Package Hierarchy
-
-```
-@flusys/nestjs-core     <- Foundation
-     |
-@flusys/nestjs-shared   <- Shared utilities
-     |
-@flusys/nestjs-event-manager <- Event management (THIS PACKAGE)
-```
+`@flusys/nestjs-event-manager` provides a structured calendar event system with rich recurrence support and per-user participant tracking. The module exposes an `EVENT_MANAGER_ADAPTER` injection token so other modules (Notification, Email) can create events without taking a direct dependency on this package.
 
 ---
 
-## Installation
+## Features
 
-```bash
-npm install @flusys/nestjs-event-manager @flusys/nestjs-shared @flusys/nestjs-core
-```
+- **Calendar events** — Title, description, meeting link, time range, color, all-day flag
+- **Recurrence engine** — NONE, DAILY, WEEKLY, BIWEEKLY, MONTHLY patterns with configurable end dates and day-of-week sets
+- **Participant tracking** — Per-user status: PENDING, ACCEPTED, DECLINED, TENTATIVE
+- **Organizer designation** — Mark specific participants as event organizer
+- **Company scoping** — Optional `companyId`/`branchId` on events
+- **Cross-module adapter** — `EVENT_MANAGER_ADAPTER` token for creating events without circular imports
+- **REQUEST-scoped services** — Dynamic entity resolution per HTTP request
+- **POST-only RPC** — All endpoints use `POST`
 
 ---
 
-## Constants
+## Compatibility
 
-```typescript
-// Injection Tokens
-export const EVENT_MANAGER_MODULE_OPTIONS = 'EVENT_MANAGER_MODULE_OPTIONS';
-
-// Adapter Token (from @flusys/nestjs-shared)
-export const EVENT_MANAGER_ADAPTER = 'EVENT_MANAGER_ADAPTER';
-
-// Permissions (from @flusys/nestjs-shared)
-export const EVENT_PERMISSIONS = {
-  CREATE: 'event.create',
-  READ: 'event.read',
-  UPDATE: 'event.update',
-  DELETE: 'event.delete',
-};
-
-export const EVENT_PARTICIPANT_PERMISSIONS = {
-  CREATE: 'event_participant.create',
-  READ: 'event_participant.read',
-  UPDATE: 'event_participant.update',
-  DELETE: 'event_participant.delete',
-};
-```
+| Package | Version |
+|---------|---------|
+| `@flusys/nestjs-core` | `^4.0.0` |
+| `@flusys/nestjs-shared` | `^4.0.0` |
+| `@nestjs/core` | `^11.0.0` |
+| `typeorm` | `^0.3.0` |
+| Node.js | `>= 18.x` |
 
 ---
 
-## Package Architecture
+## Installation
 
-```
-nestjs-event-manager/
-├── src/
-│   ├── modules/
-│   │   └── event-manager.module.ts      # Main module with provider registration
-│   │
-│   ├── adapters/
-│   │   ├── event-manager.adapter.ts     # Adapter for cross-module usage
-│   │   └── index.ts
-│   │
-│   ├── config/
-│   │   ├── event-manager.constants.ts   # Module constants
-│   │   └── index.ts
-│   │
-│   ├── services/
-│   │   ├── event.service.ts                    # Event CRUD + calendar queries
-│   │   ├── event-participant.service.ts        # Participant CRUD
-│   │   ├── event-manager-config.service.ts     # Module configuration
-│   │   ├── event-manager-datasource.provider.ts # Dynamic entity loading
-│   │   ├── event-manager-helper.service.ts     # Helper for adapter (singleton)
-│   │   └── index.ts
-│   │
-│   ├── controllers/
-│   │   ├── event.controller.ts           # /event-manager/event/*
-│   │   ├── event-participant.controller.ts # /event-manager/participant/*
-│   │   └── index.ts
-│   │
-│   ├── entities/
-│   │   ├── event.entity.ts               # Event base
-│   │   ├── event-with-company.entity.ts  # Event with company
-│   │   ├── event-participant.entity.ts   # Participant entity
-│   │   └── index.ts
-│   │
-│   ├── dtos/
-│   │   ├── event.dto.ts                  # Event DTOs
-│   │   ├── event-participant.dto.ts      # Participant DTOs
-│   │   ├── calendar-query.dto.ts         # Calendar query DTO
-│   │   └── index.ts
-│   │
-│   ├── interfaces/
-│   │   ├── event.interface.ts            # IEvent, IEventParticipant, ICalendarEvent
-│   │   ├── event-manager-module.interface.ts # Module options
-│   │   └── index.ts
-│   │
-│   ├── enums/
-│   │   └── index.ts                      # Re-exports from @flusys/nestjs-shared
-│   │
-│   ├── docs/
-│   │   └── index.ts                      # Swagger config, permissions
-│   │
-│   └── index.ts                          # Main export file
+```bash
+npm install @flusys/nestjs-event-manager @flusys/nestjs-shared @flusys/nestjs-core
 ```
 
 ---
 
-## Module Setup
+## Quick Start
 
-### Basic Setup
+### Without Company Feature
 
 ```typescript
 import { Module } from '@nestjs/common';
@@ -155,25 +83,9 @@ import { EventManagerModule } from '@flusys/nestjs-event-manager';
 @Module({
   imports: [
     EventManagerModule.forRoot({
-      global: true,
-      includeController: true,
-      bootstrapAppConfig: {
-        databaseMode: 'single',
-        enableCompanyFeature: false,
-        permissionMode: 'RBAC',
-      },
-      config: {
-        defaultDatabaseConfig: {
-          type: 'postgres',
-          host: 'localhost',
-          port: 5432,
-          username: 'postgres',
-          password: 'password',
-          database: 'myapp',
-        },
-        defaultColor: '#3B82F6',
-        maxRecurrenceOccurrences: 365,
-      },
+      dataSource: appDataSource,      // TypeORM DataSource instance
+      enableCompanyFeature: false,
+      cacheInstance: hybridCache,     // HybridCache instance
     }),
   ],
 })
@@ -184,1145 +96,340 @@ export class AppModule {}
 
 ```typescript
 EventManagerModule.forRoot({
-  global: true,
-  includeController: true,
-  bootstrapAppConfig: {
-    databaseMode: 'single',
-    enableCompanyFeature: true,
-    permissionMode: 'FULL',
-  },
-  config: {
-    defaultDatabaseConfig: { /* ... */ },
-    defaultColor: '#3B82F6',
-    maxRecurrenceOccurrences: 365,
-  },
-});
-```
-
-### Async Configuration
-
-```typescript
-EventManagerModule.forRootAsync({
-  global: true,
-  includeController: true,
-  bootstrapAppConfig: {
-    databaseMode: 'single',
-    enableCompanyFeature: true,
-    permissionMode: 'FULL',
-  },
-  imports: [ConfigModule],
-  useFactory: async (configService: ConfigService) => ({
-    defaultDatabaseConfig: configService.getDatabaseConfig(),
-    defaultColor: configService.get('EVENT_DEFAULT_COLOR', '#3B82F6'),
-    maxRecurrenceOccurrences: configService.get('MAX_RECURRENCE', 365),
-  }),
-  inject: [ConfigService],
-});
+  dataSource: appDataSource,
+  enableCompanyFeature: true,   // Adds companyId/branchId to Event entity
+  cacheInstance: hybridCache,
+})
 ```
 
-### Configuration Options
-
-```typescript
-interface IEventManagerModuleConfig extends IDataSourceServiceOptions {
-  /** Default event color (default: '#3B82F6') */
-  defaultColor?: string;
-  /** Maximum recurrence occurrences to generate (default: 365) */
-  maxRecurrenceOccurrences?: number;
-}
-
-interface EventManagerModuleOptions extends IDynamicModuleConfig {
-  bootstrapAppConfig?: IBootstrapAppConfig;
-  config?: IEventManagerModuleConfig;
-}
-```
+After registration:
+- `EventController` at `/event-manager/event/*`
+- `EventParticipantController` at `/event-manager/participant/*`
+- `EVENT_MANAGER_ADAPTER` token is available for injection
 
 ---
 
-## Entities
-
-### Enums (from @flusys/nestjs-shared)
-
-The enums are defined in `@flusys/nestjs-shared/enums` and re-exported from this package for convenience:
-
-```typescript
-// Import from shared (canonical source)
-import { RecurrenceType, ParticipantStatus } from '@flusys/nestjs-shared/enums';
-
-// Or import from event-manager (re-export)
-import { RecurrenceType, ParticipantStatus } from '@flusys/nestjs-event-manager/enums';
-```
-
-**RecurrenceType:**
-
-```typescript
-export enum RecurrenceType {
-  NONE = 'none',
-  DAILY = 'daily',
-  WEEKLY = 'weekly',
-  BIWEEKLY = 'biweekly',
-  MONTHLY = 'monthly',
-}
-```
-
-**ParticipantStatus:**
-
-```typescript
-export enum ParticipantStatus {
-  PENDING = 'pending',
-  ACCEPTED = 'accepted',
-  DECLINED = 'declined',
-  TENTATIVE = 'tentative',
-}
-```
+## Module Registration
 
-### Entity Groups
+### forRoot (Sync)
 
 ```typescript
-// Core entities (no company feature)
-export const EventManagerCoreEntities = [Event, EventParticipant];
-
-// Company-specific entities
-export const EventManagerCompanyEntities = [EventWithCompany, EventParticipant];
+EventManagerModule.forRoot({
+  /** TypeORM DataSource connected to the application database */
+  dataSource: DataSource;
 
-// Helper function
-export function getEventManagerEntitiesByConfig(enableCompanyFeature: boolean): any[] {
-  return enableCompanyFeature ? EventManagerCompanyEntities : EventManagerCoreEntities;
-}
+  /** When true, Event entity includes companyId/branchId columns */
+  enableCompanyFeature: boolean;
 
-// Base type aliases
-export { Event as EventBase } from './event.entity';
-export { EventParticipant as EventParticipantBase } from './event-participant.entity';
+  /** Cache instance (HybridCache from nestjs-shared) */
+  cacheInstance: HybridCache;
+})
 ```
 
-### Event Entity
+### forRootAsync (Factory)
 
 ```typescript
-@Entity({ name: 'event' })
-@Index(['startDateTime', 'endDateTime'])
-@Index(['isActive'])
-export class Event extends Identity {
-  @Column({ type: 'varchar', length: 255 })
-  title!: string;
-
-  @Column({ type: 'text', nullable: true })
-  description!: string | null;
-
-  @Column({ type: 'varchar', length: 500, nullable: true })
-  meetingLink!: string | null;
-
-  @Column({ type: 'timestamp' })
-  @Index()
-  startDateTime!: Date;
-
-  @Column({ type: 'timestamp' })
-  endDateTime!: Date;
-
-  @Column({ type: 'boolean', default: false })
-  isAllDay!: boolean;
-
-  @Column({ type: 'varchar', length: 20, default: 'none' })
-  @Index()
-  recurrenceType!: string;
+import { EnvConfigService } from '@flusys/nestjs-core';
 
-  @Column({ type: 'timestamp', nullable: true })
-  recurrenceEndDate!: Date | null;
-
-  @Column({ type: 'varchar', length: 7, default: '#3B82F6' })
-  color!: string;
-
-  @Column({ type: 'boolean', default: true })
-  isActive!: boolean;
-
-  @Column({ type: 'simple-json', nullable: true })
-  metadata!: Record<string, unknown> | null;
-}
-
-// With company feature
-@Entity({ name: 'event' })
-@Index(['companyId', 'isActive'])
-export class EventWithCompany extends Event {
-  @Column({ type: 'uuid', nullable: true })
-  companyId!: string | null;
-}
+EventManagerModule.forRootAsync({
+  imports: [ConfigModule],
+  inject: [EnvConfigService],
+  useFactory: (envConfig: EnvConfigService) => ({
+    dataSource: envConfig.getDataSource(),
+    enableCompanyFeature: envConfig.isCompanyFeatureEnabled(),
+    cacheInstance: envConfig.getCacheInstance(),
+  }),
+})
 ```
 
-### EventParticipant Entity
-
-```typescript
-@Entity({ name: 'event_participant' })
-@Index(['eventId'])
-@Index(['userId'])
-@Index(['eventId', 'userId'], { unique: true })
-export class EventParticipant extends Identity {
-  @Column({ type: 'uuid' })
-  eventId!: string;
-
-  @Column({ type: 'uuid' })
-  userId!: string;
-
-  @Column({ type: 'varchar', length: 50, default: 'pending' })
-  status!: string;
-
-  @Column({ type: 'boolean', default: false })
-  isOrganizer!: boolean;
+**Registered providers:**
 
-  @Column({ type: 'simple-json', nullable: true })
-  metadata!: Record<string, unknown> | null;
-}
-```
+| Provider | Token | Scope |
+|----------|-------|-------|
+| Module options | `EVENT_MANAGER_MODULE_OPTIONS` | Singleton |
+| `EventManagerConfigService` | class | Singleton |
+| `EventManagerDataSourceProvider` | class | Singleton |
+| `EventService` | class | REQUEST |
+| `EventParticipantService` | class | REQUEST |
+| `EventManagerHelperService` | class | Singleton |
+| `EventManagerAdapter` | `EVENT_MANAGER_ADAPTER` | Singleton |
 
-**Note:** EventParticipant does NOT have a company variant - company context is inherited through the Event relationship.
+**Exported:** `EventManagerHelperService`, `EVENT_MANAGER_ADAPTER`, `EventManagerConfigService`
 
 ---
 
-## Services
-
-### EventService
-
-Handles event CRUD and calendar queries.
-
-```typescript
-@Injectable({ scope: Scope.REQUEST })
-export class EventService extends RequestScopedApiService<
-  CreateEventDto,
-  UpdateEventDto,
-  IEvent,
-  EventBase,
-  Repository<EventBase>
-> {
-  // Standard CRUD methods inherited
-
-  /** Get events for calendar date range with recurrence expansion */
-  async getEventsForCalendarRange(
-    dto: CalendarQueryDto,
-    user?: ILoggedUserInfo
-  ): Promise<ICalendarEvent[]>;
-
-  /** Get event with participant list */
-  async getEventWithParticipants(
-    eventId: string,
-    user?: ILoggedUserInfo
-  ): Promise<EventBase | null>;
-
-  /** Add participants to event */
-  async addParticipants(
-    dto: BulkAddParticipantsDto,
-    user?: ILoggedUserInfo
-  ): Promise<EventParticipantBase[]>;
-}
-```
-
-**Key Features:**
-- Dynamic entity resolution (Event vs EventWithCompany)
-- Automatic participant creation on event insert
-- Recurrence expansion for calendar queries
-- Company filtering when enabled
-
-### EventParticipantService
-
-Handles participant CRUD.
-
-```typescript
-@Injectable({ scope: Scope.REQUEST })
-export class EventParticipantService extends RequestScopedApiService<
-  CreateEventParticipantDto,
-  UpdateEventParticipantDto,
-  IEventParticipant,
-  EventParticipantBase,
-  Repository<EventParticipantBase>
-> {
-  // Standard CRUD methods inherited
-
-  /** Update participant status */
-  async updateStatus(
-    dto: UpdateParticipantStatusDto,
-    user?: ILoggedUserInfo
-  ): Promise<EventParticipantBase>;
-
-  /** Get participants for event */
-  async getParticipantsByEvent(eventId: string): Promise<EventParticipantBase[]>;
-
-  /** Get user's participations */
-  async getParticipantsByUser(userId: string): Promise<EventParticipantBase[]>;
-
-  /** Remove participant from event */
-  async removeParticipant(
-    eventId: string,
-    userId: string,
-    user?: ILoggedUserInfo
-  ): Promise<void>;
-}
-```
-
-### EventManagerConfigService
-
-Module configuration service.
+## Configuration Reference
 
 ```typescript
-@Injectable()
-export class EventManagerConfigService implements IModuleConfigService {
-  /** Check if company feature is enabled */
-  isCompanyFeatureEnabled(): boolean;
-
-  /** Get database mode */
-  getDatabaseMode(): 'single' | 'multi-tenant';
+interface IEventManagerModuleOptions {
+  /** Connected TypeORM DataSource */
+  dataSource: DataSource;
 
-  /** Check if multi-tenant mode */
-  isMultiTenant(): boolean;
+  /** When true, uses company-aware Event entity variant */
+  enableCompanyFeature: boolean;
 
-  /** Get default event color */
-  getDefaultColor(): string;
-
-  /** Get max recurrence occurrences */
-  getMaxRecurrenceOccurrences(): number;
+  /** HybridCache instance for caching */
+  cacheInstance: HybridCache;
 }
-```
-
-### EventManagerDataSourceProvider
-
-Dynamic entity loading with isolated cache.
 
-```typescript
-@Injectable({ scope: Scope.REQUEST })
-export class EventManagerDataSourceProvider extends MultiTenantDataSourceService {
-  // Static cache isolated from other modules
-  protected static override readonly tenantConnections = new Map<string, DataSource>();
-  protected static override singleDataSource: DataSource | null = null;
-
-  /** Get entities based on company feature */
-  async getEventManagerEntities(enableCompanyFeature?: boolean): Promise<any[]>;
-
-  /** Get company feature for current tenant */
-  getEnableCompanyFeatureForCurrentTenant(): boolean;
+interface IEventManagerModuleAsyncOptions {
+  imports?: ModuleMetadata['imports'];
+  inject?: any[];
+  useFactory: (...args: any[]) => IEventManagerModuleOptions | Promise<IEventManagerModuleOptions>;
 }
 ```
 
 ---
 
-## Controllers
-
-### EventController
-
-Base path: `/event-manager/event`
-
-```typescript
-@Controller('event-manager/event')
-@ApiTags('Event Manager - Events')
-@ApiBearerAuth()
-export class EventController extends createApiController<
-  CreateEventDto,
-  UpdateEventDto,
-  EventResponseDto,
-  IEvent,
-  EventService
->() {
-  // Inherited CRUD endpoints with permissions
-
-  @Post('calendar')
-  @UseGuards(JwtAuthGuard)
-  @RequirePermission(EVENT_PERMISSIONS.READ)
-  async getCalendarEvents(@Body() dto: CalendarQueryDto, @CurrentUser() user): Promise<ListResponseDto>;
-
-  @Post('get-with-participants')
-  @UseGuards(JwtAuthGuard)
-  @RequirePermission(EVENT_PERMISSIONS.READ)
-  async getWithParticipants(@Body() dto: { id: string }, @CurrentUser() user): Promise<SingleResponseDto>;
-
-  @Post('add-participants')
-  @UseGuards(JwtAuthGuard)
-  @RequirePermission(EVENT_PERMISSIONS.UPDATE)
-  async addParticipants(@Body() dto: BulkAddParticipantsDto, @CurrentUser() user): Promise<SingleResponseDto>;
-}
-```
-
-### EventParticipantController
-
-Base path: `/event-manager/participant`
+## API Endpoints
 
-```typescript
-@Controller('event-manager/participant')
-@ApiTags('Event Manager - Participants')
-@ApiBearerAuth()
-export class EventParticipantController extends createApiController<...>() {
-  // Inherited CRUD endpoints with permissions
-
-  @Post('update-status')
-  @UseGuards(JwtAuthGuard)
-  @RequirePermission(EVENT_PARTICIPANT_PERMISSIONS.UPDATE)
-  async updateStatus(@Body() dto: UpdateParticipantStatusDto, @CurrentUser() user): Promise<SingleResponseDto>;
-
-  @Post('get-by-event')
-  @UseGuards(JwtAuthGuard)
-  @RequirePermission(EVENT_PARTICIPANT_PERMISSIONS.READ)
-  async getByEvent(@Body() dto: { eventId: string }): Promise<ListResponseDto>;
-
-  @Post('get-by-user')
-  @UseGuards(JwtAuthGuard)
-  @RequirePermission(EVENT_PARTICIPANT_PERMISSIONS.READ)
-  async getByUser(@Body() dto: { userId: string }): Promise<ListResponseDto>;
-
-  @Post('remove')
-  @UseGuards(JwtAuthGuard)
-  @RequirePermission(EVENT_PARTICIPANT_PERMISSIONS.DELETE)
-  async remove(@Body() dto: { eventId: string; userId: string }, @CurrentUser() user): Promise<MessageResponseDto>;
-}
-```
+All endpoints use **POST** and require JWT authentication.
 
----
+### Events — `POST /event-manager/event/*`
 
-## DTOs
+| Endpoint | Permission | Description |
+|----------|-----------|-------------|
+| `POST /event-manager/event/insert` | `event.create` | Create a new calendar event |
+| `POST /event-manager/event/get-all` | `event.read` | List events with pagination and date filters |
+| `POST /event-manager/event/get/:id` | `event.read` | Get event by ID |
+| `POST /event-manager/event/update` | `event.update` | Update event details |
+| `POST /event-manager/event/delete` | `event.delete` | Delete event (and all participants) |
+| `POST /event-manager/event/get-my-events` | JWT | Get events where current user is a participant |
+| `POST /event-manager/event/get-by-date-range` | `event.read` | Get events within a date range |
 
-### CreateEventDto
+**Create event request:**
 
-```typescript
-export class CreateEventDto {
-  @IsNotEmpty()
-  @IsString()
-  @MaxLength(255)
-  title!: string;
-
-  @IsOptional()
-  @IsString()
-  description?: string;
-
-  @IsOptional()
-  @IsString()
-  @MaxLength(500)
-  meetingLink?: string;
-
-  @IsNotEmpty()
-  @IsDateString()
-  startDateTime!: Date;
-
-  @IsNotEmpty()
-  @IsDateString()
-  endDateTime!: Date;
-
-  @IsOptional()
-  @IsBoolean()
-  isAllDay?: boolean;
-
-  @IsOptional()
-  @IsEnum(RecurrenceType)
-  recurrenceType?: RecurrenceType;
-
-  @IsOptional()
-  @IsDateString()
-  recurrenceEndDate?: Date;
-
-  @IsOptional()
-  @IsString()
-  @MaxLength(7)
-  color?: string;
-
-  @IsOptional()
-  @IsBoolean()
-  isActive?: boolean;
-
-  @IsOptional()
-  metadata?: Record<string, unknown>;
-
-  @IsOptional()
-  @IsUUID('4', { each: true })
-  participantIds?: string[];
+```json
+POST /event-manager/event/insert
+{
+  "title": "Team Standup",
+  "description": "Daily standup meeting",
+  "startDate": "2026-03-10T09:00:00Z",
+  "endDate": "2026-03-10T09:30:00Z",
+  "isAllDay": false,
+  "color": "#3B82F6",
+  "meetingLink": "https://meet.example.com/standup",
+  "recurrence": {
+    "type": "DAILY",
+    "endDate": "2026-12-31",
+    "daysOfWeek": [1, 2, 3, 4, 5]
+  },
+  "participants": [
+    { "userId": "uuid-1", "isOrganizer": true },
+    { "userId": "uuid-2", "isOrganizer": false }
+  ]
 }
 ```
 
-### UpdateEventDto
+### Participants — `POST /event-manager/participant/*`
 
-```typescript
-export class UpdateEventDto extends PartialType(CreateEventDto) {
-  @IsUUID()
-  @IsNotEmpty()
-  id!: string;
-}
-```
+| Endpoint | Permission | Description |
+|----------|-----------|-------------|
+| `POST /event-manager/participant/insert` | `event.update` | Add participant to event |
+| `POST /event-manager/participant/get-all` | `event.read` | List participants for an event |
+| `POST /event-manager/participant/update-status` | JWT | Update own participation status |
+| `POST /event-manager/participant/delete` | `event.update` | Remove participant from event |
 
-### CalendarQueryDto
+**Update status request:**
 
-```typescript
-export class CalendarQueryDto {
-  @IsNotEmpty()
-  @IsDateString()
-  startDate!: Date;
-
-  @IsNotEmpty()
-  @IsDateString()
-  endDate!: Date;
-
-  @IsOptional()
-  @IsBoolean()
-  includeParticipants?: boolean;
-
-  @IsOptional()
-  @IsUUID()
-  userId?: string;
-
-  @IsOptional()
-  @IsBoolean()
-  activeOnly?: boolean;
+```json
+POST /event-manager/participant/update-status
+{
+  "eventId": "uuid",
+  "status": "ACCEPTED"
 }
 ```
 
-### CreateEventParticipantDto
-
-```typescript
-export class CreateEventParticipantDto {
-  @IsNotEmpty()
-  @IsUUID()
-  eventId!: string;
+---
 
-  @IsNotEmpty()
-  @IsUUID()
-  userId!: string;
+## Entities
 
-  @IsOptional()
-  @IsEnum(ParticipantStatus)
-  status?: ParticipantStatus;
+### Core Entities
 
-  @IsOptional()
-  @IsBoolean()
-  isOrganizer?: boolean;
+| Entity | Table | Description |
+|--------|-------|-------------|
+| `Event` | `event_manager_event` | Calendar event with recurrence config |
+| `EventParticipant` | `event_manager_participant` | User participation with status |
 
-  @IsOptional()
-  metadata?: Record<string, unknown>;
-}
-```
+### Company Feature Entities (`enableCompanyFeature: true`)
 
-### UpdateParticipantStatusDto
+| Entity | Table | Description |
+|--------|-------|-------------|
+| `EventWithCompany` | `event_manager_event` | Same as Event + `companyId` and `branchId` |
 
 ```typescript
-export class UpdateParticipantStatusDto {
-  @IsUUID()
-  @IsNotEmpty()
-  id!: string;
-
-  @IsNotEmpty()
-  @IsEnum(ParticipantStatus)
-  status!: ParticipantStatus;
-}
-```
-
-### BulkAddParticipantsDto
+import { EventManagerModule } from '@flusys/nestjs-event-manager';
 
-```typescript
-export class BulkAddParticipantsDto {
-  @IsNotEmpty()
-  @IsUUID()
-  eventId!: string;
-
-  @IsNotEmpty()
-  @IsUUID('4', { each: true })
-  userIds!: string[];
-}
+TypeOrmModule.forRoot({
+  entities: [
+    ...EventManagerModule.getEntities({ enableCompanyFeature: true }),
+  ],
+})
 ```
 
 ---
 
-## Recurrence Handling
+## Recurrence Patterns
 
-### How Recurrence Works
+| Type | Description |
+|------|-------------|
+| `NONE` | Single occurrence, no recurrence |
+| `DAILY` | Repeats every day (or specific days via `daysOfWeek`) |
+| `WEEKLY` | Repeats every week on the same day |
+| `BIWEEKLY` | Repeats every two weeks |
+| `MONTHLY` | Repeats on the same day of month |
 
-1. **Storage:** Events store recurrence pattern in `recurrenceType` and optional `recurrenceEndDate`
-2. **Metadata:** Weekly recurrence uses `metadata.recurrenceDays` array (0=Sunday, 6=Saturday)
-3. **Expansion:** Calendar queries expand recurring events into individual instances
-4. **Instance Markers:** Expanded instances have `isRecurrenceInstance: true` and `originalEventId`
-
-### Recurrence Expansion Logic
+**Recurrence configuration:**
 
 ```typescript
-private generateOccurrences(
-  event: EventBase,
-  rangeStart: Date,
-  rangeEnd: Date
-): ICalendarEvent[] {
-  const occurrences: ICalendarEvent[] = [];
-  const recurrenceEnd = event.recurrenceEndDate || rangeEnd;
-  const maxOccurrences = this.eventConfig.getMaxRecurrenceOccurrences();
-
-  let currentDate = new Date(event.startDateTime);
-
-  while (currentDate <= recurrenceEnd && occurrences.length < maxOccurrences) {
-    if (currentDate >= rangeStart && currentDate <= rangeEnd) {
-      occurrences.push(this.createOccurrence(event, currentDate));
-    }
-
-    // Advance based on recurrence type
-    switch (event.recurrenceType) {
-      case RecurrenceType.DAILY:
-        currentDate.setDate(currentDate.getDate() + 1);
-        break;
-      case RecurrenceType.WEEKLY:
-        currentDate = this.getNextWeeklyOccurrence(event, currentDate);
-        break;
-      case RecurrenceType.BIWEEKLY:
-        currentDate.setDate(currentDate.getDate() + 14);
-        break;
-      case RecurrenceType.MONTHLY:
-        currentDate.setMonth(currentDate.getMonth() + 1);
-        break;
-    }
-  }
-
-  return occurrences;
+interface IRecurrenceConfig {
+  type: 'NONE' | 'DAILY' | 'WEEKLY' | 'BIWEEKLY' | 'MONTHLY';
+  endDate?: string;         // ISO date — when recurrence stops
+  daysOfWeek?: number[];    // 0=Sunday, 1=Monday, ... 6=Saturday (for DAILY/WEEKLY)
+  interval?: number;        // Custom interval (e.g., every 3 weeks)
 }
 ```
 
-### Weekly Recurrence with Specific Days
-
-```typescript
-// Event with recurrence on Mon, Wed, Fri
-const event = await eventService.insert({
-  title: 'Team Standup',
-  startDateTime: new Date('2026-03-02T09:00:00'),
-  endDateTime: new Date('2026-03-02T09:30:00'),
-  recurrenceType: RecurrenceType.WEEKLY,
-  recurrenceEndDate: new Date('2026-06-30'),
-  metadata: {
-    recurrenceDays: [1, 3, 5], // Monday, Wednesday, Friday
-  },
-}, user);
-```
-
 ---
 
-## REST API Endpoints
-
-All event manager endpoints are prefixed with `/event-manager`.
-
-### Event Endpoints
-
-| Endpoint | Method | Description | Permission |
-|----------|--------|-------------|------------|
-| `/event-manager/event/insert` | POST | Create event | `event.create` |
-| `/event-manager/event/insert-many` | POST | Bulk create | `event.create` |
-| `/event-manager/event/get/:id` | POST | Get by ID | `event.read` |
-| `/event-manager/event/get-all` | POST | List with pagination | `event.read` |
-| `/event-manager/event/update` | POST | Update event | `event.update` |
-| `/event-manager/event/update-many` | POST | Bulk update | `event.update` |
-| `/event-manager/event/delete` | POST | Soft delete | `event.delete` |
-| `/event-manager/event/calendar` | POST | Calendar query with expansion | `event.read` |
-| `/event-manager/event/get-with-participants` | POST | Get with participant list | `event.read` |
-| `/event-manager/event/add-participants` | POST | Add participants | `event.update` |
-
-### Participant Endpoints
-
-| Endpoint | Method | Description | Permission |
-|----------|--------|-------------|------------|
-| `/event-manager/participant/insert` | POST | Create participant | `event_participant.create` |
-| `/event-manager/participant/insert-many` | POST | Bulk create | `event_participant.create` |
-| `/event-manager/participant/get/:id` | POST | Get by ID | `event_participant.read` |
-| `/event-manager/participant/get-all` | POST | List with pagination | `event_participant.read` |
-| `/event-manager/participant/update` | POST | Update participant | `event_participant.update` |
-| `/event-manager/participant/update-many` | POST | Bulk update | `event_participant.update` |
-| `/event-manager/participant/delete` | POST | Soft delete | `event_participant.delete` |
-| `/event-manager/participant/update-status` | POST | Update status | `event_participant.update` |
-| `/event-manager/participant/get-by-event` | POST | Get by event | `event_participant.read` |
-| `/event-manager/participant/get-by-user` | POST | Get by user | `event_participant.read` |
-| `/event-manager/participant/remove` | POST | Remove from event | `event_participant.delete` |
-
-### Request/Response Examples
-
-**Create Event:**
+## Participant Status
 
-```bash
-curl -X POST http://localhost:2002/event-manager/event/insert \
-  -H "Authorization: Bearer <token>" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "title": "Team Meeting",
-    "description": "Weekly sync",
-    "startDateTime": "2026-03-01T10:00:00Z",
-    "endDateTime": "2026-03-01T11:00:00Z",
-    "recurrenceType": "weekly",
-    "recurrenceEndDate": "2026-06-01T00:00:00Z",
-    "metadata": { "recurrenceDays": [1, 3, 5] },
-    "participantIds": ["user-id-1", "user-id-2"],
-    "color": "#3B82F6"
-  }'
-
-# Response:
-{
-  "success": true,
-  "message": "Event created successfully",
-  "data": {
-    "id": "event-uuid",
-    "title": "Team Meeting",
-    "startDateTime": "2026-03-01T10:00:00.000Z",
-    "recurrenceType": "weekly",
-    ...
-  }
-}
-```
-
-**Calendar Query:**
+| Status | Description |
+|--------|-------------|
+| `PENDING` | Invited but not responded |
+| `ACCEPTED` | Confirmed attendance |
+| `DECLINED` | Declined invitation |
+| `TENTATIVE` | Tentatively attending |
 
-```bash
-curl -X POST http://localhost:2002/event-manager/event/calendar \
-  -H "Authorization: Bearer <token>" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "startDate": "2026-03-01",
-    "endDate": "2026-03-31",
-    "includeParticipants": true,
-    "activeOnly": true
-  }'
-
-# Response includes expanded recurring events
-{
-  "success": true,
-  "data": [
-    {
-      "id": "event-uuid",
-      "title": "Team Meeting",
-      "startDateTime": "2026-03-03T10:00:00.000Z",
-      "isRecurrenceInstance": true,
-      "originalEventId": "event-uuid",
-      "participants": [...]
-    },
-    {
-      "id": "event-uuid",
-      "title": "Team Meeting",
-      "startDateTime": "2026-03-05T10:00:00.000Z",
-      "isRecurrenceInstance": true,
-      "originalEventId": "event-uuid",
-      "participants": [...]
-    },
-    ...
-  ],
-  "meta": { "total": 15, "page": 1, "pageSize": 100, "count": 15 }
-}
-```
+Participants update their own status via `POST /event-manager/participant/update-status`.
 
 ---
 
-## DataSource Provider Pattern
+## Cross-Module Adapter (EVENT_MANAGER_ADAPTER)
 
-### EventManagerDataSourceProvider
+The adapter allows other modules to create and manage events without importing `@flusys/nestjs-event-manager` directly. This prevents circular dependencies.
 
-The EventManagerDataSourceProvider follows the isolated cache pattern:
+**The interface is defined in `@flusys/nestjs-shared`:**
 
 ```typescript
-@Injectable({ scope: Scope.REQUEST })
-export class EventManagerDataSourceProvider extends MultiTenantDataSourceService {
-  // Isolated static cache per module
-  protected static override readonly tenantConnections = new Map<string, DataSource>();
-  protected static override singleDataSource: DataSource | null = null;
-  protected static override tenantsRegistry: ITenant[] = [];
-  protected static override initialized = false;
-  protected static override connectionLocks = new Map<string, Promise<DataSource>>();
-  protected static override singleConnectionLock: Promise<DataSource> | null = null;
-
-  constructor(
-    @Inject(EventManagerConfigService) private readonly configService: EventManagerConfigService,
-    @Optional() @Inject(REQUEST) protected override readonly request?: Request,
-  ) {
-    super(configService, request);
-  }
-
-  async getEventManagerEntities(enableCompanyFeature?: boolean): Promise<any[]> {
-    const featureEnabled = enableCompanyFeature ?? this.configService.isCompanyFeatureEnabled();
-    return getEventManagerEntitiesByConfig(featureEnabled);
-  }
-
-  // Override methods to use EventManagerDataSourceProvider's static cache
-  protected override async getSingleDataSource(): Promise<DataSource> {
-    // Uses EventManagerDataSourceProvider.singleDataSource
-  }
-
-  protected override async getOrCreateTenantConnection(tenant: ITenant): Promise<DataSource> {
-    // Uses EventManagerDataSourceProvider.tenantConnections
-  }
-}
+import { IEventManagerAdapter, EVENT_MANAGER_ADAPTER } from '@flusys/nestjs-shared/interfaces';
 ```
 
----
-
-## Multi-Tenant Support
-
-### Company Filtering
-
-When company feature is enabled:
+**Using the adapter in another module:**
 
 ```typescript
-protected override async getExtraManipulateQuery(query, filterDto, user) {
-  const result = await super.getExtraManipulateQuery(query, filterDto, user);
-
-  applyCompanyFilter(query, {
-    isCompanyFeatureEnabled: this.eventConfig.isCompanyFeatureEnabled(),
-    entityAlias: 'event',
-  }, user);
-
-  return result;
-}
-```
+import { IEventManagerAdapter } from '@flusys/nestjs-shared/interfaces';
+import { EVENT_MANAGER_ADAPTER } from '@flusys/nestjs-shared/interfaces';
 
-### DTO to Entity Conversion
-
-```typescript
-protected override async convertSingleDtoToEntity(dto, user): Promise<Partial<EventBase>> {
-  const entity = await super.convertSingleDtoToEntity(dto, user);
+@Injectable()
+export class MeetingService {
+  constructor(
+    @Optional() @Inject(EVENT_MANAGER_ADAPTER)
+    private readonly eventAdapter?: IEventManagerAdapter,
+  ) {}
 
-  if (this.eventConfig.isCompanyFeatureEnabled() && user?.companyId) {
-    (entity as Partial<EventWithCompany>).companyId = user.companyId;
+  async scheduleMeeting(data: { title: string; userId: string; date: Date }): Promise<void> {
+    await this.eventAdapter?.createEvent({
+      title: data.title,
+      startDate: data.date,
+      participants: [{ userId: data.userId, isOrganizer: true }],
+    });
   }
-
-  return entity;
 }
 ```
 
----
-
-## Swagger Configuration
+Using `@Optional()` means your module works even when `EventManagerModule` is not registered.
 
-### Using eventManagerSwaggerConfig
+**IEventManagerAdapter interface:**
 
 ```typescript
-import { eventManagerSwaggerConfig } from '@flusys/nestjs-event-manager/docs';
-
-// In your main.ts or app module
-const swaggerOptions = eventManagerSwaggerConfig({
-  enableCompanyFeature: true,
-  databaseMode: 'single',
-});
-
-// Returns:
-// {
-//   title: 'Event Manager API',
-//   description: '... dynamic description based on config ...',
-//   version: '1.0',
-//   path: 'api/docs/event-manager',
-//   bearerAuth: true,
-// }
+interface IEventManagerAdapter {
+  createEvent(data: ICreateEventData): Promise<{ id: string }>;
+  updateEvent(id: string, data: Partial<ICreateEventData>): Promise<void>;
+  deleteEvent(id: string): Promise<void>;
+  addParticipant(eventId: string, userId: string): Promise<void>;
+  removeParticipant(eventId: string, userId: string): Promise<void>;
+  updateParticipantStatus(eventId: string, userId: string, status: ParticipantStatus): Promise<void>;
+}
 ```
 
 ---
 
-## Event Manager Adapter
+## Exported Services
 
-The Event Manager Adapter allows other modules to create events and manage participants without direct dependencies on the event manager module.
+| Service | Description |
+|---------|-------------|
+| `EventManagerHelperService` | Singleton service for programmatic event management from other modules |
+| `EventService` | Full event CRUD (REQUEST-scoped) |
+| `EventParticipantService` | Participant management (REQUEST-scoped) |
+| `EventManagerConfigService` | Exposes runtime config |
+| `EVENT_MANAGER_ADAPTER` | Cross-module adapter token |
 
-### Interface (from @flusys/nestjs-shared)
-
-```typescript
-import { ParticipantStatus, RecurrenceType } from '@flusys/nestjs-shared/enums';
-
-export interface IEventManagerAdapter {
-  createEvent(options: CreateEventOptions): Promise<EventResult>;
-  addParticipants(eventId: string, userIds: string[], companyId?: string): Promise<void>;
-  removeParticipant(eventId: string, userId: string): Promise<void>;
-  updateParticipantStatus(participantId: string, status: ParticipantStatus): Promise<void>;
-  getEventsForUser?(userId: string, startDate: Date, endDate: Date, companyId?: string): Promise<EventResult[]>;
-  getEventById?(eventId: string): Promise<EventResult | null>;
-}
-
-export interface CreateEventOptions {
-  title: string;
-  description?: string;
-  meetingLink?: string;
-  startDateTime: Date;
-  endDateTime: Date;
-  isAllDay?: boolean;
-  recurrenceType?: RecurrenceType;
-  recurrenceEndDate?: Date;
-  color?: string;
-  metadata?: Record<string, unknown>;
-  participantIds?: string[];
-  organizerId?: string;
-  companyId?: string;
-}
-
-export interface EventResult {
-  id: string;
-  title: string;
-  description?: string | null;
-  meetingLink?: string | null;
-  startDateTime: Date;
-  endDateTime: Date;
-  isAllDay: boolean;
-  recurrenceType: string;
-  recurrenceEndDate?: Date | null;
-  color: string;
-  isActive: boolean;
-  metadata?: Record<string, unknown> | null;
-  companyId?: string | null;
-  createdAt: Date;
-  updatedAt: Date;
-}
+---
 
-export const EVENT_MANAGER_ADAPTER = 'EVENT_MANAGER_ADAPTER';
-```
+## Programmatic Usage
 
-### Using the Adapter in Other Modules
+Use `EventManagerHelperService` (singleton) for programmatic access from within the same application:
 
 ```typescript
-import { Injectable, Inject, Optional } from '@nestjs/common';
-import {
-  EVENT_MANAGER_ADAPTER,
-  IEventManagerAdapter,
-  RecurrenceType,
-} from '@flusys/nestjs-shared';
+import { EventManagerHelperService } from '@flusys/nestjs-event-manager';
 
 @Injectable()
-export class MyService {
+export class OnboardingService {
   constructor(
-    @Optional() @Inject(EVENT_MANAGER_ADAPTER)
-    private readonly eventAdapter?: IEventManagerAdapter,
+    @Inject(EventManagerHelperService)
+    private readonly eventHelper: EventManagerHelperService,
   ) {}
 
-  async createMeetingEvent(userId: string, companyId?: string) {
-    if (!this.eventAdapter) {
-      console.warn('Event manager not available');
-      return;
-    }
-
-    const event = await this.eventAdapter.createEvent({
-      title: 'Team Meeting',
-      description: 'Weekly sync meeting',
-      startDateTime: new Date(),
-      endDateTime: new Date(Date.now() + 3600000), // 1 hour later
-      recurrenceType: RecurrenceType.WEEKLY,
-      participantIds: [userId],
-      organizerId: userId,
-      companyId,
-    });
-
-    return event;
-  }
+  async scheduleOnboardingCall(userId: string): Promise<void> {
+    const nextWeek = new Date();
+    nextWeek.setDate(nextWeek.getDate() + 7);
 
-  async inviteToEvent(eventId: string, userIds: string[]) {
-    if (this.eventAdapter) {
-      await this.eventAdapter.addParticipants(eventId, userIds);
-    }
+    await this.eventHelper.createEvent({
+      title: 'Onboarding Call',
+      startDate: nextWeek,
+      endDate: new Date(nextWeek.getTime() + 30 * 60 * 1000), // +30 min
+      participants: [{ userId, isOrganizer: false }],
+    });
   }
 }
 ```
 
-### Module Registration Order
-
-**Important:** The `EventManagerModule` must be imported BEFORE any module that injects the adapter:
-
-```typescript
-@Module({
-  imports: [
-    // EventManagerModule FIRST
-    EventManagerModule.forRoot({
-      global: true,
-      // ...config
-    }),
-
-    // Modules that use the adapter AFTER
-    MyFeatureModule,
-  ],
-})
-export class AppModule {}
-```
-
-### Adapter Methods
-
-| Method | Description |
-|--------|-------------|
-| `createEvent(options)` | Create a new event with optional participants |
-| `addParticipants(eventId, userIds)` | Add users as participants to an event |
-| `removeParticipant(eventId, userId)` | Remove a user from an event |
-| `updateParticipantStatus(participantId, status)` | Update RSVP status |
-| `getEventsForUser(userId, startDate, endDate)` | Get user's events in date range |
-| `getEventById(eventId)` | Get a single event by ID |
-
-### Helper Service
-
-The adapter delegates to `EventManagerHelperService`, a singleton service that handles the actual business logic:
-
-```typescript
-@Injectable()
-export class EventManagerHelperService {
-  async createEvent(options: CreateEventOptions): Promise<EventResult>;
-  async addParticipants(eventId: string, userIds: string[], companyId?: string): Promise<void>;
-  async removeParticipant(eventId: string, userId: string): Promise<void>;
-  async updateParticipantStatus(participantId: string, status: ParticipantStatus): Promise<void>;
-  async getEventsForUser(userId: string, startDate: Date, endDate: Date, companyId?: string): Promise<EventResult[]>;
-  async getEventById(eventId: string): Promise<EventResult | null>;
-}
-```
-
 ---
 
-## Best Practices
+## Troubleshooting
 
-### 1. Use Proper Recurrence Patterns
+**`EVENT_MANAGER_ADAPTER` is undefined**
 
-```typescript
-// Daily standup
-await eventService.insert({
-  title: 'Daily Standup',
-  recurrenceType: RecurrenceType.DAILY,
-  recurrenceEndDate: new Date('2026-12-31'),
-}, user);
-
-// Weekly on specific days
-await eventService.insert({
-  title: 'Team Sync',
-  recurrenceType: RecurrenceType.WEEKLY,
-  metadata: { recurrenceDays: [1, 4] }, // Monday, Thursday
-}, user);
-
-// Monthly meeting
-await eventService.insert({
-  title: 'Monthly Review',
-  recurrenceType: RecurrenceType.MONTHLY,
-}, user);
-```
+`EventManagerModule` was not registered in the application module. Either register it or use `@Optional()` in the consuming service.
 
-### 2. Query Calendar Efficiently
+---
 
-```typescript
-// Only fetch what you need
-const events = await eventService.getEventsForCalendarRange({
-  startDate: monthStart,
-  endDate: monthEnd,
-  includeParticipants: false, // Only include if needed
-  activeOnly: true,
-}, user);
-```
+**Events not filtered by company**
 
-### 3. Handle Participant Status
+Ensure `enableCompanyFeature: true` is set and the JWT contains `companyId`. Without the company ID in the token, company-scoped queries return all events.
 
-```typescript
-// Update participant response
-await participantService.updateStatus({
-  id: participantId,
-  status: ParticipantStatus.ACCEPTED,
-}, user);
-```
+---
 
-### 4. Use Consistent Colors
+**Recurrence events not expanding**
 
-```typescript
-// Use the default color from config
-const defaultColor = eventConfig.getDefaultColor();
-
-// Or use predefined colors
-const EVENT_COLORS = [
-  '#3B82F6', // Blue
-  '#EF4444', // Red
-  '#10B981', // Green
-  '#F59E0B', // Amber
-  '#8B5CF6', // Purple
-];
-```
+`nestjs-event-manager` stores the recurrence configuration as a JSON column — it does not auto-expand recurring events into separate database rows. Your frontend or a separate expansion service is responsible for generating occurrences from the recurrence config.
 
 ---
 
-## API Reference
-
-### Main Exports
+**`No metadata for entity`**
 
+Register entities in TypeORM:
 ```typescript
-// Module
-import { EventManagerModule } from '@flusys/nestjs-event-manager';
-
-// Adapter (for cross-module usage)
-import { EventManagerAdapter } from '@flusys/nestjs-event-manager/adapters';
-
-// Adapter Interface & Token (from shared)
-import {
-  EVENT_MANAGER_ADAPTER,
-  IEventManagerAdapter,
-  CreateEventOptions,
-  EventResult,
-} from '@flusys/nestjs-shared/interfaces';
-
-// Services
-import {
-  EventService,
-  EventParticipantService,
-  EventManagerConfigService,
-  EventManagerDataSourceProvider,
-  EventManagerHelperService,
-} from '@flusys/nestjs-event-manager/services';
-
-// Entities
-import {
-  Event,
-  EventBase,
-  EventWithCompany,
-  EventParticipant,
-  EventParticipantBase,
-  EventManagerCoreEntities,
-  EventManagerCompanyEntities,
-  getEventManagerEntitiesByConfig,
-} from '@flusys/nestjs-event-manager/entities';
-
-// DTOs
-import {
-  CreateEventDto,
-  UpdateEventDto,
-  EventResponseDto,
-  CalendarEventResponseDto,
-  CalendarQueryDto,
-  CreateEventParticipantDto,
-  UpdateEventParticipantDto,
-  EventParticipantResponseDto,
-  UpdateParticipantStatusDto,
-  BulkAddParticipantsDto,
-} from '@flusys/nestjs-event-manager/dtos';
-
-// Interfaces
-import {
-  IEvent,
-  IEventParticipant,
-  ICalendarEvent,
-  IEventManagerModuleConfig,
-  EventManagerModuleOptions,
-  EventManagerModuleAsyncOptions,
-  EventManagerOptionsFactory,
-} from '@flusys/nestjs-event-manager/interfaces';
-
-// Enums (canonical source)
-import {
-  RecurrenceType,
-  ParticipantStatus,
-} from '@flusys/nestjs-shared/enums';
-
-// Or re-export from event-manager
-import {
-  RecurrenceType,
-  ParticipantStatus,
-} from '@flusys/nestjs-event-manager/enums';
-
-// Controllers
-import {
-  EventController,
-  EventParticipantController,
-} from '@flusys/nestjs-event-manager/controllers';
-
-// Config & Docs
-import { EVENT_MANAGER_MODULE_OPTIONS } from '@flusys/nestjs-event-manager/config';
-import {
-  EVENT_PERMISSIONS,
-  EVENT_PARTICIPANT_PERMISSIONS,
-  eventManagerSwaggerConfig,
-} from '@flusys/nestjs-event-manager/docs';
+entities: [...EventManagerModule.getEntities({ enableCompanyFeature: true })]
 ```
 
 ---
 
-## Summary
-
-The `@flusys/nestjs-event-manager` package provides:
+## License
 
-- **Event CRUD** - Full create, read, update, delete for events
-- **Recurrence Support** - Daily, weekly, biweekly, monthly patterns
-- **Calendar Queries** - Date range queries with automatic recurrence expansion
-- **Participant Management** - Track participants with status (pending, accepted, declined, tentative)
-- **Adapter Pattern** - Cross-module event creation via `IEventManagerAdapter`
-- **Company Scoping** - Per-company event isolation
-- **Multi-Tenant** - Separate databases per tenant
-- **POST-only RPC** - All endpoints use POST method
-- **Permission Guards** - All endpoints protected by permissions
+MIT © FLUSYS
 
 ---
 
-**Last Updated:** 2026-02-26
-**Version:** 3.0.0
-**NestJS Version:** 11
+> Part of the **FLUSYS** framework — a full-stack monorepo powering Angular 21 + NestJS 11 applications.