synthra 0.1.0

data/tech_example/NEW_FEATURES.md

@@ -0,0 +1,169 @@
+# New Features Examples Summary
+
+This document provides a quick reference for the new features added to FakeDataDSL.
+
+## 🆕 New Features
+
+### 1. LSP Server (Language Server Protocol)
+**File**: `tech_example/16_lsp_server.rb`
+
+Provides IDE integration with:
+- Go to Definition
+- Real-time Diagnostics
+- Auto-completion
+- Hover Documentation
+
+**Usage**:
+```bash
+fake_data_dsl lsp
+```
+
+**Documentation**: [docs/LSP.md](../docs/LSP.md)
+
+---
+
+### 2. Property-Based Testing
+**File**: `tech_example/17_property_testing.rb`
+
+RSpec integration for verifying properties hold for all generated data.
+
+**Usage**:
+```ruby
+include FakeDataDSL::PropertyTesting
+
+verify_property("User", count: 1000) do |user_data|
+  expect(user_data["email"]).to match(/@/)
+end
+```
+
+**Documentation**: [docs/PROPERTY_TESTING.md](../docs/PROPERTY_TESTING.md)
+
+---
+
+### 3. Enhanced REPL
+**File**: `tech_example/18_enhanced_repl.rb`
+
+Interactive REPL with:
+- Table formatting (`table User`)
+- Step-through debugging (`debug User`)
+- Detailed inspection (`inspect User`)
+
+**Usage**:
+```bash
+fake_data_dsl repl
+```
+
+**Commands**:
+- `table User` - Display record in table format
+- `table User 5` - Display 5 records in table format
+- `debug User` - Step-through debugging
+- `inspect User` - Detailed inspection with statistics
+
+**Documentation**: [docs/ENHANCED_REPL.md](../docs/ENHANCED_REPL.md)
+
+---
+
+### 4. Security Fuzzing (Hostile Mode)
+**File**: `tech_example/19_security_fuzzing.rb`
+
+Generate security attack payloads for testing:
+- SQL Injection
+- XSS (Cross-Site Scripting)
+- Buffer Overflow
+- Unicode Attacks
+- Path Traversal
+- Command Injection
+
+**Usage**:
+```ruby
+schema.generate(mode: :hostile)
+```
+
+**CLI**:
+```bash
+fake_data_dsl generate User --mode hostile
+```
+
+**Documentation**: [docs/SECURITY_TESTING.md](../docs/SECURITY_TESTING.md)
+
+---
+
+## 📚 Running Examples
+
+All examples can be run with:
+
+```bash
+cd tech_example
+bundle exec ruby 16_lsp_server.rb
+bundle exec ruby 17_property_testing.rb
+bundle exec ruby 18_enhanced_repl.rb
+bundle exec ruby 19_security_fuzzing.rb
+```
+
+Or run all at once:
+
+```bash
+for file in 16_*.rb 17_*.rb 18_*.rb 19_*.rb; do
+  echo "Running $file..."
+  bundle exec ruby $file
+  echo ""
+done
+```
+
+---
+
+## 🔗 Related Documentation
+
+- [LSP Integration Guide](../docs/LSP.md)
+- [Property-Based Testing Guide](../docs/PROPERTY_TESTING.md)
+- [Enhanced REPL Guide](../docs/ENHANCED_REPL.md)
+- [Security Testing Guide](../docs/SECURITY_TESTING.md)
+- [Main README](../README.md)
+
+---
+
+## ⚠️ Important Notes
+
+1. **LSP Server**: Requires an IDE that supports LSP (VS Code, Cursor, Neovim, etc.)
+2. **Property Testing**: Requires RSpec to be available
+3. **Hostile Mode**: ⚠️ Generates actual attack payloads - use only in test environments!
+
+---
+
+## 🎯 Quick Start
+
+### Try the Enhanced REPL
+
+```bash
+fake_data_dsl repl
+> load schemas/
+> table User
+> debug User
+> inspect User
+```
+
+### Try Property-Based Testing
+
+```ruby
+require 'fake_data_dsl'
+include FakeDataDSL::PropertyTesting
+
+verify_property("User", count: 100) do |user_data|
+  expect(user_data["email"]).to match(/@/)
+end
+```
+
+### Try Security Fuzzing
+
+```bash
+fake_data_dsl generate User --mode hostile --count 10
+```
+
+---
+
+## 📝 Examples Index
+
+- [16_lsp_server.rb](16_lsp_server.rb) - LSP server setup and usage
+- [17_property_testing.rb](17_property_testing.rb) - Property-based testing examples
+- [18_enhanced_repl.rb](18_enhanced_repl.rb) - Enhanced REPL features
+- [19_security_fuzzing.rb](19_security_fuzzing.rb) - Security testing with hostile mode

