From dd58b7c2412834d9cdf423077fae2323d43245ba Mon Sep 17 00:00:00 2001
From: ogzhanolguncu <ogzhan11@gmail.com>
Date: Tue, 7 May 2024 14:43:45 +0300
Subject: [PATCH] feat: move core functions to base class

---
 bun.lockb                        | Bin 218283 -> 218660 bytes
 package.json                     |   5 +-
 src/client-factory.ts            |  18 +--
 src/clients/vector/index.test.ts |   6 +-
 src/clients/vector/index.ts      |   2 +
 src/rag-chat-base.ts             |  96 +++++++++++++
 src/rag-chat.test.ts             | 233 +++++++++++++++++++++++++++++++
 src/rag-chat.ts                  | 106 +++-----------
 src/services/retrieval.ts        |   8 ++
 9 files changed, 369 insertions(+), 105 deletions(-)
 create mode 100644 src/rag-chat-base.ts
 create mode 100644 src/rag-chat.test.ts

diff --git a/bun.lockb b/bun.lockb
index 2b5b12c9cc04ef68776c09a26802522d1ffec1a7..5fa88c752ea35199bc10cbaaf99d537add2e42d8 100755
GIT binary patch
delta 38171
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

delta 38466
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
Qd)_iD?k%;$EdAX70y`Cf*8l(j

diff --git a/package.json b/package.json
index 8ee798d..6795117 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@upstash/rag-chat",
-  "version": "0.0.20-alpha",
+  "version": "0.0.21-alpha",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -52,6 +52,7 @@
     "@langchain/core": "^0.1.58",
     "@langchain/openai": "^0.0.28",
     "@upstash/sdk": "0.0.30-alpha",
-    "ai": "^3.0.35"
+    "ai": "^3.1.1",
+    "nanoid": "^5.0.7"
   }
 }
diff --git a/src/client-factory.ts b/src/client-factory.ts
index 33cbcb8..499ee95 100644
--- a/src/client-factory.ts
+++ b/src/client-factory.ts
@@ -1,10 +1,10 @@
+/* eslint-disable unicorn/no-useless-undefined */
 import type { Index, Redis } from "@upstash/sdk";
 import type { Config } from "./config";
 
 import { Upstash } from "@upstash/sdk";
 import { RedisClient } from "./clients/redis";
 import { VectorClient } from "./clients/vector";
-import { InternalUpstashError } from "./error/internal";
 
 export type ClientFactoryConfig = Pick<Config, "email" | "token" | "vector" | "redis" | "region">;
 export class ClientFactory {
@@ -44,23 +44,19 @@ export class ClientFactory {
     redis: TInit["redis"] extends true ? Redis : undefined;
     vector: TInit["vector"] extends true ? Index : undefined;
   }> {
-    let redis: Redis | undefined;
-    let vector: Index | undefined;
+    let redisPromise: Promise<Redis | undefined> = Promise.resolve(undefined);
+    let vectorPromise: Promise<Index | undefined> = Promise.resolve(undefined);
 
     if (options.redis) {
-      redis = await this.createRedisClient();
-      if (!redis) {
-        throw new InternalUpstashError("Couldn't initialize Redis client");
-      }
+      redisPromise = this.createRedisClient();
     }
 
     if (options.vector) {
-      vector = await this.createVectorClient();
-      if (!vector) {
-        throw new InternalUpstashError("Couldn't initialize Vector client");
-      }
+      vectorPromise = this.createVectorClient();
     }
 
+    const [redis, vector] = await Promise.all([redisPromise, vectorPromise]);
+
     return { redis, vector } as {
       redis: TInit["redis"] extends true ? Redis : undefined;
       vector: TInit["vector"] extends true ? Index : undefined;
diff --git a/src/clients/vector/index.test.ts b/src/clients/vector/index.test.ts
index baf9e06..837643d 100644
--- a/src/clients/vector/index.test.ts
+++ b/src/clients/vector/index.test.ts
@@ -22,7 +22,7 @@ describe("Vector Client", () => {
 
       await upstashSDK.deleteVectorIndex(DEFAULT_VECTOR_DB_NAME);
     },
-    { timeout: 20_000 }
+    { timeout: 30_000 }
   );
 
   test(
@@ -38,7 +38,7 @@ describe("Vector Client", () => {
 
       await upstashSDK.deleteVectorIndex("test-name");
     },
-    { timeout: 20_000 }
+    { timeout: 30_000 }
   );
 
   test(
@@ -62,6 +62,6 @@ describe("Vector Client", () => {
 
       await upstashSDK.deleteVectorIndex(indexName);
     },
-    { timeout: 20_000 }
+    { timeout: 30_000 }
   );
 });
diff --git a/src/clients/vector/index.ts b/src/clients/vector/index.ts
index b76802d..627f517 100644
--- a/src/clients/vector/index.ts
+++ b/src/clients/vector/index.ts
@@ -3,6 +3,7 @@ import { Index } from "@upstash/sdk";
 
 import type { PreferredRegions } from "../../types";
 import { DEFAULT_VECTOR_DB_NAME } from "../../constants";
+import { delay } from "../../utils";
 
 export const DEFAULT_VECTOR_CONFIG: CreateIndexPayload = {
   name: DEFAULT_VECTOR_DB_NAME,
@@ -94,6 +95,7 @@ export class VectorClient {
         });
       }
     }
+    await delay();
 
     if (index?.name) {
       const client = await this.upstashSDK.newVectorClient(index.name);
diff --git a/src/rag-chat-base.ts b/src/rag-chat-base.ts
new file mode 100644
index 0000000..7870114
--- /dev/null
+++ b/src/rag-chat-base.ts
@@ -0,0 +1,96 @@
+import type { Callbacks } from "@langchain/core/callbacks/manager";
+import type { AIMessage, BaseMessage } from "@langchain/core/messages";
+import { RunnableSequence, RunnableWithMessageHistory } from "@langchain/core/runnables";
+import { StreamingTextResponse, LangChainStream } from "ai";
+
+import type { PrepareChatResult, ChatOptions } from "./types";
+import { sanitizeQuestion, formatChatHistory } from "./utils";
+import type { BaseLanguageModelInterface } from "@langchain/core/language_models/base";
+import type { PromptTemplate } from "@langchain/core/prompts";
+import type { HistoryService, RetrievePayload } from "./services";
+import type { RetrievalService } from "./services/retrieval";
+
+type CustomInputValues = { chat_history?: BaseMessage[]; question: string; context: string };
+
+export class RAGChatBase {
+  protected retrievalService: RetrievalService;
+  protected historyService: HistoryService;
+
+  #model: BaseLanguageModelInterface;
+  #template: PromptTemplate;
+
+  constructor(
+    retrievalService: RetrievalService,
+    historyService: HistoryService,
+    config: { model: BaseLanguageModelInterface; template: PromptTemplate }
+  ) {
+    this.retrievalService = retrievalService;
+    this.historyService = historyService;
+
+    this.#model = config.model;
+    this.#template = config.template;
+  }
+
+  protected async prepareChat({
+    question: input,
+    similarityThreshold,
+    topK,
+  }: RetrievePayload): Promise<PrepareChatResult> {
+    const question = sanitizeQuestion(input);
+    const facts = await this.retrievalService.retrieveFromVectorDb({
+      question,
+      similarityThreshold,
+      topK,
+    });
+    return { question, facts };
+  }
+
+  protected streamingChainCall = (
+    chatOptions: ChatOptions,
+    question: string,
+    facts: string
+  ): StreamingTextResponse => {
+    const { stream, handlers } = LangChainStream();
+    void this.chainCall(chatOptions, question, facts, [handlers]);
+    return new StreamingTextResponse(stream, {});
+  };
+
+  protected chainCall(
+    chatOptions: ChatOptions,
+    question: string,
+    facts: string,
+    handlers?: Callbacks
+  ): Promise<AIMessage> {
+    const formattedHistoryChain = RunnableSequence.from<CustomInputValues>([
+      {
+        chat_history: (input) => formatChatHistory(input.chat_history ?? []),
+        question: (input) => input.question,
+        context: (input) => input.context,
+      },
+      this.#template,
+      this.#model,
+    ]);
+
+    const chainWithMessageHistory = new RunnableWithMessageHistory({
+      runnable: formattedHistoryChain,
+      getMessageHistory: (sessionId: string) =>
+        this.historyService.getMessageHistory({
+          sessionId,
+          length: chatOptions.includeHistory,
+        }),
+      inputMessagesKey: "question",
+      historyMessagesKey: "chat_history",
+    });
+
+    return chainWithMessageHistory.invoke(
+      {
+        question,
+        context: facts,
+      },
+      {
+        callbacks: handlers ?? undefined,
+        configurable: { sessionId: chatOptions.sessionId },
+      }
+    ) as Promise<AIMessage>;
+  }
+}
diff --git a/src/rag-chat.test.ts b/src/rag-chat.test.ts
new file mode 100644
index 0000000..f614530
--- /dev/null
+++ b/src/rag-chat.test.ts
@@ -0,0 +1,233 @@
+/* eslint-disable @typescript-eslint/no-non-null-assertion */
+import { ChatOpenAI } from "@langchain/openai";
+import { RAGChat } from "./rag-chat";
+import { afterAll, beforeAll, describe, expect, test } from "bun:test";
+import type { AIMessage } from "@langchain/core/messages";
+import { delay } from "./utils";
+import { Index, Ratelimit, Redis, Upstash } from "@upstash/sdk";
+import type { StreamingTextResponse } from "ai";
+import { DEFAULT_REDIS_DB_NAME, DEFAULT_VECTOR_DB_NAME } from "./constants";
+import { RatelimitUpstashError } from "./error";
+import { PromptTemplate } from "@langchain/core/prompts";
+
+describe("RAG Chat with advance configs and direct instances", async () => {
+  const ragChat = await RAGChat.initialize({
+    email: process.env.UPSTASH_EMAIL!,
+    token: process.env.UPSTASH_TOKEN!,
+    model: new ChatOpenAI({
+      modelName: "gpt-3.5-turbo",
+      streaming: true,
+      verbose: false,
+      temperature: 0,
+      apiKey: process.env.OPENAI_API_KEY,
+    }),
+    vector: new Index({
+      token: process.env.UPSTASH_VECTOR_REST_TOKEN!,
+      url: process.env.UPSTASH_VECTOR_REST_URL!,
+    }),
+    redis: new Redis({
+      token: process.env.UPSTASH_REDIS_REST_TOKEN!,
+      url: process.env.UPSTASH_REDIS_REST_URL!,
+    }),
+  });
+
+  beforeAll(async () => {
+    await ragChat.addContext(
+      "Paris, the capital of France, is renowned for its iconic landmark, the Eiffel Tower, which was completed in 1889 and stands at 330 meters tall."
+    );
+  });
+
+  test("should get result without streaming", async () => {
+    const result = (await ragChat.chat(
+      "What year was the construction of the Eiffel Tower completed, and what is its height?",
+      { stream: false }
+    )) as AIMessage;
+    expect(result.content).toContain("330");
+  });
+
+  test("should get result with streaming", async () => {
+    const result = (await ragChat.chat("Which famous artworks can be found in the Louvre Museum?", {
+      stream: true,
+    })) as StreamingTextResponse;
+    expect(result).toBeTruthy();
+  });
+});
+
+describe("RAG Chat with basic configs", async () => {
+  const ragChat = await RAGChat.initialize({
+    email: process.env.UPSTASH_EMAIL!,
+    token: process.env.UPSTASH_TOKEN!,
+    model: new ChatOpenAI({
+      modelName: "gpt-3.5-turbo",
+      streaming: false,
+      verbose: false,
+      temperature: 0,
+      apiKey: process.env.OPENAI_API_KEY,
+    }),
+    region: "eu-west-1",
+  });
+
+  const upstashSDK = new Upstash({
+    email: process.env.UPSTASH_EMAIL!,
+    token: process.env.UPSTASH_TOKEN!,
+  });
+
+  afterAll(async () => {
+    await upstashSDK.deleteRedisDatabase(DEFAULT_REDIS_DB_NAME);
+    await upstashSDK.deleteVectorIndex(DEFAULT_VECTOR_DB_NAME);
+  });
+
+  test(
+    "should get result without streaming",
+    async () => {
+      await ragChat.addContext(
+        "Paris, the capital of France, is renowned for its iconic landmark, the Eiffel Tower, which was completed in 1889 and stands at 330 meters tall."
+      );
+
+      // Wait for it to be indexed
+      // eslint-disable-next-line @typescript-eslint/no-magic-numbers
+      await delay(3000);
+
+      const result = (await ragChat.chat(
+        "What year was the construction of the Eiffel Tower completed, and what is its height?",
+        { stream: false }
+      )) as AIMessage;
+
+      expect(result.content).toContain("330");
+    },
+    { timeout: 30_000 }
+  );
+});
+
+describe("RAG Chat with ratelimit", async () => {
+  const redis = new Redis({
+    token: process.env.UPSTASH_REDIS_REST_TOKEN!,
+    url: process.env.UPSTASH_REDIS_REST_URL!,
+  });
+  const ragChat = await RAGChat.initialize({
+    email: process.env.UPSTASH_EMAIL!,
+    token: process.env.UPSTASH_TOKEN!,
+    model: new ChatOpenAI({
+      modelName: "gpt-3.5-turbo",
+      streaming: false,
+      verbose: false,
+      temperature: 0,
+      apiKey: process.env.OPENAI_API_KEY,
+    }),
+    vector: new Index({
+      token: process.env.UPSTASH_VECTOR_REST_TOKEN!,
+      url: process.env.UPSTASH_VECTOR_REST_URL!,
+    }),
+    redis,
+    ratelimit: new Ratelimit({
+      redis,
+      limiter: Ratelimit.tokenBucket(1, "1d", 1),
+      prefix: "@upstash/rag-chat-ratelimit",
+    }),
+  });
+
+  afterAll(async () => {
+    await redis.flushdb();
+  });
+
+  test("should throw ratelimit error", async () => {
+    await ragChat.chat(
+      "What year was the construction of the Eiffel Tower completed, and what is its height?",
+      { stream: false }
+    );
+
+    const throwable = async () => {
+      await ragChat.chat("You shall not pass", { stream: false });
+    };
+
+    expect(throwable).toThrowError(RatelimitUpstashError);
+  });
+});
+
+describe("RAG Chat with instance names", async () => {
+  const ragChat = await RAGChat.initialize({
+    email: process.env.UPSTASH_EMAIL!,
+    token: process.env.UPSTASH_TOKEN!,
+    redis: "my-fancy-redis-db",
+    vector: "my-fancy-vector-db",
+    model: new ChatOpenAI({
+      modelName: "gpt-3.5-turbo",
+      streaming: false,
+      verbose: false,
+      temperature: 0,
+      apiKey: process.env.OPENAI_API_KEY,
+    }),
+    region: "eu-west-1",
+  });
+
+  afterAll(async () => {
+    const upstashSDK = new Upstash({
+      email: process.env.UPSTASH_EMAIL!,
+      token: process.env.UPSTASH_TOKEN!,
+    });
+    await upstashSDK.deleteRedisDatabase("my-fancy-redis-db");
+    await upstashSDK.deleteVectorIndex("my-fancy-vector-db");
+  });
+
+  test(
+    "should get result without streaming",
+    async () => {
+      await ragChat.addContext(
+        "Paris, the capital of France, is renowned for its iconic landmark, the Eiffel Tower, which was completed in 1889 and stands at 330 meters tall."
+      );
+
+      // Wait for it to be indexed
+      // eslint-disable-next-line @typescript-eslint/no-magic-numbers
+      await delay(3000);
+
+      const result = (await ragChat.chat(
+        "What year was the construction of the Eiffel Tower completed, and what is its height?",
+        { stream: false }
+      )) as AIMessage;
+
+      expect(result.content).toContain("330");
+    },
+    { timeout: 30_000 }
+  );
+});
+
+describe("RAG Chat with custom template", async () => {
+  const ragChat = await RAGChat.initialize({
+    email: process.env.UPSTASH_EMAIL!,
+    token: process.env.UPSTASH_TOKEN!,
+    vector: new Index({
+      token: process.env.UPSTASH_VECTOR_REST_TOKEN!,
+      url: process.env.UPSTASH_VECTOR_REST_URL!,
+    }),
+    redis: new Redis({
+      token: process.env.UPSTASH_REDIS_REST_TOKEN!,
+      url: process.env.UPSTASH_REDIS_REST_URL!,
+    }),
+    template: PromptTemplate.fromTemplate("Just say `I'm a cookie monster`. Nothing else."),
+    model: new ChatOpenAI({
+      modelName: "gpt-3.5-turbo",
+      streaming: false,
+      verbose: false,
+      temperature: 0,
+      apiKey: process.env.OPENAI_API_KEY,
+    }),
+  });
+
+  test(
+    "should get result without streaming",
+    async () => {
+      await ragChat.addContext("Ankara is the capital of Turkiye.");
+
+      // Wait for it to be indexed
+      // eslint-disable-next-line @typescript-eslint/no-magic-numbers
+      await delay(3000);
+
+      const result = (await ragChat.chat("Where is the capital of Turkiye?", {
+        stream: false,
+      })) as AIMessage;
+
+      expect(result.content).toContain("I'm a cookie monster");
+    },
+    { timeout: 30_000 }
+  );
+});
diff --git a/src/rag-chat.ts b/src/rag-chat.ts
index dd5eb76..893fc8a 100644
--- a/src/rag-chat.ts
+++ b/src/rag-chat.ts
@@ -1,34 +1,25 @@
-import type { Callbacks } from "@langchain/core/callbacks/manager";
-import type { BaseMessage } from "@langchain/core/messages";
-import { RunnableSequence, RunnableWithMessageHistory } from "@langchain/core/runnables";
-import { LangChainStream, StreamingTextResponse } from "ai";
 import type { BaseLanguageModelInterface } from "@langchain/core/language_models/base";
