@dudousxd/nestjs-durable-store-mikro-orm 0.19.0 → 0.21.0

package/dist/index.cjs

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  BufferedEventEntity: () => BufferedEventEntity,
   BufferedSignalEntity: () => BufferedSignalEntity,
   ENTITIES: () => ENTITIES,
   MikroOrmStateStore: () => MikroOrmStateStore,
@@ -66,6 +67,7 @@ var WorkflowRunEntity = class {
   searchAttributes;
   priority;
   namespace;
+  origin;
   createdAt;
   updatedAt;
 };
@@ -117,6 +119,15 @@ var BufferedSignalEntity = class {
   token;
   payload;
 };
+var BufferedEventEntity = class {
+  static {
+    __name(this, "BufferedEventEntity");
+  }
+  id;
+  name;
+  payload;
+  publishedAt;
+};
 function namespaceFilterCond(args) {
   if (args?.namespace === void 0) return {};
   return {
@@ -254,6 +265,31 @@ function durableEntities(options = {}) {
         default: "default",
         fieldName: col("namespace")
       },
+      // Which library/module registered the workflow this run belongs to (e.g.
+      // `@dudousxd/nestjs-catalog-pipeline`), derived at registration time — never caller input.
+      //
+      // NULLABLE WITH NO DEFAULT, deliberately unlike `namespace` above. `namespace` can honestly
+      // default a pre-existing row to `'default'` (that IS the namespace an unscoped engine ran it
+      // in); an origin cannot be reconstructed after the fact, so a row written before this column
+      // existed must read back as `undefined` = "unknown". Stamping it `'app'`/`'unknown'` would be
+      // indistinguishable from a real registration in the dashboard's facet — a wrong origin is worse
+      // than an absent one. Two MikroORM specifics reinforce it: a `default` here would NOT be
+      // back-filled onto existing rows anyway (the DDL default only applies to new inserts, and a
+      // TypeScript field initialiser never runs for rows the ORM did not create), so a default would
+      // buy nothing but a lie for future rows.
+      //
+      // No index, unlike `namespace`. That one is on the HOT path — every poll tick filters
+      // `listPendingRuns`/`listDueTimers`/`listIncompleteRuns` by it, hence
+      // `durable_workflow_runs_namespace_status_idx`. Nothing filters by `origin` except the
+      // dashboard's `listRuns`, where it is ANDed with the `status`/`workflow` predicates that
+      // `durable_workflow_runs_status_wake_at_idx` / `..._workflow_status_idx` already bound. If a
+      // deployment ever makes origin-filtered listings hot, add the composite index in your own
+      // migration rather than here.
+      origin: {
+        type: "string",
+        nullable: true,
+        fieldName: col("origin")
+      },
       createdAt: {
         type: "Date",
         fieldName: col("createdAt")
@@ -446,12 +482,50 @@ function durableEntities(options = {}) {
       }
     }
   });
+  const bufferedEvents = new import_core.EntitySchema({
+    class: BufferedEventEntity,
+    tableName: "durable_buffered_events",
+    // `(name, publishedAt)` serves both `listBufferedEvents`'s name-scoped scan and its oldest-first
+    // ordering in one index.
+    indexes: [
+      {
+        name: "durable_buffered_events_name_published_at_idx",
+        properties: [
+          "name",
+          "publishedAt"
+        ]
+      }
+    ],
+    properties: {
+      // Caller-minted uuid (engine.publishEvent), not autoincrement — removeBufferedEvent targets it
+      // directly and needs to be handed the SAME id it was buffered with.
+      id: {
+        type: "string",
+        primary: true,
+        fieldName: col("id")
+      },
+      name: {
+        type: "string",
+        fieldName: col("name")
+      },
+      payload: {
+        type: "json",
+        nullable: true,
+        fieldName: col("payload")
+      },
+      publishedAt: {
+        type: "Date",
+        fieldName: col("publishedAt")
+      }
+    }
+  });
   return [
     workflowRuns,
     stepCheckpoints,
     runAttributes,
     signalWaiters,
-    bufferedSignals
+    bufferedSignals,
+    bufferedEvents
   ];
 }
 __name(durableEntities, "durableEntities");
@@ -467,7 +541,8 @@ var DURABLE_TABLE_NAMES = /* @__PURE__ */ new Set([
   "durable_step_checkpoints",
   "durable_run_attributes",
   "durable_signal_waiters",
-  "durable_buffered_signals"
+  "durable_buffered_signals",
+  "durable_buffered_events"
 ]);
 function durableManagedTables() {
   return [
@@ -940,6 +1015,7 @@ var MikroOrmStateStore = class _MikroOrmStateStore {
     const where = {};
     if (query.workflow) where.workflow = query.workflow;
     if (query.namespace !== void 0) where.namespace = query.namespace;
+    if (query.origin !== void 0) where.origin = query.origin;
     if (query.status && query.statuses) {
       where.$and = [
         {
@@ -1155,6 +1231,39 @@ var MikroOrmStateStore = class _MikroOrmStateStore {
       payload
     };
   }
+  async bufferEvent(input) {
+    const em = this.fork();
+    const e = new BufferedEventEntity();
+    e.id = input.id;
+    e.name = input.name;
+    e.payload = input.payload ?? null;
+    e.publishedAt = new Date(input.publishedAt);
+    em.persist(e);
+    await em.flush();
+  }
+  async listBufferedEvents(name, limit) {
+    const em = this.fork();
+    const rows = await em.find(BufferedEventEntity, {
+      name
+    }, {
+      orderBy: {
+        publishedAt: "asc"
+      },
+      limit
+    });
+    return rows.map((e) => ({
+      id: e.id,
+      payload: e.payload ?? void 0,
+      publishedAt: e.publishedAt.getTime()
+    }));
+  }
+  async removeBufferedEvent(id) {
+    const em = this.fork();
+    const affected = await em.nativeDelete(BufferedEventEntity, {
+      id
+    });
+    return affected > 0;
+  }
 };
 function toRunEntity(run) {
   const e = new WorkflowRunEntity();
@@ -1174,6 +1283,7 @@ function toRunEntity(run) {
   e.searchAttributes = run.searchAttributes ?? null;
   e.priority = run.priority ?? null;
   e.namespace = run.namespace ?? "default";
+  e.origin = run.origin ?? null;
   e.createdAt = run.createdAt;
   e.updatedAt = run.updatedAt;
   return e;
@@ -1197,6 +1307,8 @@ function fromRunEntity(e) {
     searchAttributes: e.searchAttributes ?? void 0,
     priority: e.priority ?? void 0,
     namespace: e.namespace,
+    // NULL (a row written before the column existed) surfaces as `undefined` = unknown origin.
+    origin: e.origin ?? void 0,
     createdAt: e.createdAt,
     updatedAt: e.updatedAt
   };
@@ -1248,6 +1360,7 @@ function fromCheckpointEntity(e) {
 __name(fromCheckpointEntity, "fromCheckpointEntity");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BufferedEventEntity,
   BufferedSignalEntity,
   ENTITIES,
   MikroOrmStateStore,