@langchain/core 1.0.0-alpha.3 → 1.0.0-alpha.5

package/dist/utils/testing/vectorstores.d.cts

@@ -0,0 +1,101 @@
+import { Document } from "../../documents/document.cjs";
+import { EmbeddingsInterface } from "../../embeddings.cjs";
+import { VectorStore } from "../../vectorstores.cjs";
+import { cosine } from "../ml-distance/similarities.cjs";
+
+//#region src/utils/testing/vectorstores.d.ts
+
+/**
+ * Interface representing a vector in memory. It includes the content
+ * (text), the corresponding embedding (vector), and any associated
+ * metadata.
+ */
+interface MemoryVector {
+  content: string;
+  embedding: number[];
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  metadata: Record<string, any>;
+}
+/**
+ * Interface for the arguments that can be passed to the
+ * `FakeVectorStore` constructor. It includes an optional `similarity`
+ * function.
+ */
+interface FakeVectorStoreArgs {
+  similarity?: typeof cosine;
+}
+/**
+ * Class that extends `VectorStore` to store vectors in memory. Provides
+ * methods for adding documents, performing similarity searches, and
+ * creating instances from texts, documents, or an existing index.
+ */
+declare class FakeVectorStore extends VectorStore {
+  FilterType: (doc: Document) => boolean;
+  memoryVectors: MemoryVector[];
+  similarity: typeof cosine;
+  _vectorstoreType(): string;
+  constructor(embeddings: EmbeddingsInterface, {
+    similarity,
+    ...rest
+  }?: FakeVectorStoreArgs);
+  /**
+   * Method to add documents to the memory vector store. It extracts the
+   * text from each document, generates embeddings for them, and adds the
+   * resulting vectors to the store.
+   * @param documents Array of `Document` instances to be added to the store.
+   * @returns Promise that resolves when all documents have been added.
+   */
+  addDocuments(documents: Document[]): Promise<void>;
+  /**
+   * Method to add vectors to the memory vector store. It creates
+   * `MemoryVector` instances for each vector and document pair and adds
+   * them to the store.
+   * @param vectors Array of vectors to be added to the store.
+   * @param documents Array of `Document` instances corresponding to the vectors.
+   * @returns Promise that resolves when all vectors have been added.
+   */
+  addVectors(vectors: number[][], documents: Document[]): Promise<void>;
+  /**
+   * Method to perform a similarity search in the memory vector store. It
+   * calculates the similarity between the query vector and each vector in
+   * the store, sorts the results by similarity, and returns the top `k`
+   * results along with their scores.
+   * @param query Query vector to compare against the vectors in the store.
+   * @param k Number of top results to return.
+   * @param filter Optional filter function to apply to the vectors before performing the search.
+   * @returns Promise that resolves with an array of tuples, each containing a `Document` and its similarity score.
+   */
+  similaritySearchVectorWithScore(query: number[], k: number, filter?: this["FilterType"]): Promise<[Document, number][]>;
+  /**
+   * Static method to create a `FakeVectorStore` instance from an array of
+   * texts. It creates a `Document` for each text and metadata pair, and
+   * adds them to the store.
+   * @param texts Array of texts to be added to the store.
+   * @param metadatas Array or single object of metadata corresponding to the texts.
+   * @param embeddings `Embeddings` instance used to generate embeddings for the texts.
+   * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.
+   * @returns Promise that resolves with a new `FakeVectorStore` instance.
+   */
+  static fromTexts(texts: string[], metadatas: object[] | object, embeddings: EmbeddingsInterface, dbConfig?: FakeVectorStoreArgs): Promise<FakeVectorStore>;
+  /**
+   * Static method to create a `FakeVectorStore` instance from an array of
+   * `Document` instances. It adds the documents to the store.
+   * @param docs Array of `Document` instances to be added to the store.
+   * @param embeddings `Embeddings` instance used to generate embeddings for the documents.
+   * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.
+   * @returns Promise that resolves with a new `FakeVectorStore` instance.
+   */
+  static fromDocuments(docs: Document[], embeddings: EmbeddingsInterface, dbConfig?: FakeVectorStoreArgs): Promise<FakeVectorStore>;
+  /**
+   * Static method to create a `FakeVectorStore` instance from an existing
+   * index. It creates a new `FakeVectorStore` instance without adding any
+   * documents or vectors.
+   * @param embeddings `Embeddings` instance used to generate embeddings for the documents.
+   * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.
+   * @returns Promise that resolves with a new `FakeVectorStore` instance.
+   */
+  static fromExistingIndex(embeddings: EmbeddingsInterface, dbConfig?: FakeVectorStoreArgs): Promise<FakeVectorStore>;
+}
+//#endregion
+export { FakeVectorStore, FakeVectorStoreArgs };
+//# sourceMappingURL=vectorstores.d.cts.map

package/dist/utils/testing/vectorstores.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectorstores.d.cts","names":["Document","EmbeddingsInterface","VectorStore","cosine","MemoryVector","Record","FakeVectorStoreArgs","FakeVectorStore","similarity","Promise"],"sources":["../../../src/utils/testing/vectorstores.d.ts"],"sourcesContent":["import { Document } from \"../../documents/document.js\";\nimport { EmbeddingsInterface } from \"../../embeddings.js\";\nimport { VectorStore } from \"../../vectorstores.js\";\nimport { cosine } from \"../ml-distance/similarities.js\";\n/**\n * Interface representing a vector in memory. It includes the content\n * (text), the corresponding embedding (vector), and any associated\n * metadata.\n */\ninterface MemoryVector {\n    content: string;\n    embedding: number[];\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    metadata: Record<string, any>;\n}\n/**\n * Interface for the arguments that can be passed to the\n * `FakeVectorStore` constructor. It includes an optional `similarity`\n * function.\n */\nexport interface FakeVectorStoreArgs {\n    similarity?: typeof cosine;\n}\n/**\n * Class that extends `VectorStore` to store vectors in memory. Provides\n * methods for adding documents, performing similarity searches, and\n * creating instances from texts, documents, or an existing index.\n */\nexport declare class FakeVectorStore extends VectorStore {\n    FilterType: (doc: Document) => boolean;\n    memoryVectors: MemoryVector[];\n    similarity: typeof cosine;\n    _vectorstoreType(): string;\n    constructor(embeddings: EmbeddingsInterface, { similarity, ...rest }?: FakeVectorStoreArgs);\n    /**\n     * Method to add documents to the memory vector store. It extracts the\n     * text from each document, generates embeddings for them, and adds the\n     * resulting vectors to the store.\n     * @param documents Array of `Document` instances to be added to the store.\n     * @returns Promise that resolves when all documents have been added.\n     */\n    addDocuments(documents: Document[]): Promise<void>;\n    /**\n     * Method to add vectors to the memory vector store. It creates\n     * `MemoryVector` instances for each vector and document pair and adds\n     * them to the store.\n     * @param vectors Array of vectors to be added to the store.\n     * @param documents Array of `Document` instances corresponding to the vectors.\n     * @returns Promise that resolves when all vectors have been added.\n     */\n    addVectors(vectors: number[][], documents: Document[]): Promise<void>;\n    /**\n     * Method to perform a similarity search in the memory vector store. It\n     * calculates the similarity between the query vector and each vector in\n     * the store, sorts the results by similarity, and returns the top `k`\n     * results along with their scores.\n     * @param query Query vector to compare against the vectors in the store.\n     * @param k Number of top results to return.\n     * @param filter Optional filter function to apply to the vectors before performing the search.\n     * @returns Promise that resolves with an array of tuples, each containing a `Document` and its similarity score.\n     */\n    similaritySearchVectorWithScore(query: number[], k: number, filter?: this[\"FilterType\"]): Promise<[Document, number][]>;\n    /**\n     * Static method to create a `FakeVectorStore` instance from an array of\n     * texts. It creates a `Document` for each text and metadata pair, and\n     * adds them to the store.\n     * @param texts Array of texts to be added to the store.\n     * @param metadatas Array or single object of metadata corresponding to the texts.\n     * @param embeddings `Embeddings` instance used to generate embeddings for the texts.\n     * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.\n     * @returns Promise that resolves with a new `FakeVectorStore` instance.\n     */\n    static fromTexts(texts: string[], metadatas: object[] | object, embeddings: EmbeddingsInterface, dbConfig?: FakeVectorStoreArgs): Promise<FakeVectorStore>;\n    /**\n     * Static method to create a `FakeVectorStore` instance from an array of\n     * `Document` instances. It adds the documents to the store.\n     * @param docs Array of `Document` instances to be added to the store.\n     * @param embeddings `Embeddings` instance used to generate embeddings for the documents.\n     * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.\n     * @returns Promise that resolves with a new `FakeVectorStore` instance.\n     */\n    static fromDocuments(docs: Document[], embeddings: EmbeddingsInterface, dbConfig?: FakeVectorStoreArgs): Promise<FakeVectorStore>;\n    /**\n     * Static method to create a `FakeVectorStore` instance from an existing\n     * index. It creates a new `FakeVectorStore` instance without adding any\n     * documents or vectors.\n     * @param embeddings `Embeddings` instance used to generate embeddings for the documents.\n     * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.\n     * @returns Promise that resolves with a new `FakeVectorStore` instance.\n     */\n    static fromExistingIndex(embeddings: EmbeddingsInterface, dbConfig?: FakeVectorStoreArgs): Promise<FakeVectorStore>;\n}\nexport {};\n"],"mappings":";;;;;;;;;AAGwD;AAiBxD;AAQA;UAnBUI,YAAAA,CAmB0B;EAAA,OACdJ,EAAAA,MAAAA;EAAQ,SACXI,EAAAA,MAAAA,EAAAA;EAAY;EACF,QAEDH,EApBdI,MAoBcJ,CAAAA,MAAAA,EAAAA,GAAAA,CAAAA;;;;;;;AA4B2ED,UAzCtFM,mBAAAA,CAyCsFN;EAAQ,UAAjBS,CAAAA,EAAAA,OAxCtEN,MAwCsEM;;;;;;;AAoBPH,cArDlEC,eAAAA,SAAwBL,WAAAA,CAqD0CI;EAAmB,UAAWC,EAAAA,CAAAA,GAAAA,EApD/FP,QAoD+FO,EAAAA,GAAAA,OAAAA;EAAe,aAAvBE,EAnD1FL,YAmD0FK,EAAAA;EAAO,UAS3ER,EAAAA,OA3DlBE,MA2DkBF;EAAmB,gBAAaK,CAAAA,CAAAA,EAAAA,MAAAA;EAAmB,WAAWC,CAAAA,UAAAA,EAzD3EN,mBAyD2EM,EAAAA;IAAAA,UAAAA;IAAAA,GAAAA;EAAAA,CAAAA,CAAAA,EAzD5BD,mBAyD4BC;EAAe;;AA9D9D;;;;;0BAa5BP,aAAaS;;;;;;;;;6CASMT,aAAaS;;;;;;;;;;;4FAWkCA,SAAST;;;;;;;;;;;8EAWvBC,gCAAgCK,sBAAsBG,QAAQF;;;;;;;;;6BAS/GP,wBAAwBC,gCAAgCK,sBAAsBG,QAAQF;;;;;;;;;uCAS5EN,gCAAgCK,sBAAsBG,QAAQF"}

