@lenne.tech/cli 0.0.124 → 0.0.125

package/build/templates/claude-skills/lt-cli/examples.md

@@ -0,0 +1,312 @@
+# LT CLI Examples
+
+## Real-World Use Cases
+
+### 1. Blog System
+
+#### Step 1: Create User Module
+```bash
+lt server module --name User --controller Both \
+  --prop-name-0 email --prop-type-0 string \
+  --prop-name-1 username --prop-type-1 string \
+  --prop-name-2 firstName --prop-type-2 string \
+  --prop-name-3 lastName --prop-type-3 string \
+  --prop-name-4 bio --prop-type-4 string --prop-nullable-4 true
+```
+
+#### Step 2: Create Category Module
+```bash
+lt server module --name Category --controller Rest \
+  --prop-name-0 name --prop-type-0 string \
+  --prop-name-1 slug --prop-type-1 string \
+  --prop-name-2 description --prop-type-2 string --prop-nullable-2 true
+```
+
+#### Step 3: Create Post Module with References
+```bash
+lt server module --name Post --controller Both \
+  --prop-name-0 title --prop-type-0 string \
+  --prop-name-1 slug --prop-type-1 string \
+  --prop-name-2 content --prop-type-2 string \
+  --prop-name-3 excerpt --prop-type-3 string --prop-nullable-3 true \
+  --prop-name-4 author --prop-type-4 ObjectId --prop-reference-4 User \
+  --prop-name-5 category --prop-type-5 ObjectId --prop-reference-5 Category \
+  --prop-name-6 tags --prop-type-6 string --prop-array-6 true \
+  --prop-name-7 published --prop-type-7 boolean \
+  --prop-name-8 publishedAt --prop-type-8 Date --prop-nullable-8 true
+```
+
+#### Step 4: Create Comment Module
+```bash
+lt server module --name Comment --controller GraphQL \
+  --prop-name-0 content --prop-type-0 string \
+  --prop-name-1 author --prop-type-1 ObjectId --prop-reference-1 User \
+  --prop-name-2 post --prop-type-2 ObjectId --prop-reference-2 Post \
+  --prop-name-3 approved --prop-type-3 boolean
+```
+
+---
+
+### 2. E-Commerce Platform
+
+#### Step 1: Create Address Object
+```bash
+lt server object --name Address \
+  --prop-name-0 street --prop-type-0 string \
+  --prop-name-1 city --prop-type-1 string \
+  --prop-name-2 state --prop-type-2 string \
+  --prop-name-3 zipCode --prop-type-3 string \
+  --prop-name-4 country --prop-type-4 string
+```
+
+#### Step 2: Create Customer Module
+```bash
+lt server module --name Customer --controller Both \
+  --prop-name-0 email --prop-type-0 string \
+  --prop-name-1 firstName --prop-type-1 string \
+  --prop-name-2 lastName --prop-type-2 string \
+  --prop-name-3 phone --prop-type-3 string --prop-nullable-3 true \
+  --prop-name-4 shippingAddress --prop-schema-4 Address \
+  --prop-name-5 billingAddress --prop-schema-5 Address
+```
+
+#### Step 3: Create Product Module
+```bash
+lt server module --name Product --controller Both \
+  --prop-name-0 name --prop-type-0 string \
+  --prop-name-1 sku --prop-type-1 string \
+  --prop-name-2 description --prop-type-2 string \
+  --prop-name-3 price --prop-type-3 number \
+  --prop-name-4 compareAtPrice --prop-type-4 number --prop-nullable-4 true \
+  --prop-name-5 stock --prop-type-5 number \
+  --prop-name-6 images --prop-type-6 string --prop-array-6 true \
+  --prop-name-7 tags --prop-type-7 string --prop-array-7 true \
+  --prop-name-8 active --prop-type-8 boolean
+```
+
+#### Step 4: Create Order Module
+```bash
+lt server module --name Order --controller Both \
+  --prop-name-0 orderNumber --prop-type-0 string \
+  --prop-name-1 customer --prop-type-1 ObjectId --prop-reference-1 Customer \
+  --prop-name-2 items --prop-type-2 Json \
+  --prop-name-3 subtotal --prop-type-3 number \
+  --prop-name-4 tax --prop-type-4 number \
+  --prop-name-5 total --prop-type-5 number \
+  --prop-name-6 status --prop-enum-6 OrderStatusEnum \
+  --prop-name-7 shippingAddress --prop-schema-7 Address
+```
+
+---
+
+### 3. Project Management System
+
+#### Step 1: Create Team Module
+```bash
+lt server module --name Team --controller Rest \
+  --prop-name-0 name --prop-type-0 string \
+  --prop-name-1 description --prop-type-1 string --prop-nullable-1 true \
+  --prop-name-2 members --prop-type-2 ObjectId --prop-reference-2 User --prop-array-2 true
+```
+
+#### Step 2: Create Project Module
+```bash
+lt server module --name Project --controller Both \
+  --prop-name-0 name --prop-type-0 string \
+  --prop-name-1 description --prop-type-1 string \
+  --prop-name-2 team --prop-type-2 ObjectId --prop-reference-2 Team \
+  --prop-name-3 owner --prop-type-3 ObjectId --prop-reference-3 User \
+  --prop-name-4 startDate --prop-type-4 Date \
+  --prop-name-5 endDate --prop-type-5 Date --prop-nullable-5 true \
+  --prop-name-6 status --prop-enum-6 ProjectStatusEnum
+```
+
+#### Step 3: Create Task Module
+```bash
+lt server module --name Task --controller Both \
+  --prop-name-0 title --prop-type-0 string \
+  --prop-name-1 description --prop-type-1 string --prop-nullable-1 true \
+  --prop-name-2 project --prop-type-2 ObjectId --prop-reference-2 Project \
+  --prop-name-3 assignee --prop-type-3 ObjectId --prop-reference-3 User --prop-nullable-3 true \
+  --prop-name-4 priority --prop-enum-4 PriorityEnum \
+  --prop-name-5 status --prop-enum-5 TaskStatusEnum \
+  --prop-name-6 dueDate --prop-type-6 Date --prop-nullable-6 true \
+  --prop-name-7 estimatedHours --prop-type-7 number --prop-nullable-7 true
+```
+
+---
+
+### 4. Social Media Platform
+
+#### Step 1: Create Profile Object
+```bash
+lt server object --name Profile \
+  --prop-name-0 bio --prop-type-0 string --prop-nullable-0 true \
+  --prop-name-1 avatar --prop-type-1 string --prop-nullable-1 true \
+  --prop-name-2 coverImage --prop-type-2 string --prop-nullable-2 true \
+  --prop-name-3 website --prop-type-3 string --prop-nullable-3 true \
+  --prop-name-4 location --prop-type-4 string --prop-nullable-4 true
+```
+
+#### Step 2: Create User with Profile
+```bash
+lt server module --name User --controller Both \
+  --prop-name-0 username --prop-type-0 string \
+  --prop-name-1 email --prop-type-1 string \
+  --prop-name-2 displayName --prop-type-2 string \
+  --prop-name-3 profile --prop-schema-3 Profile \
+  --prop-name-4 verified --prop-type-4 boolean
+```
+
+#### Step 3: Create Post Module
+```bash
+lt server module --name Post --controller Both \
+  --prop-name-0 content --prop-type-0 string \
+  --prop-name-1 author --prop-type-1 ObjectId --prop-reference-1 User \
+  --prop-name-2 images --prop-type-2 string --prop-array-2 true \
+  --prop-name-3 likes --prop-type-3 ObjectId --prop-reference-3 User --prop-array-3 true \
+  --prop-name-4 hashtags --prop-type-4 string --prop-array-4 true \
+  --prop-name-5 visibility --prop-enum-5 VisibilityEnum
+```
+
+#### Step 4: Add Features to User
+```bash
+lt server addProp --type Module --element User \
+  --prop-name-0 followers --prop-type-0 ObjectId --prop-reference-0 User --prop-array-0 true \
+  --prop-name-1 following --prop-type-1 ObjectId --prop-reference-1 User --prop-array-1 true
+```
+
+---
+
+### 5. Learning Management System
+
+#### Step 1: Create Course Module
+```bash
+lt server module --name Course --controller Both \
+  --prop-name-0 title --prop-type-0 string \
+  --prop-name-1 description --prop-type-1 string \
+  --prop-name-2 instructor --prop-type-2 ObjectId --prop-reference-2 User \
+  --prop-name-3 thumbnail --prop-type-3 string --prop-nullable-3 true \
+  --prop-name-4 price --prop-type-4 number \
+  --prop-name-5 duration --prop-type-5 number \
+  --prop-name-6 level --prop-enum-6 CourseLevelEnum \
+  --prop-name-7 tags --prop-type-7 string --prop-array-7 true \
+  --prop-name-8 published --prop-type-8 boolean
+```
+
+#### Step 2: Create Lesson Module
+```bash
+lt server module --name Lesson --controller Both \
+  --prop-name-0 title --prop-type-0 string \
+  --prop-name-1 content --prop-type-1 string \
+  --prop-name-2 course --prop-type-2 ObjectId --prop-reference-2 Course \
+  --prop-name-3 order --prop-type-3 number \
+  --prop-name-4 duration --prop-type-4 number \
+  --prop-name-5 videoUrl --prop-type-5 string --prop-nullable-5 true \
+  --prop-name-6 resources --prop-type-6 Json --prop-nullable-6 true
+```
+
+#### Step 3: Create Enrollment Module
+```bash
+lt server module --name Enrollment --controller Rest \
+  --prop-name-0 student --prop-type-0 ObjectId --prop-reference-0 User \
+  --prop-name-1 course --prop-type-1 ObjectId --prop-reference-1 Course \
+  --prop-name-2 progress --prop-type-2 number \
+  --prop-name-3 completedLessons --prop-type-3 ObjectId --prop-reference-3 Lesson --prop-array-3 true \
+  --prop-name-4 enrolledAt --prop-type-4 Date \
+  --prop-name-5 completedAt --prop-type-5 Date --prop-nullable-5 true
+```
+
+---
+
+## Adding Properties to Existing Modules
+
+### Add metadata to Product
+```bash
+lt server addProp --type Module --element Product \
+  --prop-name-0 seo --prop-type-0 Json --prop-nullable-0 true \
+  --prop-name-1 dimensions --prop-type-1 Json --prop-nullable-1 true
+```
+
+### Add timestamps to custom module
+```bash
+lt server addProp --type Module --element CustomModule \
+  --prop-name-0 lastModifiedBy --prop-type-0 ObjectId --prop-reference-0 User \
+  --prop-name-1 archivedAt --prop-type-1 Date --prop-nullable-1 true
+```
+
+### Add social features
+```bash
+lt server addProp --type Module --element Post \
+  --prop-name-0 comments --prop-type-0 ObjectId --prop-reference-0 Comment --prop-array-0 true \
+  --prop-name-1 shares --prop-type-1 number \
+  --prop-name-2 views --prop-type-2 number
+```
+
+---
+
+## Common Object Patterns
+
+### Contact Information
+```bash
+lt server object --name ContactInfo \
+  --prop-name-0 email --prop-type-0 string \
+  --prop-name-1 phone --prop-type-1 string --prop-nullable-1 true \
+  --prop-name-2 mobile --prop-type-2 string --prop-nullable-2 true \
+  --prop-name-3 fax --prop-type-3 string --prop-nullable-3 true
+```
+
+### Price Range
+```bash
+lt server object --name PriceRange \
+  --prop-name-0 min --prop-type-0 number \
+  --prop-name-1 max --prop-type-1 number \
+  --prop-name-2 currency --prop-type-2 string
+```
+
+### Geo Location
+```bash
+lt server object --name GeoLocation \
+  --prop-name-0 latitude --prop-type-0 number \
+  --prop-name-1 longitude --prop-type-1 number \
+  --prop-name-2 address --prop-type-2 string --prop-nullable-2 true
+```
+
+### Media File
+```bash
+lt server object --name MediaFile \
+  --prop-name-0 url --prop-type-0 string \
+  --prop-name-1 filename --prop-type-1 string \
+  --prop-name-2 mimeType --prop-type-2 string \
+  --prop-name-3 size --prop-type-3 number
+```
+
+---
+
+## Fullstack Project Initialization
+
+### Angular Project
+```bash
+lt fullstack init \
+  --name MyAngularApp \
+  --frontend angular \
+  --git true \
+  --git-link https://github.com/myorg/my-angular-app.git
+```
+
+### Nuxt Project
+```bash
+lt fullstack init \
+  --name MyNuxtApp \
+  --frontend nuxt \
+  --git true \
+  --git-link https://github.com/myorg/my-nuxt-app.git
+```
+
+### Local Development (No Git)
+```bash
+lt fullstack init \
+  --name LocalDevProject \
+  --frontend angular \
+  --git false
+```

