@bleujs/core

!Copy of Copy of Copy of Copy of Copy of Copy of Copy of Untitled Design (1)

.js/core

- Bleu.js is a Rule-based AI framework designed to provide pinpoint solutions to various problems. It's is a JavaScript framework built to tackle the various coding challenges developers face.

$3

- Advanced debugging
- Automates dependency management
- Ensure Code Quality: Tools to ensure the highest code quality
- Generate Eggs: Automatically generate code snippets
- Provides tools to maintain code quality without adding extra complexity
- Real-time optimization suggestions
- Streamlines collaboration
- Support for multiple programming languages
- Manage Dependencies: Handle project dependencies efficiently

$3

Install the bleujs package using pnpm:

``javascript
pnpm add bleujs
`

`javascript
bleujs start
`

or

`javascript
pnpm install bleujs@latest
`

`javascript
pnpm run start
`

Retrieve Package Information

`javascript
pnpm info bleujs
`

`javascript
pnpm list | grep bleujs
`

$3

- core-engine: Contains the main logic for code generation, optimization, and debugging.
- language-plugins: Modules for different programming languages.
- javascript: JavaScript-specific tools.
- python: Python-specific tools.
- collaboration-tools: Tools for code review, issue tracking, and project management.
- dependency-management: Tools for monitoring and managing dependencies.
- code-quality-assurance: Tools for continuous code quality checks and analysis.
- eggs-generator: Tools for generating code snippets and optimization suggestions by HenFarm.js, the framework built by Helloblue.
- docker: Docker configuration files.

$3

Core Engine

- Efficient CPU core utilization through worker (Agent) processes
- Automatic worker restart for high availability
- Dynamic code generation and template management
- Enhanced logging with winston integration
- Comprehensive metrics tracking
- WebSocket connection management
- Request rate limiting
- Health monitoring
- Graceful shutdown handling

Generate a UsersController with Bleu.js

Bleu.js, uses the HenFarm.js framework by Helloblue, Inc. for generating code snippets, referred to as "eggs." It's an integral part of Bleu.js, providing the functionality to automatically generate new code snippets to help improve efficiency and solve coding problems.

After installing Bleu.js via pnpm, you can generate a UsersController dynamically using the Bleu.js API.

Ensure you have a Valid JWT Token

Generate a valid JWT Token

`javascript
openssl rand -base64 32
`

Replace YOUR_JWT_TOKEN with your valid JWT, and test it with this cURL in another terminal

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-users-controller" \
-H "Authorization: Bearer YOUR_VALID_JWT" \
-H "Accept: application/json" \
-d '{
"type": "controller",
"parameters": {
"name": "UsersController",
"route": "/api/users",
"methods": ["GET", "POST", "PUT", "DELETE"],
"security": {
"auth": ["jwt"],
"roles": ["admin", "user"]
}
}
}'
`

$3

A complete set of cURL requests for generating services, models, APIs, event-driven services, and advanced system configurations.

Starting the Server

`javascript
cd core-engine
`

`javascript
pnpm start
`

In another terminal start cURL tests:

$3

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-d '{
"type": "controller",
"parameters": {
"name": "HealthCheckController",
"route": "/api/health/deep",
"methods": ["GET"],
"logic": {
"GET": {
"description": "Performs a deep health check on services",
"implementation": "async function checkHealth() { return { database: 'OK', cache: 'OK', queue: 'OK' }; }"
}
}
}
}'
`

$3

Authentication Service

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-auth-service" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{
"type": "service",
"parameters": {
"name": "AuthenticationService",
"methods": [
"login", "logout", "refreshToken", "validateSession",
"changePassword", "resetPassword", "generateTwoFactorCode",
"verifyTwoFactorCode", "revokeToken", "updateProfile"
],
"security": {
"auth": ["jwt", "oauth2"],
"roles": ["admin", "user"]
},
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"observability": {
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
}
},
"errorHandling": true,
"caching": {
"enabled": true,
"type": "redis",
"expiration": 900
},
"rateLimiting": {
"enabled": true,
"requestsPerMinute": 5000
},
"resilience": {
"circuitBreaker": {
"failureThreshold": 3,
"resetTimeout": 20000
},
"retryPolicy": {
"enabled": true,
"maxRetries": 3,
"backoffStrategy": "exponential"
}
},
"parallelExecution": {
"enabled": true,
"workerThreads": 5
},
"responseFormat": "JSON",
"versioning": "2.0.0"
}
}' | jq '.'
`

