@sharangyawali/sg-app 0.0.5

package/common/interface/controller-method-paramenters.interface.d.ts

@@ -0,0 +1,6 @@
+import { RequestParameters } from "../enum";
+export interface ControllerMethodParams<T = RequestParameters | string> {
+    dtoClass: any;
+    index: number;
+    paramType: T;
+}

package/common/interface/controller-method-paramenters.interface.js

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

package/common/interface/controller-methods.interface.d.ts

@@ -0,0 +1,6 @@
+import { RequestMethodEnum } from "../enum";
+export interface ControllerMethods<T = RequestMethodEnum | string> {
+    method: T;
+    path?: string;
+    handler: string | symbol;
+}

package/common/interface/controller-methods.interface.js

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

package/common/interface/cors.interface.d.ts

@@ -0,0 +1,14 @@
+export interface CorsOptions {
+    origin?: boolean | string | RegExp | (string | RegExp)[] | CorsOptionsDelegate;
+    methods?: string | string[];
+    allowedHeaders?: string | string[];
+    exposedHeaders?: string | string[];
+    credentials?: boolean;
+    preflightContinue?: boolean;
+    optionsSuccessStatus?: number;
+    maxAge?: number;
+    vary?: boolean;
+}
+export interface CorsOptionsDelegate {
+    (origin: string | undefined, callback: (err: Error | null, allow: boolean) => void): void;
+}

package/common/interface/cors.interface.js

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

package/common/interface/features/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./sg-middleware.interface";
+export * from "./sg-guard.interface";
+export * from "./sg-interceptor.interface";
+export * from "./sg-filter.interface";

package/common/interface/features/index.js

@@ -0,0 +1,20 @@
+"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 __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 });
+__exportStar(require("./sg-middleware.interface"), exports);
+__exportStar(require("./sg-guard.interface"), exports);
+__exportStar(require("./sg-interceptor.interface"), exports);
+__exportStar(require("./sg-filter.interface"), exports);

package/common/interface/features/sg-filter.interface.d.ts

@@ -0,0 +1,4 @@
+import { HttpContext, HttpException } from "../..";
+export interface SGFilter {
+    catch(exception: HttpException, context: HttpContext): any;
+}

package/common/interface/features/sg-filter.interface.js

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

package/common/interface/features/sg-guard.interface.d.ts

@@ -0,0 +1,4 @@
+import { HttpContext } from "../..";
+export interface SGGuard {
+    canAccess(httpContext: HttpContext): Promise<Boolean>;
+}

package/common/interface/features/sg-guard.interface.js

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

package/common/interface/features/sg-interceptor.interface.d.ts

@@ -0,0 +1,4 @@
+import { HttpContext } from "../..";
+export interface SGInterceptor {
+    intercept(httpContext: HttpContext): Promise<(data: any) => any | void>;
+}

package/common/interface/features/sg-interceptor.interface.js

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

package/common/interface/features/sg-middleware.interface.d.ts

@@ -0,0 +1,4 @@
+import { NextFunction, Request, Response } from "express";
+export interface SGMiddleware {
+    use(request: Request, response: Response, next: NextFunction): any;
+}

package/common/interface/features/sg-middleware.interface.js

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

package/common/interface/global-middleware-options.interface.d.ts

@@ -0,0 +1,5 @@
+import { RouteInfo } from "./route-info.interface";
+export interface MiddlewareOptions<T = RouteInfo> {
+    exclude?: T[];
+    forRoutes?: T[];
+}

package/common/interface/global-middleware-options.interface.js

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

package/common/interface/global-prefix-options.interface.d.ts

@@ -0,0 +1,4 @@
+import { RouteInfo } from "./route-info.interface";
+export interface GlobalPrefixOptions<T = RouteInfo> {
+    exclude?: T[];
+}

package/common/interface/global-prefix-options.interface.js

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

package/common/interface/index.d.ts

@@ -0,0 +1,15 @@
+export * from "./route-info.interface";
+export * from "./global-prefix-options.interface";
+export * from "./sg-application.interface";
+export * from "./global-middleware-options.interface";
+export * from "./features";
+export * from "./controller-methods.interface";
+export * from "./controller-method-paramenters.interface";
+export * from "./module-options.interface";
+export * from "./injectable-options.interface";
+export * from "./type.interface";
+export * from "./injection-token.interface";
+export * from "./provider.interface";
+export * from './sg-factory.interface';
+export * from './cors.interface';
+export * from './static-route.interface';

