From c4b6e7447da9023de90cbcc875d7d0535f485bb2 Mon Sep 17 00:00:00 2001
From: George Fu <kuhe@users.noreply.github.com>
Date: Mon, 10 Nov 2025 12:43:25 -0500
Subject: [PATCH] test(client-s3vectors): add e2e test

---
 clients/client-s3vectors/package.json         |   4 +-
 .../test/S3Vectors.e2e.spec.ts                | 119 ++++++++++++++++++
 .../client-s3vectors/vitest.config.e2e.mts    |  10 ++
 3 files changed, 132 insertions(+), 1 deletion(-)
 create mode 100644 clients/client-s3vectors/test/S3Vectors.e2e.spec.ts
 create mode 100644 clients/client-s3vectors/vitest.config.e2e.mts

diff --git a/clients/client-s3vectors/package.json b/clients/client-s3vectors/package.json
index e0196079bca71..e8f803bb3586a 100644
--- a/clients/client-s3vectors/package.json
+++ b/clients/client-s3vectors/package.json
@@ -11,7 +11,9 @@
     "build:types:downlevel": "downlevel-dts dist-types dist-types/ts3.4",
     "clean": "rimraf ./dist-* && rimraf *.tsbuildinfo || exit 0",
     "extract:docs": "api-extractor run --local",
-    "generate:client": "node ../../scripts/generate-clients/single-service --solo s3vectors"
+    "generate:client": "node ../../scripts/generate-clients/single-service --solo s3vectors",
+    "test:e2e": "yarn g:vitest run -c vitest.config.e2e.mts",
+    "test:e2e:watch": "yarn g:vitest watch -c vitest.config.e2e.mts"
   },
   "main": "./dist-cjs/index.js",
   "types": "./dist-types/index.d.ts",
diff --git a/clients/client-s3vectors/test/S3Vectors.e2e.spec.ts b/clients/client-s3vectors/test/S3Vectors.e2e.spec.ts
new file mode 100644
index 0000000000000..b4ec62006a20c
--- /dev/null
+++ b/clients/client-s3vectors/test/S3Vectors.e2e.spec.ts
@@ -0,0 +1,119 @@
+import { BedrockRuntime } from "@aws-sdk/client-bedrock-runtime";
+import { S3Vectors } from "@aws-sdk/client-s3vectors";
+import { beforeEach, describe, expect, test as it } from "vitest";
+
+describe(
+  S3Vectors.name,
+  () => {
+    const s3v = new S3Vectors({
+      region: "us-west-2",
+    });
+    const rock = new BedrockRuntime({
+      region: "us-west-2",
+    });
+
+    const VECTOR_BUCKET_NAME = "jsv3-e2e-vector";
+
+    beforeEach(async () => {
+      async function checkForBucket() {
+        const buckets = await s3v.listVectorBuckets({
+          prefix: VECTOR_BUCKET_NAME,
+        });
+
+        return buckets.vectorBuckets?.some((bucket) => bucket.vectorBucketName === VECTOR_BUCKET_NAME);
+      }
+
+      const testBucket = await checkForBucket();
+
+      if (!testBucket) {
+        await s3v.createVectorBucket({
+          vectorBucketName: VECTOR_BUCKET_NAME,
+        });
+        await s3v.createIndex({
+          vectorBucketName: VECTOR_BUCKET_NAME,
+          indexName: "characters",
+          dataType: "float32",
+          dimension: 1024,
+          distanceMetric: "cosine",
+        });
+      }
+
+      while (true) {
+        const testBucket = await checkForBucket();
+        if (!testBucket) {
+          await new Promise((r) => setTimeout(r, 5000));
+        } else {
+          break;
+        }
+      }
+    });
+
+    it("can put vectors", async () => {
+      const texts = [
+        "Santa Bear is a bear who wears a Santa outfit.",
+        "Saucey is a tiger who is rotund.",
+        `Tigey is a tiger who likes to say "woof".`,
+      ];
+
+      const embeddings: number[][] = [];
+      for (const text of texts) {
+        const invoke = await rock.invokeModel({
+          modelId: "amazon.titan-embed-text-v2:0",
+          body: JSON.stringify({
+            inputText: text,
+          }),
+        });
+        embeddings.push([...invoke.body].slice(0, 1024));
+      }
+
+      await s3v.putVectors({
+        vectorBucketName: VECTOR_BUCKET_NAME,
+        indexName: "characters",
+        vectors: [
+          {
+            key: "Santa Bear",
+            data: { float32: embeddings[0] },
+            metadata: { source_text: texts[0], genre: "bear" },
+          },
+          {
+            key: "Saucey",
+            data: { float32: embeddings[1] },
+            metadata: { source_text: texts[1], genre: "tiger" },
+          },
+          {
+            key: "Tigey",
+            data: { float32: embeddings[2] },
+            metadata: { source_text: texts[2], genre: "tiger" },
+          },
+        ],
+      });
+    });
+
+    it("can query vectors", async () => {
+      const invoke = await rock.invokeModel({
+        modelId: "amazon.titan-embed-text-v2:0",
+        body: JSON.stringify({
+          inputText: "characters who are tigers or bears",
+        }),
+      });
+
+      const embedding = invoke.body;
+
+      const query = await s3v.queryVectors({
+        vectorBucketName: VECTOR_BUCKET_NAME,
+        indexName: "characters",
+        queryVector: {
+          float32: [...embedding].slice(0, 1024),
+        },
+        topK: 3,
+        returnDistance: true,
+        returnMetadata: true,
+      });
+
+      expect(query.vectors?.some((v) => v.key === "Tigey")).toBeDefined();
+      expect(query.vectors?.some((v) => v.key === "Santa Bear")).toBeDefined();
+      expect(query.vectors?.some((v) => v.key === "Saucey")).toBeDefined();
+    });
+  },
+  120_000
+);
diff --git a/clients/client-s3vectors/vitest.config.e2e.mts b/clients/client-s3vectors/vitest.config.e2e.mts
new file mode 100644
index 0000000000000..ccea26a45905c
--- /dev/null
+++ b/clients/client-s3vectors/vitest.config.e2e.mts
@@ -0,0 +1,10 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    exclude: ["**/*.browser.e2e.spec.ts"],
+    include: ["**/*.e2e.spec.ts"],
+    environment: "node",
+  },
+  mode: "development",
+});