npm - @valentine-efagene/qshelter-common - Versions diffs - 1.0.0 - Mend

@valentine-efagene/qshelter-common 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (179) hide show

package/OpenApiHelper.ts +121 -0
package/decorator/permission.decorator.ts +4 -0
package/decorator/tenant.decorator.ts +16 -0
package/dist/entities/BaseEntity.d.ts +11 -0
package/dist/entities/BaseEntity.js +54 -0
package/dist/entities/BaseEntity.js.map +1 -0
package/dist/entities/TenantAwareEntity.d.ts +10 -0
package/dist/entities/TenantAwareEntity.js +52 -0
package/dist/entities/TenantAwareEntity.js.map +1 -0
package/dist/entities/TenantAwareRepository.d.ts +13 -0
package/dist/entities/TenantAwareRepository.js +65 -0
package/dist/entities/TenantAwareRepository.js.map +1 -0
package/dist/entities/amenity.entity.d.ts +4 -0
package/dist/entities/amenity.entity.js +27 -0
package/dist/entities/amenity.entity.js.map +1 -0
package/dist/entities/common.entity.d.ts +17 -0
package/dist/entities/common.entity.js +63 -0
package/dist/entities/common.entity.js.map +1 -0
package/dist/entities/common.pure.entity.d.ts +11 -0
package/dist/entities/common.pure.entity.js +51 -0
package/dist/entities/common.pure.entity.js.map +1 -0
package/dist/entities/index.d.ts +27 -0
package/dist/entities/index.js +44 -0
package/dist/entities/index.js.map +1 -0
package/dist/entities/mortgage-document.entity.d.ts +14 -0
package/dist/entities/mortgage-document.entity.js +58 -0
package/dist/entities/mortgage-document.entity.js.map +1 -0
package/dist/entities/mortgage-downpayment-installment.entity.d.ts +19 -0
package/dist/entities/mortgage-downpayment-installment.entity.js +63 -0
package/dist/entities/mortgage-downpayment-installment.entity.js.map +1 -0
package/dist/entities/mortgage-downpayment-payment.entity.d.ts +28 -0
package/dist/entities/mortgage-downpayment-payment.entity.js +84 -0
package/dist/entities/mortgage-downpayment-payment.entity.js.map +1 -0
package/dist/entities/mortgage-downpayment.entity.d.ts +22 -0
package/dist/entities/mortgage-downpayment.entity.js +66 -0
package/dist/entities/mortgage-downpayment.entity.js.map +1 -0
package/dist/entities/mortgage-step.entity.d.ts +12 -0
package/dist/entities/mortgage-step.entity.js +52 -0
package/dist/entities/mortgage-step.entity.js.map +1 -0
package/dist/entities/mortgage-type.entity.d.ts +10 -0
package/dist/entities/mortgage-type.entity.js +46 -0
package/dist/entities/mortgage-type.entity.js.map +1 -0
package/dist/entities/mortgage.entity.d.ts +37 -0
package/dist/entities/mortgage.entity.js +124 -0
package/dist/entities/mortgage.entity.js.map +1 -0
package/dist/entities/password_reset_tokens.entity.d.ts +7 -0
package/dist/entities/password_reset_tokens.entity.js +43 -0
package/dist/entities/password_reset_tokens.entity.js.map +1 -0
package/dist/entities/permission.entity.d.ts +6 -0
package/dist/entities/permission.entity.js +30 -0
package/dist/entities/permission.entity.js.map +1 -0
package/dist/entities/property-document.entity.d.ts +6 -0
package/dist/entities/property-document.entity.js +34 -0
package/dist/entities/property-document.entity.js.map +1 -0
package/dist/entities/property-media.entity.d.ts +6 -0
package/dist/entities/property-media.entity.js +36 -0
package/dist/entities/property-media.entity.js.map +1 -0
package/dist/entities/property.entity.d.ts +36 -0
package/dist/entities/property.entity.js +182 -0
package/dist/entities/property.entity.js.map +1 -0
package/dist/entities/refresh_token.entity.d.ts +7 -0
package/dist/entities/refresh_token.entity.js +35 -0
package/dist/entities/refresh_token.entity.js.map +1 -0
package/dist/entities/role.entity.d.ts +8 -0
package/dist/entities/role.entity.js +39 -0
package/dist/entities/role.entity.js.map +1 -0
package/dist/entities/settings.entity.d.ts +17 -0
package/dist/entities/settings.entity.js +79 -0
package/dist/entities/settings.entity.js.map +1 -0
package/dist/entities/social.entity.d.ts +8 -0
package/dist/entities/social.entity.js +46 -0
package/dist/entities/social.entity.js.map +1 -0
package/dist/entities/tenant.entity.d.ts +29 -0
package/dist/entities/tenant.entity.js +82 -0
package/dist/entities/tenant.entity.js.map +1 -0
package/dist/entities/transaction.entity.d.ts +17 -0
package/dist/entities/transaction.entity.js +84 -0
package/dist/entities/transaction.entity.js.map +1 -0
package/dist/entities/user.entity.d.ts +26 -0
package/dist/entities/user.entity.js +103 -0
package/dist/entities/user.entity.js.map +1 -0
package/dist/entities/user_suspensions.entity.d.ts +7 -0
package/dist/entities/user_suspensions.entity.js +42 -0
package/dist/entities/user_suspensions.entity.js.map +1 -0
package/dist/entities/wallet.entity.d.ts +17 -0
package/dist/entities/wallet.entity.js +79 -0
package/dist/entities/wallet.entity.js.map +1 -0
package/dist/index.d.ts +3 -0
package/dist/index.js +20 -0
package/dist/index.js.map +1 -0
package/dist/pagination/index.d.ts +2 -0
package/dist/pagination/index.js +19 -0
package/dist/pagination/index.js.map +1 -0
package/dist/pagination/pagination.helper.d.ts +7 -0
package/dist/pagination/pagination.helper.js +40 -0
package/dist/pagination/pagination.helper.js.map +1 -0
package/dist/pagination/pagination.types.d.ts +19 -0
package/dist/pagination/pagination.types.js +3 -0
package/dist/pagination/pagination.types.js.map +1 -0
package/dist/standard-response.d.ts +7 -0
package/dist/standard-response.js +27 -0
package/dist/standard-response.js.map +1 -0
package/dist/tsconfig.tsbuildinfo +1 -0
package/dist/types/common.type.d.ts +26 -0
package/dist/types/common.type.js +26 -0
package/dist/types/common.type.js.map +1 -0
package/dist/types/mortgage-fsm.types.d.ts +180 -0
package/dist/types/mortgage-fsm.types.js +130 -0
package/dist/types/mortgage-fsm.types.js.map +1 -0
package/dist/types/policy.types.d.ts +18 -0
package/dist/types/policy.types.js +3 -0
package/dist/types/policy.types.js.map +1 -0
package/dist/types/property.type.d.ts +9 -0
package/dist/types/property.type.js +15 -0
package/dist/types/property.type.js.map +1 -0
package/dist/types/social.enums.d.ts +15 -0
package/dist/types/social.enums.js +22 -0
package/dist/types/social.enums.js.map +1 -0
package/dist/types/tenant.enums.d.ts +13 -0
package/dist/types/tenant.enums.js +19 -0
package/dist/types/tenant.enums.js.map +1 -0
package/dist/types/transaction.type.d.ts +8 -0
package/dist/types/transaction.type.js +14 -0
package/dist/types/transaction.type.js.map +1 -0
package/dist/types/user.enums.d.ts +10 -0
package/dist/types/user.enums.js +16 -0
package/dist/types/user.enums.js.map +1 -0
package/entities/BaseEntity.ts +34 -0
package/entities/TenantAwareEntity.ts +34 -0
package/entities/TenantAwareRepository.ts +100 -0
package/entities/amenity.entity.ts +10 -0
package/entities/common.entity.ts +46 -0
package/entities/common.pure.entity.ts +36 -0
package/entities/index.ts +27 -0
package/entities/mortgage-document.entity.ts +37 -0
package/entities/mortgage-downpayment-installment.entity.ts +40 -0
package/entities/mortgage-downpayment-payment.entity.ts +61 -0
package/entities/mortgage-downpayment.entity.ts +43 -0
package/entities/mortgage-step.entity.ts +33 -0
package/entities/mortgage-type.entity.ts +31 -0
package/entities/mortgage.entity.ts +89 -0
package/entities/password_reset_tokens.entity.ts +25 -0
package/entities/permission.entity.ts +12 -0
package/entities/property-document.entity.ts +21 -0
package/entities/property-media.entity.ts +23 -0
package/entities/property.entity.ts +147 -0
package/entities/refresh_token.entity.ts +16 -0
package/entities/role.entity.ts +20 -0
package/entities/settings.entity.ts +56 -0
package/entities/social.entity.ts +27 -0
package/entities/tenant.entity.ts +65 -0
package/entities/transaction.entity.ts +56 -0
package/entities/user.entity.ts +89 -0
package/entities/user_suspensions.entity.ts +24 -0
package/entities/wallet.entity.ts +54 -0
package/guard/permission.guard.ts +42 -0
package/guard/swagger-auth.guard.ts +9 -0
package/helpers/ArrayHelper.ts +1 -0
package/helpers/ConstantHelper.ts +101 -0
package/helpers/CustomNamingStrategy.ts +27 -0
package/helpers/DateHelper.ts +21 -0
package/helpers/EmailHelper.ts +38 -0
package/helpers/FileSystemHelper.ts +101 -0
package/index.ts +9 -0
package/middleware/TenantMiddleware.ts +52 -0
package/package.json +46 -0
package/pagination/index.ts +2 -0
package/pagination/pagination.helper.ts +57 -0
package/pagination/pagination.types.ts +21 -0
package/standard-response.ts +16 -0
package/tsconfig.json +33 -0
package/types/common.type.ts +32 -0
package/types/mortgage-fsm.types.ts +279 -0
package/types/policy.types.ts +21 -0
package/types/property.type.ts +10 -0
package/types/social.enums.ts +17 -0
package/types/tenant.enums.ts +14 -0
package/types/transaction.type.ts +9 -0
package/types/user.enums.ts +11 -0