package/common/interface/index.js

@@ -0,0 +1,31 @@
+"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 __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 });
+__exportStar(require("./route-info.interface"), exports);
+__exportStar(require("./global-prefix-options.interface"), exports);
+__exportStar(require("./sg-application.interface"), exports);
+__exportStar(require("./global-middleware-options.interface"), exports);
+__exportStar(require("./features"), exports);
+__exportStar(require("./controller-methods.interface"), exports);
+__exportStar(require("./controller-method-paramenters.interface"), exports);
+__exportStar(require("./module-options.interface"), exports);
+__exportStar(require("./injectable-options.interface"), exports);
+__exportStar(require("./type.interface"), exports);
+__exportStar(require("./injection-token.interface"), exports);
+__exportStar(require("./provider.interface"), exports);
+__exportStar(require("./sg-factory.interface"), exports);
+__exportStar(require("./cors.interface"), exports);
+__exportStar(require("./static-route.interface"), exports);

package/common/interface/injectable-options.interface.d.ts

@@ -0,0 +1,5 @@
+import { Scope } from "../enum";
+export interface InjectableOptions<T = Scope> {
+    scope: T;
+    token?: string;
+}

package/common/interface/injectable-options.interface.js

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

package/common/interface/injection-token.interface.d.ts

@@ -0,0 +1,2 @@
+export type Constructor<T = any> = new (...args: any[]) => T;
+export type Token<T = any> = (new (...args: any[]) => T) | symbol | string;

package/common/interface/injection-token.interface.js

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

package/common/interface/module-options.interface.d.ts

@@ -0,0 +1,6 @@
+import { ModuleProvider } from "./provider.interface";
+export interface ModuleOptions {
+    controllers?: any[];
+    imports?: any[];
+    providers?: ModuleProvider[];
+}

package/common/interface/module-options.interface.js

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

package/common/interface/provider.interface.d.ts

@@ -0,0 +1,30 @@
+import { Scope } from "../enum";
+import { Constructor, Token } from "./injection-token.interface";
+import { Type } from "./type.interface";
+export type ModuleProvider<T = any> = Type<any> | ClassProvider<T> | ValueProvider<T> | FactoryProvider<T>;
+export interface ClassProvider<T = any> {
+    token: Token<T>;
+    useClass?: Constructor<T>;
+    scope: Scope;
+}
+export interface ValueProvider<T = any> {
+    token: Token<T>;
+    useValue?: T;
+    scope: Scope;
+}
+export interface FactoryProvider<T = any> {
+    inject: Token[];
+    token: Token<T>;
+    useFactory: (...args: any[]) => {
+        value: T;
+    };
+    scope: Scope;
+}
+export interface Provider<T = any> {
+    token: Token<T>;
+    useClass?: Constructor<T>;
+    useValue?: T;
+    scope: Scope;
+    inject?: Token[];
+    useFactory?: (...args: any[]) => T;
+}

package/common/interface/provider.interface.js

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

package/common/interface/route-info.interface.d.ts

@@ -0,0 +1,5 @@
+import { RequestMethodEnum } from "../enum/request-method.enum";
+export interface RouteInfo {
+    routePrefix: string;
+    method: RequestMethodEnum;
+}

package/common/interface/route-info.interface.js

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

package/common/interface/sg-application.interface.d.ts

@@ -0,0 +1,8 @@
+import { GlobalPrefixOptions } from "./global-prefix-options.interface";
+import { StaticRoutes } from "./static-route.interface";
+export interface ISGApplication {
+    use(...args: any[]): this;
+    setStaticRoutes(options: StaticRoutes[]): this;
+    setGlobalPrefix(prefix: string, options?: GlobalPrefixOptions): this;
+    listen(port: number, callback?: (error?: Error) => void): Promise<any>;
+}

package/common/interface/sg-application.interface.js

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

package/common/interface/sg-factory.interface.d.ts

@@ -0,0 +1,8 @@
+import { CorsOptions } from "./cors.interface";
+import { ISGApplication } from "./sg-application.interface";
+export interface FactoryOptions {
+    cors?: CorsOptions | boolean;
+}
+export interface ISGFactory {
+    create(appModule: any, options?: FactoryOptions): ISGApplication;
+}

package/common/interface/sg-factory.interface.js

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

package/common/interface/sg-interceptor.interface.d.ts

@@ -0,0 +1,3 @@
+export interface SGInterceptor {
+    intercepts: any;
+}

