synthra 0.1.0

data/tech_example/12_behaviors.rb

@@ -0,0 +1,372 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# ============================================================================
+# FakeDataDSL - Behaviors Examples
+# ============================================================================
+# This file demonstrates behavior simulation features.
+# Run with: cd fake_data_dsl && ruby tech_example/12_behaviors.rb
+# ============================================================================
+
+# Load the local gem
+$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
+require 'fake_data_dsl'
+require 'json'
+require 'benchmark'
+
+puts "=" * 70
+puts "FakeDataDSL Behaviors Examples"
+puts "=" * 70
+puts
+
+# ============================================================================
+# Example 1: Latency Simulation
+# ============================================================================
+puts "1. LATENCY SIMULATION"
+puts "-" * 40
+
+latency_schema = FakeDataDSL.parse(<<~DSL)
+  SlowAPI:
+    @latency 100..300ms
+    
+    id: uuid
+    data: text(50..200)
+    timestamp: now
+DSL
+
+puts "Generating with latency (100-300ms):"
+5.times do |i|
+  time = Benchmark.realtime { latency_schema.generate }
+  puts "  Request #{i + 1}: #{(time * 1000).round}ms"
+end
+puts
+
+# ============================================================================
+# Example 2: Failure Simulation
+# ============================================================================
+puts "2. FAILURE SIMULATION"
+puts "-" * 40
+
+failure_schema = FakeDataDSL.parse(<<~DSL)
+  FlakyService:
+    @failure 30%
+    
+    id: uuid
+    status: enum(success, pending)
+DSL
+
+puts "Attempting 10 generations (30% failure rate):"
+success_count = 0
+failure_count = 0
+
+10.times do |i|
+  begin
+    failure_schema.generate
+    success_count += 1
+    puts "  Attempt #{i + 1}: SUCCESS"
+  rescue FakeDataDSL::Errors::SimulatedFailure
+    failure_count += 1
+    puts "  Attempt #{i + 1}: FAILED (simulated)"
+  end
+end
+puts "Results: #{success_count} successes, #{failure_count} failures"
+puts
+
+# ============================================================================
+# Example 3: Partial Data Simulation
+# ============================================================================
+puts "3. PARTIAL DATA SIMULATION"
+puts "-" * 40
+
+partial_schema = FakeDataDSL.parse(<<~DSL)
+  IncompleteResponse:
+    @partial_data 40%
+    
+    id: uuid
+    name: name
+    email: email
+    phone: phone
+    address: address
+DSL
+
+puts "Generating with partial data (40% field drop rate):"
+5.times do |i|
+  response = partial_schema.generate
+  fields_present = response.keys
+  puts "  Response #{i + 1}: #{fields_present.length} fields present: #{fields_present.join(', ')}"
+end
+puts
+
+# ============================================================================
+# Example 4: Connection Drop Simulation
+# ============================================================================
+puts "4. CONNECTION DROP SIMULATION"
+puts "-" * 40
+
+connection_schema = FakeDataDSL.parse(<<~DSL)
+  UnstableConnection:
+    @close_connection 20%
+    
+    data: text(100..500)
+DSL
+
+puts "Attempting 10 requests (20% connection drop rate):"
+connected = 0
+dropped = 0
+
+10.times do |i|
+  begin
+    connection_schema.generate
+    connected += 1
+    puts "  Request #{i + 1}: Connected"
+  rescue FakeDataDSL::Errors::SimulatedConnectionDrop
+    dropped += 1
+    puts "  Request #{i + 1}: Connection dropped"
+  end
+end
+puts "Results: #{connected} connected, #{dropped} dropped"
+puts
+
+# ============================================================================
+# Example 5: HTTP Error Simulation
+# ============================================================================
+puts "5. HTTP ERROR SIMULATION"
+puts "-" * 40
+
+error_schema = FakeDataDSL.parse(<<~DSL)
+  ErrorProneAPI:
+    @simulate_error 500 20%
+    @simulate_error 503 10%
+    
+    success: boolean(true:90%)
+    data: object
+DSL
+
+puts "Attempting 15 requests (500: 20%, 503: 10%):"
+results = { success: 0, "500" => 0, "503" => 0 }
+
+15.times do |i|
+  begin
+    error_schema.generate
+    results[:success] += 1
+    puts "  Request #{i + 1}: 200 OK"
+  rescue FakeDataDSL::Errors::SimulatedError => e
+    results[e.status_code.to_s] += 1
+    puts "  Request #{i + 1}: #{e.status_code} Error"
+  end
+end
+puts "Results: #{results}"
+puts
+
+# ============================================================================
+# Example 6: Combined Behaviors (Real-World API)
+# ============================================================================
+puts "6. COMBINED BEHAVIORS (Real-World API)"
+puts "-" * 40
+
+realistic_api = FakeDataDSL.parse(<<~DSL)
+  RealisticAPI:
+    @latency 50..500ms
+    @failure 5%
+    @simulate_error 500 2%
+    @simulate_error 503 1%
+    @partial_data 10%
+    
+    request_id: uuid
+    success: boolean(true:95%)
+    data: text(100..500)
+    timestamp: now
+DSL
+
+puts "Simulating 10 API calls:"
+10.times do |i|
+  start_time = Time.now
+  begin
+    response = realistic_api.generate
+    elapsed = ((Time.now - start_time) * 1000).round
+    fields = response.keys.length
+    puts "  Call #{i + 1}: 200 OK (#{elapsed}ms, #{fields} fields)"
+  rescue FakeDataDSL::Errors::SimulatedFailure
+    elapsed = ((Time.now - start_time) * 1000).round
+    puts "  Call #{i + 1}: Service Error (#{elapsed}ms)"
+  rescue FakeDataDSL::Errors::SimulatedError => e
+    elapsed = ((Time.now - start_time) * 1000).round
+    puts "  Call #{i + 1}: HTTP #{e.status_code} (#{elapsed}ms)"
+  end
+end
+puts
+
+# ============================================================================
+# Example 7: Field-Level Behaviors
+# ============================================================================
+puts "7. FIELD-LEVEL BEHAVIORS"
+puts "-" * 40
+
+field_behavior_schema = FakeDataDSL.parse(<<~DSL)
+  UserProfile:
+    id: uuid
+    name: name
+    email: email
+    avatar: url @partial_data 50%
+    bio: text(100..300) @partial_data 30%
+DSL
+
+puts "Generating profiles (avatar 50% missing, bio 30% missing):"
+stats = { avatar: 0, bio: 0 }
+10.times do |i|
+  profile = field_behavior_schema.generate
+  avatar_present = profile.key?('avatar')
+  bio_present = profile.key?('bio')
+  stats[:avatar] += 1 if avatar_present
+  stats[:bio] += 1 if bio_present
+  puts "  Profile #{i + 1}: avatar=#{avatar_present ? '✓' : '✗'}, bio=#{bio_present ? '✓' : '✗'}"
+end
+puts "Present: avatar #{stats[:avatar]}/10, bio #{stats[:bio]}/10"
+puts
+
+# ============================================================================
+# Example 8: Custom Behavior
+# ============================================================================
+puts "8. CUSTOM BEHAVIOR"
+puts "-" * 40
+
+# Register a custom logging behavior
+FakeDataDSL.register_behavior(:log) do |result, _context, value|
+  puts "[LOG] Generated #{result.keys.length} fields"
+  puts "[LOG] Config: #{value.inspect}" if value
+  result
+end
+
+# Note: Custom behaviors need to be added to schema manually or through DSL extension
+# This is a demonstration of the registration API
+
+puts "Custom behavior registered. Usage in DSL:"
+puts <<~DSL
+  Schema:
+    @log true
+    
+    id: uuid
+    name: name
+DSL
+puts
+
+# ============================================================================
+# Example 9: Retry Pattern Testing
+# ============================================================================
+puts "9. RETRY PATTERN TESTING"
+puts "-" * 40
+
+retry_test_schema = FakeDataDSL.parse(<<~DSL)
+  RetryableAPI:
+    @failure 40%
+    
+    data: text(50..100)
+DSL
+
+def fetch_with_retry(schema, max_retries: 3)
+  retries = 0
+  begin
+    schema.generate
+  rescue FakeDataDSL::Errors::SimulatedFailure
+    retries += 1
+    if retries <= max_retries
+      puts "    Retry #{retries}..."
+      sleep(0.1 * retries)  # Exponential backoff simulation
+      retry
+    else
+      raise
+    end
+  end
+end
+
+puts "Testing retry pattern (max 3 retries, 40% failure rate):"
+5.times do |i|
+  puts "  Request #{i + 1}:"
+  begin
+    start = Time.now
+    result = fetch_with_retry(retry_test_schema)
+    elapsed = ((Time.now - start) * 1000).round
+    puts "    SUCCESS after #{elapsed}ms"
+  rescue FakeDataDSL::Errors::SimulatedFailure
+    puts "    FAILED after max retries"
+  end
+end
+puts
+
+# ============================================================================
+# Example 10: Chaos Engineering
+# ============================================================================
+puts "10. CHAOS ENGINEERING SCENARIO"
+puts "-" * 40
+
+chaos_schema = FakeDataDSL.parse(<<~DSL)
+  ChaosAPI:
+    @latency 100..2000ms
+    @failure 15%
+    @close_connection 5%
+    @simulate_error 500 5%
+    @simulate_error 502 3%
+    @simulate_error 503 2%
+    @partial_data 20%
+    
+    transaction_id: uuid
+    amount: number(100..10000)
+    status: enum(pending, completed, failed)
+    timestamp: now
+DSL
+
+puts "Chaos test - 20 requests with aggressive failure modes:"
+results = {
+  success: 0,
+  failure: 0,
+  connection_drop: 0,
+  http_500: 0,
+  http_502: 0,
+  http_503: 0,
+  total_latency: 0
+}
+
+20.times do |i|
+  start = Time.now
+  begin
+    response = chaos_schema.generate
+    elapsed = (Time.now - start) * 1000
+    results[:success] += 1
+    results[:total_latency] += elapsed
+    status = "OK (#{elapsed.round}ms, #{response.keys.length} fields)"
+  rescue FakeDataDSL::Errors::SimulatedFailure
+    results[:failure] += 1
+    status = "FAILURE"
+  rescue FakeDataDSL::Errors::SimulatedConnectionDrop
+    results[:connection_drop] += 1
+    status = "CONNECTION DROP"
+  rescue FakeDataDSL::Errors::SimulatedError => e
+    case e.status_code
+    when 500 then results[:http_500] += 1
+    when 502 then results[:http_502] += 1
+    when 503 then results[:http_503] += 1
+    end
+    status = "HTTP #{e.status_code}"
+  end
+  
+  print "."
+end
+puts
+
+puts "\nChaos Test Results:"
+puts "  Successful: #{results[:success]}"
+puts "  Failures: #{results[:failure]}"
+puts "  Connection drops: #{results[:connection_drop]}"
+puts "  HTTP 500: #{results[:http_500]}"
+puts "  HTTP 502: #{results[:http_502]}"
+puts "  HTTP 503: #{results[:http_503]}"
+if results[:success] > 0
+  avg_latency = results[:total_latency] / results[:success]
+  puts "  Avg latency (success): #{avg_latency.round}ms"
+end
+puts
+
+puts "=" * 70
+puts "Behaviors examples completed!"
+puts "=" * 70
+