Extreme Name Length

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-long-name" \
-d "{
\"type\": \"service\",
\"parameters\": {
\"name\": \"$(printf 'a%.0s' {1..1000})Service\",
\"methods\": [\"method1\"]
}
}" | jq '.'
`

$3

$3

Generate Payment Service with Advanced Features

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-payment-service" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "PaymentService",
"methods": [
"processPayment",
"validateCard",
"calculateFees",
"generateInvoice",
"refundTransaction",
"getTransactionHistory"
],
"logging": true,
"errorHandling": true,
"authentication": "JWT",
"rateLimiting": {
"enabled": true,
"requestsPerMinute": 500
},
"caching": {
"enabled": true,
"type": "redis",
"expiration": 300
},
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
},
"circuitBreaker": {
"enabled": true,
"failureThreshold": 5,
"resetTimeout": 60000
},
"retryPolicy": {
"enabled": true,
"maxAttempts": 3,
"backoffStrategy": "exponential"
},
"observability": {
"logs": "enabled",
"monitoring": "enabled",
"alerts": "enabled"
},
"middleware": [
"validateRequest",
"rateLimit",
"authenticateUser",
"logRequest",
"handleErrors"
],
"responseFormat": "JSON",
"versioning": "1.2.0"
}
}'
`

$3

Payments Controller

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-payments-controller" \
-H "Accept: application/json" \
-d '{
"type": "controller",
"parameters": {
"name": "PaymentsController",
"route": "/api/payments",
"methods": ["GET", "POST", "PUT", "DELETE"],
"security": {
"auth": ["jwt", "apiKey"],
"roles": ["admin", "operator"],
"rateLimit": {
"enabled": true,
"window": "1m",
"maxRequests": 100
},
"cors": {
"enabled": true,
"allowedOrigins": ["*"],
"allowedMethods": ["GET", "POST", "PUT", "DELETE"]
},
"csrfProtection": true,
"inputSanitization": true
},
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"errorHandling": true,
"databaseIntegration": "MongoDB",
"schemaValidation": true,
"caching": {
"enabled": true,
"type": "redis",
"expiration": 300
},
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
},
"retryPolicy": {
"enabled": true,
"maxRetries": 3,
"backoffStrategy": "exponential"
},
"middleware": [
"validateRequest",
"rateLimit",
"authenticateUser",
"logRequest",
"handleErrors"
],
"responseFormat": "JSON",
"versioning": "1.2.0"
}
}'
`

Generate Migration

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-migration" \
-H "Accept: application/json" \
-d '{
"type": "migration",
"parameters": {
"name": "AddPaymentFields",
"database": "postgresql",
"changes": [
{
"type": "addColumn",
"table": "payments",
"column": "status",
"dataType": "VARCHAR(50)",
"default": "pending",
"constraints": ["NOT NULL"]
},
{
"type": "createIndex",
"table": "payments",
"columns": ["status"],
"unique": false
}
],
"rollback": {
"enabled": true,
"steps": [
{
"type": "dropColumn",
"table": "payments",
"column": "status"
},
{
"type": "dropIndex",
"table": "payments",
"columns": ["status"]
}
]
},
"logging": {
"enabled": true,
"level": "info",
"format": "json"
}
}
}'
`

$3

Payment Deployment Service

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-payment-deployment" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "PaymentDeploymentService",
"methods": [
"deployToKubernetes",
"scaleReplicas",
"updateConfig",
"restartService"
],
"deploymentConfig": {
"platform": "kubernetes",
"components": [
"deployment",
"service",
"ingress",
"configmap",
"secrets"
],
"resources": {
"cpu": "500m",
"memory": "512Mi",
"replicas": 3
},
"autoscaling": {
"enabled": true,
"minReplicas": 2,
"maxReplicas": 10,
"cpuThreshold": 80
},
"configmap": {
"enabled": true,
"variables": {
"NODE_ENV": "production",
"LOG_LEVEL": "info"
}
},
"secrets": {
"enabled": true,
"values": {
"DATABASE_URL": "encrypted_value",
"API_KEY": "encrypted_value"
}
},
"ingress": {
"enabled": true,
"host": "api.example.com",
"tls": true
}
},
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"observability": {
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
}
},
"middleware": [
"validateRequest",
"logRequest",
"monitorPerformance"
],
"responseFormat": "JSON",
"versioning": "1.2.0"
}
}'
`

$3

Generate Service Template

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-user-service" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "UserService",
"methods": [
"findAll",
"findById",
"create",
"update",
"delete",
"search"
],
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"errorHandling": {
"enabled": true,
"strategy": "standard"
},
"authentication": {
"enabled": true,
"strategy": "JWT"
},
"rateLimiting": {
"enabled": true,
"requestsPerMinute": 1000
},
"caching": {
"enabled": true,
"type": "redis",
"expiration": 300
},
"databaseIntegration": {
"enabled": true,
"type": "MongoDB",
"schemaValidation": true
},
"middleware": [
"validateRequest",
"rateLimit",
"authenticateUser",
"logRequest",
"handleErrors"
],
"responseFormat": "JSON",
"versioning": "1.2.0"
}
}'
`