package/dist/utils/testing/vectorstores.d.ts

@@ -0,0 +1,101 @@
+import { Document } from "../../documents/document.js";
+import { EmbeddingsInterface } from "../../embeddings.js";
+import { VectorStore } from "../../vectorstores.js";
+import { cosine } from "../ml-distance/similarities.js";
+
+//#region src/utils/testing/vectorstores.d.ts
+
+/**
+ * Interface representing a vector in memory. It includes the content
+ * (text), the corresponding embedding (vector), and any associated
+ * metadata.
+ */
+interface MemoryVector {
+  content: string;
+  embedding: number[];
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  metadata: Record<string, any>;
+}
+/**
+ * Interface for the arguments that can be passed to the
+ * `FakeVectorStore` constructor. It includes an optional `similarity`
+ * function.
+ */
+interface FakeVectorStoreArgs {
+  similarity?: typeof cosine;
+}
+/**
+ * Class that extends `VectorStore` to store vectors in memory. Provides
+ * methods for adding documents, performing similarity searches, and
+ * creating instances from texts, documents, or an existing index.
+ */
+declare class FakeVectorStore extends VectorStore {
+  FilterType: (doc: Document) => boolean;
+  memoryVectors: MemoryVector[];
+  similarity: typeof cosine;
+  _vectorstoreType(): string;
+  constructor(embeddings: EmbeddingsInterface, {
+    similarity,
+    ...rest
+  }?: FakeVectorStoreArgs);
+  /**
+   * Method to add documents to the memory vector store. It extracts the
+   * text from each document, generates embeddings for them, and adds the
+   * resulting vectors to the store.
+   * @param documents Array of `Document` instances to be added to the store.
+   * @returns Promise that resolves when all documents have been added.
+   */
+  addDocuments(documents: Document[]): Promise<void>;
+  /**
+   * Method to add vectors to the memory vector store. It creates
+   * `MemoryVector` instances for each vector and document pair and adds
+   * them to the store.
+   * @param vectors Array of vectors to be added to the store.
+   * @param documents Array of `Document` instances corresponding to the vectors.
+   * @returns Promise that resolves when all vectors have been added.
+   */
+  addVectors(vectors: number[][], documents: Document[]): Promise<void>;
+  /**
+   * Method to perform a similarity search in the memory vector store. It
+   * calculates the similarity between the query vector and each vector in
+   * the store, sorts the results by similarity, and returns the top `k`
+   * results along with their scores.
+   * @param query Query vector to compare against the vectors in the store.
+   * @param k Number of top results to return.
+   * @param filter Optional filter function to apply to the vectors before performing the search.
+   * @returns Promise that resolves with an array of tuples, each containing a `Document` and its similarity score.
+   */
+  similaritySearchVectorWithScore(query: number[], k: number, filter?: this["FilterType"]): Promise<[Document, number][]>;
+  /**
+   * Static method to create a `FakeVectorStore` instance from an array of
+   * texts. It creates a `Document` for each text and metadata pair, and
+   * adds them to the store.
+   * @param texts Array of texts to be added to the store.
+   * @param metadatas Array or single object of metadata corresponding to the texts.
+   * @param embeddings `Embeddings` instance used to generate embeddings for the texts.
+   * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.
+   * @returns Promise that resolves with a new `FakeVectorStore` instance.
+   */
+  static fromTexts(texts: string[], metadatas: object[] | object, embeddings: EmbeddingsInterface, dbConfig?: FakeVectorStoreArgs): Promise<FakeVectorStore>;
+  /**
+   * Static method to create a `FakeVectorStore` instance from an array of
+   * `Document` instances. It adds the documents to the store.
+   * @param docs Array of `Document` instances to be added to the store.
+   * @param embeddings `Embeddings` instance used to generate embeddings for the documents.
+   * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.
+   * @returns Promise that resolves with a new `FakeVectorStore` instance.
+   */
+  static fromDocuments(docs: Document[], embeddings: EmbeddingsInterface, dbConfig?: FakeVectorStoreArgs): Promise<FakeVectorStore>;
+  /**
+   * Static method to create a `FakeVectorStore` instance from an existing
+   * index. It creates a new `FakeVectorStore` instance without adding any
+   * documents or vectors.
+   * @param embeddings `Embeddings` instance used to generate embeddings for the documents.
+   * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.
+   * @returns Promise that resolves with a new `FakeVectorStore` instance.
+   */
+  static fromExistingIndex(embeddings: EmbeddingsInterface, dbConfig?: FakeVectorStoreArgs): Promise<FakeVectorStore>;
+}
+//#endregion
+export { FakeVectorStore, FakeVectorStoreArgs };
+//# sourceMappingURL=vectorstores.d.ts.map