package/helpers/ConstantHelper.ts ADDED Viewed

@@ -0,0 +1,101 @@
+class ConstantHelper {
+    public static readonly mailConstants = {
+        // Emails
+        firstEmail: process.env.FIRST_EMAIL,
+        secondEmail: process.env.INFO_EMAIL,
+        thirdEmail: process.env.SUPPORT_EMAIL,
+        supportEmail: process.env.SUPPORT_EMAIL,
+        // Website & Branding
+        appLink: process.env.APP_LINK,
+        appLogo: process.env.APP_LOGO,
+        // Phone Numbers
+        firstPhoneNumber: process.env.FIRST_PHONE_NUMBER,
+        secondPhoneNumber: process.env.SECOND_PHONE_NUMBER,
+        firstPhoneLink: process.env.FIRST_PHONE_LINK,
+        secondPhoneLink: process.env.SECOND_PHONE_LINK,
+        supportPhone: process.env.SUPPORT_PHONE,
+        // Office Addresses
+        firstOfficeAddress: process.env.FIRST_OFFICE_ADDRESS,
+        secondOfficeAddress: process.env.SECOND_OFFICE_ADDRESS,
+        officeAddress: process.env.OFFICE_ADDRESS,
+        // Social Media
+        facebookLink: process.env.FACEBOOK_LINK,
+        facebookLogo: process.env.FACEBOOK_LOGO,
+        twitterLink: process.env.TWITTER_LINK,
+        twitterLogo: process.env.TWITTER_LOGO,
+        instagramLink: process.env.INSTAGRAM_LINK,
+        instagramLogo: process.env.INSTAGRAM_LOGO,
+        youtubeLink: process.env.YOUTUBE_LINK,
+        youtubeLogo: process.env.YOUTUBE_LOGO,
+        linkedinLink: process.env.LINKEDIN_LINK,
+        linkedinLogo: process.env.LINKEDIN_LOGO,
+        // Other
+        unsubscribeLink: process.env.UNSUBSCRIBE_LINK,
+    };
+    public static get socialLinks() {
+        const { mailConstants: c } = this;
+        return [
+            { name: "Facebook", link: c.facebookLink, icon: c.facebookLogo },
+            { name: "Twitter", link: c.twitterLink, icon: c.twitterLogo },
+            { name: "Instagram", link: c.instagramLink, icon: c.instagramLogo },
+            { name: "YouTube", link: c.youtubeLink, icon: c.youtubeLogo },
+            { name: "LinkedIn", link: c.linkedinLink, icon: c.linkedinLogo },
+        ];
+    }
+    public static readonly exampleTicketTemplate = `
+    <!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Your Ticket</title>
+</head>
+<body style="margin: 0; padding: 0; font-family: Arial, sans-serif; background: #f7f7f7;">
+  <table width="100%" cellpadding="0" cellspacing="0" style="padding: 2rem 0;">
+    <tr>
+      <td align="center">
+        <table width="400" cellpadding="0" cellspacing="0" style="background: #fff; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.1); overflow: hidden;">
+          <tr>
+            <td style="padding: 1.5rem; background: #2c3e50; color: #fff; text-align: center;">
+              <h2 style="margin: 0; font-size: 24px;">Your Event Ticket</h2>
+            </td>
+          </tr>
+          <tr>
+            <td style="padding: 1.5rem;">
+              <p style="margin: 0 0 1rem;">Hello <strong>{{name}}</strong>,</p>
+              <p style="margin: 0 0 1rem;">Thanks for registering! Below is your ticket barcode:</p>
+              <div style="text-align: center; margin: 2rem 0;">
+                <img src="{{qrCodeUrl}}" alt="Ticket Barcode" style="width: 80%; max-width: 150px;" />
+              </div>
+              <p style="font-size: 0.9rem; color: #7f8c8d; text-align: center;">
+                Please bring this ticket or show it on your phone at the entrance.
+              </p>
+            </td>
+          </tr>
+          <tr>
+            <td style="padding: 1rem; background: #ecf0f1; text-align: center;">
+              <small style="color: #95a5a6;">&copy; 2025 MediaCraft. All rights reserved.</small>
+            </td>
+          </tr>
+        </table>
+      </td>
+    </tr>
+  </table>
+</body>
+</html>
+`
+}
+export { ConstantHelper }

