@premiumsarl/premium-nodejs-library 4.0.0

package/README.md

@@ -0,0 +1,132 @@
+# premium_nodejs_library
+
+Shared Node.js library for **Premium SARL** projects (Babel, GrooMe, etc.).
+
+> Formerly `base_nodejs_library`. Renamed in v4.0.0.
+
+## Install
+
+```bash
+# From npm (once published)
+npm install premium_nodejs_library
+
+# Or link locally during development
+npm link ../Libraries/base_nodejs_library
+```
+
+## Modules
+
+| Module | Import Path | Used By |
+|---|---|---|
+| **Auth** | `premium_nodejs_library` → `hashPassword`, `generateJWT` | Babel, GrooMe |
+| **Email** | `premium_nodejs_library` → `sendEmail`, `sendEmailWithName` | Babel, GrooMe |
+| **Responses (Express)** | `premium_nodejs_library` → `generateBadRequestResponse`, etc. | Babel |
+| **Responses (Next.js)** | `premium_nodejs_library` → `successResponse`, `errorResponse` | GrooMe |
+| **Responses (Core)** | `premium_nodejs_library` → `makeSuccess`, `makeError` | Any framework |
+| **Storage (S3)** | `premium_nodejs_library` → `uploadFilesToS3`, `deleteFileFromS3` | Babel |
+| **Storage (Supabase)** | `premium_nodejs_library` → `uploadToSupabase`, `deleteFromSupabase` | GrooMe |
+| **Payments (Stripe)** | `premium_nodejs_library` → `createStripeClient` | GrooMe |
+| **Payments (PayTech)** | `premium_nodejs_library` → `createPayTechPayment` | GrooMe |
+| **OTP & Twilio** | `premium_nodejs_library` → `generateOtp`, `twilioSendOTP` | Babel |
+| **Validation** | `premium_nodejs_library` → `isValidEmail`, `checkEmptyString` | Both |
+| **DB (MySQL)** | `premium_nodejs_library` → `runAnyQuery`, `selectQueryModule` | Babel |
+| **DB (Prisma)** | `premium_nodejs_library` → `createPrismaSingleton` | GrooMe |
+| **Utils (String)** | `premium_nodejs_library` → `normalizeString`, `capitalizeFirstLetter` | Both |
+| **Utils (Date)** | `premium_nodejs_library` → `isPastDate`, `dBDateFormatModule` | Both |
+| **Utils (Misc)** | `premium_nodejs_library` → `applyPagination`, `randomNumberModule` | Both |
+
+## Usage
+
+### Babel (Express)
+```ts
+// Named imports (recommended)
+import {
+  hashPassword,
+  generateJWT,
+  generateBadRequestResponse,
+  uploadFiles3Bucket,
+  runAnyQuery,
+} from "premium_nodejs_library";
+
+// Default import (backward compatible)
+import base from "premium_nodejs_library";
+base.hashPassword("secret");
+```
+
+### GrooMe (Next.js)
+```ts
+import {
+  hashPassword,
+  generateJWT,
+  successResponse,
+  errorResponse,
+  createPrismaSingleton,
+  createStripeClient,
+  sendEmailWithName,
+} from "premium_nodejs_library";
+```
+
+## Peer Dependencies
+
+These are **optional** — install only what your project needs:
+
+| Package | Required By |
+|---|---|
+| `express` | Babel (Express response adapters) |
+| `mysql2` | Babel (MySQL queries) |
+| `stripe` | GrooMe (Stripe payments) |
+| `@supabase/supabase-js` | GrooMe (Supabase storage) |
+| `@prisma/client` | GrooMe (Prisma ORM) |
+
+## Migration from base_nodejs_library
+
+1. Update `package.json`: `"premium_nodejs_library": "4.0.0"`
+2. **No code changes needed**  — all function names are identical
+3. The default export (`import base from "..."`) still works
+
+### What changed in v4.0.0
+- **Renamed** from `base_nodejs_library`
+- **Modularized** from 1 file (751 lines) → 13 focused modules
+- **Removed `moment.js`** — uses native Date APIs
+- **Switched `bcrypt` → `bcryptjs`** — pure JS, works on serverless (Vercel)
+- **Added Next.js response adapters** for GrooMe
+- **Added Supabase, Stripe, PayTech, Prisma** modules
+- **Optional peer dependencies** — install only what you need
+
+## Development
+
+```bash
+# Build
+npm run build
+
+# Clean
+npm run clean
+```
+
+## Project Structure
+
+```
+src/
+├── index.ts              ← Barrel re-exports + default export
+├── auth/index.ts         ← JWT + bcrypt
+├── email/index.ts        ← SendGrid
+├── responses/
+│   ├── core.ts           ← Framework-agnostic
+│   ├── express.ts        ← Express adapters
+│   └── nextjs.ts         ← Next.js adapters
+├── storage/
+│   ├── s3.ts             ← AWS S3
+│   └── supabase.ts       ← Supabase Storage
+├── payments/
+│   ├── stripe.ts         ← Stripe client
+│   └── paytech.ts        ← PayTech gateway
+├── otp/index.ts          ← OTP + Twilio
+├── validation/index.ts   ← Input validators
+├── db/
+│   ├── mysql.ts          ← Raw MySQL queries
+│   └── prisma.ts         ← Prisma singleton
+└── utils/
+    ├── string.ts         ← String manipulation
+    ├── date.ts           ← Date formatting
+    └── misc.ts           ← Pagination, random, env
+```

