zync-nest-data-module 1.0.0 → 1.1.38

package/README.md

@@ -1,18 +1,16 @@
-# Zync NestJS Library
+# Zync NestJS Data Module
 
-A comprehensive NestJS library providing database backup utilities, file upload services, and common utilities for modern web applications.
+A comprehensive NestJS data module providing database utilities, backup services, and base service classes for modern web applications built with MongoDB and Mongoose.
 
 ## 📦 Features
 
+- **Database Module**: Complete MongoDB/Mongoose integration with repositories, transactions, and utilities
 - **Database Backup Service**: Automated MongoDB backup with cloud storage support
-- **File Upload Service**: Handle file uploads with image resizing and cloud storage
-- **Bucket Service**: AWS S3/DigitalOcean Spaces integration
-- **Firebase Service**: Push notification service with FCM integration
-- **Mailer Service**: Email sending service with template support
-- **Exabytes SMS Service**: SMS sending service via Exabytes API
-- **UltraMsg Service**: WhatsApp messaging service via UltraMsg API
-- **Message Service**: Unified messaging service for various channels
-- **Utility Functions**: Common helpers for date formatting, file handling, and more
+- **Base Service Class**: Generic service class with CRUD operations and pagination
+- **Database Utilities**: Helper functions for database operations, unique ID generation, and data synchronization
+- **Transaction Management**: Built-in transaction support for complex database operations
+- **Repository Pattern**: Abstract base repository with common database operations
+- **Database Schema Utilities**: Schema management and validation helpers
 
 ## 🚀 Installation
 
@@ -20,8 +18,8 @@ A comprehensive NestJS library providing database backup utilities, file upload
 
 ```bash
 # Clone the repository
-git clone <repository-url>
-cd zync-nest-library
+git clone https://github.com/zynctech/zync-nest-data-module.git
+cd zync-nest-data-module
 
 # Install dependencies
 pnpm install
@@ -32,14 +30,23 @@ pnpm run build
 
 ### Using in Other Projects
 
-#### Method 1: File Path Dependency (Recommended for pnpm)
+#### Method 1: npm/pnpm install from registry
+
+```bash
+# Install from AsyncTech registry
+npm install zync-nest-data-module --registry https://registry.asynctechs.com/
+# or
+pnpm add zync-nest-data-module --registry https://registry.asynctechs.com/
+```
+
+#### Method 2: File Path Dependency (For local development)
 
 In your project's `package.json`:
 
 ```json
 {
   "dependencies": {
-    "zync-nest-library": "file:../../zync-library/zync-nest-library"
+    "zync-nest-data-module": "file:../../zync-library/zync-nest-data-module"
   }
 }
 ```
@@ -49,17 +56,17 @@ Then run:
 pnpm install
 ```
 
-#### Method 2: npm link (For npm users)
+#### Method 3: npm link (For npm users)
 
 ```bash
 # In the library directory
 npm link
 
 # In your consuming project
-npm link zync-nest-library
+npm link zync-nest-data-module
 ```
 
-#### Method 3: pnpm link (Alternative for pnpm)
+#### Method 4: pnpm link (Alternative for pnpm)
 
 ```bash
 # Setup pnpm global bin directory (one-time setup)
@@ -69,7 +76,7 @@ pnpm setup
 pnpm link --global
 
 # In your consuming project
-pnpm link --global zync-nest-library
+pnpm link --global zync-nest-data-module
 ```
 
 ## 📚 Usage
@@ -81,439 +88,209 @@ Import the required modules in your NestJS application:
 ```typescript
 import { Module } from '@nestjs/common';
 import { 
-  ApDbBackupModule, 
-  UploadModule,
-  FirebaseModule,
-  MailerModule,
-  MessageModule
-} from 'zync-nest-library';
+  DatabaseModule,
+  BackupModule,
+  BaseService
+} from 'zync-nest-data-module';
 
 @Module({
   imports: [
-    ApDbBackupModule,
-    UploadModule,
-    FirebaseModule,
-    MailerModule,
-    MessageModule,
+    DatabaseModule,
+    BackupModule,
     // ... other modules
   ],
 })
 export class AppModule {}
 ```
 
