fragment-ts 1.0.17 → 1.0.18

package/dist/core/decorators/injection.decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"injection.decorators.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/injection.decorators.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,IAAI,iBAAiB,CAK7C;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAIvD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAIzD;AAED,wBAAgB,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAI3D"}
+{"version":3,"file":"injection.decorators.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/injection.decorators.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,SAAS,IAAI,iBAAiB,CAe7C;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,iBAAiB,CAIlE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,iBAAiB,CASpE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAIzD;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,CAS3D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,iBAAiB,CAI5C;AAED;;;GAGG;AACH,wBAAgB,IAAI,IAAI,iBAAiB,CAwBxC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAY/C;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,eAAe,CAY5C"}

package/dist/core/decorators/injection.decorators.js

@@ -2,28 +2,119 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Autowired = Autowired;
 exports.Inject = Inject;
+exports.InjectRepository = InjectRepository;
 exports.Qualifier = Qualifier;
 exports.Value = Value;
+exports.Optional = Optional;
+exports.Lazy = Lazy;
+exports.PostConstruct = PostConstruct;
+exports.PreDestroy = PreDestroy;
 const metadata_keys_1 = require("../metadata/metadata-keys");
+/**
+ * @Autowired - Automatically inject dependencies by type
+ * Usage: @Autowired() private myService: MyService;
+ */
 function Autowired() {
     return (target, propertyKey) => {
-        const type = Reflect.getMetadata('design:type', target, propertyKey);
+        // Get the design type from TypeScript metadata
+        const type = Reflect.getMetadata("design:type", target, propertyKey);
+        if (!type || type === Object) {
+            throw new Error(`Cannot use @Autowired on property "${String(propertyKey)}" in ${target.constructor.name}. ` +
+                `Make sure TypeScript emitDecoratorMetadata is enabled and the type is explicitly declared.`);
+        }
+        // Store the type in metadata so DI container can resolve it
         Reflect.defineMetadata(metadata_keys_1.METADATA_KEYS.AUTOWIRED, type, target, propertyKey);
     };
 }
+/**
+ * @Inject - Inject dependency by token (string or class)
+ * Usage: @Inject('MyService') private service: MyService;
+ * or: @Inject(MyService) private service: MyService;
+ */
 function Inject(token) {
     return (target, propertyKey) => {
         Reflect.defineMetadata(metadata_keys_1.METADATA_KEYS.INJECT, token, target, propertyKey);
     };
 }
+/**
+ * @InjectRepository - Inject TypeORM repository for an entity
+ * Usage: @InjectRepository(User) private userRepo: Repository<User>;
+ */
+function InjectRepository(entity) {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(metadata_keys_1.METADATA_KEYS.INJECT_REPOSITORY, entity, target, propertyKey);
+    };
+}
+/**
+ * @Qualifier - Specify which bean to inject when multiple exist
+ * Usage: @Qualifier('primary') @Autowired() private service: MyService;
+ */
 function Qualifier(name) {
     return (target, propertyKey) => {
         Reflect.defineMetadata(metadata_keys_1.METADATA_KEYS.QUALIFIER, name, target, propertyKey);
     };
 }
+/**
+ * @Value - Inject configuration value from environment or config
+ * Usage: @Value('${PORT}') private port: number;
+ * or: @Value('${DB_HOST:localhost}') private host: string;
+ */
 function Value(expression) {
     return (target, propertyKey) => {
         Reflect.defineMetadata(metadata_keys_1.METADATA_KEYS.VALUE, expression, target, propertyKey);
     };
 }