package/dist/utils/testing/vectorstores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectorstores.d.ts","names":["Document","EmbeddingsInterface","VectorStore","cosine","MemoryVector","Record","FakeVectorStoreArgs","FakeVectorStore","similarity","Promise"],"sources":["../../../src/utils/testing/vectorstores.d.ts"],"sourcesContent":["import { Document } from \"../../documents/document.js\";\nimport { EmbeddingsInterface } from \"../../embeddings.js\";\nimport { VectorStore } from \"../../vectorstores.js\";\nimport { cosine } from \"../ml-distance/similarities.js\";\n/**\n * Interface representing a vector in memory. It includes the content\n * (text), the corresponding embedding (vector), and any associated\n * metadata.\n */\ninterface MemoryVector {\n    content: string;\n    embedding: number[];\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    metadata: Record<string, any>;\n}\n/**\n * Interface for the arguments that can be passed to the\n * `FakeVectorStore` constructor. It includes an optional `similarity`\n * function.\n */\nexport interface FakeVectorStoreArgs {\n    similarity?: typeof cosine;\n}\n/**\n * Class that extends `VectorStore` to store vectors in memory. Provides\n * methods for adding documents, performing similarity searches, and\n * creating instances from texts, documents, or an existing index.\n */\nexport declare class FakeVectorStore extends VectorStore {\n    FilterType: (doc: Document) => boolean;\n    memoryVectors: MemoryVector[];\n    similarity: typeof cosine;\n    _vectorstoreType(): string;\n    constructor(embeddings: EmbeddingsInterface, { similarity, ...rest }?: FakeVectorStoreArgs);\n    /**\n     * Method to add documents to the memory vector store. It extracts the\n     * text from each document, generates embeddings for them, and adds the\n     * resulting vectors to the store.\n     * @param documents Array of `Document` instances to be added to the store.\n     * @returns Promise that resolves when all documents have been added.\n     */\n    addDocuments(documents: Document[]): Promise<void>;\n    /**\n     * Method to add vectors to the memory vector store. It creates\n     * `MemoryVector` instances for each vector and document pair and adds\n     * them to the store.\n     * @param vectors Array of vectors to be added to the store.\n     * @param documents Array of `Document` instances corresponding to the vectors.\n     * @returns Promise that resolves when all vectors have been added.\n     */\n    addVectors(vectors: number[][], documents: Document[]): Promise<void>;\n    /**\n     * Method to perform a similarity search in the memory vector store. It\n     * calculates the similarity between the query vector and each vector in\n     * the store, sorts the results by similarity, and returns the top `k`\n     * results along with their scores.\n     * @param query Query vector to compare against the vectors in the store.\n     * @param k Number of top results to return.\n     * @param filter Optional filter function to apply to the vectors before performing the search.\n     * @returns Promise that resolves with an array of tuples, each containing a `Document` and its similarity score.\n     */\n    similaritySearchVectorWithScore(query: number[], k: number, filter?: this[\"FilterType\"]): Promise<[Document, number][]>;\n    /**\n     * Static method to create a `FakeVectorStore` instance from an array of\n     * texts. It creates a `Document` for each text and metadata pair, and\n     * adds them to the store.\n     * @param texts Array of texts to be added to the store.\n     * @param metadatas Array or single object of metadata corresponding to the texts.\n     * @param embeddings `Embeddings` instance used to generate embeddings for the texts.\n     * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.\n     * @returns Promise that resolves with a new `FakeVectorStore` instance.\n     */\n    static fromTexts(texts: string[], metadatas: object[] | object, embeddings: EmbeddingsInterface, dbConfig?: FakeVectorStoreArgs): Promise<FakeVectorStore>;\n    /**\n     * Static method to create a `FakeVectorStore` instance from an array of\n     * `Document` instances. It adds the documents to the store.\n     * @param docs Array of `Document` instances to be added to the store.\n     * @param embeddings `Embeddings` instance used to generate embeddings for the documents.\n     * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.\n     * @returns Promise that resolves with a new `FakeVectorStore` instance.\n     */\n    static fromDocuments(docs: Document[], embeddings: EmbeddingsInterface, dbConfig?: FakeVectorStoreArgs): Promise<FakeVectorStore>;\n    /**\n     * Static method to create a `FakeVectorStore` instance from an existing\n     * index. It creates a new `FakeVectorStore` instance without adding any\n     * documents or vectors.\n     * @param embeddings `Embeddings` instance used to generate embeddings for the documents.\n     * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.\n     * @returns Promise that resolves with a new `FakeVectorStore` instance.\n     */\n    static fromExistingIndex(embeddings: EmbeddingsInterface, dbConfig?: FakeVectorStoreArgs): Promise<FakeVectorStore>;\n}\nexport {};\n"],"mappings":";;;;;;;;;AAGwD;AAiBxD;AAQA;UAnBUI,YAAAA,CAmB0B;EAAA,OACdJ,EAAAA,MAAAA;EAAQ,SACXI,EAAAA,MAAAA,EAAAA;EAAY;EACF,QAEDH,EApBdI,MAoBcJ,CAAAA,MAAAA,EAAAA,GAAAA,CAAAA;;;;;;;AA4B2ED,UAzCtFM,mBAAAA,CAyCsFN;EAAQ,UAAjBS,CAAAA,EAAAA,OAxCtEN,MAwCsEM;;;;;;;AAoBPH,cArDlEC,eAAAA,SAAwBL,WAAAA,CAqD0CI;EAAmB,UAAWC,EAAAA,CAAAA,GAAAA,EApD/FP,QAoD+FO,EAAAA,GAAAA,OAAAA;EAAe,aAAvBE,EAnD1FL,YAmD0FK,EAAAA;EAAO,UAS3ER,EAAAA,OA3DlBE,MA2DkBF;EAAmB,gBAAaK,CAAAA,CAAAA,EAAAA,MAAAA;EAAmB,WAAWC,CAAAA,UAAAA,EAzD3EN,mBAyD2EM,EAAAA;IAAAA,UAAAA;IAAAA,GAAAA;EAAAA,CAAAA,CAAAA,EAzD5BD,mBAyD4BC;EAAe;;AA9D9D;;;;;0BAa5BP,aAAaS;;;;;;;;;6CASMT,aAAaS;;;;;;;;;;;4FAWkCA,SAAST;;;;;;;;;;;8EAWvBC,gCAAgCK,sBAAsBG,QAAQF;;;;;;;;;6BAS/GP,wBAAwBC,gCAAgCK,sBAAsBG,QAAQF;;;;;;;;;uCAS5EN,gCAAgCK,sBAAsBG,QAAQF"}

package/dist/utils/testing/vectorstores.js