$3

Generate Model

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-model" \
-H "Accept: application/json" \
-d '{
"type": "model",
"parameters": {
"name": "OrderModel",
"fields": [
{"name": "id", "type": "UUID", "primaryKey": true, "autoGenerate": true},
{"name": "userId", "type": "UUID", "references": "UserModel"},
{"name": "amount", "type": "DECIMAL", "precision": 10, "scale": 2, "nullable": false},
{"name": "currency", "type": "STRING", "default": "USD", "maxLength": 3},
{"name": "status", "type": "STRING", "default": "pending", "enum": ["pending", "completed", "failed"]},
{"name": "createdAt", "type": "DATETIME", "default": "CURRENT_TIMESTAMP"},
{"name": "updatedAt", "type": "DATETIME", "default": "CURRENT_TIMESTAMP", "onUpdate": "CURRENT_TIMESTAMP"}
],
"indexes": [
{"columns": ["status"], "unique": false},
{"columns": ["userId", "status"], "unique": false}
],
"methods": [
"findByUserId",
"updateStatus",
"calculateTotal",
"deletePayment"
],
"relations": [
{"type": "belongsTo", "target": "UserModel", "foreignKey": "userId"}
],
"logging": true,
"errorHandling": true,
"caching": "redis",
"rateLimiting": {
"enabled": true,
"requestsPerMinute": 200
},
"schemaValidation": true,
"databaseIntegration": "MongoDB",
"versioning": "1.1.0"
}
}'
`

Generate Service Class

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-service" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "UserService",
"methods": [
"findAll",
"findById",
"create",
"update",
"delete",
"validateBeforeSave"
],
"logging": true,
"errorHandling": true,
"authentication": "JWT",
"rateLimiting": {
"enabled": true,
"requestsPerMinute": 500
},
"caching": {
"enabled": true,
"type": "redis",
"expiration": 300
},
"databaseIntegration": "MongoDB",
"schemaValidation": true,
"versioning": "1.1.0",
"middleware": [
"validateRequest",
"rateLimit",
"authenticateUser"
],
"responseFormat": "JSON",
"authorizationRoles": ["admin", "user", "guest"]
}
}'
`

Generate Repository

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-repository" \
-H "Accept: application/json" \
-d '{
"type": "repository",
"parameters": {
"name": "OrderRepository",
"methods": [
"findById",
"findAll",
"findByCategory",
"createBulk",
"updateMany",
"softDelete"
],
"databaseIntegration": "MongoDB",
"caching": {
"enabled": true,
"type": "redis",
"expiration": 300
},
"logging": true,
"errorHandling": true,
"pagination": true,
"schemaValidation": true
}
}'
`

$3

Event Sourcing Pattern

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-event-sourcing" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "EventSourcingEngine",
"methods": [
"appendToEventStream",
"reconstructAggregateState",
"handleEventReplay",
"manageEventStore",
"versionSnapshot"
],
"databaseIntegration": "MongoDB",
"eventPersistence": {
"enabled": true,
"strategy": "eventStore",
"retentionPolicy": "7_days"
},
"distributedTracing": true,
"logging": true,
"errorHandling": true,
"rateLimiting": {
"enabled": true,
"requestsPerMinute": 500
},
"caching": {
"enabled": true,
"type": "redis",
"expiration": 600
},
"versioning": "1.1.0"
}
}'
`

Expected API Response

