fragment-ts 1.0.18 → 1.0.20

package/changes/1.md

@@ -2,10 +2,12 @@
 
 ## Issues Fixed
 
-### 1. ✅ Test Command Created
+### 1. Test Command Created
+
 **Problem:** No test command existed.
 
 **Solution:** Created `TestCommand` class with full testing support:
+
 - Runs `.spec.ts` files
 - Supports watch mode
 - Auto-detects dev vs prod environment
@@ -13,6 +15,7 @@
 - Shows detailed test results with pass/fail counts
 
 **Usage:**
+
 ```bash
 fragment test                    # Run all tests
 fragment test --watch           # Watch mode
@@ -21,74 +24,84 @@ fragment test --pattern "**/*.spec.ts"  # Custom pattern
 
 ---
 
-### 2. ✅ @Autowired Decorator Fixed
+### 2. @Autowired Decorator Fixed
+
 **Problem:** @Autowired wasn't injecting dependencies properly.
 
 **Root Causes:**
+
 - Metadata wasn't being stored correctly on the prototype
 - DI container wasn't checking the prototype chain for metadata
 - Properties were being checked on instance instead of prototype
 
 **Solution:**
+
 - Fixed `Autowired()` decorator to store metadata on prototype
 - Updated DI container to traverse prototype chain with `getAllPropertyKeys()`
 - Added proper type checking from TypeScript's `design:type` metadata
 - Improved error messages for missing emitDecoratorMetadata
 
 **Now Works:**
+
 ```typescript
 @Service()
 export class UserService {
   @Autowired()
-  private userRepository!: UserRepository;  // ✅ Auto-injected
-  
+  private userRepository!: UserRepository; // Auto-injected
+
   @Autowired()
-  private emailService!: EmailService;      // ✅ Auto-injected
+  private emailService!: EmailService; // Auto-injected
 }
 ```
 
 ---
 
-### 3. ✅ Repository TypeORM Integration Fixed
+### 3. Repository TypeORM Integration Fixed
+
 **Problem:** Repositories couldn't access TypeORM repositories automatically.
 
 **Solution:** Created `@InjectRepository(Entity)` decorator:
+
 - New metadata key: `INJECT_REPOSITORY`
 - DI container resolves TypeORM repositories via `TypeORMModule.getDataSource()`
 - Automatic entity-to-repository mapping
 
 **Now Works:**
+
 ```typescript
 @Repository()
 export class UserRepository {
   @InjectRepository(User)
-  private repo!: Repository<User>;  // ✅ TypeORM repo injected
-  
+  private repo!: Repository<User>; // TypeORM repo injected
+
   async findAll() {
-    return this.repo.find();  // ✅ Direct TypeORM access
+    return this.repo.find(); // Direct TypeORM access
   }
 }
 ```
 
 ---
 
-### 4. ✅ All Injectable Decorators Working
+### 4. All Injectable Decorators Working
+
 **Previously Working:**
-- ✅ @Controller
-- ✅ @Service  
-- ✅ HTTP decorators (@Get, @Post, etc.)
+
+- @Controller
+- @Service
+- HTTP decorators (@Get, @Post, etc.)
 
 **Now Also Working:**
-- ✅ @Injectable - General purpose components
-- ✅ @Repository - Data access with TypeORM integration
-- ✅ @Autowired - Property injection by type
-- ✅ @InjectRepository - TypeORM repository injection
-- ✅ @Inject - Token-based injection
-- ✅ @Value - Environment variable injection
-- ✅ @Qualifier - Bean qualifier
-- ✅ @PostConstruct - Lifecycle hook
-- ✅ @PreDestroy - Cleanup hook
-- ✅ @AutoConfiguration - Conditional beans
+
+- @Injectable - General purpose components
+- @Repository - Data access with TypeORM integration
+- @Autowired - Property injection by type
+- @InjectRepository - TypeORM repository injection
+- @Inject - Token-based injection
+- @Value - Environment variable injection
+- @Qualifier - Bean qualifier
+- @PostConstruct - Lifecycle hook
+- @PreDestroy - Cleanup hook
+- @AutoConfiguration - Conditional beans
 
 ---
 
@@ -97,12 +110,14 @@ export class UserRepository {
 ### DI Container Enhancements
 
 1. **Circular Dependency Detection**
+
    ```typescript
    private constructing: Set<any> = new Set();
    // Detects and throws error for circular deps
    ```
 
 2. **Prototype Chain Traversal**
+
    ```typescript
    private getAllPropertyKeys(obj: any): string[] {
      // Walks entire prototype chain to find all decorated properties
@@ -110,6 +125,7 @@ export class UserRepository {
    ```
 
 3. **TypeORM Repository Resolution**
+
    ```typescript
    private resolveRepository(entity: any): any {
      const dataSource = TypeORMModule.getDataSource();
@@ -124,7 +140,7 @@ export class UserRepository {
 
 5. **Post-Construction Hooks**
    ```typescript
-   if (typeof instance.onInit === 'function') {
+   if (typeof instance.onInit === "function") {
      instance.onInit();
    }
    ```
@@ -134,12 +150,14 @@ export class UserRepository {
 ## New Decorators Added
 
 ### @InjectRepository
+
 ```typescript
 @InjectRepository(User)
 private userRepo!: Repository<User>;
 ```
 
 ### @Optional
+
 ```typescript
 @Optional()
 @Autowired()
@@ -147,6 +165,7 @@ private cache?: CacheService;  // Won't throw if not found
 ```
 
 ### @Lazy
+
 ```typescript
 @Lazy()
 @Autowired()
@@ -154,6 +173,7 @@ private heavyService!: HeavyService;  // Created on first access
 ```
 
 ### @PostConstruct
+
 ```typescript
 @PostConstruct()
 init() {
@@ -162,6 +182,7 @@ init() {
 ```
 
 ### @PreDestroy
+
 ```typescript
 @PreDestroy()
 cleanup() {
@@ -174,21 +195,23 @@ cleanup() {
 ## Testing Infrastructure
 
 ### Test Runner Features
-- ✅ Automatic test file discovery
-- ✅ TypeScript support (ts-node)
-- ✅ Watch mode
-- ✅ Detailed error reporting
-- ✅ Test isolation (fresh DI container per test)
+
+- Automatic test file discovery
+- TypeScript support (ts-node)
+- Watch mode
+- Detailed error reporting
+- Test isolation (fresh DI container per test)
 
 ### Test API
+
 ```typescript
 describe('UserService', () => {
   let service: UserService;
-  
+
   beforeEach(() => {
     // Setup
   });
-  
+
   it('should create user', async () => {
     const user = await service.createUser({...});
     expect(user.name).toBe('Test');
@@ -197,6 +220,7 @@ describe('UserService', () => {
 ```
 
 ### Assertions
+
 - `toBe()` - Strict equality
 - `toEqual()` - Deep equality
 - `toBeTruthy()` / `toBeFalsy()`
@@ -212,19 +236,26 @@ describe('UserService', () => {
 ## Complete Example
 
 ```typescript
-import 'reflect-metadata';
-import { 
-  Controller, Service, Repository, 
-  Get, Post, Body, Param,
-  Autowired, InjectRepository, Value 
-} from 'fragment-ts';
+import "reflect-metadata";
+import {
+  Controller,
+  Service,
+  Repository,
+  Get,
+  Post,
+  Body,
+  Param,
+  Autowired,
+  InjectRepository,
+  Value,
+} from "fragment-ts";
 
 // Entity
 @Entity()
 class User {
   @PrimaryGeneratedColumn()
   id!: number;
-  
+
   @Column()
   name!: string;
 }
@@ -234,7 +265,7 @@ class User {
 class UserRepository {
   @InjectRepository(User)
   private repo!: Repository<User>;
-  
+
   async findAll() {
     return this.repo.find();
   }
@@ -245,22 +276,22 @@ class UserRepository {
 class UserService {
   @Autowired()
   private userRepository!: UserRepository;
-  
-  @Value('${MAX_USERS:100}')
+
+  @Value("${MAX_USERS:100}")
   private maxUsers!: number;
-  
+
   async getUsers() {
     return this.userRepository.findAll();
   }
 }
 
 // Controller with service
-@Controller('/api/users')
+@Controller("/api/users")
 class UserController {
   @Autowired()
   private userService!: UserService;
-  
-  @Get('/')
+
+  @Get("/")
   async getAll() {
     return this.userService.getUsers();
   }
@@ -272,24 +303,27 @@ class UserController {
 ## Migration Guide
 
 ### Before (Broken)
+
 ```typescript
 @Service()
 class MyService {
   @Autowired()
-  private repo: MyRepo;  // ❌ undefined
+  private repo: MyRepo; // ❌ undefined
 }
 ```
 
 ### After (Fixed)
+
 ```typescript
 @Service()
 class MyService {
   @Autowired()
-  private repo!: MyRepo;  // ✅ Auto-injected (note the !)
+  private repo!: MyRepo; // Auto-injected (note the !)
 }
 ```
 
 ### Key Changes Required:
+
 1. Add `!` for definite assignment: `private repo!: MyRepo`
 2. Ensure `emitDecoratorMetadata: true` in tsconfig.json
 3. Import `reflect-metadata` at app entry point
@@ -303,25 +337,25 @@ class MyService {
 fragment-ts/
 ├── src/
 │   ├── cli/
-│   │   ├── cli.ts                    # ✅ Updated with test command
+│   │   ├── cli.ts                    # Updated with test command
 │   │   └── commands/
-│   │       ├── test.command.ts       # ✅ NEW
+│   │       ├── test.command.ts       # NEW
 │   │       ├── diagnostics.command.ts
 │   │       └── ...
 │   ├── core/
 │   │   ├── container/
-│   │   │   └── di-container.ts       # ✅ FIXED
+│   │   │   └── di-container.ts       # FIXED
 │   │   ├── decorators/
-│   │   │   ├── injectable.decorator.ts  # ✅ FIXED
+│   │   │   ├── injectable.decorator.ts  # FIXED
 │   │   │   ├── repository.decorator.ts
 │   │   │   └── ...
 │   │   └── metadata/
-│   │       └── metadata-keys.ts      # ✅ UPDATED
+│   │       └── metadata-keys.ts      # UPDATED
 │   └── typeorm/
 │       └── typeorm-module.ts
 └── examples/
-    ├── complete-app/                 # ✅ NEW
-    └── tests/                        # ✅ NEW
+    ├── complete-app/                 # NEW
+    └── tests/                        # NEW
 ```
 
 ---
@@ -342,40 +376,52 @@ Before running tests, ensure:
 ## Common Issues & Solutions
 
 ### Issue: "Cannot resolve dependency"
+
 **Solution:** Make sure the dependency is registered:
+
 ```typescript
 container.register(MyService);
 ```
 
 ### Issue: "@Autowired returns undefined"
+
 **Solution:** Add `!` for definite assignment and check tsconfig:
+
 ```typescript
 @Autowired()
 private service!: MyService;  // Note the !
 ```
 
 ### Issue: "TypeORM repository is undefined"
+
 **Solution:** Use @InjectRepository instead of @Autowired:
+
 ```typescript
 @InjectRepository(User)  // Not @Autowired()
 private repo!: Repository<User>;
 ```
 
 ### Issue: "Circular dependency detected"
+
 **Solution:** Refactor to break the cycle:
+
 ```typescript
 // Before (circular)
-class A { constructor(private b: B) {} }
-class B { constructor(private a: A) {} }
+class A {
+  constructor(private b: B) {}
+}
+class B {
+  constructor(private a: A) {}
+}
 
 // After (inject via property)
-class A { 
-  @Autowired() 
-  private b!: B; 
+class A {
+  @Autowired()
+  private b!: B;
 }
-class B { 
-  @Autowired() 
-  private a!: A; 
+class B {
+  @Autowired()
+  private a!: A;
 }
 ```
 
@@ -384,16 +430,19 @@ class B {
 ## Next Steps
 
 1. **Run Tests**
+
    ```bash
    fragment test
    ```
 
 2. **Check All Beans**
+
    ```bash
    fragment beans
    ```
 
 3. **Verify Routes**
+
    ```bash
    fragment routes
    ```
@@ -415,6 +464,6 @@ All requested features are now working:
 ✅ @InjectRepository provides TypeORM repository access  
 ✅ All decorators working (@Controller, @Service, @Repository, @Injectable, etc.)  
 ✅ Comprehensive examples and documentation  
-✅ Complete testing infrastructure  
+✅ Complete testing infrastructure
 
-The framework is now fully functional and ready for development!
+The framework is now fully functional and ready for development!

package/dist/cli/commands/init.command.js

@@ -177,7 +177,7 @@ class InitCommand {
                 "migrate:revert": "fragment migrate:revert",
             },
             dependencies: {
-                "fragment-ts": "^1.0.18",
+                "fragment-ts": "^1.0.20",
                 "reflect-metadata": "^0.1.13",
             },
             devDependencies: {

package/dist/cli/commands/test.command.d.ts

@@ -2,5 +2,6 @@ import { Command } from "commander";
 export declare class TestCommand {
     static register(program: Command): void;
     private static runTests;
+    private static generateRunnerScript;
 }
 //# sourceMappingURL=test.command.d.ts.map

package/dist/cli/commands/test.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test.command.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/test.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;mBAiBlB,QAAQ;CAwQ9B"}
+{"version":3,"file":"test.command.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/test.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;mBAkBlB,QAAQ;IA8I7B,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAwIpC"}