package/helpers/CustomNamingStrategy.ts ADDED Viewed

@@ -0,0 +1,27 @@
+import { DefaultNamingStrategy, NamingStrategyInterface } from 'typeorm';
+export class CustomNamingStrategy
+  extends DefaultNamingStrategy
+  implements NamingStrategyInterface {
+  tableName(className: string, customName: string): string {
+    return customName ? customName : this.snakeCase(className);
+  }
+  columnName(
+    propertyName: string,
+    customName: string,
+    //embeddedPrefixes: string[],
+  ): string {
+    return customName ? customName : this.snakeCase(propertyName);
+  }
+  relationName(propertyName: string): string {
+    return this.snakeCase(propertyName);
+  }
+  private snakeCase(name: string): string {
+    return name
+      .replace(/([A-Z])/g, (match) => `_${match.toLowerCase()}`)
+      .replace(/^_/, '');
+  }
+}

package/helpers/DateHelper.ts ADDED Viewed

@@ -0,0 +1,21 @@
+import { BadRequestException } from '@nestjs/common';
+export default class DateHelper {
+  public static formatDateToYYYYMMDD(dateString: string) {
+    try {
+      const date = new Date(dateString);
+      // Ensure the input is a valid Date object
+      if (!(date instanceof Date)) {
+        throw new BadRequestException('Invalid date');
+      }
+      // Format the date using the formatter
+      const formattedDate = date.toISOString().split('T')[0];
+      return formattedDate;
+    } catch (error) {
+      throw new BadRequestException('Invalid date');
+    }
+  }
+}

