create-forgeapi 1.0.0

package/template/src/shared/utils/SwaggerUtil.ts

@@ -0,0 +1,107 @@
+import {ZodType} from "zod";
+
+type OpenApiSchema = Record<string, any>;
+
+function zodToOpenApi(schema: ZodType): OpenApiSchema {
+    const def = (schema as any)._def;
+    const typeName: string = def?.type ?? '';
+
+    switch (typeName) {
+        case 'optional':
+        case 'nullable':
+        case 'default':
+            return zodToOpenApi(def.innerType);
+
+        case 'string':
+            return { type: 'string' };
+
+        case 'number':
+        case 'int':
+        case 'float':
+            return { type: 'number' };
+
+        case 'boolean':
+            return { type: 'boolean' };
+
+        case 'array': {
+            return {
+                type: 'array',
+                items: zodToOpenApi(def.element)
+            };
+        }
+
+        case 'literal': {
+            const val = def.values?.[0];
+            const litType = typeof val === 'boolean' ? 'boolean' : typeof val === 'number' ? 'number' : 'string';
+            return { type: litType, example: val };
+        }
+
+        case 'enum': {
+            const values = Object.values(def.entries ?? {});
+            const enumType = typeof values[0] === 'number' ? 'number' : 'string';
+            return { type: enumType, enum: values };
+        }
+
+        case 'record':
+            return { type: 'object', additionalProperties: zodToOpenApi(def.valueType ?? def.element) };
+
+        case 'unknown':
+        case 'any':
+            return {};
+
+        case 'object': {
+            const shape: Record<string, ZodType> = def.shape ?? {};
+            const properties: OpenApiSchema = {};
+            const required: string[] = [];
+
+            for (const [key, fieldSchema] of Object.entries(shape)) {
+                properties[key] = zodToOpenApi(fieldSchema as ZodType);
+                const fieldDef = (fieldSchema as any)._def;
+                const isOptional = fieldDef?.type === 'optional' || fieldDef?.type === 'nullable';
+                if (!isOptional) {
+                    required.push(key);
+                }
+            }
+
+            return {
+                type: 'object',
+                properties,
+                ...(required.length > 0 ? { required } : {})
+            };
+        }
+
+        default:
+            return { type: 'string' };
+    }
+}
+
+export default class SwaggerUtil {
+    static generateSchema(type: ZodType): OpenApiSchema {
+        if (!type) return {};
+        return zodToOpenApi(type);
+    }
+
+    static generateParameters(type: ZodType, location: 'path' | 'query'): OpenApiSchema[] {
+        if (!type) return [];
+
+        const def = (type as any)._def;
+        if (def?.type !== 'object') return [];
+
+        const shape: Record<string, ZodType> = def.shape ?? {};
+        const parameters: OpenApiSchema[] = [];
+
+        for (const [key, fieldSchema] of Object.entries(shape)) {
+            const fieldDef = (fieldSchema as any)._def;
+            const isOptional = fieldDef?.type === 'optional' || fieldDef?.type === 'nullable';
+
+            parameters.push({
+                name: key,
+                in: location,
+                required: location === 'path' ? true : !isOptional,
+                schema: zodToOpenApi(fieldSchema as ZodType)
+            });
+        }
+
+        return parameters;
+    }
+}

package/template/src/shared/utils/TimeUtil.ts

@@ -0,0 +1,74 @@
+import {DAY_VALUES, MONTH_VALUES} from "@config/DateTimeConfig";
+
+
+export default class TimeUtil {
+    static getTimestamp(): string {
+        const now = new Date();
+        return now.toISOString();
+    }
+
+    static getTimeString() {
+        return new Date().toLocaleString()
+    }
+
+    static formatDuration(ms: number): string {
+        if (ms < 1000) return `${ms.toFixed(0)}ms`;
+        return `${(ms / 1000).toFixed(2)}s`;
+    }
+
+    // Private helper methods to avoid duplication
+    private static getDateComponents(date: Date) {
+        return {
+            day: date.getDate().toString().padStart(2, '0'),
+            month: MONTH_VALUES[date.getMonth()],
+            year: date.getFullYear(),
+            dayName: DAY_VALUES[date.getDay()]
+        };
+    }
+
+    private static getTimeComponents(date: Date) {
+        return {
+            hours: date.getHours().toString().padStart(2, '0'),
+            minutes: date.getMinutes().toString().padStart(2, '0'),
+            seconds: date.getSeconds().toString().padStart(2, '0')
+        };
+    }
+
+    static getDateTimeString(date: Date): string {
+        const year = date.getFullYear();
+        const month = (date.getMonth() + 1).toString().padStart(2, '0');
+        const day = date.getDate().toString().padStart(2, '0');
+        const {hours, minutes, seconds} = this.getTimeComponents(date);
+        return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}`;
+    }
+
+    static getReadableDate(date: Date): string {
+        const {day, month, year} = this.getDateComponents(date);
+        return `${day} ${month} ${year}`;
+    }
+
+    static getReadableDateTimeNoSecond(date: Date): string {
+        const {day, month, year} = this.getDateComponents(date);
+        return `${day} ${month} ${year} ${this.getReadableTime(date)}`;
+    }
+
+    static getReadableDateTime(date: Date): string {
+        const {day, month, year} = this.getDateComponents(date);
+        return `${day} ${month} ${year} ${this.getReadableTimeSecond(date)}`;
+    }
+
+    static getReadableDayDateTime(date: Date): string {
+        const {day, month, year, dayName} = this.getDateComponents(date);
+        return `${dayName}, ${day} ${month} ${year} ${this.getReadableTimeSecond(date)}`;
+    }
+
+    static getReadableTime(date: Date): string {
+        const {hours, minutes} = this.getTimeComponents(date);
+        return `${hours}:${minutes}`;
+    }
+
+    static getReadableTimeSecond(date: Date): string {
+        const {hours, minutes, seconds} = this.getTimeComponents(date);
+        return `${hours}:${minutes}:${seconds}`;
+    }
+}

package/template/tsconfig.dev.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "sourceMap": true,
+    "declaration": false,
+    "declarationMap": false,
+    "removeComments": false
+  }
+}

package/template/tsconfig.json

@@ -0,0 +1,33 @@
+{
+  "compilerOptions": {
+    "target": "ES2021",
+    "module": "commonjs",
+    "lib": ["ES2021"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "baseUrl": ".",
+    "paths": {
+//      "@/*": ["src/*"],
+      "@api/*": ["src/api/*"],
+      "@core/*": ["src/core/*"],
+      "@database/*": ["src/database/*"],
+      "@shared/*": ["src/shared/*"],
+      "@config/*": ["src/config/*"],
+      "@base/*": ["src/base/*"],
+    },
+    "typeRoots": ["./node_modules/@types", "./src/types", "./src/shared/types"]
+  },
+  "include": ["src/**/*"],
+  "files": ["src/shared/types/mongoose.d.ts", "src/shared/types/express.d.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/template/tsconfig.prod.json

@@ -0,0 +1,10 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "sourceMap": false,
+    "declaration": false,
+    "declarationMap": false,
+    "removeComments": true
+  }
+}
+