Websockets support (#162)

* websockets lightweight wrapper

* fix formatting

* fix ws

* minor fixes

* WIP

* working draft

* cleanup connect()

* add more tests

* minor nits and fixes

* add unit tests

* add more tests

* Move basic example to tests/integration

The examples/basic directory was primarily used for integration testing
rather than as a standalone example. This moves it to tests/integration
to reflect its actual purpose.

Merged WebSocket example functionality into tests/integration since it
shared the same testing infrastructure. Simplified WebSocket E2E tests
by removing redundant test coverage and focusing on core transport-level
functionality.

* fix the build

* Revert "fix the build"

This reverts commit b915e85.

* update lockfile

* Update lockfile

---------

Co-authored-by: Naresh <[email protected]>

Author: whoiskatrin

.changeset/loud-nights-sneeze.md

@@ -0,0 +1,5 @@
+---
+"@cloudflare/sandbox": patch
+---
+
+Add WebSocket support via connect() method for routing client WebSocket connections directly to container services

.github/changeset-version.ts

@@ -61,6 +61,12 @@ try {
       replacement: `cloudflare/sandbox-test:${newVersion}`,
       description: "Test Docker image reference",
     },
+    // Example package.json dependencies
+    {
+      pattern: /"@cloudflare\/sandbox":\s*"\^[\d.]+"/g,
+      replacement: `"@cloudflare/sandbox": "^${newVersion}"`,
+      description: "Example package.json @cloudflare/sandbox dependencies",
+    },
   ];
 
   // Files to search and update
@@ -73,6 +79,7 @@ try {
     "**/*.json",        // JSON configs (but not package.json/package-lock.json)
     "**/*.yaml",        // YAML configs
     "**/*.yml",         // YML configs
+    "examples/**/package.json", // Example package.json files (exception to ignore rule below)
   ];
 
   // Ignore patterns

CLAUDE.md

@@ -96,7 +96,7 @@ npm run docker:rebuild     # Rebuild container image locally (includes clean bui
 - Stable images when "Version Packages" PR is merged
 - Multi-arch builds (amd64, arm64) handled by CI
 
-**Critical:** Docker image version MUST match npm package version (`@cloudflare/[email protected].7` → `cloudflare/sandbox:0.4.12`). This is enforced via `ARG SANDBOX_VERSION` in Dockerfile.
+**Critical:** Docker image version MUST match npm package version (`@cloudflare/[email protected].12` → `cloudflare/sandbox:0.4.12`). This is enforced via `ARG SANDBOX_VERSION` in Dockerfile.
 
 ### Development Server