package/helpers/EmailHelper.ts ADDED Viewed

@@ -0,0 +1,38 @@
+import * as Handlebars from 'handlebars';
+import { FileSystemHelper } from "./FileSystemHelper";
+export default class EmailHelper {
+    public static async compileStringTemplate(rawTemplate: string, variables: Record<string, any>): Promise<string> {
+        try {
+            // Compile it with Handlebars
+            const compiled = Handlebars.compile(rawTemplate);
+            const html = compiled(variables);
+            return html;
+        } catch (error) {
+            throw new Error(`Failed to generate HTML: ${error.message}`);
+        }
+    }
+    public static async compileTemplate(templatePath: string, variables: Record<string, any>): Promise<string> {
+        try {
+            // Load the raw template
+            const rawTemplate = FileSystemHelper.loadFile(templatePath);
+            // Compile it with Handlebars
+            const compiled = Handlebars.compile(rawTemplate);
+            if (templatePath.includes('layout')) {
+                console.log({ compiled, variables })
+            }
+            const html = compiled(variables);
+            return html;
+        } catch (error) {
+            throw new Error(`Failed to generate HTML: ${error.message}`);
+        }
+    }
+}

package/helpers/FileSystemHelper.ts ADDED Viewed

@@ -0,0 +1,101 @@
+import { readFileSync, readdirSync, statSync, promises, constants } from 'fs';
+import * as path from 'path';
+export class FileSystemHelper {
+    private static root: string = path.join(__dirname, '../../mail/templates/');
+    public static async getFilePath(fileName: string): Promise<string> {
+        const filePath = path.join(this.root, fileName);
+        return filePath
+    }
+    public static async checkFileExists(fileName: string): Promise<boolean> {
+        const filePath = path.join(this.root, fileName);
+        try {
+            await promises.access(`${filePath}`, constants.F_OK)
+            console.log({ filePath, found: true })
+            return true
+        } catch (error) {
+            console.log({ filePath, found: false })
+            return false
+        }
+    }
+    public static loadFileWithFullPath(path: string): string {
+        const fileContent = readFileSync(path, 'utf-8');
+        return fileContent;
+    }
+    public static loadFile(fileName: string): string {
+        const filePath = path.join(this.root, fileName);
+        const fileContent = readFileSync(filePath, 'utf-8');
+        return fileContent;
+    }
+    public static async splitFilePath(filePath: string) {
+        // Normalize the file path to handle both Windows and Unix formats
+        let normalizedPath = path.normalize(filePath)
+        normalizedPath = normalizedPath.replaceAll('\\', '/')
+        // Get the file name (last part of the path)
+        const fileName = path.basename(normalizedPath);
+        // Get the directory path
+        const directoryPath = path.dirname(normalizedPath);
+        const extension = path.extname(fileName)
+        // Split the directory path into an array of folders
+        const folderArray = directoryPath.split('/');
+        // Reassemble the folder path as a string (optional, if you need it in this format)
+        const folderPath = folderArray.join('/');
+        return {
+            folderArray,
+            folderPath,
+            fileName,
+            extension
+        };
+    }
+    public static loadTemplate(fileName: string): string {
+        const filePath = path.join(this.root, `${fileName}`);
+        const fileContent = readFileSync(filePath, 'utf-8');
+        return fileContent;
+    }
+    // Method to list all .html files from the templates directory
+    public static listHtmlFilesInTemplates(): string[] {
+        const htmlFiles: string[] = [];
+        const getFilesRecursively = (dir: string) => {
+            try {
+                const files = readdirSync(dir);
+                files.forEach(file => {
+                    const fullPath = path.join(dir, file);
+                    const relativePath = path.relative(this.root, fullPath);
+                    if (statSync(fullPath).isDirectory()) {
+                        // If it's a directory, go deeper
+                        getFilesRecursively(fullPath);
+                    } else if (file.endsWith('.html')) {
+                        // If it's an HTML file, add to the list
+                        htmlFiles.push(relativePath);
+                    }
+                });
+            } catch (error) {
+                console.log(error)
+                throw error
+            }
+        };
+        // Start the recursion from the templates folder
+        getFilesRecursively(this.root);
+        return htmlFiles;
+    }
+}

