@langchain/langgraph-checkpoint-mongodb 1.1.5 → 1.1.7

package/dist/index.cjs

@@ -1,3 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 let _langchain_langgraph_checkpoint = require("@langchain/langgraph-checkpoint");
 
 //#region src/index.ts
@@ -75,6 +76,7 @@ var MongoDBSaver = class extends _langchain_langgraph_checkpoint.BaseCheckpointS
 		if (config?.configurable?.thread_id) query.thread_id = config.configurable.thread_id;
 		if (config?.configurable?.checkpoint_ns !== void 0 && config?.configurable?.checkpoint_ns !== null) query.checkpoint_ns = config.configurable.checkpoint_ns;
 		if (filter) Object.entries(filter).forEach(([key, value]) => {
+			if (value !== null && typeof value === "object") throw new Error(`Invalid filter value for key "${key}": filter values must be primitives (string, number, boolean, or null)`);
 			query[`metadata.${key}`] = value;
 		});
 		if (before) query.checkpoint_id = { $lt: before.configurable?.checkpoint_id };

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["BaseCheckpointSaver"],"sources":["../src/index.ts"],"sourcesContent":["import { type MongoClient, type Db as MongoDatabase } from \"mongodb\";\nimport type { RunnableConfig } from \"@langchain/core/runnables\";\nimport {\n  BaseCheckpointSaver,\n  type Checkpoint,\n  type CheckpointListOptions,\n  type CheckpointTuple,\n  type SerializerProtocol,\n  type PendingWrite,\n  type CheckpointMetadata,\n  CheckpointPendingWrite,\n} from \"@langchain/langgraph-checkpoint\";\n\nexport type MongoDBSaverParams = {\n  client: MongoClient;\n  dbName?: string;\n  checkpointCollectionName?: string;\n  checkpointWritesCollectionName?: string;\n};\n\n/**\n * A LangGraph checkpoint saver backed by a MongoDB database.\n */\nexport class MongoDBSaver extends BaseCheckpointSaver {\n  protected client: MongoClient;\n\n  protected db: MongoDatabase;\n\n  checkpointCollectionName = \"checkpoints\";\n\n  checkpointWritesCollectionName = \"checkpoint_writes\";\n\n  constructor(\n    {\n      client,\n      dbName,\n      checkpointCollectionName,\n      checkpointWritesCollectionName,\n    }: MongoDBSaverParams,\n    serde?: SerializerProtocol\n  ) {\n    super(serde);\n    this.client = client;\n    this.client.appendMetadata({\n      name: \"langgraphjs_checkpoint_saver\",\n    });\n    this.db = this.client.db(dbName);\n    this.checkpointCollectionName =\n      checkpointCollectionName ?? this.checkpointCollectionName;\n    this.checkpointWritesCollectionName =\n      checkpointWritesCollectionName ?? this.checkpointWritesCollectionName;\n  }\n\n  /**\n   * Retrieves a checkpoint from the MongoDB database based on the\n   * provided config. If the config contains a \"checkpoint_id\" key, the checkpoint with\n   * the matching thread ID and checkpoint ID is retrieved. Otherwise, the latest checkpoint\n   * for the given thread ID is retrieved.\n   */\n  async getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined> {\n    const {\n      thread_id,\n      checkpoint_ns = \"\",\n      checkpoint_id,\n    } = config.configurable ?? {};\n    let query;\n    if (checkpoint_id) {\n      query = {\n        thread_id,\n        checkpoint_ns,\n        checkpoint_id,\n      };\n    } else {\n      query = { thread_id, checkpoint_ns };\n    }\n    const result = await this.db\n      .collection(this.checkpointCollectionName)\n      .find(query)\n      .sort(\"checkpoint_id\", -1)\n      .limit(1)\n      .toArray();\n    if (result.length === 0) {\n      return undefined;\n    }\n    const doc = result[0];\n    const configurableValues = {\n      thread_id,\n      checkpoint_ns,\n      checkpoint_id: doc.checkpoint_id,\n    };\n    const checkpoint = (await this.serde.loadsTyped(\n      doc.type,\n      doc.checkpoint.value(\"utf8\")\n    )) as Checkpoint;\n    const serializedWrites = await this.db\n      .collection(this.checkpointWritesCollectionName)\n      .find(configurableValues)\n      .toArray();\n    const pendingWrites: CheckpointPendingWrite[] = await Promise.all(\n      serializedWrites.map(async (serializedWrite) => {\n        return [\n          serializedWrite.task_id,\n          serializedWrite.channel,\n          await this.serde.loadsTyped(\n            serializedWrite.type,\n            serializedWrite.value.value(\"utf8\")\n          ),\n        ] as CheckpointPendingWrite;\n      })\n    );\n    return {\n      config: { configurable: configurableValues },\n      checkpoint,\n      pendingWrites,\n      metadata: (await this.serde.loadsTyped(\n        doc.type,\n        doc.metadata.value(\"utf8\")\n      )) as CheckpointMetadata,\n      parentConfig:\n        doc.parent_checkpoint_id != null\n          ? {\n              configurable: {\n                thread_id,\n                checkpoint_ns,\n                checkpoint_id: doc.parent_checkpoint_id,\n              },\n            }\n          : undefined,\n    };\n  }\n\n  /**\n   * Retrieve a list of checkpoint tuples from the MongoDB database based\n   * on the provided config. The checkpoints are ordered by checkpoint ID\n   * in descending order (newest first).\n   */\n  async *list(\n    config: RunnableConfig,\n    options?: CheckpointListOptions\n  ): AsyncGenerator<CheckpointTuple> {\n    const { limit, before, filter } = options ?? {};\n    const query: Record<string, unknown> = {};\n\n    if (config?.configurable?.thread_id) {\n      query.thread_id = config.configurable.thread_id;\n    }\n\n    if (\n      config?.configurable?.checkpoint_ns !== undefined &&\n      config?.configurable?.checkpoint_ns !== null\n    ) {\n      query.checkpoint_ns = config.configurable.checkpoint_ns;\n    }\n\n    if (filter) {\n      Object.entries(filter).forEach(([key, value]) => {\n        query[`metadata.${key}`] = value;\n      });\n    }\n\n    if (before) {\n      query.checkpoint_id = { $lt: before.configurable?.checkpoint_id };\n    }\n\n    let result = this.db\n      .collection(this.checkpointCollectionName)\n      .find(query)\n      .sort(\"checkpoint_id\", -1);\n\n    if (limit !== undefined) {\n      result = result.limit(limit);\n    }\n\n    for await (const doc of result) {\n      const checkpoint = (await this.serde.loadsTyped(\n        doc.type,\n        doc.checkpoint.value(\"utf8\")\n      )) as Checkpoint;\n      const metadata = (await this.serde.loadsTyped(\n        doc.type,\n        doc.metadata.value(\"utf8\")\n      )) as CheckpointMetadata;\n\n      yield {\n        config: {\n          configurable: {\n            thread_id: doc.thread_id,\n            checkpoint_ns: doc.checkpoint_ns,\n            checkpoint_id: doc.checkpoint_id,\n          },\n        },\n        checkpoint,\n        metadata,\n        parentConfig: doc.parent_checkpoint_id\n          ? {\n              configurable: {\n                thread_id: doc.thread_id,\n                checkpoint_ns: doc.checkpoint_ns,\n                checkpoint_id: doc.parent_checkpoint_id,\n              },\n            }\n          : undefined,\n      };\n    }\n  }\n\n  /**\n   * Saves a checkpoint to the MongoDB database. The checkpoint is associated\n   * with the provided config and its parent config (if any).\n   */\n  async put(\n    config: RunnableConfig,\n    checkpoint: Checkpoint,\n    metadata: CheckpointMetadata\n  ): Promise<RunnableConfig> {\n    const thread_id = config.configurable?.thread_id;\n    const checkpoint_ns = config.configurable?.checkpoint_ns ?? \"\";\n    const checkpoint_id = checkpoint.id;\n    if (thread_id === undefined) {\n      throw new Error(\n        `The provided config must contain a configurable field with a \"thread_id\" field.`\n      );\n    }\n    const [\n      [checkpointType, serializedCheckpoint],\n      [metadataType, serializedMetadata],\n    ] = await Promise.all([\n      this.serde.dumpsTyped(checkpoint),\n      this.serde.dumpsTyped(metadata),\n    ]);\n\n    if (checkpointType !== metadataType) {\n      throw new Error(\"Mismatched checkpoint and metadata types.\");\n    }\n    const doc = {\n      parent_checkpoint_id: config.configurable?.checkpoint_id,\n      type: checkpointType,\n      checkpoint: serializedCheckpoint,\n      metadata: serializedMetadata,\n    };\n    const upsertQuery = {\n      thread_id,\n      checkpoint_ns,\n      checkpoint_id,\n    };\n    await this.db\n      .collection(this.checkpointCollectionName)\n      .updateOne(upsertQuery, { $set: doc }, { upsert: true });\n\n    return {\n      configurable: {\n        thread_id,\n        checkpoint_ns,\n        checkpoint_id,\n      },\n    };\n  }\n\n  /**\n   * Saves intermediate writes associated with a checkpoint to the MongoDB database.\n   */\n  async putWrites(\n    config: RunnableConfig,\n    writes: PendingWrite[],\n    taskId: string\n  ): Promise<void> {\n    const thread_id = config.configurable?.thread_id;\n    const checkpoint_ns = config.configurable?.checkpoint_ns;\n    const checkpoint_id = config.configurable?.checkpoint_id;\n    if (\n      thread_id === undefined ||\n      checkpoint_ns === undefined ||\n      checkpoint_id === undefined\n    ) {\n      throw new Error(\n        `The provided config must contain a configurable field with \"thread_id\", \"checkpoint_ns\" and \"checkpoint_id\" fields.`\n      );\n    }\n\n    const operations = await Promise.all(\n      writes.map(async ([channel, value], idx) => {\n        const upsertQuery = {\n          thread_id,\n          checkpoint_ns,\n          checkpoint_id,\n          task_id: taskId,\n          idx,\n        };\n\n        const [type, serializedValue] = await this.serde.dumpsTyped(value);\n\n        return {\n          updateOne: {\n            filter: upsertQuery,\n            update: { $set: { channel, type, value: serializedValue } },\n            upsert: true,\n          },\n        };\n      })\n    );\n\n    await this.db\n      .collection(this.checkpointWritesCollectionName)\n      .bulkWrite(operations);\n  }\n\n  async deleteThread(threadId: string) {\n    await this.db\n      .collection(this.checkpointCollectionName)\n      .deleteMany({ thread_id: threadId });\n\n    await this.db\n      .collection(this.checkpointWritesCollectionName)\n      .deleteMany({ thread_id: threadId });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["BaseCheckpointSaver"],"sources":["../src/index.ts"],"sourcesContent":["import { type MongoClient, type Db as MongoDatabase } from \"mongodb\";\nimport type { RunnableConfig } from \"@langchain/core/runnables\";\nimport {\n  BaseCheckpointSaver,\n  type Checkpoint,\n  type CheckpointListOptions,\n  type CheckpointTuple,\n  type SerializerProtocol,\n  type PendingWrite,\n  type CheckpointMetadata,\n  CheckpointPendingWrite,\n} from \"@langchain/langgraph-checkpoint\";\n\nexport type MongoDBSaverParams = {\n  client: MongoClient;\n  dbName?: string;\n  checkpointCollectionName?: string;\n  checkpointWritesCollectionName?: string;\n};\n\n/**\n * A LangGraph checkpoint saver backed by a MongoDB database.\n */\nexport class MongoDBSaver extends BaseCheckpointSaver {\n  protected client: MongoClient;\n\n  protected db: MongoDatabase;\n\n  checkpointCollectionName = \"checkpoints\";\n\n  checkpointWritesCollectionName = \"checkpoint_writes\";\n\n  constructor(\n    {\n      client,\n      dbName,\n      checkpointCollectionName,\n      checkpointWritesCollectionName,\n    }: MongoDBSaverParams,\n    serde?: SerializerProtocol\n  ) {\n    super(serde);\n    this.client = client;\n    this.client.appendMetadata({\n      name: \"langgraphjs_checkpoint_saver\",\n    });\n    this.db = this.client.db(dbName);\n    this.checkpointCollectionName =\n      checkpointCollectionName ?? this.checkpointCollectionName;\n    this.checkpointWritesCollectionName =\n      checkpointWritesCollectionName ?? this.checkpointWritesCollectionName;\n  }\n\n  /**\n   * Retrieves a checkpoint from the MongoDB database based on the\n   * provided config. If the config contains a \"checkpoint_id\" key, the checkpoint with\n   * the matching thread ID and checkpoint ID is retrieved. Otherwise, the latest checkpoint\n   * for the given thread ID is retrieved.\n   */\n  async getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined> {\n    const {\n      thread_id,\n      checkpoint_ns = \"\",\n      checkpoint_id,\n    } = config.configurable ?? {};\n    let query;\n    if (checkpoint_id) {\n      query = {\n        thread_id,\n        checkpoint_ns,\n        checkpoint_id,\n      };\n    } else {\n      query = { thread_id, checkpoint_ns };\n    }\n    const result = await this.db\n      .collection(this.checkpointCollectionName)\n      .find(query)\n      .sort(\"checkpoint_id\", -1)\n      .limit(1)\n      .toArray();\n    if (result.length === 0) {\n      return undefined;\n    }\n    const doc = result[0];\n    const configurableValues = {\n      thread_id,\n      checkpoint_ns,\n      checkpoint_id: doc.checkpoint_id,\n    };\n    const checkpoint = (await this.serde.loadsTyped(\n      doc.type,\n      doc.checkpoint.value(\"utf8\")\n    )) as Checkpoint;\n    const serializedWrites = await this.db\n      .collection(this.checkpointWritesCollectionName)\n      .find(configurableValues)\n      .toArray();\n    const pendingWrites: CheckpointPendingWrite[] = await Promise.all(\n      serializedWrites.map(async (serializedWrite) => {\n        return [\n          serializedWrite.task_id,\n          serializedWrite.channel,\n          await this.serde.loadsTyped(\n            serializedWrite.type,\n            serializedWrite.value.value(\"utf8\")\n          ),\n        ] as CheckpointPendingWrite;\n      })\n    );\n    return {\n      config: { configurable: configurableValues },\n      checkpoint,\n      pendingWrites,\n      metadata: (await this.serde.loadsTyped(\n        doc.type,\n        doc.metadata.value(\"utf8\")\n      )) as CheckpointMetadata,\n      parentConfig:\n        doc.parent_checkpoint_id != null\n          ? {\n              configurable: {\n                thread_id,\n                checkpoint_ns,\n                checkpoint_id: doc.parent_checkpoint_id,\n              },\n            }\n          : undefined,\n    };\n  }\n\n  /**\n   * Retrieve a list of checkpoint tuples from the MongoDB database based\n   * on the provided config. The checkpoints are ordered by checkpoint ID\n   * in descending order (newest first).\n   */\n  async *list(\n    config: RunnableConfig,\n    options?: CheckpointListOptions\n  ): AsyncGenerator<CheckpointTuple> {\n    const { limit, before, filter } = options ?? {};\n    const query: Record<string, unknown> = {};\n\n    if (config?.configurable?.thread_id) {\n      query.thread_id = config.configurable.thread_id;\n    }\n\n    if (\n      config?.configurable?.checkpoint_ns !== undefined &&\n      config?.configurable?.checkpoint_ns !== null\n    ) {\n      query.checkpoint_ns = config.configurable.checkpoint_ns;\n    }\n\n    if (filter) {\n      Object.entries(filter).forEach(([key, value]) => {\n        // Prevent MongoDB operator injection - only allow primitive values\n        if (value !== null && typeof value === \"object\") {\n          throw new Error(\n            `Invalid filter value for key \"${key}\": filter values must be primitives (string, number, boolean, or null)`\n          );\n        }\n        query[`metadata.${key}`] = value;\n      });\n    }\n\n    if (before) {\n      query.checkpoint_id = { $lt: before.configurable?.checkpoint_id };\n    }\n\n    let result = this.db\n      .collection(this.checkpointCollectionName)\n      .find(query)\n      .sort(\"checkpoint_id\", -1);\n\n    if (limit !== undefined) {\n      result = result.limit(limit);\n    }\n\n    for await (const doc of result) {\n      const checkpoint = (await this.serde.loadsTyped(\n        doc.type,\n        doc.checkpoint.value(\"utf8\")\n      )) as Checkpoint;\n      const metadata = (await this.serde.loadsTyped(\n        doc.type,\n        doc.metadata.value(\"utf8\")\n      )) as CheckpointMetadata;\n\n      yield {\n        config: {\n          configurable: {\n            thread_id: doc.thread_id,\n            checkpoint_ns: doc.checkpoint_ns,\n            checkpoint_id: doc.checkpoint_id,\n          },\n        },\n        checkpoint,\n        metadata,\n        parentConfig: doc.parent_checkpoint_id\n          ? {\n              configurable: {\n                thread_id: doc.thread_id,\n                checkpoint_ns: doc.checkpoint_ns,\n                checkpoint_id: doc.parent_checkpoint_id,\n              },\n            }\n          : undefined,\n      };\n    }\n  }\n\n  /**\n   * Saves a checkpoint to the MongoDB database. The checkpoint is associated\n   * with the provided config and its parent config (if any).\n   */\n  async put(\n    config: RunnableConfig,\n    checkpoint: Checkpoint,\n    metadata: CheckpointMetadata\n  ): Promise<RunnableConfig> {\n    const thread_id = config.configurable?.thread_id;\n    const checkpoint_ns = config.configurable?.checkpoint_ns ?? \"\";\n    const checkpoint_id = checkpoint.id;\n    if (thread_id === undefined) {\n      throw new Error(\n        `The provided config must contain a configurable field with a \"thread_id\" field.`\n      );\n    }\n    const [\n      [checkpointType, serializedCheckpoint],\n      [metadataType, serializedMetadata],\n    ] = await Promise.all([\n      this.serde.dumpsTyped(checkpoint),\n      this.serde.dumpsTyped(metadata),\n    ]);\n\n    if (checkpointType !== metadataType) {\n      throw new Error(\"Mismatched checkpoint and metadata types.\");\n    }\n    const doc = {\n      parent_checkpoint_id: config.configurable?.checkpoint_id,\n      type: checkpointType,\n      checkpoint: serializedCheckpoint,\n      metadata: serializedMetadata,\n    };\n    const upsertQuery = {\n      thread_id,\n      checkpoint_ns,\n      checkpoint_id,\n    };\n    await this.db\n      .collection(this.checkpointCollectionName)\n      .updateOne(upsertQuery, { $set: doc }, { upsert: true });\n\n    return {\n      configurable: {\n        thread_id,\n        checkpoint_ns,\n        checkpoint_id,\n      },\n    };\n  }\n\n  /**\n   * Saves intermediate writes associated with a checkpoint to the MongoDB database.\n   */\n  async putWrites(\n    config: RunnableConfig,\n    writes: PendingWrite[],\n    taskId: string\n  ): Promise<void> {\n    const thread_id = config.configurable?.thread_id;\n    const checkpoint_ns = config.configurable?.checkpoint_ns;\n    const checkpoint_id = config.configurable?.checkpoint_id;\n    if (\n      thread_id === undefined ||\n      checkpoint_ns === undefined ||\n      checkpoint_id === undefined\n    ) {\n      throw new Error(\n        `The provided config must contain a configurable field with \"thread_id\", \"checkpoint_ns\" and \"checkpoint_id\" fields.`\n      );\n    }\n\n    const operations = await Promise.all(\n      writes.map(async ([channel, value], idx) => {\n        const upsertQuery = {\n          thread_id,\n          checkpoint_ns,\n          checkpoint_id,\n          task_id: taskId,\n          idx,\n        };\n\n        const [type, serializedValue] = await this.serde.dumpsTyped(value);\n\n        return {\n          updateOne: {\n            filter: upsertQuery,\n            update: { $set: { channel, type, value: serializedValue } },\n            upsert: true,\n          },\n        };\n      })\n    );\n\n    await this.db\n      .collection(this.checkpointWritesCollectionName)\n      .bulkWrite(operations);\n  }\n\n  async deleteThread(threadId: string) {\n    await this.db\n      .collection(this.checkpointCollectionName)\n      .deleteMany({ thread_id: threadId });\n\n    await this.db\n      .collection(this.checkpointWritesCollectionName)\n      .deleteMany({ thread_id: threadId });\n  }\n}\n"],"mappings":"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"}

