@renderinc/sdk 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,9 +1,16 @@
 # Changelog
 
-All notable changes to the `@render/sdk` TypeScript SDK will be documented in this file.
+All notable changes to the `@renderinc/sdk` TypeScript SDK will be documented in this file.
 
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [0.2.1] - 2026-01-29
+
+### Changed
+- Updated package name in README from @render/sdk to @renderinc/sdk
+- Renamed experimental blob storage API to object storage (Blob* -> Object*)
+- Switched internal workflows task communication from SSE to HTTP requests
+
 ## [0.2.0] - 2026-01-26
 
 ### Added
@@ -20,7 +27,7 @@ This project follows [Semantic Versioning](https://semver.org/).
 
 ### Added
 - Add initial TypeScript SDK for Render Workflows
-- Add task registration and execution via `@render/sdk/workflows`
+- Add task registration and execution via `@renderinc/sdk/workflows`
 - Add `TaskContext` for task metadata and subtask execution
 - Add configurable retry policies with exponential backoff
 - Add generated OpenAPI types for full type safety

package/README.md

@@ -15,19 +15,19 @@ The official TypeScript SDK for Render Workflows, providing a simple and intuiti
 ## Installation
 
 ```bash
-npm install @render/sdk
+npm install @renderinc/sdk
 ```
 
 Or with yarn:
 
 ```bash
-yarn add @render/sdk
+yarn add @renderinc/sdk
 ```
 
 Or with pnpm:
 
 ```bash
-pnpm add @render/sdk
+pnpm add @renderinc/sdk
 ```
 
 ## Quick Start
@@ -37,7 +37,7 @@ pnpm add @render/sdk
 Use the Render SDK to run tasks and monitor their execution:
 
 ```typescript
-import { Render } from '@render/sdk';
+import { Render } from '@renderinc/sdk';
 
 // Create a Render SDK instance (uses RENDER_API_KEY from environment)
 const render = new Render();
@@ -57,7 +57,7 @@ const details = await render.workflows.getTaskRun(result.id);
 Alternatively, you can create a workflows client directly:
 
 ```typescript
-import { createWorkflowsClient } from '@render/sdk/workflows';
+import { createWorkflowsClient } from '@renderinc/sdk/workflows';
 
 const client = createWorkflowsClient();
 const result = await client.runTask('my-workflow/my-task', [42, 'hello']);
@@ -68,7 +68,7 @@ const result = await client.runTask('my-workflow/my-task', [42, 'hello']);
 Define tasks that can be executed by the workflow system:
 
 ```typescript
-import { task, startTaskServer } from '@render/sdk/workflows';
+import { task, startTaskServer } from '@renderinc/sdk/workflows';
 
 // Simple task
 const square = task(
@@ -95,8 +95,10 @@ task(
     retry: {
       maxRetries: 3,
       waitDurationMs: 1000,
-      factor: 1.5,
+      backoffScaling: 1.5,
     },
+    timeoutSeconds: 86400, // 24h
+    plan: 'starter',
   },
   async function retryableTask(input: string): Promise<string> {
     // Task implementation
@@ -104,8 +106,10 @@ task(
   }
 );
 
-// Start the task server
-await startTaskServer();
+// The task server starts automatically when running in a workflow environment
+// (when RENDER_SDK_SOCKET_PATH is set). No need to call startTaskServer() explicitly.
+//
+// To disable auto-start, set RENDER_SDK_AUTO_START=false in your environment.
 ```
 
 ## API Reference
@@ -127,7 +131,7 @@ Creates a new Render SDK instance with access to all Render products.
 
 **Example:**
 ```typescript
-import { Render } from '@render/sdk';
+import { Render } from '@renderinc/sdk';
 
 const render = new Render({
   token: 'your-api-token',
@@ -143,7 +147,7 @@ const result = await render.workflows.runTask('my-workflow/task', [42]);
 The workflows client is accessible via `render.workflows` or can be created directly using `createWorkflowsClient`:
 
 ```typescript
-import { createWorkflowsClient } from '@render/sdk/workflows';
+import { createWorkflowsClient } from '@renderinc/sdk/workflows';
 
 const client = createWorkflowsClient({
   token: 'your-api-token',
@@ -215,7 +219,9 @@ Registers a function as a task.
   - `retry?: RetryOptions` - Optional retry configuration
     - `maxRetries: number` - Maximum number of retries
     - `waitDurationMs: number` - Wait duration between retries in milliseconds
-    - `factor?: number` - Backoff factor (default: 1.5)
+    - `backoffScaling?: number` - Backoff multiplier (default: 1.5)
+  - `timeoutSeconds?: number` - Maximum execution time in seconds
+  - `plan?: string` - Resource plan for task execution (e.g., `"starter"`, `"standard"`, `"pro"`)
 - `func: TaskFunction` - The task function to register
 
 **Returns:** The registered function with the same signature
@@ -230,15 +236,17 @@ const myTask = task(
   }
 );
 
-// With retry options
+// With retry, timeout, and plan options
 task(
   {
     name: 'retryableTask',
     retry: {
       maxRetries: 3,
       waitDurationMs: 1000,
-      factor: 1.5,
+      backoffScaling: 1.5,
     },
+    timeoutSeconds: 300,
+    plan: 'starter',
   },
   function retryableTask(arg: string): string {
     return arg.toUpperCase();
@@ -317,8 +325,10 @@ interface RegisterTaskOptions {
   retry?: {
     maxRetries: number;
     waitDurationMs: number;
-    factor?: number; // default 1.5
+    backoffScaling?: number; // default 1.5
   };
+  timeoutSeconds?: number;
+  plan?: string; // e.g., "starter", "standard", "pro"
 }
 ```
 
@@ -327,13 +337,13 @@ interface RegisterTaskOptions {
 The SDK provides several error classes:
 
 ```typescript
-import { Render } from '@render/sdk';
+import { Render } from '@renderinc/sdk';
 import {
   RenderError,
   ClientError,
   ServerError,
   AbortError,
-} from '@render/sdk';
+} from '@renderinc/sdk';
 
 const render = new Render();
 
@@ -365,7 +375,7 @@ try {
 ### Example 1: Running a Task
 
 ```typescript
-import { Render } from '@render/sdk';
+import { Render } from '@renderinc/sdk';
 
 const render = new Render();
 
@@ -380,7 +390,7 @@ runSquareTask();
 ### Example 2: Defining Tasks with Subtasks
 
 ```typescript
-import { task, startTaskServer } from '@render/sdk/workflows';
+import { task, startTaskServer } from '@renderinc/sdk/workflows';
 
 const square = task(
   { name: 'square' },
@@ -404,7 +414,7 @@ await startTaskServer();
 ### Example 3: Error Handling in Tasks
 
 ```typescript
-import { task } from '@render/sdk/workflows';
+import { task } from '@renderinc/sdk/workflows';
 
 const divide = task(
   { name: 'divide' },
@@ -438,7 +448,7 @@ task(
 ### Example 4: Using AbortSignal for Cancellation
 
 ```typescript
-import { Render, AbortError } from '@render/sdk';
+import { Render, AbortError } from '@renderinc/sdk';
 
 const render = new Render();
 
@@ -470,7 +480,7 @@ runTaskWithCancellation();
 ### Example 5: Using the Unified Render SDK
 
 ```typescript
-import { Render } from '@render/sdk';
+import { Render } from '@renderinc/sdk';
 
 // Single entry point for all Render products
 const render = new Render({

package/dist/experimental/experimental.d.ts

@@ -1,8 +1,12 @@
 import type { Client } from "openapi-fetch";
 import type { paths } from "../generated/schema.js";
-import { BlobClient } from "./blob/client.js";
+import { ObjectClient } from "./object/client.js";
+export declare class StorageClient {
+    readonly objects: ObjectClient;
+    constructor(apiClient: Client<paths>);
+}
 export declare class ExperimentalClient {
-    readonly blob: BlobClient;
+    readonly storage: StorageClient;
     constructor(apiClient: Client<paths>);
 }
 //# 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,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAuB9C,qBAAa,kBAAkB;IAE7B,SAAgB,IAAI,EAAE,UAAU,CAAC;gBAErB,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;CAGrC;AAuBD,qBAAa,kBAAkB;IAE7B,SAAgB,OAAO,EAAE,aAAa,CAAC;gBAE3B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC;CAGrC"}

package/dist/experimental/experimental.js

@@ -1,10 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExperimentalClient = void 0;
-const client_js_1 = require("./blob/client.js");
+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);
+    }
+}
+exports.StorageClient = StorageClient;
 class ExperimentalClient {
     constructor(apiClient) {
-        this.blob = new client_js_1.BlobClient(apiClient);
+        this.storage = new StorageClient(apiClient);
     }
 }
 exports.ExperimentalClient = ExperimentalClient;

package/dist/experimental/index.d.ts

@@ -1,3 +1,3 @@
-export { BlobApi, BlobClient, type BlobData, type BlobIdentifier, type BlobScope, type DeleteBlobInput, type GetBlobInput, type PresignedDownloadUrl, type PresignedUploadUrl, type PutBlobInput, type PutBlobInputBuffer, type PutBlobInputStream, type PutBlobResult, Region, ScopedBlobClient, type ScopedDeleteBlobInput, type ScopedGetBlobInput, type ScopedPutBlobInput, } from "./blob/index.js";
-export { ExperimentalClient } from "./experimental.js";
+export { ExperimentalClient, StorageClient } from "./experimental.js";
+export { type DeleteObjectInput, type GetObjectInput, ObjectApi, ObjectClient, type ObjectData, type ObjectIdentifier, type ObjectScope, type PresignedDownloadUrl, type PresignedUploadUrl, type PutObjectInput, type PutObjectInputBuffer, type PutObjectInputStream, type PutObjectResult, Region, type ScopedDeleteObjectInput, type ScopedGetObjectInput, ScopedObjectClient, type ScopedPutObjectInput, } from "./object/index.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/experimental/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,OAAO,EACP,UAAU,EACV,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,MAAM,EACN,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/experimental/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEtE,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,SAAS,EACT,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,MAAM,EACN,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,kBAAkB,EAClB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC"}

package/dist/experimental/index.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExperimentalClient = exports.ScopedBlobClient = exports.BlobClient = exports.BlobApi = void 0;
-var index_js_1 = require("./blob/index.js");
-Object.defineProperty(exports, "BlobApi", { enumerable: true, get: function () { return index_js_1.BlobApi; } });
-Object.defineProperty(exports, "BlobClient", { enumerable: true, get: function () { return index_js_1.BlobClient; } });
-Object.defineProperty(exports, "ScopedBlobClient", { enumerable: true, get: function () { return index_js_1.ScopedBlobClient; } });
+exports.ScopedObjectClient = exports.ObjectClient = exports.ObjectApi = exports.StorageClient = exports.ExperimentalClient = void 0;
 var experimental_js_1 = require("./experimental.js");
 Object.defineProperty(exports, "ExperimentalClient", { enumerable: true, get: function () { return experimental_js_1.ExperimentalClient; } });
+Object.defineProperty(exports, "StorageClient", { enumerable: true, get: function () { return experimental_js_1.StorageClient; } });
+var index_js_1 = require("./object/index.js");
+Object.defineProperty(exports, "ObjectApi", { enumerable: true, get: function () { return index_js_1.ObjectApi; } });
+Object.defineProperty(exports, "ObjectClient", { enumerable: true, get: function () { return index_js_1.ObjectClient; } });
+Object.defineProperty(exports, "ScopedObjectClient", { enumerable: true, get: function () { return index_js_1.ScopedObjectClient; } });

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

@@ -0,0 +1,11 @@
+import type { Client } from "openapi-fetch";
+import type { paths } from "../../generated/schema.js";
+import type { 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>;
+}
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +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"}

package/dist/experimental/object/api.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectApi = void 0;
+const errors_js_1 = require("../../errors.js");
+class ObjectApi {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    async getUploadUrl(ownerId, region, key, sizeBytes) {
+        const { data, error } = await this.apiClient.PUT("/blobs/{ownerId}/{region}/{key}", {
+            params: { path: { ownerId, region: region, key } },
+            body: { sizeBytes },
+        });
+        if (error) {
+            throw new errors_js_1.RenderError(`Failed to get upload URL: ${error.message || "Unknown error"}`);
+        }
+        return {
+            url: data.url,
+            expiresAt: new Date(data.expiresAt),
+            maxSizeBytes: data.maxSizeBytes,
+        };
+    }
+    async getDownloadUrl(ownerId, region, key) {
+        const { data, error } = await this.apiClient.GET("/blobs/{ownerId}/{region}/{key}", {
+            params: { path: { ownerId, region: region, key } },
+        });
+        if (error) {
+            throw new errors_js_1.RenderError(`Failed to get download URL: ${error.message || "Unknown error"}`);
+        }
+        return {
+            url: data.url,
+            expiresAt: new Date(data.expiresAt),
+        };
+    }
+    async delete(ownerId, region, key) {
+        const { error } = await this.apiClient.DELETE("/blobs/{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"}`);
+        }
+    }
+}
+exports.ObjectApi = ObjectApi;

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

@@ -0,0 +1,21 @@
+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";
+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>;
+    scoped(scope: ObjectScope): ScopedObjectClient;
+    private resolveSize;
+}
+export declare class ScopedObjectClient {
+    private readonly scope;
+    private readonly objectClient;
+    constructor(apiClient: Client<paths>, scope: ObjectScope);
+    put(input: ScopedPutObjectInput): Promise<PutObjectResult>;
+    get(input: ScopedGetObjectInput): Promise<ObjectData>;
+    delete(input: ScopedDeleteObjectInput): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +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"}

package/dist/experimental/object/client.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopedObjectClient = exports.ObjectClient = void 0;
+const errors_js_1 = require("../../errors.js");
+class ObjectClient {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+    }
+    async put(input) {
+        const size = this.resolveSize(input);
+        const { data, error } = await this.apiClient.PUT("/blobs/{ownerId}/{region}/{key}", {
+            params: {
+                path: {
+                    ownerId: input.ownerId,
+                    region: input.region,
+                    key: input.key,
+                },
+            },
+            body: { sizeBytes: size },
+        });
+        if (error) {
+            throw new errors_js_1.RenderError(`Failed to get upload URL: ${error.message || "Unknown error"}`);
+        }
+        const headers = {
+            "Content-Length": size.toString(),
+        };
+        if (input.contentType) {
+            headers["Content-Type"] = input.contentType;
+        }
+        const response = await fetch(data.url, {
+            method: "PUT",
+            headers,
+            body: input.data,
+            duplex: "half",
+        });
+        if (!response.ok) {
+            throw new errors_js_1.RenderError(`Upload failed: ${response.status} ${response.statusText}`);
+        }
+        return {
+            etag: response.headers.get("ETag") ?? undefined,
+        };
+    }
+    async get(input) {
+        const { data, error } = await this.apiClient.GET("/blobs/{ownerId}/{region}/{key}", {
+            params: {
+                path: {
+                    ownerId: input.ownerId,
+                    region: input.region,
+                    key: input.key,
+                },
+            },
+        });
+        if (error) {
+            throw new errors_js_1.RenderError(`Failed to get download URL: ${error.message || "Unknown error"}`);
+        }
+        const response = await fetch(data.url);
+        if (!response.ok) {
+            throw new errors_js_1.RenderError(`Download failed: ${response.status} ${response.statusText}`);
+        }
+        const arrayBuffer = await response.arrayBuffer();
+        const buffer = Buffer.from(arrayBuffer);
+        return {
+            data: buffer,
+            size: buffer.byteLength,
+            contentType: response.headers.get("Content-Type") ?? undefined,
+        };
+    }
+    async delete(input) {
+        const { error } = await this.apiClient.DELETE("/blobs/{ownerId}/{region}/{key}", {
+            params: {
+                path: {
+                    ownerId: input.ownerId,
+                    region: input.region,
+                    key: input.key,
+                },
+            },
+        });
+        if (error) {
+            throw new errors_js_1.RenderError(`Failed to delete object: ${error.message || "Unknown error"}`);
+        }
+    }
+    scoped(scope) {
+        return new ScopedObjectClient(this.apiClient, scope);
+    }
+    resolveSize(input) {
+        if (Buffer.isBuffer(input.data) || input.data instanceof Uint8Array) {
+            const actualSize = input.data.byteLength;
+            if (input.size !== undefined && input.size !== actualSize) {
+                throw new errors_js_1.RenderError(`Size mismatch: provided size ${input.size} does not match actual size ${actualSize}`);
+            }
+            return actualSize;
+        }
+        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");
+        }
+        return input.size;
+    }
+}
+exports.ObjectClient = ObjectClient;
+class ScopedObjectClient {
+    constructor(apiClient, scope) {
+        this.scope = scope;
+        this.objectClient = new ObjectClient(apiClient);
+    }
+    async put(input) {
+        return this.objectClient.put({
+            ...this.scope,
+            ...input,
+        });
+    }
+    async get(input) {
+        return this.objectClient.get({
+            ...this.scope,
+            ...input,
+        });
+    }
+    async delete(input) {
+        return this.objectClient.delete({
+            ...this.scope,
+            ...input,
+        });
+    }
+}
+exports.ScopedObjectClient = ScopedObjectClient;

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