`javascript
{
"success": true,
"code": "class EventSourcingEngine {...}",
"metadata": {
"requestId": "test-event-sourcing",
"generatedAt": "2025-02-16T11:45:30.123Z",
"duration": "1.54ms",
"engineVersion": "bleu.js v.1.1.0",
"type": "service",
"className": "EventSourcingEngine",
"methodCount": 5,
"nodeVersion": "v20.18.1",
"platform": "darwin"
}
}
`

Controller generation

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-controller" \
-H "Accept: application/json" \
-d '{
"type": "controller",
"parameters": {
"name": "UserController",
"route": "/api/users",
"methods": ["GET", "POST", "PUT", "DELETE"],
"security": {
"auth": ["jwt"],
"roles": ["admin", "user"],
"rateLimit": {
"window": "1m",
"max": 100
},
"csrfProtection": true,
"inputSanitization": true,
"cors": {
"enabled": true,
"allowedOrigins": ["*"],
"allowedMethods": ["GET", "POST", "PUT", "DELETE"]
}
},
"logging": {
"enabled": true,
"level": "info"
},
"errorHandling": true,
"databaseIntegration": "MongoDB",
"schemaValidation": true,
"responseFormat": "JSON",
"middleware": [
"validateRequest",
"rateLimit",
"authenticateUser",
"logRequest",
"handleErrors"
],
"versioning": "1.2.0"
}
}'
`

Model generation

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-model" \
-H "Accept: application/json" \
-d '{
"type": "model",
"parameters": {
"name": "User",
"fields": [
{"name": "id", "type": "UUID", "primaryKey": true, "autoGenerate": true},
{"name": "username", "type": "STRING", "unique": true, "maxLength": 50},
{"name": "email", "type": "STRING", "unique": true, "validate": "email"},
{"name": "password", "type": "STRING", "hashing": "bcrypt"},
{"name": "role", "type": "STRING", "default": "user", "enum": ["user", "admin"]},
{"name": "createdAt", "type": "DATETIME", "default": "CURRENT_TIMESTAMP"},
{"name": "updatedAt", "type": "DATETIME", "default": "CURRENT_TIMESTAMP", "onUpdate": "CURRENT_TIMESTAMP"}
],
"indexes": [
{"columns": ["email"], "unique": true},
{"columns": ["username"], "unique": true}
],
"relations": [
{"type": "hasMany", "target": "Post", "foreignKey": "userId"}
],
"schemaValidation": true,
"encryption": {
"enabled": true,
"fields": ["password"]
},
"logging": true,
"versioning": "1.1.0",
"databaseIntegration": "MongoDB"
}
}'
`

Expected API Response

`javascript
{
"success": true,
"code": "class UserModel {...}",
"metadata": {
"requestId": "test-model",
"generatedAt": "2025-02-16T12:30:45.987Z",
"duration": "1.45ms",
"engineVersion": "bleu.js v.1.1.0",
"type": "model",
"className": "User",
"fieldCount": 7,
"nodeVersion": "v20.18.1",
"platform": "darwin"
}
}
`

Service generation

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-service" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "UserService",
"methods": [
"findAll",
"findById",
"create",
"update",
"delete"
],
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"errorHandling": {
"enabled": true,
"strategy": "global",
"retryPolicy": {
"enabled": true,
"maxRetries": 3,
"backoffStrategy": "exponential"
}
},
"authentication": {
"type": "JWT",
"requiredRoles": ["admin", "user", "guest"]
},
"rateLimiting": {
"enabled": true,
"requestsPerMinute": 1000
},
"caching": {
"enabled": true,
"type": "redis",
"expiration": 600
},
"databaseIntegration": "MongoDB",
"schemaValidation": true,
"observability": {
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
}
},
"circuitBreaker": {
"enabled": true,
"failureThreshold": 5,
"resetTimeout": 60000
},
"versioning": "1.1.0",
"middleware": [
"validateRequest",
"rateLimit",
"authenticateUser",
"logRequest",
"monitorPerformance"
],
"responseFormat": "JSON"
}
}'
`

$3

Controller Generation

HelloController with Advanced Features

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-hello-controller" \
-H "Accept: application/json" \
-d '{
"type": "controller",
"parameters": {
"name": "HelloController",
"route": "/hello",
"methods": ["GET"],
"security": {
"auth": ["none"],
"rateLimiting": {
"enabled": true,
"requestsPerMinute": 500
},
"cors": {
"enabled": true,
"allowedOrigins": ["*"],
"allowedMethods": ["GET"]
}
},
"caching": {
"enabled": true,
"type": "memory",
"expiration": 300
},
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"observability": {
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
}
},
"errorHandling": true,
"responseFormat": "JSON",
"middleware": ["validateRequest", "rateLimit", "monitorPerformance"],
"versioning": "1.2.0"
}
}'
`