package/dist/auth/index.d.ts

@@ -0,0 +1,19 @@
+import * as JWT from "jsonwebtoken";
+/**
+ * Hash a plaintext password with bcryptjs.
+ */
+export declare const hashPassword: (password: string) => Promise<string>;
+/**
+ * Compare a plaintext password against a bcrypt hash.
+ */
+export declare const compareHashedPassword: (password: string, hashedPassword: string) => Promise<boolean>;
+/**
+ * Sign a JWT with the given payload, secret key, and
+ * expiration time.
+ */
+export declare const generateJWT: (payload: JWT.JwtPayload, tokenKey: string, expiryTime?: string | number) => string;
+/**
+ * Verify and decode a JWT token.
+ */
+export declare const verifyJWT: (token: string, tokenKey: string) => JWT.JwtPayload | string;
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAIpC;;GAEG;AACH,eAAO,MAAM,YAAY,aACX,MAAM,KACjB,QAAQ,MAAM,CAEhB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,aACpB,MAAM,kBACA,MAAM,KACvB,QAAQ,OAAO,CAEjB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,YACX,IAAI,UAAU,YACb,MAAM,eACJ,MAAM,GAAG,MAAM,KAC5B,MASF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,UACX,MAAM,YACH,MAAM,KACjB,IAAI,UAAU,GAAG,MAEnB,CAAC"}

package/dist/auth/index.js

