@slingr/cli 0.0.1

package/src/templates/dataset-generator-script.ts.template

@@ -0,0 +1,140 @@
+/**
+ * Dataset Generator Script for {{PROJECT_NAME}}
+ * 
+ * This script generates synthetic data for the {{DATASOURCE}}-{{DATASET}} dataset.
+ * Generated by Slingr CLI at {{TIMESTAMP}}
+ * 
+ * Usage:
+ *   npm run build
+ *   node dist/scripts/generate-{{DATASOURCE}}-{{DATASET}}.js
+ *
+ * Or via CLI:
+ *   slingr ds {{DATASOURCE}} run-script {{DATASET}}
+ */
+
+import { faker } from '@faker-js/faker';
+import fs from 'fs-extra';
+import path from 'path';
+
+// Import your models (adjust paths as needed)
+{{MODEL_IMPORTS}}
+
+interface GenerationConfig {
+  seed?: number;
+  locale?: string;
+  outputDir?: string;
+}
+
+class {{DATASET_CLASS_NAME}}Generator {
+  private config: GenerationConfig;
+
+  constructor(config: GenerationConfig = {}) {
+    this.config = {
+      seed: config.seed || {{SEED}},
+      locale: config.locale || '{{LOCALE}}',
+      outputDir: config.outputDir || path.join(process.cwd(), 'src', 'datasets', '{{DATASOURCE}}-{{DATASET}}'),
+    };
+
+    // Set faker seed for reproducible results
+    faker.seed(this.config.seed);
+    if (this.config.locale !== 'en') {
+      faker.setLocale(this.config.locale);
+    }
+  }
+
+  /**
+   * Generate all datasets
+   */
+  async generateAll(): Promise<void> {
+    console.log('🎯 Starting dataset generation...');
+    
+    // Ensure output directory exists
+    await fs.ensureDir(this.config.outputDir!);
+
+    {{GENERATION_METHODS}}
+
+    console.log('🎉 Dataset generation completed!');
+    console.log(`📁 Output directory: ${this.config.outputDir}`);
+    console.log('\n💡 To load this dataset, run:');
+    console.log(`   slingr ds {{DATASOURCE}} load {{DATASET}}`);
+  }
+
+  {{INDIVIDUAL_GENERATORS}}
+
+  /**
+   * Save records to JSONL file
+   */
+  private async saveToFile<T>(records: T[], fileName: string): Promise<void> {
+    const filePath = path.join(this.config.outputDir!, `${fileName}.jsonl`);
+    const jsonlContent = records.map(record => JSON.stringify(record)).join('\n');
+    
+    await fs.writeFile(filePath, jsonlContent, 'utf-8');
+    console.log(`💾 Saved ${records.length} records to ${fileName}.jsonl`);
+  }
+
+  /**
+   * Utility method to generate realistic data based on field hints
+   */
+  private generateByFieldName(fieldName: string, type: string): any {
+    const name = fieldName.toLowerCase();
+    
+    switch (type.toLowerCase()) {
+      case 'email':
+        return faker.internet.email();
+      
+      case 'text':
+        if (name.includes('name')) {
+          if (name.includes('first')) return faker.person.firstName();
+          if (name.includes('last')) return faker.person.lastName();
+          if (name.includes('company')) return faker.company.name();
+          return faker.person.fullName();
+        }
+        if (name.includes('phone')) return faker.phone.number();
+        if (name.includes('address')) return faker.location.streetAddress();
+        if (name.includes('city')) return faker.location.city();
+        if (name.includes('country')) return faker.location.country();
+        if (name.includes('description')) return faker.lorem.paragraph();
+        return faker.lorem.words(Math.floor(Math.random() * 3) + 1);
+      
+      case 'integer':
+        if (name.includes('age')) return faker.number.int({ min: 1, max: 120 });
+        return faker.number.int({ min: 1, max: 1000 });
+      
+      case 'float':
+      case 'decimal':
+        return faker.number.float({ min: 0, max: 1000, precision: 0.01 });
+      
+      case 'boolean':
+        return faker.datatype.boolean();
+      
+      case 'date':
+        return faker.date.past().toISOString();
+      
+      case 'uuid':
+        return faker.string.uuid();
+      
+      case 'html':
+        return `<p>${faker.lorem.sentence()}</p>`;
+      
+      default:
+        return faker.lorem.word();
+    }
+  }
+}
+
+// Main execution
+if (require.main === module) {
+  const generator = new {{DATASET_CLASS_NAME}}Generator();
+  
+  generator.generateAll()
+    .then(() => {
+      console.log('✅ Script completed successfully');
+      process.exit(0);
+    })
+    .catch((error) => {
+      console.error('❌ Script failed:', error);
+      process.exit(1);
+    });
+}
+
+export { {{DATASET_CLASS_NAME}}Generator };