$3

Generate Service Class

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-service" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "UserService",
"methods": [
"findAll",
"findOne",
"create",
"update",
"delete",
"validateBeforeSave"
],
"logging": true,
"errorHandling": true,
"caching": "redis",
"rateLimiting": {
"enabled": true,
"requestsPerMinute": 100
}
}
}'
`

UserService with Security & Caching

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-user-service" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "UserService",
"methods": ["findAll", "findById", "create", "update", "delete"],
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"errorHandling": {
"enabled": true,
"strategy": "global",
"retryPolicy": {
"enabled": true,
"maxRetries": 3,
"backoffStrategy": "exponential"
}
},
"authentication": {
"type": "JWT",
"requiredRoles": ["admin", "user"],
"enforceSessionExpiration": true
},
"rateLimiting": {
"enabled": true,
"requestsPerMinute": 1000
},
"caching": {
"enabled": true,
"type": "redis",
"expiration": 600,
"invalidateOnUpdate": true
},
"databaseIntegration": {
"type": "MongoDB",
"connectionPoolSize": 20
},
"schemaValidation": true,
"observability": {
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
}
},
"circuitBreaker": {
"enabled": true,
"failureThreshold": 5,
"resetTimeout": 60000
},
"versioning": "1.2.0",
"middleware": [
"validateRequest",
"rateLimit",
"authenticateUser",
"logRequest",
"monitorPerformance"
],
"responseFormat": "JSON"
}
}'
`

"/hello" with Enhanced Configuration

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-api-hello" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json" \
-d '{
"type": "api",
"parameters": {
"route": "/hello",
"message": "Hello World!",
"security": {
"auth": ["none"],
"rateLimiting": {
"enabled": true,
"requestsPerMinute": 2000
},
"cors": {
"enabled": true,
"allowedOrigins": ["*"],
"allowedMethods": ["GET"]
}
},
"responseFormat": "JSON",
"caching": {
"enabled": true,
"type": "memory",
"expiration": 300
},
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"observability": {
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
}
},
"responseValidation": {
"enabled": true,
"schema": {
"type": "object",
"properties": {
"message": { "type": "string" }
},
"required": ["message"]
}
},
"middleware": [
"validateRequest",
"rateLimit",
"logRequest",
"monitorPerformance"
],
"versioning": "1.2.0"
}
}'
`

Generate Microservice with Advanced Features

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-payment-service" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "PaymentService",
"methods": [
"processPayment",
"validateCard",
"calculateFees",
"generateInvoice",
"refundTransaction",
"getTransactionHistory"
],
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"errorHandling": {
"enabled": true,
"strategy": "global",
"retryPolicy": {
"enabled": true,
"maxAttempts": 3,
"backoffStrategy": "exponential"
}
},
"authentication": {
"type": "JWT",
"requiredRoles": ["admin", "finance"]
},
"rateLimiting": {
"enabled": true,
"requestsPerMinute": 5000
},
"caching": {
"enabled": true,
"type": "redis",
"expiration": 600,
"invalidateOnUpdate": true
},
"databaseIntegration": {
"type": "PostgreSQL",
"connectionPoolSize": 50
},
"schemaValidation": true,
"observability": {
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
}
},
"circuitBreaker": {
"enabled": true,
"failureThreshold": 5,
"resetTimeout": 30000
},
"middleware": [
"validateRequest",
"rateLimit",
"authenticateUser",
"logRequest",
"monitorPerformance"
],
"responseFormat": "JSON",
"versioning": "1.2.0"
}
}'
`

