@mastra/mongodb 1.7.4-alpha.0 → 1.8.0-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @mastra/mongodb
 
+## 1.8.0-alpha.0
+
+### Minor Changes
+
+- Added the `schedules` storage domain so MongoDB-backed Mastra apps can use scheduled workflows. Creates `mastra_schedules` and `mastra_schedule_triggers` collections on init, with default indexes on `(status, next_fire_at)` for due-schedule polling and `(schedule_id, actual_fire_at)` for trigger-history queries. ([#15830](https://github.com/mastra-ai/mastra/pull/15830))
+
+### Patch Changes
+
+- Updated dependencies [[`c05c9a1`](https://github.com/mastra-ai/mastra/commit/c05c9a13230988cef6d438a62f37760f31927bc7), [`e24aacb`](https://github.com/mastra-ai/mastra/commit/e24aacba07bd66f5d95b636dc24016fca26b52cf), [`c721164`](https://github.com/mastra-ai/mastra/commit/c7211643f7ac861f83b19a3757cc921487fc9d75), [`1b55954`](https://github.com/mastra-ai/mastra/commit/1b559541c1e08a10e49d01ffc51a634dfc37a286), [`5adc55e`](https://github.com/mastra-ai/mastra/commit/5adc55e63407be8ee977914957d68bcc2a075ceb), [`70017d7`](https://github.com/mastra-ai/mastra/commit/70017d72ab741b5d7040e2a15c251a317782e39e), [`e4942bc`](https://github.com/mastra-ai/mastra/commit/e4942bc7fdc903572f7d84f26d5e15f9d39c763d)]:
+  - @mastra/core@1.32.0-alpha.1
+
+## 1.7.4
+
+### Patch Changes
+
+- Removed unsupported `minScore` query option from MongoDB vector store docs and README. Exported `MongoDBQueryVectorParams` so callers can type `documentFilter` for `MongoDBVector.query()`. ([#15936](https://github.com/mastra-ai/mastra/pull/15936))
+
+  Fixes #15715
+
+- Updated dependencies [[`1723e09`](https://github.com/mastra-ai/mastra/commit/1723e099829892419ddbfe49287acfeac2522724), [`629f9e9`](https://github.com/mastra-ai/mastra/commit/629f9e9a7e56aa8f129515a3923c5813298790c7), [`25168fb`](https://github.com/mastra-ai/mastra/commit/25168fb9c1de9db7f8171df4f58ceb842c53aa29), [`ab34b5a`](https://github.com/mastra-ai/mastra/commit/ab34b5a2191b8e4353df1dbf7b9155e7d6628d79), [`5fb6c2a`](https://github.com/mastra-ai/mastra/commit/5fb6c2a95c1843cc231704b91354311fc1f34a71), [`2b0f355`](https://github.com/mastra-ai/mastra/commit/2b0f3553be3e9e5524da539a66e5cf82668440a4), [`394f0cf`](https://github.com/mastra-ai/mastra/commit/394f0cfc31e6b4d801219fdef2e9cc69e5bc8682), [`b2deb29`](https://github.com/mastra-ai/mastra/commit/b2deb29412b300c868655b5840463614fbb7962d), [`66644be`](https://github.com/mastra-ai/mastra/commit/66644beac1aa560f0e417956ff007c89341dc382), [`e109607`](https://github.com/mastra-ai/mastra/commit/e10960749251e34d46b480a20648c490fd30381b), [`310b953`](https://github.com/mastra-ai/mastra/commit/310b95345f302dcd5ba3ed862bdc96f059d44122), [`3d7f709`](https://github.com/mastra-ai/mastra/commit/3d7f709b615e588050bb6283c4ee5cfe2978cbde), [`48a42f1`](https://github.com/mastra-ai/mastra/commit/48a42f114a4006a95e0b7a1b5ad1a24815a175c2), [`8091c7c`](https://github.com/mastra-ai/mastra/commit/8091c7c944d15e13fef6d61b6cfd903f158d4006), [`2c83efc`](https://github.com/mastra-ai/mastra/commit/2c83efc4482b3efe50830e3b8b4ba9a8d219edff), [`43f0e1d`](https://github.com/mastra-ai/mastra/commit/43f0e1d5d5a74ba6fc746f2ad89ebe0c64777a7d), [`da0b9e2`](https://github.com/mastra-ai/mastra/commit/da0b9e2ba7ecc560213b426d6c097fe63946086e), [`282a10c`](https://github.com/mastra-ai/mastra/commit/282a10c9446e9922afe80e10e3770481c8ac8a28), [`04151c7`](https://github.com/mastra-ai/mastra/commit/04151c7dcea934b4fe9076708a23fac161195414), [`8091c7c`](https://github.com/mastra-ai/mastra/commit/8091c7c944d15e13fef6d61b6cfd903f158d4006)]:
+  - @mastra/core@1.31.0
+
 ## 1.7.4-alpha.0
 
 ### Patch Changes

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-mongodb
 description: Documentation for @mastra/mongodb. Use when working with @mastra/mongodb APIs, configuration, or implementation.
 metadata:
   package: "@mastra/mongodb"
-  version: "1.7.4-alpha.0"
+  version: "1.8.0-alpha.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.7.4-alpha.0",
+  "version": "1.8.0-alpha.0",
   "package": "@mastra/mongodb",
   "exports": {},
   "modules": {}

package/dist/index.cjs

@@ -14,7 +14,7 @@ var evals = require('@mastra/core/evals');
 
 // package.json
 var package_default = {
-  version: "1.7.4-alpha.0"};
+  version: "1.8.0-alpha.0"};
 var MongoDBFilterTranslator = class extends filter.BaseFilterTranslator {
   getSupportedOperators() {
     return {
@@ -7595,6 +7595,206 @@ var MongoDBPromptBlocksStorage = class _MongoDBPromptBlocksStorage extends stora
     return result;
   }
 };
+function scheduleToDoc(schedule) {
+  return {
+    id: schedule.id,
+    target: schedule.target,
+    cron: schedule.cron,
+    timezone: schedule.timezone ?? null,
+    status: schedule.status,
+    next_fire_at: schedule.nextFireAt,
+    last_fire_at: schedule.lastFireAt ?? null,
+    last_run_id: schedule.lastRunId ?? null,
+    created_at: schedule.createdAt,
+    updated_at: schedule.updatedAt,
+    metadata: schedule.metadata ?? null
+  };
+}
+function docToSchedule(doc) {
+  const target = doc.target;
+  if (!target) {
+    throw new Error(`Schedule ${doc.id} has invalid target`);
+  }
+  const schedule = {
+    id: String(doc.id),
+    target,
+    cron: String(doc.cron),
+    status: String(doc.status),
+    nextFireAt: Number(doc.next_fire_at),
+    createdAt: Number(doc.created_at),
+    updatedAt: Number(doc.updated_at)
+  };
+  if (doc.timezone != null) schedule.timezone = String(doc.timezone);
+  if (doc.last_fire_at != null) schedule.lastFireAt = Number(doc.last_fire_at);
+  if (doc.last_run_id != null) schedule.lastRunId = String(doc.last_run_id);
+  if (doc.metadata != null) schedule.metadata = doc.metadata;
+  return schedule;
+}
+function triggerToDoc(trigger) {
+  return {
+    schedule_id: trigger.scheduleId,
+    run_id: trigger.runId,
+    scheduled_fire_at: trigger.scheduledFireAt,
+    actual_fire_at: trigger.actualFireAt,
+    status: trigger.status,
+    error: trigger.error ?? null
+  };
+}
+function docToTrigger(doc) {
+  const trigger = {
+    scheduleId: String(doc.schedule_id),
+    runId: String(doc.run_id),
+    scheduledFireAt: Number(doc.scheduled_fire_at),
+    actualFireAt: Number(doc.actual_fire_at),
+    status: String(doc.status)
+  };
+  if (doc.error != null) trigger.error = String(doc.error);
+  return trigger;
+}
+var SchedulesMongoDB = class _SchedulesMongoDB extends storage.SchedulesStorage {
+  #connector;
+  #skipDefaultIndexes;
+  #indexes;
+  static MANAGED_COLLECTIONS = [storage.TABLE_SCHEDULES, storage.TABLE_SCHEDULE_TRIGGERS];
+  constructor(config) {
+    super();
+    this.#connector = resolveMongoDBConfig(config);
+    this.#skipDefaultIndexes = config.skipDefaultIndexes;
+    this.#indexes = config.indexes?.filter(
+      (idx) => _SchedulesMongoDB.MANAGED_COLLECTIONS.includes(idx.collection)
+    );
+  }
+  getSchedulesCollection() {
+    return this.#connector.getCollection(storage.TABLE_SCHEDULES);
+  }
+  getTriggersCollection() {
+    return this.#connector.getCollection(storage.TABLE_SCHEDULE_TRIGGERS);
+  }
+  getDefaultIndexDefinitions() {
+    return [
+      { collection: storage.TABLE_SCHEDULES, keys: { id: 1 }, options: { unique: true } },
+      { collection: storage.TABLE_SCHEDULES, keys: { status: 1, next_fire_at: 1 } },
+      { collection: storage.TABLE_SCHEDULES, keys: { "target.workflowId": 1 } },
+      { collection: storage.TABLE_SCHEDULE_TRIGGERS, keys: { schedule_id: 1, actual_fire_at: -1 } },
+      { collection: storage.TABLE_SCHEDULE_TRIGGERS, keys: { run_id: 1 }, options: { unique: true } }
+    ];
+  }
+  async createDefaultIndexes() {
+    if (this.#skipDefaultIndexes) return;
+    for (const indexDef of this.getDefaultIndexDefinitions()) {
+      try {
+        const collection = await this.#connector.getCollection(indexDef.collection);
+        await collection.createIndex(indexDef.keys, indexDef.options);
+      } catch (error) {
+        this.logger?.warn?.(`Failed to create index on ${indexDef.collection}:`, error);
+      }
+    }
+  }
+  async createCustomIndexes() {
+    if (!this.#indexes || this.#indexes.length === 0) return;
+    for (const indexDef of this.#indexes) {
+      try {
+        const collection = await this.#connector.getCollection(indexDef.collection);
+        await collection.createIndex(indexDef.keys, indexDef.options);
+      } catch (error) {
+        this.logger?.warn?.(`Failed to create custom index on ${indexDef.collection}:`, error);
+      }
+    }
+  }
+  async init() {
+    await this.createDefaultIndexes();
+    await this.createCustomIndexes();
+  }
+  async dangerouslyClearAll() {
+    const triggers = await this.getTriggersCollection();
+    await triggers.deleteMany({});
+    const schedules = await this.getSchedulesCollection();
+    await schedules.deleteMany({});
+  }
+  async createSchedule(schedule) {
+    const collection = await this.getSchedulesCollection();
+    const existing = await collection.findOne({ id: schedule.id });
+    if (existing) {
+      throw new Error(`Schedule with id "${schedule.id}" already exists`);
+    }
+    await collection.insertOne(scheduleToDoc(schedule));
+    return schedule;
+  }
+  async getSchedule(id) {
+    const collection = await this.getSchedulesCollection();
+    const doc = await collection.findOne({ id });
+    return doc ? docToSchedule(doc) : null;
+  }
+  async listSchedules(filter) {
+    const query = {};
+    if (filter?.status) query.status = filter.status;
+    if (filter?.workflowId) query["target.workflowId"] = filter.workflowId;
+    const collection = await this.getSchedulesCollection();
+    const docs = await collection.find(query).sort({ created_at: 1 }).toArray();
+    return docs.map(docToSchedule);
+  }
+  async listDueSchedules(now, limit) {
+    const cap = limit ?? 100;
+    const collection = await this.getSchedulesCollection();
+    const docs = await collection.find({ status: "active", next_fire_at: { $lte: now } }).sort({ next_fire_at: 1 }).limit(cap).toArray();
+    return docs.map(docToSchedule);
+  }
+  async updateSchedule(id, patch) {
+    const $set = {};
+    if ("cron" in patch && patch.cron !== void 0) $set.cron = patch.cron;
+    if ("timezone" in patch) $set.timezone = patch.timezone ?? null;
+    if ("status" in patch && patch.status !== void 0) $set.status = patch.status;
+    if ("nextFireAt" in patch && patch.nextFireAt !== void 0) $set.next_fire_at = patch.nextFireAt;
+    if ("target" in patch && patch.target !== void 0) $set.target = patch.target;
+    if ("metadata" in patch) $set.metadata = patch.metadata ?? null;
+    $set.updated_at = Date.now();
+    const collection = await this.getSchedulesCollection();
+    const result = await collection.findOneAndUpdate({ id }, { $set }, { returnDocument: "after" });
+    if (!result) throw new Error(`Schedule ${id} not found`);
+    return docToSchedule(result);
+  }
+  async updateScheduleNextFire(id, expectedNextFireAt, newNextFireAt, lastFireAt, lastRunId) {
+    const collection = await this.getSchedulesCollection();
+    const result = await collection.updateOne(
+      { id, next_fire_at: expectedNextFireAt, status: "active" },
+      {
+        $set: {
+          next_fire_at: newNextFireAt,
+          last_fire_at: lastFireAt,
+          last_run_id: lastRunId,
+          updated_at: Date.now()
+        }
+      }
+    );
+    return result.matchedCount > 0;
+  }
+  async deleteSchedule(id) {
+    const triggers = await this.getTriggersCollection();
+    await triggers.deleteMany({ schedule_id: id });
+    const schedules = await this.getSchedulesCollection();
+    await schedules.deleteOne({ id });
+  }
+  async recordTrigger(trigger) {
+    const collection = await this.getTriggersCollection();
+    await collection.insertOne(triggerToDoc(trigger));
+  }
+  async listTriggers(scheduleId, opts) {
+    const query = { schedule_id: scheduleId };
+    if (opts?.fromActualFireAt != null || opts?.toActualFireAt != null) {
+      const range = {};
+      if (opts?.fromActualFireAt != null) range.$gte = opts.fromActualFireAt;
+      if (opts?.toActualFireAt != null) range.$lt = opts.toActualFireAt;
+      query.actual_fire_at = range;
+    }
+    const collection = await this.getTriggersCollection();
+    let cursor = collection.find(query).sort({ actual_fire_at: -1 });
+    if (opts?.limit != null) {
+      cursor = cursor.limit(Math.floor(opts.limit));
+    }
+    const docs = await cursor.toArray();
+    return docs.map(docToTrigger);
+  }
+};
 var SNAPSHOT_FIELDS5 = [
   "name",
   "description",
@@ -10107,6 +10307,7 @@ var MongoDBStore = class extends storage.MastraCompositeStore {
     const datasets = new MongoDBDatasetsStorage(domainConfig);
     const experiments = new MongoDBExperimentsStorage(domainConfig);
     const backgroundTasks = new BackgroundTasksStorageMongoDB(domainConfig);
+    const schedules = new SchedulesMongoDB(domainConfig);
     this.stores = {
       memory,
       scores,
@@ -10122,7 +10323,8 @@ var MongoDBStore = class extends storage.MastraCompositeStore {
       blobs,
       backgroundTasks,
       datasets,
-      experiments
+      experiments,
+      schedules
     };
   }
   /**
@@ -10257,6 +10459,7 @@ exports.MongoDBStore = MongoDBStore;
 exports.MongoDBVector = MongoDBVector;
 exports.MongoDBWorkspacesStorage = MongoDBWorkspacesStorage;
 exports.ObservabilityMongoDB = ObservabilityMongoDB;
+exports.SchedulesMongoDB = SchedulesMongoDB;
 exports.ScoresStorageMongoDB = ScoresStorageMongoDB;
 exports.WorkflowsStorageMongoDB = WorkflowsStorageMongoDB;
 //# sourceMappingURL=index.cjs.map