package/src/templates/datasets/mysql-default/Address.jsonl.template

@@ -0,0 +1,4 @@
+{"id": "69bda24e-2893-4950-a4ef-190388878123", "street": "123 Main Street", "zipCode": "10001", "country": "United States"}
+{"street": "456 Oak Avenue", "zipCode": "90210", "country": "Portugal"}
+{"street": "789 Pine Boulevard", "zipCode": "60601", "country": "Norway"}
+{"street": "321 Elm Drive", "zipCode": "30309", "country": "Zimbabwe"}

package/src/templates/datasets/mysql-default/App.jsonl.template

@@ -0,0 +1,5 @@
+{"name": "SlingrApp", "version": "01.00.01", "description": "A comprehensive application framework for building modern web applications", "ownerCompany": {"id":"69bda24e-2893-4950-a4ef-190388878401"}}
+{"name": "TestApp.Beta", "version": "00.05.12", "description": "A testing application used for quality assurance and validation purposes", "ownerCompany": {"id":"69bda24e-2893-4950-a4ef-190388878402"}}
+{"name": "ProductionApp", "version": "02.15.03", "description": "The main production application serving thousands of users daily", "ownerCompany": {"id":"69bda24e-2893-4950-a4ef-190388878401"}}
+{"name": "Analytics.Dashboard", "version": "01.08.07", "description": "A powerful analytics dashboard for monitoring application metrics and performance", "ownerCompany": {"id":"69bda24e-2893-4950-a4ef-190388878401"}}
+{"name": "AdminPanel", "version": "03.02.11", "description": "Administrative panel for managing users, permissions, and system configurations", "ownerCompany": {"id":"69bda24e-2893-4950-a4ef-190388878402"}}

package/src/templates/datasets/mysql-default/Company.jsonl.template

@@ -0,0 +1,4 @@
+{"name": "AdminTech Systems", "ceo": {"firstName": "Sarah", "lastName": "Davis", "email": "sarah.davis@admintech.com", "age": 42, "phoneNumber": "+1222333444", "additionalInfo": "<p>CEO and Systems Administrator</p>", "isActive": true}}
+{"id":"69bda24e-2893-4950-a4ef-190388878401", "name": "TechCorp Solutions", "ceo": {"firstName": "Robert", "lastName": "Johnson", "email": "robert.johnson@example.com", "age": 45, "phoneNumber": "+1987654321", "additionalInfo": "<p>CEO and Founder</p>", "isActive": true}}
+{"id":"69bda24e-2893-4950-a4ef-190388878402", "name": "DataFlow Analytics", "ceo": {"firstName": "Michael", "lastName": "Chen", "email": "michael.chen@dataflow.com", "age": 38, "phoneNumber": "+1333444555", "additionalInfo": "<p>CEO and Data Architect</p>", "isActive": true}}
+{"name": "MainStreet Enterprises", "ceo": {"firstName": "David", "lastName": "Wilson", "email": "david.wilson@mainstreet.com", "age": 48, "phoneNumber": "+1555987654", "additionalInfo": "<p>CEO and Founder of MainStreet Enterprises</p>", "isActive": true}, "address": {"street": "Calle Falsa 216", "zipCode": "28080", "country": "Spain"}}

package/src/templates/datasets/mysql-default/Person.jsonl.template

@@ -0,0 +1,3 @@
+{"firstName": "John", "lastName": "Doe", "email": "john.doe@example.com", "age": 25, "phoneNumber": "+1234567890", "additionalInfo": "<p>Senior Developer</p>", "isActive": true}
+{"firstName": "Jane", "lastName": "Smith", "email": "jane.smith@example.com", "age": 16, "parentEmail": "parent.smith@example.com", "additionalInfo": "<p>Student</p>", "isActive": true}
+{"firstName": "Alice", "lastName": "Johnson", "email": "alice.johnson@mainstreet.com", "age": 32, "phoneNumber": "+1555123456", "additionalInfo": "<p>Business Owner and Entrepreneur</p>", "isActive": true, "address": {"street": "21 Mulberry Street", "zipCode": "10001", "country": "United States"}}