package/common/interface/sg-interceptor.interface.js

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

package/common/interface/static-route.interface.d.ts

@@ -0,0 +1,20 @@
+import { Response } from "express";
+export interface StaticRoutes {
+    prefix?: string;
+    path: string;
+    options?: StaticOptions;
+}
+export interface StaticOptions<T = Response> {
+    acceptRanges?: boolean | undefined;
+    cacheControl?: boolean | undefined;
+    dotfiles?: string | undefined;
+    etag?: boolean | undefined;
+    extensions?: string[] | false | undefined;
+    fallthrough?: boolean | undefined;
+    immutable?: boolean | undefined;
+    index?: boolean | string | string[] | undefined;
+    lastModified?: boolean | undefined;
+    maxAge?: number | string | undefined;
+    redirect?: boolean | undefined;
+    setHeaders?: ((res: T, path: string, stat: any) => any) | undefined;
+}

package/common/interface/static-route.interface.js

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

package/common/interface/type.interface.d.ts

@@ -0,0 +1,3 @@
+export interface Type<T = any> extends Function {
+    new (...args: any[]): T;
+}

package/common/interface/type.interface.js

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

package/config/config-service.d.ts

@@ -0,0 +1,3 @@
+export declare class ConfigService {
+    get(propertyPath: string): string;
+}

package/config/config-service.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigService = void 0;
+const dotenv_1 = require("dotenv");
+(0, dotenv_1.config)();
+class ConfigService {
+    get(propertyPath) {
+        return process.env[propertyPath];
+    }
+}
+exports.ConfigService = ConfigService;

package/config/index.d.ts

@@ -0,0 +1 @@
+export * from "./config-service";

package/config/index.js

@@ -0,0 +1,17 @@
+"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 __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 });
+__exportStar(require("./config-service"), exports);

package/di-container.d.ts

@@ -0,0 +1,15 @@
+import { Provider, Token } from "./common";
+import "reflect-metadata";
+declare class Container {
+    private providers;
+    private singletons;
+    private requestCache;
+    register(provider: Provider): void;
+    resolve<T>(token: Token<T>, requestId?: string): T;
+    private constructFactory;
+    private construct;
+    private createRequestScopedProxy;
+    removeRequestInstances(requestId: string): void;
+}
+export declare const container: Container;
+export {};

package/di-container.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.container = void 0;
+const common_1 = require("./common");
+const cls_1 = require("./cls");
+require("reflect-metadata");
+class Container {
+    providers = new Map();
+    singletons = new Map();
+    requestCache = new Map();
+    register(provider) {
+        this.providers.set(provider.token, provider);
+    }
+    resolve(token, requestId) {
+        if (token === common_1.REQUEST) {
+            const cls = this.resolve(cls_1.CLSService);
+            return cls.get("request");
+        }
+        const provider = this.providers.get(token);
+        if (!provider) {
+            if (typeof token === "function") {
+                return this.construct(token, requestId);
+            }
+            throw new common_1.HttpException(`No provider found for token: ${token.toString()}`);
+        }
+        if (provider.useValue)
+            return provider.useValue;
+        if (provider.scope == common_1.Scope.SINGLETON) {
+            if (!this.singletons.has(token)) {
+                const instance = provider.useFactory
+                    ? this.constructFactory(provider, requestId)
+                    : this.construct(provider.useClass, requestId);
+                this.singletons.set(token, instance);
+            }
+            return this.singletons.get(token);
+        }
+        else if (provider.scope === common_1.Scope.REQUEST) {
+            if (!requestId) {
+                throw new Error(`Request-scoped provider "${String(token)}" needs requestId`);
+            }
+            let cache = this.requestCache.get(requestId);
+            if (!cache) {
+                cache = new Map();
+                this.requestCache.set(requestId, cache);
+            }
+            if (cache.has(token))
+                return cache.get(token);
+            const instance = provider.useFactory
+                ? this.constructFactory(provider, requestId)
+                : this.construct(provider.useClass, requestId);
+            cache.set(token, instance);
+            return instance;
+        }
+        return provider.useFactory ? this.constructFactory(provider, requestId) : this.construct(provider.useClass, requestId);
+    }
+    constructFactory(provider, requestId) {
+        const params = provider.inject?.map((token) => {
+            const dep = this.providers.get(token);
+            if (dep?.scope === common_1.Scope.REQUEST) {
+                return this.createRequestScopedProxy(token);
+            }
+            return this.resolve(token, requestId);
+        }) ?? [];
+        return provider.useFactory(...params);
+    }
+    construct(target, requestId) {
+        const injections = Reflect.getMetadata("custom:inject_tokens", target) || {};
+        const args = [];
+        for (const index of Object.keys(injections)) {
+            const token = injections[index];
+            const provider = this.providers.get(token);
+            if (!provider) {
+                args[+index] = this.resolve(token, requestId);
+                continue;
+            }
+            if (provider?.scope === common_1.Scope.REQUEST) {
+                args[+index] = this.createRequestScopedProxy(token);
+            }
+            else {
+                args[+index] = this.resolve(token, requestId);
+            }
+        }
+        return new target(...args);
+    }
+    createRequestScopedProxy(token) {
+        const cls = this.resolve(cls_1.CLSService);
+        return new Proxy({}, {
+            get(_, prop) {
+                const requestId = cls.get('requestId');
+                if (!requestId) {
+                    throw new Error(`Request-scoped provider "${String(token)}" accessed outside request context`);
+                }
+                const instance = exports.container.resolve(token, requestId);
+                const value = instance[prop];
+                return typeof value === "function" ? value.bind(instance) : value;
+            }
+        });
+    }
+    removeRequestInstances(requestId) {
+        this.requestCache.delete(requestId);
+    }
+}
+exports.container = new Container();