@@ -0,0 +1,129 @@
+import { VectorStore } from "../../vectorstores.js";
+import { Document } from "../../documents/document.js";
+import { cosine } from "../ml-distance/similarities.js";
+
+//#region src/utils/testing/vectorstores.ts
+/**
+* Class that extends `VectorStore` to store vectors in memory. Provides
+* methods for adding documents, performing similarity searches, and
+* creating instances from texts, documents, or an existing index.
+*/
+var FakeVectorStore = class FakeVectorStore extends VectorStore {
+	memoryVectors = [];
+	similarity;
+	_vectorstoreType() {
+		return "memory";
+	}
+	constructor(embeddings, { similarity,...rest } = {}) {
+		super(embeddings, rest);
+		this.similarity = similarity ?? cosine;
+	}
+	/**
+	* Method to add documents to the memory vector store. It extracts the
+	* text from each document, generates embeddings for them, and adds the
+	* resulting vectors to the store.
+	* @param documents Array of `Document` instances to be added to the store.
+	* @returns Promise that resolves when all documents have been added.
+	*/
+	async addDocuments(documents) {
+		const texts = documents.map(({ pageContent }) => pageContent);
+		return this.addVectors(await this.embeddings.embedDocuments(texts), documents);
+	}
+	/**
+	* Method to add vectors to the memory vector store. It creates
+	* `MemoryVector` instances for each vector and document pair and adds
+	* them to the store.
+	* @param vectors Array of vectors to be added to the store.
+	* @param documents Array of `Document` instances corresponding to the vectors.
+	* @returns Promise that resolves when all vectors have been added.
+	*/
+	async addVectors(vectors, documents) {
+		const memoryVectors = vectors.map((embedding, idx) => ({
+			content: documents[idx].pageContent,
+			embedding,
+			metadata: documents[idx].metadata
+		}));
+		this.memoryVectors = this.memoryVectors.concat(memoryVectors);
+	}
+	/**
+	* Method to perform a similarity search in the memory vector store. It
+	* calculates the similarity between the query vector and each vector in
+	* the store, sorts the results by similarity, and returns the top `k`
+	* results along with their scores.
+	* @param query Query vector to compare against the vectors in the store.
+	* @param k Number of top results to return.
+	* @param filter Optional filter function to apply to the vectors before performing the search.
+	* @returns Promise that resolves with an array of tuples, each containing a `Document` and its similarity score.
+	*/
+	async similaritySearchVectorWithScore(query, k, filter) {
+		const filterFunction = (memoryVector) => {
+			if (!filter) return true;
+			const doc = new Document({
+				metadata: memoryVector.metadata,
+				pageContent: memoryVector.content
+			});
+			return filter(doc);
+		};
+		const filteredMemoryVectors = this.memoryVectors.filter(filterFunction);
+		const searches = filteredMemoryVectors.map((vector, index) => ({
+			similarity: this.similarity(query, vector.embedding),
+			index
+		})).sort((a, b) => a.similarity > b.similarity ? -1 : 0).slice(0, k);
+		const result = searches.map((search) => [new Document({
+			metadata: filteredMemoryVectors[search.index].metadata,
+			pageContent: filteredMemoryVectors[search.index].content
+		}), search.similarity]);
+		return result;
+	}
+	/**
+	* Static method to create a `FakeVectorStore` instance from an array of
+	* texts. It creates a `Document` for each text and metadata pair, and
+	* adds them to the store.
+	* @param texts Array of texts to be added to the store.
+	* @param metadatas Array or single object of metadata corresponding to the texts.
+	* @param embeddings `Embeddings` instance used to generate embeddings for the texts.
+	* @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.
+	* @returns Promise that resolves with a new `FakeVectorStore` instance.
+	*/
+	static async fromTexts(texts, metadatas, embeddings, dbConfig) {
+		const docs = [];
+		for (let i = 0; i < texts.length; i += 1) {
+			const metadata = Array.isArray(metadatas) ? metadatas[i] : metadatas;
+			const newDoc = new Document({
+				pageContent: texts[i],
+				metadata
+			});
+			docs.push(newDoc);
+		}
+		return FakeVectorStore.fromDocuments(docs, embeddings, dbConfig);
+	}
+	/**
+	* Static method to create a `FakeVectorStore` instance from an array of
+	* `Document` instances. It adds the documents to the store.
+	* @param docs Array of `Document` instances to be added to the store.
+	* @param embeddings `Embeddings` instance used to generate embeddings for the documents.
+	* @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.
+	* @returns Promise that resolves with a new `FakeVectorStore` instance.
+	*/
+	static async fromDocuments(docs, embeddings, dbConfig) {
+		const instance = new this(embeddings, dbConfig);
+		await instance.addDocuments(docs);
+		return instance;
+	}
+	/**
+	* Static method to create a `FakeVectorStore` instance from an existing
+	* index. It creates a new `FakeVectorStore` instance without adding any
+	* documents or vectors.
+	* @param embeddings `Embeddings` instance used to generate embeddings for the documents.
+	* @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.
+	* @returns Promise that resolves with a new `FakeVectorStore` instance.
+	*/
+	static async fromExistingIndex(embeddings, dbConfig) {
+		const instance = new this(embeddings, dbConfig);
+		return instance;
+	}
+};
+
+//#endregion
+export { FakeVectorStore };
+//# sourceMappingURL=vectorstores.js.map

package/dist/utils/testing/vectorstores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectorstores.js","names":["embeddings: EmbeddingsInterface","documents: Document[]","vectors: number[][]","query: number[]","k: number","filter?: this[\"FilterType\"]","memoryVector: MemoryVector","result: [Document, number][]","texts: string[]","metadatas: object[] | object","dbConfig?: FakeVectorStoreArgs","docs: Document[]"],"sources":["../../../src/utils/testing/vectorstores.ts"],"sourcesContent":["import { Document } from \"../../documents/document.js\";\nimport { EmbeddingsInterface } from \"../../embeddings.js\";\nimport { VectorStore } from \"../../vectorstores.js\";\nimport { cosine } from \"../ml-distance/similarities.js\";\n\n/**\n * Interface representing a vector in memory. It includes the content\n * (text), the corresponding embedding (vector), and any associated\n * metadata.\n */\ninterface MemoryVector {\n  content: string;\n  embedding: number[];\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  metadata: Record<string, any>;\n}\n\n/**\n * Interface for the arguments that can be passed to the\n * `FakeVectorStore` constructor. It includes an optional `similarity`\n * function.\n */\nexport interface FakeVectorStoreArgs {\n  similarity?: typeof cosine;\n}\n\n/**\n * Class that extends `VectorStore` to store vectors in memory. Provides\n * methods for adding documents, performing similarity searches, and\n * creating instances from texts, documents, or an existing index.\n */\nexport class FakeVectorStore extends VectorStore {\n  declare FilterType: (doc: Document) => boolean;\n\n  memoryVectors: MemoryVector[] = [];\n\n  similarity: typeof cosine;\n\n  _vectorstoreType(): string {\n    return \"memory\";\n  }\n\n  constructor(\n    embeddings: EmbeddingsInterface,\n    { similarity, ...rest }: FakeVectorStoreArgs = {}\n  ) {\n    super(embeddings, rest);\n\n    this.similarity = similarity ?? cosine;\n  }\n\n  /**\n   * Method to add documents to the memory vector store. It extracts the\n   * text from each document, generates embeddings for them, and adds the\n   * resulting vectors to the store.\n   * @param documents Array of `Document` instances to be added to the store.\n   * @returns Promise that resolves when all documents have been added.\n   */\n  async addDocuments(documents: Document[]): Promise<void> {\n    const texts = documents.map(({ pageContent }) => pageContent);\n    return this.addVectors(\n      await this.embeddings.embedDocuments(texts),\n      documents\n    );\n  }\n\n  /**\n   * Method to add vectors to the memory vector store. It creates\n   * `MemoryVector` instances for each vector and document pair and adds\n   * them to the store.\n   * @param vectors Array of vectors to be added to the store.\n   * @param documents Array of `Document` instances corresponding to the vectors.\n   * @returns Promise that resolves when all vectors have been added.\n   */\n  async addVectors(vectors: number[][], documents: Document[]): Promise<void> {\n    const memoryVectors = vectors.map((embedding, idx) => ({\n      content: documents[idx].pageContent,\n      embedding,\n      metadata: documents[idx].metadata,\n    }));\n\n    this.memoryVectors = this.memoryVectors.concat(memoryVectors);\n  }\n\n  /**\n   * Method to perform a similarity search in the memory vector store. It\n   * calculates the similarity between the query vector and each vector in\n   * the store, sorts the results by similarity, and returns the top `k`\n   * results along with their scores.\n   * @param query Query vector to compare against the vectors in the store.\n   * @param k Number of top results to return.\n   * @param filter Optional filter function to apply to the vectors before performing the search.\n   * @returns Promise that resolves with an array of tuples, each containing a `Document` and its similarity score.\n   */\n  async similaritySearchVectorWithScore(\n    query: number[],\n    k: number,\n    filter?: this[\"FilterType\"]\n  ): Promise<[Document, number][]> {\n    const filterFunction = (memoryVector: MemoryVector) => {\n      if (!filter) {\n        return true;\n      }\n\n      const doc = new Document({\n        metadata: memoryVector.metadata,\n        pageContent: memoryVector.content,\n      });\n      return filter(doc);\n    };\n    const filteredMemoryVectors = this.memoryVectors.filter(filterFunction);\n    const searches = filteredMemoryVectors\n      .map((vector, index) => ({\n        similarity: this.similarity(query, vector.embedding),\n        index,\n      }))\n      .sort((a, b) => (a.similarity > b.similarity ? -1 : 0))\n      .slice(0, k);\n\n    const result: [Document, number][] = searches.map((search) => [\n      new Document({\n        metadata: filteredMemoryVectors[search.index].metadata,\n        pageContent: filteredMemoryVectors[search.index].content,\n      }),\n      search.similarity,\n    ]);\n\n    return result;\n  }\n\n  /**\n   * Static method to create a `FakeVectorStore` instance from an array of\n   * texts. It creates a `Document` for each text and metadata pair, and\n   * adds them to the store.\n   * @param texts Array of texts to be added to the store.\n   * @param metadatas Array or single object of metadata corresponding to the texts.\n   * @param embeddings `Embeddings` instance used to generate embeddings for the texts.\n   * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.\n   * @returns Promise that resolves with a new `FakeVectorStore` instance.\n   */\n  static async fromTexts(\n    texts: string[],\n    metadatas: object[] | object,\n    embeddings: EmbeddingsInterface,\n    dbConfig?: FakeVectorStoreArgs\n  ): Promise<FakeVectorStore> {\n    const docs: Document[] = [];\n    for (let i = 0; i < texts.length; i += 1) {\n      const metadata = Array.isArray(metadatas) ? metadatas[i] : metadatas;\n      const newDoc = new Document({\n        pageContent: texts[i],\n        metadata,\n      });\n      docs.push(newDoc);\n    }\n    return FakeVectorStore.fromDocuments(docs, embeddings, dbConfig);\n  }\n\n  /**\n   * Static method to create a `FakeVectorStore` instance from an array of\n   * `Document` instances. It adds the documents to the store.\n   * @param docs Array of `Document` instances to be added to the store.\n   * @param embeddings `Embeddings` instance used to generate embeddings for the documents.\n   * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.\n   * @returns Promise that resolves with a new `FakeVectorStore` instance.\n   */\n  static async fromDocuments(\n    docs: Document[],\n    embeddings: EmbeddingsInterface,\n    dbConfig?: FakeVectorStoreArgs\n  ): Promise<FakeVectorStore> {\n    const instance = new this(embeddings, dbConfig);\n    await instance.addDocuments(docs);\n    return instance;\n  }\n\n  /**\n   * Static method to create a `FakeVectorStore` instance from an existing\n   * index. It creates a new `FakeVectorStore` instance without adding any\n   * documents or vectors.\n   * @param embeddings `Embeddings` instance used to generate embeddings for the documents.\n   * @param dbConfig Optional `FakeVectorStoreArgs` to configure the `FakeVectorStore` instance.\n   * @returns Promise that resolves with a new `FakeVectorStore` instance.\n   */\n  static async fromExistingIndex(\n    embeddings: EmbeddingsInterface,\n    dbConfig?: FakeVectorStoreArgs\n  ): Promise<FakeVectorStore> {\n    const instance = new this(embeddings, dbConfig);\n    return instance;\n  }\n}\n"],"mappings":";;;;;;;;;;AA+BA,IAAa,kBAAb,MAAa,wBAAwB,YAAY;CAG/C,gBAAgC,CAAE;CAElC;CAEA,mBAA2B;AACzB,SAAO;CACR;CAED,YACEA,YACA,EAAE,WAAY,GAAG,MAA2B,GAAG,CAAE,GACjD;EACA,MAAM,YAAY,KAAK;EAEvB,KAAK,aAAa,cAAc;CACjC;;;;;;;;CASD,MAAM,aAAaC,WAAsC;EACvD,MAAM,QAAQ,UAAU,IAAI,CAAC,EAAE,aAAa,KAAK,YAAY;AAC7D,SAAO,KAAK,WACV,MAAM,KAAK,WAAW,eAAe,MAAM,EAC3C,UACD;CACF;;;;;;;;;CAUD,MAAM,WAAWC,SAAqBD,WAAsC;EAC1E,MAAM,gBAAgB,QAAQ,IAAI,CAAC,WAAW,SAAS;GACrD,SAAS,UAAU,KAAK;GACxB;GACA,UAAU,UAAU,KAAK;EAC1B,GAAE;EAEH,KAAK,gBAAgB,KAAK,cAAc,OAAO,cAAc;CAC9D;;;;;;;;;;;CAYD,MAAM,gCACJE,OACAC,GACAC,QAC+B;EAC/B,MAAM,iBAAiB,CAACC,iBAA+B;AACrD,OAAI,CAAC,OACH,QAAO;GAGT,MAAM,MAAM,IAAI,SAAS;IACvB,UAAU,aAAa;IACvB,aAAa,aAAa;GAC3B;AACD,UAAO,OAAO,IAAI;EACnB;EACD,MAAM,wBAAwB,KAAK,cAAc,OAAO,eAAe;EACvE,MAAM,WAAW,sBACd,IAAI,CAAC,QAAQ,WAAW;GACvB,YAAY,KAAK,WAAW,OAAO,OAAO,UAAU;GACpD;EACD,GAAE,CACF,KAAK,CAAC,GAAG,MAAO,EAAE,aAAa,EAAE,aAAa,KAAK,EAAG,CACtD,MAAM,GAAG,EAAE;EAEd,MAAMC,SAA+B,SAAS,IAAI,CAAC,WAAW,CAC5D,IAAI,SAAS;GACX,UAAU,sBAAsB,OAAO,OAAO;GAC9C,aAAa,sBAAsB,OAAO,OAAO;EAClD,IACD,OAAO,UACR,EAAC;AAEF,SAAO;CACR;;;;;;;;;;;CAYD,aAAa,UACXC,OACAC,WACAT,YACAU,UAC0B;EAC1B,MAAMC,OAAmB,CAAE;AAC3B,OAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,GAAG;GACxC,MAAM,WAAW,MAAM,QAAQ,UAAU,GAAG,UAAU,KAAK;GAC3D,MAAM,SAAS,IAAI,SAAS;IAC1B,aAAa,MAAM;IACnB;GACD;GACD,KAAK,KAAK,OAAO;EAClB;AACD,SAAO,gBAAgB,cAAc,MAAM,YAAY,SAAS;CACjE;;;;;;;;;CAUD,aAAa,cACXA,MACAX,YACAU,UAC0B;EAC1B,MAAM,WAAW,IAAI,KAAK,YAAY;EACtC,MAAM,SAAS,aAAa,KAAK;AACjC,SAAO;CACR;;;;;;;;;CAUD,aAAa,kBACXV,YACAU,UAC0B;EAC1B,MAAM,WAAW,IAAI,KAAK,YAAY;AACtC,SAAO;CACR;AACF"}

