terse-types 0.6.0 → 0.6.2

package/dist/ActorDiagnostics.d.ts

@@ -0,0 +1,4 @@
+/** Translate known runtime guidance, leaving source paths and dependency details intact. */
+export declare function formatActorDiagnostic(message: string): string;
+/** Keep the error class, invocation code, request ID, cause, and stack frames. */
+export declare function rethrowActorError(error: unknown): never;

package/dist/ActorDiagnostics.js

@@ -0,0 +1,33 @@
+/** Translate known runtime guidance, leaving source paths and dependency details intact. */
+export function formatActorDiagnostic(message) {
+    return message
+        .split("\n")
+        .map(line => {
+        if (/^\s*at\s/.test(line))
+            return line;
+        return line
+            .replaceAll("cannot resolve the durable-actors SDK", "Cannot resolve the Terse SDK. Install terse-sdk in your actor project")
+            .replaceAll("the durable-actors application credential was rejected", "Actor authentication failed. Check TERSE_API_KEY for the selected server")
+            .replaceAll("durable-actors client settings are invalid", "Terse actor client settings are invalid")
+            .replace(/\bdurable-actors generate --remote\b/g, "terse actor generate")
+            .replace(/\bdurable-actors dev\b/g, "terse actor dev")
+            .replace(/\bDURABLE_ACTORS_PROJECT_ID\b/g, "TERSE_ACTOR_PROJECT_ID")
+            .replace(/\bDURABLE_ACTORS_PORT\b/g, "TERSE_ACTOR_PORT")
+            .replace(/\bDURABLE_ACTORS_SECRET\b/g, "TERSE_ACTOR_SECRET");
+    })
+        .join("\n");
+}
+/** Keep the error class, invocation code, request ID, cause, and stack frames. */
+export function rethrowActorError(error) {
+    if (error instanceof Error) {
+        const message = formatActorDiagnostic(error.message);
+        if (message !== error.message) {
+            const heading = `${error.name}: ${error.message}`;
+            const stack = error.stack;
+            error.message = message;
+            if (stack?.startsWith(heading))
+                error.stack = `${error.name}: ${message}${stack.slice(heading.length)}`;
+        }
+    }
+    throw error;
+}

package/dist/ActorEndpoint.d.ts

@@ -1,3 +1,6 @@
+export declare const DEFAULT_ACTOR_DEV_PORT = 7100;
+export declare const DEFAULT_ACTOR_DEV_PROJECT_ID = "local";
+export declare const DEFAULT_ACTOR_URL = "http://127.0.0.1:7100/v1/projects/local/actors";
 export interface ActorEndpoint {
     kind: "terse" | "runtime";
     origin: string;
@@ -5,5 +8,6 @@ export interface ActorEndpoint {
     actorUrl: string;
     contractUrl: string;
 }
-/** The URL selects the API explicitly; localhost alone never changes authentication or routing. */
+export declare function isLocalActorEndpoint(endpoint: ActorEndpoint): boolean;
+/** The URL path selects the Terse API or native actor runtime explicitly. */
 export declare function parseActorEndpoint(value: string): ActorEndpoint;

package/dist/ActorEndpoint.js

@@ -1,4 +1,10 @@
-/** The URL selects the API explicitly; localhost alone never changes authentication or routing. */
+export const DEFAULT_ACTOR_DEV_PORT = 7100;
+export const DEFAULT_ACTOR_DEV_PROJECT_ID = "local";
+export const DEFAULT_ACTOR_URL = `http://127.0.0.1:${DEFAULT_ACTOR_DEV_PORT}/v1/projects/${DEFAULT_ACTOR_DEV_PROJECT_ID}/actors`;
+export function isLocalActorEndpoint(endpoint) {
+    return endpoint.kind === "runtime" && ["localhost", "127.0.0.1", "[::1]"].includes(new URL(endpoint.origin).hostname);
+}
+/** The URL path selects the Terse API or native actor runtime explicitly. */
 export function parseActorEndpoint(value) {
     const invalid = () => new Error("TERSE_ACTOR_URL must be an HTTP(S) URL ending in /<projectId>/actors or /v1/projects/<projectId>/actors, without credentials, query, or fragment");
     let url;

package/dist/types.d.ts

@@ -291,8 +291,8 @@ export declare const deviceTokenExchangeResponseSchema: z.ZodObject<{
 export type DeviceTokenExchangeResponse = z.infer<typeof deviceTokenExchangeResponseSchema>;
 export declare const authModeResponseSchema: z.ZodObject<{
     mode: z.ZodEnum<{
-        workos: "workos";
         local: "local";
+        workos: "workos";
     }>;
 }, z.core.$strip>;
 export type AuthModeResponse = z.infer<typeof authModeResponseSchema>;

package/dist/types.js

@@ -698,7 +698,7 @@ export const sdkDeployRequestBodySchema = z
     cliVersion: z.string(),
     jobs: z.array(sdkDeployJobSchema),
     actorTypes: z.array(z.string().min(1)).optional(),
-    /** Public actor API compiled by little-actors; validated by the control plane on registration. */
+    /** Public actor API compiled by durable-actors; validated by the control plane on registration. */
     actorContract: z.record(z.string(), z.json()).optional(),
     remoteServerUrl: z.string().optional(),
     sourceZipBase64: z.string().optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terse-types",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "type": "module",
   "description": "Shared Terse TypeScript types, enums, constants, and helpers.",
   "main": "./dist/index.js",