@cored3v/web-core 1.0.2 → 1.0.4

package/README.md

@@ -1,9 +1,112 @@
 # @cored3v/web-core
 
-A reusable, production-ready **Express.js application core** that provides
-bootstrapping, configuration, authentication, database lifecycle management,
-and **license-based execution enforcement**.
+A generic, production-ready application core for Node.js, designed to provide reusable **bootstrapping, configuration, authentication, and license-based execution enforcement** across multiple frameworks.
 
-This package is designed to protect source code by teams and consultants against unauthorised use.
+It supports **Express.js**, **Next.js**, **Nuxt (H3)**, and generic Node.js environments.
 
-The package supports both ESModule and CommonJS imports.
+## Features
+
+- **License Enforcement**: Protect your source code by enforcing valid license keys.
+- **JWT Authentication**: Optional, built-in JWT verification helper and middleware.
+- **Database Management**: Optional, automatic Postgres connection pooling and lifecycle management.
+- **Security Defaults**: Pre-configured Helmet and CORS for Express.
+- **Multi-Framework**: First-class adapters for Express, Next.js, and H3.
+
+> **Note**: Only **License Enforcement** and **Routes** are mandatory. Auth and Database modules are opt-in and handled via configuration.
+
+## Installation
+
+```bash
+npm install @cored3v/web-core
+# or
+yarn add @cored3v/web-core
+```
+
+## Usage
+
+### Next.js (App Router & Middleware)
+
+Use `createNextApp` to integrate core services.
+
+**`src/lib/core.ts`**
+```typescript
+import { createNextApp } from "@cored3v/web-core";
+
+// Initialize once (singleton pattern recommended)
+export const core = await createNextApp({
+  appId: "my-next-app"
+});
+```
+
+**`src/app/api/hello/route.ts`**
+```typescript
+import { core } from "@/lib/core";
+import { NextResponse } from "next/server";
+
+export async function GET(request: Request) {
+  // Verify Session
+  const user = await core.verifySession(request);
+  if (!user) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+
+  return NextResponse.json({ message: "Hello World", user });
+}
+```
+
+### Express.js
+
+Use `createApp` to bootstrap a full Express server.
+
+```typescript
+import { createApp } from "@cored3v/web-core";
+
+await createApp({
+  appId: "my-express-app",
+  http: { port: 3000 },
+  routes: ({ app, router, auth, db }) => {
+    
+    // Protected Route
+    router.get("/secure", auth.middleware(), (req, res) => {
+      res.json({ message: "Secure Data", user: req.user });
+    });
+
+  }
+}).then(({ start }) => start());
+```
+
+### Nuxt / H3 / Nitro
+
+Use `createH3App` for H3-based servers.
+
+```typescript
+import { createH3App } from "@cored3v/web-core";
+
+const core = await createH3App({ appId: "my-nuxt-app" });
+
+export default eventHandler(async (event) => {
+  const user = await core.verifySession(event);
+  if (!user) {
+    throw createError({ statusCode: 401, statusMessage: "Unauthorized" });
+  }
+  return { message: "Success", user };
+});
+```
+
+## Configuration
+
+The library uses `dotenv` to load configuration. Ensure you have a `.env` file or environment variables set.
+
+| Variable | Description | Required | Default |
+|----------|-------------|----------|---------|
+| `LICENSE_PATH` | Path to the `license.json` file | No | `./license.json` |
+| `JWT_SECRET` | Secret key for JWT verification | **Yes** (if auth used) | - |
+| `DATABASE_URL` | Postgres Connection String | No | - |
+| `PORT` | Http Port (Express only) | No | `3000` |
+
+**Note:**
+`license.json` is mandatory for the app to work. However, if the file exists in root directory, then LICENSE_PATH env variable is not required.
+
+## License
+
+Private / Proprietary.

package/dist/cjs/app/createApp.js