package/dist/utils/zod-to-json-schema/Options.cjs

@@ -0,0 +1,40 @@
+
+//#region src/utils/zod-to-json-schema/Options.ts
+const ignoreOverride = Symbol("Let zodToJsonSchema decide on which parser to use");
+const defaultOptions = {
+	name: void 0,
+	$refStrategy: "root",
+	basePath: ["#"],
+	effectStrategy: "input",
+	pipeStrategy: "all",
+	dateStrategy: "format:date-time",
+	mapStrategy: "entries",
+	removeAdditionalStrategy: "passthrough",
+	allowedAdditionalProperties: true,
+	rejectedAdditionalProperties: false,
+	definitionPath: "definitions",
+	target: "jsonSchema7",
+	strictUnions: false,
+	definitions: {},
+	errorMessages: false,
+	markdownDescription: false,
+	patternStrategy: "escape",
+	applyRegexFlags: false,
+	emailStrategy: "format:email",
+	base64Strategy: "contentEncoding:base64",
+	nameStrategy: "ref",
+	openAiAnyTypeName: "OpenAiAnyType"
+};
+const getDefaultOptions = (options) => typeof options === "string" ? {
+	...defaultOptions,
+	name: options
+} : {
+	...defaultOptions,
+	...options
+};
+
+//#endregion
+exports.defaultOptions = defaultOptions;
+exports.getDefaultOptions = getDefaultOptions;
+exports.ignoreOverride = ignoreOverride;
+//# sourceMappingURL=Options.cjs.map