+/**
+ * @Optional - Mark dependency as optional (won't throw if not found)
+ * Usage: @Optional() @Autowired() private service?: MyService;
+ */
+function Optional() {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(metadata_keys_1.METADATA_KEYS.OPTIONAL, true, target, propertyKey);
+    };
+}
+/**
+ * @Lazy - Lazy load dependency (create on first access)
+ * Usage: @Lazy() @Autowired() private service: MyService;
+ */
+function Lazy() {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(metadata_keys_1.METADATA_KEYS.LAZY, true, target, propertyKey);
+        const type = Reflect.getMetadata("design:type", target, propertyKey);
+        // Create a getter that resolves on first access
+        let cached = null;
+        let resolved = false;
+        Object.defineProperty(target, propertyKey, {
+            get() {
+                if (!resolved) {
+                    const { DIContainer } = require("../container/di-container");
+                    const container = DIContainer.getInstance();
+                    cached = container.resolve(type);
+                    resolved = true;
+                }
+                return cached;
+            },
+            enumerable: true,
+            configurable: true,
+        });
+    };
+}
+/**
+ * @PostConstruct - Method called after dependency injection is complete
+ * Usage: @PostConstruct() init() { ... }
+ */
+function PostConstruct() {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(metadata_keys_1.METADATA_KEYS.POST_CONSTRUCT, propertyKey, target.constructor);
+    };
+}
+/**
+ * @PreDestroy - Method called before bean is destroyed
+ * Usage: @PreDestroy() cleanup() { ... }
+ */
+function PreDestroy() {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(metadata_keys_1.METADATA_KEYS.PRE_DESTROY, propertyKey, target.constructor);
+    };
+}
 //# sourceMappingURL=injection.decorators.js.map

package/dist/core/decorators/injection.decorators.js.map