Generate REST API with Authentication

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-rest-api" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json" \
-d '{
"type": "api",
"parameters": {
"route": "/api/payments",
"security": {
"auth": ["jwt", "apiKey"],
"roles": ["admin", "operator"],
"rateLimit": {
"enabled": true,
"window": "1m",
"max": 100
},
"cors": {
"enabled": true,
"allowedOrigins": ["*"],
"allowedMethods": ["GET", "POST", "PUT", "DELETE"]
}
},
"methods": ["GET", "POST", "PUT", "DELETE"],
"validation": {
"enabled": true,
"schema": {
"amount": { "type": "number", "minimum": 0 },
"currency": { "type": "string", "enum": ["USD", "EUR", "GBP"] },
"description": { "type": "string", "maxLength": 255, "optional": true }
}
},
"responseValidation": {
"enabled": true,
"schema": {
"success": { "type": "boolean" },
"message": { "type": "string" },
"data": { "type": "object", "optional": true }
}
},
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"observability": {
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
}
},
"openAPIDocumentation": {
"enabled": true,
"version": "3.0.0",
"title": "Payments API",
"description": "Handles all payment-related operations"
},
"middleware": [
"validateRequest",
"rateLimit",
"authenticateUser",
"logRequest",
"monitorPerformance"
],
"responseFormat": "JSON",
"versioning": "1.2.0"
}
}'
`

Generate Event-Driven Service

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-event-driven" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "NotificationService",
"events": [
"userRegistered",
"orderPlaced",
"paymentProcessed",
"orderShipped"
],
"integrations": [
"kafka",
"redis",
"elasticsearch"
],
"options": {
"retries": {
"enabled": true,
"maxAttempts": 5,
"backoffStrategy": "exponential"
},
"deadLetterQueue": {
"enabled": true,
"retentionPeriod": "7d"
},
"monitoring": {
"enabled": true,
"system": "Prometheus"
},
"schemaValidation": {
"enabled": true,
"schemas": {
"userRegistered": {
"type": "object",
"properties": {
"userId": { "type": "string" },
"email": { "type": "string", "format": "email" }
},
"required": ["userId", "email"]
},
"orderPlaced": {
"type": "object",
"properties": {
"orderId": { "type": "string" },
"totalAmount": { "type": "number", "minimum": 0 }
},
"required": ["orderId", "totalAmount"]
}
}
}
},
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"observability": {
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
}
},
"versioning": "1.2.0",
"middleware": [
"validateEvent",
"logRequest",
"monitorPerformance"
]
}
}'
`

Generate GraphQL API

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-graphql-api" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "UserGraphQLService",
"methods": [
"getUser",
"listUsers",
"searchUsers",
"createUser",
"updateUser",
"deleteUser"
],
"graphqlSchema": {
"types": [
{
"name": "User",
"fields": {
"id": "ID!",
"name": "String!",
"email": "String!"
}
},
{
"name": "Order",
"fields": {
"id": "ID!",
"total": "Float!",
"items": "[String]"
}
}
],
"queries": [
{
"name": "getUser",
"params": { "id": "ID!" },
"returnType": "User"
},
{
"name": "listUsers",
"returnType": "[User]"
},
{
"name": "searchUsers",
"params": { "name": "String!" },
"returnType": "[User]"
}
],
"mutations": [
{
"name": "createUser",
"params": { "name": "String!", "email": "String!" },
"returnType": "User"
},
{
"name": "updateUser",
"params": { "id": "ID!", "name": "String", "email": "String" },
"returnType": "User"
},
{
"name": "deleteUser",
"params": { "id": "ID!" },
"returnType": "Boolean"
}
]
},
"authentication": {
"enabled": true,
"type": "JWT"
},
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"observability": {
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
}
},
"middleware": [
"validateRequest",
"authenticateUser",
"logRequest",
"monitorPerformance"
],
"responseFormat": "GraphQL",
"versioning": "1.2.0"
}
}'
`

Request for Load Testing Service

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-load-test" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "LoadTestingService",
"methods": [
"simulateHighConcurrency",
"testErrorScenarios",
"simulateTimeouts"
],
"loadTestConfig": {
"users": 1000,
"duration": "5m",
"scenarios": [
"highConcurrency",
"errorScenarios",
"timeouts"
],
"metrics": {
"latency": true,
"throughput": true,
"errorRate": true
}
},
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"observability": {
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
}
},
"middleware": [
"logRequest",
"monitorPerformance"
],
"responseFormat": "JSON",
"versioning": "1.2.0"
}
}'
`