package/index.ts ADDED Viewed

@@ -0,0 +1,9 @@
+// Pagination
+export * from './pagination';
+// Types
+export * from './standard-response';
+// Entities
+export * from './entities';

package/middleware/TenantMiddleware.ts ADDED Viewed

@@ -0,0 +1,52 @@
+import { Injectable, NestMiddleware } from '@nestjs/common';
+import { Request, Response, NextFunction } from 'express';
+// Extend Express Request to include tenantId
+declare global {
+    namespace Express {
+        interface Request {
+            tenantId?: number;
+        }
+    }
+}
+@Injectable()
+export class TenantMiddleware implements NestMiddleware {
+    async use(req: Request, _res: Response, next: NextFunction) {
+        // Prefer explicit header `x-tenant-id`
+        const tenantIdHeader = (req.headers['x-tenant-id'] as string) || (req.headers['X-Tenant-Id'] as string);
+        if (tenantIdHeader) {
+            const id = parseInt(tenantIdHeader, 10);
+            if (!isNaN(id)) {
+                req.tenantId = id;
+                return next();
+            }
+        }
+        // Fall back to subdomain extraction (subdomain.domain.tld)
+        const host = (req.hostname || req.headers.host || '').toString();
+        const subdomain = this.extractSubdomain(host);
+        if (subdomain) {
+            // If subdomain is numeric, treat as tenantId; otherwise leave undefined
+            const id = parseInt(subdomain, 10);
+            if (!isNaN(id)) {
+                req.tenantId = id;
+            }
+        }
+        next();
+    }
+    private extractSubdomain(host: string): string | null {
+        if (!host) return null;
+        const hostname = host.split(':')[0];
+        const parts = hostname.split('.');
+        if (hostname === 'localhost' || /^(\d{1,3}\.){3}\d{1,3}$/.test(hostname)) {
+            return null;
+        }
+        if (parts.length >= 3) return parts[0];
+        return null;
+    }
+}
+export default TenantMiddleware;