package/src/templates/datasets/postgres-default/Address.jsonl.template

@@ -0,0 +1,4 @@
+{"id": "69bda24e-2893-4950-a4ef-190388878123", "street": "123 Main Street", "zipCode": "10001", "country": "United States"}
+{"street": "456 Oak Avenue", "zipCode": "90210", "country": "Portugal"}
+{"street": "789 Pine Boulevard", "zipCode": "60601", "country": "Norway"}
+{"street": "321 Elm Drive", "zipCode": "30309", "country": "Zimbabwe"}

package/src/templates/datasets/postgres-default/App.jsonl.template

@@ -0,0 +1,5 @@
+{"name": "SlingrApp", "version": "01.00.01", "description": "A comprehensive application framework for building modern web applications", "ownerCompany": {"id":"69bda24e-2893-4950-a4ef-190388878401"}}
+{"name": "TestApp.Beta", "version": "00.05.12", "description": "A testing application used for quality assurance and validation purposes", "ownerCompany": {"id":"69bda24e-2893-4950-a4ef-190388878402"}}
+{"name": "ProductionApp", "version": "02.15.03", "description": "The main production application serving thousands of users daily", "ownerCompany": {"id":"69bda24e-2893-4950-a4ef-190388878401"}}
+{"name": "Analytics.Dashboard", "version": "01.08.07", "description": "A powerful analytics dashboard for monitoring application metrics and performance", "ownerCompany": {"id":"69bda24e-2893-4950-a4ef-190388878401"}}
+{"name": "AdminPanel", "version": "03.02.11", "description": "Administrative panel for managing users, permissions, and system configurations", "ownerCompany": {"id":"69bda24e-2893-4950-a4ef-190388878402"}}

package/src/templates/datasets/postgres-default/Company.jsonl.template

@@ -0,0 +1,4 @@
+{"name": "AdminTech Systems", "ceo": {"firstName": "Sarah", "lastName": "Davis", "email": "sarah.davis@admintech.com", "age": 42, "phoneNumber": "+1222333444", "additionalInfo": "<p>CEO and Systems Administrator</p>", "isActive": true}}
+{"id":"69bda24e-2893-4950-a4ef-190388878401", "name": "TechCorp Solutions", "ceo": {"firstName": "Robert", "lastName": "Johnson", "email": "robert.johnson@example.com", "age": 45, "phoneNumber": "+1987654321", "additionalInfo": "<p>CEO and Founder</p>", "isActive": true}}
+{"id":"69bda24e-2893-4950-a4ef-190388878402", "name": "DataFlow Analytics", "ceo": {"firstName": "Michael", "lastName": "Chen", "email": "michael.chen@dataflow.com", "age": 38, "phoneNumber": "+1333444555", "additionalInfo": "<p>CEO and Data Architect</p>", "isActive": true}}
+{"name": "MainStreet Enterprises", "ceo": {"firstName": "David", "lastName": "Wilson", "email": "david.wilson@mainstreet.com", "age": 48, "phoneNumber": "+1555987654", "additionalInfo": "<p>CEO and Founder of MainStreet Enterprises</p>", "isActive": true}, "address": {"street": "Calle Falsa 216", "zipCode": "28080", "country": "Spain"}}

package/src/templates/datasets/postgres-default/Person.jsonl.template

@@ -0,0 +1,3 @@
+{"firstName": "John", "lastName": "Doe", "email": "john.doe@example.com", "age": 25, "phoneNumber": "+1234567890", "additionalInfo": "<p>Senior Developer</p>", "isActive": true}
+{"firstName": "Jane", "lastName": "Smith", "email": "jane.smith@example.com", "age": 16, "parentEmail": "parent.smith@example.com", "additionalInfo": "<p>Student</p>", "isActive": true}
+{"firstName": "Alice", "lastName": "Johnson", "email": "alice.johnson@mainstreet.com", "age": 32, "phoneNumber": "+1555123456", "additionalInfo": "<p>Business Owner and Entrepreneur</p>", "isActive": true, "address": {"street": "21 Mulberry Street", "zipCode": "10001", "country": "United States"}}

package/src/templates/docs/app-description.md.template