package/dist/utils/zod-to-json-schema/Options.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Options.cjs","names":["defaultOptions: Options","options: Partial<Options<Target>> | string | undefined"],"sources":["../../../src/utils/zod-to-json-schema/Options.ts"],"sourcesContent":["import { ZodSchema, ZodTypeDef } from \"zod/v3\";\nimport { Refs, Seen } from \"./Refs\";\nimport { JsonSchema7Type } from \"./parseTypes\";\n\nexport type Targets =\n  | \"jsonSchema7\"\n  | \"jsonSchema2019-09\"\n  | \"openApi3\"\n  | \"openAi\";\n\nexport type DateStrategy =\n  | \"format:date-time\"\n  | \"format:date\"\n  | \"string\"\n  | \"integer\";\n\nexport const ignoreOverride = Symbol(\n  \"Let zodToJsonSchema decide on which parser to use\"\n);\n\nexport type OverrideCallback = (\n  def: ZodTypeDef,\n  refs: Refs,\n  seen: Seen | undefined,\n  forceResolution?: boolean\n) => JsonSchema7Type | undefined | typeof ignoreOverride;\n\nexport type PostProcessCallback = (\n  jsonSchema: JsonSchema7Type | undefined,\n  def: ZodTypeDef,\n  refs: Refs\n) => JsonSchema7Type | undefined;\n\nexport const jsonDescription: PostProcessCallback = (jsonSchema, def) => {\n  if (def.description) {\n    try {\n      return {\n        ...jsonSchema,\n        ...JSON.parse(def.description),\n      };\n    } catch {}\n  }\n\n  return jsonSchema;\n};\n\nexport type Options<Target extends Targets = \"jsonSchema7\"> = {\n  name: string | undefined;\n  $refStrategy: \"root\" | \"relative\" | \"none\" | \"seen\";\n  basePath: string[];\n  effectStrategy: \"input\" | \"any\";\n  pipeStrategy: \"input\" | \"output\" | \"all\";\n  dateStrategy: DateStrategy | DateStrategy[];\n  mapStrategy: \"entries\" | \"record\";\n  removeAdditionalStrategy: \"passthrough\" | \"strict\";\n  allowedAdditionalProperties: true | undefined;\n  rejectedAdditionalProperties: false | undefined;\n  target: Target;\n  strictUnions: boolean;\n  definitionPath: string;\n  definitions: Record<string, ZodSchema>;\n  errorMessages: boolean;\n  markdownDescription: boolean;\n  patternStrategy: \"escape\" | \"preserve\";\n  applyRegexFlags: boolean;\n  emailStrategy: \"format:email\" | \"format:idn-email\" | \"pattern:zod\";\n  base64Strategy: \"format:binary\" | \"contentEncoding:base64\" | \"pattern:zod\";\n  nameStrategy: \"ref\" | \"title\";\n  override?: OverrideCallback;\n  postProcess?: PostProcessCallback;\n  openAiAnyTypeName: string;\n};\n\nexport const defaultOptions: Options = {\n  name: undefined,\n  $refStrategy: \"root\",\n  basePath: [\"#\"],\n  effectStrategy: \"input\",\n  pipeStrategy: \"all\",\n  dateStrategy: \"format:date-time\",\n  mapStrategy: \"entries\",\n  removeAdditionalStrategy: \"passthrough\",\n  allowedAdditionalProperties: true,\n  rejectedAdditionalProperties: false,\n  definitionPath: \"definitions\",\n  target: \"jsonSchema7\",\n  strictUnions: false,\n  definitions: {},\n  errorMessages: false,\n  markdownDescription: false,\n  patternStrategy: \"escape\",\n  applyRegexFlags: false,\n  emailStrategy: \"format:email\",\n  base64Strategy: \"contentEncoding:base64\",\n  nameStrategy: \"ref\",\n  openAiAnyTypeName: \"OpenAiAnyType\",\n};\n\nexport const getDefaultOptions = <Target extends Targets>(\n  options: Partial<Options<Target>> | string | undefined\n) =>\n  (typeof options === \"string\"\n    ? {\n        ...defaultOptions,\n        name: options,\n      }\n    : {\n        ...defaultOptions,\n        ...options,\n      }) as Options<Target>;\n"],"mappings":";;AAgBA,MAAa,iBAAiB,OAC5B,oDACD;AAuDD,MAAaA,iBAA0B;CACrC,MAAM;CACN,cAAc;CACd,UAAU,CAAC,GAAI;CACf,gBAAgB;CAChB,cAAc;CACd,cAAc;CACd,aAAa;CACb,0BAA0B;CAC1B,6BAA6B;CAC7B,8BAA8B;CAC9B,gBAAgB;CAChB,QAAQ;CACR,cAAc;CACd,aAAa,CAAE;CACf,eAAe;CACf,qBAAqB;CACrB,iBAAiB;CACjB,iBAAiB;CACjB,eAAe;CACf,gBAAgB;CAChB,cAAc;CACd,mBAAmB;AACpB;AAED,MAAa,oBAAoB,CAC/BC,YAEC,OAAO,YAAY,WAChB;CACE,GAAG;CACH,MAAM;AACP,IACD;CACE,GAAG;CACH,GAAG;AACJ"}

package/dist/utils/zod-to-json-schema/Options.js

@@ -0,0 +1,37 @@
+//#region src/utils/zod-to-json-schema/Options.ts
+const ignoreOverride = Symbol("Let zodToJsonSchema decide on which parser to use");
+const defaultOptions = {
+	name: void 0,
+	$refStrategy: "root",
+	basePath: ["#"],
+	effectStrategy: "input",
+	pipeStrategy: "all",
+	dateStrategy: "format:date-time",
+	mapStrategy: "entries",
+	removeAdditionalStrategy: "passthrough",
+	allowedAdditionalProperties: true,
+	rejectedAdditionalProperties: false,
+	definitionPath: "definitions",
+	target: "jsonSchema7",
+	strictUnions: false,
+	definitions: {},
+	errorMessages: false,
+	markdownDescription: false,
+	patternStrategy: "escape",
+	applyRegexFlags: false,
+	emailStrategy: "format:email",
+	base64Strategy: "contentEncoding:base64",
+	nameStrategy: "ref",
+	openAiAnyTypeName: "OpenAiAnyType"
+};
+const getDefaultOptions = (options) => typeof options === "string" ? {
+	...defaultOptions,
+	name: options
+} : {
+	...defaultOptions,
+	...options
+};
+
+//#endregion
+export { defaultOptions, getDefaultOptions, ignoreOverride };
+//# sourceMappingURL=Options.js.map

package/dist/utils/zod-to-json-schema/Options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Options.js","names":["defaultOptions: Options","options: Partial<Options<Target>> | string | undefined"],"sources":["../../../src/utils/zod-to-json-schema/Options.ts"],"sourcesContent":["import { ZodSchema, ZodTypeDef } from \"zod/v3\";\nimport { Refs, Seen } from \"./Refs\";\nimport { JsonSchema7Type } from \"./parseTypes\";\n\nexport type Targets =\n  | \"jsonSchema7\"\n  | \"jsonSchema2019-09\"\n  | \"openApi3\"\n  | \"openAi\";\n\nexport type DateStrategy =\n  | \"format:date-time\"\n  | \"format:date\"\n  | \"string\"\n  | \"integer\";\n\nexport const ignoreOverride = Symbol(\n  \"Let zodToJsonSchema decide on which parser to use\"\n);\n\nexport type OverrideCallback = (\n  def: ZodTypeDef,\n  refs: Refs,\n  seen: Seen | undefined,\n  forceResolution?: boolean\n) => JsonSchema7Type | undefined | typeof ignoreOverride;\n\nexport type PostProcessCallback = (\n  jsonSchema: JsonSchema7Type | undefined,\n  def: ZodTypeDef,\n  refs: Refs\n) => JsonSchema7Type | undefined;\n\nexport const jsonDescription: PostProcessCallback = (jsonSchema, def) => {\n  if (def.description) {\n    try {\n      return {\n        ...jsonSchema,\n        ...JSON.parse(def.description),\n      };\n    } catch {}\n  }\n\n  return jsonSchema;\n};\n\nexport type Options<Target extends Targets = \"jsonSchema7\"> = {\n  name: string | undefined;\n  $refStrategy: \"root\" | \"relative\" | \"none\" | \"seen\";\n  basePath: string[];\n  effectStrategy: \"input\" | \"any\";\n  pipeStrategy: \"input\" | \"output\" | \"all\";\n  dateStrategy: DateStrategy | DateStrategy[];\n  mapStrategy: \"entries\" | \"record\";\n  removeAdditionalStrategy: \"passthrough\" | \"strict\";\n  allowedAdditionalProperties: true | undefined;\n  rejectedAdditionalProperties: false | undefined;\n  target: Target;\n  strictUnions: boolean;\n  definitionPath: string;\n  definitions: Record<string, ZodSchema>;\n  errorMessages: boolean;\n  markdownDescription: boolean;\n  patternStrategy: \"escape\" | \"preserve\";\n  applyRegexFlags: boolean;\n  emailStrategy: \"format:email\" | \"format:idn-email\" | \"pattern:zod\";\n  base64Strategy: \"format:binary\" | \"contentEncoding:base64\" | \"pattern:zod\";\n  nameStrategy: \"ref\" | \"title\";\n  override?: OverrideCallback;\n  postProcess?: PostProcessCallback;\n  openAiAnyTypeName: string;\n};\n\nexport const defaultOptions: Options = {\n  name: undefined,\n  $refStrategy: \"root\",\n  basePath: [\"#\"],\n  effectStrategy: \"input\",\n  pipeStrategy: \"all\",\n  dateStrategy: \"format:date-time\",\n  mapStrategy: \"entries\",\n  removeAdditionalStrategy: \"passthrough\",\n  allowedAdditionalProperties: true,\n  rejectedAdditionalProperties: false,\n  definitionPath: \"definitions\",\n  target: \"jsonSchema7\",\n  strictUnions: false,\n  definitions: {},\n  errorMessages: false,\n  markdownDescription: false,\n  patternStrategy: \"escape\",\n  applyRegexFlags: false,\n  emailStrategy: \"format:email\",\n  base64Strategy: \"contentEncoding:base64\",\n  nameStrategy: \"ref\",\n  openAiAnyTypeName: \"OpenAiAnyType\",\n};\n\nexport const getDefaultOptions = <Target extends Targets>(\n  options: Partial<Options<Target>> | string | undefined\n) =>\n  (typeof options === \"string\"\n    ? {\n        ...defaultOptions,\n        name: options,\n      }\n    : {\n        ...defaultOptions,\n        ...options,\n      }) as Options<Target>;\n"],"mappings":";AAgBA,MAAa,iBAAiB,OAC5B,oDACD;AAuDD,MAAaA,iBAA0B;CACrC,MAAM;CACN,cAAc;CACd,UAAU,CAAC,GAAI;CACf,gBAAgB;CAChB,cAAc;CACd,cAAc;CACd,aAAa;CACb,0BAA0B;CAC1B,6BAA6B;CAC7B,8BAA8B;CAC9B,gBAAgB;CAChB,QAAQ;CACR,cAAc;CACd,aAAa,CAAE;CACf,eAAe;CACf,qBAAqB;CACrB,iBAAiB;CACjB,iBAAiB;CACjB,eAAe;CACf,gBAAgB;CAChB,cAAc;CACd,mBAAmB;AACpB;AAED,MAAa,oBAAoB,CAC/BC,YAEC,OAAO,YAAY,WAChB;CACE,GAAG;CACH,MAAM;AACP,IACD;CACE,GAAG;CACH,GAAG;AACJ"}