package/package.json ADDED Viewed

@@ -0,0 +1,46 @@
+{
+    "name": "@valentine-efagene/qshelter-common",
+    "version": "1.0.0",
+    "description": "Shared common utilities, DTOs, guards, middleware, decorators, and pagination for QShelter",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "build": "tsc",
+        "prepublishOnly": "npm run build",
+        "publish:public": "npm publish --access public",
+        "build:watch": "tsc -w",
+        "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+        "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix"
+    },
+    "keywords": [
+        "common",
+        "utilities",
+        "nestjs",
+        "entities",
+        "pagination",
+        "qshelter"
+    ],
+    "author": "Valentine Efagene",
+    "license": "MIT",
+    "peerDependencies": {
+        "typeorm": "^0.3.0",
+        "@nestjs/common": "^10.0.0",
+        "@nestjs/swagger": "^7.4.0",
+        "@nestjs/config": "^3.0.0",
+        "@nestjs/jwt": "^10.0.0",
+        "class-validator": "^0.14.0",
+        "class-transformer": "^0.5.0"
+    },
+    "dependencies": {},
+    "devDependencies": {
+        "@nestjs/swagger": "^7.4.0",
+        "typeorm": "^0.3.20",
+        "@nestjs/common": "^10.0.0",
+        "@nestjs/config": "^3.0.0",
+        "@nestjs/jwt": "^10.0.0",
+        "class-validator": "^0.14.0",
+        "class-transformer": "^0.5.1",
+        "typescript": "^5.0.0",
+        "@types/node": "^20.0.0"
+    }
+}

package/pagination/index.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export * from './pagination.types';
2	+ export * from './pagination.helper';

package/pagination/pagination.helper.ts ADDED Viewed

