@zintrust/core 0.1.19 → 0.1.21

package/src/cli/scaffolding/ProjectScaffolder.js

@@ -4,6 +4,7 @@
  */
 import { EnvFileBackfill } from '../env/EnvFileBackfill.js';
 import { Logger } from '../../config/logger.js';
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { randomBytes } from '../../node-singletons/crypto.js';
 import fs from '../../node-singletons/fs.js';
 import * as path from '../../node-singletons/path.js';
@@ -98,7 +99,33 @@ const createProjectConfigFile = (projectPath, variables) => {
         return false;
     }
 };
-const buildDatabaseEnvLines = (database) => {
+const toSafeDbBasename = (raw) => {
+    const trimmed = raw.trim();
+    if (trimmed === '')
+        return 'zintrust';
+    const lower = trimmed.toLowerCase();
+    let out = '';
+    let prevWasDash = false;
+    for (const char of lower) {
+        const isAlphaNum = (char >= 'a' && char <= 'z') || (char >= '0' && char <= '9');
+        const isContent = isAlphaNum || char === '_';
+        if (isContent) {
+            out += char;
+            prevWasDash = false;
+            continue;
+        }
+        // Treat as separator: collapse dashes and avoid leading dash
+        if (out.length > 0 && !prevWasDash) {
+            out += '-';
+            prevWasDash = true;
+        }
+    }
+    if (out.endsWith('-')) {
+        out = out.slice(0, -1);
+    }
+    return out === '' ? 'zintrust' : out;
+};
+const buildDatabaseEnvLinesWithName = (database, name) => {
     if (database === 'postgresql' || database === 'postgres') {
         return [
             'DB_HOST=localhost',
@@ -119,7 +146,8 @@ const buildDatabaseEnvLines = (database) => {
     }
     if (database === 'sqlite') {
         // Provide both DB_DATABASE (used by the framework) and DB_PATH (common alias)
-        return ['DB_DATABASE=./database.sqlite', 'DB_PATH=./database.sqlite'];
+        const base = toSafeDbBasename(name);
+        return [`DB_DATABASE=.zintrust/dbs/${base}.sqlite`, `DB_PATH=.zintrust/dbs/${base}.sqlite`];
     }
     if (database === 'd1-remote' || database === 'd1-proxy') {
         return [
@@ -166,7 +194,7 @@ const createEnvFile = (projectPath, variables) => {
             `APP_KEY=${appKey}`,
             `DB_CONNECTION=${database}`,
         ];
-        const dbLines = buildDatabaseEnvLines(database);
+        const dbLines = buildDatabaseEnvLinesWithName(database, name);
         const placeholderLines = [
             '',
             '# Logging',
@@ -254,6 +282,7 @@ const loadTemplateFiles = (templateDir) => {
         'config/broadcast.ts',
         'config/cache.ts',
         'config/database.ts',
+        'config/middleware.ts',
         'config/logging/HttpLogger.ts',
         'config/mail.ts',
         'config/notification.ts',
@@ -352,6 +381,7 @@ const API_TEMPLATE = {
         'logs',
         'storage',
         'tmp',
+        'src',
         'routes',
         'tests',
     ],
@@ -484,6 +514,7 @@ coverage/
 logs/
 storage/
 tmp/
+.zintrust/
 *.log
 `;
     }
@@ -501,6 +532,7 @@ zin s
 
 - Health: http://localhost:{{port}}/health
 - Tasks:  http://localhost:{{port}}/api/tasks
+- Doc:  http://localhost:{{port}}/doc
 `;
     }
     return createFiles(state.projectPath, files, variables);
@@ -548,7 +580,7 @@ const scaffoldWithState = async (state, options
     }
     catch (error) {
         Logger.error('Project scaffolding failed', error);
-        const err = error instanceof Error ? error : new Error(String(error));
+        const err = error instanceof Error ? error : ErrorFactory.createGeneralError(String(error));
         return {
             success: false,
             projectPath: state.projectPath,

package/src/cli/scaffolding/RouteGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RouteGenerator.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/RouteGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAqB3F;AAED;;GAEG;AAEH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2CnF;AA+HD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,EAAE,CAsCpD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,eAAe,EAAE,CA6BjD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,eAAe,EAAE,CA+BlD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAEhD;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;EAOzB,CAAC"}
+{"version":3,"file":"RouteGenerator.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/RouteGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAqB3F;AAED;;GAEG;AAEH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA4CnF;AA2LD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,EAAE,CAsCpD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,eAAe,EAAE,CA6BjD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,eAAe,EAAE,CA+BlD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAEhD;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;EAOzB,CAAC"}

package/src/cli/scaffolding/RouteGenerator.js

@@ -63,11 +63,12 @@ export function generateRoutes(options) {
     }
     catch (error) {
         Logger.error('Route generation failed', error);
+        const message = error instanceof Error ? error.message : String(error);
         return Promise.resolve({
             success: false,
             routeFile: '',
             routeCount: 0,
-            message: `Error: ${error.message}`,
+            message: `Error: ${message}`,
         });
     }
 }
@@ -76,6 +77,7 @@ export function generateRoutes(options) {
  */
 function buildRouteWrapper(options) {
     const imports = buildImports(options);
+    const controllerInstances = buildControllerInstances(options);
     const routeRegistration = buildRouteRegistration(options);
     return `/**
  * Routes
@@ -84,7 +86,8 @@ function buildRouteWrapper(options) {
 
 ${imports}
 
-export function registerRoutes(router: Router): void {
+export function registerRoutes(router: IRouter): void {
+${controllerInstances}
 ${routeRegistration}
 }
 `;
@@ -93,7 +96,7 @@ ${routeRegistration}
  * Build import statements
  */
 function buildImports(options) {
-    const imports = ['import { Router } from "../../routing/Router";'];
+    const imports = ["import { Router, type IRouter } from '../../index.js';"];
     // Collect unique controllers
     const controllers = new Set();
     for (const route of options.routes) {
@@ -105,78 +108,111 @@ function buildImports(options) {
     }
     return imports.join('\n');
 }
+function toControllerVar(controllerName) {
+    if (controllerName.length === 0)
+        return 'controller';
+    return `${controllerName[0].toLowerCase()}${controllerName.slice(1)}`;
+}
+function toTag(controllerName) {
+    const trimmed = controllerName.endsWith('Controller')
+        ? controllerName.slice(0, -'Controller'.length)
+        : controllerName;
+    return trimmed === '' ? 'General' : trimmed;
+}
+function buildControllerInstances(options) {
+    const controllers = new Set();
+    for (const route of options.routes) {
+        controllers.add(route.controller);
+    }
+    let code = '';
+    for (const controller of controllers) {
+        const varName = toControllerVar(controller);
+        code += `  const ${varName} = typeof ${controller}.create === 'function' ? ${controller}.create() : ${controller};\n`;
+    }
+    return code;
+}
 /**
  * Build route registration code
  */
 function buildRouteRegistration(options) {
     let code = '';
-    // Add group if prefix or middleware provided
-    if (options.prefix !== undefined || options.middleware !== undefined) {
-        code += `  router.group({`;
-        const groupOptions = [];
-        if (options.prefix !== undefined) {
-            groupOptions.push(`    prefix: '${options.prefix}'`);
-        }
-        if (options.middleware !== undefined && options.middleware.length > 0) {
-            const middleware = options.middleware.map((m) => `'${m}'`).join(', ');
-            groupOptions.push(`    middleware: [${middleware}]`);
-        }
-        code += groupOptions.join(',\n') + '\n';
-        code += `  }, (r) => {\n`;
-        // Add routes inside group
+    const groupMiddleware = options.middleware ?? [];
+    const groupMiddlewareList = groupMiddleware.map((m) => `'${m}'`).join(', ');
+    if (options.prefix !== undefined && options.prefix.trim() !== '') {
+        code += `  Router.group(router, '${options.prefix}', (r) => {\n`;
         for (const route of options.routes) {
-            code += buildRouteCode(route, 'r');
+            code += buildRouteCode(route, 'r', groupMiddlewareList);
         }
         code += `  });\n`;
+        return code;
     }
-    else {
-        // Add routes directly
-        for (const route of options.routes) {
-            code += buildRouteCode(route, 'router');
-        }
+    for (const route of options.routes) {
+        code += buildRouteCode(route, 'router', groupMiddlewareList);
     }
     return code;
 }
 /**
  * Build single route code
  */
-function buildRouteCode(route, router) {
+function buildRouteCode(route, router, groupMiddlewareList) {
     if (route.method === 'resource') {
-        return buildResourceRoute(route, router);
+        return buildResourceRoute(route, router, groupMiddlewareList);
     }
     else {
-        return buildMethodRoute(route, router);
+        return buildMethodRoute(route, router, groupMiddlewareList);
     }
 }
 /**
  * Build standard method route (GET, POST, etc.)
  */
-function buildMethodRoute(route, router) {
-    const method = route.method;
+function buildMethodRoute(route, router, groupMiddlewareList) {
+    const method = route.method === 'delete' ? 'del' : route.method;
     const routePath = route.path;
     const controller = route.controller;
     const action = route.action ?? 'handle';
-    const middleware = route.middleware === undefined
-        ? ''
-        : (() => {
-            const middlewareList = route.middleware.map((m) => `'${m}'`).join(', ');
-            return `, { middleware: [${middlewareList}] }`;
-        })();
-    return `    ${router}.${method}('${routePath}', [${controller}, '${action}']${middleware});\n`;
+    const tag = toTag(controller);
+    const summary = `${method.toUpperCase()} ${routePath}`;
+    const controllerVar = toControllerVar(controller);
+    const localMiddlewareList = (route.middleware ?? []).map((m) => `'${m}'`).join(', ');
+    const hasGroup = groupMiddlewareList.trim() !== '';
+    const hasLocal = localMiddlewareList.trim() !== '';
+    const middlewareProp = hasGroup || hasLocal
+        ? `middleware: [${[hasGroup ? groupMiddlewareList : '', hasLocal ? localMiddlewareList : '']
+            .filter((v) => v.trim() !== '')
+            .join(', ')}]`
+        : '';
+    const metaProp = `meta: { summary: ${JSON.stringify(summary)}, tags: [${JSON.stringify(tag)}] }`;
+    const options = `{ ${[middlewareProp, metaProp].filter((v) => v !== '').join(', ')} }`;
+    return `  Router.${method}(${router}, '${routePath}', (req, res) => ${controllerVar}.${action}(req, res), ${options});\n`;
 }
 /**
  * Build resource route (RESTful CRUD)
  */
-function buildResourceRoute(route, router) {
+function buildResourceRoute(route, router, groupMiddlewareList) {
     const routePath = route.path;
     const controller = route.controller;
-    const middleware = route.middleware === undefined
-        ? ''
-        : (() => {
-            const middlewareList = route.middleware.map((m) => `'${m}'`).join(', ');
-            return `, { middleware: [${middlewareList}] }`;
-        })();
-    return `    ${router}.resource('${routePath}', ${controller}${middleware});\n`;
+    const tag = toTag(controller);
+    const controllerVar = toControllerVar(controller);
+    const localMiddlewareList = (route.middleware ?? []).map((m) => `'${m}'`).join(', ');
+    const hasGroup = groupMiddlewareList.trim() !== '';
+    const hasLocal = localMiddlewareList.trim() !== '';
+    const middlewareProp = hasGroup || hasLocal
+        ? `middleware: [${[hasGroup ? groupMiddlewareList : '', hasLocal ? localMiddlewareList : '']
+            .filter((v) => v.trim() !== '')
+            .join(', ')}]`
+        : '';
+    const resourceMeta = (action, routePattern) => `meta: { summary: ${JSON.stringify(action.toUpperCase() + ' ' + routePattern)}, tags: [${JSON.stringify(tag)}] }`;
+    const pathId = routePath + '/:id';
+    const optsParts = [
+        middlewareProp,
+        `index: { ${resourceMeta('GET', routePath)} }`,
+        `store: { ${resourceMeta('POST', routePath)} }`,
+        `show: { ${resourceMeta('GET', pathId)} }`,
+        `update: { ${resourceMeta('PUT', pathId)} }`,
+        `destroy: { ${resourceMeta('DELETE', pathId)} }`,
+    ].filter((v) => v !== '');
+    const options = `{ ${optsParts.join(', ')} }`;
+    return `  Router.resource(${router}, '${routePath}', ${controllerVar}, ${options});\n`;
 }
 /**
  * Generate common API routes (User CRUD example)

package/src/cli/scaffolding/SeederGenerator.d.ts

@@ -17,6 +17,9 @@ export interface SeederOptions {
     relationships?: string[];
     truncate?: boolean;
 }
+export interface DatabaseSeederOptions {
+    seedersPath: string;
+}
 export interface SeederGeneratorResult {
     success: boolean;
     filePath: string;
@@ -34,6 +37,7 @@ export declare function validateOptions(options: SeederOptions): Promise<void>;
  * Generate a database seeder
  */
 export declare function generateSeeder(options: SeederOptions): Promise<SeederGeneratorResult>;
+export declare function generateDatabaseSeeder(options: DatabaseSeederOptions): Promise<SeederGeneratorResult>;
 /**
  * Get available seeder options
  */
@@ -41,6 +45,7 @@ export declare function getAvailableOptions(): string[];
 export declare const SeederGenerator: Readonly<{
     validateOptions: typeof validateOptions;
     generateSeeder: typeof generateSeeder;
+    generateDatabaseSeeder: typeof generateDatabaseSeeder;
     getAvailableOptions: typeof getAvailableOptions;
 }>;
 export default SeederGenerator;

package/src/cli/scaffolding/SeederGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SeederGenerator.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/SeederGenerator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AAEH;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAmC3E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAyB3F;AA+OD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAQ9C;AAED,eAAO,MAAM,eAAe;;;;EAI1B,CAAC;AAEH,eAAe,eAAe,CAAC"}
+{"version":3,"file":"SeederGenerator.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/SeederGenerator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AAEH;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B3E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAyB3F;AAkBD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,qBAAqB,CAAC,CAyBhC;AAmQD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAQ9C;AAED,eAAO,MAAM,eAAe;;;;;EAK1B,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/src/cli/scaffolding/SeederGenerator.js

@@ -35,14 +35,7 @@ export async function validateOptions(options) {
     if (options.count !== undefined && (options.count < 1 || options.count > 100000)) {
         throw ErrorFactory.createCliError('Count must be between 1 and 100000');
     }
-    // Verify seeders path exists
-    const pathStat = await fs.stat(options.seedersPath).catch(() => null);
-    if (pathStat === null) {
-        throw ErrorFactory.createCliError(`Seeders path does not exist: ${options.seedersPath}`);
-    }
-    if (!pathStat.isDirectory()) {
-        throw ErrorFactory.createCliError(`Seeders path is not a directory: ${options.seedersPath}`);
-    }
+    await assertDirectoryExists(options.seedersPath, 'Seeders path');
 }
 /**
  * Generate a database seeder
@@ -70,6 +63,64 @@ export async function generateSeeder(options) {
         };
     }
 }
+async function validateDatabaseSeederOptions(options) {
+    await assertDirectoryExists(options.seedersPath, 'Seeders path');
+}
+async function assertDirectoryExists(dirPath, label) {
+    const pathStat = await fs.stat(dirPath).catch(() => null);
+    if (pathStat === null) {
+        throw ErrorFactory.createCliError(`${label} does not exist: ${dirPath}`);
+    }
+    if (!pathStat.isDirectory()) {
+        throw ErrorFactory.createCliError(`${label} is not a directory: ${dirPath}`);
+    }
+}
+export async function generateDatabaseSeeder(options) {
+    try {
+        await validateDatabaseSeederOptions(options);
+        const seederCode = buildDatabaseSeederCode();
+        const fileName = 'DatabaseSeeder.ts';
+        const filePath = path.join(options.seedersPath, fileName);
+        FileGenerator.writeFile(filePath, seederCode, { overwrite: true });
+        Logger.info(`✅ Created seeder: ${fileName}`);
+        return {
+            success: true,
+            filePath,
+            message: `Seeder '${fileName}' created successfully`,
+        };
+    }
+    catch (error) {
+        Logger.error('DatabaseSeeder generation failed', error);
+        return {
+            success: false,
+            filePath: '',
+            message: error.message,
+        };
+    }
+}
+function buildDatabaseSeederCode() {
+    return `import { SeederDiscovery } from '../../seeders/SeederDiscovery';
+import { SeederLoader } from '../../seeders/SeederLoader';
+import { CommonUtils } from '../../common/index';
+import type { IDatabase } from '../../orm/Database';
+import * as path from '../../node-singletons/path';
+
+export const DatabaseSeeder = Object.freeze({
+  async run(db: IDatabase): Promise<void> {
+    const dir = CommonUtils.esmDirname(import.meta.url);
+    const files = SeederDiscovery.listSeederFiles(dir).filter((filePath) => {
+      const base = path.basename(filePath, path.extname(filePath));
+      return base !== 'DatabaseSeeder';
+    });
+
+    for (const filePath of files) {
+      const loaded = await SeederLoader.load(filePath);
+      await loaded.run(db);
+    }
+  },
+});
+`;
+}
 /**
  * Build complete seeder code
  */
@@ -222,8 +273,7 @@ import { ${options.modelName} } from '@app/Models/${options.modelName}';`;
  */
 function buildRelationshipMethods(options) {
     if (options.relationships === undefined || options.relationships.length === 0) {
-        return `    const factory = new ${getFactoryName(options)}();
-    const records = factory.count(${options.count ?? 10});
+        return `    const records = factory.count(${options.count ?? 10});
 
     // Create records with relationships (implement as needed)
     for (const record of records) {
@@ -236,13 +286,10 @@ function buildRelationshipMethods(options) {
         return `    // Seed with ${rel} relationships
     const ${CommonUtils.camelCase(rel)}s = await ${rel}.all();
     if (${CommonUtils.camelCase(rel)}s.length > 0) {
-      const factory = new ${getFactoryName(options)}();
-      const records = factory
-        .count(Math.min(${options.count ?? 10}, ${CommonUtils.camelCase(rel)}s.length))
-        .get();
+      const records = factory.count(Math.min(${options.count ?? 10}, ${CommonUtils.camelCase(rel)}s.length));
 
       for (let i = 0; i < records.length; i++) {
-        records[i].${relId} = ${CommonUtils.camelCase(rel)}s[i].id;
+        (records[i] as Record<string, unknown>).${relId} = (${CommonUtils.camelCase(rel)}s[i] as { id?: unknown }).id;
         // await ${options.modelName}.create(records[i]);
       }
     }`;
@@ -281,6 +328,7 @@ export function getAvailableOptions() {
 export const SeederGenerator = Object.freeze({
     validateOptions,
     generateSeeder,
+    generateDatabaseSeeder,
     getAvailableOptions,
 });
 export default SeederGenerator;

package/src/cli/scaffolding/ServiceScaffolder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServiceScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ServiceScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IACjC,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAuB7F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAGnF;AAED;;GAEG;AAEH,wBAAgB,QAAQ,CACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,qBAAqB,CAAC,CA+ChC;AA6SD,eAAO,MAAM,iBAAiB;;;;EAI5B,CAAC"}
+{"version":3,"file":"ServiceScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ServiceScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IACjC,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAuB7F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAGnF;AAED;;GAEG;AAEH,wBAAgB,QAAQ,CACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,qBAAqB,CAAC,CA+ChC;AAkUD,eAAO,MAAM,iBAAiB;;;;EAI5B,CAAC"}

package/src/cli/scaffolding/ServiceScaffolder.js

@@ -162,7 +162,7 @@ function generateServiceIndex(options) {
  * Auth: ${options.auth ?? 'api-key'}
  */
 
-import { Application, Server } from '@zintrust/core';
+import { Application, Server } from '../../index.js';
 import { Logger } from '../../config/logger';
 import { Env } from '../../config/env';
 import { esmDirname } from '../../common/index';
@@ -192,13 +192,24 @@ function generateServiceRoutes(options) {
  * ${options.name} Service Routes
  */
 
-import { Router, type IRouter } from '@zintrust/core';
+import { Router, type IRouter } from '../../index.js';
 
 export function registerRoutes(router: IRouter): void {
   // Example route
-  Router.get(router, '/', (_req, res) => {
+  Router.get(
+    router,
+    '/',
+    (_req, res) => {
     res.json({ message: '${options.name} service' });
-  });
+    },
+    {
+      meta: {
+        summary: 'Service root',
+        tags: ['Service'],
+        responseStatus: 200,
+      },
+    }
+  );
 }
 `;
 }
@@ -211,9 +222,9 @@ function generateExampleController(options) {
  * Example Controller for ${options.name} Service
  */
 
-import { type IRequest, type IResponse, Controller } from '@zintrust/core';
+import { type IRequest, type IResponse, Controller } from '../../index.js';
 
-export const ${className} = {
+const controller = Object.freeze({
   ...Controller,
 
   /**
@@ -254,6 +265,16 @@ export const ${className} = {
     res.json({ deleted: true, id });
   },
 };
+
+export type ${className}Api = typeof controller;
+
+export const ${className} = Object.freeze({
+  create(): ${className}Api {
+    return controller;
+  },
+});
+
+export default ${className};
 `;
 }
 /**
@@ -264,7 +285,7 @@ function generateExampleModel(options) {
  * Example Model for ${options.name} Service
  */
 
-import { Model } from '@zintrust/core';
+import { Model } from '../../index.js';
 
 export const Example = Model.define({
   table: '${options.name}',

package/src/cli/scaffolding/index.d.ts

@@ -9,6 +9,8 @@ export { FeatureScaffolder } from '../scaffolding/FeatureScaffolder';
 export type { FeatureOptions, FeatureScaffoldResult, FeatureType, } from '../scaffolding/FeatureScaffolder';
 export { FileGenerator } from '../scaffolding/FileGenerator';
 export type { FileCreationOptions } from '../scaffolding/FileGenerator';
+export { GovernanceScaffolder } from '../scaffolding/GovernanceScaffolder';
+export type { GovernanceScaffoldOptions, GovernanceScaffoldResult, } from '../scaffolding/GovernanceScaffolder';
 export { MigrationGenerator } from '../scaffolding/MigrationGenerator';
 export type { MigrationOptions, MigrationScaffoldResult, } from '../scaffolding/MigrationGenerator';
 export { ModelGenerator } from '../scaffolding/ModelGenerator';

package/src/cli/scaffolding/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,YAAY,EACV,yBAAyB,EACzB,iBAAiB,EACjB,cAAc,GACf,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,YAAY,EACV,YAAY,EACZ,sBAAsB,EACtB,cAAc,GACf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,WAAW,GACZ,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,YAAY,EACV,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,YAAY,EACV,SAAS,EACT,UAAU,EACV,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,YAAY,EACV,6BAA6B,EAC7B,qBAAqB,EACrB,YAAY,GACb,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,YAAY,EACV,8BAA8B,EAC9B,sBAAsB,EACtB,aAAa,GACd,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,YAAY,GACb,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,YAAY,EACV,WAAW,EACX,qBAAqB,EACrB,aAAa,GACd,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,+BAA+B,EAAE,MAAM,kDAAkD,CAAC;AACnG,YAAY,EACV,eAAe,EACf,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAC;AACjG,YAAY,EACV,2BAA2B,EAC3B,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACrF,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,YAAY,EACV,yBAAyB,EACzB,iBAAiB,EACjB,cAAc,GACf,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,YAAY,EACV,YAAY,EACZ,sBAAsB,EACtB,cAAc,GACf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,WAAW,GACZ,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,YAAY,EACV,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,YAAY,EACV,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,YAAY,EACV,SAAS,EACT,UAAU,EACV,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,YAAY,EACV,6BAA6B,EAC7B,qBAAqB,EACrB,YAAY,GACb,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,YAAY,EACV,8BAA8B,EAC9B,sBAAsB,EACtB,aAAa,GACd,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,YAAY,GACb,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,YAAY,EACV,WAAW,EACX,qBAAqB,EACrB,aAAa,GACd,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,+BAA+B,EAAE,MAAM,kDAAkD,CAAC;AACnG,YAAY,EACV,eAAe,EACf,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAC;AACjG,YAAY,EACV,2BAA2B,EAC3B,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACrF,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC"}

package/src/cli/scaffolding/index.js

@@ -5,6 +5,7 @@ export { ControllerGenerator } from '../scaffolding/ControllerGenerator.js';
 export { FactoryGenerator } from '../scaffolding/FactoryGenerator.js';
 export { FeatureScaffolder } from '../scaffolding/FeatureScaffolder.js';
 export { FileGenerator } from '../scaffolding/FileGenerator.js';
+export { GovernanceScaffolder } from '../scaffolding/GovernanceScaffolder.js';
 export { MigrationGenerator } from '../scaffolding/MigrationGenerator.js';
 export { ModelGenerator } from '../scaffolding/ModelGenerator.js';
 export { ProjectScaffolder } from '../scaffolding/ProjectScaffolder.js';

package/src/common/index.d.ts

@@ -59,10 +59,18 @@ export declare const CommonUtils: Readonly<{
      * Read file contents as string
      */
     readFile(filePath: string): string;
+    /**
+     * Read file contents as string (async)
+     */
+    readFileAsync(filePath: string): Promise<string>;
     /**
      * Write file with optional directory creation
      */
     writeFile(filePath: string, content: string, createDir?: boolean): void;
+    /**
+     * Write file with optional directory creation (async)
+     */
+    writeFileAsync(filePath: string, content: string, createDir?: boolean): Promise<void>;
     /**
      * Delete file if it exists
      */

package/src/common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,eAAO,MAAM,WAAW;qBACL,MAAM,GAAG,OAAO;CAOlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;sBACe,MAAM;IAgBxB;;OAEG;IAEH;;OAEG;cACa,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtC;;OAEG;yBACkB,MAAM,GAAG,GAAG,GAAG,MAAM;IAI1C;;OAEG;wBACiB,MAAM,GAAG,GAAG,GAAG,MAAM;IAIzC;;OAEG;IAEH;;OAEG;mBACY,MAAM,GAAG,MAAM;IAgB9B;;OAEG;qBACc,MAAM,GAAG,MAAM;IAUhC;;OAEG;sBACe,MAAM,GAAG,MAAM;IAQjC;;OAEG;IAEH;;OAEG;yBACkB,MAAM,GAAG,OAAO;IAIrC;;OAEG;uBACgB,MAAM,GAAG,IAAI;IAMhC;;OAEG;2BACoB,MAAM,GAAG,IAAI;IAQpC;;OAEG;uBACgB,MAAM,GAAG,MAAM;IAUlC;;OAEG;wBACiB,MAAM,WAAW,MAAM,wBAAqB,IAAI;IAcpE;;OAEG;yBACkB,MAAM,GAAG,IAAI;IAYlC;;OAEG;IAEH;;OAEG;2BACoB,MAAM;IAI7B;;OAEG;2BACmB,IAAI,GAAgB,MAAM;IAIhD;;OAEG;8BACuB,MAAM,GAAG,IAAI;IAYvC;;OAEG;IAEH;;OAEG;+BACwB,OAAO,GAAG,MAAM;IAa3C;;OAEG;6BAEQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBAChB,MAAM,EAAE,WACf,MAAM,GACd,IAAI;IAWP;;OAEG;mBACY,OAAO,GAAG,OAAO;IAIhC;;OAEG;wBACiB,OAAO,aAAa,MAAM,GAAG,MAAM;IAOvD;;OAEG;wBACiB,OAAO,aAAa,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAOxE;;;OAGG;sCAC+B,MAAM,EAAE,GAAG,MAAM;EAgBnD,CAAC;AAGH,eAAO,MAAM,cAAc,QAAO,MAAsC,CAAC;AAEzE,eAAO,MAAM,KAAK,GAAU,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CAA0B,CAAC;AAEhF,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,GAAG,GAAG,KAAG,MAA0C,CAAC;AAC/F,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,GAAG,GAAG,KAAG,MAAyC,CAAC;AAE7F,eAAO,MAAM,qBAAqB,GAAI,YAAY,MAAM,EAAE,KAAG,MAE5D,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,MACb,CAAC;AAIzC,eAAO,MAAM,yBAAyB,GAAI,OAAO,OAAO,KAAG,MAM1D,CAAC;AAGF,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,KAAG,OAA2C,CAAC;AAC1F,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,KAAG,IAAsC,CAAC;AACnF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,KAAG,IAA0C,CAAC;AAC3F,eAAO,MAAM,QAAQ,GAAI,UAAU,MAAM,KAAG,MAAwC,CAAC;AACrF,eAAO,MAAM,SAAS,GAAI,UAAU,MAAM,EAAE,SAAS,MAAM,EAAE,mBAAgB,KAAG,IAC3B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,eAAO,MAAM,WAAW;qBACL,MAAM,GAAG,OAAO;CAOlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;sBACe,MAAM;IAgBxB;;OAEG;IAEH;;OAEG;cACa,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtC;;OAEG;yBACkB,MAAM,GAAG,GAAG,GAAG,MAAM;IAI1C;;OAEG;wBACiB,MAAM,GAAG,GAAG,GAAG,MAAM;IAIzC;;OAEG;IAEH;;OAEG;mBACY,MAAM,GAAG,MAAM;IAgB9B;;OAEG;qBACc,MAAM,GAAG,MAAM;IAUhC;;OAEG;sBACe,MAAM,GAAG,MAAM;IAQjC;;OAEG;IAEH;;OAEG;yBACkB,MAAM,GAAG,OAAO;IAIrC;;OAEG;uBACgB,MAAM,GAAG,IAAI;IAMhC;;OAEG;2BACoB,MAAM,GAAG,IAAI;IAQpC;;OAEG;uBACgB,MAAM,GAAG,MAAM;IAUlC;;OAEG;4BAC2B,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWtD;;OAEG;wBACiB,MAAM,WAAW,MAAM,wBAAqB,IAAI;IAcpE;;OAEG;6BAC4B,MAAM,WAAW,MAAM,wBAAqB,OAAO,CAAC,IAAI,CAAC;IAexF;;OAEG;yBACkB,MAAM,GAAG,IAAI;IAYlC;;OAEG;IAEH;;OAEG;2BACoB,MAAM;IAI7B;;OAEG;2BACmB,IAAI,GAAgB,MAAM;IAIhD;;OAEG;8BACuB,MAAM,GAAG,IAAI;IAYvC;;OAEG;IAEH;;OAEG;+BACwB,OAAO,GAAG,MAAM;IAa3C;;OAEG;6BAEQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,kBAChB,MAAM,EAAE,WACf,MAAM,GACd,IAAI;IAWP;;OAEG;mBACY,OAAO,GAAG,OAAO;IAIhC;;OAEG;wBACiB,OAAO,aAAa,MAAM,GAAG,MAAM;IAOvD;;OAEG;wBACiB,OAAO,aAAa,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAOxE;;;OAGG;sCAC+B,MAAM,EAAE,GAAG,MAAM;EAgBnD,CAAC;AAGH,eAAO,MAAM,cAAc,QAAO,MAAsC,CAAC;AAEzE,eAAO,MAAM,KAAK,GAAU,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CAA0B,CAAC;AAEhF,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,GAAG,GAAG,KAAG,MAA0C,CAAC;AAC/F,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,GAAG,GAAG,KAAG,MAAyC,CAAC;AAE7F,eAAO,MAAM,qBAAqB,GAAI,YAAY,MAAM,EAAE,KAAG,MAE5D,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,MACb,CAAC;AAIzC,eAAO,MAAM,yBAAyB,GAAI,OAAO,OAAO,KAAG,MAM1D,CAAC;AAGF,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,KAAG,OAA2C,CAAC;AAC1F,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,KAAG,IAAsC,CAAC;AACnF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,KAAG,IAA0C,CAAC;AAC3F,eAAO,MAAM,QAAQ,GAAI,UAAU,MAAM,KAAG,MAAwC,CAAC;AACrF,eAAO,MAAM,SAAS,GAAI,UAAU,MAAM,EAAE,SAAS,MAAM,EAAE,mBAAgB,KAAG,IAC3B,CAAC"}

package/src/common/index.js

@@ -141,6 +141,18 @@ export const CommonUtils = Object.freeze({
             throw ErrorFactory.createGeneralError(`Failed to read file: ${filePath}. ${error instanceof Error ? error.message : 'Unknown error'}`);
         }
     },
+    /**
+     * Read file contents as string (async)
+     */
+    async readFileAsync(filePath) {
+        try {
+            const fsPromises = await import('../node-singletons/fs.js').then((m) => m.fsPromises);
+            return await fsPromises.readFile(filePath, 'utf-8');
+        }
+        catch (error) {
+            throw ErrorFactory.createGeneralError(`Failed to read file: ${filePath}. ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    },
     /**
      * Write file with optional directory creation
      */
@@ -156,6 +168,22 @@ export const CommonUtils = Object.freeze({
             throw ErrorFactory.createGeneralError(`Failed to write file: ${filePath}. ${error instanceof Error ? error.message : 'Unknown error'}`);
         }
     },
+    /**
+     * Write file with optional directory creation (async)
+     */
+    async writeFileAsync(filePath, content, createDir = true) {
+        try {
+            const fsPromises = await import('../node-singletons/fs.js').then((m) => m.fsPromises);
+            if (createDir) {
+                const dir = path.dirname(filePath);
+                await fsPromises.mkdir(dir, { recursive: true });
+            }
+            await fsPromises.writeFile(filePath, content, 'utf-8');
+        }
+        catch (error) {
+            throw ErrorFactory.createGeneralError(`Failed to write file: ${filePath}. ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    },
     /**
      * Delete file if it exists
      */