@@ -0,0 +1,61 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyJWT = exports.generateJWT = exports.compareHashedPassword = exports.hashPassword = void 0;
+const bcrypt = __importStar(require("bcryptjs"));
+const JWT = __importStar(require("jsonwebtoken"));
+const BCRYPT_SALT_ROUNDS = 10;
+/**
+ * Hash a plaintext password with bcryptjs.
+ */
+const hashPassword = async (password) => {
+    return bcrypt.hash(password, BCRYPT_SALT_ROUNDS);
+};
+exports.hashPassword = hashPassword;
+/**
+ * Compare a plaintext password against a bcrypt hash.
+ */
+const compareHashedPassword = async (password, hashedPassword) => {
+    return bcrypt.compare(password, hashedPassword);
+};
+exports.compareHashedPassword = compareHashedPassword;
+/**
+ * Sign a JWT with the given payload, secret key, and
+ * expiration time.
+ */
+const generateJWT = (payload, tokenKey, expiryTime = "24h") => {
+    return JWT.sign(payload, tokenKey, {
+        expiresIn: expiryTime,
+    });
+};
+exports.generateJWT = generateJWT;
+/**
+ * Verify and decode a JWT token.
+ */
+const verifyJWT = (token, tokenKey) => {
+    return JWT.verify(token, tokenKey);
+};
+exports.verifyJWT = verifyJWT;
+//# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,iDAAmC;AACnC,kDAAoC;AAEpC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B;;GAEG;AACI,MAAM,YAAY,GAAG,KAAK,EAC7B,QAAgB,EACD,EAAE;IACjB,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;AACrD,CAAC,CAAC;AAJW,QAAA,YAAY,gBAIvB;AAEF;;GAEG;AACI,MAAM,qBAAqB,GAAG,KAAK,EACtC,QAAgB,EAChB,cAAsB,EACN,EAAE;IAClB,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;AACpD,CAAC,CAAC;AALW,QAAA,qBAAqB,yBAKhC;AAEF;;;GAGG;AACI,MAAM,WAAW,GAAG,CACvB,OAAuB,EACvB,QAAgB,EAChB,aAA8B,KAAK,EAC7B,EAAE;IACR,OAAO,GAAG,CAAC,IAAI,CACX,OAAiB,EACjB,QAAQ,EACR;QACI,SAAS,EACL,UAA0C;KACjD,CACJ,CAAC;AACN,CAAC,CAAC;AAbW,QAAA,WAAW,eAatB;AAEF;;GAEG;AACI,MAAM,SAAS,GAAG,CACrB,KAAa,EACb,QAAgB,EACO,EAAE;IACzB,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC,CAAC;AALW,QAAA,SAAS,aAKpB"}

package/dist/db/mysql.d.ts

@@ -0,0 +1,26 @@
+/**
+ * MySQL database helpers.
+ * Used by babel-lambda-api.
+ *
+ * Requires mysql2 as a peer dependency.
+ */
+export interface DbConnection {
+    query: (sql: string, values: any[], callback: (err: {
+        message: string;
+    } | null, data: any) => void) => void;
+}
+export interface QueryResult {
+    status: boolean;
+    message?: string;
+    data?: any;
+}
+/**
+ * Run an arbitrary SQL query.
+ */
+export declare const runAnyQuery: (dbCon: DbConnection, sql: string, values: any[]) => Promise<QueryResult>;
+/**
+ * Build and run a SELECT query with optional
+ * WHERE, GROUP BY, ORDER BY, and LIMIT clauses.
+ */
+export declare const selectQueryModule: (dbCon: DbConnection, table: string, columns: string, where: string | null, groupBy: string | null, orderBy: string | null, limit: string | null, values: any[]) => Promise<QueryResult>;
+//# sourceMappingURL=mysql.d.ts.map

package/dist/db/mysql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../src/db/mysql.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,CACH,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,GAAG,EAAE,EACb,QAAQ,EAAE,CACN,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,EAC/B,IAAI,EAAE,GAAG,KACR,IAAI,KACR,IAAI,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;CACd;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,UACb,YAAY,OACd,MAAM,UACH,GAAG,EAAE,KACd,QAAQ,WAAW,CAarB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,UACnB,YAAY,SACZ,MAAM,WACJ,MAAM,SACR,MAAM,GAAG,IAAI,WACX,MAAM,GAAG,IAAI,WACb,MAAM,GAAG,IAAI,SACf,MAAM,GAAG,IAAI,UACZ,GAAG,EAAE,KACd,QAAQ,WAAW,CA+BrB,CAAC"}