-### Database Backup Service
-
-The `DbBackupService` provides automated MongoDB backup functionality with optional cloud storage.
-
-#### Configuration
-
-```typescript
-import { IDbBackupConfig } from 'zync-nest-library';
-
-const backupConfig: IDbBackupConfig = {
-  env: 'production',
-  mongodb: {
-    connectionStrings: 'mongodb://localhost:27017/mydb'
-    // or multiple connections: ['mongodb://...', 'mongodb://...']
-  },
-  backup: {
-    dir: './backups',
-    enabled: true,
-    maxBackups: 10,
-    isDownload: false,
-    uploadToSpace: true
-  },
-  spaces: {
-    name: 'my-bucket',
-    region: 'nyc3',
-    key: 'your-access-key',
-    secret: 'your-secret-key',
-    endpoint: 'https://nyc3.digitaloceanspaces.com',
-    dir: 'backups'
-  }
-};
-```
-
-#### Usage
-
-```typescript
-import { Injectable } from '@nestjs/common';
-import { DbBackupService } from 'zync-nest-library';
-
-@Injectable()
-export class MyService {
-  constructor(private readonly backupService: DbBackupService) {}
+### Database Module
 
-  async createBackup() {
-    await this.backupService.backup();
-  }
+The `DatabaseModule` provides comprehensive MongoDB/Mongoose integration with repositories, transactions, and utilities.
 
-  async scheduleBackups() {
-    // Set up automated backups (runs every 6 hours by default)
-    this.backupService.startBackupSchedule();
-  }
-}
-```
-
-### Upload Service
+#### Database Schema
 
-The `UploadService` handles file uploads with automatic image resizing and cloud storage integration.
-
-#### Interfaces
+The module includes a `BaseSchema` class that provides common fields for all documents:
 
 ```typescript
-import { IUpload, IUploadResult } from 'zync-nest-library';
-
-// Upload interface
-interface IUpload {
-  type?: "base64" | "buffer";
-  file: any;
-  filepath?: string;
-  filename: string;
-  filetype: string;
-  dir?: string;
-  transformName?: boolean;
-}
+import { BaseSchema } from 'zync-nest-data-module';
 
-// Upload result
-interface IUploadResult {
+@Schema()
+export class MyDocument extends BaseSchema {
+  @Prop({ required: true })
   name: string;
-  type: string;
-  uri: string;
-  lgUri?: string;  // Large thumbnail
-  mdUri?: string;  // Medium thumbnail
-  smUri?: string;  // Small thumbnail
+  
+  @Prop()
+  description: string;
 }
 ```
 
-#### Usage
+#### Repository Pattern
 
