@dudousxd/nestjs-durable 0.20.0 → 0.22.0

package/dist/index.js

@@ -293,7 +293,7 @@ DurableWorkerModule = _ts_decorate([
 ], DurableWorkerModule);
 
 // src/durable.module.ts
-import { DURABLE_OPTIONS, DURABLE_OPTIONS_CANONICAL as DURABLE_OPTIONS_CANONICAL4, STATE_STORE, STATE_STORE_CANONICAL as STATE_STORE_CANONICAL2, TRANSPORT, TRANSPORT_CANONICAL as TRANSPORT_CANONICAL2, WorkflowEngine as WorkflowEngine5 } from "@dudousxd/nestjs-durable-core";
+import { DURABLE_OPTIONS, DURABLE_OPTIONS_CANONICAL as DURABLE_OPTIONS_CANONICAL5, STATE_STORE, STATE_STORE_CANONICAL as STATE_STORE_CANONICAL3, TRANSPORT, TRANSPORT_CANONICAL as TRANSPORT_CANONICAL2, WorkflowEngine as WorkflowEngine5 } from "@dudousxd/nestjs-durable-core";
 import { Module as Module2 } from "@nestjs/common";
 import { DiscoveryModule as DiscoveryModule2, ModuleRef } from "@nestjs/core";
 
@@ -435,8 +435,8 @@ EntityService = _ts_decorate3([
   ])
 ], EntityService);
 
-// src/timer-poller.ts
-import { DURABLE_OPTIONS_CANONICAL as DURABLE_OPTIONS_CANONICAL2, WorkflowEngine as WorkflowEngine2, runSchedules } from "@dudousxd/nestjs-durable-core";
+// src/retention-poller.ts
+import { DURABLE_OPTIONS_CANONICAL as DURABLE_OPTIONS_CANONICAL2, STATE_STORE_CANONICAL, TERMINAL_RUN_STATUSES, parseDuration } from "@dudousxd/nestjs-durable-core";
 import { Inject as Inject3, Injectable as Injectable4 } from "@nestjs/common";
 function _ts_decorate4(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -455,6 +455,113 @@ function _ts_param3(paramIndex, decorator) {
   };
 }
 __name(_ts_param3, "_ts_param");