data/tech_example/README.md

@@ -0,0 +1,118 @@
+# FakeDataDSL Examples
+
+A comprehensive collection of examples demonstrating FakeDataDSL usage.
+
+## 📁 Example Categories
+
+### Basic Examples
+- [01_basic_usage.rb](01_basic_usage.rb) - Getting started with FakeDataDSL
+- [02_types_demo.rb](02_types_demo.rb) - All built-in types demonstration
+- [03_generation_modes.rb](03_generation_modes.rb) - Random, edge, invalid modes
+- [04_cli_usage.md](04_cli_usage.md) - Command-line interface examples
+
+### Schema Examples
+- [schemas/](schemas/) - Example DSL schema files
+  - [user.dsl](schemas/user.dsl) - User schema
+  - [order.dsl](schemas/order.dsl) - E-commerce order
+  - [api_response.dsl](schemas/api_response.dsl) - API response simulation
+  - [social_media.dsl](schemas/social_media.dsl) - Social platform data
+  - [healthcare.dsl](schemas/healthcare.dsl) - Medical records
+
+### Use Cases
+- [05_database_seeding.rb](05_database_seeding.rb) - Seeding databases
+- [06_api_testing.rb](06_api_testing.rb) - API response testing
+- [07_rspec_integration.rb](07_rspec_integration.rb) - RSpec test fixtures
+- [08_load_testing.rb](08_load_testing.rb) - High-volume generation
+- [09_data_migration.rb](09_data_migration.rb) - Migration testing
+
+### Advanced Examples
+- [10_custom_types.rb](10_custom_types.rb) - Creating custom types
+- [11_custom_functions.rb](11_custom_functions.rb) - Computed fields
+- [12_behaviors.rb](12_behaviors.rb) - Simulating conditions
+- [13_twitter_dm_example.rb](13_twitter_dm_example.rb) - Twitter/X Direct Message API
+- [14_exact_json_structure.rb](14_exact_json_structure.rb) - Matching exact JSON structures
+- [15_streaming.rb](15_streaming.rb) - Memory-efficient generation
+- [16_lsp_server.rb](16_lsp_server.rb) - LSP server for IDE integration ⭐ NEW
+- [17_property_testing.rb](17_property_testing.rb) - Property-based testing with RSpec ⭐ NEW
+- [18_enhanced_repl.rb](18_enhanced_repl.rb) - Enhanced REPL with visual inspection ⭐ NEW
+- [19_security_fuzzing.rb](19_security_fuzzing.rb) - Security testing with hostile mode ⭐ NEW
+
+### Integration Examples
+- [rails/](rails/) - Rails integration examples
+- [rspec/](rspec/) - RSpec testing patterns
+- [sidekiq/](sidekiq/) - Background job testing
+
+---
+
+## 🚀 Running Examples
+
+### Prerequisites
+
+```bash
+# Install the gem
+gem install fake_data_dsl
+
+# Or add to Gemfile
+bundle add fake_data_dsl
+```
+
+### Run Individual Examples
+
+```bash
+cd tech_example
+ruby 01_basic_usage.rb
+```
+
+### Run All Examples
+
+```bash
+for file in *.rb; do
+  echo "Running $file..."
+  ruby $file
+  echo ""
+done
+```
+
+---
+
+## 📋 Quick Start
+
+### 1. Basic Generation
+
+```ruby
+require 'fake_data_dsl'
+
+# Define schema inline
+schema = FakeDataDSL.parse(<<~DSL)
+  User:
+    id: uuid
+    name: name
+    email: email
+DSL
+
+# Generate data
+user = schema.generate
+puts user
+```
+
+### 2. From File
+
+```ruby
+# Load from file
+schema = FakeDataDSL.load('schemas/user.dsl')
+users = schema.generate_many(10)
+```
+
+### 3. With Options
+
+```ruby
+# Reproducible output
+user = schema.generate(seed: 12345)
+
+# Edge cases
+edge_user = schema.generate(mode: :edge)
+
+# Invalid data
+invalid_user = schema.generate(mode: :invalid)
+```
+