-```typescript
-import { Injectable } from '@nestjs/common';
-import { UploadService } from 'zync-nest-library';
-
-@Injectable()
-export class FileService {
-  constructor(private readonly uploadService: UploadService) {}
-
-  async uploadFile(file: Express.Multer.File): Promise<IUploadResult> {
-    const uploadData: IUpload = {
-      type: 'buffer',
-      file: file.buffer,
-      filename: file.originalname,
-      filetype: file.mimetype,
-      dir: 'uploads',
-      transformName: true
-    };
-
-    return await this.uploadService.uploadFile(uploadData);
-  }
-
-  async uploadBase64Image(base64: string): Promise<IUploadResult> {
-    const uploadData: IUpload = {
-      type: 'base64',
-      file: base64,
-      filename: 'image.jpg',
-      filetype: 'image/jpeg',
-      dir: 'images'
-    };
-
-    return await this.uploadService.uploadFile(uploadData);
-  }
-}
-```
-
-### Bucket Service
-
-The `BucketService` provides direct integration with cloud storage services (AWS S3, DigitalOcean Spaces).
-
-#### Configuration
-
-```typescript
-// In your environment or config
-export default () => ({
-  bucket: {
-    name: process.env.aws_bucket,
-    region: process.env.aws_s3_region,
-    key: process.env.aws_access_key_id,
-    secret: process.env.aws_secret_access_key,
-    endpoint: process.env.aws_s3_endpoint,
-  }
-});
-```
-
-#### Usage
+Create repositories by extending `AbstractBaseRepository`:
 
 ```typescript
 import { Injectable } from '@nestjs/common';
-import { BucketService } from 'zync-nest-library';
+import { AbstractBaseRepository, IPageParams } from 'zync-nest-data-module';
 
 @Injectable()
-export class CloudStorageService {
-  constructor(private readonly bucketService: BucketService) {}
+export class MyRepository extends AbstractBaseRepository<MyDocument> {
+  constructor(@InjectModel(MyDocument.name) model: SoftDeleteModel<MyDocument>) {
+    super(model);
+  }
 
-  async uploadToBucket(buffer: Buffer, key: string) {
-    return await this.bucketService.upload(buffer, key);
+  protected buildQuery(query: Partial<MyDocument>): any {
+    return query;
   }
 
-  async downloadFromBucket(key: string) {
-    return await this.bucketService.download(key);
+  public async mapData(data: any, isCreate: boolean): Promise<MyDocument> {
+    return data;
   }
 
-  async deleteFromBucket(key: string) {
-    return await this.bucketService.delete(key);
+  // Additional custom methods
+  async findByName(name: string): Promise<MyDocument[]> {
+    return this.find({ name });
   }
 }
 ```
 
-### Firebase Service
-
-The `FirebaseService` provides push notification functionality using Firebase Cloud Messaging (FCM).
-
-#### Configuration
-
-First, you need to set up Firebase Admin SDK with a service account key:
+#### Transaction Support
 
-1. Download your Firebase service account key JSON file
-2. Place it in your project root as `serviceAccount.json`
-3. The service will automatically initialize Firebase Admin SDK
-
-#### Interfaces
-
-```typescript
-import { INotification } from 'zync-nest-library';
-
-interface INotification {
-  title: string;
-  body: string;
-  topic?: string;
-  image?: string;
-  data?: {
-    type: "ORDER" | "SCHEME" | "RATE" | "PUSH" | "FEED";
-    [x: string]: string;
-  };
-}
-```
-
-#### Usage
+Use transactions for complex operations:
 
 ```typescript
 import { Injectable } from '@nestjs/common';
-import { FirebaseService, INotification } from 'zync-nest-library';
+import { TransactionManager } from 'zync-nest-data-module';
 
 @Injectable()
-export class NotificationService {
-  constructor(private readonly firebaseService: FirebaseService) {}
-
-  async sendToDevices(tokens: string[], notification: INotification) {
-    await this.firebaseService.sendPushNotification(tokens, notification);
-  }
-
-  async sendToTopic(topic: string, notification: INotification) {
-    await this.firebaseService.sendPushNotificationToTopic(topic, notification);
-  }
-
-  async subscribeToTopic(topic: string, tokens: string[]) {
-    await this.firebaseService.subscribeToTopic(topic, tokens);
+export class MyService {
+  constructor(
+    private readonly transactionManager: TransactionManager,
+    private readonly myRepository: MyRepository
+  ) {}
+
+  async complexOperation() {
+    return await this.transactionManager.runTransaction(async (session) => {
+      this.myRepository.session = session;
+      
+      const doc1 = await this.myRepository.create({ name: 'Document 1' });
+      const doc2 = await this.myRepository.create({ name: 'Document 2' });
+      
+      return { doc1, doc2 };
+    });
   }
 }
 ```
 
-### Mailer Service
-
-The `MailerService` provides email sending functionality with template support.
-
-#### Configuration
+#### Pagination
 