Generate Documentation

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-api-docs" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "APIDocumentationService",
"methods": ["generateOpenAPI", "exportSchema", "serveSwaggerUI"],
"openAPIConfig": {
"version": "3.0.0",
"format": "openapi",
"info": {
"title": "Payment API",
"description": "Comprehensive API documentation for Payment Service",
"version": "1.0.0"
},
"servers": [
{ "url": "https://api.example.com/v1", "description": "Production Server" },
{ "url": "http://localhost:3001", "description": "Local Development Server" }
],
"sections": [
"overview",
"authentication",
"endpoints",
"schemas",
"examples"
],
"authentication": {
"enabled": true,
"type": ["JWT", "API Key"]
}
},
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"observability": {
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
}
},
"middleware": [
"validateRequest",
"logRequest",
"monitorPerformance"
],
"responseFormat": "JSON",
"versioning": "1.2.0"
}
}'
`

Generate Deployment Config

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-deployment-config" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "DeploymentConfigurationService",
"methods": ["generateKubernetesDeployment", "configureIngress", "manageSecrets"],
"kubernetesConfig": {
"platform": "kubernetes",
"components": [
"deployment",
"service",
"ingress",
"configmap",
"secrets"
],
"resources": {
"cpu": "500m",
"memory": "512Mi",
"replicas": 3
},
"autoscaling": {
"enabled": true,
"minReplicas": 2,
"maxReplicas": 10,
"cpuThreshold": 80
},
"configmap": {
"enabled": true,
"variables": {
"NODE_ENV": "production",
"LOG_LEVEL": "info"
}
},
"secrets": {
"enabled": true,
"values": {
"DATABASE_URL": "encrypted_value",
"API_KEY": "encrypted_value"
}
},
"ingress": {
"enabled": true,
"host": "api.example.com",
"tls": true
}
},
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"observability": {
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
}
},
"middleware": [
"validateRequest",
"logRequest",
"monitorPerformance"
],
"responseFormat": "JSON",
"versioning": "1.2.0"
}
}'
`

Get Metrics

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-db-model" \
-H "Accept: application/json" \
-d '{
"type": "model",
"parameters": {
"name": "PaymentModel",
"fields": [
{"name": "id", "type": "UUID", "primaryKey": true, "autoGenerate": true},
{"name": "userId", "type": "UUID", "references": "UserModel"},
{"name": "amount", "type": "DECIMAL", "precision": 10, "scale": 2, "nullable": false},
{"name": "currency", "type": "STRING", "default": "USD", "maxLength": 3},
{"name": "status", "type": "STRING", "default": "pending", "enum": ["pending", "completed", "failed"]},
{"name": "createdAt", "type": "DATETIME", "default": "CURRENT_TIMESTAMP"},
{"name": "updatedAt", "type": "DATETIME", "default": "CURRENT_TIMESTAMP", "onUpdate": "CURRENT_TIMESTAMP"}
],
"indexes": [
{"columns": ["status"], "unique": false},
{"columns": ["userId", "status"], "unique": false}
],
"methods": [
"findByUserId",
"updateStatus",
"calculateTotal",
"deletePayment"
],
"relations": [
{"type": "belongsTo", "target": "UserModel", "foreignKey": "userId"}
]
}
}'
`

Generate Service Template

`javascript
curl -X POST http://localhost:3001/api/generate-egg \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-user-service" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "UserService",
"methods": ["findAll", "findById", "create", "update", "delete", "search"],
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"errorHandling": true,
"authentication": "JWT",
"rateLimiting": {
"enabled": true,
"requestsPerMinute": 1000
},
"caching": {
"enabled": true,
"type": "redis",
"expiration": 300
},
"databaseIntegration": "MongoDB",
"schemaValidation": true,
"middleware": [
"validateRequest",
"rateLimit",
"authenticateUser",
"logRequest"
],
"responseFormat": "JSON",
"versioning": "1.2.0"
}
}'
`

API Template

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-users-api" \
-H "Accept: application/json" \
-d '{
"type": "controller",
"parameters": {
"name": "UsersController",
"route": "/api/users",
"methods": ["GET", "POST", "PUT", "DELETE"],
"security": {
"auth": ["jwt"],
"roles": ["admin", "user"],
"rateLimit": {
"window": "1m",
"max": 100
},
"csrfProtection": true,
"inputSanitization": true,
"cors": {
"enabled": true,
"allowedOrigins": ["*"],
"allowedMethods": ["GET", "POST", "PUT", "DELETE"]
}
},
"logging": {
"enabled": true,
"level": "info"
},
"errorHandling": true,
"databaseIntegration": "MongoDB",
"schemaValidation": true,
"responseFormat": "JSON",
"rateLimiting": {
"enabled": true,
"requestsPerMinute": 1000
},
"caching": {
"enabled": true,
"type": "redis",
"expiration": 300
},
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
},
"retryPolicy": {
"enabled": true,
"maxRetries": 3,
"backoffStrategy": "exponential"
},
"middleware": [
"validateRequest",
"rateLimit",
"authenticateUser",
"logRequest",
"handleErrors"
],
"versioning": "1.2.0"
}
}'
`

