0.1.8 - Polling, ASIA region, CJS

.env.example

@@ -3,7 +3,7 @@ BUDDY_WORKSPACE=your-workspace
 BUDDY_PROJECT=your-project
 BUDDY_TOKEN=your-token
 
-# Optional: API region (US, EU, or AP) - defaults to US
+# Optional: API region (US, EU, or AS) - defaults to US
 # BUDDY_REGION=US
 
 # Optional: Custom API URL (for testing against different environments)

README.md

@@ -42,7 +42,33 @@ Set required environment variables:
 export BUDDY_TOKEN="your-api-token"
 export BUDDY_WORKSPACE="your-workspace"
 export BUDDY_PROJECT="your-project"
-export BUDDY_REGION="US"  # Optional: US (default), EU, or AP
+export BUDDY_REGION="US"  # Optional: US (default), EU, or AS
+```
+
+## Waiting for readiness
+
+`Sandbox.create()` blocks until the sandbox has finished setup and reached
+`RUNNING`, so the instance it returns is ready to use. While waiting it polls
+the API on a backoff starting at 100ms and growing to 500ms.
+
+Pass `wait: false` to skip the wait and drive it yourself. The instance you get
+back carries everything the create call returned - `id`, `identifier`, `url`,
+`resources` - but connection details are not settled yet.
+
+```typescript
+const sandbox = await Sandbox.create({ identifier: "my-sandbox", wait: false });
+
+// ... do other work while the sandbox boots ...
+
+await sandbox.waitUntilReady();   // setup_status: SUCCESS
+await sandbox.waitUntilRunning(); // status: RUNNING
+```
+
+The waiters accept an explicit interval, which pins polling to that fixed value
+instead of backing off:
+
+```typescript
+await sandbox.waitUntilRunning(500); // check every 500ms
 ```
 
 ## Apps
@@ -162,7 +188,7 @@ const sandbox = await Sandbox.create({
     name: "My Sandbox",
     os: "ubuntu:24.04",
     connection: {
-        region: "EU"  // US, EU, or AP
+        region: "EU"  // US, EU, or AS
     }
 });
 ```

examples/.env.example

@@ -4,4 +4,4 @@ BUDDY_WORKSPACE=""
 BUDDY_PROJECT=""
 
 # Optional - defaults to US
-BUDDY_REGION="US"  # Valid values: US, EU, AP
+BUDDY_REGION="US"  # Valid values: US, EU, AS

package.json

@@ -1,14 +1,21 @@
 {
 	"name": "@buddy-works/sandbox-sdk",
-	"version": "0.1.7",
+	"version": "0.1.8-rc.0",
 	"type": "module",
 	"description": "TypeScript SDK for managing sandboxes through the Buddy API",
-	"main": "./dist/index.mjs",
-	"types": "./dist/index.d.mts",
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.cts",
 	"exports": {
 		".": {
-			"types": "./dist/index.d.mts",
-			"default": "./dist/index.mjs"
+			"import": {
+				"types": "./dist/index.d.mts",
+				"default": "./dist/index.mjs"
+			},
+			"require": {
+				"types": "./dist/index.d.cts",
+				"default": "./dist/index.cjs"
+			}
 		}
 	},
 	"files": [
@@ -34,7 +41,7 @@
 		"typescript"
 	],
 	"engines": {
-		"node": ">=20"
+		"node": "^20.19.0 || >=22.12.0"
 	},
 	"sideEffects": false,
 	"author": "Cyprian Zdebski <cyprian.zdebski@buddy.works>",