-```typescript
-import { IMailerConfig } from 'zync-nest-library';
-
-const mailerConfig: IMailerConfig = {
-  logo: 'https://example.com/logo.png',
-  host: 'smtp.gmail.com',
-  user: 'your-email@gmail.com',
-  pass: 'your-app-password',
-  from: 'noreply@yourcompany.com',
-  port: '587',
-  playStore: 'https://play.google.com/store/apps/details?id=your.app',
-  appStore: 'https://apps.apple.com/app/your-app/id123456789'
-};
-```
-
-#### Environment Variables
-
-```env
-# Email Configuration
-MAILER_HOST=smtp.gmail.com
-MAILER_USER=your-email@gmail.com
-MAILER_PASS=your-app-password
-MAILER_FROM=noreply@yourcompany.com
-MAILER_PORT=587
-MAILER_LOGO=https://example.com/logo.png
-MAILER_PLAY_STORE=https://play.google.com/store/apps/details?id=your.app
-MAILER_APP_STORE=https://apps.apple.com/app/your-app/id123456789
-```
-
-#### Usage
+Use built-in pagination functionality:
 
 ```typescript
-import { Injectable } from '@nestjs/common';
-import { MailerService, IMail } from 'zync-nest-library';
-
-@Injectable()
-export class EmailService {
-  constructor(private readonly mailerService: MailerService) {}
-
-  async sendEmail(mailData: IMail) {
-    await this.mailerService.sendMail(mailData);
-  }
-
-  async sendWelcomeEmail(email: string, name: string) {
-    const mailData: IMail = {
-      to: email,
-      subject: 'Welcome to Our Platform',
-      template: 'welcome',
-      context: {
-        name: name,
-        loginUrl: 'https://yourapp.com/login'
-      }
-    };
-    
-    await this.mailerService.sendMail(mailData);
-  }
+async getPaginatedData(pageParams: IPageParams) {
+  return await this.myRepository.page({
+    ...pageParams,
+    // additional query filters
+  });
 }
 ```
 
-### Exabytes SMS Service
-
-The Exabytes SMS service provides SMS sending functionality via Exabytes API.
-
-#### Configuration
-
-Configure the Exabytes SMS service using environment variables:
-
-```env
-# Exabytes SMS Configuration
-exabytes_sms_username=your_username
-exabytes_sms_password=your_password
-exabytes_sms_url=https://sms.exabytes.com/api/send
-exabytes_sms_sendid=YOUR_SENDER_ID
-```
-
-#### Usage
-
-The Exabytes SMS service is typically used through the unified Message Service for SMS functionality.
-
-### UltraMsg Service
+### Database Backup Service
 
-The `UltraMsgService` provides WhatsApp messaging functionality via UltraMsg API.
+The `BackupService` provides automated MongoDB backup functionality with cloud storage support.
 
 #### Configuration
 
-Configure the UltraMsg service using environment variables:
+Configure backup settings using environment variables:
 
 ```env
-# UltraMsg Configuration
-ultramsg_instance=your_instance_id
-ultramsg_token=your_api_token
-ultramsg_url=https://api.ultramsg.com
+# Database Backup Configuration
+app_env=production
+mongodb_backup_connection_strings=mongodb://localhost:27017/mydb
+db_backup_enabled=true
+db_backup_dir=./backups
+db_backup_max=10
+
+# Cloud Storage Configuration (DigitalOcean Spaces / AWS S3)
+aws_bucket=my-backup-bucket
+aws_s3_region=nyc3
+aws_access_key_id=your-access-key
+aws_secret_access_key=your-secret-key
+s3_spaces_endpoint=https://nyc3.digitaloceanspaces.com
+s3_spaces_dir=db-backups
 ```
 
 #### Usage
 
 ```typescript
 import { Injectable } from '@nestjs/common';
-import { UltraMsgService } from 'zync-nest-library';
+import { BackupService } from 'zync-nest-data-module';
 
 @Injectable()
-export class WhatsAppService {
-  constructor(private readonly ultraMsgService: UltraMsgService) {}
+export class MyBackupService {
+  constructor(private readonly backupService: BackupService) {}
 
-  async sendMessage(phone: string, message: string) {
-    return await this.ultraMsgService.sendMessage(phone, message);
+  async createBackup() {
+    await this.backupService.backup();
   }
 
-  async sendDocument(phone: string, document: string, caption?: string) {
-    return await this.ultraMsgService.sendDocument(phone, document, caption);
+  async scheduleBackups() {
+    // Set up automated backups (runs every 6 hours by default)
+    this.backupService.startBackupSchedule();
   }
 }
 ```
 