@@ -0,0 +1,34 @@
+# {{APP_NAME}}
+
+## Overview
+{{DESCRIPTION}}
+
+## Application Type
+{{APP_TYPE}}
+
+## Architecture
+- **Backend**: {{HAS_BACKEND}}
+- **Frontend**: {{HAS_FRONTEND}}
+- **Database**: {{DB_TYPE}}
+
+## Getting Started
+
+1. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+2. Start development:
+   ```bash
+   npm run dev
+   ```
+
+3. Build for production:
+   ```bash
+   npm run build
+   ```
+
+## Development
+- Use TypeScript for all development
+- Follow the established patterns in the `src/data` directory
+- Refer to the GitHub Copilot instructions in `.github/copilot-instructions.md`

package/src/templates/gql/codegen.yml.template

@@ -0,0 +1,25 @@
+# GraphQL Code Generator configuration
+# This file is automatically generated by Slingr CLI
+# You can customize it according to your needs
+
+schema: './generated/gql/schema.graphql'
+documents: './operations.graphql'
+generates:
+  ./generated/gql/sdk.ts:
+    plugins:
+      - 'typescript'
+      - 'typescript-operations'
+      - 'typescript-graphql-request'
+    config:
+      # Generate a SDK that works with graphql-request
+      rawRequest: false
+      # Generate typed document nodes
+      documentMode: 'documentNode'
+      # Use GraphQLClient from graphql-request
+      gqlImport: 'graphql-request#gql'
+      # Add helpful comments
+      addDocumentNodeToSchema: true
+      # Generate scalars as strings by default
+      scalars:
+        DateTime: string
+        Upload: File

package/src/templates/gql/index.ts.template

@@ -0,0 +1,24 @@
+/**
+ * GraphQL SDK - Auto-generated by Slingr CLI
+ * 
+ * This module provides a typed GraphQL SDK for your Slingr application.
+ * Import this module to access type-safe GraphQL operations.
+ */
+
+import { getSdk } from './sdk';
+import { GraphQLClient } from 'graphql-request';
+
+// Default GraphQL client configuration
+const defaultEndpoint = process.env.GRAPHQL_ENDPOINT || 'http://localhost:4000/graphql';
+
+// Create a default client
+const defaultClient = new GraphQLClient(defaultEndpoint);
+
+// Export the SDK with the default client
+const gql = getSdk(defaultClient);
+
+export default gql;
+export * from './sdk';
+
+// Also export a function to create SDK with custom client
+export const createGql = (client: GraphQLClient) => getSdk(client);

package/src/templates/gql/operations.graphql.template

@@ -0,0 +1,30 @@
+# GraphQL Operations for SDK Generation
+# 
+# This file defines the queries, mutations, and subscriptions 
+# that will be available in your generated SDK.
+#
+# IMPORTANT: This is YOUR file - customize it with your own operations!
+# 
+# The SDK generator will create typed functions for each operation defined here.
+# Add your custom queries, mutations, and subscriptions below.
+#
+# Example:
+# query GetUser($id: ID!) {
+#   user(id: $id) {
+#     id
+#     name
+#     email
+#   }
+# }
+#
+# mutation CreateUser($input: CreateUserInput!) {
+#   createUser(input: $input) {
+#     id
+#     name
+#   }
+# }
+
+# Sample query (replace or remove this)
+query TestQuery {
+  test
+}

package/src/templates/package.json.template

@@ -0,0 +1,38 @@
+{
+  "name": "{{APP_NAME}}",
+  "version": "1.0.0",
+  "description": "{{DESCRIPTION}}",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "test": "jest",
+    "test:watch": "jest --watch"
+  },
+  "keywords": [
+    "slingr",
+    "{{APP_KEYWORD}}"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "graphql-request": "^7.3.0",
+    "slingr-framework": "github:slingr-stack/framework"{{DB_DRIVER_DEPENDENCY}}
+  },
+  "devDependencies": {
+    "@graphql-codegen/cli": "^6.0.0",
+    "@graphql-codegen/typescript": "^5.0.2",
+    "@graphql-codegen/typescript-graphql-request": "^6.3.0",
+    "@graphql-codegen/typescript-operations": "^5.0.2",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^24.3.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.5",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.2"
+  },
+  "overrides": {
+    "glob": "^11.0.0",
+    "node-gyp": "^11.0.0"
+  }
+}

package/src/templates/prompt-analysis.md.template

