First cut of transtional

Author: seebees

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "test-server/ruby-transitional-server/transitional-ruby-sdk"]
+	path = test-server/ruby-transitional-server/transitional-ruby-sdk
+	url = git@github.com:aws/aws-sdk-ruby-staging.git

test-server/ruby-transitional-server/.bundle/config

@@ -0,0 +1,2 @@
+---
+BUNDLE_PATH: "vendor/bundle"

test-server/ruby-transitional-server/.gitignore

@@ -0,0 +1 @@
+vendor

test-server/ruby-transitional-server/Gemfile

@@ -0,0 +1,15 @@
+source 'https://rubygems.org'
+
+ruby '~> 3.0'
+
+gem 'sinatra', '~> 3.0'
+gem 'puma', '~> 6.0'
+gem 'aws-sdk-s3', path: 'transitional-ruby-sdk/gems/aws-sdk-s3'
+gem 'aws-sdk-kms', path: 'transitional-ruby-sdk/gems/aws-sdk-kms'
+gem 'json', '~> 2.0'
+gem 'concurrent-ruby', '~> 1.0'
+gem 'nokogiri', '~> 1.13'
+
+group :development do
+  gem 'rubocop', '~> 1.0'
+end

test-server/ruby-transitional-server/Gemfile.lock

@@ -0,0 +1,102 @@
+PATH
+  remote: transitional-ruby-sdk/gems/aws-sdk-kms
+  specs:
+    aws-sdk-kms (1.112.0)
+      aws-sdk-core (~> 3, >= 3.231.0)
+      aws-sigv4 (~> 1.5)
+
+PATH
+  remote: transitional-ruby-sdk/gems/aws-sdk-s3
+  specs:
+    aws-sdk-s3 (1.199.0)
+      aws-sdk-core (~> 3, >= 3.231.0)
+      aws-sdk-kms (~> 1)
+      aws-sigv4 (~> 1.5)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    aws-eventstream (1.4.0)
+    aws-partitions (1.1161.0)
+    aws-sdk-core (3.232.0)
+      aws-eventstream (~> 1, >= 1.3.0)
+      aws-partitions (~> 1, >= 1.992.0)
+      aws-sigv4 (~> 1.9)
+      base64
+      bigdecimal
+      jmespath (~> 1, >= 1.6.1)
+      logger
+    aws-sigv4 (1.12.1)
+      aws-eventstream (~> 1, >= 1.0.2)
+    base64 (0.3.0)
+    bigdecimal (3.2.3)
+    concurrent-ruby (1.3.5)
+    jmespath (1.6.2)
+    json (2.13.2)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    mustermann (3.0.4)
+      ruby2_keywords (~> 0.0.1)
+    nio4r (2.7.4)
+    nokogiri (1.18.10-arm64-darwin)
+      racc (~> 1.4)
+    parallel (1.27.0)
+    parser (3.3.9.0)
+      ast (~> 2.4.1)
+      racc
+    prism (1.5.1)
+    puma (6.6.1)
+      nio4r (~> 2.0)
+    racc (1.8.1)
+    rack (2.2.17)
+    rack-protection (3.2.0)
+      base64 (>= 0.1.0)
+      rack (~> 2.2, >= 2.2.4)
+    rainbow (3.1.1)
+    regexp_parser (2.11.3)
+    rubocop (1.80.2)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.46.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.46.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    ruby-progressbar (1.13.0)
+    ruby2_keywords (0.0.5)
+    sinatra (3.2.0)
+      mustermann (~> 3.0)
+      rack (~> 2.2, >= 2.2.4)
+      rack-protection (= 3.2.0)
+      tilt (~> 2.0)
+    tilt (2.6.1)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.1.0)
+
+PLATFORMS
+  arm64-darwin-24
+
+DEPENDENCIES
+  aws-sdk-kms!
+  aws-sdk-s3!
+  concurrent-ruby (~> 1.0)
+  json (~> 2.0)
+  nokogiri (~> 1.13)
+  puma (~> 6.0)
+  rubocop (~> 1.0)
+  sinatra (~> 3.0)
+
+RUBY VERSION
+   ruby 3.4.5p51
+
+BUNDLED WITH
+   2.6.9

test-server/ruby-transitional-server/README.md

@@ -0,0 +1,66 @@
+# Ruby S3 Encryption Client Test Server
+
+This is a Ruby implementation of the S3 Encryption Client test server that provides an invariant interface around the S3 Encryption Client v2. It's designed to work alongside other implementations of test servers for cross-language compatibility testing.
+
+## Overview
+
+The server provides a REST API that wraps the AWS S3 Encryption Client v2, allowing tests to verify that all language implementations behave consistently.
+
+## Endpoints
+
+- `POST /client` - Create a new S3 encryption client instance
+- `PUT /object/{bucket}/{key}` - Encrypt and store an object
+- `GET /object/{bucket}/{key}` - Retrieve and decrypt an object
+- `GET /health` - Health check endpoint
+
+## Configuration
+
+The server runs on port **8086** by default.
+
+## Setup
+
+1. Install Ruby 3.x
+2. Install dependencies:
+   ```bash
+   cd test-server/ruby-v2-server
+   bundle install
+   ```
+
+3. Set up AWS credentials (via AWS CLI, environment variables, or IAM roles)
+
+4. Start the server:
+   ```bash
+   ruby app.rb
+   # or using Rack
+   bundle exec rackup -p 8086
+   ```
+
+## Usage
+
+The server is designed to be used by the Java test suite in `test-server/java-tests/`. The tests will automatically discover and use this server for cross-language compatibility testing.
+
+### Environment Variables
+
+- `TEST_SERVER_KMS_KEY_ARN` - KMS key ARN for encryption (defaults to test key)
+- `TEST_SERVER_S3_BUCKET` - S3 bucket for testing (defaults to test bucket)
+
+## Architecture
+
+- `app.rb` - Main Sinatra application
+- `lib/client_manager.rb` - Manages S3 encryption client instances
+- `lib/metadata_utils.rb` - Handles metadata serialization/deserialization
+- `lib/error_handlers.rb` - Smithy-compliant error responses
+
+## Error Handling
+
+The server returns errors in the format expected by the Smithy model:
+
+- `GenericServerError` - Internal server errors
+- `S3EncryptionClientError` - Errors from the S3 Encryption Client
+
+## Compatibility
+
+This server is compatible with:
+- S3 Encryption Client v2
+- Legacy v1 clients (when `enableLegacyWrappingAlgorithms` is true)
+- Cross-language testing with Java and Python implementations