+var DEFAULT_SWEEP_INTERVAL_MS = 6e4;
+var DEFAULT_BATCH_SIZE = 1e3;
+var MAX_BATCHES_PER_POLICY = 100;
+function validateRetention(retention) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const policy of retention.policies) {
+    if (policy.statuses.length === 0) {
+      throw new Error("durable retention: each policy must list at least one status");
+    }
+    if (policy.maxAge == null && policy.maxCount == null) {
+      throw new Error("durable retention: each policy must set maxAge and/or maxCount");
+    }
+    if (policy.maxAge != null) parseDuration(policy.maxAge);
+    for (const status of policy.statuses) {
+      if (!TERMINAL_RUN_STATUSES.includes(status)) {
+        throw new Error(`durable retention: status "${status}" is not terminal; only ${TERMINAL_RUN_STATUSES.join(", ")} can be pruned`);
+      }
+      if (seen.has(status)) {
+        throw new Error(`durable retention: status "${status}" appears in more than one policy; status sets must be disjoint`);
+      }
+      seen.add(status);
+    }
+  }
+}
+__name(validateRetention, "validateRetention");
+var RetentionPoller = class {
+  static {
+    __name(this, "RetentionPoller");
+  }
+  store;
+  options;
+  timer;
+  sweeping = false;
+  constructor(store, options) {
+    this.store = store;
+    this.options = options;
+  }
+  async onApplicationBootstrap() {
+    if (this.options.worker === false) return;
+    const retention = this.options.retention;
+    if (!retention || retention.policies.length === 0) return;
+    validateRetention(retention);
+    if (typeof this.store.pruneTerminalRuns !== "function") {
+      console.warn("[nestjs-durable] `retention` is configured but the store adapter does not implement pruneTerminalRuns; retention is disabled.");
+      return;
+    }
+    await this.sweep();
+    const intervalMs = retention.sweepInterval != null ? parseDuration(retention.sweepInterval) : DEFAULT_SWEEP_INTERVAL_MS;
+    if (intervalMs > 0) {
+      this.timer = setInterval(() => void this.sweep(), intervalMs);
+      this.timer.unref?.();
+    }
+  }
+  onModuleDestroy() {
+    if (this.timer) clearInterval(this.timer);
+  }
+  async sweep() {
+    if (this.sweeping) return;
+    const retention = this.options.retention;
+    const prune = this.store.pruneTerminalRuns;
+    if (!retention || typeof prune !== "function") return;
+    this.sweeping = true;
+    try {
+      const batchSize = retention.batchSize ?? DEFAULT_BATCH_SIZE;
+      const now = Date.now();
+      for (const policy of retention.policies) {
+        for (let batch = 0; batch < MAX_BATCHES_PER_POLICY; batch++) {
+          const deleted = await prune.call(this.store, policy, now, batchSize);
+          if (deleted < batchSize) break;
+        }
+      }
+    } finally {
+      this.sweeping = false;
+    }
+  }
+};
+RetentionPoller = _ts_decorate4([
+  Injectable4(),
+  _ts_param3(0, Inject3(STATE_STORE_CANONICAL)),
+  _ts_param3(1, Inject3(DURABLE_OPTIONS_CANONICAL2)),
+  _ts_metadata4("design:type", Function),
+  _ts_metadata4("design:paramtypes", [
+    typeof StateStore === "undefined" ? Object : StateStore,
+    typeof DurableModuleOptions === "undefined" ? Object : DurableModuleOptions
+  ])
+], RetentionPoller);
+
+// src/timer-poller.ts
+import { DURABLE_OPTIONS_CANONICAL as DURABLE_OPTIONS_CANONICAL3, WorkflowEngine as WorkflowEngine2, runSchedules } from "@dudousxd/nestjs-durable-core";
+import { Inject as Inject4, Injectable as Injectable5 } from "@nestjs/common";
+function _ts_decorate5(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate5, "_ts_decorate");
+function _ts_metadata5(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata5, "_ts_metadata");
+function _ts_param4(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param4, "_ts_param");
 var TimerPoller = class {
   static {
     __name(this, "TimerPoller");
@@ -499,11 +606,11 @@ var TimerPoller = class {
     }
   }
 };