@@ -0,0 +1,57 @@
+import { PaginatedResponse, PaginationQuery } from './pagination.types';
+export class PaginationHelper {
+    /**
+     * Creates a paginated response object
+     */
+    static paginate<T>(
+        items: T[],
+        total: number,
+        query: PaginationQuery
+    ): PaginatedResponse<T> {
+        const page = Math.max(1, query.page || 1);
+        const limit = this.getLimit(query.limit);
+        const totalPages = Math.ceil(total / limit);
+        return {
+            data: items,
+            meta: {
+                total,
+                page,
+                limit,
+                totalPages,
+                hasNext: page < totalPages,
+                hasPrev: page > 1,
+            },
+        };
+    }
+    /**
+     * Calculate the number of records to skip for pagination
+     */
+    static getSkip(page?: number, limit?: number): number {
+        const actualPage = Math.max(1, page || 1);
+        const actualLimit = this.getLimit(limit);
+        return (actualPage - 1) * actualLimit;
+    }
+    /**
+     * Get validated limit (min: 1, max: 100, default: 10)
+     */
+    static getLimit(limit?: number): number {
+        return Math.min(100, Math.max(1, limit || 10));
+    }
+    /**
+     * Parse and validate pagination query parameters
+     */
+    static parseQuery(query: any): PaginationQuery {
+        return {
+            page: query.page ? parseInt(query.page, 10) : 1,
+            limit: query.limit ? parseInt(query.limit, 10) : 10,
+            sortBy: query.sortBy || 'id',
+            sortOrder: query.sortOrder?.toUpperCase() === 'ASC' ? 'ASC' : 'DESC',
+            search: query.search || undefined,
+        };
+    }
+}

package/pagination/pagination.types.ts ADDED Viewed

@@ -0,0 +1,21 @@
+export interface PaginationQuery {
+    page?: number;
+    limit?: number;
+    sortBy?: string;
+    sortOrder?: 'ASC' | 'DESC';
+    search?: string;
+}
+export interface PaginationMeta {
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}
+export interface PaginatedResponse<T> {
+    data: T[];
+    meta: PaginationMeta;
+}

package/standard-response.ts ADDED Viewed

@@ -0,0 +1,16 @@
+import { ApiExtraModels } from "@nestjs/swagger";
+@ApiExtraModels(StandardApiResponse)
+export class StandardApiResponse<T = any> {
+    ok: boolean
+    status: number;
+    message: string;
+    body?: T;
+    constructor(status: number, message: string, body?: T) {
+        this.message = message;
+        this.status = status;
+        this.body = body;
+        this.ok = status >= 200 && status < 300;
+    }
+}

package/tsconfig.json ADDED Viewed

@@ -0,0 +1,33 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "declaration": true,
+        "removeComments": true,
+        "emitDecoratorMetadata": true,
+        "experimentalDecorators": true,
+        "allowSyntheticDefaultImports": true,
+        "target": "ES2021",
+        "sourceMap": true,
+        "outDir": "./dist",
+        "baseUrl": "./",
+        "incremental": true,
+        "skipLibCheck": true,
+        "strictNullChecks": false,
+        "noImplicitAny": false,
+        "strictBindCallApply": false,
+        "forceConsistentCasingInFileNames": false,
+        "noFallthroughCasesInSwitch": false,
+        "esModuleInterop": true
+    },
+    "include": [
+        "pagination/**/*.ts",
+        "entities/**/*.ts",
+        "types/**/*.ts",
+        "index.ts",
+        "standard-response.ts"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}

package/types/common.type.ts ADDED Viewed

@@ -0,0 +1,32 @@
+export enum DocumentStatus {
+  APPROVED = 'APPROVED',
+  PENDING = 'PENDING',
+  DECLINED = 'DECLINED',
+}
+export enum Status {
+  APPROVED = 'APPROVED',
+  PENDING = 'PENDING',
+  DECLINED = 'DECLINED',
+}
+export interface IDocument {
+  url: string;
+  name: string;
+  description: string;
+}
+export class PaginatedData {
+  total: number;
+  totalPages: number;
+  currentPage: number;
+}
+export enum Frequency {
+  MONTHLY = 'MONTHLY',
+  YEARLY = 'YEARLY',
+  ONE_TIME = 'ONE_TIME',
+  DAILY = 'DAILY',
+}