feat: implement Simple List API for S3 objects

- Add List method with ListInput and ListResponse structs following simples3 patterns
- Implement pagination, prefix filtering, and delimiter grouping
- Add comprehensive test suite for List functionality
- Update tests to use environment variables instead of hardcoded values
- Fix deprecated io/ioutil usage throughout codebase
- Add comprehensive README with API documentation and examples
- Add Nix development environment with flake.nix
- Add Justfile for modern command runner
- Add Docker Compose setup for local MinIO testing
- Update GitHub Actions to use Nix and Justfile for CI consistency
- Fix test naming and setup flow issues

New API:
s3.List(ListInput{
    Bucket: "my-bucket",
    Prefix: "documents/",
    MaxKeys: 100,
})

All tests pass with new simplified API design.

Author: rhnvrm

.envrc

@@ -0,0 +1,4 @@
+# Load the Nix development environment
+use flake
+
+echo "✅ Environment loaded - Use 'just --list' to see available commands"

.github/workflows/go-test.yml

@@ -10,31 +10,19 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v2
+      - name: Checkout code
+        uses: actions/checkout@v4
 
-    - name: Set up Go
-      uses: actions/setup-go@v2
-      with:
-        go-version: 1.15
-    - name: Setup minio
-      run: |
-          docker run -d -p 9000:9000 --name minio \
-                     -e "MINIO_ACCESS_KEY=minioadmin" \
-                     -e "MINIO_SECRET_KEY=minioadmin" \
-                     -v /tmp/data:/data \
-                     -v /tmp/config:/root/.minio \
-                     minio/minio server /data
-                     
-          export AWS_ACCESS_KEY_ID=minioadmin
-          export AWS_SECRET_ACCESS_KEY=minioadmin
-          export AWS_EC2_METADATA_DISABLED=true
-          
-          aws --endpoint-url http://127.0.0.1:9000/ s3 mb s3://testbucket
-           
-    - name: Run Go Test
-      run: go test -v ./...
-      env:
-        AWS_S3_BUCKET: testbucket 
-        AWS_S3_ACCESS_KEY: minioadmin
-        AWS_S3_SECRET_KEY: minioadmin
-        AWS_S3_ENDPOINT: http://127.0.0.1:9000
+      - name: Install Nix
+        uses: cachix/install-nix-action@v27
+        with:
+          nix_path: nixpkgs=channel:nixos-unstable
+
+      - name: Run Tests via Justfile
+        env:
+          AWS_S3_BUCKET: testbucket
+          AWS_ACCESS_KEY_ID: minioadmin
+          AWS_SECRET_ACCESS_KEY: minioadmin
+          AWS_S3_ENDPOINT: http://127.0.0.1:9000
+          AWS_EC2_METADATA_DISABLED: "true"
+        run: nix develop --command just test-local

.gitignore

@@ -24,3 +24,6 @@ tsconfig.json
 jsconfig.json
 
 .env
+
+# direnv
+.direnv

Justfile

@@ -0,0 +1,92 @@
+# SimpleS3 Development Commands
+
+# Variables
+MINIO_CONTAINER_NAME := "simples3-minio"
+MINIO_DATA_DIR := ".minio-data"
+AWS_S3_BUCKET := "testbucket"
+
+# Default command - lists all available recipes
+default:
+    @just --list
+
+# --- Development Commands ---
+test:
+    @echo "🧪 Running all tests..."
+    @go test -v ./...
+
+test-local: setup
+    @echo "🧪 Running tests with local MinIO..."
+    @sleep 2
+    @go test -v ./...
+
+
+# --- Go Module Management ---
+tidy:
+    @echo "📦 Tidying Go modules..."
+    @go mod tidy
+
+fmt:
+    @echo "🎨 Formatting Go code..."
+    @go fmt ./...
+
+vet:
+    @echo "🔍 Running go vet..."
+    @go vet ./...
+
+# --- MinIO Management ---
+minio-up:
+    @echo "🚀 Starting MinIO container..."
+    @docker compose up -d
+    @echo "✅ MinIO started:"
+    @echo "   API: http://localhost:9000"
+    @echo "   Console: http://localhost:9001"
+    @echo "   Access Key: minioadmin"
+    @echo "   Secret Key: minioadmin"
+
+minio-down:
+    @echo "🛑 Stopping MinIO container..."
+    @docker compose down
+
+minio-logs:
+    @echo "📋 Showing MinIO logs..."
+    @docker compose logs -f
+
+minio-clean:
+    @echo "🧹 Cleaning MinIO data..."
+    @docker compose down --volumes
+
+minio-reset: minio-clean minio-up
+
+# --- Development Environment Setup ---
+setup: minio-up
+    @echo "⚙️ Setting up development environment..."
+    @sleep 3
+    @aws --endpoint-url http://127.0.0.1:9000/ s3 mb s3://{{AWS_S3_BUCKET}} || true
+    @echo "✅ Development environment ready!"
+
+dev-env: setup
+    @echo "🎯 Development environment active!"
+    @echo "   MinIO: http://localhost:9000"
+    @echo "   Console: http://localhost:9001"
+    @echo "   Bucket: {{AWS_S3_BUCKET}}"
+
+# --- Cleanup Commands ---
+clean:
+    @echo "🧹 Cleaning up development environment..."
+    @docker compose down --volumes
+
+# --- Helper Commands ---
+status:
+    @echo "📊 Status Check:"
+    @echo "   MinIO Container: $(docker ps -q -f name={{MINIO_CONTAINER_NAME}} | wc -l | tr -d ' ') running"
+    @if [ "$(docker ps -q -f name={{MINIO_CONTAINER_NAME}})" ]; then \
+        echo "   MinIO URL: http://localhost:9000"; \
+        echo "   Console URL: http://localhost:9001"; \
+    fi
+    @echo "   Go version: $(go version | awk '{print $3}')"
+
+# --- Documentation ---
+docs:
+    @echo "📖 Opening documentation..."
+    @echo "   Plan: PLAN.md"
+    @echo "   README: README.md"