@@ -1 +1 @@
-{"version":3,"file":"injection.decorators.js","sourceRoot":"","sources":["../../../src/core/decorators/injection.decorators.ts"],"names":[],"mappings":";;AAEA,8BAKC;AAED,wBAIC;AAED,8BAIC;AAED,sBAIC;AAzBD,6DAA0D;AAE1D,SAAgB,SAAS;IACvB,OAAO,CAAC,MAAW,EAAE,WAA4B,EAAE,EAAE;QACnD,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACrE,OAAO,CAAC,cAAc,CAAC,6BAAa,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC7E,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,MAAM,CAAC,KAAa;IAClC,OAAO,CAAC,MAAW,EAAE,WAA4B,EAAE,EAAE;QACnD,OAAO,CAAC,cAAc,CAAC,6BAAa,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3E,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,SAAS,CAAC,IAAY;IACpC,OAAO,CAAC,MAAW,EAAE,WAA4B,EAAE,EAAE;QACnD,OAAO,CAAC,cAAc,CAAC,6BAAa,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC7E,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,KAAK,CAAC,UAAkB;IACtC,OAAO,CAAC,MAAW,EAAE,WAA4B,EAAE,EAAE;QACnD,OAAO,CAAC,cAAc,CAAC,6BAAa,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/E,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"injection.decorators.js","sourceRoot":"","sources":["../../../src/core/decorators/injection.decorators.ts"],"names":[],"mappings":"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"}

package/dist/core/metadata/metadata-keys.d.ts

@@ -1,20 +1,32 @@
 export declare const METADATA_KEYS: {
-    INJECTABLE: string;
-    SCOPE: string;
-    SERVICE: string;
-    CONTROLLER: string;
-    REPOSITORY: string;
-    AUTO_CONFIGURATION: string;
-    CONDITIONAL_ON_CLASS: string;
-    CONDITIONAL_ON_MISSING_BEAN: string;
-    CONDITIONAL_ON_PROPERTY: string;
-    AUTOWIRED: string;
-    INJECT: string;
-    QUALIFIER: string;
-    VALUE: string;
-    HTTP_METHOD: string;
-    ROUTE_PATH: string;
-    PARAM_METADATA: string;
-    APPLICATION: string;
+    readonly APPLICATION: "fragment:application";
+    readonly INJECTABLE: "fragment:injectable";
+    readonly CONTROLLER: "fragment:controller";
+    readonly SERVICE: "fragment:service";
+    readonly REPOSITORY: "fragment:repository";
+    readonly AUTO_CONFIGURATION: "fragment:auto-configuration";
+    readonly SCOPE: "fragment:scope";
+    readonly AUTOWIRED: "fragment:autowired";
+    readonly INJECT: "fragment:inject";
+    readonly INJECT_REPOSITORY: "fragment:inject-repository";
+    readonly QUALIFIER: "fragment:qualifier";
+    readonly VALUE: "fragment:value";
+    readonly OPTIONAL: "fragment:optional";
+    readonly LAZY: "fragment:lazy";
+    readonly HTTP_METHOD: "fragment:http-method";
+    readonly ROUTE_PATH: "fragment:route-path";
+    readonly POST_CONSTRUCT: "fragment:post-construct";
+    readonly PRE_DESTROY: "fragment:pre-destroy";
+    readonly PARAM_METADATA: "fragment:param-metadata";
+    readonly CONDITIONAL_ON_CLASS: "fragment:conditional-on-class";
+    readonly CONDITIONAL_ON_MISSING_BEAN: "fragment:conditional-on-missing-bean";
+    readonly CONDITIONAL_ON_PROPERTY: "fragment:conditional-on-property";
+    readonly CONDITIONAL_ON_BEAN: "fragment:conditional-on-bean";
+    readonly USE_GUARDS: "fragment:use-guards";
+    readonly USE_INTERCEPTORS: "fragment:use-interceptors";
+    readonly USE_FILTERS: "fragment:use-filters";
+    readonly VALIDATE: "fragment:validate";
+    readonly TRANSFORM: "fragment:transform";
 };
+export type MetadataKey = (typeof METADATA_KEYS)[keyof typeof METADATA_KEYS];
 //# sourceMappingURL=metadata-keys.d.ts.map

package/dist/core/metadata/metadata-keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-keys.d.ts","sourceRoot":"","sources":["../../../src/core/metadata/metadata-keys.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;CAkBzB,CAAC"}
+{"version":3,"file":"metadata-keys.d.ts","sourceRoot":"","sources":["../../../src/core/metadata/metadata-keys.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0ChB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC"}

package/dist/core/metadata/metadata-keys.js

@@ -2,22 +2,40 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.METADATA_KEYS = void 0;
 exports.METADATA_KEYS = {
-    INJECTABLE: 'fragment:injectable',
-    SCOPE: 'fragment:scope',
-    SERVICE: 'fragment:service',
-    CONTROLLER: 'fragment:controller',
-    REPOSITORY: 'fragment:repository',
-    AUTO_CONFIGURATION: 'fragment:auto-configuration',
-    CONDITIONAL_ON_CLASS: 'fragment:conditional-class',
-    CONDITIONAL_ON_MISSING_BEAN: 'fragment:conditional-missing-bean',
-    CONDITIONAL_ON_PROPERTY: 'fragment:conditional-property',
-    AUTOWIRED: 'fragment:autowired',
-    INJECT: 'fragment:inject',
-    QUALIFIER: 'fragment:qualifier',
-    VALUE: 'fragment:value',
-    HTTP_METHOD: 'fragment:http-method',
-    ROUTE_PATH: 'fragment:route-path',
-    PARAM_METADATA: 'fragment:param-metadata',
-    APPLICATION: 'fragment:application'
+    // Class decorators
+    APPLICATION: "fragment:application",
+    INJECTABLE: "fragment:injectable",
+    CONTROLLER: "fragment:controller",
+    SERVICE: "fragment:service",
+    REPOSITORY: "fragment:repository",
+    AUTO_CONFIGURATION: "fragment:auto-configuration",
+    SCOPE: "fragment:scope",
+    // Property decorators
+    AUTOWIRED: "fragment:autowired",
+    INJECT: "fragment:inject",
+    INJECT_REPOSITORY: "fragment:inject-repository",
+    QUALIFIER: "fragment:qualifier",
+    VALUE: "fragment:value",
+    OPTIONAL: "fragment:optional",
+    LAZY: "fragment:lazy",
+    // Method decorators
+    HTTP_METHOD: "fragment:http-method",
+    ROUTE_PATH: "fragment:route-path",
+    POST_CONSTRUCT: "fragment:post-construct",
+    PRE_DESTROY: "fragment:pre-destroy",
+    // Parameter decorators
+    PARAM_METADATA: "fragment:param-metadata",
+    // Conditional decorators
+    CONDITIONAL_ON_CLASS: "fragment:conditional-on-class",
+    CONDITIONAL_ON_MISSING_BEAN: "fragment:conditional-on-missing-bean",
+    CONDITIONAL_ON_PROPERTY: "fragment:conditional-on-property",
+    CONDITIONAL_ON_BEAN: "fragment:conditional-on-bean",
+    // Middleware & Guards
+    USE_GUARDS: "fragment:use-guards",
+    USE_INTERCEPTORS: "fragment:use-interceptors",
+    USE_FILTERS: "fragment:use-filters",
+    // Validation
+    VALIDATE: "fragment:validate",
+    TRANSFORM: "fragment:transform",
 };
 //# sourceMappingURL=metadata-keys.js.map

package/dist/core/metadata/metadata-keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-keys.js","sourceRoot":"","sources":["../../../src/core/metadata/metadata-keys.ts"],"names":[],"mappings":";;;AAAa,QAAA,aAAa,GAAG;IAC3B,UAAU,EAAE,qBAAqB;IACjC,KAAK,EAAE,gBAAgB;IACvB,OAAO,EAAE,kBAAkB;IAC3B,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE,qBAAqB;IACjC,kBAAkB,EAAE,6BAA6B;IACjD,oBAAoB,EAAE,4BAA4B;IAClD,2BAA2B,EAAE,mCAAmC;IAChE,uBAAuB,EAAE,+BAA+B;IACxD,SAAS,EAAE,oBAAoB;IAC/B,MAAM,EAAE,iBAAiB;IACzB,SAAS,EAAE,oBAAoB;IAC/B,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,sBAAsB;IACnC,UAAU,EAAE,qBAAqB;IACjC,cAAc,EAAE,yBAAyB;IACzC,WAAW,EAAE,sBAAsB;CACpC,CAAC"}
+{"version":3,"file":"metadata-keys.js","sourceRoot":"","sources":["../../../src/core/metadata/metadata-keys.ts"],"names":[],"mappings":";;;AAAa,QAAA,aAAa,GAAG;IAC3B,mBAAmB;IACnB,WAAW,EAAE,sBAAsB;IACnC,UAAU,EAAE,qBAAqB;IACjC,UAAU,EAAE,qBAAqB;IACjC,OAAO,EAAE,kBAAkB;IAC3B,UAAU,EAAE,qBAAqB;IACjC,kBAAkB,EAAE,6BAA6B;IACjD,KAAK,EAAE,gBAAgB;IAEvB,sBAAsB;IACtB,SAAS,EAAE,oBAAoB;IAC/B,MAAM,EAAE,iBAAiB;IACzB,iBAAiB,EAAE,4BAA4B;IAC/C,SAAS,EAAE,oBAAoB;IAC/B,KAAK,EAAE,gBAAgB;IACvB,QAAQ,EAAE,mBAAmB;IAC7B,IAAI,EAAE,eAAe;IAErB,oBAAoB;IACpB,WAAW,EAAE,sBAAsB;IACnC,UAAU,EAAE,qBAAqB;IACjC,cAAc,EAAE,yBAAyB;IACzC,WAAW,EAAE,sBAAsB;IAEnC,uBAAuB;IACvB,cAAc,EAAE,yBAAyB;IAEzC,yBAAyB;IACzB,oBAAoB,EAAE,+BAA+B;IACrD,2BAA2B,EAAE,sCAAsC;IACnE,uBAAuB,EAAE,kCAAkC;IAC3D,mBAAmB,EAAE,8BAA8B;IAEnD,sBAAsB;IACtB,UAAU,EAAE,qBAAqB;IACjC,gBAAgB,EAAE,2BAA2B;IAC7C,WAAW,EAAE,sBAAsB;IAEnC,aAAa;IACb,QAAQ,EAAE,mBAAmB;IAC7B,SAAS,EAAE,oBAAoB;CACvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fragment-ts",
-  "version": "1.0.17",
+  "version": "1.0.18",
   "description": "Spring Boot-style framework for TypeScript with Express and TypeORM",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/cli/commands/init.command.ts

@@ -169,12 +169,14 @@ export class InitCommand {
         "migrate:revert": "fragment migrate:revert",
       },
       dependencies: {
-        "fragment-ts": "^1.0.17",
+        "fragment-ts": "^1.0.18",
         "reflect-metadata": "^0.1.13",
       },
       devDependencies: {
         typescript: "^5.3.3",
         "@types/node": "^20.10.5",
+        "ts-node": "^10.9.2",
+        "tsconfig-paths": "^4.2.0",
       },
     };
 
@@ -214,9 +216,7 @@ export class InitCommand {
         database: process.env.DATABASE_FILE || "database.sqlite",
         synchronize: true,
         logging: false,
-        entities: isProd
-          ? ["dist/**/*.entity.js"]
-          : ["src/**/*.entity.ts"],
+        entities: isProd ? ["dist/**/*.entity.js"] : ["src/**/*.entity.ts"],
         migrations: isProd
           ? ["dist/migrations/**/*.js"]
           : ["src/migrations/**/*.ts"],

package/src/cli/commands/test.command.ts

@@ -0,0 +1,289 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import * as path from "path";
+import { spawn } from "child_process";
+import * as fs from "fs";
+
+export class TestCommand {
+  static register(program: Command): void {
+    program
+      .command("test")
+      .description("Run tests")
+      .option("--watch", "Run tests in watch mode")
+      .option(
+        "--env <environment>",
+        "Environment mode: dev (use src/) or prod (use dist/)",
+        "auto",
+      )
+      .option("--pattern <pattern>", "Test file pattern", "**/*.spec.ts")
+      .option("--coverage", "Generate coverage report")
+      .action(async (options) => {
+        await this.runTests(options);
+      });
+  }
+
+  private static async runTests(options: any): Promise<void> {
+    console.log(chalk.blue("\n🧪 Running Fragment Tests...\n"));
+
+    const cwd = process.cwd();
+    const hasSource = fs.existsSync(path.join(cwd, "src"));
+    const hasDist = fs.existsSync(path.join(cwd, "dist"));
+
+    let useTypeScript: boolean;
+    let mode: string;
+    let basePath: string;
+    let pattern: string;
+
+    if (options.env === "dev") {
+      if (!hasSource) {
+        console.log(
+          chalk.red("Development mode requested but src/ directory not found"),
+        );
+        return;
+      }
+      useTypeScript = true;
+      mode = "development (src/)";
+      basePath = "src";
+      pattern = options.pattern || "**/*.spec.ts";
+    } else if (options.env === "prod") {
+      if (!hasDist) {
+        console.log(
+          chalk.red(
+            "Production mode requested but dist/ directory not found. Run: fragment build",
+          ),
+        );
+        return;
+      }
+      useTypeScript = false;
+      mode = "production (dist/)";
+      basePath = "dist";
+      pattern = options.pattern.replace(".ts", ".js") || "**/*.spec.js";
+    } else {
+      // Auto-detect
+      if (hasSource) {
+        useTypeScript = true;
+        mode = "auto-detected development (src/)";
+        basePath = "src";
+        pattern = options.pattern || "**/*.spec.ts";
+      } else if (hasDist) {
+        useTypeScript = false;
+        mode = "auto-detected production (dist/)";
+        basePath = "dist";
+        pattern = options.pattern.replace(".ts", ".js") || "**/*.spec.js";
+      } else {
+        console.log(
+          chalk.red("No src/ or dist/ directory found. Run: fragment init"),
+        );
+        return;
+      }
+    }
+
+    console.log(chalk.gray(`   Mode: ${mode}\n`));
+
+    const scriptContent = `
+${useTypeScript ? "require('ts-node/register/transpile-only');" : ""}
+require('reflect-metadata');
+
+const { glob } = require('glob');
+const path = require('path');
+
+// Global test state
+const testState = {
+  suites: [],
+  currentSuite: null,
+  passed: 0,
+  failed: 0,
+  errors: []
+};
+
+// Global test functions
+global.describe = function(name, fn) {
+  const suite = { name, tests: [] };
+  testState.suites.push(suite);
+  testState.currentSuite = suite;
+  fn();
+  testState.currentSuite = null;
+};
+
+global.it = function(name, fn) {
+  if (!testState.currentSuite) {
+    throw new Error('it() must be called inside describe()');
+  }
+  testState.currentSuite.tests.push({ name, fn });
+};
+
+global.expect = function(actual) {
+  return {
+    toBe(expected) {
+      if (actual !== expected) {
+        throw new Error(\`Expected \${actual} to be \${expected}\`);
+      }
+    },
+    toEqual(expected) {
+      if (JSON.stringify(actual) !== JSON.stringify(expected)) {
+        throw new Error(\`Expected \${JSON.stringify(actual)} to equal \${JSON.stringify(expected)}\`);
+      }
+    },
+    toBeTruthy() {
+      if (!actual) {
+        throw new Error(\`Expected \${actual} to be truthy\`);
+      }
+    },
+    toBeFalsy() {
+      if (actual) {
+        throw new Error(\`Expected \${actual} to be falsy\`);
+      }
+    },
+    toThrow(expectedError) {
+      let threw = false;
+      let error = null;
+      try {
+        actual();
+      } catch (e) {
+        threw = true;
+        error = e;
+      }
+      if (!threw) {
+        throw new Error('Expected function to throw');
+      }
+      if (expectedError && error.message !== expectedError) {
+        throw new Error(\`Expected error message "\${expectedError}" but got "\${error.message}"\`);
+      }
+    },
+    toBeInstanceOf(expected) {
+      if (!(actual instanceof expected)) {
+        throw new Error(\`Expected \${actual} to be instance of \${expected.name}\`);
+      }
+    },
+    toContain(expected) {
+      if (!actual.includes(expected)) {
+        throw new Error(\`Expected \${actual} to contain \${expected}\`);
+      }
+    },
+    toHaveProperty(property, value) {
+      if (!(property in actual)) {
+        throw new Error(\`Expected object to have property \${property}\`);
+      }
+      if (value !== undefined && actual[property] !== value) {
+        throw new Error(\`Expected property \${property} to be \${value} but got \${actual[property]}\`);
+      }
+    },
+    toBeNull() {
+      if (actual !== null) {
+        throw new Error(\`Expected \${actual} to be null\`);
+      }
+    },
+    toBeUndefined() {
+      if (actual !== undefined) {
+        throw new Error(\`Expected \${actual} to be undefined\`);
+      }
+    },
+    toHaveLength(expected) {
+      if (actual.length !== expected) {
+        throw new Error(\`Expected length \${expected} but got \${actual.length}\`);
+      }
+    }
+  };
+};
+
+async function runTests() {
+  try {
+    // Find and load test files
+    const files = await glob('${basePath}/${pattern}', { cwd: process.cwd() });
+    
+    if (files.length === 0) {
+      console.log('No test files found matching pattern: ${basePath}/${pattern}');
+      process.exit(0);
+    }
+
+    console.log(\`Found \${files.length} test file(s)\\n\`);
+
+    // Load all test files
+    for (const file of files) {
+      require(path.resolve(file));
+    }
+
+    // Run all tests
+    for (const suite of testState.suites) {
+      console.log(\`\\n📦 \${suite.name}\`);
+
+      for (const test of suite.tests) {
+        try {
+          await test.fn();
+          console.log(\`  ✓ \${test.name}\`);
+          testState.passed++;
+        } catch (error) {
+          console.log(\`  ✗ \${test.name}\`);
+          console.error(\`    \${error.message}\`);
+          testState.failed++;
+          testState.errors.push({
+            suite: suite.name,
+            test: test.name,
+            error: error.message,
+            stack: error.stack
+          });
+        }
+      }
+    }
+
+    // Print summary
+    console.log(\`\\n\\n📊 Results: \${testState.passed} passed, \${testState.failed} failed\\n\`);
+
+    if (testState.failed > 0) {
+      console.log('\\n❌ Failed Tests:\\n');
+      testState.errors.forEach(err => {
+        console.log(\`  \${err.suite} > \${err.test}\`);
+        console.log(\`    \${err.error}\\n\`);
+      });
+      process.exit(1);
+    } else {
+      console.log('✅ All tests passed!\\n');
+      process.exit(0);
+    }
+  } catch (error) {
+    console.error('Error running tests:', error);
+    process.exit(1);
+  }
+}
+
+runTests();
+`;
+
+    const scriptPath = path.join(cwd, ".fragment-test-runner.js");
+
+    try {
+      fs.writeFileSync(scriptPath, scriptContent);
+
+      const nodeArgs = [scriptPath];
+      const env = {
+        ...process.env,
+        TS_NODE_TRANSPILE_ONLY: "true",
+        NODE_ENV: "test",
+      };
+
+      const proc = spawn("node", nodeArgs, {
+        cwd,
+        stdio: "inherit",
+        env,
+      });
+
+      proc.on("close", (code) => {
+        try {
+          fs.unlinkSync(scriptPath);
+        } catch {}
+        process.exit(code || 0);
+      });
+
+      proc.on("error", (error) => {
+        console.error(chalk.red("Failed to run tests:"), error);
+        try {
+          fs.unlinkSync(scriptPath);
+        } catch {}
+        process.exit(1);
+      });
+    } catch (error: any) {
+      console.error(chalk.red("Failed to create test runner:"), error.message);
+      process.exit(1);
+    }
+  }
+}

package/src/cli/index.ts

@@ -1,23 +1,28 @@
-import { Command } from 'commander';
-import { InitCommand } from './commands/init.command';
-import { GenerateCommand } from './commands/generate.command';
-import { ServeCommand } from './commands/serve.command';
-import { BuildCommand } from './commands/build.command';
-import { MigrateCommand } from './commands/migrate.command';
-import { DiagnosticsCommand } from './commands/diagnostics.command';
+import { Command } from "commander";
+import { InitCommand } from "./commands/init.command";
+import { GenerateCommand } from "./commands/generate.command";
+import { ServeCommand } from "./commands/serve.command";
+import { BuildCommand } from "./commands/build.command";
+import { MigrateCommand } from "./commands/migrate.command";
+import { DiagnosticsCommand } from "./commands/diagnostics.command";
+import { TestCommand } from "./commands/test.command";
 
 const program = new Command();
 
 program
-  .name('fragment')
-  .description('Fragment Framework CLI')
-  .version('1.0.0');
+  .name("fragment")
+  .description(
+    "Fragment Framework CLI - A TypeScript framework inspired by Spring Boot",
+  )
+  .version("1.0.0");
 
+// Register all commands
 InitCommand.register(program);
 GenerateCommand.register(program);
 ServeCommand.register(program);
 BuildCommand.register(program);
+TestCommand.register(program);
 MigrateCommand.register(program);
 DiagnosticsCommand.register(program);
 
-program.parse();
+program.parse();