package/dist/db/mysql.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * MySQL database helpers.
+ * Used by babel-lambda-api.
+ *
+ * Requires mysql2 as a peer dependency.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectQueryModule = exports.runAnyQuery = void 0;
+/**
+ * Run an arbitrary SQL query.
+ */
+const runAnyQuery = (dbCon, sql, values) => {
+    return new Promise((resolve) => {
+        dbCon.query(sql, values, (err, data) => {
+            if (err) {
+                resolve({
+                    status: false,
+                    message: err.message,
+                });
+            }
+            else {
+                resolve({ status: true, data });
+            }
+        });
+    });
+};
+exports.runAnyQuery = runAnyQuery;
+/**
+ * Build and run a SELECT query with optional
+ * WHERE, GROUP BY, ORDER BY, and LIMIT clauses.
+ */
+const selectQueryModule = (dbCon, table, columns, where, groupBy, orderBy, limit, values) => {
+    return new Promise((resolve) => {
+        const whereClause = where
+            ? ` WHERE ${where}`
+            : "";
+        const groupByClause = groupBy
+            ? ` GROUP BY ${groupBy}`
+            : "";
+        const orderByClause = orderBy
+            ? ` ORDER BY ${orderBy}`
+            : "";
+        const limitClause = limit
+            ? ` LIMIT ${limit}`
+            : "";
+        const sql = `SELECT ${columns} FROM ${table}` +
+            `${whereClause}${groupByClause}` +
+            `${orderByClause}${limitClause}`;
+        dbCon.query(sql, values, (err, data) => {
+            if (err) {
+                resolve({
+                    status: false,
+                    message: err.message,
+                });
+            }
+            else {
+                resolve({ status: true, data });
+            }
+        });
+    });
+};
+exports.selectQueryModule = selectQueryModule;
+//# sourceMappingURL=mysql.js.map

package/dist/db/mysql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.js","sourceRoot":"","sources":["../../src/db/mysql.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAqBH;;GAEG;AACI,MAAM,WAAW,GAAG,CACvB,KAAmB,EACnB,GAAW,EACX,MAAa,EACO,EAAE;IACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACnC,IAAI,GAAG,EAAE,CAAC;gBACN,OAAO,CAAC;oBACJ,MAAM,EAAE,KAAK;oBACb,OAAO,EAAE,GAAG,CAAC,OAAO;iBACvB,CAAC,CAAC;YACP,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACpC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAjBW,QAAA,WAAW,eAiBtB;AAEF;;;GAGG;AACI,MAAM,iBAAiB,GAAG,CAC7B,KAAmB,EACnB,KAAa,EACb,OAAe,EACf,KAAoB,EACpB,OAAsB,EACtB,OAAsB,EACtB,KAAoB,EACpB,MAAa,EACO,EAAE;IACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,MAAM,WAAW,GAAG,KAAK;YACrB,CAAC,CAAC,UAAU,KAAK,EAAE;YACnB,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,aAAa,GAAG,OAAO;YACzB,CAAC,CAAC,aAAa,OAAO,EAAE;YACxB,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,aAAa,GAAG,OAAO;YACzB,CAAC,CAAC,aAAa,OAAO,EAAE;YACxB,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,WAAW,GAAG,KAAK;YACrB,CAAC,CAAC,UAAU,KAAK,EAAE;YACnB,CAAC,CAAC,EAAE,CAAC;QAET,MAAM,GAAG,GACL,UAAU,OAAO,SAAS,KAAK,EAAE;YACjC,GAAG,WAAW,GAAG,aAAa,EAAE;YAChC,GAAG,aAAa,GAAG,WAAW,EAAE,CAAC;QAErC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACnC,IAAI,GAAG,EAAE,CAAC;gBACN,OAAO,CAAC;oBACJ,MAAM,EAAE,KAAK;oBACb,OAAO,EAAE,GAAG,CAAC,OAAO;iBACvB,CAAC,CAAC;YACP,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACpC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAxCW,QAAA,iBAAiB,qBAwC5B"}

package/dist/db/prisma.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Prisma client singleton factory.
+ * Used by GrooMe-nodeJS and GrooMe admin panel.
+ *
+ * Requires @prisma/client as a peer dependency.
+ */
+/**
+ * Create a hot-reload-safe Prisma client singleton.
+ *
+ * Usage:
+ * ```ts
+ * import { PrismaClient } from "@prisma/client";
+ * import { createPrismaSingleton } from
+ *   "premium_nodejs_library/db/prisma";
+ *
+ * export const prisma =
+ *   createPrismaSingleton(PrismaClient);
+ * ```
+ */
+export declare const createPrismaSingleton: <T extends new () => any>(PrismaClientClass: T) => InstanceType<T>;
+//# sourceMappingURL=prisma.d.ts.map

