@renderinc/sdk 0.2.0 → 0.2.1

package/dist/workflows/uds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uds.d.ts","sourceRoot":"","sources":["../../src/workflows/uds.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,gBAAgB,EAEhB,wBAAwB,EAIxB,YAAY,EACb,MAAM,YAAY,CAAC;AAKpB,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,MAAM;IAKzC,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAI3C,OAAO,CAAC,iBAAiB;IAyBnB,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAa3D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAUtE,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAa3C,OAAO;CAiFtB"}
+{"version":3,"file":"uds.d.ts","sourceRoot":"","sources":["../../src/workflows/uds.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,gBAAgB,EAEhB,wBAAwB,EAIxB,YAAY,EACb,MAAM,YAAY,CAAC;AAKpB,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,MAAM;IAKzC,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAI3C,OAAO,CAAC,iBAAiB;IAyBnB,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAa3D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAUtE,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAa3C,OAAO;CA2CtB"}

package/dist/workflows/uds.js

@@ -1,9 +1,11 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UDSClient = void 0;
-const node_net_1 = require("node:net");
+const node_http_1 = __importDefault(require("node:http"));
 const version_js_1 = require("../version.js");
-const CONTENT_LENGTH_REGEX = /Content-Length:\s*(\d+)/i;
 class UDSClient {
     constructor(socketPath) {
         this.socketPath = socketPath;
@@ -59,66 +61,39 @@ class UDSClient {
     }
     async request(path, method, body) {
         return new Promise((resolve, reject) => {
-            const client = (0, node_net_1.createConnection)({ path: this.socketPath }, () => {
-                const bodyStr = body ? JSON.stringify(body) : "";
-                const userAgent = (0, version_js_1.getUserAgent)();
-                const request = `${method} ${path} HTTP/1.1\r\nHost: unix\r\nContent-Length: ${bodyStr.length}\r\nContent-Type: application/json\r\nUser-Agent: ${userAgent}\r\n\r\n${bodyStr}`;
-                client.write(request);
-            });
-            let data = "";
-            let contentLength = null;
-            let headersParsed = false;
-            let bodyStartIndex = -1;
-            client.on("data", (chunk) => {
-                data += chunk.toString();
-                if (!headersParsed) {
-                    const headerEndIndex = data.indexOf("\r\n\r\n");
-                    if (headerEndIndex !== -1) {
-                        headersParsed = true;
-                        bodyStartIndex = headerEndIndex + 4;
-                        const headers = data.substring(0, headerEndIndex);
-                        const contentLengthMatch = headers.match(CONTENT_LENGTH_REGEX);
-                        if (contentLengthMatch) {
-                            contentLength = Number.parseInt(contentLengthMatch[1], 10);
-                        }
-                    }
+            const req = node_http_1.default.request({
+                socketPath: this.socketPath,
+                path: path,
+                method: method,
+                headers: {
+                    "Content-Length": body ? JSON.stringify(body).length : 0,
+                    "Content-Type": "application/json",
+                    "User-Agent": (0, version_js_1.getUserAgent)(),
+                },
+            }, async (res) => {
+                const chunks = [];
+                for await (const chunk of res)
+                    chunks.push(chunk);
+                const responseBody = Buffer.concat(chunks).toString();
+                if (res.statusCode && res.statusCode >= 400) {
+                    reject(new Error(`HTTP ${res.statusCode}: ${responseBody}`));
+                    return;
                 }
-                if (headersParsed && contentLength !== null) {
-                    const bodyReceived = data.length - bodyStartIndex;
-                    if (bodyReceived >= contentLength) {
-                        client.end();
-                    }
+                if (responseBody.length === 0) {
+                    resolve(undefined);
+                    return;
                 }
-            });
-            client.on("end", () => {
                 try {
-                    const lines = data.split("\r\n");
-                    const statusLine = lines[0];
-                    const statusCode = Number.parseInt(statusLine.split(" ")[1], 10);
-                    if (statusCode >= 400) {
-                        reject(new Error(`HTTP ${statusCode}: ${data}`));
-                        return;
-                    }
-                    const emptyLineIndex = lines.indexOf("");
-                    if (emptyLineIndex === -1) {
-                        resolve(undefined);
-                        return;
-                    }
-                    const bodyLines = lines.slice(emptyLineIndex + 1);
-                    const responseBody = bodyLines.join("\r\n").trim();
-                    if (!responseBody) {
-                        resolve(undefined);
-                        return;
-                    }
                     resolve(JSON.parse(responseBody));
                 }
                 catch (error) {
                     reject(error);
                 }
             });
-            client.on("error", (error) => {
+            req.on("error", (error) => {
                 reject(error);
             });
+            req.end(body ? JSON.stringify(body) : "");
         });
     }
 }

package/examples/client/main.ts

@@ -1,4 +1,4 @@
-import { Render, ServerError } from "@render/sdk";
+import { Render, ServerError } from "@renderinc/sdk";
 
 /**
  * Example: Using the REST API client to run tasks

package/examples/client/package-lock.json

@@ -8,7 +8,7 @@
       "name": "render-sdk-client-example",
       "version": "1.0.0",
       "dependencies": {
-        "@render/sdk": "file:../.."
+        "@renderinc/sdk": "file:../.."
       },
       "devDependencies": {
         "@types/node": "22.19.0",
@@ -16,7 +16,7 @@
       }
     },
     "../..": {
-      "name": "@render/sdk",
+      "name": "@renderinc/sdk",
       "version": "0.2.0",
       "license": "MIT",
       "dependencies": {
@@ -28,7 +28,7 @@
         "@types/node": "^20.0.0",
         "openapi-typescript": "^7.10.1",
         "typescript": "^5.9.3",
-        "vitest": "^1.0.0"
+        "vitest": "^4.0.18"
       },
       "engines": {
         "node": ">=18.0.0"
@@ -476,7 +476,7 @@
         "node": ">=18"
       }
     },
-    "node_modules/@render/sdk": {
+    "node_modules/@renderinc/sdk": {
       "resolved": "../..",
       "link": true
     },

package/examples/client/package.json

@@ -7,7 +7,7 @@
     "start": "tsx main.ts"
   },
   "dependencies": {
-    "@render/sdk": "file:../.."
+    "@renderinc/sdk": "file:../.."
   },
   "devDependencies": {
     "@types/node": "22.19.0",

package/examples/task/main.ts

@@ -1,4 +1,4 @@
-import { task } from "@render/sdk/workflows";
+import { task } from "@renderinc/sdk/workflows";
 
 /**
  * Simple task that squares a number

package/examples/task/package-lock.json

@@ -9,15 +9,15 @@
       "version": "1.0.0",
       "hasInstallScript": true,
       "dependencies": {
-        "@render/sdk": "file:../.."
+        "@renderinc/sdk": "file:../.."
       },
       "devDependencies": {
         "tsx": "^4.0.0"
       }
     },
     "../..": {
-      "name": "@render/sdk",
-      "version": "0.1.0",
+      "name": "@renderinc/sdk",
+      "version": "0.2.0",
       "license": "MIT",
       "dependencies": {
         "eventsource": "^4.0.0",
@@ -25,11 +25,10 @@
       },
       "devDependencies": {
         "@biomejs/biome": "2.3.8",
-        "@types/eventsource": "^3.0.0",
         "@types/node": "^20.0.0",
         "openapi-typescript": "^7.10.1",
         "typescript": "^5.9.3",
-        "vitest": "^1.0.0"
+        "vitest": "^4.0.18"
       },
       "engines": {
         "node": ">=18.0.0"
@@ -477,7 +476,7 @@
         "node": ">=18"
       }
     },
-    "node_modules/@render/sdk": {
+    "node_modules/@renderinc/sdk": {
       "resolved": "../..",
       "link": true
     },

package/examples/task/package.json

@@ -8,7 +8,7 @@
     "start": "tsx main.ts"
   },
   "dependencies": {
-    "@render/sdk": "file:../.."
+    "@renderinc/sdk": "file:../.."
   },
   "devDependencies": {
     "tsx": "^4.0.0"

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@renderinc/sdk",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Render SDK for TypeScript",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "test": "vitest",
+    "typecheck": "tsc --noEmit",
     "lint": "biome lint",
     "lint:fix": "biome lint --write",
     "format": "biome format --write",
@@ -27,7 +28,7 @@
     "@types/node": "^20.0.0",
     "openapi-typescript": "^7.10.1",
     "typescript": "^5.9.3",
-    "vitest": "^1.0.0"
+    "vitest": "^4.0.18"
   },
   "dependencies": {
     "eventsource": "^4.0.0",
@@ -38,19 +39,19 @@
   },
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.js"
     },
     "./workflows": {
+      "types": "./dist/workflows/index.d.ts",
       "import": "./dist/workflows/index.js",
-      "require": "./dist/workflows/index.js",
-      "types": "./dist/workflows/index.d.ts"
+      "require": "./dist/workflows/index.js"
     },
     "./experimental": {
+      "types": "./dist/experimental/index.d.ts",
       "import": "./dist/experimental/index.js",
-      "require": "./dist/experimental/index.js",
-      "types": "./dist/experimental/index.d.ts"
+      "require": "./dist/experimental/index.js"
     }
   }
 }

package/src/errors.test.ts

@@ -0,0 +1,75 @@
+import {
+  AbortError,
+  ClientError,
+  RenderError,
+  ServerError,
+  TaskRunError,
+  TimeoutError,
+} from "./errors.js";
+
+describe("errors", () => {
+  describe("RenderError", () => {
+    it("has correct name and message", () => {
+      const err = new RenderError("test message");
+      expect(err.name).toBe("RenderError");
+      expect(err.message).toBe("test message");
+      expect(err instanceof Error).toBe(true);
+      expect(err instanceof RenderError).toBe(true);
+    });
+  });
+
+  describe("TaskRunError", () => {
+    it("has correct name and properties", () => {
+      const err = new TaskRunError("task failed", "run-123", "internal error");
+      expect(err.name).toBe("TaskRunError");
+      expect(err.message).toBe("task failed");
+      expect(err.taskRunId).toBe("run-123");
+      expect(err.taskError).toBe("internal error");
+      expect(err instanceof RenderError).toBe(true);
+    });
+
+    it("works with optional properties", () => {
+      const err = new TaskRunError("task failed");
+      expect(err.taskRunId).toBeUndefined();
+      expect(err.taskError).toBeUndefined();
+    });
+  });
+
+  describe("ClientError", () => {
+    it("has correct name and properties", () => {
+      const err = new ClientError("not found", 404, { detail: "missing" });
+      expect(err.name).toBe("ClientError");
+      expect(err.statusCode).toBe(404);
+      expect(err.response).toEqual({ detail: "missing" });
+      expect(err instanceof RenderError).toBe(true);
+    });
+  });
+
+  describe("ServerError", () => {
+    it("has correct name and properties", () => {
+      const err = new ServerError("server error", 500, { detail: "crash" });
+      expect(err.name).toBe("ServerError");
+      expect(err.statusCode).toBe(500);
+      expect(err.response).toEqual({ detail: "crash" });
+      expect(err instanceof RenderError).toBe(true);
+    });
+  });
+
+  describe("TimeoutError", () => {
+    it("has correct name and inherits from RenderError", () => {
+      const err = new TimeoutError("request timed out");
+      expect(err.name).toBe("TimeoutError");
+      expect(err.message).toBe("request timed out");
+      expect(err instanceof RenderError).toBe(true);
+    });
+  });
+
+  describe("AbortError", () => {
+    it("has correct name and fixed message", () => {
+      const err = new AbortError();
+      expect(err.name).toBe("AbortError");
+      expect(err.message).toBe("The operation was aborted.");
+      expect(err instanceof Error).toBe(true);
+    });
+  });
+});

package/src/experimental/experimental.ts

@@ -1,6 +1,29 @@
 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";
+
+/**
+ * StorageClient provides access to experimental storage features
+ *
+ * @example
+ * ```typescript
+ * // Access object storage
+ * await render.experimental.storage.objects.put({
+ *   ownerId: "tea-xxxxx",
+ *   region: "oregon",
+ *   key: "file.png",
+ *   data: buffer
+ * });
+ * ```
+ */
+export class StorageClient {
+  /** Object storage client for managing binary objects */
+  public readonly objects: ObjectClient;
+
+  constructor(apiClient: Client<paths>) {
+    this.objects = new ObjectClient(apiClient);
+  }
+}
 
 /**
  * ExperimentalClient provides access to experimental Render SDK features
@@ -10,12 +33,12 @@ import { BlobClient } from "./blob/client.js";
  *
  * @example
  * ```typescript
- * import { Render } from '@render/sdk';
+ * import { Render } from '@renderinc/sdk';
  *
  * const render = new Render();
  *
- * // Access experimental blob storage
- * await render.experimental.blob.put({
+ * // Access experimental object storage
+ * await render.experimental.storage.objects.put({
  *   ownerId: "tea-xxxxx",
  *   region: "oregon",
  *   key: "file.png",
@@ -24,10 +47,10 @@ import { BlobClient } from "./blob/client.js";
  * ```
  */
 export class ExperimentalClient {
-  /** Blob storage client for managing binary objects */
-  public readonly blob: BlobClient;
+  /** Storage client for managing storage features */
+  public readonly storage: StorageClient;
 
   constructor(apiClient: Client<paths>) {
-    this.blob = new BlobClient(apiClient);
+    this.storage = new StorageClient(apiClient);
   }
 }

package/src/experimental/index.ts

@@ -1,24 +1,24 @@
 // Experimental client
 
-// Blob storage exports
+export { ExperimentalClient, StorageClient } from "./experimental.js";
+// Object storage exports
 export {
-  BlobApi,
-  BlobClient,
-  type BlobData,
-  type BlobIdentifier,
-  type BlobScope,
-  type DeleteBlobInput,
-  type GetBlobInput,
+  type DeleteObjectInput,
+  type GetObjectInput,
+  ObjectApi,
+  ObjectClient,
+  type ObjectData,
+  type ObjectIdentifier,
+  type ObjectScope,
   type PresignedDownloadUrl,
   type PresignedUploadUrl,
-  type PutBlobInput,
-  type PutBlobInputBuffer,
-  type PutBlobInputStream,
-  type PutBlobResult,
+  type PutObjectInput,
+  type PutObjectInputBuffer,
+  type PutObjectInputStream,
+  type PutObjectResult,
   Region,
-  ScopedBlobClient,
-  type ScopedDeleteBlobInput,
-  type ScopedGetBlobInput,
-  type ScopedPutBlobInput,
-} from "./blob/index.js";
-export { ExperimentalClient } from "./experimental.js";
+  type ScopedDeleteObjectInput,
+  type ScopedGetObjectInput,
+  ScopedObjectClient,
+  type ScopedPutObjectInput,
+} from "./object/index.js";

package/src/experimental/{blob → object}/api.ts

@@ -4,23 +4,23 @@ import type { paths } from "../../generated/schema.js";
 import type { PresignedDownloadUrl, PresignedUploadUrl, Region } from "./types.js";
 
 /**
- * Layer 2: Typed Blob API Client
+ * Layer 2: Typed Object API Client
  *
  * Provides idiomatic TypeScript wrapper around the raw OpenAPI client.
  * Handles presigned URL flow but still exposes the two-step nature
  * (get URL, then upload/download). Useful for advanced use cases
  * requiring fine-grained control.
  */
-export class BlobApi {
+export class ObjectApi {
   constructor(private readonly apiClient: Client<paths>) {}
 
   /**
-   * Get a presigned URL for uploading a blob
+   * Get a presigned URL for uploading an object
    *
    * @param ownerId - Owner ID (workspace team ID)
    * @param region - Storage region
    * @param key - Object key (path)
-   * @param sizeBytes - Size of the blob in bytes
+   * @param sizeBytes - Size of the object in bytes
    * @returns Presigned upload URL with expiration and size limit
    */
   async getUploadUrl(
@@ -46,7 +46,7 @@ export class BlobApi {
   }
 
   /**
-   * Get a presigned URL for downloading a blob
+   * Get a presigned URL for downloading an object
    *
    * @param ownerId - Owner ID (workspace team ID)
    * @param region - Storage region
@@ -73,7 +73,7 @@ export class BlobApi {
   }
 
   /**
-   * Delete a blob
+   * Delete an object
    *
    * @param ownerId - Owner ID (workspace team ID)
    * @param region - Storage region
@@ -85,7 +85,7 @@ export class BlobApi {
     });
 
     if (error) {
-      throw new RenderError(`Failed to delete blob: ${error.message || "Unknown error"}`);
+      throw new RenderError(`Failed to delete object: ${error.message || "Unknown error"}`);
     }
   }
 }

package/src/experimental/object/client.test.ts

@@ -0,0 +1,138 @@
+import { Readable } from "node:stream";
+import type { Client } from "openapi-fetch";
+import { RenderError } from "../../errors.js";
+import type { paths } from "../../generated/schema.js";
+import { ObjectClient } from "./client.js";
+import type { PutObjectInput } from "./types.js";
+
+describe("ObjectClient", () => {
+  describe("resolveSize (via put validation)", () => {
+    // Test resolveSize indirectly by calling put() which will fail
+    // at the API call stage, but size validation happens first.
+    const putMock = vi.fn().mockRejectedValue(new Error("should not reach API"));
+    const mockApiClient = { PUT: putMock } as unknown as Client<paths>;
+
+    const client = new ObjectClient(mockApiClient);
+
+    it("auto-calculates Buffer size", async () => {
+      const buffer = Buffer.from("hello");
+      putMock.mockResolvedValueOnce({
+        data: { url: "http://test" },
+        error: null,
+      });
+
+      // Will fail at fetch, but that's after size validation
+      await expect(
+        client.put({
+          ownerId: "tea-test",
+          region: "oregon",
+          key: "test.txt",
+          data: buffer,
+        }),
+      ).rejects.toThrow(); // fetch not available in test
+
+      expect(putMock).toHaveBeenCalledWith(
+        "/blobs/{ownerId}/{region}/{key}",
+        expect.objectContaining({
+          body: { sizeBytes: 5 },
+        }),
+      );
+    });
+
+    it("auto-calculates Uint8Array size", async () => {
+      const arr = new Uint8Array([1, 2, 3, 4]);
+      putMock.mockResolvedValueOnce({
+        data: { url: "http://test" },
+        error: null,
+      });
+
+      await expect(
+        client.put({
+          ownerId: "tea-test",
+          region: "oregon",
+          key: "test.bin",
+          data: arr,
+        }),
+      ).rejects.toThrow();
+
+      expect(putMock).toHaveBeenCalledWith(
+        "/blobs/{ownerId}/{region}/{key}",
+        expect.objectContaining({
+          body: { sizeBytes: 4 },
+        }),
+      );
+    });
+
+    it("throws on size mismatch for Buffer", async () => {
+      const buffer = Buffer.from("hello");
+      await expect(
+        client.put({
+          ownerId: "tea-test",
+          region: "oregon",
+          key: "test.txt",
+          data: buffer,
+          size: 10,
+        }),
+      ).rejects.toThrow(RenderError);
+      await expect(
+        client.put({
+          ownerId: "tea-test",
+          region: "oregon",
+          key: "test.txt",
+          data: buffer,
+          size: 10,
+        }),
+      ).rejects.toThrow("Size mismatch");
+    });
+
+    it("requires size for stream input", async () => {
+      const stream = Readable.from(["hello"]);
+      const invalidInput = {
+        ownerId: "tea-test",
+        region: "oregon",
+        key: "test.txt",
+        data: stream,
+        // Intentionally omit size to test validation (invalid at runtime)
+      } as unknown as PutObjectInput;
+      await expect(client.put(invalidInput)).rejects.toThrow(RenderError);
+      await expect(client.put(invalidInput)).rejects.toThrow("Size is required");
+    });
+
+    it("requires size for string input", async () => {
+      await expect(
+        client.put({
+          ownerId: "tea-test",
+          region: "oregon",
+          key: "test.txt",
+          data: "hello",
+        }),
+      ).rejects.toThrow("Size is required");
+    });
+
+    it("throws on zero size", async () => {
+      const stream = Readable.from(["hello"]);
+      await expect(
+        client.put({
+          ownerId: "tea-test",
+          region: "oregon",
+          key: "test.txt",
+          data: stream,
+          size: 0,
+        }),
+      ).rejects.toThrow("Size must be a positive integer");
+    });
+
+    it("throws on negative size", async () => {
+      const stream = Readable.from(["hello"]);
+      await expect(
+        client.put({
+          ownerId: "tea-test",
+          region: "oregon",
+          key: "test.txt",
+          data: stream,
+          size: -1,
+        }),
+      ).rejects.toThrow("Size must be a positive integer");
+    });
+  });
+});