@renderinc/sdk 0.2.1 → 0.4.0

package/README.md

@@ -30,6 +30,12 @@ Or with pnpm:
 pnpm add @renderinc/sdk
 ```
 
+Or with Bun:
+
+```bash
+bun add @renderinc/sdk
+```
+
 ## Quick Start
 
 ### REST API Client
@@ -47,11 +53,13 @@ const result = await render.workflows.runTask('my-workflow/my-task', [42, 'hello
 console.log('Status:', result.status);
 console.log('Results:', result.results);
 
+// Or start a task and decide when to await the result
+const run = await render.workflows.startTask('my-workflow/my-task', [42, 'hello']);
+console.log('Task run ID:', run.taskRunId);
+const details = await run.get();
+
 // List recent task runs
 const taskRuns = await render.workflows.listTaskRuns({ limit: 10 });
-
-// Get specific task run
-const details = await render.workflows.getTaskRun(result.id);
 ```
 
 Alternatively, you can create a workflows client directly:
@@ -125,9 +133,12 @@ Creates a new Render SDK instance with access to all Render products.
 - `baseUrl?: string` - Base URL (defaults to `https://api.render.com`)
 - `useLocalDev?: boolean` - Use local development mode
 - `localDevUrl?: string` - Local development URL
+- `ownerId?: string` - Default owner ID for object storage (falls back to `RENDER_WORKSPACE_ID` env var)
+- `region?: string` - Default region for object storage (falls back to `RENDER_REGION` env var)
 
 **Properties:**
 - `workflows` - WorkflowsClient instance for managing workflow tasks
+- `experimental` - ExperimentalClient instance for object storage and other experimental APIs
 
 **Example:**
 ```typescript
@@ -175,6 +186,56 @@ const result = await render.workflows.runTask('my-workflow/square', [5]);
 console.log('Results:', result.results);
 ```
 
+#### `render.workflows.startTask(taskIdentifier, inputData, signal?)`
+
+Starts a task run and returns a `TaskRunResult`. Results are not streamed until you call `.get()` on the returned result. Use this when you need the task run ID, want to defer awaiting, or want fire-and-forget.
+
+**Parameters:**
+- `taskIdentifier: string` - Task identifier in format "workflow-slug/task-name"
+- `inputData: any[]` - Input data as array of parameters
+- `signal?: AbortSignal` - Optional abort signal for cancellation
+
+**Returns:** `Promise<TaskRunResult>`
+
+**Example:**
+```typescript
+const render = new Render();
+
+// Start a task and grab its ID
+const run = await render.workflows.startTask('my-workflow/square', [5]);
+console.log('Task run ID:', run.taskRunId);
+
+// Await the result when you're ready
+const result = await run.get();
+console.log('Results:', result.results);
+```
+
+#### `render.workflows.taskRunEvents(taskRunIds, signal?)`
+
+Streams task run events as an async iterable. Yields a `TaskRunDetails` for each terminal event (completed or failed) received on the stream.
+
+**Parameters:**
+- `taskRunIds: string[]` - One or more task run IDs to subscribe to
+- `signal?: AbortSignal` - Optional abort signal for cancellation
+
+**Returns:** `AsyncGenerator<TaskRunDetails>`
+
+**Example:**
+```typescript
+const render = new Render();
+
+const run1 = await render.workflows.startTask('my-workflow/square', [3]);
+const run2 = await render.workflows.startTask('my-workflow/square', [6]);
+
+// The stream stays open until you break or abort.
+const pending = new Set([run1.taskRunId, run2.taskRunId]);
+for await (const event of render.workflows.taskRunEvents([...pending])) {
+  console.log('Event:', event.status, event.id, event.results);
+  pending.delete(event.id);
+  if (pending.size === 0) break;
+}
+```
+
 #### `render.workflows.getTaskRun(taskRunId)`
 
 Gets task run details by ID.
