terse-types 0.6.1 → 0.6.3

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/ActorSource.d.ts

@@ -0,0 +1,4 @@
+export declare const ACTOR_ENTRY_FILE = "src/actor.ts";
+export declare const LEGACY_ACTOR_ENTRY_FILE = "src/actors.ts";
+/** Share discovery between the local CLI and uploaded deployment archives. */
+export declare function findActorEntryFile(hasFile: (file: string) => boolean): string | undefined;

package/dist/ActorSource.js

@@ -0,0 +1,6 @@
+export const ACTOR_ENTRY_FILE = "src/actor.ts";
+export const LEGACY_ACTOR_ENTRY_FILE = "src/actors.ts";
+/** Share discovery between the local CLI and uploaded deployment archives. */
+export function findActorEntryFile(hasFile) {
+    return [ACTOR_ENTRY_FILE, LEGACY_ACTOR_ENTRY_FILE].find(hasFile);
+}

package/dist/ProductFeatures.d.ts

@@ -0,0 +1,5 @@
+/** Keep this key and cutoff aligned with the Actors-only flag in PostHog. */
+export declare const ACTORS_ONLY_FLAG = "Actors-only";
+export declare const ACTORS_ONLY_ROLLOUT_AT = "2026-09-23T18:23:42.000Z";
+/** Preserve legacy accounts when flags are unavailable, including older identities without a date. */
+export declare function actorsOnlyDefault(createdAt?: string): boolean;

package/dist/ProductFeatures.js

@@ -0,0 +1,7 @@
+/** Keep this key and cutoff aligned with the Actors-only flag in PostHog. */
+export const ACTORS_ONLY_FLAG = "Actors-only";
+export const ACTORS_ONLY_ROLLOUT_AT = "2026-09-23T18:23:42.000Z";
+/** Preserve legacy accounts when flags are unavailable, including older identities without a date. */
+export function actorsOnlyDefault(createdAt) {
+    return !!createdAt && Date.parse(createdAt) >= Date.parse(ACTORS_ONLY_ROLLOUT_AT);
+}

package/dist/types.d.ts

@@ -13,6 +13,7 @@ export declare const userProfileSchema: z.ZodObject<{
     displayName: z.ZodString;
     firstName: z.ZodNullable<z.ZodString>;
     lastName: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodString>;
     displayPhotoUrl: z.ZodString;
 }, z.core.$strip>;
 export type UserProfile = z.infer<typeof userProfileSchema>;
@@ -22,6 +23,7 @@ export declare const userSessionSchema: z.ZodObject<{
     displayName: z.ZodString;
     firstName: z.ZodNullable<z.ZodString>;
     lastName: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodString>;
     displayPhotoUrl: z.ZodString;
     organizationId: z.ZodString;
     organizationName: z.ZodString;
@@ -29,6 +31,7 @@ export declare const userSessionSchema: z.ZodObject<{
         user: "user";
         admin: "admin";
     }>>;
+    actorsOnly: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type UserSession = z.infer<typeof userSessionSchema>;
 export declare const organizationSchema: z.ZodObject<{
@@ -291,8 +294,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>;
@@ -14212,6 +14215,7 @@ export declare const projectDetailResponseSchema: z.ZodObject<{
     isSelfHosted: z.ZodBoolean;
     hasSigningSecret: z.ZodBoolean;
     hasProjectApiKey: z.ZodBoolean;
+    actorTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     jobs: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;

package/dist/types.js

@@ -12,12 +12,14 @@ export const userProfileSchema = z.object({
     displayName: z.string(),
     firstName: z.string().nullable(),
     lastName: z.string().nullable(),
+    createdAt: z.string().optional(),
     displayPhotoUrl: z.string()
 });
 export const userSessionSchema = userProfileSchema.extend({
     organizationId: z.string(),
     organizationName: z.string(),
-    roles: z.array(roleSchema)
+    roles: z.array(roleSchema),
+    actorsOnly: z.boolean().optional()
 });
 export const organizationSchema = z.object({
     id: z.string(),
@@ -624,6 +626,7 @@ export const projectDetailResponseSchema = z.object({
     isSelfHosted: z.boolean(),
     hasSigningSecret: z.boolean(),
     hasProjectApiKey: z.boolean(),
+    actorTypes: z.array(z.string()).optional(),
     jobs: z.array(z.object({
         id: z.string(),
         name: z.string(),

package/package.json

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