package/build/templates/claude-skills/lt-cli/reference.md

@@ -0,0 +1,332 @@
+# LT CLI Quick Reference
+
+## Command Cheat Sheet
+
+### Module Commands
+```bash
+# Interactive
+lt server module
+lt server m
+
+# Non-interactive
+lt server module --name <Name> --controller <Rest|GraphQL|Both> [props]
+```
+
+### Add Property Commands
+```bash
+# Interactive
+lt server addProp
+lt server ap
+
+# Non-interactive
+lt server addProp --type <Module|Object> --element <name> [props]
+```
+
+### Object Commands
+```bash
+# Interactive
+lt server object
+lt server o
+
+# Non-interactive
+lt server object --name <Name> [props] [--skipLint]
+```
+
+### Fullstack Commands
+```bash
+# Interactive
+lt fullstack init
+lt full init
+
+# Non-interactive
+lt fullstack init --name <Name> --frontend <angular|nuxt> --git <true|false> [--git-link <url>]
+```
+
+---
+
+## Property Flag Reference
+
+| Flag | Description | Example | Required |
+|------|-------------|---------|----------|
+| `--prop-name-X` | Property name | `--prop-name-0 title` | Yes |
+| `--prop-type-X` | Property type | `--prop-type-0 string` | No (default: string) |
+| `--prop-nullable-X` | Is optional | `--prop-nullable-0 true` | No (default: false) |
+| `--prop-array-X` | Is array | `--prop-array-0 true` | No (default: false) |
+| `--prop-enum-X` | Enum reference | `--prop-enum-0 StatusEnum` | No |
+| `--prop-schema-X` | Object reference | `--prop-schema-0 Address` | No |
+| `--prop-reference-X` | ObjectId reference | `--prop-reference-0 User` | Yes (with ObjectId) |
+
+---
+
+## Type Mapping
+
+### Primitive Types
+| Type | TypeScript | MongoDB | Use Case |
+|------|-----------|---------|----------|
+| `string` | `string` | String | Text, names, descriptions |
+| `number` | `number` | Number | Integers, floats, counts |
+| `boolean` | `boolean` | Boolean | Flags, toggles |
+| `Date` | `Date` | Date | Timestamps, dates |
+| `bigint` | `bigint` | Long | Large integers |
+
+### Special Types
+| Type | Model Type | Input Type | Notes |
+|------|-----------|-----------|--------|
+| `ObjectId` | `Reference` | `ReferenceInput` | Requires `--prop-reference-X` |
+| `Json` | `JSON` | `JSON` | Flexible metadata |
+| Custom Object | `<Name>` | `<Name>Input` | Requires `--prop-schema-X` |
+| Custom Enum | `<Name>Enum` | `<Name>Enum` | Requires `--prop-enum-X` |
+
+---
+
+## Decorator Reference
+
+### Model Decorators
+```typescript
+@Prop()                    // MongoDB property
+@UnifiedField()            // GraphQL + REST
+@Restricted(RoleEnum.XXX)  // Access control
+```
+
+### Input Decorators
+```typescript
+@UnifiedField()            // GraphQL + REST
+@IsOptional()              // Validation
+@IsEmail()                 // Email validation
+@IsString()                // String validation
+```
+
+---
+
+## File Structure Reference
+
+### Module Structure
+```
+src/server/modules/<module-name>/
+├── <module-name>.model.ts              # MongoDB schema
+├── <module-name>.service.ts            # Business logic
+├── <module-name>.controller.ts         # REST endpoints
+├── <module-name>.resolver.ts           # GraphQL resolver
+├── <module-name>.module.ts             # NestJS module
+├── inputs/
+│   ├── <module-name>.input.ts          # Update DTO
+│   └── <module-name>-create.input.ts   # Create DTO
+└── outputs/
+    └── find-and-count-<module-name>s-result.output.ts
+```
+
+### Object Structure
+```
+src/server/common/objects/<object-name>/
+├── <object-name>.object.ts             # Object class
+├── <object-name>.input.ts              # Update DTO
+└── <object-name>-create.input.ts       # Create DTO
+```
+
+---
+
+## Common Command Patterns
+
+### Simple Module (No Properties)
+```bash
+lt server module --name Category --controller Rest
+```
+
+### Module with Basic Properties
+```bash
+lt server module --name Product --controller Both \
+  --prop-name-0 name --prop-type-0 string \
+  --prop-name-1 price --prop-type-1 number \
+  --prop-name-2 active --prop-type-2 boolean
+```
+
+### Module with Nullable Property
+```bash
+lt server module --name Post --controller GraphQL \
+  --prop-name-0 title --prop-type-0 string \
+  --prop-name-1 subtitle --prop-type-1 string --prop-nullable-1 true
+```
+
+### Module with Array Property
+```bash
+lt server module --name Article --controller Both \
+  --prop-name-0 title --prop-type-0 string \
+  --prop-name-1 tags --prop-type-1 string --prop-array-1 true
+```
+
+### Module with ObjectId Reference
+```bash
+lt server module --name Comment --controller Rest \
+  --prop-name-0 content --prop-type-0 string \
+  --prop-name-1 author --prop-type-1 ObjectId --prop-reference-1 User
+```
+
+### Module with Schema/Object
+```bash
+lt server module --name Company --controller Both \
+  --prop-name-0 name --prop-type-0 string \
+  --prop-name-1 address --prop-schema-1 Address
+```
+
+### Module with Enum
+```bash
+lt server module --name Order --controller Both \
+  --prop-name-0 orderNumber --prop-type-0 string \
+  --prop-name-1 status --prop-enum-1 OrderStatusEnum
+```
+
+### Module with JSON Metadata
+```bash
+lt server module --name Product --controller Both \
+  --prop-name-0 name --prop-type-0 string \
+  --prop-name-1 metadata --prop-type-1 Json --prop-nullable-1 true
+```
+
+### Complex Module (Multiple Property Types)
+```bash
+lt server module --name Event --controller Both \
+  --prop-name-0 title --prop-type-0 string \
+  --prop-name-1 description --prop-type-1 string --prop-nullable-1 true \
+  --prop-name-2 organizer --prop-type-2 ObjectId --prop-reference-2 User \
+  --prop-name-3 attendees --prop-type-3 ObjectId --prop-reference-3 User --prop-array-3 true \
+  --prop-name-4 startDate --prop-type-4 Date \
+  --prop-name-5 endDate --prop-type-5 Date --prop-nullable-5 true \
+  --prop-name-6 location --prop-schema-6 Location \
+  --prop-name-7 status --prop-enum-7 EventStatusEnum \
+  --prop-name-8 tags --prop-type-8 string --prop-array-8 true \
+  --prop-name-9 metadata --prop-type-9 Json --prop-nullable-9 true
+```
+
+---
+
+## Troubleshooting Guide
+
+### Error: Cannot read properties of undefined (reading 'getChildIndex')
+**Cause**: Input files have no existing properties (fixed in latest version)
+**Solution**: Update to latest CLI version or ensure files have at least one property
+
+### Error: Module directory already exists
+**Cause**: Trying to create a module that already exists
+**Solution**: Use `lt server addProp` instead
+
+### Error: No src directory found
+**Cause**: Running command outside of project directory
+**Solution**: Navigate to project directory (anywhere inside works)
+
+### TypeScript Errors: Cannot find name 'Reference'
+**Cause**: Missing imports for referenced modules
+**Solution**: Manually add imports:
+```typescript
+import { Reference } from '@lenne.tech/nest-server';
+import { User } from '../../user/user.model';
+```
+
+### Property Index Mismatch
+**Cause**: Using different indices for same property
+**Wrong**:
+```bash
+--prop-name-1 company --prop-type-0 string
+```
+**Correct**:
+```bash
+--prop-name-1 company --prop-type-1 string
+```
+
+### Boolean Value Errors
+**Wrong**: `--prop-nullable-0 True` or `--prop-nullable-0 TRUE`
+**Correct**: `--prop-nullable-0 true` (lowercase)
+
+---
+
+## Best Practices Checklist
+
+- [ ] Plan data model before generating
+- [ ] Create objects for reusable structures first
+- [ ] Use meaningful, descriptive names
+- [ ] Create referenced modules before referencing them
+- [ ] Start with one API type (Rest or GraphQL)
+- [ ] Mark only truly optional fields as nullable
+- [ ] Use arrays for collections
+- [ ] Use JSON for flexible/extensible data
+- [ ] Create enums before using them
+- [ ] Run lint after generation
+- [ ] Test incrementally
+- [ ] Commit after successful generation
+- [ ] Review generated code before modifying
+- [ ] Add custom business logic in services
+- [ ] Document complex relationships
+
+---
+
+## Naming Conventions
+
+### Modules & Objects
+- **Format**: PascalCase
+- **Examples**: `User`, `BlogPost`, `OrderItem`, `ProductCategory`
+
+### Properties
+- **Format**: camelCase
+- **Examples**: `firstName`, `emailAddress`, `isActive`, `createdAt`
+
+### Enum Names
+- **Format**: PascalCase + "Enum" suffix
+- **Examples**: `UserStatusEnum`, `OrderStatusEnum`, `PriorityEnum`
+
+### File Names
+- **Format**: kebab-case
+- **Examples**: `user.model.ts`, `blog-post.service.ts`, `order-item.input.ts`
+
+---
+
+## Controller Type Decision Guide
+
+### Choose REST when:
+- Building traditional CRUD APIs
+- Simple data fetching needs
+- RESTful conventions are preferred
+- Mobile/web clients expect REST
+
+### Choose GraphQL when:
+- Complex data relationships
+- Frontend needs flexible queries
+- Reducing over-fetching/under-fetching
+- Real-time subscriptions needed
+
+### Choose Both when:
+- Supporting multiple client types
+- Gradual migration from REST to GraphQL
+- Maximum flexibility required
+- Unsure about future requirements
+
+---
+
+## Related Technologies
+
+### Dependencies
+- **NestJS**: Node.js framework
+- **Mongoose**: MongoDB ODM
+- **GraphQL**: Query language
+- **TypeScript**: Type-safe JavaScript
+- **ts-morph**: TypeScript AST manipulation
+
+### Generated Decorators
+- `@Prop()`: Mongoose schema definition
+- `@UnifiedField()`: GraphQL + REST exposure
+- `@Restricted()`: Access control
+- `@IsOptional()`: Validation
+- `@Field()`: GraphQL field
+
+---
+
+## Quick Tips
+
+1. **Use indices consistently**: All flags for one property use same index
+2. **ObjectId always needs reference**: `--prop-reference-X` is required
+3. **Quote special characters**: Wrap values with spaces in quotes
+4. **Lowercase booleans**: Use `true`/`false`, not `True`/`FALSE`
+5. **Run from anywhere**: CLI finds `src/` automatically
+6. **Check before creating**: Use `addProp` for existing modules
+7. **Plan relationships**: Create referenced modules first
+8. **Use objects for reuse**: Don't duplicate structures
+9. **Start simple**: Add complexity incrementally
+10. **Commit often**: Save after each successful generation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lenne.tech/cli",
-  "version": "0.0.124",
+  "version": "0.0.125",
   "description": "lenne.Tech CLI: lt",
   "keywords": [
     "lenne.Tech",