package/dist/db/prisma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma.d.ts","sourceRoot":"","sources":["../../src/db/prisma.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,uBACV,GAAG,0CAiB1B,CAAC"}

package/dist/db/prisma.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Prisma client singleton factory.
+ * Used by GrooMe-nodeJS and GrooMe admin panel.
+ *
+ * Requires @prisma/client as a peer dependency.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPrismaSingleton = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Create a hot-reload-safe Prisma client singleton.
+ *
+ * Usage:
+ * ```ts
+ * import { PrismaClient } from "@prisma/client";
+ * import { createPrismaSingleton } from
+ *   "premium_nodejs_library/db/prisma";
+ *
+ * export const prisma =
+ *   createPrismaSingleton(PrismaClient);
+ * ```
+ */
+const createPrismaSingleton = (PrismaClientClass) => {
+    const globalForPrisma = globalThis;
+    const prisma = globalForPrisma.prisma ??
+        new PrismaClientClass();
+    if (process.env.NODE_ENV !== "production") {
+        globalForPrisma.prisma = prisma;
+    }
+    return prisma;
+};
+exports.createPrismaSingleton = createPrismaSingleton;
+//# sourceMappingURL=prisma.js.map

package/dist/db/prisma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma.js","sourceRoot":"","sources":["../../src/db/prisma.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,uDAAuD;AAEvD;;;;;;;;;;;;GAYG;AACI,MAAM,qBAAqB,GAAG,CAGjC,iBAAoB,EACL,EAAE;IACjB,MAAM,eAAe,GAAG,UAEvB,CAAC;IAEF,MAAM,MAAM,GACR,eAAe,CAAC,MAAM;QACtB,IAAI,iBAAiB,EAAE,CAAC;IAE5B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QACxC,eAAe,CAAC,MAAM,GAAG,MAAM,CAAC;IACpC,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAlBW,QAAA,qBAAqB,yBAkBhC"}

package/dist/email/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Send an email via SendGrid.
+ *
+ * @param to - Recipient email address
+ * @param from - Sender email address
+ * @param subject - Email subject
+ * @param message - HTML or plain text message
+ * @param apiKey - SendGrid API key
+ */
+export declare const sendEmail: (to: string, from: string, subject: string, message: string, apiKey: string) => Promise<void>;
+/**
+ * Send an email with separate from name and address.
+ */
+export declare const sendEmailWithName: (options: {
+    to: string;
+    toName?: string;
+    fromEmail: string;
+    fromName: string;
+    subject: string;
+    html: string;
+    apiKey: string;
+}) => Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/email/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/email/index.ts"],"names":[],"mappings":"AAeA;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,OACd,MAAM,QACJ,MAAM,WACH,MAAM,WACN,MAAM,UACP,MAAM,KACf,QAAQ,IAAI,CAgCd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,YAAmB;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB,KAAG,QAAQ,IAAI,CAsBf,CAAC"}

package/dist/email/index.js