@@ -190,6 +251,22 @@ const render = new Render();
 const details = await render.workflows.getTaskRun('task-run-id');
 ```
 
+#### `render.workflows.cancelTaskRun(taskRunId)`
+
+Cancels a running task.
+
+**Parameters:**
+- `taskRunId: string` - Task run ID to cancel
+
+**Returns:** `Promise<void>`
+
+**Example:**
+```typescript
+const render = new Render();
+const run = await render.workflows.startTask('my-workflow/square', [5]);
+await render.workflows.cancelTaskRun(run.taskRunId);
+```
+
 #### `render.workflows.listTaskRuns(params)`
 
 Lists task runs with optional filters.
@@ -300,20 +377,36 @@ enum TaskRunStatus {
 ```typescript
 interface TaskRun {
   id: string;
+  taskId: string;
   status: TaskRunStatus;
-  created_at: string;
-  updated_at: string;
-  task_identifier: string;
+  startedAt?: string;
+  completedAt?: string;
+  parentTaskRunId: string;
+  rootTaskRunId: string;
+  retries: number;
 }
 ```
 
 #### `TaskRunDetails`
 
 ```typescript
-interface TaskRunDetails extends TaskRun {
-  completed_at?: string;
-  results?: any[];
+interface TaskRunDetails {
+  id: string;
+  taskId: string;
+  status: TaskRunStatus;
+  results?: any;
   error?: string;
+  startedAt?: string;
+  completedAt?: string;
+}
+```
+
+#### `TaskRunResult`
+
+```typescript
+class TaskRunResult {
+  readonly taskRunId: string;
+  get(): Promise<TaskRunDetails>;
 }
 ```
 
@@ -340,6 +433,7 @@ The SDK provides several error classes:
 import { Render } from '@renderinc/sdk';
 import {
   RenderError,
+  TaskRunError,
   ClientError,
   ServerError,
   AbortError,
@@ -350,7 +444,9 @@ const render = new Render();
 try {
   const result = await render.workflows.runTask('my-workflow/task', [42]);
 } catch (error) {
-  if (error instanceof ClientError) {
+  if (error instanceof TaskRunError) {
+    console.error('Task failed:', error.taskRunId, error.message);
+  } else if (error instanceof ClientError) {
     console.error('Client error:', error.statusCode, error.cause);
   } else if (error instanceof ServerError) {
     console.error('Server error:', error.statusCode, error.cause);
@@ -365,11 +461,36 @@ try {
 ## Environment Variables
 
 - `RENDER_API_KEY` - Your Render API key (required)
+- `RENDER_WORKSPACE_ID` - Default owner ID for object storage (workspace team ID, e.g. `tea-xxxxx`)
+- `RENDER_REGION` - Default region for object storage (e.g. `oregon`, `frankfurt`)
 - `RENDER_USE_LOCAL_DEV` - Enable local development mode (`true`/`false`)
 - `RENDER_LOCAL_DEV_URL` - Local development URL (default: `http://localhost:8120`)
 - `RENDER_SDK_MODE` - Task execution mode (`run` or `register`)
 - `RENDER_SDK_SOCKET_PATH` - Unix socket path for task communication
 
+### Object Storage
+
+When running on Render, `RENDER_WORKSPACE_ID` and `RENDER_REGION` are set automatically. You can also pass them as constructor options:
+
+```typescript
+import { Render } from '@renderinc/sdk';
+
+const render = new Render();  // Uses env vars for auth + object storage defaults
+
+// Upload (no need to pass ownerId/region when env vars are set)
+await render.experimental.storage.objects.put({
+  key: 'path/to/file.png',
+  data: Buffer.from('binary content'),
+  contentType: 'image/png',
+});
+
+// Download
+const obj = await render.experimental.storage.objects.get({ key: 'path/to/file.png' });
+
+// List
+const response = await render.experimental.storage.objects.list();
+```
+
 ## Examples
 
 ### Example 1: Running a Task
@@ -379,18 +500,14 @@ import { Render } from '@renderinc/sdk';
 
 const render = new Render();
 
-async function runSquareTask() {
-  const result = await render.workflows.runTask('my-workflow/square', [5]);
-  console.log('Square of 5 is:', result.results[0]); // 25
-}
-
-runSquareTask();
+const result = await render.workflows.runTask('my-workflow/square', [5]);
+console.log('Square of 5 is:', result.results[0]); // 25
 ```
 
 ### Example 2: Defining Tasks with Subtasks
 
 ```typescript
-import { task, startTaskServer } from '@renderinc/sdk/workflows';
+import { task } from '@renderinc/sdk/workflows';
 
 const square = task(
   { name: 'square' },
@@ -407,8 +524,6 @@ task(
     return Math.sqrt(aSquared + bSquared);
   }
 );
-
-await startTaskServer();
 ```
 
 ### Example 3: Error Handling in Tasks
@@ -502,8 +617,7 @@ async function workflowExample() {
     console.log(`\nRecent task runs: ${recentRuns.length}`);
 
     for (const run of recentRuns) {
-      const details = await render.workflows.getTaskRun(run.id);
-      console.log(`- ${run.taskId}: ${details.status}`);
+      console.log(`- ${run.id}: ${run.status} (${run.taskId})`);
     }
   } catch (error) {
     console.error('Error:', error);
@@ -544,30 +658,33 @@ npm run format
 ```
 typescript/
 ├── src/
-│   ├── render.ts            # Main Render SDK class
-│   ├── index.ts             # Main exports
-│   └── workflows/           # Workflows functionality
-│       ├── client/          # REST API client
-│       │   ├── client.ts    # WorkflowsClient class
-│       │   ├── workflows.ts # WorkflowsService
-│       │   ├── sse.ts       # SSE client
-│       │   ├── types.ts     # Type definitions
-│       │   ├── errors.ts    # Error classes
-│       │   └── index.ts     # Exports
-│       ├── task/            # Task execution SDK
-│       │   ├── task.ts      # task() function
-│       │   ├── runner.ts    # start() and run()
-│       │   ├── executor.ts  # TaskExecutor
-│       │   ├── registry.ts  # TaskRegistry
-│       │   ├── uds.ts       # Unix socket client
-│       │   ├── types.ts     # Type definitions
-│       │   └── index.ts     # Exports
-│       └── index.ts         # Workflows exports
+│   ├── render.ts              # Main Render SDK class
+│   ├── errors.ts              # Error classes
+│   ├── index.ts               # Main exports
+│   ├── version.ts             # SDK version and user-agent
+│   ├── workflows/             # Workflows functionality
+│   │   ├── task.ts            # task() function
+│   │   ├── runner.ts          # startTaskServer() and run()
+│   │   ├── executor.ts        # TaskExecutor
+│   │   ├── registry.ts        # TaskRegistry
+│   │   ├── uds.ts             # Unix socket client
+│   │   ├── types.ts           # Type definitions
+│   │   ├── client/            # REST API client
+│   │   │   ├── client.ts      # WorkflowsClient class
+│   │   │   ├── create-client.ts # createWorkflowsClient() factory
+│   │   │   ├── task-run-result.ts # TaskRunResult class
+│   │   │   ├── sse.ts         # SSE event types
+│   │   │   ├── types.ts       # Client type definitions
+│   │   │   └── index.ts       # Exports
+│   │   └── index.ts           # Workflows exports
+│   ├── experimental/          # Experimental features
+│   │   └── object/            # Object storage API
+│   └── utils/                 # Shared utilities
 ├── examples/
-│   ├── client/              # Client example
+│   ├── client/                # Client example
 │   │   ├── main.ts
 │   │   └── package.json
-│   └── task/                # Task example
+│   └── task/                  # Task example
 │       ├── main.ts
 │       └── package.json
 ├── package.json

package/dist/experimental/experimental.d.ts

@@ -3,10 +3,10 @@ import type { paths } from "../generated/schema.js";
 import { ObjectClient } from "./object/client.js";
 export declare class StorageClient {
     readonly objects: ObjectClient;
-    constructor(apiClient: Client<paths>);
+    constructor(apiClient: Client<paths>, defaultOwnerId?: string, defaultRegion?: string);
 }
 export declare class ExperimentalClient {
     readonly storage: StorageClient;
-    constructor(apiClient: Client<paths>);
+    constructor(apiClient: Client<paths>, defaultOwnerId?: string, defaultRegion?: string);
 }
 //# sourceMappingURL=experimental.d.ts.map

package/dist/experimental/experimental.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"experimental.d.ts","sourceRoot":"","sources":["../../src/experimental/experimental.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAgBlD,qBAAa,aAAa;IAExB,SAAgB,OAAO,EAAE,YAAY,CAAC;gBAE1B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC;CAGrC;AAuBD,qBAAa,kBAAkB;IAE7B,SAAgB,OAAO,EAAE,aAAa,CAAC;gBAE3B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC;CAGrC"}
+{"version":3,"file":"experimental.d.ts","sourceRoot":"","sources":["../../src/experimental/experimental.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAgBlD,qBAAa,aAAa;IAExB,SAAgB,OAAO,EAAE,YAAY,CAAC;gBAE1B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;CAGtF;AAuBD,qBAAa,kBAAkB;IAE7B,SAAgB,OAAO,EAAE,aAAa,CAAC;gBAE3B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;CAGtF"}

package/dist/experimental/experimental.js

@@ -3,14 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExperimentalClient = exports.StorageClient = void 0;
 const client_js_1 = require("./object/client.js");
 class StorageClient {
-    constructor(apiClient) {
-        this.objects = new client_js_1.ObjectClient(apiClient);
+    constructor(apiClient, defaultOwnerId, defaultRegion) {
+        this.objects = new client_js_1.ObjectClient(apiClient, defaultOwnerId, defaultRegion);
     }
 }
 exports.StorageClient = StorageClient;
 class ExperimentalClient {
-    constructor(apiClient) {
-        this.storage = new StorageClient(apiClient);
+    constructor(apiClient, defaultOwnerId, defaultRegion) {
+        this.storage = new StorageClient(apiClient, defaultOwnerId, defaultRegion);
     }
 }
 exports.ExperimentalClient = ExperimentalClient;

package/dist/experimental/object/api.d.ts

@@ -1,11 +1,12 @@
 import type { Client } from "openapi-fetch";
 import type { paths } from "../../generated/schema.js";
-import type { PresignedDownloadUrl, PresignedUploadUrl, Region } from "./types.js";
+import type { ListObjectsResponse, PresignedDownloadUrl, PresignedUploadUrl, Region } from "./types.js";
 export declare class ObjectApi {
     private readonly apiClient;
     constructor(apiClient: Client<paths>);
     getUploadUrl(ownerId: string, region: Region | string, key: string, sizeBytes: number): Promise<PresignedUploadUrl>;
     getDownloadUrl(ownerId: string, region: Region | string, key: string): Promise<PresignedDownloadUrl>;
     delete(ownerId: string, region: Region | string, key: string): Promise<void>;
+    listObjects(ownerId: string, region: Region | string, cursor?: string, limit?: number): Promise<ListObjectsResponse>;
 }
 //# sourceMappingURL=api.d.ts.map

package/dist/experimental/object/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/experimental/object/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAUnF,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC;IAW/C,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC;IAyBxB,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,oBAAoB,CAAC;IAsB1B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CASnF"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/experimental/object/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EACV,mBAAmB,EAEnB,oBAAoB,EACpB,kBAAkB,EAClB,MAAM,EACP,MAAM,YAAY,CAAC;AAUpB,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC;IAW/C,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC;IAyBxB,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,oBAAoB,CAAC;IAsB1B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB5E,WAAW,CACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC;CAoBhC"}

package/dist/experimental/object/api.js

@@ -7,7 +7,7 @@ class ObjectApi {
         this.apiClient = apiClient;
     }
     async getUploadUrl(ownerId, region, key, sizeBytes) {
-        const { data, error } = await this.apiClient.PUT("/blobs/{ownerId}/{region}/{key}", {
+        const { data, error } = await this.apiClient.PUT("/objects/{ownerId}/{region}/{key}", {
             params: { path: { ownerId, region: region, key } },
             body: { sizeBytes },
         });
@@ -21,7 +21,7 @@ class ObjectApi {
         };
     }
     async getDownloadUrl(ownerId, region, key) {
-        const { data, error } = await this.apiClient.GET("/blobs/{ownerId}/{region}/{key}", {
+        const { data, error } = await this.apiClient.GET("/objects/{ownerId}/{region}/{key}", {
             params: { path: { ownerId, region: region, key } },
         });
         if (error) {
@@ -33,12 +33,29 @@ class ObjectApi {
         };
     }
     async delete(ownerId, region, key) {
-        const { error } = await this.apiClient.DELETE("/blobs/{ownerId}/{region}/{key}", {
+        const { error } = await this.apiClient.DELETE("/objects/{ownerId}/{region}/{key}", {
             params: { path: { ownerId, region: region, key } },
         });
         if (error) {
             throw new errors_js_1.RenderError(`Failed to delete object: ${error.message || "Unknown error"}`);
         }
     }
+    async listObjects(ownerId, region, cursor, limit) {
+        const { data, error } = await this.apiClient.GET("/objects/{ownerId}/{region}", {
+            params: {
+                path: { ownerId, region: region },
+                query: { cursor, limit },
+            },
+        });
+        if (error) {
+            throw new errors_js_1.RenderError(`Failed to list objects: ${error.message || "Unknown error"}`);
+        }
+        const objects = data.items.map((item) => ({
+            key: item.object.key,
+            size: item.object.sizeBytes,
+            lastModified: new Date(item.object.lastModified),
+        }));
+        return { objects, hasNext: data.hasNext, nextCursor: data.nextCursor };
+    }
 }
 exports.ObjectApi = ObjectApi;

package/dist/experimental/object/client.d.ts

@@ -1,12 +1,17 @@
 import type { Client } from "openapi-fetch";
 import type { paths } from "../../generated/schema.js";
-import type { DeleteObjectInput, GetObjectInput, ObjectData, ObjectScope, PutObjectInput, PutObjectResult, ScopedDeleteObjectInput, ScopedGetObjectInput, ScopedPutObjectInput } from "./types.js";
+import type { DeleteObjectInput, GetObjectInput, ListObjectsInput, ListObjectsResponse, ObjectData, ObjectScope, OptionalScope, PutObjectInput, PutObjectResult, ScopedDeleteObjectInput, ScopedGetObjectInput, ScopedListObjectsInput, ScopedPutObjectInput } from "./types.js";
 export declare class ObjectClient {
     private readonly apiClient;
-    constructor(apiClient: Client<paths>);
-    put(input: PutObjectInput): Promise<PutObjectResult>;
-    get(input: GetObjectInput): Promise<ObjectData>;
-    delete(input: DeleteObjectInput): Promise<void>;
+    private readonly defaultOwnerId?;
+    private readonly defaultRegion?;
+    constructor(apiClient: Client<paths>, defaultOwnerId?: string, defaultRegion?: string);
+    private resolveOwnerId;
+    private resolveRegion;
+    put(input: OptionalScope<PutObjectInput>): Promise<PutObjectResult>;
+    get(input: OptionalScope<GetObjectInput>): Promise<ObjectData>;
+    delete(input: OptionalScope<DeleteObjectInput>): Promise<void>;
+    list(input: OptionalScope<ListObjectsInput>): Promise<ListObjectsResponse>;
     scoped(scope: ObjectScope): ScopedObjectClient;
     private resolveSize;
 }
@@ -17,5 +22,6 @@ export declare class ScopedObjectClient {
     put(input: ScopedPutObjectInput): Promise<PutObjectResult>;
     get(input: ScopedGetObjectInput): Promise<ObjectData>;
     delete(input: ScopedDeleteObjectInput): Promise<void>;
+    list(input?: ScopedListObjectsInput): Promise<ListObjectsResponse>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/experimental/object/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/experimental/object/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,WAAW,EACX,cAAc,EACd,eAAe,EAEf,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AASpB,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC;IAgC/C,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAgEpD,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IA+C/C,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCrD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,kBAAkB;IAU9C,OAAO,CAAC,WAAW;CA0BpB;AAQD,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAG1C,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,EACP,KAAK,EAAE,WAAW;IAqB/B,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAmB1D,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBrD,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;CAM5D"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/experimental/object/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EAEV,WAAW,EACX,aAAa,EACb,cAAc,EACd,eAAe,EAEf,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AASpB,qBAAa,YAAY;IAKrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAkB;gBAG9B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,EACzC,cAAc,CAAC,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,MAAM;IAMxB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,aAAa;IA4Cf,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAwFnE,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAkD9D,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgD9D,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiDhF,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,kBAAkB;IAU9C,OAAO,CAAC,WAAW;CA0BpB;AAQD,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAG1C,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,EACP,KAAK,EAAE,WAAW;IAqB/B,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAmB1D,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBrD,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBrD,IAAI,CAAC,KAAK,GAAE,sBAA2B,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAM7E"}

package/dist/experimental/object/client.js

@@ -1,18 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ScopedObjectClient = exports.ObjectClient = void 0;
+const node_stream_1 = require("node:stream");
 const errors_js_1 = require("../../errors.js");
 class ObjectClient {
-    constructor(apiClient) {
+    constructor(apiClient, defaultOwnerId, defaultRegion) {
         this.apiClient = apiClient;
+        this.defaultOwnerId = defaultOwnerId;
+        this.defaultRegion = defaultRegion;
+    }
+    resolveOwnerId(ownerId) {
+        const resolved = ownerId || this.defaultOwnerId;
+        if (!resolved) {
+            throw new errors_js_1.RenderError("ownerId is required. Provide it as a parameter or set the RENDER_WORKSPACE_ID environment variable.");
+        }
+        return resolved;
+    }
+    resolveRegion(region) {
+        const resolved = region || this.defaultRegion;
+        if (!resolved) {
+            throw new errors_js_1.RenderError("region is required. Provide it as a parameter or set the RENDER_REGION environment variable.");
+        }
+        return resolved;
     }
     async put(input) {
+        const ownerId = this.resolveOwnerId(input.ownerId);
+        const region = this.resolveRegion(input.region);
         const size = this.resolveSize(input);
-        const { data, error } = await this.apiClient.PUT("/blobs/{ownerId}/{region}/{key}", {
+        const { data, error } = await this.apiClient.PUT("/objects/{ownerId}/{region}/{key}", {
             params: {
                 path: {
-                    ownerId: input.ownerId,
-                    region: input.region,
+                    ownerId,
+                    region: region,
                     key: input.key,
                 },
             },
@@ -21,16 +40,27 @@ class ObjectClient {
         if (error) {
             throw new errors_js_1.RenderError(`Failed to get upload URL: ${error.message || "Unknown error"}`);
         }
+        if (size !== data.maxSizeBytes) {
+            throw new errors_js_1.ClientError(`File size ${size} bytes does not match expected size of ${data.maxSizeBytes} bytes`, 400);
+        }
         const headers = {
             "Content-Length": size.toString(),
         };
         if (input.contentType) {
             headers["Content-Type"] = input.contentType;
         }
+        let body = input.data;
+        if (process.versions.bun && input.data instanceof node_stream_1.Readable) {
+            const chunks = [];
+            for await (const chunk of input.data) {
+                chunks.push(Buffer.from(chunk));
+            }
+            body = Buffer.concat(chunks);
+        }
         const response = await fetch(data.url, {
             method: "PUT",
             headers,
-            body: input.data,
+            body,
             duplex: "half",
         });
         if (!response.ok) {
@@ -41,11 +71,13 @@ class ObjectClient {
         };
     }
     async get(input) {
-        const { data, error } = await this.apiClient.GET("/blobs/{ownerId}/{region}/{key}", {
+        const ownerId = this.resolveOwnerId(input.ownerId);
+        const region = this.resolveRegion(input.region);
+        const { data, error } = await this.apiClient.GET("/objects/{ownerId}/{region}/{key}", {
             params: {
                 path: {
-                    ownerId: input.ownerId,
-                    region: input.region,
+                    ownerId,
+                    region: region,
                     key: input.key,
                 },
             },
@@ -66,11 +98,13 @@ class ObjectClient {
         };
     }
     async delete(input) {
-        const { error } = await this.apiClient.DELETE("/blobs/{ownerId}/{region}/{key}", {
+        const ownerId = this.resolveOwnerId(input.ownerId);
+        const region = this.resolveRegion(input.region);
+        const { error } = await this.apiClient.DELETE("/objects/{ownerId}/{region}/{key}", {
             params: {
                 path: {
-                    ownerId: input.ownerId,
-                    region: input.region,
+                    ownerId,
+                    region: region,
                     key: input.key,
                 },
             },
@@ -79,6 +113,31 @@ class ObjectClient {
             throw new errors_js_1.RenderError(`Failed to delete object: ${error.message || "Unknown error"}`);
         }
     }
+    async list(input) {
+        const ownerId = this.resolveOwnerId(input.ownerId);
+        const region = this.resolveRegion(input.region);
+        const { data, error } = await this.apiClient.GET("/objects/{ownerId}/{region}", {
+            params: {
+                path: {
+                    ownerId,
+                    region: region,
+                },
+                query: {
+                    cursor: input.cursor,
+                    limit: input.limit,
+                },
+            },
+        });
+        if (error) {
+            throw new errors_js_1.RenderError(`Failed to list objects: ${error.message || "Unknown error"}`);
+        }
+        const objects = data.items.map((item) => ({
+            key: item.object.key,
+            size: item.object.sizeBytes,
+            lastModified: new Date(item.object.lastModified),
+        }));
+        return { objects, hasNext: data.hasNext, nextCursor: data.nextCursor };
+    }
     scoped(scope) {
         return new ScopedObjectClient(this.apiClient, scope);
     }
@@ -93,8 +152,8 @@ class ObjectClient {
         if (input.size === undefined) {
             throw new errors_js_1.RenderError("Size is required for stream and string inputs. Provide the size parameter.");
         }
-        if (input.size <= 0) {
-            throw new errors_js_1.RenderError("Size must be a positive integer");
+        if (input.size < 0) {
+            throw new errors_js_1.RenderError("Size must be a non-negative integer");
         }
         return input.size;
     }
@@ -123,5 +182,11 @@ class ScopedObjectClient {
             ...input,
         });
     }
+    async list(input = {}) {
+        return this.objectClient.list({
+            ...this.scope,
+            ...input,
+        });
+    }
 }
 exports.ScopedObjectClient = ScopedObjectClient;

package/dist/experimental/object/e2e-helpers.d.ts

@@ -0,0 +1,3 @@
+import type { ObjectClient } from "./client.js";
+export declare function objectStorageCrudCheck(client: ObjectClient, ownerId: `tea-${string}`, region: string): Promise<string>;
+//# sourceMappingURL=e2e-helpers.d.ts.map

package/dist/experimental/object/e2e-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2e-helpers.d.ts","sourceRoot":"","sources":["../../../src/experimental/object/e2e-helpers.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAchD,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,MAAM,EAAE,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAsEjB"}