data/tech_example/13_twitter_dm_example.rb

@@ -0,0 +1,120 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# ============================================================================
+# FakeDataDSL - Twitter/X Direct Message Webhook Example
+# ============================================================================
+# 100% schema-driven - NO Ruby code needed for data transformation!
+#
+# Features demonstrated:
+#   - shared() - recipient is the SAME for all 10 webhooks (like a real inbox)
+#   - copy() - links sender_id, recipient_id, for_user_id
+#   - map_by_field() - creates dynamic user ID keys
+#   - generate_many() - efficient batch generation
+#
+# Run: cd fake_data_dsl && ruby tech_example/13_twitter_dm_example.rb
+# ============================================================================
+
+$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
+require 'fake_data_dsl'
+require 'json'
+
+puts "=" * 70
+puts "FakeDataDSL - Twitter DM Webhook Generator"
+puts "=" * 70
+puts
+
+# ============================================================================
+# 100% SCHEMA - shared() makes recipient same across all records!
+# ============================================================================
+registry = FakeDataDSL::Registry.new
+registry.load_string(<<~DSL)
+  TwitterDMWebhook:
+    eventName: const("new_twitter_direct_message")
+    eventData: EventData
+
+  EventData:
+    users: map_by_field("id", sender: TwitterUser, recipient: shared(TwitterUser))
+    for_user_id: copy("users.recipient.id")
+    direct_message_events: array(DirectMessageEvent, 1..1)
+
+  DirectMessageEvent:
+    type: const("message_create")
+    id: snowflake_id
+    created_timestamp: unix_timestamp_ms
+    message_create: MessageCreate
+
+  MessageCreate:
+    target: Target
+    sender_id: copy("users.sender.id")
+    message_data: MessageData
+
+  Target:
+    recipient_id: copy("users.recipient.id")
+
+  MessageData:
+    text: message_text
+    entities: Entities
+    WEB_HOOK_RECEIVE_TIME: unix_timestamp_ms
+
+  Entities:
+    hashtags: empty_array
+    symbols: empty_array
+    user_mentions: empty_array
+    urls: empty_array
+
+  TwitterUser:
+    id: snowflake_id
+    created_timestamp: unix_timestamp_ms
+    name: full_name
+    screen_name: social_handle
+    location: city
+    description: text(20..100)
+    url: url
+    protected: boolean
+    verified: boolean
+    followers_count: number(10..1000000)
+    friends_count: number(5..5000)
+    statuses_count: number(10..500000)
+    profile_image_url: url
+    profile_image_url_https: url
+DSL
+
+# ============================================================================
+# Generate 10 Twitter DM Webhooks - recipient is SHARED across all!
+# ============================================================================
+
+puts "Generating 10 Twitter DM Webhook Events..."
+puts "Note: ALL events go to the SAME recipient (shared)!"
+puts "-" * 70
+puts
+
+schema = registry.schema("TwitterDMWebhook")
+
+# ONE LINE - generate_many with shared context!
+webhooks = schema.generate_many(10, registry: registry)
+
+# Show first 3 in detail
+webhooks.first(3).each_with_index do |webhook, i|
+  puts "Event #{i + 1}:"
+  puts JSON.pretty_generate(webhook)
+  puts
+  puts "-" * 70
+  puts
+end
+
+# Verify recipient is shared across all webhooks
+recipient_ids = webhooks.map { |w| w.dig("eventData", "for_user_id") }.uniq
+sender_ids = webhooks.map { |w| w.dig("eventData", "direct_message_events", 0, "message_create", "sender_id") }.uniq
+
+puts "=" * 70
+puts "VERIFICATION:"
+puts "  Unique recipient IDs: #{recipient_ids.length} (should be 1 - SHARED)"
+puts "  Unique sender IDs: #{sender_ids.length} (should be 10 - DIFFERENT)"
+puts "-" * 70
+puts "✓ 100% schema-driven - NO Ruby transformation code!"
+puts "✓ shared() keeps recipient same across all webhooks"
+puts "✓ copy() links sender_id, recipient_id, for_user_id"
+puts "✓ map_by_field() creates dynamic user ID keys"
+puts "✓ generate_many() for efficient batch generation"
+puts "=" * 70