@lenne.tech/cli 0.0.124 → 0.0.125

package/build/extensions/parse-properties.js

@@ -0,0 +1,119 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Extend toolbox with parseProperties() helper.
+ */
+exports.default = (toolbox) => {
+    toolbox.parseProperties = (options) => __awaiter(void 0, void 0, void 0, function* () {
+        const { parameters: globalParameters, server: globalServer } = toolbox;
+        const { argProps = Object.keys(globalParameters.options || {}).filter(key => key.startsWith('prop')), objectsToAdd = [], parameters = globalParameters, referencesToAdd = [], server = globalServer, } = options || {};
+        // --- CLI Mode ---
+        if (argProps.length > 0) {
+            const { print } = toolbox;
+            // Count how many prop-name flags exist
+            const propNameFlags = argProps.filter(key => key.startsWith('prop-name'));
+            const hasMultipleProps = propNameFlags.length > 1;
+            // If multiple properties, all must have numeric indices
+            if (hasMultipleProps) {
+                const hasNonIndexed = propNameFlags.some(key => !key.match(/^prop-name-\d+$/));
+                if (hasNonIndexed) {
+                    print.error('When adding multiple properties, all must use numeric indices (e.g., --prop-name-0, --prop-name-1)');
+                    print.info('');
+                    print.info('Example:');
+                    print.info('  lt server addProp --type Module --element User \\');
+                    print.info('    --prop-name-0 email --prop-type-0 string \\');
+                    print.info('    --prop-name-1 age --prop-type-1 number');
+                    throw new Error('Invalid property flags: Multiple properties require numeric indices');
+                }
+            }
+            // Extract index from prop key (e.g., 'prop-name-1' -> 1)
+            const extractIndex = (key, prefix) => {
+                const match = key.match(new RegExp(`^${prefix}-(\\d+)$`));
+                return match ? parseInt(match[1], 10) : -1;
+            };
+            // Build a map of index -> property data
+            const propDataByIndex = new Map();
+            for (const key of argProps) {
+                let index = -1;
+                let field = '';
+                if (key.startsWith('prop-name-')) {
+                    index = extractIndex(key, 'prop-name');
+                    field = 'name';
+                }
+                else if (key.startsWith('prop-type-')) {
+                    index = extractIndex(key, 'prop-type');
+                    field = 'type';
+                }
+                else if (key.startsWith('prop-nullable-')) {
+                    index = extractIndex(key, 'prop-nullable');
+                    field = 'nullable';
+                }
+                else if (key.startsWith('prop-array-')) {
+                    index = extractIndex(key, 'prop-array');
+                    field = 'isArray';
+                }
+                else if (key.startsWith('prop-enum-')) {
+                    index = extractIndex(key, 'prop-enum');
+                    field = 'enumRef';
+                }
+                else if (key.startsWith('prop-schema-')) {
+                    index = extractIndex(key, 'prop-schema');
+                    field = 'schema';
+                }
+                else if (key.startsWith('prop-reference-')) {
+                    index = extractIndex(key, 'prop-reference');
+                    field = 'reference';
+                }
+                if (index >= 0 && field) {
+                    if (!propDataByIndex.has(index)) {
+                        propDataByIndex.set(index, {
+                            enumRef: null,
+                            isArray: false,
+                            name: '',
+                            nullable: false,
+                            reference: null,
+                            schema: null,
+                            type: 'string',
+                        });
+                    }
+                    const propData = propDataByIndex.get(index);
+                    const value = parameters.options[key];
+                    if (field === 'nullable' || field === 'isArray') {
+                        propData[field] = value === 'true';
+                    }
+                    else {
+                        propData[field] = value;
+                    }
+                }
+            }
+            // Convert map to props object
+            const props = {};
+            for (const propData of propDataByIndex.values()) {
+                if (!propData.name) {
+                    continue;
+                }
+                props[propData.name] = propData;
+            }
+            return { objectsToAdd, props, referencesToAdd, refsSet: false, schemaSet: false };
+        }
+        // --- Interactive Mode ---
+        const result = yield server.addProperties({ objectsToAdd, referencesToAdd });
+        return {
+            objectsToAdd: result.objectsToAdd,
+            props: result.props,
+            referencesToAdd: result.referencesToAdd,
+            refsSet: result.refsSet,
+            schemaSet: result.schemaSet,
+        };
+    });
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGFyc2UtcHJvcGVydGllcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9leHRlbnNpb25zL3BhcnNlLXByb3BlcnRpZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7QUFVQTs7R0FFRztBQUNILGtCQUFlLENBQUMsT0FBK0IsRUFBRSxFQUFFO0lBQ2pELE9BQU8sQ0FBQyxlQUFlLEdBQUcsQ0FDeEIsT0FNQyxFQUMyQixFQUFFO1FBQzlCLE1BQU0sRUFBRSxVQUFVLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxFQUFFLFlBQVksRUFBRSxHQUFHLE9BQU8sQ0FBQztRQUN2RSxNQUFNLEVBQ0osUUFBUSxHQUFHLE1BQU0sQ0FBQyxJQUFJLENBQUMsZ0JBQWdCLENBQUMsT0FBTyxJQUFJLEVBQUUsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDLEdBQUcsQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDLENBQUMsRUFDNUYsWUFBWSxHQUFHLEVBQUUsRUFDakIsVUFBVSxHQUFHLGdCQUFnQixFQUM3QixlQUFlLEdBQUcsRUFBRSxFQUNwQixNQUFNLEdBQUcsWUFBWSxHQUN0QixHQUFHLE9BQU8sSUFBSSxFQUFFLENBQUM7UUFDbEIsbUJBQW1CO1FBQ25CLElBQUksUUFBUSxDQUFDLE1BQU0sR0FBRyxDQUFDLEVBQUUsQ0FBQztZQUN4QixNQUFNLEVBQUUsS0FBSyxFQUFFLEdBQUcsT0FBTyxDQUFDO1lBRTFCLHVDQUF1QztZQUN2QyxNQUFNLGFBQWEsR0FBRyxRQUFRLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxDQUFDLFVBQVUsQ0FBQyxXQUFXLENBQUMsQ0FBQyxDQUFDO1lBQzFFLE1BQU0sZ0JBQWdCLEdBQUcsYUFBYSxDQUFDLE1BQU0sR0FBRyxDQUFDLENBQUM7WUFFbEQsd0RBQXdEO1lBQ3hELElBQUksZ0JBQWdCLEVBQUUsQ0FBQztnQkFDckIsTUFBTSxhQUFh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

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

@@ -0,0 +1,341 @@
+---
+name: lt-cli
+description: Expert assistance with lenne.tech CLI for NestJS/TypeScript backend development. Use when creating server modules, objects, or adding properties to NestJS backends. Generates correct lt server commands with proper --prop-name-X syntax. Helps with lt server module, lt server object, lt server addProp, and lt fullstack init commands.
+---
+
+# LT CLI Expert
+
+You are an expert in the lenne.tech CLI tool for NestJS/TypeScript backend development. When this skill is active, help users generate correct LT CLI commands and work efficiently with the framework.
+
+## Available Commands
+
+### 1. Create Server Module
+**Command**: `lt server module` (alias: `lt server m`)
+
+Creates a complete NestJS module with model, service, controller/resolver, and DTOs.
+
+**Non-interactive syntax**:
+```bash
+lt server module --name <ModuleName> --controller <Rest|GraphQL|Both> [property-flags]
+```
+
+**Property flags** (multiple properties with different indices):
+- `--prop-name-X <name>` - Property name (X = 0, 1, 2...)
+- `--prop-type-X <type>` - string, number, boolean, ObjectId, Json, Date, etc.
+- `--prop-nullable-X <true|false>` - Optional property
+- `--prop-array-X <true|false>` - Array type
+- `--prop-enum-X <EnumName>` - Enum reference
+- `--prop-schema-X <SchemaName>` - Object/schema reference
+- `--prop-reference-X <RefName>` - Reference name for ObjectId
+- `--skipLint` - Skip lint prompt
+
+**Example**:
+```bash
+lt server module --name Post --controller GraphQL \
+  --prop-name-0 title --prop-type-0 string \
+  --prop-name-1 content --prop-type-1 string --prop-nullable-1 true \
+  --prop-name-2 author --prop-type-2 ObjectId --prop-reference-2 User \
+  --prop-name-3 tags --prop-type-3 string --prop-array-3 true
+```
+
+### 2. Add Properties to Existing Module/Object
+**Command**: `lt server addProp` (alias: `lt server ap`)
+
+Adds properties to existing modules or objects, updating model and input files.
+
+**Non-interactive syntax**:
+```bash
+lt server addProp --type <Module|Object> --element <name> [property-flags]
+```
+
+**Example**:
+```bash
+lt server addProp --type Module --element User \
+  --prop-name-0 email --prop-type-0 string \
+  --prop-name-1 age --prop-type-1 number --prop-nullable-1 true
+```
+
+### 3. Create Server Object
+**Command**: `lt server object` (alias: `lt server o`)
+
+Creates reusable data structures (objects) for embedding in modules.
+
+**Non-interactive syntax**:
+```bash
+lt server object --name <ObjectName> [property-flags] [--skipLint]
+```
+
+**Example**:
+```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 zipCode --prop-type-2 string
+```
+
+### 4. Initialize Fullstack Workspace
+**Command**: `lt fullstack init` (alias: `lt full init`)
+
+Creates complete fullstack workspace with frontend and backend.
+
+**Non-interactive syntax**:
+```bash
+lt fullstack init --name <WorkspaceName> --frontend <angular|nuxt> --git <true|false> --git-link <GitURL>
+```
+
+**Example**:
+```bash
+lt fullstack init --name MyApp --frontend angular --git true --git-link https://github.com/user/repo.git
+```
+
+## Critical Rules for Command Generation
+
+### 1. Index-Based Property Flags
+Always use numbered indices for property flags:
+```bash
+# CORRECT
+--prop-name-0 title --prop-type-0 string \
+--prop-name-1 content --prop-type-1 string
+
+# WRONG - Don't use sequential arrays
+--prop-name title --prop-type string
+```
+
+### 2. Match Indices Across Flags
+All flags for one property must use the same index:
+```bash
+# CORRECT
+--prop-name-1 company --prop-type-1 string --prop-nullable-1 false
+
+# WRONG - Mixed indices
+--prop-name-1 company --prop-type-0 string --prop-nullable-2 false
+```
+
+### 3. ObjectId References
+Always include `--prop-reference-X` with ObjectId type:
+```bash
+--prop-name-0 author --prop-type-0 ObjectId --prop-reference-0 User
+```
+
+### 4. Schema/Object Properties
+Use `--prop-schema-X` for embedding objects:
+```bash
+--prop-name-0 address --prop-schema-0 Address
+```
+
+### 5. Boolean Values
+Use lowercase string literals:
+```bash
+--prop-nullable-0 true   # CORRECT
+--prop-nullable-0 True   # WRONG
+--prop-nullable-0 TRUE   # WRONG
+```
+
+## Property Types Reference
+
+### Primitive Types
+- `string` - Text values
+- `number` - Numeric values
+- `boolean` - True/false
+- `bigint` - Large integers
+- `Date` - Date/time values
+
+### Special Types
+- `ObjectId` - MongoDB reference (requires `--prop-reference-X`)
+- `Json` - JSON data for flexible metadata
+- Custom objects (requires `--prop-schema-X`)
+- Custom enums (requires `--prop-enum-X`) - **Note: CLI generates the reference, but you must create the enum file manually afterwards**
+
+### Modifiers
+- `--prop-nullable-X true` - Makes property optional
+- `--prop-array-X true` - Makes property an array type
+
+## Common Patterns
+
+### User Authentication
+```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 roles --prop-type-2 string --prop-array-2 true \
+  --prop-name-3 verified --prop-type-3 boolean
+```
+
+### Blog Post with Relationships
+```bash
+lt server module --name Post --controller GraphQL \
+  --prop-name-0 title --prop-type-0 string \
+  --prop-name-1 content --prop-type-1 string \
+  --prop-name-2 author --prop-type-2 ObjectId --prop-reference-2 User \
+  --prop-name-3 tags --prop-type-3 string --prop-array-3 true \
+  --prop-name-4 published --prop-type-4 boolean
+```
+
+### E-commerce Product
+```bash
+lt server module --name Product --controller Both \
+  --prop-name-0 name --prop-type-0 string \
+  --prop-name-1 description --prop-type-1 string --prop-nullable-1 true \
+  --prop-name-2 price --prop-type-2 number \
+  --prop-name-3 stock --prop-type-3 number \
+  --prop-name-4 category --prop-enum-4 ProductCategoryEnum \
+  --prop-name-5 metadata --prop-type-5 Json --prop-nullable-5 true
+```
+
+### Nested Object Pattern
+```bash
+# First create the object
+lt server object --name Address \
+  --prop-name-0 street --prop-type-0 string \
+  --prop-name-1 city --prop-type-1 string \
+  --prop-name-2 country --prop-type-2 string
+
+# Then use it in a module
+lt server addProp --type Module --element User \
+  --prop-name-0 address --prop-schema-0 Address
+```
+
+## Project Structure
+
+The CLI expects this structure:
+```
+src/
+  server/
+    modules/
+      <module-name>/
+        <module-name>.model.ts          # MongoDB schema
+        <module-name>.service.ts        # Business logic
+        <module-name>.controller.ts     # REST controller
+        <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
+    common/
+      objects/
+        <object-name>/
+          <object-name>.object.ts
+          <object-name>.input.ts
+          <object-name>-create.input.ts
+```
+
+## Generated Code Features
+
+### Model Files (.model.ts)
+- MongoDB schema with `@Prop()` decorator
+- `@UnifiedField()` decorator for GraphQL/REST
+- Mongoose schema definition
+- TypeScript typing with proper suffixes
+
+### Input Files (.input.ts / -create.input.ts)
+- `@UnifiedField()` decorator
+- Validation decorators
+- TypeScript typing
+- Generic support for references
+
+### Service Files (.service.ts)
+- CRUD operations
+- Pagination support
+- Reference handling
+- Business logic structure
+
+### Controller/Resolver Files
+- REST endpoints (controller)
+- GraphQL queries/mutations (resolver)
+- Proper authentication guards
+- DTO validation
+
+## Troubleshooting
+
+### Property Index Mismatch
+**Symptom**: Properties not created correctly or values mixed up
+**Cause**: Using wrong indices (e.g., `--prop-name-1` with `--prop-type-0`)
+**Solution**: Ensure all flags for one property use the same index
+
+### ObjectId Without Reference
+**Symptom**: TypeScript errors about missing reference
+**Cause**: Using `ObjectId` type without `--prop-reference-X`
+**Solution**: Always pair ObjectId with reference:
+```bash
+--prop-type-0 ObjectId --prop-reference-0 User
+```
+
+### Module Already Exists
+**Symptom**: Error that module directory exists
+**Solution**: Use `lt server addProp` instead to add to existing modules
+
+### Empty Property Lists
+**Symptom**: "Cannot read properties of undefined"
+**Status**: Fixed in latest version
+**Solution**: Update to latest CLI version
+
+## Best Practices
+
+1. **Plan relationships first**: Sketch entity relationships before generating
+2. **Create objects for reusable structures**: Don't duplicate data structures
+3. **Use meaningful names**: PascalCase for modules/objects, camelCase for properties
+4. **Start with one API type**: Use Rest or GraphQL, add Both later if needed
+5. **Create enum files after generation**: CLI generates enum references, you create the actual enum files manually afterwards in `src/server/common/enums/`
+6. **Mark truly optional fields**: Only use nullable for genuinely optional data
+7. **Use JSON for extensibility**: Metadata and flexible fields work well as JSON
+8. **Run lint after generation**: Always run lint fix for code quality
+9. **Test incrementally**: Generate one module, test, then continue
+10. **Version control**: Commit after successful generation
+
+## Working with This Skill
+
+When helping users:
+
+1. **Clarify requirements**: Ask about API type (REST/GraphQL/Both), relationships, data types
+2. **Suggest architecture**: Recommend objects for shared structures, modules for entities
+3. **Generate complete commands**: Include all necessary flags with correct syntax
+4. **Explain side effects**: Describe what files will be created and where
+5. **Provide next steps**: Suggest related modules, testing, or additional properties
+
+### Example Response Pattern
+
+User: "Create a Task module with title, description, due date, and assignee"
+
+Your response:
+```bash
+# First ensure User module exists, then create Task module
+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 dueDate --prop-type-2 Date --prop-nullable-2 true \
+  --prop-name-3 assignee --prop-type-3 ObjectId --prop-reference-3 User \
+  --prop-name-4 status --prop-enum-4 TaskStatusEnum
+
+# This creates:
+# ✓ Task model with MongoDB schema
+# ✓ Task service with CRUD operations
+# ✓ REST controller and GraphQL resolver
+# ✓ Input DTOs for create/update
+
+# Next steps:
+# 1. Manually create TaskStatusEnum file in src/server/common/enums/task-status.enum.ts
+# 2. Verify User module exists
+# 3. Run lint fix
+# 4. Add custom business logic to TaskService
+```
+
+## Integration Details
+
+- Uses `ts-morph` for AST manipulation
+- Integrates with `@lenne.tech/nest-server` package
+- Generates `@UnifiedField()` decorators for dual REST/GraphQL support
+- Handles `useDefineForClassFields` TypeScript config
+- Automatically adds properties to `.model.ts`, `.input.ts`, and `-create.input.ts`
+- Manages imports and decorators automatically
+
+## Important Notes
+
+- CLI works from anywhere in project directory
+- Automatically finds nearest `src/` directory
+- Properties are added with proper TypeScript typing
+- ObjectId properties become Reference/ReferenceInput in generated code
+- The CLI prompts for lint fix after generation (use `--skipLint` to skip)
+- Manual imports may be needed for references and schemas
+- **Enum files must be created manually**: When using `--prop-enum-X`, the CLI generates the reference in your code, but you must create the actual enum file yourself afterwards in `src/server/common/enums/<enum-name>.enum.ts`