@@ -0,0 +1,5 @@
+export { ObjectApi } from "./api.js";
+export { ObjectClient, ScopedObjectClient } from "./client.js";
+export type { DeleteObjectInput, GetObjectInput, ObjectData, ObjectIdentifier, ObjectScope, PresignedDownloadUrl, PresignedUploadUrl, PutObjectInput, PutObjectInputBuffer, PutObjectInputStream, PutObjectResult, ScopedDeleteObjectInput, ScopedGetObjectInput, ScopedPutObjectInput, } from "./types.js";
+export { Region } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/experimental/object/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE/D,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/dist/experimental/object/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopedObjectClient = exports.ObjectClient = exports.ObjectApi = void 0;
+var api_js_1 = require("./api.js");
+Object.defineProperty(exports, "ObjectApi", { enumerable: true, get: function () { return api_js_1.ObjectApi; } });
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "ObjectClient", { enumerable: true, get: function () { return client_js_1.ObjectClient; } });
+Object.defineProperty(exports, "ScopedObjectClient", { enumerable: true, get: function () { return client_js_1.ScopedObjectClient; } });

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

@@ -0,0 +1,49 @@
+import type { Readable } from "node:stream";
+export type Region = "frankfurt" | "oregon" | "ohio" | "singapore" | "virginia";
+export interface ObjectIdentifier {
+    ownerId: `tea-${string}`;
+    region: Region | string;
+    key: string;
+}
+interface PutObjectInputBase extends ObjectIdentifier {
+    contentType?: string;
+}
+export interface PutObjectInputBuffer extends PutObjectInputBase {
+    data: Buffer | Uint8Array | string;
+    size?: number;
+}
+export interface PutObjectInputStream extends PutObjectInputBase {
+    data: Readable;
+    size: number;
+}
+export type PutObjectInput = PutObjectInputBuffer | PutObjectInputStream;
+export interface GetObjectInput extends ObjectIdentifier {
+}
+export interface DeleteObjectInput extends ObjectIdentifier {
+}
+export interface PresignedUploadUrl {
+    url: string;
+    expiresAt: Date;
+    maxSizeBytes: number;
+}
+export interface PresignedDownloadUrl {
+    url: string;
+    expiresAt: Date;
+}
+export interface ObjectData {
+    data: Buffer;
+    contentType?: string;
+    size: number;
+}
+export interface PutObjectResult {
+    etag?: string;
+}
+export interface ObjectScope {
+    ownerId: `tea-${string}`;
+    region: Region | string;
+}
+export type ScopedPutObjectInput = Omit<PutObjectInput, keyof ObjectScope>;
+export type ScopedGetObjectInput = Omit<GetObjectInput, keyof ObjectScope>;
+export type ScopedDeleteObjectInput = Omit<DeleteObjectInput, keyof ObjectScope>;
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/experimental/object/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5C,MAAM,MAAM,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;AAKhF,MAAM,WAAW,gBAAgB;IAE/B,OAAO,EAAE,OAAO,MAAM,EAAE,CAAC;IAEzB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAExB,GAAG,EAAE,MAAM,CAAC;CACb;AAKD,UAAU,kBAAmB,SAAQ,gBAAgB;IAEnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAE9D,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IAEnC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAE9D,IAAI,EAAE,QAAQ,CAAC;IAEf,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAKzE,MAAM,WAAW,cAAe,SAAQ,gBAAgB;CAAG;AAK3D,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;CAAG;AAK9D,MAAM,WAAW,kBAAkB;IAEjC,GAAG,EAAE,MAAM,CAAC;IAEZ,SAAS,EAAE,IAAI,CAAC;IAEhB,YAAY,EAAE,MAAM,CAAC;CACtB;AAKD,MAAM,WAAW,oBAAoB;IAEnC,GAAG,EAAE,MAAM,CAAC;IAEZ,SAAS,EAAE,IAAI,CAAC;CACjB;AAKD,MAAM,WAAW,UAAU;IAEzB,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,IAAI,EAAE,MAAM,CAAC;CACd;AAKD,MAAM,WAAW,eAAe;IAE9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAKD,MAAM,WAAW,WAAW;IAE1B,OAAO,EAAE,OAAO,MAAM,EAAE,CAAC;IAEzB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAKD,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,WAAW,CAAC,CAAC;AAK3E,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,WAAW,CAAC,CAAC;AAK3E,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,WAAW,CAAC,CAAC"}