@@ -0,0 +1,79 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendEmailWithName = exports.sendEmail = void 0;
+const mail_1 = __importDefault(require("@sendgrid/mail"));
+let sgInitialized = false;
+/**
+ * Lazily initialize SendGrid with an API key.
+ * Safe for build-time (Vercel) and serverless.
+ */
+function initSendGrid(apiKey) {
+    if (!sgInitialized) {
+        mail_1.default.setApiKey(apiKey);
+        sgInitialized = true;
+    }
+}
+/**
+ * Send an email via SendGrid.
+ *
+ * @param to - Recipient email address
+ * @param from - Sender email address
+ * @param subject - Email subject
+ * @param message - HTML or plain text message
+ * @param apiKey - SendGrid API key
+ */
+const sendEmail = async (to, from, subject, message, apiKey) => {
+    try {
+        initSendGrid(apiKey);
+        const msg = {
+            to,
+            from,
+            subject,
+            text: message,
+            html: message,
+        };
+        await mail_1.default.send(msg);
+        console.log("Email sent successfully");
+    }
+    catch (error) {
+        const err = error;
+        if (err.response) {
+            console.error("Error sending email:", err.response.body);
+        }
+        else {
+            console.error("Error sending email:", err.message);
+        }
+        throw new Error("Failed to send email");
+    }
+};
+exports.sendEmail = sendEmail;
+/**
+ * Send an email with separate from name and address.
+ */
+const sendEmailWithName = async (options) => {
+    initSendGrid(options.apiKey);
+    const msg = {
+        to: {
+            email: options.to,
+            name: options.toName,
+        },
+        from: {
+            email: options.fromEmail,
+            name: options.fromName,
+        },
+        subject: options.subject,
+        html: options.html,
+    };
+    try {
+        await mail_1.default.send(msg);
+    }
+    catch (error) {
+        console.error("[SendGrid] Failed:", error);
+        throw error;
+    }
+};
+exports.sendEmailWithName = sendEmailWithName;
+//# sourceMappingURL=index.js.map

package/dist/email/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/email/index.ts"],"names":[],"mappings":";;;;;;AAAA,0DAAoC;AAEpC,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B;;;GAGG;AACH,SAAS,YAAY,CAAC,MAAc;IAChC,IAAI,CAAC,aAAa,EAAE,CAAC;QACjB,cAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACzB,aAAa,GAAG,IAAI,CAAC;IACzB,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACI,MAAM,SAAS,GAAG,KAAK,EAC1B,EAAU,EACV,IAAY,EACZ,OAAe,EACf,OAAe,EACf,MAAc,EACD,EAAE;IACf,IAAI,CAAC;QACD,YAAY,CAAC,MAAM,CAAC,CAAC;QAErB,MAAM,GAAG,GAAG;YACR,EAAE;YACF,IAAI;YACJ,OAAO;YACP,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,OAAO;SAChB,CAAC;QAEF,MAAM,cAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,KAGX,CAAC;QACF,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACT,sBAAsB,EACtB,GAAG,CAAC,QAAQ,CAAC,IAAI,CACpB,CAAC;QACN,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,KAAK,CACT,sBAAsB,EACtB,GAAG,CAAC,OAAO,CACd,CAAC;QACN,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC5C,CAAC;AACL,CAAC,CAAC;AAtCW,QAAA,SAAS,aAsCpB;AAEF;;GAEG;AACI,MAAM,iBAAiB,GAAG,KAAK,EAAE,OAQvC,EAAiB,EAAE;IAChB,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7B,MAAM,GAAG,GAAG;QACR,EAAE,EAAE;YACA,KAAK,EAAE,OAAO,CAAC,EAAE;YACjB,IAAI,EAAE,OAAO,CAAC,MAAM;SACvB;QACD,IAAI,EAAE;YACF,KAAK,EAAE,OAAO,CAAC,SAAS;YACxB,IAAI,EAAE,OAAO,CAAC,QAAQ;SACzB;QACD,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;KACrB,CAAC;IAEF,IAAI,CAAC;QACD,MAAM,cAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC,CAAC;AA9BW,QAAA,iBAAiB,qBA8B5B"}

package/dist/index.d.ts