package/dist/utils/zod-to-json-schema/Refs.cjs

@@ -0,0 +1,30 @@
+const require_Options = require('./Options.cjs');
+
+//#region src/utils/zod-to-json-schema/Refs.ts
+const getRefs = (options) => {
+	const _options = require_Options.getDefaultOptions(options);
+	const currentPath = _options.name !== void 0 ? [
+		..._options.basePath,
+		_options.definitionPath,
+		_options.name
+	] : _options.basePath;
+	return {
+		..._options,
+		flags: { hasReferencedOpenAiAnyType: false },
+		currentPath,
+		propertyPath: void 0,
+		seen: new Map(Object.entries(_options.definitions).map(([name, def]) => [def._def, {
+			def: def._def,
+			path: [
+				..._options.basePath,
+				_options.definitionPath,
+				name
+			],
+			jsonSchema: void 0
+		}]))
+	};
+};
+
+//#endregion
+exports.getRefs = getRefs;
+//# sourceMappingURL=Refs.cjs.map

package/dist/utils/zod-to-json-schema/Refs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Refs.cjs","names":["options?: string | Partial<Options<Targets>>","getDefaultOptions"],"sources":["../../../src/utils/zod-to-json-schema/Refs.ts"],"sourcesContent":["import { ZodTypeDef } from \"zod/v3\";\nimport { getDefaultOptions, Options, Targets } from \"./Options.js\";\nimport { JsonSchema7Type } from \"./parseTypes.js\";\n\nexport type Refs = {\n  seen: Map<ZodTypeDef, Seen>;\n  currentPath: string[];\n  propertyPath: string[] | undefined;\n  flags: { hasReferencedOpenAiAnyType: boolean };\n} & Options<Targets>;\n\nexport type Seen = {\n  def: ZodTypeDef;\n  path: string[];\n  jsonSchema: JsonSchema7Type | undefined;\n};\n\nexport const getRefs = (options?: string | Partial<Options<Targets>>): Refs => {\n  const _options = getDefaultOptions(options);\n  const currentPath =\n    _options.name !== undefined\n      ? [..._options.basePath, _options.definitionPath, _options.name]\n      : _options.basePath;\n  return {\n    ..._options,\n    flags: { hasReferencedOpenAiAnyType: false },\n    currentPath: currentPath,\n    propertyPath: undefined,\n    seen: new Map(\n      Object.entries(_options.definitions).map(([name, def]) => [\n        def._def,\n        {\n          def: def._def,\n          path: [..._options.basePath, _options.definitionPath, name],\n          // Resolution of references will be forced even though seen, so it's ok that the schema is undefined here for now.\n          jsonSchema: undefined,\n        },\n      ])\n    ),\n  };\n};\n"],"mappings":";;;AAiBA,MAAa,UAAU,CAACA,YAAuD;CAC7E,MAAM,WAAWC,kCAAkB,QAAQ;CAC3C,MAAM,cACJ,SAAS,SAAS,SACd;EAAC,GAAG,SAAS;EAAU,SAAS;EAAgB,SAAS;CAAK,IAC9D,SAAS;AACf,QAAO;EACL,GAAG;EACH,OAAO,EAAE,4BAA4B,MAAO;EAC/B;EACb,cAAc;EACd,MAAM,IAAI,IACR,OAAO,QAAQ,SAAS,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CACxD,IAAI,MACJ;GACE,KAAK,IAAI;GACT,MAAM;IAAC,GAAG,SAAS;IAAU,SAAS;IAAgB;GAAK;GAE3D,YAAY;EACb,CACF,EAAC;CAEL;AACF"}

package/dist/utils/zod-to-json-schema/Refs.js

@@ -0,0 +1,30 @@
+import { getDefaultOptions } from "./Options.js";
+
+//#region src/utils/zod-to-json-schema/Refs.ts
+const getRefs = (options) => {
+	const _options = getDefaultOptions(options);
+	const currentPath = _options.name !== void 0 ? [
+		..._options.basePath,
+		_options.definitionPath,
+		_options.name
+	] : _options.basePath;
+	return {
+		..._options,
+		flags: { hasReferencedOpenAiAnyType: false },
+		currentPath,
+		propertyPath: void 0,
+		seen: new Map(Object.entries(_options.definitions).map(([name, def]) => [def._def, {
+			def: def._def,
+			path: [
+				..._options.basePath,
+				_options.definitionPath,
+				name
+			],
+			jsonSchema: void 0
+		}]))
+	};
+};
+
+//#endregion
+export { getRefs };
+//# sourceMappingURL=Refs.js.map

package/dist/utils/zod-to-json-schema/Refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Refs.js","names":["options?: string | Partial<Options<Targets>>"],"sources":["../../../src/utils/zod-to-json-schema/Refs.ts"],"sourcesContent":["import { ZodTypeDef } from \"zod/v3\";\nimport { getDefaultOptions, Options, Targets } from \"./Options.js\";\nimport { JsonSchema7Type } from \"./parseTypes.js\";\n\nexport type Refs = {\n  seen: Map<ZodTypeDef, Seen>;\n  currentPath: string[];\n  propertyPath: string[] | undefined;\n  flags: { hasReferencedOpenAiAnyType: boolean };\n} & Options<Targets>;\n\nexport type Seen = {\n  def: ZodTypeDef;\n  path: string[];\n  jsonSchema: JsonSchema7Type | undefined;\n};\n\nexport const getRefs = (options?: string | Partial<Options<Targets>>): Refs => {\n  const _options = getDefaultOptions(options);\n  const currentPath =\n    _options.name !== undefined\n      ? [..._options.basePath, _options.definitionPath, _options.name]\n      : _options.basePath;\n  return {\n    ..._options,\n    flags: { hasReferencedOpenAiAnyType: false },\n    currentPath: currentPath,\n    propertyPath: undefined,\n    seen: new Map(\n      Object.entries(_options.definitions).map(([name, def]) => [\n        def._def,\n        {\n          def: def._def,\n          path: [..._options.basePath, _options.definitionPath, name],\n          // Resolution of references will be forced even though seen, so it's ok that the schema is undefined here for now.\n          jsonSchema: undefined,\n        },\n      ])\n    ),\n  };\n};\n"],"mappings":";;;AAiBA,MAAa,UAAU,CAACA,YAAuD;CAC7E,MAAM,WAAW,kBAAkB,QAAQ;CAC3C,MAAM,cACJ,SAAS,SAAS,SACd;EAAC,GAAG,SAAS;EAAU,SAAS;EAAgB,SAAS;CAAK,IAC9D,SAAS;AACf,QAAO;EACL,GAAG;EACH,OAAO,EAAE,4BAA4B,MAAO;EAC/B;EACb,cAAc;EACd,MAAM,IAAI,IACR,OAAO,QAAQ,SAAS,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CACxD,IAAI,MACJ;GACE,KAAK,IAAI;GACT,MAAM;IAAC,GAAG,SAAS;IAAU,SAAS;IAAgB;GAAK;GAE3D,YAAY;EACb,CACF,EAAC;CAEL;AACF"}