@@ -0,0 +1,111 @@
+# Dataset Quality Analysis: Improve "{{DATASOURCE}}-{{DATASET}}" Synthetic Data
+
+## ⚠️ IMPORTANT: DO NOT MODIFY MODELS
+**Your task is ONLY to improve the dataset generation, NOT to modify the existing model definitions.**
+The models in `src/data/*.ts` are correct and must remain unchanged. Focus exclusively on generating better, more realistic data that fits these models.
+
+## Project Context
+{{PROJECT_DESCRIPTION}}
+
+## Current Dataset Information
+- **Dataset Name**: `{{DATASOURCE}}-{{DATASET}}`
+- **Location**: `src/datasets/{{DATASOURCE}}-{{DATASET}}/`
+- **Datasource**: {{DATASOURCE}}
+- **Generated**: {{TIMESTAMP}}
+- **Models**: {{TOTAL_MODELS}} models with {{TOTAL_RECORDS}} total records
+
+### Generated Files
+{{DATASET_FILES}}
+
+## Data Models (READ-ONLY)
+The following models define the structure that your dataset must follow:
+
+{{MODEL_DESCRIPTIONS}}
+
+## Current Generated Data Preview
+{{DATA_PREVIEW}}
+
+---
+
+## Your Task: Analyze and Improve Dataset Quality
+
+Please analyze the **generated dataset only** (not the models) and help improve the data generation to make it more realistic, coherent, and useful for testing.
+
+### 1. **Data Realism Assessment**
+Analyze the sample data above and identify:
+- Which fields have unrealistic or nonsensical values?
+- Are the generated values appropriate for the field names and types?
+- Do text fields have meaningful content or just random words?
+- Are numeric values (ages, prices, quantities) within realistic ranges?
+- Do email addresses, phone numbers, and other formatted fields look authentic?
+
+### 2. **Data Coherence & Relationships**
+Check for logical consistency:
+- Do related fields make sense together? (e.g., age and parentEmail relationship)
+- Are there dependencies between fields that should be respected?
+- Do composition/reference relationships contain appropriate related data?
+- Are there any contradictory values in the same record?
+
+### 3. **Business Domain Appropriateness**
+Consider the business context:
+- Do the generated values reflect realistic business scenarios?
+- Are the data patterns useful for testing various use cases?
+- Would this data help identify bugs or test edge cases?
+- Are there missing scenarios or data patterns that should be represented?
+
+### 4. **Field-by-Field Generation Improvements**
+For each model and its fields, suggest specific improvements:
+- Which Faker.js methods would generate more appropriate data?
+- Should certain fields use smart generation based on field names?
+- Are there field combinations that need coordinated generation?
+- Should some fields use predefined realistic values instead of random data?
+
+### 5. **Specific Actionable Recommendations**
+Provide concrete suggestions to improve the dataset generation:
+
+#### Example Format:
+```
+Model: Person
+Field: firstName
+Current Issue: Generic random words like "dolor sit"
+Improvement: Use faker.person.firstName() for realistic names
+Expected Result: "John", "María", "Wei", etc.
+
+Field: age + parentEmail
+Current Issue: parentEmail appears randomly regardless of age
+Improvement: Only generate parentEmail when age < 18
+Expected Result: Coherent parent-child relationships
+```
+
+Please provide similar detailed recommendations for EACH field that needs improvement.
+
+### 6. **Sample Improved Records**
+Show 2-3 examples of what improved records should look like for each model, with realistic and coherent data that respects all field constraints and relationships.
+
+---
+
+## Generation Strategy Recommendations
+
+Based on your analysis, suggest:
+1. **Smart Field Mapping**: Which field names should trigger specific Faker methods?
+2. **Conditional Logic**: What field dependencies need to be handled?
+3. **Realistic Ranges**: What are appropriate min/max values for numeric fields?
+4. **Data Patterns**: What mix of typical vs. edge case values would be most useful?
+5. **Relationship Handling**: How to ensure referential integrity and meaningful relationships?
+
+---
+
+## Technical Constraints (DO NOT CHANGE)
+- Models are defined in `src/data/*.ts` and must NOT be modified
+- All generated data must pass the model validations (required, min/max, regex, etc.)
+- Output format is JSONL (one JSON object per line)
+- Generation uses @faker-js/faker library
+
+## Next Steps After Analysis
+Once you provide your recommendations, I will:
+1. Update the data generation logic to implement your suggestions
+2. Regenerate the dataset with improved realistic data
+3. Validate that all data passes model constraints
+4. Load the improved dataset for testing
+
+Please focus on making the data as realistic and useful as possible while respecting all existing model constraints and validations.