package/dist/index.js

@@ -75,6 +75,7 @@ var MongoDBSaver = class extends BaseCheckpointSaver {
 		if (config?.configurable?.thread_id) query.thread_id = config.configurable.thread_id;
 		if (config?.configurable?.checkpoint_ns !== void 0 && config?.configurable?.checkpoint_ns !== null) query.checkpoint_ns = config.configurable.checkpoint_ns;
 		if (filter) Object.entries(filter).forEach(([key, value]) => {
+			if (value !== null && typeof value === "object") throw new Error(`Invalid filter value for key "${key}": filter values must be primitives (string, number, boolean, or null)`);
 			query[`metadata.${key}`] = value;
 		});
 		if (before) query.checkpoint_id = { $lt: before.configurable?.checkpoint_id };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { type MongoClient, type Db as MongoDatabase } from \"mongodb\";\nimport type { RunnableConfig } from \"@langchain/core/runnables\";\nimport {\n  BaseCheckpointSaver,\n  type Checkpoint,\n  type CheckpointListOptions,\n  type CheckpointTuple,\n  type SerializerProtocol,\n  type PendingWrite,\n  type CheckpointMetadata,\n  CheckpointPendingWrite,\n} from \"@langchain/langgraph-checkpoint\";\n\nexport type MongoDBSaverParams = {\n  client: MongoClient;\n  dbName?: string;\n  checkpointCollectionName?: string;\n  checkpointWritesCollectionName?: string;\n};\n\n/**\n * A LangGraph checkpoint saver backed by a MongoDB database.\n */\nexport class MongoDBSaver extends BaseCheckpointSaver {\n  protected client: MongoClient;\n\n  protected db: MongoDatabase;\n\n  checkpointCollectionName = \"checkpoints\";\n\n  checkpointWritesCollectionName = \"checkpoint_writes\";\n\n  constructor(\n    {\n      client,\n      dbName,\n      checkpointCollectionName,\n      checkpointWritesCollectionName,\n    }: MongoDBSaverParams,\n    serde?: SerializerProtocol\n  ) {\n    super(serde);\n    this.client = client;\n    this.client.appendMetadata({\n      name: \"langgraphjs_checkpoint_saver\",\n    });\n    this.db = this.client.db(dbName);\n    this.checkpointCollectionName =\n      checkpointCollectionName ?? this.checkpointCollectionName;\n    this.checkpointWritesCollectionName =\n      checkpointWritesCollectionName ?? this.checkpointWritesCollectionName;\n  }\n\n  /**\n   * Retrieves a checkpoint from the MongoDB database based on the\n   * provided config. If the config contains a \"checkpoint_id\" key, the checkpoint with\n   * the matching thread ID and checkpoint ID is retrieved. Otherwise, the latest checkpoint\n   * for the given thread ID is retrieved.\n   */\n  async getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined> {\n    const {\n      thread_id,\n      checkpoint_ns = \"\",\n      checkpoint_id,\n    } = config.configurable ?? {};\n    let query;\n    if (checkpoint_id) {\n      query = {\n        thread_id,\n        checkpoint_ns,\n        checkpoint_id,\n      };\n    } else {\n      query = { thread_id, checkpoint_ns };\n    }\n    const result = await this.db\n      .collection(this.checkpointCollectionName)\n      .find(query)\n      .sort(\"checkpoint_id\", -1)\n      .limit(1)\n      .toArray();\n    if (result.length === 0) {\n      return undefined;\n    }\n    const doc = result[0];\n    const configurableValues = {\n      thread_id,\n      checkpoint_ns,\n      checkpoint_id: doc.checkpoint_id,\n    };\n    const checkpoint = (await this.serde.loadsTyped(\n      doc.type,\n      doc.checkpoint.value(\"utf8\")\n    )) as Checkpoint;\n    const serializedWrites = await this.db\n      .collection(this.checkpointWritesCollectionName)\n      .find(configurableValues)\n      .toArray();\n    const pendingWrites: CheckpointPendingWrite[] = await Promise.all(\n      serializedWrites.map(async (serializedWrite) => {\n        return [\n          serializedWrite.task_id,\n          serializedWrite.channel,\n          await this.serde.loadsTyped(\n            serializedWrite.type,\n            serializedWrite.value.value(\"utf8\")\n          ),\n        ] as CheckpointPendingWrite;\n      })\n    );\n    return {\n      config: { configurable: configurableValues },\n      checkpoint,\n      pendingWrites,\n      metadata: (await this.serde.loadsTyped(\n        doc.type,\n        doc.metadata.value(\"utf8\")\n      )) as CheckpointMetadata,\n      parentConfig:\n        doc.parent_checkpoint_id != null\n          ? {\n              configurable: {\n                thread_id,\n                checkpoint_ns,\n                checkpoint_id: doc.parent_checkpoint_id,\n              },\n            }\n          : undefined,\n    };\n  }\n\n  /**\n   * Retrieve a list of checkpoint tuples from the MongoDB database based\n   * on the provided config. The checkpoints are ordered by checkpoint ID\n   * in descending order (newest first).\n   */\n  async *list(\n    config: RunnableConfig,\n    options?: CheckpointListOptions\n  ): AsyncGenerator<CheckpointTuple> {\n    const { limit, before, filter } = options ?? {};\n    const query: Record<string, unknown> = {};\n\n    if (config?.configurable?.thread_id) {\n      query.thread_id = config.configurable.thread_id;\n    }\n\n    if (\n      config?.configurable?.checkpoint_ns !== undefined &&\n      config?.configurable?.checkpoint_ns !== null\n    ) {\n      query.checkpoint_ns = config.configurable.checkpoint_ns;\n    }\n\n    if (filter) {\n      Object.entries(filter).forEach(([key, value]) => {\n        query[`metadata.${key}`] = value;\n      });\n    }\n\n    if (before) {\n      query.checkpoint_id = { $lt: before.configurable?.checkpoint_id };\n    }\n\n    let result = this.db\n      .collection(this.checkpointCollectionName)\n      .find(query)\n      .sort(\"checkpoint_id\", -1);\n\n    if (limit !== undefined) {\n      result = result.limit(limit);\n    }\n\n    for await (const doc of result) {\n      const checkpoint = (await this.serde.loadsTyped(\n        doc.type,\n        doc.checkpoint.value(\"utf8\")\n      )) as Checkpoint;\n      const metadata = (await this.serde.loadsTyped(\n        doc.type,\n        doc.metadata.value(\"utf8\")\n      )) as CheckpointMetadata;\n\n      yield {\n        config: {\n          configurable: {\n            thread_id: doc.thread_id,\n            checkpoint_ns: doc.checkpoint_ns,\n            checkpoint_id: doc.checkpoint_id,\n          },\n        },\n        checkpoint,\n        metadata,\n        parentConfig: doc.parent_checkpoint_id\n          ? {\n              configurable: {\n                thread_id: doc.thread_id,\n                checkpoint_ns: doc.checkpoint_ns,\n                checkpoint_id: doc.parent_checkpoint_id,\n              },\n            }\n          : undefined,\n      };\n    }\n  }\n\n  /**\n   * Saves a checkpoint to the MongoDB database. The checkpoint is associated\n   * with the provided config and its parent config (if any).\n   */\n  async put(\n    config: RunnableConfig,\n    checkpoint: Checkpoint,\n    metadata: CheckpointMetadata\n  ): Promise<RunnableConfig> {\n    const thread_id = config.configurable?.thread_id;\n    const checkpoint_ns = config.configurable?.checkpoint_ns ?? \"\";\n    const checkpoint_id = checkpoint.id;\n    if (thread_id === undefined) {\n      throw new Error(\n        `The provided config must contain a configurable field with a \"thread_id\" field.`\n      );\n    }\n    const [\n      [checkpointType, serializedCheckpoint],\n      [metadataType, serializedMetadata],\n    ] = await Promise.all([\n      this.serde.dumpsTyped(checkpoint),\n      this.serde.dumpsTyped(metadata),\n    ]);\n\n    if (checkpointType !== metadataType) {\n      throw new Error(\"Mismatched checkpoint and metadata types.\");\n    }\n    const doc = {\n      parent_checkpoint_id: config.configurable?.checkpoint_id,\n      type: checkpointType,\n      checkpoint: serializedCheckpoint,\n      metadata: serializedMetadata,\n    };\n    const upsertQuery = {\n      thread_id,\n      checkpoint_ns,\n      checkpoint_id,\n    };\n    await this.db\n      .collection(this.checkpointCollectionName)\n      .updateOne(upsertQuery, { $set: doc }, { upsert: true });\n\n    return {\n      configurable: {\n        thread_id,\n        checkpoint_ns,\n        checkpoint_id,\n      },\n    };\n  }\n\n  /**\n   * Saves intermediate writes associated with a checkpoint to the MongoDB database.\n   */\n  async putWrites(\n    config: RunnableConfig,\n    writes: PendingWrite[],\n    taskId: string\n  ): Promise<void> {\n    const thread_id = config.configurable?.thread_id;\n    const checkpoint_ns = config.configurable?.checkpoint_ns;\n    const checkpoint_id = config.configurable?.checkpoint_id;\n    if (\n      thread_id === undefined ||\n      checkpoint_ns === undefined ||\n      checkpoint_id === undefined\n    ) {\n      throw new Error(\n        `The provided config must contain a configurable field with \"thread_id\", \"checkpoint_ns\" and \"checkpoint_id\" fields.`\n      );\n    }\n\n    const operations = await Promise.all(\n      writes.map(async ([channel, value], idx) => {\n        const upsertQuery = {\n          thread_id,\n          checkpoint_ns,\n          checkpoint_id,\n          task_id: taskId,\n          idx,\n        };\n\n        const [type, serializedValue] = await this.serde.dumpsTyped(value);\n\n        return {\n          updateOne: {\n            filter: upsertQuery,\n            update: { $set: { channel, type, value: serializedValue } },\n            upsert: true,\n          },\n        };\n      })\n    );\n\n    await this.db\n      .collection(this.checkpointWritesCollectionName)\n      .bulkWrite(operations);\n  }\n\n  async deleteThread(threadId: string) {\n    await this.db\n      .collection(this.checkpointCollectionName)\n      .deleteMany({ thread_id: threadId });\n\n    await this.db\n      .collection(this.checkpointWritesCollectionName)\n      .deleteMany({ thread_id: threadId });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { type MongoClient, type Db as MongoDatabase } from \"mongodb\";\nimport type { RunnableConfig } from \"@langchain/core/runnables\";\nimport {\n  BaseCheckpointSaver,\n  type Checkpoint,\n  type CheckpointListOptions,\n  type CheckpointTuple,\n  type SerializerProtocol,\n  type PendingWrite,\n  type CheckpointMetadata,\n  CheckpointPendingWrite,\n} from \"@langchain/langgraph-checkpoint\";\n\nexport type MongoDBSaverParams = {\n  client: MongoClient;\n  dbName?: string;\n  checkpointCollectionName?: string;\n  checkpointWritesCollectionName?: string;\n};\n\n/**\n * A LangGraph checkpoint saver backed by a MongoDB database.\n */\nexport class MongoDBSaver extends BaseCheckpointSaver {\n  protected client: MongoClient;\n\n  protected db: MongoDatabase;\n\n  checkpointCollectionName = \"checkpoints\";\n\n  checkpointWritesCollectionName = \"checkpoint_writes\";\n\n  constructor(\n    {\n      client,\n      dbName,\n      checkpointCollectionName,\n      checkpointWritesCollectionName,\n    }: MongoDBSaverParams,\n    serde?: SerializerProtocol\n  ) {\n    super(serde);\n    this.client = client;\n    this.client.appendMetadata({\n      name: \"langgraphjs_checkpoint_saver\",\n    });\n    this.db = this.client.db(dbName);\n    this.checkpointCollectionName =\n      checkpointCollectionName ?? this.checkpointCollectionName;\n    this.checkpointWritesCollectionName =\n      checkpointWritesCollectionName ?? this.checkpointWritesCollectionName;\n  }\n\n  /**\n   * Retrieves a checkpoint from the MongoDB database based on the\n   * provided config. If the config contains a \"checkpoint_id\" key, the checkpoint with\n   * the matching thread ID and checkpoint ID is retrieved. Otherwise, the latest checkpoint\n   * for the given thread ID is retrieved.\n   */\n  async getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined> {\n    const {\n      thread_id,\n      checkpoint_ns = \"\",\n      checkpoint_id,\n    } = config.configurable ?? {};\n    let query;\n    if (checkpoint_id) {\n      query = {\n        thread_id,\n        checkpoint_ns,\n        checkpoint_id,\n      };\n    } else {\n      query = { thread_id, checkpoint_ns };\n    }\n    const result = await this.db\n      .collection(this.checkpointCollectionName)\n      .find(query)\n      .sort(\"checkpoint_id\", -1)\n      .limit(1)\n      .toArray();\n    if (result.length === 0) {\n      return undefined;\n    }\n    const doc = result[0];\n    const configurableValues = {\n      thread_id,\n      checkpoint_ns,\n      checkpoint_id: doc.checkpoint_id,\n    };\n    const checkpoint = (await this.serde.loadsTyped(\n      doc.type,\n      doc.checkpoint.value(\"utf8\")\n    )) as Checkpoint;\n    const serializedWrites = await this.db\n      .collection(this.checkpointWritesCollectionName)\n      .find(configurableValues)\n      .toArray();\n    const pendingWrites: CheckpointPendingWrite[] = await Promise.all(\n      serializedWrites.map(async (serializedWrite) => {\n        return [\n          serializedWrite.task_id,\n          serializedWrite.channel,\n          await this.serde.loadsTyped(\n            serializedWrite.type,\n            serializedWrite.value.value(\"utf8\")\n          ),\n        ] as CheckpointPendingWrite;\n      })\n    );\n    return {\n      config: { configurable: configurableValues },\n      checkpoint,\n      pendingWrites,\n      metadata: (await this.serde.loadsTyped(\n        doc.type,\n        doc.metadata.value(\"utf8\")\n      )) as CheckpointMetadata,\n      parentConfig:\n        doc.parent_checkpoint_id != null\n          ? {\n              configurable: {\n                thread_id,\n                checkpoint_ns,\n                checkpoint_id: doc.parent_checkpoint_id,\n              },\n            }\n          : undefined,\n    };\n  }\n\n  /**\n   * Retrieve a list of checkpoint tuples from the MongoDB database based\n   * on the provided config. The checkpoints are ordered by checkpoint ID\n   * in descending order (newest first).\n   */\n  async *list(\n    config: RunnableConfig,\n    options?: CheckpointListOptions\n  ): AsyncGenerator<CheckpointTuple> {\n    const { limit, before, filter } = options ?? {};\n    const query: Record<string, unknown> = {};\n\n    if (config?.configurable?.thread_id) {\n      query.thread_id = config.configurable.thread_id;\n    }\n\n    if (\n      config?.configurable?.checkpoint_ns !== undefined &&\n      config?.configurable?.checkpoint_ns !== null\n    ) {\n      query.checkpoint_ns = config.configurable.checkpoint_ns;\n    }\n\n    if (filter) {\n      Object.entries(filter).forEach(([key, value]) => {\n        // Prevent MongoDB operator injection - only allow primitive values\n        if (value !== null && typeof value === \"object\") {\n          throw new Error(\n            `Invalid filter value for key \"${key}\": filter values must be primitives (string, number, boolean, or null)`\n          );\n        }\n        query[`metadata.${key}`] = value;\n      });\n    }\n\n    if (before) {\n      query.checkpoint_id = { $lt: before.configurable?.checkpoint_id };\n    }\n\n    let result = this.db\n      .collection(this.checkpointCollectionName)\n      .find(query)\n      .sort(\"checkpoint_id\", -1);\n\n    if (limit !== undefined) {\n      result = result.limit(limit);\n    }\n\n    for await (const doc of result) {\n      const checkpoint = (await this.serde.loadsTyped(\n        doc.type,\n        doc.checkpoint.value(\"utf8\")\n      )) as Checkpoint;\n      const metadata = (await this.serde.loadsTyped(\n        doc.type,\n        doc.metadata.value(\"utf8\")\n      )) as CheckpointMetadata;\n\n      yield {\n        config: {\n          configurable: {\n            thread_id: doc.thread_id,\n            checkpoint_ns: doc.checkpoint_ns,\n            checkpoint_id: doc.checkpoint_id,\n          },\n        },\n        checkpoint,\n        metadata,\n        parentConfig: doc.parent_checkpoint_id\n          ? {\n              configurable: {\n                thread_id: doc.thread_id,\n                checkpoint_ns: doc.checkpoint_ns,\n                checkpoint_id: doc.parent_checkpoint_id,\n              },\n            }\n          : undefined,\n      };\n    }\n  }\n\n  /**\n   * Saves a checkpoint to the MongoDB database. The checkpoint is associated\n   * with the provided config and its parent config (if any).\n   */\n  async put(\n    config: RunnableConfig,\n    checkpoint: Checkpoint,\n    metadata: CheckpointMetadata\n  ): Promise<RunnableConfig> {\n    const thread_id = config.configurable?.thread_id;\n    const checkpoint_ns = config.configurable?.checkpoint_ns ?? \"\";\n    const checkpoint_id = checkpoint.id;\n    if (thread_id === undefined) {\n      throw new Error(\n        `The provided config must contain a configurable field with a \"thread_id\" field.`\n      );\n    }\n    const [\n      [checkpointType, serializedCheckpoint],\n      [metadataType, serializedMetadata],\n    ] = await Promise.all([\n      this.serde.dumpsTyped(checkpoint),\n      this.serde.dumpsTyped(metadata),\n    ]);\n\n    if (checkpointType !== metadataType) {\n      throw new Error(\"Mismatched checkpoint and metadata types.\");\n    }\n    const doc = {\n      parent_checkpoint_id: config.configurable?.checkpoint_id,\n      type: checkpointType,\n      checkpoint: serializedCheckpoint,\n      metadata: serializedMetadata,\n    };\n    const upsertQuery = {\n      thread_id,\n      checkpoint_ns,\n      checkpoint_id,\n    };\n    await this.db\n      .collection(this.checkpointCollectionName)\n      .updateOne(upsertQuery, { $set: doc }, { upsert: true });\n\n    return {\n      configurable: {\n        thread_id,\n        checkpoint_ns,\n        checkpoint_id,\n      },\n    };\n  }\n\n  /**\n   * Saves intermediate writes associated with a checkpoint to the MongoDB database.\n   */\n  async putWrites(\n    config: RunnableConfig,\n    writes: PendingWrite[],\n    taskId: string\n  ): Promise<void> {\n    const thread_id = config.configurable?.thread_id;\n    const checkpoint_ns = config.configurable?.checkpoint_ns;\n    const checkpoint_id = config.configurable?.checkpoint_id;\n    if (\n      thread_id === undefined ||\n      checkpoint_ns === undefined ||\n      checkpoint_id === undefined\n    ) {\n      throw new Error(\n        `The provided config must contain a configurable field with \"thread_id\", \"checkpoint_ns\" and \"checkpoint_id\" fields.`\n      );\n    }\n\n    const operations = await Promise.all(\n      writes.map(async ([channel, value], idx) => {\n        const upsertQuery = {\n          thread_id,\n          checkpoint_ns,\n          checkpoint_id,\n          task_id: taskId,\n          idx,\n        };\n\n        const [type, serializedValue] = await this.serde.dumpsTyped(value);\n\n        return {\n          updateOne: {\n            filter: upsertQuery,\n            update: { $set: { channel, type, value: serializedValue } },\n            upsert: true,\n          },\n        };\n      })\n    );\n\n    await this.db\n      .collection(this.checkpointWritesCollectionName)\n      .bulkWrite(operations);\n  }\n\n  async deleteThread(threadId: string) {\n    await this.db\n      .collection(this.checkpointCollectionName)\n      .deleteMany({ thread_id: threadId });\n\n    await this.db\n      .collection(this.checkpointWritesCollectionName)\n      .deleteMany({ thread_id: threadId });\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-checkpoint-mongodb",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "LangGraph",
   "type": "module",
   "engines": {
@@ -13,21 +13,6 @@
     "url": "git+ssh://git@github.com/langchain-ai/langgraphjs.git",
     "directory": "libs/checkpoint-mongodb"
   },
-  "scripts": {
-    "build": "yarn turbo:command build:internal --filter=@langchain/langgraph-checkpoint-mongodb",
-    "build:internal": "yarn workspace @langchain/build compile @langchain/langgraph-checkpoint-mongodb",
-    "clean": "rm -rf dist/ dist-cjs/ .turbo/",
-    "lint:eslint": "NODE_OPTIONS=--max-old-space-size=4096 eslint --cache --ext .ts,.js src/",
-    "lint:dpdm": "dpdm --exit-code circular:1 --no-warning --no-tree src/*.ts src/**/*.ts",
-    "lint": "yarn lint:eslint && yarn lint:dpdm",
-    "lint:fix": "yarn lint:eslint --fix && yarn lint:dpdm",
-    "prepublish": "yarn build",
-    "test": "vitest run",
-    "test:watch": "vitest watch",
-    "test:int": "vitest run --mode int",
-    "format": "prettier --config .prettierrc --write \"src\"",
-    "format:check": "prettier --config .prettierrc --check \"src\""
-  },
   "author": "LangChain",
   "license": "MIT",
   "dependencies": {
@@ -38,7 +23,6 @@
     "@langchain/langgraph-checkpoint": "^1.0.0"
   },
   "devDependencies": {
-    "@langchain/langgraph-checkpoint": "workspace:*",
     "@langchain/scripts": ">=0.1.3 <0.2.0",
     "@tsconfig/recommended": "^1.0.3",
     "@types/better-sqlite3": "^7.6.12",
@@ -57,7 +41,8 @@
     "rollup": "^4.37.0",
     "tsx": "^4.19.3",
     "typescript": "^4.9.5 || ^5.4.5",
-    "vitest": "^3.2.4"
+    "vitest": "^3.2.4",
+    "@langchain/langgraph-checkpoint": "1.0.0"
   },
   "publishConfig": {
     "access": "public",
@@ -80,5 +65,20 @@
   },
   "files": [
     "dist/"
-  ]
-}
+  ],
+  "scripts": {
+    "build": "pnpm turbo build:internal --filter=@langchain/langgraph-checkpoint-mongodb",
+    "build:internal": "pnpm --filter @langchain/build compile @langchain/langgraph-checkpoint-mongodb",
+    "clean": "rm -rf dist/ dist-cjs/ .turbo/",
+    "lint:eslint": "NODE_OPTIONS=--max-old-space-size=4096 eslint --cache --ext .ts,.js src/",
+    "lint:dpdm": "dpdm --exit-code circular:1 --no-warning --no-tree src/*.ts src/**/*.ts",
+    "lint": "pnpm lint:eslint && pnpm lint:dpdm",
+    "lint:fix": "pnpm lint:eslint --fix && pnpm lint:dpdm",
+    "prepublish": "pnpm build",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:int": "vitest run --mode int",
+    "format": "prettier --config .prettierrc --write \"src\"",
+    "format:check": "prettier --config .prettierrc --check \"src\""
+  }
+}