@@ -0,0 +1,104 @@
+/**
+ * premium_nodejs_library v4.0.0
+ *
+ * Shared Node.js library for Premium SARL projects.
+ * Provides auth, email, responses, storage, payments,
+ * OTP, validation, DB, and utility modules.
+ *
+ * BACKWARD COMPATIBLE with base_nodejs_library.
+ * All original exports are preserved.
+ */
+export { hashPassword, compareHashedPassword, generateJWT, verifyJWT, } from "./auth";
+export { sendEmail, sendEmailWithName, } from "./email";
+export { makeSuccess, makeSuccessMessage, makeError, makeUnauthorized, makeForbidden, makeNotFound, makeServerError, makeBadGateway, } from "./responses/core";
+export type { ApiResponse } from "./responses/core";
+export { generateBadRequestResponse, generateUnauthorizedResponse, generateBadGatewayResponse, generateForbiddenErrorResponse, generateErrorResponse, generateSuccessResponse, generateSuccessResponseWithData, generateServerErrorResponse, generateSuccessFullResponse, } from "./responses/express";
+export { successResponse, errorResponse, unauthorizedResponse, forbiddenResponse, notFoundResponse, serverErrorResponse, } from "./responses/nextjs";
+export { extractKeyFromObjectUrl, isValidS3Url, getS3FileUrl, uploadFilesToS3, deleteFileFromS3, uploadFiles3Bucket, deleteFileFroms3Bucket, } from "./storage/s3";
+export { createSupabaseStorageClient, uploadToSupabase, deleteFromSupabase, } from "./storage/supabase";
+export { createStripeClient } from "./payments/stripe";
+export { createPayTechPayment, } from "./payments/paytech";
+export { generateOtp, generateOtpExpiryTime, isOtpExpired, twilioSendOTP, twilioVerifyOTP, otpValidator, } from "./otp";
+export type { TwilioConfig } from "./otp";
+export { checkRequiredValidation, isValidEmail, isValidTime, isValidEndTime, checkEmptyString, validateEmailAndPhone, checkExistingUser, checkVerifiedUserInfo, } from "./validation";
+export { runAnyQuery, selectQueryModule, } from "./db/mysql";
+export { createPrismaSingleton, } from "./db/prisma";
+export { capitalizeFirstLetter, removeSpecialCharactersFromNormalString, removeSpecialCharactersFromURL, removeAccents, normalizeDataNFD, normalizeString, } from "./utils/string";
+export { dBDateFormatModule, isPastDate, validateAndConvertDate, convertDateTimeFormat, getYearAndWeekNumber, } from "./utils/date";
+export { applyPagination, randomNumberModule, removeKeysFromJoinData, getContextFromEnvironment, } from "./utils/misc";
+declare const _default: {
+    hashPassword: (password: string) => Promise<string>;
+    compareHashedPassword: (password: string, hashedPassword: string) => Promise<boolean>;
+    generateJWT: (payload: import("jsonwebtoken").JwtPayload, tokenKey: string, expiryTime?: string | number) => string;
+    verifyJWT: (token: string, tokenKey: string) => string | import("jsonwebtoken").JwtPayload;
+    sendEmail: (to: string, from: string, subject: string, message: string, apiKey: string) => Promise<void>;
+    generateBadRequestResponse: (response: any, data: string) => any;
+    generateUnauthorizedResponse: (response: any, data: string) => any;
+    generateBadGatewayResponse: (response: any, data: string) => any;
+    generateForbiddenErrorResponse: (response: any, data: string) => any;
+    generateErrorResponse: (response: any, data: any) => any;
+    generateSuccessResponse: (response: any, data: any) => any;
+    generateSuccessResponseWithData: (response: any, data: any) => any;
+    generateServerErrorResponse: (response: any, data: string, statusCode: number) => any;
+    generateSuccessFullResponse: (response: any, responseData: object) => any;
+    extractKeyFromObjectUrl: (objectUrl: string) => string | null;
+    uploadFiles3Bucket: (Region: string, AccessKey: string, SecretKey: string, BucketName: string, _LocalStorageFilesPath: string, FileObjectPath: {
+        path: string;
+    } | {
+        path: string;
+    }[]) => Promise<{
+        status: boolean;
+        data?: string[] | undefined;
+        message?: string | undefined;
+    }>;
+    deleteFileFroms3Bucket: (Region: string, AccessKey: string, SecretKey: string, BucketName: string, FilePath: string) => Promise<{
+        status: boolean;
+        message: string;
+    }>;
+    isValidS3Url: (url: string) => boolean;
+    twilioSendOTP: (to: string, mode: string, config: import("./otp").TwilioConfig) => Promise<import("axios").AxiosResponse<any, any>>;
+    twilioVerifyOTP: (to: string, code: string, config: import("./otp").TwilioConfig) => Promise<import("axios").AxiosResponse<any, any>>;
+    generateOtp: () => string;
+    isOtpExpired: (otpExpiresAt: Date) => boolean;
+    generateOtpExpiryTime: () => Date;
+    otpValidator: (user: {
+        phoneOtpCode?: number | undefined;
+        emailOtpCode?: number | undefined;
+        phoneOtpExpiresAt?: Date | undefined;
+        emailOtpExpiresAt?: Date | undefined;
+    }, phone: string | null, otpCode: number) => string | undefined;
+    checkRequiredValidation: (data: {
+        field: string;
+        value: unknown;
+        type: string;
+    }[]) => Promise<{
+        status: boolean;
+        message?: string | undefined;
+    }>;
+    isValidEmail: (email: string) => boolean;
+    isValidTime: (time: string) => boolean;
+    isValidEndTime: (startTime: string, endTime: string) => boolean;
+    checkEmptyString: (data: unknown) => boolean;
+    validateEmailAndPhone: (email: string | null, phone: string | null) => string | null;
+    checkExistingUser: (existingUserByEmail: Record<string, unknown> | null, existingUserByPhone: Record<string, unknown> | null) => Record<string, unknown> | undefined;
+    checkVerifiedUserInfo: (existingUser: Record<string, unknown>, email: string | null, phone: string | null) => string | undefined;
+    runAnyQuery: (dbCon: import("./db/mysql").DbConnection, sql: string, values: any[]) => Promise<import("./db/mysql").QueryResult>;
+    selectQueryModule: (dbCon: import("./db/mysql").DbConnection, table: string, columns: string, where: string | null, groupBy: string | null, orderBy: string | null, limit: string | null, values: any[]) => Promise<import("./db/mysql").QueryResult>;
+    capitalizeFirstLetter: (sentence: string) => string;
+    removeSpecialCharactersFromNormalString: (str: string) => string;
+    removeSpecialCharactersFromURL: (str: string) => string;
+    removeAccents: (str: string) => string;
+    normalizeDataNFD: (str: string) => string;
+    normalizeString: (str: string) => string;
+    dBDateFormatModule: (date?: Date | undefined) => string;
+    isPastDate: (date: string) => boolean;
+    validateAndConvertDate: (date: string) => string | null;
+    convertDateTimeFormat: (date: string) => string;
+    getYearAndWeekNumber: () => [number, number];
+    applyPagination: <T>(data: T[], page: number, limit: number) => T[];
+    randomNumberModule: (Min: number, Max: number) => number;
+    removeKeysFromJoinData: (data: Record<string, unknown>) => unknown[];
+    getContextFromEnvironment: (environment: string) => string;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACH,YAAY,EACZ,qBAAqB,EACrB,WAAW,EACX,SAAS,GACZ,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACH,SAAS,EACT,iBAAiB,GACpB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACH,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,GACjB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,EACH,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,EACrB,uBAAuB,EACvB,+BAA+B,EAC/B,2BAA2B,EAC3B,2BAA2B,GAC9B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACH,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GACtB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACH,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,gBAAgB,EAEhB,kBAAkB,EAClB,sBAAsB,GACzB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACH,2BAA2B,EAC3B,gBAAgB,EAChB,kBAAkB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EACH,oBAAoB,GACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACH,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,YAAY,GACf,MAAM,OAAO,CAAC;AACf,YAAY,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,EACH,uBAAuB,EACvB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,GACxB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACH,WAAW,EACX,iBAAiB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,qBAAqB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACH,qBAAqB,EACrB,uCAAuC,EACvC,8BAA8B,EAC9B,aAAa,EACb,gBAAgB,EAChB,eAAe,GAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACH,kBAAkB,EAClB,UAAU,EACV,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACvB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACH,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,GAC5B,MAAM,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AActB,wBA4DE"}