+import type { AIMessage } from "@langchain/core/messages";
 import type { PromptTemplate } from "@langchain/core/prompts";
+import type { StreamingTextResponse } from "ai";
 
 import { HistoryService } from "./services/history";
-import { RetrievalService } from "./services/retrieval";
 import { RateLimitService } from "./services/ratelimit";
-import type { RetrievePayload } from "./services/retrieval";
+import { RetrievalService } from "./services/retrieval";
 
 import { QA_TEMPLATE } from "./prompts";
 
 import { UpstashModelError } from "./error/model";
 import { RatelimitUpstashError } from "./error/ratelimit";
 
-import type { ChatOptions, PrepareChatResult, RAGChatConfig } from "./types";
 import { ClientFactory } from "./client-factory";
 import { Config } from "./config";
-import { appendDefaultsIfNeeded, formatChatHistory, sanitizeQuestion } from "./utils";
-
-type CustomInputValues = { chat_history?: BaseMessage[]; question: string; context: string };
+import { RAGChatBase } from "./rag-chat-base";
+import type { ChatOptions, RAGChatConfig } from "./types";
+import { appendDefaultsIfNeeded } from "./utils";
 
-export class RAGChat {
-  private retrievalService: RetrievalService;
-  private historyService: HistoryService;
-  private ratelimitService: RateLimitService;
-
-  private model: BaseLanguageModelInterface;
-  private template: PromptTemplate;
+export class RAGChat extends RAGChatBase {
+  #ratelimitService: RateLimitService;
 
   constructor(
     retrievalService: RetrievalService,
@@ -36,37 +27,16 @@ export class RAGChat {
     ratelimitService: RateLimitService,
     config: { model: BaseLanguageModelInterface; template: PromptTemplate }
   ) {
-    this.retrievalService = retrievalService;
-    this.historyService = historyService;
-    this.ratelimitService = ratelimitService;
-
-    this.model = config.model;
-    this.template = config.template;
-  }
-
-  private async prepareChat({
-    question: input,
-    similarityThreshold,
-    topK,
-  }: RetrievePayload): Promise<PrepareChatResult> {
-    const question = sanitizeQuestion(input);
-    const facts = await this.retrievalService.retrieveFromVectorDb({
-      question,
-      similarityThreshold,
-      topK,
-    });
-    return { question, facts };
+    super(retrievalService, historyService, config);
+    this.#ratelimitService = ratelimitService;
   }
 
-  async chat(
-    input: string,
-    options: ChatOptions
-  ): Promise<StreamingTextResponse | Record<string, unknown>> {
+  async chat(input: string, options: ChatOptions): Promise<StreamingTextResponse | AIMessage> {
     // Adds chat session id and ratelimit session id if not provided.
     const options_ = appendDefaultsIfNeeded(options);
 
     //Checks ratelimit of the user. If not enabled `success` will be always true.
-    const { success, resetTime } = await this.ratelimitService.checkLimit(
+    const { success, resetTime } = await this.#ratelimitService.checkLimit(
       options_.ratelimitSessionId
     );
 
@@ -89,53 +59,11 @@ export class RAGChat {
       : this.chainCall(options_, question, facts);
   }
 
-  private streamingChainCall = (
-    chatOptions: ChatOptions,
-    question: string,
-    facts: string
-  ): StreamingTextResponse => {
-    const { stream, handlers } = LangChainStream();
-    void this.chainCall(chatOptions, question, facts, [handlers]);
-    return new StreamingTextResponse(stream, {});
-  };
-
-  private chainCall(
-    chatOptions: ChatOptions,
-    question: string,
-    facts: string,
-    handlers?: Callbacks
-  ) {
-    const formattedHistoryChain = RunnableSequence.from<CustomInputValues>([
-      {
-        chat_history: (input) => formatChatHistory(input.chat_history ?? []),
-        question: (input) => input.question,
-        context: (input) => input.context,
-      },
-      this.template,
-      this.model,
-    ]);
-
-    const chainWithMessageHistory = new RunnableWithMessageHistory({
-      runnable: formattedHistoryChain,
-      getMessageHistory: (sessionId: string) =>
-        this.historyService.getMessageHistory({
-          sessionId,
-          length: chatOptions.includeHistory,
-        }),
-      inputMessagesKey: "question",
-      historyMessagesKey: "chat_history",
-    });
-
-    return chainWithMessageHistory.invoke(
-      {
-        question,
-        context: facts,
-      },
-      {
-        callbacks: handlers ?? undefined,
-        configurable: { sessionId: chatOptions.sessionId },
-      }
-    );
+  /** Context can be either plain text or embeddings  */
+  async addContext(context: string | number[]) {
+    const retrievalService = await this.retrievalService.addEmbeddingOrTextToVectorDb(context);
+    if (retrievalService === "Success") return "OK";
+    return "NOT-OK";
   }
 
   /**
diff --git a/src/services/retrieval.ts b/src/services/retrieval.ts
index 063daee..d6b860e 100644
--- a/src/services/retrieval.ts
+++ b/src/services/retrieval.ts
@@ -3,6 +3,7 @@ import { formatFacts } from "../utils";
 import type { RAGChatConfig } from "../types";
 import { ClientFactory } from "../client-factory";
 import { Config } from "../config";
+import { nanoid } from "nanoid";
 
 const SIMILARITY_THRESHOLD = 0.5;
 const TOP_K = 5;
@@ -51,6 +52,13 @@ export class RetrievalService {
     return formatFacts(facts);
   }
 
+  async addEmbeddingOrTextToVectorDb(input: string | number[]) {
+    if (typeof input === "string") {
+      return this.index.upsert({ data: input, id: nanoid(), metadata: { value: input } });
+    }
+    return this.index.upsert({ vector: input, id: nanoid(), metadata: { value: input } });
+  }
+
   public static async init(config: RetrievalInit) {
     const clientFactory = new ClientFactory(
       new Config(config.email, config.token, {