data/tech_example/schemas/api_response.dsl

@@ -0,0 +1,123 @@
+# ============================================================================
+# API Response Schemas
+# ============================================================================
+# Schemas for testing API clients with realistic responses.
+# Includes behaviors for simulating real-world conditions.
+# ============================================================================
+
+# Standard API response wrapper
+APIResponse:
+  @latency 50..200ms
+  @failure 2%
+  @simulate_error 500 1%
+  
+  success: boolean(true:95%)
+  request_id: uuid
+  timestamp: now
+  version: enum(v1:80%, v2:20%)
+
+# Paginated list response
+PaginatedResponse:
+  @latency 100..500ms
+  
+  success: boolean(true:98%)
+  page: number(1..100)
+  per_page: enum(10, 25, 50, 100)
+  total_count: number(0..10000)
+  total_pages: number(1..100)
+  has_next: boolean(true:70%)
+  has_previous: boolean(true:50%)
+
+# Error response
+ErrorResponse:
+  success: boolean
+  error_code: enum(BAD_REQUEST, UNAUTHORIZED, FORBIDDEN, NOT_FOUND, RATE_LIMITED, INTERNAL_ERROR)
+  message: text(20..200)
+  details?: text(50..500)
+  request_id: uuid
+  timestamp: now
+
+# Rate limited response
+RateLimitedResponse:
+  @simulate_error 429 100%
+  
+  success: boolean
+  retry_after_seconds: number(1..3600)
+  limit: number(100..10000)
+  remaining: number(0)
+  reset_at: future_date(1d)
+
+# Slow endpoint (database heavy)
+SlowDatabaseQuery:
+  @latency 500..3000ms
+  @failure 5%
+  
+  success: boolean(true:90%)
+  query_time_ms: number(100..2500)
+  rows_affected: number(0..10000)
+  
+# External service call
+ExternalServiceResponse:
+  @latency 200..1000ms
+  @failure 10%
+  @close_connection 2%
+  @simulate_error 503 3%
+  
+  success: boolean(true:85%)
+  service_name: enum(payment_gateway, email_service, analytics, cdn)
+  response_time_ms: number(50..800)
+
+# Webhook payload
+WebhookPayload:
+  @latency 10..50ms
+  
+  event_id: uuid
+  event_type: enum(user.created, user.updated, order.placed, order.shipped, payment.completed)
+  created_at: now
+  retry_count: number(0..5)
+
+# Health check response
+HealthCheck:
+  @latency 5..20ms
+  @failure 1%
+  
+  status: enum(healthy:95%, degraded:4%, unhealthy:1%)
+  version: text(5..10)
+  uptime_seconds: number(0..31536000)
+  checks: enum(database:ok, cache:ok, queue:ok)
+
+# Authentication response
+AuthResponse:
+  @latency 100..300ms
+  @simulate_error 401 5%
+  
+  success: boolean(true:90%)
+  access_token?: text(100..200)
+  refresh_token?: text(100..200)
+  expires_in?: number(300..86400)
+  token_type?: const("Bearer")
+
+# File upload response
+FileUploadResponse:
+  @latency 500..5000ms
+  @failure 3%
+  @simulate_error 413 2%
+  
+  success: boolean(true:92%)
+  file_id?: uuid
+  filename?: text(10..100)
+  size_bytes?: number(1..104857600)
+  mime_type?: enum(image/jpeg, image/png, application/pdf, text/plain)
+  url?: url
+
+# Search response
+SearchResponse:
+  @latency 50..500ms
+  @partial_data 5%
+  
+  success: boolean(true:98%)
+  query: text(1..100)
+  total_results: number(0..100000)
+  took_ms: number(10..400)
+  max_score: number(0.0..1.0)
+

