@cadenza.io/core 3.23.0 → 3.24.0

package/dist/index.d.mts

@@ -1854,6 +1854,8 @@ interface SessionPolicy {
     idleTtlMs?: number;
     absoluteTtlMs?: number;
     extendIdleTtlOnRead?: boolean;
+    persistDurableState?: boolean;
+    persistenceTimeoutMs?: number;
 }
 /**
  * Task retry policy metadata for actor definitions/specs.
@@ -2056,6 +2058,7 @@ interface ActorTaskRuntimeMetadata {
     mode: ActorTaskMode;
     forceMeta: boolean;
 }
+declare const META_ACTOR_SESSION_STATE_PERSIST_INTENT = "meta-actor-session-state-persist";
 /**
  * Reads actor metadata from a wrapped task function if available.
  */
@@ -2126,6 +2129,7 @@ declare class Actor<D extends Record<string, any> = AnyObject, R = AnyObject> {
     private touchSession;
     private runWithOptionalIdempotency;
     private getActiveIdempotencyRecord;
+    private persistDurableStateIfConfigured;
     private emitActorCreatedSignal;
 }
 
@@ -2613,4 +2617,4 @@ declare class Cadenza {
     static reset(): void;
 }
 
-export { Actor, type ActorConsistencyProfileName, type ActorDefinition, type ActorFactoryOptions, type ActorInvocationOptions, type ActorKeyDefinition, type ActorKind, type ActorLoadPolicy, type ActorRuntimeReadGuard, type ActorSpec, type ActorStateDefinition, type ActorStateReducer, type ActorStateStore, type ActorTaskBindingDefinition, type ActorTaskBindingOptions, type ActorTaskContext, type ActorTaskHandler, type ActorTaskMode, type ActorTaskRuntimeMetadata, type ActorWriteContract, type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type IdempotencyPolicy, InquiryBroker, type InquiryOptions, type Intent, type RetryPolicy, type Schema, type SchemaConstraints, type SchemaDefinition, type SchemaType, type SessionPolicy, SignalBroker, SignalEmitter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default, getActorTaskRuntimeMetadata };
+export { Actor, type ActorConsistencyProfileName, type ActorDefinition, type ActorFactoryOptions, type ActorInvocationOptions, type ActorKeyDefinition, type ActorKind, type ActorLoadPolicy, type ActorRuntimeReadGuard, type ActorSpec, type ActorStateDefinition, type ActorStateReducer, type ActorStateStore, type ActorTaskBindingDefinition, type ActorTaskBindingOptions, type ActorTaskContext, type ActorTaskHandler, type ActorTaskMode, type ActorTaskRuntimeMetadata, type ActorWriteContract, type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type IdempotencyPolicy, InquiryBroker, type InquiryOptions, type Intent, META_ACTOR_SESSION_STATE_PERSIST_INTENT, type RetryPolicy, type Schema, type SchemaConstraints, type SchemaDefinition, type SchemaType, type SessionPolicy, SignalBroker, SignalEmitter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default, getActorTaskRuntimeMetadata };

package/dist/index.d.ts

@@ -1854,6 +1854,8 @@ interface SessionPolicy {
     idleTtlMs?: number;
     absoluteTtlMs?: number;
     extendIdleTtlOnRead?: boolean;
+    persistDurableState?: boolean;
+    persistenceTimeoutMs?: number;
 }
 /**
  * Task retry policy metadata for actor definitions/specs.
@@ -2056,6 +2058,7 @@ interface ActorTaskRuntimeMetadata {
     mode: ActorTaskMode;
     forceMeta: boolean;
 }
+declare const META_ACTOR_SESSION_STATE_PERSIST_INTENT = "meta-actor-session-state-persist";
 /**
  * Reads actor metadata from a wrapped task function if available.
  */
@@ -2126,6 +2129,7 @@ declare class Actor<D extends Record<string, any> = AnyObject, R = AnyObject> {
     private touchSession;
     private runWithOptionalIdempotency;
     private getActiveIdempotencyRecord;
+    private persistDurableStateIfConfigured;
     private emitActorCreatedSignal;
 }
 
@@ -2613,4 +2617,4 @@ declare class Cadenza {
     static reset(): void;
 }
 
