terse-sdk 0.6.1 → 0.6.2

package/README.md

@@ -51,7 +51,7 @@ createJob({
 
 ## Core concepts
 
-For actor development, run `terse actor serve` in the actor source project. Copy the printed `TERSE_ACTOR_URL` and `TERSE_API_KEY` into your app backend environment, then run `terse actor generate` in the app project. Generated actor clients use the same settings for RPC and WebSocket authorization, including when the app lives in a separate repository. Regenerate after public API changes; no production deployment is needed. See the [local actor development guide](../terse-cli/README.md#developing-actors).
+For actor development, run `terse actor dev` in the actor source project, then `terse actor generate` in your app project. Both the generator and SDK default to the local server on port `7100`, project `local`, with no API key. Set `TERSE_ACTOR_URL` and, when required, `TERSE_API_KEY` only to override those defaults or connect to deployed actors. Regenerate after public API changes. See the [local actor development guide](../terse-cli/README.md#developing-actors).
 
 | Concept | What it is |
 |---|---|

package/dist/actorHost.d.ts

@@ -1,2 +1,2 @@
-export { runDurableObjectHost } from "durable-actors/host";
+export { runActorHost } from "durable-actors/host";
 //# sourceMappingURL=actorHost.d.ts.map

package/dist/actorHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actorHost.d.ts","sourceRoot":"","sources":["../src/actorHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"actorHost.d.ts","sourceRoot":"","sources":["../src/actorHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/actorHost.js

@@ -1,2 +1,2 @@
-export { runDurableObjectHost } from "durable-actors/host";
+export { runActorHost } from "durable-actors/host";
 //# sourceMappingURL=actorHost.js.map

package/dist/actorHost.js.map

@@ -1 +1 @@
-{"version":3,"file":"actorHost.js","sourceRoot":"","sources":["../src/actorHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"actorHost.js","sourceRoot":"","sources":["../src/actorHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/actors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actors.d.ts","sourceRoot":"","sources":["../src/actors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAmE,MAAM,wBAAwB,CAAA;AAKrJ,OAAO,EAAc,KAAK,UAAU,EAAE,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAA;AA+BzG,wBAAgB,eAAe,CAAC,IAAI,SAAS,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,cAAc,EAAE,EAAE,SAAS,GAAE,iBAAkC,GAAG,IAAI,CAEhL;AAYD,MAAM,WAAW,uBAAuB;IACpC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAClC;AAED,qBAAa,WAAW,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAE1D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,uBAA4B;IAGzD,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;CAYjF;AAED,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"actors.d.ts","sourceRoot":"","sources":["../src/actors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAmE,MAAM,wBAAwB,CAAA;AAMrJ,OAAO,EAAc,KAAK,UAAU,EAAE,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAmCzG,wBAAgB,eAAe,CAAC,IAAI,SAAS,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,cAAc,EAAE,EAAE,SAAS,GAAE,iBAAkC,GAAG,IAAI,CAEhL;AAWD,MAAM,WAAW,uBAAuB;IACpC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAClC;AAED,qBAAa,WAAW,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAE1D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,uBAA4B;IAGzD,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;CAkBjF;AAED,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/actors.js

@@ -1,6 +1,7 @@
 import { createActorTransport, createActorStub as createDurableActorStub } from "durable-actors/backend";
 import { SocketProxy as RuntimeSocketProxy } from "durable-actors/proxy";
-import { parseActorEndpoint } from "terse-types/ActorEndpoint";
+import { rethrowActorError } from "terse-types/ActorDiagnostics";
+import { DEFAULT_ACTOR_URL, isLocalActorEndpoint, parseActorEndpoint } from "terse-types/ActorEndpoint";
 import { z } from "zod";
 import { ActorProxy } from "./actorProxy.js";
 const invocationResultSchema = z.object({ result: z.json() });
@@ -9,7 +10,12 @@ const terseTransport = {
         const { endpoint, apiKey } = actorConnectionSettings();
         if (endpoint.kind === "runtime") {
             // Source reloads replace actor hosts. Resolve the current host for each call.
-            return createActorTransport({ projectId: endpoint.projectId, controlPlaneUrl: endpoint.origin, apiKey }).invoke(actorName, actorId, method, args);
+            try {
+                return await createActorTransport({ projectId: endpoint.projectId, controlPlaneUrl: endpoint.origin, apiKey: apiKey || undefined }).invoke(actorName, actorId, method, args);
+            }
+            catch (error) {
+                rethrowActorError(error);
+            }
         }
         const response = await fetch(`${endpoint.actorUrl}/invoke`, {
             method: "POST",
@@ -33,13 +39,12 @@ export function createActorStub(actorName, actorId, methods, transport = terseTr
     return createDurableActorStub(actorName, actorId, methods, transport);
 }
 function actorConnectionSettings() {
-    const actorUrl = process.env.TERSE_ACTOR_URL?.trim();
-    const apiKey = process.env.TERSE_API_KEY?.trim();
-    if (!actorUrl || !apiKey) {
-        const missing = [!actorUrl && "TERSE_ACTOR_URL", !apiKey && "TERSE_API_KEY"].filter(Boolean);
-        throw new Error(`Missing ${missing.join(" and ")}. Set ${missing.length === 1 ? "it" : "them"} in the .env of the project calling the actor.`);
+    const endpoint = parseActorEndpoint(process.env.TERSE_ACTOR_URL?.trim() || DEFAULT_ACTOR_URL);
+    const apiKey = process.env.TERSE_API_KEY?.trim() || "";
+    if (!apiKey && !isLocalActorEndpoint(endpoint)) {
+        throw new Error("Missing TERSE_API_KEY. Set it in the .env of the project calling the actor.");
     }
-    return { endpoint: parseActorEndpoint(actorUrl), apiKey };
+    return { endpoint, apiKey };
 }
 export class SocketProxy {
     actors;
@@ -51,7 +56,12 @@ export class SocketProxy {
     async handle(authorization) {
         const { endpoint, apiKey } = actorConnectionSettings();
         if (endpoint.kind === "runtime") {
-            return new RuntimeSocketProxy(this.actors, { projectId: endpoint.projectId, controlPlaneUrl: endpoint.origin, apiKey }, this.dependencies).handle(authorization);
+            try {
+                return await new RuntimeSocketProxy(this.actors, { projectId: endpoint.projectId, controlPlaneUrl: endpoint.origin, apiKey: apiKey || undefined }, this.dependencies).handle(authorization);
+            }
+            catch (error) {
+                rethrowActorError(error);
+            }
         }
         return new ActorProxy(this.actors, {
             projectId: endpoint.projectId,

package/dist/actors.js.map

@@ -1 +1 @@
-{"version":3,"file":"actors.js","sourceRoot":"","sources":["../src/actors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"actors.js","sourceRoot":"","sources":["../src/actors.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terse-sdk",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE.md",
   "repository": {
@@ -42,10 +42,10 @@
     "zod": "^4.3.6"
   },
   "dependencies": {
-    "durable-actors": "0.2.4",
+    "durable-actors": "0.3.1",
     "little-durable": "0.1.3",
     "ms": "2.1.3",
-    "terse-types": "0.6.1"
+    "terse-types": "0.6.2"
   },
   "scripts": {
     "build": "rm -rf dist && tsc",