data/tech_example/schemas/ecommerce.dsl

@@ -0,0 +1,121 @@
+# ============================================================================
+# E-commerce Schemas
+# ============================================================================
+# Complete e-commerce data model demonstrating complex relationships.
+# ============================================================================
+
+# Product catalog
+Product:
+  id: uuid(unique: true)
+  sku: text(10)
+  name: text(10..80)
+  description: text(100..500)
+  price_cents: number(100..100000)
+  currency: enum(USD:70%, EUR:20%, GBP:10%)
+  category: enum(electronics:25%, clothing:25%, home:20%, sports:15%, books:15%)
+  brand: company_name
+  in_stock: boolean(true:85%)
+  stock_quantity: number(0..1000)
+  weight_grams: number(50..50000)
+  rating: number(1.0..5.0)
+  review_count: number(0..5000)
+  created_at: past_date(2y)
+  updated_at: past_date(30d)
+
+# Customer account
+Customer:
+  id: uuid(unique: true)
+  email: email(unique: true)
+  first_name: first_name
+  last_name: last_name
+  phone?: phone
+  loyalty_tier: enum(bronze:60%, silver:25%, gold:10%, platinum:5%)
+  total_orders: number(0..100)
+  total_spent_cents: number(0..10000000)
+  created_at: past_date(3y)
+  
+# Shipping address
+Address:
+  id: uuid
+  street_line1: street_address
+  street_line2?: text(5..50)
+  city: city
+  state?: state
+  postal_code: postal_code
+  country: country_code
+  is_default: boolean(false:80%)
+
+# Shopping cart
+Cart:
+  id: uuid
+  session_id: uuid
+  item_count: number(0..20)
+  subtotal_cents: number(0..500000)
+  created_at: past_date(7d)
+  updated_at: past_date(1d)
+  expires_at: future_date(30d)
+
+# Cart item
+CartItem:
+  id: uuid
+  quantity: number(1..10)
+  unit_price_cents: number(100..100000)
+  added_at: past_date(7d)
+
+# Order
+Order:
+  id: uuid(unique: true)
+  order_number: text(12)
+  status: enum(pending:15%, processing:10%, shipped:35%, delivered:35%, cancelled:5%)
+  subtotal_cents: number(1000..500000)
+  shipping_cents: number(0..5000)
+  tax_cents: number(0..50000)
+  discount_cents: number(0..50000)
+  total_cents: number(1000..600000)
+  currency: enum(USD:70%, EUR:20%, GBP:10%)
+  notes?: text(10..200)
+  created_at: past_date(90d)
+  updated_at: past_date(7d)
+  shipped_at?: past_date(60d)
+  delivered_at?: past_date(30d)
+
+# Order line item
+OrderItem:
+  id: uuid
+  quantity: number(1..5)
+  unit_price_cents: number(100..100000)
+  discount_cents: number(0..10000)
+  subtotal_cents: number(100..500000)
+
+# Payment
+Payment:
+  id: uuid
+  method: enum(credit_card:60%, paypal:25%, bank_transfer:10%, crypto:5%)
+  status: enum(pending:10%, completed:80%, failed:5%, refunded:5%)
+  amount_cents: number(1000..600000)
+  currency: enum(USD:70%, EUR:20%, GBP:10%)
+  transaction_id: uuid
+  processed_at: past_date(90d)
+  
+# Review
+Review:
+  id: uuid
+  rating: number(1..5)
+  title?: text(10..100)
+  body: text(50..1000)
+  verified_purchase: boolean(true:75%)
+  helpful_votes: number(0..500)
+  created_at: past_date(1y)
+  
+# Coupon
+Coupon:
+  id: uuid
+  code: text(6..12)
+  discount_type: enum(percentage:60%, fixed:40%)
+  discount_value: number(5..50)
+  min_order_cents: number(0..10000)
+  max_uses: number(1..10000)
+  current_uses: number(0..5000)
+  expires_at: future_date(90d)
+  active: boolean(true:80%)
+

data/tech_example/schemas/twitter_dm.dsl