-export { Actor, type ActorConsistencyProfileName, type ActorDefinition, type ActorFactoryOptions, type ActorInvocationOptions, type ActorKeyDefinition, type ActorKind, type ActorLoadPolicy, type ActorRuntimeReadGuard, type ActorSpec, type ActorStateDefinition, type ActorStateReducer, type ActorStateStore, type ActorTaskBindingDefinition, type ActorTaskBindingOptions, type ActorTaskContext, type ActorTaskHandler, type ActorTaskMode, type ActorTaskRuntimeMetadata, type ActorWriteContract, type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type IdempotencyPolicy, InquiryBroker, type InquiryOptions, type Intent, type RetryPolicy, type Schema, type SchemaConstraints, type SchemaDefinition, type SchemaType, type SessionPolicy, SignalBroker, SignalEmitter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default, getActorTaskRuntimeMetadata };
+export { Actor, type ActorConsistencyProfileName, type ActorDefinition, type ActorFactoryOptions, type ActorInvocationOptions, type ActorKeyDefinition, type ActorKind, type ActorLoadPolicy, type ActorRuntimeReadGuard, type ActorSpec, type ActorStateDefinition, type ActorStateReducer, type ActorStateStore, type ActorTaskBindingDefinition, type ActorTaskBindingOptions, type ActorTaskContext, type ActorTaskHandler, type ActorTaskMode, type ActorTaskRuntimeMetadata, type ActorWriteContract, type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type IdempotencyPolicy, InquiryBroker, type InquiryOptions, type Intent, META_ACTOR_SESSION_STATE_PERSIST_INTENT, type RetryPolicy, type Schema, type SchemaConstraints, type SchemaDefinition, type SchemaType, type SessionPolicy, SignalBroker, SignalEmitter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default, getActorTaskRuntimeMetadata };

package/dist/index.js

@@ -29,6 +29,7 @@ __export(index_exports, {
   GraphRun: () => GraphRun,
   GraphRunner: () => GraphRunner,
   InquiryBroker: () => InquiryBroker,
+  META_ACTOR_SESSION_STATE_PERSIST_INTENT: () => META_ACTOR_SESSION_STATE_PERSIST_INTENT,
   SignalBroker: () => SignalBroker,
   SignalEmitter: () => SignalEmitter,
   Task: () => Task,
@@ -3663,6 +3664,7 @@ var TaskIterator = class {
 // src/actors/Actor.ts
 var ACTOR_TASK_METADATA = /* @__PURE__ */ Symbol.for("@cadenza.io/core/actor-task-meta");
 var ACTOR_INVOCATION_OPTIONS_KEY = "__actorOptions";
+var META_ACTOR_SESSION_STATE_PERSIST_INTENT = "meta-actor-session-state-persist";
 function deepClone(value) {
   if (value === void 0 || value === null || typeof value !== "object" || value instanceof Date) {
     return value;
@@ -3921,10 +3923,19 @@ var Actor = class {
         if (invocationOptions.writeContract === "reducer" && typeof handlerResult === "function") {
           reduceDurableState(handlerResult);
         }
+        const nextDurableVersion = stateRecord.version + (durableStateChanged ? 1 : 0);
+        if (durableStateChanged) {
+          await this.persistDurableStateIfConfigured(
+            actorKey,
+            nextDurableState,
+            nextDurableVersion,
+            inquire
+          );
+        }
         const writeTimestamp = Date.now();
         if (durableStateChanged) {
           stateRecord.durableState = cloneForDurableState(nextDurableState);
-          stateRecord.version += 1;
+          stateRecord.version = nextDurableVersion;
           stateRecord.lastDurableWriteAt = writeTimestamp;
         }
         if (runtimeStateChanged) {
@@ -4232,6 +4243,34 @@ var Actor = class {
     }
     return record;
   }
+  async persistDurableStateIfConfigured(actorKey, durableState, durableVersion, inquire) {
+    const shouldPersist = this.spec.session?.persistDurableState ?? false;
+    if (!shouldPersist) {
+      return;
+    }
+    const timeoutMs = normalizePositiveInteger(this.spec.session?.persistenceTimeoutMs) ?? 5e3;
+    const response = await inquire(
+      META_ACTOR_SESSION_STATE_PERSIST_INTENT,
+      {
+        actor_name: this.spec.name,
+        actor_version: 1,
+        actor_key: actorKey,
+        durable_state: cloneForDurableState(durableState),
+        durable_version: durableVersion,
+        expires_at: null
+      },
+      {
+        timeout: timeoutMs,
+        rejectOnTimeout: true
+      }
+    );
+    if (!isObject2(response) || response.__success !== true || response.persisted !== true) {
+      const reason = isObject2(response) ? response.__error ?? response.error : void 0;
+      throw new Error(
+        `Actor "${this.spec.name}" durable state persistence failed for key "${actorKey}"${reason ? `: ${String(reason)}` : ""}`
+      );
+    }
+  }
   emitActorCreatedSignal() {
     Cadenza.signalBroker.registerEmittedSignal("meta.actor.created");
     const definition = sanitizeActorMetadataValue(
@@ -7485,6 +7524,7 @@ var index_default = Cadenza;
   GraphRun,
   GraphRunner,
   InquiryBroker,
+  META_ACTOR_SESSION_STATE_PERSIST_INTENT,
   SignalBroker,
   SignalEmitter,
   Task,