-### Message Service
+### Base Service Class
 
-The `MessageService` provides a unified interface for sending messages across different channels (Email, SMS, WhatsApp, Push Notifications).
-
-#### Usage
+The `BaseService` provides a generic service class with common CRUD operations:
 
 ```typescript
 import { Injectable } from '@nestjs/common';
-import { MessageService } from 'zync-nest-library';
+import { BaseService } from 'zync-nest-data-module';
 
 @Injectable()
-export class UnifiedMessageService {
-  constructor(private readonly messageService: MessageService) {}
-
-  async sendMultiChannelMessage(
-    email: string,
-    phone: string,
-    pushTokens: string[],
-    message: any
-  ) {
-    // Send via email
-    await this.messageService.sendEmail({
-      to: email,
-      subject: message.subject,
-      template: message.template,
-      context: message.context
-    });
-
-    // Send via SMS (if configured)
-    // await this.messageService.sendSMS(phone, message.text);
-
-    // Send via WhatsApp (if configured)
-    // await this.messageService.sendWhatsApp(phone, message.text);
+export class MyService extends BaseService<MyDocument> {
+  constructor(myRepository: MyRepository) {
+    super(myRepository);
+  }
 
-    // Send push notification
-    await this.messageService.sendPushNotification(pushTokens, {
-      title: message.title,
-      body: message.body,
-      data: message.data
-    });
+  // Inherits all CRUD operations:
+  // - create(data)
+  // - update(_id, data)
+  // - findById(_id)
+  // - findOne(query)
+  // - find(query)
+  // - delete(_id)
+  // - page(query)
+
+  // Add custom business logic
+  async findActiveDocuments(): Promise<MyDocument[]> {
+    return this.find({ deleted: false });
   }
 }
 ```
 
-### Utility Functions
+### Database Utilities
 
-The library includes various utility functions for common operations:
+The module includes various utility functions:
 
 ```typescript
-import {
-  DateUtils,
-  mkdir,
-  uuidFilenameTransform,
-  bufferFromBase64,
-  getBase64FileName,
-  toSlug,
-  fileDownloadResponse
-} from 'zync-nest-library';
-
-// Date utilities
-const timestamp = DateUtils.formatStringDate('25/12/2023');
-
-// File utilities
-const uniqueFilename = uuidFilenameTransform('image.jpg'); // Returns: uuid.jpg
-const buffer = bufferFromBase64('data:image/jpeg;base64,...');
-const filename = getBase64FileName('data:image/jpeg;base64,...'); // Returns: uuid.jpeg
-
-// String utilities
-const slug = toSlug('My Product Title'); // Returns: my-product-title-abc123
-
-// Directory creation
-mkdir('./uploads/images');
-
-// File download response (Express)
-fileDownloadResponse(res, buffer, 'report', 'pdf');
+import { 
+  DbUtils,
+  ApUniqueIdGenerator,
+  UniqueKeyTypes 
+} from 'zync-nest-data-module';
+
+// Generate unique IDs
+const uniqueId = await uniqueIdGenerator.generate({
+  prefix: 'DOC',
+  key: UniqueKeyTypes.DOCUMENT,
+  filter: { status: 'active' }
+});
+
+// Database utilities
+const isValidObjectId = DbUtils.isValidObjectId('507f1f77bcf86cd799439011');
+const objectId = DbUtils.toObjectId('507f1f77bcf86cd799439011');
 ```
 
 ## 🔧 Configuration