package/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./logger";
+export * from "./common";
+export * from "./config";
+export * from "./sg-factory";
+export * from "./sg-application";
+export * from "./routes-config";
+export * from "./set-meta-data";
+export * from "./cls";
+export * from "./di-container";

package/index.js

@@ -0,0 +1,25 @@
+"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 __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 });
+__exportStar(require("./logger"), exports);
+__exportStar(require("./common"), exports);
+__exportStar(require("./config"), exports);
+__exportStar(require("./sg-factory"), exports);
+__exportStar(require("./sg-application"), exports);
+__exportStar(require("./routes-config"), exports);
+__exportStar(require("./set-meta-data"), exports);
+__exportStar(require("./cls"), exports);
+__exportStar(require("./di-container"), exports);

package/logger/index.d.ts

@@ -0,0 +1 @@
+export * from "./logger-service";

package/logger/index.js

@@ -0,0 +1,17 @@
+"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 __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 });
+__exportStar(require("./logger-service"), exports);

package/logger/logger-service.d.ts

@@ -0,0 +1,9 @@
+export declare class AppLogger {
+    private readonly logger;
+    constructor();
+    log(message: string): void;
+    debug(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    logWithContext(context: string, message: string): void;
+}

package/logger/logger-service.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppLogger = void 0;
+const winston_1 = require("winston");
+class AppLogger {
+    logger;
+    constructor() {
+        const colorizer = winston_1.format.colorize();
+        (0, winston_1.addColors)({
+            info: "bold green",
+            log: "bold white",
+            warn: "bold yellow"
+        });
+        const myFormat = winston_1.format.printf(({ message }) => {
+            const coloredTime = colorizer.colorize("log", new Date().toLocaleString());
+            const coloredServer = colorizer.colorize("info", "[NODE] SHARAN");
+            return `${coloredServer}- ${coloredTime}  ${message}`;
+        });
+        this.logger = (0, winston_1.createLogger)({
+            level: "info",
+            format: winston_1.format.combine(winston_1.format.colorize({ all: true }), myFormat),
+            transports: [
+                new winston_1.transports.Console(),
+            ],
+            exitOnError: false
+        });
+    }
+    log(message) {
+        this.logger.log("info", message);
+    }
+    debug(message) {
+        this.logger.debug(message);
+    }
+    warn(message) {
+        this.logger.warn(message);
+    }
+    error(message) {
+        this.logger.error(message);
+    }
+    logWithContext(context, message) {
+        this.logger.info(`[${context}] ${message}`);
+    }
+}
+exports.AppLogger = AppLogger;

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@sharangyawali/sg-app",
+  "version": "0.0.5",
+  "keywords": [],
+  "author": "Sharan Gyawali",
+  "license": "ISC",
+  "description": "SG-APP - Express App In CLEAN ARCHITECTURE",
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.0.3",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.3",
+    "cors": "^2.8.5",
+    "dotenv": "^17.2.3",
+    "express": "^5.2.1",
+    "reflect-metadata": "^0.2.2",
+    "winston": "^3.19.0"
+  }
+}