-TimerPoller = _ts_decorate4([
-  Injectable4(),
-  _ts_param3(1, Inject3(DURABLE_OPTIONS_CANONICAL2)),
-  _ts_metadata4("design:type", Function),
-  _ts_metadata4("design:paramtypes", [
+TimerPoller = _ts_decorate5([
+  Injectable5(),
+  _ts_param4(1, Inject4(DURABLE_OPTIONS_CANONICAL3)),
+  _ts_metadata5("design:type", Function),
+  _ts_metadata5("design:paramtypes", [
     typeof WorkflowEngine2 === "undefined" ? Object : WorkflowEngine2,
     typeof DurableModuleOptions === "undefined" ? Object : DurableModuleOptions
   ])
@@ -513,8 +620,8 @@ TimerPoller = _ts_decorate4([
 var CONTEXT_ACCESSOR = Symbol.for("@dudousxd/nestjs-context:accessor");
 
 // src/workflow.registrar.ts
-import { DURABLE_OPTIONS_CANONICAL as DURABLE_OPTIONS_CANONICAL3, STATE_STORE_CANONICAL, WorkflowEngine as WorkflowEngine3, parseDuration, workflowName } from "@dudousxd/nestjs-durable-core";
-import { Inject as Inject4, Injectable as Injectable5 } from "@nestjs/common";
+import { DURABLE_OPTIONS_CANONICAL as DURABLE_OPTIONS_CANONICAL4, STATE_STORE_CANONICAL as STATE_STORE_CANONICAL2, WorkflowEngine as WorkflowEngine3, parseDuration as parseDuration2, workflowName } from "@dudousxd/nestjs-durable-core";
+import { Inject as Inject5, Injectable as Injectable6 } from "@nestjs/common";
 import { DiscoveryService as DiscoveryService3, MetadataScanner as MetadataScanner3 } from "@nestjs/core";
 
 // src/input-validation.ts
@@ -557,23 +664,23 @@ function isStepInterceptor(target) {
 __name(isStepInterceptor, "isStepInterceptor");
 
 // src/workflow.registrar.ts
-function _ts_decorate5(decorators, target, key, desc) {
+function _ts_decorate6(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate5, "_ts_decorate");
-function _ts_metadata5(k, v) {
+__name(_ts_decorate6, "_ts_decorate");
+function _ts_metadata6(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata5, "_ts_metadata");
-function _ts_param4(paramIndex, decorator) {
+__name(_ts_metadata6, "_ts_metadata");
+function _ts_param5(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param4, "_ts_param");
+__name(_ts_param5, "_ts_param");
 var WorkflowRegistrar = class {
   static {
     __name(this, "WorkflowRegistrar");
@@ -626,11 +733,11 @@ var WorkflowRegistrar = class {
       const validateInput = meta.validateInput ?? (meta.inputSchema ? classValidatorInput(meta.inputSchema) : void 0);
       const eventBatch = meta.debounce ? {
         mode: "debounce",
-        windowMs: parseDuration(meta.debounce)
+        windowMs: parseDuration2(meta.debounce)
       } : meta.batch ? {
         mode: "batch",
         maxSize: meta.batch.maxSize,
-        windowMs: parseDuration(meta.batch.within)
+        windowMs: parseDuration2(meta.batch.within)
       } : void 0;
       const workflowCtor = workflow.constructor;
       this.engine.register(meta.name, meta.version, (ctx, input) => workflow.run(ctx, input), {
@@ -686,12 +793,12 @@ var WorkflowRegistrar = class {
     });
   }
 };
-WorkflowRegistrar = _ts_decorate5([
-  Injectable5(),
-  _ts_param4(3, Inject4(STATE_STORE_CANONICAL)),
-  _ts_param4(4, Inject4(DURABLE_OPTIONS_CANONICAL3)),
-  _ts_metadata5("design:type", Function),
-  _ts_metadata5("design:paramtypes", [
+WorkflowRegistrar = _ts_decorate6([
+  Injectable6(),
+  _ts_param5(3, Inject5(STATE_STORE_CANONICAL2)),
+  _ts_param5(4, Inject5(DURABLE_OPTIONS_CANONICAL4)),
+  _ts_metadata6("design:type", Function),
+  _ts_metadata6("design:paramtypes", [
     typeof DiscoveryService3 === "undefined" ? Object : DiscoveryService3,
     typeof MetadataScanner3 === "undefined" ? Object : MetadataScanner3,
     typeof WorkflowEngine3 === "undefined" ? Object : WorkflowEngine3,
@@ -703,18 +810,18 @@ WorkflowRegistrar = _ts_decorate5([
 // src/workflow.service.ts
 import { randomUUID } from "node:crypto";
 import { WorkflowEngine as WorkflowEngine4 } from "@dudousxd/nestjs-durable-core";
-import { Injectable as Injectable6 } from "@nestjs/common";
-function _ts_decorate6(decorators, target, key, desc) {
+import { Injectable as Injectable7 } from "@nestjs/common";
+function _ts_decorate7(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate6, "_ts_decorate");
-function _ts_metadata6(k, v) {
+__name(_ts_decorate7, "_ts_decorate");
+function _ts_metadata7(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata6, "_ts_metadata");
+__name(_ts_metadata7, "_ts_metadata");
 var WorkflowService = class {
   static {
     __name(this, "WorkflowService");
@@ -754,22 +861,22 @@ var WorkflowService = class {
     return this.engine.publishEvent(name, payload, opts);
   }
 };
-WorkflowService = _ts_decorate6([
-  Injectable6(),
-  _ts_metadata6("design:type", Function),
-  _ts_metadata6("design:paramtypes", [
+WorkflowService = _ts_decorate7([
+  Injectable7(),
+  _ts_metadata7("design:type", Function),
+  _ts_metadata7("design:paramtypes", [
     typeof WorkflowEngine4 === "undefined" ? Object : WorkflowEngine4
   ])
 ], WorkflowService);
 
 // src/durable.module.ts
-function _ts_decorate7(decorators, target, key, desc) {
+function _ts_decorate8(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-__name(_ts_decorate7, "_ts_decorate");
+__name(_ts_decorate8, "_ts_decorate");
 function resolveAccessor(moduleRef) {
   try {
     return moduleRef.get(CONTEXT_ACCESSOR, {
@@ -815,13 +922,13 @@ var DurableModule = class _DurableModule {
   }
   static forRoot(options) {
     return _DurableModule.build({
-      provide: DURABLE_OPTIONS_CANONICAL4,
+      provide: DURABLE_OPTIONS_CANONICAL5,
       useValue: options
     });
   }
   static forRootAsync(options) {
     return _DurableModule.build({
-      provide: DURABLE_OPTIONS_CANONICAL4,
+      provide: DURABLE_OPTIONS_CANONICAL5,
       useFactory: options.useFactory,
       inject: options.inject ?? []
     });
@@ -836,23 +943,23 @@ var DurableModule = class _DurableModule {
       providers: [
         optionsProvider,
         {
-          provide: STATE_STORE_CANONICAL2,
+          provide: STATE_STORE_CANONICAL3,
           useFactory: /* @__PURE__ */ __name((options) => options.store, "useFactory"),
           inject: [
-            DURABLE_OPTIONS_CANONICAL4
+            DURABLE_OPTIONS_CANONICAL5
           ]
         },
         {
           provide: TRANSPORT_CANONICAL2,
           useFactory: /* @__PURE__ */ __name((options) => options.transport ?? null, "useFactory"),
           inject: [
-            DURABLE_OPTIONS_CANONICAL4
+            DURABLE_OPTIONS_CANONICAL5
           ]
         },
         // Legacy back-compat aliases (deprecated tokens still resolve to the same instances):
         {
           provide: STATE_STORE,
-          useExisting: STATE_STORE_CANONICAL2
+          useExisting: STATE_STORE_CANONICAL3
         },
         {
           provide: TRANSPORT,
@@ -860,7 +967,7 @@ var DurableModule = class _DurableModule {
         },
         {
           provide: DURABLE_OPTIONS,
-          useExisting: DURABLE_OPTIONS_CANONICAL4
+          useExisting: DURABLE_OPTIONS_CANONICAL5
         },
         {
           provide: WorkflowEngine5,
@@ -897,9 +1004,9 @@ var DurableModule = class _DurableModule {
             return engine;
           }, "useFactory"),
           inject: [
-            STATE_STORE_CANONICAL2,
+            STATE_STORE_CANONICAL3,
             TRANSPORT_CANONICAL2,
-            DURABLE_OPTIONS_CANONICAL4,
+            DURABLE_OPTIONS_CANONICAL5,
             ModuleRef
           ]
         },
@@ -907,22 +1014,23 @@ var DurableModule = class _DurableModule {
         EntityService,
         WorkflowRegistrar,
         DurableStepRegistrar,
-        TimerPoller
+        TimerPoller,
+        RetentionPoller
       ],
       exports: [
         WorkflowService,
         EntityService,
         WorkflowEngine5,
         STATE_STORE,
-        STATE_STORE_CANONICAL2,
+        STATE_STORE_CANONICAL3,
         TRANSPORT,
         TRANSPORT_CANONICAL2,
-        DURABLE_OPTIONS_CANONICAL4
+        DURABLE_OPTIONS_CANONICAL5
       ]
     };
   }
 };
-DurableModule = _ts_decorate7([
+DurableModule = _ts_decorate8([
   Module2({})
 ], DurableModule);
 export {