package/dist/utils/zod-to-json-schema/errorMessages.cjs

@@ -0,0 +1,18 @@
+
+//#region src/utils/zod-to-json-schema/errorMessages.ts
+function addErrorMessage(res, key, errorMessage, refs) {
+	if (!refs?.errorMessages) return;
+	if (errorMessage) res.errorMessage = {
+		...res.errorMessage,
+		[key]: errorMessage
+	};
+}
+function setResponseValueAndErrors(res, key, value, errorMessage, refs) {
+	res[key] = value;
+	addErrorMessage(res, key, errorMessage, refs);
+}
+
+//#endregion
+exports.addErrorMessage = addErrorMessage;
+exports.setResponseValueAndErrors = setResponseValueAndErrors;
+//# sourceMappingURL=errorMessages.cjs.map

package/dist/utils/zod-to-json-schema/errorMessages.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMessages.cjs","names":["res: T","key: keyof T","errorMessage: string | undefined","refs: Refs","res: Json7Type","key: Key","value: Json7Type[Key]"],"sources":["../../../src/utils/zod-to-json-schema/errorMessages.ts"],"sourcesContent":["import { JsonSchema7TypeUnion } from \"./parseTypes.js\";\nimport { Refs } from \"./Refs.js\";\n\nexport type ErrorMessages<\n  T extends JsonSchema7TypeUnion | { format: string } | { pattern: string },\n  OmitProperties extends string = \"\",\n> = Partial<\n  Omit<{ [key in keyof T]: string }, OmitProperties | \"type\" | \"errorMessages\">\n>;\n\nexport function addErrorMessage<\n  T extends { errorMessage?: ErrorMessages<any> },\n>(res: T, key: keyof T, errorMessage: string | undefined, refs: Refs) {\n  if (!refs?.errorMessages) return;\n  if (errorMessage) {\n    res.errorMessage = {\n      ...res.errorMessage,\n      [key]: errorMessage,\n    };\n  }\n}\n\nexport function setResponseValueAndErrors<\n  Json7Type extends JsonSchema7TypeUnion & {\n    errorMessage?: ErrorMessages<Json7Type>;\n  },\n  Key extends keyof Omit<Json7Type, \"errorMessage\">,\n>(\n  res: Json7Type,\n  key: Key,\n  value: Json7Type[Key],\n  errorMessage: string | undefined,\n  refs: Refs,\n) {\n  res[key] = value;\n  addErrorMessage(res, key, errorMessage, refs);\n}\n"],"mappings":";;AAUA,SAAgB,gBAEdA,KAAQC,KAAcC,cAAkCC,MAAY;AACpE,KAAI,CAAC,MAAM,cAAe;AAC1B,KAAI,cACF,IAAI,eAAe;EACjB,GAAG,IAAI;GACN,MAAM;CACR;AAEJ;AAED,SAAgB,0BAMdC,KACAC,KACAC,OACAJ,cACAC,MACA;CACA,IAAI,OAAO;CACX,gBAAgB,KAAK,KAAK,cAAc,KAAK;AAC9C"}

package/dist/utils/zod-to-json-schema/errorMessages.d.cts

@@ -0,0 +1,11 @@
+import { JsonSchema7TypeUnion } from "./parseTypes.cjs";
+
+//#region src/utils/zod-to-json-schema/errorMessages.d.ts
+type ErrorMessages<T extends JsonSchema7TypeUnion | {
+  format: string;
+} | {
+  pattern: string;
+}, OmitProperties extends string = ""> = Partial<Omit<{ [key in keyof T]: string }, OmitProperties | "type" | "errorMessages">>;
+//#endregion
+export { ErrorMessages };
+//# sourceMappingURL=errorMessages.d.cts.map

package/dist/utils/zod-to-json-schema/errorMessages.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMessages.d.cts","names":["JsonSchema7TypeUnion","Refs","ErrorMessages","T","OmitProperties","Omit","Partial","addErrorMessage","setResponseValueAndErrors","Json7Type","Key"],"sources":["../../../src/utils/zod-to-json-schema/errorMessages.d.ts"],"sourcesContent":["import { JsonSchema7TypeUnion } from \"./parseTypes.js\";\nimport { Refs } from \"./Refs.js\";\nexport type ErrorMessages<T extends JsonSchema7TypeUnion | {\n    format: string;\n} | {\n    pattern: string;\n}, OmitProperties extends string = \"\"> = Partial<Omit<{\n    [key in keyof T]: string;\n}, OmitProperties | \"type\" | \"errorMessages\">>;\nexport declare function addErrorMessage<T extends {\n    errorMessage?: ErrorMessages<any>;\n}>(res: T, key: keyof T, errorMessage: string | undefined, refs: Refs): void;\nexport declare function setResponseValueAndErrors<Json7Type extends JsonSchema7TypeUnion & {\n    errorMessage?: ErrorMessages<Json7Type>;\n}, Key extends keyof Omit<Json7Type, \"errorMessage\">>(res: Json7Type, key: Key, value: Json7Type[Key], errorMessage: string | undefined, refs: Refs): void;\n"],"mappings":";;;KAEYE,wBAAwBF;EAAxBE,MAAAA,EAAAA,MAAAA;CAAa,GAAA;EAAA,OAAWF,EAAAA,MAAAA;CAAoB,EAAA,uBAKtCG,MAAAA,GAAAA,EAAAA,CAAAA,GADuBG,OACvBH,CAD+BE,IAC/BF,CAAAA,UACfC,MADeD,CACfC,GAAAA,MAAAA,EAAc,EAAdA,cAF8CC,GAAAA,MAAAA,GAAAA,eAAAA,CAAAA,CAAAA"}

package/dist/utils/zod-to-json-schema/errorMessages.d.ts

@@ -0,0 +1,11 @@
+import { JsonSchema7TypeUnion } from "./parseTypes.js";
+
+//#region src/utils/zod-to-json-schema/errorMessages.d.ts
+type ErrorMessages<T extends JsonSchema7TypeUnion | {
+  format: string;
+} | {
+  pattern: string;
+}, OmitProperties extends string = ""> = Partial<Omit<{ [key in keyof T]: string }, OmitProperties | "type" | "errorMessages">>;
+//#endregion
+export { ErrorMessages };
+//# sourceMappingURL=errorMessages.d.ts.map

package/dist/utils/zod-to-json-schema/errorMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMessages.d.ts","names":["JsonSchema7TypeUnion","Refs","ErrorMessages","T","OmitProperties","Omit","Partial","addErrorMessage","setResponseValueAndErrors","Json7Type","Key"],"sources":["../../../src/utils/zod-to-json-schema/errorMessages.d.ts"],"sourcesContent":["import { JsonSchema7TypeUnion } from \"./parseTypes.js\";\nimport { Refs } from \"./Refs.js\";\nexport type ErrorMessages<T extends JsonSchema7TypeUnion | {\n    format: string;\n} | {\n    pattern: string;\n}, OmitProperties extends string = \"\"> = Partial<Omit<{\n    [key in keyof T]: string;\n}, OmitProperties | \"type\" | \"errorMessages\">>;\nexport declare function addErrorMessage<T extends {\n    errorMessage?: ErrorMessages<any>;\n}>(res: T, key: keyof T, errorMessage: string | undefined, refs: Refs): void;\nexport declare function setResponseValueAndErrors<Json7Type extends JsonSchema7TypeUnion & {\n    errorMessage?: ErrorMessages<Json7Type>;\n}, Key extends keyof Omit<Json7Type, \"errorMessage\">>(res: Json7Type, key: Key, value: Json7Type[Key], errorMessage: string | undefined, refs: Refs): void;\n"],"mappings":";;;KAEYE,wBAAwBF;EAAxBE,MAAAA,EAAAA,MAAAA;CAAa,GAAA;EAAA,OAAWF,EAAAA,MAAAA;CAAoB,EAAA,uBAKtCG,MAAAA,GAAAA,EAAAA,CAAAA,GADuBG,OACvBH,CAD+BE,IAC/BF,CAAAA,UACfC,MADeD,CACfC,GAAAA,MAAAA,EAAc,EAAdA,cAF8CC,GAAAA,MAAAA,GAAAA,eAAAA,CAAAA,CAAAA"}