@@ -65,7 +65,10 @@ async function createApp(opts) {
     // 5) DB (non-optional if declared)
     const db = await (0, index_js_2.initDb)(opts.db);
     // 6) AUTH
-    const auth = (0, jwt_js_1.initJwtAuth)(config);
+    let auth;
+    if (opts.auth) {
+        auth = (0, jwt_js_1.initJwtAuth)(config);
+    }
     // 7) ROUTES
     if (opts.routes) {
         opts.routes({ app, router, db, auth, config });

package/dist/cjs/app/security.d.ts

@@ -1,2 +1,11 @@
 import { Express } from "express";
+import cors from "cors";
+export declare const securityConfig: {
+    helmet: (req: import("http").IncomingMessage, res: import("http").ServerResponse, next: (err?: unknown) => void) => void;
+    cors: (req: cors.CorsRequest, res: {
+        statusCode?: number | undefined;
+        setHeader(key: string, value: string): any;
+        end(): any;
+    }, next: (err?: any) => any) => void;
+};
 export declare function applySecurity(app: Express): void;

package/dist/cjs/app/security.js

@@ -3,10 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.securityConfig = void 0;
 exports.applySecurity = applySecurity;
 const helmet_1 = __importDefault(require("helmet"));
 const cors_1 = __importDefault(require("cors"));
+exports.securityConfig = {
+    helmet: (0, helmet_1.default)(),
+    cors: (0, cors_1.default)()
+};
 function applySecurity(app) {
-    app.use((0, helmet_1.default)());
-    app.use((0, cors_1.default)());
+    app.use(exports.securityConfig.helmet);
+    app.use(exports.securityConfig.cors);
 }

package/dist/cjs/auth/jwt.d.ts

@@ -1,4 +1,7 @@
+import jwt from "jsonwebtoken";
 import { Config } from "../types.js";
+export declare function verifyToken(token: string, secret: string): string | jwt.JwtPayload;
 export declare function initJwtAuth(config: Config): {
+    verify(token: string): string | jwt.JwtPayload;
     middleware(): (req: any, _res: any, next: any) => any;
 };

package/dist/cjs/auth/jwt.js

@@ -3,13 +3,20 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifyToken = verifyToken;
 exports.initJwtAuth = initJwtAuth;
 const jsonwebtoken_1 = __importDefault(require("jsonwebtoken"));
+function verifyToken(token, secret) {
+    return jsonwebtoken_1.default.verify(token, secret);
+}
 function initJwtAuth(config) {
     const secret = config.get("JWT_SECRET");
     if (!secret)
         throw new Error("JWT_SECRET missing");
     return {
+        verify(token) {
+            return verifyToken(token, secret);
+        },
         middleware() {
             return (req, _res, next) => {
                 const h = req.headers.authorization;
@@ -17,7 +24,7 @@ function initJwtAuth(config) {
                     return next();
                 try {
                     const token = h.replace("Bearer ", "");
-                    req.user = jsonwebtoken_1.default.verify(token, secret);
+                    req.user = verifyToken(token, secret);
                 }
                 catch { }
                 next();

package/dist/cjs/frameworks/h3.d.ts

@@ -0,0 +1,21 @@
+import { CreateFrameworkAppOptions } from "./types.js";
+export declare function createH3App(opts: CreateFrameworkAppOptions): Promise<{
+    db: {
+        query: {
+            <T extends import("pg").Submittable>(queryStream: T): T;
+            <R extends any[] = any[], I = any[]>(queryConfig: import("pg").QueryArrayConfig<I>, values?: import("pg").QueryConfigValues<I>): Promise<import("pg").QueryArrayResult<R>>;
+            <R extends import("pg").QueryResultRow = any, I = any>(queryConfig: import("pg").QueryConfig<I>): Promise<import("pg").QueryResult<R>>;
+            <R extends import("pg").QueryResultRow = any, I = any[]>(queryTextOrConfig: string | import("pg").QueryConfig<I>, values?: import("pg").QueryConfigValues<I>): Promise<import("pg").QueryResult<R>>;
+            <R extends any[] = any[], I = any[]>(queryConfig: import("pg").QueryArrayConfig<I>, callback: (err: Error, result: import("pg").QueryArrayResult<R>) => void): void;
+            <R extends import("pg").QueryResultRow = any, I = any[]>(queryTextOrConfig: string | import("pg").QueryConfig<I>, callback: (err: Error, result: import("pg").QueryResult<R>) => void): void;
+            <R extends import("pg").QueryResultRow = any, I = any[]>(queryText: string, values: import("pg").QueryConfigValues<I>, callback: (err: Error, result: import("pg").QueryResult<R>) => void): void;
+        };
+        close: () => Promise<void>;
+    } | null;
+    auth: {
+        verify(token: string): string | import("jsonwebtoken").JwtPayload;
+        middleware(): (req: any, _res: any, next: any) => any;
+    };
+    config: import("../types.js").Config;
+    verifySession: (event: any) => Promise<string | import("jsonwebtoken").JwtPayload | null>;
+}>;

package/dist/cjs/frameworks/h3.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createH3App = createH3App;
+const index_js_1 = require("../config/index.js");
+const verify_js_1 = require("../license/verify.js");
+const jwt_js_1 = require("../auth/jwt.js");
+const index_js_2 = require("../db/index.js");
+// H3 is often used in Nuxt or Nitro. We don't import h3 directly to avoid hard dependency,
+// but we assume the user passes the event or app instance if needed.
+// For now, we return a setup object similar to Next.js
+async function createH3App(opts) {
+    const config = (0, index_js_1.loadConfig)();
+    // License Check
+    await (0, verify_js_1.verifyLicense)({
+        appId: opts.appId,
+        licensePath: config.get("LICENSE_PATH", "./license.json"),
+    });
+    const db = await (0, index_js_2.initDb)({ type: "postgres" });
+    const auth = (0, jwt_js_1.initJwtAuth)(config);
+    return {
+        db,
+        auth,
+        config,
+        verifySession: async (event) => {
+            // H3 event structure abstraction
+            const h = event.node?.req?.headers?.authorization || event.headers?.get("authorization");
+            if (!h)
+                return null;
+            try {
+                const token = h.replace("Bearer ", "");
+                return auth.verify(token);
+            }
+            catch {
+                return null;
+            }
+        }
+    };
+}

package/dist/cjs/frameworks/next.d.ts

@@ -0,0 +1,21 @@
+import { CreateFrameworkAppOptions } from "./types.js";
+export declare function createNextApp(opts: CreateFrameworkAppOptions): Promise<{
+    db: {
+        query: {
+            <T extends import("pg").Submittable>(queryStream: T): T;
+            <R extends any[] = any[], I = any[]>(queryConfig: import("pg").QueryArrayConfig<I>, values?: import("pg").QueryConfigValues<I>): Promise<import("pg").QueryArrayResult<R>>;
+            <R extends import("pg").QueryResultRow = any, I = any>(queryConfig: import("pg").QueryConfig<I>): Promise<import("pg").QueryResult<R>>;
+            <R extends import("pg").QueryResultRow = any, I = any[]>(queryTextOrConfig: string | import("pg").QueryConfig<I>, values?: import("pg").QueryConfigValues<I>): Promise<import("pg").QueryResult<R>>;
+            <R extends any[] = any[], I = any[]>(queryConfig: import("pg").QueryArrayConfig<I>, callback: (err: Error, result: import("pg").QueryArrayResult<R>) => void): void;
+            <R extends import("pg").QueryResultRow = any, I = any[]>(queryTextOrConfig: string | import("pg").QueryConfig<I>, callback: (err: Error, result: import("pg").QueryResult<R>) => void): void;
+            <R extends import("pg").QueryResultRow = any, I = any[]>(queryText: string, values: import("pg").QueryConfigValues<I>, callback: (err: Error, result: import("pg").QueryResult<R>) => void): void;
+        };
+        close: () => Promise<void>;
+    } | null;
+    auth: {
+        verify(token: string): string | import("jsonwebtoken").JwtPayload;
+        middleware(): (req: any, _res: any, next: any) => any;
+    };
+    config: import("../types.js").Config;
+    verifySession: (req: Request) => Promise<string | import("jsonwebtoken").JwtPayload | null>;
+}>;

package/dist/cjs/frameworks/next.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNextApp = createNextApp;
+const index_js_1 = require("../config/index.js");
+const verify_js_1 = require("../license/verify.js");
+const jwt_js_1 = require("../auth/jwt.js");
+const index_js_2 = require("../db/index.js");
+async function createNextApp(opts) {
+    const config = (0, index_js_1.loadConfig)();
+    // License Check
+    await (0, verify_js_1.verifyLicense)({
+        appId: opts.appId,
+        licensePath: config.get("LICENSE_PATH", "./license.json"),
+    });
+    const db = await (0, index_js_2.initDb)({ type: "postgres" }); // Defaulting to existing DB logic
+    const auth = (0, jwt_js_1.initJwtAuth)(config);
+    return {
+        db,
+        auth,
+        config,
+        verifySession: async (req) => {
+            const h = req.headers.get("authorization");
+            if (!h)
+                return null;
+            try {
+                const token = h.replace("Bearer ", "");
+                return auth.verify(token);
+            }
+            catch {
+                return null;
+            }
+        }
+    };
+}

package/dist/cjs/frameworks/types.d.ts

@@ -0,0 +1,24 @@
+import { Config } from "../types.js";
+export interface WebCoreRequest {
+    headers: Record<string, string | string[] | undefined>;
+    url?: string;
+    method?: string;
+    body?: any;
+}
+export interface WebCoreResponse {
+    status(code: number): WebCoreResponse;
+    json(body: any): WebCoreResponse;
+    send(body: any): WebCoreResponse;
+    setHeader(key: string, value: string): WebCoreResponse;
+}
+export interface WebCoreContext {
+    config: Config;
+    auth: {
+        verify(token: string): any;
+    };
+    db?: any;
+}
+export interface CreateFrameworkAppOptions {
+    appId: string;
+    config?: Record<string, any>;
+}

package/dist/cjs/frameworks/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/index.cjs

@@ -14,7 +14,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createApp = void 0;
+exports.createH3App = exports.createNextApp = exports.createApp = void 0;
 var createApp_1 = require("./app/createApp");
 Object.defineProperty(exports, "createApp", { enumerable: true, get: function () { return createApp_1.createApp; } });
+var next_1 = require("./frameworks/next");
+Object.defineProperty(exports, "createNextApp", { enumerable: true, get: function () { return next_1.createNextApp; } });
+var h3_1 = require("./frameworks/h3");
+Object.defineProperty(exports, "createH3App", { enumerable: true, get: function () { return h3_1.createH3App; } });
 __exportStar(require("./types"), exports);

package/dist/cjs/index.d.cts

@@ -1,2 +1,4 @@
 export { createApp } from "./app/createApp";
+export { createNextApp } from "./frameworks/next";
+export { createH3App } from "./frameworks/h3";
 export * from "./types";

package/dist/cjs/index.d.mts

@@ -1,2 +1,4 @@
 export { createApp } from "./app/createApp.js";
+export { createNextApp } from "./frameworks/next.js";
+export { createH3App } from "./frameworks/h3.js";
 export * from "./types.js";

package/dist/cjs/index.mjs

@@ -1,3 +1,5 @@
 "use strict";
 export { createApp } from "./app/createApp.js";
+export { createNextApp } from "./frameworks/next.js";
+export { createH3App } from "./frameworks/h3.js";
 export * from "./types.js";

package/dist/cjs/license/crypto.js

@@ -7,13 +7,13 @@ exports.verifySignature = verifySignature;
 const crypto_1 = __importDefault(require("crypto"));
 const PUBLIC_KEY = `
 -----BEGIN PUBLIC KEY-----
-MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAsU0BSgfcYaHOuWuNRQEw
-t3HyMf+UY+RAVGf0bDmdXIyp5fPol5K86jol45lIaxdbkMpPqODmr/lU0dDBOIwy
-wlhbAQb0nLsIMQf3M6lNw6OtI0EnlZd2xhfisfu1XH9UBbn7Q6W2+i22rZhKC3yY
-8E7Dntgl7IkItjEFFpnbA4tCY6yTGhGfAx/4O977Vw2ET6m5SVcFVlKs0OxekRc0
-7rcgCTwSjHPkMumVc7zv+rfZPkhULN76ju26gcuR19xd+gNq3qLGgJ9hcDITmuwP
-FE212I94elpNRNbrX7MUqVX3o7trE5CqxH42NuGP20edSWcKqpvqLFPSnlsSvhUp
-MQIDAQAB
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArCxkEU67ODBGA9LQbMrm
+mquTktu9xme2nJKPoPce1cYqjTOt/NJ2a+LDuhM7t8PHVye18+RJq+mFOkOSgilo
+qpsoM/45NqN4doBkfajZqXtCSjiYg2F4O/zppElzTlsFxc7vtKs+KoTE91s0w0e6
+xTrgdpqwZnUQ9q+16tuCIKPdxJ4mwqZbnUXdE3WKfedbnI2DNE0CfpJFrLkpSsnK
+s/gcPBCi4obvE2RJWNqWoMULW6iLXSNqwDmxE+o87hwCTGfpZ/bxyirRbBCSq/hY
+SdVQJlDhE2ta6CoITROp0c3+xffpCvlYnADp544nuz5IlTZk7LN9X5mF27VcTPc6
+bwIDAQAB
 -----END PUBLIC KEY-----
 `;
 function verifySignature(payload, signature) {

package/dist/cjs/types.d.ts

@@ -17,8 +17,8 @@ export interface CreateAppOptions {
 export interface AppContext {
     app: Express;
     router: Router;
-    db: any;
-    auth: {
+    db?: any;
+    auth?: {
         middleware(): any;
     };
     config: Config;

package/dist/esm/app/createApp.js

@@ -26,7 +26,10 @@ export async function createApp(opts) {
     // 5) DB (non-optional if declared)
     const db = await initDb(opts.db);
     // 6) AUTH
-    const auth = initJwtAuth(config);
+    let auth;
+    if (opts.auth) {
+        auth = initJwtAuth(config);
+    }
     // 7) ROUTES
     if (opts.routes) {
         opts.routes({ app, router, db, auth, config });

package/dist/esm/app/security.d.ts

@@ -1,2 +1,11 @@
 import { Express } from "express";
+import cors from "cors";
+export declare const securityConfig: {
+    helmet: (req: import("http").IncomingMessage, res: import("http").ServerResponse, next: (err?: unknown) => void) => void;
+    cors: (req: cors.CorsRequest, res: {
+        statusCode?: number | undefined;
+        setHeader(key: string, value: string): any;
+        end(): any;
+    }, next: (err?: any) => any) => void;
+};
 export declare function applySecurity(app: Express): void;

package/dist/esm/app/security.js

@@ -1,6 +1,10 @@
 import helmet from "helmet";
 import cors from "cors";
+export const securityConfig = {
+    helmet: helmet(),
+    cors: cors()
+};
 export function applySecurity(app) {
-    app.use(helmet());
-    app.use(cors());
+    app.use(securityConfig.helmet);
+    app.use(securityConfig.cors);
 }

package/dist/esm/auth/jwt.d.ts

@@ -1,4 +1,7 @@
+import jwt from "jsonwebtoken";
 import { Config } from "../types.js";
+export declare function verifyToken(token: string, secret: string): string | jwt.JwtPayload;
 export declare function initJwtAuth(config: Config): {
+    verify(token: string): string | jwt.JwtPayload;
     middleware(): (req: any, _res: any, next: any) => any;
 };

package/dist/esm/auth/jwt.js

@@ -1,9 +1,15 @@
 import jwt from "jsonwebtoken";
+export function verifyToken(token, secret) {
+    return jwt.verify(token, secret);
+}
 export function initJwtAuth(config) {
     const secret = config.get("JWT_SECRET");
     if (!secret)
         throw new Error("JWT_SECRET missing");
     return {
+        verify(token) {
+            return verifyToken(token, secret);
+        },
         middleware() {
             return (req, _res, next) => {
                 const h = req.headers.authorization;
@@ -11,7 +17,7 @@ export function initJwtAuth(config) {
                     return next();
                 try {
                     const token = h.replace("Bearer ", "");
-                    req.user = jwt.verify(token, secret);
+                    req.user = verifyToken(token, secret);
                 }
                 catch { }
                 next();

package/dist/esm/frameworks/h3.d.ts

@@ -0,0 +1,21 @@
+import { CreateFrameworkAppOptions } from "./types.js";
+export declare function createH3App(opts: CreateFrameworkAppOptions): Promise<{
+    db: {
+        query: {
+            <T extends import("pg").Submittable>(queryStream: T): T;
+            <R extends any[] = any[], I = any[]>(queryConfig: import("pg").QueryArrayConfig<I>, values?: import("pg").QueryConfigValues<I>): Promise<import("pg").QueryArrayResult<R>>;
+            <R extends import("pg").QueryResultRow = any, I = any>(queryConfig: import("pg").QueryConfig<I>): Promise<import("pg").QueryResult<R>>;
+            <R extends import("pg").QueryResultRow = any, I = any[]>(queryTextOrConfig: string | import("pg").QueryConfig<I>, values?: import("pg").QueryConfigValues<I>): Promise<import("pg").QueryResult<R>>;
+            <R extends any[] = any[], I = any[]>(queryConfig: import("pg").QueryArrayConfig<I>, callback: (err: Error, result: import("pg").QueryArrayResult<R>) => void): void;
+            <R extends import("pg").QueryResultRow = any, I = any[]>(queryTextOrConfig: string | import("pg").QueryConfig<I>, callback: (err: Error, result: import("pg").QueryResult<R>) => void): void;
+            <R extends import("pg").QueryResultRow = any, I = any[]>(queryText: string, values: import("pg").QueryConfigValues<I>, callback: (err: Error, result: import("pg").QueryResult<R>) => void): void;
+        };
+        close: () => Promise<void>;
+    } | null;
+    auth: {
+        verify(token: string): string | import("jsonwebtoken").JwtPayload;
+        middleware(): (req: any, _res: any, next: any) => any;
+    };
+    config: import("../types.js").Config;
+    verifySession: (event: any) => Promise<string | import("jsonwebtoken").JwtPayload | null>;
+}>;

package/dist/esm/frameworks/h3.js

@@ -0,0 +1,35 @@
+import { loadConfig } from "../config/index.js";
+import { verifyLicense } from "../license/verify.js";
+import { initJwtAuth } from "../auth/jwt.js";
+import { initDb } from "../db/index.js";
+// H3 is often used in Nuxt or Nitro. We don't import h3 directly to avoid hard dependency,
+// but we assume the user passes the event or app instance if needed.
+// For now, we return a setup object similar to Next.js
+export async function createH3App(opts) {
+    const config = loadConfig();
+    // License Check
+    await verifyLicense({
+        appId: opts.appId,
+        licensePath: config.get("LICENSE_PATH", "./license.json"),
+    });
+    const db = await initDb({ type: "postgres" });
+    const auth = initJwtAuth(config);
+    return {
+        db,
+        auth,
+        config,
+        verifySession: async (event) => {
+            // H3 event structure abstraction
+            const h = event.node?.req?.headers?.authorization || event.headers?.get("authorization");
+            if (!h)
+                return null;
+            try {
+                const token = h.replace("Bearer ", "");
+                return auth.verify(token);
+            }
+            catch {
+                return null;
+            }
+        }
+    };
+}

package/dist/esm/frameworks/next.d.ts

@@ -0,0 +1,21 @@
+import { CreateFrameworkAppOptions } from "./types.js";
+export declare function createNextApp(opts: CreateFrameworkAppOptions): Promise<{
+    db: {
+        query: {
+            <T extends import("pg").Submittable>(queryStream: T): T;
+            <R extends any[] = any[], I = any[]>(queryConfig: import("pg").QueryArrayConfig<I>, values?: import("pg").QueryConfigValues<I>): Promise<import("pg").QueryArrayResult<R>>;
+            <R extends import("pg").QueryResultRow = any, I = any>(queryConfig: import("pg").QueryConfig<I>): Promise<import("pg").QueryResult<R>>;
+            <R extends import("pg").QueryResultRow = any, I = any[]>(queryTextOrConfig: string | import("pg").QueryConfig<I>, values?: import("pg").QueryConfigValues<I>): Promise<import("pg").QueryResult<R>>;
+            <R extends any[] = any[], I = any[]>(queryConfig: import("pg").QueryArrayConfig<I>, callback: (err: Error, result: import("pg").QueryArrayResult<R>) => void): void;
+            <R extends import("pg").QueryResultRow = any, I = any[]>(queryTextOrConfig: string | import("pg").QueryConfig<I>, callback: (err: Error, result: import("pg").QueryResult<R>) => void): void;
+            <R extends import("pg").QueryResultRow = any, I = any[]>(queryText: string, values: import("pg").QueryConfigValues<I>, callback: (err: Error, result: import("pg").QueryResult<R>) => void): void;
+        };
+        close: () => Promise<void>;
+    } | null;
+    auth: {
+        verify(token: string): string | import("jsonwebtoken").JwtPayload;
+        middleware(): (req: any, _res: any, next: any) => any;
+    };
+    config: import("../types.js").Config;
+    verifySession: (req: Request) => Promise<string | import("jsonwebtoken").JwtPayload | null>;
+}>;

package/dist/esm/frameworks/next.js

@@ -0,0 +1,31 @@
+import { loadConfig } from "../config/index.js";
+import { verifyLicense } from "../license/verify.js";
+import { initJwtAuth } from "../auth/jwt.js";
+import { initDb } from "../db/index.js";
+export async function createNextApp(opts) {
+    const config = loadConfig();
+    // License Check
+    await verifyLicense({
+        appId: opts.appId,
+        licensePath: config.get("LICENSE_PATH", "./license.json"),
+    });
+    const db = await initDb({ type: "postgres" }); // Defaulting to existing DB logic
+    const auth = initJwtAuth(config);
+    return {
+        db,
+        auth,
+        config,
+        verifySession: async (req) => {
+            const h = req.headers.get("authorization");
+            if (!h)
+                return null;
+            try {
+                const token = h.replace("Bearer ", "");
+                return auth.verify(token);
+            }
+            catch {
+                return null;
+            }
+        }
+    };
+}

package/dist/esm/frameworks/types.d.ts

@@ -0,0 +1,24 @@
+import { Config } from "../types.js";
+export interface WebCoreRequest {
+    headers: Record<string, string | string[] | undefined>;
+    url?: string;
+    method?: string;
+    body?: any;
+}
+export interface WebCoreResponse {
+    status(code: number): WebCoreResponse;
+    json(body: any): WebCoreResponse;
+    send(body: any): WebCoreResponse;
+    setHeader(key: string, value: string): WebCoreResponse;
+}
+export interface WebCoreContext {
+    config: Config;
+    auth: {
+        verify(token: string): any;
+    };
+    db?: any;
+}
+export interface CreateFrameworkAppOptions {
+    appId: string;
+    config?: Record<string, any>;
+}

package/dist/esm/frameworks/types.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/index.cjs

@@ -14,7 +14,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createApp = void 0;
+exports.createH3App = exports.createNextApp = exports.createApp = void 0;
 var createApp_1 = require("./app/createApp");
 Object.defineProperty(exports, "createApp", { enumerable: true, get: function () { return createApp_1.createApp; } });
+var next_1 = require("./frameworks/next");
+Object.defineProperty(exports, "createNextApp", { enumerable: true, get: function () { return next_1.createNextApp; } });
+var h3_1 = require("./frameworks/h3");
+Object.defineProperty(exports, "createH3App", { enumerable: true, get: function () { return h3_1.createH3App; } });
 __exportStar(require("./types"), exports);

package/dist/esm/index.d.cts

@@ -1,2 +1,4 @@
 export { createApp } from "./app/createApp";
+export { createNextApp } from "./frameworks/next";
+export { createH3App } from "./frameworks/h3";
 export * from "./types";

package/dist/esm/index.d.mts

@@ -1,2 +1,4 @@
 export { createApp } from "./app/createApp.js";
+export { createNextApp } from "./frameworks/next.js";
+export { createH3App } from "./frameworks/h3.js";
 export * from "./types.js";

package/dist/esm/index.mjs

@@ -1,2 +1,4 @@
 export { createApp } from "./app/createApp.js";
+export { createNextApp } from "./frameworks/next.js";
+export { createH3App } from "./frameworks/h3.js";
 export * from "./types.js";

package/dist/esm/license/crypto.js

@@ -1,13 +1,13 @@
 import crypto from "crypto";
 const PUBLIC_KEY = `
 -----BEGIN PUBLIC KEY-----
-MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAsU0BSgfcYaHOuWuNRQEw
-t3HyMf+UY+RAVGf0bDmdXIyp5fPol5K86jol45lIaxdbkMpPqODmr/lU0dDBOIwy
-wlhbAQb0nLsIMQf3M6lNw6OtI0EnlZd2xhfisfu1XH9UBbn7Q6W2+i22rZhKC3yY
-8E7Dntgl7IkItjEFFpnbA4tCY6yTGhGfAx/4O977Vw2ET6m5SVcFVlKs0OxekRc0
-7rcgCTwSjHPkMumVc7zv+rfZPkhULN76ju26gcuR19xd+gNq3qLGgJ9hcDITmuwP
-FE212I94elpNRNbrX7MUqVX3o7trE5CqxH42NuGP20edSWcKqpvqLFPSnlsSvhUp
-MQIDAQAB
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArCxkEU67ODBGA9LQbMrm
+mquTktu9xme2nJKPoPce1cYqjTOt/NJ2a+LDuhM7t8PHVye18+RJq+mFOkOSgilo
+qpsoM/45NqN4doBkfajZqXtCSjiYg2F4O/zppElzTlsFxc7vtKs+KoTE91s0w0e6
+xTrgdpqwZnUQ9q+16tuCIKPdxJ4mwqZbnUXdE3WKfedbnI2DNE0CfpJFrLkpSsnK
+s/gcPBCi4obvE2RJWNqWoMULW6iLXSNqwDmxE+o87hwCTGfpZ/bxyirRbBCSq/hY
+SdVQJlDhE2ta6CoITROp0c3+xffpCvlYnADp544nuz5IlTZk7LN9X5mF27VcTPc6
+bwIDAQAB
 -----END PUBLIC KEY-----
 `;
 export function verifySignature(payload, signature) {

package/dist/esm/types.d.ts

@@ -17,8 +17,8 @@ export interface CreateAppOptions {
 export interface AppContext {
     app: Express;
     router: Router;
-    db: any;
-    auth: {
+    db?: any;
+    auth?: {
         middleware(): any;
     };
     config: Config;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cored3v/web-core",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Reusable licensed Express core for web applications",
   "type": "module",
   "main": "./dist/cjs/index.cjs",
@@ -39,4 +39,4 @@
     "typescript": "^5.4.0",
     "undici-types": "^7.18.2"
   }
-}
+}