Test with Complex Parameters

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-order-service" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "OrderService",
"methods": [
"findAll",
"findById",
"create",
"update",
"delete",
"processPayment",
"calculateTotal",
"validateOrder"
],
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"errorHandling": {
"enabled": true,
"logErrors": true,
"errorFormat": "detailed"
},
"authentication": {
"type": "JWT",
"roles": ["admin", "user"]
},
"rateLimiting": {
"enabled": true,
"requestsPerMinute": 2000
},
"caching": {
"enabled": true,
"type": "redis",
"expiration": 300
},
"databaseIntegration": {
"type": "MongoDB",
"collections": ["orders"]
},
"schemaValidation": true,
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
},
"retryPolicy": {
"enabled": true,
"maxRetries": 3,
"backoffStrategy": "exponential"
},
"middleware": [
"validateRequest",
"rateLimit",
"authenticateUser",
"logRequest"
],
"responseFormat": "JSON",
"versioning": "1.1.0"
}
}'
`

$3

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-users-controller" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json" \
-d '{
"type": "controller",
"parameters": {
"name": "UsersController",
"route": "/api/users",
"methods": ["GET", "POST", "PUT", "DELETE"],
"security": {
"auth": ["jwt"],
"roles": ["admin", "user"],
"rateLimit": {
"window": "1m",
"max": 100
},
"csrfProtection": true,
"inputSanitization": true,
"cors": {
"enabled": true,
"allowedOrigins": ["*"],
"allowedMethods": ["GET", "POST", "PUT", "DELETE"]
}
},
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"errorHandling": {
"enabled": true,
"logErrors": true,
"errorFormat": "detailed"
},
"databaseIntegration": {
"type": "MongoDB",
"collections": ["users"]
},
"schemaValidation": true,
"caching": {
"enabled": true,
"type": "redis",
"expiration": 300
},
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
},
"retryPolicy": {
"enabled": true,
"maxRetries": 3,
"backoffStrategy": "exponential"
},
"middleware": [
"validateRequest",
"rateLimit",
"authenticateUser",
"logRequest",
"handleErrors"
],
"responseFormat": "JSON",
"versioning": "1.2.0"
}
}'
`

Microservice Infrastructure

Generate MI Service

`javascript
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: test-microservice" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json" \
-d '{
"type": "service",
"parameters": {
"name": "MicroserviceInfrastructure",
"methods": [
"initializeServiceRegistry",
"configureServiceDiscovery",
"setupCircuitBreaker",
"implementRetryMechanism",
"setupDistributedTracing"
],
"serviceRegistry": {
"enabled": true,
"provider": "Consul",
"ttl": 30
},
"serviceDiscovery": {
"enabled": true,
"strategy": "round-robin"
},
"circuitBreaker": {
"enabled": true,
"failureThreshold": 5,
"resetTimeout": 60000
},
"retryPolicy": {
"enabled": true,
"maxRetries": 3,
"backoffStrategy": "exponential"
},
"tracing": {
"enabled": true,
"system": "OpenTelemetry"
},
"metrics": {
"enabled": true,
"system": "Prometheus"
},
"logging": {
"enabled": true,
"level": "info",
"format": "json"
},
"observability": {
"healthChecks": {
"enabled": true,
"dependencies": ["database", "cache", "queue"]
},
"performanceMonitoring": true
},
"middleware": [
"validateRequest",
"logRequest",
"monitorPerformance"
],
"responseFormat": "JSON",
"versioning": "1.2.0"
}
}'
`

Load Testing

``javascript
for i in {1..100}; do
curl -X POST "http://localhost:3001/api/generate-egg" \
-H "Content-Type: application/json" \
-H "X-Request-ID: load-test-$i" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{
"type": "service",
"parameters": {
"name": "LoadTestService",
"methods": ["simulateTraffic"],
"logging": true,
"errorHandling": true,
"rateLimiting": {
"enabled": true,