@@ -521,44 +298,29 @@ fileDownloadResponse(res, buffer, 'report', 'pdf');
 ### Environment Variables
 
 ```env
-# Cloud Storage (DigitalOcean Spaces / AWS S3)
-#-----------------s3-----------------#
-aws_access_key_id=xxxx
-aws_secret_access_key=xxxxx
+# Application Environment
+app_env=production
+NODE_ENV=production
+is_docker=false
+
+# MongoDB Configuration
+mongodb_url=mongodb://localhost:27017/mydb
+mongodb_backup_connection_strings=mongodb://localhost:27017/mydb
+
+# Database Backup Configuration
+db_backup_enabled=true
+db_backup_dir=./backups
+db_backup_max=10
+
+# Cloud Storage Configuration (DigitalOcean Spaces / AWS S3)
+aws_bucket=my-backup-bucket
 aws_s3_region=nyc3
-aws_s3_endpoint=https://xxxx.nyc3.digitaloceanspaces.com
-aws_bucket=xxxx
+aws_access_key_id=your-access-key
+aws_secret_access_key=your-secret-key
+aws_s3_endpoint=https://nyc3.digitaloceanspaces.com
 aws_base_key=development
-
-# Email Configuration (Mailer Service)
-#-----------------mailer-----------------#
-MAILER_HOST=smtp.gmail.com
-MAILER_USER=your-email@gmail.com
-MAILER_PASS=your-app-password
-MAILER_FROM=noreply@yourcompany.com
-MAILER_PORT=587
-MAILER_LOGO=https://example.com/logo.png
-MAILER_PLAY_STORE=https://play.google.com/store/apps/details?id=your.app
-MAILER_APP_STORE=https://apps.apple.com/app/your-app/id123456789
-
-# Exabytes SMS Configuration
-#-----------------exabytes-----------------#
-exabytes_sms_username=your_username
-exabytes_sms_password=your_password
-exabytes_sms_url=https://sms.exabytes.com/api/send
-exabytes_sms_sendid=YOUR_SENDER_ID
-
-# UltraMsg WhatsApp Configuration
-#-----------------ultramsg-----------------#
-ultramsg_instance=your_instance_id
-ultramsg_token=your_api_token
-ultramsg_url=https://api.ultramsg.com
-
-# Firebase Configuration
-#-----------------firebase-----------------#
-# Note: Firebase requires a service account JSON file
-# Place your serviceAccount.json file in the project root
-# Download from: Firebase Console > Project Settings > Service Accounts
+s3_spaces_dir=db-backups
+s3_spaces_endpoint=https://sgp1.digitaloceanspaces.com
 ```
 
 ## 🛠️ Development
@@ -569,14 +331,38 @@ ultramsg_url=https://api.ultramsg.com
 # Build the library
 pnpm run build
 
+# Build library with clean (removes dist first)
+pnpm run build:lib
+
 # Build in watch mode
 pnpm run build:watch
 
 # Clean build artifacts
 pnpm run clean
 
-# Build and clean
-pnpm run clean && pnpm run build
+# Start the application (builds first)
+pnpm run start
+
+# Start in development mode (builds in watch mode + nodemon)
+pnpm run start:dev
+
+# Publish to AsyncTech registry
+pnpm run publish:update
+
+# Update links in consuming projects
+pnpm run update-links
+
+# Update links with version bump (minor)
+pnpm run update-links:minor
+
+# Update links with version bump (major)
+pnpm run update-links:major
+
+# Update links without building
+pnpm run update-links:no-build
+
+# Update links without version bump or build
+pnpm run update-links:no-version
 ```
 
 ### Project Structure
@@ -584,43 +370,36 @@ pnpm run clean && pnpm run build
 ```
 libs/
 ├── src/