@@ -0,0 +1,109 @@
+# ============================================================================
+# Twitter/X Direct Message Schema
+# ============================================================================
+# Generates realistic Twitter Direct Message API response data.
+# Uses ONLY built-in FakeDataDSL types - no custom registration needed!
+#
+# Built-in types used:
+#   - snowflake_id      : 19-digit Twitter/Discord style ID
+#   - unix_timestamp_ms : Unix timestamp in milliseconds
+#   - numeric_string_id : 9-19 digit numeric string
+#   - message_text      : Chat message text using Faker
+#   - empty_array       : Always returns []
+#   - social_handle     : Social media username
+#   - hashtag_text      : Hashtag without # prefix
+#   - indices_pair      : [start, end] position pair
+# ============================================================================
+
+# Main Direct Message Event
+DirectMessageEvent:
+  type: const("message_create")
+  id: snowflake_id
+  created_timestamp: unix_timestamp_ms
+  message_create: MessageCreate
+
+# Message Create Object
+MessageCreate:
+  target: MessageTarget
+  sender_id: numeric_string_id
+  message_data: MessageData
+
+# Target Recipient
+MessageTarget:
+  recipient_id: numeric_string_id
+
+# Message Data with Text and Entities
+MessageData:
+  text: message_text
+  entities: MessageEntities
+
+# Entities Object (Twitter-style)
+# Use empty_array for fields that should be []
+MessageEntities:
+  hashtags: empty_array
+  symbols: empty_array
+  user_mentions: empty_array
+  urls: empty_array
+
+# ============================================================================
+# Extended Schemas (with populated entities)
+# ============================================================================
+
+# Full entities with actual content
+FullMessageEntities:
+  hashtags: array(Hashtag, 0..3)
+  symbols: array(Symbol, 0..2)
+  user_mentions: array(UserMention, 0..3)
+  urls: array(UrlEntity, 0..2)
+
+# Hashtag Entity
+Hashtag:
+  text: hashtag_text
+  indices: indices_pair
+
+# Symbol/Cashtag Entity
+Symbol:
+  text: text(3..6)
+  indices: indices_pair
+
+# User Mention Entity
+UserMention:
+  screen_name: social_handle
+  name: name
+  id: numeric_string_id
+  id_str: numeric_string_id
+  indices: indices_pair
+
+# URL Entity
+UrlEntity:
+  url: url
+  expanded_url: url
+  display_url: text(15..40)
+  indices: indices_pair
+
+# ============================================================================
+# Webhook Event Wrapper
+# ============================================================================
+
+WebhookEvent:
+  for_user_id: numeric_string_id
+  direct_message_events: array(DirectMessageEvent, 1..5)
+
+# ============================================================================
+# Alternative: DM with full entities
+# ============================================================================
+
+DirectMessageEventFull:
+  type: const("message_create")
+  id: snowflake_id
+  created_timestamp: unix_timestamp_ms
+  message_create: MessageCreateFull
+
+MessageCreateFull:
+  target: MessageTarget
+  sender_id: numeric_string_id
+  message_data: MessageDataFull
+
+MessageDataFull:
+  text: message_text
+  entities: FullMessageEntities

data/tech_example/schemas/user.dsl

@@ -0,0 +1,36 @@
+# ============================================================================
+# User Schema
+# ============================================================================
+# Comprehensive user schema for testing and development.
+# This schema demonstrates most common patterns in FakeDataDSL.
+# ============================================================================
+
+User:
+  # Primary identifier
+  id: uuid(unique: true, version: 7)
+  
+  # Personal information
+  first_name: first_name
+  last_name: last_name
+  email: email(unique: true)
+  phone?: phone
+  
+  # Profile
+  username: username
+  avatar?: url
+  bio?: text(50..500)
+  
+  # Account settings
+  role: enum(user:80%, admin:15%, superadmin:5%)
+  status: enum(active:85%, inactive:10%, suspended:5%)
+  verified: boolean(true:60%)
+  
+  # Preferences
+  locale: enum(en:60%, es:15%, fr:10%, de:10%, ja:5%)
+  timezone: time_zone
+  
+  # Metadata
+  created_at: past_date(2y)
+  updated_at: past_date(30d)
+  last_login?: past_date(7d)
+