-│   ├── dbbackup/          # Database backup functionality
+│   ├── backup/              # Database backup functionality
 │   │   ├── backup.config.ts
 │   │   ├── backup.interface.ts
 │   │   ├── backup.module.ts
-│   │   └── backup.service.ts
-│   ├── upload/            # File upload functionality
-│   │   ├── bucket/        # Cloud storage integration
-│   │   ├── upload.interface.ts
-│   │   ├── upload.module.ts
-│   │   ├── upload.service.ts
-│   │   └── upload.utils.ts
-│   ├── firebase/          # Firebase push notifications
-│   │   ├── firebase.interface.ts
-│   │   ├── firebase.module.ts
-│   │   └── firebase.service.ts
-│   ├── mailer/            # Email service
-│   │   ├── mailer.interface.ts
-│   │   ├── mailer.module.ts
-│   │   └── mailer.service.ts
-│   ├── message/           # Unified messaging service
-│   │   ├── message.module.ts
-│   │   └── message.service.ts
-│   ├── exabytes/          # SMS service via Exabytes
-│   │   ├── exabytes.config.ts
-│   │   ├── exabytes.interface.ts
-│   │   ├── exabytes.module.ts
-│   │   └── exabytes.service.ts
-│   ├── ultramsg/          # WhatsApp service via UltraMsg
-│   │   ├── ultramsg.config.ts
-│   │   ├── ultramsg.interface.ts
-│   │   ├── ultramsg.module.ts
-│   │   └── ultramsg.service.ts
-│   ├── utils/             # Utility functions
-│   │   ├── date.ts
-│   │   ├── object.ts
+│   │   ├── backup.service.ts
+│   │   └── index.ts
+│   ├── database/            # Database utilities and patterns
+│   │   ├── database.module.ts
+│   │   ├── database.repository.ts
+│   │   ├── database.scheme.ts
+│   │   ├── database.service.ts
+│   │   ├── database.sync.ts
+│   │   ├── database.transaction.ts
+│   │   ├── database.uniqueId.ts
+│   │   ├── database.utils.ts
+│   │   └── index.ts
+│   ├── service/             # Base service class
+│   │   ├── service.ts
 │   │   └── index.ts
-│   └── index.ts           # Main exports
+│   ├── test/                # Example/test implementation
+│   │   ├── test.dto.ts
+│   │   ├── test.module.ts
+│   │   ├── test.repository.ts
+│   │   ├── test.resolver.ts
+│   │   ├── test.schema.ts
+│   │   └── test.service.ts
+│   ├── app.controller.ts
+│   ├── app.module.ts
+│   ├── main.ts
+│   └── index.ts             # Main exports
 └── tsconfig.lib.json
 ```
 ### Common Issues
@@ -631,7 +410,7 @@ If `pnpm link` doesn't work, use the file path dependency method instead:
 ```json
 {
   "dependencies": {
-    "zync-nest-library": "file:../../zync-library/zync-nest-library"
+    "zync-nest-data-module": "file:../../zync-library/zync-nest-data-module"
   }
 }
 ```
@@ -654,7 +433,7 @@ If you see peer dependency warnings (e.g., `@nestjs/core` version mismatch), you
 #### 3. Build errors after linking
 Make sure to build the library first:
 ```bash
-cd zync-nest-library
+cd zync-nest-data-module
 pnpm run build
 ```
 
@@ -667,6 +446,14 @@ pnpm run build
 # No need to reinstall - changes are automatically available in linked projects
 ```
 
+#### 5. Registry access issues
+If you encounter issues accessing the AsyncTech registry, ensure you have proper authentication:
+
+```bash
+# Login to AsyncTech registry
+npm login --registry https://registry.asynctechs.com/
+```
+
 ## 🐛 Issues
 
 If you encounter any issues or have questions, please file an issue on the project repository.